mongodb 2.2.36 → 3.0.2

package/.eslintrc

@@ -1,15 +1,29 @@
 {
-  "extends": ["eslint:recommended"],
+  "extends": [
+    "eslint:recommended"
+  ],
   "env": {
     "node": true,
     "mocha": true
-   },
-   "ecmaFeatures": {
-    "es6": true,
-   },
-   "plugins": [
-   ],
-   "rules": {
-    "no-console":0
-   }
+  },
+  "globals": {
+    "Promise": true
+  },
+  "parserOptions": {
+    "ecmaVersion": 2017
+  },
+  "plugins": [
+    "prettier"
+  ],
+  "rules": {
+    "prettier/prettier": ["error", {
+      "singleQuote": true,
+      "tabWidth": 2,
+      "printWidth": 100
+    }],
+
+    "no-console": 0,
+    "eqeqeq": ["error", "always", {"null": "ignore"}],
+    "strict": ["error", "global"]
+  }
 }

package/CHANGES_3.0.0.md

@@ -0,0 +1,288 @@
+## Features
+
+The following are new features added in MongoDB 3.6 and supported in the Node.js driver.
+
+### Retryable Writes
+
+Support has been added for retryable writes through the connection string. MongoDB 3.6
+will utilize server sessions to allow some write commands to specify a transaction ID to enforce
+at-most-once semantics for the write operation(s) and allow for retrying the operation if the driver
+fails to obtain a write result (e.g. network error or "not master" error after a replica set
+failover)Full details can be found in the [Retryable Writes Specification](https://github.com/mongodb/specifications/blob/master/source/retryable-writes/retryable-writes.rst).
+
+
+### DNS Seedlist Support
+
+Support has been added for DNS Seedlists. Users may now configure a single domain to return a list
+of host names. Full details can be found in the [Seedlist Discovery Specification](https://github.com/mongodb/specifications/blob/master/source/initial-dns-seedlist-discovery/initial-dns-seedlist-discovery.rst).
+
+### Change Streams
+
+Support has been added for creating a stream to track changes to a particular collection. This is a
+new feature in MongoDB 3.6. Full details can be found in the [Change Stream Specification](https://github.com/mongodb/specifications/blob/master/source/change-streams.rst) as
+well as [examples in the test directory](https://github.com/mongodb/node-mongodb-native/blob/3.0.0/test/functional/operation_changestream_example_tests.js).
+
+### Sessions
+
+Version 3.6 of the server introduces the concept of logical sessions for clients. In this driver,
+`MongoClient` now tracks all sessions created on the client, and explicitly cleans them up upon
+client close. More information can be found in the [Driver Sessions Specification](https://github.com/mongodb/specifications/blob/master/source/sessions/driver-sessions.rst).
+
+## API Changes
+
+We removed the following API methods.
+
+- `Db.prototype.authenticate`
+- `Db.prototype.logout`
+- `Db.prototype.open`
+- `Db.prototype.db`
+- `Db.prototype.close`
+- `Admin.prototype.authenticate`
+- `Admin.prototype.logout`
+- `Admin.prototype.profilingLevel`
+- `Admin.prototype.setProfilingLevel`
+- `Admin.prototype.profilingInfo`
+- `Cursor.prototype.nextObject`
+
+We've added the following API methods.
+- `MongoClient.prototype.logout`
+- `MongoClient.prototype.isConnected`
+- `MongoClient.prototype.db`
+- `MongoClient.prototype.close`
+- `MongoClient.prototype.connect`
+- `Db.prototype.profilingLevel`
+- `Db.prototype.setProfilingLevel`
+- `Db.prototype.profilingInfo`
+
+In core we have removed the possibility of authenticating multiple credentials against the same
+connection pool. This is to avoid problems with MongoDB 3.6 or higher where all users will reside in
+the admin database and thus database level authentication is no longer supported.
+
+The legacy construct
+
+```js
+var db = var Db('test', new Server('localhost', 27017));
+db.open((err, db) => {
+  // Authenticate
+  db.admin().authenticate('root', 'root', (err, success) => {
+    ....
+  });
+});
+```
+
+is replaced with
+
+```js
+new MongoClient(new Server('localhost', 27017), {
+    user: 'root'
+  , password: 'root'
+  , authSource: 'adming'}).connect((err, client) => {
+    ....
+  })
+```
+
+`MongoClient.connect` works as expected but it returns the MongoClient instance instead of a
+database object.
+
+The legacy operation
+
+```js
+MongoClient.connect('mongodb://localhost:27017/test', (err, db) => {
+  // Database returned
+});
+```
+
+is replaced with
+
+```js
+MongoClient.connect('mongodb://localhost:27017/test', (err, client) => {
+  // Client returned
+  var db = client.db('test');
+});
+```
+
+## Other Changes
+
+Below are more updates to the driver in the 3.0.0 release.
+
+### Connection String
+
+Following [changes to the MongoDB connection string specification](https://github.com/mongodb/specifications/commit/4631ccd4f825fb1a3aba204510023f9b4d193a05),
+authentication and hostname details in connection strings must now be URL-encoded. These changes
+reduce ambiguity in connection strings.
+
+For example, whereas before `mongodb://u$ername:pa$$w{}rd@/tmp/mongodb-27017.sock/test` would have
+been a valid connection string (with username `u$ername`, password `pa$$w{}rd`, host `/tmp/mongodb-27017.sock`
+and auth database `test`), the connection string for those details would now have to be provided to
+MongoClient as `mongodb://u%24ername:pa%24%24w%7B%7Drd@%2Ftmp%2Fmongodb-27017.sock/test`.
+
+Unsupported URL options in a connection string now log a warning instead of throwing an error.
+
+For more information about connection strings, read the [connection string specification](https://github.com/mongodb/specifications/blob/master/source/connection-string/connection-string-spec.rst).
+
+
+### `BulkWriteResult` & `BulkWriteError`
+
+When errors occured with bulk write operations in the past, the driver would callback or reject with
+the first write error, as well as passing the resulting `BulkWriteResult`.  For example:
+
+```js
+MongoClient.connect('mongodb://localhost', function(err, client) {
+  const collection = client.db('foo').collection('test-collection')
+
+  collection
+    .insert({ id: 1 })
+    .then(() => collection.insertMany([ { id: 1 }, { id: 1 } ]))
+    .then(result => /* deal with errors in `result */)
+    .catch(err => /* no error is thrown for bulk errors */);
+});
+```
+
+becomes:
+
+```js
+MongoClient.connect('mongodb://localhost', function(err, client) {
+  const collection = client.db('foo').collection('test-collection')
+
+  collection
+    .insert({ id: 1 })
+    .then(() => collection.insertMany([ { id: 1 }, { id: 1 } ]))
+    .then(() => /* this will not be called in the event of a bulk write error */)
+    .catch(err => /* deal with errors in `err` */);
+});
+```
+
+Where the result of the failed operation is a `BulkWriteError` which has a child value `result`
+which is the original `BulkWriteResult`.  Similarly, the callback form no longer calls back with an
+`(Error, BulkWriteResult)`, but instead just a `(BulkWriteError)`.
+
+### `mapReduce` inlined results
+
+When `Collection.prototype.mapReduce` is invoked with a callback that includes `out: 'inline'`,
+it would diverge from the `Promise`-based variant by returning additional data as positional
+arguments to  the callback (`(err, result, stats, ...)`).  This is no longer the case, both variants
+of the method will now return a single object for all results - a single value for the default case,
+and an object similar to the existing `Promise` form for cases where there is more data to pass to
+the user.
+
+### Find
+
+`find` and `findOne` no longer support the `fields` parameter. You can achieve the same results as
+the `fields` parameter by using `Cursor.prototype.project` or by passing the `projection` property
+in on the options object . Additionally, `find` does not support individual options like `skip` and
+`limit` as positional parameters. You must either pass in these parameters in the `options` object,
+or add them via `Cursor` methods like `Cursor.prototype.skip`.
+
+### `Collection.prototype.aggregate`
+
+`Collection.prototype.aggregate` no longer accepts variadic arguments. While this
+was originally added to improve compatibility with the mongo shell, it has never
+been a documented feature, and has led to more bugs and maintenance burden.
+Pipeline stages are now only accepted as an `Array` of stages as the first argument.
+
+2.x syntax:
+
+```js
+collection.prototype.aggregate(
+  {$match: {a: 1}},
+  {$project: {b: 1, _id: 0}},
+  function (err, result) {
+    ...
+  }
+);
+```
+
+3.x syntax
+
+```js
+collection.prototype.aggregate(
+  [
+    {$match: {a: 1}},
+    {$project: {b: 1, _id: 0}}
+  ],
+  function (err, cursor) {
+    ...
+  }
+);
+```
+
+`Collection.prototype.aggregate` now returns a cursor if a callback is provided. It used to return
+the resulting documents which is the same as calling `cursor.toArray()` on the cursor we now pass to
+the callback.
+
+2.x syntax
+
+```js
+collection.prototype.aggregate(
+  [
+    {$match: {a: 1}},
+    {$project: {b: 1, _id: 0}}
+  ],
+  function (err, result) {
+    console.log(result);
+  }
+);
+```
+
+3.x syntax
+
+```js
+collection.prototype.aggregate(
+  [
+    {$match: {a: 1}},
+    {$project: {b: 1, _id: 0}}
+  ],
+  function (err, cursor) {
+    cursor.toArray(function(err, result) {
+      console.log(result);
+    });
+  }
+);
+```
+
+Support added for `comment` in the aggregation command. Support also added for a `hint` field in the
+aggregation `options`.
+
+If you use aggregation and try to use the `explain` flag while you have a `readConcern` or
+`writeConcern`, your query will now fail.
+
+### `updateOne` & `updateMany`
+
+The driver now ensures that updated documents contain atomic operators. For instance, if a user
+tries to update an existing document but passes in no operations (such as `$set`, `$unset`, or
+`$rename`), the driver will now error:
+
+```js
+
+let testCollection = db.collection('test');
+testCollection.updateOne({_id: 'test'}, {});
+// An error is returned: The update operation document must contain at least one atomic operator.
+```
+
+### `keepAlive`
+
+Wherever it occurs, the option `keepAlive` has been changed. `keepAlive` is now a boolean that enables/disables `keepAlive`, while `keepAliveInitialDelay` specifies how long to wait before initiating keepAlive. This brings the API in line with [NodeJS's socket api](https://nodejs.org/dist/latest-v9.x/docs/api/all.html#net_socket_setkeepalive_enable_initialdelay)
+
+### `insertMany`
+
+Now `insertMany` returns `insertedIds` in a map of the index of the inserted document to the id of the inserted document:
+
+```js
+{
+  "0": 2,
+  "1": 3
+}
+```
+
+Previously an array of ids was returned: `[ 2, 3 ]`. This change occurs with both ordered and unordered `insertMany` calls, see the [CRUD specifications](https://github.com/mongodb/specifications/blob/master/source/crud/crud.rst#results) for more details.
+
+### `geoNear` command helper
+
+The functionality of the geoNear command is duplicated elsewhere in the language, in the `$near`/`$nearSphere` query operators on unsharded collections, and in the `$geoNear` aggregation stage on all collections. Maintaining this command increases our test surface, and creates additional work when adding features that must be supported on all read commands. As a result, the command will be fully
+removed in the MongoDB 4.0 release, and we are choosing to remove it in this
+major release of the node driver.
+
+### Tests
+
+We have updated all of the tests to use [Mocha](https://mochajs.org) and a new test runner, [`mongodb-test-runner`](https://github.com/mongodb-js/mongodb-test-runner), which
+sets up topologies for the test scenarios.

package/HISTORY.md

@@ -1,59 +1,154 @@
-<a name="2.2.35"></a>
-## [2.2.35](https://github.com/mongodb/node-mongodb-native/compare/v2.2.34...v2.2.35) (2018-02-26)
+<a name="3.0.2"></a>
+## [3.0.2](https://github.com/mongodb/node-mongodb-native/compare/v3.0.1...v3.0.2) (2018-01-29)
 
 
 ### Bug Fixes
 
-* **url parser:** preserve auth creds when composing conn string ([#1641](https://github.com/mongodb/node-mongodb-native/issues/1641)) ([ecedce6](https://github.com/mongodb/node-mongodb-native/commit/ecedce6))
+* **collection:** ensure dynamic require of `db` is wrapped in parentheses ([efa78f0](https://github.com/mongodb/node-mongodb-native/commit/efa78f0))
+* **db:** only callback with MongoError NODE-1293 ([#1652](https://github.com/mongodb/node-mongodb-native/issues/1652)) ([45bc722](https://github.com/mongodb/node-mongodb-native/commit/45bc722))
+* **topology base:** allow more than 10 event listeners ([#1630](https://github.com/mongodb/node-mongodb-native/issues/1630)) ([d9fb750](https://github.com/mongodb/node-mongodb-native/commit/d9fb750))
+* **url parser:** preserve auth creds when composing conn string  ([#1640](https://github.com/mongodb/node-mongodb-native/issues/1640)) ([eddca5e](https://github.com/mongodb/node-mongodb-native/commit/eddca5e))
 
 
 ### Features
 
-* **core**: update mongodb-core to 2.1.19
+* **bulk:** forward 'checkKeys' option for ordered and unordered bulk operations ([421a6b2](https://github.com/mongodb/node-mongodb-native/commit/421a6b2))
+* **collection:** expose `dbName` property of collection ([6fd05c1](https://github.com/mongodb/node-mongodb-native/commit/6fd05c1))
 
 
 
-<a name="2.2.34"></a>
-## [2.2.34](https://github.com/mongodb/node-mongodb-native/compare/v2.2.33...v2.2.34) (2018-01-03)
+<a name="3.0.1"></a>
+## [3.0.1](https://github.com/mongodb/node-mongodb-native/compare/v3.0.0...v3.0.1) (2017-12-24)
+
+* update mongodb-core to 3.0.1
+
+<a name="3.0.0"></a>
+# [3.0.0](https://github.com/mongodb/node-mongodb-native/compare/v3.0.0-rc0...v3.0.0) (2017-12-24)
 
 
 ### Bug Fixes
 
-* **collection:** allow { upsert: 1 } for findOneAndUpdate() and update() ([#1580](https://github.com/mongodb/node-mongodb-native/issues/1580)) ([0f338c8](https://github.com/mongodb/node-mongodb-native/commit/0f338c8)), closes [Automattic/mongoose#5839](https://github.com/Automattic/mongoose/issues/5839)
-* **GridFS:** fix TypeError: doc.data.length is not a function ([811de0c](https://github.com/mongodb/node-mongodb-native/commit/811de0c))
-* **import:** adds missing import to lib/authenticate.js ([10db9a2](https://github.com/mongodb/node-mongodb-native/commit/10db9a2))
-* **list-collections:** ensure default of primary ReadPreference ([0935306](https://github.com/mongodb/node-mongodb-native/commit/0935306))
+* **aggregate:** remove support for inline results for aggregate ([#1620](https://github.com/mongodb/node-mongodb-native/issues/1620)) ([84457ec](https://github.com/mongodb/node-mongodb-native/commit/84457ec))
+* **topologies:** unify topologies connect API ([#1615](https://github.com/mongodb/node-mongodb-native/issues/1615)) ([0fb4658](https://github.com/mongodb/node-mongodb-native/commit/0fb4658))
 
 
 ### Features
 
-* **ssl:** adds missing ssl options ssl options for `ciphers` and `ecdhCurve` ([bd4fb53](https://github.com/mongodb/node-mongodb-native/commit/bd4fb53))
-* **url parser:** add dns seedlist support ([2d357bc](https://github.com/mongodb/node-mongodb-native/commit/2d357bc))
-* **core**: update mongodb-core to 2.1.18
+* **keepAlive:** make keepAlive options consistent ([#1612](https://github.com/mongodb/node-mongodb-native/issues/1612)) ([f608f44](https://github.com/mongodb/node-mongodb-native/commit/f608f44))
 
 
-2.2.33 2017-10-12
------------------
-* update to mongodb-core 2.1.17
+### BREAKING CHANGES
 
-2.2.32 2017-10-11
------------------
-* update to mongodb-core 2.1.16
-* ensure that the `cursor` key is always present in aggregation commands
-* `Cursor.prototype.hasNext` now propagates errors when using callback
-* allow passing `noCursorTimeout` as an option to `find()`
-* bubble up `reconnectFailed` event from Server topology
+* **topologies:** Function signature for `.connect` method on replset and mongos has changed. You shouldn't have been using this anyway, but if you were, you only should pass `options` and `callback`.
+
+Part of NODE-1089
+* **keepAlive:** option `keepAlive` is now split into boolean `keepAlive` and
+number `keepAliveInitialDelay`
+
+Fixes NODE-998
+
+
+
+<a name="3.0.0-rc0"></a>
+# [3.0.0-rc0](https://github.com/mongodb/node-mongodb-native/compare/v2.2.31...v3.0.0-rc0) (2017-12-05)
+
+
+### Bug Fixes
+
+* **aggregation:** ensure that the `cursor` key is always present ([f16f314](https://github.com/mongodb/node-mongodb-native/commit/f16f314))
+* **apm:** give users access to raw server responses ([88b206b](https://github.com/mongodb/node-mongodb-native/commit/88b206b))
+* **apm:** only rebuilt cursor if reply is non-null ([96052c8](https://github.com/mongodb/node-mongodb-native/commit/96052c8))
+* **apm:** rebuild lost `cursor` info on pre-OP_QUERY responses ([4242d49](https://github.com/mongodb/node-mongodb-native/commit/4242d49))
+* **bulk-unordered:** add check for ignoreUndefined ([f38641a](https://github.com/mongodb/node-mongodb-native/commit/f38641a))
+* **change stream examples:** use timeouts, cleanup ([c5fec5f](https://github.com/mongodb/node-mongodb-native/commit/c5fec5f))
+* **change-streams:** ensure a majority read concern on initial agg ([23011e9](https://github.com/mongodb/node-mongodb-native/commit/23011e9))
+* **changeStreams:** fixing node4 issue with util.inherits ([#1587](https://github.com/mongodb/node-mongodb-native/issues/1587)) ([168bb3d](https://github.com/mongodb/node-mongodb-native/commit/168bb3d))
+* **collection:** allow { upsert: 1 } for findOneAndUpdate() and update() ([5bcedd6](https://github.com/mongodb/node-mongodb-native/commit/5bcedd6))
+* **collection:** allow passing `noCursorTimeout` as an option to `find()` ([e9c4ffc](https://github.com/mongodb/node-mongodb-native/commit/e9c4ffc))
+* **collection:** make the parameters of findOne very explicit ([3054f1a](https://github.com/mongodb/node-mongodb-native/commit/3054f1a))
+* **cursor:** `hasNext` should propagate errors when using callback ([6339625](https://github.com/mongodb/node-mongodb-native/commit/6339625))
+* **cursor:** close readable on `null` response for dead cursor ([6aca2c5](https://github.com/mongodb/node-mongodb-native/commit/6aca2c5))
+* **dns txt records:** check options are set ([e5caf4f](https://github.com/mongodb/node-mongodb-native/commit/e5caf4f))
+* **docs:** Represent each valid option in docs in both places ([fde6e5d](https://github.com/mongodb/node-mongodb-native/commit/fde6e5d))
+* **grid-store:** add missing callback ([66a9a05](https://github.com/mongodb/node-mongodb-native/commit/66a9a05))
+* **grid-store:** move into callback scope ([b53f65f](https://github.com/mongodb/node-mongodb-native/commit/b53f65f))
+* **GridFS:**  fix TypeError: doc.data.length is not a function ([#1570](https://github.com/mongodb/node-mongodb-native/issues/1570)) ([22a4628](https://github.com/mongodb/node-mongodb-native/commit/22a4628))
+* **list-collections:** ensure default of primary ReadPreference ([4a0cfeb](https://github.com/mongodb/node-mongodb-native/commit/4a0cfeb))
+* **mongo client:** close client before calling done ([c828aab](https://github.com/mongodb/node-mongodb-native/commit/c828aab))
+* **mongo client:** do not connect if url parse error ([cd10084](https://github.com/mongodb/node-mongodb-native/commit/cd10084))
+* **mongo client:** send error to cb ([eafc9e2](https://github.com/mongodb/node-mongodb-native/commit/eafc9e2))
+* **mongo-client:** move to inside of callback ([68b0fca](https://github.com/mongodb/node-mongodb-native/commit/68b0fca))
+* **mongo-client:** options should not be passed to `connect` ([474ac65](https://github.com/mongodb/node-mongodb-native/commit/474ac65))
+* **tests:** migrate 2.x tests to 3.x ([3a5232a](https://github.com/mongodb/node-mongodb-native/commit/3a5232a))
+* **updateOne/updateMany:** ensure that update documents contain atomic operators ([8b4255a](https://github.com/mongodb/node-mongodb-native/commit/8b4255a))
+* **url parser:** add check for options as cb ([52b6039](https://github.com/mongodb/node-mongodb-native/commit/52b6039))
+* **url parser:** compare srv address and parent domains ([daa186d](https://github.com/mongodb/node-mongodb-native/commit/daa186d))
+* **url parser:** compare string from first period on ([9e5d77e](https://github.com/mongodb/node-mongodb-native/commit/9e5d77e))
+* **url parser:** default to ssl true for mongodb+srv ([0fbca4b](https://github.com/mongodb/node-mongodb-native/commit/0fbca4b))
+* **url parser:** error when multiple hostnames used ([c1aa681](https://github.com/mongodb/node-mongodb-native/commit/c1aa681))
+* **url parser:** keep original uri options and default to ssl true ([e876a72](https://github.com/mongodb/node-mongodb-native/commit/e876a72))
+* **url parser:** log instead of throw error for unsupported url options ([155de2d](https://github.com/mongodb/node-mongodb-native/commit/155de2d))
+* **url parser:** make sure uri has 3 parts ([aa9871b](https://github.com/mongodb/node-mongodb-native/commit/aa9871b))
+* **url parser:** only 1 txt record allowed with 2 possible options ([d9f4218](https://github.com/mongodb/node-mongodb-native/commit/d9f4218))
+* **url parser:** only check for multiple hostnames with srv protocol ([5542bcc](https://github.com/mongodb/node-mongodb-native/commit/5542bcc))
+* **url parser:** remove .only from test ([642e39e](https://github.com/mongodb/node-mongodb-native/commit/642e39e))
+* **url parser:** return callback ([6096afc](https://github.com/mongodb/node-mongodb-native/commit/6096afc))
+* **url parser:** support single text record with multiple strings ([356fa57](https://github.com/mongodb/node-mongodb-native/commit/356fa57))
+* **url parser:** try catch bug, not actually returning from try loop ([758892b](https://github.com/mongodb/node-mongodb-native/commit/758892b))
+* **url parser:** use warn instead of info ([40ed27d](https://github.com/mongodb/node-mongodb-native/commit/40ed27d))
+* **url-parser:** remove comment, send error to cb ([d44420b](https://github.com/mongodb/node-mongodb-native/commit/d44420b))
+
+
+### Features
+
+* **aggregate:** support hit field for aggregate command ([aa7da15](https://github.com/mongodb/node-mongodb-native/commit/aa7da15))
+* **aggregation:** adds support for comment in aggregation command ([#1571](https://github.com/mongodb/node-mongodb-native/issues/1571)) ([4ac475c](https://github.com/mongodb/node-mongodb-native/commit/4ac475c))
+* **aggregation:** fail aggregation on explain + readConcern/writeConcern ([e0ca1b4](https://github.com/mongodb/node-mongodb-native/commit/e0ca1b4))
+* **causal-consistency:** support `afterClusterTime` in readConcern ([a9097f7](https://github.com/mongodb/node-mongodb-native/commit/a9097f7))
+* **change-streams:** add support for change streams ([c02d25c](https://github.com/mongodb/node-mongodb-native/commit/c02d25c))
+* **collection:** updating find API ([f26362d](https://github.com/mongodb/node-mongodb-native/commit/f26362d))
+* **execute-operation:** implementation for common op execution ([67c344f](https://github.com/mongodb/node-mongodb-native/commit/67c344f))
+* **listDatabases:** add support for nameOnly option to listDatabases ([eb79b5a](https://github.com/mongodb/node-mongodb-native/commit/eb79b5a))
+* **maxTimeMS:** adding maxTimeMS option to createIndexes and dropIndexes ([90d4a63](https://github.com/mongodb/node-mongodb-native/commit/90d4a63))
+* **mongo-client:** implement `MongoClient.prototype.startSession` ([bce5adf](https://github.com/mongodb/node-mongodb-native/commit/bce5adf))
+* **retryable-writes:** add support for `retryWrites` cs option ([2321870](https://github.com/mongodb/node-mongodb-native/commit/2321870))
+* **sessions:** MongoClient will now track sessions and release ([6829f47](https://github.com/mongodb/node-mongodb-native/commit/6829f47))
+* **sessions:** support passing sessions via objects in all methods ([a531f05](https://github.com/mongodb/node-mongodb-native/commit/a531f05))
+* **shared:** add helper utilities for assertion and suite setup ([b6cc34e](https://github.com/mongodb/node-mongodb-native/commit/b6cc34e))
+* **ssl:** adds missing ssl options ssl options for `ciphers` and `ecdhCurve` ([441b7b1](https://github.com/mongodb/node-mongodb-native/commit/441b7b1))
+* **test-shared:** add `notEqual` assertion ([41d93fd](https://github.com/mongodb/node-mongodb-native/commit/41d93fd))
+* **test-shared:** add `strictEqual` assertion method ([cad8e19](https://github.com/mongodb/node-mongodb-native/commit/cad8e19))
+* **topologies:** expose underlaying `logicalSessionTimeoutMinutes' ([1609a37](https://github.com/mongodb/node-mongodb-native/commit/1609a37))
+* **url parser:** better error message for slash in hostname ([457bc29](https://github.com/mongodb/node-mongodb-native/commit/457bc29))
+
+
+### BREAKING CHANGES
+
+* **aggregation:** If you use aggregation, and try to use the explain flag while you
+have a readConcern or writeConcern, your query will fail
+* **collection:** `find` and `findOne` no longer support the `fields` parameter.
+You can achieve the same results as the `fields` parameter by
+either using `Cursor.prototype.project`, or by passing the `projection`
+property in on the `options` object. Additionally, `find` does not
+support individual options like `skip` and `limit` as positional
+parameters. You must pass in these parameters in the `options` object
+
+
+
+3.0.0 2017-??-??
+----------------
+* NODE-1043 URI-escaping authentication and hostname details in connection string
 
 2.2.31 2017-08-08
 -----------------
-* update mongodb-core to 2.1.15
+* update mongodb-core to 2.2.15
 * allow auth option in MongoClient.connect
 * remove duplicate option `promoteLongs` from MongoClient's `connect`
 * bulk operations should not throw an error on empty batch
 
 2.2.30 2017-07-07
 -----------------
-* Update mongodb-core to 2.1.14
+* Update mongodb-core to 2.2.14
 * MongoClient
   * add `appname` to list of valid option names
   * added test for passing appname as option