@stamprally/core 0.13.0 → 0.15.0

package/dist/index.d.cts

@@ -96,6 +96,14 @@ type RewardUnlockCondition = {
 };
 type RewardType = "digital" | "in_person";
 type RedemptionMethod = "manual_slide" | "staff_passcode" | "view_only" | "server_claim";
+type InventoryAggregationMode = "shared" | "per_reward";
+type RallyInventory = Readonly<Record<string, number>> & {
+    readonly sharedStock?: number;
+};
+interface RallyInventoryState {
+    readonly sharedRemaining?: number;
+    readonly rewardRemaining?: Readonly<Record<string, number>>;
+}
 interface Reward<TLocale extends string = string> {
     readonly id: string;
     readonly title: LocalizedText<TLocale>;
@@ -120,7 +128,9 @@ interface AdminRallyConfig<TLocale extends string = string, TMeta extends Record
     readonly spots: ReadonlyArray<SpotItem<TLocale, TMeta>>;
     readonly rewards: ReadonlyArray<Reward<TLocale>>;
     readonly staffPasscode?: string;
-    readonly inventory?: Readonly<Record<string, number>>;
+    readonly inventory?: RallyInventory;
+    /** How the optional top-level inventory limit is aggregated. */
+    readonly inventoryMode?: InventoryAggregationMode;
     readonly serverMetadata?: Readonly<Record<string, unknown>>;
     readonly metadata?: TMeta;
     /** Explicit public metadata name. `metadata` remains supported for compatibility. */
@@ -164,6 +174,7 @@ interface StampRallyState {
     readonly userId: string | null;
     readonly records: ReadonlyArray<StampRecord>;
     readonly rewards: ReadonlyArray<RewardState>;
+    readonly inventory?: RallyInventoryState;
     readonly updatedAt: string;
 }
 type UserRallyState = StampRallyState;
@@ -285,6 +296,8 @@ declare class ConfigValidationError extends Error {
     readonly name = "ConfigValidationError";
     constructor(errors: ReadonlyArray<ValidationError>);
 }
+/** Validates relationships that can only be checked after all entities exist. */
+declare function validateRallyConfigRelations(config: AdminRallyConfig | PublicRallyConfig): ReadonlyArray<ValidationError>;
 declare function safeParseAdminConfig(input: unknown): ParseResult<AdminRallyConfig>;
 declare function parseAdminConfig(input: unknown): AdminRallyConfig;
 declare function safeParsePublicConfig(input: unknown): ParseResult<PublicRallyConfig>;
@@ -362,9 +375,13 @@ declare function processStamp(state: StampRallyState, config: AdminRallyConfig,
 type OfflineOperation = {
     readonly kind: "checkIn";
     readonly request: CheckInRequest;
+    readonly status?: OfflineOperationLifecycleStatus;
+    readonly attempts?: number;
 } | {
     readonly kind: "claimReward";
     readonly request: ClaimRequest;
+    readonly status?: OfflineOperationLifecycleStatus;
+    readonly attempts?: number;
 };
 type OfflineResult = CheckInResult | ClaimResult | UserRallyState;
 type SyncState = "idle" | "syncing" | "error";
@@ -393,6 +410,17 @@ interface OfflineQueueOptions {
     readonly databaseName?: string;
     readonly conflictPolicy?: SyncConflictPolicy;
     readonly onSyncConflict?: SyncConflictPolicy | ((context: OfflineConflict) => SyncConflictPolicy | Promise<SyncConflictPolicy>);
+    /** Enables storage-event/BroadcastChannel synchronization when browser APIs exist. */
+    readonly synchronizeInstances?: boolean;
+    readonly retryOptions?: SyncRetryOptions;
+    readonly retry?: SyncRetryOptions;
+    /** Alias accepted for callers that configure retry behavior at sync time. */
+    readonly syncRetryOptions?: SyncRetryOptions;
+}
+interface SyncRetryOptions {
+    readonly maxRetries?: number;
+    readonly initialIntervalMs?: number;
+    readonly backoffMultiplier?: number;
 }
 interface OfflineConflict {
     readonly operation: OfflineOperation;
@@ -400,7 +428,8 @@ interface OfflineConflict {
     readonly serverState: UserRallyState;
 }
 type OfflineSender = (operation: OfflineOperation) => Promise<OfflineResult | OfflineConflictResult | OfflineOperationResponse>;
-type OfflineOperationStatus = "ACCEPTED" | "REJECTED_PERMANENT" | "RETRYABLE_ERROR";
+type OfflineOperationStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED" | "REJECTED_PERMANENT" | "RETRYABLE_ERROR";
+type OfflineOperationLifecycleStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED";
 interface OfflineOperationError {
     readonly code: string;
     readonly message: string;
@@ -457,6 +486,8 @@ declare class OfflineQueue {
     get userId(): string | null;
     setSyncResultListener(listener: OfflineSyncResultListener | undefined): void;
     initialize(): Promise<void>;
+    /** Releases browser listeners when the queue is no longer used. */
+    dispose(): void;
     /** Selects a rally/user queue scope and loads its pending operations. */
     setScope(rallyId: string, userId: string | null): Promise<void>;
     switchUser(newUserId: string | null): Promise<void>;
@@ -510,6 +541,7 @@ declare class InMemoryStorage implements StampStorage {
     remove(rallyId: string, userId: string | null): Promise<void>;
 }
 declare function storageKey(rallyId: string, userId: string | null): string;
+declare function createAnonymousSessionId(storage?: StorageLike | null): string;
 interface LocalStorageAdapterOptions {
     readonly storage?: StorageLike | null;
     readonly keyPrefix?: string;
@@ -598,6 +630,7 @@ interface CheckInRequest {
     readonly idempotencyKey: string;
     readonly now: string;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface ClaimRequest {
     readonly rallyId: string;
@@ -607,6 +640,7 @@ interface ClaimRequest {
     readonly now: string;
     readonly options: ClaimOptions;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface SyncAdapter {
     readonly checkIn?: (request: CheckInRequest) => Promise<CheckInResult>;
@@ -615,6 +649,7 @@ interface SyncAdapter {
         readonly rallyId: string;
         readonly userId: string | null;
         readonly state: UserRallyState;
+        readonly anonymousSessionId?: string;
     }) => Promise<UserRallyState>;
 }
 interface ClientOptions {
@@ -624,6 +659,7 @@ interface ClientOptions {
     readonly customValidators?: Readonly<Record<string, Validator>>;
     readonly clock?: () => string;
     readonly userId?: string | null;
+    readonly anonymousSessionId?: string;
     readonly offlineQueue?: OfflineQueue;
 }
 type StorageOrOptions = StampStorage | ClientOptions;
@@ -633,6 +669,7 @@ declare class StampRallyClient {
     getConfig(): RallyConfig;
     getState(): UserRallyState | null;
     getUserId(): string | null;
+    getAnonymousSessionId(): string;
     get syncState(): SyncState;
     get pendingCount(): number;
     subscribe(listener: ClientListener): () => void;
@@ -755,4 +792,4 @@ type SnapshotTokenVerification<T extends SnapshotTokenPayload = SnapshotTokenPay
 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 { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineSyncResultEvent, type OfflineSyncResultListener, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, type PublicConfigSafety, type PublicRallyConfig, type PublicReward, type PublicSpotItem, type QrDetectorOptions, type QrVerificationContext, type RallyConfig, type RallySnapshot, type RedemptionMethod, type Result, type Reward, type RewardConsumeError, type RewardState, type RewardStatus, type RewardType, type RewardUnlockCondition, type SecureTokenError, type SecureTokenErrorCode, type SecureTokenOptions, type SecureTokenPayload, type SecureTokenSecretKey, type SecureTokenVerification, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type SpotStatus, type StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, type SyncConflictPolicy, type SyncState, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, evaluateSpotStatus, exportProgressToken, getCurrentGeoContext, getOrderedSpots, getSpotStatus, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, verifyPasscode, verifySecureToken, verifySnapshotToken };
+export { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, type InventoryAggregationMode, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationLifecycleStatus, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineSyncResultEvent, type OfflineSyncResultListener, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, type PublicConfigSafety, type PublicRallyConfig, type PublicReward, type PublicSpotItem, type QrDetectorOptions, type QrVerificationContext, type RallyConfig, type RallyInventory, type RallyInventoryState, type RallySnapshot, type RedemptionMethod, type Result, type Reward, type RewardConsumeError, type RewardState, type RewardStatus, type RewardType, type RewardUnlockCondition, type SecureTokenError, type SecureTokenErrorCode, type SecureTokenOptions, type SecureTokenPayload, type SecureTokenSecretKey, type SecureTokenVerification, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type SpotStatus, type StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, type SyncConflictPolicy, type SyncRetryOptions, type SyncState, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createAnonymousSessionId, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, evaluateSpotStatus, exportProgressToken, getCurrentGeoContext, getOrderedSpots, getSpotStatus, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, validateRallyConfigRelations, verifyPasscode, verifySecureToken, verifySnapshotToken };

package/dist/index.d.ts

@@ -96,6 +96,14 @@ type RewardUnlockCondition = {
 };
 type RewardType = "digital" | "in_person";
 type RedemptionMethod = "manual_slide" | "staff_passcode" | "view_only" | "server_claim";
+type InventoryAggregationMode = "shared" | "per_reward";
+type RallyInventory = Readonly<Record<string, number>> & {
+    readonly sharedStock?: number;
+};
+interface RallyInventoryState {
+    readonly sharedRemaining?: number;
+    readonly rewardRemaining?: Readonly<Record<string, number>>;
+}
 interface Reward<TLocale extends string = string> {
     readonly id: string;
     readonly title: LocalizedText<TLocale>;
@@ -120,7 +128,9 @@ interface AdminRallyConfig<TLocale extends string = string, TMeta extends Record
     readonly spots: ReadonlyArray<SpotItem<TLocale, TMeta>>;
     readonly rewards: ReadonlyArray<Reward<TLocale>>;
     readonly staffPasscode?: string;
-    readonly inventory?: Readonly<Record<string, number>>;
+    readonly inventory?: RallyInventory;
+    /** How the optional top-level inventory limit is aggregated. */
+    readonly inventoryMode?: InventoryAggregationMode;
     readonly serverMetadata?: Readonly<Record<string, unknown>>;
     readonly metadata?: TMeta;
     /** Explicit public metadata name. `metadata` remains supported for compatibility. */
@@ -164,6 +174,7 @@ interface StampRallyState {
     readonly userId: string | null;
     readonly records: ReadonlyArray<StampRecord>;
     readonly rewards: ReadonlyArray<RewardState>;
+    readonly inventory?: RallyInventoryState;
     readonly updatedAt: string;
 }
 type UserRallyState = StampRallyState;
@@ -285,6 +296,8 @@ declare class ConfigValidationError extends Error {
     readonly name = "ConfigValidationError";
     constructor(errors: ReadonlyArray<ValidationError>);
 }
+/** Validates relationships that can only be checked after all entities exist. */
+declare function validateRallyConfigRelations(config: AdminRallyConfig | PublicRallyConfig): ReadonlyArray<ValidationError>;
 declare function safeParseAdminConfig(input: unknown): ParseResult<AdminRallyConfig>;
 declare function parseAdminConfig(input: unknown): AdminRallyConfig;
 declare function safeParsePublicConfig(input: unknown): ParseResult<PublicRallyConfig>;
@@ -362,9 +375,13 @@ declare function processStamp(state: StampRallyState, config: AdminRallyConfig,
 type OfflineOperation = {
     readonly kind: "checkIn";
     readonly request: CheckInRequest;
+    readonly status?: OfflineOperationLifecycleStatus;
+    readonly attempts?: number;
 } | {
     readonly kind: "claimReward";
     readonly request: ClaimRequest;
+    readonly status?: OfflineOperationLifecycleStatus;
+    readonly attempts?: number;
 };
 type OfflineResult = CheckInResult | ClaimResult | UserRallyState;
 type SyncState = "idle" | "syncing" | "error";
@@ -393,6 +410,17 @@ interface OfflineQueueOptions {
     readonly databaseName?: string;
     readonly conflictPolicy?: SyncConflictPolicy;
     readonly onSyncConflict?: SyncConflictPolicy | ((context: OfflineConflict) => SyncConflictPolicy | Promise<SyncConflictPolicy>);
+    /** Enables storage-event/BroadcastChannel synchronization when browser APIs exist. */
+    readonly synchronizeInstances?: boolean;
+    readonly retryOptions?: SyncRetryOptions;
+    readonly retry?: SyncRetryOptions;
+    /** Alias accepted for callers that configure retry behavior at sync time. */
+    readonly syncRetryOptions?: SyncRetryOptions;
+}
+interface SyncRetryOptions {
+    readonly maxRetries?: number;
+    readonly initialIntervalMs?: number;
+    readonly backoffMultiplier?: number;
 }
 interface OfflineConflict {
     readonly operation: OfflineOperation;
@@ -400,7 +428,8 @@ interface OfflineConflict {
     readonly serverState: UserRallyState;
 }
 type OfflineSender = (operation: OfflineOperation) => Promise<OfflineResult | OfflineConflictResult | OfflineOperationResponse>;
-type OfflineOperationStatus = "ACCEPTED" | "REJECTED_PERMANENT" | "RETRYABLE_ERROR";
+type OfflineOperationStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED" | "REJECTED_PERMANENT" | "RETRYABLE_ERROR";
+type OfflineOperationLifecycleStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED";
 interface OfflineOperationError {
     readonly code: string;
     readonly message: string;
@@ -457,6 +486,8 @@ declare class OfflineQueue {
     get userId(): string | null;
     setSyncResultListener(listener: OfflineSyncResultListener | undefined): void;
     initialize(): Promise<void>;
+    /** Releases browser listeners when the queue is no longer used. */
+    dispose(): void;
     /** Selects a rally/user queue scope and loads its pending operations. */
     setScope(rallyId: string, userId: string | null): Promise<void>;
     switchUser(newUserId: string | null): Promise<void>;
@@ -510,6 +541,7 @@ declare class InMemoryStorage implements StampStorage {
     remove(rallyId: string, userId: string | null): Promise<void>;
 }
 declare function storageKey(rallyId: string, userId: string | null): string;
+declare function createAnonymousSessionId(storage?: StorageLike | null): string;
 interface LocalStorageAdapterOptions {
     readonly storage?: StorageLike | null;
     readonly keyPrefix?: string;
@@ -598,6 +630,7 @@ interface CheckInRequest {
     readonly idempotencyKey: string;
     readonly now: string;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface ClaimRequest {
     readonly rallyId: string;
@@ -607,6 +640,7 @@ interface ClaimRequest {
     readonly now: string;
     readonly options: ClaimOptions;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface SyncAdapter {
     readonly checkIn?: (request: CheckInRequest) => Promise<CheckInResult>;
@@ -615,6 +649,7 @@ interface SyncAdapter {
         readonly rallyId: string;
         readonly userId: string | null;
         readonly state: UserRallyState;
+        readonly anonymousSessionId?: string;
     }) => Promise<UserRallyState>;
 }
 interface ClientOptions {
@@ -624,6 +659,7 @@ interface ClientOptions {
     readonly customValidators?: Readonly<Record<string, Validator>>;
     readonly clock?: () => string;
     readonly userId?: string | null;
+    readonly anonymousSessionId?: string;
     readonly offlineQueue?: OfflineQueue;
 }
 type StorageOrOptions = StampStorage | ClientOptions;
@@ -633,6 +669,7 @@ declare class StampRallyClient {
     getConfig(): RallyConfig;
     getState(): UserRallyState | null;
     getUserId(): string | null;
+    getAnonymousSessionId(): string;
     get syncState(): SyncState;
     get pendingCount(): number;
     subscribe(listener: ClientListener): () => void;
@@ -755,4 +792,4 @@ type SnapshotTokenVerification<T extends SnapshotTokenPayload = SnapshotTokenPay
 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 { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineSyncResultEvent, type OfflineSyncResultListener, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, type PublicConfigSafety, type PublicRallyConfig, type PublicReward, type PublicSpotItem, type QrDetectorOptions, type QrVerificationContext, type RallyConfig, type RallySnapshot, type RedemptionMethod, type Result, type Reward, type RewardConsumeError, type RewardState, type RewardStatus, type RewardType, type RewardUnlockCondition, type SecureTokenError, type SecureTokenErrorCode, type SecureTokenOptions, type SecureTokenPayload, type SecureTokenSecretKey, type SecureTokenVerification, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type SpotStatus, type StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, type SyncConflictPolicy, type SyncState, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, evaluateSpotStatus, exportProgressToken, getCurrentGeoContext, getOrderedSpots, getSpotStatus, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, verifyPasscode, verifySecureToken, verifySnapshotToken };
+export { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, type InventoryAggregationMode, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationLifecycleStatus, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineSyncResultEvent, type OfflineSyncResultListener, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, type PublicConfigSafety, type PublicRallyConfig, type PublicReward, type PublicSpotItem, type QrDetectorOptions, type QrVerificationContext, type RallyConfig, type RallyInventory, type RallyInventoryState, type RallySnapshot, type RedemptionMethod, type Result, type Reward, type RewardConsumeError, type RewardState, type RewardStatus, type RewardType, type RewardUnlockCondition, type SecureTokenError, type SecureTokenErrorCode, type SecureTokenOptions, type SecureTokenPayload, type SecureTokenSecretKey, type SecureTokenVerification, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type SpotStatus, type StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, type SyncConflictPolicy, type SyncRetryOptions, type SyncState, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createAnonymousSessionId, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, evaluateSpotStatus, exportProgressToken, getCurrentGeoContext, getOrderedSpots, getSpotStatus, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, validateRallyConfigRelations, verifyPasscode, verifySecureToken, verifySnapshotToken };