@go-avro/avro-js 0.0.47 → 0.0.48

package/dist/client/QueryClient.d.ts

@@ -12,6 +12,13 @@ import type { BulkDeleteBillsResponse, BulkEmailBillsResponse } from '../client/
 /** Callbacks for a tracked email request. */
 export interface TrackEmailOptions {
     emailType?: EmailType;
+    /**
+     * Pre-existing request_id to register. When omitted, a fresh uuid is
+     * generated. Pass this when the request_id was produced elsewhere
+     * (e.g. a bulk endpoint returns one in its synchronous response, or
+     * the caller wants to pre-generate it and ship it in the POST body).
+     */
+    requestId?: string;
     /** How long to wait before firing onTimeout (ms). Default 30 000. */
     timeout?: number;
     onSuccess?: (data: EmailSucceededPayload) => void;

package/dist/client/QueryClient.js

@@ -1142,8 +1142,15 @@ export class AvroQueryClient {
      */
     trackEmail(options = {}) {
         this._initEmailListeners();
-        const requestId = uuidv4();
+        const requestId = options.requestId ?? uuidv4();
         const { timeout = 30000 } = options;
+        // If this request_id is already being tracked, replace the existing
+        // entry so the latest caller's handlers win. (Callers that reuse a
+        // request_id are explicitly opting in to this behaviour.)
+        const existing = this._emailTracking.get(requestId);
+        if (existing) {
+            clearTimeout(existing.timerId);
+        }
         const timerId = setTimeout(() => {
             this._emailTracking.delete(requestId);
             options.onTimeout?.(requestId);

package/dist/client/hooks/email.d.ts

@@ -43,7 +43,10 @@ export interface UseEmailStatusOptions {
  * ```
  */
 export declare function useEmailStatus(options?: UseEmailStatusOptions): {
-    readonly trackEmail: (emailType?: EmailType) => string;
+    readonly trackEmail: (emailType?: EmailType, opts?: {
+        requestId?: string;
+        timeout?: number;
+    }) => string;
     readonly pending: Map<string, {
         emailType?: EmailType;
         trackedAt: number;

package/dist/client/hooks/email.js

@@ -36,10 +36,11 @@ export function useEmailStatus(options = {}) {
     const [pending, setPending] = useState(new Map());
     const [results, setResults] = useState(new Map());
     /* ── trackEmail — delegates to client.trackEmail() ──────────────── */
-    const trackEmail = useCallback((emailType) => {
+    const trackEmail = useCallback((emailType, opts = {}) => {
         const requestId = client.trackEmail({
             emailType,
-            timeout,
+            requestId: opts.requestId,
+            timeout: opts.timeout ?? timeout,
             onSuccess: (data) => {
                 const result = {
                     requestId: data.request_id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@go-avro/avro-js",
-  "version": "0.0.47",
+  "version": "0.0.48",
   "description": "JS client for Avro backend integration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",