Add function to BaseConvexClient to return a mutation's request ID (#…

…32373)

Related to get-convex/convex#32367, but when we request a mutation, we want to get its request ID so we can track it properly and potentially handle it being reflected in the `onTransition` callback.

GitOrigin-RevId: 1525f6de224bb88acba013dd6841cd53f0260b6b

src/browser/sync/client.ts

@@ -719,6 +719,24 @@ export class BaseConvexClient {
     options?: MutationOptions,
     componentPath?: string,
   ): Promise<FunctionResult> {
+    const { mutationPromise } = this.enqueueMutation(
+      udfPath,
+      args,
+      options,
+      componentPath,
+    );
+    return mutationPromise;
+  }
+
+  /**
+   * @internal
+   */
+  enqueueMutation(
+    udfPath: string,
+    args?: Record<string, Value>,
+    options?: MutationOptions,
+    componentPath?: string,
+  ): { requestId: RequestId; mutationPromise: Promise<FunctionResult> } {
     const mutationArgs = parseArgs(args);
     this.tryReportLongDisconnect();
     const requestId = this.nextRequestId;
@@ -770,7 +788,11 @@ export class BaseConvexClient {
       args: [convexToJson(mutationArgs)],
     };
     const mightBeSent = this.webSocketManager.sendMessage(message);
-    return this.requestManager.request(message, mightBeSent);
+    const mutationPromise = this.requestManager.request(message, mightBeSent);
+    return {
+      requestId,
+      mutationPromise,
+    };
   }
 
   /**