mongoose 9.2.2 → 9.2.4

package/lib/query.js

@@ -101,10 +101,10 @@ const opToThunk = new Map([
  *     // this unless you're an advanced user with a very good reason to.
  *     const query = new mongoose.Query();
  *
- * @param {Object} [options]
- * @param {Object} [model]
- * @param {Object} [conditions]
- * @param {Object} [collection] Mongoose collection
+ * @param {object} [options]
+ * @param {object} [model]
+ * @param {object} [conditions]
+ * @param {object} [collection] Mongoose collection
  * @api public
  */
 
@@ -379,7 +379,7 @@ Query.prototype.clone = function() {
  *
  * @see $where https://www.mongodb.com/docs/manual/reference/operator/where/
  * @method $where
- * @param {String|Function} js javascript string or function
+ * @param {string|Function} js javascript string or function
  * @return {Query} this
  * @memberOf Query
  * @instance
@@ -411,7 +411,7 @@ Query.prototype.clone = function() {
  * @method where
  * @memberOf Query
  * @instance
- * @param {String|Object} [path]
+ * @param {string|object} [path]
  * @param {any} [val]
  * @return {Query} this
  * @api public
@@ -447,8 +447,8 @@ Query.prototype.clone = function() {
  * @method slice
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Number|Array} val number of elements to slice or array with number of elements to skip and number of elements to slice
+ * @param {string} [path]
+ * @param {number|Array} val number of elements to slice or array with number of elements to skip and number of elements to slice
  * @return {Query} this
  * @see mongodb https://www.mongodb.com/docs/manual/tutorial/query-documents/#projection
  * @see $slice https://www.mongodb.com/docs/manual/reference/projection/slice/#prj._S_slice
@@ -529,7 +529,7 @@ Query.prototype._validateOp = function() {
  * @method equals
  * @memberOf Query
  * @instance
- * @param {Object} val
+ * @param {object} val
  * @return {Query} this
  * @api public
  */
@@ -597,8 +597,8 @@ Query.prototype._validateOp = function() {
  * @method gt
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Number} val
+ * @param {string} [path]
+ * @param {number} val
  * @see $gt https://www.mongodb.com/docs/manual/reference/operator/gt/
  * @api public
  */
@@ -611,8 +611,8 @@ Query.prototype._validateOp = function() {
  * @method gte
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Number} val
+ * @param {string} [path]
+ * @param {number} val
  * @see $gte https://www.mongodb.com/docs/manual/reference/operator/gte/
  * @api public
  */
@@ -625,8 +625,8 @@ Query.prototype._validateOp = function() {
  * @method lt
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Number} val
+ * @param {string} [path]
+ * @param {number} val
  * @see $lt https://www.mongodb.com/docs/manual/reference/operator/lt/
  * @api public
  */
@@ -640,8 +640,8 @@ Query.prototype._validateOp = function() {
  * @see $lte https://www.mongodb.com/docs/manual/reference/operator/lte/
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Number} val
+ * @param {string} [path]
+ * @param {number} val
  * @api public
  */
 
@@ -654,7 +654,7 @@ Query.prototype._validateOp = function() {
  * @method ne
  * @memberOf Query
  * @instance
- * @param {String} [path]
+ * @param {string} [path]
  * @param {any} val
  * @api public
  */
@@ -668,7 +668,7 @@ Query.prototype._validateOp = function() {
  * @method in
  * @memberOf Query
  * @instance
- * @param {String} [path]
+ * @param {string} [path]
  * @param {Array} val
  * @api public
  */
@@ -682,7 +682,7 @@ Query.prototype._validateOp = function() {
  * @method nin
  * @memberOf Query
  * @instance
- * @param {String} [path]
+ * @param {string} [path]
  * @param {Array} val
  * @api public
  */
@@ -702,7 +702,7 @@ Query.prototype._validateOp = function() {
  * @method all
  * @memberOf Query
  * @instance
- * @param {String} [path]
+ * @param {string} [path]
  * @param {Array} val
  * @api public
  */
@@ -722,8 +722,8 @@ Query.prototype._validateOp = function() {
  * @method size
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Number} val
+ * @param {string} [path]
+ * @param {number} val
  * @api public
  */
 
@@ -736,8 +736,8 @@ Query.prototype._validateOp = function() {
  * @method regex
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {String|RegExp} val
+ * @param {string} [path]
+ * @param {string|RegExp} val
  * @api public
  */
 
@@ -750,8 +750,8 @@ Query.prototype._validateOp = function() {
  * @method maxDistance
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Number} val
+ * @param {string} [path]
+ * @param {number} val
  * @api public
  */
 
@@ -770,7 +770,7 @@ Query.prototype._validateOp = function() {
  * @method mod
  * @memberOf Query
  * @instance
- * @param {String} [path]
+ * @param {string} [path]
  * @param {Array} val must be of length 2, first element is `divisor`, 2nd element is `remainder`.
  * @return {Query} this
  * @see $mod https://www.mongodb.com/docs/manual/reference/operator/mod/
@@ -819,8 +819,8 @@ Query.prototype.mod = function() {
  * @method exists
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Boolean} val
+ * @param {string} [path]
+ * @param {boolean} val
  * @return {Query} this
  * @see $exists https://www.mongodb.com/docs/manual/reference/operator/exists/
  * @api public
@@ -848,8 +848,8 @@ Query.prototype.mod = function() {
  * @method elemMatch
  * @memberOf Query
  * @instance
- * @param {String|Object|Function} path
- * @param {Object|Function} filter
+ * @param {string|object|Function} path
+ * @param {object|Function} filter
  * @return {Query} this
  * @see $elemMatch https://www.mongodb.com/docs/manual/reference/operator/elemMatch/
  * @api public
@@ -908,7 +908,7 @@ Query.prototype.mod = function() {
  * @method limit
  * @memberOf Query
  * @instance
- * @param {Number} val
+ * @param {number} val
  * @api public
  */
 
@@ -941,7 +941,7 @@ Query.prototype.limit = function limit(v) {
  * @method skip
  * @memberOf Query
  * @instance
- * @param {Number} val
+ * @param {number} val
  * @see cursor.skip https://www.mongodb.com/docs/manual/reference/method/cursor.skip/
  * @api public
  */
@@ -975,7 +975,7 @@ Query.prototype.skip = function skip(v) {
  * @method batchSize
  * @memberOf Query
  * @instance
- * @param {Number} val
+ * @param {number} val
  * @see batchSize https://www.mongodb.com/docs/manual/reference/method/cursor.batchSize/
  * @api public
  */
@@ -994,7 +994,7 @@ Query.prototype.skip = function skip(v) {
  * @method comment
  * @memberOf Query
  * @instance
- * @param {String} val
+ * @param {string} val
  * @see comment https://www.mongodb.com/docs/manual/reference/operator/comment/
  * @api public
  */
@@ -1013,7 +1013,7 @@ Query.prototype.skip = function skip(v) {
  * @method hint
  * @memberOf Query
  * @instance
- * @param {Object} val a hint object
+ * @param {object} val a hint object
  * @return {Query} this
  * @see $hint https://www.mongodb.com/docs/manual/reference/operator/hint/
  * @api public
@@ -1044,8 +1044,8 @@ Query.prototype.skip = function skip(v) {
  * @method projection
  * @memberOf Query
  * @instance
- * @param {Object|null} arg
- * @return {Object} the current projection
+ * @param {object|null} arg
+ * @return {object} the current projection
  * @api public
  */
 
@@ -1102,7 +1102,7 @@ Query.prototype.projection = function(arg) {
  * @method select
  * @memberOf Query
  * @instance
- * @param {Object|String|String[]} arg
+ * @param {object|string|Array<string>} arg
  * @return {Query} this
  * @see SchemaType https://mongoosejs.com/docs/api/schematype.html
  * @api public
@@ -1206,7 +1206,7 @@ Query.prototype.select = function select() {
  * @method schemaLevelProjections
  * @memberOf Query
  * @instance
- * @param {Boolean} value
+ * @param {boolean} value
  * @return {Query} this
  * @see SchemaTypeOptions https://mongoosejs.com/docs/schematypes.html#all-schema-types
  * @api public
@@ -1259,7 +1259,7 @@ Query.prototype.schemaLevelProjections = function schemaLevelProjections(value)
  * @method sanitizeProjection
  * @memberOf Query
  * @instance
- * @param {Boolean} value
+ * @param {boolean} value
  * @return {Query} this
  * @see sanitizeProjection https://thecodebarbarian.com/whats-new-in-mongoose-5-13-sanitizeprojection.html
  * @api public
@@ -1319,7 +1319,7 @@ Query.prototype.sanitizeProjection = function sanitizeProjection(value) {
  * @method read
  * @memberOf Query
  * @instance
- * @param {String} mode one of the listed preference options or aliases
+ * @param {string} mode one of the listed preference options or aliases
  * @param {Array} [tags] optional tags for this query
  * @see mongodb https://www.mongodb.com/docs/manual/applications/replication/#read-preference
  * @return {Query} this
@@ -1432,7 +1432,7 @@ Query.prototype.session = function session(v) {
  * @method writeConcern
  * @memberOf Query
  * @instance
- * @param {Object} writeConcern the write concern value to set
+ * @param {object} writeConcern the write concern value to set
  * @see WriteConcernSettings https://mongodb.github.io/node-mongodb-native/4.9/interfaces/WriteConcernSettings.html
  * @return {Query} this
  * @api public
@@ -1473,7 +1473,7 @@ Query.prototype.writeConcern = function writeConcern(val) {
  * @method w
  * @memberOf Query
  * @instance
- * @param {String|number} val 0 for fire-and-forget, 1 for acknowledged by one server, 'majority' for majority of the replica set, or [any of the more advanced options](https://www.mongodb.com/docs/manual/reference/write-concern/#w-option).
+ * @param {string|number} val 0 for fire-and-forget, 1 for acknowledged by one server, 'majority' for majority of the replica set, or [any of the more advanced options](https://www.mongodb.com/docs/manual/reference/write-concern/#w-option).
  * @see mongodb https://www.mongodb.com/docs/manual/reference/write-concern/#w-option
  * @return {Query} this
  * @api public
@@ -1640,7 +1640,7 @@ Query.prototype.wtimeout = function wtimeout(ms) {
  *     query.setOptions({ maxTimeMS: 1000 });
  *     query.getOptions(); // { limit: 10, maxTimeMS: 1000 }
  *
- * @return {Object} the options
+ * @return {object} the options
  * @api public
  */
 
@@ -1700,7 +1700,7 @@ Query.prototype.getOptions = function() {
  * - [explain](https://www.mongodb.com/docs/manual/reference/method/cursor.explain/)
  * - [middleware](https://mongoosejs.com/docs/middleware.html#skipping): set to `false` to skip all user-defined middleware, or `{ pre: false }` / `{ post: false }` to skip only pre or post hooks
  *
- * @param {Object} options
+ * @param {object} options
  * @return {Query} this
  * @api public
  */
@@ -1860,7 +1860,7 @@ Query.prototype.explain = function explain(verbose) {
  *     // Equivalent:
  *     await query.find().sort({ name: 1 }).allowDiskUse();
  *
- * @param {Boolean} [v] Enable/disable `allowDiskUse`. If called with 0 arguments, sets `allowDiskUse: true`
+ * @param {boolean} [v] Enable/disable `allowDiskUse`. If called with 0 arguments, sets `allowDiskUse: true`
  * @return {Query} this
  * @api public
  */
@@ -1890,7 +1890,7 @@ Query.prototype.allowDiskUse = function(v) {
  *     // >= 1 doc in the queried collection
  *     const res = await query.find({ $where: 'sleep(1000) || true' }).maxTimeMS(100);
  *
- * @param {Number} [ms] The number of milliseconds
+ * @param {number} [ms] The number of milliseconds
  * @return {Query} this
  * @api public
  */
@@ -1909,7 +1909,7 @@ Query.prototype.maxTimeMS = function(ms) {
  *     query.find({ a: 1 }).where('b').gt(2);
  *     query.getFilter(); // { a: 1, b: { $gt: 2 } }
  *
- * @return {Object} current query filter
+ * @return {object} current query filter
  * @api public
  */
 
@@ -1929,7 +1929,7 @@ Query.prototype.getFilter = function() {
  *     query.find({ a: 1 }).where('b').gt(2);
  *     query.getQuery(); // { a: 1, b: { $gt: 2 } }
  *
- * @return {Object} current query filter
+ * @return {object} current query filter
  * @api public
  */
 
@@ -1947,7 +1947,7 @@ Query.prototype.getQuery = function() {
  *     query.setQuery({ a: 2 });
  *     query.getQuery(); // { a: 2 }
  *
- * @param {Object} new query conditions
+ * @param {object} new query conditions
  * @return {undefined}
  * @api public
  */
@@ -1965,7 +1965,7 @@ Query.prototype.setQuery = function(val) {
  *     query.updateOne({}, { $set: { a: 5 } });
  *     query.getUpdate(); // { $set: { a: 5 } }
  *
- * @return {Object} current update operations
+ * @return {object} current update operations
  * @api public
  */
 
@@ -1983,7 +1983,7 @@ Query.prototype.getUpdate = function() {
  *     query.setUpdate({ $set: { b: 6 } });
  *     query.getUpdate(); // { $set: { b: 6 } }
  *
- * @param {Object} new update operation
+ * @param {object} new update operation
  * @return {undefined}
  * @api public
  */
@@ -1996,7 +1996,7 @@ Query.prototype.setUpdate = function(val) {
  * Returns fields selection for this query.
  *
  * @method _fieldsForExec
- * @return {Object}
+ * @return {object}
  * @api private
  * @memberOf Query
  */
@@ -2016,7 +2016,7 @@ Query.prototype._fieldsForExec = function() {
  * Return an update document with corrected `$set` operations.
  *
  * @method _updateForExec
- * @return {Object}
+ * @return {object}
  * @api private
  * @memberOf Query
  */
@@ -2063,7 +2063,7 @@ Query.prototype._updateForExec = function() {
  * This method is inherited by `mquery`
  *
  * @method _ensurePath
- * @param {String} method
+ * @param {string} method
  * @api private
  * @memberOf Query
  */
@@ -2074,8 +2074,8 @@ Query.prototype._updateForExec = function() {
  * @method canMerge
  * @memberOf Query
  * @instance
- * @param {Object} conds
- * @return {Boolean}
+ * @param {object} conds
+ * @return {boolean}
  * @api private
  */
 
@@ -2188,7 +2188,7 @@ Query.prototype._optionsForExec = function(model) {
  * - [mongoose-lean-getters](https://plugins.mongoosejs.io/plugins/lean-getters)
  * - [mongoose-lean-defaults](https://www.npmjs.com/package/mongoose-lean-defaults)
  *
- * @param {Boolean|Object} bool defaults to true
+ * @param {boolean|object} bool defaults to true
  * @return {Query} this
  * @api public
  */
@@ -2209,8 +2209,8 @@ Query.prototype.lean = function(v) {
  *     new Query().updateOne({}, {}).set('updatedAt', new Date());
  *     new Query().updateMany({}, {}).set({ updatedAt: new Date() });
  *
- * @param {String|Object} path path or object of key/value pairs to set
- * @param {Any} [val] the value to set
+ * @param {string|object} path path or object of key/value pairs to set
+ * @param {any} [val] the value to set
  * @return {Query} this
  * @api public
  */
@@ -2243,7 +2243,7 @@ Query.prototype.set = function(path, val) {
  *     const query = Model.updateOne({}, { $set: { name: 'Jean-Luc Picard' } });
  *     query.get('name'); // 'Jean-Luc Picard'
  *
- * @param {String|Object} path path or object of key/value pairs to get
+ * @param {string|object} path path or object of key/value pairs to get
  * @return {Query} this
  * @api public
  */
@@ -2338,8 +2338,8 @@ Query.prototype._unsetCastError = function _unsetCastError() {
  * Mongoose sends `Query.prototype.options` to the MongoDB server, and the
  * above options are not relevant for the MongoDB server.
  *
- * @param {Object} options if specified, overwrites the current options
- * @return {Object} the options
+ * @param {object} options if specified, overwrites the current options
+ * @return {object} the options
  * @api public
  */
 
@@ -2482,7 +2482,7 @@ Query.prototype._find = async function _find() {
  *
  *     const arr = await Movie.find({ year: { $gte: 1980, $lte: 1989 } });
  *
- * @param {Object|ObjectId} [filter] mongodb filter. If not specified, returns all documents.
+ * @param {object|ObjectId} [filter] mongodb filter. If not specified, returns all documents.
  * @return {Query} this
  * @api public
  */
@@ -2511,7 +2511,7 @@ Query.prototype.find = function(conditions) {
  *
  * When a Query is passed, conditions, field selection and options are merged.
  *
- * @param {Query|Object} source
+ * @param {Query|object} source
  * @return {Query} this
  */
 
@@ -2602,7 +2602,7 @@ Query.prototype.merge = function(source) {
 /**
  * Adds a collation to this op (MongoDB 3.4 and up)
  *
- * @param {Object} value
+ * @param {object} value
  * @return {Query} this
  * @see MongoDB docs https://www.mongodb.com/docs/manual/reference/method/cursor.collation/#cursor.collation
  * @api public
@@ -2679,9 +2679,9 @@ Query.prototype._completeOne = function(doc, res, projection, callback) {
  * of the model. Used to initialize docs returned from the db from `find()`
  *
  * @param {Array} docs
- * @param {Object} fields the projection used, including `select` from schemas
- * @param {Object} userProvidedFields the user-specified projection
- * @param {Object} [opts]
+ * @param {object} fields the projection used, including `select` from schemas
+ * @param {object} userProvidedFields the user-specified projection
+ * @param {object} [opts]
  * @param {Array} [opts.populated]
  * @param {ClientSession} [opts.session]
  * @api private
@@ -2758,10 +2758,10 @@ Query.prototype._findOne = async function _findOne() {
  *     const query = Kitten.where({ color: 'white' });
  *     const kitten = await query.findOne();
  *
- * @param {Object} [filter] mongodb selector
- * @param {Object} [projection] optional fields to return
- * @param {Object} [options] see [`setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
- * @param {Boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {object} [filter] mongodb selector
+ * @param {object} [projection] optional fields to return
+ * @param {object} [options] see [`setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
+ * @param {boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
  * @return {Query} this
  * @see findOne https://www.mongodb.com/docs/manual/reference/method/db.collection.findOne/
  * @see Query.select https://mongoosejs.com/docs/api/query.html#Query.prototype.select()
@@ -2892,7 +2892,7 @@ Query.prototype._estimatedDocumentCount = async function _estimatedDocumentCount
  *
  *     await Model.find().estimatedDocumentCount();
  *
- * @param {Object} [options] passed transparently to the [MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/EstimatedDocumentCountOptions.html)
+ * @param {object} [options] passed transparently to the [MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/EstimatedDocumentCountOptions.html)
  * @return {Query} this
  * @see estimatedDocumentCount https://mongodb.github.io/node-mongodb-native/4.9/classes/Collection.html#estimatedDocumentCount
  * @api public
@@ -2944,8 +2944,8 @@ Query.prototype.estimatedDocumentCount = function(options) {
  * - `$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] mongodb selector
- * @param {Object} [options]
+ * @param {object} [filter] mongodb selector
+ * @param {object} [options]
  * @return {Query} this
  * @see countDocuments https://mongodb.github.io/node-mongodb-native/4.9/classes/Collection.html#countDocuments
  * @api public
@@ -3009,9 +3009,9 @@ Query.prototype.__distinct = async function __distinct() {
  *     distinct(field)
  *     distinct()
  *
- * @param {String} [field]
- * @param {Object|Query} [filter]
- * @param {Object} [options]
+ * @param {string} [field]
+ * @param {object|Query} [filter]
+ * @param {object} [options]
  * @return {Query} this
  * @see distinct https://www.mongodb.com/docs/manual/reference/method/db.collection.distinct/
  * @api public
@@ -3070,9 +3070,9 @@ Query.prototype.distinct = function(field, conditions, options) {
  *
  * Cannot be used with `distinct()`
  *
- * @param {Object|String|Array<Array<(string | number)>>} arg
- * @param {Object} [options]
- * @param {Boolean} [options.override=false] If true, replace existing sort options with `arg`
+ * @param {object|string|Array<Array<(string | number)>>} arg
+ * @param {object} [options]
+ * @param {boolean} [options.override=false] If true, replace existing sort options with `arg`
  * @return {Query} this
  * @see cursor.sort https://www.mongodb.com/docs/manual/reference/method/cursor.sort/
  * @api public
@@ -3179,9 +3179,9 @@ function _handleSortValue(val, key) {
  *     // `1` if MongoDB deleted a doc, `0` if no docs matched the filter `{ name: ... }`
  *     res.deletedCount;
  *
- * @param {Object|Query} [filter] mongodb selector
- * @param {Object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {object|Query} [filter] mongodb selector
+ * @param {object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @return {Query} this
  * @see DeleteResult https://mongodb.github.io/node-mongodb-native/6.15/interfaces/DeleteResult.html
  * @see deleteOne https://mongodb.github.io/node-mongodb-native/6.15/classes/Collection.html#deleteOne
@@ -3255,9 +3255,9 @@ Query.prototype._deleteOne = async function _deleteOne() {
  *     // `0` if no docs matched the filter, number of docs deleted otherwise
  *     res.deletedCount;
  *
- * @param {Object|Query} [filter] mongodb selector
- * @param {Object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {object|Query} [filter] mongodb selector
+ * @param {object} [options] optional see [`Query.prototype.setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @return {Query} this
  * @see DeleteResult https://mongodb.github.io/node-mongodb-native/6.15/interfaces/DeleteResult.html
  * @see deleteMany https://mongodb.github.io/node-mongodb-native/6.15/classes/Collection.html#deleteMany
@@ -3312,8 +3312,8 @@ Query.prototype._deleteMany = async function _deleteMany() {
  *
  * @param {Model} model
  * @param {Document} doc
- * @param {Object} res 3rd parameter to callback
- * @param {Object} fields
+ * @param {object} res 3rd parameter to callback
+ * @param {object} fields
  * @param {Query} self
  * @param {Array} [pop] array of paths used in population
  * @param {Function} callback
@@ -3402,22 +3402,22 @@ function prepareDiscriminatorCriteria(query) {
  * @method findOneAndUpdate
  * @memberOf Query
  * @instance
- * @param {Object|Query} [filter]
- * @param {Object} [update]
- * @param {Object} [options]
- * @param {Boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
- * @param {Boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
+ * @param {object|Query} [filter]
+ * @param {object} [update]
+ * @param {object} [options]
+ * @param {boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
+ * @param {boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](https://mongoosejs.com/docs/transactions.html).
- * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
- * @param {Boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied. **Deprecated:** Use `returnDocument: 'after'` instead of `new: true`, or `returnDocument: 'before'` instead of `new: false`.
- * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.lean()) and [the Mongoose lean tutorial](https://mongoosejs.com/docs/tutorials/lean.html).
- * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/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.returnOriginal=null] An alias for the `new` option. `returnOriginal: false` is equivalent to `new: true`. **Deprecated:** Use `returnDocument: 'after'` instead of `returnOriginal: false`, or `returnDocument: 'before'` instead of `returnOriginal: true`.
+ * @param {boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
+ * @param {boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied. **Deprecated:** Use `returnDocument: 'after'` instead of `new: true`, or `returnDocument: 'before'` instead of `new: false`.
+ * @param {object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.lean()) and [the Mongoose lean tutorial](https://mongoosejs.com/docs/tutorials/lean.html).
+ * @param {boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/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.returnOriginal=null] An alias for the `new` option. `returnOriginal: false` is equivalent to `new: true`. **Deprecated:** Use `returnDocument: 'after'` instead of `returnOriginal: false`, or `returnDocument: 'before'` instead of `returnOriginal: true`.
  * @param {'before'|'after'} [options.returnDocument='before'] Has two possible values, `'before'` and `'after'`. By default, it will return the document before the update was applied.
- * @param {Boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
- * @param {Boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
- * @param {Boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
+ * @param {boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @see Tutorial https://mongoosejs.com/docs/tutorials/findoneandupdate.html
  * @see findAndModify command https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  * @see ModifyResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html
@@ -3601,12 +3601,12 @@ Query.prototype._findOneAndUpdate = async function _findOneAndUpdate() {
  *
  * @method findOneAndDelete
  * @memberOf Query
- * @param {Object} [filter]
- * @param {Object} [options]
- * @param {Boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {object} [filter]
+ * @param {object} [options]
+ * @param {boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](https://mongoosejs.com/docs/transactions.html).
- * @param {Boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
+ * @param {boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @return {Query} this
  * @see findAndModify command https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  * @api public
@@ -3695,21 +3695,21 @@ Query.prototype._findOneAndDelete = async function _findOneAndDelete() {
  *
  * @method findOneAndReplace
  * @memberOf Query
- * @param {Object} [filter]
- * @param {Object} [replacement]
- * @param {Object} [options]
- * @param {Boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
+ * @param {object} [filter]
+ * @param {object} [replacement]
+ * @param {object} [options]
+ * @param {boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](https://mongoosejs.com/docs/transactions.html).
- * @param {Boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
- * @param {Boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied. **Deprecated:** Use `returnDocument: 'after'` instead of `new: true`, or `returnDocument: 'before'` instead of `new: false`.
- * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.lean()) and [the Mongoose lean tutorial](https://mongoosejs.com/docs/tutorials/lean.html).
+ * @param {boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
+ * @param {boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied. **Deprecated:** Use `returnDocument: 'after'` instead of `new: true`, or `returnDocument: 'before'` instead of `new: false`.
+ * @param {object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.lean()) and [the Mongoose lean tutorial](https://mongoosejs.com/docs/tutorials/lean.html).
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](https://mongoosejs.com/docs/transactions.html).
- * @param {Boolean|'throw'} [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](https://mongoosejs.com/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.returnOriginal=null] An alias for the `new` option. `returnOriginal: false` is equivalent to `new: true`. **Deprecated:** Use `returnDocument: 'after'` instead of `returnOriginal: false`, or `returnDocument: 'before'` instead of `returnOriginal: true`.
+ * @param {boolean|'throw'} [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](https://mongoosejs.com/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.returnOriginal=null] An alias for the `new` option. `returnOriginal: false` is equivalent to `new: true`. **Deprecated:** Use `returnDocument: 'after'` instead of `returnOriginal: false`, or `returnDocument: 'before'` instead of `returnOriginal: true`.
  * @param {'before'|'after'} [options.returnDocument='before'] Has two possible values, `'before'` and `'after'`. By default, it will return the document before the update was applied.
- * @param {Boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @return {Query} this
  * @api public
  */
@@ -3839,10 +3839,10 @@ Query.prototype._findOneAndReplace = async function _findOneAndReplace() {
  * @method findById
  * @memberOf Query
  * @instance
- * @param {Any} id value of `_id` to query by
- * @param {Object} [projection] optional fields to return
- * @param {Object} [options] see [`setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
- * @param {Boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {any} id value of `_id` to query by
+ * @param {object} [projection] optional fields to return
+ * @param {object} [options] see [`setOptions()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.setOptions())
+ * @param {boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
  * @return {Query} this
  * @see findOne https://www.mongodb.com/docs/manual/reference/method/db.collection.findOne/
  * @see Query.select https://mongoosejs.com/docs/api/query.html#Query.prototype.select()
@@ -3868,21 +3868,21 @@ Query.prototype.findById = function(id, projection, options) {
  * @method findByIdAndUpdate
  * @memberOf Query
  * @instance
- * @param {Any} id value of `_id` to query by
- * @param {Object} [doc]
- * @param {Object} [options]
- * @param {Boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
- * @param {Boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
+ * @param {any} id value of `_id` to query by
+ * @param {object} [doc]
+ * @param {object} [options]
+ * @param {boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
+ * @param {boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](https://mongoosejs.com/docs/transactions.html).
- * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
- * @param {Boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied. **Deprecated:** Use `returnDocument: 'after'` instead of `new: true`, or `returnDocument: 'before'` instead of `new: false`.
- * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.lean()) and [the Mongoose lean tutorial](https://mongoosejs.com/docs/tutorials/lean.html).
- * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/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.returnOriginal=null] An alias for the `new` option. `returnOriginal: false` is equivalent to `new: true`. **Deprecated:** Use `returnDocument: 'after'` instead of `returnOriginal: false`, or `returnDocument: 'before'` instead of `returnOriginal: true`.
+ * @param {boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
+ * @param {boolean} [options.new=false] By default, `findOneAndUpdate()` returns the document as it was **before** `update` was applied. If you set `new: true`, `findOneAndUpdate()` will instead give you the object after `update` was applied. **Deprecated:** Use `returnDocument: 'after'` instead of `new: true`, or `returnDocument: 'before'` instead of `new: false`.
+ * @param {object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](https://mongoosejs.com/docs/api/query.html#Query.prototype.lean()) and [the Mongoose lean tutorial](https://mongoosejs.com/docs/tutorials/lean.html).
+ * @param {boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/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.returnOriginal=null] An alias for the `new` option. `returnOriginal: false` is equivalent to `new: true`. **Deprecated:** Use `returnDocument: 'after'` instead of `returnOriginal: false`, or `returnDocument: 'before'` instead of `returnOriginal: true`.
  * @param {'before'|'after'} [options.returnDocument='before'] Has two possible values, `'before'` and `'after'`. By default, it will return the document before the update was applied.
- * @param {Boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
- * @param {Boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
- * @param {Boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
+ * @param {boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
+ * @param {boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
  * @see Tutorial https://mongoosejs.com/docs/tutorials/findoneandupdate.html
  * @see findAndModify command https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  * @see ModifyResult https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html
@@ -3907,10 +3907,10 @@ Query.prototype.findByIdAndUpdate = function(id, update, options) {
  * @method findByIdAndDelete
  * @memberOf Query
  * @param {any} id value of `_id` to query by
- * @param {Object} [options]
- * @param {Boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
+ * @param {object} [options]
+ * @param {boolean} [options.includeResultMetadata] if true, returns the full [ModifyResult from the MongoDB driver](https://mongodb.github.io/node-mongodb-native/4.9/interfaces/ModifyResult.html) rather than just the document
  * @param {ClientSession} [options.session=null] The session associated with this query. See [transactions docs](https://mongoosejs.com/docs/transactions.html).
- * @param {Boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
+ * @param {boolean|'throw'} [options.strict] overwrites the schema's [strict mode option](https://mongoosejs.com/docs/guide.html#strict)
  * @return {Query} this
  * @see findAndModify command https://www.mongodb.com/docs/manual/reference/command/findAndModify/
  * @api public
@@ -3954,8 +3954,8 @@ function convertNewToReturnDocument(options) {
 /**
  * Get options from query opts, falling back to the base mongoose object.
  * @param {Query} query
- * @param {Object} option
- * @param {Any} def
+ * @param {object} option
+ * @param {any} def
  * @api private
  */
 
@@ -4038,7 +4038,7 @@ function _completeManyLean(schema, docs, path, opts) {
  * Override mquery.prototype._mergeUpdate to handle mongoose objects in
  * updates.
  *
- * @param {Object} update
+ * @param {object} update
  * @method _mergeUpdate
  * @memberOf Query
  * @instance
@@ -4158,9 +4158,9 @@ async function _updateThunk(op) {
  * Mongoose calls this function internally to validate the query if
  * `runValidators` is set
  *
- * @param {Object} castedDoc the update, after casting
- * @param {Object} options the options from `_optionsForExec()`
- * @param {Boolean} isOverwriting
+ * @param {object} castedDoc the update, after casting
+ * @param {object} options the options from `_optionsForExec()`
+ * @param {boolean} isOverwriting
  * @method validate
  * @memberOf Query
  * @instance
@@ -4243,18 +4243,18 @@ Query.prototype._replaceOne = async function _replaceOne() {
  *
  * - `updateMany()`
  *
- * @param {Object} [filter]
- * @param {Object|Array} [update] the update command. If array, this update will be treated as an update pipeline and not casted.
- * @param {Object} [options]
- * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
- * @param {Boolean|'throw'} [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://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](https://mongoosejs.com/docs/guide.html#writeConcern)
- * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
- * @param {Boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
- * @param {Boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
- * @param {Boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {object} [filter]
+ * @param {object|Array} [update] the update command. If array, this update will be treated as an update pipeline and not casted.
+ * @param {object} [options]
+ * @param {boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
+ * @param {boolean|'throw'} [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://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](https://mongoosejs.com/docs/guide.html#writeConcern)
+ * @param {boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
+ * @param {boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
+ * @param {boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @return {Query} this
  * @see Model.update https://mongoosejs.com/docs/api/model.html#Model.update()
  * @see Query docs https://mongoosejs.com/docs/queries.html
@@ -4318,18 +4318,18 @@ Query.prototype.updateMany = function(conditions, doc, options, callback) {
  *
  * - `updateOne()`
  *
- * @param {Object} [filter]
- * @param {Object|Array} [update] the update command. If array, this update will be treated as an update pipeline and not casted.
- * @param {Object} [options]
- * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
- * @param {Boolean|'throw'} [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://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](https://mongoosejs.com/docs/guide.html#writeConcern)
- * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/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.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
- * @param {Boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
- * @param {Boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {object} [filter]
+ * @param {object|Array} [update] the update command. If array, this update will be treated as an update pipeline and not casted.
+ * @param {object} [options]
+ * @param {boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
+ * @param {boolean|'throw'} [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://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](https://mongoosejs.com/docs/guide.html#writeConcern)
+ * @param {boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/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.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {boolean} [options.overwriteDiscriminatorKey=false] Mongoose removes discriminator key updates from `update` by default, set `overwriteDiscriminatorKey` to `true` to allow updating the discriminator key
+ * @param {boolean} [options.overwriteImmutable=false] Mongoose removes updated immutable properties from `update` by default (excluding $setOnInsert). Set `overwriteImmutable` to `true` to allow updating immutable properties using other update operators.
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @return {Query} this
  * @see Model.update https://mongoosejs.com/docs/api/model.html#Model.update()
  * @see Query docs https://mongoosejs.com/docs/queries.html
@@ -4387,16 +4387,16 @@ Query.prototype.updateOne = function(conditions, doc, options, callback) {
  *
  * - `replaceOne()`
  *
- * @param {Object} [filter]
- * @param {Object} [doc] the update command
- * @param {Object} [options]
- * @param {Boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
- * @param {Boolean|'throw'} [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://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](https://mongoosejs.com/docs/guide.html#writeConcern)
- * @param {Boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
- * @param {Boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
- * @param {Boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
+ * @param {object} [filter]
+ * @param {object} [doc] the update command
+ * @param {object} [options]
+ * @param {boolean} [options.multipleCastError] by default, mongoose only returns the first error that occurred in casting the query. Turn on this option to aggregate all the cast errors.
+ * @param {boolean|'throw'} [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://www.mongodb.com/docs/manual/reference/write-concern/) for replica sets. Overrides the [schema-level write concern](https://mongoosejs.com/docs/guide.html#writeConcern)
+ * @param {boolean} [options.timestamps=null] If set to `false` and [schema-level timestamps](https://mongoosejs.com/docs/guide.html#timestamps) are enabled, skip timestamps for this update. Does nothing if schema-level timestamps are not set.
+ * @param {boolean} [options.translateAliases=null] If set to `true`, translates any schema-defined aliases in `filter`, `projection`, `update`, and `distinct`. Throws an error if there are any conflicts where both alias and raw property are defined on the same object.
+ * @param {boolean} [options.requireFilter=false] If true, throws an error if the filter is empty (`{}`)
  * @return {Query} this
  * @see Model.update https://mongoosejs.com/docs/api/model.html#Model.update()
  * @see Query docs https://mongoosejs.com/docs/queries.html
@@ -4437,10 +4437,10 @@ Query.prototype.replaceOne = function(conditions, doc, options, callback) {
 /**
  * Internal helper for update, updateMany, updateOne, replaceOne
  * @param {Query} query
- * @param {String} op
- * @param {Object} filter
+ * @param {string} op
+ * @param {object} filter
  * @param {Document} [doc]
- * @param {Object} [options]
+ * @param {object} [options]
  * @param {Function} callback
  * @api private
  */
@@ -4611,8 +4611,8 @@ function _orFailError(err, query) {
 
 /**
  * Wrapper function to call isPathSelectedInclusive on a query.
- * @param {String} path
- * @return {Boolean}
+ * @param {string} path
+ * @return {boolean}
  * @api public
  */
 
@@ -4628,7 +4628,7 @@ Query.prototype.isPathSelectedInclusive = function(path) {
  *     const promise = query.exec();
  *     const promise = query.exec('update');
  *
- * @param {String|Function} [operation]
+ * @param {string|Function} [operation]
  * @return {Promise}
  * @api public
  */
@@ -4806,7 +4806,7 @@ Query.prototype.finally = function(onFinally) {
  *     const q = Model.find();
  *     console.log(q); // Prints "Query { find }"
  *
- * @return {String}
+ * @return {string}
  * @api public
  * @method [Symbol.toStringTag]
  * @memberOf Query
@@ -4871,8 +4871,8 @@ Query.prototype.post = function(fn) {
 /**
  * Casts obj for an update command.
  *
- * @param {Object} obj
- * @return {Object} obj after casting its values
+ * @param {object} obj
+ * @return {object} obj after casting its values
  * @method _castUpdate
  * @memberOf Query
  * @instance
@@ -4942,18 +4942,18 @@ Query.prototype._castUpdate = function _castUpdate(obj) {
  * a response for each query has also been returned, the results are passed to
  * the callback.
  *
- * @param {Object|String|String[]} path either the path(s) to populate or an object specifying all parameters
- * @param {Object|String} [select] Field selection for the population query
+ * @param {object|string|Array<string>} path either the path(s) to populate or an object specifying all parameters
+ * @param {object|string} [select] Field selection for the population query
  * @param {Model} [model] The model you wish to use for population. If not specified, populate will look up the model by the name in the Schema's `ref` field.
- * @param {Object} [match] Conditions for the population query
- * @param {Object} [options] Options for the population query (sort, etc)
- * @param {String} [options.path=null] The path to populate.
+ * @param {object} [match] Conditions for the population query
+ * @param {object} [options] Options for the population query (sort, etc)
+ * @param {string} [options.path=null] The path to populate.
  * @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`](https://mongoosejs.com/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://www.mongodb.com/docs/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 {Function} [options.transform=null] Function that Mongoose will call on every populated document that allows you to transform the populated document.
- * @param {Object} [options.options=null] Additional options like `limit` and `lean`.
+ * @param {object} [options.options=null] Additional options like `limit` and `lean`.
  * @see population https://mongoosejs.com/docs/populate.html
  * @see Query#select https://mongoosejs.com/docs/api/query.html#Query.prototype.select()
  * @see Model.populate https://mongoosejs.com/docs/api/model.html#Model.populate()
@@ -5057,8 +5057,8 @@ function _getPopulatedPaths(list, arr, prefix) {
  * If `obj` is present, it is cast instead of this query.
  *
  * @param {Model} [model] the model to cast to. If not set, defaults to `this.model`
- * @param {Object} [obj]
- * @return {Object}
+ * @param {object} [obj]
+ * @return {object}
  * @api public
  */
 
@@ -5100,7 +5100,7 @@ Query.prototype.cast = function(model, obj) {
  *
  *     query.select({ ids: { $elemMatch: { $in: [hexString] }})
  *
- * @param {Object} fields
+ * @param {object} fields
  * @see https://github.com/Automattic/mongoose/issues/1091
  * @see https://www.mongodb.com/docs/manual/reference/projection/elemMatch/
  * @api private
@@ -5221,7 +5221,7 @@ Query.prototype._applyPaths = function applyPaths() {
  *   - `transform`: optional function which accepts a mongoose document. The return value of the function will be emitted on `data` and returned by `.next()`.
  *
  * @return {QueryCursor}
- * @param {Object} [options]
+ * @param {object} [options]
  * @see QueryCursor https://mongoosejs.com/docs/api/querycursor.html
  * @api public
  */
@@ -5258,10 +5258,10 @@ Query.prototype.cursor = function cursor(opts) {
  *
  * Cannot be used with `distinct()`
  *
- * @param {Boolean} bool defaults to true
- * @param {Object} [opts] options to set
- * @param {Boolean} [opts.awaitData] false by default. Set to true to keep the cursor open even if there's no data.
- * @param {Number} [opts.maxAwaitTimeMS] the maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query. Requires `tailable` and `awaitData` to be true
+ * @param {boolean} bool defaults to true
+ * @param {object} [opts] options to set
+ * @param {boolean} [opts.awaitData] false by default. Set to true to keep the cursor open even if there's no data.
+ * @param {number} [opts.maxAwaitTimeMS] the maximum amount of time for the server to wait on new documents to satisfy a tailable cursor query. Requires `tailable` and `awaitData` to be true
  * @see tailable https://www.mongodb.com/docs/manual/tutorial/create-tailable-cursor/
  * @api public
  */
@@ -5320,7 +5320,7 @@ Query.prototype.tailable = function(val, opts) {
  * @method intersects
  * @memberOf Query
  * @instance
- * @param {Object} [arg]
+ * @param {object} [arg]
  * @return {Query} this
  * @see $geometry https://www.mongodb.com/docs/manual/reference/operator/geometry/
  * @see geoIntersects https://www.mongodb.com/docs/manual/reference/operator/geoIntersects/
@@ -5359,7 +5359,7 @@ Query.prototype.tailable = function(val, opts) {
  * @method geometry
  * @memberOf Query
  * @instance
- * @param {Object} object Must contain a `type` property which is a String and a `coordinates` property which is an Array. See the examples.
+ * @param {object} object Must contain a `type` property which is a String and a `coordinates` property which is an Array. See the examples.
  * @return {Query} this
  * @see $geometry https://www.mongodb.com/docs/manual/reference/operator/geometry/
  * @see Geospatial Support Enhancements https://www.mongodb.com/docs/manual/release-notes/2.4/#geospatial-support-enhancements
@@ -5382,8 +5382,8 @@ Query.prototype.tailable = function(val, opts) {
  * @method near
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Object} val
+ * @param {string} [path]
+ * @param {object} val
  * @return {Query} this
  * @see $near https://www.mongodb.com/docs/manual/reference/operator/near/
  * @see $nearSphere https://www.mongodb.com/docs/manual/reference/operator/nearSphere/
@@ -5518,8 +5518,8 @@ Query.prototype[Symbol.asyncIterator] = function queryAsyncIterator() {
  * @method polygon
  * @memberOf Query
  * @instance
- * @param {String|Array} [path]
- * @param {...Array|Object} [coordinatePairs]
+ * @param {string|Array} [path]
+ * @param {...Array|object} [coordinatePairs]
  * @return {Query} this
  * @see $polygon https://www.mongodb.com/docs/manual/reference/operator/polygon/
  * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
@@ -5543,8 +5543,8 @@ Query.prototype[Symbol.asyncIterator] = function queryAsyncIterator() {
  * @see $box https://www.mongodb.com/docs/manual/reference/operator/box/
  * @see within() Query#within https://mongoosejs.com/docs/api/query.html#Query.prototype.within()
  * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
- * @param {Object|Array<Number>} val1 Lower Left Coordinates OR a object of lower-left(ll) and upper-right(ur) Coordinates
- * @param {Array<Number>} [val2] Upper Right Coordinates
+ * @param {object|Array<number>} val1 Lower Left Coordinates OR a object of lower-left(ll) and upper-right(ur) Coordinates
+ * @param {Array<number>} [val2] Upper Right Coordinates
  * @return {Query} this
  * @api public
  */
@@ -5587,8 +5587,8 @@ Query.prototype.box = function(ll, ur) {
  * @method circle
  * @memberOf Query
  * @instance
- * @param {String} [path]
- * @param {Object} area
+ * @param {string} [path]
+ * @param {object} area
  * @return {Query} this
  * @see $center https://www.mongodb.com/docs/manual/reference/operator/center/
  * @see $centerSphere https://www.mongodb.com/docs/manual/reference/operator/centerSphere/
@@ -5622,8 +5622,8 @@ Query.prototype.center = Query.base.circle;
  *     query.where('loc').within().centerSphere(area);
  *
  * @deprecated
- * @param {String} [path]
- * @param {Object} val
+ * @param {string} [path]
+ * @param {object} val
  * @return {Query} this
  * @see MongoDB Geospatial Indexing https://www.mongodb.com/docs/manual/core/geospatial-indexes/
  * @see $centerSphere https://www.mongodb.com/docs/manual/reference/operator/centerSphere/
@@ -5648,7 +5648,7 @@ Query.prototype.centerSphere = function() {
  * @method selected
  * @memberOf Query
  * @instance
- * @return {Boolean}
+ * @return {boolean}
  * @api public
  */
 
@@ -5662,7 +5662,7 @@ Query.prototype.centerSphere = function() {
  * @method selectedInclusively
  * @memberOf Query
  * @instance
- * @return {Boolean}
+ * @return {boolean}
  * @api public
  */
 
@@ -5681,7 +5681,7 @@ Query.prototype.selectedInclusively = function selectedInclusively() {
  * @method selectedExclusively
  * @memberOf Query
  * @instance
- * @return {Boolean}
+ * @return {boolean}
  * @api public
  */