feat(NODE-3568)!: ensure includeResultsMetadata is false by default (mongodb#3786)

Co-authored-by: Durran Jordan <durran@gmail.com>

Author: W-A-James

src/client-side-encryption/client_encryption.ts

@@ -444,7 +444,7 @@ export class ClientEncryption implements StateMachineExecutable {
       this._keyVaultNamespace
     );
 
-    const { value } = await this._keyVaultClient
+    const value = await this._keyVaultClient
       .db(dbName)
       .collection<DataKey>(collectionName)
       .findOneAndUpdate(
@@ -506,7 +506,7 @@ export class ClientEncryption implements StateMachineExecutable {
         }
       }
     ];
-    const { value } = await this._keyVaultClient
+    const value = await this._keyVaultClient
       .db(dbName)
       .collection<DataKey>(collectionName)
       .findOneAndUpdate({ _id }, pipeline, {

src/collection.ts

@@ -819,8 +819,8 @@ export class Collection<TSchema extends Document = Document> {
   async findOneAndDelete(
     filter: Filter<TSchema>,
     options: FindOneAndDeleteOptions
-  ): Promise<ModifyResult<TSchema>>;
-  async findOneAndDelete(filter: Filter<TSchema>): Promise<ModifyResult<TSchema>>;
+  ): Promise<WithId<TSchema> | null>;
+  async findOneAndDelete(filter: Filter<TSchema>): Promise<WithId<TSchema> | null>;
   async findOneAndDelete(
     filter: Filter<TSchema>,
     options?: FindOneAndDeleteOptions
@@ -856,11 +856,11 @@ export class Collection<TSchema extends Document = Document> {
     filter: Filter<TSchema>,
     replacement: WithoutId<TSchema>,
     options: FindOneAndReplaceOptions
-  ): Promise<ModifyResult<TSchema>>;
+  ): Promise<WithId<TSchema> | null>;
   async findOneAndReplace(
     filter: Filter<TSchema>,
     replacement: WithoutId<TSchema>
-  ): Promise<ModifyResult<TSchema>>;
+  ): Promise<WithId<TSchema> | null>;
   async findOneAndReplace(
     filter: Filter<TSchema>,
     replacement: WithoutId<TSchema>,
@@ -898,11 +898,11 @@ export class Collection<TSchema extends Document = Document> {
     filter: Filter<TSchema>,
     update: UpdateFilter<TSchema>,
     options: FindOneAndUpdateOptions
-  ): Promise<ModifyResult<TSchema>>;
+  ): Promise<WithId<TSchema> | null>;
   async findOneAndUpdate(
     filter: Filter<TSchema>,
     update: UpdateFilter<TSchema>
-  ): Promise<ModifyResult<TSchema>>;
+  ): Promise<WithId<TSchema> | null>;
   async findOneAndUpdate(
     filter: Filter<TSchema>,
     update: UpdateFilter<TSchema>,

src/operations/find_and_modify.ts

@@ -30,8 +30,7 @@ export interface FindOneAndDeleteOptions extends CommandOperationOptions {
   /** Map of parameter names and values that can be accessed using $$var (requires MongoDB 5.0). */
   let?: Document;
   /**
-   * Return the ModifyResult instead of the modified document. Defaults to true
-   * but will default to false in the next major version.
+   * Return the ModifyResult instead of the modified document. Defaults to false
    */
   includeResultMetadata?: boolean;
 }
@@ -142,7 +141,7 @@ class FindAndModifyOperation extends CommandOperation<Document> {
       upsert: false
     };
 
-    options.includeResultMetadata ??= true;
+    options.includeResultMetadata ??= false;
 
     const sort = formatSort(options.sort);
     if (sort) {

test/integration/crud/crud_api.test.ts

@@ -638,7 +638,7 @@ describe('CRUD API', function () {
       it('returns the modify result', async function () {
         const result = await collection.findOneAndDelete(
           { a: 1 },
-          { projection: { b: 1 }, sort: { a: 1 } }
+          { projection: { b: 1 }, sort: { a: 1 }, includeResultMetadata: true }
         );
         expect(result?.lastErrorObject.n).to.equal(1);
         expect(result?.value.b).to.equal(1);
@@ -685,7 +685,8 @@ describe('CRUD API', function () {
             projection: { b: 1, c: 1 },
             sort: { a: 1 },
             returnDocument: ReturnDocument.AFTER,
-            upsert: true
+            upsert: true,
+            includeResultMetadata: true
           }
         );
         expect(result?.lastErrorObject.n).to.equal(1);
@@ -742,7 +743,8 @@ describe('CRUD API', function () {
             projection: { b: 1, d: 1 },
             sort: { a: 1 },
             returnDocument: ReturnDocument.AFTER,
-            upsert: true
+            upsert: true,
+            includeResultMetadata: true
           }
         );
         expect(result?.lastErrorObject.n).to.equal(1);

test/integration/crud/explain.test.ts

@@ -42,7 +42,7 @@ describe('CRUD API explain option', function () {
     {
       name: 'findOneAndDelete',
       op: async (explain: boolean | string) =>
-        await collection.findOneAndDelete({ a: 1 }, { explain })
+        await collection.findOneAndDelete({ a: 1 }, { explain, includeResultMetadata: true })
     },
     {
       name: 'findOne',
@@ -52,7 +52,11 @@ describe('CRUD API explain option', function () {
     {
       name: 'findOneAndReplace',
       op: async (explain: boolean | string) =>
-        await collection.findOneAndReplace({ a: 1 }, { a: 2 }, { explain })
+        await collection.findOneAndReplace(
+          { a: 1 },
+          { a: 2 },
+          { explain, includeResultMetadata: true }
+        )
     },
     {
       name: 'aggregate',