@depup/mongodb 7.1.0-depup.0

package/package.json

@@ -0,0 +1,197 @@
+{
+  "name": "@depup/mongodb",
+  "version": "7.1.0-depup.0",
+  "description": "[DepUp] The official MongoDB driver for Node.js",
+  "main": "lib/index.js",
+  "files": [
+    "lib",
+    "src",
+    "etc/prepare.js",
+    "mongodb.d.ts",
+    "tsconfig.json"
+  ],
+  "types": "mongodb.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:mongodb/node-mongodb-native.git"
+  },
+  "keywords": [
+    "depup",
+    "dependency-bumped",
+    "updated-deps",
+    "mongodb",
+    "driver",
+    "official"
+  ],
+  "author": {
+    "name": "The MongoDB NodeJS Team",
+    "email": "dbx-node@mongodb.com"
+  },
+  "dependencies": {
+    "@mongodb-js/saslprep": "^1.4.6",
+    "bson": "^7.2.0",
+    "mongodb-connection-string-url": "^7.0.1"
+  },
+  "peerDependencies": {
+    "@aws-sdk/credential-providers": "^3.806.0",
+    "@mongodb-js/zstd": "^7.0.0",
+    "gcp-metadata": "^7.0.1",
+    "kerberos": "^7.0.0",
+    "mongodb-client-encryption": ">=7.0.0 <7.1.0",
+    "snappy": "^7.3.2",
+    "socks": "^2.8.6"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/credential-providers": {
+      "optional": true
+    },
+    "@mongodb-js/zstd": {
+      "optional": true
+    },
+    "kerberos": {
+      "optional": true
+    },
+    "snappy": {
+      "optional": true
+    },
+    "mongodb-client-encryption": {
+      "optional": true
+    },
+    "gcp-metadata": {
+      "optional": true
+    },
+    "socks": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@aws-sdk/credential-providers": "^3.876.0",
+    "@iarna/toml": "^2.2.5",
+    "@istanbuljs/nyc-config-typescript": "^1.0.2",
+    "@microsoft/api-extractor": "^7.54.0",
+    "@microsoft/tsdoc-config": "^0.17.1",
+    "@mongodb-js/zstd": "^7.0.0",
+    "@types/chai": "^4.3.17",
+    "@types/chai-subset": "^1.3.5",
+    "@types/express": "^5.0.5",
+    "@types/kerberos": "^1.1.5",
+    "@types/mocha": "^10.0.9",
+    "@types/node": "^22.15.3",
+    "@types/saslprep": "^1.0.3",
+    "@types/semver": "^7.7.0",
+    "@types/sinon": "^17.0.4",
+    "@types/sinon-chai": "^4.0.0",
+    "@types/whatwg-url": "^13.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.46.3",
+    "@typescript-eslint/parser": "^8.31.1",
+    "aws4": "^1.13.2",
+    "chai": "^4.4.1",
+    "chai-subset": "^1.6.0",
+    "chalk": "^4.1.2",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-mocha": "^10.4.1",
+    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-tsdoc": "^0.4.0",
+    "eslint-plugin-unused-imports": "^4.2.0",
+    "express": "^5.1.0",
+    "gcp-metadata": "^7.0.1",
+    "js-yaml": "^4.1.0",
+    "mocha": "^11.7.5",
+    "mocha-sinon": "^2.1.2",
+    "mongodb-client-encryption": "^7.0.0",
+    "nyc": "^17.1.0",
+    "prettier": "^3.6.2",
+    "semver": "^7.7.2",
+    "sinon": "^18.0.1",
+    "sinon-chai": "^3.7.0",
+    "snappy": "^7.3.2",
+    "socks": "^2.8.7",
+    "source-map-support": "^0.5.21",
+    "ts-node": "^10.9.2",
+    "tsd": "^0.33.0",
+    "typescript": "5.8.3",
+    "typescript-cached-transpile": "^0.0.6",
+    "v8-heapsnapshot": "^1.3.1",
+    "yargs": "^18.0.0"
+  },
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "bugs": {
+    "url": "https://jira.mongodb.org/projects/NODE/issues/"
+  },
+  "homepage": "https://github.com/mongodb/node-mongodb-native",
+  "scripts": {
+    "build:evergreen": "node .evergreen/generate_evergreen_tasks.js",
+    "build:ts": "node ./node_modules/typescript/bin/tsc",
+    "build:dts": "npm run build:ts && api-extractor run && node etc/clean_definition_files.cjs && ESLINT_USE_FLAT_CONFIG=false eslint --no-ignore --fix mongodb.d.ts",
+    "build:docs": "./etc/docs/build.ts",
+    "build:typedoc": "typedoc",
+    "build:nightly": "node ./.github/scripts/nightly.mjs",
+    "check:bench": "npm --prefix test/benchmarks/driver_bench start",
+    "check:coverage": "nyc npm run test:all",
+    "check:integration-coverage": "nyc npm run check:test",
+    "check:lambda": "nyc mocha --config test/mocha_lambda.js test/integration/node-specific/examples/handler.test.js",
+    "check:lambda:aws": "nyc mocha --config test/mocha_lambda.js test/integration/node-specific/examples/aws_handler.test.js",
+    "check:lint": "npm run build:dts && npm run check:dts && npm run check:eslint && npm run check:tsd",
+    "check:eslint": "npm run build:dts && ESLINT_USE_FLAT_CONFIG=false eslint -v && ESLINT_USE_FLAT_CONFIG=false eslint --max-warnings=0 --ext '.js,.ts' src test",
+    "check:tsd": "tsd --version && tsd",
+    "check:dependencies": "mocha test/action/dependency.test.ts",
+    "check:dts": "node ./node_modules/typescript/bin/tsc --target es2023 --module commonjs --noEmit mongodb.d.ts && tsd",
+    "check:search-indexes": "nyc mocha --config test/mocha_mongodb.js test/manual/search-index-management.prose.test.ts",
+    "check:test": "mocha --config test/mocha_mongodb.js test/integration",
+    "check:unit": "nyc mocha test/unit",
+    "check:ts": "node ./node_modules/typescript/bin/tsc -v && node ./node_modules/typescript/bin/tsc --noEmit",
+    "check:atlas": "nyc mocha --config test/manual/mocharc.js test/manual/atlas_connectivity.test.ts",
+    "check:drivers-atlas-testing": "nyc mocha --config test/mocha_mongodb.js test/atlas/drivers_atlas_testing.test.ts",
+    "check:aws": "nyc mocha --config test/mocha_mongodb.js test/integration/auth/mongodb_aws.test.ts test/integration/auth/mongodb_aws.prose.test.ts",
+    "check:oidc-auth": "nyc mocha --config test/mocha_mongodb.js test/integration/auth/auth.spec.test.ts",
+    "check:oidc-test": "nyc mocha --config test/mocha_mongodb.js test/integration/auth/mongodb_oidc.prose.test.ts",
+    "check:kerberos": "nyc mocha --config test/manual/mocharc.js test/manual/kerberos.test.ts",
+    "check:tls": "nyc mocha --config test/manual/mocharc.js test/manual/tls_support.test.ts",
+    "check:ldap": "nyc mocha --config test/manual/mocharc.js test/manual/ldap.test.ts",
+    "check:socks5": "nyc mocha --config test/manual/mocharc.js test/manual/socks5.test.ts",
+    "check:csfle": "nyc mocha --config test/mocha_mongodb.js test/integration/client-side-encryption",
+    "check:snappy": "nyc mocha test/unit/assorted/snappy.test.js",
+    "check:x509": "nyc mocha test/manual/x509_auth.test.ts",
+    "fix:eslint": "npm run check:eslint -- --fix",
+    "prepare": "node etc/prepare.js",
+    "preview:docs": "ts-node etc/docs/preview.ts",
+    "test": "npm run check:lint && npm run test:all",
+    "test:all": "npm run check:unit && npm run check:test",
+    "update:docs": "npm run build:docs -- --yes"
+  },
+  "tsd": {
+    "directory": "test/types",
+    "compilerOptions": {
+      "strict": true,
+      "target": "esnext",
+      "module": "commonjs",
+      "moduleResolution": "node"
+    }
+  },
+  "depup": {
+    "changes": {
+      "@mongodb-js/saslprep": {
+        "from": "^1.3.0",
+        "to": "^1.4.6"
+      },
+      "bson": {
+        "from": "^7.1.1",
+        "to": "^7.2.0"
+      },
+      "mongodb-connection-string-url": {
+        "from": "^7.0.0",
+        "to": "^7.0.1"
+      }
+    },
+    "depsUpdated": 3,
+    "originalPackage": "mongodb",
+    "originalVersion": "7.1.0",
+    "processedAt": "2026-03-09T04:58:47.350Z",
+    "smokeTest": "passed"
+  }
+}

package/src/admin.ts

@@ -0,0 +1,173 @@
+import { type Document, resolveBSONOptions } from './bson';
+import type { Db } from './db';
+import type { CommandOperationOptions } from './operations/command';
+import { executeOperation } from './operations/execute_operation';
+import {
+  ListDatabasesOperation,
+  type ListDatabasesOptions,
+  type ListDatabasesResult
+} from './operations/list_databases';
+import { RemoveUserOperation, type RemoveUserOptions } from './operations/remove_user';
+import { RunCommandOperation, type RunCommandOptions } from './operations/run_command';
+import {
+  ValidateCollectionOperation,
+  type ValidateCollectionOptions
+} from './operations/validate_collection';
+import { MongoDBNamespace } from './utils';
+
+/** @internal */
+export interface AdminPrivate {
+  db: Db;
+}
+
+/**
+ * The **Admin** class is an internal class that allows convenient access to
+ * the admin functionality and commands for MongoDB.
+ *
+ * **ADMIN Cannot directly be instantiated**
+ * @public
+ *
+ * @example
+ * ```ts
+ * import { MongoClient } from 'mongodb';
+ *
+ * const client = new MongoClient('mongodb://localhost:27017');
+ * const admin = client.db().admin();
+ * const dbInfo = await admin.listDatabases();
+ * for (const db of dbInfo.databases) {
+ *   console.log(db.name);
+ * }
+ * ```
+ */
+export class Admin {
+  /** @internal */
+  s: AdminPrivate;
+
+  /**
+   * Create a new Admin instance
+   * @internal
+   */
+  constructor(db: Db) {
+    this.s = { db };
+  }
+
+  /**
+   * Execute a command
+   *
+   * The driver will ensure the following fields are attached to the command sent to the server:
+   * - `lsid` - sourced from an implicit session or options.session
+   * - `$readPreference` - defaults to primary or can be configured by options.readPreference
+   * - `$db` - sourced from the name of this database
+   *
+   * If the client has a serverApi setting:
+   * - `apiVersion`
+   * - `apiStrict`
+   * - `apiDeprecationErrors`
+   *
+   * When in a transaction:
+   * - `readConcern` - sourced from readConcern set on the TransactionOptions
+   * - `writeConcern` - sourced from writeConcern set on the TransactionOptions
+   *
+   * Attaching any of the above fields to the command will have no effect as the driver will overwrite the value.
+   *
+   * @param command - The command to execute
+   * @param options - Optional settings for the command
+   */
+  async command(command: Document, options?: RunCommandOptions): Promise<Document> {
+    return await executeOperation(
+      this.s.db.client,
+      new RunCommandOperation(new MongoDBNamespace('admin'), command, {
+        ...resolveBSONOptions(options),
+        session: options?.session,
+        readPreference: options?.readPreference,
+        timeoutMS: options?.timeoutMS ?? this.s.db.timeoutMS
+      })
+    );
+  }
+
+  /**
+   * Retrieve the server build information
+   *
+   * @param options - Optional settings for the command
+   */
+  async buildInfo(options?: CommandOperationOptions): Promise<Document> {
+    return await this.command({ buildinfo: 1 }, options);
+  }
+
+  /**
+   * Retrieve the server build information
+   *
+   * @param options - Optional settings for the command
+   */
+  async serverInfo(options?: CommandOperationOptions): Promise<Document> {
+    return await this.command({ buildinfo: 1 }, options);
+  }
+
+  /**
+   * Retrieve this db's server status.
+   *
+   * @param options - Optional settings for the command
+   */
+  async serverStatus(options?: CommandOperationOptions): Promise<Document> {
+    return await this.command({ serverStatus: 1 }, options);
+  }
+
+  /**
+   * Ping the MongoDB server and retrieve results
+   *
+   * @param options - Optional settings for the command
+   */
+  async ping(options?: CommandOperationOptions): Promise<Document> {
+    return await this.command({ ping: 1 }, options);
+  }
+
+  /**
+   * Remove a user from a database
+   *
+   * @param username - The username to remove
+   * @param options - Optional settings for the command
+   */
+  async removeUser(username: string, options?: RemoveUserOptions): Promise<boolean> {
+    return await executeOperation(
+      this.s.db.client,
+      new RemoveUserOperation(this.s.db, username, { dbName: 'admin', ...options })
+    );
+  }
+
+  /**
+   * Validate an existing collection
+   *
+   * @param collectionName - The name of the collection to validate.
+   * @param options - Optional settings for the command
+   */
+  async validateCollection(
+    collectionName: string,
+    options: ValidateCollectionOptions = {}
+  ): Promise<Document> {
+    return await executeOperation(
+      this.s.db.client,
+      new ValidateCollectionOperation(this, collectionName, options)
+    );
+  }
+
+  /**
+   * List the available databases
+   *
+   * @param options - Optional settings for the command
+   */
+  async listDatabases(options?: ListDatabasesOptions): Promise<ListDatabasesResult> {
+    return await executeOperation(
+      this.s.db.client,
+      new ListDatabasesOperation(this.s.db, { timeoutMS: this.s.db.timeoutMS, ...options })
+    );
+  }
+
+  /**
+   * Get ReplicaSet status
+   *
+   * @param options - Optional settings for the command
+   */
+  async replSetGetStatus(options?: CommandOperationOptions): Promise<Document> {
+    return await this.command({ replSetGetStatus: 1 }, options);
+  }
+}

package/src/bson.ts

@@ -0,0 +1,149 @@
+/* eslint-disable no-restricted-imports */
+import { BSON, type DeserializeOptions, type SerializeOptions } from 'bson';
+
+export {
+  Binary,
+  BSON,
+  BSONError,
+  BSONRegExp,
+  BSONSymbol,
+  BSONType,
+  calculateObjectSize,
+  Code,
+  DBRef,
+  Decimal128,
+  deserialize,
+  type DeserializeOptions,
+  Document,
+  Double,
+  EJSON,
+  EJSONOptions,
+  Int32,
+  Long,
+  MaxKey,
+  MinKey,
+  NumberUtils,
+  ObjectId,
+  type ObjectIdLike,
+  serialize,
+  Timestamp,
+  UUID
+} from 'bson';
+
+/** @internal */
+export type BSONElement = BSON.OnDemand['BSONElement'];
+
+export function parseToElementsToArray(bytes: Uint8Array, offset?: number): BSONElement[] {
+  const res = BSON.onDemand.parseToElements(bytes, offset);
+  return Array.isArray(res) ? res : [...res];
+}
+
+export const getInt32LE = BSON.onDemand.NumberUtils.getInt32LE;
+export const getFloat64LE = BSON.onDemand.NumberUtils.getFloat64LE;
+export const getBigInt64LE = BSON.onDemand.NumberUtils.getBigInt64LE;
+export const toUTF8 = BSON.onDemand.ByteUtils.toUTF8;
+
+/**
+ * BSON Serialization options.
+ * @public
+ */
+export interface BSONSerializeOptions
+  extends Omit<SerializeOptions, 'index'>,
+    Omit<
+      DeserializeOptions,
+      | 'evalFunctions'
+      | 'cacheFunctions'
+      | 'cacheFunctionsCrc32'
+      | 'allowObjectSmallerThanBufferSize'
+      | 'index'
+      | 'validation'
+    > {
+  /**
+   * Enabling the raw option will return a [Node.js Buffer](https://nodejs.org/api/buffer.html)
+   * which is allocated using [allocUnsafe API](https://nodejs.org/api/buffer.html#static-method-bufferallocunsafesize).
+   * See this section from the [Node.js Docs here](https://nodejs.org/api/buffer.html#what-makes-bufferallocunsafe-and-bufferallocunsafeslow-unsafe)
+   * for more detail about what "unsafe" refers to in this context.
+   * If you need to maintain your own editable clone of the bytes returned for an extended life time of the process, it is recommended you allocate
+   * your own buffer and clone the contents:
+   *
+   * @example
+   * ```ts
+   * const raw = await collection.findOne({}, { raw: true });
+   * const myBuffer = Buffer.alloc(raw.byteLength);
+   * myBuffer.set(raw, 0);
+   * // Only save and use `myBuffer` beyond this point
+   * ```
+   *
+   * @remarks
+   * Please note there is a known limitation where this option cannot be used at the MongoClient level (see [NODE-3946](https://jira.mongodb.org/browse/NODE-3946)).
+   * It does correctly work at `Db`, `Collection`, and per operation the same as other BSON options work.
+   */
+  raw?: boolean;
+
+  /** Enable utf8 validation when deserializing BSON documents.  Defaults to true. */
+  enableUtf8Validation?: boolean;
+}
+
+export function pluckBSONSerializeOptions(options: BSONSerializeOptions): BSONSerializeOptions {
+  const {
+    fieldsAsRaw,
+    useBigInt64,
+    promoteValues,
+    promoteBuffers,
+    promoteLongs,
+    serializeFunctions,
+    ignoreUndefined,
+    bsonRegExp,
+    raw,
+    enableUtf8Validation
+  } = options;
+  return {
+    fieldsAsRaw,
+    useBigInt64,
+    promoteValues,
+    promoteBuffers,
+    promoteLongs,
+    serializeFunctions,
+    ignoreUndefined,
+    bsonRegExp,
+    raw,
+    enableUtf8Validation
+  };
+}
+
+/**
+ * Merge the given BSONSerializeOptions, preferring options over the parent's options, and
+ * substituting defaults for values not set.
+ *
+ * @internal
+ */
+export function resolveBSONOptions(
+  options?: BSONSerializeOptions,
+  parent?: { bsonOptions?: BSONSerializeOptions }
+): BSONSerializeOptions {
+  const parentOptions = parent?.bsonOptions;
+  return {
+    raw: options?.raw ?? parentOptions?.raw ?? false,
+    useBigInt64: options?.useBigInt64 ?? parentOptions?.useBigInt64 ?? false,
+    promoteLongs: options?.promoteLongs ?? parentOptions?.promoteLongs ?? true,
+    promoteValues: options?.promoteValues ?? parentOptions?.promoteValues ?? true,
+    promoteBuffers: options?.promoteBuffers ?? parentOptions?.promoteBuffers ?? false,
+    ignoreUndefined: options?.ignoreUndefined ?? parentOptions?.ignoreUndefined ?? false,
+    bsonRegExp: options?.bsonRegExp ?? parentOptions?.bsonRegExp ?? false,
+    serializeFunctions: options?.serializeFunctions ?? parentOptions?.serializeFunctions ?? false,
+    fieldsAsRaw: options?.fieldsAsRaw ?? parentOptions?.fieldsAsRaw ?? {},
+    enableUtf8Validation:
+      options?.enableUtf8Validation ?? parentOptions?.enableUtf8Validation ?? true
+  };
+}
+
+/** @internal */
+export function parseUtf8ValidationOption(options?: { enableUtf8Validation?: boolean }): {
+  utf8: { writeErrors: false } | false;
+} {
+  const enableUtf8Validation = options?.enableUtf8Validation;
+  if (enableUtf8Validation === false) {
+    return { utf8: false };
+  }
+  return { utf8: { writeErrors: false } };
+}