@stamprally/core 0.19.0 → 0.20.0

package/dist/index.d.cts

@@ -307,76 +307,51 @@ declare function parseAdminConfig(input: unknown): AdminRallyConfig;
 declare function safeParsePublicConfig(input: unknown): ParseResult<PublicRallyConfig>;
 declare function parsePublicConfig(input: unknown): PublicRallyConfig;
 
-declare function calculateDistanceMeters(aLat: number, aLon: number, bLat: number, bLon: number): number;
-declare function evaluateConditionDetailed(condition: CheckInCondition, context: VerificationContext): Result<ConditionMatch, ConditionMismatch>;
-declare function evaluateCondition(condition: CheckInCondition, context: VerificationContext): boolean;
-/** Derives a viewer-safe spot status without changing the supplied state. */
-declare function evaluateSpotStatus(spot: Pick<SpotItem, "id" | "prerequisites">, state: Pick<UserRallyState, "records">, options?: {
-    readonly verifying?: boolean;
-}): SpotStatus;
-declare const getSpotStatus: typeof evaluateSpotStatus;
-
-declare function getOrderedSpots<TLocale extends string, TMeta extends Record<string, unknown>>(spots: ReadonlyArray<SpotItem<TLocale, TMeta>>): ReadonlyArray<SpotItem<TLocale, TMeta>>;
-
-interface StampRallyProgress {
-    readonly acquired: number;
-    readonly total: number;
-    readonly percentage: number;
-    readonly isCompleted: boolean;
-    readonly nextAvailableSpots: ReadonlyArray<PublicSpotItem>;
-}
-declare function calculateProgress(state: StampRallyState, config: RallyConfig): StampRallyProgress;
-
-interface ClaimTicketOptions {
-    readonly issuedAt?: string;
-    readonly sequence?: number;
-}
-declare function createClaimTicketNumber(rewardId: string, options?: ClaimTicketOptions): string;
-/** Creates a one-time ticket for a successful reward consumption. */
-declare function createUniqueClaimTicketNumber(rewardId: string, issuedAt: string): string;
-declare function issueClaimTicketNumber(reward: Reward, currentState: RewardState, options?: ClaimTicketOptions): RewardState;
-
-type ConflictResolutionPolicy = "authoritative_replay";
-/** Uses the server snapshot as the immutable replay baseline. */
-declare function resolveRallyStateConflict(serverState: UserRallyState, _localState: UserRallyState): UserRallyState;
-
-type RewardConsumeError = {
-    readonly code: "NOT_AVAILABLE" | "ALREADY_CONSUMED" | "OUT_OF_STOCK" | "REWARD_NOT_FOUND";
-    readonly rewardId: string;
-} | {
-    readonly code: "INVALID_PASSCODE";
-    readonly rewardId: string;
-    readonly message: string;
+type SyncOperationAction = "CHECK_IN" | "CLAIM_REWARD";
+type SyncOperationResult = {
+    readonly operationId: string;
+    readonly status: "ACCEPTED";
+    readonly resourceId: string;
+    readonly action: SyncOperationAction;
+    readonly appliedAt: number;
 } | {
-    readonly code: "EXPIRED";
-    readonly rewardId: string;
+    readonly operationId: string;
+    readonly status: "REJECTED_PERMANENT";
+    readonly resourceId: string;
+    readonly errorCode: string;
+    readonly reason: string;
 } | {
-    readonly code: "USER_LIMIT_REACHED";
-    readonly rewardId: string;
+    readonly operationId: string;
+    readonly status: "FAILED_RETRYABLE";
+    readonly resourceId: string;
+    readonly error: string;
 };
-interface ConsumeRewardParams {
-    readonly reward: Reward;
-    readonly currentState: RewardState;
-    readonly inputPasscode?: string;
-    readonly staffId?: string;
-    readonly now: string;
-    readonly userRedemptionCount?: number;
+interface SyncProgressResponse {
+    readonly results: ReadonlyArray<SyncOperationResult>;
+    readonly currentState: UserRallyState;
+    readonly syncTimestamp: number;
 }
-type ConsumeResult = Result<RewardState, RewardConsumeError>;
-declare function reconcileRewardStates(rewards: ReadonlyArray<Reward>, currentStates: ReadonlyArray<RewardState>, acquiredStampCount: number, now: string): ReadonlyArray<RewardState>;
-declare function consumeReward(params: ConsumeRewardParams): ConsumeResult;
-interface ProcessStampValue {
-    readonly nextState: StampRallyState;
-    readonly events: ReadonlyArray<{
-        readonly type: "stampAcquired";
-        readonly record: StampRecord;
-    }>;
+interface RebuildUserStateOptions {
+    readonly baseline: UserRallyState;
+    readonly operations: ReadonlyArray<OfflineOperation>;
+    readonly config?: AdminRallyConfig | PublicRallyConfig;
 }
-declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
+interface RebuildUserStateResult {
+    readonly state: UserRallyState;
+    readonly rejectedOperationIds: ReadonlyArray<string>;
+}
+/** Replays the durable operation log on top of a server-confirmed baseline. */
+declare function rebuildUserStateFromLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): UserRallyState;
+declare function rebuildUserStateFromLog(options: RebuildUserStateOptions): UserRallyState;
+declare function rebuildUserStateLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): RebuildUserStateResult;
 
 type QueueOperationStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED_PERMANENT" | "FAILED_RETRYABLE";
-type OfflineQueueCapability = "indexeddb" | "localstorage" | "memory" | "custom";
-type OfflineStorageCapability = OfflineQueueCapability | "volatile_single_tab";
+type OfflineStorageCapability = "indexeddb" | "localstorage" | "memory" | "custom" | "volatile_single_tab";
+type MultiTabSyncCapability = "supported_web_locks" | "disabled_unsafe_environment";
+interface OfflineQueueCapability {
+    readonly storage: OfflineStorageCapability;
+    readonly multiTabSync: MultiTabSyncCapability;
+}
 type OfflineOperation = {
     readonly kind: "checkIn";
     readonly request: CheckInRequest;
@@ -407,6 +382,7 @@ interface OfflineQueueStorage {
 interface OfflineQueueCapabilityWarning {
     readonly type: "STORAGE_CAPABILITY_WARNING";
     readonly storageCapability: "volatile_single_tab" | "memory";
+    readonly multiTabSync: "disabled_unsafe_environment";
     readonly isStoragePersistent: boolean;
     readonly message: string;
 }
@@ -533,7 +509,76 @@ declare class OfflineQueue {
     clearRejectedHistory(): Promise<void>;
     sync(sender?: OfflineSender | undefined): Promise<void>;
     retrySync(sender?: OfflineSender | undefined): Promise<void>;
+    /** Applies a server-side batch response while preserving retryable operations. */
+    applySyncProgress(response: SyncProgressResponse): Promise<void>;
+}
+
+declare function calculateDistanceMeters(aLat: number, aLon: number, bLat: number, bLon: number): number;
+declare function evaluateConditionDetailed(condition: CheckInCondition, context: VerificationContext): Result<ConditionMatch, ConditionMismatch>;
+declare function evaluateCondition(condition: CheckInCondition, context: VerificationContext): boolean;
+/** Derives a viewer-safe spot status without changing the supplied state. */
+declare function evaluateSpotStatus(spot: Pick<SpotItem, "id" | "prerequisites">, state: Pick<UserRallyState, "records">, options?: {
+    readonly verifying?: boolean;
+}): SpotStatus;
+declare const getSpotStatus: typeof evaluateSpotStatus;
+
+declare function getOrderedSpots<TLocale extends string, TMeta extends Record<string, unknown>>(spots: ReadonlyArray<SpotItem<TLocale, TMeta>>): ReadonlyArray<SpotItem<TLocale, TMeta>>;
+
+interface StampRallyProgress {
+    readonly acquired: number;
+    readonly total: number;
+    readonly percentage: number;
+    readonly isCompleted: boolean;
+    readonly nextAvailableSpots: ReadonlyArray<PublicSpotItem>;
 }
+declare function calculateProgress(state: StampRallyState, config: RallyConfig): StampRallyProgress;
+
+interface ClaimTicketOptions {
+    readonly issuedAt?: string;
+    readonly sequence?: number;
+}
+declare function createClaimTicketNumber(rewardId: string, options?: ClaimTicketOptions): string;
+/** Creates a one-time ticket for a successful reward consumption. */
+declare function createUniqueClaimTicketNumber(rewardId: string, issuedAt: string): string;
+declare function issueClaimTicketNumber(reward: Reward, currentState: RewardState, options?: ClaimTicketOptions): RewardState;
+
+type ConflictResolutionPolicy = "authoritative_replay";
+/** Uses the server snapshot as the immutable replay baseline. */
+declare function resolveRallyStateConflict(serverState: UserRallyState, _localState: UserRallyState): UserRallyState;
+
+type RewardConsumeError = {
+    readonly code: "NOT_AVAILABLE" | "ALREADY_CONSUMED" | "OUT_OF_STOCK" | "REWARD_NOT_FOUND";
+    readonly rewardId: string;
+} | {
+    readonly code: "INVALID_PASSCODE";
+    readonly rewardId: string;
+    readonly message: string;
+} | {
+    readonly code: "EXPIRED";
+    readonly rewardId: string;
+} | {
+    readonly code: "USER_LIMIT_REACHED";
+    readonly rewardId: string;
+};
+interface ConsumeRewardParams {
+    readonly reward: Reward;
+    readonly currentState: RewardState;
+    readonly inputPasscode?: string;
+    readonly staffId?: string;
+    readonly now: string;
+    readonly userRedemptionCount?: number;
+}
+type ConsumeResult = Result<RewardState, RewardConsumeError>;
+declare function reconcileRewardStates(rewards: ReadonlyArray<Reward>, currentStates: ReadonlyArray<RewardState>, acquiredStampCount: number, now: string): ReadonlyArray<RewardState>;
+declare function consumeReward(params: ConsumeRewardParams): ConsumeResult;
+interface ProcessStampValue {
+    readonly nextState: StampRallyState;
+    readonly events: ReadonlyArray<{
+        readonly type: "stampAcquired";
+        readonly record: StampRecord;
+    }>;
+}
+declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
 
 interface StampStorage {
     load(rallyId: string, userId: string | null): Promise<StampRallyState | null>;
@@ -712,7 +757,8 @@ interface SyncAdapter {
         readonly userId: string | null;
         readonly state: UserRallyState;
         readonly anonymousSessionId?: string;
-    }) => Promise<UserRallyState>;
+        readonly operations?: ReadonlyArray<OfflineOperation>;
+    }) => Promise<UserRallyState | SyncProgressResponse>;
 }
 interface ClientOptions {
     readonly storage?: StampStorage;
@@ -760,20 +806,6 @@ declare class StampRallyClient {
     restore(state: UserRallyState): Promise<UserRallyState>;
 }
 
-interface RebuildUserStateOptions {
-    readonly baseline: UserRallyState;
-    readonly operations: ReadonlyArray<OfflineOperation>;
-    readonly config?: AdminRallyConfig | PublicRallyConfig;
-}
-interface RebuildUserStateResult {
-    readonly state: UserRallyState;
-    readonly rejectedOperationIds: ReadonlyArray<string>;
-}
-/** Replays the durable operation log on top of a server-confirmed baseline. */
-declare function rebuildUserStateFromLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): UserRallyState;
-declare function rebuildUserStateFromLog(options: RebuildUserStateOptions): UserRallyState;
-declare function rebuildUserStateLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): RebuildUserStateResult;
-
 type SecureTokenSecretKey = string | Uint8Array;
 interface SecureTokenOptions {
     readonly encrypt?: boolean;
@@ -879,4 +911,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 ConflictResolutionPolicy, 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 NfcDetectorOptions, type NfcVerificationContext, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationLifecycleStatus, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueCapability, type OfflineQueueCapabilityWarning, type OfflineQueueChangeListener, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineStorageCapability, 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 RebuildUserStateOptions, type RebuildUserStateResult, 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 SyncEventListener, type SyncLifecycleEvent, 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, rebuildUserStateFromLog, rebuildUserStateLog, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, rollbackOptimisticOperation, 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 ConflictResolutionPolicy, 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 MultiTabSyncCapability, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationLifecycleStatus, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueCapability, type OfflineQueueCapabilityWarning, type OfflineQueueChangeListener, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineStorageCapability, 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 RebuildUserStateOptions, type RebuildUserStateResult, 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 SyncEventListener, type SyncLifecycleEvent, type SyncOperationAction, type SyncOperationResult, type SyncProgressResponse, 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, rebuildUserStateFromLog, rebuildUserStateLog, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, rollbackOptimisticOperation, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, validateRallyConfigRelations, verifyPasscode, verifySecureToken, verifySnapshotToken };

package/dist/index.d.ts

@@ -307,76 +307,51 @@ declare function parseAdminConfig(input: unknown): AdminRallyConfig;
 declare function safeParsePublicConfig(input: unknown): ParseResult<PublicRallyConfig>;
 declare function parsePublicConfig(input: unknown): PublicRallyConfig;
 
-declare function calculateDistanceMeters(aLat: number, aLon: number, bLat: number, bLon: number): number;
-declare function evaluateConditionDetailed(condition: CheckInCondition, context: VerificationContext): Result<ConditionMatch, ConditionMismatch>;
-declare function evaluateCondition(condition: CheckInCondition, context: VerificationContext): boolean;
-/** Derives a viewer-safe spot status without changing the supplied state. */
-declare function evaluateSpotStatus(spot: Pick<SpotItem, "id" | "prerequisites">, state: Pick<UserRallyState, "records">, options?: {
-    readonly verifying?: boolean;
-}): SpotStatus;
-declare const getSpotStatus: typeof evaluateSpotStatus;
-
-declare function getOrderedSpots<TLocale extends string, TMeta extends Record<string, unknown>>(spots: ReadonlyArray<SpotItem<TLocale, TMeta>>): ReadonlyArray<SpotItem<TLocale, TMeta>>;
-
-interface StampRallyProgress {
-    readonly acquired: number;
-    readonly total: number;
-    readonly percentage: number;
-    readonly isCompleted: boolean;
-    readonly nextAvailableSpots: ReadonlyArray<PublicSpotItem>;
-}
-declare function calculateProgress(state: StampRallyState, config: RallyConfig): StampRallyProgress;
-
-interface ClaimTicketOptions {
-    readonly issuedAt?: string;
-    readonly sequence?: number;
-}
-declare function createClaimTicketNumber(rewardId: string, options?: ClaimTicketOptions): string;
-/** Creates a one-time ticket for a successful reward consumption. */
-declare function createUniqueClaimTicketNumber(rewardId: string, issuedAt: string): string;
-declare function issueClaimTicketNumber(reward: Reward, currentState: RewardState, options?: ClaimTicketOptions): RewardState;
-
-type ConflictResolutionPolicy = "authoritative_replay";
-/** Uses the server snapshot as the immutable replay baseline. */
-declare function resolveRallyStateConflict(serverState: UserRallyState, _localState: UserRallyState): UserRallyState;
-
-type RewardConsumeError = {
-    readonly code: "NOT_AVAILABLE" | "ALREADY_CONSUMED" | "OUT_OF_STOCK" | "REWARD_NOT_FOUND";
-    readonly rewardId: string;
-} | {
-    readonly code: "INVALID_PASSCODE";
-    readonly rewardId: string;
-    readonly message: string;
+type SyncOperationAction = "CHECK_IN" | "CLAIM_REWARD";
+type SyncOperationResult = {
+    readonly operationId: string;
+    readonly status: "ACCEPTED";
+    readonly resourceId: string;
+    readonly action: SyncOperationAction;
+    readonly appliedAt: number;
 } | {
-    readonly code: "EXPIRED";
-    readonly rewardId: string;
+    readonly operationId: string;
+    readonly status: "REJECTED_PERMANENT";
+    readonly resourceId: string;
+    readonly errorCode: string;
+    readonly reason: string;
 } | {
-    readonly code: "USER_LIMIT_REACHED";
-    readonly rewardId: string;
+    readonly operationId: string;
+    readonly status: "FAILED_RETRYABLE";
+    readonly resourceId: string;
+    readonly error: string;
 };
-interface ConsumeRewardParams {
-    readonly reward: Reward;
-    readonly currentState: RewardState;
-    readonly inputPasscode?: string;
-    readonly staffId?: string;
-    readonly now: string;
-    readonly userRedemptionCount?: number;
+interface SyncProgressResponse {
+    readonly results: ReadonlyArray<SyncOperationResult>;
+    readonly currentState: UserRallyState;
+    readonly syncTimestamp: number;
 }
-type ConsumeResult = Result<RewardState, RewardConsumeError>;
-declare function reconcileRewardStates(rewards: ReadonlyArray<Reward>, currentStates: ReadonlyArray<RewardState>, acquiredStampCount: number, now: string): ReadonlyArray<RewardState>;
-declare function consumeReward(params: ConsumeRewardParams): ConsumeResult;
-interface ProcessStampValue {
-    readonly nextState: StampRallyState;
-    readonly events: ReadonlyArray<{
-        readonly type: "stampAcquired";
-        readonly record: StampRecord;
-    }>;
+interface RebuildUserStateOptions {
+    readonly baseline: UserRallyState;
+    readonly operations: ReadonlyArray<OfflineOperation>;
+    readonly config?: AdminRallyConfig | PublicRallyConfig;
 }
-declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
+interface RebuildUserStateResult {
+    readonly state: UserRallyState;
+    readonly rejectedOperationIds: ReadonlyArray<string>;
+}
+/** Replays the durable operation log on top of a server-confirmed baseline. */
+declare function rebuildUserStateFromLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): UserRallyState;
+declare function rebuildUserStateFromLog(options: RebuildUserStateOptions): UserRallyState;
+declare function rebuildUserStateLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): RebuildUserStateResult;
 
 type QueueOperationStatus = "PENDING" | "IN_FLIGHT" | "ACCEPTED" | "REJECTED_PERMANENT" | "FAILED_RETRYABLE";
-type OfflineQueueCapability = "indexeddb" | "localstorage" | "memory" | "custom";
-type OfflineStorageCapability = OfflineQueueCapability | "volatile_single_tab";
+type OfflineStorageCapability = "indexeddb" | "localstorage" | "memory" | "custom" | "volatile_single_tab";
+type MultiTabSyncCapability = "supported_web_locks" | "disabled_unsafe_environment";
+interface OfflineQueueCapability {
+    readonly storage: OfflineStorageCapability;
+    readonly multiTabSync: MultiTabSyncCapability;
+}
 type OfflineOperation = {
     readonly kind: "checkIn";
     readonly request: CheckInRequest;
@@ -407,6 +382,7 @@ interface OfflineQueueStorage {
 interface OfflineQueueCapabilityWarning {
     readonly type: "STORAGE_CAPABILITY_WARNING";
     readonly storageCapability: "volatile_single_tab" | "memory";
+    readonly multiTabSync: "disabled_unsafe_environment";
     readonly isStoragePersistent: boolean;
     readonly message: string;
 }
@@ -533,7 +509,76 @@ declare class OfflineQueue {
     clearRejectedHistory(): Promise<void>;
     sync(sender?: OfflineSender | undefined): Promise<void>;
     retrySync(sender?: OfflineSender | undefined): Promise<void>;
+    /** Applies a server-side batch response while preserving retryable operations. */
+    applySyncProgress(response: SyncProgressResponse): Promise<void>;
+}
+
+declare function calculateDistanceMeters(aLat: number, aLon: number, bLat: number, bLon: number): number;
+declare function evaluateConditionDetailed(condition: CheckInCondition, context: VerificationContext): Result<ConditionMatch, ConditionMismatch>;
+declare function evaluateCondition(condition: CheckInCondition, context: VerificationContext): boolean;
+/** Derives a viewer-safe spot status without changing the supplied state. */
+declare function evaluateSpotStatus(spot: Pick<SpotItem, "id" | "prerequisites">, state: Pick<UserRallyState, "records">, options?: {
+    readonly verifying?: boolean;
+}): SpotStatus;
+declare const getSpotStatus: typeof evaluateSpotStatus;
+
+declare function getOrderedSpots<TLocale extends string, TMeta extends Record<string, unknown>>(spots: ReadonlyArray<SpotItem<TLocale, TMeta>>): ReadonlyArray<SpotItem<TLocale, TMeta>>;
+
+interface StampRallyProgress {
+    readonly acquired: number;
+    readonly total: number;
+    readonly percentage: number;
+    readonly isCompleted: boolean;
+    readonly nextAvailableSpots: ReadonlyArray<PublicSpotItem>;
 }
+declare function calculateProgress(state: StampRallyState, config: RallyConfig): StampRallyProgress;
+
+interface ClaimTicketOptions {
+    readonly issuedAt?: string;
+    readonly sequence?: number;
+}
+declare function createClaimTicketNumber(rewardId: string, options?: ClaimTicketOptions): string;
+/** Creates a one-time ticket for a successful reward consumption. */
+declare function createUniqueClaimTicketNumber(rewardId: string, issuedAt: string): string;
+declare function issueClaimTicketNumber(reward: Reward, currentState: RewardState, options?: ClaimTicketOptions): RewardState;
+
+type ConflictResolutionPolicy = "authoritative_replay";
+/** Uses the server snapshot as the immutable replay baseline. */
+declare function resolveRallyStateConflict(serverState: UserRallyState, _localState: UserRallyState): UserRallyState;
+
+type RewardConsumeError = {
+    readonly code: "NOT_AVAILABLE" | "ALREADY_CONSUMED" | "OUT_OF_STOCK" | "REWARD_NOT_FOUND";
+    readonly rewardId: string;
+} | {
+    readonly code: "INVALID_PASSCODE";
+    readonly rewardId: string;
+    readonly message: string;
+} | {
+    readonly code: "EXPIRED";
+    readonly rewardId: string;
+} | {
+    readonly code: "USER_LIMIT_REACHED";
+    readonly rewardId: string;
+};
+interface ConsumeRewardParams {
+    readonly reward: Reward;
+    readonly currentState: RewardState;
+    readonly inputPasscode?: string;
+    readonly staffId?: string;
+    readonly now: string;
+    readonly userRedemptionCount?: number;
+}
+type ConsumeResult = Result<RewardState, RewardConsumeError>;
+declare function reconcileRewardStates(rewards: ReadonlyArray<Reward>, currentStates: ReadonlyArray<RewardState>, acquiredStampCount: number, now: string): ReadonlyArray<RewardState>;
+declare function consumeReward(params: ConsumeRewardParams): ConsumeResult;
+interface ProcessStampValue {
+    readonly nextState: StampRallyState;
+    readonly events: ReadonlyArray<{
+        readonly type: "stampAcquired";
+        readonly record: StampRecord;
+    }>;
+}
+declare function processStamp(state: StampRallyState, config: AdminRallyConfig, spotId: string, context: VerificationContext, now: string): Result<ProcessStampValue, StampError>;
 
 interface StampStorage {
     load(rallyId: string, userId: string | null): Promise<StampRallyState | null>;
@@ -712,7 +757,8 @@ interface SyncAdapter {
         readonly userId: string | null;
         readonly state: UserRallyState;
         readonly anonymousSessionId?: string;
-    }) => Promise<UserRallyState>;
+        readonly operations?: ReadonlyArray<OfflineOperation>;
+    }) => Promise<UserRallyState | SyncProgressResponse>;
 }
 interface ClientOptions {
     readonly storage?: StampStorage;
@@ -760,20 +806,6 @@ declare class StampRallyClient {
     restore(state: UserRallyState): Promise<UserRallyState>;
 }
 
-interface RebuildUserStateOptions {
-    readonly baseline: UserRallyState;
-    readonly operations: ReadonlyArray<OfflineOperation>;
-    readonly config?: AdminRallyConfig | PublicRallyConfig;
-}
-interface RebuildUserStateResult {
-    readonly state: UserRallyState;
-    readonly rejectedOperationIds: ReadonlyArray<string>;
-}
-/** Replays the durable operation log on top of a server-confirmed baseline. */
-declare function rebuildUserStateFromLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): UserRallyState;
-declare function rebuildUserStateFromLog(options: RebuildUserStateOptions): UserRallyState;
-declare function rebuildUserStateLog(baseline: UserRallyState, operations: ReadonlyArray<OfflineOperation>, config?: AdminRallyConfig | PublicRallyConfig): RebuildUserStateResult;
-
 type SecureTokenSecretKey = string | Uint8Array;
 interface SecureTokenOptions {
     readonly encrypt?: boolean;
@@ -879,4 +911,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 ConflictResolutionPolicy, 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 NfcDetectorOptions, type NfcVerificationContext, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationLifecycleStatus, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueCapability, type OfflineQueueCapabilityWarning, type OfflineQueueChangeListener, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineStorageCapability, 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 RebuildUserStateOptions, type RebuildUserStateResult, 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 SyncEventListener, type SyncLifecycleEvent, 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, rebuildUserStateFromLog, rebuildUserStateLog, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, rollbackOptimisticOperation, 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 ConflictResolutionPolicy, 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 MultiTabSyncCapability, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationLifecycleStatus, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueCapability, type OfflineQueueCapabilityWarning, type OfflineQueueChangeListener, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineStorageCapability, 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 RebuildUserStateOptions, type RebuildUserStateResult, 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 SyncEventListener, type SyncLifecycleEvent, type SyncOperationAction, type SyncOperationResult, type SyncProgressResponse, 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, rebuildUserStateFromLog, rebuildUserStateLog, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, rollbackOptimisticOperation, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, validateRallyConfigRelations, verifyPasscode, verifySecureToken, verifySnapshotToken };