mongodb 7.7.0 → 7.8.0

package/mongodb.d.ts

@@ -146,8 +146,11 @@ export declare abstract class AbstractCursor<TSchema = any, CursorEvents extends
     forEach(iterator: (doc: TSchema) => boolean | void): Promise<void>;
     /**
      * Frees any client-side resources used by the cursor.
+     *
+     * @param _options - `timeoutMS` is deprecated and has no effect
      */
-    close(options?: {
+    close(_options?: {
+        /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
         timeoutMS?: number;
     }): Promise<void>;
     /**
@@ -295,36 +298,14 @@ export declare interface AbstractCursorOptions extends BSONSerializeOptions {
      */
     awaitData?: boolean;
     noCursorTimeout?: boolean;
-    /** Specifies the time an operation will run until it throws a timeout error. See {@link AbstractCursorOptions.timeoutMode} for more details on how this option applies to cursors. */
+    /**
+     * Specifies the time an operation will run until it throws a timeout error.
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
+     */
     timeoutMS?: number;
     /**
-     * @public
-     * @experimental
-     * Specifies how `timeoutMS` is applied to the cursor. Can be either `'cursorLifeTime'` or `'iteration'`
-     * When set to `'iteration'`, the deadline specified by `timeoutMS` applies to each call of
-     * `cursor.next()`.
-     * When set to `'cursorLifetime'`, the deadline applies to the life of the entire cursor.
-     *
-     * Depending on the type of cursor being used, this option has different default values.
-     * For non-tailable cursors, this value defaults to `'cursorLifetime'`
-     * For tailable cursors, this value defaults to `'iteration'` since tailable cursors, by
-     * definition can have an arbitrarily long lifetime.
-     *
-     * @example
-     * ```ts
-     * const cursor = collection.find({}, {timeoutMS: 100, timeoutMode: 'iteration'});
-     * for await (const doc of cursor) {
-     *  // process doc
-     *  // This will throw a timeout error if any of the iterator's `next()` calls takes more than 100ms, but
-     *  // will continue to iterate successfully otherwise, regardless of the number of batches.
-     * }
-     * ```
-     *
-     * @example
-     * ```ts
-     * const cursor = collection.find({}, { timeoutMS: 1000, timeoutMode: 'cursorLifetime' });
-     * const docs = await cursor.toArray(); // This entire line will throw a timeout error if all batches are not fetched and returned within 1000ms.
-     * ```
+     * Specifies how `timeoutMS` is applied to the cursor.
+     * @deprecated `timeoutMode` has no effect and will be removed in a future release.
      */
     timeoutMode?: CursorTimeoutMode;
     /* Excluded from this release type: timeoutContext */
@@ -1891,9 +1872,7 @@ export declare class ClientEncryption {
      * }
      * ```
      */
-    rewrapManyDataKey(filter: Filter<DataKey>, options?: ClientEncryptionRewrapManyDataKeyProviderOptions): Promise<{
-        bulkWriteResult?: BulkWriteResult;
-    }>;
+    rewrapManyDataKey(filter: Filter<DataKey>, options?: ClientEncryptionRewrapManyDataKeyProviderOptions): Promise<ClientEncryptionRewrapManyDataKeyResult>;
     /**
      * Deletes the key with the provided id from the keyvault, if it exists.
      *
@@ -2101,7 +2080,7 @@ export declare interface ClientEncryptionCreateDataKeyProviderOptions {
      * If a key is created with alternate names, then encryption may refer to the key by the unique alternate name instead of by _id.
      */
     keyAltNames?: string[] | undefined;
-    /** @experimental */
+    /** Optional 96-byte custom key material used when creating a data key instead of libmongocrypt’s random material. **/
     keyMaterial?: Buffer | Binary;
     /* Excluded from this release type: timeoutContext */
 }
@@ -2201,42 +2180,15 @@ export declare interface ClientEncryptionOptions {
      */
     keyExpirationMS?: number;
     /**
-     * @experimental
-     *
      * The timeout setting to be used for all the operations on ClientEncryption.
-     *
-     * When provided, `timeoutMS` is used as the timeout for each operation executed on
-     * the ClientEncryption object.  For example:
-     *
-     * ```typescript
-     * const clientEncryption = new ClientEncryption(client, {
-     *  timeoutMS: 1_000
-     *  kmsProviders: { local: { key: '<KEY>' } }
-     * });
-     *
-     * // `1_000` is used as the timeout for createDataKey call
-     * await clientEncryption.createDataKey('local');
-     * ```
-     *
-     * If `timeoutMS` is configured on the provided client, the client's `timeoutMS` value
-     * will be used unless `timeoutMS` is also provided as a client encryption option.
-     *
-     * ```typescript
-     * const client = new MongoClient('<uri>', { timeoutMS: 2_000 });
-     *
-     * // timeoutMS is set to 1_000 on clientEncryption
-     * const clientEncryption = new ClientEncryption(client, {
-     *  timeoutMS: 1_000
-     *  kmsProviders: { local: { key: '<KEY>' } }
-     * });
-     * ```
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
 }
 
 /**
  * @public
- * @experimental
+ * Options interface for `rewrapManyDataKey`; selects the new KMS provider/masterKey for bulk key rotation.
  */
 export declare interface ClientEncryptionRewrapManyDataKeyProviderOptions {
     provider: ClientEncryptionDataKeyProvider;
@@ -2245,7 +2197,7 @@ export declare interface ClientEncryptionRewrapManyDataKeyProviderOptions {
 
 /**
  * @public
- * @experimental
+ * Public result shape describing the `bulkWriteResult` produced by `rewrapManyDataKey`.
  */
 export declare interface ClientEncryptionRewrapManyDataKeyResult {
     /** The result of rewrapping data keys. If unset, no keys matched the filter. */
@@ -2337,8 +2289,8 @@ export declare class ClientSession extends TypedEventEmitter<ClientSessionEvents
     /* Excluded from this release type: pinnedConnection */
     /* Excluded from this release type: txnNumberIncrement */
     /**
-     * @experimental
      * Specifies the time an operation in a given `ClientSession` will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
     /* Excluded from this release type: timeoutContext */
@@ -2406,9 +2358,10 @@ export declare class ClientSession extends TypedEventEmitter<ClientSessionEvents
     /**
      * Commits the currently active transaction in this session.
      *
-     * @param options - Optional options, can be used to override `defaultTimeoutMS`.
+     * @param _options - `timeoutMS` is deprecated and has no effect.
      */
-    commitTransaction(options?: {
+    commitTransaction(_options?: {
+        /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
         timeoutMS?: number;
     }): Promise<void>;
     /**
@@ -2462,10 +2415,7 @@ export declare class ClientSession extends TypedEventEmitter<ClientSessionEvents
     withTransaction<T = any>(fn: WithTransactionCallback<T>, options?: TransactionOptions & {
         /**
          * Configures a timeoutMS expiry for the entire withTransactionCallback.
-         *
-         * @remarks
-         * - The remaining timeout will not be applied to callback operations that do not use the ClientSession.
-         * - Overriding timeoutMS for operations executed using the explicit session inside the provided callback will result in a client-side error.
+         * @deprecated `timeoutMS` has no effect and will be removed in a future release.
          */
         timeoutMS?: number;
     }): Promise<T>;
@@ -2486,9 +2436,8 @@ export declare interface ClientSessionOptions {
     defaultTransactionOptions?: TransactionOptions;
     /**
      * @public
-     * @experimental
      * An overriding timeoutMS value to use for a client-side timeout.
-     * If not provided the session uses the timeoutMS specified on the MongoClient.
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     defaultTimeoutMS?: number;
     /* Excluded from this release type: owner */
@@ -2689,6 +2638,7 @@ export declare class Collection<TSchema extends Document = Document> {
     /** The current index hint for the collection */
     get hint(): Hint | undefined;
     set hint(v: Hint | undefined);
+    /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
     get timeoutMS(): number | undefined;
     /**
      * Inserts a single document into MongoDB. If documents passed in do not contain the **_id** field,
@@ -2828,7 +2778,7 @@ export declare class Collection<TSchema extends Document = Document> {
      * Creates an index on the db and collection collection.
      *
      * @param indexSpec - The field name or index specification to create an index for
-     * @param options - Optional settings for the command
+     * @param indexOptions - Optional settings for the command
      *
      * @example
      * ```ts
@@ -2851,8 +2801,22 @@ export declare class Collection<TSchema extends Document = Document> {
      * // Equivalent to { j: 1, k: -1, l: 2d }
      * await collection.createIndex(['j', ['k', -1], { l: '2d' }])
      * ```
+     * @deprecated Use the three parameter overload, which separates index options from
+     *   command options. This overload will be removed in a future major release.
      */
     createIndex(indexSpec: IndexSpecification, options?: CreateIndexesOptions): Promise<string>;
+    /**
+     * Creates an index on the db and collection collection.
+     *
+     * Options for the index itself are given in `indexOptions`, and options for the
+     * `createIndexes` command are given separately in `commandOptions`. Unknown fields in
+     * `indexOptions` are passed through to the server for validation rather than being dropped.
+     *
+     * @param keys - The field name or index specification to create an index for
+     * @param indexOptions - Settings for the index, or `undefined` if there are none
+     * @param commandOptions - Settings for the `createIndexes` command, or `undefined` if there are none
+     */
+    createIndex(keys: IndexSpecification, indexOptions: IndexOptions | undefined, commandOptions: CreateIndexOptions | undefined): Promise<string>;
     /**
      * Creates multiple indexes in the collection, this method is only supported for
      * MongoDB 2.6 or higher. Earlier version of MongoDB will throw a command not supported
@@ -2862,7 +2826,7 @@ export declare class Collection<TSchema extends Document = Document> {
      * Index specifications are defined {@link https://www.mongodb.com/docs/manual/reference/command/createIndexes/| here}.
      *
      * @param indexSpecs - An array of index specifications to be created
-     * @param options - Optional settings for the command
+     * @param commandOptions - Optional settings for the `createIndexes` command
      *
      * @example
      * ```ts
@@ -2884,7 +2848,21 @@ export declare class Collection<TSchema extends Document = Document> {
      * ]);
      * ```
      */
-    createIndexes(indexSpecs: IndexDescription[], options?: CreateIndexesOptions): Promise<string[]>;
+    createIndexes(indexSpecs: IndexDescription[], commandOptions?: CreateIndexesOptions): Promise<string[]>;
+    /**
+     * Creates multiple indexes in the collection, opting into "pass through" behavior for index
+     * options the driver does not recognise.
+     *
+     * @param indexSpecs - An array of index specifications to be created
+     * @param commandOptions - Optional settings for the `createIndexes` command
+     * @param allowUnknownIndexOptions - When `true`, index options the driver does not recognise are
+     *   sent to the server instead of being dropped, for the server to validate.
+     *
+     * @deprecated Used to opt into "pass through" behavior, where options will be validated by the
+     *   server rather than the driver. In a future release this overload will be removed and the
+     *   default behavior will change from `false` to `true`.
+     */
+    createIndexes(indexSpecs: IndexDescription[], commandOptions: CreateIndexesOptions | undefined, allowUnknownIndexOptions: boolean): Promise<string[]>;
     /**
      * Drops an index from this collection.
      *
@@ -3087,60 +3065,6 @@ export declare class Collection<TSchema extends Document = Document> {
      *     expectType<Schema>(change.fullDocument);
      *   });
      * ```
-     *
-     * @remarks
-     * When `timeoutMS` is configured for a change stream, it will have different behaviour depending
-     * on whether the change stream is in iterator mode or emitter mode. In both cases, a change
-     * stream will time out if it does not receive a change event within `timeoutMS` of the last change
-     * event.
-     *
-     * Note that if a change stream is consistently timing out when watching a collection, database or
-     * client that is being changed, then this may be due to the server timing out before it can finish
-     * processing the existing oplog. To address this, restart the change stream with a higher
-     * `timeoutMS`.
-     *
-     * If the change stream times out the initial aggregate operation to establish the change stream on
-     * the server, then the client will close the change stream. If the getMore calls to the server
-     * time out, then the change stream will be left open, but will throw a MongoOperationTimeoutError
-     * when in iterator mode and emit an error event that returns a MongoOperationTimeoutError in
-     * emitter mode.
-     *
-     * To determine whether or not the change stream is still open following a timeout, check the
-     * {@link ChangeStream.closed} getter.
-     *
-     * @example
-     * In iterator mode, if a next() call throws a timeout error, it will attempt to resume the change stream.
-     * The next call can just be retried after this succeeds.
-     * ```ts
-     * const changeStream = collection.watch([], { timeoutMS: 100 });
-     * try {
-     *     await changeStream.next();
-     * } catch (e) {
-     *     if (e instanceof MongoOperationTimeoutError && !changeStream.closed) {
-     *       await changeStream.next();
-     *     }
-     *     throw e;
-     * }
-     * ```
-     *
-     * @example
-     * In emitter mode, if the change stream goes `timeoutMS` without emitting a change event, it will
-     * emit an error event that returns a MongoOperationTimeoutError, but will not close the change
-     * stream unless the resume attempt fails. There is no need to re-establish change listeners as
-     * this will automatically continue emitting change events once the resume attempt completes.
-     *
-     * ```ts
-     * const changeStream = collection.watch([], { timeoutMS: 100 });
-     * changeStream.on('change', console.log);
-     * changeStream.on('error', e => {
-     *     if (e instanceof MongoOperationTimeoutError && !changeStream.closed) {
-     *         // do nothing
-     *     } else {
-     *         changeStream.close();
-     *     }
-     * });
-     * ```
-     *
      * @param pipeline - An array of {@link https://www.mongodb.com/docs/manual/reference/operator/aggregation-pipeline/|aggregation pipeline stages} through which to pass change stream documents. This allows for filtering (using $match) and manipulating the change stream documents.
      * @param options - Optional settings for the command
      * @typeParam TLocal - Type of the data being detected by the change stream
@@ -3252,8 +3176,8 @@ export declare interface CollectionOptions extends BSONSerializeOptions, WriteCo
     /** The preferred read preference (ReadPreference.PRIMARY, ReadPreference.PRIMARY_PREFERRED, ReadPreference.SECONDARY, ReadPreference.SECONDARY_PREFERRED, ReadPreference.NEAREST). */
     readPreference?: ReadPreferenceLike;
     /**
-     * @experimental
      * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
 }
@@ -3708,7 +3632,7 @@ export declare interface CreateCollectionOptions extends Omit<CommandOperationOp
     clusteredIndex?: ClusteredCollectionOptions;
     /** The number of seconds after which a document in a timeseries or clustered collection expires. */
     expireAfterSeconds?: number;
-    /** @experimental */
+    /** Queryable Encryption field schema attached at collection creation. **/
     encryptedFields?: Document;
     /**
      * If set, enables pre-update and post-update document events to be included for any
@@ -3753,6 +3677,27 @@ export declare interface CreateIndexesOptions extends Omit<CommandOperationOptio
     wildcardProjection?: Document;
     /** Specifies that the index should exist on the target collection but should not be used by the query planner when executing operations. */
     hidden?: boolean;
+    /** Collation */
+    collation?: CollationOptions;
+}
+
+/** @public */
+export declare interface CreateIndexOptions extends Omit<CommandOperationOptions, 'collation' | 'explain'> {
+    /**
+     * Specifies how many data-bearing members of a replica set, including the primary, must
+     * complete the index builds successfully before the primary marks the indexes as ready.
+     *
+     * This option accepts the same values for the "w" field in a write concern plus "votingMembers",
+     * which indicates all voting data-bearing nodes.
+     *
+     * This option is only supported by servers \>= 4.4. Drivers MUST manually raise an error if this option
+     * is specified when creating an index on a pre 4.4 server. See the Q&A section for the rationale behind this.
+     *
+     * @remarks This option is sent only if the caller explicitly provides a value. The default is to not send a value.
+     *
+     * @sinceServerVersion 4.4
+     */
+    commitQuorum?: number | string;
 }
 
 /**
@@ -3789,32 +3734,8 @@ export declare type CursorFlag = (typeof CURSOR_FLAGS)[number];
 
 /**
  * @public
- * @experimental
- * Specifies how `timeoutMS` is applied to the cursor. Can be either `'cursorLifeTime'` or `'iteration'`
- * When set to `'iteration'`, the deadline specified by `timeoutMS` applies to each call of
- * `cursor.next()`.
- * When set to `'cursorLifetime'`, the deadline applies to the life of the entire cursor.
- *
- * Depending on the type of cursor being used, this option has different default values.
- * For non-tailable cursors, this value defaults to `'cursorLifetime'`
- * For tailable cursors, this value defaults to `'iteration'` since tailable cursors, by
- * definition can have an arbitrarily long lifetime.
- *
- * @example
- * ```ts
- * const cursor = collection.find({}, {timeoutMS: 100, timeoutMode: 'iteration'});
- * for await (const doc of cursor) {
- *  // process doc
- *  // This will throw a timeout error if any of the iterator's `next()` calls takes more than 100ms, but
- *  // will continue to iterate successfully otherwise, regardless of the number of batches.
- * }
- * ```
- *
- * @example
- * ```ts
- * const cursor = collection.find({}, { timeoutMS: 1000, timeoutMode: 'cursorLifetime' });
- * const docs = await cursor.toArray(); // This entire line will throw a timeout error if all batches are not fetched and returned within 1000ms.
- * ```
+ * Specifies how `timeoutMS` is applied to the cursor.
+ * @deprecated `timeoutMode` has no effect and will be removed in a future release.
  */
 export declare const CursorTimeoutMode: Readonly<{
     readonly ITERATION: "iteration";
@@ -3823,7 +3744,7 @@ export declare const CursorTimeoutMode: Readonly<{
 
 /**
  * @public
- * @experimental
+ * @deprecated `timeoutMode` has no effect and will be removed in a future release.
  */
 export declare type CursorTimeoutMode = (typeof CursorTimeoutMode)[keyof typeof CursorTimeoutMode];
 
@@ -3902,6 +3823,7 @@ export declare class Db {
     get bsonOptions(): BSONSerializeOptions;
     get writeConcern(): WriteConcern | undefined;
     get namespace(): string;
+    /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
     get timeoutMS(): number | undefined;
     /**
      * Create a new collection on a server with the specified options. Use this to create capped collections.
@@ -4057,59 +3979,6 @@ export declare class Db {
      * watch() accepts two generic arguments for distinct use cases:
      * - The first is to provide the schema that may be defined for all the collections within this database
      * - The second is to override the shape of the change stream document entirely, if it is not provided the type will default to ChangeStreamDocument of the first argument
-     *
-     * @remarks
-     * When `timeoutMS` is configured for a change stream, it will have different behaviour depending
-     * on whether the change stream is in iterator mode or emitter mode. In both cases, a change
-     * stream will time out if it does not receive a change event within `timeoutMS` of the last change
-     * event.
-     *
-     * Note that if a change stream is consistently timing out when watching a collection, database or
-     * client that is being changed, then this may be due to the server timing out before it can finish
-     * processing the existing oplog. To address this, restart the change stream with a higher
-     * `timeoutMS`.
-     *
-     * If the change stream times out the initial aggregate operation to establish the change stream on
-     * the server, then the client will close the change stream. If the getMore calls to the server
-     * time out, then the change stream will be left open, but will throw a MongoOperationTimeoutError
-     * when in iterator mode and emit an error event that returns a MongoOperationTimeoutError in
-     * emitter mode.
-     *
-     * To determine whether or not the change stream is still open following a timeout, check the
-     * {@link ChangeStream.closed} getter.
-     *
-     * @example
-     * In iterator mode, if a next() call throws a timeout error, it will attempt to resume the change stream.
-     * The next call can just be retried after this succeeds.
-     * ```ts
-     * const changeStream = collection.watch([], { timeoutMS: 100 });
-     * try {
-     *     await changeStream.next();
-     * } catch (e) {
-     *     if (e instanceof MongoOperationTimeoutError && !changeStream.closed) {
-     *       await changeStream.next();
-     *     }
-     *     throw e;
-     * }
-     * ```
-     *
-     * @example
-     * In emitter mode, if the change stream goes `timeoutMS` without emitting a change event, it will
-     * emit an error event that returns a MongoOperationTimeoutError, but will not close the change
-     * stream unless the resume attempt fails. There is no need to re-establish change listeners as
-     * this will automatically continue emitting change events once the resume attempt completes.
-     *
-     * ```ts
-     * const changeStream = collection.watch([], { timeoutMS: 100 });
-     * changeStream.on('change', console.log);
-     * changeStream.on('error', e => {
-     *     if (e instanceof MongoOperationTimeoutError && !changeStream.closed) {
-     *         // do nothing
-     *     } else {
-     *         changeStream.close();
-     *     }
-     * });
-     * ```
      * @param pipeline - An array of {@link https://www.mongodb.com/docs/manual/reference/operator/aggregation-pipeline/|aggregation pipeline stages} through which to pass change stream documents. This allows for filtering (using $match) and manipulating the change stream documents.
      * @param options - Optional settings for the command
      * @typeParam TSchema - Type of the data being detected by the change stream
@@ -4145,8 +4014,8 @@ export declare interface DbOptions extends BSONSerializeOptions, WriteConcernOpt
     /** Should retry failed writes */
     retryWrites?: boolean;
     /**
-     * @experimental
      * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
 }
@@ -4246,7 +4115,7 @@ export declare interface DriverInfo {
 
 /** @public */
 export declare interface DropCollectionOptions extends Omit<CommandOperationOptions, 'rawData'> {
-    /** @experimental */
+    /** Queryable Encryption field schema used during collection drop so associated state collections are dropped too. **/
     encryptedFields?: Document;
 }
 
@@ -4265,7 +4134,10 @@ export declare interface EndSessionOptions {
     /* Excluded from this release type: error */
     force?: boolean;
     forceClear?: boolean;
-    /** Specifies the time an operation will run until it throws a timeout error */
+    /**
+     * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
+     */
     timeoutMS?: number;
 }
 
@@ -4854,7 +4726,8 @@ export declare class GridFSBucket extends TypedEventEmitter<GridFSBucketEvents>
      * @param id - The id of the file doc
      */
     delete(id: ObjectId, options?: {
-        timeoutMS: number;
+        /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
+        timeoutMS?: number;
     }): Promise<void>;
     /** Convenience wrapper around find on the files collection */
     find(filter?: Filter<GridFSFile>, options?: FindOptions): FindCursor<GridFSFile>;
@@ -4873,11 +4746,13 @@ export declare class GridFSBucket extends TypedEventEmitter<GridFSBucketEvents>
      * @param filename - new name for the file
      */
     rename(id: ObjectId, filename: string, options?: {
-        timeoutMS: number;
+        /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
+        timeoutMS?: number;
     }): Promise<void>;
     /** Removes this bucket's files collection, followed by its chunks collection. */
     drop(options?: {
-        timeoutMS: number;
+        /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
+        timeoutMS?: number;
     }): Promise<void>;
 }
 
@@ -4895,9 +4770,9 @@ export declare interface GridFSBucketOptions extends WriteConcernOptions {
     /** Read preference to be passed to read operations */
     readPreference?: ReadPreference;
     /**
-     * @experimental
      * Specifies the lifetime duration of a gridFS stream. If any async operations are in progress
      * when this timeout expires, the stream will throw a timeout error.
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
 }
@@ -4957,8 +4832,8 @@ export declare interface GridFSBucketReadStreamOptions {
      */
     end?: number;
     /**
-     * @experimental
      * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
 }
@@ -5052,8 +4927,8 @@ export declare interface GridFSBucketWriteStreamOptions extends WriteConcernOpti
     /** Object to store in the file document's `metadata` field */
     metadata?: Document;
     /**
-     * @experimental
      * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
 }
@@ -5148,7 +5023,11 @@ export declare interface IdPServerResponse {
     refreshToken?: string;
 }
 
-/** @public */
+/**
+ * @public
+ *
+ * Loosely aligns with `IndexModel` from the spec.
+ * */
 export declare interface IndexDescription extends Pick<CreateIndexesOptions, 'background' | 'unique' | 'partialFilterExpression' | 'sparse' | 'hidden' | 'expireAfterSeconds' | 'storageEngine' | 'version' | 'weights' | 'default_language' | 'language_override' | 'textIndexVersion' | '2dsphereIndexVersion' | 'bits' | 'min' | 'max' | 'bucketSize' | 'wildcardProjection'> {
     collation?: CollationOptions;
     name?: string;
@@ -5197,6 +5076,103 @@ export declare interface IndexInformationOptions extends ListIndexesOptions {
     full?: boolean;
 }
 
+/** @public */
+export declare interface IndexOptions extends Document {
+    /**
+     * Optionally specifies the length in time, in seconds, for documents to remain in
+     * a collection.
+     */
+    expireAfterSeconds?: number;
+    /**
+     * Optionally specify a specific name for the index outside of the default generated
+     * name. If none is provided then the name is generated in the format "[field]_[direction]".
+     *
+     * Note that if an index is created for the same key pattern with different collations,
+     * a name must be provided by the user to avoid ambiguity.
+     *
+     * @example For an index of name: 1, age: -1, the generated name would be "name_1_age_-1".
+     */
+    name?: string;
+    /**
+     * Optionally tells the index to only reference documents with the specified field in
+     * the index.
+     */
+    sparse?: boolean;
+    /**
+     * Optionally allows users to configure the storage engine on a per-index basis when creating
+     * an index.
+     */
+    storageEngine?: Document;
+    /**
+     * Optionally forces the index to be unique.
+     */
+    unique?: boolean;
+    /**
+     * Optionally specifies the index version number, either 0 or 1.
+     */
+    version?: number;
+    /**
+     * Optionally specifies the default language for text indexes.
+     * Is 'english' if none is provided.
+     */
+    defaultLanguage?: string;
+    /**
+     * Optionally Specifies the field in the document to override the language.
+     */
+    languageOverride?: string;
+    /**
+     * Optionally provides the text index version number.
+     */
+    textIndexVersion?: number;
+    /**
+     * Optionally specifies fields in the index and their corresponding weight values.
+     */
+    weights?: Document;
+    /**
+     * Optionally specifies the 2dsphere index version number.
+     */
+    '2dsphereIndexVersion'?: number;
+    /**
+     * Optionally specifies the precision of the stored geo hash in the 2d index, from 1 to 32.
+     */
+    bits?: number;
+    /**
+     * Optionally sets the maximum boundary for latitude and longitude in the 2d index.
+     */
+    max?: number;
+    /**
+     * Optionally sets the minimum boundary for latitude and longitude in the index in a
+     * 2d index.
+     */
+    min?: number;
+    /**
+     * Optionally specifies the number of units within which to group the location values
+     * in a geo haystack index.
+     */
+    bucketSize?: number;
+    /**
+     * Optionally specifies a filter for use in a partial index. Only documents that match the
+     * filter expression are included in the index.
+     */
+    partialFilterExpression?: Document;
+    /**
+     * Optionally specifies a collation to use for the index. If not specified, no collation is
+     * sent and the default collation of the collection server-side is used.
+     */
+    collation?: CollationOptions;
+    /**
+     * Optionally specifies the wildcard projection of a wildcard index.
+     */
+    wildcardProjection?: Document;
+    /**
+     * Optionally specifies that the index should exist on the target collection but should not be used by the query
+     * planner when executing operations.
+     *
+     * This option is only supported by servers \>= 4.4.
+     */
+    hidden?: boolean;
+}
+
 /** @public */
 export declare type IndexSpecification = OneOrMore<string | [string, IndexDirection] | {
     [key: string]: IndexDirection;
@@ -5356,6 +5332,7 @@ export declare interface KMIPKMSProviderConfiguration {
 export declare type KMSConnectCallback = (options: {
     host: string;
     port: number;
+    /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
     timeoutMS?: number;
     signal: AbortSignal;
 }) => Promise<Duplex>;
@@ -5773,6 +5750,7 @@ export declare class MongoClient extends TypedEventEmitter<MongoClientEvents> im
     get writeConcern(): WriteConcern | undefined;
     get readPreference(): ReadPreference;
     get bsonOptions(): BSONSerializeOptions;
+    /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
     get timeoutMS(): number | undefined;
     /**
      * Executes a client bulk write operation, available on server 8.0+.
@@ -5871,12 +5849,6 @@ export declare class MongoClient extends TypedEventEmitter<MongoClientEvents> im
      * **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
-     * **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/
      */
     static connect(url: string, options?: MongoClientOptions): Promise<MongoClient>;
@@ -5907,59 +5879,6 @@ export declare class MongoClient extends TypedEventEmitter<MongoClientEvents> im
      * watch() accepts two generic arguments for distinct use cases:
      * - The first is to provide the schema that may be defined for all the data within the current cluster
      * - The second is to override the shape of the change stream document entirely, if it is not provided the type will default to ChangeStreamDocument of the first argument
-     *
-     * @remarks
-     * When `timeoutMS` is configured for a change stream, it will have different behaviour depending
-     * on whether the change stream is in iterator mode or emitter mode. In both cases, a change
-     * stream will time out if it does not receive a change event within `timeoutMS` of the last change
-     * event.
-     *
-     * Note that if a change stream is consistently timing out when watching a collection, database or
-     * client that is being changed, then this may be due to the server timing out before it can finish
-     * processing the existing oplog. To address this, restart the change stream with a higher
-     * `timeoutMS`.
-     *
-     * If the change stream times out the initial aggregate operation to establish the change stream on
-     * the server, then the client will close the change stream. If the getMore calls to the server
-     * time out, then the change stream will be left open, but will throw a MongoOperationTimeoutError
-     * when in iterator mode and emit an error event that returns a MongoOperationTimeoutError in
-     * emitter mode.
-     *
-     * To determine whether or not the change stream is still open following a timeout, check the
-     * {@link ChangeStream.closed} getter.
-     *
-     * @example
-     * In iterator mode, if a next() call throws a timeout error, it will attempt to resume the change stream.
-     * The next call can just be retried after this succeeds.
-     * ```ts
-     * const changeStream = collection.watch([], { timeoutMS: 100 });
-     * try {
-     *     await changeStream.next();
-     * } catch (e) {
-     *     if (e instanceof MongoOperationTimeoutError && !changeStream.closed) {
-     *       await changeStream.next();
-     *     }
-     *     throw e;
-     * }
-     * ```
-     *
-     * @example
-     * In emitter mode, if the change stream goes `timeoutMS` without emitting a change event, it will
-     * emit an error event that returns a MongoOperationTimeoutError, but will not close the change
-     * stream unless the resume attempt fails. There is no need to re-establish change listeners as
-     * this will automatically continue emitting change events once the resume attempt completes.
-     *
-     * ```ts
-     * const changeStream = collection.watch([], { timeoutMS: 100 });
-     * changeStream.on('change', console.log);
-     * changeStream.on('error', e => {
-     *     if (e instanceof MongoOperationTimeoutError && !changeStream.closed) {
-     *         // do nothing
-     *     } else {
-     *         changeStream.close();
-     *     }
-     * });
-     * ```
      * @param pipeline - An array of {@link https://www.mongodb.com/docs/manual/reference/operator/aggregation-pipeline/|aggregation pipeline stages} through which to pass change stream documents. This allows for filtering (using $match) and manipulating the change stream documents.
      * @param options - Optional settings for the command
      * @typeParam TSchema - Type of the data being detected by the change stream
@@ -6081,8 +6000,8 @@ export declare interface MongoClientOptions extends BSONSerializeOptions, Suppor
     /** Specifies the name of the replica set, if the mongod is a member of a replica set. */
     replicaSet?: string;
     /**
-     * @experimental
      * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
     /** Enables or disables TLS/SSL for the connection. */
@@ -6121,6 +6040,46 @@ export declare interface MongoClientOptions extends BSONSerializeOptions, Suppor
      * Querying this DNS URI is expected to respond with SRV records
      */
     srvServiceName?: string;
+    /**
+     * A host name suffix that every host returned by the SRV lookup must end with. It replaces the
+     * default verification, which requires returned hosts to share the parent domain of the SRV host
+     * name (the SRV host name without its leftmost label). Only valid with a `mongodb+srv` connection
+     * string, and cannot be combined with `srvHostValidator`.
+     *
+     * For example, with `mongodb+srv://cluster.mongodb.mydomain.net`, the default verification
+     * rejects `host1.us-east-1.mydomain.net`, while `srvAllowedHostsSuffix: '.mydomain.net'` accepts
+     * it. A leading `.` is optional. Internationalized domain names may be given in Unicode or in
+     * A-label (`xn--`) form: the value is converted to lowercase A-label form, and a value that cannot
+     * be converted is an error. The value must contain at least two labels, unless it is one of the
+     * names reserved for private or special use: `test`, `localhost`, `invalid`, `example`, `local`,
+     * `internal`, `corp`, `home`, or `mail`.
+     *
+     * **WARNING: Modifying the default SRV domain name validation can create vulnerabilities.**
+     * SRV host verification prevents a spoofed DNS response from directing the driver to arbitrary
+     * hosts, and this option widens the set of hosts such a response can direct it to. Configure the
+     * narrowest suffix that covers your deployment: for a seed of
+     * `cluster.test.internal.example.com`, prefer `.internal.example.com` over `.example.com`.
+     */
+    srvAllowedHostsSuffix?: string;
+    /**
+     * A synchronous function that decides whether a host returned by the SRV lookup may be used. It
+     * receives the host name, normalized to lowercase A-label (Punycode) form without a trailing `.`,
+     * and must return `true` to accept the host or `false` to reject it. Its return value replaces the
+     * default verification entirely: the driver applies no other checks to the host. Only valid with a
+     * `mongodb+srv` connection string, cannot be combined with `srvAllowedHostsSuffix`, and cannot be
+     * set in the connection string.
+     *
+     * The function runs synchronously during SRV resolution and SRV polling, so it must not block.
+     *
+     * If the function throws during the initial SRV lookup, `connect()` rejects with a
+     * `MongoAPIError` whose `cause` is the thrown error. During SRV polling, the host is rejected
+     * instead and no error is raised.
+     *
+     * **WARNING: Modifying the default SRV domain name validation can create vulnerabilities.**
+     * SRV host verification prevents a spoofed DNS response from directing the driver to arbitrary
+     * hosts, and a validator that accepts too broadly removes that protection.
+     */
+    srvHostValidator?: (host: string) => boolean;
     /** The maximum number of connections in the connection pool. */
     maxPoolSize?: number;
     /** The minimum number of connections in the connection pool. */
@@ -7031,6 +6990,8 @@ export declare interface MongoOptions extends Required<Pick<MongoClientOptions,
     appName?: string;
     hosts: HostAddress[];
     srvHost?: string;
+    srvAllowedHostsSuffix?: string;
+    srvHostValidator?: (host: string) => boolean;
     credentials?: MongoCredentials;
     readPreference: ReadPreference;
     readConcern: ReadConcern;
@@ -7094,6 +7055,7 @@ export declare interface MongoOptions extends Required<Pick<MongoClientOptions,
     tlsCertificateKeyFile?: string;
     /* Excluded from this release type: mongoLoggerOptions */
     /* Excluded from this release type: mongodbLogPath */
+    /** @deprecated `timeoutMS` has no effect and will be removed in a future release. */
     timeoutMS?: number;
     /* Excluded from this release type: __skipPingOnConnect */
     /* Excluded from this release type: runtime */
@@ -7539,8 +7501,8 @@ export declare interface OperationOptions extends BSONSerializeOptions {
     /* Excluded from this release type: bypassPinningCheck */
     /* Excluded from this release type: omitMaxTimeMS */
     /**
-     * @experimental
      * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
 }
@@ -7960,8 +7922,8 @@ export declare type RunCommandOptions = {
     /** The read preference */
     readPreference?: ReadPreferenceLike;
     /**
-     * @experimental
      * Specifies the time an operation will run until it throws a timeout error
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
     /* Excluded from this release type: omitMaxTimeMS */
@@ -7973,40 +7935,13 @@ export declare type RunCursorCommandOptions = {
     readPreference?: ReadPreferenceLike;
     session?: ClientSession;
     /**
-     * @experimental
-     * Specifies the time an operation will run until it throws a timeout error. Note that if
-     * `maxTimeMS` is provided in the command in addition to setting `timeoutMS` in the options, then
-     * the original value of `maxTimeMS` will be overwritten.
+     * Specifies the time an operation will run until it throws a timeout error.
+     * @deprecated `timeoutMS` has no effect and will be removed in a future release.
      */
     timeoutMS?: number;
     /**
-     * @public
-     * @experimental
-     * Specifies how `timeoutMS` is applied to the cursor. Can be either `'cursorLifeTime'` or `'iteration'`
-     * When set to `'iteration'`, the deadline specified by `timeoutMS` applies to each call of
-     * `cursor.next()`.
-     * When set to `'cursorLifetime'`, the deadline applies to the life of the entire cursor.
-     *
-     * Depending on the type of cursor being used, this option has different default values.
-     * For non-tailable cursors, this value defaults to `'cursorLifetime'`
-     * For tailable cursors, this value defaults to `'iteration'` since tailable cursors, by
-     * definition can have an arbitrarily long lifetime.
-     *
-     * @example
-     * ```ts
-     * const cursor = collection.find({}, {timeoutMS: 100, timeoutMode: 'iteration'});
-     * for await (const doc of cursor) {
-     *  // process doc
-     *  // This will throw a timeout error if any of the iterator's `next()` calls takes more than 100ms, but
-     *  // will continue to iterate successfully otherwise, regardless of the number of batches.
-     * }
-     * ```
-     *
-     * @example
-     * ```ts
-     * const cursor = collection.find({}, { timeoutMS: 1000, timeoutMode: 'cursorLifetime' });
-     * const docs = await cursor.toArray(); // This entire line will throw a timeout error if all batches are not fetched and returned within 1000ms.
-     * ```
+     * Specifies how `timeoutMS` is applied to the cursor.
+     * @deprecated `timeoutMode` has no effect and will be removed in a future release.
      */
     timeoutMode?: CursorTimeoutMode;
     tailable?: boolean;