@stamprally/core 0.14.0 → 0.16.0

package/dist/index.d.cts

@@ -97,6 +97,13 @@ 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>;
@@ -121,7 +128,7 @@ 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>>;
@@ -167,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;
@@ -364,12 +372,18 @@ interface ProcessStampValue {
 }
 declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
 
+type QueueOperationStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED_PERMANENT" | "FAILED_RETRYABLE";
+type OfflineQueueCapability = "indexeddb" | "localstorage" | "memory" | "custom";
 type OfflineOperation = {
     readonly kind: "checkIn";
     readonly request: CheckInRequest;
+    readonly status?: QueueOperationStatus;
+    readonly attempts?: number;
 } | {
     readonly kind: "claimReward";
     readonly request: ClaimRequest;
+    readonly status?: QueueOperationStatus;
+    readonly attempts?: number;
 };
 type OfflineResult = CheckInResult | ClaimResult | UserRallyState;
 type SyncState = "idle" | "syncing" | "error";
@@ -382,6 +396,8 @@ interface OfflineConflictResult {
 interface OfflineQueueStorage {
     load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
     save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+    loadRejectedHistory?(key: string): Promise<ReadonlyArray<RejectedOperationHistoryEntry>>;
+    saveRejectedHistory?(key: string, history: ReadonlyArray<RejectedOperationHistoryEntry>): Promise<void>;
 }
 interface OfflineQueueOptions {
     readonly storage?: OfflineQueueStorage;
@@ -400,6 +416,15 @@ interface OfflineQueueOptions {
     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;
@@ -407,12 +432,21 @@ interface OfflineConflict {
     readonly serverState: UserRallyState;
 }
 type OfflineSender = (operation: OfflineOperation) => Promise<OfflineResult | OfflineConflictResult | OfflineOperationResponse>;
-type OfflineOperationStatus = "ACCEPTED" | "REJECTED_PERMANENT" | "RETRYABLE_ERROR";
+type OfflineOperationStatus = QueueOperationStatus | "REJECTED" | "RETRYABLE_ERROR";
+type OfflineOperationLifecycleStatus = QueueOperationStatus;
 interface OfflineOperationError {
     readonly code: string;
     readonly message: string;
     readonly [key: string]: unknown;
 }
+interface RejectedOperationHistoryEntry {
+    readonly operation: OfflineOperation;
+    readonly reason: OfflineOperationError;
+    readonly errorCode: string;
+    readonly rejectedAt: string;
+    readonly attempts: number;
+}
+type RejectedOperation = RejectedOperationHistoryEntry;
 type OfflineOperationResponse = {
     readonly status: "ACCEPTED";
     readonly result?: OfflineResult | OfflineConflictResult;
@@ -439,6 +473,8 @@ declare class MemoryQueueStorage implements OfflineQueueStorage {
     #private;
     load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
     save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+    loadRejectedHistory(key: string): Promise<ReadonlyArray<RejectedOperationHistoryEntry>>;
+    saveRejectedHistory(key: string, history: ReadonlyArray<RejectedOperationHistoryEntry>): Promise<void>;
 }
 interface IndexedDBOfflineQueueOptions {
     readonly indexedDB?: IDBFactory | null;
@@ -449,13 +485,18 @@ declare class IndexedDBOfflineQueueStorage implements OfflineQueueStorage {
     constructor(options?: IndexedDBOfflineQueueOptions);
     load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
     save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+    loadRejectedHistory(key: string): Promise<ReadonlyArray<RejectedOperationHistoryEntry>>;
+    saveRejectedHistory(key: string, history: ReadonlyArray<RejectedOperationHistoryEntry>): Promise<void>;
 }
+declare function offlineOperationId(operation: OfflineOperation): string;
 /** Durable, sequential retry queue for operations created while disconnected. */
 declare class OfflineQueue {
     #private;
     constructor(options?: OfflineQueueOptions);
     get syncState(): SyncState;
     get pendingCount(): number;
+    get queueCapability(): OfflineQueueCapability;
+    get rejectedHistory(): ReadonlyArray<RejectedOperationHistoryEntry>;
     get error(): Error | null;
     get operations(): ReadonlyArray<OfflineOperation>;
     get conflictPolicy(): SyncConflictPolicy;
@@ -474,6 +515,11 @@ declare class OfflineQueue {
     enqueueCheckIn(request: CheckInRequest): Promise<void>;
     enqueueClaimReward(request: ClaimRequest): Promise<void>;
     clear(): Promise<void>;
+    discardRejected(operationId: string): Promise<boolean>;
+    retryRejected(operationId: string): Promise<boolean>;
+    discardRejectedOperation(operationId: string): Promise<boolean>;
+    retryRejectedOperation(operationId: string): Promise<boolean>;
+    clearRejectedHistory(): Promise<void>;
     sync(sender?: OfflineSender | undefined): Promise<void>;
     retrySync(sender?: OfflineSender | undefined): Promise<void>;
     resolveConflict(operation: OfflineOperation, localState: UserRallyState, serverState: UserRallyState): Promise<UserRallyState>;
@@ -519,6 +565,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;
@@ -607,6 +654,7 @@ interface CheckInRequest {
     readonly idempotencyKey: string;
     readonly now: string;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface ClaimRequest {
     readonly rallyId: string;
@@ -616,6 +664,7 @@ interface ClaimRequest {
     readonly now: string;
     readonly options: ClaimOptions;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface SyncAdapter {
     readonly checkIn?: (request: CheckInRequest) => Promise<CheckInResult>;
@@ -624,6 +673,7 @@ interface SyncAdapter {
         readonly rallyId: string;
         readonly userId: string | null;
         readonly state: UserRallyState;
+        readonly anonymousSessionId?: string;
     }) => Promise<UserRallyState>;
 }
 interface ClientOptions {
@@ -633,6 +683,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;
@@ -642,8 +693,13 @@ declare class StampRallyClient {
     getConfig(): RallyConfig;
     getState(): UserRallyState | null;
     getUserId(): string | null;
+    getAnonymousSessionId(): string;
     get syncState(): SyncState;
     get pendingCount(): number;
+    get rejectedHistory(): ReadonlyArray<RejectedOperationHistoryEntry>;
+    get queueCapability(): OfflineQueueCapability;
+    discardRejected(operationId: string): Promise<boolean>;
+    retryRejected(operationId: string): Promise<boolean>;
     subscribe(listener: ClientListener): () => void;
     subscribeEvents(listener: ClientEventListener): () => void;
     init(): Promise<UserRallyState>;
@@ -764,4 +820,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, 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 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, validateRallyConfigRelations, 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 OfflineQueueCapability, 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 QueueOperationStatus, type RallyConfig, type RallyInventory, type RallyInventoryState, type RallySnapshot, type RedemptionMethod, type RejectedOperation, type RejectedOperationHistoryEntry, 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, offlineOperationId, 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

@@ -97,6 +97,13 @@ 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>;
@@ -121,7 +128,7 @@ 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>>;
@@ -167,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;
@@ -364,12 +372,18 @@ interface ProcessStampValue {
 }
 declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
 
+type QueueOperationStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED_PERMANENT" | "FAILED_RETRYABLE";
+type OfflineQueueCapability = "indexeddb" | "localstorage" | "memory" | "custom";
 type OfflineOperation = {
     readonly kind: "checkIn";
     readonly request: CheckInRequest;
+    readonly status?: QueueOperationStatus;
+    readonly attempts?: number;
 } | {
     readonly kind: "claimReward";
     readonly request: ClaimRequest;
+    readonly status?: QueueOperationStatus;
+    readonly attempts?: number;
 };
 type OfflineResult = CheckInResult | ClaimResult | UserRallyState;
 type SyncState = "idle" | "syncing" | "error";
@@ -382,6 +396,8 @@ interface OfflineConflictResult {
 interface OfflineQueueStorage {
     load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
     save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+    loadRejectedHistory?(key: string): Promise<ReadonlyArray<RejectedOperationHistoryEntry>>;
+    saveRejectedHistory?(key: string, history: ReadonlyArray<RejectedOperationHistoryEntry>): Promise<void>;
 }
 interface OfflineQueueOptions {
     readonly storage?: OfflineQueueStorage;
@@ -400,6 +416,15 @@ interface OfflineQueueOptions {
     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;
@@ -407,12 +432,21 @@ interface OfflineConflict {
     readonly serverState: UserRallyState;
 }
 type OfflineSender = (operation: OfflineOperation) => Promise<OfflineResult | OfflineConflictResult | OfflineOperationResponse>;
-type OfflineOperationStatus = "ACCEPTED" | "REJECTED_PERMANENT" | "RETRYABLE_ERROR";
+type OfflineOperationStatus = QueueOperationStatus | "REJECTED" | "RETRYABLE_ERROR";
+type OfflineOperationLifecycleStatus = QueueOperationStatus;
 interface OfflineOperationError {
     readonly code: string;
     readonly message: string;
     readonly [key: string]: unknown;
 }
+interface RejectedOperationHistoryEntry {
+    readonly operation: OfflineOperation;
+    readonly reason: OfflineOperationError;
+    readonly errorCode: string;
+    readonly rejectedAt: string;
+    readonly attempts: number;
+}
+type RejectedOperation = RejectedOperationHistoryEntry;
 type OfflineOperationResponse = {
     readonly status: "ACCEPTED";
     readonly result?: OfflineResult | OfflineConflictResult;
@@ -439,6 +473,8 @@ declare class MemoryQueueStorage implements OfflineQueueStorage {
     #private;
     load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
     save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+    loadRejectedHistory(key: string): Promise<ReadonlyArray<RejectedOperationHistoryEntry>>;
+    saveRejectedHistory(key: string, history: ReadonlyArray<RejectedOperationHistoryEntry>): Promise<void>;
 }
 interface IndexedDBOfflineQueueOptions {
     readonly indexedDB?: IDBFactory | null;
@@ -449,13 +485,18 @@ declare class IndexedDBOfflineQueueStorage implements OfflineQueueStorage {
     constructor(options?: IndexedDBOfflineQueueOptions);
     load(key: string): Promise<ReadonlyArray<OfflineOperation>>;
     save(key: string, operations: ReadonlyArray<OfflineOperation>): Promise<void>;
+    loadRejectedHistory(key: string): Promise<ReadonlyArray<RejectedOperationHistoryEntry>>;
+    saveRejectedHistory(key: string, history: ReadonlyArray<RejectedOperationHistoryEntry>): Promise<void>;
 }
+declare function offlineOperationId(operation: OfflineOperation): string;
 /** Durable, sequential retry queue for operations created while disconnected. */
 declare class OfflineQueue {
     #private;
     constructor(options?: OfflineQueueOptions);
     get syncState(): SyncState;
     get pendingCount(): number;
+    get queueCapability(): OfflineQueueCapability;
+    get rejectedHistory(): ReadonlyArray<RejectedOperationHistoryEntry>;
     get error(): Error | null;
     get operations(): ReadonlyArray<OfflineOperation>;
     get conflictPolicy(): SyncConflictPolicy;
@@ -474,6 +515,11 @@ declare class OfflineQueue {
     enqueueCheckIn(request: CheckInRequest): Promise<void>;
     enqueueClaimReward(request: ClaimRequest): Promise<void>;
     clear(): Promise<void>;
+    discardRejected(operationId: string): Promise<boolean>;
+    retryRejected(operationId: string): Promise<boolean>;
+    discardRejectedOperation(operationId: string): Promise<boolean>;
+    retryRejectedOperation(operationId: string): Promise<boolean>;
+    clearRejectedHistory(): Promise<void>;
     sync(sender?: OfflineSender | undefined): Promise<void>;
     retrySync(sender?: OfflineSender | undefined): Promise<void>;
     resolveConflict(operation: OfflineOperation, localState: UserRallyState, serverState: UserRallyState): Promise<UserRallyState>;
@@ -519,6 +565,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;
@@ -607,6 +654,7 @@ interface CheckInRequest {
     readonly idempotencyKey: string;
     readonly now: string;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface ClaimRequest {
     readonly rallyId: string;
@@ -616,6 +664,7 @@ interface ClaimRequest {
     readonly now: string;
     readonly options: ClaimOptions;
     readonly state: UserRallyState;
+    readonly anonymousSessionId?: string;
 }
 interface SyncAdapter {
     readonly checkIn?: (request: CheckInRequest) => Promise<CheckInResult>;
@@ -624,6 +673,7 @@ interface SyncAdapter {
         readonly rallyId: string;
         readonly userId: string | null;
         readonly state: UserRallyState;
+        readonly anonymousSessionId?: string;
     }) => Promise<UserRallyState>;
 }
 interface ClientOptions {
@@ -633,6 +683,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;
@@ -642,8 +693,13 @@ declare class StampRallyClient {
     getConfig(): RallyConfig;
     getState(): UserRallyState | null;
     getUserId(): string | null;
+    getAnonymousSessionId(): string;
     get syncState(): SyncState;
     get pendingCount(): number;
+    get rejectedHistory(): ReadonlyArray<RejectedOperationHistoryEntry>;
+    get queueCapability(): OfflineQueueCapability;
+    discardRejected(operationId: string): Promise<boolean>;
+    retryRejected(operationId: string): Promise<boolean>;
     subscribe(listener: ClientListener): () => void;
     subscribeEvents(listener: ClientEventListener): () => void;
     init(): Promise<UserRallyState>;
@@ -764,4 +820,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, 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 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, validateRallyConfigRelations, 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 OfflineQueueCapability, 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 QueueOperationStatus, type RallyConfig, type RallyInventory, type RallyInventoryState, type RallySnapshot, type RedemptionMethod, type RejectedOperation, type RejectedOperationHistoryEntry, 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, offlineOperationId, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, validateRallyConfigRelations, verifyPasscode, verifySecureToken, verifySnapshotToken };