mongoose 4.13.7 → 4.13.11

package/History.md

@@ -1,3 +1,29 @@
+4.13.11 / 2018-02-07
+====================
+ * docs: fix links in 4.x docs #6081
+ * chore: add release script that uses --tag for npm publish for 4.x releases #6063
+
+4.13.10 / 2018-01-28
+====================
+ * docs(model+query): add lean() option to Model helpers #5996 [aguyinmontreal](https://github.com/aguyinmontreal)
+ * fix: use lazy loading so we can build mongoose with webpack #5993 #5842
+ * docs(connections): clarify multi-mongos with useMongoClient for 4.x docs #5984
+ * fix(populate): handle populating embedded discriminator paths #5970
+ * docs(query+aggregate): add more detail re: maxTimeMS #4066
+
+4.13.9 / 2018-01-07
+===================
+ * chore: update marked (dev dependency) re: security vulnerability #5951 [ChristianMurphy](https://github.com/ChristianMurphy)
+ * fix: upgrade mongodb -> 2.2.34 for ipv6 and autoReconnect fixes #5794 #5760
+ * docs: use useMongooseAggCursor for aggregate docs #2955
+
+4.13.8 / 2017-12-27
+===================
+ * docs(guide): use more up-to-date syntax for autoIndex example #5933
+ * docs: fix grammar #5927 [abagh0703](https://github.com/abagh0703)
+ * fix: propagate lean options to child schemas #5914
+ * fix(populate): use correct model with discriminators + nested populate #5858
+
 4.13.7 / 2017-12-11
 ===================
  * docs(schematypes): fix typo #5889 [gokaygurcan](https://github.com/gokaygurcan)

package/README.md

@@ -5,8 +5,6 @@ Mongoose is a [MongoDB](https://www.mongodb.org/) object modeling tool designed
 [![Slack Status](http://slack.mongoosejs.io/badge.svg)](http://slack.mongoosejs.io)
 [![Build Status](https://api.travis-ci.org/Automattic/mongoose.svg?branch=master)](https://travis-ci.org/Automattic/mongoose)
 [![NPM version](https://badge.fury.io/js/mongoose.svg)](http://badge.fury.io/js/mongoose)
-[![Dependency Status](https://gemnasium.com/Automattic/mongoose.svg)](https://gemnasium.com/Automattic/mongoose)
-[![Get help on Codementor](https://cdn.codementor.io/badges/get_help_github.svg)](https://www.codementor.io/vkarpov?utm_source=github&utm_medium=button&utm_term=vkarpov&utm_campaign=github)
 
 ## Documentation
 
@@ -20,6 +18,16 @@ Mongoose is a [MongoDB](https://www.mongodb.org/) object modeling tool designed
   - [Help Forum](http://groups.google.com/group/mongoose-orm)
   - [MongoDB Support](https://docs.mongodb.org/manual/support/)
 
+## Importing
+
+```javascript
+// Using Node.js `require()`
+const mongoose = require('mongoose');
+
+// Using ES6 imports
+import mongoose from 'mongoose';
+```
+
 ## Plugins
 
 Check out the [plugins search site](http://plugins.mongoosejs.io/) to see hundreds of related modules from the community. Next, learn how to write your own plugin from the [docs](http://mongoosejs.com/docs/plugins.html) or [this blog post](http://thecodebarbarian.com/2015/03/06/guide-to-mongoose-plugins).

package/d1c5478c698dcae9731751e285eef3c431a8f213.patch

@@ -0,0 +1,56 @@
+From d1c5478c698dcae9731751e285eef3c431a8f213 Mon Sep 17 00:00:00 2001
+From: Jess <jessachandler@gmail.com>
+Date: Fri, 26 Jan 2018 10:06:01 +0900
+Subject: [PATCH] Updated CONTRIBUTING.md (optional)
+
+---
+ CONTRIBUTING.md | 38 ++++++++++++++++++++++++++++++++++++++
+ 1 file changed, 38 insertions(+)
+
+diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
+index 477f83a8a..a82f1ed20 100644
+--- a/CONTRIBUTING.md
++++ b/CONTRIBUTING.md
+@@ -60,3 +60,41 @@ Visit `http://localhost:8088` and you should see the docs with your local change
+ ### Plugins website
+ 
+ The [plugins](http://plugins.mongoosejs.io/) site is also an [open source project](https://github.com/vkarpov15/mongooseplugins) that you can get involved with. Feel free to fork and improve it as well!
++
++
++## Financial contributions
++
++We also welcome financial contributions in full transparency on our [open collective](https://opencollective.com/mongoose).
++Anyone can file an expense. If the expense makes sense for the development of the community, it will be "merged" in the ledger of our open collective by the core contributors and the person who filed the expense will be reimbursed.
++
++
++## Credits
++
++
++### Contributors
++
++Thank you to all the people who have already contributed to mongoose!
++<a href="graphs/contributors"><img src="https://opencollective.com/mongoose/contributors.svg?width=890" /></a>
++
++
++### Backers
++
++Thank you to all our backers! [[Become a backer](https://opencollective.com/mongoose#backer)]
++
++<a href="https://opencollective.com/mongoose#backers" target="_blank"><img src="https://opencollective.com/mongoose/backers.svg?width=890"></a>
++
++
++### Sponsors
++
++Thank you to all our sponsors! (please ask your company to also support this open source project by [becoming a sponsor](https://opencollective.com/mongoose#sponsor))
++
++<a href="https://opencollective.com/mongoose/sponsor/0/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/0/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/1/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/1/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/2/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/2/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/3/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/3/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/4/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/4/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/5/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/5/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/6/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/6/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/7/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/7/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/8/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/8/avatar.svg"></a>
++<a href="https://opencollective.com/mongoose/sponsor/9/website" target="_blank"><img src="https://opencollective.com/mongoose/sponsor/9/avatar.svg"></a>
+

package/docs.html

@@ -0,0 +1,413 @@
+<html>
+  <head>
+    <link
+      rel="stylesheet"
+      href="https://unpkg.com/purecss@1.0.0/build/pure-min.css"
+      integrity="sha384-nn4HPE8lTHyVtfCBi5yW9d20FjT8BJwUXyWZT9InLYax14RDjBj46LmSztkmNP9w"
+      crossorigin="anonymous">
+
+    <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans">
+    <link rel="stylesheet" href="http://thecodebarbarian.com/style/github.css">
+
+    <style>
+      html {
+        font-family: 'Open Sans';
+      }
+
+      body {
+        margin: 0;
+      }
+
+      a {
+        text-decoration: none;
+      }
+
+      #logo {
+        width: 62px;
+        height: 30px;
+        position: relative;
+        top: 5px;
+      }
+
+      .logo-text {
+        color: #800;
+        font-size: 20pt;
+        position: relative;
+        top: 0px;
+        left: 10px;
+        text-transform: none;
+      }
+
+      .pure-menu-item {
+        height: 30px;
+        font-size: 13pt;
+        padding-top: 0px;
+      }
+
+      .pure-menu-link {
+        padding-top: 2px;
+      }
+
+      li.sub-item {
+        height: 25px;
+        font-size: 11pt;
+        margin-left: 20px;
+      }
+
+      #logo-container {
+        position: relative;
+        top: -4px;
+        padding-bottom: 6px;
+        border-bottom: 1px solid #ddd;
+      }
+
+      #menu {
+        z-index: 1;
+        position: fixed;
+        top: 0;
+        left: 0;
+        height: 100%;
+        background-color: #eee;
+        width: 250px;
+        border-right: 1px solid #ddd;
+      }
+
+      .container {
+        position: relative;
+        left: 250px;
+        padding-left: 50px;
+        width: 850px;
+      }
+
+      pre {
+        display: block;
+        padding: 9.5px;
+        margin: 10px 0 10px;
+        font-size: 13px;
+        line-height: 1.42857143;
+        color: #333;
+        word-break: break-all;
+        word-wrap: break-word;
+        background-color: #f5f5f5;
+        border: 1px solid #ccc;
+        border-radius: 4px;
+        font-family: Menlo,Monaco,Consolas,"Courier New",monospace;
+      }
+
+      #mobile-menu {
+        display: none;
+      }
+
+      @media (max-width: 1160px) {
+        .container {
+          width: 100%;
+          padding: 0px;
+          left: 0px;
+          margin: auto;
+        }
+
+        #content {
+          margin: 10px;
+        }
+
+        #menu {
+          display: none;
+          position: absolute;
+          top: 45px;
+          border-top: 1px solid #ddd;
+          border-right: 1px solid #ddd;
+          border-bottom: 1px solid #ddd;
+          left: 0px;
+        }
+
+        pre {
+          margin: 0px;
+          margin-top: 10px;
+        }
+
+        #mobile-menu {
+          display: block;
+          height: 45px;
+          background-color: #eee;
+          border-bottom: 1px solid #ddd;
+        }
+
+        #logo {
+          border: 0;
+        }
+
+        #mobile-logo-container {
+          padding: 0;
+          border: 0px;
+          padding-top: 3px;
+          padding-bottom: 3px;
+          width: 215px;
+          margin-left: auto;
+          margin-right: auto;
+        }
+
+        #logo-container {
+          display: none;
+        }
+
+        .menu-link {
+          position: absolute;
+          display: block;
+          top: 0px;
+          left: 0;
+          background-color: #eee;
+          font-size: 10px; /* change this value to increase/decrease button size */
+          z-index: 10;
+          width: 2em;
+          height: 3px;
+          padding: 2.1em 1.6em;
+        }
+
+        .menu-link:hover,
+        .menu-link:focus {
+          background: #ddd;
+        }
+
+        .menu-link span {
+          position: relative;
+          display: block;
+        }
+
+        .menu-link span,
+        .menu-link span:before,
+        .menu-link span:after {
+          background-color: #333;
+          width: 100%;
+          height: 0.2em;
+        }
+
+        .menu-link span:before,
+        .menu-link span:after {
+          position: absolute;
+          margin-top: -0.6em;
+          content: " ";
+        }
+
+        .menu-link span:after {
+          margin-top: 0.6em;
+        }
+
+        .active {
+          display: block !important;
+        }
+      }
+    </style>
+  </head>
+
+  <body>
+    <div id="layout">
+      <div id="mobile-menu">
+        <a href="#menu" class="menu-link" id="menuLink">
+          <span></span>
+        </a>
+        <div id="mobile-logo-container">
+          <a href="#">
+            <img id="logo" src="./mongoose5_transparent.png">
+            <span class="logo-text">mongoose</span>
+          </a>
+        </div>
+      </div>
+
+      <div id="menu">
+        <div class="pure-menu">
+          <div id="logo-container" class="pure-menu-heading">
+            <a href="#">
+              <img id="logo" src="./mongoose5_transparent.png">
+              <span class="logo-text">mongoose</span>
+            </a>
+          </div>
+          <ul class="pure-menu-list">
+            <li class="pure-menu-item">
+              <a class="pure-menu-link">Quick Start</a>
+            </li>
+            <li class="pure-menu-item">
+              <a class="pure-menu-link">Guide</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a class="pure-menu-link">Schemas</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Connections</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Models</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Documents</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Queries</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Validation</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Middleware</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Population</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Discriminators</a>
+            </li>
+
+
+            <li class="pure-menu-item">
+              <a class="pure-menu-link">API</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a class="pure-menu-link">Schema</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Document</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Model</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Query</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Aggregate</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">SchemaType</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">VirtualType</a>
+            </li>
+            <li class="pure-menu-item sub-item">
+              <a href="#" class="pure-menu-link">Error</a>
+            </li>
+
+            <li class="pure-menu-item">
+              <a class="pure-menu-link">Version Compatibility</a>
+            </li>
+            <li class="pure-menu-item">
+              <a class="pure-menu-link">FAQ</a>
+            </li>
+          </ul>
+        </div>
+      </div>
+
+      <div class="container">
+        <div id="content">
+          <h1>Header</h1>
+          <p>
+          Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque faucibus lobortis enim, eu sodales risus bibendum vitae. Phasellus aliquam ultrices sem non posuere. Aenean finibus a massa nec euismod. Donec ullamcorper, sapien rhoncus tempor rhoncus, purus arcu eleifend mauris, ullamcorper maximus magna arcu vel purus. Sed consequat nibh ipsum, vitae commodo risus rhoncus in. Morbi et dolor ultrices, finibus urna at, hendrerit ex. Morbi suscipit eget leo quis vehicula. Curabitur eu lacinia turpis. Sed ut bibendum nisl.
+          </p>
+
+          <p>
+            Integer id turpis magna. Nunc lectus lectus, pellentesque vel vulputate ac, pharetra eu tortor. Phasellus arcu erat, pellentesque et nibh non, dignissim scelerisque lacus. Pellentesque mattis ipsum a tincidunt porttitor. Suspendisse ut congue magna. Donec aliquam lectus libero, in feugiat dolor ornare sit amet. Nulla et molestie libero. Lorem ipsum dolor sit amet, consectetur adipiscing elit.
+          </p>
+
+          <p>
+            Donec aliquet ac turpis vitae elementum. Nullam volutpat mattis leo, id facilisis orci porta nec. Nulla vel faucibus ex, et gravida felis. Nulla facilisi. Donec ut felis ut ante fringilla dapibus id sed mi. Donec a blandit velit, id ultricies risus. Vivamus bibendum odio sit amet vehicula tincidunt. Phasellus blandit dui urna, blandit venenatis erat tincidunt eget. Nunc pretium sodales ligula, ut faucibus orci elementum sit amet. Curabitur luctus, est in rutrum congue, est lorem luctus dui, vitae auctor libero lacus ut enim. Nullam neque est, pellentesque ac viverra pretium, varius ut risus.
+          </p>
+
+          <p>
+            Pellentesque blandit quam turpis, sit amet ullamcorper dui malesuada tincidunt. Donec ac mattis urna, nec posuere nunc. Aenean non urna ultrices, convallis mauris non, efficitur lacus. Duis eget metus sed magna convallis lobortis ac et est. Suspendisse tincidunt ligula arcu. Aenean at euismod elit, a suscipit ante. Nulla porttitor sit amet justo et vestibulum. Cras sodales leo a velit tempor, sit amet commodo odio tincidunt. In nec tempus dolor. In bibendum sodales enim nec rhoncus.
+          </p>
+
+          <p>
+            Duis convallis a ante vel imperdiet. Vivamus nec arcu mollis, malesuada felis sit amet, aliquet elit. Aliquam erat volutpat. Morbi consequat orci sit amet tellus convallis laoreet. Nunc sed suscipit neque. Fusce convallis nisi ligula, et maximus lorem tincidunt eu. Morbi nec venenatis justo. Morbi laoreet lectus at vestibulum placerat. Pellentesque bibendum magna velit, convallis euismod leo fringilla vel. Duis maximus elementum enim, dignissim accumsan ex finibus ac. Aliquam erat volutpat. Etiam sit amet commodo enim. Pellentesque ac est eget ipsum fermentum facilisis sit amet sed nisl.
+          </p>
+
+<pre><code class="lang-javascript"><span class="hljs-keyword">const</span> mongoose = <span class="hljs-built_in">require</span>(<span class="hljs-string">'mongoose'</span>);
+
+mongoose.connect(<span class="hljs-string">'mongodb://localhost:27017/test'</span>);
+mongoose.set(<span class="hljs-string">'debug'</span>, <span class="hljs-literal">true</span>);
+
+<span class="hljs-keyword">const</span> vehicleSchema = <span class="hljs-keyword">new</span> mongoose.Schema({
+make: <span class="hljs-built_in">String</span>,
+model: <span class="hljs-built_in">String</span>,
+year: <span class="hljs-built_in">Number</span>,
+customerId: mongoose.Schema.Types.ObjectId
+});
+
+<span class="hljs-keyword">const</span> customerSchema = <span class="hljs-keyword">new</span> mongoose.Schema({
+vehicle: { type: vehicleSchema, required: <span class="hljs-literal">true</span> }
+});
+
+<span class="hljs-comment">// Callback-style middleware, your only option in 4.x</span>
+vehicleSchema.pre(<span class="hljs-string">'save'</span>, <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">next</span>) </span>{
+Customer.updateMany({ <span class="hljs-string">'vehicle._id'</span>: <span class="hljs-keyword">this</span>._id }, { $set: { vehicle: <span class="hljs-keyword">this</span> } }, (error) =&gt; {
+next(error);
+});
+});
+
+<span class="hljs-keyword">const</span> Vehicle = mongoose.model(<span class="hljs-string">'Vehicle'</span>, vehicleSchema);
+<span class="hljs-keyword">const</span> Customer = mongoose.model(<span class="hljs-string">'Customer'</span>, customerSchema);
+
+run().catch(error =&gt; <span class="hljs-built_in">console</span>.error(error.stack));
+
+<span class="hljs-keyword">async</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">run</span>(<span class="hljs-params"></span>) </span>{
+<span class="hljs-keyword">const</span> v = <span class="hljs-keyword">await</span> Vehicle.create({ make: <span class="hljs-string">'Subaru'</span>, model: <span class="hljs-string">'Crosstrek'</span>, year: <span class="hljs-number">2016</span> });
+<span class="hljs-keyword">let</span> customer = <span class="hljs-keyword">await</span> Customer.create({ vehicle: v });
+
+v.year = <span class="hljs-number">2018</span>;
+<span class="hljs-keyword">await</span> v.save();
+
+<span class="hljs-comment">// `year` will be '2018'</span>
+<span class="hljs-built_in">console</span>.log(<span class="hljs-keyword">await</span> Customer.findById(customer._id));
+}
+</code></pre>
+        </div>
+      </div>
+    </div>
+
+    <script type="text/javascript">
+    (function (window, document) {
+
+      var layout   = document.getElementById('layout'),
+          menu     = document.getElementById('menu'),
+          menuLink = document.getElementById('menuLink'),
+          content  = document.getElementById('content');
+
+      function toggleClass(element, className) {
+          var classes = element.className.split(/\s+/),
+              length = classes.length,
+              i = 0;
+
+          for(; i < length; i++) {
+            if (classes[i] === className) {
+              classes.splice(i, 1);
+              break;
+            }
+          }
+          // The className is not found
+          if (length === classes.length) {
+              classes.push(className);
+          }
+
+          element.className = classes.join(' ');
+      }
+
+      function toggleAll(e) {
+          var active = 'active';
+
+          e.preventDefault();
+          toggleClass(layout, active);
+          toggleClass(menu, active);
+          toggleClass(menuLink, active);
+      }
+
+      menuLink.onclick = function (e) {
+          toggleAll(e);
+      };
+
+      content.onclick = function(e) {
+          if (menu.className.indexOf('active') !== -1) {
+              toggleAll(e);
+          }
+      };
+
+    }(this, this.document));
+    </script>
+  </body>
+</html>

package/lib/aggregate.js

@@ -554,7 +554,10 @@ Aggregate.prototype.allowDiskUse = function(value) {
  *     var agg = Model.aggregate(..).option({ allowDiskUse: true }); // Set the `allowDiskUse` option
  *     agg.options; // `{ allowDiskUse: true }`
  *
- * @param {Object} value keys to merge into current options
+ * @param {Object} options keys to merge into current options
+ * @param [options.maxTimeMS] number limits the time this aggregation will run, see [MongoDB docs on `maxTimeMS`](https://docs.mongodb.com/manual/reference/operator/meta/maxTimeMS/)
+ * @param [options.allowDiskUse] boolean if true, the MongoDB server will use the hard drive to store data during this aggregation
+ * @param [options.collation] object see [`Aggregate.prototype.collation()`](./docs/api.html#aggregate_Aggregate-collation)
  * @see mongodb http://docs.mongodb.org/manual/reference/command/aggregate/
  * @return {Aggregate} this
  * @api public
@@ -574,7 +577,7 @@ Aggregate.prototype.option = function(value) {
  *
  * ####Example:
  *
- *     var cursor = Model.aggregate(..).cursor({ batchSize: 1000 }).exec();
+ *     var cursor = Model.aggregate(..).cursor({ batchSize: 1000, useMongooseAggCursor: true }).exec();
  *     cursor.each(function(error, doc) {
  *       // use doc
  *     });
@@ -621,7 +624,6 @@ Aggregate.prototype.addCursorFlag = function(flag, value) {
  *     Model.aggregate(..).collation({ locale: 'en_US', strength: 1 }).exec();
  *
  * @param {Object} collation options
- * @param {Boolean} value
  * @see mongodb http://mongodb.github.io/node-mongodb-native/2.2/api/Collection.html#aggregate
  */
 

package/lib/document.js

@@ -487,10 +487,11 @@ Document.prototype.update = function update() {
  * @param {Any} val the value to set
  * @param {Schema|String|Number|Buffer|*} [type] optionally specify a type for "on-the-fly" attributes
  * @param {Object} [options] optionally specify options that modify the behavior of the set
+ * @method $set
  * @api public
  */
 
-Document.prototype.$set = function(path, val, type, options) {
+Document.prototype.$set = function $set(path, val, type, options) {
   if (type && utils.getFunctionName(type.constructor) === 'Object') {
     options = type;
     type = undefined;
@@ -1178,6 +1179,7 @@ Document.prototype.$isDefault = function(path) {
  *
  * @param {Boolean} [val] optional, overrides whether mongoose thinks the doc is deleted
  * @return {Boolean} whether mongoose thinks this doc is deleted.
+ * @method $isDeleted
  * @api public
  */
 

package/lib/model.js

@@ -21,6 +21,7 @@ var castUpdate = require('./services/query/castUpdate');
 var discriminator = require('./services/model/discriminator');
 var isPathSelectedInclusive = require('./services/projection/isPathSelectedInclusive');
 var get = require('lodash.get');
+var getSchemaTypes = require('./services/populate/getSchemaTypes');
 var mpath = require('mpath');
 var parallel = require('async/parallel');
 var parallelLimit = require('async/parallelLimit');
@@ -1686,6 +1687,7 @@ Model.$where = function $where() {
  * @param {Object} [conditions]
  * @param {Object} [update]
  * @param {Object} [options] optional see [`Query.prototype.setOptions()`](http://mongoosejs.com/docs/api.html#query_Query-setOptions)
+ * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](http://mongoosejs.com/docs/api.html#query_Query-lean).
  * @param {Function} [callback]
  * @return {Query}
  * @see mongodb http://www.mongodb.org/display/DOCS/findAndModify+Command
@@ -1805,6 +1807,7 @@ Model.findOneAndUpdate = function(conditions, update, options, callback) {
  * @param {Object|Number|String} id value of `_id` to query by
  * @param {Object} [update]
  * @param {Object} [options] optional see [`Query.prototype.setOptions()`](http://mongoosejs.com/docs/api.html#query_Query-setOptions)
+ * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](http://mongoosejs.com/docs/api.html#query_Query-lean).
  * @param {Function} [callback]
  * @return {Query}
  * @see Model.findOneAndUpdate #model_Model.findOneAndUpdate
@@ -2968,7 +2971,8 @@ Model.aggregate = function aggregate() {
  * - `lean` {Boolean} return the raw object instead of the Mongoose Model
  *
  * @param {Object} conditions an object that specifies the match condition (required)
- * @param {Object} options for the geoSearch, some (near, maxDistance) are required
+ * @param {Object} [options] for the geoSearch, some (near, maxDistance) are required
+ * @param {Object} [options.lean] if truthy, mongoose will return the document as a plain JavaScript object rather than a mongoose document. See [`Query.lean()`](http://mongoosejs.com/docs/api.html#query_Query-lean).
  * @param {Function} [callback] optional callback
  * @return {Promise}
  * @see http://docs.mongodb.org/manual/reference/command/geoSearch/
@@ -3261,7 +3265,9 @@ function populate(model, docs, options, callback) {
       mod.options.options.limit = mod.options.options.limit * ids.length;
     }
 
-    var subPopulate = mod.options.populate;
+    var subPopulate = utils.clone(mod.options.populate, {
+      retainKeyOrder: true
+    });
     var query = mod.Model.find(match, select, mod.options.options);
 
     // If we're doing virtual populate and projection is inclusive and foreign
@@ -3546,95 +3552,42 @@ function getModelsMapForPopulate(model, docs, options) {
   var originalModel = options.model;
   var isVirtual = false;
   var isRefPathArray = false;
-
-  schema = model._getSchema(options.path);
-  var isUnderneathDocArray = schema && schema.$isUnderneathDocArray;
-  if (isUnderneathDocArray &&
-      options &&
-      options.options &&
-      options.options.sort) {
-    return new Error('Cannot populate with `sort` on path ' + options.path +
-      ' because it is a subproperty of a document array');
-  }
-
-  if (schema && schema.caster) {
-    schema = schema.caster;
-  }
-
-  if (!schema && model.discriminators) {
-    discriminatorKey = model.schema.discriminatorMapping.key;
-  }
-
-  refPath = schema && schema.options && schema.options.refPath;
+  var modelSchema = model.schema;
 
   for (i = 0; i < len; i++) {
     doc = docs[i];
 
-    if (refPath) {
-      modelNames = utils.getValue(refPath, doc);
-      isRefPathArray = Array.isArray(modelNames);
-    } else {
-      if (!modelNameFromQuery) {
-        var modelForCurrentDoc = model;
-        var schemaForCurrentDoc;
-
-        if (!schema && discriminatorKey) {
-          modelForFindSchema = utils.getValue(discriminatorKey, doc);
-
-          if (modelForFindSchema) {
-            try {
-              modelForCurrentDoc = model.db.model(modelForFindSchema);
-            } catch (error) {
-              return error;
-            }
-
-            schemaForCurrentDoc = modelForCurrentDoc._getSchema(options.path);
+    schema = getSchemaTypes(modelSchema, doc, options.path);
+    var isUnderneathDocArray = schema && schema.$isUnderneathDocArray;
+    if (isUnderneathDocArray &&
+        options &&
+        options.options &&
+        options.options.sort) {
+      return new Error('Cannot populate with `sort` on path ' + options.path +
+        ' because it is a subproperty of a document array');
+    }
 
-            if (schemaForCurrentDoc && schemaForCurrentDoc.caster) {
-              schemaForCurrentDoc = schemaForCurrentDoc.caster;
-            }
-          }
-        } else {
-          schemaForCurrentDoc = schema;
+    if (Array.isArray(schema)) {
+      for (var j = 0; j < schema.length; ++j) {
+        var _modelNames = _getModelNames(doc, schema[j]);
+        if (!_modelNames) {
+          continue;
         }
-        var virtual = modelForCurrentDoc.schema._getVirtual(options.path);
-
-        var ref;
-        if ((ref = get(schemaForCurrentDoc, 'options.ref')) != null) {
-          modelNames = [ref];
-        } else if ((ref = get(virtual, 'options.ref')) != null) {
-          if (typeof ref === 'function') {
-            ref = ref.call(doc, doc);
-          }
-
-          // When referencing nested arrays, the ref should be an Array
-          // of modelNames.
-          if (Array.isArray(ref)) {
-            modelNames = ref;
-          } else {
-            modelNames = [ref];
+        modelNames = (modelNames || []);
+        for (var x = 0; x < _modelNames.length; ++x) {
+          if (modelNames.indexOf(_modelNames[x]) === -1) {
+            modelNames.push(_modelNames[x]);
           }
-
-          isVirtual = true;
-        } else {
-          // We may have a discriminator, in which case we don't want to
-          // populate using the base model by default
-          modelNames = discriminatorKey ? null : [model.modelName];
         }
-      } else {
-        modelNames = [modelNameFromQuery];  // query options
+      }
+    } else {
+      modelNames = _getModelNames(doc, schema);
+      if (!modelNames) {
+        continue;
       }
     }
 
-    if (!modelNames) {
-      continue;
-    }
-
-    if (!Array.isArray(modelNames)) {
-      modelNames = [modelNames];
-    }
-
-    virtual = model.schema._getVirtual(options.path);
+    var virtual = model.schema._getVirtual(options.path);
     var localField;
     if (virtual && virtual.options) {
       var virtualPrefix = virtual.$nestedSchemaPath ?
@@ -3724,6 +3677,87 @@ function getModelsMapForPopulate(model, docs, options) {
     }
   }
 
+  function _getModelNames(doc, schema) {
+    var modelNames;
+    var discriminatorKey;
+
+    if (schema && schema.caster) {
+      schema = schema.caster;
+    }
+
+    if (!schema && model.discriminators) {
+      discriminatorKey = model.schema.discriminatorMapping.key;
+    }
+
+    refPath = schema && schema.options && schema.options.refPath;
+
+    if (refPath) {
+      modelNames = utils.getValue(refPath, doc);
+      isRefPathArray = Array.isArray(modelNames);
+    } else {
+      if (!modelNameFromQuery) {
+        var modelForCurrentDoc = model;
+        var schemaForCurrentDoc;
+
+        if (!schema && discriminatorKey) {
+          modelForFindSchema = utils.getValue(discriminatorKey, doc);
+
+          if (modelForFindSchema) {
+            try {
+              modelForCurrentDoc = model.db.model(modelForFindSchema);
+            } catch (error) {
+              return error;
+            }
+
+            schemaForCurrentDoc = modelForCurrentDoc.schema._getSchema(options.path);
+
+            if (schemaForCurrentDoc && schemaForCurrentDoc.caster) {
+              schemaForCurrentDoc = schemaForCurrentDoc.caster;
+            }
+          }
+        } else {
+          schemaForCurrentDoc = schema;
+        }
+        var virtual = modelForCurrentDoc.schema._getVirtual(options.path);
+
+        var ref;
+        if ((ref = get(schemaForCurrentDoc, 'options.ref')) != null) {
+          modelNames = [ref];
+        } else if ((ref = get(virtual, 'options.ref')) != null) {
+          if (typeof ref === 'function') {
+            ref = ref.call(doc, doc);
+          }
+
+          // When referencing nested arrays, the ref should be an Array
+          // of modelNames.
+          if (Array.isArray(ref)) {
+            modelNames = ref;
+          } else {
+            modelNames = [ref];
+          }
+
+          isVirtual = true;
+        } else {
+          // We may have a discriminator, in which case we don't want to
+          // populate using the base model by default
+          modelNames = discriminatorKey ? null : [model.modelName];
+        }
+      } else {
+        modelNames = [modelNameFromQuery]; // query options
+      }
+    }
+
+    if (!modelNames) {
+      return;
+    }
+
+    if (!Array.isArray(modelNames)) {
+      modelNames = [modelNames];
+    }
+
+    return modelNames;
+  }
+
   return map;
 }
 
@@ -3852,20 +3886,6 @@ function isDoc(doc) {
   return true;
 }
 
-/**
- * Finds the schema for `path`. This is different than
- * calling `schema.path` as it also resolves paths with
- * positional selectors (something.$.another.$.path).
- *
- * @param {String} path
- * @return {Schema}
- * @api private
- */
-
-Model._getSchema = function _getSchema(path) {
-  return this.schema._getSchema(path);
-};
-
 /*!
  * Compiler utility.
  *

package/lib/query.js

@@ -1002,13 +1002,16 @@ Query.prototype.read = function read(pref, tags) {
  * - [readPreference](http://docs.mongodb.org/manual/applications/replication/#read-preference)
  * - [hint](http://www.mongodb.org/display/DOCS/Advanced+Queries#AdvancedQueries-%24hint)
  *
- * The following options are only for `update()`, `updateOne()`, `updateMany()`, `replaceOne()`, and `findOneAndUpdate()`:
+ * The following options are only for `update()`, `updateOne()`, `updateMany()`, `replaceOne()`, `findOneAndUpdate()`, and `findByIdAndUpdate()`:
  * - [upsert](https://docs.mongodb.com/manual/reference/method/db.collection.update/)
  * - [writeConcern](https://docs.mongodb.com/manual/reference/method/db.collection.update/)
  *
- * The following options are only for `find()`, `findOne()`, `findById()`, and `findOneAndUpdate()`:
+ * The following options are only for `find()`, `findOne()`, `findById()`, `findOneAndUpdate()`, and `findByIdAndUpdate()`:
  * - [lean](./api.html#query_Query-lean)
  *
+ * The following options are only for all operations **except** `update()`, `updateOne()`, `updateMany()`, `remove()`, `deleteOne()`, and `deleteMany()`:
+ * - [maxTimeMS](https://docs.mongodb.com/manual/reference/operator/meta/maxTimeMS/)
+ *
  * The following options are for all operations:
  * - [collation](https://docs.mongodb.com/manual/reference/collation/)
  *

package/lib/queryhelpers.js

@@ -19,7 +19,9 @@ exports.preparePopulationOptions = function preparePopulationOptions(query, opti
   var pop = utils.object.vals(query.options.populate);
 
   // lean options should trickle through all queries
-  if (options.lean) pop.forEach(makeLean);
+  if (options.lean) {
+    pop.forEach(makeLean(options.lean));
+  }
 
   return pop;
 };
@@ -37,7 +39,9 @@ exports.preparePopulationOptionsMQ = function preparePopulationOptionsMQ(query,
   var pop = utils.object.vals(query._mongooseOptions.populate);
 
   // lean options should trickle through all queries
-  if (options.lean) pop.forEach(makeLean);
+  if (options.lean) {
+    pop.forEach(makeLean(options.lean));
+  }
 
   return pop;
 };
@@ -207,7 +211,9 @@ exports.applyPaths = function applyPaths(fields, schema) {
  * @param {Object} option
  */
 
-function makeLean(option) {
-  option.options || (option.options = {});
-  option.options.lean = true;
+function makeLean(val) {
+  return function(option) {
+    option.options || (option.options = {});
+    option.options.lean = val;
+  };
 }

package/lib/schema/array.js

@@ -15,8 +15,6 @@ var Types = {
   ObjectId: require('./objectid'),
   Buffer: require('./buffer')
 };
-var MongooseArray = require('../types').Array;
-var EmbeddedDoc = require('../types').Embedded;
 var Mixed = require('./mixed');
 var cast = require('../cast');
 var util = require('util');
@@ -24,6 +22,9 @@ var utils = require('../utils');
 var castToNumber = require('./operators/helpers').castToNumber;
 var geospatial = require('./operators/geospatial');
 
+var MongooseArray;
+var EmbeddedDoc;
+
 /**
  * Array SchemaType constructor
  *
@@ -35,6 +36,9 @@ var geospatial = require('./operators/geospatial');
  */
 
 function SchemaArray(key, cast, options, schemaOptions) {
+  // lazy load
+  EmbeddedDoc || (EmbeddedDoc = require('../types').Embedded);
+
   var typeKey = 'type';
   if (schemaOptions && schemaOptions.typeKey) {
     typeKey = schemaOptions.typeKey;
@@ -155,6 +159,9 @@ SchemaArray.prototype.applyGetters = function(value, scope) {
  */
 
 SchemaArray.prototype.cast = function(value, doc, init) {
+  // lazy load
+  MongooseArray || (MongooseArray = require('../types').Array);
+
   if (Array.isArray(value)) {
     if (!value.length && doc) {
       var indexes = doc.schema.indexedPaths();

package/lib/schema/buffer.js

@@ -5,7 +5,7 @@
 var handleBitwiseOperator = require('./operators/bitwise');
 var utils = require('../utils');
 
-var MongooseBuffer = require('../types').Buffer;
+var MongooseBuffer = require('../types/buffer');
 var SchemaType = require('../schematype');
 
 var Binary = MongooseBuffer.Binary;

package/lib/schema/documentarray.js

@@ -8,13 +8,14 @@ var ArrayType = require('./array');
 var CastError = require('../error/cast');
 var Document = require('../document');
 var EventEmitter = require('events').EventEmitter;
-var MongooseDocumentArray = require('../types/documentarray');
 var SchemaType = require('../schematype');
-var Subdocument = require('../types/embedded');
 var discriminator = require('../services/model/discriminator');
 var util = require('util');
 var utils = require('../utils');
 
+var MongooseDocumentArray;
+var Subdocument;
+
 /**
  * SubdocsArray SchemaType constructor
  *
@@ -66,6 +67,8 @@ DocumentArray.prototype.constructor = DocumentArray;
  */
 
 function _createConstructor(schema, options) {
+  Subdocument || (Subdocument = require('../types/embedded'));
+
   // compile an embedded document for this schema
   function EmbeddedDocument() {
     Subdocument.apply(this, arguments);
@@ -130,6 +133,9 @@ DocumentArray.prototype.discriminator = function(name, schema) {
  */
 
 DocumentArray.prototype.doValidate = function(array, fn, scope, options) {
+  // lazy load
+  MongooseDocumentArray || (MongooseDocumentArray = require('../types/documentarray'));
+
   var _this = this;
   SchemaType.prototype.doValidate.call(this, array, function(err) {
     if (err) {
@@ -251,6 +257,9 @@ DocumentArray.prototype.doValidateSync = function(array, scope) {
  */
 
 DocumentArray.prototype.cast = function(value, doc, init, prev, options) {
+  // lazy load
+  MongooseDocumentArray || (MongooseDocumentArray = require('../types/documentarray'));
+
   var selected;
   var subdoc;
   var i;

package/lib/schema/embedded.js

@@ -7,11 +7,12 @@
 var $exists = require('./operators/exists');
 var EventEmitter = require('events').EventEmitter;
 var SchemaType = require('../schematype');
-var Subdocument = require('../types/subdocument');
 var castToNumber = require('./operators/helpers').castToNumber;
 var discriminator = require('../services/model/discriminator');
 var geospatial = require('./operators/geospatial');
 
+var Subdocument;
+
 module.exports = Embedded;
 
 /**
@@ -43,6 +44,9 @@ Embedded.prototype = Object.create(SchemaType.prototype);
  */
 
 function _createConstructor(schema) {
+  // lazy load
+  Subdocument || (Subdocument = require('../types/subdocument'));
+
   var _embedded = function SingleNested(value, path, parent) {
     var _this = this;
 

package/lib/schema.js

@@ -804,22 +804,17 @@ Schema.prototype.hasMixedParent = function(path) {
  */
 Schema.prototype.setupTimestamp = function(timestamps) {
   if (timestamps) {
-    var paths = ['createdAt', 'updatedAt'].map(handleTimestampOption.bind(null, timestamps));
-    var createdAt = paths[0];
-    var updatedAt = paths[1];
-    var schemaAdditions = paths.reduce(function(cur, path) {
-      if (path != null) {
-        var parts = path.split('.');
-        if (this.pathType(path) === 'adhocOrUndefined') {
-          for (var i = 0; i < parts.length; ++i) {
-            cur[parts[i]] = (i < parts.length - 1 ?
-            cur[parts[i]] || {} :
-              Date);
-          }
-        }
-      }
-      return cur;
-    }.bind(this), {});
+    var createdAt = handleTimestampOption(timestamps, 'createdAt');
+    var updatedAt = handleTimestampOption(timestamps, 'updatedAt');
+    var schemaAdditions = {};
+
+    if (updatedAt && !this.paths[updatedAt]) {
+      schemaAdditions[updatedAt] = Date;
+    }
+
+    if (createdAt && !this.paths[createdAt]) {
+      schemaAdditions[createdAt] = Date;
+    }
 
     this.add(schemaAdditions);
 
@@ -1403,7 +1398,8 @@ Object.defineProperty(Schema, 'indexTypes', {
 });
 
 /**
- * Compiles indexes from fields and schema-level indexes
+ * Returns a list of indexes that this schema declares, via `schema.index()`
+ * or by `index: true` in a path's options.
  *
  * @api public
  */

package/lib/services/model/discriminator.js

@@ -128,8 +128,11 @@ module.exports = function discriminator(model, name, schema) {
 
   if (!model.schema.discriminatorMapping) {
     model.schema.discriminatorMapping = {key: key, value: null, isRoot: true};
+    model.schema.discriminators = {};
   }
 
+  model.schema.discriminators[name] = schema;
+
   if (model.discriminators[name]) {
     throw new Error('Discriminator with name "' + name + '" already exists');
   }

package/lib/services/populate/getSchemaTypes.js

@@ -0,0 +1,115 @@
+'use strict';
+
+/*!
+ * ignore
+ */
+
+var Mixed = require('../../schema/mixed');
+var mpath = require('mpath');
+
+/*!
+ * @param {Schema} schema
+ * @param {Object} doc POJO
+ * @param {string} path
+ */
+
+module.exports = function getSchemaTypes(schema, doc, path) {
+  var pathschema = schema.path(path);
+
+  if (pathschema) {
+    return pathschema;
+  }
+
+  function search(parts, schema) {
+    var p = parts.length + 1;
+    var foundschema;
+    var trypath;
+
+    while (p--) {
+      trypath = parts.slice(0, p).join('.');
+      foundschema = schema.path(trypath);
+      if (foundschema) {
+        if (foundschema.caster) {
+          // array of Mixed?
+          if (foundschema.caster instanceof Mixed) {
+            return foundschema.caster;
+          }
+
+          var schemas = null;
+          if (doc != null && foundschema.schema != null && foundschema.schema.discriminators != null) {
+            var discriminators = foundschema.schema.discriminators;
+            var keys = mpath.get(trypath + '.' + foundschema.schema.options.discriminatorKey,
+              doc);
+            schemas = Object.keys(discriminators).
+              reduce(function(cur, discriminator) {
+                if (keys.indexOf(discriminator) !== -1) {
+                  cur.push(discriminators[discriminator]);
+                }
+                return cur;
+              }, []);
+          }
+
+          // Now that we found the array, we need to check if there
+          // are remaining document paths to look up for casting.
+          // Also we need to handle array.$.path since schema.path
+          // doesn't work for that.
+          // If there is no foundschema.schema we are dealing with
+          // a path like array.$
+          if (p !== parts.length && foundschema.schema) {
+            var ret;
+            if (parts[p] === '$') {
+              if (p + 1 === parts.length) {
+                // comments.$
+                return foundschema;
+              }
+              // comments.$.comments.$.title
+              ret = search(parts.slice(p + 1), schema);
+              if (ret) {
+                ret.$isUnderneathDocArray = ret.$isUnderneathDocArray ||
+                  !foundschema.schema.$isSingleNested;
+              }
+              return ret;
+            }
+
+            if (schemas != null && schemas.length > 0) {
+              ret = [];
+              for (var i = 0; i < schemas.length; ++i) {
+                var _ret = search(parts.slice(p), schemas[i]);
+                if (_ret != null) {
+                  _ret.$isUnderneathDocArray = _ret.$isUnderneathDocArray ||
+                    !foundschema.schema.$isSingleNested;
+                  if (_ret.$isUnderneathDocArray) {
+                    ret.$isUnderneathDocArray = true;
+                  }
+                  ret.push(_ret);
+                }
+              }
+              return ret;
+            } else {
+              ret = search(parts.slice(p), foundschema.schema);
+
+              if (ret) {
+                ret.$isUnderneathDocArray = ret.$isUnderneathDocArray ||
+                  !foundschema.schema.$isSingleNested;
+              }
+
+              return ret;
+            }
+          }
+        }
+
+        return foundschema;
+      }
+    }
+  }
+
+  // look for arrays
+  var parts = path.split('.');
+  for (var i = 0; i < parts.length; ++i) {
+    if (parts[i] === '$') {
+      // Re: gh-5628, because `schema.path()` doesn't take $ into account.
+      parts[i] = '0';
+    }
+  }
+  return search(parts, schema);
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mongoose",
   "description": "Mongoose MongoDB ODM",
-  "version": "4.13.7",
+  "version": "4.13.11",
   "author": "Guillermo Rauch <guillermo@learnboost.com>",
   "keywords": [
     "mongodb",
@@ -24,7 +24,7 @@
     "hooks-fixed": "2.0.2",
     "kareem": "1.5.0",
     "lodash.get": "4.4.2",
-    "mongodb": "2.2.33",
+    "mongodb": "2.2.34",
     "mpath": "0.3.0",
     "mpromise": "0.5.5",
     "mquery": "2.3.3",
@@ -46,7 +46,7 @@
     "jade": "0.26.3",
     "lodash": "4.16.6",
     "markdown": "0.5.0",
-    "marked": "0.3.6",
+    "marked": "0.3.9",
     "mocha": "3.2.0",
     "mongoose-long": "0.1.1",
     "mongodb-topology-manager": "1.0.11",
@@ -77,6 +77,8 @@
     "install-browser": "npm install `node format_deps.js`",
     "lint": "eslint . --quiet",
     "nsp": "nsp check",
+    "release": "git push origin master --tags && npm publish",
+    "release-legacy": "git push origin 4.x --tags && npm publish --tag legacy",
     "test": "mocha test/*.test.js test/**/*.test.js",
     "test-cov": "istanbul cover --report text --report html _mocha test/*.test.js"
   },

package/release-items.md

@@ -1,11 +1,11 @@
 ## mongoose release procedure
 
 1.  tests must pass
-2.  update package.json version
-3.  update History.md using `git changelog` or similar. list the related ticket(s) #<TICKET_NUMBER> as well as a link to the github user who fixed it if applicable.
-4.  git commit -m 'release x.x.x'
+2.  update `package.json` and `package-lock.json` version
+3.  update History.md using `git changelog` or similar. Add #<TICKET_NUMBER> as well as a link to the github user who fixed it if applicable.
+4.  git commit -a -m 'release x.x.x'
 5.  git tag x.x.x
-6.  git push origin BRANCH --tags && npm publish
+6.  `npm run release`, or `npm run release-legacy` for 4.x
 7.  update mongoosejs.com (see "updating the website" below)
 8.  tweet changelog link from [@mongoosejs](https://twitter.com/mongoosejs)
 9.  Announce on mongoosejsteam slack channel
@@ -14,16 +14,16 @@
 
 ## updating the website
 
-For 4.x
+For 5.x
 
 0. Change to the master branch
 1. execute `make docs` (when this process completes you'll be on the gh-pages branch)
-2. `git commit -a -m 'chore: website 4.x.x'`
+2. `git commit -a -m 'chore: website 5.x.x'`
 3. `git push origin gh-pages`
 
-For 3.8.x:
+For 4.x
 
-0. Change to the 3.8.x branch
+0. Change to the 4.x branch
 1. execute `make docs_legacy` (when this process completes you'll be on the gh-pages branch)
-2. `git commit -a -m 'website; regen <x.x.x>'`
+2. `git commit -a -m 'chore: website 4.x.x'`
 3. `git push origin gh-pages`

package/test.js

@@ -0,0 +1 @@
+require('./lib/browserDocument');

package/.npmignore

@@ -1,19 +0,0 @@
-lib-cov
-**.swp
-*.sw*
-*.orig
-.DS_Store
-node_modules/
-benchmarks/
-docs/
-test/
-Makefile
-CNAME
-index.html
-index.jade
-bin/
-karma.*.js
-format_deps.js
-tools/31*
-*.key
-data/