mongodb 6.9.0-dev.20240917.sha.20396e1b → 6.9.0-dev.20240926.sha.3d3da407

package/lib/operations/client_bulk_write/results_merger.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientBulkWriteResultsMerger = void 0;
+/**
+ * Merges client bulk write cursor responses together into a single result.
+ * @internal
+ */
+class ClientBulkWriteResultsMerger {
+    /**
+     * Instantiate the merger.
+     * @param options - The options.
+     */
+    constructor(options) {
+        this.options = options;
+        this.result = {
+            insertedCount: 0,
+            upsertedCount: 0,
+            matchedCount: 0,
+            modifiedCount: 0,
+            deletedCount: 0,
+            insertResults: undefined,
+            updateResults: undefined,
+            deleteResults: undefined
+        };
+        if (options.verboseResults) {
+            this.result.insertResults = new Map();
+            this.result.updateResults = new Map();
+            this.result.deleteResults = new Map();
+        }
+    }
+    /**
+     * Merge the results in the cursor to the existing result.
+     * @param response - The cursor response.
+     * @param documents - The documents in the cursor.
+     * @returns The current result.
+     */
+    merge(operations, response, documents) {
+        // Update the counts from the cursor response.
+        this.result.insertedCount += response.insertedCount;
+        this.result.upsertedCount += response.upsertedCount;
+        this.result.matchedCount += response.matchedCount;
+        this.result.modifiedCount += response.modifiedCount;
+        this.result.deletedCount += response.deletedCount;
+        if (this.options.verboseResults) {
+            // Iterate all the documents in the cursor and update the result.
+            for (const document of documents) {
+                // Only add to maps if ok: 1
+                if (document.ok === 1) {
+                    // Get the corresponding operation from the command.
+                    const operation = operations[document.idx];
+                    // Handle insert results.
+                    if ('insert' in operation) {
+                        this.result.insertResults?.set(document.idx, { insertedId: operation.document._id });
+                    }
+                    // Handle update results.
+                    if ('update' in operation) {
+                        const result = {
+                            matchedCount: document.n,
+                            modifiedCount: document.nModified ?? 0,
+                            // Check if the bulk did actually upsert.
+                            didUpsert: document.upserted != null
+                        };
+                        if (document.upserted) {
+                            result.upsertedId = document.upserted._id;
+                        }
+                        this.result.updateResults?.set(document.idx, result);
+                    }
+                    // Handle delete results.
+                    if ('delete' in operation) {
+                        this.result.deleteResults?.set(document.idx, { deletedCount: document.n });
+                    }
+                }
+            }
+        }
+        return this.result;
+    }
+}
+exports.ClientBulkWriteResultsMerger = ClientBulkWriteResultsMerger;
+//# sourceMappingURL=results_merger.js.map

package/lib/operations/client_bulk_write/results_merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results_merger.js","sourceRoot":"","sources":["../../../src/operations/client_bulk_write/results_merger.ts"],"names":[],"mappings":";;;AAUA;;;GAGG;AACH,MAAa,4BAA4B;IAIvC;;;OAGG;IACH,YAAY,OAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG;YACZ,aAAa,EAAE,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,aAAa,EAAE,SAAS;YACxB,aAAa,EAAE,SAAS;YACxB,aAAa,EAAE,SAAS;SACzB,CAAC;QAEF,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,GAAG,EAAiC,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,GAAG,EAA8B,CAAC;YAClE,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,GAAG,EAA8B,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CACH,UAAsB,EACtB,QAAuC,EACvC,SAAqB;QAErB,8CAA8C;QAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;QAElD,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAChC,iEAAiE;YACjE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,4BAA4B;gBAC5B,IAAI,QAAQ,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;oBACtB,oDAAoD;oBACpD,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAC3C,yBAAyB;oBACzB,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;wBAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;oBACvF,CAAC;oBACD,yBAAyB;oBACzB,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;wBAC1B,MAAM,MAAM,GAAuB;4BACjC,YAAY,EAAE,QAAQ,CAAC,CAAC;4BACxB,aAAa,EAAE,QAAQ,CAAC,SAAS,IAAI,CAAC;4BACtC,yCAAyC;4BACzC,SAAS,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;yBACrC,CAAC;wBACF,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;4BACtB,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;wBAC5C,CAAC;wBACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;oBACvD,CAAC;oBACD,yBAAyB;oBACzB,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;wBAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC7E,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAhFD,oEAgFC"}

package/lib/write_concern.js.map

@@ -1 +1 @@
-{"version":3,"file":"write_concern.js","sourceRoot":"","sources":["../src/write_concern.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"write_concern.js","sourceRoot":"","sources":["../src/write_concern.ts"],"names":[],"mappings":"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"}

package/mongodb.d.ts

@@ -514,6 +514,13 @@ export declare type AnyBulkWriteOperation<TSchema extends Document = Document> =
     deleteMany: DeleteManyModel<TSchema>;
 };
 
+/**
+ * Used to represent any of the client bulk write models that can be passed as an array
+ * to MongoClient#bulkWrite.
+ * @public
+ */
+export declare type AnyClientBulkWriteModel = ClientInsertOneModel | ClientReplaceOneModel | ClientUpdateOneModel | ClientUpdateManyModel | ClientDeleteOneModel | ClientDeleteManyModel;
+
 /** @public */
 export declare type AnyError = MongoError | Error;
 
@@ -1480,6 +1487,100 @@ export declare interface ChangeStreamUpdateDocument<TSchema extends Document = D
     fullDocumentBeforeChange?: TSchema;
 }
 
+/** @public */
+export declare interface ClientBulkWriteOptions extends CommandOperationOptions {
+    /**
+     * If true, when an insert fails, don't execute the remaining writes.
+     * If false, continue with remaining inserts when one fails.
+     * @defaultValue `true` - inserts are ordered by default
+     */
+    ordered?: boolean;
+    /**
+     * Allow driver to bypass schema validation.
+     * @defaultValue `false` - documents will be validated by default
+     **/
+    bypassDocumentValidation?: boolean;
+    /** Map of parameter names and values that can be accessed using $$var (requires MongoDB 5.0). */
+    let?: Document;
+    /**
+     * Whether detailed results for each successful operation should be included in the returned
+     * BulkWriteResult.
+     */
+    verboseResults?: boolean;
+}
+
+/** @public */
+export declare interface ClientBulkWriteResult {
+    /**
+     * The total number of documents inserted across all insert operations.
+     */
+    insertedCount: number;
+    /**
+     * The total number of documents upserted across all update operations.
+     */
+    upsertedCount: number;
+    /**
+     * The total number of documents matched across all update operations.
+     */
+    matchedCount: number;
+    /**
+     * The total number of documents modified across all update operations.
+     */
+    modifiedCount: number;
+    /**
+     * The total number of documents deleted across all delete operations.
+     */
+    deletedCount: number;
+    /**
+     * The results of each individual insert operation that was successfully performed.
+     */
+    insertResults?: Map<number, ClientInsertOneResult>;
+    /**
+     * The results of each individual update operation that was successfully performed.
+     */
+    updateResults?: Map<number, ClientUpdateResult>;
+    /**
+     * The results of each individual delete operation that was successfully performed.
+     */
+    deleteResults?: Map<number, ClientDeleteResult>;
+}
+
+/** @public */
+export declare interface ClientDeleteManyModel extends ClientWriteModel {
+    name: 'deleteMany';
+    /**
+     * The filter used to determine if a document should be deleted.
+     * For a deleteMany operation, all matches are removed.
+     */
+    filter: Filter<Document>;
+    /** Specifies a collation. */
+    collation?: CollationOptions;
+    /** The index to use. If specified, then the query system will only consider plans using the hinted index. */
+    hint?: Hint;
+}
+
+/** @public */
+export declare interface ClientDeleteOneModel extends ClientWriteModel {
+    name: 'deleteOne';
+    /**
+     * The filter used to determine if a document should be deleted.
+     * For a deleteOne operation, the first match is removed.
+     */
+    filter: Filter<Document>;
+    /** Specifies a collation. */
+    collation?: CollationOptions;
+    /** The index to use. If specified, then the query system will only consider plans using the hinted index. */
+    hint?: Hint;
+}
+
+/** @public */
+export declare interface ClientDeleteResult {
+    /**
+     * The number of documents that were deleted.
+     */
+    deletedCount: number;
+}
+
 /**
  * @public
  * The public interface for explicit in-use encryption
@@ -1901,6 +2002,21 @@ export declare type ClientEncryptionSocketOptions = Pick<MongoClientOptions, 'au
  */
 export declare type ClientEncryptionTlsOptions = Pick<MongoClientOptions, 'tlsCAFile' | 'tlsCertificateKeyFile' | 'tlsCertificateKeyFilePassword'>;
 
+/** @public */
+export declare interface ClientInsertOneModel extends ClientWriteModel {
+    name: 'insertOne';
+    /** The document to insert. */
+    document: OptionalId<Document>;
+}
+
+/** @public */
+export declare interface ClientInsertOneResult {
+    /**
+     * The _id of the inserted document.
+     */
+    insertedId: any;
+}
+
 /**
  * @public
  * @see https://github.com/mongodb/specifications/blob/master/source/mongodb-handshake/handshake.rst#hello-command
@@ -1940,6 +2056,24 @@ export declare interface ClientMetadataOptions {
     appName?: string;
 }
 
+/** @public */
+export declare interface ClientReplaceOneModel extends ClientWriteModel {
+    name: 'replaceOne';
+    /**
+     * The filter used to determine if a document should be replaced.
+     * For a replaceOne operation, the first match is replaced.
+     */
+    filter: Filter<Document>;
+    /** The document with which to replace the matched document. */
+    replacement: WithoutId<Document>;
+    /** Specifies a collation. */
+    collation?: CollationOptions;
+    /** The index to use. If specified, then the query system will only consider plans using the hinted index. */
+    hint?: Hint;
+    /** When true, creates a new document if no document matches the query. */
+    upsert?: boolean;
+}
+
 /**
  * A class representing a client session on the server
  *
@@ -2094,6 +2228,84 @@ export declare interface ClientSessionOptions {
     /* Excluded from this release type: initialClusterTime */
 }
 
+/** @public */
+export declare interface ClientUpdateManyModel extends ClientWriteModel {
+    name: 'updateMany';
+    /**
+     * The filter used to determine if a document should be updated.
+     * For an updateMany operation, all matches are updated.
+     */
+    filter: Filter<Document>;
+    /**
+     * The modifications to apply. The value can be either:
+     * UpdateFilter<Document> - A document that contains update operator expressions,
+     * Document[] - an aggregation pipeline.
+     */
+    update: UpdateFilter<Document> | Document[];
+    /** A set of filters specifying to which array elements an update should apply. */
+    arrayFilters?: Document[];
+    /** Specifies a collation. */
+    collation?: CollationOptions;
+    /** The index to use. If specified, then the query system will only consider plans using the hinted index. */
+    hint?: Hint;
+    /** When true, creates a new document if no document matches the query. */
+    upsert?: boolean;
+}
+
+/** @public */
+export declare interface ClientUpdateOneModel extends ClientWriteModel {
+    name: 'updateOne';
+    /**
+     * The filter used to determine if a document should be updated.
+     * For an updateOne operation, the first match is updated.
+     */
+    filter: Filter<Document>;
+    /**
+     * The modifications to apply. The value can be either:
+     * UpdateFilter<Document> - A document that contains update operator expressions,
+     * Document[] - an aggregation pipeline.
+     */
+    update: UpdateFilter<Document> | Document[];
+    /** A set of filters specifying to which array elements an update should apply. */
+    arrayFilters?: Document[];
+    /** Specifies a collation. */
+    collation?: CollationOptions;
+    /** The index to use. If specified, then the query system will only consider plans using the hinted index. */
+    hint?: Hint;
+    /** When true, creates a new document if no document matches the query. */
+    upsert?: boolean;
+}
+
+/** @public */
+export declare interface ClientUpdateResult {
+    /**
+     * The number of documents that matched the filter.
+     */
+    matchedCount: number;
+    /**
+     * The number of documents that were modified.
+     */
+    modifiedCount: number;
+    /**
+     * The _id field of the upserted document if an upsert occurred.
+     *
+     * It MUST be possible to discern between a BSON Null upserted ID value and this field being
+     * unset. If necessary, drivers MAY add a didUpsert boolean field to differentiate between
+     * these two cases.
+     */
+    upsertedId?: any;
+    /**
+     * Determines if the upsert did include an _id, which includes the case of the _id being null.
+     */
+    didUpsert: boolean;
+}
+
+/** @public */
+export declare interface ClientWriteModel {
+    /** The namespace for the write. */
+    namespace: string;
+}
+
 /**
  * @public
  * @deprecated This interface is deprecated and will be removed in a future release as it is not used
@@ -4894,6 +5106,28 @@ export declare class MongoBatchReExecutionError extends MongoAPIError {
     get name(): string;
 }
 
+/**
+ * An error indicating that an error occurred when processing bulk write results.
+ *
+ * @public
+ * @category Error
+ */
+export declare class MongoBulkWriteCursorError extends MongoRuntimeError {
+    /**
+     * **Do not use this constructor!**
+     *
+     * Meant for internal use only.
+     *
+     * @remarks
+     * This class is only meant to be constructed within the driver. This constructor is
+     * not subject to semantic versioning compatibility guarantees and may change at any time.
+     *
+     * @public
+     **/
+    constructor(message: string);
+    get name(): string;
+}
+
 /**
  * An error indicating an unsuccessful Bulk Write
  * @public
@@ -5001,6 +5235,15 @@ export declare class MongoClient extends TypedEventEmitter<MongoClientEvents> im
     get writeConcern(): WriteConcern | undefined;
     get readPreference(): ReadPreference;
     get bsonOptions(): BSONSerializeOptions;
+    /**
+     * Executes a client bulk write operation, available on server 8.0+.
+     * @param models - The client bulk write models.
+     * @param options - The client bulk write options.
+     * @returns A ClientBulkWriteResult for acknowledged writes and ok: 1 for unacknowledged writes.
+     */
+    bulkWrite(models: AnyClientBulkWriteModel[], options?: ClientBulkWriteOptions): Promise<ClientBulkWriteResult | {
+        ok: 1;
+    }>;
     /**
      * Connect to MongoDB using a url
      *
@@ -7751,7 +7994,10 @@ export declare type WithTransactionCallback<T = any> = (session: ClientSession)
  * @see https://www.mongodb.com/docs/manual/reference/write-concern/
  */
 export declare class WriteConcern {
-    /** Request acknowledgment that the write operation has propagated to a specified number of mongod instances or to mongod instances with specified tags. */
+    /**
+     * Request acknowledgment that the write operation has propagated to a specified number of mongod instances or to mongod instances with specified tags.
+     * If w is 0 and is set on a write operation, the server will not send a response.
+     */
     readonly w?: W;
     /** Request acknowledgment that the write operation has been written to the on-disk journal */
     readonly journal?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mongodb",
-  "version": "6.9.0-dev.20240917.sha.20396e1b",
+  "version": "6.9.0-dev.20240926.sha.3d3da407",
   "description": "The official MongoDB driver for Node.js",
   "main": "lib/index.js",
   "files": [

package/src/cmap/command_monitoring_events.ts

@@ -7,7 +7,12 @@ import {
   LEGACY_HELLO_COMMAND_CAMEL_CASE
 } from '../constants';
 import { calculateDurationInMs, deepCopy } from '../utils';
-import { OpMsgRequest, type OpQueryRequest, type WriteProtocolMessageType } from './commands';
+import {
+  DocumentSequence,
+  OpMsgRequest,
+  type OpQueryRequest,
+  type WriteProtocolMessageType
+} from './commands';
 import type { Connection } from './connection';
 
 /**
@@ -249,7 +254,16 @@ const OP_QUERY_KEYS = [
 /** Extract the actual command from the query, possibly up-converting if it's a legacy format */
 function extractCommand(command: WriteProtocolMessageType): Document {
   if (command instanceof OpMsgRequest) {
-    return deepCopy(command.command);
+    const cmd = deepCopy(command.command);
+    // For OP_MSG with payload type 1 we need to pull the documents
+    // array out of the document sequence for monitoring.
+    if (cmd.ops instanceof DocumentSequence) {
+      cmd.ops = cmd.ops.documents;
+    }
+    if (cmd.nsInfo instanceof DocumentSequence) {
+      cmd.nsInfo = cmd.nsInfo.documents;
+    }
+    return cmd;
   }
 
   if (command.query?.$query) {

package/src/cmap/commands.ts

@@ -74,6 +74,8 @@ export class OpQueryRequest {
   awaitData: boolean;
   exhaust: boolean;
   partial: boolean;
+  /** moreToCome is an OP_MSG only concept */
+  moreToCome = false;
 
   constructor(
     public databaseName: string,
@@ -407,13 +409,21 @@ const OPTS_EXHAUST_ALLOWED = 1 << 16;
 
 /** @internal */
 export interface OpMsgOptions {
-  requestId: number;
-  serializeFunctions: boolean;
-  ignoreUndefined: boolean;
-  checkKeys: boolean;
-  maxBsonSize: number;
-  moreToCome: boolean;
-  exhaustAllowed: boolean;
+  socketTimeoutMS?: number;
+  session?: ClientSession;
+  numberToSkip?: number;
+  numberToReturn?: number;
+  returnFieldSelector?: Document;
+  pre32Limit?: number;
+  serializeFunctions?: boolean;
+  ignoreUndefined?: boolean;
+  maxBsonSize?: number;
+  checkKeys?: boolean;
+  secondaryOk?: boolean;
+
+  requestId?: number;
+  moreToCome?: boolean;
+  exhaustAllowed?: boolean;
   readPreference: ReadPreference;
 }
 
@@ -465,7 +475,7 @@ export class OpMsgRequest {
 
     // flags
     this.checksumPresent = false;
-    this.moreToCome = options.moreToCome || false;
+    this.moreToCome = options.moreToCome ?? command.writeConcern?.w === 0;
     this.exhaustAllowed =
       typeof options.exhaustAllowed === 'boolean' ? options.exhaustAllowed : false;
   }
@@ -534,10 +544,10 @@ export class OpMsgRequest {
     for (const [key, value] of Object.entries(document)) {
       if (value instanceof DocumentSequence) {
         // Document sequences starts with type 1 at the first byte.
-        const buffer = Buffer.allocUnsafe(1 + 4 + key.length);
+        const buffer = Buffer.allocUnsafe(1 + 4 + key.length + 1);
         buffer[0] = 1;
-        // Third part is the field name at offset 5.
-        encodeUTF8Into(buffer, key, 5);
+        // Third part is the field name at offset 5 with trailing null byte.
+        encodeUTF8Into(buffer, `${key}\0`, 5);
         chunks.push(buffer);
         // Fourth part are the documents' bytes.
         let docsLength = 0;
@@ -547,7 +557,7 @@ export class OpMsgRequest {
           chunks.push(docBson);
         }
         // Second part of the sequence is the length at offset 1;
-        buffer.writeInt32LE(key.length + docsLength, 1);
+        buffer.writeInt32LE(4 + key.length + 1 + docsLength, 1);
         // Why are we removing the field from the command? This is because it needs to be
         // removed in the OP_MSG request first section, and DocumentSequence is not a
         // BSON type and is specific to the MongoDB wire protocol so there's nothing

package/src/cmap/connection.ts

@@ -439,7 +439,7 @@ export class Connection extends TypedEventEmitter<ConnectionEvents> {
         zlibCompressionLevel: this.description.zlibCompressionLevel
       });
 
-      if (options.noResponse) {
+      if (options.noResponse || message.moreToCome) {
         yield MongoDBResponse.empty;
         return;
       }
@@ -527,7 +527,11 @@ export class Connection extends TypedEventEmitter<ConnectionEvents> {
             new CommandSucceededEvent(
               this,
               message,
-              options.noResponse ? undefined : (object ??= document.toObject(bsonOptions)),
+              options.noResponse
+                ? undefined
+                : message.moreToCome
+                  ? { ok: 1 }
+                  : (object ??= document.toObject(bsonOptions)),
               started,
               this.description.serverConnectionId
             )

package/src/cmap/wire_protocol/responses.ts

@@ -329,3 +329,29 @@ export class ExplainedCursorResponse extends CursorResponse {
     return this.toObject(options);
   }
 }
+
+/**
+ * Client bulk writes have some extra metadata at the top level that needs to be
+ * included in the result returned to the user.
+ */
+export class ClientBulkWriteCursorResponse extends CursorResponse {
+  get insertedCount() {
+    return this.get('nInserted', BSONType.int, true);
+  }
+
+  get upsertedCount() {
+    return this.get('nUpserted', BSONType.int, true);
+  }
+
+  get matchedCount() {
+    return this.get('nMatched', BSONType.int, true);
+  }
+
+  get modifiedCount() {
+    return this.get('nModified', BSONType.int, true);
+  }
+
+  get deletedCount() {
+    return this.get('nDeleted', BSONType.int, true);
+  }
+}

package/src/cursor/client_bulk_write_cursor.ts

@@ -0,0 +1,73 @@
+import type { Document } from '../bson';
+import { type ClientBulkWriteCursorResponse } from '../cmap/wire_protocol/responses';
+import { MongoBulkWriteCursorError } from '../error';
+import type { MongoClient } from '../mongo_client';
+import { ClientBulkWriteOperation } from '../operations/client_bulk_write/client_bulk_write';
+import { type ClientBulkWriteOptions } from '../operations/client_bulk_write/common';
+import { executeOperation } from '../operations/execute_operation';
+import type { ClientSession } from '../sessions';
+import { mergeOptions, MongoDBNamespace } from '../utils';
+import {
+  AbstractCursor,
+  type AbstractCursorOptions,
+  type InitialCursorResponse
+} from './abstract_cursor';
+
+/** @public */
+export interface ClientBulkWriteCursorOptions
+  extends Omit<AbstractCursorOptions, 'maxAwaitTimeMS' | 'tailable' | 'awaitData'>,
+    ClientBulkWriteOptions {}
+
+/**
+ * This is the cursor that handles client bulk write operations. Note this is never
+ * exposed directly to the user and is always immediately exhausted.
+ * @internal
+ */
+export class ClientBulkWriteCursor extends AbstractCursor {
+  public readonly command: Document;
+  /** @internal */
+  private cursorResponse?: ClientBulkWriteCursorResponse;
+  /** @internal */
+  private clientBulkWriteOptions: ClientBulkWriteOptions;
+
+  /** @internal */
+  constructor(client: MongoClient, command: Document, options: ClientBulkWriteOptions = {}) {
+    super(client, new MongoDBNamespace('admin', '$cmd'), options);
+
+    this.command = command;
+    this.clientBulkWriteOptions = options;
+  }
+
+  /**
+   * We need a way to get the top level cursor response fields for
+   * generating the bulk write result, so we expose this here.
+   */
+  get response(): ClientBulkWriteCursorResponse {
+    if (this.cursorResponse) return this.cursorResponse;
+    throw new MongoBulkWriteCursorError(
+      'No client bulk write cursor response returned from the server.'
+    );
+  }
+
+  clone(): ClientBulkWriteCursor {
+    const clonedOptions = mergeOptions({}, this.clientBulkWriteOptions);
+    delete clonedOptions.session;
+    return new ClientBulkWriteCursor(this.client, this.command, {
+      ...clonedOptions
+    });
+  }
+
+  /** @internal */
+  async _initialize(session: ClientSession): Promise<InitialCursorResponse> {
+    const clientBulkWriteOperation = new ClientBulkWriteOperation(this.command, {
+      ...this.clientBulkWriteOptions,
+      ...this.cursorOptions,
+      session
+    });
+
+    const response = await executeOperation(this.client, clientBulkWriteOperation);
+    this.cursorResponse = response;
+
+    return { server: clientBulkWriteOperation.server, session, response };
+  }
+}

package/src/error.ts

@@ -616,6 +616,33 @@ export class MongoGCPError extends MongoOIDCError {
   }
 }
 
+/**
+ * An error indicating that an error occurred when processing bulk write results.
+ *
+ * @public
+ * @category Error
+ */
+export class MongoBulkWriteCursorError extends MongoRuntimeError {
+  /**
+   * **Do not use this constructor!**
+   *
+   * Meant for internal use only.
+   *
+   * @remarks
+   * This class is only meant to be constructed within the driver. This constructor is
+   * not subject to semantic versioning compatibility guarantees and may change at any time.
+   *
+   * @public
+   **/
+  constructor(message: string) {
+    super(message);
+  }
+
+  override get name(): string {
+    return 'MongoBulkWriteCursorError';
+  }
+}
+
 /**
  * An error generated when a ChangeStream operation fails to execute.
  *