mongodb 6.19.0 → 6.20.0-dev.20250920.sha.e8a91a91

package/src/operations/indexes.ts

@@ -356,6 +356,8 @@ export class DropIndexOperation extends CommandOperation<Document> {
 export type ListIndexesOptions = AbstractCursorOptions & {
   /** @internal */
   omitMaxTimeMS?: boolean;
+  /** @internal */
+  rawData?: boolean;
 };
 
 /** @internal */
@@ -409,7 +411,8 @@ export class ListIndexesOperation extends CommandOperation<CursorResponse> {
 defineAspects(ListIndexesOperation, [
   Aspect.READ_OPERATION,
   Aspect.RETRYABLE,
-  Aspect.CURSOR_CREATING
+  Aspect.CURSOR_CREATING,
+  Aspect.SUPPORTS_RAW_DATA
 ]);
-defineAspects(CreateIndexesOperation, [Aspect.WRITE_OPERATION]);
-defineAspects(DropIndexOperation, [Aspect.WRITE_OPERATION]);
+defineAspects(CreateIndexesOperation, [Aspect.WRITE_OPERATION, Aspect.SUPPORTS_RAW_DATA]);
+defineAspects(DropIndexOperation, [Aspect.WRITE_OPERATION, Aspect.SUPPORTS_RAW_DATA]);

package/src/operations/insert.ts

@@ -96,5 +96,13 @@ export interface InsertManyResult<TSchema = Document> {
   insertedIds: { [key: number]: InferIdType<TSchema> };
 }
 
-defineAspects(InsertOperation, [Aspect.RETRYABLE, Aspect.WRITE_OPERATION]);
-defineAspects(InsertOneOperation, [Aspect.RETRYABLE, Aspect.WRITE_OPERATION]);
+defineAspects(InsertOperation, [
+  Aspect.RETRYABLE,
+  Aspect.WRITE_OPERATION,
+  Aspect.SUPPORTS_RAW_DATA
+]);
+defineAspects(InsertOneOperation, [
+  Aspect.RETRYABLE,
+  Aspect.WRITE_OPERATION,
+  Aspect.SUPPORTS_RAW_DATA
+]);

package/src/operations/list_collections.ts

@@ -103,5 +103,6 @@ export interface CollectionInfo extends Document {
 defineAspects(ListCollectionsOperation, [
   Aspect.READ_OPERATION,
   Aspect.RETRYABLE,
-  Aspect.CURSOR_CREATING
+  Aspect.CURSOR_CREATING,
+  Aspect.SUPPORTS_RAW_DATA
 ]);

package/src/operations/list_databases.ts

@@ -16,7 +16,7 @@ export interface ListDatabasesResult {
 }
 
 /** @public */
-export interface ListDatabasesOptions extends CommandOperationOptions {
+export interface ListDatabasesOptions extends Omit<CommandOperationOptions, 'rawData'> {
   /** A query predicate that determines which databases are listed */
   filter?: Document;
   /** A flag to indicate whether the command should return just the database names, or return both database names and size information */

package/src/operations/operation.ts

@@ -16,7 +16,8 @@ export const Aspect = {
   SKIP_COLLATION: Symbol('SKIP_COLLATION'),
   CURSOR_CREATING: Symbol('CURSOR_CREATING'),
   MUST_SELECT_SAME_SERVER: Symbol('MUST_SELECT_SAME_SERVER'),
-  COMMAND_BATCHING: Symbol('COMMAND_BATCHING')
+  COMMAND_BATCHING: Symbol('COMMAND_BATCHING'),
+  SUPPORTS_RAW_DATA: Symbol('SUPPORTS_RAW_DATA')
 } as const;
 
 /** @public */

package/src/operations/profiling_level.ts

@@ -6,7 +6,7 @@ import { MongoUnexpectedServerResponseError } from '../error';
 import { CommandOperation, type CommandOperationOptions } from './command';
 
 /** @public */
-export type ProfilingLevelOptions = CommandOperationOptions;
+export type ProfilingLevelOptions = Omit<CommandOperationOptions, 'rawData'>;
 
 class ProfilingLevelResponse extends MongoDBResponse {
   get was() {

package/src/operations/remove_user.ts

@@ -6,7 +6,7 @@ import { CommandOperation, type CommandOperationOptions } from './command';
 import { Aspect, defineAspects } from './operation';
 
 /** @public */
-export type RemoveUserOptions = CommandOperationOptions;
+export type RemoveUserOptions = Omit<CommandOperationOptions, 'rawData'>;
 
 /** @internal */
 export class RemoveUserOperation extends CommandOperation<boolean> {

package/src/operations/rename.ts

@@ -8,7 +8,7 @@ import { CommandOperation, type CommandOperationOptions } from './command';
 import { Aspect, defineAspects } from './operation';
 
 /** @public */
-export interface RenameOptions extends CommandOperationOptions {
+export interface RenameOptions extends Omit<CommandOperationOptions, 'rawData'> {
   /** Drop the target name collection if it previously exists. */
   dropTarget?: boolean;
   /** Unclear */
@@ -48,7 +48,7 @@ export class RenameOperation extends CommandOperation<Document> {
   }
 
   override handleOk(_response: InstanceType<typeof this.SERVER_COMMAND_RESPONSE_TYPE>): Document {
-    return new Collection(this.collection.s.db, this.newName, this.collection.s.options);
+    return new Collection(this.collection.db, this.newName, this.collection.s.options);
   }
 }
 

package/src/operations/set_profiling_level.ts

@@ -19,7 +19,7 @@ export const ProfilingLevel = Object.freeze({
 export type ProfilingLevel = (typeof ProfilingLevel)[keyof typeof ProfilingLevel];
 
 /** @public */
-export type SetProfilingLevelOptions = CommandOperationOptions;
+export type SetProfilingLevelOptions = Omit<CommandOperationOptions, 'rawData'>;
 
 /** @internal */
 export class SetProfilingLevelOperation extends CommandOperation<ProfilingLevel> {

package/src/operations/stats.ts

@@ -6,7 +6,7 @@ import { CommandOperation, type CommandOperationOptions } from './command';
 import { Aspect, defineAspects } from './operation';
 
 /** @public */
-export interface DbStatsOptions extends CommandOperationOptions {
+export interface DbStatsOptions extends Omit<CommandOperationOptions, 'rawData'> {
   /** Divide the returned sizes by scale value. */
   scale?: number;
 }

package/src/operations/update.ts

@@ -1,7 +1,7 @@
 import type { Document } from '../bson';
 import { type Connection } from '../cmap/connection';
 import { MongoDBResponse } from '../cmap/wire_protocol/responses';
-import { MongoCompatibilityError, MongoInvalidArgumentError, MongoServerError } from '../error';
+import { MongoInvalidArgumentError, MongoServerError } from '../error';
 import type { InferIdType } from '../mongo_types';
 import type { ClientSession } from '../sessions';
 import { formatSort, type Sort, type SortForCmd } from '../sort';
@@ -121,14 +121,6 @@ export class UpdateOperation extends CommandOperation<Document> {
       command.comment = options.comment;
     }
 
-    const unacknowledgedWrite = this.writeConcern?.w === 0;
-    if (unacknowledgedWrite) {
-      if (this.statements.find((o: Document) => o.hint)) {
-        // TODO(NODE-3541): fix error for hint with unacknowledged writes
-        throw new MongoCompatibilityError(`hint is not supported with unacknowledged writes`);
-      }
-    }
-
     return command;
   }
 }
@@ -299,20 +291,28 @@ export function makeUpdateStatement(
   return op;
 }
 
-defineAspects(UpdateOperation, [Aspect.RETRYABLE, Aspect.WRITE_OPERATION, Aspect.SKIP_COLLATION]);
+defineAspects(UpdateOperation, [
+  Aspect.RETRYABLE,
+  Aspect.WRITE_OPERATION,
+  Aspect.SKIP_COLLATION,
+  Aspect.SUPPORTS_RAW_DATA
+]);
 defineAspects(UpdateOneOperation, [
   Aspect.RETRYABLE,
   Aspect.WRITE_OPERATION,
   Aspect.EXPLAINABLE,
-  Aspect.SKIP_COLLATION
+  Aspect.SKIP_COLLATION,
+  Aspect.SUPPORTS_RAW_DATA
 ]);
 defineAspects(UpdateManyOperation, [
   Aspect.WRITE_OPERATION,
   Aspect.EXPLAINABLE,
-  Aspect.SKIP_COLLATION
+  Aspect.SKIP_COLLATION,
+  Aspect.SUPPORTS_RAW_DATA
 ]);
 defineAspects(ReplaceOneOperation, [
   Aspect.RETRYABLE,
   Aspect.WRITE_OPERATION,
-  Aspect.SKIP_COLLATION
+  Aspect.SKIP_COLLATION,
+  Aspect.SUPPORTS_RAW_DATA
 ]);

package/src/operations/validate_collection.ts

@@ -7,7 +7,7 @@ import type { ClientSession } from '../sessions';
 import { CommandOperation, type CommandOperationOptions } from './command';
 
 /** @public */
-export interface ValidateCollectionOptions extends CommandOperationOptions {
+export 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;
 }

package/src/read_preference.ts

@@ -63,6 +63,9 @@ 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;

package/src/sdam/server.ts

@@ -414,7 +414,7 @@ export class Server extends TypedEventEmitter<ServerEvents> {
     } else {
       if (isSDAMUnrecoverableError(error)) {
         if (shouldHandleStateChangeError(this, error)) {
-          const shouldClearPool = maxWireVersion(this) <= 7 || isNodeShuttingDownError(error);
+          const shouldClearPool = isNodeShuttingDownError(error);
           if (this.loadBalanced && connection && shouldClearPool) {
             this.pool.clear({ serviceId: connection.serviceId });
           }

package/src/sdam/server_selection.ts

@@ -1,4 +1,4 @@
-import { MongoCompatibilityError, MongoInvalidArgumentError } from '../error';
+import { MongoInvalidArgumentError } from '../error';
 import { ReadPreference } from '../read_preference';
 import { ServerType, TopologyType } from './common';
 import type { ServerDescription, TagSet } from './server_description';
@@ -273,17 +273,6 @@ export function readPreferenceServerSelector(readPreference: ReadPreference): Se
     servers: ServerDescription[],
     deprioritized: ServerDescription[] = []
   ): ServerDescription[] {
-    const commonWireVersion = topologyDescription.commonWireVersion;
-    if (
-      commonWireVersion &&
-      readPreference.minWireVersion &&
-      readPreference.minWireVersion > commonWireVersion
-    ) {
-      throw new MongoCompatibilityError(
-        `Minimum wire version '${readPreference.minWireVersion}' required, but found '${commonWireVersion}'`
-      );
-    }
-
     if (topologyDescription.type === TopologyType.LoadBalanced) {
       return servers.filter(loadBalancerFilter);
     }

package/src/sdam/topology.ts

@@ -1104,7 +1104,10 @@ function isStaleServerDescription(
   );
 }
 
-/** @public */
+/**
+ * @public
+ * @deprecated This class will be removed as dead code in the next major version.
+ */
 export class ServerCapabilities {
   maxWireVersion: number;
   minWireVersion: number;
@@ -1115,26 +1118,26 @@ export class ServerCapabilities {
   }
 
   get hasAggregationCursor(): boolean {
-    return this.maxWireVersion >= 1;
+    return true;
   }
 
   get hasWriteCommands(): boolean {
-    return this.maxWireVersion >= 2;
+    return true;
   }
   get hasTextSearch(): boolean {
-    return this.minWireVersion >= 0;
+    return true;
   }
 
   get hasAuthCommands(): boolean {
-    return this.maxWireVersion >= 1;
+    return true;
   }
 
   get hasListCollectionsCommand(): boolean {
-    return this.maxWireVersion >= 3;
+    return true;
   }
 
   get hasListIndexesCommand(): boolean {
-    return this.maxWireVersion >= 3;
+    return true;
   }
 
   get supportsSnapshotReads(): boolean {
@@ -1142,10 +1145,10 @@ export class ServerCapabilities {
   }
 
   get commandsTakeWriteConcern(): boolean {
-    return this.maxWireVersion >= 5;
+    return true;
   }
 
   get commandsTakeCollation(): boolean {
-    return this.maxWireVersion >= 5;
+    return true;
   }
 }

package/src/sessions.ts

@@ -2,7 +2,6 @@ import { Binary, type Document, Long, type Timestamp } from './bson';
 import type { CommandOptions, Connection } from './cmap/connection';
 import { ConnectionPoolMetrics } from './cmap/metrics';
 import { type MongoDBResponse } from './cmap/wire_protocol/responses';
-import { isSharded } from './cmap/wire_protocol/shared';
 import { PINNED, UNPINNED } from './constants';
 import type { AbstractCursor } from './cursor/abstract_cursor';
 import {
@@ -42,7 +41,6 @@ import {
   commandSupportsReadConcern,
   isPromiseLike,
   List,
-  maxWireVersion,
   MongoDBNamespace,
   noop,
   now,
@@ -51,8 +49,6 @@ import {
 } from './utils';
 import { WriteConcern, type WriteConcernOptions, type WriteConcernSettings } from './write_concern';
 
-const minWireVersionForShardedTransactions = 8;
-
 /** @public */
 export interface ClientSessionOptions {
   /** Whether causal consistency should be enabled on this session */
@@ -405,17 +401,6 @@ export class ClientSession
       this.unpin();
     }
 
-    const topologyMaxWireVersion = maxWireVersion(this.client.topology);
-    if (
-      isSharded(this.client.topology) &&
-      topologyMaxWireVersion != null &&
-      topologyMaxWireVersion < minWireVersionForShardedTransactions
-    ) {
-      throw new MongoCompatibilityError(
-        'Transactions are not supported on sharded clusters in MongoDB < 4.2.'
-      );
-    }
-
     this.commitAttempted = false;
     // increment txnNumber
     this.incrementTransactionNumber();

package/src/utils.ts

@@ -19,7 +19,6 @@ import type { Db } from './db';
 import {
   type AnyError,
   MongoAPIError,
-  MongoCompatibilityError,
   MongoInvalidArgumentError,
   MongoNetworkTimeoutError,
   MongoNotConnectedError,
@@ -206,18 +205,9 @@ export function isPromiseLike<T = unknown>(value?: unknown): value is PromiseLik
  * @param target - target of command
  * @param options - options containing collation settings
  */
-export function decorateWithCollation(
-  command: Document,
-  target: MongoClient | Db | Collection,
-  options: AnyOptions
-): void {
-  const capabilities = getTopology(target).capabilities;
+export function decorateWithCollation(command: Document, options: AnyOptions): void {
   if (options.collation && typeof options.collation === 'object') {
-    if (capabilities && capabilities.commandsTakeCollation) {
-      command.collation = options.collation;
-    } else {
-      throw new MongoCompatibilityError(`Current topology does not support collation`);
-    }
+    command.collation = options.collation;
   }
 }
 
@@ -359,34 +349,40 @@ export function uuidV4(): Buffer {
  * A helper function for determining `maxWireVersion` between legacy and new topology instances
  * @internal
  */
-export function maxWireVersion(topologyOrServer?: Connection | Topology | Server): number {
-  if (topologyOrServer) {
-    if (topologyOrServer.loadBalanced || topologyOrServer.serverApi?.version) {
-      // Since we do not have a monitor in the load balanced mode,
-      // we assume the load-balanced server is always pointed at the latest mongodb version.
-      // There is a risk that for on-prem deployments
-      // that don't upgrade immediately that this could alert to the
-      // application that a feature is available that is actually not.
-      // We also return the max supported wire version for serverAPI.
+export function maxWireVersion(handshakeAware?: Connection | Topology | Server): number {
+  if (handshakeAware) {
+    if (handshakeAware.hello) {
+      return handshakeAware.hello.maxWireVersion;
+    }
+
+    if (handshakeAware.serverApi?.version) {
+      // We return the max supported wire version for serverAPI.
       return MAX_SUPPORTED_WIRE_VERSION;
     }
-    if (topologyOrServer.hello) {
-      return topologyOrServer.hello.maxWireVersion;
+    // This is the fallback case for load balanced mode. If we are building commands the
+    // object being checked will be a connection, and we will have a hello response on
+    // it. For other cases, such as retryable writes, the object will be a server or
+    // topology, and there will be no hello response on those objects, so we return
+    // the max wire version so we support retryability. Once we have a min supported
+    // wire version of 9, then the needsRetryableWriteLabel() check can remove the
+    // usage of passing the wire version into it.
+    if (handshakeAware.loadBalanced) {
+      return MAX_SUPPORTED_WIRE_VERSION;
     }
 
-    if ('lastHello' in topologyOrServer && typeof topologyOrServer.lastHello === 'function') {
-      const lastHello = topologyOrServer.lastHello();
+    if ('lastHello' in handshakeAware && typeof handshakeAware.lastHello === 'function') {
+      const lastHello = handshakeAware.lastHello();
       if (lastHello) {
         return lastHello.maxWireVersion;
       }
     }
 
     if (
-      topologyOrServer.description &&
-      'maxWireVersion' in topologyOrServer.description &&
-      topologyOrServer.description.maxWireVersion != null
+      handshakeAware.description &&
+      'maxWireVersion' in handshakeAware.description &&
+      handshakeAware.description.maxWireVersion != null
     ) {
-      return topologyOrServer.description.maxWireVersion;
+      return handshakeAware.description.maxWireVersion;
     }
   }
 
@@ -1362,7 +1358,7 @@ export function maybeAddIdToDocuments(
   options: { forceServerObjectId?: boolean }
 ): Document {
   const forceServerObjectId =
-    options.forceServerObjectId ?? collection.s.db.options?.forceServerObjectId ?? false;
+    options.forceServerObjectId ?? collection.db.options?.forceServerObjectId ?? false;
 
   // no need to modify the docs if server sets the ObjectId
   if (forceServerObjectId) {