mongoose 6.2.9 → 6.3.0

package/lib/aggregate.js

@@ -6,7 +6,7 @@
 
 const AggregationCursor = require('./cursor/AggregationCursor');
 const Query = require('./query');
-const applyGlobalMaxTimeMS = require('./helpers/query/applyGlobalMaxTimeMS');
+const { applyGlobalMaxTimeMS, applyGlobalDiskUse } = require('./helpers/query/applyGlobalOption');
 const getConstructorName = require('./helpers/getConstructorName');
 const prepareDiscriminatorPipeline = require('./helpers/aggregate/prepareDiscriminatorPipeline');
 const promiseOrCallback = require('./helpers/promiseOrCallback');
@@ -15,11 +15,13 @@ const utils = require('./utils');
 const read = Query.prototype.read;
 const readConcern = Query.prototype.readConcern;
 
+const validRedactStringValues = new Set(['$$DESCEND', '$$PRUNE', '$$KEEP']);
+
 /**
  * Aggregate constructor used for building aggregation pipelines. Do not
  * instantiate this class directly, use [Model.aggregate()](/docs/api.html#model_Model.aggregate) instead.
  *
- * ####Example:
+ * #### Example:
  *
  *     const aggregate = Model.aggregate([
  *       { $project: { a: 1, b: 1 } },
@@ -31,7 +33,7 @@ const readConcern = Query.prototype.readConcern;
  *       unwind('tags').
  *       exec(callback);
  *
- * ####Note:
+ * #### Note:
  *
  * - The documents returned are plain javascript objects, not mongoose documents (since any shape of document can be returned).
  * - Mongoose does **not** cast pipeline stages. The below will **not** work unless `_id` is a string in the database
@@ -63,19 +65,21 @@ function Aggregate(pipeline, model) {
  * Contains options passed down to the [aggregate command](https://docs.mongodb.com/manual/reference/command/aggregate/).
  * Supported options are:
  *
- * - `readPreference`
- * - [`cursor`](./api.html#aggregate_Aggregate-cursor)
- * - [`explain`](./api.html#aggregate_Aggregate-explain)
  * - [`allowDiskUse`](./api.html#aggregate_Aggregate-allowDiskUse)
- * - `maxTimeMS`
  * - `bypassDocumentValidation`
- * - `raw`
- * - `promoteLongs`
- * - `promoteValues`
- * - `promoteBuffers`
  * - [`collation`](./api.html#aggregate_Aggregate-collation)
  * - `comment`
+ * - [`cursor`](./api.html#aggregate_Aggregate-cursor)
+ * - [`explain`](./api.html#aggregate_Aggregate-explain)
+ * - `fieldsAsRaw`
+ * - hint
+ * - let
+ * - `maxTimeMS`
+ * - `raw`
+ * - `readConcern`
+ * - `readPreference`
  * - [`session`](./api.html#aggregate_Aggregate-session)
+ * - `writeConcern`
  *
  * @property options
  * @memberOf Aggregate
@@ -87,7 +91,7 @@ Aggregate.prototype.options;
 /**
  * Get/set the model that this aggregation will execute on.
  *
- * ####Example:
+ * #### Example:
  *     const aggregate = MyModel.aggregate([{ $match: { answer: 42 } }]);
  *     aggregate.model() === MyModel; // true
  *
@@ -123,7 +127,7 @@ Aggregate.prototype.model = function(model) {
 /**
  * Appends new operators to this aggregate pipeline
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.append({ $project: { field: 1 }}, { $limit: 2 });
  *
@@ -154,7 +158,7 @@ Aggregate.prototype.append = function() {
  * Appends a new $addFields operator to this aggregate pipeline.
  * Requires MongoDB v3.4+ to work
  *
- * ####Examples:
+ * #### Examples:
   *
  *     // adding new fields based on existing fields
  *     aggregate.addFields({
@@ -185,7 +189,7 @@ Aggregate.prototype.addFields = function(arg) {
  *
  * Mongoose query [selection syntax](#query_Query-select) is also supported.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     // include a, include b, exclude _id
  *     aggregate.project("a b -_id");
@@ -240,7 +244,7 @@ Aggregate.prototype.project = function(arg) {
 /**
  * Appends a new custom $group operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.group({ _id: "$department" });
  *
@@ -256,7 +260,7 @@ Aggregate.prototype.project = function(arg) {
 /**
  * Appends a new custom $match operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.match({ department: { $in: [ "sales", "engineering" ] } });
  *
@@ -272,7 +276,7 @@ Aggregate.prototype.project = function(arg) {
 /**
  * Appends a new $skip operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.skip(10);
  *
@@ -288,7 +292,7 @@ Aggregate.prototype.project = function(arg) {
 /**
  * Appends a new $limit operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.limit(10);
  *
@@ -304,11 +308,11 @@ Aggregate.prototype.project = function(arg) {
 /**
  * Appends a new $geoNear operator to this aggregate pipeline.
  *
- * ####NOTE:
+ * #### Note:
  *
  * **MUST** be used as the first operator in the pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.near({
  *       near: [40.724, -73.997],
@@ -353,7 +357,7 @@ Aggregate.prototype.near = function(arg) {
  * Note that the `$unwind` operator requires the path name to start with '$'.
  * Mongoose will prepend '$' if the specified field doesn't start '$'.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.unwind("tags");
  *     aggregate.unwind("a", "b", "c");
@@ -374,7 +378,7 @@ Aggregate.prototype.unwind = function() {
       res.push({ $unwind: arg });
     } else if (typeof arg === 'string') {
       res.push({
-        $unwind: (arg && arg.startsWith('$')) ? arg : '$' + arg
+        $unwind: (arg[0] === '$') ? arg : '$' + arg
       });
     } else {
       throw new Error('Invalid arg "' + arg + '" to unwind(), ' +
@@ -392,14 +396,14 @@ Aggregate.prototype.unwind = function() {
  * If you are passing in a string Mongoose will prepend '$' if the specified field doesn't start '$'.
  * If you are passing in an object the strings in your expression will not be altered.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.replaceRoot("user");
  *
  *     aggregate.replaceRoot({ x: { $concat: ['$this', '$that'] } });
  *
  * @see $replaceRoot https://docs.mongodb.org/manual/reference/operator/aggregation/replaceRoot
- * @param {String|Object} the field or document which will become the new root document
+ * @param {String|Object} newRoot the field or document which will become the new root document
  * @return {Aggregate}
  * @api public
  */
@@ -423,18 +427,18 @@ Aggregate.prototype.replaceRoot = function(newRoot) {
 /**
  * Appends a new $count operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.count("userCount");
  *
  * @see $count https://docs.mongodb.org/manual/reference/operator/aggregation/count
- * @param {String} the name of the count field
+ * @param {String} fieldName The name of the output field which has the count as its value. It must be a non-empty string, must not start with $ and must not contain the . character.
  * @return {Aggregate}
  * @api public
  */
 
-Aggregate.prototype.count = function(countName) {
-  return this.append({ $count: countName });
+Aggregate.prototype.count = function(fieldName) {
+  return this.append({ $count: fieldName });
 };
 
 /**
@@ -444,7 +448,7 @@ Aggregate.prototype.count = function(countName) {
  * Note that the `$sortByCount` operator requires the new root to start with '$'.
  * Mongoose will prepend '$' if the specified field name doesn't start with '$'.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.sortByCount('users');
  *     aggregate.sortByCount({ $mergeObjects: [ "$employee", "$business" ] })
@@ -460,7 +464,7 @@ Aggregate.prototype.sortByCount = function(arg) {
     return this.append({ $sortByCount: arg });
   } else if (typeof arg === 'string') {
     return this.append({
-      $sortByCount: (arg && arg.startsWith('$')) ? arg : '$' + arg
+      $sortByCount: (arg[0] === '$') ? arg : '$' + arg
     });
   } else {
     throw new TypeError('Invalid arg "' + arg + '" to sortByCount(), ' +
@@ -471,7 +475,7 @@ Aggregate.prototype.sortByCount = function(arg) {
 /**
  * Appends new custom $lookup operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.lookup({ from: 'users', localField: 'userId', foreignField: '_id', as: 'users' });
  *
@@ -522,7 +526,7 @@ Aggregate.prototype.graphLookup = function(options) {
 /**
  * Appends new custom $sample operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.sample(3); // Add a pipeline that picks 3 random documents
  *
@@ -543,7 +547,7 @@ Aggregate.prototype.sample = function(size) {
  *
  * If a string is passed, it must be a space delimited list of path names. The sort order of each path is ascending unless the path name is prefixed with `-` which will be treated as descending.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     // these are equivalent
  *     aggregate.sort({ field: 'asc', test: -1 });
@@ -591,7 +595,7 @@ Aggregate.prototype.sort = function(arg) {
 /**
  * Appends new $unionWith operator to this aggregate pipeline.
  *
- * ####Examples:
+ * #### Examples:
  *
  *     aggregate.unionWith({ coll: 'users', pipeline: [ { $match: { _id: 1 } } ] });
  *
@@ -608,7 +612,7 @@ Aggregate.prototype.unionWith = function(options) {
 /**
  * Sets the readPreference option for the aggregation query.
  *
- * ####Example:
+ * #### Example:
  *
  *     await Model.aggregate(pipeline).read('primaryPreferred');
  *
@@ -621,9 +625,6 @@ Aggregate.prototype.unionWith = function(options) {
  */
 
 Aggregate.prototype.read = function(pref, tags) {
-  if (!this.options) {
-    this.options = {};
-  }
   read.call(this, pref, tags);
   return this;
 };
@@ -631,7 +632,7 @@ Aggregate.prototype.read = function(pref, tags) {
 /**
  * Sets the readConcern level for the aggregation query.
  *
- * ####Example:
+ * #### Example:
  *
  *     await Model.aggregate(pipeline).readConcern('majority');
  *
@@ -642,9 +643,6 @@ Aggregate.prototype.read = function(pref, tags) {
  */
 
 Aggregate.prototype.readConcern = function(level) {
-  if (!this.options) {
-    this.options = {};
-  }
   readConcern.call(this, level);
   return this;
 };
@@ -655,7 +653,7 @@ Aggregate.prototype.readConcern = function(level) {
  * If 3 arguments are supplied, Mongoose will wrap them with if-then-else of $cond operator respectively
  * If `thenExpr` or `elseExpr` is string, make sure it starts with $$, like `$$DESCEND`, `$$PRUNE` or `$$KEEP`.
  *
- * ####Example:
+ * #### Example:
  *
  *     await Model.aggregate(pipeline).redact({
  *       $cond: {
@@ -678,9 +676,9 @@ Aggregate.prototype.readConcern = function(level) {
 
 Aggregate.prototype.redact = function(expression, thenExpr, elseExpr) {
   if (arguments.length === 3) {
-    if ((typeof thenExpr === 'string' && !thenExpr.startsWith('$$')) ||
-        (typeof elseExpr === 'string' && !elseExpr.startsWith('$$'))) {
-      throw new Error('If thenExpr or elseExpr is string, it must start with $$. e.g. $$DESCEND, $$PRUNE, $$KEEP');
+    if ((typeof thenExpr === 'string' && !validRedactStringValues.has(thenExpr)) ||
+        (typeof elseExpr === 'string' && !validRedactStringValues.has(elseExpr))) {
+      throw new Error('If thenExpr or elseExpr is string, it must be either $$DESCEND, $$PRUNE or $$KEEP');
     }
 
     expression = {
@@ -700,7 +698,7 @@ Aggregate.prototype.redact = function(expression, thenExpr, elseExpr) {
 /**
  * Execute the aggregation with explain
  *
- * ####Example:
+ * #### Example:
  *
  *     Model.aggregate(..).explain(callback)
  *
@@ -768,12 +766,11 @@ Aggregate.prototype.explain = function(verbosity, callback) {
 /**
  * Sets the allowDiskUse option for the aggregation query (ignored for < 2.6.0)
  *
- * ####Example:
+ * #### Example:
  *
  *     await Model.aggregate([{ $match: { foo: 'bar' } }]).allowDiskUse(true);
  *
  * @param {Boolean} value Should tell server it can use hard drive to store data during aggregation.
- * @param {Array} [tags] optional tags for this query
  * @see mongodb https://docs.mongodb.org/manual/reference/command/aggregate/
  */
 
@@ -785,7 +782,7 @@ Aggregate.prototype.allowDiskUse = function(value) {
 /**
  * Sets the hint option for the aggregation query (ignored for < 3.6.0)
  *
- * ####Example:
+ * #### Example:
  *
  *     Model.aggregate(..).hint({ qty: 1, category: 1 }).exec(callback)
  *
@@ -801,7 +798,7 @@ Aggregate.prototype.hint = function(value) {
 /**
  * Sets the session for this aggregation. Useful for [transactions](/docs/transactions.html).
  *
- * ####Example:
+ * #### Example:
  *
  *     const session = await Model.startSession();
  *     await Model.aggregate(..).session(session);
@@ -822,7 +819,7 @@ Aggregate.prototype.session = function(session) {
 /**
  * Lets you set arbitrary options, for middleware or plugins.
  *
- * ####Example:
+ * #### Example:
  *
  *     const agg = Model.aggregate(..).option({ allowDiskUse: true }); // Set the `allowDiskUse` option
  *     agg.options; // `{ allowDiskUse: true }`
@@ -849,7 +846,7 @@ Aggregate.prototype.option = function(value) {
  * Cursors are useful if you want to process the results of the aggregation one-at-a-time
  * because the aggregation result is too big to fit into memory.
  *
- * ####Example:
+ * #### Example:
  *
  *     const cursor = Model.aggregate(..).cursor({ batchSize: 1000 });
  *     cursor.eachAsync(function(doc, i) {
@@ -865,9 +862,6 @@ Aggregate.prototype.option = function(value) {
  */
 
 Aggregate.prototype.cursor = function(options) {
-  if (!this.options) {
-    this.options = {};
-  }
   this.options.cursor = options || {};
   return new AggregationCursor(this); // return this;
 };
@@ -875,7 +869,7 @@ Aggregate.prototype.cursor = function(options) {
 /**
  * Adds a collation
  *
- * ####Example:
+ * #### Example:
  *
  *     const res = await Model.aggregate(pipeline).collation({ locale: 'en_US', strength: 1 });
  *
@@ -886,9 +880,6 @@ Aggregate.prototype.cursor = function(options) {
  */
 
 Aggregate.prototype.collation = function(collation) {
-  if (!this.options) {
-    this.options = {};
-  }
   this.options.collation = collation;
   return this;
 };
@@ -896,7 +887,7 @@ Aggregate.prototype.collation = function(collation) {
 /**
  * Combines multiple aggregation pipelines.
  *
- * ####Example:
+ * #### Example:
  *
  *     const res = await Model.aggregate().facet({
  *       books: [{ groupBy: '$author' }],
@@ -919,7 +910,7 @@ Aggregate.prototype.facet = function(options) {
  * Helper for [Atlas Text Search](https://docs.atlas.mongodb.com/reference/atlas-search/tutorial/)'s
  * `$search` stage.
  *
- * ####Example:
+ * #### Example:
  *
  *     const res = await Model.aggregate().
  *      search({
@@ -944,7 +935,7 @@ Aggregate.prototype.search = function(options) {
 /**
  * Returns the current pipeline
  *
- * ####Example:
+ * #### Example:
  *
  *     MyModel.aggregate().match({ test: 1 }).pipeline(); // [{ $match: { test: 1 } }]
  *
@@ -960,7 +951,7 @@ Aggregate.prototype.pipeline = function() {
 /**
  * Executes the aggregate pipeline on the currently bound Model.
  *
- * ####Example:
+ * #### Example:
  *
  *     aggregate.exec(callback);
  *
@@ -982,6 +973,7 @@ Aggregate.prototype.exec = function(callback) {
   const collection = this._model.collection;
 
   applyGlobalMaxTimeMS(this.options, model);
+  applyGlobalDiskUse(this.options, model);
 
   if (this.options && this.options.cursor) {
     return new AggregationCursor(this);
@@ -1027,7 +1019,7 @@ Aggregate.prototype.exec = function(callback) {
 /**
  * Provides promise for aggregate.
  *
- * ####Example:
+ * #### Example:
  *
  *     Model.aggregate(..).then(successCallback, errorCallback);
  *
@@ -1059,7 +1051,7 @@ Aggregate.prototype.catch = function(reject) {
  * You do not need to call this function explicitly, the JavaScript runtime
  * will call it for you.
  *
- * ####Example
+ * #### Example
  *
  *     const agg = Model.aggregate([{ $match: { age: { $gte: 25 } } }]);
  *     for await (const doc of agg) {

package/lib/browser.js

@@ -46,7 +46,7 @@ exports.Error = require('./error/index');
 /**
  * The Mongoose [Schema](#schema_Schema) constructor
  *
- * ####Example:
+ * #### Example:
  *
  *     const mongoose = require('mongoose');
  *     const Schema = mongoose.Schema;
@@ -61,12 +61,12 @@ exports.Schema = require('./schema');
 /**
  * The various Mongoose Types.
  *
- * ####Example:
+ * #### Example:
  *
  *     const mongoose = require('mongoose');
  *     const array = mongoose.Types.Array;
  *
- * ####Types:
+ * #### Types:
  *
  * - [Array](/docs/schematypes.html#arrays)
  * - [Buffer](/docs/schematypes.html#buffers)
@@ -98,7 +98,7 @@ exports.VirtualType = require('./virtualtype');
 /**
  * The various Mongoose SchemaTypes.
  *
- * ####Note:
+ * #### Note:
  *
  * _Alias of mongoose.Schema.Types for backwards compatibility._
  *

package/lib/connection.js

@@ -92,7 +92,7 @@ Connection.prototype.__proto__ = EventEmitter.prototype;
  *
  * Each state change emits its associated event name.
  *
- * ####Example
+ * #### Example
  *
  *     conn.on('connected', callback);
  *     conn.on('disconnected', callback);
@@ -131,7 +131,7 @@ Object.defineProperty(Connection.prototype, 'readyState', {
 /**
  * Gets the value of the option `key`. Equivalent to `conn.options[key]`
  *
- * ####Example:
+ * #### Example:
  *
  *     conn.get('test'); // returns the 'test' value
  *
@@ -155,7 +155,7 @@ Connection.prototype.get = function(key) {
  *
  * - `maxTimeMS`: Set [`maxTimeMS`](/docs/api.html#query_Query-maxTimeMS) for all queries on this connection.
  *
- * ####Example:
+ * #### Example:
  *
  *     conn.set('test', 'foo');
  *     conn.get('test'); // 'foo'
@@ -192,7 +192,7 @@ Connection.prototype.collections;
 /**
  * The name of the database this connection points to.
  *
- * ####Example
+ * #### Example
  *
  *     mongoose.createConnection('mongodb://localhost:27017/mydb').name; // "mydb"
  *
@@ -209,7 +209,7 @@ Connection.prototype.name;
  * a map from model names to models. Contains all models that have been
  * added to this connection using [`Connection#model()`](/docs/api/connection.html#connection_Connection-model).
  *
- * ####Example
+ * #### Example
  *
  *     const conn = mongoose.createConnection();
  *     const Test = conn.model('Test', mongoose.Schema({ name: String }));
@@ -229,7 +229,7 @@ Connection.prototype.models;
  * A number identifier for this connection. Used for debugging when
  * you have [multiple connections](/docs/connections.html#multiple_connections).
  *
- * ####Example
+ * #### Example
  *
  *     // The default connection has `id = 0`
  *     mongoose.connection.id; // 0
@@ -249,7 +249,7 @@ Connection.prototype.id;
 /**
  * The plugins that will be applied to all models created on this connection.
  *
- * ####Example:
+ * #### Example:
  *
  *     const db = mongoose.createConnection('mongodb://localhost:27017/mydb');
  *     db.plugin(() => console.log('Applied'));
@@ -273,7 +273,7 @@ Object.defineProperty(Connection.prototype, 'plugins', {
  * The host name portion of the URI. If multiple hosts, such as a replica set,
  * this will contain the first host name in the URI
  *
- * ####Example
+ * #### Example
  *
  *     mongoose.createConnection('mongodb://localhost:27017/mydb').host; // "localhost"
  *
@@ -293,7 +293,7 @@ Object.defineProperty(Connection.prototype, 'host', {
  * The port portion of the URI. If multiple hosts, such as a replica set,
  * this will contain the port from the first host name in the URI.
  *
- * ####Example
+ * #### Example
  *
  *     mongoose.createConnection('mongodb://localhost:27017/mydb').port; // 27017
  *
@@ -312,7 +312,7 @@ Object.defineProperty(Connection.prototype, 'port', {
 /**
  * The username specified in the URI
  *
- * ####Example
+ * #### Example
  *
  *     mongoose.createConnection('mongodb://val:psw@localhost:27017/mydb').user; // "val"
  *
@@ -331,7 +331,7 @@ Object.defineProperty(Connection.prototype, 'user', {
 /**
  * The password specified in the URI
  *
- * ####Example
+ * #### Example
  *
  *     mongoose.createConnection('mongodb://val:psw@localhost:27017/mydb').pass; // "psw"
  *
@@ -409,7 +409,7 @@ Connection.prototype.createCollection = _wrapConnHelper(function createCollectio
  * for benefits like causal consistency, [retryable writes](https://docs.mongodb.com/manual/core/retryable-writes/),
  * and [transactions](https://thecodebarbarian.com/a-node-js-perspective-on-mongodb-4-transactions.html).
  *
- * ####Example:
+ * #### Example:
  *
  *     const session = await conn.startSession();
  *     let doc = await Person.findOne({ name: 'Ned Stark' }, null, { session });
@@ -447,7 +447,7 @@ Connection.prototype.startSession = _wrapConnHelper(function startSession(option
  * Calls the MongoDB driver's [`session.withTransaction()`](https://mongodb.github.io/node-mongodb-native/3.5/api/ClientSession.html#withTransaction),
  * but also handles resetting Mongoose document state as shown below.
  *
- * ####Example:
+ * #### Example:
  *
  *     const doc = new Person({ name: 'Will Riker' });
  *     await db.transaction(async function setRank(session) {
@@ -532,7 +532,7 @@ Connection.prototype.dropCollection = _wrapConnHelper(function dropCollection(co
  * Helper for `dropDatabase()`. Deletes the given database, including all
  * collections, documents, and indexes.
  *
- * ####Example:
+ * #### Example:
  *
  *     const conn = mongoose.createConnection('mongodb://localhost:27017/mydb');
  *     // Deletes the entire 'mydb' database
@@ -1037,7 +1037,7 @@ Connection.prototype.collection = function(name, options) {
  *
  * Equivalent to calling `.plugin(fn)` on each schema you create.
  *
- * ####Example:
+ * #### Example:
  *     const db = mongoose.createConnection('mongodb://localhost:27017/mydb');
  *     db.plugin(() => console.log('Applied'));
  *     db.plugins.length; // 1
@@ -1067,7 +1067,7 @@ Connection.prototype.plugin = function(fn, opts) {
  *
  * _When no `collection` argument is passed, Mongoose produces a collection name by passing the model `name` to the [utils.toCollectionName](#utils_exports.toCollectionName) method. This method pluralizes the name. If you don't like this behavior, either pass a collection name or set your schemas collection name option._
  *
- * ####Example:
+ * #### Example:
  *
  *     const schema = new Schema({ name: String }, { collection: 'actor' });
  *
@@ -1185,7 +1185,7 @@ Connection.prototype.model = function(name, schema, collection, options) {
  * use this function to clean up any models you created in your tests to
  * prevent OverwriteModelErrors.
  *
- * ####Example:
+ * #### Example:
  *
  *     conn.model('User', new Schema({ name: String }));
  *     console.log(conn.model('User')); // Model object
@@ -1243,7 +1243,7 @@ Connection.prototype.deleteModel = function(name) {
  * - 'end': Emitted if the underlying stream is closed
  * - 'close': Emitted if the underlying stream is closed
  *
- * ####Example:
+ * #### Example:
  *
  *     const User = conn.model('User', new Schema({ name: String }));
  *
@@ -1287,7 +1287,7 @@ Connection.prototype.watch = function(pipeline, options) {
  * successfully connects to MongoDB, or rejects if this connection failed
  * to connect.
  *
- * ####Example:
+ * #### Example:
  *     const conn = await mongoose.createConnection('mongodb://localhost:27017/test').
  *       asPromise();
  *     conn.readyState; // 1, means Mongoose is connected
@@ -1356,7 +1356,7 @@ Connection.prototype.optionsProvideAuthenticationData = function(options) {
  * Returns the [MongoDB driver `MongoClient`](https://mongodb.github.io/node-mongodb-native/3.5/api/MongoClient.html) instance
  * that this connection uses to talk to MongoDB.
  *
- * ####Example:
+ * #### Example:
  *     const conn = await mongoose.createConnection('mongodb://localhost:27017/test');
  *
  *     conn.getClient(); // MongoClient { ... }
@@ -1374,7 +1374,7 @@ Connection.prototype.getClient = function getClient() {
  * that this connection uses to talk to MongoDB. This is useful if you already have a MongoClient instance, and want to
  * reuse it.
  *
- * ####Example:
+ * #### Example:
  *     const client = await mongodb.MongoClient.connect('mongodb://localhost:27017/test');
  *
  *     const conn = mongoose.createConnection().setClient(client);

package/lib/cursor/AggregationCursor.js

@@ -107,7 +107,7 @@ if (Symbol.asyncIterator != null) {
  * Registers a transform function which subsequently maps documents retrieved
  * via the streams interface or `.next()`
  *
- * ####Example
+ * #### Example
  *
  *     // Map documents returned by `data` events
  *     Thing.
@@ -226,7 +226,7 @@ AggregationCursor.prototype.eachAsync = function(fn, opts, callback) {
  * You do not need to call this function explicitly, the JavaScript runtime
  * will call it for you.
  *
- * ####Example
+ * #### Example
  *
  *     // Async iterator without explicitly calling `cursor()`. Mongoose still
  *     // creates an AggregationCursor instance internally.