@mongosh/shell-api 3.29.1 → 5.0.0

package/lib/api-raw.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="node" />
 
+import type { Abortable as Abortable_2 } from 'events';
 import type { Agent } from 'https';
 import type { AgentConnectOpts } from 'agent-base';
 import { Binary } from 'bson';
@@ -70,7 +71,7 @@ declare type Abortable = {
 };
 
 /** @public */
-declare abstract class AbstractCursor<TSchema = any, CursorEvents extends AbstractCursorEvents = AbstractCursorEvents> extends TypedEventEmitter<CursorEvents> implements AsyncDisposable_2 {
+declare abstract class AbstractCursor<TSchema = any, CursorEvents extends AbstractCursorEvents = AbstractCursorEvents> extends TypedEventEmitter<CursorEvents> implements AsyncDisposable {
     /* Excluded from this release type: cursorId */
     /* Excluded from this release type: cursorSession */
     /* Excluded from this release type: selectedServer */
@@ -115,8 +116,11 @@ declare abstract class AbstractCursor<TSchema = any, CursorEvents extends Abstra
      */
     get killed(): boolean;
     get loadBalanced(): boolean;
-    /* Excluded from this release type: [Symbol.asyncDispose] */
-    /* Excluded from this release type: asyncDispose */
+    /**
+     * @experimental
+     * An alias for {@link AbstractCursor.close|AbstractCursor.close()}.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
     /** Adds cursor to client's tracking so it will be closed by MongoClient.close() */
     private trackCursor;
     /** Returns current buffered documents length */
@@ -124,7 +128,7 @@ declare abstract class AbstractCursor<TSchema = any, CursorEvents extends Abstra
     /** Returns current buffered documents */
     readBufferedDocuments(number?: number): NonNullable<TSchema>[];
     [Symbol.asyncIterator](): AsyncGenerator<TSchema, void, void>;
-    stream(options?: CursorStreamOptions): Readable & AsyncIterable<TSchema>;
+    stream(): Readable & AsyncIterable<TSchema>;
     hasNext(): Promise<boolean>;
     /** Get the next available document from the cursor, returns null if no more documents are available. */
     next(): Promise<TSchema | null>;
@@ -707,14 +711,6 @@ declare type ArrayOperator<Type> = {
 
 declare const asPrintable: unique symbol;
 
-/**
- * @public
- */
-declare interface AsyncDisposable_2 {
-    /* Excluded from this release type: [Symbol.asyncDispose] */
-    /* Excluded from this release type: asyncDispose */
-}
-
 /** @public */
 declare interface Auth {
     /** The username for auth */
@@ -736,7 +732,6 @@ declare type AuthFlowType = 'auth-code' | 'device-auth';
 /** @public */
 declare const AuthMechanism: Readonly<{
     readonly MONGODB_AWS: "MONGODB-AWS";
-    readonly MONGODB_CR: "MONGODB-CR";
     readonly MONGODB_DEFAULT: "DEFAULT";
     readonly MONGODB_GSSAPI: "GSSAPI";
     readonly MONGODB_PLAIN: "PLAIN";
@@ -755,7 +750,7 @@ declare interface AuthMechanismProperties extends Document_2 {
     SERVICE_NAME?: string;
     SERVICE_REALM?: string;
     CANONICALIZE_HOST_NAME?: GSSAPICanonicalizationValue;
-    AWS_SESSION_TOKEN?: string;
+    /* Excluded from this release type: AWS_SESSION_TOKEN */
     /** A user provided OIDC machine callback function. */
     OIDC_CALLBACK?: OIDCCallbackFunction;
     /** A user provided OIDC human interacted callback function. */
@@ -880,7 +875,7 @@ declare interface AutoEncryptionOptions {
         /** If true, autoEncryption will not attempt to spawn a mongocryptd before connecting  */
         mongocryptdBypassSpawn?: boolean;
         /** The path to the mongocryptd executable on the system */
-        mongocryptdSpawnPath?: string;
+        mongocryptdSpawnPath?: `${string}mongocryptd${'.exe' | ''}`;
         /** Command line arguments to use when auto-spawning a mongocryptd */
         mongocryptdSpawnArgs?: string[];
         /**
@@ -906,7 +901,7 @@ declare interface AutoEncryptionOptions {
          *
          * Requires the MongoDB Crypt shared library, available in MongoDB 6.0 or higher.
          */
-        cryptSharedLibPath?: string;
+        cryptSharedLibPath?: `${string}mongo_crypt_v${number}.${'so' | 'dll' | 'dylib'}`;
         /**
          * If specified, never use mongocryptd and instead fail when the MongoDB Crypt
          * shared library could not be loaded.
@@ -1161,6 +1156,7 @@ declare abstract class BulkOperationBase {
     /* Excluded from this release type: s */
     operationId?: number;
     private collection;
+    /* Excluded from this release type: retryWrites */
     /* Excluded from this release type: __constructor */
     /**
      * Add a single insert document to the bulk operation
@@ -1331,23 +1327,16 @@ declare type CacheOptions = {
     aggregationSchemaTTL: number;
 };
 
-/**
- * @public
- * @deprecated Will be removed in favor of `AbortSignal` in the next major release.
- */
-declare class CancellationToken extends TypedEventEmitter<{
-    cancel(): void;
-}> {
-    constructor(...args: any[]);
-}
-
 /**
  * Creates a new Change Stream instance. Normally created using {@link Collection#watch|Collection.watch()}.
  * @public
  */
-declare class ChangeStream<TSchema extends Document_2 = Document_2, TChange extends Document_2 = ChangeStreamDocument<TSchema>> extends TypedEventEmitter<ChangeStreamEvents<TSchema, TChange>> implements AsyncDisposable_2 {
-    /* Excluded from this release type: [Symbol.asyncDispose] */
-    /* Excluded from this release type: asyncDispose */
+declare class ChangeStream<TSchema extends Document_2 = Document_2, TChange extends Document_2 = ChangeStreamDocument<TSchema>> extends TypedEventEmitter<ChangeStreamEvents<TSchema, TChange>> implements AsyncDisposable {
+    /**
+     * @experimental
+     * An alias for {@link ChangeStream.close|ChangeStream.close()}.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
     pipeline: Document_2[];
     /**
      * @remarks WriteConcern can still be present on the options because
@@ -1363,7 +1352,6 @@ declare class ChangeStream<TSchema extends Document_2 = Document_2, TChange exte
     namespace: MongoDBNamespace;
     type: symbol;
     /* Excluded from this release type: cursor */
-    streamOptions?: CursorStreamOptions;
     /* Excluded from this release type: cursorStream */
     /* Excluded from this release type: isClosed */
     /* Excluded from this release type: mode */
@@ -1424,7 +1412,7 @@ declare class ChangeStream<TSchema extends Document_2 = Document_2, TChange exte
      *
      * @throws MongoChangeStreamError if the underlying cursor or the change stream is closed
      */
-    stream(options?: CursorStreamOptions): Readable & AsyncIterable<TChange>;
+    stream(): Readable & AsyncIterable<TChange>;
     /* Excluded from this release type: _setIsEmitter */
     /* Excluded from this release type: _setIsIterator */
     /* Excluded from this release type: _createChangeStreamCursor */
@@ -2106,7 +2094,7 @@ declare class ClientEncryption {
      * }
      * ```
      */
-    rewrapManyDataKey(filter: Filter<DataKey>, options: ClientEncryptionRewrapManyDataKeyProviderOptions): Promise<{
+    rewrapManyDataKey(filter: Filter<DataKey>, options?: ClientEncryptionRewrapManyDataKeyProviderOptions): Promise<{
         bulkWriteResult?: BulkWriteResult;
     }>;
     /**
@@ -2489,36 +2477,6 @@ declare type ClientInsertResult = {
     insertedId: any;
 };
 
-/**
- * @public
- * @deprecated This interface will be made internal in the next major release.
- * @see https://github.com/mongodb/specifications/blob/master/source/mongodb-handshake/handshake.md#hello-command
- */
-declare interface ClientMetadata {
-    driver: {
-        name: string;
-        version: string;
-    };
-    os: {
-        type: string;
-        name?: NodeJS.Platform;
-        architecture?: string;
-        version?: string;
-    };
-    platform: string;
-    application?: {
-        name: string;
-    };
-    /** FaaS environment information */
-    env?: {
-        name: 'aws.lambda' | 'gcp.func' | 'azure.func' | 'vercel';
-        timeout_sec?: Int32;
-        memory_mb?: Int32;
-        region?: string;
-        url?: string;
-    };
-}
-
 /** @public */
 declare interface ClientReplaceOneModel<TSchema> extends ClientWriteModel {
     name: 'replaceOne';
@@ -2545,7 +2503,7 @@ declare interface ClientReplaceOneModel<TSchema> extends ClientWriteModel {
  * NOTE: not meant to be instantiated directly.
  * @public
  */
-declare class ClientSession extends TypedEventEmitter<ClientSessionEvents> implements AsyncDisposable_2 {
+declare class ClientSession extends TypedEventEmitter<ClientSessionEvents> implements AsyncDisposable {
     /* Excluded from this release type: client */
     /* Excluded from this release type: sessionPool */
     hasEnded: boolean;
@@ -2558,8 +2516,7 @@ declare class ClientSession extends TypedEventEmitter<ClientSessionEvents> imple
     explicit: boolean;
     /* Excluded from this release type: owner */
     defaultTransactionOptions: TransactionOptions;
-    /** @deprecated - Will be made internal in the next major release */
-    transaction: Transaction;
+    /* Excluded from this release type: transaction */
     /* Excluded from this release type: commitAttempted */
     readonly snapshotEnabled: boolean;
     /* Excluded from this release type: _serverSession */
@@ -2589,8 +2546,11 @@ declare class ClientSession extends TypedEventEmitter<ClientSessionEvents> imple
      * @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 */
+    /**
+     * @experimental
+     * An alias for {@link ClientSession.endSession|ClientSession.endSession()}.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
     /**
      * Advances the operationTime for a ClientSession.
      *
@@ -2886,21 +2846,23 @@ declare class Collection<M extends GenericServerSideSchema = GenericServerSideSc
     private _emitCollectionApiCall;
     aggregate(pipeline: MQLPipeline, options: AggregateOptions & {
         explain: ExplainVerbosityLike;
-    }): Promise<Document_2>;
-    aggregate(pipeline: MQLPipeline, options?: AggregateOptions): Promise<AggregationCursor_2>;
+    } & Abortable_2): Promise<Document_2>;
+    aggregate(pipeline: MQLPipeline, options?: AggregateOptions & Abortable_2): Promise<AggregationCursor_2>;
     aggregate(...stages: MQLPipeline): Promise<AggregationCursor_2>;
     bulkWrite(operations: AnyBulkWriteOperation[], options?: BulkWriteOptions): Promise<BulkWriteResult_2>;
     count(query?: {}, options?: CountOptions): Promise<number>;
-    countDocuments(query?: MQLQuery, options?: CountDocumentsOptions): Promise<number>;
+    countDocuments(query?: MQLQuery, options?: CountDocumentsOptions & Abortable_2): Promise<number>;
     deleteMany(filter: Document_2, options?: DeleteOptions): Promise<DeleteResult_2 | Document_2>;
     deleteOne(filter: Document_2, options?: DeleteOptions): Promise<DeleteResult_2 | Document_2>;
     distinct(field: string): Promise<Document_2>;
     distinct(field: string, query: MQLQuery): Promise<Document_2>;
     distinct(field: string, query: MQLQuery, options: DistinctOptions): Promise<Document_2>;
     estimatedDocumentCount(options?: EstimatedDocumentCountOptions): Promise<number>;
-    find(query?: MQLQuery, projection?: Document_2, options?: FindOptions): Promise<Cursor>;
+    find(query?: MQLQuery, projection?: Document_2, options?: FindOptions & {
+        explain?: ExplainVerbosityLike;
+    } & Abortable_2): Promise<Cursor>;
     findAndModify(options: FindAndModifyMethodShellOptions): Promise<Document_2 | null>;
-    findOne(query?: MQLQuery, projection?: Document_2, options?: FindOptions): Promise<MQLDocument | null>;
+    findOne(query?: MQLQuery, projection?: Document_2, options?: FindOptions & Abortable_2): Promise<MQLDocument | null>;
     renameCollection(newName: string, dropTarget?: boolean): Promise<Document_2>;
     findOneAndDelete(filter: Document_2, options?: FindOneAndDeleteOptions): Promise<Document_2 | null>;
     findOneAndReplace(filter: Document_2, replacement: Document_2, options?: FindAndModifyShellOptions<FindOneAndReplaceOptions>): Promise<Document_2>;
@@ -3008,6 +2970,10 @@ declare class Collection<M extends GenericServerSideSchema = GenericServerSideSc
 declare class Collection_2<TSchema extends Document_2 = Document_2> {
     /* Excluded from this release type: s */
     /* Excluded from this release type: client */
+    /**
+     * Get the database object for the collection.
+     */
+    readonly db: Db;
     /* Excluded from this release type: __constructor */
     /**
      * The name of the database this collection belongs to
@@ -3663,15 +3629,9 @@ declare interface CommandOperationOptions extends OperationOptions, WriteConcern
      * In server versions 4.4 and above, 'comment' can be any valid BSON type.
      */
     comment?: unknown;
-    /** Should retry failed writes */
-    retryWrites?: boolean;
     dbName?: string;
     authdb?: string;
-    /**
-     * @deprecated
-     * This option is deprecated and will be removed in an upcoming major version.
-     */
-    noResponse?: boolean;
+    /* Excluded from this release type: rawData */
 }
 
 declare class CommandResult<T = unknown> extends ShellApiValueClass {
@@ -3984,9 +3944,8 @@ declare interface ConnectionOptions_2 extends SupportedNodeConnectionOptions, St
     tls: boolean;
     noDelay?: boolean;
     socketTimeoutMS?: number;
-    cancellationToken?: CancellationToken;
-    metadata: ClientMetadata;
-    /* Excluded from this release type: extendedMetadata */
+    /* Excluded from this release type: cancellationToken */
+    /* Excluded from this release type: metadata */
     /* Excluded from this release type: mongoLogger */
 }
 
@@ -4165,11 +4124,9 @@ declare interface CountOptions extends CommandOperationOptions {
 }
 
 /** @public */
-declare interface CreateCollectionOptions extends CommandOperationOptions {
+declare interface CreateCollectionOptions extends Omit<CommandOperationOptions, 'rawData'> {
     /** Create a capped collection */
     capped?: boolean;
-    /** @deprecated Create an index on the _id field of the document. This option is deprecated in MongoDB 3.2+ and will be removed once no longer supported by the server. */
-    autoIndexId?: boolean;
     /** The size of the capped collection in bytes */
     size?: number;
     /** The maximum number of documents in the capped collection */
@@ -4327,12 +4284,6 @@ declare class CursorIterationResult extends ShellApiValueClass {
     constructor();
 }
 
-/** @public */
-declare interface CursorStreamOptions {
-    /** A transformation method applied to each document emitted by the stream */
-    transform?(this: void, doc: Document_2): Document_2;
-}
-
 /**
  * @public
  * @experimental
@@ -4385,27 +4336,27 @@ declare class Database<M extends GenericServerSideSchema = GenericServerSideSche
     _maybeCachedHello(): Promise<Document_2>;
     [asPrintable](): string;
     private _emitDatabaseApiCall;
-    _runCommand(cmd: Document_2, options?: CommandOperationOptions): Promise<Document_2>;
-    _runReadCommand(cmd: Document_2, options?: CommandOperationOptions): Promise<Document_2>;
-    _runAdminCommand(cmd: Document_2, options?: CommandOperationOptions): Promise<Document_2>;
-    _runAdminReadCommand(cmd: Document_2, options?: CommandOperationOptions): Promise<Document_2>;
+    _runCommand(cmd: Document_2, options?: CommandOperationOptions & Abortable_2): Promise<Document_2>;
+    _runReadCommand(cmd: Document_2, options?: CommandOperationOptions & Abortable_2): Promise<Document_2>;
+    _runAdminCommand(cmd: Document_2, options?: CommandOperationOptions & Abortable_2): Promise<Document_2>;
+    _runAdminReadCommand(cmd: Document_2, options?: CommandOperationOptions & Abortable_2): Promise<Document_2>;
     _runCursorCommand(cmd: Document_2, options?: CommandOperationOptions): Promise<RunCommandCursor_2>;
     _runAdminCursorCommand(cmd: Document_2, options?: CommandOperationOptions): Promise<RunCommandCursor_2>;
-    _listCollections(filter: Document_2, options: ListCollectionsOptions): Promise<Document_2[]>;
-    _getCollectionNames(options?: ListCollectionsOptions): Promise<string[]>;
-    _getCollectionNamesWithTypes(options?: ListCollectionsOptions): Promise<CollectionNamesWithTypes[]>;
+    _listCollections(filter: Document_2, options: ListCollectionsOptions & Abortable_2): Promise<Document_2[]>;
+    _getCollectionNames(options?: ListCollectionsOptions & Abortable_2): Promise<string[]>;
+    _getCollectionNamesWithTypes(options?: ListCollectionsOptions & Abortable_2): Promise<CollectionNamesWithTypes[]>;
     _getCollectionNamesForCompletion(): Promise<string[]>;
     _getLastErrorObj(w?: number | string, wTimeout?: number, j?: boolean): Promise<Document_2>;
     getMongo(): Mongo<M>;
     getName(): StringKey<M>;
     getCollectionNames(): Promise<StringKey<D>[]>;
-    getCollectionInfos(filter?: Document_2, options?: ListCollectionsOptions): Promise<Document_2[]>;
-    runCommand(cmd: string | Document_2, options?: RunCommandOptions): Promise<Document_2>;
+    getCollectionInfos(filter?: Document_2, options?: ListCollectionsOptions & Abortable_2): Promise<Document_2[]>;
+    runCommand(cmd: string | Document_2, options?: RunCommandOptions & Abortable_2): Promise<Document_2>;
     adminCommand(cmd: string | Document_2): Promise<Document_2>;
     aggregate(pipeline: MQLPipeline, options: AggregateOptions & {
         explain: ExplainVerbosityLike;
-    }): Promise<Document_2>;
-    aggregate(pipeline: MQLPipeline, options?: AggregateOptions): Promise<AggregationCursor_2>;
+    } & Abortable_2): Promise<Document_2>;
+    aggregate(pipeline: MQLPipeline, options?: AggregateOptions & Abortable_2): Promise<AggregationCursor_2>;
     aggregate(...stages: MQLPipeline): Promise<AggregationCursor_2>;
     getSiblingDB<K extends StringKey<M>>(db: K): DatabaseWithSchema<M, M[K]>;
     getCollection<K extends StringKey<D>>(coll: K): CollectionWithSchema<M, D, D[K], K>;
@@ -4531,7 +4482,11 @@ declare type DataKeyEncryptionKeyOptions = {
  */
 declare class Db {
     /* Excluded from this release type: s */
-    /* Excluded from this release type: client */
+    /**
+     * Gets the MongoClient associated with the Db.
+     * @public
+     */
+    readonly client: MongoClient;
     static SYSTEM_NAMESPACE_COLLECTION: string;
     static SYSTEM_INDEX_COLLECTION: string;
     static SYSTEM_PROFILE_COLLECTION: string;
@@ -4818,7 +4773,7 @@ declare class DBQuery extends ShellApiClass {
 }
 
 /** @public */
-declare interface DbStatsOptions extends CommandOperationOptions {
+declare interface DbStatsOptions extends Omit<CommandOperationOptions, 'rawData'> {
     /** Divide the returned sizes by scale value. */
     scale?: number;
 }
@@ -4910,6 +4865,7 @@ declare interface DevtoolsConnectOptions extends MongoClientOptions {
     parentHandle?: string;
     proxy?: DevtoolsProxyOptions | AgentWithInitialize;
     applyProxyToOIDC?: boolean | DevtoolsProxyOptions | AgentWithInitialize;
+    useSystemCA?: boolean;
 }
 
 declare interface DevtoolsProxyOptions {
@@ -4949,7 +4905,7 @@ declare interface DriverInfo {
 }
 
 /** @public */
-declare interface DropCollectionOptions extends CommandOperationOptions {
+declare interface DropCollectionOptions extends Omit<CommandOperationOptions, 'rawData'> {
     /** @experimental */
     encryptedFields?: Document_2;
 }
@@ -5033,7 +4989,9 @@ declare class Explainable extends ShellApiWithMongoClass {
     getCollection(): CollectionWithSchema;
     getVerbosity(): ExplainVerbosityLike;
     setVerbosity(verbosity: ExplainVerbosityLike): void;
-    find(query?: MQLQuery, projection?: Document_2, options?: FindOptions): Promise<ExplainableCursor_2>;
+    find(query?: MQLQuery, projection?: Document_2, options?: FindOptions & {
+        explain?: ExplainVerbosityLike;
+    }): Promise<ExplainableCursor_2>;
     aggregate(pipeline: MQLPipeline, options: Document_2): Promise<Document_2>;
     aggregate(...stages: MQLPipeline): Promise<Document_2>;
     count(query?: {}, options?: CountOptions): Promise<Document_2>;
@@ -5454,14 +5412,7 @@ declare interface FindOneAndUpdateOptions extends CommandOperationOptions {
 }
 
 /** @public */
-declare interface FindOneOptions extends FindOptions {
-    /** @deprecated Will be removed in the next major version. User provided value will be ignored. */
-    batchSize?: number;
-    /** @deprecated Will be removed in the next major version. User provided value will be ignored. */
-    limit?: number;
-    /** @deprecated Will be removed in the next major version. User provided value will be ignored. */
-    noCursorTimeout?: boolean;
-}
+declare type FindOneOptions = Omit<FindOptions, 'batchSize' | 'limit' | 'noCursorTimeout'>;
 
 /**
  * A builder object that is returned from {@link BulkOperationBase#find}.
@@ -5494,9 +5445,8 @@ declare class FindOperators {
 
 /**
  * @public
- * @typeParam TSchema - Unused schema definition, deprecated usage, only specify `FindOptions` with no generic
  */
-declare interface FindOptions<TSchema extends Document_2 = Document_2> extends Omit<CommandOperationOptions, 'writeConcern' | 'explain'>, AbstractCursorOptions {
+declare interface FindOptions extends Omit<CommandOperationOptions, 'writeConcern' | 'explain'>, AbstractCursorOptions {
     /** Sets the limit of documents returned in the query. */
     limit?: number;
     /** Set to sort the documents coming back from the query. Array of indexes, `[['a', 1]]` etc. */
@@ -6231,7 +6181,7 @@ declare interface ListCollectionsOptions extends Omit<CommandOperationOptions, '
 }
 
 /** @public */
-declare interface ListDatabasesOptions extends CommandOperationOptions {
+declare interface ListDatabasesOptions extends Omit<CommandOperationOptions, 'rawData'> {
     /** A query predicate that determines which databases are listed */
     filter?: Document_2;
     /** A flag to indicate whether the command should return just the database names, or return both database names and size information */
@@ -6264,6 +6214,7 @@ declare class ListIndexesCursor extends AbstractCursor {
 /** @public */
 declare type ListIndexesOptions = AbstractCursorOptions & {
     /* Excluded from this release type: omitMaxTimeMS */
+    /* Excluded from this release type: rawData */
 };
 
 /** @public */
@@ -6433,7 +6384,7 @@ declare const MONGO_CLIENT_EVENTS: readonly ["connectionPoolCreated", "connectio
  * const client = new MongoClient('mongodb://localhost:27017?appName=mflix', { monitorCommands: true });
  * ```
  */
-declare class MongoClient extends TypedEventEmitter<MongoClientEvents> implements AsyncDisposable_2 {
+declare class MongoClient extends TypedEventEmitter<MongoClientEvents> implements AsyncDisposable {
     /* Excluded from this release type: s */
     /* Excluded from this release type: topology */
     /* Excluded from this release type: mongoLogger */
@@ -6442,10 +6393,16 @@ declare class MongoClient extends TypedEventEmitter<MongoClientEvents> implement
     /**
      * The consolidate, parsed, transformed and merged options.
      */
-    readonly options: Readonly<Omit<MongoOptions, 'monitorCommands' | 'ca' | 'crl' | 'key' | 'cert' | 'driverInfo' | 'additionalDriverInfo' | 'metadata' | 'extendedMetadata'>> & Pick<MongoOptions, 'monitorCommands' | 'ca' | 'crl' | 'key' | 'cert' | 'driverInfo' | 'additionalDriverInfo' | 'metadata' | 'extendedMetadata'>;
+    readonly options: Readonly<Omit<MongoOptions, 'monitorCommands' | 'ca' | 'crl' | 'key' | 'cert' | 'driverInfo'>> & Pick<MongoOptions, 'monitorCommands' | 'ca' | 'crl' | 'key' | 'cert' | 'driverInfo'> & {
+        /* Excluded from this release type: metadata */
+    };
+    private driverInfoList;
     constructor(url: string, options?: MongoClientOptions);
-    /* Excluded from this release type: [Symbol.asyncDispose] */
-    /* Excluded from this release type: asyncDispose */
+    /**
+     * @experimental
+     * An alias for {@link MongoClient.close|MongoClient.close()}.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
     /**
      * Append metadata to the client metadata after instantiation.
      * @param driverInfo - Information about the application or library.
@@ -6469,20 +6426,13 @@ declare class MongoClient extends TypedEventEmitter<MongoClientEvents> implement
      */
     bulkWrite<SchemaMap extends Record<string, Document_2> = Record<string, Document_2>>(models: ReadonlyArray<ClientBulkWriteModel<SchemaMap>>, options?: ClientBulkWriteOptions): Promise<ClientBulkWriteResult>;
     /**
-     * Connect to MongoDB using a url
+     * An optional method to verify a handful of assumptions that are generally useful at application boot-time before using a MongoClient.
+     * For detailed information about the connect process see the MongoClient.connect static method documentation.
      *
-     * @remarks
-     * Calling `connect` is optional since the first operation you perform will call `connect` if it's needed.
-     * `timeoutMS` will bound the time any operation can take before throwing a timeout error.
-     * However, when the operation being run is automatically connecting your `MongoClient` the `timeoutMS` will not apply to the time taken to connect the MongoClient.
-     * This means the time to setup the `MongoClient` does not count against `timeoutMS`.
-     * If you are using `timeoutMS` we recommend connecting your client explicitly in advance of any operation to avoid this inconsistent execution time.
+     * @param url - The MongoDB connection string (supports `mongodb://` and `mongodb+srv://` schemes)
+     * @param options - Optional configuration options for the client
      *
-     * @remarks
-     * The driver will look up corresponding SRV and TXT records if the connection string starts with `mongodb+srv://`.
-     * If those look ups throw a DNS Timeout error, the driver will retry the look up once.
-     *
-     * @see docs.mongodb.org/manual/reference/connection-string/
+     * @see https://www.mongodb.com/docs/manual/reference/connection-string/
      */
     connect(): Promise<this>;
     /* Excluded from this release type: _connect */
@@ -6541,21 +6491,35 @@ declare class MongoClient extends TypedEventEmitter<MongoClientEvents> implement
      */
     db(dbName?: string, options?: DbOptions): Db;
     /**
-     * Connect to MongoDB using a url
+     * Creates a new MongoClient instance and immediately connects it to MongoDB.
+     * This convenience method combines `new MongoClient(url, options)` and `client.connect()` in a single step.
+     *
+     * Connect can be helpful to detect configuration issues early by validating:
+     * - **DNS Resolution**: Verifies that SRV records and hostnames in the connection string resolve DNS entries
+     * - **Network Connectivity**: Confirms that host addresses are reachable and ports are open
+     * - **TLS Configuration**: Validates SSL/TLS certificates, CA files, and encryption settings are correct
+     * - **Authentication**: Verifies that provided credentials are valid
+     * - **Server Compatibility**: Ensures the MongoDB server version is supported by this driver version
+     * - **Load Balancer Setup**: For load-balanced deployments, confirms the service is properly configured
+     *
+     * @returns A promise that resolves to the same MongoClient instance once connected
      *
      * @remarks
-     * Calling `connect` is optional since the first operation you perform will call `connect` if it's needed.
-     * `timeoutMS` will bound the time any operation can take before throwing a timeout error.
-     * However, when the operation being run is automatically connecting your `MongoClient` the `timeoutMS` will not apply to the time taken to connect the MongoClient.
-     * This means the time to setup the `MongoClient` does not count against `timeoutMS`.
-     * If you are using `timeoutMS` we recommend connecting your client explicitly in advance of any operation to avoid this inconsistent execution time.
+     * **Connection is Optional:** Calling `connect` is optional since any operation method (`find`, `insertOne`, etc.)
+     * will automatically perform these same validation steps if the client is not already connected.
+     * However, explicitly calling `connect` can make sense for:
+     * - **Fail-fast Error Detection**: Non-transient connection issues (hostname unresolved, port refused connection) are discovered immediately rather than during your first operation
+     * - **Predictable Performance**: Eliminates first connection overhead from your first database operation
      *
      * @remarks
-     * The programmatically provided options take precedence over the URI options.
+     * **Connection Pooling Impact:** Calling `connect` will populate the connection pool with one connection
+     * to a server selected by the client's configured `readPreference` (defaults to primary).
      *
      * @remarks
-     * The driver will look up corresponding SRV and TXT records if the connection string starts with `mongodb+srv://`.
-     * If those look ups throw a DNS Timeout error, the driver will retry the look up once.
+     * **Timeout Behavior:** When using `timeoutMS`, the connection establishment time does not count against
+     * the timeout for subsequent operations. This means `connect` runs without a `timeoutMS` limit, while
+     * your database operations will still respect the configured timeout. If you need predictable operation
+     * timing with `timeoutMS`, call `connect` explicitly before performing operations.
      *
      * @see https://www.mongodb.com/docs/manual/reference/connection-string/
      */
@@ -6800,7 +6764,10 @@ declare interface MongoClientOptions extends BSONSerializeOptions, SupportedNode
      * If an internal MongoClient is created, it is configured with the same options as the parent MongoClient except minPoolSize is set to 0 and AutoEncryptionOptions is omitted.
      */
     autoEncryption?: AutoEncryptionOptions;
-    /** Allows a wrapping driver to amend the client metadata generated by the driver to include information about the wrapping driver */
+    /**
+     * Allows a wrapping driver to amend the client metadata generated by the driver to include information about the wrapping driver
+     /* @deprecated - Will be made internal in a future major release.
+     */
     driverInfo?: DriverInfo;
     /** Configures a Socks5 proxy host used for creating TCP connections. */
     proxyHost?: string;
@@ -7342,10 +7309,7 @@ declare interface MongoOptions extends Required<Pick<MongoClientOptions, 'autoEn
     compressors: CompressorName[];
     writeConcern: WriteConcern;
     dbName: string;
-    /** @deprecated - Will be made internal in a future major release. */
-    metadata: ClientMetadata;
-    extendedMetadata: Promise<Document_2>;
-    additionalDriverInfo: DriverInfo[];
+    /* Excluded from this release type: metadata */
     /* Excluded from this release type: autoEncrypter */
     /* Excluded from this release type: tokenCache */
     proxyHost?: string;
@@ -7685,7 +7649,7 @@ declare const ProfilingLevel: Readonly<{
 declare type ProfilingLevel = (typeof ProfilingLevel)[keyof typeof ProfilingLevel];
 
 /** @public */
-declare type ProfilingLevelOptions = CommandOperationOptions;
+declare type ProfilingLevelOptions = Omit<CommandOperationOptions, 'rawData'>;
 
 declare type ProxyEventArgs<K extends keyof ProxyEventMap> = ProxyEventMap[K] extends (...args: infer P) => any ? P : never;
 
@@ -7789,16 +7753,16 @@ declare interface RangeOptions {
 }
 
 declare interface Readable_2 {
-    aggregate(database: string, collection: string, pipeline: Document_2[], options?: AggregateOptions, dbOptions?: DbOptions): ServiceProviderAggregationCursor;
-    aggregateDb(database: string, pipeline: Document_2[], options?: AggregateOptions, dbOptions?: DbOptions): ServiceProviderAggregationCursor;
+    aggregate(database: string, collection: string, pipeline: Document_2[], options?: AggregateOptions & Abortable_2, dbOptions?: DbOptions): ServiceProviderAggregationCursor;
+    aggregateDb(database: string, pipeline: Document_2[], options?: AggregateOptions & Abortable_2, dbOptions?: DbOptions): ServiceProviderAggregationCursor;
     count(db: string, coll: string, query?: Document_2, options?: CountOptions, dbOptions?: DbOptions): Promise<number>;
-    countDocuments(database: string, collection: string, filter?: Document_2, options?: CountDocumentsOptions, dbOptions?: DbOptions): Promise<number>;
+    countDocuments(database: string, collection: string, filter?: Document_2, options?: CountDocumentsOptions & Abortable_2, dbOptions?: DbOptions): Promise<number>;
     distinct(database: string, collection: string, fieldName: string, filter?: Document_2, options?: DistinctOptions, dbOptions?: DbOptions): Promise<Document_2>;
     estimatedDocumentCount(database: string, collection: string, options?: EstimatedDocumentCountOptions, dbOptions?: DbOptions): Promise<number>;
-    find(database: string, collection: string, filter?: Document_2, options?: FindOptions, dbOptions?: DbOptions): ServiceProviderFindCursor;
+    find(database: string, collection: string, filter?: Document_2, options?: FindOptions & Abortable_2, dbOptions?: DbOptions): ServiceProviderFindCursor;
     getTopologyDescription(): TopologyDescription_2 | undefined;
     getIndexes(database: string, collection: string, options: ListIndexesOptions, dbOptions?: DbOptions): Promise<Document_2[]>;
-    listCollections(database: string, filter?: Document_2, options?: ListCollectionsOptions, dbOptions?: DbOptions): Promise<Document_2[]>;
+    listCollections(database: string, filter?: Document_2, options?: ListCollectionsOptions & Abortable_2, dbOptions?: DbOptions): Promise<Document_2[]>;
     readPreferenceFromOptions(options?: Omit<ReadPreferenceFromOptions, 'session'>): ReadPreferenceLike | undefined;
     watch(pipeline: Document_2[], options: ChangeStreamOptions, dbOptions?: DbOptions, db?: string, coll?: string): ServiceProviderChangeStream;
     getSearchIndexes(database: string, collection: string, indexName?: string, options?: Document_2, dbOptions?: DbOptions): Promise<Document_2[]>;
@@ -7860,7 +7824,6 @@ declare class ReadPreference {
     tags?: TagSet[];
     hedge?: HedgeOptions;
     maxStalenessSeconds?: number;
-    minWireVersion?: number;
     static PRIMARY: "primary";
     static PRIMARY_PREFERRED: "primaryPreferred";
     static SECONDARY: "secondary";
@@ -7992,13 +7955,18 @@ declare type RemoveShellOptions = DeleteOptions & {
 };
 
 /** @public */
-declare type RemoveUserOptions = CommandOperationOptions;
+declare type RemoveUserOptions = Omit<CommandOperationOptions, 'rawData'>;
 
 /** @public */
-declare interface RenameOptions extends CommandOperationOptions {
+declare interface RenameOptions extends Omit<CommandOperationOptions, 'rawData'> {
     /** Drop the target name collection if it previously exists. */
     dropTarget?: boolean;
-    /** Unclear */
+    /**
+     * @deprecated
+     *
+     * This option has been dead code since at least Node driver version 4.x. It will
+     * be removed in a future major release.
+     */
     new_collection?: boolean;
 }
 
@@ -8565,7 +8533,7 @@ declare type SetFields<TSchema> = ({
 };
 
 /** @public */
-declare type SetProfilingLevelOptions = CommandOperationOptions;
+declare type SetProfilingLevelOptions = Omit<CommandOperationOptions, 'rawData'>;
 
 /**
  * @public
@@ -9206,40 +9174,6 @@ declare interface TopologyVersion {
     counter: Long;
 }
 
-/**
- * @public
- * @deprecated - Will be made internal in a future major release.
- * A class maintaining state related to a server transaction. Internal Only
- */
-declare class Transaction {
-    /* Excluded from this release type: state */
-    /** @deprecated - Will be made internal in a future major release. */
-    options: TransactionOptions;
-    /* Excluded from this release type: _pinnedServer */
-    /* Excluded from this release type: _recoveryToken */
-    /* Excluded from this release type: __constructor */
-    /* Excluded from this release type: server */
-    /** @deprecated - Will be made internal in a future major release. */
-    get recoveryToken(): Document_2 | undefined;
-    /** @deprecated - Will be made internal in a future major release. */
-    get isPinned(): boolean;
-    /**
-     * @deprecated - Will be made internal in a future major release.
-     * @returns Whether the transaction has started
-     */
-    get isStarting(): boolean;
-    /**
-     * @deprecated - Will be made internal in a future major release.
-     * @returns Whether this session is presently in a transaction
-     */
-    get isActive(): boolean;
-    /** @deprecated - Will be made internal in a future major release. */
-    get isCommitted(): boolean;
-    /* Excluded from this release type: transition */
-    /* Excluded from this release type: pinServer */
-    /* Excluded from this release type: unpinServer */
-}
-
 /**
  * Configuration options for a transaction.
  * @public
@@ -9501,7 +9435,7 @@ declare interface UseEvent {
 }
 
 /** @public */
-declare interface ValidateCollectionOptions extends CommandOperationOptions {
+declare interface ValidateCollectionOptions extends Omit<CommandOperationOptions, 'rawData'> {
     /** Validates a collection in the background, without interrupting read or write traffic (only in MongoDB 4.4+) */
     background?: boolean;
 }
@@ -9529,8 +9463,8 @@ declare type WorkspaceDefaults = {
 };
 
 declare interface Writable {
-    runCommand(db: string, spec: Document_2, options: RunCommandOptions, dbOptions?: DbOptions): Promise<Document_2>;
-    runCommandWithCheck(db: string, spec: Document_2, options: RunCommandOptions, dbOptions?: DbOptions): Promise<Document_2>;
+    runCommand(db: string, spec: Document_2, options: RunCommandOptions & Abortable_2, dbOptions?: DbOptions): Promise<Document_2>;
+    runCommandWithCheck(db: string, spec: Document_2, options: RunCommandOptions & Abortable_2, dbOptions?: DbOptions): Promise<Document_2>;
     runCursorCommand(db: string, spec: Document_2, options: RunCursorCommandOptions, dbOptions?: DbOptions): ServiceProviderRunCommandCursor;
     dropDatabase(database: string, options: DropDatabaseOptions, dbOptions?: DbOptions): Promise<Document_2>;
     bulkWrite(database: string, collection: string, requests: AnyBulkWriteOperation[], options: BulkWriteOptions, dbOptions?: DbOptions): Promise<BulkWriteResult>;