mongodb 6.8.2 → 6.9.0

package/mongodb.d.ts

@@ -1,15 +1,37 @@
-/// <reference types="node" />
-
-import type { DeserializeOptions,ObjectIdLike , SerializeOptions  } from 'bson';
-import { Binary , BSON , BSONRegExp , BSONSymbol , BSONType , Code , DBRef , Decimal128 , deserialize  , Document , Double , Int32 , Long , MaxKey , MinKey , ObjectId , serialize , Timestamp , UUID } from 'bson';
+import type { ObjectIdLike } from 'bson';
+import type { DeserializeOptions } from 'bson';
+import type { SerializeOptions } from 'bson';
+import { Binary } from 'bson';
+import { BSON } from 'bson';
+import { BSONRegExp } from 'bson';
+import { BSONSymbol } from 'bson';
+import { BSONType } from 'bson';
+import { Code } from 'bson';
+import { DBRef } from 'bson';
+import { Decimal128 } from 'bson';
+import { deserialize } from 'bson';
+import { Document } from 'bson';
+import { Double } from 'bson';
+import { Int32 } from 'bson';
+import { Long } from 'bson';
+import { MaxKey } from 'bson';
+import { MinKey } from 'bson';
+import { ObjectId } from 'bson';
+import { serialize } from 'bson';
+import { Timestamp } from 'bson';
+import { UUID } from 'bson';
 import type { SrvRecord } from 'dns';
 import { EventEmitter } from 'events';
-import type { Socket , TcpNetConnectOpts } from 'net';
-import { Readable , Writable } from 'stream';
-import type { ConnectionOptions as ConnectionOptions_2 , TLSSocket , TLSSocketOptions } from 'tls';
+import type { Socket } from 'net';
+import type { TcpNetConnectOpts } from 'net';
+import { Readable } from 'stream';
+import { Writable } from 'stream';
+import type { ConnectionOptions as ConnectionOptions_2 } from 'tls';
+import type { TLSSocket } from 'tls';
+import type { TLSSocketOptions } from 'tls';
 
 /** @public */
-export declare abstract class AbstractCursor<TSchema = any, CursorEvents extends AbstractCursorEvents = AbstractCursorEvents> extends TypedEventEmitter<CursorEvents> {
+export declare abstract class AbstractCursor<TSchema = any, CursorEvents extends AbstractCursorEvents = AbstractCursorEvents> extends TypedEventEmitter<CursorEvents> implements AsyncDisposable_2 {
     /* Excluded from this release type: cursorId */
     /* Excluded from this release type: cursorSession */
     /* Excluded from this release type: selectedServer */
@@ -51,10 +73,12 @@ export declare abstract class AbstractCursor<TSchema = any, CursorEvents extends
      */
     get killed(): boolean;
     get loadBalanced(): boolean;
+    /* Excluded from this release type: [Symbol.asyncDispose] */
+    /* Excluded from this release type: asyncDispose */
     /** Returns current buffered documents length */
     bufferedCount(): number;
     /** Returns current buffered documents */
-    readBufferedDocuments(number?: number): TSchema[];
+    readBufferedDocuments(number?: number): NonNullable<TSchema>[];
     [Symbol.asyncIterator](): AsyncGenerator<TSchema, void, void>;
     stream(options?: CursorStreamOptions): Readable & AsyncIterable<TSchema>;
     hasNext(): Promise<boolean>;
@@ -73,6 +97,9 @@ export declare abstract class AbstractCursor<TSchema = any, CursorEvents extends
      * @deprecated - Will be removed in a future release. Use for await...of instead.
      */
     forEach(iterator: (doc: TSchema) => boolean | void): Promise<void>;
+    /**
+     * Frees any client-side resources used by the cursor.
+     */
     close(): Promise<void>;
     /**
      * Returns an array of documents. The caller is responsible for making sure that there
@@ -501,6 +528,15 @@ export declare type ArrayOperator<Type> = {
     $sort?: Sort;
 };
 
+/**
+ * @public
+ */
+declare interface AsyncDisposable_2 {
+    /* Excluded from this release type: [Symbol.asyncDispose] */
+    /* Excluded from this release type: asyncDispose */
+}
+export { AsyncDisposable_2 as AsyncDisposable }
+
 /** @public */
 export declare interface Auth {
     /** The username for auth */
@@ -589,77 +625,7 @@ export declare interface AutoEncryptionOptions {
     /** The namespace where keys are stored in the key vault */
     keyVaultNamespace?: string;
     /** Configuration options that are used by specific KMS providers during key generation, encryption, and decryption. */
-    kmsProviders?: {
-        /** Configuration options for using 'aws' as your KMS provider */
-        aws?: {
-            /** The access key used for the AWS KMS provider */
-            accessKeyId: string;
-            /** The secret access key used for the AWS KMS provider */
-            secretAccessKey: string;
-            /**
-             * An optional AWS session token that will be used as the
-             * X-Amz-Security-Token header for AWS requests.
-             */
-            sessionToken?: string;
-        } | Record<string, never>;
-        /** Configuration options for using 'local' as your KMS provider */
-        local?: {
-            /**
-             * The master key used to encrypt/decrypt data keys.
-             * A 96-byte long Buffer or base64 encoded string.
-             */
-            key: Buffer | string;
-        };
-        /** Configuration options for using 'azure' as your KMS provider */
-        azure?: {
-            /** The tenant ID identifies the organization for the account */
-            tenantId: string;
-            /** The client ID to authenticate a registered application */
-            clientId: string;
-            /** The client secret to authenticate a registered application */
-            clientSecret: string;
-            /**
-             * If present, a host with optional port. E.g. "example.com" or "example.com:443".
-             * This is optional, and only needed if customer is using a non-commercial Azure instance
-             * (e.g. a government or China account, which use different URLs).
-             * Defaults to "login.microsoftonline.com"
-             */
-            identityPlatformEndpoint?: string | undefined;
-        } | {
-            /**
-             * If present, an access token to authenticate with Azure.
-             */
-            accessToken: string;
-        } | Record<string, never>;
-        /** Configuration options for using 'gcp' as your KMS provider */
-        gcp?: {
-            /** The service account email to authenticate */
-            email: string;
-            /** A PKCS#8 encrypted key. This can either be a base64 string or a binary representation */
-            privateKey: string | Buffer;
-            /**
-             * If present, a host with optional port. E.g. "example.com" or "example.com:443".
-             * Defaults to "oauth2.googleapis.com"
-             */
-            endpoint?: string | undefined;
-        } | {
-            /**
-             * If present, an access token to authenticate with GCP.
-             */
-            accessToken: string;
-        } | Record<string, never>;
-        /**
-         * Configuration options for using 'kmip' as your KMS provider
-         */
-        kmip?: {
-            /**
-             * The output endpoint string.
-             * The endpoint consists of a hostname and port separated by a colon.
-             * E.g. "example.com:123". A port is always present.
-             */
-            endpoint?: string;
-        };
-    };
+    kmsProviders?: KMSProviders;
     /**
      * A map of namespaces to a local JSON schema for encryption
      *
@@ -951,6 +917,7 @@ export declare abstract class BulkOperationBase {
     find(selector: Document): FindOperators;
     /** Specifies a raw operation to perform in the bulk write. */
     raw(op: AnyBulkWriteOperation): this;
+    get length(): number;
     get bsonOptions(): BSONSerializeOptions;
     get writeConcern(): WriteConcern | undefined;
     get batches(): Batch[];
@@ -1058,7 +1025,9 @@ export declare class CancellationToken extends TypedEventEmitter<{
  * Creates a new Change Stream instance. Normally created using {@link Collection#watch|Collection.watch()}.
  * @public
  */
-export declare class ChangeStream<TSchema extends Document = Document, TChange extends Document = ChangeStreamDocument<TSchema>> extends TypedEventEmitter<ChangeStreamEvents<TSchema, TChange>> {
+export declare class ChangeStream<TSchema extends Document = Document, TChange extends Document = ChangeStreamDocument<TSchema>> extends TypedEventEmitter<ChangeStreamEvents<TSchema, TChange>> implements AsyncDisposable_2 {
+    /* Excluded from this release type: [Symbol.asyncDispose] */
+    /* Excluded from this release type: asyncDispose */
     pipeline: Document[];
     /**
      * @remarks WriteConcern can still be present on the options because
@@ -1117,7 +1086,9 @@ export declare class ChangeStream<TSchema extends Document = Document, TChange e
     [Symbol.asyncIterator](): AsyncGenerator<TChange, void, void>;
     /** Is the cursor closed */
     get closed(): boolean;
-    /** Close the Change Stream */
+    /**
+     * Frees the internal resources used by the change stream.
+     */
     close(): Promise<void>;
     /**
      * Return a modified Readable stream including a possible transform method.
@@ -1773,9 +1744,7 @@ export declare class ClientEncryption {
     /**
      * Encrypts a Match Expression or Aggregate Expression to query a range index.
      *
-     * Only supported when queryType is "rangePreview" and algorithm is "RangePreview".
-     *
-     * @experimental The Range algorithm is experimental only. It is not intended for production use. It is subject to breaking changes.
+     * Only supported when queryType is "range" and algorithm is "Range".
      *
      * @param expression - a BSON document of one of the following forms:
      *  1. A Match Expression of this form:
@@ -1847,7 +1816,7 @@ export declare interface ClientEncryptionEncryptOptions {
     /**
      * The algorithm to use for encryption.
      */
-    algorithm: 'AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic' | 'AEAD_AES_256_CBC_HMAC_SHA_512-Random' | 'Indexed' | 'Unindexed' | 'RangePreview';
+    algorithm: 'AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic' | 'AEAD_AES_256_CBC_HMAC_SHA_512-Random' | 'Indexed' | 'Unindexed' | 'Range';
     /**
      * The id of the Binary dataKey to use for encryption
      */
@@ -1859,41 +1828,10 @@ export declare interface ClientEncryptionEncryptOptions {
     /** The contention factor. */
     contentionFactor?: bigint | number;
     /**
-     * The query type supported.  Only the queryType `equality` is stable.
-     *
-     * @experimental Public Technical Preview: The queryType `rangePreview` is experimental.
+     * The query type.
      */
-    queryType?: 'equality' | 'rangePreview';
-    /** @experimental Public Technical Preview: The index options for a Queryable Encryption field supporting "rangePreview" queries.*/
-    rangeOptions?: RangeOptions;
-}
-
-/**
- * @public
- * Options to provide when encrypting data.
- */
-export declare interface ClientEncryptionEncryptOptions {
-    /**
-     * The algorithm to use for encryption.
-     */
-    algorithm: 'AEAD_AES_256_CBC_HMAC_SHA_512-Deterministic' | 'AEAD_AES_256_CBC_HMAC_SHA_512-Random' | 'Indexed' | 'Unindexed' | 'RangePreview';
-    /**
-     * The id of the Binary dataKey to use for encryption
-     */
-    keyId?: Binary;
-    /**
-     * A unique string name corresponding to an already existing dataKey.
-     */
-    keyAltName?: string;
-    /** The contention factor. */
-    contentionFactor?: bigint | number;
-    /**
-     * The query type supported.  Only the queryType `equality` is stable.
-     *
-     * @experimental Public Technical Preview: The queryType `rangePreview` is experimental.
-     */
-    queryType?: 'equality' | 'rangePreview';
-    /** @experimental Public Technical Preview: The index options for a Queryable Encryption field supporting "rangePreview" queries.*/
+    queryType?: 'equality' | 'range';
+    /** The index options for a Queryable Encryption field supporting "range" queries.*/
     rangeOptions?: RangeOptions;
 }
 
@@ -1942,6 +1880,13 @@ export declare interface ClientEncryptionRewrapManyDataKeyResult {
     bulkWriteResult?: BulkWriteResult;
 }
 
+/**
+ * @public
+ *
+ * Socket options to use for KMS requests.
+ */
+export declare type ClientEncryptionSocketOptions = Pick<MongoClientOptions, 'autoSelectFamily' | 'autoSelectFamilyAttemptTimeout'>;
+
 /**
  * @public
  *
@@ -2001,7 +1946,7 @@ export declare interface ClientMetadataOptions {
  * NOTE: not meant to be instantiated directly.
  * @public
  */
-export declare class ClientSession extends TypedEventEmitter<ClientSessionEvents> {
+export declare class ClientSession extends TypedEventEmitter<ClientSessionEvents> implements AsyncDisposable_2 {
     /* Excluded from this release type: client */
     /* Excluded from this release type: sessionPool */
     hasEnded: boolean;
@@ -2033,11 +1978,16 @@ export declare class ClientSession extends TypedEventEmitter<ClientSessionEvents
     /* Excluded from this release type: unpin */
     get isPinned(): boolean;
     /**
-     * Ends this session on the server
+     * Frees any client-side resources held by the current session.  If a session is in a transaction,
+     * the transaction is aborted.
+     *
+     * Does not end the session on the server.
      *
      * @param options - Optional settings. Currently reserved for future use
      */
     endSession(options?: EndSessionOptions): Promise<void>;
+    /* Excluded from this release type: [Symbol.asyncDispose] */
+    /* Excluded from this release type: asyncDispose */
     /**
      * Advances the operationTime for a ClientSession.
      *
@@ -2272,7 +2222,7 @@ export declare class Collection<TSchema extends Document = Document> {
      * @param docs - The documents to insert
      * @param options - Optional settings for the command
      */
-    insertMany(docs: OptionalUnlessRequiredId<TSchema>[], options?: BulkWriteOptions): Promise<InsertManyResult<TSchema>>;
+    insertMany(docs: ReadonlyArray<OptionalUnlessRequiredId<TSchema>>, options?: BulkWriteOptions): Promise<InsertManyResult<TSchema>>;
     /**
      * Perform a bulkWrite operation without a fluent API
      *
@@ -2292,7 +2242,7 @@ export declare class Collection<TSchema extends Document = Document> {
      * @param options - Optional settings for the command
      * @throws MongoDriverError if operations is not an array
      */
-    bulkWrite(operations: AnyBulkWriteOperation<TSchema>[], options?: BulkWriteOptions): Promise<BulkWriteResult>;
+    bulkWrite(operations: ReadonlyArray<AnyBulkWriteOperation<TSchema>>, options?: BulkWriteOptions): Promise<BulkWriteResult>;
     /**
      * Update a single document in a collection
      *
@@ -2879,6 +2829,8 @@ export declare type CompressorName = keyof typeof Compressor;
 /** @public */
 export declare type Condition<T> = AlternativeType<T> | FilterOperators<AlternativeType<T>>;
 
+/* Excluded from this release type: configureExplicitResourceManagement */
+
 /* Excluded from this release type: Connection */
 
 /* Excluded from this release type: CONNECTION_CHECK_OUT_FAILED */
@@ -2924,6 +2876,14 @@ export declare class ConnectionCheckedOutEvent extends ConnectionPoolMonitoringE
     /** The id of the connection */
     connectionId: number | '<monitor>';
     /* Excluded from this release type: name */
+    /**
+     * The time it took to check out the connection.
+     * More specifically, the time elapsed between
+     * emitting a `ConnectionCheckOutStartedEvent`
+     * and emitting this event as part of the same checking out.
+     *
+     */
+    durationMS: number;
     /* Excluded from this release type: __constructor */
 }
 
@@ -2937,6 +2897,13 @@ export declare class ConnectionCheckOutFailedEvent extends ConnectionPoolMonitor
     reason: string;
     /* Excluded from this release type: error */
     /* Excluded from this release type: name */
+    /**
+     * The time it took to check out the connection.
+     * More specifically, the time elapsed between
+     * emitting a `ConnectionCheckOutStartedEvent`
+     * and emitting this event as part of the same check out.
+     */
+    durationMS: number;
     /* Excluded from this release type: __constructor */
 }
 
@@ -3112,6 +3079,18 @@ export declare class ConnectionPoolReadyEvent extends ConnectionPoolMonitoringEv
 export declare class ConnectionReadyEvent extends ConnectionPoolMonitoringEvent {
     /** The id of the connection */
     connectionId: number | '<monitor>';
+    /**
+     * The time it took to establish the connection.
+     * In accordance with the definition of establishment of a connection
+     * specified by `ConnectionPoolOptions.maxConnecting`,
+     * it is the time elapsed between emitting a `ConnectionCreatedEvent`
+     * and emitting this event as part of the same checking out.
+     *
+     * Naturally, when establishing a connection is part of checking out,
+     * this duration is not greater than
+     * `ConnectionCheckedOutEvent.duration`.
+     */
+    durationMS: number;
     /* Excluded from this release type: name */
     /* Excluded from this release type: __constructor */
 }
@@ -4663,10 +4642,10 @@ export declare interface KMSProviders {
 /* Excluded from this release type: kWaitQueue_2 */
 
 /** @public */
-export declare const LEGAL_TCP_SOCKET_OPTIONS: readonly ["family", "hints", "localAddress", "localPort", "lookup"];
+export declare const LEGAL_TCP_SOCKET_OPTIONS: readonly ["autoSelectFamily", "autoSelectFamilyAttemptTimeout", "family", "hints", "localAddress", "localPort", "lookup"];
 
 /** @public */
-export declare const LEGAL_TLS_SOCKET_OPTIONS: readonly ["ALPNProtocols", "ca", "cert", "checkServerIdentity", "ciphers", "crl", "ecdhCurve", "key", "minDHSize", "passphrase", "pfx", "rejectUnauthorized", "secureContext", "secureProtocol", "servername", "session"];
+export declare const LEGAL_TLS_SOCKET_OPTIONS: readonly ["allowPartialTrustChain", "ALPNProtocols", "ca", "cert", "checkServerIdentity", "ciphers", "crl", "ecdhCurve", "key", "minDHSize", "passphrase", "pfx", "rejectUnauthorized", "secureContext", "secureProtocol", "servername", "session"];
 
 /* Excluded from this release type: List */
 
@@ -4967,13 +4946,15 @@ export declare class MongoChangeStreamError extends MongoRuntimeError {
  * await client.insertOne({ name: 'spot', kind: 'dog' });
  * ```
  */
-export declare class MongoClient extends TypedEventEmitter<MongoClientEvents> {
+export declare class MongoClient extends TypedEventEmitter<MongoClientEvents> implements AsyncDisposable_2 {
     /* Excluded from this release type: s */
     /* Excluded from this release type: topology */
     /* Excluded from this release type: mongoLogger */
     /* Excluded from this release type: connectionLock */
     /* Excluded from this release type: [kOptions] */
     constructor(url: string, options?: MongoClientOptions);
+    /* Excluded from this release type: [Symbol.asyncDispose] */
+    /* Excluded from this release type: asyncDispose */
     /* Excluded from this release type: checkForNonGenuineHosts */
     /** @see MongoOptions */
     get options(): Readonly<MongoOptions>;
@@ -4993,7 +4974,15 @@ export declare class MongoClient extends TypedEventEmitter<MongoClientEvents> {
     connect(): Promise<this>;
     /* Excluded from this release type: _connect */
     /**
-     * Close the client and its underlying connections
+     * Cleans up client-side resources used by the MongoCLient and .  This includes:
+     *
+     * - Closes all open, unused connections (see note).
+     * - Ends all in-use sessions with {@link ClientSession#endSession|ClientSession.endSession()}.
+     * - Ends all unused sessions server-side.
+     * - Cleans up any resources being used for auto encryption if auto encryption is enabled.
+     *
+     * @remarks Any in-progress operations are not killed and any connections used by in progress operations
+     * will be cleaned up lazily as operations finish.
      *
      * @param force - Force close, emitting no events
      */
@@ -6244,15 +6233,7 @@ export declare class MongoWriteConcernError extends MongoServerError {
      *
      * @public
      **/
-    constructor(result: {
-        writeConcernError: {
-            code: number;
-            errmsg: string;
-            codeName?: string;
-            errInfo?: Document;
-        };
-        errorLabels?: string[];
-    });
+    constructor(result: WriteConcernErrorResult);
     get name(): string;
 }
 
@@ -6504,14 +6485,19 @@ export declare type PushOperator<TSchema> = ({
 
 /**
  * @public
- * RangeOptions specifies index options for a Queryable Encryption field supporting "rangePreview" queries.
- * min, max, sparsity, and range must match the values set in the encryptedFields of the destination collection.
+ * RangeOptions specifies index options for a Queryable Encryption field supporting "range" queries.
+ * min, max, sparsity, trimFactor and range must match the values set in the encryptedFields of the destination collection.
  * For double and decimal128, min/max/precision must all be set, or all be unset.
  */
 export declare interface RangeOptions {
+    /** min is the minimum value for the encrypted index. Required if precision is set. */
     min?: any;
+    /** max is the minimum value for the encrypted index. Required if precision is set. */
     max?: any;
-    sparsity: Long;
+    /** sparsity may be used to tune performance. must be non-negative. When omitted, a default value is used. */
+    sparsity?: Long | bigint;
+    /** trimFactor may be used to tune performance. must be non-negative. When omitted, a default value is used. */
+    trimFactor?: Int32 | number;
     precision?: number;
 }
 
@@ -7254,10 +7240,15 @@ export declare type StrictUpdateFilter<TSchema> = {
 export declare type SupportedNodeConnectionOptions = SupportedTLSConnectionOptions & SupportedTLSSocketOptions & SupportedSocketOptions;
 
 /** @public */
-export declare type SupportedSocketOptions = Pick<TcpNetConnectOpts, (typeof LEGAL_TCP_SOCKET_OPTIONS)[number]>;
+export declare type SupportedSocketOptions = Pick<TcpNetConnectOpts & {
+    autoSelectFamily?: boolean;
+    autoSelectFamilyAttemptTimeout?: number;
+}, (typeof LEGAL_TCP_SOCKET_OPTIONS)[number]>;
 
 /** @public */
-export declare type SupportedTLSConnectionOptions = Pick<ConnectionOptions_2, Extract<keyof ConnectionOptions_2, (typeof LEGAL_TLS_SOCKET_OPTIONS)[number]>>;
+export declare type SupportedTLSConnectionOptions = Pick<ConnectionOptions_2 & {
+    allowPartialTrustChain?: boolean;
+}, (typeof LEGAL_TLS_SOCKET_OPTIONS)[number]>;
 
 /** @public */
 export declare type SupportedTLSSocketOptions = Pick<TLSSocketOptions, Extract<keyof TLSSocketOptions, (typeof LEGAL_TLS_SOCKET_OPTIONS)[number]>>;
@@ -7787,6 +7778,23 @@ export declare interface WriteConcernErrorData {
     errInfo?: Document;
 }
 
+/**
+ * The type of the result property of MongoWriteConcernError
+ * @public
+ */
+export declare interface WriteConcernErrorResult {
+    writeConcernError: {
+        code: number;
+        errmsg: string;
+        codeName?: string;
+        errInfo?: Document;
+    };
+    ok: number;
+    code?: number;
+    errorLabels?: string[];
+    [x: string | number]: unknown;
+}
+
 /** @public */
 export declare interface WriteConcernOptions {
     /** Write Concern as an object */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mongodb",
-  "version": "6.8.2",
+  "version": "6.9.0",
   "description": "The official MongoDB driver for Node.js",
   "main": "lib/index.js",
   "files": [
@@ -62,55 +62,53 @@
     }
   },
   "devDependencies": {
-    "@aws-sdk/credential-providers": "^3.515.0",
+    "@aws-sdk/credential-providers": "^3.632.0",
     "@iarna/toml": "^2.2.5",
     "@istanbuljs/nyc-config-typescript": "^1.0.2",
-    "@microsoft/api-extractor": "^7.43.1",
-    "@microsoft/tsdoc-config": "^0.16.2",
+    "@microsoft/api-extractor": "^7.47.5",
+    "@microsoft/tsdoc-config": "^0.17.0",
     "@mongodb-js/zstd": "^1.2.0",
-    "@types/chai": "^4.3.14",
+    "@types/chai": "^4.3.17",
     "@types/chai-subset": "^1.3.5",
     "@types/express": "^4.17.21",
     "@types/kerberos": "^1.1.5",
-    "@types/mocha": "^10.0.6",
-    "@types/node": "^20.12.7",
+    "@types/mocha": "^10.0.7",
+    "@types/node": "^22.4.1",
     "@types/saslprep": "^1.0.3",
     "@types/semver": "^7.5.8",
     "@types/sinon": "^17.0.3",
     "@types/sinon-chai": "^3.2.12",
-    "@types/whatwg-url": "^11.0.4",
-    "@typescript-eslint/eslint-plugin": "^5.62.0",
-    "@typescript-eslint/parser": "^5.62.0",
+    "@types/whatwg-url": "^11.0.5",
+    "@typescript-eslint/eslint-plugin": "^8.2.0",
+    "@typescript-eslint/parser": "^8.2.0",
     "chai": "^4.4.1",
     "chai-subset": "^1.6.0",
     "chalk": "^4.1.2",
-    "eslint": "^8.56.0",
-    "eslint-config-prettier": "^8.10.0",
-    "eslint-plugin-github": "^4.10.2",
-    "eslint-plugin-import": "^2.29.1",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-mocha": "^10.4.1",
-    "eslint-plugin-prettier": "^4.2.1",
-    "eslint-plugin-simple-import-sort": "^10.0.0",
-    "eslint-plugin-tsdoc": "^0.2.17",
-    "eslint-plugin-unused-imports": "^2.0.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-tsdoc": "^0.3.0",
+    "eslint-plugin-unused-imports": "^4.0.0",
     "express": "^4.19.2",
     "gcp-metadata": "^5.3.0",
     "js-yaml": "^4.1.0",
     "mocha": "^10.4.0",
     "mocha-sinon": "^2.1.2",
-    "mongodb-client-encryption": "^6.0.1",
-    "mongodb-legacy": "^6.0.1",
+    "mongodb-client-encryption": "^6.1.0",
+    "mongodb-legacy": "^6.1.0",
     "nyc": "^15.1.0",
-    "prettier": "^2.8.8",
-    "semver": "^7.6.0",
-    "sinon": "^17.0.1",
+    "prettier": "^3.3.3",
+    "semver": "^7.6.3",
+    "sinon": "^18.0.0",
     "sinon-chai": "^3.7.0",
     "snappy": "^7.2.2",
     "socks": "^2.8.1",
     "source-map-support": "^0.5.21",
     "ts-node": "^10.9.2",
-    "tsd": "^0.31.0",
-    "typescript": "5.0",
+    "tsd": "^0.31.1",
+    "typescript": "5.5",
     "typescript-cached-transpile": "^0.0.6",
     "v8-heapsnapshot": "^1.3.1",
     "yargs": "^17.7.2"
@@ -126,7 +124,7 @@
   "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 mongodb.d.ts --fix",
+    "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 lib/beta.d.ts",
     "build:docs": "./etc/docs/build.ts",
     "build:typedoc": "typedoc",
     "build:nightly": "node ./.github/scripts/nightly.mjs",
@@ -136,7 +134,7 @@
     "check:lambda": "mocha --config test/mocha_lambda.json test/integration/node-specific/examples/handler.test.js",
     "check:lambda:aws": "mocha --config test/mocha_lambda.json 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": "eslint -v && eslint --max-warnings=0 --ext '.js,.ts' src test",
+    "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 --noEmit mongodb.d.ts && tsd",
@@ -145,6 +143,7 @@
     "check:unit": "mocha test/unit",
     "check:ts": "node ./node_modules/typescript/bin/tsc -v && node ./node_modules/typescript/bin/tsc --noEmit",
     "check:atlas": "mocha --config test/manual/mocharc.json test/manual/atlas_connectivity.test.ts",
+    "check:resource-management": "mocha --config test/manual/mocharc.json test/manual/resource_management.test.ts",
     "check:drivers-atlas-testing": "mocha --config test/mocha_mongodb.json test/atlas/drivers_atlas_testing.test.ts",
     "check:adl": "mocha --config test/mocha_mongodb.json test/manual/atlas-data-lake-testing",
     "check:aws": "nyc mocha --config test/mocha_mongodb.json test/integration/auth/mongodb_aws.test.ts",

package/src/beta.ts

@@ -0,0 +1,22 @@
+import { type Document } from 'bson';
+
+export * from './index';
+
+/**
+ * @internal
+ *
+ * Since we don't bundle tslib helpers, we need to polyfill this method.
+ *
+ * This is used in the generated JS.  Adapted from https://github.com/microsoft/TypeScript/blob/aafdfe5b3f76f5c41abeec412ce73c86da94c75f/src/compiler/factory/emitHelpers.ts#L1202.
+ */
+
+function __exportStar(mod: Document) {
+  for (const key of Object.keys(mod)) {
+    Object.defineProperty(exports, key, {
+      enumerable: true,
+      get: function () {
+        return mod[key];
+      }
+    });
+  }
+}

package/src/bson.ts

@@ -1,5 +1,4 @@
-import type { DeserializeOptions, SerializeOptions } from 'bson';
-import { BSON } from 'bson';
+import { BSON, type DeserializeOptions, type SerializeOptions } from 'bson';
 
 export {
   Binary,