@stamprally/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nitta-a
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,240 @@
+'use strict';
+
+var core = require('@stamprally/core');
+var react = require('react');
+
+// src/useStampRally.ts
+function getServerSnapshot() {
+  return null;
+}
+function toError(error) {
+  return error instanceof Error ? error : new Error(String(error));
+}
+function applyOptimisticAcquire(currentState, action) {
+  if (currentState === null || currentState.records.some((record) => record.stampId === action.stampId)) {
+    return currentState;
+  }
+  return {
+    ...currentState,
+    records: [...currentState.records, { stampId: action.stampId, acquiredAt: action.acquiredAt }],
+    updatedAt: action.acquiredAt
+  };
+}
+function useStampRally(client) {
+  const subscribe = react.useCallback(
+    (onStoreChange) => client.subscribe(() => onStoreChange()),
+    [client]
+  );
+  const getSnapshot = react.useCallback(() => client.getState(), [client]);
+  const rawState = react.useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+  const [clientStatus, setClientStatus] = react.useState(() => ({
+    client,
+    isInitializing: client.getState() === null
+  }));
+  const [clientError, setClientError] = react.useState(null);
+  const [isPending, startTransition] = react.useTransition();
+  const [optimisticState, addOptimisticAcquire] = react.useOptimistic(rawState, applyOptimisticAcquire);
+  react.useEffect(() => {
+    let active = true;
+    setClientError(null);
+    if (rawState !== null) {
+      setClientStatus({ client, isInitializing: false });
+      return () => {
+        active = false;
+      };
+    }
+    setClientStatus({ client, isInitializing: true });
+    void client.init().catch((initializationError) => {
+      if (active) {
+        setClientError({ client, value: toError(initializationError) });
+      }
+    }).finally(() => {
+      if (active) {
+        setClientStatus({ client, isInitializing: false });
+      }
+    });
+    return () => {
+      active = false;
+    };
+  }, [client, rawState]);
+  const acquire = react.useCallback(
+    (stampId, context, now) => {
+      const acquiredAt = now ?? (/* @__PURE__ */ new Date()).toISOString();
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          addOptimisticAcquire({ stampId, acquiredAt });
+          try {
+            const result = await client.acquire(stampId, context, acquiredAt);
+            if (!result.ok) {
+              setClientError({ client, value: result.error });
+            }
+            resolve(result);
+          } catch (acquireError) {
+            const normalizedError = toError(acquireError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [addOptimisticAcquire, client]
+  );
+  const reset = react.useCallback(
+    (now) => {
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          try {
+            const nextState = now === void 0 ? await client.reset() : await client.reset(now);
+            resolve(nextState);
+          } catch (resetError) {
+            const normalizedError = toError(resetError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [client]
+  );
+  const redeem = react.useCallback(
+    (rewardId, options = {}) => {
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);
+          if (reward === void 0) {
+            const result2 = {
+              ok: false,
+              error: { code: "REWARD_NOT_FOUND", rewardId }
+            };
+            setClientError({ client, value: result2.error });
+            resolve(result2);
+            return;
+          }
+          const currentState = client.getState();
+          const currentRewardState = currentState?.rewards?.find(
+            (state) => state.rewardId === rewardId
+          );
+          if (currentState === null || currentRewardState === void 0) {
+            const result2 = {
+              ok: false,
+              error: { code: "NOT_AVAILABLE", rewardId }
+            };
+            setClientError({ client, value: result2.error });
+            resolve(result2);
+            return;
+          }
+          const result = core.consumeReward({
+            reward,
+            currentState: currentRewardState,
+            now: (/* @__PURE__ */ new Date()).toISOString(),
+            ...options.passcode === void 0 ? {} : { inputPasscode: options.passcode },
+            ...options.staffId === void 0 ? {} : { staffId: options.staffId }
+          });
+          if (!result.ok) {
+            setClientError({ client, value: result.error });
+            resolve(result);
+            return;
+          }
+          if (result.value === currentRewardState) {
+            resolve(result);
+            return;
+          }
+          const nextState = {
+            ...currentState,
+            rewards: (currentState.rewards ?? []).map(
+              (state) => state.rewardId === rewardId ? result.value : state
+            ),
+            updatedAt: result.value.consumedAt ?? currentState.updatedAt
+          };
+          try {
+            await client.restore(nextState);
+            resolve(result);
+          } catch (redeemError) {
+            const normalizedError = toError(redeemError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [client]
+  );
+  const exportRecoveryCode = react.useCallback(() => {
+    const state = client.getState();
+    if (state === null) {
+      throw new Error("Cannot export recovery code before the rally is initialized.");
+    }
+    return core.exportProgressToken({
+      version: 1,
+      rallyId: state.rallyId,
+      stamps: state.records,
+      rewards: state.rewards ?? [],
+      exportedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }, [client]);
+  const importRecoveryCode = react.useCallback(
+    (token) => {
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          const config = client.getConfig();
+          const snapshot = core.importProgressToken(token, config.id);
+          if (snapshot === null) {
+            resolve(false);
+            return;
+          }
+          const stampIds = new Set(config.stamps.map((stamp) => stamp.id));
+          const rewardIds = new Set((config.rewards ?? []).map((reward) => reward.id));
+          const importedStampIds = /* @__PURE__ */ new Set();
+          const importedRewardIds = /* @__PURE__ */ new Set();
+          const stamps = snapshot.stamps.filter((record) => {
+            if (!stampIds.has(record.stampId) || importedStampIds.has(record.stampId)) return false;
+            importedStampIds.add(record.stampId);
+            return true;
+          });
+          const rewards = snapshot.rewards.filter((state) => {
+            if (!rewardIds.has(state.rewardId) || importedRewardIds.has(state.rewardId))
+              return false;
+            importedRewardIds.add(state.rewardId);
+            return true;
+          });
+          try {
+            await client.restore({
+              rallyId: config.id,
+              records: stamps,
+              ...config.rewards === void 0 && rewards.length === 0 ? {} : { rewards },
+              updatedAt: snapshot.exportedAt
+            });
+            resolve(true);
+          } catch (importError) {
+            const normalizedError = toError(importError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [client]
+  );
+  const isLoading = rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);
+  const error = clientError?.client === client ? clientError.value : null;
+  return {
+    state: optimisticState,
+    isLoading,
+    isPending,
+    error,
+    rewardsState: optimisticState?.rewards ?? [],
+    acquire,
+    reset,
+    redeem,
+    exportRecoveryCode,
+    importRecoveryCode
+  };
+}
+
+exports.useStampRally = useStampRally;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +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"]}

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import { StampRallyState, StampError, RewardConsumeError, RewardState, VerificationContext, Result, ProcessStampValue, ConsumeResult, StampRallyClient } from '@stamprally/core';
+
+interface RedeemOptions {
+    readonly passcode?: string;
+    readonly staffId?: string;
+}
+interface UseStampRallyReturn {
+    readonly state: StampRallyState | null;
+    readonly isLoading: boolean;
+    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 reset: (now?: string) => Promise<StampRallyState>;
+    readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;
+    readonly exportRecoveryCode: () => string;
+    readonly importRecoveryCode: (token: string) => Promise<boolean>;
+}
+/** @deprecated Use UseStampRallyReturn instead. */
+type UseStampRallyValue = UseStampRallyReturn;
+declare function useStampRally(client: StampRallyClient): UseStampRallyReturn;
+
+export { type RedeemOptions, type UseStampRallyReturn, type UseStampRallyValue, useStampRally };

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { StampRallyState, StampError, RewardConsumeError, RewardState, VerificationContext, Result, ProcessStampValue, ConsumeResult, StampRallyClient } from '@stamprally/core';
+
+interface RedeemOptions {
+    readonly passcode?: string;
+    readonly staffId?: string;
+}
+interface UseStampRallyReturn {
+    readonly state: StampRallyState | null;
+    readonly isLoading: boolean;
+    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 reset: (now?: string) => Promise<StampRallyState>;
+    readonly redeem: (rewardId: string, options?: RedeemOptions) => Promise<ConsumeResult>;
+    readonly exportRecoveryCode: () => string;
+    readonly importRecoveryCode: (token: string) => Promise<boolean>;
+}
+/** @deprecated Use UseStampRallyReturn instead. */
+type UseStampRallyValue = UseStampRallyReturn;
+declare function useStampRally(client: StampRallyClient): UseStampRallyReturn;
+
+export { type RedeemOptions, type UseStampRallyReturn, type UseStampRallyValue, useStampRally };

package/dist/index.js

@@ -0,0 +1,238 @@
+import { consumeReward, exportProgressToken, importProgressToken } from '@stamprally/core';
+import { useCallback, useSyncExternalStore, useState, useTransition, useOptimistic, useEffect } from 'react';
+
+// src/useStampRally.ts
+function getServerSnapshot() {
+  return null;
+}
+function toError(error) {
+  return error instanceof Error ? error : new Error(String(error));
+}
+function applyOptimisticAcquire(currentState, action) {
+  if (currentState === null || currentState.records.some((record) => record.stampId === action.stampId)) {
+    return currentState;
+  }
+  return {
+    ...currentState,
+    records: [...currentState.records, { stampId: action.stampId, acquiredAt: action.acquiredAt }],
+    updatedAt: action.acquiredAt
+  };
+}
+function useStampRally(client) {
+  const subscribe = useCallback(
+    (onStoreChange) => client.subscribe(() => onStoreChange()),
+    [client]
+  );
+  const getSnapshot = useCallback(() => client.getState(), [client]);
+  const rawState = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+  const [clientStatus, setClientStatus] = useState(() => ({
+    client,
+    isInitializing: client.getState() === null
+  }));
+  const [clientError, setClientError] = useState(null);
+  const [isPending, startTransition] = useTransition();
+  const [optimisticState, addOptimisticAcquire] = useOptimistic(rawState, applyOptimisticAcquire);
+  useEffect(() => {
+    let active = true;
+    setClientError(null);
+    if (rawState !== null) {
+      setClientStatus({ client, isInitializing: false });
+      return () => {
+        active = false;
+      };
+    }
+    setClientStatus({ client, isInitializing: true });
+    void client.init().catch((initializationError) => {
+      if (active) {
+        setClientError({ client, value: toError(initializationError) });
+      }
+    }).finally(() => {
+      if (active) {
+        setClientStatus({ client, isInitializing: false });
+      }
+    });
+    return () => {
+      active = false;
+    };
+  }, [client, rawState]);
+  const acquire = useCallback(
+    (stampId, context, now) => {
+      const acquiredAt = now ?? (/* @__PURE__ */ new Date()).toISOString();
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          addOptimisticAcquire({ stampId, acquiredAt });
+          try {
+            const result = await client.acquire(stampId, context, acquiredAt);
+            if (!result.ok) {
+              setClientError({ client, value: result.error });
+            }
+            resolve(result);
+          } catch (acquireError) {
+            const normalizedError = toError(acquireError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [addOptimisticAcquire, client]
+  );
+  const reset = useCallback(
+    (now) => {
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          try {
+            const nextState = now === void 0 ? await client.reset() : await client.reset(now);
+            resolve(nextState);
+          } catch (resetError) {
+            const normalizedError = toError(resetError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [client]
+  );
+  const redeem = useCallback(
+    (rewardId, options = {}) => {
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          const reward = client.getConfig().rewards?.find((item) => item.id === rewardId);
+          if (reward === void 0) {
+            const result2 = {
+              ok: false,
+              error: { code: "REWARD_NOT_FOUND", rewardId }
+            };
+            setClientError({ client, value: result2.error });
+            resolve(result2);
+            return;
+          }
+          const currentState = client.getState();
+          const currentRewardState = currentState?.rewards?.find(
+            (state) => state.rewardId === rewardId
+          );
+          if (currentState === null || currentRewardState === void 0) {
+            const result2 = {
+              ok: false,
+              error: { code: "NOT_AVAILABLE", rewardId }
+            };
+            setClientError({ client, value: result2.error });
+            resolve(result2);
+            return;
+          }
+          const result = consumeReward({
+            reward,
+            currentState: currentRewardState,
+            now: (/* @__PURE__ */ new Date()).toISOString(),
+            ...options.passcode === void 0 ? {} : { inputPasscode: options.passcode },
+            ...options.staffId === void 0 ? {} : { staffId: options.staffId }
+          });
+          if (!result.ok) {
+            setClientError({ client, value: result.error });
+            resolve(result);
+            return;
+          }
+          if (result.value === currentRewardState) {
+            resolve(result);
+            return;
+          }
+          const nextState = {
+            ...currentState,
+            rewards: (currentState.rewards ?? []).map(
+              (state) => state.rewardId === rewardId ? result.value : state
+            ),
+            updatedAt: result.value.consumedAt ?? currentState.updatedAt
+          };
+          try {
+            await client.restore(nextState);
+            resolve(result);
+          } catch (redeemError) {
+            const normalizedError = toError(redeemError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [client]
+  );
+  const exportRecoveryCode = useCallback(() => {
+    const state = client.getState();
+    if (state === null) {
+      throw new Error("Cannot export recovery code before the rally is initialized.");
+    }
+    return exportProgressToken({
+      version: 1,
+      rallyId: state.rallyId,
+      stamps: state.records,
+      rewards: state.rewards ?? [],
+      exportedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  }, [client]);
+  const importRecoveryCode = useCallback(
+    (token) => {
+      setClientError(null);
+      return new Promise((resolve, reject) => {
+        startTransition(async () => {
+          const config = client.getConfig();
+          const snapshot = importProgressToken(token, config.id);
+          if (snapshot === null) {
+            resolve(false);
+            return;
+          }
+          const stampIds = new Set(config.stamps.map((stamp) => stamp.id));
+          const rewardIds = new Set((config.rewards ?? []).map((reward) => reward.id));
+          const importedStampIds = /* @__PURE__ */ new Set();
+          const importedRewardIds = /* @__PURE__ */ new Set();
+          const stamps = snapshot.stamps.filter((record) => {
+            if (!stampIds.has(record.stampId) || importedStampIds.has(record.stampId)) return false;
+            importedStampIds.add(record.stampId);
+            return true;
+          });
+          const rewards = snapshot.rewards.filter((state) => {
+            if (!rewardIds.has(state.rewardId) || importedRewardIds.has(state.rewardId))
+              return false;
+            importedRewardIds.add(state.rewardId);
+            return true;
+          });
+          try {
+            await client.restore({
+              rallyId: config.id,
+              records: stamps,
+              ...config.rewards === void 0 && rewards.length === 0 ? {} : { rewards },
+              updatedAt: snapshot.exportedAt
+            });
+            resolve(true);
+          } catch (importError) {
+            const normalizedError = toError(importError);
+            setClientError({ client, value: normalizedError });
+            reject(normalizedError);
+          }
+        });
+      });
+    },
+    [client]
+  );
+  const isLoading = rawState === null && (clientStatus.client !== client || clientStatus.isInitializing);
+  const error = clientError?.client === client ? clientError.value : null;
+  return {
+    state: optimisticState,
+    isLoading,
+    isPending,
+    error,
+    rewardsState: optimisticState?.rewards ?? [],
+    acquire,
+    reset,
+    redeem,
+    exportRecoveryCode,
+    importRecoveryCode
+  };
+}
+
+export { useStampRally };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@stamprally/react",
+  "version": "0.1.0",
+  "description": "React hooks for @stamprally/core.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nitta-a/stamprally-core-app.git",
+    "directory": "packages/react"
+  },
+  "bugs": {
+    "url": "https://github.com/nitta-a/stamprally-core-app/issues"
+  },
+  "homepage": "https://github.com/nitta-a/stamprally-core-app#readme",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@stamprally/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0 <20.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.18",
+    "jsdom": "^30.0.1",
+    "react": "^19.2.8",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}