mongoose 8.17.0 → 8.17.1

package/lib/helpers/model/discriminator.js

@@ -14,7 +14,8 @@ const CUSTOMIZABLE_DISCRIMINATOR_OPTIONS = {
   _id: true,
   id: true,
   virtuals: true,
-  methods: true
+  methods: true,
+  statics: true
 };
 
 /**

package/lib/model.js

@@ -1099,7 +1099,7 @@ Model.init = function init() {
       return;
     }
 
-    return await this.ensureSearchIndexes();
+    return await this.createSearchIndexes();
   };
   const _createCollection = async() => {
     let autoCreate = utils.getOption(
@@ -2092,9 +2092,7 @@ Model.find = function find(conditions, projection, options) {
 };
 
 /**
- * Finds a single document by its _id field. `findById(id)` is almost*
- * equivalent to `findOne({ _id: id })`. If you want to query by a document's
- * `_id`, use `findById()` instead of `findOne()`.
+ * Finds a single document by its _id field. `findById(id)` is equivalent to `findOne({ _id: id })`.
  *
  * The `id` is cast based on the Schema before sending the command.
  *
@@ -2102,11 +2100,6 @@ Model.find = function find(conditions, projection, options) {
  *
  * - `findOne()`
  *
- * \* Except for how it treats `undefined`. If you use `findOne()`, you'll see
- * that `findOne(undefined)` and `findOne({ _id: undefined })` are equivalent
- * to `findOne({})` and return arbitrary documents. However, mongoose
- * translates `findById(undefined)` into `findOne({ _id: null })`.
- *
  * #### Example:
  *
  *     // Find the adventure with the given `id`, or `null` if not found
@@ -2131,10 +2124,6 @@ Model.findById = function findById(id, projection, options) {
     throw new MongooseError('Model.findById() no longer accepts a callback');
   }
 
-  if (typeof id === 'undefined') {
-    id = null;
-  }
-
   return this.findOne({ _id: id }, projection, options);
 };
 

package/lib/query.js

@@ -2133,6 +2133,29 @@ Query.prototype._optionsForExec = function(model) {
     }
   }
 
+  if (this._mongooseOptions.populate) {
+    if (options.readPreference) {
+      for (const pop of Object.values(this._mongooseOptions.populate)) {
+        if (pop.options?.readPreference === undefined) {
+          if (!pop.options) {
+            pop.options = {};
+          }
+          pop.options.readPreference = options.readPreference;
+        }
+      }
+    }
+    if (options.readConcern) {
+      for (const pop of Object.values(this._mongooseOptions.populate)) {
+        if (pop.options?.readConcern === undefined) {
+          if (!pop.options) {
+            pop.options = {};
+          }
+          pop.options.readConcern = options.readConcern;
+        }
+      }
+    }
+  }
+
   return options;
 };
 
@@ -4918,24 +4941,6 @@ Query.prototype.populate = function() {
 
   const res = utils.populate.apply(null, args);
 
-  // Propagate readConcern and readPreference and lean from parent query,
-  // unless one already specified
-  if (this.options != null) {
-    const readConcern = this.options.readConcern;
-    const readPref = this.options.readPreference;
-
-    for (const populateOptions of res) {
-      if (readConcern != null && (populateOptions && populateOptions.options && populateOptions.options.readConcern) == null) {
-        populateOptions.options = populateOptions.options || {};
-        populateOptions.options.readConcern = readConcern;
-      }
-      if (readPref != null && (populateOptions && populateOptions.options && populateOptions.options.readPreference) == null) {
-        populateOptions.options = populateOptions.options || {};
-        populateOptions.options.readPreference = readPref;
-      }
-    }
-  }
-
   const opts = this._mongooseOptions;
 
   if (opts.lean != null) {

package/lib/schema/string.js

@@ -381,7 +381,7 @@ SchemaString.prototype.trim = function(shouldTrim) {
  *
  * #### Example:
  *
- *     const schema = new Schema({ postalCode: { type: String, minlength: 5 })
+ *     const schema = new Schema({ postalCode: { type: String, minLength: 5 })
  *     const Address = db.model('Address', schema)
  *     const address = new Address({ postalCode: '9512' })
  *     address.save(function (err) {
@@ -392,8 +392,8 @@ SchemaString.prototype.trim = function(shouldTrim) {
  *
  *     // custom error messages
  *     // We can also use the special {MINLENGTH} token which will be replaced with the minimum allowed length
- *     const minlength = [5, 'The value of path `{PATH}` (`{VALUE}`) is shorter than the minimum allowed length ({MINLENGTH}).'];
- *     const schema = new Schema({ postalCode: { type: String, minlength: minlength })
+ *     const minLength = [5, 'The value of path `{PATH}` (`{VALUE}`) is shorter than the minimum allowed length ({MINLENGTH}).'];
+ *     const schema = new Schema({ postalCode: { type: String, minLength: minLength })
  *     const Address = mongoose.model('Address', schema);
  *     const address = new Address({ postalCode: '9512' });
  *     address.validate(function (err) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mongoose",
   "description": "Mongoose MongoDB ODM",
-  "version": "8.17.0",
+  "version": "8.17.1",
   "author": "Guillermo Rauch <guillermo@learnboost.com>",
   "keywords": [
     "mongodb",
@@ -29,8 +29,8 @@
     "sift": "17.1.3"
   },
   "devDependencies": {
-    "@babel/core": "7.27.7",
-    "@babel/preset-env": "7.27.2",
+    "@babel/core": "7.28.0",
+    "@babel/preset-env": "7.28.0",
     "@mongodb-js/mongodb-downloader": "^0.4.2",
     "@typescript-eslint/eslint-plugin": "^8.19.1",
     "@typescript-eslint/parser": "^8.19.1",
@@ -42,7 +42,7 @@
     "babel-loader": "8.2.5",
     "broken-link-checker": "^0.7.8",
     "buffer": "^5.6.0",
-    "cheerio": "1.1.0",
+    "cheerio": "1.1.2",
     "crypto-browserify": "3.12.1",
     "dox": "1.0.0",
     "eslint": "8.57.1",
@@ -69,7 +69,7 @@
     "tsd": "0.32.0",
     "typescript": "5.8.3",
     "uuid": "11.1.0",
-    "webpack": "5.99.9"
+    "webpack": "5.101.0"
   },
   "directories": {
     "lib": "./lib/mongoose"

package/types/index.d.ts

@@ -704,9 +704,9 @@ declare module 'mongoose' {
           [K in keyof T]?: T[K] extends Record<string, any> ? Projector<T[K], Element> | Element : Element;
         }
         : Element;
-  type _IDType = { _id?: boolean | 1 | 0 };
+  type _IDType = { _id?: boolean | number };
   export type InclusionProjection<T> = IsItRecordAndNotAny<T> extends true
-    ? Omit<Projector<WithLevel1NestedPaths<T>, true | 1>, '_id'> & _IDType
+    ? Omit<Projector<WithLevel1NestedPaths<T>, boolean | number>, '_id'> & _IDType
     : AnyObject;
   export type ExclusionProjection<T> = IsItRecordAndNotAny<T> extends true
     ? Omit<Projector<WithLevel1NestedPaths<T>, false | 0>, '_id'> & _IDType

package/types/schematypes.d.ts

@@ -207,9 +207,11 @@ declare module 'mongoose' {
 
     /** If set, Mongoose will add a custom validator that ensures the given string's `length` is at least the given number. */
     minlength?: number | [number, string] | readonly [number, string];
+    minLength?: number | [number, string] | readonly [number, string];
 
     /** If set, Mongoose will add a custom validator that ensures the given string's `length` is at most the given number. */
     maxlength?: number | [number, string] | readonly [number, string];
+    maxLength?: number | [number, string] | readonly [number, string];
 
     [other: string]: any;