add yaml files

Author: qingyang-hu

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

@@ -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: {}
+                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: {}
+                rawData:
+                  $$exists: false

source/crud/bulk-write.md

@@ -309,6 +309,15 @@ class BulkWriteOptions {
      */
     comment: Optional<BSON value>;
 
+    /**
+     * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+     *
+     * @note This option will not be sent when connected to pre-9.0 servers.
+     *
+     * @since MongoDB 8.2
+     */
+    rawData: Optional<Boolean>;
+
     /**
      * Whether detailed results for each successful operation should be included in the returned
      * BulkWriteResult.
@@ -538,6 +547,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 +927,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`.

source/crud/crud.md

@@ -319,6 +319,15 @@ class AggregateOptions {
    * @see https://www.mongodb.com/docs/manual/reference/command/aggregate/
    */
   let: Optional<Document>;
+
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class CountOptions {
@@ -371,6 +380,15 @@ class CountOptions {
    * and providing one will result in a server-side error.
    */
   comment: Optional<any>;
+
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class EstimatedDocumentCountOptions {
@@ -395,6 +413,15 @@ class EstimatedDocumentCountOptions {
    * comment may result in a server-side error.
    */
   comment: Optional<any>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class DistinctOptions {
@@ -439,6 +466,15 @@ class DistinctOptions {
    * @see https://www.mongodb.com/docs/manual/reference/command/find/
    */
   hint: Optional<(String | Document)>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 enum CursorType {
@@ -713,6 +749,15 @@ class FindOptions {
    * @see https://www.mongodb.com/docs/manual/reference/command/find/
    */
   let: Optional<Document>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 type FindOneOptions = Omit<FindOptions, 'batchSize' | 'cursorType' | 'limit' | 'noCursorTimeout'>;
@@ -985,6 +1030,15 @@ class BulkWriteOptions {
    * The value of let will be passed to all update and delete, but not insert, commands.
    */
   let: Optional<Document>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class InsertOneOptions {
@@ -1007,6 +1061,15 @@ class InsertOneOptions {
    * and providing one will result in a server-side error.
    */
   comment: Optional<any>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class InsertManyOptions {
@@ -1036,6 +1099,15 @@ class InsertManyOptions {
    * and providing one will result in a server-side error.
    */
   comment: Optional<any>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class UpdateOptions {
@@ -1127,6 +1199,15 @@ class UpdateOptions {
    * @see https://www.mongodb.com/docs/manual/reference/command/update/
    */
   sort: Optional<Document>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class ReplaceOptions {
@@ -1206,6 +1287,15 @@ class ReplaceOptions {
    * @see https://www.mongodb.com/docs/manual/reference/command/update/
    */
   sort: Optional<Document>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class DeleteOptions {
@@ -1256,6 +1346,15 @@ class DeleteOptions {
    * and providing one will result in a server-side error.
    */
   comment: Optional<any>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 ```
 
@@ -2009,6 +2108,15 @@ class FindOneAndDeleteOptions {
    * and providing one will result in a server-side error.
    */
   comment: Optional<any>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class FindOneAndReplaceOptions {
@@ -2117,6 +2225,15 @@ class FindOneAndReplaceOptions {
    * and providing one will result in a server-side error.
    */
   comment: Optional<any>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 
 class FindOneAndUpdateOptions {
@@ -2234,6 +2351,15 @@ class FindOneAndUpdateOptions {
    * and providing one will result in a server-side error.
    */
   comment: Optional<any>;
+  
+  /**
+   * This option allows operations to function on the bucket-level data while accessing the primary namespace (not system.buckets).
+   *
+   * @note This option will not be sent when connected to pre-9.0 servers.
+   *
+   * @since MongoDB 8.2
+   */
+  rawData: Optional<Boolean>;
 }
 ```
 
@@ -2512,6 +2638,8 @@ aforementioned allowance in the SemVer spec.
 
 ## Changelog
 
+- 2025-06-27: Added `rawData` options.
+
 - 2024-11-13: Define `findOne` operation as optional, and add guidance on `limit` and `batchSize` for `find` operations.
 
 - 2024-11-04: Always send a value for `bypassDocumentValidation` if it was specified.

source/crud/tests/unified/aggregate-rawdata.yml

@@ -0,0 +1,55 @@
+description: "aggregate-rawData"
+
+schemaVersion: "1.4"
+
+createEntities:
+  - client:
+      id: &client0 client0
+      observeEvents: [ commandStartedEvent ]
+  - database:
+      id: &database0 database0
+      client: *client0
+      databaseName: &database0Name crud-tests
+  - collection:
+      id: &collection0 collection0
+      database: *database0
+      collectionName: &collection0Name coll0
+
+tests:
+  - description: "Aggregate with rawData option"
+    runOnRequirements:
+      - minServerVersion: "8.2.0"
+    operations:
+      - name: aggregate
+        object: *collection0
+        arguments:
+          pipeline: &pipeline0
+            - $match: {}
+          rawData: &rawdata true
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collection0Name
+                pipeline: *pipeline0
+                rawData: *rawdata
+  - description: "Aggregate with rawData option on less than 8.2.0 - ignore argument"
+    runOnRequirements:
+      - maxServerVersion: "8.1.99"
+    operations:
+      - name: aggregate
+        object: *collection0
+        arguments:
+          pipeline: &pipeline0
+            - $match: {}
+          rawData: true
+    expectEvents:
+      - client: *client0
+        events:
+          - commandStartedEvent:
+              command:
+                aggregate: *collection0Name
+                pipeline: *pipeline0
+                rawData:
+                  $$exists: false