@stamprally/core 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -94,6 +94,13 @@ type StampError = {
     readonly code: "CONDITION_MISMATCH";
     readonly stampId: string;
     readonly mismatch: ConditionMismatch;
+} | {
+    readonly code: "OFFLINE_QUEUED";
+    readonly stampId: string;
+    readonly idempotencyKey: string;
+} | {
+    readonly code: "INVALID_PROOF";
+    readonly stampId: string;
 };
 type Result<T, E> = {
     readonly ok: true;
@@ -104,8 +111,8 @@ type Result<T, E> = {
 };
 
 type SupportedLocale = "ja" | "en";
-type LocalizedString = Record<SupportedLocale, string>;
-type LocalizedText = string | LocalizedString;
+type LocalizedString<TLocale extends string = SupportedLocale> = Record<TLocale, string>;
+type LocalizedText<TLocale extends string = string> = string | Partial<Record<TLocale, string>>;
 type SlotShape = "circle" | "square" | "rounded";
 type FontFamily = "system-ui" | "serif" | "rounded-sans" | "monospace" | "handwritten";
 interface SheetTheme {
@@ -121,23 +128,33 @@ interface SheetTheme {
     readonly fontFamily?: FontFamily;
 }
 type ThemePresetId = "default" | "modern_dark" | "pop_candy" | "retro_craft" | "cyber";
-interface ThemePreset {
+interface ThemePreset<TLocale extends string = SupportedLocale> {
     readonly id: ThemePresetId;
-    readonly name: LocalizedString;
-    readonly description: LocalizedString;
+    readonly name: LocalizedString<TLocale>;
+    readonly description: LocalizedString<TLocale>;
     readonly theme: SheetTheme;
 }
 declare const DEFAULT_SHEET_THEME: SheetTheme;
-interface SpotItem {
+interface SpotItem<TLocale extends string = SupportedLocale, TMeta extends Record<string, unknown> = Record<string, unknown>> {
     readonly id: string;
-    readonly name: LocalizedText;
-    readonly description?: LocalizedText;
-    readonly hint?: LocalizedText;
+    readonly name: LocalizedText<TLocale>;
+    readonly description?: LocalizedText<TLocale>;
+    readonly hint?: LocalizedText<TLocale>;
     readonly condition: StampCondition;
     readonly order?: number;
+    readonly deckId?: string;
+    readonly groupId?: string;
+    readonly guideId?: string;
+    readonly iconUrl?: string;
+    readonly imageUrl?: string;
+    readonly externalUrl?: string;
+    readonly redirectUrlAfterClaim?: string;
+    readonly metadata?: TMeta;
+    readonly dependsOn?: ReadonlyArray<string>;
+    readonly requiresStampIds?: ReadonlyArray<string>;
 }
 /** @deprecated Use SpotItem instead. */
-type StampDefinition = SpotItem;
+type StampDefinition<TLocale extends string = SupportedLocale, TMeta extends Record<string, unknown> = Record<string, unknown>> = SpotItem<TLocale, TMeta>;
 interface StampRecord {
     readonly stampId: string;
     readonly acquiredAt: string;
@@ -146,15 +163,19 @@ interface StampRecord {
 type RewardType = "digital" | "in_person";
 type RedemptionMethod = "manual_slide" | "staff_passcode" | "view_only";
 type RewardStatus = "LOCKED" | "AVAILABLE" | "CONSUMED" | "EXPIRED";
-interface RewardItem {
+interface RewardItem<TLocale extends string = SupportedLocale> {
     readonly id: string;
-    readonly title: LocalizedText;
-    readonly description: LocalizedText;
+    readonly title: LocalizedText<TLocale>;
+    readonly description: LocalizedText<TLocale>;
     readonly type: RewardType;
     readonly redemptionMethod: RedemptionMethod;
     readonly requiredStampCount: number;
     readonly digitalContentUrl?: string;
     readonly staffPasscode?: string;
+    readonly validUntil?: string;
+    readonly maxStock?: number;
+    readonly limitPerUser?: number;
+    readonly claimTicketNumber?: string;
 }
 interface RewardState {
     readonly rewardId: string;
@@ -162,6 +183,9 @@ interface RewardState {
     readonly unlockedAt?: string;
     readonly consumedAt?: string;
     readonly consumedByStaffId?: string;
+    readonly claimTicketNumber?: string;
+    readonly redeemedCount?: number;
+    readonly userRedemptionCount?: number;
 }
 interface StampRallyState {
     readonly rallyId: string;
@@ -169,21 +193,72 @@ interface StampRallyState {
     readonly rewards?: ReadonlyArray<RewardState>;
     readonly updatedAt: string;
 }
-interface RallyConfig {
+interface RallyConfig<TLocale extends string = SupportedLocale, TMeta extends Record<string, unknown> = Record<string, unknown>> {
     readonly id: string;
-    readonly title?: LocalizedText;
-    readonly description?: LocalizedText;
-    readonly stamps: ReadonlyArray<StampDefinition>;
-    readonly rewards?: ReadonlyArray<RewardItem>;
+    readonly title?: LocalizedText<TLocale>;
+    readonly description?: LocalizedText<TLocale>;
+    readonly stamps: ReadonlyArray<StampDefinition<TLocale, TMeta>>;
+    readonly rewards?: ReadonlyArray<RewardItem<TLocale>>;
     readonly isSequential?: boolean;
     readonly theme?: SheetTheme;
+    readonly version?: number;
+    readonly startDate?: string;
+    readonly endDate?: string;
 }
 
-declare function resolveLocalizedText(text: LocalizedText | undefined, locale: SupportedLocale, fallbackLocale?: SupportedLocale): string;
+declare function resolveLocalizedText<TLocale extends string = SupportedLocale>(text: LocalizedText<TLocale> | undefined, locale: string, fallbackLocale?: string): string;
 declare function toLocalizedString(text: LocalizedText | undefined): LocalizedString;
+declare function toLocalizedString<TLocale extends string>(text: LocalizedText<TLocale> | undefined): LocalizedString<TLocale>;
+
+declare function migrateRallyConfig(raw: unknown): RallyConfig;
+
+type PublicRewardItem<TLocale extends string = string> = Omit<RewardItem<TLocale>, "staffPasscode">;
+type PublicRallyConfig<TLocale extends string = string, TMeta extends Record<string, unknown> = Record<string, unknown>> = Omit<RallyConfig<TLocale, TMeta>, "rewards"> & {
+    readonly rewards?: ReadonlyArray<PublicRewardItem<TLocale>>;
+};
+declare function stripSensitiveConfig<TLocale extends string, TMeta extends Record<string, unknown>>(config: RallyConfig<TLocale, TMeta>): PublicRallyConfig<TLocale, TMeta>;
 
 declare const THEME_PRESETS: ReadonlyArray<ThemePreset>;
 
+declare const CURRENT_RALLY_CONFIG_VERSION = 2;
+interface ValidationError {
+    readonly path: string;
+    readonly code: "INVALID_TYPE" | "REQUIRED" | "EMPTY_STRING" | "DUPLICATE_ID" | "INVALID_COORDINATES" | "INVALID_RADIUS" | "INVALID_DATE" | "INVALID_VERSION" | "INVALID_REWARD" | "CYCLE_DETECTED";
+    readonly message: string;
+}
+interface RallyConfigValidationResult {
+    readonly valid: boolean;
+    readonly errors: ReadonlyArray<ValidationError>;
+}
+declare function validateRallyConfig(config: unknown): RallyConfigValidationResult;
+
+type CheckInErrorCode = "ORDER_VIOLATION" | "OUT_OF_RANGE" | "EXPIRED" | "INVALID_PROOF" | "INVALID_CONTEXT" | "ALREADY_CLAIMED";
+interface CheckInContext {
+    readonly verificationContext: VerificationContext;
+    readonly now?: string;
+    readonly expectedStampId?: string;
+    readonly proof?: string;
+    readonly alreadyClaimed?: boolean;
+}
+type CheckInInput = VerificationContext | (VerificationContext & {
+    readonly now?: string;
+    readonly expectedStampId?: string;
+    readonly alreadyClaimed?: boolean;
+}) | CheckInContext;
+type CheckInResult$1 = {
+    readonly ok: true;
+    readonly success: true;
+    readonly stampId: string;
+    readonly checkedAt: string;
+} | {
+    readonly ok: false;
+    readonly success: false;
+    readonly code: CheckInErrorCode;
+    readonly stampId: string;
+    readonly message: string;
+};
+declare function evaluateCheckIn(spot: SpotItem, input: CheckInInput): CheckInResult$1;
+
 declare function calculateDistanceMeters(latitudeA: number, longitudeA: number, latitudeB: number, longitudeB: number): number;
 declare function evaluateConditionDetailed(condition: StampCondition, context: VerificationContext, now: string): Result<ConditionMatch, ConditionMismatch>;
 declare function evaluateCondition(condition: StampCondition, context: VerificationContext, now?: string): boolean;
@@ -199,6 +274,13 @@ interface StampRallyProgress {
 }
 declare function calculateProgress(state: StampRallyState, config: RallyConfig): StampRallyProgress;
 
+interface ClaimTicketOptions {
+    readonly issuedAt?: string;
+    readonly sequence?: number;
+}
+declare function createClaimTicketNumber(rewardId: string, options?: ClaimTicketOptions): string;
+declare function issueClaimTicketNumber(reward: RewardItem, currentState: RewardState, options?: ClaimTicketOptions): RewardState;
+
 type StampRallyEvent = {
     readonly type: "stampAcquired";
     readonly record: StampRecord;
@@ -206,6 +288,10 @@ type StampRallyEvent = {
     readonly type: "rallyCompleted";
     readonly rallyId: string;
     readonly completedAt: string;
+} | {
+    readonly type: "rewardUnlocked";
+    readonly rewardId: string;
+    readonly unlockedAt: string;
 };
 interface ProcessStampValue {
     readonly nextState: StampRallyState;
@@ -221,6 +307,15 @@ type RewardConsumeError = {
     readonly code: "INVALID_PASSCODE";
     readonly rewardId: string;
     readonly message: string;
+} | {
+    readonly code: "EXPIRED";
+    readonly rewardId: string;
+} | {
+    readonly code: "OUT_OF_STOCK";
+    readonly rewardId: string;
+} | {
+    readonly code: "USER_LIMIT_REACHED";
+    readonly rewardId: string;
 } | {
     readonly code: "REWARD_NOT_FOUND";
     readonly rewardId: string;
@@ -231,6 +326,8 @@ interface ConsumeRewardParams {
     readonly inputPasscode?: string;
     readonly staffId?: string;
     readonly now: string;
+    readonly userId?: string;
+    readonly userRedemptionCount?: number;
 }
 type ConsumeResult = Result<RewardState, RewardConsumeError>;
 declare function reconcileRewardStates(rewards: ReadonlyArray<RewardItem>, currentStates: ReadonlyArray<RewardState>, acquiredStampCount: number, now: string): ReadonlyArray<RewardState>;
@@ -369,4 +466,27 @@ interface QrDetectorOptions {
 declare function isQrSupported(): boolean;
 declare function readQrContext(videoElement: HTMLVideoElement, options?: QrDetectorOptions): Promise<DetectorResult<TokenVerificationContext>>;
 
-export { type CheckInResult, type Clock, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, type ConsumeResult, type ConsumeRewardParams, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type PasscodeCondition, type ProcessStampValue, type QrDetectorOptions, type RallyConfig, type RallySnapshot, type RedemptionMethod, type Result, type RewardConsumeError, type RewardItem, type RewardState, type RewardStatus, type RewardType, type SheetTheme, type SlotShape, type SpotItem, type StampCondition, type StampDefinition, type StampError, StampRallyClient, type StampRallyEvent, type StampRallyListener, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, THEME_PRESETS, type ThemePreset, type ThemePresetId, type TokenVerificationContext, type VerificationContext, calculateDistanceMeters, calculateProgress, consumeReward, evaluateCondition, evaluateConditionDetailed, exportProgressToken, getCurrentGeoContext, importProgressToken, isGeolocationSupported, isNfcSupported, isQrSupported, isRewardState, isStampRallyState, normalizePasscode, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, toLocalizedString, verifyPasscode };
+type SnapshotSecretKey = string | Uint8Array;
+interface SnapshotTokenPayload {
+    readonly [key: string]: unknown;
+    readonly expiresAt?: string;
+    readonly exp?: number;
+}
+type SnapshotTokenErrorCode = "MALFORMED" | "INVALID_SIGNATURE" | "DECRYPTION_FAILED" | "EXPIRED" | "UNSUPPORTED";
+interface SnapshotTokenError {
+    readonly code: SnapshotTokenErrorCode;
+    readonly message: string;
+}
+type SnapshotTokenVerification<T extends SnapshotTokenPayload = SnapshotTokenPayload> = {
+    readonly ok: true;
+    readonly valid: true;
+    readonly payload: T;
+} | {
+    readonly ok: false;
+    readonly valid: false;
+    readonly error: SnapshotTokenError;
+};
+declare function createSignedSnapshotToken<T extends SnapshotTokenPayload>(payload: T, secretKey: SnapshotSecretKey): Promise<string>;
+declare function verifySnapshotToken<T extends SnapshotTokenPayload = SnapshotTokenPayload>(token: string, secretKey: SnapshotSecretKey, now?: number): Promise<SnapshotTokenVerification<T>>;
+
+export { CURRENT_RALLY_CONFIG_VERSION, type CheckInContext, type CheckInErrorCode, type CheckInInput, type CheckInResult$1 as CheckInResult, type ClaimTicketOptions, type Clock, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, type ConsumeResult, type ConsumeRewardParams, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type PasscodeCondition, type ProcessStampValue, type PublicRallyConfig, type PublicRewardItem, type QrDetectorOptions, type RallyConfig, type RallyConfigValidationResult, type RallySnapshot, type RedemptionMethod, type Result, type RewardConsumeError, type RewardItem, type RewardState, type RewardStatus, type RewardType, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type StampCondition, type StampDefinition, type StampError, StampRallyClient, type StampRallyEvent, type StampRallyListener, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, THEME_PRESETS, type ThemePreset, type ThemePresetId, type TokenVerificationContext, type ValidationError, type VerificationContext, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSignedSnapshotToken, evaluateCheckIn, evaluateCondition, evaluateConditionDetailed, exportProgressToken, getCurrentGeoContext, importProgressToken, isGeolocationSupported, isNfcSupported, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, migrateRallyConfig, normalizePasscode, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, stripSensitiveConfig, toLocalizedString, validateRallyConfig, verifyPasscode, verifySnapshotToken };

package/dist/index.d.ts

@@ -94,6 +94,13 @@ type StampError = {
     readonly code: "CONDITION_MISMATCH";
     readonly stampId: string;
     readonly mismatch: ConditionMismatch;
+} | {
+    readonly code: "OFFLINE_QUEUED";
+    readonly stampId: string;
+    readonly idempotencyKey: string;
+} | {
+    readonly code: "INVALID_PROOF";
+    readonly stampId: string;
 };
 type Result<T, E> = {
     readonly ok: true;
@@ -104,8 +111,8 @@ type Result<T, E> = {
 };
 
 type SupportedLocale = "ja" | "en";
-type LocalizedString = Record<SupportedLocale, string>;
-type LocalizedText = string | LocalizedString;
+type LocalizedString<TLocale extends string = SupportedLocale> = Record<TLocale, string>;
+type LocalizedText<TLocale extends string = string> = string | Partial<Record<TLocale, string>>;
 type SlotShape = "circle" | "square" | "rounded";
 type FontFamily = "system-ui" | "serif" | "rounded-sans" | "monospace" | "handwritten";
 interface SheetTheme {
@@ -121,23 +128,33 @@ interface SheetTheme {
     readonly fontFamily?: FontFamily;
 }
 type ThemePresetId = "default" | "modern_dark" | "pop_candy" | "retro_craft" | "cyber";
-interface ThemePreset {
+interface ThemePreset<TLocale extends string = SupportedLocale> {
     readonly id: ThemePresetId;
-    readonly name: LocalizedString;
-    readonly description: LocalizedString;
+    readonly name: LocalizedString<TLocale>;
+    readonly description: LocalizedString<TLocale>;
     readonly theme: SheetTheme;
 }
 declare const DEFAULT_SHEET_THEME: SheetTheme;
-interface SpotItem {
+interface SpotItem<TLocale extends string = SupportedLocale, TMeta extends Record<string, unknown> = Record<string, unknown>> {
     readonly id: string;
-    readonly name: LocalizedText;
-    readonly description?: LocalizedText;
-    readonly hint?: LocalizedText;
+    readonly name: LocalizedText<TLocale>;
+    readonly description?: LocalizedText<TLocale>;
+    readonly hint?: LocalizedText<TLocale>;
     readonly condition: StampCondition;
     readonly order?: number;
+    readonly deckId?: string;
+    readonly groupId?: string;
+    readonly guideId?: string;
+    readonly iconUrl?: string;
+    readonly imageUrl?: string;
+    readonly externalUrl?: string;
+    readonly redirectUrlAfterClaim?: string;
+    readonly metadata?: TMeta;
+    readonly dependsOn?: ReadonlyArray<string>;
+    readonly requiresStampIds?: ReadonlyArray<string>;
 }
 /** @deprecated Use SpotItem instead. */
-type StampDefinition = SpotItem;
+type StampDefinition<TLocale extends string = SupportedLocale, TMeta extends Record<string, unknown> = Record<string, unknown>> = SpotItem<TLocale, TMeta>;
 interface StampRecord {
     readonly stampId: string;
     readonly acquiredAt: string;
@@ -146,15 +163,19 @@ interface StampRecord {
 type RewardType = "digital" | "in_person";
 type RedemptionMethod = "manual_slide" | "staff_passcode" | "view_only";
 type RewardStatus = "LOCKED" | "AVAILABLE" | "CONSUMED" | "EXPIRED";
-interface RewardItem {
+interface RewardItem<TLocale extends string = SupportedLocale> {
     readonly id: string;
-    readonly title: LocalizedText;
-    readonly description: LocalizedText;
+    readonly title: LocalizedText<TLocale>;
+    readonly description: LocalizedText<TLocale>;
     readonly type: RewardType;
     readonly redemptionMethod: RedemptionMethod;
     readonly requiredStampCount: number;
     readonly digitalContentUrl?: string;
     readonly staffPasscode?: string;
+    readonly validUntil?: string;
+    readonly maxStock?: number;
+    readonly limitPerUser?: number;
+    readonly claimTicketNumber?: string;
 }
 interface RewardState {
     readonly rewardId: string;
@@ -162,6 +183,9 @@ interface RewardState {
     readonly unlockedAt?: string;
     readonly consumedAt?: string;
     readonly consumedByStaffId?: string;
+    readonly claimTicketNumber?: string;
+    readonly redeemedCount?: number;
+    readonly userRedemptionCount?: number;
 }
 interface StampRallyState {
     readonly rallyId: string;
@@ -169,21 +193,72 @@ interface StampRallyState {
     readonly rewards?: ReadonlyArray<RewardState>;
     readonly updatedAt: string;
 }
-interface RallyConfig {
+interface RallyConfig<TLocale extends string = SupportedLocale, TMeta extends Record<string, unknown> = Record<string, unknown>> {
     readonly id: string;
-    readonly title?: LocalizedText;
-    readonly description?: LocalizedText;
-    readonly stamps: ReadonlyArray<StampDefinition>;
-    readonly rewards?: ReadonlyArray<RewardItem>;
+    readonly title?: LocalizedText<TLocale>;
+    readonly description?: LocalizedText<TLocale>;
+    readonly stamps: ReadonlyArray<StampDefinition<TLocale, TMeta>>;
+    readonly rewards?: ReadonlyArray<RewardItem<TLocale>>;
     readonly isSequential?: boolean;
     readonly theme?: SheetTheme;
+    readonly version?: number;
+    readonly startDate?: string;
+    readonly endDate?: string;
 }
 
-declare function resolveLocalizedText(text: LocalizedText | undefined, locale: SupportedLocale, fallbackLocale?: SupportedLocale): string;
+declare function resolveLocalizedText<TLocale extends string = SupportedLocale>(text: LocalizedText<TLocale> | undefined, locale: string, fallbackLocale?: string): string;
 declare function toLocalizedString(text: LocalizedText | undefined): LocalizedString;
+declare function toLocalizedString<TLocale extends string>(text: LocalizedText<TLocale> | undefined): LocalizedString<TLocale>;
+
+declare function migrateRallyConfig(raw: unknown): RallyConfig;
+
+type PublicRewardItem<TLocale extends string = string> = Omit<RewardItem<TLocale>, "staffPasscode">;
+type PublicRallyConfig<TLocale extends string = string, TMeta extends Record<string, unknown> = Record<string, unknown>> = Omit<RallyConfig<TLocale, TMeta>, "rewards"> & {
+    readonly rewards?: ReadonlyArray<PublicRewardItem<TLocale>>;
+};
+declare function stripSensitiveConfig<TLocale extends string, TMeta extends Record<string, unknown>>(config: RallyConfig<TLocale, TMeta>): PublicRallyConfig<TLocale, TMeta>;
 
 declare const THEME_PRESETS: ReadonlyArray<ThemePreset>;
 
+declare const CURRENT_RALLY_CONFIG_VERSION = 2;
+interface ValidationError {
+    readonly path: string;
+    readonly code: "INVALID_TYPE" | "REQUIRED" | "EMPTY_STRING" | "DUPLICATE_ID" | "INVALID_COORDINATES" | "INVALID_RADIUS" | "INVALID_DATE" | "INVALID_VERSION" | "INVALID_REWARD" | "CYCLE_DETECTED";
+    readonly message: string;
+}
+interface RallyConfigValidationResult {
+    readonly valid: boolean;
+    readonly errors: ReadonlyArray<ValidationError>;
+}
+declare function validateRallyConfig(config: unknown): RallyConfigValidationResult;
+
+type CheckInErrorCode = "ORDER_VIOLATION" | "OUT_OF_RANGE" | "EXPIRED" | "INVALID_PROOF" | "INVALID_CONTEXT" | "ALREADY_CLAIMED";
+interface CheckInContext {
+    readonly verificationContext: VerificationContext;
+    readonly now?: string;
+    readonly expectedStampId?: string;
+    readonly proof?: string;
+    readonly alreadyClaimed?: boolean;
+}
+type CheckInInput = VerificationContext | (VerificationContext & {
+    readonly now?: string;
+    readonly expectedStampId?: string;
+    readonly alreadyClaimed?: boolean;
+}) | CheckInContext;
+type CheckInResult$1 = {
+    readonly ok: true;
+    readonly success: true;
+    readonly stampId: string;
+    readonly checkedAt: string;
+} | {
+    readonly ok: false;
+    readonly success: false;
+    readonly code: CheckInErrorCode;
+    readonly stampId: string;
+    readonly message: string;
+};
+declare function evaluateCheckIn(spot: SpotItem, input: CheckInInput): CheckInResult$1;
+
 declare function calculateDistanceMeters(latitudeA: number, longitudeA: number, latitudeB: number, longitudeB: number): number;
 declare function evaluateConditionDetailed(condition: StampCondition, context: VerificationContext, now: string): Result<ConditionMatch, ConditionMismatch>;
 declare function evaluateCondition(condition: StampCondition, context: VerificationContext, now?: string): boolean;
@@ -199,6 +274,13 @@ interface StampRallyProgress {
 }
 declare function calculateProgress(state: StampRallyState, config: RallyConfig): StampRallyProgress;
 
+interface ClaimTicketOptions {
+    readonly issuedAt?: string;
+    readonly sequence?: number;
+}
+declare function createClaimTicketNumber(rewardId: string, options?: ClaimTicketOptions): string;
+declare function issueClaimTicketNumber(reward: RewardItem, currentState: RewardState, options?: ClaimTicketOptions): RewardState;
+
 type StampRallyEvent = {
     readonly type: "stampAcquired";
     readonly record: StampRecord;
@@ -206,6 +288,10 @@ type StampRallyEvent = {
     readonly type: "rallyCompleted";
     readonly rallyId: string;
     readonly completedAt: string;
+} | {
+    readonly type: "rewardUnlocked";
+    readonly rewardId: string;
+    readonly unlockedAt: string;
 };
 interface ProcessStampValue {
     readonly nextState: StampRallyState;
@@ -221,6 +307,15 @@ type RewardConsumeError = {
     readonly code: "INVALID_PASSCODE";
     readonly rewardId: string;
     readonly message: string;
+} | {
+    readonly code: "EXPIRED";
+    readonly rewardId: string;
+} | {
+    readonly code: "OUT_OF_STOCK";
+    readonly rewardId: string;
+} | {
+    readonly code: "USER_LIMIT_REACHED";
+    readonly rewardId: string;
 } | {
     readonly code: "REWARD_NOT_FOUND";
     readonly rewardId: string;
@@ -231,6 +326,8 @@ interface ConsumeRewardParams {
     readonly inputPasscode?: string;
     readonly staffId?: string;
     readonly now: string;
+    readonly userId?: string;
+    readonly userRedemptionCount?: number;
 }
 type ConsumeResult = Result<RewardState, RewardConsumeError>;
 declare function reconcileRewardStates(rewards: ReadonlyArray<RewardItem>, currentStates: ReadonlyArray<RewardState>, acquiredStampCount: number, now: string): ReadonlyArray<RewardState>;
@@ -369,4 +466,27 @@ interface QrDetectorOptions {
 declare function isQrSupported(): boolean;
 declare function readQrContext(videoElement: HTMLVideoElement, options?: QrDetectorOptions): Promise<DetectorResult<TokenVerificationContext>>;
 
-export { type CheckInResult, type Clock, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, type ConsumeResult, type ConsumeRewardParams, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type PasscodeCondition, type ProcessStampValue, type QrDetectorOptions, type RallyConfig, type RallySnapshot, type RedemptionMethod, type Result, type RewardConsumeError, type RewardItem, type RewardState, type RewardStatus, type RewardType, type SheetTheme, type SlotShape, type SpotItem, type StampCondition, type StampDefinition, type StampError, StampRallyClient, type StampRallyEvent, type StampRallyListener, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, THEME_PRESETS, type ThemePreset, type ThemePresetId, type TokenVerificationContext, type VerificationContext, calculateDistanceMeters, calculateProgress, consumeReward, evaluateCondition, evaluateConditionDetailed, exportProgressToken, getCurrentGeoContext, importProgressToken, isGeolocationSupported, isNfcSupported, isQrSupported, isRewardState, isStampRallyState, normalizePasscode, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, toLocalizedString, verifyPasscode };
+type SnapshotSecretKey = string | Uint8Array;
+interface SnapshotTokenPayload {
+    readonly [key: string]: unknown;
+    readonly expiresAt?: string;
+    readonly exp?: number;
+}
+type SnapshotTokenErrorCode = "MALFORMED" | "INVALID_SIGNATURE" | "DECRYPTION_FAILED" | "EXPIRED" | "UNSUPPORTED";
+interface SnapshotTokenError {
+    readonly code: SnapshotTokenErrorCode;
+    readonly message: string;
+}
+type SnapshotTokenVerification<T extends SnapshotTokenPayload = SnapshotTokenPayload> = {
+    readonly ok: true;
+    readonly valid: true;
+    readonly payload: T;
+} | {
+    readonly ok: false;
+    readonly valid: false;
+    readonly error: SnapshotTokenError;
+};
+declare function createSignedSnapshotToken<T extends SnapshotTokenPayload>(payload: T, secretKey: SnapshotSecretKey): Promise<string>;
+declare function verifySnapshotToken<T extends SnapshotTokenPayload = SnapshotTokenPayload>(token: string, secretKey: SnapshotSecretKey, now?: number): Promise<SnapshotTokenVerification<T>>;
+
+export { CURRENT_RALLY_CONFIG_VERSION, type CheckInContext, type CheckInErrorCode, type CheckInInput, type CheckInResult$1 as CheckInResult, type ClaimTicketOptions, type Clock, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, type ConsumeResult, type ConsumeRewardParams, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type PasscodeCondition, type ProcessStampValue, type PublicRallyConfig, type PublicRewardItem, type QrDetectorOptions, type RallyConfig, type RallyConfigValidationResult, type RallySnapshot, type RedemptionMethod, type Result, type RewardConsumeError, type RewardItem, type RewardState, type RewardStatus, type RewardType, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type StampCondition, type StampDefinition, type StampError, StampRallyClient, type StampRallyEvent, type StampRallyListener, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, THEME_PRESETS, type ThemePreset, type ThemePresetId, type TokenVerificationContext, type ValidationError, type VerificationContext, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSignedSnapshotToken, evaluateCheckIn, evaluateCondition, evaluateConditionDetailed, exportProgressToken, getCurrentGeoContext, importProgressToken, isGeolocationSupported, isNfcSupported, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, migrateRallyConfig, normalizePasscode, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, stripSensitiveConfig, toLocalizedString, validateRallyConfig, verifyPasscode, verifySnapshotToken };