BREAKING CHANGE: Schema.create() for TypeScript type inference

lib/schema.js

@@ -372,6 +372,27 @@ Schema.prototype.paths;
 
 Schema.prototype.tree;
 
+/**
+ * Creates a new schema with the given definition and options. Equivalent to `new Schema(definition, options)`.
+ *
+ * `Schema.create()` is primarily useful for automatic schema type inference in TypeScript.
+ *
+ * #### Example:
+ *
+ *     const schema = Schema.create({ name: String }, { toObject: { virtuals: true } });
+ *     // Equivalent:
+ *     const schema2 = new Schema({ name: String }, { toObject: { virtuals: true } });
+ *
+ * @return {Schema} the new schema
+ * @api public
+ * @memberOf Schema
+ * @static
+ */
+
+Schema.create = function create(definition, options) {
+  return new Schema(definition, options);
+};
+
 /**
  * Returns a deep copy of the schema
  *

test/types/inferrawdoctype.test.ts

@@ -1,4 +1,4 @@
-import { InferRawDocType } from 'mongoose';
+import { InferRawDocType, Types } from 'mongoose';
 import { expectType, expectError } from 'tsd';
 
 function gh14839() {
@@ -21,5 +21,5 @@ function gh14839() {
   };
 
   type UserType = InferRawDocType< typeof schemaDefinition>;
-  expectType<{ email: string, password: string, dateOfBirth: Date }>({} as UserType);
+  expectType<{ email: string, password: string, dateOfBirth: Date } & { _id: Types.ObjectId }>({} as UserType);
 }