feat(NODE-4541): implement legacy callback wrapper library

.gitignore

@@ -1,3 +1,4 @@
+node_modules/
 !mongodb-legacy.d.ts
 .vscode/
 *.tgz

.mocharc.json

@@ -2,11 +2,12 @@
   "$schema": "https://raw.githubusercontent.com/SchemaStore/schemastore/master/src/schemas/json/mocharc.json",
   "extension": ["js", "ts"],
   "recursive": true,
-  "failZero": false,
+  "failZero": true,
   "sort": true,
   "color": true,
   "require": [
     "source-map-support/register",
-    "ts-node/register"
+    "ts-node/register",
+    "test/hooks/addons.js"
   ]
 }

src/index.js

@@ -1,3 +1,79 @@
 'use strict';
 
-throw new Error('Work In Progress - Not intended for use at this time');
+const mongodb = require('mongodb');
+
+const { makeLegacyMongoClient } = require('./legacy_wrappers/mongo_client');
+const { makeLegacyDb } = require('./legacy_wrappers/db');
+const { makeLegacyCollection } = require('./legacy_wrappers/collection');
+const { makeLegacyAdmin } = require('./legacy_wrappers/admin');
+const {
+  makeLegacyAggregationCursor,
+  makeLegacyFindCursor,
+  makeLegacyListCollectionsCursor,
+  makeLegacyListIndexesCursor
+} = require('./legacy_wrappers/cursors');
+const {
+  makeLegacyGridFSBucket,
+  makeLegacyGridFSBucketWriteStream
+} = require('./legacy_wrappers/gridfs');
+const { makeLegacyChangeStream } = require('./legacy_wrappers/change_stream');
+const { makeLegacyClientSession } = require('./legacy_wrappers/session');
+const {
+  makeLegacyUnorderedBulkOperation,
+  makeLegacyOrderedBulkOperation
+} = require('./legacy_wrappers/bulk');
+
+/** @type {import('..')} */
+module.exports = Object.create(null);
+Object.defineProperty(module.exports, '__esModule', { value: true });
+
+const classesWithAsyncAPIs = new Map([
+  ['Admin', makeLegacyAdmin],
+  ['FindCursor', makeLegacyFindCursor],
+  ['ListCollectionsCursor', makeLegacyListCollectionsCursor],
+  ['ListIndexesCursor', makeLegacyListIndexesCursor],
+  ['AggregationCursor', makeLegacyAggregationCursor],
+  ['ChangeStream', makeLegacyChangeStream],
+  ['Collection', makeLegacyCollection],
+  ['Db', makeLegacyDb],
+  ['GridFSBucket', makeLegacyGridFSBucket],
+  ['ClientSession', makeLegacyClientSession],
+  ['MongoClient', makeLegacyMongoClient],
+
+  // Need to be exported top-level still
+  ['ClientSession', makeLegacyClientSession],
+  ['GridFSBucketWriteStream', makeLegacyGridFSBucketWriteStream],
+  ['OrderedBulkOperation', makeLegacyOrderedBulkOperation],
+  ['UnorderedBulkOperation', makeLegacyUnorderedBulkOperation]
+]);
+
+const TODO_SPECIAL_IMPORTS = new Map([
+  ['ClientSession', '/lib/sessions'],
+  ['GridFSBucketWriteStream', '/lib/gridfs/upload'],
+  ['OrderedBulkOperation', '/lib/bulk/ordered'],
+  ['UnorderedBulkOperation', '/lib/bulk/unordered']
+]);
+
+for (const [missingTopLevelClassName, location] of TODO_SPECIAL_IMPORTS) {
+  mongodb[missingTopLevelClassName] = require(`mongodb${location}`)[missingTopLevelClassName];
+}
+
+for (const [mongodbExportName, mongodbExportValue] of Object.entries(mongodb)) {
+  let makeLegacyClass = classesWithAsyncAPIs.get(mongodbExportName);
+  if (makeLegacyClass != null) {
+    const patchedClass = makeLegacyClass(mongodbExportValue);
+    Object.defineProperty(module.exports, mongodbExportName, {
+      enumerable: true,
+      get: function () {
+        return patchedClass;
+      }
+    });
+  } else {
+    Object.defineProperty(module.exports, mongodbExportName, {
+      enumerable: true,
+      get: function () {
+        return mongodbExportValue;
+      }
+    });
+  }
+}

src/legacy_wrappers/admin.js

@@ -0,0 +1,136 @@
+'use strict';
+
+const { toLegacy, maybeCallback } = require('../utils');
+
+module.exports = Object.create(null);
+Object.defineProperty(module.exports, '__esModule', { value: true });
+
+module.exports.makeLegacyAdmin = function (baseClass) {
+  class LegacyAdmin extends baseClass {
+    addUser(username, password, options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : typeof password === 'function'
+          ? password
+          : undefined;
+      options =
+        options != null && typeof options === 'object'
+          ? options
+          : password != null && typeof password === 'object'
+          ? password
+          : undefined;
+      return maybeCallback(super.addUser(username, password, options), callback);
+    }
+
+    buildInfo(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.buildInfo(options), callback);
+    }
+
+    command(command, options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.command(command, options), callback);
+    }
+
+    listDatabases(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.listDatabases(options), callback);
+    }
+
+    ping(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.ping(options), callback);
+    }
+
+    removeUser(username, options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.removeUser(username, options), callback);
+    }
+
+    replSetGetStatus(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.replSetGetStatus(options), callback);
+    }
+
+    serverInfo(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.serverInfo(options), callback);
+    }
+
+    serverStatus(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.serverStatus(options), callback);
+    }
+
+    validateCollection(name, options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.validateCollection(name, options), callback);
+    }
+  }
+
+  Object.defineProperty(baseClass.prototype, toLegacy, {
+    enumerable: false,
+    value: function () {
+      return Object.setPrototypeOf(this, LegacyAdmin.prototype);
+    }
+  });
+
+  return LegacyAdmin;
+};

src/legacy_wrappers/bulk.js

@@ -0,0 +1,36 @@
+'use strict';
+
+const { maybeCallback } = require('../utils');
+
+module.exports = Object.create(null);
+Object.defineProperty(module.exports, '__esModule', { value: true });
+
+module.exports.makeLegacyOrderedBulkOperation = function (baseClass) {
+  return class LegacyOrderedBulkOperation extends baseClass {
+    execute(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.execute(options), callback);
+    }
+  };
+};
+
+module.exports.makeLegacyUnorderedBulkOperation = function (baseClass) {
+  return class LegacyUnorderedBulkOperation extends baseClass {
+    execute(options, callback) {
+      callback =
+        typeof callback === 'function'
+          ? callback
+          : typeof options === 'function'
+          ? options
+          : undefined;
+      options = typeof options !== 'function' ? options : undefined;
+      return maybeCallback(super.execute(options), callback);
+    }
+  };
+};

src/legacy_wrappers/change_stream.js

@@ -0,0 +1,32 @@
+'use strict';
+
+const { toLegacy, maybeCallback } = require('../utils');
+
+module.exports = Object.create(null);
+Object.defineProperty(module.exports, '__esModule', { value: true });
+
+module.exports.makeLegacyChangeStream = function (baseClass) {
+  class LegacyChangeStream extends baseClass {
+    close(callback) {
+      return maybeCallback(super.close(), callback);
+    }
+    hasNext(callback) {
+      return maybeCallback(super.hasNext(), callback);
+    }
+    next(callback) {
+      return maybeCallback(super.next(), callback);
+    }
+    tryNext(callback) {
+      return maybeCallback(super.tryNext(), callback);
+    }
+  }
+
+  Object.defineProperty(baseClass.prototype, toLegacy, {
+    enumerable: false,
+    value: function () {
+      return Object.setPrototypeOf(this, LegacyChangeStream.prototype);
+    }
+  });
+
+  return LegacyChangeStream;
+};