DRIVERS-3064 Add support for the rawData command option (#1814)

Co-authored-by: Andreas Braun <[email protected]>

Author: qingyang-hu

source/collection-management/tests/listCollections-rawdata.json

@@ -0,0 +1,49 @@
+description: "listCollections-rawData"
+
+schemaVersion: "1.4"
+
+createEntities:
+  - client:
+      id: &client0 client0
+      observeEvents: [ commandStartedEvent ]
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: &database0Name database0
+
+tests:
+  - description: "listCollections with rawData option"
+    runOnRequirements:
+      - minServerVersion: "8.2.0"
+        auth: false
+    operations:
+      - name: listCollections
+        object: *database0
+        arguments:
+          rawData: &rawdata true
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                listCollections: 1
+                filter: { $$unsetOrMatches: {} }
+                rawData: *rawdata
+  - description: "listCollections with rawData option on less than 8.2.0 - ignore argument"
+    runOnRequirements:
+      - maxServerVersion: "8.1.99"
+        auth: false
+    operations:
+      - name: listCollections
+        object: *database0
+        arguments:
+          rawData: true
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                listCollections: 1
+                filter: { $$unsetOrMatches: {} }
+                rawData:
+                  $$exists: false

source/collection-management/tests/listCollections-rawdata.yml

@@ -309,6 +309,16 @@ class BulkWriteOptions {
      */
     comment: Optional<BSON value>;
 
+    /**
+     * This option MAY be implemented by drivers that need to grant access to underlying namespaces
+     * for time-series collections. Drivers SHOULD NOT implement this option unless asked to do so.
+     *
+     * @note This option MUST NOT be sent when connected to pre-8.2 servers.
+     *
+     * @since MongoDB 8.2
+     */
+    rawData: Optional<Boolean>;
+
     /**
      * Whether detailed results for each successful operation should be included in the returned
      * BulkWriteResult.
@@ -538,6 +548,7 @@ The `bulkWrite` server command has the following format:
     "bypassDocumentValidation": Optional<Boolean>,
     "comment": Optional<BSON value>,
     "let": Optional<Document>,
+    "rawData": Optional<Boolean>,
     ...additional operation-agnostic fields
 }
 ```
@@ -917,6 +928,8 @@ error in this specific situation does not seem helpful enough to require size ch
 
 ## **Changelog**
 
+- 2025-06-27: Added `rawData` option.
+
 - 2024-11-05: Updated the requirements regarding the size validation.
 
 - 2024-10-07: Error if `w:0` is used with `ordered=true` or `verboseResults=true`.