mongodb 3.2.5 → 3.3.0-beta2

package/lib/gridfs/grid_store.js

@@ -36,17 +36,17 @@
  * });
  */
 const Chunk = require('./chunk');
-const ObjectID = require('mongodb-core').BSON.ObjectID;
-const ReadPreference = require('mongodb-core').ReadPreference;
+const ObjectID = require('../core').BSON.ObjectID;
+const ReadPreference = require('../core').ReadPreference;
 const Buffer = require('safe-buffer').Buffer;
 const fs = require('fs');
 const f = require('util').format;
 const util = require('util');
-const MongoError = require('mongodb-core').MongoError;
+const MongoError = require('../core').MongoError;
 const inherits = util.inherits;
 const Duplex = require('stream').Duplex;
 const shallowClone = require('../utils').shallowClone;
-const executeOperation = require('../utils').executeOperation;
+const executeLegacyOperation = require('../utils').executeLegacyOperation;
 const deprecate = require('util').deprecate;
 
 var REFERENCE_BY_FILENAME = 0,
@@ -56,7 +56,7 @@ const deprecationFn = deprecate(() => {},
 'GridStore is deprecated, and will be removed in a future version. Please use GridFSBucket instead');
 
 /**
- * Namespace provided by the mongodb-core and node.js
+ * Namespace provided by the core module
  * @external Duplex
  */
 
@@ -203,7 +203,7 @@ GridStore.prototype.open = function(options, callback) {
     throw MongoError.create({ message: 'Illegal mode ' + this.mode, driver: true });
   }
 
-  return executeOperation(this.db.s.topology, open, [this, options, callback], {
+  return executeLegacyOperation(this.db.s.topology, open, [this, options, callback], {
     skipSessions: true
   });
 };
@@ -275,7 +275,7 @@ GridStore.prototype.getc = function(options, callback) {
   if (typeof options === 'function') (callback = options), (options = {});
   options = options || {};
 
-  return executeOperation(this.db.s.topology, getc, [this, options, callback], {
+  return executeLegacyOperation(this.db.s.topology, getc, [this, options, callback], {
     skipSessions: true
   });
 };
@@ -312,7 +312,7 @@ GridStore.prototype.puts = function(string, options, callback) {
   options = options || {};
 
   var finalString = string.match(/\n$/) == null ? string + '\n' : string;
-  return executeOperation(
+  return executeLegacyOperation(
     this.db.s.topology,
     this.write.bind(this),
     [finalString, options, callback],
@@ -347,7 +347,7 @@ GridStore.prototype.write = function write(data, close, options, callback) {
   if (typeof options === 'function') (callback = options), (options = {});
   options = options || {};
 
-  return executeOperation(
+  return executeLegacyOperation(
     this.db.s.topology,
     _writeNormal,
     [this, data, close, options, callback],
@@ -388,7 +388,7 @@ GridStore.prototype.writeFile = function(file, options, callback) {
   if (typeof options === 'function') (callback = options), (options = {});
   options = options || {};
 
-  return executeOperation(this.db.s.topology, writeFile, [this, file, options, callback], {
+  return executeLegacyOperation(this.db.s.topology, writeFile, [this, file, options, callback], {
     skipSessions: true
   });
 };
@@ -473,7 +473,7 @@ GridStore.prototype.close = function(options, callback) {
   if (typeof options === 'function') (callback = options), (options = {});
   options = options || {};
 
-  return executeOperation(this.db.s.topology, close, [this, options, callback], {
+  return executeLegacyOperation(this.db.s.topology, close, [this, options, callback], {
     skipSessions: true
   });
 };
@@ -576,7 +576,7 @@ GridStore.prototype.unlink = function(options, callback) {
   if (typeof options === 'function') (callback = options), (options = {});
   options = options || {};
 
-  return executeOperation(this.db.s.topology, unlink, [this, options, callback], {
+  return executeLegacyOperation(this.db.s.topology, unlink, [this, options, callback], {
     skipSessions: true
   });
 };
@@ -639,9 +639,12 @@ GridStore.prototype.readlines = function(separator, options, callback) {
   separator = separator || '\n';
   options = args.length ? args.shift() : {};
 
-  return executeOperation(this.db.s.topology, readlines, [this, separator, options, callback], {
-    skipSessions: true
-  });
+  return executeLegacyOperation(
+    this.db.s.topology,
+    readlines,
+    [this, separator, options, callback],
+    { skipSessions: true }
+  );
 };
 
 var readlines = function(self, separator, options, callback) {
@@ -673,7 +676,7 @@ GridStore.prototype.rewind = function(options, callback) {
   if (typeof options === 'function') (callback = options), (options = {});
   options = options || {};
 
-  return executeOperation(this.db.s.topology, rewind, [this, options, callback], {
+  return executeLegacyOperation(this.db.s.topology, rewind, [this, options, callback], {
     skipSessions: true
   });
 };
@@ -735,9 +738,12 @@ GridStore.prototype.read = function(length, buffer, options, callback) {
   buffer = args.length ? args.shift() : null;
   options = args.length ? args.shift() : {};
 
-  return executeOperation(this.db.s.topology, read, [this, length, buffer, options, callback], {
-    skipSessions: true
-  });
+  return executeLegacyOperation(
+    this.db.s.topology,
+    read,
+    [this, length, buffer, options, callback],
+    { skipSessions: true }
+  );
 };
 
 var read = function(self, length, buffer, options, callback) {
@@ -851,7 +857,7 @@ GridStore.prototype.seek = function(position, seekLocation, options, callback) {
   seekLocation = args.length ? args.shift() : null;
   options = args.length ? args.shift() : {};
 
-  return executeOperation(
+  return executeLegacyOperation(
     this.db.s.topology,
     seek,
     [this, position, seekLocation, options, callback],
@@ -1285,7 +1291,7 @@ GridStore.exist = function(db, fileIdObject, rootCollection, options, callback)
   options = args.length ? args.shift() : {};
   options = options || {};
 
-  return executeOperation(
+  return executeLegacyOperation(
     db.s.topology,
     exists,
     [db, fileIdObject, rootCollection, options, callback],
@@ -1348,7 +1354,7 @@ GridStore.list = function(db, rootCollection, options, callback) {
   options = args.length ? args.shift() : {};
   options = options || {};
 
-  return executeOperation(db.s.topology, list, [db, rootCollection, options, callback], {
+  return executeLegacyOperation(db.s.topology, list, [db, rootCollection, options, callback], {
     skipSessions: true
   });
 };
@@ -1417,7 +1423,7 @@ GridStore.read = function(db, name, length, offset, options, callback) {
   options = args.length ? args.shift() : null;
   options = options || {};
 
-  return executeOperation(
+  return executeLegacyOperation(
     db.s.topology,
     readStatic,
     [db, name, length, offset, options, callback],
@@ -1470,7 +1476,7 @@ GridStore.readlines = function(db, name, separator, options, callback) {
   options = args.length ? args.shift() : null;
   options = options || {};
 
-  return executeOperation(
+  return executeLegacyOperation(
     db.s.topology,
     readlinesStatic,
     [db, name, separator, options, callback],
@@ -1506,7 +1512,7 @@ GridStore.unlink = function(db, names, options, callback) {
   options = args.length ? args.shift() : {};
   options = options || {};
 
-  return executeOperation(db.s.topology, unlinkStatic, [this, db, names, options, callback], {
+  return executeLegacyOperation(db.s.topology, unlinkStatic, [this, db, names, options, callback], {
     skipSessions: true
   });
 };

package/lib/gridfs-stream/index.js

@@ -6,7 +6,7 @@ var GridFSBucketWriteStream = require('./upload');
 var shallowClone = require('../utils').shallowClone;
 var toError = require('../utils').toError;
 var util = require('util');
-var executeOperation = require('../utils').executeOperation;
+var executeLegacyOperation = require('../utils').executeLegacyOperation;
 
 var DEFAULT_GRIDFS_BUCKET_OPTIONS = {
   bucketName: 'fs',
@@ -162,7 +162,7 @@ GridFSBucket.prototype.openDownloadStream = function(id, options) {
  */
 
 GridFSBucket.prototype.delete = function(id, callback) {
-  return executeOperation(this.s.db.s.topology, _delete, [this, id, callback], {
+  return executeLegacyOperation(this.s.db.s.topology, _delete, [this, id, callback], {
     skipSessions: true
   });
 };
@@ -287,7 +287,7 @@ GridFSBucket.prototype.openDownloadStreamByName = function(filename, options) {
  */
 
 GridFSBucket.prototype.rename = function(id, filename, callback) {
-  return executeOperation(this.s.db.s.topology, _rename, [this, id, filename, callback], {
+  return executeLegacyOperation(this.s.db.s.topology, _rename, [this, id, filename, callback], {
     skipSessions: true
   });
 };
@@ -317,7 +317,7 @@ function _rename(_this, id, filename, callback) {
  */
 
 GridFSBucket.prototype.drop = function(callback) {
-  return executeOperation(this.s.db.s.topology, _drop, [this, callback], {
+  return executeLegacyOperation(this.s.db.s.topology, _drop, [this, callback], {
     skipSessions: true
   });
 };

package/lib/gridfs-stream/upload.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var core = require('mongodb-core');
+var core = require('../core');
 var crypto = require('crypto');
 var stream = require('stream');
 var util = require('util');

package/lib/mongo_client.js

@@ -3,15 +3,15 @@
 const ChangeStream = require('./change_stream');
 const Db = require('./db');
 const EventEmitter = require('events').EventEmitter;
-const executeOperation = require('./utils').executeOperation;
+const executeOperation = require('./operations/execute_operation');
 const inherits = require('util').inherits;
-const MongoError = require('mongodb-core').MongoError;
+const MongoError = require('./core').MongoError;
 const deprecate = require('util').deprecate;
+const WriteConcern = require('./write_concern');
 
 // Operations
-const connectOp = require('./operations/mongo_client_ops').connectOp;
-const validOptions = require('./operations/mongo_client_ops').validOptions;
-const closeOperation = require('./operations/mongo_client_ops').closeOperation;
+const ConnectOperation = require('./operations/connect');
+const CloseOperation = require('./operations/close');
 
 /**
  * @fileOverview The **MongoClient** class is a class that allows for making Connections to MongoDB.
@@ -52,6 +52,23 @@ const closeOperation = require('./operations/mongo_client_ops').closeOperation;
  * @see https://docs.mongodb.com/manual/reference/read-concern/index.html#read-concern-levels
  */
 
+/**
+ * Configuration options for a automatic client encryption
+ *
+ * @typedef {Object} AutoEncryptionOptions
+ * @property {MongoClient} [keyVaultClient] A `MongoClient` used to fetch keys from a key vault
+ * @property {string} [keyVaultNamespace] The namespace where keys are stored in the key vault
+ * @property {object} [kmsProviders] Provider details for the desired Key Management Service to use for encryption
+ * @property {object} [kmsProviders.aws] Optional settings for the AWS KMS provider
+ * @property {string} [kmsProviders.aws.accessKeyId] The access key used for the AWS KMS provider
+ * @property {string} [kmsProviders.aws.secretAccessKey] The secret access key used for the AWS KMS provider
+ * @property {object} [kmsProviders.local] Optional settings for the local KMS provider
+ * @property {string} [kmsProviders.local.key] The master key used to encrypt/decrypt data keys
+ * @property {object} [schemaMap] A map of namespaces to a local JSON schema for encryption
+ * @property {boolean} [bypassAutoEncryption] Allows the user to bypass auto encryption, maintaining implicit decryption
+ * @param {string} [extraOptions.mongocryptURI] A local process the driver communicates with to determine how to encrypt values in a command. Defaults to "mongodb://%2Fvar%2Fmongocryptd.sock" if domain sockets are available or "mongodb://localhost:27020" otherwise.
+ */
+
 /**
  * Creates a new MongoClient instance
  * @class
@@ -117,6 +134,7 @@ const closeOperation = require('./operations/mongo_client_ops').closeOperation;
  * @param {number} [options.minSize] If present, the connection pool will be initialized with minSize connections, and will never dip below minSize connections
  * @param {boolean} [options.useNewUrlParser=false] Determines whether or not to use the new url parser. Enables the new, spec-compliant, url parser shipped in the core driver. This url parser fixes a number of problems with the original parser, and aims to outright replace that parser in the near future.
  * @param {boolean} [options.useUnifiedTopology] Enables the new unified topology layer
+ * @param {AutoEncryptionOptions} [options.autoEncryption] Optionally enable client side auto encryption
  * @param {MongoClient~connectCallback} [callback] The command result callback
  * @return {MongoClient} a MongoClient instance
  */
@@ -131,7 +149,8 @@ function MongoClient(url, options) {
     options: options || {},
     promiseLibrary: null,
     dbCache: {},
-    sessions: []
+    sessions: [],
+    writeConcern: WriteConcern.fromOptions(options)
   };
 
   // Get the promiseLibrary
@@ -146,6 +165,13 @@ function MongoClient(url, options) {
  */
 inherits(MongoClient, EventEmitter);
 
+Object.defineProperty(MongoClient.prototype, 'writeConcern', {
+  enumerable: true,
+  get: function() {
+    return this.s.writeConcern;
+  }
+});
+
 /**
  * The callback format for results
  * @callback MongoClient~connectCallback
@@ -165,16 +191,13 @@ inherits(MongoClient, EventEmitter);
  * @return {Promise<MongoClient>} returns Promise if no callback passed
  */
 MongoClient.prototype.connect = function(callback) {
-  // Validate options object
-  const err = validOptions(this.s.options);
-
   if (typeof callback === 'string') {
     throw new TypeError('`connect` only accepts a callback');
   }
 
-  return executeOperation(this, connectOp, [this, err, callback], {
-    skipSessions: true
-  });
+  const operation = new ConnectOperation(this);
+
+  return executeOperation(this, operation, callback);
 };
 
 MongoClient.prototype.logout = deprecate(function(options, callback) {
@@ -191,9 +214,8 @@ MongoClient.prototype.logout = deprecate(function(options, callback) {
  */
 MongoClient.prototype.close = function(force, callback) {
   if (typeof force === 'function') (callback = force), (force = false);
-  return executeOperation(this, closeOperation, [this, force, callback], {
-    skipSessions: true
-  });
+  const operation = new CloseOperation(this, force);
+  return executeOperation(this, operation, callback);
 };
 
 /**

package/lib/operations/add_user.js

@@ -0,0 +1,96 @@
+'use strict';
+
+const Aspect = require('./operation').Aspect;
+const CommandOperation = require('./command');
+const defineAspects = require('./operation').defineAspects;
+const crypto = require('crypto');
+const handleCallback = require('../utils').handleCallback;
+const toError = require('../utils').toError;
+
+class AddUserOperation extends CommandOperation {
+  constructor(db, username, password, options) {
+    super(db, options);
+
+    this.username = username;
+    this.password = password;
+  }
+
+  _buildCommand() {
+    const db = this.db;
+    const username = this.username;
+    const password = this.password;
+    const options = this.options;
+
+    // Get additional values
+    let roles = Array.isArray(options.roles) ? options.roles : [];
+
+    // If not roles defined print deprecated message
+    // TODO: handle deprecation properly
+    if (roles.length === 0) {
+      console.log('Creating a user without roles is deprecated in MongoDB >= 2.6');
+    }
+
+    // Check the db name and add roles if needed
+    if (
+      (db.databaseName.toLowerCase() === 'admin' || options.dbName === 'admin') &&
+      !Array.isArray(options.roles)
+    ) {
+      roles = ['root'];
+    } else if (!Array.isArray(options.roles)) {
+      roles = ['dbOwner'];
+    }
+
+    const digestPassword = db.s.topology.lastIsMaster().maxWireVersion >= 7;
+
+    let userPassword = password;
+
+    if (!digestPassword) {
+      // Use node md5 generator
+      const md5 = crypto.createHash('md5');
+      // Generate keys used for authentication
+      md5.update(username + ':mongo:' + password);
+      userPassword = md5.digest('hex');
+    }
+
+    // Build the command to execute
+    const command = {
+      createUser: username,
+      customData: options.customData || {},
+      roles: roles,
+      digestPassword
+    };
+
+    // No password
+    if (typeof password === 'string') {
+      command.pwd = userPassword;
+    }
+
+    return command;
+  }
+
+  execute(callback) {
+    const options = this.options;
+
+    // Error out if digestPassword set
+    if (options.digestPassword != null) {
+      return callback(
+        toError(
+          "The digestPassword option is not supported via add_user. Please use db.command('createUser', ...) instead for this option."
+        )
+      );
+    }
+
+    // Attempt to execute auth command
+    super.execute((err, r) => {
+      if (!err) {
+        return handleCallback(callback, err, r);
+      }
+
+      return handleCallback(callback, err, null);
+    });
+  }
+}
+
+defineAspects(AddUserOperation, Aspect.WRITE_OPERATION);
+
+module.exports = AddUserOperation;

package/lib/operations/aggregate.js

@@ -5,11 +5,13 @@ const applyWriteConcern = require('../utils').applyWriteConcern;
 const decorateWithCollation = require('../utils').decorateWithCollation;
 const decorateWithReadConcern = require('../utils').decorateWithReadConcern;
 const handleCallback = require('../utils').handleCallback;
-const MongoError = require('mongodb-core').MongoError;
+const MongoError = require('../core').MongoError;
 const resolveReadPreference = require('../utils').resolveReadPreference;
 const toError = require('../utils').toError;
+const ReadPreference = require('../core').ReadPreference;
 
 const DB_AGGREGATE_COLLECTION = 1;
+const MIN_WIRE_VERSION_$OUT_READ_CONCERN_SUPPORT = 8;
 
 /**
  * Perform an aggregate operation. See Collection.prototype.aggregate or Db.prototype.aggregate for more information.
@@ -25,13 +27,16 @@ function aggregate(db, coll, pipeline, options, callback) {
   const isDbAggregate = typeof coll === 'string';
   const target = isDbAggregate ? db : coll;
   const topology = target.s.topology;
-  let hasOutStage = false;
+  let hasWriteStage = false;
 
   if (typeof options.out === 'string') {
     pipeline = pipeline.concat({ $out: options.out });
-    hasOutStage = true;
-  } else if (pipeline.length > 0 && pipeline[pipeline.length - 1]['$out']) {
-    hasOutStage = true;
+    hasWriteStage = true;
+  } else if (pipeline.length > 0) {
+    const finalStage = pipeline[pipeline.length - 1];
+    if (finalStage.$out || finalStage.$merge) {
+      hasWriteStage = true;
+    }
   }
 
   let command;
@@ -40,23 +45,24 @@ function aggregate(db, coll, pipeline, options, callback) {
 
   if (isDbAggregate) {
     command = { aggregate: DB_AGGREGATE_COLLECTION, pipeline: pipeline };
-    namespace = `${db.s.databaseName}.${DB_AGGREGATE_COLLECTION}`;
+    namespace = db.s.namespace.withCollection(DB_AGGREGATE_COLLECTION);
 
     optionSources = { db };
   } else {
-    command = { aggregate: coll.s.name, pipeline: pipeline };
+    command = { aggregate: coll.collectionName, pipeline: pipeline };
     namespace = coll.s.namespace;
 
     optionSources = { db: coll.s.db, collection: coll };
   }
 
   const takesWriteConcern = topology.capabilities().commandsTakeWriteConcern;
+  const ismaster = topology.lastIsMaster() || {};
 
-  if (!hasOutStage) {
+  if (!hasWriteStage || ismaster.maxWireVersion >= MIN_WIRE_VERSION_$OUT_READ_CONCERN_SUPPORT) {
     decorateWithReadConcern(command, target, options);
   }
 
-  if (pipeline.length > 0 && pipeline[pipeline.length - 1]['$out'] && takesWriteConcern) {
+  if (hasWriteStage && takesWriteConcern) {
     applyWriteConcern(command, optionSources, options);
   }
 
@@ -79,7 +85,9 @@ function aggregate(db, coll, pipeline, options, callback) {
   options = Object.assign({}, options);
 
   // Ensure we have the right read preference inheritance
-  options.readPreference = resolveReadPreference(options, optionSources);
+  options.readPreference = hasWriteStage
+    ? ReadPreference.primary
+    : resolveReadPreference(isDbAggregate ? db : coll, options);
 
   if (options.explain) {
     if (command.readConcern || command.writeConcern) {
@@ -96,7 +104,10 @@ function aggregate(db, coll, pipeline, options, callback) {
   }
 
   options.cursor = options.cursor || {};
-  if (options.batchSize && !hasOutStage) options.cursor.batchSize = options.batchSize;
+  if (options.batchSize && !hasWriteStage) {
+    options.cursor.batchSize = options.batchSize;
+  }
+
   command.cursor = options.cursor;
 
   // promiseLibrary
@@ -110,10 +121,10 @@ function aggregate(db, coll, pipeline, options, callback) {
       throw new MongoError('cannot connect to server');
     }
 
-    return topology.cursor(namespace, command, options);
+    return topology.cursor(namespace.toString(), command, options);
   }
 
-  return handleCallback(callback, null, topology.cursor(namespace, command, options));
+  return handleCallback(callback, null, topology.cursor(namespace.toString(), command, options));
 }
 
 module.exports = {

package/lib/operations/aggregate_operation.js

@@ -0,0 +1,127 @@
+'use strict';
+
+const OperationBase = require('./operation').OperationBase;
+const AggregationCursor = require('../aggregation_cursor');
+const applyWriteConcern = require('../utils').applyWriteConcern;
+const decorateWithCollation = require('../utils').decorateWithCollation;
+const decorateWithReadConcern = require('../utils').decorateWithReadConcern;
+const handleCallback = require('../utils').handleCallback;
+const MongoError = require('../core').MongoError;
+const resolveReadPreference = require('../utils').resolveReadPreference;
+const toError = require('../utils').toError;
+
+const DB_AGGREGATE_COLLECTION = 1;
+
+class AggregateOperation extends OperationBase {
+  constructor(db, collection, pipeline, options) {
+    super(options);
+
+    this.db = db;
+    this.collection = collection;
+    this.pipeline = pipeline;
+  }
+
+  execute(callback) {
+    const db = this.db;
+    const coll = this.collection;
+    let pipeline = this.pipeline;
+    let options = this.options;
+
+    const isDbAggregate = typeof coll === 'string';
+    const target = isDbAggregate ? db : coll;
+    const topology = target.s.topology;
+    let hasOutStage = false;
+
+    if (typeof options.out === 'string') {
+      pipeline = pipeline.concat({ $out: options.out });
+      hasOutStage = true;
+    } else if (pipeline.length > 0 && pipeline[pipeline.length - 1]['$out']) {
+      hasOutStage = true;
+    }
+
+    let command;
+    let namespace;
+    let optionSources;
+
+    if (isDbAggregate) {
+      command = { aggregate: DB_AGGREGATE_COLLECTION, pipeline: pipeline };
+      namespace = db.s.namespace.withCollection(DB_AGGREGATE_COLLECTION);
+
+      optionSources = { db };
+    } else {
+      command = { aggregate: coll.collectionName, pipeline: pipeline };
+      namespace = coll.s.namespace;
+
+      optionSources = { db: coll.s.db, collection: coll };
+    }
+
+    const takesWriteConcern = topology.capabilities().commandsTakeWriteConcern;
+
+    if (!hasOutStage) {
+      decorateWithReadConcern(command, target, options);
+    }
+
+    if (pipeline.length > 0 && pipeline[pipeline.length - 1]['$out'] && takesWriteConcern) {
+      applyWriteConcern(command, optionSources, options);
+    }
+
+    try {
+      decorateWithCollation(command, target, options);
+    } catch (err) {
+      if (typeof callback === 'function') return callback(err, null);
+      throw err;
+    }
+
+    if (options.bypassDocumentValidation === true) {
+      command.bypassDocumentValidation = options.bypassDocumentValidation;
+    }
+
+    if (typeof options.allowDiskUse === 'boolean') command.allowDiskUse = options.allowDiskUse;
+    if (typeof options.maxTimeMS === 'number') command.maxTimeMS = options.maxTimeMS;
+
+    if (options.hint) command.hint = options.hint;
+
+    options = Object.assign({}, options);
+
+    // Ensure we have the right read preference inheritance
+    options.readPreference = resolveReadPreference(options, optionSources);
+
+    if (options.explain) {
+      if (command.readConcern || command.writeConcern) {
+        throw toError(
+          '"explain" cannot be used on an aggregate call with readConcern/writeConcern'
+        );
+      }
+      command.explain = options.explain;
+    }
+
+    if (typeof options.comment === 'string') command.comment = options.comment;
+
+    // Validate that cursor options is valid
+    if (options.cursor != null && typeof options.cursor !== 'object') {
+      throw toError('cursor options must be an object');
+    }
+
+    options.cursor = options.cursor || {};
+    if (options.batchSize && !hasOutStage) options.cursor.batchSize = options.batchSize;
+    command.cursor = options.cursor;
+
+    // promiseLibrary
+    options.promiseLibrary = target.s.promiseLibrary;
+
+    // Set the AggregationCursor constructor
+    options.cursorFactory = AggregationCursor;
+
+    if (typeof callback !== 'function') {
+      if (!topology.capabilities()) {
+        throw new MongoError('cannot connect to server');
+      }
+
+      return topology.cursor(namespace.toString(), command, options);
+    }
+
+    return handleCallback(callback, null, topology.cursor(namespace.toString(), command, options));
+  }
+}
+
+module.exports = AggregateOperation;