mongoose 6.9.1 → 6.9.2

package/lib/model.js

@@ -82,12 +82,12 @@ const saveToObjectOptions = Object.assign({}, internalToObjectOptions, {
 
 /**
  * A Model is a class that's your primary tool for interacting with MongoDB.
- * An instance of a Model is called a [Document](./api/document.html#Document).
+ * An instance of a Model is called a [Document](/docs/api/document.html#Document).
  *
  * In Mongoose, the term "Model" refers to subclasses of the `mongoose.Model`
  * class. You should not use the `mongoose.Model` class directly. The
- * [`mongoose.model()`](./api/mongoose.html#mongoose_Mongoose-model) and
- * [`connection.model()`](./api/connection.html#connection_Connection-model) functions
+ * [`mongoose.model()`](/docs/api/mongoose.html#mongoose_Mongoose-model) and
+ * [`connection.model()`](/docs/api/connection.html#connection_Connection-model) functions
  * create subclasses of `mongoose.Model` as shown below.
  *
  * #### Example:
@@ -103,7 +103,7 @@ const saveToObjectOptions = Object.assign({}, internalToObjectOptions, {
  *     const userFromDb = await UserModel.findOne({ name: 'Foo' });
  *
  * @param {Object} doc values for initial set
- * @param {Object} [fields] optional object containing the fields that were selected in the query which returned this document. You do **not** need to set this parameter to ensure Mongoose handles your [query projection](./api/query.html#query_Query-select).
+ * @param {Object} [fields] optional object containing the fields that were selected in the query which returned this document. You do **not** need to set this parameter to ensure Mongoose handles your [query projection](/docs/api/query.html#query_Query-select).
  * @param {Boolean} [skipId=false] optional boolean. If true, mongoose doesn't add an `_id` field to the document.
  * @inherits Document https://mongoosejs.com/docs/api/document.html
  * @event `error`: If listening to this event, 'error' is emitted when a document was saved without passing a callback and an `error` occurred. If not listening, the event bubbles to the connection used to create this Model.
@@ -477,17 +477,17 @@ function generateVersionError(doc, modifiedPaths) {
  *     newProduct === product; // true
  *
  * @param {Object} [options] options optional options
- * @param {Session} [options.session=null] the [session](https://docs.mongodb.com/manual/reference/server-sessions/) associated with this save operation. If not specified, defaults to the [document's associated session](api/document.html#document_Document-$session).
+ * @param {Session} [options.session=null] the [session](https://www.mongodb.com/docs/manual/reference/server-sessions/) associated with this save operation. If not specified, defaults to the [document's associated session](/docs/api/document.html#document_Document-$session).
  * @param {Object} [options.safe] (DEPRECATED) overrides [schema's safe option](https://mongoosejs.com//docs/guide.html#safe). Use the `w` option instead.
  * @param {Boolean} [options.validateBeforeSave] set to false to save without validating.
  * @param {Boolean} [options.validateModifiedOnly=false] if `true`, Mongoose will only validate modified paths, as opposed to modified paths and `required` paths.
- * @param {Number|String} [options.w] set the [write concern](https://docs.mongodb.com/manual/reference/write-concern/#w-option). Overrides the [schema-level `writeConcern` option](/docs/guide.html#writeConcern)
- * @param {Boolean} [options.j] set to true for MongoDB to wait until this `save()` has been [journaled before resolving the returned promise](https://docs.mongodb.com/manual/reference/write-concern/#j-option). Overrides the [schema-level `writeConcern` option](/docs/guide.html#writeConcern)
- * @param {Number} [options.wtimeout] sets a [timeout for the write concern](https://docs.mongodb.com/manual/reference/write-concern/#wtimeout). Overrides the [schema-level `writeConcern` option](/docs/guide.html#writeConcern).
- * @param {Boolean} [options.checkKeys=true] the MongoDB driver prevents you from saving keys that start with '$' or contain '.' by default. Set this option to `false` to skip that check. See [restrictions on field names](https://docs.mongodb.com/manual/reference/limits/#Restrictions-on-Field-Names)
- * @param {Boolean} [options.timestamps=true] if `false` and [timestamps](./guide.html#timestamps) are enabled, skip timestamps for this `save()`.
+ * @param {Number|String} [options.w] set the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/#w-option). Overrides the [schema-level `writeConcern` option](/docs/guide.html#writeConcern)
+ * @param {Boolean} [options.j] set to true for MongoDB to wait until this `save()` has been [journaled before resolving the returned promise](https://www.mongodb.com/docs/manual/reference/write-concern/#j-option). Overrides the [schema-level `writeConcern` option](/docs/guide.html#writeConcern)
+ * @param {Number} [options.wtimeout] sets a [timeout for the write concern](https://www.mongodb.com/docs/manual/reference/write-concern/#wtimeout). Overrides the [schema-level `writeConcern` option](/docs/guide.html#writeConcern).
+ * @param {Boolean} [options.checkKeys=true] the MongoDB driver prevents you from saving keys that start with '$' or contain '.' by default. Set this option to `false` to skip that check. See [restrictions on field names](https://www.mongodb.com/docs/manual/reference/limits/#Restrictions-on-Field-Names)
+ * @param {Boolean} [options.timestamps=true] if `false` and [timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this `save()`.
  * @param {Function} [fn] optional callback
- * @throws {DocumentNotFoundError} if this [save updates an existing document](api/document.html#document_Document-isNew) but the document doesn't exist in the database. For example, you will get this error if the document is [deleted between when you retrieved the document and when you saved it](documents.html#updating).
+ * @throws {DocumentNotFoundError} if this [save updates an existing document](/docs/api/document.html#document_Document-isNew) but the document doesn't exist in the database. For example, you will get this error if the document is [deleted between when you retrieved the document and when you saved it](documents.html#updating).
  * @return {Promise|undefined} Returns undefined if used with callback or a Promise otherwise.
  * @api public
  * @see middleware https://mongoosejs.com/docs/middleware.html
@@ -991,7 +991,7 @@ Model.prototype.$__where = function _where(where) {
  *     console.log(foundProduct) // null
  *
  * @param {Object} [options]
- * @param {Session} [options.session=null] the [session](https://docs.mongodb.com/manual/reference/server-sessions/) associated with this operation. If not specified, defaults to the [document's associated session](api/document.html#document_Document-$session).
+ * @param {Session} [options.session=null] the [session](https://www.mongodb.com/docs/manual/reference/server-sessions/) associated with this operation. If not specified, defaults to the [document's associated session](/docs/api/document.html#document_Document-$session).
  * @param {function(err,product)} [fn] optional callback
  * @return {Promise} Promise
  * @api public
@@ -1308,7 +1308,7 @@ for (const i in EventEmitter.prototype) {
 }
 
 /**
- * This function is responsible for building [indexes](https://docs.mongodb.com/manual/indexes/),
+ * This function is responsible for building [indexes](https://www.mongodb.com/docs/manual/indexes/),
  * unless [`autoIndex`](https://mongoosejs.com/docs/guide.html#autoIndex) is turned off.
  *
  * Mongoose calls this function automatically when a model is created using
@@ -1399,7 +1399,7 @@ Model.init = function init(callback) {
  * created. Use this method to create the collection explicitly.
  *
  * Note 1: You may need to call this before starting a transaction
- * See https://docs.mongodb.com/manual/core/transactions/#transactions-and-operations
+ * See https://www.mongodb.com/docs/manual/core/transactions/#transactions-and-operations
  *
  * Note 2: You don't have to call this if your schema contains index or unique field.
  * In that case, just use `Model.init()`
@@ -2088,7 +2088,7 @@ Model.translateAliases = function translateAliases(fields) {
  * @deprecated
  * @param {Object} conditions
  * @param {Object} [options]
- * @param {Session} [options.session=null] the [session](https://docs.mongodb.com/manual/reference/server-sessions/) associated with this operation.
+ * @param {Session} [options.session=null] the [session](https://www.mongodb.com/docs/manual/reference/server-sessions/) associated with this operation.
  * @param {Function} [callback]
  * @return {Query}
  * @api public
@@ -2400,7 +2400,7 @@ Model.estimatedDocumentCount = function estimatedDocumentCount(options, callback
  *     });
  *
  * If you want to count all documents in a large collection,
- * use the [`estimatedDocumentCount()` function](/docs/api/model.html#model_Model-estimatedDocumentCount)
+ * use the [`estimatedDocumentCount()` function](#model_Model-estimatedDocumentCount)
  * instead. If you call `countDocuments({})`, MongoDB will always execute
  * a full collection scan and **not** use any indexes.
  *
@@ -2409,9 +2409,9 @@ Model.estimatedDocumentCount = function estimatedDocumentCount(options, callback
  * Below are the operators that `count()` supports but `countDocuments()` does not,
  * and the suggested replacement:
  *
- * - `$where`: [`$expr`](https://docs.mongodb.com/manual/reference/operator/query/expr/)
- * - `$near`: [`$geoWithin`](https://docs.mongodb.com/manual/reference/operator/query/geoWithin/) with [`$center`](https://docs.mongodb.com/manual/reference/operator/query/center/#op._S_center)
- * - `$nearSphere`: [`$geoWithin`](https://docs.mongodb.com/manual/reference/operator/query/geoWithin/) with [`$centerSphere`](https://docs.mongodb.com/manual/reference/operator/query/centerSphere/#op._S_centerSphere)
+ * - `$where`: [`$expr`](https://www.mongodb.com/docs/manual/reference/operator/query/expr/)
+ * - `$near`: [`$geoWithin`](https://www.mongodb.com/docs/manual/reference/operator/query/geoWithin/) with [`$center`](https://www.mongodb.com/docs/manual/reference/operator/query/center/#op._S_center)
+ * - `$nearSphere`: [`$geoWithin`](https://www.mongodb.com/docs/manual/reference/operator/query/geoWithin/) with [`$centerSphere`](https://www.mongodb.com/docs/manual/reference/operator/query/centerSphere/#op._S_centerSphere)
  *
  * @param {Object} filter
  * @param {Function} [callback]
@@ -2445,8 +2445,8 @@ Model.countDocuments = function countDocuments(conditions, options, callback) {
  * Counts number of documents that match `filter` in a database collection.
  *
  * This method is deprecated. If you want to count the number of documents in
- * a collection, e.g. `count({})`, use the [`estimatedDocumentCount()` function](/docs/api/model.html#model_Model-estimatedDocumentCount)
- * instead. Otherwise, use the [`countDocuments()`](/docs/api/model.html#model_Model-countDocuments) function instead.
+ * a collection, e.g. `count({})`, use the [`estimatedDocumentCount()` function](#model_Model-estimatedDocumentCount)
+ * instead. Otherwise, use the [`countDocuments()`](#model_Model-countDocuments) function instead.
  *
  * #### Example:
  *
@@ -2615,7 +2615,7 @@ Model.$where = function $where() {
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](/docs/transactions.html).
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Note that this allows you to overwrite timestamps. Does nothing if schema-level timestamps are not set.
- * @param {Boolean} [options.overwrite=false] By default, if you don't include any [update operators](https://docs.mongodb.com/manual/reference/operator/update/) in `update`, Mongoose will wrap `update` in `$set` for you. This prevents you from accidentally overwriting the document. This option tells Mongoose to skip adding `$set`. An alternative to this would be using [Model.findOneAndReplace(conditions, update, options, callback)](https://mongoosejs.com/docs/api/model.html#model_Model-findOneAndReplace).
+ * @param {Boolean} [options.overwrite=false] By default, if you don't include any [update operators](https://www.mongodb.com/docs/manual/reference/operator/update/) in `update`, Mongoose will wrap `update` in `$set` for you. This prevents you from accidentally overwriting the document. This option tells Mongoose to skip adding `$set`. An alternative to this would be using [Model.findOneAndReplace(conditions, update, options, callback)](#model_Model-findOneAndReplace).
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
  * @param {Object|String|String[]} [options.projection=null] optional fields to return, see [`Query.prototype.select()`](#query_Query-select)
  * @param {Boolean} [options.new=false] if true, return the modified document rather than the original
@@ -2628,7 +2628,7 @@ Model.$where = function $where() {
  * @param {Function} [callback]
  * @return {Query}
  * @see Tutorial /docs/tutorials/findoneandupdate.html
- * @see mongodb https://www.mongodb.org/display/DOCS/findAndModify+Command
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  * @api public
  */
 
@@ -2748,7 +2748,7 @@ function _decorateUpdateWithVersionKey(update, options, versionKey) {
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](/docs/transactions.html).
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Note that this allows you to overwrite timestamps. Does nothing if schema-level timestamps are not set.
- * @param {Boolean} [options.overwrite=false] By default, if you don't include any [update operators](https://docs.mongodb.com/manual/reference/operator/update/) in `update`, Mongoose will wrap `update` in `$set` for you. This prevents you from accidentally overwriting the document. This option tells Mongoose to skip adding `$set`. An alternative to this would be using [Model.findOneAndReplace({ _id: id }, update, options, callback)](https://mongoosejs.com/docs/api/model.html#model_Model-findOneAndReplace).
+ * @param {Boolean} [options.overwrite=false] By default, if you don't include any [update operators](https://www.mongodb.com/docs/manual/reference/operator/update/) in `update`, Mongoose will wrap `update` in `$set` for you. This prevents you from accidentally overwriting the document. This option tells Mongoose to skip adding `$set`. An alternative to this would be using [Model.findOneAndReplace({ _id: id }, update, options, callback)](#model_Model-findOneAndReplace).
  * @param {Object|String} [options.sort] if multiple docs are found by the conditions, sets the sort order to choose which doc to update.
  * @param {Boolean} [options.runValidators] if true, runs [update validators](/docs/validation.html#update-validators) on this command. Update validators validate the update operation against the model's schema
  * @param {Boolean} [options.setDefaultsOnInsert=true] If `setDefaultsOnInsert` and `upsert` are true, mongoose will apply the [defaults](https://mongoosejs.com/docs/defaults.html) specified in the model's schema if a new document is created
@@ -2759,7 +2759,7 @@ function _decorateUpdateWithVersionKey(update, options, versionKey) {
  * @param {Function} [callback]
  * @return {Query}
  * @see Model.findOneAndUpdate #model_Model-findOneAndUpdate
- * @see mongodb https://www.mongodb.org/display/DOCS/findAndModify+Command
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  * @api public
  */
 
@@ -2799,7 +2799,7 @@ Model.findByIdAndUpdate = function(id, update, options, callback) {
  * - `findOneAndDelete()`
  *
  * This function differs slightly from `Model.findOneAndRemove()` in that
- * `findOneAndRemove()` becomes a [MongoDB `findAndModify()` command](https://docs.mongodb.com/manual/reference/method/db.collection.findAndModify/),
+ * `findOneAndRemove()` becomes a [MongoDB `findAndModify()` command](https://www.mongodb.com/docs/manual/reference/method/db.collection.findAndModify/),
  * as opposed to a `findOneAndDelete()` command. For most mongoose use cases,
  * this distinction is purely pedantic. You should use `findOneAndDelete()`
  * unless you have a good reason not to.
@@ -2880,7 +2880,7 @@ Model.findOneAndDelete = function(conditions, options, callback) {
  * @param {Function} [callback]
  * @return {Query}
  * @see Model.findOneAndRemove #model_Model-findOneAndRemove
- * @see mongodb https://www.mongodb.org/display/DOCS/findAndModify+Command
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  */
 
 Model.findByIdAndDelete = function(id, options, callback) {
@@ -3013,7 +3013,7 @@ Model.findOneAndReplace = function(filter, replacement, options, callback) {
  * @param {Number} [options.maxTimeMS] puts a time limit on the query - requires mongodb >= 2.6.0
  * @param {Function} [callback]
  * @return {Query}
- * @see mongodb https://www.mongodb.org/display/DOCS/findAndModify+Command
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  * @api public
  */
 
@@ -3076,7 +3076,7 @@ Model.findOneAndRemove = function(conditions, options, callback) {
  * @param {Function} [callback]
  * @return {Query}
  * @see Model.findOneAndRemove #model_Model-findOneAndRemove
- * @see mongodb https://www.mongodb.org/display/DOCS/findAndModify+Command
+ * @see mongodb https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  */
 
 Model.findByIdAndRemove = function(id, options, callback) {
@@ -3242,7 +3242,7 @@ Model.create = function create(doc, options, callback) {
 /**
  * _Requires a replica set running MongoDB >= 3.6.0._ Watches the
  * underlying collection for changes using
- * [MongoDB change streams](https://docs.mongodb.com/manual/changeStreams/).
+ * [MongoDB change streams](https://www.mongodb.com/docs/manual/changeStreams/).
  *
  * This function does **not** trigger any middleware. In particular, it
  * does **not** trigger aggregate middleware.
@@ -3299,8 +3299,8 @@ Model.watch = function(pipeline, options) {
 };
 
 /**
- * _Requires MongoDB >= 3.6.0._ Starts a [MongoDB session](https://docs.mongodb.com/manual/release-notes/3.6/#client-sessions)
- * for benefits like causal consistency, [retryable writes](https://docs.mongodb.com/manual/core/retryable-writes/),
+ * _Requires MongoDB >= 3.6.0._ Starts a [MongoDB session](https://www.mongodb.com/docs/manual/release-notes/3.6/#client-sessions)
+ * for benefits like causal consistency, [retryable writes](https://www.mongodb.com/docs/manual/core/retryable-writes/),
  * and [transactions](https://thecodebarbarian.com/a-node-js-perspective-on-mongodb-4-transactions.html).
  *
  * Calling `MyModel.startSession()` is equivalent to calling `MyModel.db.startSession()`.
@@ -3340,7 +3340,7 @@ Model.startSession = function() {
  * Mongoose always validates each document **before** sending `insertMany`
  * to MongoDB. So if one document has a validation error, no documents will
  * be saved, unless you set
- * [the `ordered` option to false](https://docs.mongodb.com/manual/reference/method/db.collection.insertMany/#error-handling).
+ * [the `ordered` option to false](https://www.mongodb.com/docs/manual/reference/method/db.collection.insertMany/#error-handling).
  *
  * This function does **not** trigger save middleware.
  *
@@ -3615,7 +3615,7 @@ function _setIsNew(doc, val) {
  *
  * This function does **not** trigger any middleware, neither `save()`, nor `update()`.
  * If you need to trigger
- * `save()` middleware for every document use [`create()`](https://mongoosejs.com/docs/api/model.html#model_Model-create) instead.
+ * `save()` middleware for every document use [`create()`](#model_Model-create) instead.
  *
  * #### Example:
  *
@@ -3647,7 +3647,7 @@ function _setIsNew(doc, val) {
  *      console.log(res.insertedCount, res.modifiedCount, res.deletedCount);
  *     });
  *
- * The [supported operations](https://docs.mongodb.com/manual/reference/method/db.collection.bulkWrite/#db.collection.bulkWrite) are:
+ * The [supported operations](https://www.mongodb.com/docs/manual/reference/method/db.collection.bulkWrite/#db.collection.bulkWrite) are:
  *
  * - `insertOne`
  * - `updateOne`
@@ -3659,13 +3659,13 @@ function _setIsNew(doc, val) {
  * @param {Array} ops
  * @param {Object} [ops.insertOne.document] The document to insert
  * @param {Object} [ops.updateOne.filter] Update the first document that matches this filter
- * @param {Object} [ops.updateOne.update] An object containing [update operators](https://docs.mongodb.com/manual/reference/operator/update/)
+ * @param {Object} [ops.updateOne.update] An object containing [update operators](https://www.mongodb.com/docs/manual/reference/operator/update/)
  * @param {Boolean} [ops.updateOne.upsert=false] If true, insert a doc if none match
  * @param {Boolean} [ops.updateOne.timestamps=true] If false, do not apply [timestamps](https://mongoosejs.com/docs/guide.html#timestamps) to the operation
  * @param {Object} [ops.updateOne.collation] The [MongoDB collation](https://thecodebarbarian.com/a-nodejs-perspective-on-mongodb-34-collations) to use
  * @param {Array} [ops.updateOne.arrayFilters] The [array filters](https://thecodebarbarian.com/a-nodejs-perspective-on-mongodb-36-array-filters.html) used in `update`
  * @param {Object} [ops.updateMany.filter] Update all the documents that match this filter
- * @param {Object} [ops.updateMany.update] An object containing [update operators](https://docs.mongodb.com/manual/reference/operator/update/)
+ * @param {Object} [ops.updateMany.update] An object containing [update operators](https://www.mongodb.com/docs/manual/reference/operator/update/)
  * @param {Boolean} [ops.updateMany.upsert=false] If true, insert a doc if no documents match `filter`
  * @param {Boolean} [ops.updateMany.timestamps=true] If false, do not apply [timestamps](https://mongoosejs.com/docs/guide.html#timestamps) to the operation
  * @param {Object} [ops.updateMany.collation] The [MongoDB collation](https://thecodebarbarian.com/a-nodejs-perspective-on-mongodb-34-collations) to use
@@ -3678,11 +3678,11 @@ function _setIsNew(doc, val) {
  * @param {Object} [options]
  * @param {Boolean} [options.ordered=true] If true, execute writes in order and stop at the first error. If false, execute writes in parallel and continue until all writes have either succeeded or errored.
  * @param {ClientSession} [options.session=null] The session associated with this bulk write. See [transactions docs](/docs/transactions.html).
- * @param {String|number} [options.w=1] The [write concern](https://docs.mongodb.com/manual/reference/write-concern/). See [`Query#w()`](/docs/api/query.html#query_Query-w) for more information.
- * @param {number} [options.wtimeout=null] The [write concern timeout](https://docs.mongodb.com/manual/reference/write-concern/#wtimeout).
- * @param {Boolean} [options.j=true] If false, disable [journal acknowledgement](https://docs.mongodb.com/manual/reference/write-concern/#j-option)
+ * @param {String|number} [options.w=1] The [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/). See [`Query#w()`](/docs/api/query.html#query_Query-w) for more information.
+ * @param {number} [options.wtimeout=null] The [write concern timeout](https://www.mongodb.com/docs/manual/reference/write-concern/#wtimeout).
+ * @param {Boolean} [options.j=true] If false, disable [journal acknowledgement](https://www.mongodb.com/docs/manual/reference/write-concern/#j-option)
  * @param {Boolean} [options.skipValidation=false] Set to true to skip Mongoose schema validation on bulk write operations. Mongoose currently runs validation on `insertOne` and `replaceOne` operations by default.
- * @param {Boolean} [options.bypassDocumentValidation=false] If true, disable [MongoDB server-side schema validation](https://docs.mongodb.com/manual/core/schema-validation/) for all writes in this bulk.
+ * @param {Boolean} [options.bypassDocumentValidation=false] If true, disable [MongoDB server-side schema validation](https://www.mongodb.com/docs/manual/core/schema-validation/) for all writes in this bulk.
  * @param {Boolean} [options.strict=null] Overwrites the [`strict` option](/docs/guide.html#strict) on schema. If false, allows filtering and writing fields not defined in the schema for all writes in this bulk.
  * @param {Function} [callback] callback `function(error, bulkWriteOpResult) {}`
  * @return {Promise} resolves to a [`BulkWriteOpResult`](https://mongodb.github.io/node-mongodb-native/4.9/classes/BulkWriteResult.html) if the operation succeeds
@@ -3737,9 +3737,9 @@ Model.bulkWrite = function(ops, options, callback) {
  * @param {Object} [options] options passed to the underlying `bulkWrite()`
  * @param {Boolean} [options.timestamps] defaults to `null`, when set to false, mongoose will not add/update timestamps to the documents.
  * @param {ClientSession} [options.session=null] The session associated with this bulk write. See [transactions docs](/docs/transactions.html).
- * @param {String|number} [options.w=1] The [write concern](https://docs.mongodb.com/manual/reference/write-concern/). See [`Query#w()`](/docs/api/query.html#query_Query-w) for more information.
- * @param {number} [options.wtimeout=null] The [write concern timeout](https://docs.mongodb.com/manual/reference/write-concern/#wtimeout).
- * @param {Boolean} [options.j=true] If false, disable [journal acknowledgement](https://docs.mongodb.com/manual/reference/write-concern/#j-option)
+ * @param {String|number} [options.w=1] The [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/). See [`Query#w()`](/docs/api/query.html#query_Query-w) for more information.
+ * @param {number} [options.wtimeout=null] The [write concern timeout](https://www.mongodb.com/docs/manual/reference/write-concern/#wtimeout).
+ * @param {Boolean} [options.j=true] If false, disable [journal acknowledgement](https://www.mongodb.com/docs/manual/reference/write-concern/#j-option)
  *
  */
 Model.bulkSave = async function(documents, options) {
@@ -3807,7 +3807,7 @@ function handleSuccessfulWrite(document) {
     }
 
     document.$__reset();
-    document.schema.s.hooks.execPost('save', document, {}, (err) => {
+    document.schema.s.hooks.execPost('save', document, [document], {}, (err) => {
       if (err) {
         reject(err);
         return;
@@ -4065,10 +4065,10 @@ Model.hydrate = function(obj, projection, options) {
  *
  *  - `strict` (boolean): overrides the [schema-level `strict` option](/docs/guide.html#strict) for this update
  *  - `upsert` (boolean): whether to create the doc if it doesn't match (false)
- *  - `writeConcern` (object): sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ *  - `writeConcern` (object): sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  *  - `multi` (boolean): whether multiple documents should be updated (false)
  *  - `runValidators`: if true, runs [update validators](/docs/validation.html#update-validators) on this command. Update validators validate the update operation against the model's schema.
- *  - `setDefaultsOnInsert` (boolean): if this and `upsert` are true, mongoose will apply the [defaults](https://mongoosejs.com/docs/defaults.html) specified in the model's schema if a new document is created. This option only works on MongoDB >= 2.4 because it relies on [MongoDB's `$setOnInsert` operator](https://docs.mongodb.org/v2.4/reference/operator/update/setOnInsert/).
+ *  - `setDefaultsOnInsert` (boolean): if this and `upsert` are true, mongoose will apply the [defaults](https://mongoosejs.com/docs/defaults.html) specified in the model's schema if a new document is created. This option only works on MongoDB >= 2.4 because it relies on [MongoDB's `$setOnInsert` operator](https://www.mongodb.com/docs/manual/reference/operator/update/setOnInsert/).
  *  - `timestamps` (boolean): If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
  *  - `overwrite` (boolean): disables update-only mode, allowing you to overwrite the doc (false)
  *
@@ -4100,21 +4100,21 @@ Model.hydrate = function(obj, projection, options) {
  *
  * @deprecated
  * @see strict https://mongoosejs.com/docs/guide.html#strict
- * @see response https://docs.mongodb.org/v2.6/reference/command/update/#output
+ * @see response https://mongodb.github.io/node-mongodb-native/4.9/classes/Collection.html#update
  * @param {Object} filter
  * @param {Object} doc
  * @param {Object} [options] optional see [`Query.prototype.setOptions()`](/docs/api/query.html#query_Query-setOptions)
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.multi=false] whether multiple documents should be updated or just the first one that matches `filter`.
  * @param {Boolean} [options.runValidators=false] if true, runs [update validators](/docs/validation.html#update-validators) on this command. Update validators validate the update operation against the model's schema.
  * @param {Boolean} [options.setDefaultsOnInsert=false] `true` by default. If `setDefaultsOnInsert` and `upsert` are true, mongoose will apply the [defaults](https://mongoosejs.com/docs/defaults.html) specified in the model's schema if a new document is created.
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
- * @param {Boolean} [options.overwrite=false] By default, if you don't include any [update operators](https://docs.mongodb.com/manual/reference/operator/update/) in `doc`, Mongoose will wrap `doc` in `$set` for you. This prevents you from accidentally overwriting the document. This option tells Mongoose to skip adding `$set`.
+ * @param {Boolean} [options.overwrite=false] By default, if you don't include any [update operators](https://www.mongodb.com/docs/manual/reference/operator/update/) in `doc`, Mongoose will wrap `doc` in `$set` for you. This prevents you from accidentally overwriting the document. This option tells Mongoose to skip adding `$set`.
  * @param {Function} [callback] params are (error, [updateWriteOpResult](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html))
  * @return {Query}
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/command/update/#update-command-output
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/command/update/#update-command-output
  * @see UpdateResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html
  * @see Query docs https://mongoosejs.com/docs/queries.html
  * @api public
@@ -4152,12 +4152,12 @@ Model.update = function update(conditions, doc, options, callback) {
  * @param {Object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#query_Query-setOptions)
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
  * @param {Function} [callback] `function(error, res) {}` where `res` has 5 properties: `modifiedCount`, `matchedCount`, `acknowledged`, `upsertedId`, and `upsertedCount`.
  * @return {Query}
  * @see Query docs https://mongoosejs.com/docs/queries.html
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/command/update/#update-command-output
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/command/update/#update-command-output
  * @see UpdateResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html
  * @api public
  */
@@ -4193,12 +4193,12 @@ Model.updateMany = function updateMany(conditions, doc, options, callback) {
  * @param {Object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#query_Query-setOptions)
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Note that this allows you to overwrite timestamps. Does nothing if schema-level timestamps are not set.
  * @param {Function} [callback] params are (error, writeOpResult)
  * @return {Query}
  * @see Query docs https://mongoosejs.com/docs/queries.html
- * @see MongoDB docs https://docs.mongodb.com/manual/reference/command/update/#update-command-output
+ * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/command/update/#update-command-output
  * @see UpdateResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/UpdateResult.html
  * @api public
  */
@@ -4231,7 +4231,7 @@ Model.updateOne = function updateOne(conditions, doc, options, callback) {
  * @param {Object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#query_Query-setOptions)
  * @param {Boolean|String} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {Boolean} [options.upsert=false] if true, and no documents found, insert a new document
- * @param {Object} [options.writeConcern=null] sets the [write concern](https://docs.mongodb.com/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
+ * @param {Object} [options.writeConcern=null] sets the [write concern](https://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](/docs/guide.html#writeConcern)
  * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
  * @param {Function} [callback] `function(error, res) {}` where `res` has 3 properties: `n`, `nModified`, `ok`.
  * @return {Query}
@@ -4345,7 +4345,7 @@ function _update(model, op, conditions, doc, options, callback) {
  * @param {String} [opts.out.reduce] add the results to collectionName: if dups are detected, uses the reducer / finalize functions
  * @param {String} [opts.out.merge] add the results to collectionName: if dups exist the new docs overwrite the old
  * @param {Function} [callback] optional callback
- * @see MongoDB MapReduce https://www.mongodb.org/display/DOCS/MapReduce
+ * @see MongoDB MapReduce https://www.mongodb.com/docs/manual/core/map-reduce/
  * @return {Promise}
  * @api public
  */
@@ -4398,7 +4398,7 @@ Model.mapReduce = function mapReduce(opts, callback) {
 };
 
 /**
- * Performs [aggregations](https://docs.mongodb.org/manual/applications/aggregation/) on the models collection.
+ * Performs [aggregations](https://www.mongodb.com/docs/manual/applications/aggregation/) on the models collection.
  *
  * If a `callback` is passed, the `aggregate` is executed and a `Promise` is returned. If a callback is not passed, the `aggregate` itself is returned.
  *
@@ -4432,10 +4432,10 @@ Model.mapReduce = function mapReduce(opts, callback) {
  *
  * - [Mongoose `Aggregate`](/docs/api/aggregate.html)
  * - [An Introduction to Mongoose Aggregate](https://masteringjs.io/tutorials/mongoose/aggregate)
- * - [MongoDB Aggregation docs](https://docs.mongodb.org/manual/applications/aggregation/)
+ * - [MongoDB Aggregation docs](https://www.mongodb.com/docs/manual/applications/aggregation/)
  *
  * @see Aggregate #aggregate_Aggregate
- * @see MongoDB https://docs.mongodb.org/manual/applications/aggregation/
+ * @see MongoDB https://www.mongodb.com/docs/manual/applications/aggregation/
  * @param {Array} [pipeline] aggregation pipeline as an array of objects
  * @param {Object} [options] aggregation options
  * @param {Function} [callback]
@@ -4641,7 +4641,7 @@ Model.validate = function validate(obj, pathsToValidate, context, callback) {
  * @param {boolean} [options.retainNullValues=false] By default, Mongoose removes null and undefined values from populated arrays. Use this option to make `populate()` retain `null` and `undefined` array entries.
  * @param {boolean} [options.getters=false] If true, Mongoose will call any getters defined on the `localField`. By default, Mongoose gets the raw value of `localField`. For example, you would need to set this option to `true` if you wanted to [add a `lowercase` getter to your `localField`](/docs/schematypes.html#schematype-options).
  * @param {boolean} [options.clone=false] When you do `BlogPost.find().populate('author')`, blog posts with the same author will share 1 copy of an `author` doc. Enable this option to make Mongoose clone populated docs before assigning them.
- * @param {Object|Function} [options.match=null] Add an additional filter to the populate query. Can be a filter object containing [MongoDB query syntax](https://docs.mongodb.com/manual/tutorial/query-documents/), or a function that returns a filter object.
+ * @param {Object|Function} [options.match=null] Add an additional filter to the populate query. Can be a filter object containing [MongoDB query syntax](https://www.mongodb.com/docs/manual/tutorial/query-documents/), or a function that returns a filter object.
  * @param {Boolean} [options.skipInvalidIds=false] By default, Mongoose throws a cast error if `localField` and `foreignField` schemas don't line up. If you enable this option, Mongoose will instead filter out any `localField` properties that cannot be casted to `foreignField`'s schema type.
  * @param {Number} [options.perDocumentLimit=null] For legacy reasons, `limit` with `populate()` may give incorrect results because it only executes a single query for every document being populated. If you set `perDocumentLimit`, Mongoose will ensure correct `limit` per document by executing a separate query for each document to `populate()`. For example, `.find().populate({ path: 'test', perDocumentLimit: 2 })` will execute 2 additional queries if `.find()` returns 2 documents.
  * @param {Boolean} [options.strictPopulate=true] Set to false to allow populating paths that aren't defined in the given model's schema.