mongoose 9.3.1 → 9.3.2

package/README.md

@@ -11,7 +11,7 @@ Mongoose is a [MongoDB](https://www.mongodb.org/) object modeling tool designed
 
 ## Documentation
 
-The official documentation website is [mongoosejs.com](http://mongoosejs.com/).
+The official documentation website is [mongoosejs.com](https://mongoosejs.com/).
 
 Mongoose 9.0.0 was released on November 21, 2025. You can find more details on [backwards breaking changes in 9.0.0 on our docs site](https://mongoosejs.com/docs/migrating_to_9.html).
 
@@ -25,7 +25,7 @@ Mongoose 9.0.0 was released on November 21, 2025. You can find more details on [
 
 ## Plugins
 
-Check out the [plugins search site](http://plugins.mongoosejs.io/) to see hundreds of related modules from the community. Next, learn how to write your own plugin from the [docs](http://mongoosejs.com/docs/plugins.html) or [this blog post](http://thecodebarbarian.com/2015/03/06/guide-to-mongoose-plugins).
+Check out the [plugins search site](https://plugins.mongoosejs.io/) to see hundreds of related modules from the community. Next, learn how to write your own plugin from the [docs](https://mongoosejs.com/docs/plugins.html) or [this blog post](http://thecodebarbarian.com/2015/03/06/guide-to-mongoose-plugins).
 
 ## Contributors
 
@@ -40,9 +40,7 @@ View all 400+ [contributors](https://github.com/Automattic/mongoose/graphs/contr
 
 ## Installation
 
-First install [Node.js](http://nodejs.org/) and [MongoDB](https://www.mongodb.org/downloads). Then:
-
-Then install the `mongoose` package using your preferred package manager:
+First install [Node.js](https://nodejs.org/) and [MongoDB](https://www.mongodb.org/downloads), then install the `mongoose` package using your preferred package manager:
 
 ### Using npm
 
@@ -140,16 +138,16 @@ const BlogPost = new Schema({
 
 Aside from defining the structure of your documents and the types of data you're storing, a Schema handles the definition of:
 
-* [Validators](http://mongoosejs.com/docs/validation.html) (async and sync)
-* [Defaults](http://mongoosejs.com/docs/api/schematype.html#schematype_SchemaType-default)
-* [Getters](http://mongoosejs.com/docs/api/schematype.html#schematype_SchemaType-get)
-* [Setters](http://mongoosejs.com/docs/api/schematype.html#schematype_SchemaType-set)
-* [Indexes](http://mongoosejs.com/docs/guide.html#indexes)
-* [Middleware](http://mongoosejs.com/docs/middleware.html)
-* [Methods](http://mongoosejs.com/docs/guide.html#methods) definition
-* [Statics](http://mongoosejs.com/docs/guide.html#statics) definition
-* [Plugins](http://mongoosejs.com/docs/plugins.html)
-* [pseudo-JOINs](http://mongoosejs.com/docs/populate.html)
+* [Validators](https://mongoosejs.com/docs/validation.html) (async and sync)
+* [Defaults](https://mongoosejs.com/docs/api/schematype.html#schematype_SchemaType-default)
+* [Getters](https://mongoosejs.com/docs/api/schematype.html#schematype_SchemaType-get)
+* [Setters](https://mongoosejs.com/docs/api/schematype.html#schematype_SchemaType-set)
+* [Indexes](https://mongoosejs.com/docs/guide.html#indexes)
+* [Middleware](https://mongoosejs.com/docs/middleware.html)
+* [Methods](https://mongoosejs.com/docs/guide.html#methods) definition
+* [Statics](https://mongoosejs.com/docs/guide.html#statics) definition
+* [Plugins](https://mongoosejs.com/docs/plugins.html)
+* [pseudo-JOINs](https://mongoosejs.com/docs/populate.html)
 
 The following example shows some of these features:
 
@@ -219,7 +217,7 @@ const instance = await MyModel.findOne({ /* ... */ });
 console.log(instance.my.key); // 'hello'
 ```
 
-For more details check out [the docs](http://mongoosejs.com/docs/queries.html).
+For more details check out [the docs](https://mongoosejs.com/docs/queries.html).
 
 **Important!** If you opened a separate connection using `mongoose.createConnection()` but attempt to access the model through `mongoose.model('ModelName')` it will not work as expected since it is not hooked up to an active db connection. In this case access your model through the connection you created:
 
@@ -274,7 +272,7 @@ Embedded documents enjoy all the same features as your models. Defaults, validat
 
 ### Middleware
 
-See the [docs](http://mongoosejs.com/docs/middleware.html) page.
+See the [docs](https://mongoosejs.com/docs/middleware.html) page.
 
 #### Intercepting and mutating method arguments
 
@@ -347,7 +345,7 @@ return a cursor.
 
 ## API Docs
 
-[Mongoose API documentation](http://mongoosejs.com/docs/api/mongoose.html), generated using [dox](https://github.com/tj/dox)
+[Mongoose API documentation](https://mongoosejs.com/docs/api/mongoose.html), generated using [dox](https://github.com/tj/dox)
 and [acquit](https://github.com/vkarpov15/acquit).
 
 ## Related Projects

package/lib/cast/number.js

@@ -1,7 +1,5 @@
 'use strict';
 
-const assert = require('assert');
-
 /**
  * Given a value, cast it to a number, or throw an `Error` if the value
  * cannot be casted. `null` and `undefined` are considered valid.
@@ -24,7 +22,9 @@ module.exports = function castNumber(val) {
     val = Number(val);
   }
 
-  assert.ok(!isNaN(val));
+  if (isNaN(val)) {
+    throw new Error('Cast to Number failed: value is not a valid number');
+  }
   if (val instanceof Number) {
     return val.valueOf();
   }
@@ -38,5 +38,5 @@ module.exports = function castNumber(val) {
     return Number(val);
   }
 
-  assert.ok(false);
+  throw new Error('Cast to Number failed: value is not a valid number');
 };

package/lib/cast.js

@@ -35,7 +35,7 @@ const ALLOWED_GEOWITHIN_GEOJSON_TYPES = ['Polygon', 'MultiPolygon'];
  */
 module.exports = function cast(schema, obj, options, context) {
   if (Array.isArray(obj)) {
-    throw new Error('Query filter must be an object, got an array ', util.inspect(obj));
+    throw new Error('Query filter must be an object, got an array ' + util.inspect(obj));
   }
 
   if (obj == null) {

package/lib/connection.js

@@ -132,7 +132,7 @@ Object.defineProperty(Connection.prototype, 'readyState', {
   },
   set: function(val) {
     if (!(val in STATES)) {
-      throw new Error('Invalid connection state: ' + val);
+      throw new MongooseError('Invalid connection state: ' + val);
     }
 
     if (this._readyState !== val) {
@@ -655,7 +655,7 @@ Connection.prototype.createCollections = async function createCollections(option
 
 Connection.prototype.withSession = async function withSession(executor) {
   if (arguments.length === 0) {
-    throw new Error('Please provide an executor function');
+    throw new MongooseError('Please provide an executor function');
   }
   return await this.client.withSession(executor);
 };
@@ -713,7 +713,7 @@ Connection.prototype.startSession = async function startSession(options) {
  *       doc.isNew; // false
  *
  *       // Throw an error to abort the transaction
- *       throw new Error('Oops!');
+ *       throw new MongooseError('Oops!');
  *     },{ readPreference: 'primary' }).catch(() => {});
  *
  *     // true, `transaction()` reset the document's state because the
@@ -1310,7 +1310,7 @@ Connection.prototype._close = async function _close(force, destroy) {
  */
 
 Connection.prototype.doClose = function doClose() {
-  throw new Error('Connection#doClose unimplemented by driver');
+  throw new MongooseError('Connection#doClose unimplemented by driver');
 };
 
 /**
@@ -1453,7 +1453,7 @@ Connection.prototype.model = function model(name, schema, collection, options) {
     }
   }
   if (schema && !schema.instanceOfSchema) {
-    throw new Error('The 2nd parameter to `mongoose.model()` should be a ' +
+    throw new MongooseError('The 2nd parameter to `mongoose.model()` should be a ' +
       'schema or a POJO');
   }
 
@@ -1566,7 +1566,7 @@ Connection.prototype.deleteModel = function deleteModel(name) {
       }
     }
   } else {
-    throw new Error('First parameter to `deleteModel()` must be a string ' +
+    throw new MongooseError('First parameter to `deleteModel()` must be a string ' +
       'or regexp, got "' + name + '"');
   }
 

package/lib/helpers/get.js

@@ -47,7 +47,7 @@ module.exports = function get(obj, path, def) {
     cur = getProperty(cur, part);
 
     if (!isPathArray) {
-      rest = rest.substr(part.length + 1);
+      rest = rest.substring(part.length + 1);
     }
   }
 

package/lib/mongoose.js

@@ -256,6 +256,12 @@ Mongoose.prototype.setDriver = function setDriver(driver) {
 Mongoose.prototype.set = function getsetOptions(key, value) {
   const _mongoose = this instanceof Mongoose ? this : mongoose;
 
+  if (key == null) {
+    const error = new SetOptionError();
+    error.addError(String(key), new SetOptionError.SetOptionInnerError(String(key)));
+    throw error;
+  }
+
   if (arguments.length === 1 && typeof key !== 'object') {
     if (VALID_OPTIONS.indexOf(key) === -1) {
       const error = new SetOptionError();

package/lib/query.js

@@ -185,7 +185,7 @@ function isEmptyFilter(obj) {
 // Helper function to check for empty/invalid filter
 function checkRequireFilter(filter, options) {
   if (options?.requireFilter && isEmptyFilter(filter)) {
-    throw new Error('Empty or invalid filter not allowed with requireFilter enabled');
+    throw new MongooseError('Empty or invalid filter not allowed with requireFilter enabled');
   }
 }
 
@@ -1113,7 +1113,7 @@ Query.prototype.select = function select() {
   if (!arg) return this;
 
   if (arguments.length !== 1) {
-    throw new Error('Invalid select: select only takes 1 argument');
+    throw new MongooseError('Invalid select: select only takes 1 argument');
   }
 
   this._validate('select');
@@ -1721,7 +1721,7 @@ Query.prototype.setOptions = function(options, overwrite) {
     return this;
   }
   if (typeof options !== 'object') {
-    throw new Error('Options must be an object, got "' + options + '"');
+    throw new MongooseError('Options must be an object, got "' + options + '"');
   }
 
   options = Object.assign({}, options);
@@ -3080,10 +3080,10 @@ Query.prototype.distinct = function(field, conditions, options) {
 
 Query.prototype.sort = function(arg, options) {
   if (arguments.length > 2) {
-    throw new Error('sort() takes at most 2 arguments');
+    throw new MongooseError('sort() takes at most 2 arguments');
   }
   if (options != null && typeof options !== 'object') {
-    throw new Error('sort() options argument must be an object or nullish');
+    throw new MongooseError('sort() options argument must be an object or nullish');
   }
 
   if (this.options.sort == null) {
@@ -4695,7 +4695,7 @@ Query.prototype.exec = async function exec(op) {
   }
 
   if (this.options?.sort && typeof this.options.sort === 'object' && Object.hasOwn(this.options.sort, '')) {
-    throw new Error('Invalid field "" passed to sort()');
+    throw new MongooseError('Invalid field "" passed to sort()');
   }
 
   if (this._execCount > 0) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mongoose",
   "description": "Mongoose MongoDB ODM",
-  "version": "9.3.1",
+  "version": "9.3.2",
   "author": "Guillermo Rauch <guillermo@learnboost.com>",
   "keywords": [
     "mongodb",