Update Item batch operation method signature (#23652)

* update method signature

* update api documentation

* update data type

* change formatting

* update operation response check

* update any type to unknown type

Co-authored-by: Will Temple <witemple@microsoft.com>

* add operation response import

Co-authored-by: Manik Khandelwal <mkhandelwal@microsoft.com>
Co-authored-by: Will Temple <witemple@microsoft.com>

sdk/cosmosdb/cosmos/review/cosmos.api.md

@@ -896,7 +896,7 @@ export class ItemResponse<T extends ItemDefinition> extends ResourceResponse<T &
 // @public
 export class Items {
     constructor(container: Container, clientContext: ClientContext);
-    batch(operations: OperationInput[], partitionKey?: string, options?: RequestOptions): Promise<Response_2<any>>;
+    batch(operations: OperationInput[], partitionKey?: string, options?: RequestOptions): Promise<Response_2<OperationResponse[]>>;
     bulk(operations: OperationInput[], bulkOptions?: BulkOptions, options?: RequestOptions): Promise<OperationResponse[]>;
     changeFeed(partitionKey: string | number | boolean, changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<any>;
     changeFeed(changeFeedOptions?: ChangeFeedOptions): ChangeFeedIterator<any>;

sdk/cosmosdb/cosmos/src/client/Item/Items.ts

@@ -501,7 +501,7 @@ export class Items {
     operations: OperationInput[],
     partitionKey: string = "[{}]",
     options?: RequestOptions
-  ): Promise<Response<any>> {
+  ): Promise<Response<OperationResponse[]>> {
     operations.map((operation) => decorateBatchOperation(operation, options));
 
     const path = getPathFromLink(this.container.url, ResourceType.item);
@@ -510,7 +510,7 @@ export class Items {
       throw new Error("Cannot run batch request with more than 100 operations per partition");
     }
     try {
-      const response = await this.clientContext.batch({
+      const response: Response<OperationResponse[]> = await this.clientContext.batch({
         body: operations,
         partitionKey,
         path,

sdk/cosmosdb/cosmos/test/public/functional/item.spec.ts

@@ -2,7 +2,13 @@
 // Licensed under the MIT license.
 import assert from "assert";
 import { Suite } from "mocha";
-import { Container, CosmosClient, PatchOperation, PatchOperationType } from "../../../src";
+import {
+  Container,
+  CosmosClient,
+  OperationResponse,
+  PatchOperation,
+  PatchOperationType,
+} from "../../../src";
 import { ItemDefinition } from "../../../src";
 import {
   bulkDeleteItems,
@@ -688,6 +694,7 @@ describe("bulk/batch item operations", function () {
       ];
 
       const response = await container.items.batch(operations, "A");
+      assert(isOperationResponse(response.result[0]));
       assert.strictEqual(response.result[0].statusCode, 201);
       assert.strictEqual(response.result[1].statusCode, 201);
       assert.strictEqual(response.result[2].statusCode, 200);
@@ -711,7 +718,17 @@ describe("bulk/batch item operations", function () {
       assert.strictEqual(deleteResponse.result[1].statusCode, 404);
       const { resource: readItem } = await container.item(otherItemId).read();
       assert.strictEqual(readItem, undefined);
+      assert(isOperationResponse(deleteResponse.result[0]));
     });
+
+    function isOperationResponse(object: unknown): object is OperationResponse {
+      return (
+        typeof object === "object" &&
+        object !== null &&
+        Object.prototype.hasOwnProperty.call(object, "statusCode") &&
+        Object.prototype.hasOwnProperty.call(object, "requestCharge")
+      );
+    }
   });
 });
 describe("patch operations", function () {