@stamprally/core 0.10.0 → 0.11.0

package/dist/index.d.cts

@@ -123,6 +123,8 @@ interface AdminRallyConfig<TLocale extends string = string, TMeta extends Record
     readonly inventory?: Readonly<Record<string, number>>;
     readonly serverMetadata?: Readonly<Record<string, unknown>>;
     readonly metadata?: TMeta;
+    /** Explicit public metadata name. `metadata` remains supported for compatibility. */
+    readonly publicMetadata?: TMeta;
     readonly serverEndpoint?: string;
 }
 interface PublicRallyConfig<TLocale extends string = string, TMeta extends Record<string, unknown> = Record<string, unknown>> {
@@ -165,6 +167,19 @@ interface StampRallyState {
 }
 type UserRallyState = StampRallyState;
 
+/**
+ * Creates the client-facing configuration and removes private values at every
+ * nesting level. `customFilter` is an allow-list predicate: returning false
+ * removes that key.
+ */
+declare function sanitizeAdminConfig<TLocale extends string = string, TMeta extends Record<string, unknown> = Record<string, unknown>>(admin: AdminRallyConfig<TLocale, TMeta>, customFilter?: (key: string, value: unknown) => boolean): PublicRallyConfig<TLocale, TMeta>;
+interface PublicConfigSafety {
+    readonly safe: boolean;
+    readonly leakedKeys: string[];
+}
+/** Finds private keys, including keys nested in metadata or custom values. */
+declare function validatePublicConfigSafety(publicConfig: PublicRallyConfig): PublicConfigSafety;
+
 type VerificationContext = {
     readonly type: "qr";
     readonly token: string;
@@ -332,6 +347,77 @@ interface ProcessStampValue {
 }
 declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
 
+type OfflineOperation = {
+    readonly kind: "checkIn";
+    readonly request: CheckInRequest;
+} | {
+    readonly kind: "claimReward";
+    readonly request: ClaimRequest;
+};
+type OfflineResult = CheckInResult | ClaimResult | UserRallyState;
+type SyncState = "idle" | "syncing" | "error";
+type SyncConflictPolicy = "server_wins" | "merge";
+interface OfflineConflictResult {
+    readonly conflict: true;
+    readonly localState: UserRallyState;
+    readonly serverState: UserRallyState;
+}
+interface OfflineQueueStorage {
+    load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
+    save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+}
+interface OfflineQueueOptions {
+    readonly storage?: OfflineQueueStorage;
+    readonly storageLike?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+        removeItem?(key: string): void;
+    } | null;
+    readonly key?: string;
+    readonly databaseName?: string;
+    readonly conflictPolicy?: SyncConflictPolicy;
+    readonly onSyncConflict?: SyncConflictPolicy | ((context: OfflineConflict) => SyncConflictPolicy | Promise<SyncConflictPolicy>);
+}
+interface OfflineConflict {
+    readonly operation: OfflineOperation;
+    readonly localState: UserRallyState;
+    readonly serverState: UserRallyState;
+}
+type OfflineSender = (operation: OfflineOperation) => Promise<OfflineResult | OfflineConflictResult>;
+declare class MemoryQueueStorage implements OfflineQueueStorage {
+    #private;
+    load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
+    save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+}
+interface IndexedDBOfflineQueueOptions {
+    readonly indexedDB?: IDBFactory | null;
+    readonly databaseName?: string;
+}
+declare class IndexedDBOfflineQueueStorage implements OfflineQueueStorage {
+    #private;
+    constructor(options?: IndexedDBOfflineQueueOptions);
+    load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
+    save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+}
+/** Durable, sequential retry queue for operations created while disconnected. */
+declare class OfflineQueue {
+    #private;
+    constructor(options?: OfflineQueueOptions);
+    get syncState(): SyncState;
+    get pendingCount(): number;
+    get error(): Error | null;
+    get operations(): ReadonlyArray<OfflineOperation>;
+    initialize(): Promise<void>;
+    setSender(sender: OfflineSender): void;
+    enqueue(operation: OfflineOperation): Promise<void>;
+    enqueueCheckIn(request: CheckInRequest): Promise<void>;
+    enqueueClaimReward(request: ClaimRequest): Promise<void>;
+    clear(): Promise<void>;
+    sync(sender?: OfflineSender | undefined): Promise<void>;
+    retrySync(sender?: OfflineSender | undefined): Promise<void>;
+    resolveConflict(operation: OfflineOperation, localState: UserRallyState, serverState: UserRallyState): Promise<void>;
+}
+
 interface StampStorage {
     load(rallyId: string, userId: string | null): Promise<StampRallyState | null>;
     save(state: StampRallyState): Promise<void>;
@@ -486,6 +572,7 @@ interface ClientOptions {
     readonly customValidators?: Readonly<Record<string, Validator>>;
     readonly clock?: () => string;
     readonly userId?: string | null;
+    readonly offlineQueue?: OfflineQueue;
 }
 type StorageOrOptions = StampStorage | ClientOptions;
 declare class StampRallyClient {
@@ -494,6 +581,8 @@ declare class StampRallyClient {
     getConfig(): RallyConfig;
     getState(): UserRallyState | null;
     getUserId(): string | null;
+    get syncState(): SyncState;
+    get pendingCount(): number;
     subscribe(listener: ClientListener): () => void;
     subscribeEvents(listener: ClientEventListener): () => void;
     init(): Promise<UserRallyState>;
@@ -504,6 +593,7 @@ declare class StampRallyClient {
     checkIn(spotId: string, proofData: unknown, options?: CheckInOptions): Promise<CheckInResult>;
     claimReward(rewardId: string, options?: ClaimOptions): Promise<ClaimResult>;
     sync(adapter?: SyncAdapter | undefined): Promise<void>;
+    retrySync(): Promise<void>;
     reset(): Promise<UserRallyState>;
     restore(state: UserRallyState): Promise<UserRallyState>;
 }
@@ -613,4 +703,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, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type NfcVerificationContext, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, 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 StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, exportProgressToken, getCurrentGeoContext, getOrderedSpots, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, safeParseAdminConfig, safeParsePublicConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, 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, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, 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 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, exportProgressToken, getCurrentGeoContext, getOrderedSpots, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, verifyPasscode, verifySecureToken, verifySnapshotToken };

package/dist/index.d.ts

@@ -123,6 +123,8 @@ interface AdminRallyConfig<TLocale extends string = string, TMeta extends Record
     readonly inventory?: Readonly<Record<string, number>>;
     readonly serverMetadata?: Readonly<Record<string, unknown>>;
     readonly metadata?: TMeta;
+    /** Explicit public metadata name. `metadata` remains supported for compatibility. */
+    readonly publicMetadata?: TMeta;
     readonly serverEndpoint?: string;
 }
 interface PublicRallyConfig<TLocale extends string = string, TMeta extends Record<string, unknown> = Record<string, unknown>> {
@@ -165,6 +167,19 @@ interface StampRallyState {
 }
 type UserRallyState = StampRallyState;
 
+/**
+ * Creates the client-facing configuration and removes private values at every
+ * nesting level. `customFilter` is an allow-list predicate: returning false
+ * removes that key.
+ */
+declare function sanitizeAdminConfig<TLocale extends string = string, TMeta extends Record<string, unknown> = Record<string, unknown>>(admin: AdminRallyConfig<TLocale, TMeta>, customFilter?: (key: string, value: unknown) => boolean): PublicRallyConfig<TLocale, TMeta>;
+interface PublicConfigSafety {
+    readonly safe: boolean;
+    readonly leakedKeys: string[];
+}
+/** Finds private keys, including keys nested in metadata or custom values. */
+declare function validatePublicConfigSafety(publicConfig: PublicRallyConfig): PublicConfigSafety;
+
 type VerificationContext = {
     readonly type: "qr";
     readonly token: string;
@@ -332,6 +347,77 @@ interface ProcessStampValue {
 }
 declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
 
+type OfflineOperation = {
+    readonly kind: "checkIn";
+    readonly request: CheckInRequest;
+} | {
+    readonly kind: "claimReward";
+    readonly request: ClaimRequest;
+};
+type OfflineResult = CheckInResult | ClaimResult | UserRallyState;
+type SyncState = "idle" | "syncing" | "error";
+type SyncConflictPolicy = "server_wins" | "merge";
+interface OfflineConflictResult {
+    readonly conflict: true;
+    readonly localState: UserRallyState;
+    readonly serverState: UserRallyState;
+}
+interface OfflineQueueStorage {
+    load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
+    save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+}
+interface OfflineQueueOptions {
+    readonly storage?: OfflineQueueStorage;
+    readonly storageLike?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+        removeItem?(key: string): void;
+    } | null;
+    readonly key?: string;
+    readonly databaseName?: string;
+    readonly conflictPolicy?: SyncConflictPolicy;
+    readonly onSyncConflict?: SyncConflictPolicy | ((context: OfflineConflict) => SyncConflictPolicy | Promise<SyncConflictPolicy>);
+}
+interface OfflineConflict {
+    readonly operation: OfflineOperation;
+    readonly localState: UserRallyState;
+    readonly serverState: UserRallyState;
+}
+type OfflineSender = (operation: OfflineOperation) => Promise<OfflineResult | OfflineConflictResult>;
+declare class MemoryQueueStorage implements OfflineQueueStorage {
+    #private;
+    load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
+    save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+}
+interface IndexedDBOfflineQueueOptions {
+    readonly indexedDB?: IDBFactory | null;
+    readonly databaseName?: string;
+}
+declare class IndexedDBOfflineQueueStorage implements OfflineQueueStorage {
+    #private;
+    constructor(options?: IndexedDBOfflineQueueOptions);
+    load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
+    save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+}
+/** Durable, sequential retry queue for operations created while disconnected. */
+declare class OfflineQueue {
+    #private;
+    constructor(options?: OfflineQueueOptions);
+    get syncState(): SyncState;
+    get pendingCount(): number;
+    get error(): Error | null;
+    get operations(): ReadonlyArray<OfflineOperation>;
+    initialize(): Promise<void>;
+    setSender(sender: OfflineSender): void;
+    enqueue(operation: OfflineOperation): Promise<void>;
+    enqueueCheckIn(request: CheckInRequest): Promise<void>;
+    enqueueClaimReward(request: ClaimRequest): Promise<void>;
+    clear(): Promise<void>;
+    sync(sender?: OfflineSender | undefined): Promise<void>;
+    retrySync(sender?: OfflineSender | undefined): Promise<void>;
+    resolveConflict(operation: OfflineOperation, localState: UserRallyState, serverState: UserRallyState): Promise<void>;
+}
+
 interface StampStorage {
     load(rallyId: string, userId: string | null): Promise<StampRallyState | null>;
     save(state: StampRallyState): Promise<void>;
@@ -486,6 +572,7 @@ interface ClientOptions {
     readonly customValidators?: Readonly<Record<string, Validator>>;
     readonly clock?: () => string;
     readonly userId?: string | null;
+    readonly offlineQueue?: OfflineQueue;
 }
 type StorageOrOptions = StampStorage | ClientOptions;
 declare class StampRallyClient {
@@ -494,6 +581,8 @@ declare class StampRallyClient {
     getConfig(): RallyConfig;
     getState(): UserRallyState | null;
     getUserId(): string | null;
+    get syncState(): SyncState;
+    get pendingCount(): number;
     subscribe(listener: ClientListener): () => void;
     subscribeEvents(listener: ClientEventListener): () => void;
     init(): Promise<UserRallyState>;
@@ -504,6 +593,7 @@ declare class StampRallyClient {
     checkIn(spotId: string, proofData: unknown, options?: CheckInOptions): Promise<CheckInResult>;
     claimReward(rewardId: string, options?: ClaimOptions): Promise<ClaimResult>;
     sync(adapter?: SyncAdapter | undefined): Promise<void>;
+    retrySync(): Promise<void>;
     reset(): Promise<UserRallyState>;
     restore(state: UserRallyState): Promise<UserRallyState>;
 }
@@ -613,4 +703,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, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type NfcVerificationContext, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, 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 StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, exportProgressToken, getCurrentGeoContext, getOrderedSpots, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, safeParseAdminConfig, safeParsePublicConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, 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, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, 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 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, exportProgressToken, getCurrentGeoContext, getOrderedSpots, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, verifyPasscode, verifySecureToken, verifySnapshotToken };