@mongosh/shell-api 3.29.0 → 5.0.0

package/lib/api-processed.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>;
@@ -714,14 +718,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 */
@@ -742,7 +738,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";
@@ -761,7 +756,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. */
@@ -884,7 +879,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[];
     /**
@@ -910,7 +905,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.
@@ -1209,6 +1204,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
@@ -1377,23 +1373,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
@@ -1409,7 +1398,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 */
@@ -1470,7 +1458,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 */
@@ -2177,7 +2165,7 @@ declare class ClientEncryption {
    * }
    * ```
    */
-  rewrapManyDataKey(filter: Filter<DataKey>, options: ClientEncryptionRewrapManyDataKeyProviderOptions): Promise<{
+  rewrapManyDataKey(filter: Filter<DataKey>, options?: ClientEncryptionRewrapManyDataKeyProviderOptions): Promise<{
     bulkWriteResult?: BulkWriteResult;
   }>;
   /**
@@ -2570,36 +2558,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';
@@ -2626,7 +2584,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;
@@ -2639,8 +2597,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 */
@@ -2670,8 +2627,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.
    *
@@ -2964,11 +2924,11 @@ declare class Collection<M extends GenericServerSideSchema = GenericServerSideSc
   */
   aggregate(pipeline: MQLPipeline, options: AggregateOptions & {
     explain: ExplainVerbosityLike;
-  }): Document_2;
+  } & Abortable_2): Document_2;
   /*
   Calculates aggregate values for the data in a collection or a view.
   */
-  aggregate(pipeline: MQLPipeline, options?: AggregateOptions): AggregationCursor_2;
+  aggregate(pipeline: MQLPipeline, options?: AggregateOptions & Abortable_2): AggregationCursor_2;
   /*
   Calculates aggregate values for the data in a collection or a view.
   */
@@ -2984,7 +2944,7 @@ declare class Collection<M extends GenericServerSideSchema = GenericServerSideSc
   /*
   Returns the count of documents that match the query for a collection or view.
   */
-  countDocuments(query?: MQLQuery, options?: CountDocumentsOptions): number;
+  countDocuments(query?: MQLQuery, options?: CountDocumentsOptions & Abortable_2): number;
   /*
   Removes all documents that match the filter from a collection.
   */
@@ -3012,7 +2972,9 @@ declare class Collection<M extends GenericServerSideSchema = GenericServerSideSc
   /*
   Selects documents in a collection or view.
   */
-  find(query?: MQLQuery, projection?: Document_2, options?: FindOptions): Cursor;
+  find(query?: MQLQuery, projection?: Document_2, options?: FindOptions & {
+    explain?: ExplainVerbosityLike;
+  } & Abortable_2): Cursor;
   /*
   Modifies and returns a single document.
   */
@@ -3020,7 +2982,7 @@ declare class Collection<M extends GenericServerSideSchema = GenericServerSideSc
   /*
   Selects documents in a collection or view.
   */
-  findOne(query?: MQLQuery, projection?: Document_2, options?: FindOptions): MQLDocument | null;
+  findOne(query?: MQLQuery, projection?: Document_2, options?: FindOptions & Abortable_2): MQLDocument | null;
   /*
   Renames a collection.
   */
@@ -3311,6 +3273,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
@@ -3962,15 +3928,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 {
   value: T;
@@ -4270,9 +4230,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 */
 }
 
@@ -4445,11 +4404,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 */
@@ -4668,12 +4625,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
@@ -4725,15 +4676,15 @@ 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>;
   /*
@@ -4751,11 +4702,11 @@ declare class Database<M extends GenericServerSideSchema = GenericServerSideSche
   /*
   Returns an array of documents with collection information, i.e. collection name and options, for the current database.
   */
-  getCollectionInfos(filter?: Document_2, options?: ListCollectionsOptions): Document_2[];
+  getCollectionInfos(filter?: Document_2, options?: ListCollectionsOptions & Abortable_2): Document_2[];
   /*
   Runs an arbitrary command on the database.
   */
-  runCommand(cmd: string | Document_2, options?: RunCommandOptions): Document_2;
+  runCommand(cmd: string | Document_2, options?: RunCommandOptions & Abortable_2): Document_2;
   /*
   Runs an arbitrary command against the admin database.
   */
@@ -4765,11 +4716,11 @@ declare class Database<M extends GenericServerSideSchema = GenericServerSideSche
   */
   aggregate(pipeline: MQLPipeline, options: AggregateOptions & {
     explain: ExplainVerbosityLike;
-  }): Document_2;
+  } & Abortable_2): Document_2;
   /*
   Runs a specified admin/diagnostic pipeline which does not require an underlying collection.
   */
-  aggregate(pipeline: MQLPipeline, options?: AggregateOptions): AggregationCursor_2;
+  aggregate(pipeline: MQLPipeline, options?: AggregateOptions & Abortable_2): AggregationCursor_2;
   /*
   Runs a specified admin/diagnostic pipeline which does not require an underlying collection.
   */
@@ -5083,7 +5034,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;
@@ -5369,7 +5324,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;
 }
@@ -5458,6 +5413,7 @@ declare interface DevtoolsConnectOptions extends MongoClientOptions {
   parentHandle?: string;
   proxy?: DevtoolsProxyOptions | AgentWithInitialize;
   applyProxyToOIDC?: boolean | DevtoolsProxyOptions | AgentWithInitialize;
+  useSystemCA?: boolean;
 }
 declare interface DevtoolsProxyOptions {
   proxy?: string;
@@ -5496,7 +5452,7 @@ declare interface DriverInfo {
 }
 
 /** @public */
-declare interface DropCollectionOptions extends CommandOperationOptions {
+declare interface DropCollectionOptions extends Omit<CommandOperationOptions, 'rawData'> {
   /** @experimental */
   encryptedFields?: Document_2;
 }
@@ -5586,7 +5542,9 @@ declare class Explainable extends ShellApiWithMongoClass {
   /*
   Returns information on the query plan.
   */
-  find(query?: MQLQuery, projection?: Document_2, options?: FindOptions): ExplainableCursor_2;
+  find(query?: MQLQuery, projection?: Document_2, options?: FindOptions & {
+    explain?: ExplainVerbosityLike;
+  }): ExplainableCursor_2;
   /*
   Provides information on the query plan for db.collection.aggregate() method.
   */
@@ -6037,14 +5995,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}.
@@ -6077,9 +6028,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. */
@@ -6818,7 +6768,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 */
@@ -6851,6 +6801,7 @@ declare class ListIndexesCursor extends AbstractCursor {
 /** @public */
 declare type ListIndexesOptions = AbstractCursorOptions & {
   /* Excluded from this release type: omitMaxTimeMS */
+  /* Excluded from this release type: rawData */
 };
 
 /** @public */
@@ -7094,7 +7045,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 */
@@ -7103,10 +7054,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.
@@ -7130,20 +7087,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 */
@@ -7202,21 +7152,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/
    */
@@ -7461,7 +7425,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;
@@ -8002,10 +7969,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;
@@ -8347,7 +8311,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;
 declare interface ProxyEventMap {
   'socks5:authentication-complete': (ev: {
@@ -8441,16 +8405,16 @@ declare interface RangeOptions {
   precision?: number;
 }
 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[]>;
@@ -8512,7 +8476,6 @@ declare class ReadPreference {
   tags?: TagSet[];
   hedge?: HedgeOptions;
   maxStalenessSeconds?: number;
-  minWireVersion?: number;
   static PRIMARY: "primary";
   static PRIMARY_PREFERRED: "primaryPreferred";
   static SECONDARY: "secondary";
@@ -8643,13 +8606,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;
 }
 
@@ -9289,7 +9257,7 @@ declare type SetFields<TSchema> = ({ readonly [key in KeysOfAType<TSchema, Reado
 };
 
 /** @public */
-declare type SetProfilingLevelOptions = CommandOperationOptions;
+declare type SetProfilingLevelOptions = Omit<CommandOperationOptions, 'rawData'>;
 
 /**
  * @public
@@ -10156,40 +10124,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
@@ -10449,7 +10383,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;
 }
@@ -10475,8 +10409,8 @@ declare type WorkspaceDefaults = {
   maxTierSize: string;
 };
 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>;