fix(mutate): reflect support for providing transaction id in typings (#187)

Author: rexxars

src/data/dataMethods.ts

@@ -187,7 +187,7 @@ export function _mutate<R extends Record<string, Any>>(
   }
 
   const muts = Array.isArray(mut) ? mut : [mut]
-  const transactionId = options && (options as Any).transactionId
+  const transactionId = (options && options.transactionId) || undefined
   return _dataRequest(client, httpRequest, 'mutate', {mutations: muts, transactionId}, options)
 }
 

src/types.ts

@@ -481,6 +481,7 @@ export type BaseMutationOptions = RequestOptions & {
   dryRun?: boolean
   autoGenerateArrayKeys?: boolean
   skipCrossDatasetReferenceValidation?: boolean
+  transactionId?: string
 }
 
 /** @internal */

test/client.test.ts

@@ -917,6 +917,24 @@ describe('client', async () => {
       await expect(getClient().mutate(mutations, {tag: 'foobar'})).resolves.not.toThrow()
     })
 
+    test.skipIf(isEdge)('mutate() accepts transaction id', async () => {
+      const mutations = [{delete: {id: 'abc123'}}]
+
+      nock(projectHost())
+        .post('/v1/data/mutate/foo?returnIds=true&returnDocuments=true&visibility=sync', {
+          mutations,
+          transactionId: 'spec-ific',
+        })
+        .reply(200, {
+          transactionId: 'spec-ific',
+          results: [{id: 'abc123', operation: 'delete', document: {_id: 'abc123'}}],
+        })
+
+      await expect(
+        getClient().mutate(mutations, {transactionId: 'spec-ific'})
+      ).resolves.not.toThrow()
+    })
+
     test.skipIf(isEdge)('mutate() accepts `autoGenerateArrayKeys`', async () => {
       const mutations = [
         {