@stamprally/core 0.13.0 → 0.14.0

package/dist/index.d.cts

@@ -96,6 +96,7 @@ type RewardUnlockCondition = {
 };
 type RewardType = "digital" | "in_person";
 type RedemptionMethod = "manual_slide" | "staff_passcode" | "view_only" | "server_claim";
+type InventoryAggregationMode = "shared" | "per_reward";
 interface Reward<TLocale extends string = string> {
     readonly id: string;
     readonly title: LocalizedText<TLocale>;
@@ -121,6 +122,8 @@ interface AdminRallyConfig<TLocale extends string = string, TMeta extends Record
     readonly rewards: ReadonlyArray<Reward<TLocale>>;
     readonly staffPasscode?: string;
     readonly inventory?: Readonly<Record<string, number>>;
+    /** How the optional top-level inventory limit is aggregated. */
+    readonly inventoryMode?: InventoryAggregationMode;
     readonly serverMetadata?: Readonly<Record<string, unknown>>;
     readonly metadata?: TMeta;
     /** Explicit public metadata name. `metadata` remains supported for compatibility. */
@@ -285,6 +288,8 @@ declare class ConfigValidationError extends Error {
     readonly name = "ConfigValidationError";
     constructor(errors: ReadonlyArray<ValidationError>);
 }
+/** Validates relationships that can only be checked after all entities exist. */
+declare function validateRallyConfigRelations(config: AdminRallyConfig | PublicRallyConfig): ReadonlyArray<ValidationError>;
 declare function safeParseAdminConfig(input: unknown): ParseResult<AdminRallyConfig>;
 declare function parseAdminConfig(input: unknown): AdminRallyConfig;
 declare function safeParsePublicConfig(input: unknown): ParseResult<PublicRallyConfig>;
@@ -393,6 +398,8 @@ interface OfflineQueueOptions {
     readonly databaseName?: string;
     readonly conflictPolicy?: SyncConflictPolicy;
     readonly onSyncConflict?: SyncConflictPolicy | ((context: OfflineConflict) => SyncConflictPolicy | Promise<SyncConflictPolicy>);
+    /** Enables storage-event/BroadcastChannel synchronization when browser APIs exist. */
+    readonly synchronizeInstances?: boolean;
 }
 interface OfflineConflict {
     readonly operation: OfflineOperation;
@@ -457,6 +464,8 @@ declare class OfflineQueue {
     get userId(): string | null;
     setSyncResultListener(listener: OfflineSyncResultListener | undefined): void;
     initialize(): Promise<void>;
+    /** Releases browser listeners when the queue is no longer used. */
+    dispose(): void;
     /** Selects a rally/user queue scope and loads its pending operations. */
     setScope(rallyId: string, userId: string | null): Promise<void>;
     switchUser(newUserId: string | null): Promise<void>;
@@ -755,4 +764,4 @@ type SnapshotTokenVerification<T extends SnapshotTokenPayload = SnapshotTokenPay
 declare function createSignedSnapshotToken<T extends SnapshotTokenPayload>(payload: T, secretKey: SnapshotSecretKey): Promise<string>;
 declare function verifySnapshotToken<T extends SnapshotTokenPayload = SnapshotTokenPayload>(token: string, secretKey: SnapshotSecretKey, now?: number): Promise<SnapshotTokenVerification<T>>;
 
-export { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineSyncResultEvent, type OfflineSyncResultListener, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, type PublicConfigSafety, type PublicRallyConfig, type PublicReward, type PublicSpotItem, type QrDetectorOptions, type QrVerificationContext, type RallyConfig, type RallySnapshot, type RedemptionMethod, type Result, type Reward, type RewardConsumeError, type RewardState, type RewardStatus, type RewardType, type RewardUnlockCondition, type SecureTokenError, type SecureTokenErrorCode, type SecureTokenOptions, type SecureTokenPayload, type SecureTokenSecretKey, type SecureTokenVerification, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type SpotStatus, type StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, type SyncConflictPolicy, type SyncState, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, evaluateSpotStatus, exportProgressToken, getCurrentGeoContext, getOrderedSpots, getSpotStatus, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, verifyPasscode, verifySecureToken, verifySnapshotToken };
+export { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, type InventoryAggregationMode, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type 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 };

package/dist/index.d.ts

@@ -96,6 +96,7 @@ type RewardUnlockCondition = {
 };
 type RewardType = "digital" | "in_person";
 type RedemptionMethod = "manual_slide" | "staff_passcode" | "view_only" | "server_claim";
+type InventoryAggregationMode = "shared" | "per_reward";
 interface Reward<TLocale extends string = string> {
     readonly id: string;
     readonly title: LocalizedText<TLocale>;
@@ -121,6 +122,8 @@ interface AdminRallyConfig<TLocale extends string = string, TMeta extends Record
     readonly rewards: ReadonlyArray<Reward<TLocale>>;
     readonly staffPasscode?: string;
     readonly inventory?: Readonly<Record<string, number>>;
+    /** How the optional top-level inventory limit is aggregated. */
+    readonly inventoryMode?: InventoryAggregationMode;
     readonly serverMetadata?: Readonly<Record<string, unknown>>;
     readonly metadata?: TMeta;
     /** Explicit public metadata name. `metadata` remains supported for compatibility. */
@@ -285,6 +288,8 @@ declare class ConfigValidationError extends Error {
     readonly name = "ConfigValidationError";
     constructor(errors: ReadonlyArray<ValidationError>);
 }
+/** Validates relationships that can only be checked after all entities exist. */
+declare function validateRallyConfigRelations(config: AdminRallyConfig | PublicRallyConfig): ReadonlyArray<ValidationError>;
 declare function safeParseAdminConfig(input: unknown): ParseResult<AdminRallyConfig>;
 declare function parseAdminConfig(input: unknown): AdminRallyConfig;
 declare function safeParsePublicConfig(input: unknown): ParseResult<PublicRallyConfig>;
@@ -393,6 +398,8 @@ interface OfflineQueueOptions {
     readonly databaseName?: string;
     readonly conflictPolicy?: SyncConflictPolicy;
     readonly onSyncConflict?: SyncConflictPolicy | ((context: OfflineConflict) => SyncConflictPolicy | Promise<SyncConflictPolicy>);
+    /** Enables storage-event/BroadcastChannel synchronization when browser APIs exist. */
+    readonly synchronizeInstances?: boolean;
 }
 interface OfflineConflict {
     readonly operation: OfflineOperation;
@@ -457,6 +464,8 @@ declare class OfflineQueue {
     get userId(): string | null;
     setSyncResultListener(listener: OfflineSyncResultListener | undefined): void;
     initialize(): Promise<void>;
+    /** Releases browser listeners when the queue is no longer used. */
+    dispose(): void;
     /** Selects a rally/user queue scope and loads its pending operations. */
     setScope(rallyId: string, userId: string | null): Promise<void>;
     switchUser(newUserId: string | null): Promise<void>;
@@ -755,4 +764,4 @@ type SnapshotTokenVerification<T extends SnapshotTokenPayload = SnapshotTokenPay
 declare function createSignedSnapshotToken<T extends SnapshotTokenPayload>(payload: T, secretKey: SnapshotSecretKey): Promise<string>;
 declare function verifySnapshotToken<T extends SnapshotTokenPayload = SnapshotTokenPayload>(token: string, secretKey: SnapshotSecretKey, now?: number): Promise<SnapshotTokenVerification<T>>;
 
-export { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type OfflineOperationResponse, type OfflineOperationStatus, OfflineQueue, type OfflineQueueOptions, type OfflineQueueStorage, type OfflineResult, type OfflineSender, type OfflineSyncResultEvent, type OfflineSyncResultListener, type ParseResult, type PasscodeCondition$1 as PasscodeCondition, type ProcessStampValue, type PublicCheckInCondition, type PublicConfigSafety, type PublicRallyConfig, type PublicReward, type PublicSpotItem, type QrDetectorOptions, type QrVerificationContext, type RallyConfig, type RallySnapshot, type RedemptionMethod, type Result, type Reward, type RewardConsumeError, type RewardState, type RewardStatus, type RewardType, type RewardUnlockCondition, type SecureTokenError, type SecureTokenErrorCode, type SecureTokenOptions, type SecureTokenPayload, type SecureTokenSecretKey, type SecureTokenVerification, type SheetTheme, type SlotShape, type SnapshotSecretKey, type SnapshotTokenError, type SnapshotTokenErrorCode, type SnapshotTokenPayload, type SnapshotTokenVerification, type SpotItem, type SpotStatus, type StampError, StampRallyClient, type StampRallyProgress, type StampRallyState, type StampRecord, type StampStorage, StorageAdapterError, type StorageAdapterErrorCode, type StorageLike, type StorageOperation, type StorageWarningHandler, type SupportedLocale, type SyncAdapter, type SyncConflictPolicy, type SyncState, THEME_PRESETS, type ThemePreset, type ThemePresetId, type UserRallyState, type ValidationError, type Validator, type VerificationContext, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, evaluateSpotStatus, exportProgressToken, getCurrentGeoContext, getOrderedSpots, getSpotStatus, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, verifyPasscode, verifySecureToken, verifySnapshotToken };
+export { type AdminRallyConfig, type CheckInCondition, type CheckInOptions, type CheckInRequest, type CheckInResult, type CheckInSuccess, type ClaimOptions, type ClaimRequest, type ClaimResult, type ClaimSuccess, type ClaimTicketOptions, type ClientError, type ClientEvent, type ClientEventListener, type ClientListener, type ClientOptions, type CompositeConditionFailure, type ConditionMatch, type ConditionMismatch, ConfigValidationError, type ConsumeResult, type ConsumeRewardParams, type CustomValidationContext, type CustomValidator, DEFAULT_SHEET_THEME, type DetectorError, type DetectorErrorCode, type DetectorKind, type DetectorResult, type ExternalReference, type FontFamily, type GeoDetectorOptions, type GeoVerificationContext, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, type IndexedDBAdapterOptions, type IndexedDBOfflineQueueOptions, IndexedDBOfflineQueueStorage, type InventoryAggregationMode, LocalStorageAdapter, type LocalStorageAdapterOptions, type LocalStorageFailureMode, type LocaleDictionary, type LocalizedString, type LocalizedText, type MergeConflictOptions, type NfcDetectorOptions, type NfcVerificationContext, type OfflineConflict, type OfflineConflictResult, type OfflineOperation, type OfflineOperationError, type 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 };

package/dist/index.js

@@ -59,7 +59,9 @@ function calculateProgress(state, config) {
   const acquired = new Set(
     state.records.map((record) => record.stampId).filter((id2) => ids.has(id2))
   );
-  const remaining = config.spots.filter((spot2) => !acquired.has(spot2.id));
+  const remaining = config.spots.filter(
+    (spot2) => !acquired.has(spot2.id) && (spot2.prerequisites === void 0 || spot2.prerequisites.every((id2) => acquired.has(id2)))
+  );
   return {
     acquired: acquired.size,
     total: config.spots.length,
@@ -1522,6 +1524,11 @@ function errorValue(value, fallbackCode) {
   if (typeof value === "string") return { code: fallbackCode, message: value };
   return { code: fallbackCode, message: "Offline operation was rejected." };
 }
+var syncLocks = /* @__PURE__ */ new Map();
+var SYNC_LOCK_TTL_MS = 3e4;
+function randomId() {
+  return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
 var OfflineQueue = class {
   #storage;
   #configuredKey;
@@ -1536,6 +1543,11 @@ var OfflineQueue = class {
   #sender;
   #syncPromise = null;
   #syncResultListener;
+  #synchronizeInstances;
+  #instanceId = randomId();
+  #lockStorage;
+  #storageListener;
+  #channel = null;
   constructor(options = {}) {
     if (options.storage !== void 0) this.#storage = options.storage;
     else if (options.storageLike !== void 0 && options.storageLike !== null)
@@ -1546,6 +1558,9 @@ var OfflineQueue = class {
     this.#userId = options.userId ?? null;
     this.#conflictPolicy = options.conflictPolicy ?? "server_wins";
     this.#onSyncConflict = options.onSyncConflict;
+    this.#synchronizeInstances = options.synchronizeInstances ?? true;
+    this.#lockStorage = options.storageLike ?? globalThis.localStorage ?? null;
+    if (this.#synchronizeInstances) this.#subscribeToExternalChanges();
   }
   get syncState() {
     return this.#state;
@@ -1579,6 +1594,16 @@ var OfflineQueue = class {
     this.#operations = [...await this.#storage.load(this.#storageKey())];
     this.#loaded = true;
   }
+  /** Releases browser listeners when the queue is no longer used. */
+  dispose() {
+    const windowLike = globalThis.window;
+    if (windowLike !== void 0 && this.#storageListener !== void 0)
+      windowLike.removeEventListener("storage", this.#storageListener);
+    this.#storageListener = void 0;
+    this.#channel?.close();
+    this.#channel = null;
+    this.#releaseSyncLock();
+  }
   /** Selects a rally/user queue scope and loads its pending operations. */
   async setScope(rallyId, userId) {
     if (this.#configuredKey !== void 0) {
@@ -1613,6 +1638,7 @@ var OfflineQueue = class {
     if (this.#operations.some((item) => operationId(item) === id2)) return;
     this.#operations = [...this.#operations, operation];
     await this.#storage.save(this.#storageKey(), this.#operations);
+    this.#announceChange();
   }
   async enqueueCheckIn(request) {
     return this.enqueue({ kind: "checkIn", request });
@@ -1624,6 +1650,7 @@ var OfflineQueue = class {
     await this.initialize();
     this.#operations = [];
     await this.#storage.save(this.#storageKey(), this.#operations);
+    this.#announceChange();
   }
   async sync(sender = this.#sender) {
     await this.initialize();
@@ -1641,6 +1668,11 @@ var OfflineQueue = class {
   async #run(sender) {
     this.#state = "syncing";
     this.#error = null;
+    if (!this.#acquireSyncLock()) {
+      await this.#reloadFromStorage();
+      this.#state = "idle";
+      return;
+    }
     try {
       while (this.#operations.length > 0) {
         const operation = this.#operations[0];
@@ -1662,6 +1694,7 @@ var OfflineQueue = class {
         const error = response.status === "REJECTED_PERMANENT" ? errorValue(response.error ?? response.reason, "REJECTED_PERMANENT") : void 0;
         this.#operations = this.#operations.slice(1);
         await this.#storage.save(this.#storageKey(), this.#operations);
+        this.#announceChange();
         await this.#syncResultListener?.({
           operation,
           ...result === void 0 ? {} : { result },
@@ -1675,6 +1708,80 @@ var OfflineQueue = class {
       this.#state = "error";
       this.#error = cause instanceof Error ? cause : new Error(String(cause));
       throw this.#error;
+    } finally {
+      this.#releaseSyncLock();
+    }
+  }
+  #subscribeToExternalChanges() {
+    const windowLike = globalThis.window;
+    if (windowLike !== void 0) {
+      this.#storageListener = (event) => {
+        if (event.key === this.#storageKey()) void this.#reloadFromStorage();
+      };
+      windowLike.addEventListener("storage", this.#storageListener);
+    }
+    const Channel = globalThis.BroadcastChannel;
+    if (Channel !== void 0) {
+      try {
+        this.#channel = new Channel("stamprally:queue-sync");
+        this.#channel.addEventListener("message", (event) => {
+          if (typeof event.data === "object" && event.data !== null && "key" in event.data && event.data.key === this.#storageKey())
+            void this.#reloadFromStorage();
+        });
+      } catch {
+        this.#channel = null;
+      }
+    }
+  }
+  #announceChange() {
+    this.#channel?.postMessage({ key: this.#storageKey(), owner: this.#instanceId });
+  }
+  async #reloadFromStorage() {
+    if (this.#state === "syncing") return;
+    try {
+      this.#operations = [...await this.#storage.load(this.#storageKey())];
+      this.#loaded = true;
+    } catch {
+    }
+  }
+  #lockKey() {
+    return `${this.#storageKey()}:sync-lock`;
+  }
+  #acquireSyncLock() {
+    const key = this.#lockKey();
+    const now = Date.now();
+    const local = syncLocks.get(key);
+    if (local !== void 0 && local.expiresAt > now && local.owner !== this.#instanceId)
+      return false;
+    if (this.#lockStorage !== null) {
+      try {
+        const existing = this.#lockStorage.getItem(key);
+        if (existing !== null) {
+          const parsed = JSON.parse(existing);
+          if (typeof parsed === "object" && parsed !== null && typeof parsed.expiresAt === "number" && parsed.expiresAt > now && parsed.owner !== this.#instanceId)
+            return false;
+        }
+        this.#lockStorage.setItem(
+          key,
+          JSON.stringify({ owner: this.#instanceId, expiresAt: now + SYNC_LOCK_TTL_MS })
+        );
+      } catch {
+      }
+    }
+    syncLocks.set(key, { owner: this.#instanceId, expiresAt: now + SYNC_LOCK_TTL_MS });
+    return true;
+  }
+  #releaseSyncLock() {
+    const key = this.#lockKey();
+    const current = syncLocks.get(key);
+    if (current?.owner === this.#instanceId) syncLocks.delete(key);
+    if (this.#lockStorage !== null) {
+      try {
+        const value = this.#lockStorage.getItem(key);
+        if (value !== null && JSON.parse(value).owner === this.#instanceId)
+          this.#lockStorage.removeItem?.(key);
+      } catch {
+      }
     }
   }
   #storageKey() {
@@ -2437,21 +2544,112 @@ function validate(value, isPublic) {
     optionalString(value, "staffPasscode", "$", errors);
     if (hasOwn(value, "inventory") && value.inventory !== void 0 && !isRecord3(value.inventory))
       add(errors, "$.inventory", "Expected an object.", "invalid_type");
+    if (hasOwn(value, "inventoryMode") && value.inventoryMode !== void 0 && value.inventoryMode !== "shared" && value.inventoryMode !== "per_reward")
+      add(errors, "$.inventoryMode", "Expected shared or per_reward.", "invalid_enum");
     if (hasOwn(value, "serverMetadata") && value.serverMetadata !== void 0 && !isRecord3(value.serverMetadata))
       add(errors, "$.serverMetadata", "Expected an object.", "invalid_type");
     if (hasOwn(value, "publicMetadata") && value.publicMetadata !== void 0 && !isRecord3(value.publicMetadata))
       add(errors, "$.publicMetadata", "Expected an object.", "invalid_type");
     optionalString(value, "serverEndpoint", "$", errors);
   } else {
-    for (const key of ["staffPasscode", "serverMetadata", "inventory"])
+    for (const key of ["staffPasscode", "serverMetadata", "inventory", "inventoryMode"])
       if (hasOwn(value, key))
         add(errors, `$.${key}`, "Private field is not allowed.", "private_field");
     optionalString(value, "serverEndpoint", "$", errors);
   }
   return errors;
 }
+function validateRallyConfigRelations(config) {
+  const errors = [];
+  const spotIds = /* @__PURE__ */ new Set();
+  const rewardIds = /* @__PURE__ */ new Set();
+  const orderIndexes = /* @__PURE__ */ new Map();
+  config.spots.forEach((spot2, index) => {
+    if (spotIds.has(spot2.id))
+      add(errors, `spots[${index}].id`, "Spot ID must be unique.", "duplicate_spot_id");
+    spotIds.add(spot2.id);
+    const previousIndex = orderIndexes.get(spot2.orderIndex);
+    if (previousIndex !== void 0)
+      add(
+        errors,
+        `spots[${index}].orderIndex`,
+        `orderIndex duplicates spots[${previousIndex}].`,
+        "duplicate_order_index"
+      );
+    else orderIndexes.set(spot2.orderIndex, index);
+    if (spot2.orderIndex < 0)
+      add(
+        errors,
+        `spots[${index}].orderIndex`,
+        "orderIndex must not be negative.",
+        "negative_order_index"
+      );
+    spot2.prerequisites?.forEach((prerequisite, prerequisiteIndex) => {
+      if (!spotIds.has(prerequisite) && !config.spots.some((candidate) => candidate.id === prerequisite))
+        add(
+          errors,
+          `spots[${index}].prerequisites[${prerequisiteIndex}]`,
+          "Prerequisite spot does not exist.",
+          "missing_prerequisite"
+        );
+    });
+  });
+  config.rewards.forEach((reward2, index) => {
+    if (rewardIds.has(reward2.id))
+      add(errors, `rewards[${index}].id`, "Reward ID must be unique.", "duplicate_reward_id");
+    rewardIds.add(reward2.id);
+    const visit = (condition2, path) => {
+      if (condition2.type === "stamps")
+        condition2.stampIds.forEach((stampId, stampIndex) => {
+          if (!spotIds.has(stampId))
+            add(
+              errors,
+              `${path}.stampIds[${stampIndex}]`,
+              "Referenced spot does not exist.",
+              "missing_reward_spot"
+            );
+        });
+      else if (condition2.type === "all" || condition2.type === "any")
+        condition2.conditions.forEach((nested, nestedIndex) => {
+          visit(nested, `${path}.conditions[${nestedIndex}]`);
+        });
+    };
+    reward2.conditions?.forEach((condition2, conditionIndex) => {
+      visit(condition2, `rewards[${index}].conditions[${conditionIndex}]`);
+    });
+  });
+  const visiting = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  const cycleNodes = /* @__PURE__ */ new Set();
+  const visitSpot = (spotId) => {
+    if (visiting.has(spotId)) {
+      cycleNodes.add(spotId);
+      return;
+    }
+    if (visited.has(spotId)) return;
+    visiting.add(spotId);
+    const spot2 = config.spots.find((candidate) => candidate.id === spotId);
+    spot2?.prerequisites?.forEach(visitSpot);
+    visiting.delete(spotId);
+    visited.add(spotId);
+  };
+  config.spots.forEach((spot2) => {
+    visitSpot(spot2.id);
+  });
+  cycleNodes.forEach((spotId) => {
+    const index = config.spots.findIndex((spot2) => spot2.id === spotId);
+    add(
+      errors,
+      `spots[${index}].prerequisites`,
+      "Prerequisites must form a DAG.",
+      "cyclic_prerequisites"
+    );
+  });
+  return errors;
+}
 function safeParseAdminConfig(input) {
-  const errors = validate(input, false);
+  const errors = [...validate(input, false)];
+  if (errors.length === 0) errors.push(...validateRallyConfigRelations(input));
   return errors.length === 0 ? { success: true, data: input } : { success: false, errors };
 }
 function parseAdminConfig(input) {
@@ -2460,7 +2658,8 @@ function parseAdminConfig(input) {
   return result.data;
 }
 function safeParsePublicConfig(input) {
-  const errors = validate(input, true);
+  const errors = [...validate(input, true)];
+  if (errors.length === 0) errors.push(...validateRallyConfigRelations(input));
   return errors.length === 0 ? { success: true, data: input } : { success: false, errors };
 }
 function parsePublicConfig(input) {
@@ -2588,6 +2787,6 @@ async function verifySnapshotToken(token, secretKey, now = Date.now()) {
   }
 }
 
-export { ConfigValidationError, DEFAULT_SHEET_THEME, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, IndexedDBOfflineQueueStorage, LocalStorageAdapter, OfflineQueue, StampRallyClient, StorageAdapterError, THEME_PRESETS, assertPublicConfig, calculateDistanceMeters, calculateProgress, consumeReward, createClaimTicketNumber, createSecureToken, createSignedSnapshotToken, createUniqueClaimTicketNumber, evaluateCondition, evaluateConditionDetailed, evaluateSpotStatus, exportProgressToken, getCurrentGeoContext, getOrderedSpots, getSpotStatus, importProgressToken, isGeolocationSupported, isNfcSupported, isPublicConfig, isQrSupported, isRewardState, isStampRallyState, issueClaimTicketNumber, normalizePasscode, parseAdminConfig, parsePublicConfig, processStamp, readNfcContext, readQrContext, reconcileRewardStates, resolveLocalizedText, resolveRallyStateConflict, safeParseAdminConfig, safeParsePublicConfig, sanitizeAdminConfig, storageKey, toLocalizedString, toPublicConfig, updateLocalizedField, validatePublicConfigSafety, verifyPasscode, verifySecureToken, verifySnapshotToken };
+export { ConfigValidationError, DEFAULT_SHEET_THEME, MemoryQueueStorage as InMemoryOfflineQueueStorage, InMemoryStorage, IndexedDBAdapter, IndexedDBOfflineQueueStorage, LocalStorageAdapter, OfflineQueue, StampRallyClient, StorageAdapterError, THEME_PRESETS, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map