@stamprally/react 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -36,10 +36,28 @@ function isOnline(adapter) {
 function isRejectedVerification(value) {
   return value === false || typeof value === "object" && value !== null && "ok" in value && value.ok === false;
 }
+function isNetworkFailure(error) {
+  if (typeof navigator !== "undefined" && navigator.onLine === false) return true;
+  if (!(error instanceof Error)) return true;
+  return /aborted|connection|fetch|network|offline|timeout/i.test(`${error.name} ${error.message}`);
+}
+function notifyAcquisitionEvents(result, events, onStampClaimed, onRewardUnlocked) {
+  for (const event of result.events) {
+    if (event.type === "stampAcquired") {
+      (events?.onStampClaimed ?? onStampClaimed)?.(event.record);
+    }
+    if (event.type === "rewardUnlocked") {
+      (events?.onRewardUnlocked ?? onRewardUnlocked)?.(event.rewardId);
+    }
+  }
+}
 function useStampRally(client, options = {}) {
   const syncAdapter = options.syncAdapter;
   const events = options.events;
-  const queuedRequests = react.useRef([]);
+  const [offlineQueue, setOfflineQueue] = react.useState([]);
+  const queuedMetadata = react.useRef(/* @__PURE__ */ new Map());
+  const isFlushingQueue = react.useRef(false);
+  const activeClient = react.useRef(client);
   const subscribe = react.useCallback(
     (onStoreChange) => client.subscribe(() => onStoreChange()),
     [client]
@@ -57,6 +75,12 @@ function useStampRally(client, options = {}) {
   react.useEffect(() => {
     setOptimisticState(rawState);
   }, [rawState]);
+  react.useEffect(() => {
+    if (activeClient.current === client) return;
+    activeClient.current = client;
+    setOfflineQueue([]);
+    queuedMetadata.current.clear();
+  }, [client]);
   react.useEffect(() => {
     if (syncAdapter?.onStateChange === void 0) return;
     return client.subscribe(syncAdapter.onStateChange);
@@ -84,6 +108,15 @@ function useStampRally(client, options = {}) {
       active = false;
     };
   }, [client, rawState]);
+  const queueRequest = react.useCallback(
+    (request, metadata) => {
+      if (metadata !== void 0) queuedMetadata.current.set(request.idempotencyKey, metadata);
+      setOfflineQueue(
+        (current) => current.some((item) => item.idempotencyKey === request.idempotencyKey) ? current : [...current, request]
+      );
+    },
+    []
+  );
   const acquire = react.useCallback(
     (stampId, context, now, idempotencyKey) => {
       const acquiredAt = now ?? (/* @__PURE__ */ new Date()).toISOString();
@@ -95,7 +128,7 @@ function useStampRally(client, options = {}) {
       };
       setClientError(null);
       if (!isOnline(syncAdapter)) {
-        queuedRequests.current = [...queuedRequests.current, request];
+        queueRequest(request);
         const queued = {
           ok: false,
           error: { code: "OFFLINE_QUEUED", stampId, idempotencyKey: request.idempotencyKey }
@@ -119,9 +152,29 @@ function useStampRally(client, options = {}) {
               resolve(rejected);
               return;
             }
+            const previousState = client.getState();
             const result = await client.acquire(stampId, context, acquiredAt);
             if (result.ok) {
-              const verified = await syncAdapter?.onServerVerify?.(request);
+              let verified;
+              try {
+                verified = await syncAdapter?.onServerVerify?.(request);
+              } catch (verificationError) {
+                if (!isNetworkFailure(verificationError)) throw verificationError;
+                queueRequest(request, { previousState, result: result.value });
+                const queued = {
+                  ok: false,
+                  error: {
+                    code: "OFFLINE_QUEUED",
+                    stampId,
+                    idempotencyKey: request.idempotencyKey
+                  }
+                };
+                setClientError({ client, value: toError(verificationError) });
+                setOptimisticState(client.getState());
+                setIsOperationPending(false);
+                resolve(queued);
+                return;
+              }
               if (isRejectedVerification(verified)) {
                 await client.restore(rawState ?? client.getState() ?? result.value.nextState);
                 const rejected = {
@@ -134,14 +187,12 @@ function useStampRally(client, options = {}) {
                 resolve(rejected);
                 return;
               }
-              for (const event of result.value.events) {
-                if (event.type === "stampAcquired") {
-                  (events?.onStampClaimed ?? options.onStampClaimed)?.(event.record);
-                }
-                if (event.type === "rewardUnlocked") {
-                  (events?.onRewardUnlocked ?? options.onRewardUnlocked)?.(event.rewardId);
-                }
-              }
+              notifyAcquisitionEvents(
+                result.value,
+                events,
+                options.onStampClaimed,
+                options.onRewardUnlocked
+              );
             }
             if (!result.ok) {
               setClientError({ client, value: result.error });
@@ -150,6 +201,18 @@ function useStampRally(client, options = {}) {
             setIsOperationPending(false);
             resolve(result);
           } catch (acquireError) {
+            if (isNetworkFailure(acquireError)) {
+              queueRequest(request);
+              const queued = {
+                ok: false,
+                error: { code: "OFFLINE_QUEUED", stampId, idempotencyKey: request.idempotencyKey }
+              };
+              setClientError({ client, value: queued.error });
+              setOptimisticState(client.getState());
+              setIsOperationPending(false);
+              resolve(queued);
+              return;
+            }
             const normalizedError = toError(acquireError);
             setClientError({ client, value: normalizedError });
             setOptimisticState(client.getState());
@@ -159,7 +222,15 @@ function useStampRally(client, options = {}) {
         })();
       });
     },
-    [client, events, options.onRewardUnlocked, options.onStampClaimed, rawState, syncAdapter]
+    [
+      client,
+      events,
+      options.onRewardUnlocked,
+      options.onStampClaimed,
+      queueRequest,
+      rawState,
+      syncAdapter
+    ]
   );
   const reset = react.useCallback(
     (now) => {
@@ -318,13 +389,87 @@ function useStampRally(client, options = {}) {
   const isLoading = rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);
   const error = clientError?.client === client ? clientError.value : null;
   const flushQueue = react.useCallback(async () => {
-    if (!isOnline(syncAdapter)) return;
-    const pending = queuedRequests.current;
-    queuedRequests.current = [];
-    for (const request of pending) {
-      await acquire(request.stampId, request.context, request.now, request.idempotencyKey);
+    if (!isOnline(syncAdapter) || isFlushingQueue.current) return;
+    isFlushingQueue.current = true;
+    setIsOperationPending(true);
+    try {
+      for (const request of offlineQueue) {
+        if (!isOnline(syncAdapter)) break;
+        const metadata = queuedMetadata.current.get(request.idempotencyKey);
+        const previousState = metadata?.previousState ?? client.getState();
+        try {
+          const before = await syncAdapter?.onBeforeCheckIn?.(request);
+          if (before === false) {
+            if (metadata !== void 0 && previousState !== null)
+              await client.restore(previousState);
+            setClientError({ client, value: { code: "INVALID_PROOF", stampId: request.stampId } });
+            queuedMetadata.current.delete(request.idempotencyKey);
+            setOfflineQueue(
+              (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+            );
+            continue;
+          }
+          let result = metadata?.result;
+          if (result === void 0) {
+            const localResult = await client.acquire(request.stampId, request.context, request.now);
+            if (!localResult.ok) {
+              setClientError({ client, value: localResult.error });
+              queuedMetadata.current.delete(request.idempotencyKey);
+              setOfflineQueue(
+                (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+              );
+              continue;
+            }
+            result = localResult.value;
+            queuedMetadata.current.set(request.idempotencyKey, {
+              previousState,
+              result
+            });
+          }
+          const verified = await syncAdapter?.onServerVerify?.(request);
+          if (isRejectedVerification(verified)) {
+            if (previousState !== null) await client.restore(previousState);
+            setClientError({
+              client,
+              value: { code: "INVALID_PROOF", stampId: request.stampId }
+            });
+          } else {
+            notifyAcquisitionEvents(
+              result,
+              events,
+              options.onStampClaimed,
+              options.onRewardUnlocked
+            );
+          }
+          queuedMetadata.current.delete(request.idempotencyKey);
+          setOfflineQueue(
+            (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+          );
+        } catch (flushError) {
+          if (isNetworkFailure(flushError)) {
+            setClientError({ client, value: toError(flushError) });
+            break;
+          }
+          setClientError({ client, value: toError(flushError) });
+          queuedMetadata.current.delete(request.idempotencyKey);
+          setOfflineQueue(
+            (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+          );
+        }
+      }
+    } finally {
+      isFlushingQueue.current = false;
+      setIsOperationPending(false);
     }
-  }, [acquire, syncAdapter]);
+  }, [client, events, offlineQueue, options.onRewardUnlocked, options.onStampClaimed, syncAdapter]);
+  react.useEffect(() => {
+    if (typeof window === "undefined") return;
+    const handleOnline = () => {
+      void flushQueue();
+    };
+    window.addEventListener("online", handleOnline);
+    return () => window.removeEventListener("online", handleOnline);
+  }, [flushQueue]);
   return {
     state: optimisticState,
     isLoading,
@@ -336,7 +481,8 @@ function useStampRally(client, options = {}) {
     redeem,
     exportRecoveryCode,
     importRecoveryCode,
-    queuedCount: queuedRequests.current.length,
+    offlineQueue,
+    queuedCount: offlineQueue.length,
     flushQueue
   };
 }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useStampRally.ts"],"names":["useRef","useCallback","useSyncExternalStore","useState","useTransition","useEffect","result","consumeReward","exportProgressToken","importProgressToken"],"mappings":";;;;;;AA4FA,SAAS,iBAAA,GAA0B;AACjC,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,QAAQ,KAAA,EAAuB;AACtC,EAAA,OAAO,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AACjE;AAEA,SAAS,sBAAA,CACP,cACA,MAAA,EACwB;AACxB,EAAA,IACE,YAAA,KAAiB,IAAA,IACjB,YAAA,CAAa,OAAA,CAAQ,IAAA,CAAK,CAAC,MAAA,KAAW,MAAA,CAAO,OAAA,KAAY,MAAA,CAAO,OAAO,CAAA,EACvE;AACA,IAAA,OAAO,YAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,GAAG,YAAA;AAAA,IACH,OAAA,EAAS,CAAC,GAAG,YAAA,CAAa,OAAA,EAAS,EAAE,OAAA,EAAS,MAAA,CAAO,OAAA,EAAS,UAAA,EAAY,MAAA,CAAO,UAAA,EAAY,CAAA;AAAA,IAC7F,WAAW,MAAA,CAAO;AAAA,GACpB;AACF;AAEA,SAAS,oBAAA,GAA+B;AACtC,EAAA,MAAM,YAAY,UAAA,CAAW,MAAA;AAC7B,EAAA,IAAI,SAAA,KAAc,MAAA,IAAa,OAAO,SAAA,CAAU,eAAe,UAAA,EAAY;AACzE,IAAA,OAAO,UAAU,UAAA,EAAW;AAAA,EAC9B;AACA,EAAA,OAAO,CAAA,MAAA,EAAS,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AACnE;AAEA,SAAS,SAAS,OAAA,EAA2C;AAC3D,EAAA,IAAI,OAAA,EAAS,aAAa,MAAA,EAAW;AACnC,IAAA,OAAO,OAAO,SAAA,KAAc,WAAA,IAAe,SAAA,CAAU,MAAA,KAAW,KAAA;AAAA,EAClE;AACA,EAAA,OAAO,OAAO,OAAA,CAAQ,QAAA,KAAa,aAAa,OAAA,CAAQ,QAAA,KAAa,OAAA,CAAQ,QAAA;AAC/E;AAEA,SAAS,uBAAuB,KAAA,EAAyB;AACvD,EAAA,OACE,KAAA,KAAU,KAAA,IACT,OAAO,KAAA,KAAU,QAAA,IAAY,UAAU,IAAA,IAAQ,IAAA,IAAQ,KAAA,IAAS,KAAA,CAAM,EAAA,KAAO,KAAA;AAElF;AAEO,SAAS,aAAA,CACd,MAAA,EACA,OAAA,GAAgC,EAAC,EACZ;AACrB,EAAA,MAAM,cAAc,OAAA,CAAQ,WAAA;AAC5B,EAAA,MAAM,SAAS,OAAA,CAAQ,MAAA;AACvB,EAAA,MAAM,cAAA,GAAiBA,YAAA,CAAsC,EAAE,CAAA;AAC/D,EAAA,MAAM,SAAA,GAAYC,iBAAA;AAAA,IAChB,CAAC,aAAA,KAA8B,MAAA,CAAO,SAAA,CAAU,MAAM,eAAe,CAAA;AAAA,IACrE,CAAC,MAAM;AAAA,GACT;AACA,EAAA,MAAM,WAAA,GAAcA,kBAAY,MAAM,MAAA,CAAO,UAAS,EAAG,CAAC,MAAM,CAAC,CAAA;AACjE,EAAA,MAAM,QAAA,GAAWC,0BAAA,CAAqB,SAAA,EAAW,WAAA,EAAa,iBAAiB,CAAA;AAC/E,EAAA,MAAM,CAAC,YAAA,EAAc,eAAe,CAAA,GAAIC,eAAuB,OAAO;AAAA,IACpE,MAAA;AAAA,IACA,cAAA,EAAgB,MAAA,CAAO,QAAA,EAAS,KAAM;AAAA,GACxC,CAAE,CAAA;AACF,EAAA,MAAM,CAAC,WAAA,EAAa,cAAc,CAAA,GAAIA,eAA6B,IAAI,CAAA;AACvE,EAAA,MAAM,CAAC,SAAS,CAAA,GAAIC,mBAAA,EAAc;AAClC,EAAA,MAAM,CAAC,kBAAA,EAAoB,qBAAqB,CAAA,GAAID,eAAS,KAAK,CAAA;AAClE,EAAA,MAAM,CAAC,eAAA,EAAiB,kBAAkB,CAAA,GAAIA,eAAiC,QAAQ,CAAA;AAEvF,EAAAE,eAAA,CAAU,MAAM;AACd,IAAA,kBAAA,CAAmB,QAAQ,CAAA;AAAA,EAC7B,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,WAAA,EAAa,kBAAkB,MAAA,EAAW;AAC9C,IAAA,OAAO,MAAA,CAAO,SAAA,CAAU,WAAA,CAAY,aAAa,CAAA;AAAA,EACnD,CAAA,EAAG,CAAC,MAAA,EAAQ,WAAW,CAAC,CAAA;AAExB,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,MAAA,GAAS,IAAA;AACb,IAAA,cAAA,CAAe,IAAI,CAAA;AACnB,IAAA,IAAI,aAAa,IAAA,EAAM;AACrB,MAAA,eAAA,CAAgB,EAAE,MAAA,EAAQ,cAAA,EAAgB,KAAA,EAAO,CAAA;AACjD,MAAA,OAAO,MAAM;AACX,QAAA,MAAA,GAAS,KAAA;AAAA,MACX,CAAA;AAAA,IACF;AAEA,IAAA,eAAA,CAAgB,EAAE,MAAA,EAAQ,cAAA,EAAgB,IAAA,EAAM,CAAA;AAEhD,IAAA,KAAK,MAAA,CACF,IAAA,EAAK,CACL,KAAA,CAAM,CAAC,mBAAA,KAAiC;AACvC,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,OAAA,CAAQ,mBAAmB,GAAG,CAAA;AAAA,MAChE;AAAA,IACF,CAAC,CAAA,CACA,OAAA,CAAQ,MAAM;AACb,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,eAAA,CAAgB,EAAE,MAAA,EAAQ,cAAA,EAAgB,KAAA,EAAO,CAAA;AAAA,MACnD;AAAA,IACF,CAAC,CAAA;AAEH,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,GAAS,KAAA;AAAA,IACX,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,QAAQ,CAAC,CAAA;AAErB,EAAA,MAAM,OAAA,GAAUJ,iBAAA;AAAA,IACd,CACE,OAAA,EACA,OAAA,EACA,GAAA,EACA,cAAA,KACmD;AACnD,MAAA,MAAM,UAAA,GAAa,GAAA,IAAA,iBAAO,IAAI,IAAA,IAAO,WAAA,EAAY;AACjD,MAAA,MAAM,OAAA,GAA0B;AAAA,QAC9B,OAAA;AAAA,QACA,OAAA;AAAA,QACA,GAAA,EAAK,UAAA;AAAA,QACL,cAAA,EAAgB,kBAAkB,oBAAA;AAAqB,OACzD;AACA,MAAA,cAAA,CAAe,IAAI,CAAA;AAEnB,MAAA,IAAI,CAAC,QAAA,CAAS,WAAW,CAAA,EAAG;AAC1B,QAAA,cAAA,CAAe,OAAA,GAAU,CAAC,GAAG,cAAA,CAAe,SAAS,OAAO,CAAA;AAC5D,QAAA,MAAM,MAAA,GAAgD;AAAA,UACpD,EAAA,EAAI,KAAA;AAAA,UACJ,OAAO,EAAE,IAAA,EAAM,kBAAkB,OAAA,EAAS,cAAA,EAAgB,QAAQ,cAAA;AAAe,SACnF;AACA,QAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAC9C,QAAA,OAAO,OAAA,CAAQ,QAAQ,MAAM,CAAA;AAAA,MAC/B;AAEA,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAC1B,MAAA,kBAAA,CAAmB,CAAC,YAAY,sBAAA,CAAuB,OAAA,EAAS,EAAE,OAAA,EAAS,UAAA,EAAY,CAAC,CAAA;AACxF,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,IAAI;AACF,YAAA,MAAM,MAAA,GAAS,MAAM,WAAA,EAAa,eAAA,GAAkB,OAAO,CAAA;AAC3D,YAAA,IAAI,WAAW,KAAA,EAAO;AACpB,cAAA,MAAM,QAAA,GAAkD;AAAA,gBACtD,EAAA,EAAI,KAAA;AAAA,gBACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,OAAA;AAAQ,eAC1C;AACA,cAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,CAAS,OAAO,CAAA;AAChD,cAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,cAAA,OAAA,CAAQ,QAAQ,CAAA;AAChB,cAAA;AAAA,YACF;AACA,YAAA,MAAM,SAAS,MAAM,MAAA,CAAO,OAAA,CAAQ,OAAA,EAAS,SAAS,UAAU,CAAA;AAChE,YAAA,IAAI,OAAO,EAAA,EAAI;AACb,cAAA,MAAM,QAAA,GAAW,MAAM,WAAA,EAAa,cAAA,GAAiB,OAAO,CAAA;AAC5D,cAAA,IAAI,sBAAA,CAAuB,QAAQ,CAAA,EAAG;AACpC,gBAAA,MAAM,MAAA,CAAO,QAAQ,QAAA,IAAY,MAAA,CAAO,UAAS,IAAK,MAAA,CAAO,MAAM,SAAS,CAAA;AAC5E,gBAAA,MAAM,QAAA,GAAkD;AAAA,kBACtD,EAAA,EAAI,KAAA;AAAA,kBACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,OAAA;AAAQ,iBAC1C;AACA,gBAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,CAAS,OAAO,CAAA;AAChD,gBAAA,kBAAA,CAAmB,MAAA,CAAO,UAAU,CAAA;AACpC,gBAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,gBAAA,OAAA,CAAQ,QAAQ,CAAA;AAChB,gBAAA;AAAA,cACF;AACA,cAAA,KAAA,MAAW,KAAA,IAAS,MAAA,CAAO,KAAA,CAAM,MAAA,EAAQ;AACvC,gBAAA,IAAI,KAAA,CAAM,SAAS,eAAA,EAAiB;AAClC,kBAAA,CAAC,MAAA,EAAQ,cAAA,IAAkB,OAAA,CAAQ,cAAA,IAAkB,MAAM,MAAM,CAAA;AAAA,gBACnE;AACA,gBAAA,IAAI,KAAA,CAAM,SAAS,gBAAA,EAAkB;AACnC,kBAAA,CAAC,MAAA,EAAQ,gBAAA,IAAoB,OAAA,CAAQ,gBAAA,IAAoB,MAAM,QAAQ,CAAA;AAAA,gBACzE;AAAA,cACF;AAAA,YACF;AACA,YAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,cAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAC9C,cAAA,kBAAA,CAAmB,MAAA,CAAO,UAAU,CAAA;AAAA,YACtC;AACA,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AAAA,UAChB,SAAS,YAAA,EAAc;AACrB,YAAA,MAAM,eAAA,GAAkB,QAAQ,YAAY,CAAA;AAC5C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,kBAAA,CAAmB,MAAA,CAAO,UAAU,CAAA;AACpC,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,QAAQ,MAAA,EAAQ,OAAA,CAAQ,kBAAkB,OAAA,CAAQ,cAAA,EAAgB,UAAU,WAAW;AAAA,GAC1F;AAEA,EAAA,MAAM,KAAA,GAAQA,iBAAA;AAAA,IACZ,CAAC,GAAA,KAA2C;AAC1C,MAAA,cAAA,CAAe,IAAI,CAAA;AACnB,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAE1B,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,IAAI;AACF,YAAA,MAAM,SAAA,GAAY,GAAA,KAAQ,KAAA,CAAA,GAAY,MAAM,MAAA,CAAO,OAAM,GAAI,MAAM,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA;AACnF,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,SAAS,CAAA;AAAA,UACnB,SAAS,UAAA,EAAY;AACnB,YAAA,MAAM,eAAA,GAAkB,QAAQ,UAAU,CAAA;AAC1C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,MAAM;AAAA,GACT;AAEA,EAAA,MAAM,MAAA,GAASA,iBAAA;AAAA,IACb,CAAC,QAAA,EAAkB,aAAA,GAA+B,EAAC,KAA8B;AAC/E,MAAA,cAAA,CAAe,IAAI,CAAA;AACnB,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAE1B,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,MAAM,MAAA,GAAS,MAAA,CAAO,SAAA,EAAU,CAAE,OAAA,EAAS,KAAK,CAAC,IAAA,KAAS,IAAA,CAAK,EAAA,KAAO,QAAQ,CAAA;AAC9E,UAAA,IAAI,WAAW,MAAA,EAAW;AACxB,YAAA,MAAMK,OAAAA,GAAwB;AAAA,cAC5B,EAAA,EAAI,KAAA;AAAA,cACJ,KAAA,EAAO,EAAE,IAAA,EAAM,kBAAA,EAAoB,QAAA;AAAS,aAC9C;AACA,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAOA,OAAAA,CAAO,OAAO,CAAA;AAC9C,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQA,OAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,YAAA,GAAe,OAAO,QAAA,EAAS;AACrC,UAAA,MAAM,kBAAA,GAAqB,cAAc,OAAA,EAAS,IAAA;AAAA,YAChD,CAAC,KAAA,KAAU,KAAA,CAAM,QAAA,KAAa;AAAA,WAChC;AACA,UAAA,IAAI,YAAA,KAAiB,IAAA,IAAQ,kBAAA,KAAuB,MAAA,EAAW;AAC7D,YAAA,MAAMA,OAAAA,GAAwB;AAAA,cAC5B,EAAA,EAAI,KAAA;AAAA,cACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,QAAA;AAAS,aAC3C;AACA,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAOA,OAAAA,CAAO,OAAO,CAAA;AAC9C,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQA,OAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,SAASC,kBAAA,CAAc;AAAA,YAC3B,MAAA;AAAA,YACA,YAAA,EAAc,kBAAA;AAAA,YACd,GAAA,EAAA,iBAAK,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,YAC5B,GAAI,cAAc,QAAA,KAAa,MAAA,GAC3B,EAAC,GACD,EAAE,aAAA,EAAe,aAAA,CAAc,QAAA,EAAS;AAAA,YAC5C,GAAI,cAAc,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,aAAA,CAAc,OAAA;AAAQ,WACjF,CAAA;AACD,UAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAC9C,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,IAAI,MAAA,CAAO,UAAU,kBAAA,EAAoB;AACvC,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,SAAA,GAA6B;AAAA,YACjC,GAAG,YAAA;AAAA,YACH,OAAA,EAAA,CAAU,YAAA,CAAa,OAAA,IAAW,EAAC,EAAG,GAAA;AAAA,cAAI,CAAC,KAAA,KACzC,KAAA,CAAM,QAAA,KAAa,QAAA,GAAW,OAAO,KAAA,GAAQ;AAAA,aAC/C;AAAA,YACA,SAAA,EAAW,MAAA,CAAO,KAAA,CAAM,UAAA,IAAc,YAAA,CAAa;AAAA,WACrD;AAEA,UAAA,IAAI;AACF,YAAA,MAAM,MAAA,CAAO,QAAQ,SAAS,CAAA;AAC9B,YAAA,CAAC,MAAA,EAAQ,gBAAA,IAAoB,OAAA,CAAQ,gBAAA,IAAoB,QAAQ,CAAA;AACjE,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AAAA,UAChB,SAAS,WAAA,EAAa;AACpB,YAAA,MAAM,eAAA,GAAkB,QAAQ,WAAW,CAAA;AAC3C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,MAAA,EAAQ,MAAA,EAAQ,OAAA,CAAQ,gBAAgB;AAAA,GAC3C;AAEA,EAAA,MAAM,kBAAA,GAAqBN,kBAAY,MAAc;AACnD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,MAAM,IAAI,MAAM,8DAA8D,CAAA;AAAA,IAChF;AAEA,IAAA,OAAOO,wBAAA,CAAoB;AAAA,MACzB,OAAA,EAAS,CAAA;AAAA,MACT,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,QAAQ,KAAA,CAAM,OAAA;AAAA,MACd,OAAA,EAAS,KAAA,CAAM,OAAA,IAAW,EAAC;AAAA,MAC3B,UAAA,EAAA,iBAAY,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,KACpC,CAAA;AAAA,EACH,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,kBAAA,GAAqBP,iBAAA;AAAA,IACzB,CAAC,KAAA,KAAoC;AACnC,MAAA,cAAA,CAAe,IAAI,CAAA;AACnB,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAE1B,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,MAAM,MAAA,GAAS,OAAO,SAAA,EAAU;AAChC,UAAA,MAAM,QAAA,GAAWQ,wBAAA,CAAoB,KAAA,EAAO,MAAA,CAAO,EAAE,CAAA;AACrD,UAAA,IAAI,aAAa,IAAA,EAAM;AACrB,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,KAAK,CAAA;AACb,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,QAAA,GAAW,IAAI,GAAA,CAAI,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,KAAA,KAAU,KAAA,CAAM,EAAE,CAAC,CAAA;AAC/D,UAAA,MAAM,SAAA,GAAY,IAAI,GAAA,CAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG,GAAA,CAAI,CAAC,MAAA,KAAW,MAAA,CAAO,EAAE,CAAC,CAAA;AAC3E,UAAA,MAAM,gBAAA,uBAAuB,GAAA,EAAY;AACzC,UAAA,MAAM,iBAAA,uBAAwB,GAAA,EAAY;AAC1C,UAAA,MAAM,MAAA,GAAS,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,CAAC,MAAA,KAAW;AAChD,YAAA,IAAI,CAAC,QAAA,CAAS,GAAA,CAAI,MAAA,CAAO,OAAO,CAAA,IAAK,gBAAA,CAAiB,GAAA,CAAI,MAAA,CAAO,OAAO,CAAA,EAAG,OAAO,KAAA;AAClF,YAAA,gBAAA,CAAiB,GAAA,CAAI,OAAO,OAAO,CAAA;AACnC,YAAA,OAAO,IAAA;AAAA,UACT,CAAC,CAAA;AACD,UAAA,MAAM,OAAA,GAAU,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,CAAC,KAAA,KAAU;AACjD,YAAA,IAAI,CAAC,UAAU,GAAA,CAAI,KAAA,CAAM,QAAQ,CAAA,IAAK,iBAAA,CAAkB,GAAA,CAAI,KAAA,CAAM,QAAQ,CAAA;AACxE,cAAA,OAAO,KAAA;AACT,YAAA,iBAAA,CAAkB,GAAA,CAAI,MAAM,QAAQ,CAAA;AACpC,YAAA,OAAO,IAAA;AAAA,UACT,CAAC,CAAA;AAED,UAAA,IAAI;AACF,YAAA,MAAM,OAAO,OAAA,CAAQ;AAAA,cACnB,SAAS,MAAA,CAAO,EAAA;AAAA,cAChB,OAAA,EAAS,MAAA;AAAA,cACT,GAAI,MAAA,CAAO,OAAA,KAAY,KAAA,CAAA,IAAa,OAAA,CAAQ,WAAW,CAAA,GAAI,EAAC,GAAI,EAAE,OAAA,EAAQ;AAAA,cAC1E,WAAW,QAAA,CAAS;AAAA,aACrB,CAAA;AACD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,IAAI,CAAA;AAAA,UACd,SAAS,WAAA,EAAa;AACpB,YAAA,MAAM,eAAA,GAAkB,QAAQ,WAAW,CAAA;AAC3C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,MAAM;AAAA,GACT;AAEA,EAAA,MAAM,YACJ,QAAA,KAAa,IAAA,KAAS,YAAA,CAAa,MAAA,KAAW,UAAU,YAAA,CAAa,cAAA,CAAA;AACvE,EAAA,MAAM,KAAA,GAAQ,WAAA,EAAa,MAAA,KAAW,MAAA,GAAS,YAAY,KAAA,GAAQ,IAAA;AAEnE,EAAA,MAAM,UAAA,GAAaR,kBAAY,YAA2B;AACxD,IAAA,IAAI,CAAC,QAAA,CAAS,WAAW,CAAA,EAAG;AAC5B,IAAA,MAAM,UAAU,cAAA,CAAe,OAAA;AAC/B,IAAA,cAAA,CAAe,UAAU,EAAC;AAC1B,IAAA,KAAA,MAAW,WAAW,OAAA,EAAS;AAC7B,MAAA,MAAM,OAAA,CAAQ,QAAQ,OAAA,EAAS,OAAA,CAAQ,SAAS,OAAA,CAAQ,GAAA,EAAK,QAAQ,cAAc,CAAA;AAAA,IACrF;AAAA,EACF,CAAA,EAAG,CAAC,OAAA,EAAS,WAAW,CAAC,CAAA;AAEzB,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,eAAA;AAAA,IACP,SAAA;AAAA,IACA,WAAW,SAAA,IAAa,kBAAA;AAAA,IACxB,KAAA;AAAA,IACA,YAAA,EAAc,eAAA,EAAiB,OAAA,IAAW,EAAC;AAAA,IAC3C,OAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA,kBAAA;AAAA,IACA,kBAAA;AAAA,IACA,WAAA,EAAa,eAAe,OAAA,CAAQ,MAAA;AAAA,IACpC;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["import type {\n  ConsumeResult,\n  ProcessStampValue,\n  Result,\n  RewardConsumeError,\n  RewardState,\n  StampError,\n  StampRallyClient,\n  StampRallyState,\n  VerificationContext,\n} from \"@stamprally/core\";\nimport { consumeReward, exportProgressToken, importProgressToken } from \"@stamprally/core\";\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  useTransition,\n} from \"react\";\n\ninterface OptimisticAcquire {\n  readonly stampId: string;\n  readonly acquiredAt: string;\n}\n\ninterface ClientStatus {\n  readonly client: StampRallyClient;\n  readonly isInitializing: boolean;\n}\n\ninterface ClientError {\n  readonly client: StampRallyClient;\n  readonly value: StampError | RewardConsumeError | Error;\n}\n\nexport interface CheckInRequest {\n  readonly stampId: string;\n  readonly context: VerificationContext;\n  readonly now: string;\n  readonly idempotencyKey: string;\n}\n\nexport interface SyncAdapter {\n  readonly isOnline?: boolean | (() => boolean);\n  readonly onBeforeCheckIn?: (request: CheckInRequest) => unknown;\n  readonly onServerVerify?: (request: CheckInRequest) => unknown;\n  readonly onStateChange?: (state: StampRallyState) => void;\n}\n\nexport interface StampRallyEventHandlers {\n  readonly onStampClaimed?: (record: StampRallyState[\"records\"][number]) => void;\n  readonly onRewardUnlocked?: (rewardId: string) => void;\n  readonly onRewardConsumed?: (rewardId: string) => void;\n}\n\nexport interface UseStampRallyOptions {\n  readonly syncAdapter?: SyncAdapter;\n  readonly events?: StampRallyEventHandlers;\n  readonly onStampClaimed?: StampRallyEventHandlers[\"onStampClaimed\"];\n  readonly onRewardUnlocked?: StampRallyEventHandlers[\"onRewardUnlocked\"];\n  readonly onRewardConsumed?: StampRallyEventHandlers[\"onRewardConsumed\"];\n}\n\nexport interface RedeemOptions {\n  readonly passcode?: string;\n  readonly staffId?: string;\n}\n\nexport interface UseStampRallyReturn {\n  readonly state: StampRallyState | null;\n  readonly isLoading: boolean;\n  readonly isPending: boolean;\n  readonly error: StampError | RewardConsumeError | Error | null;\n  readonly rewardsState: ReadonlyArray<RewardState>;\n  readonly acquire: (\n    stampId: string,\n    context: VerificationContext,\n    now?: string,\n    idempotencyKey?: string,\n  ) => Promise<Result<ProcessStampValue, StampError>>;\n  readonly reset: (now?: string) => Promise<StampRallyState>;\n  readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;\n  readonly exportRecoveryCode: () => string;\n  readonly importRecoveryCode: (token: string) => Promise<boolean>;\n  readonly queuedCount: number;\n  readonly flushQueue: () => Promise<void>;\n}\n\n/** @deprecated Use UseStampRallyReturn instead. */\nexport type UseStampRallyValue = UseStampRallyReturn;\n\nfunction getServerSnapshot(): null {\n  return null;\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\nfunction applyOptimisticAcquire(\n  currentState: StampRallyState | null,\n  action: OptimisticAcquire,\n): StampRallyState | null {\n  if (\n    currentState === null ||\n    currentState.records.some((record) => record.stampId === action.stampId)\n  ) {\n    return currentState;\n  }\n\n  return {\n    ...currentState,\n    records: [...currentState.records, { stampId: action.stampId, acquiredAt: action.acquiredAt }],\n    updatedAt: action.acquiredAt,\n  };\n}\n\nfunction createIdempotencyKey(): string {\n  const cryptoApi = globalThis.crypto;\n  if (cryptoApi !== undefined && typeof cryptoApi.randomUUID === \"function\") {\n    return cryptoApi.randomUUID();\n  }\n  return `stamp-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction isOnline(adapter: SyncAdapter | undefined): boolean {\n  if (adapter?.isOnline === undefined) {\n    return typeof navigator === \"undefined\" || navigator.onLine !== false;\n  }\n  return typeof adapter.isOnline === \"function\" ? adapter.isOnline() : adapter.isOnline;\n}\n\nfunction isRejectedVerification(value: unknown): boolean {\n  return (\n    value === false ||\n    (typeof value === \"object\" && value !== null && \"ok\" in value && value.ok === false)\n  );\n}\n\nexport function useStampRally(\n  client: StampRallyClient,\n  options: UseStampRallyOptions = {},\n): UseStampRallyReturn {\n  const syncAdapter = options.syncAdapter;\n  const events = options.events;\n  const queuedRequests = useRef<ReadonlyArray<CheckInRequest>>([]);\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => client.subscribe(() => onStoreChange()),\n    [client],\n  );\n  const getSnapshot = useCallback(() => client.getState(), [client]);\n  const rawState = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n  const [clientStatus, setClientStatus] = useState<ClientStatus>(() => ({\n    client,\n    isInitializing: client.getState() === null,\n  }));\n  const [clientError, setClientError] = useState<ClientError | null>(null);\n  const [isPending] = useTransition();\n  const [isOperationPending, setIsOperationPending] = useState(false);\n  const [optimisticState, setOptimisticState] = useState<StampRallyState | null>(rawState);\n\n  useEffect(() => {\n    setOptimisticState(rawState);\n  }, [rawState]);\n\n  useEffect(() => {\n    if (syncAdapter?.onStateChange === undefined) return;\n    return client.subscribe(syncAdapter.onStateChange);\n  }, [client, syncAdapter]);\n\n  useEffect(() => {\n    let active = true;\n    setClientError(null);\n    if (rawState !== null) {\n      setClientStatus({ client, isInitializing: false });\n      return () => {\n        active = false;\n      };\n    }\n\n    setClientStatus({ client, isInitializing: true });\n\n    void client\n      .init()\n      .catch((initializationError: unknown) => {\n        if (active) {\n          setClientError({ client, value: toError(initializationError) });\n        }\n      })\n      .finally(() => {\n        if (active) {\n          setClientStatus({ client, isInitializing: false });\n        }\n      });\n\n    return () => {\n      active = false;\n    };\n  }, [client, rawState]);\n\n  const acquire = useCallback(\n    (\n      stampId: string,\n      context: VerificationContext,\n      now?: string,\n      idempotencyKey?: string,\n    ): Promise<Result<ProcessStampValue, StampError>> => {\n      const acquiredAt = now ?? new Date().toISOString();\n      const request: CheckInRequest = {\n        stampId,\n        context,\n        now: acquiredAt,\n        idempotencyKey: idempotencyKey ?? createIdempotencyKey(),\n      };\n      setClientError(null);\n\n      if (!isOnline(syncAdapter)) {\n        queuedRequests.current = [...queuedRequests.current, request];\n        const queued: Result<ProcessStampValue, StampError> = {\n          ok: false,\n          error: { code: \"OFFLINE_QUEUED\", stampId, idempotencyKey: request.idempotencyKey },\n        };\n        setClientError({ client, value: queued.error });\n        return Promise.resolve(queued);\n      }\n\n      setIsOperationPending(true);\n      setOptimisticState((current) => applyOptimisticAcquire(current, { stampId, acquiredAt }));\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const before = await syncAdapter?.onBeforeCheckIn?.(request);\n            if (before === false) {\n              const rejected: Result<ProcessStampValue, StampError> = {\n                ok: false,\n                error: { code: \"INVALID_PROOF\", stampId },\n              };\n              setClientError({ client, value: rejected.error });\n              setIsOperationPending(false);\n              resolve(rejected);\n              return;\n            }\n            const result = await client.acquire(stampId, context, acquiredAt);\n            if (result.ok) {\n              const verified = await syncAdapter?.onServerVerify?.(request);\n              if (isRejectedVerification(verified)) {\n                await client.restore(rawState ?? client.getState() ?? result.value.nextState);\n                const rejected: Result<ProcessStampValue, StampError> = {\n                  ok: false,\n                  error: { code: \"INVALID_PROOF\", stampId },\n                };\n                setClientError({ client, value: rejected.error });\n                setOptimisticState(client.getState());\n                setIsOperationPending(false);\n                resolve(rejected);\n                return;\n              }\n              for (const event of result.value.events) {\n                if (event.type === \"stampAcquired\") {\n                  (events?.onStampClaimed ?? options.onStampClaimed)?.(event.record);\n                }\n                if (event.type === \"rewardUnlocked\") {\n                  (events?.onRewardUnlocked ?? options.onRewardUnlocked)?.(event.rewardId);\n                }\n              }\n            }\n            if (!result.ok) {\n              setClientError({ client, value: result.error });\n              setOptimisticState(client.getState());\n            }\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (acquireError) {\n            const normalizedError = toError(acquireError);\n            setClientError({ client, value: normalizedError });\n            setOptimisticState(client.getState());\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client, events, options.onRewardUnlocked, options.onStampClaimed, rawState, syncAdapter],\n  );\n\n  const reset = useCallback(\n    (now?: string): Promise<StampRallyState> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const nextState = now === undefined ? await client.reset() : await client.reset(now);\n            setIsOperationPending(false);\n            resolve(nextState);\n          } catch (resetError) {\n            const normalizedError = toError(resetError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const redeem = useCallback(\n    (rewardId: string, redeemOptions: RedeemOptions = {}): Promise<ConsumeResult> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);\n          if (reward === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"REWARD_NOT_FOUND\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const currentState = client.getState();\n          const currentRewardState = currentState?.rewards?.find(\n            (state) => state.rewardId === rewardId,\n          );\n          if (currentState === null || currentRewardState === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"NOT_AVAILABLE\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const result = consumeReward({\n            reward,\n            currentState: currentRewardState,\n            now: new Date().toISOString(),\n            ...(redeemOptions.passcode === undefined\n              ? {}\n              : { inputPasscode: redeemOptions.passcode }),\n            ...(redeemOptions.staffId === undefined ? {} : { staffId: redeemOptions.staffId }),\n          });\n          if (!result.ok) {\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          if (result.value === currentRewardState) {\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const nextState: StampRallyState = {\n            ...currentState,\n            rewards: (currentState.rewards ?? []).map((state) =>\n              state.rewardId === rewardId ? result.value : state,\n            ),\n            updatedAt: result.value.consumedAt ?? currentState.updatedAt,\n          };\n\n          try {\n            await client.restore(nextState);\n            (events?.onRewardConsumed ?? options.onRewardConsumed)?.(rewardId);\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (redeemError) {\n            const normalizedError = toError(redeemError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client, events, options.onRewardConsumed],\n  );\n\n  const exportRecoveryCode = useCallback((): string => {\n    const state = client.getState();\n    if (state === null) {\n      throw new Error(\"Cannot export recovery code before the rally is initialized.\");\n    }\n\n    return exportProgressToken({\n      version: 1,\n      rallyId: state.rallyId,\n      stamps: state.records,\n      rewards: state.rewards ?? [],\n      exportedAt: new Date().toISOString(),\n    });\n  }, [client]);\n\n  const importRecoveryCode = useCallback(\n    (token: string): Promise<boolean> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const config = client.getConfig();\n          const snapshot = importProgressToken(token, config.id);\n          if (snapshot === null) {\n            setIsOperationPending(false);\n            resolve(false);\n            return;\n          }\n\n          const stampIds = new Set(config.stamps.map((stamp) => stamp.id));\n          const rewardIds = new Set((config.rewards ?? []).map((reward) => reward.id));\n          const importedStampIds = new Set<string>();\n          const importedRewardIds = new Set<string>();\n          const stamps = snapshot.stamps.filter((record) => {\n            if (!stampIds.has(record.stampId) || importedStampIds.has(record.stampId)) return false;\n            importedStampIds.add(record.stampId);\n            return true;\n          });\n          const rewards = snapshot.rewards.filter((state) => {\n            if (!rewardIds.has(state.rewardId) || importedRewardIds.has(state.rewardId))\n              return false;\n            importedRewardIds.add(state.rewardId);\n            return true;\n          });\n\n          try {\n            await client.restore({\n              rallyId: config.id,\n              records: stamps,\n              ...(config.rewards === undefined && rewards.length === 0 ? {} : { rewards }),\n              updatedAt: snapshot.exportedAt,\n            });\n            setIsOperationPending(false);\n            resolve(true);\n          } catch (importError) {\n            const normalizedError = toError(importError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const isLoading =\n    rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);\n  const error = clientError?.client === client ? clientError.value : null;\n\n  const flushQueue = useCallback(async (): Promise<void> => {\n    if (!isOnline(syncAdapter)) return;\n    const pending = queuedRequests.current;\n    queuedRequests.current = [];\n    for (const request of pending) {\n      await acquire(request.stampId, request.context, request.now, request.idempotencyKey);\n    }\n  }, [acquire, syncAdapter]);\n\n  return {\n    state: optimisticState,\n    isLoading,\n    isPending: isPending || isOperationPending,\n    error,\n    rewardsState: optimisticState?.rewards ?? [],\n    acquire,\n    reset,\n    redeem,\n    exportRecoveryCode,\n    importRecoveryCode,\n    queuedCount: queuedRequests.current.length,\n    flushQueue,\n  };\n}\n"]}
+{"version":3,"sources":["../src/useStampRally.ts"],"names":["useState","useRef","useCallback","useSyncExternalStore","useTransition","useEffect","result","consumeReward","exportProgressToken","importProgressToken"],"mappings":"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","file":"index.cjs","sourcesContent":["import type {\n  ConsumeResult,\n  ProcessStampValue,\n  Result,\n  RewardConsumeError,\n  RewardState,\n  StampError,\n  StampRallyClient,\n  StampRallyState,\n  VerificationContext,\n} from \"@stamprally/core\";\nimport { consumeReward, exportProgressToken, importProgressToken } from \"@stamprally/core\";\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  useTransition,\n} from \"react\";\n\ninterface OptimisticAcquire {\n  readonly stampId: string;\n  readonly acquiredAt: string;\n}\n\ninterface ClientStatus {\n  readonly client: StampRallyClient;\n  readonly isInitializing: boolean;\n}\n\ninterface ClientError {\n  readonly client: StampRallyClient;\n  readonly value: StampError | RewardConsumeError | Error;\n}\n\ninterface QueuedRequestMetadata {\n  readonly previousState: StampRallyState | null;\n  readonly result: ProcessStampValue;\n}\n\nexport interface CheckInRequest {\n  readonly stampId: string;\n  readonly context: VerificationContext;\n  readonly now: string;\n  readonly idempotencyKey: string;\n}\n\nexport interface SyncAdapter {\n  readonly isOnline?: boolean | (() => boolean);\n  readonly onBeforeCheckIn?: (request: CheckInRequest) => unknown;\n  readonly onServerVerify?: (request: CheckInRequest) => unknown;\n  readonly onStateChange?: (state: StampRallyState) => void;\n}\n\nexport interface StampRallyEventHandlers {\n  readonly onStampClaimed?: (record: StampRallyState[\"records\"][number]) => void;\n  readonly onRewardUnlocked?: (rewardId: string) => void;\n  readonly onRewardConsumed?: (rewardId: string) => void;\n}\n\nexport interface UseStampRallyOptions {\n  readonly syncAdapter?: SyncAdapter;\n  readonly events?: StampRallyEventHandlers;\n  readonly onStampClaimed?: StampRallyEventHandlers[\"onStampClaimed\"];\n  readonly onRewardUnlocked?: StampRallyEventHandlers[\"onRewardUnlocked\"];\n  readonly onRewardConsumed?: StampRallyEventHandlers[\"onRewardConsumed\"];\n}\n\nexport interface RedeemOptions {\n  readonly passcode?: string;\n  readonly staffId?: string;\n}\n\nexport interface UseStampRallyReturn {\n  readonly state: StampRallyState | null;\n  readonly isLoading: boolean;\n  readonly isPending: boolean;\n  readonly error: StampError | RewardConsumeError | Error | null;\n  readonly rewardsState: ReadonlyArray<RewardState>;\n  readonly acquire: (\n    stampId: string,\n    context: VerificationContext,\n    now?: string,\n    idempotencyKey?: string,\n  ) => Promise<Result<ProcessStampValue, StampError>>;\n  readonly reset: (now?: string) => Promise<StampRallyState>;\n  readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;\n  readonly exportRecoveryCode: () => string;\n  readonly importRecoveryCode: (token: string) => Promise<boolean>;\n  readonly offlineQueue: ReadonlyArray<CheckInRequest>;\n  readonly queuedCount: number;\n  readonly flushQueue: () => Promise<void>;\n}\n\n/** @deprecated Use UseStampRallyReturn instead. */\nexport type UseStampRallyValue = UseStampRallyReturn;\n\nfunction getServerSnapshot(): null {\n  return null;\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\nfunction applyOptimisticAcquire(\n  currentState: StampRallyState | null,\n  action: OptimisticAcquire,\n): StampRallyState | null {\n  if (\n    currentState === null ||\n    currentState.records.some((record) => record.stampId === action.stampId)\n  ) {\n    return currentState;\n  }\n\n  return {\n    ...currentState,\n    records: [...currentState.records, { stampId: action.stampId, acquiredAt: action.acquiredAt }],\n    updatedAt: action.acquiredAt,\n  };\n}\n\nfunction createIdempotencyKey(): string {\n  const cryptoApi = globalThis.crypto;\n  if (cryptoApi !== undefined && typeof cryptoApi.randomUUID === \"function\") {\n    return cryptoApi.randomUUID();\n  }\n  return `stamp-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction isOnline(adapter: SyncAdapter | undefined): boolean {\n  if (adapter?.isOnline === undefined) {\n    return typeof navigator === \"undefined\" || navigator.onLine !== false;\n  }\n  return typeof adapter.isOnline === \"function\" ? adapter.isOnline() : adapter.isOnline;\n}\n\nfunction isRejectedVerification(value: unknown): boolean {\n  return (\n    value === false ||\n    (typeof value === \"object\" && value !== null && \"ok\" in value && value.ok === false)\n  );\n}\n\nfunction isNetworkFailure(error: unknown): boolean {\n  if (typeof navigator !== \"undefined\" && navigator.onLine === false) return true;\n  if (!(error instanceof Error)) return true;\n  return /aborted|connection|fetch|network|offline|timeout/i.test(`${error.name} ${error.message}`);\n}\n\nfunction notifyAcquisitionEvents(\n  result: ProcessStampValue,\n  events: StampRallyEventHandlers | undefined,\n  onStampClaimed: StampRallyEventHandlers[\"onStampClaimed\"] | undefined,\n  onRewardUnlocked: StampRallyEventHandlers[\"onRewardUnlocked\"] | undefined,\n): void {\n  for (const event of result.events) {\n    if (event.type === \"stampAcquired\") {\n      (events?.onStampClaimed ?? onStampClaimed)?.(event.record);\n    }\n    if (event.type === \"rewardUnlocked\") {\n      (events?.onRewardUnlocked ?? onRewardUnlocked)?.(event.rewardId);\n    }\n  }\n}\n\nexport function useStampRally(\n  client: StampRallyClient,\n  options: UseStampRallyOptions = {},\n): UseStampRallyReturn {\n  const syncAdapter = options.syncAdapter;\n  const events = options.events;\n  const [offlineQueue, setOfflineQueue] = useState<ReadonlyArray<CheckInRequest>>([]);\n  const queuedMetadata = useRef(new Map<string, QueuedRequestMetadata>());\n  const isFlushingQueue = useRef(false);\n  const activeClient = useRef(client);\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => client.subscribe(() => onStoreChange()),\n    [client],\n  );\n  const getSnapshot = useCallback(() => client.getState(), [client]);\n  const rawState = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n  const [clientStatus, setClientStatus] = useState<ClientStatus>(() => ({\n    client,\n    isInitializing: client.getState() === null,\n  }));\n  const [clientError, setClientError] = useState<ClientError | null>(null);\n  const [isPending] = useTransition();\n  const [isOperationPending, setIsOperationPending] = useState(false);\n  const [optimisticState, setOptimisticState] = useState<StampRallyState | null>(rawState);\n\n  useEffect(() => {\n    setOptimisticState(rawState);\n  }, [rawState]);\n\n  useEffect(() => {\n    if (activeClient.current === client) return;\n    activeClient.current = client;\n    setOfflineQueue([]);\n    queuedMetadata.current.clear();\n  }, [client]);\n\n  useEffect(() => {\n    if (syncAdapter?.onStateChange === undefined) return;\n    return client.subscribe(syncAdapter.onStateChange);\n  }, [client, syncAdapter]);\n\n  useEffect(() => {\n    let active = true;\n    setClientError(null);\n    if (rawState !== null) {\n      setClientStatus({ client, isInitializing: false });\n      return () => {\n        active = false;\n      };\n    }\n\n    setClientStatus({ client, isInitializing: true });\n\n    void client\n      .init()\n      .catch((initializationError: unknown) => {\n        if (active) {\n          setClientError({ client, value: toError(initializationError) });\n        }\n      })\n      .finally(() => {\n        if (active) {\n          setClientStatus({ client, isInitializing: false });\n        }\n      });\n\n    return () => {\n      active = false;\n    };\n  }, [client, rawState]);\n\n  const queueRequest = useCallback(\n    (request: CheckInRequest, metadata?: QueuedRequestMetadata): void => {\n      if (metadata !== undefined) queuedMetadata.current.set(request.idempotencyKey, metadata);\n      setOfflineQueue((current) =>\n        current.some((item) => item.idempotencyKey === request.idempotencyKey)\n          ? current\n          : [...current, request],\n      );\n    },\n    [],\n  );\n\n  const acquire = useCallback(\n    (\n      stampId: string,\n      context: VerificationContext,\n      now?: string,\n      idempotencyKey?: string,\n    ): Promise<Result<ProcessStampValue, StampError>> => {\n      const acquiredAt = now ?? new Date().toISOString();\n      const request: CheckInRequest = {\n        stampId,\n        context,\n        now: acquiredAt,\n        idempotencyKey: idempotencyKey ?? createIdempotencyKey(),\n      };\n      setClientError(null);\n\n      if (!isOnline(syncAdapter)) {\n        queueRequest(request);\n        const queued: Result<ProcessStampValue, StampError> = {\n          ok: false,\n          error: { code: \"OFFLINE_QUEUED\", stampId, idempotencyKey: request.idempotencyKey },\n        };\n        setClientError({ client, value: queued.error });\n        return Promise.resolve(queued);\n      }\n\n      setIsOperationPending(true);\n      setOptimisticState((current) => applyOptimisticAcquire(current, { stampId, acquiredAt }));\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const before = await syncAdapter?.onBeforeCheckIn?.(request);\n            if (before === false) {\n              const rejected: Result<ProcessStampValue, StampError> = {\n                ok: false,\n                error: { code: \"INVALID_PROOF\", stampId },\n              };\n              setClientError({ client, value: rejected.error });\n              setIsOperationPending(false);\n              resolve(rejected);\n              return;\n            }\n            const previousState = client.getState();\n            const result = await client.acquire(stampId, context, acquiredAt);\n            if (result.ok) {\n              let verified: unknown;\n              try {\n                verified = await syncAdapter?.onServerVerify?.(request);\n              } catch (verificationError) {\n                if (!isNetworkFailure(verificationError)) throw verificationError;\n                queueRequest(request, { previousState, result: result.value });\n                const queued: Result<ProcessStampValue, StampError> = {\n                  ok: false,\n                  error: {\n                    code: \"OFFLINE_QUEUED\",\n                    stampId,\n                    idempotencyKey: request.idempotencyKey,\n                  },\n                };\n                setClientError({ client, value: toError(verificationError) });\n                setOptimisticState(client.getState());\n                setIsOperationPending(false);\n                resolve(queued);\n                return;\n              }\n              if (isRejectedVerification(verified)) {\n                await client.restore(rawState ?? client.getState() ?? result.value.nextState);\n                const rejected: Result<ProcessStampValue, StampError> = {\n                  ok: false,\n                  error: { code: \"INVALID_PROOF\", stampId },\n                };\n                setClientError({ client, value: rejected.error });\n                setOptimisticState(client.getState());\n                setIsOperationPending(false);\n                resolve(rejected);\n                return;\n              }\n              notifyAcquisitionEvents(\n                result.value,\n                events,\n                options.onStampClaimed,\n                options.onRewardUnlocked,\n              );\n            }\n            if (!result.ok) {\n              setClientError({ client, value: result.error });\n              setOptimisticState(client.getState());\n            }\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (acquireError) {\n            if (isNetworkFailure(acquireError)) {\n              queueRequest(request);\n              const queued: Result<ProcessStampValue, StampError> = {\n                ok: false,\n                error: { code: \"OFFLINE_QUEUED\", stampId, idempotencyKey: request.idempotencyKey },\n              };\n              setClientError({ client, value: queued.error });\n              setOptimisticState(client.getState());\n              setIsOperationPending(false);\n              resolve(queued);\n              return;\n            }\n            const normalizedError = toError(acquireError);\n            setClientError({ client, value: normalizedError });\n            setOptimisticState(client.getState());\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [\n      client,\n      events,\n      options.onRewardUnlocked,\n      options.onStampClaimed,\n      queueRequest,\n      rawState,\n      syncAdapter,\n    ],\n  );\n\n  const reset = useCallback(\n    (now?: string): Promise<StampRallyState> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const nextState = now === undefined ? await client.reset() : await client.reset(now);\n            setIsOperationPending(false);\n            resolve(nextState);\n          } catch (resetError) {\n            const normalizedError = toError(resetError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const redeem = useCallback(\n    (rewardId: string, redeemOptions: RedeemOptions = {}): Promise<ConsumeResult> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);\n          if (reward === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"REWARD_NOT_FOUND\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const currentState = client.getState();\n          const currentRewardState = currentState?.rewards?.find(\n            (state) => state.rewardId === rewardId,\n          );\n          if (currentState === null || currentRewardState === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"NOT_AVAILABLE\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const result = consumeReward({\n            reward,\n            currentState: currentRewardState,\n            now: new Date().toISOString(),\n            ...(redeemOptions.passcode === undefined\n              ? {}\n              : { inputPasscode: redeemOptions.passcode }),\n            ...(redeemOptions.staffId === undefined ? {} : { staffId: redeemOptions.staffId }),\n          });\n          if (!result.ok) {\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          if (result.value === currentRewardState) {\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const nextState: StampRallyState = {\n            ...currentState,\n            rewards: (currentState.rewards ?? []).map((state) =>\n              state.rewardId === rewardId ? result.value : state,\n            ),\n            updatedAt: result.value.consumedAt ?? currentState.updatedAt,\n          };\n\n          try {\n            await client.restore(nextState);\n            (events?.onRewardConsumed ?? options.onRewardConsumed)?.(rewardId);\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (redeemError) {\n            const normalizedError = toError(redeemError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client, events, options.onRewardConsumed],\n  );\n\n  const exportRecoveryCode = useCallback((): string => {\n    const state = client.getState();\n    if (state === null) {\n      throw new Error(\"Cannot export recovery code before the rally is initialized.\");\n    }\n\n    return exportProgressToken({\n      version: 1,\n      rallyId: state.rallyId,\n      stamps: state.records,\n      rewards: state.rewards ?? [],\n      exportedAt: new Date().toISOString(),\n    });\n  }, [client]);\n\n  const importRecoveryCode = useCallback(\n    (token: string): Promise<boolean> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const config = client.getConfig();\n          const snapshot = importProgressToken(token, config.id);\n          if (snapshot === null) {\n            setIsOperationPending(false);\n            resolve(false);\n            return;\n          }\n\n          const stampIds = new Set(config.stamps.map((stamp) => stamp.id));\n          const rewardIds = new Set((config.rewards ?? []).map((reward) => reward.id));\n          const importedStampIds = new Set<string>();\n          const importedRewardIds = new Set<string>();\n          const stamps = snapshot.stamps.filter((record) => {\n            if (!stampIds.has(record.stampId) || importedStampIds.has(record.stampId)) return false;\n            importedStampIds.add(record.stampId);\n            return true;\n          });\n          const rewards = snapshot.rewards.filter((state) => {\n            if (!rewardIds.has(state.rewardId) || importedRewardIds.has(state.rewardId))\n              return false;\n            importedRewardIds.add(state.rewardId);\n            return true;\n          });\n\n          try {\n            await client.restore({\n              rallyId: config.id,\n              records: stamps,\n              ...(config.rewards === undefined && rewards.length === 0 ? {} : { rewards }),\n              updatedAt: snapshot.exportedAt,\n            });\n            setIsOperationPending(false);\n            resolve(true);\n          } catch (importError) {\n            const normalizedError = toError(importError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const isLoading =\n    rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);\n  const error = clientError?.client === client ? clientError.value : null;\n\n  const flushQueue = useCallback(async (): Promise<void> => {\n    if (!isOnline(syncAdapter) || isFlushingQueue.current) return;\n    isFlushingQueue.current = true;\n    setIsOperationPending(true);\n    try {\n      for (const request of offlineQueue) {\n        if (!isOnline(syncAdapter)) break;\n        const metadata = queuedMetadata.current.get(request.idempotencyKey);\n        const previousState = metadata?.previousState ?? client.getState();\n        try {\n          const before = await syncAdapter?.onBeforeCheckIn?.(request);\n          if (before === false) {\n            if (metadata !== undefined && previousState !== null)\n              await client.restore(previousState);\n            setClientError({ client, value: { code: \"INVALID_PROOF\", stampId: request.stampId } });\n            queuedMetadata.current.delete(request.idempotencyKey);\n            setOfflineQueue((current) =>\n              current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n            );\n            continue;\n          }\n\n          let result = metadata?.result;\n          if (result === undefined) {\n            const localResult = await client.acquire(request.stampId, request.context, request.now);\n            if (!localResult.ok) {\n              setClientError({ client, value: localResult.error });\n              queuedMetadata.current.delete(request.idempotencyKey);\n              setOfflineQueue((current) =>\n                current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n              );\n              continue;\n            }\n            result = localResult.value;\n            queuedMetadata.current.set(request.idempotencyKey, {\n              previousState,\n              result,\n            });\n          }\n\n          const verified = await syncAdapter?.onServerVerify?.(request);\n          if (isRejectedVerification(verified)) {\n            if (previousState !== null) await client.restore(previousState);\n            setClientError({\n              client,\n              value: { code: \"INVALID_PROOF\", stampId: request.stampId },\n            });\n          } else {\n            notifyAcquisitionEvents(\n              result,\n              events,\n              options.onStampClaimed,\n              options.onRewardUnlocked,\n            );\n          }\n          queuedMetadata.current.delete(request.idempotencyKey);\n          setOfflineQueue((current) =>\n            current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n          );\n        } catch (flushError) {\n          if (isNetworkFailure(flushError)) {\n            setClientError({ client, value: toError(flushError) });\n            break;\n          }\n          setClientError({ client, value: toError(flushError) });\n          queuedMetadata.current.delete(request.idempotencyKey);\n          setOfflineQueue((current) =>\n            current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n          );\n        }\n      }\n    } finally {\n      isFlushingQueue.current = false;\n      setIsOperationPending(false);\n    }\n  }, [client, events, offlineQueue, options.onRewardUnlocked, options.onStampClaimed, syncAdapter]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n    const handleOnline = (): void => {\n      void flushQueue();\n    };\n    window.addEventListener(\"online\", handleOnline);\n    return () => window.removeEventListener(\"online\", handleOnline);\n  }, [flushQueue]);\n\n  return {\n    state: optimisticState,\n    isLoading,\n    isPending: isPending || isOperationPending,\n    error,\n    rewardsState: optimisticState?.rewards ?? [],\n    acquire,\n    reset,\n    redeem,\n    exportRecoveryCode,\n    importRecoveryCode,\n    offlineQueue,\n    queuedCount: offlineQueue.length,\n    flushQueue,\n  };\n}\n"]}

package/dist/index.d.cts

@@ -39,6 +39,7 @@ interface UseStampRallyReturn {
     readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;
     readonly exportRecoveryCode: () => string;
     readonly importRecoveryCode: (token: string) => Promise<boolean>;
+    readonly offlineQueue: ReadonlyArray<CheckInRequest>;
     readonly queuedCount: number;
     readonly flushQueue: () => Promise<void>;
 }

package/dist/index.d.ts

@@ -39,6 +39,7 @@ interface UseStampRallyReturn {
     readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;
     readonly exportRecoveryCode: () => string;
     readonly importRecoveryCode: (token: string) => Promise<boolean>;
+    readonly offlineQueue: ReadonlyArray<CheckInRequest>;
     readonly queuedCount: number;
     readonly flushQueue: () => Promise<void>;
 }

package/dist/index.js

@@ -1,5 +1,5 @@
 import { consumeReward, exportProgressToken, importProgressToken } from '@stamprally/core';
-import { useRef, useCallback, useSyncExternalStore, useState, useTransition, useEffect } from 'react';
+import { useState, useRef, useCallback, useSyncExternalStore, useTransition, useEffect } from 'react';
 
 // src/useStampRally.ts
 function getServerSnapshot() {
@@ -34,10 +34,28 @@ function isOnline(adapter) {
 function isRejectedVerification(value) {
   return value === false || typeof value === "object" && value !== null && "ok" in value && value.ok === false;
 }
+function isNetworkFailure(error) {
+  if (typeof navigator !== "undefined" && navigator.onLine === false) return true;
+  if (!(error instanceof Error)) return true;
+  return /aborted|connection|fetch|network|offline|timeout/i.test(`${error.name} ${error.message}`);
+}
+function notifyAcquisitionEvents(result, events, onStampClaimed, onRewardUnlocked) {
+  for (const event of result.events) {
+    if (event.type === "stampAcquired") {
+      (events?.onStampClaimed ?? onStampClaimed)?.(event.record);
+    }
+    if (event.type === "rewardUnlocked") {
+      (events?.onRewardUnlocked ?? onRewardUnlocked)?.(event.rewardId);
+    }
+  }
+}
 function useStampRally(client, options = {}) {
   const syncAdapter = options.syncAdapter;
   const events = options.events;
-  const queuedRequests = useRef([]);
+  const [offlineQueue, setOfflineQueue] = useState([]);
+  const queuedMetadata = useRef(/* @__PURE__ */ new Map());
+  const isFlushingQueue = useRef(false);
+  const activeClient = useRef(client);
   const subscribe = useCallback(
     (onStoreChange) => client.subscribe(() => onStoreChange()),
     [client]
@@ -55,6 +73,12 @@ function useStampRally(client, options = {}) {
   useEffect(() => {
     setOptimisticState(rawState);
   }, [rawState]);
+  useEffect(() => {
+    if (activeClient.current === client) return;
+    activeClient.current = client;
+    setOfflineQueue([]);
+    queuedMetadata.current.clear();
+  }, [client]);
   useEffect(() => {
     if (syncAdapter?.onStateChange === void 0) return;
     return client.subscribe(syncAdapter.onStateChange);
@@ -82,6 +106,15 @@ function useStampRally(client, options = {}) {
       active = false;
     };
   }, [client, rawState]);
+  const queueRequest = useCallback(
+    (request, metadata) => {
+      if (metadata !== void 0) queuedMetadata.current.set(request.idempotencyKey, metadata);
+      setOfflineQueue(
+        (current) => current.some((item) => item.idempotencyKey === request.idempotencyKey) ? current : [...current, request]
+      );
+    },
+    []
+  );
   const acquire = useCallback(
     (stampId, context, now, idempotencyKey) => {
       const acquiredAt = now ?? (/* @__PURE__ */ new Date()).toISOString();
@@ -93,7 +126,7 @@ function useStampRally(client, options = {}) {
       };
       setClientError(null);
       if (!isOnline(syncAdapter)) {
-        queuedRequests.current = [...queuedRequests.current, request];
+        queueRequest(request);
         const queued = {
           ok: false,
           error: { code: "OFFLINE_QUEUED", stampId, idempotencyKey: request.idempotencyKey }
@@ -117,9 +150,29 @@ function useStampRally(client, options = {}) {
               resolve(rejected);
               return;
             }
+            const previousState = client.getState();
             const result = await client.acquire(stampId, context, acquiredAt);
             if (result.ok) {
-              const verified = await syncAdapter?.onServerVerify?.(request);
+              let verified;
+              try {
+                verified = await syncAdapter?.onServerVerify?.(request);
+              } catch (verificationError) {
+                if (!isNetworkFailure(verificationError)) throw verificationError;
+                queueRequest(request, { previousState, result: result.value });
+                const queued = {
+                  ok: false,
+                  error: {
+                    code: "OFFLINE_QUEUED",
+                    stampId,
+                    idempotencyKey: request.idempotencyKey
+                  }
+                };
+                setClientError({ client, value: toError(verificationError) });
+                setOptimisticState(client.getState());
+                setIsOperationPending(false);
+                resolve(queued);
+                return;
+              }
               if (isRejectedVerification(verified)) {
                 await client.restore(rawState ?? client.getState() ?? result.value.nextState);
                 const rejected = {
@@ -132,14 +185,12 @@ function useStampRally(client, options = {}) {
                 resolve(rejected);
                 return;
               }
-              for (const event of result.value.events) {
-                if (event.type === "stampAcquired") {
-                  (events?.onStampClaimed ?? options.onStampClaimed)?.(event.record);
-                }
-                if (event.type === "rewardUnlocked") {
-                  (events?.onRewardUnlocked ?? options.onRewardUnlocked)?.(event.rewardId);
-                }
-              }
+              notifyAcquisitionEvents(
+                result.value,
+                events,
+                options.onStampClaimed,
+                options.onRewardUnlocked
+              );
             }
             if (!result.ok) {
               setClientError({ client, value: result.error });
@@ -148,6 +199,18 @@ function useStampRally(client, options = {}) {
             setIsOperationPending(false);
             resolve(result);
           } catch (acquireError) {
+            if (isNetworkFailure(acquireError)) {
+              queueRequest(request);
+              const queued = {
+                ok: false,
+                error: { code: "OFFLINE_QUEUED", stampId, idempotencyKey: request.idempotencyKey }
+              };
+              setClientError({ client, value: queued.error });
+              setOptimisticState(client.getState());
+              setIsOperationPending(false);
+              resolve(queued);
+              return;
+            }
             const normalizedError = toError(acquireError);
             setClientError({ client, value: normalizedError });
             setOptimisticState(client.getState());
@@ -157,7 +220,15 @@ function useStampRally(client, options = {}) {
         })();
       });
     },
-    [client, events, options.onRewardUnlocked, options.onStampClaimed, rawState, syncAdapter]
+    [
+      client,
+      events,
+      options.onRewardUnlocked,
+      options.onStampClaimed,
+      queueRequest,
+      rawState,
+      syncAdapter
+    ]
   );
   const reset = useCallback(
     (now) => {
@@ -316,13 +387,87 @@ function useStampRally(client, options = {}) {
   const isLoading = rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);
   const error = clientError?.client === client ? clientError.value : null;
   const flushQueue = useCallback(async () => {
-    if (!isOnline(syncAdapter)) return;
-    const pending = queuedRequests.current;
-    queuedRequests.current = [];
-    for (const request of pending) {
-      await acquire(request.stampId, request.context, request.now, request.idempotencyKey);
+    if (!isOnline(syncAdapter) || isFlushingQueue.current) return;
+    isFlushingQueue.current = true;
+    setIsOperationPending(true);
+    try {
+      for (const request of offlineQueue) {
+        if (!isOnline(syncAdapter)) break;
+        const metadata = queuedMetadata.current.get(request.idempotencyKey);
+        const previousState = metadata?.previousState ?? client.getState();
+        try {
+          const before = await syncAdapter?.onBeforeCheckIn?.(request);
+          if (before === false) {
+            if (metadata !== void 0 && previousState !== null)
+              await client.restore(previousState);
+            setClientError({ client, value: { code: "INVALID_PROOF", stampId: request.stampId } });
+            queuedMetadata.current.delete(request.idempotencyKey);
+            setOfflineQueue(
+              (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+            );
+            continue;
+          }
+          let result = metadata?.result;
+          if (result === void 0) {
+            const localResult = await client.acquire(request.stampId, request.context, request.now);
+            if (!localResult.ok) {
+              setClientError({ client, value: localResult.error });
+              queuedMetadata.current.delete(request.idempotencyKey);
+              setOfflineQueue(
+                (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+              );
+              continue;
+            }
+            result = localResult.value;
+            queuedMetadata.current.set(request.idempotencyKey, {
+              previousState,
+              result
+            });
+          }
+          const verified = await syncAdapter?.onServerVerify?.(request);
+          if (isRejectedVerification(verified)) {
+            if (previousState !== null) await client.restore(previousState);
+            setClientError({
+              client,
+              value: { code: "INVALID_PROOF", stampId: request.stampId }
+            });
+          } else {
+            notifyAcquisitionEvents(
+              result,
+              events,
+              options.onStampClaimed,
+              options.onRewardUnlocked
+            );
+          }
+          queuedMetadata.current.delete(request.idempotencyKey);
+          setOfflineQueue(
+            (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+          );
+        } catch (flushError) {
+          if (isNetworkFailure(flushError)) {
+            setClientError({ client, value: toError(flushError) });
+            break;
+          }
+          setClientError({ client, value: toError(flushError) });
+          queuedMetadata.current.delete(request.idempotencyKey);
+          setOfflineQueue(
+            (current) => current.filter((item) => item.idempotencyKey !== request.idempotencyKey)
+          );
+        }
+      }
+    } finally {
+      isFlushingQueue.current = false;
+      setIsOperationPending(false);
     }
-  }, [acquire, syncAdapter]);
+  }, [client, events, offlineQueue, options.onRewardUnlocked, options.onStampClaimed, syncAdapter]);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const handleOnline = () => {
+      void flushQueue();
+    };
+    window.addEventListener("online", handleOnline);
+    return () => window.removeEventListener("online", handleOnline);
+  }, [flushQueue]);
   return {
     state: optimisticState,
     isLoading,
@@ -334,7 +479,8 @@ function useStampRally(client, options = {}) {
     redeem,
     exportRecoveryCode,
     importRecoveryCode,
-    queuedCount: queuedRequests.current.length,
+    offlineQueue,
+    queuedCount: offlineQueue.length,
     flushQueue
   };
 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useStampRally.ts"],"names":["result"],"mappings":";;;;AA4FA,SAAS,iBAAA,GAA0B;AACjC,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,QAAQ,KAAA,EAAuB;AACtC,EAAA,OAAO,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AACjE;AAEA,SAAS,sBAAA,CACP,cACA,MAAA,EACwB;AACxB,EAAA,IACE,YAAA,KAAiB,IAAA,IACjB,YAAA,CAAa,OAAA,CAAQ,IAAA,CAAK,CAAC,MAAA,KAAW,MAAA,CAAO,OAAA,KAAY,MAAA,CAAO,OAAO,CAAA,EACvE;AACA,IAAA,OAAO,YAAA;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACL,GAAG,YAAA;AAAA,IACH,OAAA,EAAS,CAAC,GAAG,YAAA,CAAa,OAAA,EAAS,EAAE,OAAA,EAAS,MAAA,CAAO,OAAA,EAAS,UAAA,EAAY,MAAA,CAAO,UAAA,EAAY,CAAA;AAAA,IAC7F,WAAW,MAAA,CAAO;AAAA,GACpB;AACF;AAEA,SAAS,oBAAA,GAA+B;AACtC,EAAA,MAAM,YAAY,UAAA,CAAW,MAAA;AAC7B,EAAA,IAAI,SAAA,KAAc,MAAA,IAAa,OAAO,SAAA,CAAU,eAAe,UAAA,EAAY;AACzE,IAAA,OAAO,UAAU,UAAA,EAAW;AAAA,EAC9B;AACA,EAAA,OAAO,CAAA,MAAA,EAAS,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,EAAO,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AACnE;AAEA,SAAS,SAAS,OAAA,EAA2C;AAC3D,EAAA,IAAI,OAAA,EAAS,aAAa,MAAA,EAAW;AACnC,IAAA,OAAO,OAAO,SAAA,KAAc,WAAA,IAAe,SAAA,CAAU,MAAA,KAAW,KAAA;AAAA,EAClE;AACA,EAAA,OAAO,OAAO,OAAA,CAAQ,QAAA,KAAa,aAAa,OAAA,CAAQ,QAAA,KAAa,OAAA,CAAQ,QAAA;AAC/E;AAEA,SAAS,uBAAuB,KAAA,EAAyB;AACvD,EAAA,OACE,KAAA,KAAU,KAAA,IACT,OAAO,KAAA,KAAU,QAAA,IAAY,UAAU,IAAA,IAAQ,IAAA,IAAQ,KAAA,IAAS,KAAA,CAAM,EAAA,KAAO,KAAA;AAElF;AAEO,SAAS,aAAA,CACd,MAAA,EACA,OAAA,GAAgC,EAAC,EACZ;AACrB,EAAA,MAAM,cAAc,OAAA,CAAQ,WAAA;AAC5B,EAAA,MAAM,SAAS,OAAA,CAAQ,MAAA;AACvB,EAAA,MAAM,cAAA,GAAiB,MAAA,CAAsC,EAAE,CAAA;AAC/D,EAAA,MAAM,SAAA,GAAY,WAAA;AAAA,IAChB,CAAC,aAAA,KAA8B,MAAA,CAAO,SAAA,CAAU,MAAM,eAAe,CAAA;AAAA,IACrE,CAAC,MAAM;AAAA,GACT;AACA,EAAA,MAAM,WAAA,GAAc,YAAY,MAAM,MAAA,CAAO,UAAS,EAAG,CAAC,MAAM,CAAC,CAAA;AACjE,EAAA,MAAM,QAAA,GAAW,oBAAA,CAAqB,SAAA,EAAW,WAAA,EAAa,iBAAiB,CAAA;AAC/E,EAAA,MAAM,CAAC,YAAA,EAAc,eAAe,CAAA,GAAI,SAAuB,OAAO;AAAA,IACpE,MAAA;AAAA,IACA,cAAA,EAAgB,MAAA,CAAO,QAAA,EAAS,KAAM;AAAA,GACxC,CAAE,CAAA;AACF,EAAA,MAAM,CAAC,WAAA,EAAa,cAAc,CAAA,GAAI,SAA6B,IAAI,CAAA;AACvE,EAAA,MAAM,CAAC,SAAS,CAAA,GAAI,aAAA,EAAc;AAClC,EAAA,MAAM,CAAC,kBAAA,EAAoB,qBAAqB,CAAA,GAAI,SAAS,KAAK,CAAA;AAClE,EAAA,MAAM,CAAC,eAAA,EAAiB,kBAAkB,CAAA,GAAI,SAAiC,QAAQ,CAAA;AAEvF,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,kBAAA,CAAmB,QAAQ,CAAA;AAAA,EAC7B,CAAA,EAAG,CAAC,QAAQ,CAAC,CAAA;AAEb,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,WAAA,EAAa,kBAAkB,MAAA,EAAW;AAC9C,IAAA,OAAO,MAAA,CAAO,SAAA,CAAU,WAAA,CAAY,aAAa,CAAA;AAAA,EACnD,CAAA,EAAG,CAAC,MAAA,EAAQ,WAAW,CAAC,CAAA;AAExB,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,MAAA,GAAS,IAAA;AACb,IAAA,cAAA,CAAe,IAAI,CAAA;AACnB,IAAA,IAAI,aAAa,IAAA,EAAM;AACrB,MAAA,eAAA,CAAgB,EAAE,MAAA,EAAQ,cAAA,EAAgB,KAAA,EAAO,CAAA;AACjD,MAAA,OAAO,MAAM;AACX,QAAA,MAAA,GAAS,KAAA;AAAA,MACX,CAAA;AAAA,IACF;AAEA,IAAA,eAAA,CAAgB,EAAE,MAAA,EAAQ,cAAA,EAAgB,IAAA,EAAM,CAAA;AAEhD,IAAA,KAAK,MAAA,CACF,IAAA,EAAK,CACL,KAAA,CAAM,CAAC,mBAAA,KAAiC;AACvC,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,OAAA,CAAQ,mBAAmB,GAAG,CAAA;AAAA,MAChE;AAAA,IACF,CAAC,CAAA,CACA,OAAA,CAAQ,MAAM;AACb,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,eAAA,CAAgB,EAAE,MAAA,EAAQ,cAAA,EAAgB,KAAA,EAAO,CAAA;AAAA,MACnD;AAAA,IACF,CAAC,CAAA;AAEH,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,GAAS,KAAA;AAAA,IACX,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,QAAQ,CAAC,CAAA;AAErB,EAAA,MAAM,OAAA,GAAU,WAAA;AAAA,IACd,CACE,OAAA,EACA,OAAA,EACA,GAAA,EACA,cAAA,KACmD;AACnD,MAAA,MAAM,UAAA,GAAa,GAAA,IAAA,iBAAO,IAAI,IAAA,IAAO,WAAA,EAAY;AACjD,MAAA,MAAM,OAAA,GAA0B;AAAA,QAC9B,OAAA;AAAA,QACA,OAAA;AAAA,QACA,GAAA,EAAK,UAAA;AAAA,QACL,cAAA,EAAgB,kBAAkB,oBAAA;AAAqB,OACzD;AACA,MAAA,cAAA,CAAe,IAAI,CAAA;AAEnB,MAAA,IAAI,CAAC,QAAA,CAAS,WAAW,CAAA,EAAG;AAC1B,QAAA,cAAA,CAAe,OAAA,GAAU,CAAC,GAAG,cAAA,CAAe,SAAS,OAAO,CAAA;AAC5D,QAAA,MAAM,MAAA,GAAgD;AAAA,UACpD,EAAA,EAAI,KAAA;AAAA,UACJ,OAAO,EAAE,IAAA,EAAM,kBAAkB,OAAA,EAAS,cAAA,EAAgB,QAAQ,cAAA;AAAe,SACnF;AACA,QAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAC9C,QAAA,OAAO,OAAA,CAAQ,QAAQ,MAAM,CAAA;AAAA,MAC/B;AAEA,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAC1B,MAAA,kBAAA,CAAmB,CAAC,YAAY,sBAAA,CAAuB,OAAA,EAAS,EAAE,OAAA,EAAS,UAAA,EAAY,CAAC,CAAA;AACxF,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,IAAI;AACF,YAAA,MAAM,MAAA,GAAS,MAAM,WAAA,EAAa,eAAA,GAAkB,OAAO,CAAA;AAC3D,YAAA,IAAI,WAAW,KAAA,EAAO;AACpB,cAAA,MAAM,QAAA,GAAkD;AAAA,gBACtD,EAAA,EAAI,KAAA;AAAA,gBACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,OAAA;AAAQ,eAC1C;AACA,cAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,CAAS,OAAO,CAAA;AAChD,cAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,cAAA,OAAA,CAAQ,QAAQ,CAAA;AAChB,cAAA;AAAA,YACF;AACA,YAAA,MAAM,SAAS,MAAM,MAAA,CAAO,OAAA,CAAQ,OAAA,EAAS,SAAS,UAAU,CAAA;AAChE,YAAA,IAAI,OAAO,EAAA,EAAI;AACb,cAAA,MAAM,QAAA,GAAW,MAAM,WAAA,EAAa,cAAA,GAAiB,OAAO,CAAA;AAC5D,cAAA,IAAI,sBAAA,CAAuB,QAAQ,CAAA,EAAG;AACpC,gBAAA,MAAM,MAAA,CAAO,QAAQ,QAAA,IAAY,MAAA,CAAO,UAAS,IAAK,MAAA,CAAO,MAAM,SAAS,CAAA;AAC5E,gBAAA,MAAM,QAAA,GAAkD;AAAA,kBACtD,EAAA,EAAI,KAAA;AAAA,kBACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,OAAA;AAAQ,iBAC1C;AACA,gBAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,QAAA,CAAS,OAAO,CAAA;AAChD,gBAAA,kBAAA,CAAmB,MAAA,CAAO,UAAU,CAAA;AACpC,gBAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,gBAAA,OAAA,CAAQ,QAAQ,CAAA;AAChB,gBAAA;AAAA,cACF;AACA,cAAA,KAAA,MAAW,KAAA,IAAS,MAAA,CAAO,KAAA,CAAM,MAAA,EAAQ;AACvC,gBAAA,IAAI,KAAA,CAAM,SAAS,eAAA,EAAiB;AAClC,kBAAA,CAAC,MAAA,EAAQ,cAAA,IAAkB,OAAA,CAAQ,cAAA,IAAkB,MAAM,MAAM,CAAA;AAAA,gBACnE;AACA,gBAAA,IAAI,KAAA,CAAM,SAAS,gBAAA,EAAkB;AACnC,kBAAA,CAAC,MAAA,EAAQ,gBAAA,IAAoB,OAAA,CAAQ,gBAAA,IAAoB,MAAM,QAAQ,CAAA;AAAA,gBACzE;AAAA,cACF;AAAA,YACF;AACA,YAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,cAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAC9C,cAAA,kBAAA,CAAmB,MAAA,CAAO,UAAU,CAAA;AAAA,YACtC;AACA,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AAAA,UAChB,SAAS,YAAA,EAAc;AACrB,YAAA,MAAM,eAAA,GAAkB,QAAQ,YAAY,CAAA;AAC5C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,kBAAA,CAAmB,MAAA,CAAO,UAAU,CAAA;AACpC,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,QAAQ,MAAA,EAAQ,OAAA,CAAQ,kBAAkB,OAAA,CAAQ,cAAA,EAAgB,UAAU,WAAW;AAAA,GAC1F;AAEA,EAAA,MAAM,KAAA,GAAQ,WAAA;AAAA,IACZ,CAAC,GAAA,KAA2C;AAC1C,MAAA,cAAA,CAAe,IAAI,CAAA;AACnB,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAE1B,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,IAAI;AACF,YAAA,MAAM,SAAA,GAAY,GAAA,KAAQ,KAAA,CAAA,GAAY,MAAM,MAAA,CAAO,OAAM,GAAI,MAAM,MAAA,CAAO,KAAA,CAAM,GAAG,CAAA;AACnF,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,SAAS,CAAA;AAAA,UACnB,SAAS,UAAA,EAAY;AACnB,YAAA,MAAM,eAAA,GAAkB,QAAQ,UAAU,CAAA;AAC1C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,MAAM;AAAA,GACT;AAEA,EAAA,MAAM,MAAA,GAAS,WAAA;AAAA,IACb,CAAC,QAAA,EAAkB,aAAA,GAA+B,EAAC,KAA8B;AAC/E,MAAA,cAAA,CAAe,IAAI,CAAA;AACnB,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAE1B,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,MAAM,MAAA,GAAS,MAAA,CAAO,SAAA,EAAU,CAAE,OAAA,EAAS,KAAK,CAAC,IAAA,KAAS,IAAA,CAAK,EAAA,KAAO,QAAQ,CAAA;AAC9E,UAAA,IAAI,WAAW,MAAA,EAAW;AACxB,YAAA,MAAMA,OAAAA,GAAwB;AAAA,cAC5B,EAAA,EAAI,KAAA;AAAA,cACJ,KAAA,EAAO,EAAE,IAAA,EAAM,kBAAA,EAAoB,QAAA;AAAS,aAC9C;AACA,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAOA,OAAAA,CAAO,OAAO,CAAA;AAC9C,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQA,OAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,YAAA,GAAe,OAAO,QAAA,EAAS;AACrC,UAAA,MAAM,kBAAA,GAAqB,cAAc,OAAA,EAAS,IAAA;AAAA,YAChD,CAAC,KAAA,KAAU,KAAA,CAAM,QAAA,KAAa;AAAA,WAChC;AACA,UAAA,IAAI,YAAA,KAAiB,IAAA,IAAQ,kBAAA,KAAuB,MAAA,EAAW;AAC7D,YAAA,MAAMA,OAAAA,GAAwB;AAAA,cAC5B,EAAA,EAAI,KAAA;AAAA,cACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,QAAA;AAAS,aAC3C;AACA,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAOA,OAAAA,CAAO,OAAO,CAAA;AAC9C,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQA,OAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,SAAS,aAAA,CAAc;AAAA,YAC3B,MAAA;AAAA,YACA,YAAA,EAAc,kBAAA;AAAA,YACd,GAAA,EAAA,iBAAK,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,YAC5B,GAAI,cAAc,QAAA,KAAa,MAAA,GAC3B,EAAC,GACD,EAAE,aAAA,EAAe,aAAA,CAAc,QAAA,EAAS;AAAA,YAC5C,GAAI,cAAc,OAAA,KAAY,MAAA,GAAY,EAAC,GAAI,EAAE,OAAA,EAAS,aAAA,CAAc,OAAA;AAAQ,WACjF,CAAA;AACD,UAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,MAAA,CAAO,OAAO,CAAA;AAC9C,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,IAAI,MAAA,CAAO,UAAU,kBAAA,EAAoB;AACvC,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AACd,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,SAAA,GAA6B;AAAA,YACjC,GAAG,YAAA;AAAA,YACH,OAAA,EAAA,CAAU,YAAA,CAAa,OAAA,IAAW,EAAC,EAAG,GAAA;AAAA,cAAI,CAAC,KAAA,KACzC,KAAA,CAAM,QAAA,KAAa,QAAA,GAAW,OAAO,KAAA,GAAQ;AAAA,aAC/C;AAAA,YACA,SAAA,EAAW,MAAA,CAAO,KAAA,CAAM,UAAA,IAAc,YAAA,CAAa;AAAA,WACrD;AAEA,UAAA,IAAI;AACF,YAAA,MAAM,MAAA,CAAO,QAAQ,SAAS,CAAA;AAC9B,YAAA,CAAC,MAAA,EAAQ,gBAAA,IAAoB,OAAA,CAAQ,gBAAA,IAAoB,QAAQ,CAAA;AACjE,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,MAAM,CAAA;AAAA,UAChB,SAAS,WAAA,EAAa;AACpB,YAAA,MAAM,eAAA,GAAkB,QAAQ,WAAW,CAAA;AAC3C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,MAAA,EAAQ,MAAA,EAAQ,OAAA,CAAQ,gBAAgB;AAAA,GAC3C;AAEA,EAAA,MAAM,kBAAA,GAAqB,YAAY,MAAc;AACnD,IAAA,MAAM,KAAA,GAAQ,OAAO,QAAA,EAAS;AAC9B,IAAA,IAAI,UAAU,IAAA,EAAM;AAClB,MAAA,MAAM,IAAI,MAAM,8DAA8D,CAAA;AAAA,IAChF;AAEA,IAAA,OAAO,mBAAA,CAAoB;AAAA,MACzB,OAAA,EAAS,CAAA;AAAA,MACT,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,QAAQ,KAAA,CAAM,OAAA;AAAA,MACd,OAAA,EAAS,KAAA,CAAM,OAAA,IAAW,EAAC;AAAA,MAC3B,UAAA,EAAA,iBAAY,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,KACpC,CAAA;AAAA,EACH,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AAEX,EAAA,MAAM,kBAAA,GAAqB,WAAA;AAAA,IACzB,CAAC,KAAA,KAAoC;AACnC,MAAA,cAAA,CAAe,IAAI,CAAA;AACnB,MAAA,qBAAA,CAAsB,IAAI,CAAA;AAE1B,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,KAAA,CAAM,YAAY;AAChB,UAAA,MAAM,MAAA,GAAS,OAAO,SAAA,EAAU;AAChC,UAAA,MAAM,QAAA,GAAW,mBAAA,CAAoB,KAAA,EAAO,MAAA,CAAO,EAAE,CAAA;AACrD,UAAA,IAAI,aAAa,IAAA,EAAM;AACrB,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,KAAK,CAAA;AACb,YAAA;AAAA,UACF;AAEA,UAAA,MAAM,QAAA,GAAW,IAAI,GAAA,CAAI,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,KAAA,KAAU,KAAA,CAAM,EAAE,CAAC,CAAA;AAC/D,UAAA,MAAM,SAAA,GAAY,IAAI,GAAA,CAAA,CAAK,MAAA,CAAO,OAAA,IAAW,EAAC,EAAG,GAAA,CAAI,CAAC,MAAA,KAAW,MAAA,CAAO,EAAE,CAAC,CAAA;AAC3E,UAAA,MAAM,gBAAA,uBAAuB,GAAA,EAAY;AACzC,UAAA,MAAM,iBAAA,uBAAwB,GAAA,EAAY;AAC1C,UAAA,MAAM,MAAA,GAAS,QAAA,CAAS,MAAA,CAAO,MAAA,CAAO,CAAC,MAAA,KAAW;AAChD,YAAA,IAAI,CAAC,QAAA,CAAS,GAAA,CAAI,MAAA,CAAO,OAAO,CAAA,IAAK,gBAAA,CAAiB,GAAA,CAAI,MAAA,CAAO,OAAO,CAAA,EAAG,OAAO,KAAA;AAClF,YAAA,gBAAA,CAAiB,GAAA,CAAI,OAAO,OAAO,CAAA;AACnC,YAAA,OAAO,IAAA;AAAA,UACT,CAAC,CAAA;AACD,UAAA,MAAM,OAAA,GAAU,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,CAAC,KAAA,KAAU;AACjD,YAAA,IAAI,CAAC,UAAU,GAAA,CAAI,KAAA,CAAM,QAAQ,CAAA,IAAK,iBAAA,CAAkB,GAAA,CAAI,KAAA,CAAM,QAAQ,CAAA;AACxE,cAAA,OAAO,KAAA;AACT,YAAA,iBAAA,CAAkB,GAAA,CAAI,MAAM,QAAQ,CAAA;AACpC,YAAA,OAAO,IAAA;AAAA,UACT,CAAC,CAAA;AAED,UAAA,IAAI;AACF,YAAA,MAAM,OAAO,OAAA,CAAQ;AAAA,cACnB,SAAS,MAAA,CAAO,EAAA;AAAA,cAChB,OAAA,EAAS,MAAA;AAAA,cACT,GAAI,MAAA,CAAO,OAAA,KAAY,KAAA,CAAA,IAAa,OAAA,CAAQ,WAAW,CAAA,GAAI,EAAC,GAAI,EAAE,OAAA,EAAQ;AAAA,cAC1E,WAAW,QAAA,CAAS;AAAA,aACrB,CAAA;AACD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,OAAA,CAAQ,IAAI,CAAA;AAAA,UACd,SAAS,WAAA,EAAa;AACpB,YAAA,MAAM,eAAA,GAAkB,QAAQ,WAAW,CAAA;AAC3C,YAAA,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,eAAA,EAAiB,CAAA;AACjD,YAAA,qBAAA,CAAsB,KAAK,CAAA;AAC3B,YAAA,MAAA,CAAO,eAAe,CAAA;AAAA,UACxB;AAAA,QACF,CAAA,GAAG;AAAA,MACL,CAAC,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,MAAM;AAAA,GACT;AAEA,EAAA,MAAM,YACJ,QAAA,KAAa,IAAA,KAAS,YAAA,CAAa,MAAA,KAAW,UAAU,YAAA,CAAa,cAAA,CAAA;AACvE,EAAA,MAAM,KAAA,GAAQ,WAAA,EAAa,MAAA,KAAW,MAAA,GAAS,YAAY,KAAA,GAAQ,IAAA;AAEnE,EAAA,MAAM,UAAA,GAAa,YAAY,YAA2B;AACxD,IAAA,IAAI,CAAC,QAAA,CAAS,WAAW,CAAA,EAAG;AAC5B,IAAA,MAAM,UAAU,cAAA,CAAe,OAAA;AAC/B,IAAA,cAAA,CAAe,UAAU,EAAC;AAC1B,IAAA,KAAA,MAAW,WAAW,OAAA,EAAS;AAC7B,MAAA,MAAM,OAAA,CAAQ,QAAQ,OAAA,EAAS,OAAA,CAAQ,SAAS,OAAA,CAAQ,GAAA,EAAK,QAAQ,cAAc,CAAA;AAAA,IACrF;AAAA,EACF,CAAA,EAAG,CAAC,OAAA,EAAS,WAAW,CAAC,CAAA;AAEzB,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,eAAA;AAAA,IACP,SAAA;AAAA,IACA,WAAW,SAAA,IAAa,kBAAA;AAAA,IACxB,KAAA;AAAA,IACA,YAAA,EAAc,eAAA,EAAiB,OAAA,IAAW,EAAC;AAAA,IAC3C,OAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IACA,kBAAA;AAAA,IACA,kBAAA;AAAA,IACA,WAAA,EAAa,eAAe,OAAA,CAAQ,MAAA;AAAA,IACpC;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type {\n  ConsumeResult,\n  ProcessStampValue,\n  Result,\n  RewardConsumeError,\n  RewardState,\n  StampError,\n  StampRallyClient,\n  StampRallyState,\n  VerificationContext,\n} from \"@stamprally/core\";\nimport { consumeReward, exportProgressToken, importProgressToken } from \"@stamprally/core\";\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  useTransition,\n} from \"react\";\n\ninterface OptimisticAcquire {\n  readonly stampId: string;\n  readonly acquiredAt: string;\n}\n\ninterface ClientStatus {\n  readonly client: StampRallyClient;\n  readonly isInitializing: boolean;\n}\n\ninterface ClientError {\n  readonly client: StampRallyClient;\n  readonly value: StampError | RewardConsumeError | Error;\n}\n\nexport interface CheckInRequest {\n  readonly stampId: string;\n  readonly context: VerificationContext;\n  readonly now: string;\n  readonly idempotencyKey: string;\n}\n\nexport interface SyncAdapter {\n  readonly isOnline?: boolean | (() => boolean);\n  readonly onBeforeCheckIn?: (request: CheckInRequest) => unknown;\n  readonly onServerVerify?: (request: CheckInRequest) => unknown;\n  readonly onStateChange?: (state: StampRallyState) => void;\n}\n\nexport interface StampRallyEventHandlers {\n  readonly onStampClaimed?: (record: StampRallyState[\"records\"][number]) => void;\n  readonly onRewardUnlocked?: (rewardId: string) => void;\n  readonly onRewardConsumed?: (rewardId: string) => void;\n}\n\nexport interface UseStampRallyOptions {\n  readonly syncAdapter?: SyncAdapter;\n  readonly events?: StampRallyEventHandlers;\n  readonly onStampClaimed?: StampRallyEventHandlers[\"onStampClaimed\"];\n  readonly onRewardUnlocked?: StampRallyEventHandlers[\"onRewardUnlocked\"];\n  readonly onRewardConsumed?: StampRallyEventHandlers[\"onRewardConsumed\"];\n}\n\nexport interface RedeemOptions {\n  readonly passcode?: string;\n  readonly staffId?: string;\n}\n\nexport interface UseStampRallyReturn {\n  readonly state: StampRallyState | null;\n  readonly isLoading: boolean;\n  readonly isPending: boolean;\n  readonly error: StampError | RewardConsumeError | Error | null;\n  readonly rewardsState: ReadonlyArray<RewardState>;\n  readonly acquire: (\n    stampId: string,\n    context: VerificationContext,\n    now?: string,\n    idempotencyKey?: string,\n  ) => Promise<Result<ProcessStampValue, StampError>>;\n  readonly reset: (now?: string) => Promise<StampRallyState>;\n  readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;\n  readonly exportRecoveryCode: () => string;\n  readonly importRecoveryCode: (token: string) => Promise<boolean>;\n  readonly queuedCount: number;\n  readonly flushQueue: () => Promise<void>;\n}\n\n/** @deprecated Use UseStampRallyReturn instead. */\nexport type UseStampRallyValue = UseStampRallyReturn;\n\nfunction getServerSnapshot(): null {\n  return null;\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\nfunction applyOptimisticAcquire(\n  currentState: StampRallyState | null,\n  action: OptimisticAcquire,\n): StampRallyState | null {\n  if (\n    currentState === null ||\n    currentState.records.some((record) => record.stampId === action.stampId)\n  ) {\n    return currentState;\n  }\n\n  return {\n    ...currentState,\n    records: [...currentState.records, { stampId: action.stampId, acquiredAt: action.acquiredAt }],\n    updatedAt: action.acquiredAt,\n  };\n}\n\nfunction createIdempotencyKey(): string {\n  const cryptoApi = globalThis.crypto;\n  if (cryptoApi !== undefined && typeof cryptoApi.randomUUID === \"function\") {\n    return cryptoApi.randomUUID();\n  }\n  return `stamp-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction isOnline(adapter: SyncAdapter | undefined): boolean {\n  if (adapter?.isOnline === undefined) {\n    return typeof navigator === \"undefined\" || navigator.onLine !== false;\n  }\n  return typeof adapter.isOnline === \"function\" ? adapter.isOnline() : adapter.isOnline;\n}\n\nfunction isRejectedVerification(value: unknown): boolean {\n  return (\n    value === false ||\n    (typeof value === \"object\" && value !== null && \"ok\" in value && value.ok === false)\n  );\n}\n\nexport function useStampRally(\n  client: StampRallyClient,\n  options: UseStampRallyOptions = {},\n): UseStampRallyReturn {\n  const syncAdapter = options.syncAdapter;\n  const events = options.events;\n  const queuedRequests = useRef<ReadonlyArray<CheckInRequest>>([]);\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => client.subscribe(() => onStoreChange()),\n    [client],\n  );\n  const getSnapshot = useCallback(() => client.getState(), [client]);\n  const rawState = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n  const [clientStatus, setClientStatus] = useState<ClientStatus>(() => ({\n    client,\n    isInitializing: client.getState() === null,\n  }));\n  const [clientError, setClientError] = useState<ClientError | null>(null);\n  const [isPending] = useTransition();\n  const [isOperationPending, setIsOperationPending] = useState(false);\n  const [optimisticState, setOptimisticState] = useState<StampRallyState | null>(rawState);\n\n  useEffect(() => {\n    setOptimisticState(rawState);\n  }, [rawState]);\n\n  useEffect(() => {\n    if (syncAdapter?.onStateChange === undefined) return;\n    return client.subscribe(syncAdapter.onStateChange);\n  }, [client, syncAdapter]);\n\n  useEffect(() => {\n    let active = true;\n    setClientError(null);\n    if (rawState !== null) {\n      setClientStatus({ client, isInitializing: false });\n      return () => {\n        active = false;\n      };\n    }\n\n    setClientStatus({ client, isInitializing: true });\n\n    void client\n      .init()\n      .catch((initializationError: unknown) => {\n        if (active) {\n          setClientError({ client, value: toError(initializationError) });\n        }\n      })\n      .finally(() => {\n        if (active) {\n          setClientStatus({ client, isInitializing: false });\n        }\n      });\n\n    return () => {\n      active = false;\n    };\n  }, [client, rawState]);\n\n  const acquire = useCallback(\n    (\n      stampId: string,\n      context: VerificationContext,\n      now?: string,\n      idempotencyKey?: string,\n    ): Promise<Result<ProcessStampValue, StampError>> => {\n      const acquiredAt = now ?? new Date().toISOString();\n      const request: CheckInRequest = {\n        stampId,\n        context,\n        now: acquiredAt,\n        idempotencyKey: idempotencyKey ?? createIdempotencyKey(),\n      };\n      setClientError(null);\n\n      if (!isOnline(syncAdapter)) {\n        queuedRequests.current = [...queuedRequests.current, request];\n        const queued: Result<ProcessStampValue, StampError> = {\n          ok: false,\n          error: { code: \"OFFLINE_QUEUED\", stampId, idempotencyKey: request.idempotencyKey },\n        };\n        setClientError({ client, value: queued.error });\n        return Promise.resolve(queued);\n      }\n\n      setIsOperationPending(true);\n      setOptimisticState((current) => applyOptimisticAcquire(current, { stampId, acquiredAt }));\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const before = await syncAdapter?.onBeforeCheckIn?.(request);\n            if (before === false) {\n              const rejected: Result<ProcessStampValue, StampError> = {\n                ok: false,\n                error: { code: \"INVALID_PROOF\", stampId },\n              };\n              setClientError({ client, value: rejected.error });\n              setIsOperationPending(false);\n              resolve(rejected);\n              return;\n            }\n            const result = await client.acquire(stampId, context, acquiredAt);\n            if (result.ok) {\n              const verified = await syncAdapter?.onServerVerify?.(request);\n              if (isRejectedVerification(verified)) {\n                await client.restore(rawState ?? client.getState() ?? result.value.nextState);\n                const rejected: Result<ProcessStampValue, StampError> = {\n                  ok: false,\n                  error: { code: \"INVALID_PROOF\", stampId },\n                };\n                setClientError({ client, value: rejected.error });\n                setOptimisticState(client.getState());\n                setIsOperationPending(false);\n                resolve(rejected);\n                return;\n              }\n              for (const event of result.value.events) {\n                if (event.type === \"stampAcquired\") {\n                  (events?.onStampClaimed ?? options.onStampClaimed)?.(event.record);\n                }\n                if (event.type === \"rewardUnlocked\") {\n                  (events?.onRewardUnlocked ?? options.onRewardUnlocked)?.(event.rewardId);\n                }\n              }\n            }\n            if (!result.ok) {\n              setClientError({ client, value: result.error });\n              setOptimisticState(client.getState());\n            }\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (acquireError) {\n            const normalizedError = toError(acquireError);\n            setClientError({ client, value: normalizedError });\n            setOptimisticState(client.getState());\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client, events, options.onRewardUnlocked, options.onStampClaimed, rawState, syncAdapter],\n  );\n\n  const reset = useCallback(\n    (now?: string): Promise<StampRallyState> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const nextState = now === undefined ? await client.reset() : await client.reset(now);\n            setIsOperationPending(false);\n            resolve(nextState);\n          } catch (resetError) {\n            const normalizedError = toError(resetError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const redeem = useCallback(\n    (rewardId: string, redeemOptions: RedeemOptions = {}): Promise<ConsumeResult> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);\n          if (reward === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"REWARD_NOT_FOUND\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const currentState = client.getState();\n          const currentRewardState = currentState?.rewards?.find(\n            (state) => state.rewardId === rewardId,\n          );\n          if (currentState === null || currentRewardState === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"NOT_AVAILABLE\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const result = consumeReward({\n            reward,\n            currentState: currentRewardState,\n            now: new Date().toISOString(),\n            ...(redeemOptions.passcode === undefined\n              ? {}\n              : { inputPasscode: redeemOptions.passcode }),\n            ...(redeemOptions.staffId === undefined ? {} : { staffId: redeemOptions.staffId }),\n          });\n          if (!result.ok) {\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          if (result.value === currentRewardState) {\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const nextState: StampRallyState = {\n            ...currentState,\n            rewards: (currentState.rewards ?? []).map((state) =>\n              state.rewardId === rewardId ? result.value : state,\n            ),\n            updatedAt: result.value.consumedAt ?? currentState.updatedAt,\n          };\n\n          try {\n            await client.restore(nextState);\n            (events?.onRewardConsumed ?? options.onRewardConsumed)?.(rewardId);\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (redeemError) {\n            const normalizedError = toError(redeemError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client, events, options.onRewardConsumed],\n  );\n\n  const exportRecoveryCode = useCallback((): string => {\n    const state = client.getState();\n    if (state === null) {\n      throw new Error(\"Cannot export recovery code before the rally is initialized.\");\n    }\n\n    return exportProgressToken({\n      version: 1,\n      rallyId: state.rallyId,\n      stamps: state.records,\n      rewards: state.rewards ?? [],\n      exportedAt: new Date().toISOString(),\n    });\n  }, [client]);\n\n  const importRecoveryCode = useCallback(\n    (token: string): Promise<boolean> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const config = client.getConfig();\n          const snapshot = importProgressToken(token, config.id);\n          if (snapshot === null) {\n            setIsOperationPending(false);\n            resolve(false);\n            return;\n          }\n\n          const stampIds = new Set(config.stamps.map((stamp) => stamp.id));\n          const rewardIds = new Set((config.rewards ?? []).map((reward) => reward.id));\n          const importedStampIds = new Set<string>();\n          const importedRewardIds = new Set<string>();\n          const stamps = snapshot.stamps.filter((record) => {\n            if (!stampIds.has(record.stampId) || importedStampIds.has(record.stampId)) return false;\n            importedStampIds.add(record.stampId);\n            return true;\n          });\n          const rewards = snapshot.rewards.filter((state) => {\n            if (!rewardIds.has(state.rewardId) || importedRewardIds.has(state.rewardId))\n              return false;\n            importedRewardIds.add(state.rewardId);\n            return true;\n          });\n\n          try {\n            await client.restore({\n              rallyId: config.id,\n              records: stamps,\n              ...(config.rewards === undefined && rewards.length === 0 ? {} : { rewards }),\n              updatedAt: snapshot.exportedAt,\n            });\n            setIsOperationPending(false);\n            resolve(true);\n          } catch (importError) {\n            const normalizedError = toError(importError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const isLoading =\n    rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);\n  const error = clientError?.client === client ? clientError.value : null;\n\n  const flushQueue = useCallback(async (): Promise<void> => {\n    if (!isOnline(syncAdapter)) return;\n    const pending = queuedRequests.current;\n    queuedRequests.current = [];\n    for (const request of pending) {\n      await acquire(request.stampId, request.context, request.now, request.idempotencyKey);\n    }\n  }, [acquire, syncAdapter]);\n\n  return {\n    state: optimisticState,\n    isLoading,\n    isPending: isPending || isOperationPending,\n    error,\n    rewardsState: optimisticState?.rewards ?? [],\n    acquire,\n    reset,\n    redeem,\n    exportRecoveryCode,\n    importRecoveryCode,\n    queuedCount: queuedRequests.current.length,\n    flushQueue,\n  };\n}\n"]}
+{"version":3,"sources":["../src/useStampRally.ts"],"names":["result"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  ConsumeResult,\n  ProcessStampValue,\n  Result,\n  RewardConsumeError,\n  RewardState,\n  StampError,\n  StampRallyClient,\n  StampRallyState,\n  VerificationContext,\n} from \"@stamprally/core\";\nimport { consumeReward, exportProgressToken, importProgressToken } from \"@stamprally/core\";\nimport {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  useTransition,\n} from \"react\";\n\ninterface OptimisticAcquire {\n  readonly stampId: string;\n  readonly acquiredAt: string;\n}\n\ninterface ClientStatus {\n  readonly client: StampRallyClient;\n  readonly isInitializing: boolean;\n}\n\ninterface ClientError {\n  readonly client: StampRallyClient;\n  readonly value: StampError | RewardConsumeError | Error;\n}\n\ninterface QueuedRequestMetadata {\n  readonly previousState: StampRallyState | null;\n  readonly result: ProcessStampValue;\n}\n\nexport interface CheckInRequest {\n  readonly stampId: string;\n  readonly context: VerificationContext;\n  readonly now: string;\n  readonly idempotencyKey: string;\n}\n\nexport interface SyncAdapter {\n  readonly isOnline?: boolean | (() => boolean);\n  readonly onBeforeCheckIn?: (request: CheckInRequest) => unknown;\n  readonly onServerVerify?: (request: CheckInRequest) => unknown;\n  readonly onStateChange?: (state: StampRallyState) => void;\n}\n\nexport interface StampRallyEventHandlers {\n  readonly onStampClaimed?: (record: StampRallyState[\"records\"][number]) => void;\n  readonly onRewardUnlocked?: (rewardId: string) => void;\n  readonly onRewardConsumed?: (rewardId: string) => void;\n}\n\nexport interface UseStampRallyOptions {\n  readonly syncAdapter?: SyncAdapter;\n  readonly events?: StampRallyEventHandlers;\n  readonly onStampClaimed?: StampRallyEventHandlers[\"onStampClaimed\"];\n  readonly onRewardUnlocked?: StampRallyEventHandlers[\"onRewardUnlocked\"];\n  readonly onRewardConsumed?: StampRallyEventHandlers[\"onRewardConsumed\"];\n}\n\nexport interface RedeemOptions {\n  readonly passcode?: string;\n  readonly staffId?: string;\n}\n\nexport interface UseStampRallyReturn {\n  readonly state: StampRallyState | null;\n  readonly isLoading: boolean;\n  readonly isPending: boolean;\n  readonly error: StampError | RewardConsumeError | Error | null;\n  readonly rewardsState: ReadonlyArray<RewardState>;\n  readonly acquire: (\n    stampId: string,\n    context: VerificationContext,\n    now?: string,\n    idempotencyKey?: string,\n  ) => Promise<Result<ProcessStampValue, StampError>>;\n  readonly reset: (now?: string) => Promise<StampRallyState>;\n  readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;\n  readonly exportRecoveryCode: () => string;\n  readonly importRecoveryCode: (token: string) => Promise<boolean>;\n  readonly offlineQueue: ReadonlyArray<CheckInRequest>;\n  readonly queuedCount: number;\n  readonly flushQueue: () => Promise<void>;\n}\n\n/** @deprecated Use UseStampRallyReturn instead. */\nexport type UseStampRallyValue = UseStampRallyReturn;\n\nfunction getServerSnapshot(): null {\n  return null;\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\nfunction applyOptimisticAcquire(\n  currentState: StampRallyState | null,\n  action: OptimisticAcquire,\n): StampRallyState | null {\n  if (\n    currentState === null ||\n    currentState.records.some((record) => record.stampId === action.stampId)\n  ) {\n    return currentState;\n  }\n\n  return {\n    ...currentState,\n    records: [...currentState.records, { stampId: action.stampId, acquiredAt: action.acquiredAt }],\n    updatedAt: action.acquiredAt,\n  };\n}\n\nfunction createIdempotencyKey(): string {\n  const cryptoApi = globalThis.crypto;\n  if (cryptoApi !== undefined && typeof cryptoApi.randomUUID === \"function\") {\n    return cryptoApi.randomUUID();\n  }\n  return `stamp-${Date.now()}-${Math.random().toString(36).slice(2)}`;\n}\n\nfunction isOnline(adapter: SyncAdapter | undefined): boolean {\n  if (adapter?.isOnline === undefined) {\n    return typeof navigator === \"undefined\" || navigator.onLine !== false;\n  }\n  return typeof adapter.isOnline === \"function\" ? adapter.isOnline() : adapter.isOnline;\n}\n\nfunction isRejectedVerification(value: unknown): boolean {\n  return (\n    value === false ||\n    (typeof value === \"object\" && value !== null && \"ok\" in value && value.ok === false)\n  );\n}\n\nfunction isNetworkFailure(error: unknown): boolean {\n  if (typeof navigator !== \"undefined\" && navigator.onLine === false) return true;\n  if (!(error instanceof Error)) return true;\n  return /aborted|connection|fetch|network|offline|timeout/i.test(`${error.name} ${error.message}`);\n}\n\nfunction notifyAcquisitionEvents(\n  result: ProcessStampValue,\n  events: StampRallyEventHandlers | undefined,\n  onStampClaimed: StampRallyEventHandlers[\"onStampClaimed\"] | undefined,\n  onRewardUnlocked: StampRallyEventHandlers[\"onRewardUnlocked\"] | undefined,\n): void {\n  for (const event of result.events) {\n    if (event.type === \"stampAcquired\") {\n      (events?.onStampClaimed ?? onStampClaimed)?.(event.record);\n    }\n    if (event.type === \"rewardUnlocked\") {\n      (events?.onRewardUnlocked ?? onRewardUnlocked)?.(event.rewardId);\n    }\n  }\n}\n\nexport function useStampRally(\n  client: StampRallyClient,\n  options: UseStampRallyOptions = {},\n): UseStampRallyReturn {\n  const syncAdapter = options.syncAdapter;\n  const events = options.events;\n  const [offlineQueue, setOfflineQueue] = useState<ReadonlyArray<CheckInRequest>>([]);\n  const queuedMetadata = useRef(new Map<string, QueuedRequestMetadata>());\n  const isFlushingQueue = useRef(false);\n  const activeClient = useRef(client);\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => client.subscribe(() => onStoreChange()),\n    [client],\n  );\n  const getSnapshot = useCallback(() => client.getState(), [client]);\n  const rawState = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n  const [clientStatus, setClientStatus] = useState<ClientStatus>(() => ({\n    client,\n    isInitializing: client.getState() === null,\n  }));\n  const [clientError, setClientError] = useState<ClientError | null>(null);\n  const [isPending] = useTransition();\n  const [isOperationPending, setIsOperationPending] = useState(false);\n  const [optimisticState, setOptimisticState] = useState<StampRallyState | null>(rawState);\n\n  useEffect(() => {\n    setOptimisticState(rawState);\n  }, [rawState]);\n\n  useEffect(() => {\n    if (activeClient.current === client) return;\n    activeClient.current = client;\n    setOfflineQueue([]);\n    queuedMetadata.current.clear();\n  }, [client]);\n\n  useEffect(() => {\n    if (syncAdapter?.onStateChange === undefined) return;\n    return client.subscribe(syncAdapter.onStateChange);\n  }, [client, syncAdapter]);\n\n  useEffect(() => {\n    let active = true;\n    setClientError(null);\n    if (rawState !== null) {\n      setClientStatus({ client, isInitializing: false });\n      return () => {\n        active = false;\n      };\n    }\n\n    setClientStatus({ client, isInitializing: true });\n\n    void client\n      .init()\n      .catch((initializationError: unknown) => {\n        if (active) {\n          setClientError({ client, value: toError(initializationError) });\n        }\n      })\n      .finally(() => {\n        if (active) {\n          setClientStatus({ client, isInitializing: false });\n        }\n      });\n\n    return () => {\n      active = false;\n    };\n  }, [client, rawState]);\n\n  const queueRequest = useCallback(\n    (request: CheckInRequest, metadata?: QueuedRequestMetadata): void => {\n      if (metadata !== undefined) queuedMetadata.current.set(request.idempotencyKey, metadata);\n      setOfflineQueue((current) =>\n        current.some((item) => item.idempotencyKey === request.idempotencyKey)\n          ? current\n          : [...current, request],\n      );\n    },\n    [],\n  );\n\n  const acquire = useCallback(\n    (\n      stampId: string,\n      context: VerificationContext,\n      now?: string,\n      idempotencyKey?: string,\n    ): Promise<Result<ProcessStampValue, StampError>> => {\n      const acquiredAt = now ?? new Date().toISOString();\n      const request: CheckInRequest = {\n        stampId,\n        context,\n        now: acquiredAt,\n        idempotencyKey: idempotencyKey ?? createIdempotencyKey(),\n      };\n      setClientError(null);\n\n      if (!isOnline(syncAdapter)) {\n        queueRequest(request);\n        const queued: Result<ProcessStampValue, StampError> = {\n          ok: false,\n          error: { code: \"OFFLINE_QUEUED\", stampId, idempotencyKey: request.idempotencyKey },\n        };\n        setClientError({ client, value: queued.error });\n        return Promise.resolve(queued);\n      }\n\n      setIsOperationPending(true);\n      setOptimisticState((current) => applyOptimisticAcquire(current, { stampId, acquiredAt }));\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const before = await syncAdapter?.onBeforeCheckIn?.(request);\n            if (before === false) {\n              const rejected: Result<ProcessStampValue, StampError> = {\n                ok: false,\n                error: { code: \"INVALID_PROOF\", stampId },\n              };\n              setClientError({ client, value: rejected.error });\n              setIsOperationPending(false);\n              resolve(rejected);\n              return;\n            }\n            const previousState = client.getState();\n            const result = await client.acquire(stampId, context, acquiredAt);\n            if (result.ok) {\n              let verified: unknown;\n              try {\n                verified = await syncAdapter?.onServerVerify?.(request);\n              } catch (verificationError) {\n                if (!isNetworkFailure(verificationError)) throw verificationError;\n                queueRequest(request, { previousState, result: result.value });\n                const queued: Result<ProcessStampValue, StampError> = {\n                  ok: false,\n                  error: {\n                    code: \"OFFLINE_QUEUED\",\n                    stampId,\n                    idempotencyKey: request.idempotencyKey,\n                  },\n                };\n                setClientError({ client, value: toError(verificationError) });\n                setOptimisticState(client.getState());\n                setIsOperationPending(false);\n                resolve(queued);\n                return;\n              }\n              if (isRejectedVerification(verified)) {\n                await client.restore(rawState ?? client.getState() ?? result.value.nextState);\n                const rejected: Result<ProcessStampValue, StampError> = {\n                  ok: false,\n                  error: { code: \"INVALID_PROOF\", stampId },\n                };\n                setClientError({ client, value: rejected.error });\n                setOptimisticState(client.getState());\n                setIsOperationPending(false);\n                resolve(rejected);\n                return;\n              }\n              notifyAcquisitionEvents(\n                result.value,\n                events,\n                options.onStampClaimed,\n                options.onRewardUnlocked,\n              );\n            }\n            if (!result.ok) {\n              setClientError({ client, value: result.error });\n              setOptimisticState(client.getState());\n            }\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (acquireError) {\n            if (isNetworkFailure(acquireError)) {\n              queueRequest(request);\n              const queued: Result<ProcessStampValue, StampError> = {\n                ok: false,\n                error: { code: \"OFFLINE_QUEUED\", stampId, idempotencyKey: request.idempotencyKey },\n              };\n              setClientError({ client, value: queued.error });\n              setOptimisticState(client.getState());\n              setIsOperationPending(false);\n              resolve(queued);\n              return;\n            }\n            const normalizedError = toError(acquireError);\n            setClientError({ client, value: normalizedError });\n            setOptimisticState(client.getState());\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [\n      client,\n      events,\n      options.onRewardUnlocked,\n      options.onStampClaimed,\n      queueRequest,\n      rawState,\n      syncAdapter,\n    ],\n  );\n\n  const reset = useCallback(\n    (now?: string): Promise<StampRallyState> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          try {\n            const nextState = now === undefined ? await client.reset() : await client.reset(now);\n            setIsOperationPending(false);\n            resolve(nextState);\n          } catch (resetError) {\n            const normalizedError = toError(resetError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const redeem = useCallback(\n    (rewardId: string, redeemOptions: RedeemOptions = {}): Promise<ConsumeResult> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);\n          if (reward === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"REWARD_NOT_FOUND\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const currentState = client.getState();\n          const currentRewardState = currentState?.rewards?.find(\n            (state) => state.rewardId === rewardId,\n          );\n          if (currentState === null || currentRewardState === undefined) {\n            const result: ConsumeResult = {\n              ok: false,\n              error: { code: \"NOT_AVAILABLE\", rewardId },\n            };\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const result = consumeReward({\n            reward,\n            currentState: currentRewardState,\n            now: new Date().toISOString(),\n            ...(redeemOptions.passcode === undefined\n              ? {}\n              : { inputPasscode: redeemOptions.passcode }),\n            ...(redeemOptions.staffId === undefined ? {} : { staffId: redeemOptions.staffId }),\n          });\n          if (!result.ok) {\n            setClientError({ client, value: result.error });\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          if (result.value === currentRewardState) {\n            setIsOperationPending(false);\n            resolve(result);\n            return;\n          }\n\n          const nextState: StampRallyState = {\n            ...currentState,\n            rewards: (currentState.rewards ?? []).map((state) =>\n              state.rewardId === rewardId ? result.value : state,\n            ),\n            updatedAt: result.value.consumedAt ?? currentState.updatedAt,\n          };\n\n          try {\n            await client.restore(nextState);\n            (events?.onRewardConsumed ?? options.onRewardConsumed)?.(rewardId);\n            setIsOperationPending(false);\n            resolve(result);\n          } catch (redeemError) {\n            const normalizedError = toError(redeemError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client, events, options.onRewardConsumed],\n  );\n\n  const exportRecoveryCode = useCallback((): string => {\n    const state = client.getState();\n    if (state === null) {\n      throw new Error(\"Cannot export recovery code before the rally is initialized.\");\n    }\n\n    return exportProgressToken({\n      version: 1,\n      rallyId: state.rallyId,\n      stamps: state.records,\n      rewards: state.rewards ?? [],\n      exportedAt: new Date().toISOString(),\n    });\n  }, [client]);\n\n  const importRecoveryCode = useCallback(\n    (token: string): Promise<boolean> => {\n      setClientError(null);\n      setIsOperationPending(true);\n\n      return new Promise((resolve, reject) => {\n        void (async () => {\n          const config = client.getConfig();\n          const snapshot = importProgressToken(token, config.id);\n          if (snapshot === null) {\n            setIsOperationPending(false);\n            resolve(false);\n            return;\n          }\n\n          const stampIds = new Set(config.stamps.map((stamp) => stamp.id));\n          const rewardIds = new Set((config.rewards ?? []).map((reward) => reward.id));\n          const importedStampIds = new Set<string>();\n          const importedRewardIds = new Set<string>();\n          const stamps = snapshot.stamps.filter((record) => {\n            if (!stampIds.has(record.stampId) || importedStampIds.has(record.stampId)) return false;\n            importedStampIds.add(record.stampId);\n            return true;\n          });\n          const rewards = snapshot.rewards.filter((state) => {\n            if (!rewardIds.has(state.rewardId) || importedRewardIds.has(state.rewardId))\n              return false;\n            importedRewardIds.add(state.rewardId);\n            return true;\n          });\n\n          try {\n            await client.restore({\n              rallyId: config.id,\n              records: stamps,\n              ...(config.rewards === undefined && rewards.length === 0 ? {} : { rewards }),\n              updatedAt: snapshot.exportedAt,\n            });\n            setIsOperationPending(false);\n            resolve(true);\n          } catch (importError) {\n            const normalizedError = toError(importError);\n            setClientError({ client, value: normalizedError });\n            setIsOperationPending(false);\n            reject(normalizedError);\n          }\n        })();\n      });\n    },\n    [client],\n  );\n\n  const isLoading =\n    rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);\n  const error = clientError?.client === client ? clientError.value : null;\n\n  const flushQueue = useCallback(async (): Promise<void> => {\n    if (!isOnline(syncAdapter) || isFlushingQueue.current) return;\n    isFlushingQueue.current = true;\n    setIsOperationPending(true);\n    try {\n      for (const request of offlineQueue) {\n        if (!isOnline(syncAdapter)) break;\n        const metadata = queuedMetadata.current.get(request.idempotencyKey);\n        const previousState = metadata?.previousState ?? client.getState();\n        try {\n          const before = await syncAdapter?.onBeforeCheckIn?.(request);\n          if (before === false) {\n            if (metadata !== undefined && previousState !== null)\n              await client.restore(previousState);\n            setClientError({ client, value: { code: \"INVALID_PROOF\", stampId: request.stampId } });\n            queuedMetadata.current.delete(request.idempotencyKey);\n            setOfflineQueue((current) =>\n              current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n            );\n            continue;\n          }\n\n          let result = metadata?.result;\n          if (result === undefined) {\n            const localResult = await client.acquire(request.stampId, request.context, request.now);\n            if (!localResult.ok) {\n              setClientError({ client, value: localResult.error });\n              queuedMetadata.current.delete(request.idempotencyKey);\n              setOfflineQueue((current) =>\n                current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n              );\n              continue;\n            }\n            result = localResult.value;\n            queuedMetadata.current.set(request.idempotencyKey, {\n              previousState,\n              result,\n            });\n          }\n\n          const verified = await syncAdapter?.onServerVerify?.(request);\n          if (isRejectedVerification(verified)) {\n            if (previousState !== null) await client.restore(previousState);\n            setClientError({\n              client,\n              value: { code: \"INVALID_PROOF\", stampId: request.stampId },\n            });\n          } else {\n            notifyAcquisitionEvents(\n              result,\n              events,\n              options.onStampClaimed,\n              options.onRewardUnlocked,\n            );\n          }\n          queuedMetadata.current.delete(request.idempotencyKey);\n          setOfflineQueue((current) =>\n            current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n          );\n        } catch (flushError) {\n          if (isNetworkFailure(flushError)) {\n            setClientError({ client, value: toError(flushError) });\n            break;\n          }\n          setClientError({ client, value: toError(flushError) });\n          queuedMetadata.current.delete(request.idempotencyKey);\n          setOfflineQueue((current) =>\n            current.filter((item) => item.idempotencyKey !== request.idempotencyKey),\n          );\n        }\n      }\n    } finally {\n      isFlushingQueue.current = false;\n      setIsOperationPending(false);\n    }\n  }, [client, events, offlineQueue, options.onRewardUnlocked, options.onStampClaimed, syncAdapter]);\n\n  useEffect(() => {\n    if (typeof window === \"undefined\") return;\n    const handleOnline = (): void => {\n      void flushQueue();\n    };\n    window.addEventListener(\"online\", handleOnline);\n    return () => window.removeEventListener(\"online\", handleOnline);\n  }, [flushQueue]);\n\n  return {\n    state: optimisticState,\n    isLoading,\n    isPending: isPending || isOperationPending,\n    error,\n    rewardsState: optimisticState?.rewards ?? [],\n    acquire,\n    reset,\n    redeem,\n    exportRecoveryCode,\n    importRecoveryCode,\n    offlineQueue,\n    queuedCount: offlineQueue.length,\n    flushQueue,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stamprally/react",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "React hooks for @stamprally/core.",
   "license": "MIT",
   "repository": {
@@ -31,7 +31,7 @@
     }
   },
   "dependencies": {
-    "@stamprally/core": "0.3.0"
+    "@stamprally/core": "0.4.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",