mongodb 6.20.0-dev.20251007.sha.3f7196eb → 6.20.0-dev.20251009.sha.fb2824ff

package/src/change_stream.ts

@@ -17,9 +17,7 @@ import {
 import { MongoClient } from './mongo_client';
 import { type InferIdType, TypedEventEmitter } from './mongo_types';
 import type { AggregateOptions } from './operations/aggregate';
-import type { CollationOptions, OperationParent } from './operations/command';
-import type { ReadPreference } from './read_preference';
-import { type AsyncDisposable, configureResourceManagement } from './resource_management';
+import type { OperationParent } from './operations/command';
 import type { ServerSessionId } from './sessions';
 import { CSOTTimeoutContext, type TimeoutContext } from './timeout';
 import { filterOptions, getTopology, type MongoDBNamespace, squashError } from './utils';
@@ -45,21 +43,6 @@ const NO_RESUME_TOKEN_ERROR =
   'A change stream document has been received that lacks a resume token (_id).';
 const CHANGESTREAM_CLOSED_ERROR = 'ChangeStream is closed';
 
-/**
- * @public
- * @deprecated Please use the ChangeStreamCursorOptions type instead.
- */
-export interface ResumeOptions {
-  startAtOperationTime?: Timestamp;
-  batchSize?: number;
-  maxAwaitTimeMS?: number;
-  collation?: CollationOptions;
-  readPreference?: ReadPreference;
-  resumeAfter?: ResumeToken;
-  startAfter?: ResumeToken;
-  fullDocument?: string;
-}
-
 /**
  * Represents the logical starting point for a new ChangeStream or resuming a ChangeStream on the server.
  * @see https://www.mongodb.com/docs/manual/changeStreams/#std-label-change-stream-resume
@@ -590,13 +573,10 @@ export class ChangeStream<
   implements AsyncDisposable
 {
   /**
-   * @beta
    * @experimental
    * An alias for {@link ChangeStream.close|ChangeStream.close()}.
    */
-  declare [Symbol.asyncDispose]: () => Promise<void>;
-  /** @internal */
-  async asyncDispose() {
+  async [Symbol.asyncDispose]() {
     await this.close();
   }
 
@@ -1106,5 +1086,3 @@ export class ChangeStream<
     }
   }
 }
-
-configureResourceManagement(ChangeStream.prototype);

package/src/cmap/connection.ts

@@ -138,6 +138,7 @@ export interface ConnectionOptions
   tls: boolean;
   noDelay?: boolean;
   socketTimeoutMS?: number;
+  /** @internal */
   cancellationToken?: CancellationToken;
   metadata: ClientMetadata;
   /** @internal */

package/src/cmap/connection_pool.ts

@@ -97,15 +97,6 @@ export const PoolState = Object.freeze({
 
 type PoolState = (typeof PoolState)[keyof typeof PoolState];
 
-/**
- * @public
- * @deprecated This interface is deprecated and will be removed in a future release as it is not used
- * in the driver
- */
-export interface CloseOptions {
-  force?: boolean;
-}
-
 /** @public */
 export type ConnectionPoolEvents = {
   connectionPoolCreated(event: ConnectionPoolCreatedEvent): void;

package/src/cmap/handshake/client_metadata.ts

@@ -56,19 +56,6 @@ export interface ClientMetadata {
   };
 }
 
-/**
- * @public
- * @deprecated This interface will be made internal in the next major release.
- */
-export interface ClientMetadataOptions {
-  driverInfo?: {
-    name?: string;
-    version?: string;
-    platform?: string;
-  };
-  appName?: string;
-}
-
 /** @internal */
 export class LimitedSizeDocument {
   private document = new Map();

package/src/cmap/wire_protocol/constants.ts

@@ -1,5 +1,7 @@
 export const MIN_SUPPORTED_SERVER_VERSION = '4.2';
 export const MAX_SUPPORTED_SERVER_VERSION = '8.2';
+export const MIN_SUPPORTED_SNAPSHOT_READS_WIRE_VERSION = 13;
+export const MIN_SUPPORTED_SNAPSHOT_READS_SERVER_VERSION = '5.0';
 export const MIN_SUPPORTED_WIRE_VERSION = 8;
 export const MAX_SUPPORTED_WIRE_VERSION = 27;
 export const MIN_SUPPORTED_QE_WIRE_VERSION = 21;

package/src/collection.ts

@@ -546,7 +546,7 @@ export class Collection<TSchema extends Document = Document> {
     // Explicitly set the limit to 1 and singleBatch to true for all commands, per the spec.
     // noCursorTimeout must be unset as well as batchSize.
     // See: https://github.com/mongodb/specifications/blob/master/source/crud/crud.md#findone-api-details
-    const { batchSize: _batchSize, noCursorTimeout: _noCursorTimeout, ...opts } = options;
+    const { ...opts } = options;
     opts.singleBatch = true;
     const cursor = this.find(filter, opts).limit(1);
     const result = await cursor.next();

package/src/connection_string.ts

@@ -1283,16 +1283,6 @@ export const OPTIONS = {
   secureProtocol: { type: 'any' },
   index: { type: 'any' },
   // Legacy options from v3 era
-  useNewUrlParser: {
-    type: 'boolean',
-    deprecated:
-      'useNewUrlParser has no effect since Node.js Driver version 4.0.0 and will be removed in the next major version'
-  } as OptionDescriptor,
-  useUnifiedTopology: {
-    type: 'boolean',
-    deprecated:
-      'useUnifiedTopology has no effect since Node.js Driver version 4.0.0 and will be removed in the next major version'
-  } as OptionDescriptor,
   __skipPingOnConnect: { type: 'boolean' }
 } as Record<keyof MongoClientOptions, OptionDescriptor>;
 

package/src/cursor/abstract_cursor.ts

@@ -18,7 +18,6 @@ import { GetMoreOperation } from '../operations/get_more';
 import { KillCursorsOperation } from '../operations/kill_cursors';
 import { ReadConcern, type ReadConcernLike } from '../read_concern';
 import { ReadPreference, type ReadPreferenceLike } from '../read_preference';
-import { type AsyncDisposable, configureResourceManagement } from '../resource_management';
 import type { Server } from '../sdam/server';
 import { type ClientSession, maybeClearPinnedConnection } from '../sessions';
 import { type CSOTTimeoutContext, type Timeout, TimeoutContext } from '../timeout';
@@ -437,13 +436,10 @@ export abstract class AbstractCursor<
   }
 
   /**
-   * @beta
    * @experimental
    * An alias for {@link AbstractCursor.close|AbstractCursor.close()}.
    */
-  declare [Symbol.asyncDispose]: () => Promise<void>;
-  /** @internal */
-  async asyncDispose() {
+  async [Symbol.asyncDispose]() {
     await this.close();
   }
 
@@ -1223,8 +1219,6 @@ class ReadableCursorStream extends Readable {
   }
 }
 
-configureResourceManagement(AbstractCursor.prototype);
-
 /**
  * @internal
  * The cursor timeout context is a wrapper around a timeout context

package/src/gridfs/download.ts

@@ -53,10 +53,6 @@ export interface GridFSFile {
   filename: string;
   metadata?: Document;
   uploadDate: Date;
-  /** @deprecated Will be removed in the next major version. */
-  contentType?: string;
-  /** @deprecated Will be removed in the next major version. */
-  aliases?: string[];
 }
 
 /** @internal */

package/src/gridfs/upload.ts

@@ -32,16 +32,6 @@ export interface GridFSBucketWriteStreamOptions extends WriteConcernOptions {
   id?: ObjectId;
   /** Object to store in the file document's `metadata` field */
   metadata?: Document;
-  /**
-   * String to store in the file document's `contentType` field.
-   * @deprecated Will be removed in the next major version. Add a contentType field to the metadata document instead.
-   */
-  contentType?: string;
-  /**
-   * Array of strings to store in the file document's `aliases` field.
-   * @deprecated Will be removed in the next major version. Add an aliases field to the metadata document instead.
-   */
-  aliases?: string[];
   /**
    * @experimental
    * Specifies the time an operation will run until it throws a timeout error
@@ -305,8 +295,6 @@ function checkDone(stream: GridFSBucketWriteStream, callback: Callback): void {
       stream.length,
       stream.chunkSizeBytes,
       stream.filename,
-      stream.options.contentType,
-      stream.options.aliases,
       stream.options.metadata
     );
 
@@ -402,8 +390,6 @@ function createFilesDoc(
   length: number,
   chunkSize: number,
   filename: string,
-  contentType?: string,
-  aliases?: string[],
   metadata?: Document
 ): GridFSFile {
   const ret: GridFSFile = {
@@ -414,14 +400,6 @@ function createFilesDoc(
     filename
   };
 
-  if (contentType) {
-    ret.contentType = contentType;
-  }
-
-  if (aliases) {
-    ret.aliases = aliases;
-  }
-
   if (metadata) {
     ret.metadata = metadata;
   }

package/src/index.ts

@@ -87,7 +87,6 @@ export {
   MongoWriteConcernError,
   WriteConcernErrorResult
 } from './error';
-export { configureExplicitResourceManagement } from './resource_management';
 export {
   AbstractCursor,
   // Actual driver classes exported
@@ -224,7 +223,6 @@ export type {
   ChangeStreamSplitEvent,
   ChangeStreamUpdateDocument,
   OperationTime,
-  ResumeOptions,
   ResumeToken,
   UpdateDescription
 } from './change_stream';
@@ -307,7 +305,6 @@ export type {
   ProxyOptions
 } from './cmap/connection';
 export type {
-  CloseOptions,
   ConnectionPool,
   ConnectionPoolEvents,
   ConnectionPoolOptions,
@@ -315,7 +312,7 @@ export type {
   WaitQueueMember,
   WithConnectionCallback
 } from './cmap/connection_pool';
-export type { ClientMetadata, ClientMetadataOptions } from './cmap/handshake/client_metadata';
+export type { ClientMetadata } from './cmap/handshake/client_metadata';
 export type { ConnectionPoolMetrics } from './cmap/metrics';
 export type { StreamDescription, StreamDescriptionOptions } from './cmap/stream_description';
 export type { CompressorName } from './cmap/wire_protocol/compression';
@@ -566,7 +563,6 @@ export type {
   ReadPreferenceLikeOptions,
   ReadPreferenceOptions
 } from './read_preference';
-export type { AsyncDisposable } from './resource_management';
 export type { ClusterTime } from './sdam/common';
 export type {
   Monitor,
@@ -598,7 +594,6 @@ export type { SrvPoller, SrvPollerEvents, SrvPollerOptions } from './sdam/srv_po
 export type {
   ConnectOptions,
   SelectServerOptions,
-  ServerCapabilities,
   ServerSelectionCallback,
   ServerSelectionRequest,
   Topology,

package/src/mongo_client.ts

@@ -48,7 +48,6 @@ import { executeOperation } from './operations/execute_operation';
 import { AbstractOperation } from './operations/operation';
 import type { ReadConcern, ReadConcernLevel, ReadConcernLike } from './read_concern';
 import { ReadPreference, type ReadPreferenceMode } from './read_preference';
-import { type AsyncDisposable, configureResourceManagement } from './resource_management';
 import type { ServerMonitoringMode } from './sdam/monitor';
 import type { TagSet } from './sdam/server_description';
 import { readPreferenceServerSelector } from './sdam/server_selection';
@@ -485,13 +484,10 @@ export class MongoClient extends TypedEventEmitter<MongoClientEvents> implements
   }
 
   /**
-   * @beta
    * @experimental
    * An alias for {@link MongoClient.close|MongoClient.close()}.
    */
-  declare [Symbol.asyncDispose]: () => Promise<void>;
-  /** @internal */
-  async asyncDispose() {
+  async [Symbol.asyncDispose]() {
     await this.close();
   }
 
@@ -1037,8 +1033,6 @@ export class MongoClient extends TypedEventEmitter<MongoClientEvents> implements
   }
 }
 
-configureResourceManagement(MongoClient.prototype);
-
 /**
  * Parsed Mongo Client Options.
  *

package/src/mongo_types.ts

@@ -473,8 +473,7 @@ export class TypedEventEmitter<Events extends EventsDescription> extends EventEm
 }
 
 /**
- * @public
- * @deprecated Will be removed in favor of `AbortSignal` in the next major release.
+ * @internal
  */
 export class CancellationToken extends TypedEventEmitter<{ cancel(): void }> {
   constructor(...args: any[]) {

package/src/operations/aggregate.ts

@@ -80,12 +80,6 @@ export class AggregateOperation extends CommandOperation<CursorResponse> {
       delete this.options.writeConcern;
     }
 
-    if (this.explain && this.writeConcern) {
-      throw new MongoInvalidArgumentError(
-        'Option "explain" cannot be used on an aggregate call with writeConcern'
-      );
-    }
-
     if (options?.cursor != null && typeof options.cursor !== 'object') {
       throw new MongoInvalidArgumentError('Cursor options must be an object');
     }

package/src/operations/command.ts

@@ -53,13 +53,6 @@ export interface CommandOperationOptions
    * In server versions 4.4 and above, 'comment' can be any valid BSON type.
    */
   comment?: unknown;
-  /**
-   * @deprecated
-   * This option is deprecated and will be removed in a future release as it is not used
-   * in the driver. Use MongoClientOptions or connection string parameters instead.
-   * */
-  retryWrites?: boolean;
-
   // Admin command overrides.
   dbName?: string;
   authdb?: string;

package/src/operations/create_collection.ts

@@ -23,7 +23,6 @@ const ILLEGAL_COMMAND_FIELDS = new Set([
   'timeoutMS',
   'j',
   'fsync',
-  'autoIndexId',
   'pkFactory',
   'raw',
   'readPreference',
@@ -68,8 +67,6 @@ export interface ClusteredCollectionOptions extends Document {
 export 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 */

package/src/operations/execute_operation.ts

@@ -1,3 +1,4 @@
+import { MIN_SUPPORTED_SNAPSHOT_READS_WIRE_VERSION } from '../cmap/wire_protocol/constants';
 import {
   isRetryableReadError,
   isRetryableWriteError,
@@ -25,7 +26,7 @@ import {
 import type { Topology } from '../sdam/topology';
 import type { ClientSession } from '../sessions';
 import { TimeoutContext } from '../timeout';
-import { abortable, supportsRetryableWrites } from '../utils';
+import { abortable, maxWireVersion, supportsRetryableWrites } from '../utils';
 import { AggregateOperation } from './aggregate';
 import { AbstractOperation, Aspect } from './operation';
 
@@ -81,7 +82,10 @@ export async function executeOperation<
     session = client.startSession({ owner, explicit: false });
   } else if (session.hasEnded) {
     throw new MongoExpiredSessionError('Use of expired sessions is not permitted');
-  } else if (session.snapshotEnabled && !topology.capabilities.supportsSnapshotReads) {
+  } else if (
+    session.snapshotEnabled &&
+    maxWireVersion(topology) < MIN_SUPPORTED_SNAPSHOT_READS_WIRE_VERSION
+  ) {
     throw new MongoCompatibilityError('Snapshot reads require MongoDB 5.0 or later');
   } else if (session.client !== client) {
     throw new MongoInvalidArgumentError('ClientSession must be from the same MongoClient');

package/src/operations/find.ts

@@ -12,10 +12,8 @@ import { Aspect, defineAspects, type Hint } from './operation';
 
 /**
  * @public
- * @typeParam TSchema - Unused schema definition, deprecated usage, only specify `FindOptions` with no generic
  */
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export interface FindOptions<TSchema extends Document = Document>
+export interface FindOptions
   extends Omit<CommandOperationOptions, 'writeConcern' | 'explain'>,
     AbstractCursorOptions {
   /** Sets the limit of documents returned in the query. */
@@ -76,14 +74,7 @@ export interface FindOptions<TSchema extends Document = Document>
 }
 
 /** @public */
-export 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;
-}
+export type FindOneOptions = Omit<FindOptions, 'batchSize' | 'limit' | 'noCursorTimeout'>;
 
 /** @internal */
 export class FindOperation extends CommandOperation<CursorResponse> {

package/src/read_preference.ts

@@ -63,10 +63,6 @@ export class ReadPreference {
   tags?: TagSet[];
   hedge?: HedgeOptions;
   maxStalenessSeconds?: number;
-  /**
-   * @deprecated This will be removed as dead code in the next major version.
-   */
-  minWireVersion?: number;
 
   public static PRIMARY = ReadPreferenceMode.primary;
   public static PRIMARY_PREFERRED = ReadPreferenceMode.primaryPreferred;
@@ -100,7 +96,6 @@ export class ReadPreference {
     this.tags = tags;
     this.hedge = options?.hedge;
     this.maxStalenessSeconds = undefined;
-    this.minWireVersion = undefined;
 
     options = options ?? {};
     if (options.maxStalenessSeconds != null) {
@@ -109,10 +104,6 @@ export class ReadPreference {
       }
 
       this.maxStalenessSeconds = options.maxStalenessSeconds;
-
-      // NOTE: The minimum required wire version is 5 for this read preference. If the existing
-      //       topology has a lower value then a MongoError will be thrown during server selection.
-      this.minWireVersion = 5;
     }
 
     if (this.mode === ReadPreference.PRIMARY) {

package/src/sdam/topology.ts

@@ -393,10 +393,6 @@ export class Topology extends TypedEventEmitter<TopologyEvents> {
     return this.s.options.serverApi;
   }
 
-  get capabilities(): ServerCapabilities {
-    return new ServerCapabilities(this.lastHello());
-  }
-
   /** Initiate server connect */
   async connect(options?: ConnectOptions): Promise<Topology> {
     this.connectionLock ??= this._connect(options);
@@ -1103,52 +1099,3 @@ function isStaleServerDescription(
     compareTopologyVersion(currentTopologyVersion, incomingServerDescription.topologyVersion) > 0
   );
 }
-
-/**
- * @public
- * @deprecated This class will be removed as dead code in the next major version.
- */
-export class ServerCapabilities {
-  maxWireVersion: number;
-  minWireVersion: number;
-
-  constructor(hello: Document) {
-    this.minWireVersion = hello.minWireVersion || 0;
-    this.maxWireVersion = hello.maxWireVersion || 0;
-  }
-
-  get hasAggregationCursor(): boolean {
-    return true;
-  }
-
-  get hasWriteCommands(): boolean {
-    return true;
-  }
-  get hasTextSearch(): boolean {
-    return true;
-  }
-
-  get hasAuthCommands(): boolean {
-    return true;
-  }
-
-  get hasListCollectionsCommand(): boolean {
-    return true;
-  }
-
-  get hasListIndexesCommand(): boolean {
-    return true;
-  }
-
-  get supportsSnapshotReads(): boolean {
-    return this.maxWireVersion >= 13;
-  }
-
-  get commandsTakeWriteConcern(): boolean {
-    return true;
-  }
-
-  get commandsTakeCollation(): boolean {
-    return true;
-  }
-}

package/src/sessions.ts

@@ -26,7 +26,6 @@ import { executeOperation } from './operations/execute_operation';
 import { RunCommandOperation } from './operations/run_command';
 import { ReadConcernLevel } from './read_concern';
 import { ReadPreference } from './read_preference';
-import { type AsyncDisposable, configureResourceManagement } from './resource_management';
 import { _advanceClusterTime, type ClusterTime, TopologyType } from './sdam/common';
 import { TimeoutContext } from './timeout';
 import {
@@ -118,7 +117,7 @@ export class ClientSession
   /** @internal */
   owner?: symbol | AbstractCursor;
   defaultTransactionOptions: TransactionOptions;
-  /** @deprecated - Will be made internal in the next major release */
+  /** @internal */
   transaction: Transaction;
   /**
    * @internal
@@ -289,13 +288,10 @@ export class ClientSession
     }
   }
   /**
-   * @beta
    * @experimental
    * An alias for {@link ClientSession.endSession|ClientSession.endSession()}.
    */
-  declare [Symbol.asyncDispose]: () => Promise<void>;
-  /** @internal */
-  async asyncDispose() {
+  async [Symbol.asyncDispose]() {
     await this.endSession({ force: true });
   }
 
@@ -823,8 +819,6 @@ export class ClientSession
   }
 }
 
-configureResourceManagement(ClientSession.prototype);
-
 const NON_DETERMINISTIC_WRITE_CONCERN_ERRORS = new Set([
   'CannotSatisfyWriteConcern',
   'UnknownReplWriteConcern',

package/src/transactions.ts

@@ -73,21 +73,15 @@ export interface TransactionOptions extends Omit<CommandOperationOptions, 'timeo
 }
 
 /**
- * @public
- * @deprecated - Will be made internal in a future major release.
- * A class maintaining state related to a server transaction. Internal Only
+ * @internal
  */
 export class Transaction {
-  /** @internal */
   state: TxnState;
-  /** @deprecated - Will be made internal in a future major release. */
   options: TransactionOptions;
-  /** @internal */
   _pinnedServer?: Server;
-  /** @internal */
   _recoveryToken?: Document;
 
-  /** Create a transaction @internal */
+  /** Create a transaction */
   constructor(options?: TransactionOptions) {
     options = options ?? {};
     this.state = TxnState.NO_TRANSACTION;
@@ -119,23 +113,19 @@ export class Transaction {
     this._recoveryToken = undefined;
   }
 
-  /** @internal */
   get server(): Server | undefined {
     return this._pinnedServer;
   }
 
-  /** @deprecated - Will be made internal in a future major release. */
   get recoveryToken(): Document | undefined {
     return this._recoveryToken;
   }
 
-  /** @deprecated - Will be made internal in a future major release. */
   get isPinned(): boolean {
     return !!this.server;
   }
 
   /**
-   * @deprecated - Will be made internal in a future major release.
    * @returns Whether the transaction has started
    */
   get isStarting(): boolean {
@@ -143,20 +133,17 @@ export class Transaction {
   }
 
   /**
-   * @deprecated - Will be made internal in a future major release.
    * @returns Whether this session is presently in a transaction
    */
   get isActive(): boolean {
     return ACTIVE_STATES.has(this.state);
   }
 
-  /** @deprecated - Will be made internal in a future major release. */
   get isCommitted(): boolean {
     return COMMITTED_STATES.has(this.state);
   }
   /**
    * Transition the transaction in the state machine
-   * @internal
    * @param nextState - The new state to transition to
    */
   transition(nextState: TxnState): void {
@@ -178,14 +165,12 @@ export class Transaction {
     );
   }
 
-  /** @internal */
   pinServer(server: Server): void {
     if (this.isActive) {
       this._pinnedServer = server;
     }
   }
 
-  /** @internal */
   unpinServer(): void {
     this._pinnedServer = undefined;
   }

package/src/utils.ts

@@ -153,24 +153,6 @@ export function filterOptions(options: AnyOptions, names: ReadonlyArray<string>)
   return filterOptions;
 }
 
-interface HasRetryableWrites {
-  retryWrites?: boolean;
-}
-/**
- * Applies retryWrites: true to a command if retryWrites is set on the command's database.
- * @internal
- *
- * @param target - The target command to which we will apply retryWrites.
- * @param db - The database from which we can inherit a retryWrites value.
- */
-export function applyRetryableWrites<T extends HasRetryableWrites>(target: T, db?: Db): T {
-  if (db && db.s.options?.retryWrites) {
-    target.retryWrites = true;
-  }
-
-  return target;
-}
-
 /**
  * Applies a write concern to a command based on well defined inheritance rules, optionally
  * detecting support for the write concern in the first place.