@stamprally/react 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,103 @@
+# @stamprally/react
+
+React 19 integration for [`@stamprally/core`](https://www.npmjs.com/package/@stamprally/core).
+The package provides the `useStampRally` hook with external-store updates,
+optimistic stamp acquisition, persistence, reward redemption, and recovery-code
+support.
+
+## Install
+
+```sh
+npm install @stamprally/core @stamprally/react react
+```
+
+Or with pnpm:
+
+```sh
+pnpm add @stamprally/core @stamprally/react react
+```
+
+This package supports React `>=19.0.0 <20.0.0`.
+
+## Quick start
+
+```tsx
+import { useMemo } from "react";
+import {
+  LocalStorageAdapter,
+  StampRallyClient,
+  type RallyConfig,
+} from "@stamprally/core";
+import { useStampRally } from "@stamprally/react";
+
+const config: RallyConfig = {
+  id: "city-tour",
+  stamps: [
+    {
+      id: "station",
+      name: "Central Station",
+      condition: { type: "instant" },
+    },
+  ],
+};
+
+export function Rally() {
+  const client = useMemo(
+    () => new StampRallyClient(config, new LocalStorageAdapter()),
+    [],
+  );
+  const { state, isLoading, isPending, error, acquire } = useStampRally(client);
+
+  if (isLoading) return <p>Loading…</p>;
+
+  return (
+    <section>
+      <p>
+        {state?.records.length ?? 0} stamp(s) collected
+      </p>
+      <button
+        disabled={isPending}
+        onClick={() => void acquire("station", { type: "instant" })}
+      >
+        Collect stamp
+      </button>
+      {error !== null && <p role="alert">Could not collect the stamp.</p>}
+    </section>
+  );
+}
+```
+
+The hook initializes the client when needed, subscribes to state changes, and
+keeps the UI synchronized with persisted state. Keep the `StampRallyClient`
+instance stable, for example with `useMemo`, so that the hook does not switch
+clients on every render.
+
+## Hook return value
+
+`useStampRally(client)` returns:
+
+- `state`: the current `StampRallyState`, or `null` while it is not initialized.
+- `isLoading`: whether the client is initializing or changing clients.
+- `isPending`: whether an acquisition, reset, redemption, or import is pending.
+- `error`: the latest typed engine/reward error or storage error.
+- `rewardsState`: the current reward states, or an empty array when rewards are not configured.
+- `acquire(stampId, context, now?)`: validates and persists a stamp acquisition.
+- `reset(now?)`: clears the persisted rally state.
+- `redeem(rewardId, options?)`: redeems an available reward, optionally with a staff passcode and ID.
+- `exportRecoveryCode()`: exports confirmed stamp and reward progress.
+- `importRecoveryCode(token)`: restores a rally-scoped recovery code and returns whether it was valid.
+
+Acquisitions are shown optimistically while persistence is pending. Engine
+validation and storage failures roll the optimistic state back and are exposed
+through the returned `error` value and the rejected promise where applicable.
+
+## Browser and server rendering
+
+The hook uses React's external-store API and provides a `null` server snapshot.
+The core package's browser adapters and detectors access browser globals only
+when called, so applications can choose a different `StampStorage` for server
+rendering, tests, or non-browser environments.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -20,7 +20,26 @@ function applyOptimisticAcquire(currentState, action) {
     updatedAt: action.acquiredAt
   };
 }
-function useStampRally(client) {
+function createIdempotencyKey() {
+  const cryptoApi = globalThis.crypto;
+  if (cryptoApi !== void 0 && typeof cryptoApi.randomUUID === "function") {
+    return cryptoApi.randomUUID();
+  }
+  return `stamp-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+function isOnline(adapter) {
+  if (adapter?.isOnline === void 0) {
+    return typeof navigator === "undefined" || navigator.onLine !== false;
+  }
+  return typeof adapter.isOnline === "function" ? adapter.isOnline() : adapter.isOnline;
+}
+function isRejectedVerification(value) {
+  return value === false || typeof value === "object" && value !== null && "ok" in value && value.ok === false;
+}
+function useStampRally(client, options = {}) {
+  const syncAdapter = options.syncAdapter;
+  const events = options.events;
+  const queuedRequests = react.useRef([]);
   const subscribe = react.useCallback(
     (onStoreChange) => client.subscribe(() => onStoreChange()),
     [client]
@@ -32,8 +51,16 @@ function useStampRally(client) {
     isInitializing: client.getState() === null
   }));
   const [clientError, setClientError] = react.useState(null);
-  const [isPending, startTransition] = react.useTransition();
-  const [optimisticState, addOptimisticAcquire] = react.useOptimistic(rawState, applyOptimisticAcquire);
+  const [isPending] = react.useTransition();
+  const [isOperationPending, setIsOperationPending] = react.useState(false);
+  const [optimisticState, setOptimisticState] = react.useState(rawState);
+  react.useEffect(() => {
+    setOptimisticState(rawState);
+  }, [rawState]);
+  react.useEffect(() => {
+    if (syncAdapter?.onStateChange === void 0) return;
+    return client.subscribe(syncAdapter.onStateChange);
+  }, [client, syncAdapter]);
   react.useEffect(() => {
     let active = true;
     setClientError(null);
@@ -58,51 +85,109 @@ function useStampRally(client) {
     };
   }, [client, rawState]);
   const acquire = react.useCallback(
-    (stampId, context, now) => {
+    (stampId, context, now, idempotencyKey) => {
       const acquiredAt = now ?? (/* @__PURE__ */ new Date()).toISOString();
+      const request = {
+        stampId,
+        context,
+        now: acquiredAt,
+        idempotencyKey: idempotencyKey ?? createIdempotencyKey()
+      };
       setClientError(null);
+      if (!isOnline(syncAdapter)) {
+        queuedRequests.current = [...queuedRequests.current, request];
+        const queued = {
+          ok: false,
+          error: { code: "OFFLINE_QUEUED", stampId, idempotencyKey: request.idempotencyKey }
+        };
+        setClientError({ client, value: queued.error });
+        return Promise.resolve(queued);
+      }
+      setIsOperationPending(true);
+      setOptimisticState((current) => applyOptimisticAcquire(current, { stampId, acquiredAt }));
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
-          addOptimisticAcquire({ stampId, acquiredAt });
+        void (async () => {
           try {
+            const before = await syncAdapter?.onBeforeCheckIn?.(request);
+            if (before === false) {
+              const rejected = {
+                ok: false,
+                error: { code: "INVALID_PROOF", stampId }
+              };
+              setClientError({ client, value: rejected.error });
+              setIsOperationPending(false);
+              resolve(rejected);
+              return;
+            }
             const result = await client.acquire(stampId, context, acquiredAt);
+            if (result.ok) {
+              const verified = await syncAdapter?.onServerVerify?.(request);
+              if (isRejectedVerification(verified)) {
+                await client.restore(rawState ?? client.getState() ?? result.value.nextState);
+                const rejected = {
+                  ok: false,
+                  error: { code: "INVALID_PROOF", stampId }
+                };
+                setClientError({ client, value: rejected.error });
+                setOptimisticState(client.getState());
+                setIsOperationPending(false);
+                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);
+                }
+              }
+            }
             if (!result.ok) {
               setClientError({ client, value: result.error });
+              setOptimisticState(client.getState());
             }
+            setIsOperationPending(false);
             resolve(result);
           } catch (acquireError) {
             const normalizedError = toError(acquireError);
             setClientError({ client, value: normalizedError });
+            setOptimisticState(client.getState());
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
-    [addOptimisticAcquire, client]
+    [client, events, options.onRewardUnlocked, options.onStampClaimed, rawState, syncAdapter]
   );
   const reset = react.useCallback(
     (now) => {
       setClientError(null);
+      setIsOperationPending(true);
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
+        void (async () => {
           try {
             const nextState = now === void 0 ? await client.reset() : await client.reset(now);
+            setIsOperationPending(false);
             resolve(nextState);
           } catch (resetError) {
             const normalizedError = toError(resetError);
             setClientError({ client, value: normalizedError });
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
     [client]
   );
   const redeem = react.useCallback(
-    (rewardId, options = {}) => {
+    (rewardId, redeemOptions = {}) => {
       setClientError(null);
+      setIsOperationPending(true);
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
+        void (async () => {
           const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);
           if (reward === void 0) {
             const result2 = {
@@ -110,6 +195,7 @@ function useStampRally(client) {
               error: { code: "REWARD_NOT_FOUND", rewardId }
             };
             setClientError({ client, value: result2.error });
+            setIsOperationPending(false);
             resolve(result2);
             return;
           }
@@ -123,6 +209,7 @@ function useStampRally(client) {
               error: { code: "NOT_AVAILABLE", rewardId }
             };
             setClientError({ client, value: result2.error });
+            setIsOperationPending(false);
             resolve(result2);
             return;
           }
@@ -130,15 +217,17 @@ function useStampRally(client) {
             reward,
             currentState: currentRewardState,
             now: (/* @__PURE__ */ new Date()).toISOString(),
-            ...options.passcode === void 0 ? {} : { inputPasscode: options.passcode },
-            ...options.staffId === void 0 ? {} : { staffId: options.staffId }
+            ...redeemOptions.passcode === void 0 ? {} : { inputPasscode: redeemOptions.passcode },
+            ...redeemOptions.staffId === void 0 ? {} : { staffId: redeemOptions.staffId }
           });
           if (!result.ok) {
             setClientError({ client, value: result.error });
+            setIsOperationPending(false);
             resolve(result);
             return;
           }
           if (result.value === currentRewardState) {
+            setIsOperationPending(false);
             resolve(result);
             return;
           }
@@ -151,16 +240,19 @@ function useStampRally(client) {
           };
           try {
             await client.restore(nextState);
+            (events?.onRewardConsumed ?? options.onRewardConsumed)?.(rewardId);
+            setIsOperationPending(false);
             resolve(result);
           } catch (redeemError) {
             const normalizedError = toError(redeemError);
             setClientError({ client, value: normalizedError });
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
-    [client]
+    [client, events, options.onRewardConsumed]
   );
   const exportRecoveryCode = react.useCallback(() => {
     const state = client.getState();
@@ -178,11 +270,13 @@ function useStampRally(client) {
   const importRecoveryCode = react.useCallback(
     (token) => {
       setClientError(null);
+      setIsOperationPending(true);
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
+        void (async () => {
           const config = client.getConfig();
           const snapshot = core.importProgressToken(token, config.id);
           if (snapshot === null) {
+            setIsOperationPending(false);
             resolve(false);
             return;
           }
@@ -208,30 +302,42 @@ function useStampRally(client) {
               ...config.rewards === void 0 && rewards.length === 0 ? {} : { rewards },
               updatedAt: snapshot.exportedAt
             });
+            setIsOperationPending(false);
             resolve(true);
           } catch (importError) {
             const normalizedError = toError(importError);
             setClientError({ client, value: normalizedError });
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
     [client]
   );
   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);
+    }
+  }, [acquire, syncAdapter]);
   return {
     state: optimisticState,
     isLoading,
-    isPending,
+    isPending: isPending || isOperationPending,
     error,
     rewardsState: optimisticState?.rewards ?? [],
     acquire,
     reset,
     redeem,
     exportRecoveryCode,
-    importRecoveryCode
+    importRecoveryCode,
+    queuedCount: queuedRequests.current.length,
+    flushQueue
   };
 }
 

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useStampRally.ts"],"names":["useCallback","useSyncExternalStore","useState","useTransition","useOptimistic","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  useOptimistic,\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 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  ) => 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}\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\nexport function useStampRally(client: StampRallyClient): UseStampRallyReturn {\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, startTransition] = useTransition();\n  const [optimisticState, addOptimisticAcquire] = useOptimistic(rawState, applyOptimisticAcquire);\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    ): Promise<Result<ProcessStampValue, StampError>> => {\n      const acquiredAt = now ?? new Date().toISOString();\n      setClientError(null);\n\n      return new Promise((resolve, reject) => {\n        startTransition(async () => {\n          addOptimisticAcquire({ stampId, acquiredAt });\n          try {\n            const result = await client.acquire(stampId, context, acquiredAt);\n            if (!result.ok) {\n              setClientError({ client, value: result.error });\n            }\n            resolve(result);\n          } catch (acquireError) {\n            const normalizedError = toError(acquireError);\n            setClientError({ client, value: normalizedError });\n            reject(normalizedError);\n          }\n        });\n      });\n    },\n    [addOptimisticAcquire, client],\n  );\n\n  const reset = useCallback(\n    (now?: string): Promise<StampRallyState> => {\n      setClientError(null);\n\n      return new Promise((resolve, reject) => {\n        startTransition(async () => {\n          try {\n            const nextState = now === undefined ? await client.reset() : await client.reset(now);\n            resolve(nextState);\n          } catch (resetError) {\n            const normalizedError = toError(resetError);\n            setClientError({ client, value: normalizedError });\n            reject(normalizedError);\n          }\n        });\n      });\n    },\n    [client],\n  );\n\n  const redeem = useCallback(\n    (rewardId: string, options: RedeemOptions = {}): Promise<ConsumeResult> => {\n      setClientError(null);\n\n      return new Promise((resolve, reject) => {\n        startTransition(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            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            resolve(result);\n            return;\n          }\n\n          const result = consumeReward({\n            reward,\n            currentState: currentRewardState,\n            now: new Date().toISOString(),\n            ...(options.passcode === undefined ? {} : { inputPasscode: options.passcode }),\n            ...(options.staffId === undefined ? {} : { staffId: options.staffId }),\n          });\n          if (!result.ok) {\n            setClientError({ client, value: result.error });\n            resolve(result);\n            return;\n          }\n\n          if (result.value === currentRewardState) {\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            resolve(result);\n          } catch (redeemError) {\n            const normalizedError = toError(redeemError);\n            setClientError({ client, value: normalizedError });\n            reject(normalizedError);\n          }\n        });\n      });\n    },\n    [client],\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\n      return new Promise((resolve, reject) => {\n        startTransition(async () => {\n          const config = client.getConfig();\n          const snapshot = importProgressToken(token, config.id);\n          if (snapshot === null) {\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            resolve(true);\n          } catch (importError) {\n            const normalizedError = toError(importError);\n            setClientError({ client, value: normalizedError });\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  return {\n    state: optimisticState,\n    isLoading,\n    isPending,\n    error,\n    rewardsState: optimisticState?.rewards ?? [],\n    acquire,\n    reset,\n    redeem,\n    exportRecoveryCode,\n    importRecoveryCode,\n  };\n}\n"]}
+{"version":3,"sources":["../src/useStampRally.ts"],"names":["useRef","useCallback","useSyncExternalStore","useState","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\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"]}

package/dist/index.d.cts

@@ -1,5 +1,29 @@
-import { StampRallyState, StampError, RewardConsumeError, RewardState, VerificationContext, Result, ProcessStampValue, ConsumeResult, StampRallyClient } from '@stamprally/core';
+import { VerificationContext, StampRallyState, StampError, RewardConsumeError, RewardState, Result, ProcessStampValue, ConsumeResult, StampRallyClient } from '@stamprally/core';
 
+interface CheckInRequest {
+    readonly stampId: string;
+    readonly context: VerificationContext;
+    readonly now: string;
+    readonly idempotencyKey: string;
+}
+interface SyncAdapter {
+    readonly isOnline?: boolean | (() => boolean);
+    readonly onBeforeCheckIn?: (request: CheckInRequest) => unknown;
+    readonly onServerVerify?: (request: CheckInRequest) => unknown;
+    readonly onStateChange?: (state: StampRallyState) => void;
+}
+interface StampRallyEventHandlers {
+    readonly onStampClaimed?: (record: StampRallyState["records"][number]) => void;
+    readonly onRewardUnlocked?: (rewardId: string) => void;
+    readonly onRewardConsumed?: (rewardId: string) => void;
+}
+interface UseStampRallyOptions {
+    readonly syncAdapter?: SyncAdapter;
+    readonly events?: StampRallyEventHandlers;
+    readonly onStampClaimed?: StampRallyEventHandlers["onStampClaimed"];
+    readonly onRewardUnlocked?: StampRallyEventHandlers["onRewardUnlocked"];
+    readonly onRewardConsumed?: StampRallyEventHandlers["onRewardConsumed"];
+}
 interface RedeemOptions {
     readonly passcode?: string;
     readonly staffId?: string;
@@ -10,14 +34,16 @@ interface UseStampRallyReturn {
     readonly isPending: boolean;
     readonly error: StampError | RewardConsumeError | Error | null;
     readonly rewardsState: ReadonlyArray<RewardState>;
-    readonly acquire: (stampId: string, context: VerificationContext, now?: string) => Promise<Result<ProcessStampValue, StampError>>;
+    readonly acquire: (stampId: string, context: VerificationContext, now?: string, idempotencyKey?: string) => Promise<Result<ProcessStampValue, StampError>>;
     readonly reset: (now?: string) => Promise<StampRallyState>;
     readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;
     readonly exportRecoveryCode: () => string;
     readonly importRecoveryCode: (token: string) => Promise<boolean>;
+    readonly queuedCount: number;
+    readonly flushQueue: () => Promise<void>;
 }
 /** @deprecated Use UseStampRallyReturn instead. */
 type UseStampRallyValue = UseStampRallyReturn;
-declare function useStampRally(client: StampRallyClient): UseStampRallyReturn;
+declare function useStampRally(client: StampRallyClient, options?: UseStampRallyOptions): UseStampRallyReturn;
 
-export { type RedeemOptions, type UseStampRallyReturn, type UseStampRallyValue, useStampRally };
+export { type CheckInRequest, type RedeemOptions, type StampRallyEventHandlers, type SyncAdapter, type UseStampRallyOptions, type UseStampRallyReturn, type UseStampRallyValue, useStampRally };

package/dist/index.d.ts

@@ -1,5 +1,29 @@
-import { StampRallyState, StampError, RewardConsumeError, RewardState, VerificationContext, Result, ProcessStampValue, ConsumeResult, StampRallyClient } from '@stamprally/core';
+import { VerificationContext, StampRallyState, StampError, RewardConsumeError, RewardState, Result, ProcessStampValue, ConsumeResult, StampRallyClient } from '@stamprally/core';
 
+interface CheckInRequest {
+    readonly stampId: string;
+    readonly context: VerificationContext;
+    readonly now: string;
+    readonly idempotencyKey: string;
+}
+interface SyncAdapter {
+    readonly isOnline?: boolean | (() => boolean);
+    readonly onBeforeCheckIn?: (request: CheckInRequest) => unknown;
+    readonly onServerVerify?: (request: CheckInRequest) => unknown;
+    readonly onStateChange?: (state: StampRallyState) => void;
+}
+interface StampRallyEventHandlers {
+    readonly onStampClaimed?: (record: StampRallyState["records"][number]) => void;
+    readonly onRewardUnlocked?: (rewardId: string) => void;
+    readonly onRewardConsumed?: (rewardId: string) => void;
+}
+interface UseStampRallyOptions {
+    readonly syncAdapter?: SyncAdapter;
+    readonly events?: StampRallyEventHandlers;
+    readonly onStampClaimed?: StampRallyEventHandlers["onStampClaimed"];
+    readonly onRewardUnlocked?: StampRallyEventHandlers["onRewardUnlocked"];
+    readonly onRewardConsumed?: StampRallyEventHandlers["onRewardConsumed"];
+}
 interface RedeemOptions {
     readonly passcode?: string;
     readonly staffId?: string;
@@ -10,14 +34,16 @@ interface UseStampRallyReturn {
     readonly isPending: boolean;
     readonly error: StampError | RewardConsumeError | Error | null;
     readonly rewardsState: ReadonlyArray<RewardState>;
-    readonly acquire: (stampId: string, context: VerificationContext, now?: string) => Promise<Result<ProcessStampValue, StampError>>;
+    readonly acquire: (stampId: string, context: VerificationContext, now?: string, idempotencyKey?: string) => Promise<Result<ProcessStampValue, StampError>>;
     readonly reset: (now?: string) => Promise<StampRallyState>;
     readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;
     readonly exportRecoveryCode: () => string;
     readonly importRecoveryCode: (token: string) => Promise<boolean>;
+    readonly queuedCount: number;
+    readonly flushQueue: () => Promise<void>;
 }
 /** @deprecated Use UseStampRallyReturn instead. */
 type UseStampRallyValue = UseStampRallyReturn;
-declare function useStampRally(client: StampRallyClient): UseStampRallyReturn;
+declare function useStampRally(client: StampRallyClient, options?: UseStampRallyOptions): UseStampRallyReturn;
 
-export { type RedeemOptions, type UseStampRallyReturn, type UseStampRallyValue, useStampRally };
+export { type CheckInRequest, type RedeemOptions, type StampRallyEventHandlers, type SyncAdapter, type UseStampRallyOptions, type UseStampRallyReturn, type UseStampRallyValue, useStampRally };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { consumeReward, exportProgressToken, importProgressToken } from '@stamprally/core';
-import { useCallback, useSyncExternalStore, useState, useTransition, useOptimistic, useEffect } from 'react';
+import { useRef, useCallback, useSyncExternalStore, useState, useTransition, useEffect } from 'react';
 
 // src/useStampRally.ts
 function getServerSnapshot() {
@@ -18,7 +18,26 @@ function applyOptimisticAcquire(currentState, action) {
     updatedAt: action.acquiredAt
   };
 }
-function useStampRally(client) {
+function createIdempotencyKey() {
+  const cryptoApi = globalThis.crypto;
+  if (cryptoApi !== void 0 && typeof cryptoApi.randomUUID === "function") {
+    return cryptoApi.randomUUID();
+  }
+  return `stamp-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+function isOnline(adapter) {
+  if (adapter?.isOnline === void 0) {
+    return typeof navigator === "undefined" || navigator.onLine !== false;
+  }
+  return typeof adapter.isOnline === "function" ? adapter.isOnline() : adapter.isOnline;
+}
+function isRejectedVerification(value) {
+  return value === false || typeof value === "object" && value !== null && "ok" in value && value.ok === false;
+}
+function useStampRally(client, options = {}) {
+  const syncAdapter = options.syncAdapter;
+  const events = options.events;
+  const queuedRequests = useRef([]);
   const subscribe = useCallback(
     (onStoreChange) => client.subscribe(() => onStoreChange()),
     [client]
@@ -30,8 +49,16 @@ function useStampRally(client) {
     isInitializing: client.getState() === null
   }));
   const [clientError, setClientError] = useState(null);
-  const [isPending, startTransition] = useTransition();
-  const [optimisticState, addOptimisticAcquire] = useOptimistic(rawState, applyOptimisticAcquire);
+  const [isPending] = useTransition();
+  const [isOperationPending, setIsOperationPending] = useState(false);
+  const [optimisticState, setOptimisticState] = useState(rawState);
+  useEffect(() => {
+    setOptimisticState(rawState);
+  }, [rawState]);
+  useEffect(() => {
+    if (syncAdapter?.onStateChange === void 0) return;
+    return client.subscribe(syncAdapter.onStateChange);
+  }, [client, syncAdapter]);
   useEffect(() => {
     let active = true;
     setClientError(null);
@@ -56,51 +83,109 @@ function useStampRally(client) {
     };
   }, [client, rawState]);
   const acquire = useCallback(
-    (stampId, context, now) => {
+    (stampId, context, now, idempotencyKey) => {
       const acquiredAt = now ?? (/* @__PURE__ */ new Date()).toISOString();
+      const request = {
+        stampId,
+        context,
+        now: acquiredAt,
+        idempotencyKey: idempotencyKey ?? createIdempotencyKey()
+      };
       setClientError(null);
+      if (!isOnline(syncAdapter)) {
+        queuedRequests.current = [...queuedRequests.current, request];
+        const queued = {
+          ok: false,
+          error: { code: "OFFLINE_QUEUED", stampId, idempotencyKey: request.idempotencyKey }
+        };
+        setClientError({ client, value: queued.error });
+        return Promise.resolve(queued);
+      }
+      setIsOperationPending(true);
+      setOptimisticState((current) => applyOptimisticAcquire(current, { stampId, acquiredAt }));
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
-          addOptimisticAcquire({ stampId, acquiredAt });
+        void (async () => {
           try {
+            const before = await syncAdapter?.onBeforeCheckIn?.(request);
+            if (before === false) {
+              const rejected = {
+                ok: false,
+                error: { code: "INVALID_PROOF", stampId }
+              };
+              setClientError({ client, value: rejected.error });
+              setIsOperationPending(false);
+              resolve(rejected);
+              return;
+            }
             const result = await client.acquire(stampId, context, acquiredAt);
+            if (result.ok) {
+              const verified = await syncAdapter?.onServerVerify?.(request);
+              if (isRejectedVerification(verified)) {
+                await client.restore(rawState ?? client.getState() ?? result.value.nextState);
+                const rejected = {
+                  ok: false,
+                  error: { code: "INVALID_PROOF", stampId }
+                };
+                setClientError({ client, value: rejected.error });
+                setOptimisticState(client.getState());
+                setIsOperationPending(false);
+                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);
+                }
+              }
+            }
             if (!result.ok) {
               setClientError({ client, value: result.error });
+              setOptimisticState(client.getState());
             }
+            setIsOperationPending(false);
             resolve(result);
           } catch (acquireError) {
             const normalizedError = toError(acquireError);
             setClientError({ client, value: normalizedError });
+            setOptimisticState(client.getState());
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
-    [addOptimisticAcquire, client]
+    [client, events, options.onRewardUnlocked, options.onStampClaimed, rawState, syncAdapter]
   );
   const reset = useCallback(
     (now) => {
       setClientError(null);
+      setIsOperationPending(true);
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
+        void (async () => {
           try {
             const nextState = now === void 0 ? await client.reset() : await client.reset(now);
+            setIsOperationPending(false);
             resolve(nextState);
           } catch (resetError) {
             const normalizedError = toError(resetError);
             setClientError({ client, value: normalizedError });
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
     [client]
   );
   const redeem = useCallback(
-    (rewardId, options = {}) => {
+    (rewardId, redeemOptions = {}) => {
       setClientError(null);
+      setIsOperationPending(true);
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
+        void (async () => {
           const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);
           if (reward === void 0) {
             const result2 = {
@@ -108,6 +193,7 @@ function useStampRally(client) {
               error: { code: "REWARD_NOT_FOUND", rewardId }
             };
             setClientError({ client, value: result2.error });
+            setIsOperationPending(false);
             resolve(result2);
             return;
           }
@@ -121,6 +207,7 @@ function useStampRally(client) {
               error: { code: "NOT_AVAILABLE", rewardId }
             };
             setClientError({ client, value: result2.error });
+            setIsOperationPending(false);
             resolve(result2);
             return;
           }
@@ -128,15 +215,17 @@ function useStampRally(client) {
             reward,
             currentState: currentRewardState,
             now: (/* @__PURE__ */ new Date()).toISOString(),
-            ...options.passcode === void 0 ? {} : { inputPasscode: options.passcode },
-            ...options.staffId === void 0 ? {} : { staffId: options.staffId }
+            ...redeemOptions.passcode === void 0 ? {} : { inputPasscode: redeemOptions.passcode },
+            ...redeemOptions.staffId === void 0 ? {} : { staffId: redeemOptions.staffId }
           });
           if (!result.ok) {
             setClientError({ client, value: result.error });
+            setIsOperationPending(false);
             resolve(result);
             return;
           }
           if (result.value === currentRewardState) {
+            setIsOperationPending(false);
             resolve(result);
             return;
           }
@@ -149,16 +238,19 @@ function useStampRally(client) {
           };
           try {
             await client.restore(nextState);
+            (events?.onRewardConsumed ?? options.onRewardConsumed)?.(rewardId);
+            setIsOperationPending(false);
             resolve(result);
           } catch (redeemError) {
             const normalizedError = toError(redeemError);
             setClientError({ client, value: normalizedError });
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
-    [client]
+    [client, events, options.onRewardConsumed]
   );
   const exportRecoveryCode = useCallback(() => {
     const state = client.getState();
@@ -176,11 +268,13 @@ function useStampRally(client) {
   const importRecoveryCode = useCallback(
     (token) => {
       setClientError(null);
+      setIsOperationPending(true);
       return new Promise((resolve, reject) => {
-        startTransition(async () => {
+        void (async () => {
           const config = client.getConfig();
           const snapshot = importProgressToken(token, config.id);
           if (snapshot === null) {
+            setIsOperationPending(false);
             resolve(false);
             return;
           }
@@ -206,30 +300,42 @@ function useStampRally(client) {
               ...config.rewards === void 0 && rewards.length === 0 ? {} : { rewards },
               updatedAt: snapshot.exportedAt
             });
+            setIsOperationPending(false);
             resolve(true);
           } catch (importError) {
             const normalizedError = toError(importError);
             setClientError({ client, value: normalizedError });
+            setIsOperationPending(false);
             reject(normalizedError);
           }
-        });
+        })();
       });
     },
     [client]
   );
   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);
+    }
+  }, [acquire, syncAdapter]);
   return {
     state: optimisticState,
     isLoading,
-    isPending,
+    isPending: isPending || isOperationPending,
     error,
     rewardsState: optimisticState?.rewards ?? [],
     acquire,
     reset,
     redeem,
     exportRecoveryCode,
-    importRecoveryCode
+    importRecoveryCode,
+    queuedCount: queuedRequests.current.length,
+    flushQueue
   };
 }
 

package/dist/index.js.map

@@ -1 +1 @@
-{"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  useOptimistic,\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 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  ) => 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}\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\nexport function useStampRally(client: StampRallyClient): UseStampRallyReturn {\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, startTransition] = useTransition();\n  const [optimisticState, addOptimisticAcquire] = useOptimistic(rawState, applyOptimisticAcquire);\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    ): Promise<Result<ProcessStampValue, StampError>> => {\n      const acquiredAt = now ?? new Date().toISOString();\n      setClientError(null);\n\n      return new Promise((resolve, reject) => {\n        startTransition(async () => {\n          addOptimisticAcquire({ stampId, acquiredAt });\n          try {\n            const result = await client.acquire(stampId, context, acquiredAt);\n            if (!result.ok) {\n              setClientError({ client, value: result.error });\n            }\n            resolve(result);\n          } catch (acquireError) {\n            const normalizedError = toError(acquireError);\n            setClientError({ client, value: normalizedError });\n            reject(normalizedError);\n          }\n        });\n      });\n    },\n    [addOptimisticAcquire, client],\n  );\n\n  const reset = useCallback(\n    (now?: string): Promise<StampRallyState> => {\n      setClientError(null);\n\n      return new Promise((resolve, reject) => {\n        startTransition(async () => {\n          try {\n            const nextState = now === undefined ? await client.reset() : await client.reset(now);\n            resolve(nextState);\n          } catch (resetError) {\n            const normalizedError = toError(resetError);\n            setClientError({ client, value: normalizedError });\n            reject(normalizedError);\n          }\n        });\n      });\n    },\n    [client],\n  );\n\n  const redeem = useCallback(\n    (rewardId: string, options: RedeemOptions = {}): Promise<ConsumeResult> => {\n      setClientError(null);\n\n      return new Promise((resolve, reject) => {\n        startTransition(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            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            resolve(result);\n            return;\n          }\n\n          const result = consumeReward({\n            reward,\n            currentState: currentRewardState,\n            now: new Date().toISOString(),\n            ...(options.passcode === undefined ? {} : { inputPasscode: options.passcode }),\n            ...(options.staffId === undefined ? {} : { staffId: options.staffId }),\n          });\n          if (!result.ok) {\n            setClientError({ client, value: result.error });\n            resolve(result);\n            return;\n          }\n\n          if (result.value === currentRewardState) {\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            resolve(result);\n          } catch (redeemError) {\n            const normalizedError = toError(redeemError);\n            setClientError({ client, value: normalizedError });\n            reject(normalizedError);\n          }\n        });\n      });\n    },\n    [client],\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\n      return new Promise((resolve, reject) => {\n        startTransition(async () => {\n          const config = client.getConfig();\n          const snapshot = importProgressToken(token, config.id);\n          if (snapshot === null) {\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            resolve(true);\n          } catch (importError) {\n            const normalizedError = toError(importError);\n            setClientError({ client, value: normalizedError });\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  return {\n    state: optimisticState,\n    isLoading,\n    isPending,\n    error,\n    rewardsState: optimisticState?.rewards ?? [],\n    acquire,\n    reset,\n    redeem,\n    exportRecoveryCode,\n    importRecoveryCode,\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\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stamprally/react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "React hooks for @stamprally/core.",
   "license": "MIT",
   "repository": {
@@ -31,10 +31,11 @@
     }
   },
   "dependencies": {
-    "@stamprally/core": "0.1.0"
+    "@stamprally/core": "0.2.0"
   },
   "peerDependencies": {
-    "react": ">=19.0.0 <20.0.0"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",