@stamprally/core 0.16.0 → 0.17.0

package/dist/index.cjs

@@ -171,6 +171,12 @@ function mergeStampRecords(serverRecords, localRecords) {
 }
 function resolveRallyStateConflict(serverState, localState, options = { policy: "merge" }) {
   if (options.policy === "server_wins") return serverState;
+  if (options.policy === "authoritative_replay")
+    return {
+      ...serverState,
+      records: serverState.records.map((record) => ({ ...record })),
+      rewards: serverState.rewards.map((reward2) => ({ ...reward2 }))
+    };
   return {
     ...serverState,
     records: mergeStampRecords(serverState.records, localState.records),
@@ -1058,1079 +1064,1217 @@ var IndexedDBAdapter = class {
   }
 };
 
-// src/client/client.ts
-function isStorage(value) {
-  return "load" in value && "save" in value && "remove" in value;
-}
-function id(prefix) {
-  return `${prefix}-${globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`}`;
-}
-function proof(value) {
-  if (typeof value === "string") return value;
-  if (typeof value === "object" && value !== null) {
-    const item = value;
-    for (const key of ["token", "code", "passcode", "value", "tagId"])
-      if (typeof item[key] === "string") return item[key];
-  }
-  return "";
-}
-function matches(condition2, value) {
-  if (condition2.type === "gps") {
-    if (typeof value !== "object" || value === null) return false;
-    const item = value;
-    const latitude = item.latitude;
-    const longitude = item.longitude;
-    if (typeof latitude !== "number" || typeof longitude !== "number") return false;
-    const radians = (v) => v * Math.PI / 180;
-    const dLat = radians(latitude - condition2.latitude);
-    const dLon = radians(longitude - condition2.longitude);
-    const h = Math.sin(dLat / 2) ** 2 + Math.cos(radians(condition2.latitude)) * Math.cos(radians(latitude)) * Math.sin(dLon / 2) ** 2;
-    return 6371e3 * 2 * Math.asin(Math.sqrt(Math.min(1, h))) <= condition2.radiusMeters;
+// src/client/offlineQueue.ts
+function rollbackOptimisticOperation(state, operation) {
+  const previous = operation.request.state;
+  if (operation.kind === "checkIn") {
+    const records = state.records.filter(
+      (record) => record.stampId !== operation.request.spotId || record.acquiredAt !== operation.request.now
+    );
+    const previousRewards = new Map(previous.rewards.map((reward2) => [reward2.rewardId, reward2]));
+    const rewards2 = state.rewards.map((reward2) => previousRewards.get(reward2.rewardId) ?? reward2);
+    return { ...cloneState(state), records, rewards: rewards2, updatedAt: previous.updatedAt };
   }
-  return proof(value).trim() !== "";
-}
-function emptyState(config, userId, now) {
-  return {
-    rallyId: config.id,
-    userId,
-    records: [],
-    rewards: reconcileRewardStates(config.rewards, [], 0, now),
-    updatedAt: now
+  const previousReward = previous.rewards.find(
+    (reward2) => reward2.rewardId === operation.request.rewardId
+  );
+  const rewards = state.rewards.filter(
+    (reward2) => reward2.rewardId !== operation.request.rewardId || previousReward !== void 0
+  ).map(
+    (reward2) => reward2.rewardId === operation.request.rewardId && previousReward !== void 0 ? { ...previousReward } : reward2
+  );
+  const cloned = cloneState(state);
+  const { inventory: _inventory, ...stateWithoutInventory } = cloned;
+  const previousInventory = previous.inventory;
+  return previousInventory === void 0 ? { ...stateWithoutInventory, rewards, updatedAt: previous.updatedAt } : {
+    ...stateWithoutInventory,
+    rewards,
+    inventory: {
+      ...previousInventory,
+      ...previousInventory.rewardRemaining === void 0 ? {} : { rewardRemaining: { ...previousInventory.rewardRemaining } }
+    },
+    updatedAt: previous.updatedAt
   };
 }
-var StampRallyClient = class {
-  #listeners = /* @__PURE__ */ new Set();
-  #eventListeners = /* @__PURE__ */ new Set();
-  #storage;
-  #options;
-  #config;
-  #offlineQueue;
-  #userId;
-  #anonymousSessionId;
-  #state = null;
-  #initialization = null;
-  #queue = Promise.resolve();
-  constructor(config, storageOrOptions = {}) {
-    this.#config = config;
-    this.#options = isStorage(storageOrOptions) ? { storage: storageOrOptions } : storageOrOptions;
-    this.#storage = this.#options.storage ?? new InMemoryStorage();
-    this.#anonymousSessionId = this.#options.anonymousSessionId ?? createAnonymousSessionId();
-    this.#userId = this.#options.userId ?? this.#anonymousSessionId;
-    this.#offlineQueue = this.#options.offlineQueue;
-    this.#offlineQueue?.setSyncResultListener((event) => this.#handleOfflineSyncResult(event));
-  }
-  getConfig() {
-    return this.#config;
+var MemoryQueueStorage = class {
+  #values = /* @__PURE__ */ new Map();
+  #rejected = /* @__PURE__ */ new Map();
+  async load(key) {
+    return this.#values.get(key) ?? [];
   }
-  getState() {
-    return this.#state;
+  async save(key, operations) {
+    this.#values.set(key, structuredClone(operations));
   }
-  getUserId() {
-    return this.#userId;
+  async loadRejectedHistory(key) {
+    return this.#rejected.get(key) ?? [];
   }
-  getAnonymousSessionId() {
-    return this.#anonymousSessionId;
+  async saveRejectedHistory(key, history) {
+    this.#rejected.set(key, structuredClone(history));
   }
-  get syncState() {
-    return this.#offlineQueue?.syncState ?? "idle";
+};
+var LocalStorageQueueStorage = class {
+  constructor(storage) {
+    this.storage = storage;
   }
-  get pendingCount() {
-    return this.#offlineQueue?.pendingCount ?? 0;
+  storage;
+  async load(key) {
+    const value = this.storage.getItem(key);
+    if (value === null) return [];
+    try {
+      const parsed = JSON.parse(value);
+      return Array.isArray(parsed) ? parsed : [];
+    } catch {
+      return [];
+    }
   }
-  get rejectedHistory() {
-    return this.#offlineQueue?.rejectedHistory ?? [];
+  async save(key, operations) {
+    this.storage.setItem(key, JSON.stringify(operations));
   }
-  get queueCapability() {
-    return this.#offlineQueue?.queueCapability ?? "custom";
+  async loadRejectedHistory(key) {
+    const value = this.storage.getItem(`${key}:rejected-history`);
+    if (value === null) return [];
+    try {
+      const parsed = JSON.parse(value);
+      return Array.isArray(parsed) ? parsed : [];
+    } catch {
+      return [];
+    }
   }
-  discardRejected(operationId) {
-    return this.#offlineQueue?.discardRejected(operationId) ?? Promise.resolve(false);
+  async saveRejectedHistory(key, history) {
+    this.storage.setItem(`${key}:rejected-history`, JSON.stringify(history));
   }
-  retryRejected(operationId) {
-    return this.#offlineQueue?.retryRejected(operationId) ?? Promise.resolve(false);
+};
+var IndexedDBOfflineQueueStorage = class {
+  #providedFactory;
+  #databaseName;
+  #databasePromise = null;
+  constructor(options = {}) {
+    this.#providedFactory = options.indexedDB;
+    this.#databaseName = options.databaseName ?? "stamprally-offline-queue";
   }
-  subscribe(listener) {
-    this.#listeners.add(listener);
-    return () => this.#listeners.delete(listener);
+  async load(key) {
+    const database = await this.#open();
+    return new Promise((resolve, reject) => {
+      const request = database.transaction("operations", "readonly").objectStore("operations").get(key);
+      request.onsuccess = () => resolve(Array.isArray(request.result) ? request.result : []);
+      request.onerror = () => reject(request.error ?? new Error("Failed to read offline queue."));
+    });
   }
-  subscribeEvents(listener) {
-    this.#eventListeners.add(listener);
-    return () => this.#eventListeners.delete(listener);
+  async save(key, operations) {
+    const database = await this.#open();
+    return new Promise((resolve, reject) => {
+      const transaction = database.transaction("operations", "readwrite");
+      transaction.objectStore("operations").put(structuredClone(operations), key);
+      transaction.oncomplete = () => resolve();
+      transaction.onerror = () => reject(transaction.error ?? new Error("Failed to save offline queue."));
+      transaction.onabort = () => reject(transaction.error ?? new Error("Offline queue write aborted."));
+    });
   }
-  init() {
-    return this.initialize();
+  async loadRejectedHistory(key) {
+    const database = await this.#open();
+    return new Promise((resolve, reject) => {
+      const request = database.transaction("operations", "readonly").objectStore("operations").get(`${key}:rejected-history`);
+      request.onsuccess = () => resolve(
+        Array.isArray(request.result) ? request.result : []
+      );
+      request.onerror = () => reject(request.error ?? new Error("Failed to read rejected operation history."));
+    });
   }
-  initialize() {
-    if (this.#state !== null) return Promise.resolve(this.#state);
-    if (this.#initialization === null) {
-      this.#initialization = (async () => {
-        await this.#offlineQueue?.setScope(this.#config.id, this.#userId);
-        return this.#storage.load(this.#config.id, this.#userId);
-      })().then((state) => {
-        const next = state === null ? emptyState(this.#config, this.#userId, this.#now()) : this.#reconcile(state);
-        this.#state = next;
-        this.#emit(next);
-        return next;
-      }).catch((error) => {
-        this.#initialization = null;
-        throw error;
-      });
-    }
-    return this.#initialization;
+  async saveRejectedHistory(key, history) {
+    const database = await this.#open();
+    return new Promise((resolve, reject) => {
+      const transaction = database.transaction("operations", "readwrite");
+      transaction.objectStore("operations").put(structuredClone(history), `${key}:rejected-history`);
+      transaction.oncomplete = () => resolve();
+      transaction.onerror = () => reject(transaction.error ?? new Error("Failed to save rejected operation history."));
+      transaction.onabort = () => reject(transaction.error ?? new Error("Rejected operation history write aborted."));
+    });
   }
-  switchUser(newUserId) {
-    return this.#enqueue(async () => {
-      const nextUserId = newUserId ?? this.#anonymousSessionId;
-      if (this.#userId === nextUserId && this.#state !== null) return this.#state;
-      this.#userId = nextUserId;
-      this.#state = null;
-      this.#initialization = null;
-      await this.#offlineQueue?.switchUser(nextUserId);
-      return this.initialize();
+  #open() {
+    if (this.#databasePromise !== null) return this.#databasePromise;
+    let factory = this.#providedFactory;
+    if (factory === void 0)
+      factory = globalThis.indexedDB;
+    if (factory === void 0 || factory === null)
+      return Promise.reject(new Error("IndexedDB is unavailable in this environment."));
+    this.#databasePromise = new Promise((resolve, reject) => {
+      const request = factory.open(this.#databaseName, 1);
+      request.onupgradeneeded = () => {
+        if (!request.result.objectStoreNames.contains("operations"))
+          request.result.createObjectStore("operations");
+      };
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error ?? new Error("Failed to open offline queue."));
+    }).catch((error) => {
+      this.#databasePromise = null;
+      throw error;
     });
+    return this.#databasePromise;
   }
-  async getUserState(rallyId, userId) {
-    return this.#storage.load(rallyId, userId);
+};
+function availableLocalStorage() {
+  try {
+    const storage = globalThis.localStorage;
+    return storage ?? null;
+  } catch {
+    return null;
   }
-  clearUserState(userId = this.#userId) {
-    return this.#enqueue(async () => {
-      await this.#storage.remove(this.#config.id, userId);
-      if (userId === this.#userId) {
-        await this.#initializeFresh();
-      }
-    });
+}
+function defaultStorage(databaseName) {
+  try {
+    const indexedDB = globalThis.indexedDB;
+    if (indexedDB !== void 0)
+      return {
+        storage: new IndexedDBOfflineQueueStorage({
+          indexedDB,
+          ...databaseName === void 0 ? {} : { databaseName }
+        }),
+        capability: "indexeddb"
+      };
+    const storage = availableLocalStorage();
+    if (storage !== void 0 && storage !== null)
+      return { storage: new LocalStorageQueueStorage(storage), capability: "localstorage" };
+  } catch {
   }
-  checkIn(spotId, proofData, options = {}) {
-    return this.#enqueue(async () => {
-      const current = await this.initialize();
-      const spot2 = this.#config.spots.find((item) => item.id === spotId);
-      if (spot2 === void 0)
-        return this.#fail({ code: "SPOT_NOT_FOUND", spotId, message: "Spot was not found." });
-      if (current.records.some((record2) => record2.stampId === spotId))
-        return this.#fail({
-          code: "STAMP_ALREADY_ACQUIRED",
-          spotId,
-          message: "Spot was already claimed."
-        });
-      const acquired = new Set(current.records.map((record2) => record2.stampId));
-      if (spot2.prerequisites?.some((id2) => !acquired.has(id2)))
-        return this.#fail({
-          code: "PREREQUISITES_NOT_MET",
-          spotId,
-          message: "Prerequisite spots are not complete."
-        });
-      for (const condition2 of spot2.conditions) {
-        if (condition2.type === "custom") {
-          const validator = this.#options.customValidators?.[condition2.validatorName] ?? this.#options.customValidator;
-          if (validator === void 0)
-            return this.#fail({
-              code: "CUSTOM_VALIDATION_FAILED",
-              spotId,
-              message: "No custom validator is registered."
-            });
-          const context = {
-            rallyId: this.#config.id,
-            spotId,
-            proofData,
-            condition: { type: "custom", validatorName: condition2.validatorName },
-            userState: current
-          };
-          const result = typeof validator === "function" ? await validator(context) : await validator.validate(context);
-          if (result === false || typeof result === "object" && !result.valid)
-            return this.#fail({
-              code: "CUSTOM_VALIDATION_FAILED",
-              spotId,
-              message: typeof result === "object" && result.message !== void 0 ? result.message : "Custom validation failed."
-            });
-        } else if (!matches(condition2, proofData))
-          return this.#fail({ code: "INVALID_PROOF", spotId, message: "Verification failed." });
-      }
-      const now = options.now ?? this.#now();
-      const request = {
-        rallyId: this.#config.id,
-        userId: this.#userId,
-        spotId,
-        proofData,
-        idempotencyKey: options.idempotencyKey ?? id("check-in"),
-        now,
-        state: current,
-        ...this.#userId === this.#anonymousSessionId ? { anonymousSessionId: this.#anonymousSessionId } : {}
-      };
-      const remote = this.#options.syncAdapter?.checkIn;
-      if (options.sync !== false && remote !== void 0) {
-        try {
-          const result = await remote(request);
-          return result.ok ? this.#commitCheckIn(result) : this.#fail(result.error);
-        } catch (error) {
-          if (this.#offlineQueue === void 0) throw error;
-          await this.#offlineQueue.enqueueCheckIn(request);
-          const record2 = { stampId: spotId, acquiredAt: now };
-          const next2 = this.#reconcile({
-            ...current,
-            records: [...current.records, record2],
-            updatedAt: now
-          });
-          await this.#storage.save(next2);
-          return this.#commitCheckIn({ ok: true, value: { state: next2, record: record2 } });
-        }
-      }
-      const record = { stampId: spotId, acquiredAt: now };
-      const next = this.#reconcile({
-        ...current,
-        records: [...current.records, record],
-        updatedAt: now
-      });
-      await this.#storage.save(next);
-      return this.#commitCheckIn({ ok: true, value: { state: next, record } });
-    });
+  return { storage: new MemoryQueueStorage(), capability: "memory" };
+}
+function offlineOperationId(operation) {
+  const identity = operation.request.userId ?? operation.request.anonymousSessionId ?? "anonymous";
+  return operation.kind === "checkIn" ? `checkIn:${operation.request.rallyId}:${identity}:${operation.request.idempotencyKey}` : `claimReward:${operation.request.rallyId}:${identity}:${operation.request.idempotencyKey}`;
+}
+function requestScope(operation) {
+  return {
+    rallyId: operation.request.rallyId,
+    userId: operation.request.userId
+  };
+}
+function errorValue(value, fallbackCode) {
+  if (typeof value === "object" && value !== null) {
+    const candidate = value;
+    if (typeof candidate.code === "string" && typeof candidate.message === "string")
+      return { ...candidate, code: candidate.code, message: candidate.message };
   }
-  claimReward(rewardId, options = {}) {
-    return this.#enqueue(async () => {
-      const current = await this.initialize();
-      const configured = this.#config.rewards.find((item) => item.id === rewardId);
-      if (configured === void 0)
-        return this.#fail({ code: "REWARD_NOT_FOUND", rewardId, message: "Reward was not found." });
-      const now = options.now ?? this.#now();
-      const state = current.rewards.find((item) => item.rewardId === rewardId) ?? {
-        rewardId,
-        status: "LOCKED"
-      };
-      const local = consumeReward({
-        reward: configured,
-        currentState: state,
-        now,
-        ...options.staffPasscode === void 0 ? {} : { inputPasscode: options.staffPasscode },
-        ...options.staffId === void 0 ? {} : { staffId: options.staffId }
-      });
-      if (!local.ok) return this.#fail(local.error);
-      const request = {
-        rallyId: this.#config.id,
-        userId: this.#userId,
-        rewardId,
-        idempotencyKey: options.idempotencyKey ?? id("claim"),
-        now,
-        options,
-        state: current,
-        ...this.#userId === this.#anonymousSessionId ? { anonymousSessionId: this.#anonymousSessionId } : {}
-      };
-      const remote = this.#options.syncAdapter?.claimReward;
-      if (options.sync !== false && remote !== void 0) {
-        try {
-          const result = await remote(request);
-          return result.ok ? this.#commitClaim(result) : this.#fail(result.error);
-        } catch (error) {
-          if (this.#offlineQueue === void 0) throw error;
-          await this.#offlineQueue.enqueueClaimReward(request);
-          const next2 = {
-            ...current,
-            rewards: current.rewards.map(
-              (item) => item.rewardId === rewardId ? local.value : item
-            ),
-            updatedAt: now
-          };
-          await this.#storage.save(next2);
-          return this.#commitClaim({ ok: true, value: { state: next2, reward: local.value } });
-        }
-      }
-      const next = {
-        ...current,
-        rewards: current.rewards.map((item) => item.rewardId === rewardId ? local.value : item),
-        updatedAt: now
-      };
-      await this.#storage.save(next);
-      return this.#commitClaim({ ok: true, value: { state: next, reward: local.value } });
-    });
+  if (value instanceof Error) return { code: fallbackCode, message: value.message };
+  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;
+var DEFAULT_RETRY_OPTIONS = {
+  maxRetries: 0,
+  initialIntervalMs: 250,
+  backoffMultiplier: 2
+};
+function randomId() {
+  return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+var OfflineQueue = class {
+  #storage;
+  #queueCapability;
+  #configuredKey;
+  #rallyId;
+  #userId;
+  #conflictPolicy;
+  #onSyncConflict;
+  #operations = [];
+  #rejectedHistory = [];
+  #loaded = false;
+  #state = "idle";
+  #error = null;
+  #sender;
+  #syncPromise = null;
+  #syncResultListener;
+  #changeListener;
+  #synchronizeInstances;
+  #retryOptions;
+  #instanceId = randomId();
+  #lockStorage;
+  #observedLocks = /* @__PURE__ */ new Map();
+  #warnedMemoryLock = false;
+  #storageListener;
+  #channel = null;
+  constructor(options = {}) {
+    if (options.storage !== void 0) {
+      this.#storage = options.storage;
+      this.#queueCapability = "custom";
+    } else if (options.storageLike !== void 0 && options.storageLike !== null) {
+      this.#storage = new LocalStorageQueueStorage(options.storageLike);
+      this.#queueCapability = "localstorage";
+    } else {
+      const selected = defaultStorage(options.databaseName);
+      this.#storage = selected.storage;
+      this.#queueCapability = selected.capability;
+    }
+    this.#configuredKey = options.key;
+    this.#rallyId = options.rallyId;
+    this.#userId = options.userId ?? null;
+    this.#conflictPolicy = options.conflictPolicy ?? "authoritative_replay";
+    this.#onSyncConflict = options.onSyncConflict;
+    this.#synchronizeInstances = options.synchronizeInstances ?? true;
+    const retryOptions = {
+      ...DEFAULT_RETRY_OPTIONS,
+      ...options.retryOptions ?? options.syncRetryOptions ?? options.retry ?? {}
+    };
+    this.#retryOptions = {
+      maxRetries: Math.max(0, Math.floor(retryOptions.maxRetries)),
+      initialIntervalMs: Math.max(0, retryOptions.initialIntervalMs),
+      backoffMultiplier: Math.max(1, retryOptions.backoffMultiplier)
+    };
+    this.#lockStorage = options.storageLike ?? availableLocalStorage();
+    if (this.#synchronizeInstances) this.#subscribeToExternalChanges();
   }
-  sync(adapter = this.#options.syncAdapter) {
-    return this.#enqueue(async () => {
-      const current = await this.initialize();
-      if (this.#offlineQueue !== void 0 && adapter !== void 0) {
-        await this.#offlineQueue.sync(async (operation) => {
-          if (operation.kind === "checkIn") {
-            if (adapter.checkIn === void 0)
-              throw new Error("No check-in sync adapter is configured.");
-            return adapter.checkIn(operation.request);
-          }
-          if (adapter.claimReward === void 0)
-            throw new Error("No reward sync adapter is configured.");
-          return adapter.claimReward(operation.request);
-        });
-      }
-      if (adapter?.sync === void 0) {
-        this.#emitEvent({ type: "sync", state: this.#state ?? current });
-        return;
-      }
-      const serverState = await adapter.sync({
-        rallyId: this.#config.id,
-        userId: this.#userId,
-        state: this.#state ?? current,
-        ...this.#userId === this.#anonymousSessionId ? { anonymousSessionId: this.#anonymousSessionId } : {}
-      });
-      const next = this.#reconcile(serverState);
-      await this.#storage.save(next);
-      this.#state = next;
-      this.#emit(next);
-      this.#emitEvent({ type: "sync", state: next });
-    });
+  get syncState() {
+    return this.#state;
   }
-  retrySync() {
-    return this.sync();
+  get pendingCount() {
+    return this.#operations.length;
   }
-  reset() {
-    return this.#enqueue(async () => {
-      await this.#storage.remove(this.#config.id, this.#userId);
-      return this.#initializeFresh();
-    });
+  get queueCapability() {
+    return this.#queueCapability;
   }
-  restore(state) {
-    return this.#enqueue(async () => {
-      if (state.rallyId !== this.#config.id || state.userId !== this.#userId)
-        throw new Error("State belongs to another rally or user.");
-      const next = this.#reconcile(state);
-      await this.#storage.save(next);
-      this.#state = next;
-      this.#initialization = Promise.resolve(next);
-      this.#emit(next);
-      return next;
-    });
+  get rejectedHistory() {
+    return this.#rejectedHistory;
   }
-  #enqueue(operation) {
-    const next = this.#queue.then(operation, operation);
-    this.#queue = next.then(
-      () => void 0,
-      () => void 0
-    );
-    return next;
+  get error() {
+    return this.#error;
   }
-  #initializeFresh() {
-    const next = emptyState(this.#config, this.#userId, this.#now());
-    this.#state = next;
-    this.#initialization = Promise.resolve(next);
-    this.#emit(next);
-    return Promise.resolve(next);
+  get operations() {
+    return this.#operations;
   }
-  #reconcile(state) {
-    const ids = new Set(this.#config.spots.map((spot2) => spot2.id));
-    const records = state.records.filter(
-      (record, index, all) => ids.has(record.stampId) && all.findIndex((candidate) => candidate.stampId === record.stampId) === index
-    );
-    return {
-      ...cloneState(state),
-      userId: this.#userId,
-      records,
-      rewards: reconcileRewardStates(
-        this.#config.rewards,
-        state.rewards,
-        records.length,
-        state.updatedAt
-      )
-    };
+  get conflictPolicy() {
+    return this.#conflictPolicy;
   }
-  async #handleOfflineSyncResult(event) {
-    if (event.state !== void 0) {
-      const next = this.#reconcile(event.state);
-      await this.#storage.save(next);
-      this.#state = next;
-      this.#emit(next);
-    }
-    if (event.error !== void 0) this.#emitEvent({ type: "error", error: event.error });
-    else if (event.result !== void 0 && "ok" in event.result && !event.result.ok)
-      this.#emitEvent({ type: "error", error: event.result.error });
+  get storageKey() {
+    return this.#storageKey();
   }
-  #now() {
-    return this.#options.clock?.() ?? (/* @__PURE__ */ new Date()).toISOString();
+  get rallyId() {
+    return this.#rallyId;
   }
-  #fail(error) {
-    this.#emitEvent({ type: "error", error });
-    return { ok: false, error };
+  get userId() {
+    return this.#userId;
   }
-  #commitCheckIn(result) {
-    if (result.ok) {
-      this.#state = result.value.state;
-      this.#emit(this.#state);
-    }
-    this.#emitEvent({ type: "checkIn", result });
-    return result;
+  setSyncResultListener(listener) {
+    this.#syncResultListener = listener;
   }
-  #commitClaim(result) {
-    if (result.ok) {
-      this.#state = result.value.state;
-      this.#emit(this.#state);
+  setChangeListener(listener) {
+    this.#changeListener = listener;
+  }
+  async initialize() {
+    if (this.#loaded) return;
+    try {
+      const key = this.#storageKey();
+      this.#operations = (await this.#storage.load(key)).map(normalizeOperation);
+      this.#rejectedHistory = (await this.#storage.loadRejectedHistory?.(key))?.map(normalizeRejectedHistory) ?? [];
+    } catch (error) {
+      if (this.#queueCapability === "memory") throw error;
+      this.#storage = new MemoryQueueStorage();
+      this.#queueCapability = "memory";
+      this.#operations = [];
+      this.#rejectedHistory = [];
+      this.#warnMemoryLock(
+        `Offline queue persistence is unavailable; queued data can be lost after reload (${String(error)}).`
+      );
     }
-    this.#emitEvent({ type: "rewardClaimed", result });
-    return result;
+    this.#loaded = true;
   }
-  #emit(state) {
-    for (const listener of this.#listeners) listener(state);
+  /** 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();
   }
-  #emitEvent(event) {
-    for (const listener of this.#eventListeners) listener(event);
+  /** Selects a rally/user queue scope and loads its pending operations. */
+  async setScope(rallyId, userId) {
+    if (this.#configuredKey !== void 0) {
+      this.#rallyId = rallyId;
+      this.#userId = userId;
+      return this.initialize();
+    }
+    if (this.#rallyId === rallyId && this.#userId === userId && this.#loaded) return;
+    this.#rallyId = rallyId;
+    this.#userId = userId;
+    this.#operations = [];
+    this.#loaded = false;
+    await this.initialize();
   }
-};
-
-// src/client/offlineQueue.ts
-var MemoryQueueStorage = class {
-  #values = /* @__PURE__ */ new Map();
-  #rejected = /* @__PURE__ */ new Map();
-  async load(key) {
-    return this.#values.get(key) ?? [];
+  async switchUser(newUserId) {
+    if (this.#rallyId === void 0)
+      throw new Error("OfflineQueue.switchUser requires a rally scope.");
+    await this.setScope(this.#rallyId, newUserId);
   }
-  async save(key, operations) {
-    this.#values.set(key, structuredClone(operations));
+  setSender(sender) {
+    this.#sender = sender;
   }
-  async loadRejectedHistory(key) {
-    return this.#rejected.get(key) ?? [];
+  async enqueue(operation) {
+    if (this.#configuredKey === void 0) {
+      const scope = requestScope(operation);
+      if (this.#rallyId === void 0) await this.setScope(scope.rallyId, scope.userId);
+      if (this.#rallyId !== scope.rallyId || this.#userId !== scope.userId)
+        throw new Error("Offline operation belongs to another rally or user queue.");
+    }
+    await this.initialize();
+    const id2 = offlineOperationId(operation);
+    if (this.#operations.some((item) => offlineOperationId(item) === id2)) return;
+    this.#operations = [...this.#operations, { ...operation, status: "PENDING", attempts: 0 }];
+    await this.#storage.save(this.#storageKey(), this.#operations);
+    this.#announceChange();
   }
-  async saveRejectedHistory(key, history) {
-    this.#rejected.set(key, structuredClone(history));
+  async enqueueCheckIn(request) {
+    return this.enqueue({ kind: "checkIn", request });
   }
-};
-var LocalStorageQueueStorage = class {
-  constructor(storage) {
-    this.storage = storage;
+  async enqueueClaimReward(request) {
+    return this.enqueue({ kind: "claimReward", request });
   }
-  storage;
-  async load(key) {
-    const value = this.storage.getItem(key);
-    if (value === null) return [];
-    try {
-      const parsed = JSON.parse(value);
-      return Array.isArray(parsed) ? parsed : [];
-    } catch {
-      return [];
-    }
+  async clear() {
+    await this.initialize();
+    this.#operations = [];
+    await this.#storage.save(this.#storageKey(), this.#operations);
+    this.#announceChange();
   }
-  async save(key, operations) {
-    this.storage.setItem(key, JSON.stringify(operations));
+  async discardRejected(operationId) {
+    await this.initialize();
+    const next = this.#rejectedHistory.filter(
+      (entry) => offlineOperationId(entry.operation) !== operationId
+    );
+    if (next.length === this.#rejectedHistory.length) return false;
+    this.#rejectedHistory = next;
+    await this.#saveRejectedHistory();
+    this.#announceChange();
+    return true;
   }
-  async loadRejectedHistory(key) {
-    const value = this.storage.getItem(`${key}:rejected-history`);
-    if (value === null) return [];
-    try {
-      const parsed = JSON.parse(value);
-      return Array.isArray(parsed) ? parsed : [];
-    } catch {
-      return [];
-    }
+  async retryRejected(operationId) {
+    await this.initialize();
+    const entry = this.#rejectedHistory.find(
+      (candidate) => offlineOperationId(candidate.operation) === operationId
+    );
+    if (entry === void 0) return false;
+    if (!this.#operations.some((operation) => offlineOperationId(operation) === operationId))
+      this.#operations = [
+        ...this.#operations,
+        { ...entry.operation, status: "PENDING", attempts: 0 }
+      ];
+    this.#rejectedHistory = this.#rejectedHistory.filter((candidate) => candidate !== entry);
+    await this.#storage.save(this.#storageKey(), this.#operations);
+    await this.#saveRejectedHistory();
+    this.#announceChange();
+    return true;
   }
-  async saveRejectedHistory(key, history) {
-    this.storage.setItem(`${key}:rejected-history`, JSON.stringify(history));
+  async discardRejectedOperation(operationId) {
+    return this.discardRejected(operationId);
   }
-};
-var IndexedDBOfflineQueueStorage = class {
-  #providedFactory;
-  #databaseName;
-  #databasePromise = null;
-  constructor(options = {}) {
-    this.#providedFactory = options.indexedDB;
-    this.#databaseName = options.databaseName ?? "stamprally-offline-queue";
+  async retryRejectedOperation(operationId) {
+    return this.retryRejected(operationId);
   }
-  async load(key) {
-    const database = await this.#open();
-    return new Promise((resolve, reject) => {
-      const request = database.transaction("operations", "readonly").objectStore("operations").get(key);
-      request.onsuccess = () => resolve(Array.isArray(request.result) ? request.result : []);
-      request.onerror = () => reject(request.error ?? new Error("Failed to read offline queue."));
-    });
+  async clearRejectedHistory() {
+    await this.initialize();
+    if (this.#rejectedHistory.length === 0) return;
+    this.#rejectedHistory = [];
+    await this.#saveRejectedHistory();
+    this.#announceChange();
   }
-  async save(key, operations) {
-    const database = await this.#open();
-    return new Promise((resolve, reject) => {
-      const transaction = database.transaction("operations", "readwrite");
-      transaction.objectStore("operations").put(structuredClone(operations), key);
-      transaction.oncomplete = () => resolve();
-      transaction.onerror = () => reject(transaction.error ?? new Error("Failed to save offline queue."));
-      transaction.onabort = () => reject(transaction.error ?? new Error("Offline queue write aborted."));
+  async sync(sender = this.#sender) {
+    await this.initialize();
+    if (sender === void 0) throw new Error("OfflineQueue.sync requires a sender.");
+    if (this.#syncPromise !== null) return this.#syncPromise;
+    this.#sender = sender;
+    this.#syncPromise = this.#run(sender).finally(() => {
+      this.#syncPromise = null;
     });
+    return this.#syncPromise;
   }
-  async loadRejectedHistory(key) {
-    const database = await this.#open();
-    return new Promise((resolve, reject) => {
-      const request = database.transaction("operations", "readonly").objectStore("operations").get(`${key}:rejected-history`);
-      request.onsuccess = () => resolve(
-        Array.isArray(request.result) ? request.result : []
+  async retrySync(sender = this.#sender) {
+    return this.sync(sender);
+  }
+  async #run(sender) {
+    const locks = globalThis.navigator?.locks;
+    if (locks !== void 0 && typeof locks.request === "function") {
+      let callbackStarted = false;
+      try {
+        const acquired = await locks.request(
+          `stamprally:${this.#storageKey()}:sync`,
+          { ifAvailable: true },
+          async (lock) => {
+            if (lock === null) {
+              await this.#reloadFromStorage();
+              this.#state = "idle";
+              this.#changeListener?.();
+              return false;
+            }
+            callbackStarted = true;
+            await this.#runWithStorageLock(sender);
+            return true;
+          }
+        );
+        if (!acquired) return;
+        return;
+      } catch (error) {
+        if (callbackStarted) throw error;
+      }
+    }
+    if (this.#lockStorage === null)
+      this.#warnMemoryLock(
+        "No cross-tab storage lock is available; offline sync is single-tab only."
       );
-      request.onerror = () => reject(request.error ?? new Error("Failed to read rejected operation history."));
-    });
+    await this.#runWithStorageLock(sender);
   }
-  async saveRejectedHistory(key, history) {
-    const database = await this.#open();
-    return new Promise((resolve, reject) => {
-      const transaction = database.transaction("operations", "readwrite");
-      transaction.objectStore("operations").put(structuredClone(history), `${key}:rejected-history`);
-      transaction.oncomplete = () => resolve();
-      transaction.onerror = () => reject(transaction.error ?? new Error("Failed to save rejected operation history."));
-      transaction.onabort = () => reject(transaction.error ?? new Error("Rejected operation history write aborted."));
-    });
+  async #runWithStorageLock(sender) {
+    this.#state = "syncing";
+    this.#error = null;
+    this.#changeListener?.();
+    if (!this.#acquireSyncLock()) {
+      await this.#reloadFromStorage();
+      this.#state = "idle";
+      this.#changeListener?.();
+      return;
+    }
+    try {
+      while (this.#operations.length > 0) {
+        const operation = this.#operations[0];
+        if (operation === void 0) break;
+        let attempt = 0;
+        let response;
+        while (true) {
+          await this.#updateOperationStatus("IN_FLIGHT", attempt);
+          try {
+            response = this.#normalizeResponse(await sender(operation));
+          } catch (cause) {
+            response = {
+              status: "RETRYABLE_ERROR",
+              error: errorValue(cause, "RETRYABLE_ERROR")
+            };
+          }
+          if (response.status !== "RETRYABLE_ERROR") break;
+          const error2 = errorValue(response.error ?? response.reason, "RETRYABLE_ERROR");
+          await this.#updateOperationStatus("PENDING", attempt + 1);
+          await this.#syncResultListener?.({ operation, status: response.status, error: error2 });
+          if (attempt >= this.#retryOptions.maxRetries) {
+            await this.#updateOperationStatus("FAILED_RETRYABLE", attempt + 1);
+            throw new Error(error2.message);
+          }
+          const interval = this.#retryOptions.initialIntervalMs * this.#retryOptions.backoffMultiplier ** attempt;
+          await new Promise((resolve) => setTimeout(resolve, Math.max(0, interval)));
+          attempt += 1;
+        }
+        const result = response.result;
+        const state = response.state ?? (result !== void 0 && "conflict" in result && result.conflict === true ? result.serverState : result !== void 0 && "ok" in result && result.ok ? result.value.state : void 0);
+        const error = response.status === "REJECTED_PERMANENT" ? errorValue(
+          response.error ?? response.reason ?? (result !== void 0 && "ok" in result && !result.ok ? result.error : void 0),
+          "REJECTED_PERMANENT"
+        ) : void 0;
+        await this.#updateOperationStatus(
+          response.status === "ACCEPTED" ? "ACCEPTED" : "REJECTED_PERMANENT",
+          attempt + 1
+        );
+        const eventState = state;
+        if (response.status === "REJECTED_PERMANENT" && error !== void 0) {
+          this.#rejectedHistory = [
+            ...this.#rejectedHistory,
+            {
+              operation: { ...operation, status: "REJECTED_PERMANENT", attempts: attempt + 1 },
+              reason: error,
+              errorCode: error.code,
+              rejectedAt: (/* @__PURE__ */ new Date()).toISOString(),
+              attempts: attempt + 1
+            }
+          ];
+          await this.#saveRejectedHistory();
+        }
+        this.#operations = this.#operations.slice(1);
+        await this.#storage.save(this.#storageKey(), this.#operations);
+        this.#announceChange();
+        await this.#syncResultListener?.({
+          operation,
+          ...result === void 0 ? {} : { result },
+          status: response.status,
+          ...error === void 0 ? {} : { error },
+          ...eventState === void 0 ? {} : { state: eventState }
+        });
+      }
+      this.#state = "idle";
+      this.#changeListener?.();
+    } catch (cause) {
+      this.#state = "error";
+      this.#error = cause instanceof Error ? cause : new Error(String(cause));
+      this.#changeListener?.();
+      throw this.#error;
+    } finally {
+      this.#releaseSyncLock();
+    }
+  }
+  async #updateOperationStatus(status, attempts) {
+    const operation = this.#operations[0];
+    if (operation === void 0) return;
+    this.#operations = [{ ...operation, status, attempts }, ...this.#operations.slice(1)];
+    await this.#storage.save(this.#storageKey(), this.#operations);
+    this.#announceChange();
   }
-  #open() {
-    if (this.#databasePromise !== null) return this.#databasePromise;
-    let factory = this.#providedFactory;
-    if (factory === void 0)
-      factory = globalThis.indexedDB;
-    if (factory === void 0 || factory === null)
-      return Promise.reject(new Error("IndexedDB is unavailable in this environment."));
-    this.#databasePromise = new Promise((resolve, reject) => {
-      const request = factory.open(this.#databaseName, 1);
-      request.onupgradeneeded = () => {
-        if (!request.result.objectStoreNames.contains("operations"))
-          request.result.createObjectStore("operations");
+  #subscribeToExternalChanges() {
+    const windowLike = globalThis.window;
+    if (windowLike !== void 0) {
+      this.#storageListener = (event) => {
+        if (event.key === this.#storageKey() || event.key === `${this.#storageKey()}:rejected-history`)
+          void this.#reloadFromStorage();
       };
-      request.onsuccess = () => resolve(request.result);
-      request.onerror = () => reject(request.error ?? new Error("Failed to open offline queue."));
-    }).catch((error) => {
-      this.#databasePromise = null;
-      throw error;
+      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) {
+            const data = event.data;
+            if (data.type === "lock" && data.lockKey === this.#lockKey()) {
+              this.#observedLocks.set(data.lockKey, {
+                owner: typeof data.owner === "string" ? data.owner : "unknown",
+                expiresAt: typeof data.expiresAt === "number" ? data.expiresAt : 0
+              });
+              return;
+            }
+            if (data.type === "unlock" && data.lockKey === this.#lockKey()) {
+              this.#observedLocks.delete(data.lockKey);
+              return;
+            }
+          }
+          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.#changeListener?.();
+    this.#channel?.postMessage({
+      type: "change",
+      key: this.#storageKey(),
+      owner: this.#instanceId
     });
-    return this.#databasePromise;
   }
-};
-function availableLocalStorage() {
-  try {
-    const storage = globalThis.localStorage;
-    return storage ?? null;
-  } catch {
-    return null;
+  async #reloadFromStorage() {
+    if (this.#state === "syncing") return;
+    try {
+      const key = this.#storageKey();
+      this.#operations = (await this.#storage.load(key)).map(normalizeOperation);
+      this.#rejectedHistory = (await this.#storage.loadRejectedHistory?.(key))?.map(normalizeRejectedHistory) ?? this.#rejectedHistory;
+      this.#loaded = true;
+    } catch {
+    }
   }
-}
-function defaultStorage(databaseName) {
-  try {
-    const indexedDB = globalThis.indexedDB;
-    if (indexedDB !== void 0)
-      return {
-        storage: new IndexedDBOfflineQueueStorage({
-          indexedDB,
-          ...databaseName === void 0 ? {} : { databaseName }
-        }),
-        capability: "indexeddb"
-      };
-    const storage = availableLocalStorage();
-    if (storage !== void 0 && storage !== null)
-      return { storage: new LocalStorageQueueStorage(storage), capability: "localstorage" };
-  } catch {
+  #lockKey() {
+    return `${this.#storageKey()}:sync-lock`;
   }
-  return { storage: new MemoryQueueStorage(), capability: "memory" };
-}
-function offlineOperationId(operation) {
-  const identity = operation.request.userId ?? operation.request.anonymousSessionId ?? "anonymous";
-  return operation.kind === "checkIn" ? `checkIn:${operation.request.rallyId}:${identity}:${operation.request.idempotencyKey}` : `claimReward:${operation.request.rallyId}:${identity}:${operation.request.idempotencyKey}`;
-}
-function requestScope(operation) {
-  return {
-    rallyId: operation.request.rallyId,
-    userId: operation.request.userId
-  };
-}
-function errorValue(value, fallbackCode) {
-  if (typeof value === "object" && value !== null) {
-    const candidate = value;
-    if (typeof candidate.code === "string" && typeof candidate.message === "string")
-      return { ...candidate, code: candidate.code, message: candidate.message };
+  #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;
+    const observed = this.#observedLocks.get(key);
+    if (observed !== void 0 && observed.expiresAt > now && observed.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 })
+        );
+        this.#channel?.postMessage({
+          type: "lock",
+          lockKey: key,
+          owner: this.#instanceId,
+          expiresAt: now + SYNC_LOCK_TTL_MS
+        });
+      } catch {
+        this.#warnMemoryLock("Persistent lock access failed; offline sync is single-tab only.");
+      }
+    }
+    syncLocks.set(key, { owner: this.#instanceId, expiresAt: now + SYNC_LOCK_TTL_MS });
+    return true;
   }
-  if (value instanceof Error) return { code: fallbackCode, message: value.message };
-  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;
-var DEFAULT_RETRY_OPTIONS = {
-  maxRetries: 0,
-  initialIntervalMs: 250,
-  backoffMultiplier: 2
-};
-function randomId() {
-  return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
-}
-var OfflineQueue = class {
-  #storage;
-  #queueCapability;
-  #configuredKey;
-  #rallyId;
-  #userId;
-  #conflictPolicy;
-  #onSyncConflict;
-  #operations = [];
-  #rejectedHistory = [];
-  #loaded = false;
-  #state = "idle";
-  #error = null;
-  #sender;
-  #syncPromise = null;
-  #syncResultListener;
-  #synchronizeInstances;
-  #retryOptions;
-  #instanceId = randomId();
-  #lockStorage;
-  #observedLocks = /* @__PURE__ */ new Map();
-  #warnedMemoryLock = false;
-  #storageListener;
-  #channel = null;
-  constructor(options = {}) {
-    if (options.storage !== void 0) {
-      this.#storage = options.storage;
-      this.#queueCapability = "custom";
-    } else if (options.storageLike !== void 0 && options.storageLike !== null) {
-      this.#storage = new LocalStorageQueueStorage(options.storageLike);
-      this.#queueCapability = "localstorage";
-    } else {
-      const selected = defaultStorage(options.databaseName);
-      this.#storage = selected.storage;
-      this.#queueCapability = selected.capability;
+  #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);
+        this.#channel?.postMessage({ type: "unlock", lockKey: key, owner: this.#instanceId });
+      } catch {
+      }
     }
-    this.#configuredKey = options.key;
-    this.#rallyId = options.rallyId;
-    this.#userId = options.userId ?? null;
-    this.#conflictPolicy = options.conflictPolicy ?? "server_wins";
-    this.#onSyncConflict = options.onSyncConflict;
-    this.#synchronizeInstances = options.synchronizeInstances ?? true;
-    const retryOptions = {
-      ...DEFAULT_RETRY_OPTIONS,
-      ...options.retryOptions ?? options.syncRetryOptions ?? options.retry ?? {}
-    };
-    this.#retryOptions = {
-      maxRetries: Math.max(0, Math.floor(retryOptions.maxRetries)),
-      initialIntervalMs: Math.max(0, retryOptions.initialIntervalMs),
-      backoffMultiplier: Math.max(1, retryOptions.backoffMultiplier)
-    };
-    this.#lockStorage = options.storageLike ?? availableLocalStorage();
-    if (this.#synchronizeInstances) this.#subscribeToExternalChanges();
   }
-  get syncState() {
-    return this.#state;
+  #storageKey() {
+    if (this.#configuredKey !== void 0) return this.#configuredKey;
+    return `stamprally:queue:${this.#rallyId ?? "unscoped"}:${this.#userId ?? "anonymous"}`;
   }
-  get pendingCount() {
-    return this.#operations.length;
+  #normalizeResponse(value) {
+    if ("ok" in value) {
+      if (value.ok === false) {
+        if ("status" in value && value.status === "RETRYABLE_ERROR")
+          return { status: "RETRYABLE_ERROR", error: errorValue(value.error, "RETRYABLE_ERROR") };
+        return { status: "REJECTED_PERMANENT", result: value };
+      }
+      return { status: "ACCEPTED", result: value };
+    }
+    if ("status" in value) {
+      if (value.status === "ACCEPTED") return value;
+      return value;
+    }
+    return { status: "ACCEPTED", result: value };
   }
-  get queueCapability() {
-    return this.#queueCapability;
+  async resolveConflict(operation, localState, serverState) {
+    const configured = this.#onSyncConflict;
+    const policy = (typeof configured === "function" ? await configured({ operation, localState, serverState }) : configured) ?? this.#conflictPolicy;
+    return resolveRallyStateConflict(serverState, localState, { policy });
   }
-  get rejectedHistory() {
-    return this.#rejectedHistory;
+  async #saveRejectedHistory() {
+    await this.#storage.saveRejectedHistory?.(this.#storageKey(), this.#rejectedHistory);
+  }
+  #warnMemoryLock(message) {
+    if (this.#warnedMemoryLock) return;
+    this.#warnedMemoryLock = true;
+    console.warn(`[@stamprally/core] ${message}`);
   }
-  get error() {
-    return this.#error;
+};
+function normalizeOperation(operation) {
+  const status = operation.status;
+  return {
+    ...operation,
+    status: status === "IN_FLIGHT" || status === "REJECTED" ? "PENDING" : status === "RETRYABLE_ERROR" ? "FAILED_RETRYABLE" : operation.status ?? "PENDING",
+    attempts: operation.attempts ?? 0
+  };
+}
+function normalizeRejectedHistory(entry) {
+  return {
+    ...entry,
+    operation: normalizeOperation(entry.operation),
+    reason: errorValue(entry.reason, "REJECTED_PERMANENT"),
+    errorCode: entry.errorCode || entry.reason.code,
+    rejectedAt: entry.rejectedAt || (/* @__PURE__ */ new Date(0)).toISOString(),
+    attempts: entry.attempts ?? entry.operation.attempts ?? 0
+  };
+}
+
+// src/client/client.ts
+function isStorage(value) {
+  return "load" in value && "save" in value && "remove" in value;
+}
+function id(prefix) {
+  return `${prefix}-${globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`}`;
+}
+function proof(value) {
+  if (typeof value === "string") return value;
+  if (typeof value === "object" && value !== null) {
+    const item = value;
+    for (const key of ["token", "code", "passcode", "value", "tagId"])
+      if (typeof item[key] === "string") return item[key];
   }
-  get operations() {
-    return this.#operations;
+  return "";
+}
+function matches(condition2, value) {
+  if (condition2.type === "gps") {
+    if (typeof value !== "object" || value === null) return false;
+    const item = value;
+    const latitude = item.latitude;
+    const longitude = item.longitude;
+    if (typeof latitude !== "number" || typeof longitude !== "number") return false;
+    const radians = (v) => v * Math.PI / 180;
+    const dLat = radians(latitude - condition2.latitude);
+    const dLon = radians(longitude - condition2.longitude);
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(radians(condition2.latitude)) * Math.cos(radians(latitude)) * Math.sin(dLon / 2) ** 2;
+    return 6371e3 * 2 * Math.asin(Math.sqrt(Math.min(1, h))) <= condition2.radiusMeters;
   }
-  get conflictPolicy() {
-    return this.#conflictPolicy;
+  return proof(value).trim() !== "";
+}
+function emptyState(config, userId, now) {
+  return {
+    rallyId: config.id,
+    userId,
+    records: [],
+    rewards: reconcileRewardStates(config.rewards, [], 0, now),
+    updatedAt: now
+  };
+}
+function errorMessage(error, fallback) {
+  return error !== void 0 && "message" in error && typeof error.message === "string" ? error.message : fallback;
+}
+var StampRallyClient = class {
+  #listeners = /* @__PURE__ */ new Set();
+  #eventListeners = /* @__PURE__ */ new Set();
+  #syncEventListeners = /* @__PURE__ */ new Set();
+  #storage;
+  #options;
+  #config;
+  #offlineQueue;
+  #userId;
+  #anonymousSessionId;
+  #state = null;
+  #initialization = null;
+  #queue = Promise.resolve();
+  #syncRevision = 0;
+  #syncMetrics = null;
+  constructor(config, storageOrOptions = {}) {
+    this.#config = config;
+    this.#options = isStorage(storageOrOptions) ? { storage: storageOrOptions } : storageOrOptions;
+    this.#storage = this.#options.storage ?? new InMemoryStorage();
+    this.#anonymousSessionId = this.#options.anonymousSessionId ?? createAnonymousSessionId();
+    this.#userId = this.#options.userId ?? this.#anonymousSessionId;
+    this.#offlineQueue = this.#options.offlineQueue;
+    this.#offlineQueue?.setSyncResultListener((event) => this.#handleOfflineSyncResult(event));
+    this.#offlineQueue?.setChangeListener(() => {
+      this.#syncRevision += 1;
+      if (this.#state !== null) this.#emit(this.#state);
+    });
   }
-  get storageKey() {
-    return this.#storageKey();
+  getConfig() {
+    return this.#config;
   }
-  get rallyId() {
-    return this.#rallyId;
+  getState() {
+    return this.#state;
   }
-  get userId() {
+  getUserId() {
     return this.#userId;
   }
-  setSyncResultListener(listener) {
-    this.#syncResultListener = listener;
+  getAnonymousSessionId() {
+    return this.#anonymousSessionId;
   }
-  async initialize() {
-    if (this.#loaded) return;
-    try {
-      const key = this.#storageKey();
-      this.#operations = (await this.#storage.load(key)).map(normalizeOperation);
-      this.#rejectedHistory = (await this.#storage.loadRejectedHistory?.(key))?.map(normalizeRejectedHistory) ?? [];
-    } catch (error) {
-      if (this.#queueCapability === "memory") throw error;
-      this.#storage = new MemoryQueueStorage();
-      this.#queueCapability = "memory";
-      this.#operations = [];
-      this.#rejectedHistory = [];
-      this.#warnMemoryLock(
-        `Offline queue persistence is unavailable; queued data can be lost after reload (${String(error)}).`
-      );
-    }
-    this.#loaded = true;
+  get syncState() {
+    return this.#offlineQueue?.syncState ?? "idle";
   }
-  /** 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();
+  get pendingCount() {
+    return this.#offlineQueue?.pendingCount ?? 0;
   }
-  /** Selects a rally/user queue scope and loads its pending operations. */
-  async setScope(rallyId, userId) {
-    if (this.#configuredKey !== void 0) {
-      this.#rallyId = rallyId;
-      this.#userId = userId;
-      return this.initialize();
-    }
-    if (this.#rallyId === rallyId && this.#userId === userId && this.#loaded) return;
-    this.#rallyId = rallyId;
-    this.#userId = userId;
-    this.#operations = [];
-    this.#loaded = false;
-    await this.initialize();
+  get rejectedHistory() {
+    return this.#offlineQueue?.rejectedHistory ?? [];
   }
-  async switchUser(newUserId) {
-    if (this.#rallyId === void 0)
-      throw new Error("OfflineQueue.switchUser requires a rally scope.");
-    await this.setScope(this.#rallyId, newUserId);
+  getSyncRevision() {
+    return this.#syncRevision;
   }
-  setSender(sender) {
-    this.#sender = sender;
+  get queueCapability() {
+    return this.#offlineQueue?.queueCapability ?? "custom";
   }
-  async enqueue(operation) {
-    if (this.#configuredKey === void 0) {
-      const scope = requestScope(operation);
-      if (this.#rallyId === void 0) await this.setScope(scope.rallyId, scope.userId);
-      if (this.#rallyId !== scope.rallyId || this.#userId !== scope.userId)
-        throw new Error("Offline operation belongs to another rally or user queue.");
-    }
-    await this.initialize();
-    const id2 = offlineOperationId(operation);
-    if (this.#operations.some((item) => offlineOperationId(item) === id2)) return;
-    this.#operations = [...this.#operations, { ...operation, status: "PENDING", attempts: 0 }];
-    await this.#storage.save(this.#storageKey(), this.#operations);
-    this.#announceChange();
+  discardRejected(operationId) {
+    return this.#offlineQueue?.discardRejected(operationId) ?? Promise.resolve(false);
   }
-  async enqueueCheckIn(request) {
-    return this.enqueue({ kind: "checkIn", request });
+  retryRejected(operationId) {
+    return this.#offlineQueue?.retryRejected(operationId) ?? Promise.resolve(false);
   }
-  async enqueueClaimReward(request) {
-    return this.enqueue({ kind: "claimReward", request });
+  dismissRejectedOperation(operationId) {
+    return this.discardRejected(operationId);
   }
-  async clear() {
-    await this.initialize();
-    this.#operations = [];
-    await this.#storage.save(this.#storageKey(), this.#operations);
-    this.#announceChange();
+  retryOperation(operationId) {
+    return this.retryRejected(operationId);
   }
-  async discardRejected(operationId) {
-    await this.initialize();
-    const next = this.#rejectedHistory.filter(
-      (entry) => offlineOperationId(entry.operation) !== operationId
-    );
-    if (next.length === this.#rejectedHistory.length) return false;
-    this.#rejectedHistory = next;
-    await this.#saveRejectedHistory();
-    this.#announceChange();
-    return true;
+  subscribe(listener) {
+    this.#listeners.add(listener);
+    return () => this.#listeners.delete(listener);
   }
-  async retryRejected(operationId) {
-    await this.initialize();
-    const entry = this.#rejectedHistory.find(
-      (candidate) => offlineOperationId(candidate.operation) === operationId
-    );
-    if (entry === void 0) return false;
-    if (!this.#operations.some((operation) => offlineOperationId(operation) === operationId))
-      this.#operations = [
-        ...this.#operations,
-        { ...entry.operation, status: "PENDING", attempts: 0 }
-      ];
-    this.#rejectedHistory = this.#rejectedHistory.filter((candidate) => candidate !== entry);
-    await this.#storage.save(this.#storageKey(), this.#operations);
-    await this.#saveRejectedHistory();
-    this.#announceChange();
-    return true;
+  subscribeEvents(listener) {
+    this.#eventListeners.add(listener);
+    return () => this.#eventListeners.delete(listener);
   }
-  async discardRejectedOperation(operationId) {
-    return this.discardRejected(operationId);
+  subscribeSyncEvents(listener) {
+    this.#syncEventListeners.add(listener);
+    return () => this.#syncEventListeners.delete(listener);
   }
-  async retryRejectedOperation(operationId) {
-    return this.retryRejected(operationId);
+  subscribeSyncState(listener) {
+    const wrapped = () => listener();
+    this.#listeners.add(wrapped);
+    return () => this.#listeners.delete(wrapped);
   }
-  async clearRejectedHistory() {
-    await this.initialize();
-    if (this.#rejectedHistory.length === 0) return;
-    this.#rejectedHistory = [];
-    await this.#saveRejectedHistory();
-    this.#announceChange();
+  init() {
+    return this.initialize();
   }
-  async sync(sender = this.#sender) {
-    await this.initialize();
-    if (sender === void 0) throw new Error("OfflineQueue.sync requires a sender.");
-    if (this.#syncPromise !== null) return this.#syncPromise;
-    this.#sender = sender;
-    this.#syncPromise = this.#run(sender).finally(() => {
-      this.#syncPromise = null;
+  initialize() {
+    if (this.#state !== null) return Promise.resolve(this.#state);
+    if (this.#initialization === null) {
+      this.#initialization = (async () => {
+        await this.#offlineQueue?.setScope(this.#config.id, this.#userId);
+        return this.#storage.load(this.#config.id, this.#userId);
+      })().then((state) => {
+        const next = state === null ? emptyState(this.#config, this.#userId, this.#now()) : this.#reconcile(state);
+        this.#state = next;
+        this.#emit(next);
+        return next;
+      }).catch((error) => {
+        this.#initialization = null;
+        throw error;
+      });
+    }
+    return this.#initialization;
+  }
+  switchUser(newUserId) {
+    return this.#enqueue(async () => {
+      const nextUserId = newUserId ?? this.#anonymousSessionId;
+      if (this.#userId === nextUserId && this.#state !== null) return this.#state;
+      this.#userId = nextUserId;
+      this.#state = null;
+      this.#initialization = null;
+      await this.#offlineQueue?.switchUser(nextUserId);
+      return this.initialize();
     });
-    return this.#syncPromise;
   }
-  async retrySync(sender = this.#sender) {
-    return this.sync(sender);
+  async getUserState(rallyId, userId) {
+    return this.#storage.load(rallyId, userId);
   }
-  async #run(sender) {
-    const locks = globalThis.navigator?.locks;
-    if (locks !== void 0 && typeof locks.request === "function") {
-      let callbackStarted = false;
-      try {
-        const acquired = await locks.request(
-          `stamprally:${this.#storageKey()}:sync`,
-          { ifAvailable: true },
-          async (lock) => {
-            if (lock === null) {
-              await this.#reloadFromStorage();
-              this.#state = "idle";
-              return false;
-            }
-            callbackStarted = true;
-            await this.#runWithStorageLock(sender);
-            return true;
-          }
-        );
-        if (!acquired) return;
-        return;
-      } catch (error) {
-        if (callbackStarted) throw error;
+  clearUserState(userId = this.#userId) {
+    return this.#enqueue(async () => {
+      await this.#storage.remove(this.#config.id, userId);
+      if (userId === this.#userId) {
+        await this.#initializeFresh();
       }
-    }
-    if (this.#lockStorage === null)
-      this.#warnMemoryLock(
-        "No cross-tab storage lock is available; offline sync is single-tab only."
-      );
-    await this.#runWithStorageLock(sender);
+    });
   }
-  async #runWithStorageLock(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];
-        if (operation === void 0) break;
-        let attempt = 0;
-        let response;
-        while (true) {
-          await this.#updateOperationStatus("IN_FLIGHT", attempt);
-          try {
-            response = this.#normalizeResponse(await sender(operation));
-          } catch (cause) {
-            response = {
-              status: "RETRYABLE_ERROR",
-              error: errorValue(cause, "RETRYABLE_ERROR")
-            };
-          }
-          if (response.status !== "RETRYABLE_ERROR") break;
-          const error2 = errorValue(response.error ?? response.reason, "RETRYABLE_ERROR");
-          await this.#updateOperationStatus("PENDING", attempt + 1);
-          await this.#syncResultListener?.({ operation, status: response.status, error: error2 });
-          if (attempt >= this.#retryOptions.maxRetries) {
-            await this.#updateOperationStatus("FAILED_RETRYABLE", attempt + 1);
-            throw new Error(error2.message);
-          }
-          const interval = this.#retryOptions.initialIntervalMs * this.#retryOptions.backoffMultiplier ** attempt;
-          await new Promise((resolve) => setTimeout(resolve, Math.max(0, interval)));
-          attempt += 1;
-        }
-        const result = response.result;
-        const state = response.state ?? (result !== void 0 && "conflict" in result && result.conflict === true ? result.serverState : result !== void 0 && "ok" in result && result.ok ? result.value.state : void 0);
-        const error = response.status === "REJECTED_PERMANENT" ? errorValue(
-          response.error ?? response.reason ?? (result !== void 0 && "ok" in result && !result.ok ? result.error : void 0),
-          "REJECTED_PERMANENT"
-        ) : void 0;
-        await this.#updateOperationStatus(
-          response.status === "ACCEPTED" ? "ACCEPTED" : "REJECTED_PERMANENT",
-          attempt + 1
-        );
-        const eventState = state;
-        if (response.status === "REJECTED_PERMANENT" && error !== void 0) {
-          this.#rejectedHistory = [
-            ...this.#rejectedHistory,
-            {
-              operation: { ...operation, status: "REJECTED_PERMANENT", attempts: attempt + 1 },
-              reason: error,
-              errorCode: error.code,
-              rejectedAt: (/* @__PURE__ */ new Date()).toISOString(),
-              attempts: attempt + 1
-            }
-          ];
-          await this.#saveRejectedHistory();
-        }
-        this.#operations = this.#operations.slice(1);
-        await this.#storage.save(this.#storageKey(), this.#operations);
-        this.#announceChange();
-        await this.#syncResultListener?.({
-          operation,
-          ...result === void 0 ? {} : { result },
-          status: response.status,
-          ...error === void 0 ? {} : { error },
-          ...eventState === void 0 ? {} : { state: eventState }
+  checkIn(spotId, proofData, options = {}) {
+    return this.#enqueue(async () => {
+      const current = await this.initialize();
+      const spot2 = this.#config.spots.find((item) => item.id === spotId);
+      if (spot2 === void 0)
+        return this.#fail({ code: "SPOT_NOT_FOUND", spotId, message: "Spot was not found." });
+      if (current.records.some((record2) => record2.stampId === spotId))
+        return this.#fail({
+          code: "STAMP_ALREADY_ACQUIRED",
+          spotId,
+          message: "Spot was already claimed."
+        });
+      const acquired = new Set(current.records.map((record2) => record2.stampId));
+      if (spot2.prerequisites?.some((id2) => !acquired.has(id2)))
+        return this.#fail({
+          code: "PREREQUISITES_NOT_MET",
+          spotId,
+          message: "Prerequisite spots are not complete."
         });
+      for (const condition2 of spot2.conditions) {
+        if (condition2.type === "custom") {
+          const validator = this.#options.customValidators?.[condition2.validatorName] ?? this.#options.customValidator;
+          if (validator === void 0)
+            return this.#fail({
+              code: "CUSTOM_VALIDATION_FAILED",
+              spotId,
+              message: "No custom validator is registered."
+            });
+          const context = {
+            rallyId: this.#config.id,
+            spotId,
+            proofData,
+            condition: { type: "custom", validatorName: condition2.validatorName },
+            userState: current
+          };
+          const result = typeof validator === "function" ? await validator(context) : await validator.validate(context);
+          if (result === false || typeof result === "object" && !result.valid)
+            return this.#fail({
+              code: "CUSTOM_VALIDATION_FAILED",
+              spotId,
+              message: typeof result === "object" && result.message !== void 0 ? result.message : "Custom validation failed."
+            });
+        } else if (!matches(condition2, proofData))
+          return this.#fail({ code: "INVALID_PROOF", spotId, message: "Verification failed." });
       }
-      this.#state = "idle";
-    } catch (cause) {
-      this.#state = "error";
-      this.#error = cause instanceof Error ? cause : new Error(String(cause));
-      throw this.#error;
-    } finally {
-      this.#releaseSyncLock();
-    }
-  }
-  async #updateOperationStatus(status, attempts) {
-    const operation = this.#operations[0];
-    if (operation === void 0) return;
-    this.#operations = [{ ...operation, status, attempts }, ...this.#operations.slice(1)];
-    await this.#storage.save(this.#storageKey(), this.#operations);
-    this.#announceChange();
+      const now = options.now ?? this.#now();
+      const request = {
+        rallyId: this.#config.id,
+        userId: this.#userId,
+        spotId,
+        proofData,
+        idempotencyKey: options.idempotencyKey ?? id("check-in"),
+        now,
+        state: current,
+        ...this.#userId === this.#anonymousSessionId ? { anonymousSessionId: this.#anonymousSessionId } : {}
+      };
+      const remote = this.#options.syncAdapter?.checkIn;
+      if (options.sync !== false && remote !== void 0) {
+        try {
+          const result = await remote(request);
+          return result.ok ? this.#commitCheckIn(result) : this.#fail(result.error);
+        } catch (error) {
+          if (this.#offlineQueue === void 0) throw error;
+          await this.#offlineQueue.enqueueCheckIn(request);
+          const record2 = { stampId: spotId, acquiredAt: now };
+          const next2 = this.#reconcile({
+            ...current,
+            records: [...current.records, record2],
+            updatedAt: now
+          });
+          await this.#storage.save(next2);
+          return this.#commitCheckIn({ ok: true, value: { state: next2, record: record2 } });
+        }
+      }
+      const record = { stampId: spotId, acquiredAt: now };
+      const next = this.#reconcile({
+        ...current,
+        records: [...current.records, record],
+        updatedAt: now
+      });
+      await this.#storage.save(next);
+      return this.#commitCheckIn({ ok: true, value: { state: next, record } });
+    });
   }
-  #subscribeToExternalChanges() {
-    const windowLike = globalThis.window;
-    if (windowLike !== void 0) {
-      this.#storageListener = (event) => {
-        if (event.key === this.#storageKey() || event.key === `${this.#storageKey()}:rejected-history`)
-          void this.#reloadFromStorage();
+  claimReward(rewardId, options = {}) {
+    return this.#enqueue(async () => {
+      const current = await this.initialize();
+      const configured = this.#config.rewards.find((item) => item.id === rewardId);
+      if (configured === void 0)
+        return this.#fail({ code: "REWARD_NOT_FOUND", rewardId, message: "Reward was not found." });
+      const now = options.now ?? this.#now();
+      const state = current.rewards.find((item) => item.rewardId === rewardId) ?? {
+        rewardId,
+        status: "LOCKED"
+      };
+      const local = consumeReward({
+        reward: configured,
+        currentState: state,
+        now,
+        ...options.staffPasscode === void 0 ? {} : { inputPasscode: options.staffPasscode },
+        ...options.staffId === void 0 ? {} : { staffId: options.staffId }
+      });
+      if (!local.ok) return this.#fail(local.error);
+      const request = {
+        rallyId: this.#config.id,
+        userId: this.#userId,
+        rewardId,
+        idempotencyKey: options.idempotencyKey ?? id("claim"),
+        now,
+        options,
+        state: current,
+        ...this.#userId === this.#anonymousSessionId ? { anonymousSessionId: this.#anonymousSessionId } : {}
+      };
+      const remote = this.#options.syncAdapter?.claimReward;
+      if (options.sync !== false && remote !== void 0) {
+        try {
+          const result = await remote(request);
+          return result.ok ? this.#commitClaim(result) : this.#fail(result.error);
+        } catch (error) {
+          if (this.#offlineQueue === void 0) throw error;
+          await this.#offlineQueue.enqueueClaimReward(request);
+          const next2 = {
+            ...current,
+            rewards: current.rewards.map(
+              (item) => item.rewardId === rewardId ? local.value : item
+            ),
+            updatedAt: now
+          };
+          await this.#storage.save(next2);
+          return this.#commitClaim({ ok: true, value: { state: next2, reward: local.value } });
+        }
+      }
+      const next = {
+        ...current,
+        rewards: current.rewards.map((item) => item.rewardId === rewardId ? local.value : item),
+        updatedAt: now
       };
-      windowLike.addEventListener("storage", this.#storageListener);
-    }
-    const Channel = globalThis.BroadcastChannel;
-    if (Channel !== void 0) {
+      await this.#storage.save(next);
+      return this.#commitClaim({ ok: true, value: { state: next, reward: local.value } });
+    });
+  }
+  sync(adapter = this.#options.syncAdapter) {
+    return this.#enqueue(async () => {
+      this.#emitSyncEvent({ type: "SYNC_STARTED" });
+      this.#syncMetrics = { processed: 0, failed: 0 };
       try {
-        this.#channel = new Channel("stamprally:queue-sync");
-        this.#channel.addEventListener("message", (event) => {
-          if (typeof event.data === "object" && event.data !== null) {
-            const data = event.data;
-            if (data.type === "lock" && data.lockKey === this.#lockKey()) {
-              this.#observedLocks.set(data.lockKey, {
-                owner: typeof data.owner === "string" ? data.owner : "unknown",
-                expiresAt: typeof data.expiresAt === "number" ? data.expiresAt : 0
-              });
-              return;
-            }
-            if (data.type === "unlock" && data.lockKey === this.#lockKey()) {
-              this.#observedLocks.delete(data.lockKey);
-              return;
+        const current = await this.initialize();
+        if (this.#offlineQueue !== void 0 && adapter !== void 0) {
+          await this.#offlineQueue.sync(async (operation) => {
+            if (operation.kind === "checkIn") {
+              if (adapter.checkIn === void 0)
+                throw new Error("No check-in sync adapter is configured.");
+              return adapter.checkIn(operation.request);
             }
-          }
-          if (typeof event.data === "object" && event.data !== null && "key" in event.data && event.data.key === this.#storageKey())
-            void this.#reloadFromStorage();
+            if (adapter.claimReward === void 0)
+              throw new Error("No reward sync adapter is configured.");
+            return adapter.claimReward(operation.request);
+          });
+        }
+        if (adapter?.sync === void 0) {
+          this.#emitEvent({ type: "sync", state: this.#state ?? current });
+          return;
+        }
+        const localState = this.#state ?? current;
+        const serverState = await adapter.sync({
+          rallyId: this.#config.id,
+          userId: this.#userId,
+          state: localState,
+          ...this.#userId === this.#anonymousSessionId ? { anonymousSessionId: this.#anonymousSessionId } : {}
+        });
+        const resolved = resolveRallyStateConflict(serverState, localState, {
+          policy: this.#options.conflictResolutionPolicy ?? this.#options.conflictPolicy ?? "authoritative_replay"
+        });
+        const next = this.#reconcile(resolved);
+        await this.#storage.save(next);
+        this.#state = next;
+        this.#emit(next);
+        this.#emitEvent({ type: "sync", state: next });
+      } finally {
+        const metrics = this.#syncMetrics ?? { processed: 0, failed: 0 };
+        this.#syncMetrics = null;
+        this.#emitSyncEvent({
+          type: "SYNC_COMPLETED",
+          totalProcessed: metrics.processed,
+          failedCount: metrics.failed
         });
-      } catch {
-        this.#channel = null;
       }
-    }
+    });
   }
-  #announceChange() {
-    this.#channel?.postMessage({
-      type: "change",
-      key: this.#storageKey(),
-      owner: this.#instanceId
+  retrySync() {
+    return this.sync();
+  }
+  reset() {
+    return this.#enqueue(async () => {
+      await this.#storage.remove(this.#config.id, this.#userId);
+      return this.#initializeFresh();
     });
   }
-  async #reloadFromStorage() {
-    if (this.#state === "syncing") return;
-    try {
-      const key = this.#storageKey();
-      this.#operations = (await this.#storage.load(key)).map(normalizeOperation);
-      this.#rejectedHistory = (await this.#storage.loadRejectedHistory?.(key))?.map(normalizeRejectedHistory) ?? this.#rejectedHistory;
-      this.#loaded = true;
-    } catch {
-    }
+  restore(state) {
+    return this.#enqueue(async () => {
+      if (state.rallyId !== this.#config.id || state.userId !== this.#userId)
+        throw new Error("State belongs to another rally or user.");
+      const next = this.#reconcile(state);
+      await this.#storage.save(next);
+      this.#state = next;
+      this.#initialization = Promise.resolve(next);
+      this.#emit(next);
+      return next;
+    });
   }
-  #lockKey() {
-    return `${this.#storageKey()}:sync-lock`;
+  #enqueue(operation) {
+    const next = this.#queue.then(operation, operation);
+    this.#queue = next.then(
+      () => void 0,
+      () => void 0
+    );
+    return next;
   }
-  #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;
-    const observed = this.#observedLocks.get(key);
-    if (observed !== void 0 && observed.expiresAt > now && observed.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 })
-        );
-        this.#channel?.postMessage({
-          type: "lock",
-          lockKey: key,
-          owner: this.#instanceId,
-          expiresAt: now + SYNC_LOCK_TTL_MS
-        });
-      } catch {
-        this.#warnMemoryLock("Persistent lock access failed; offline sync is single-tab only.");
-      }
-    }
-    syncLocks.set(key, { owner: this.#instanceId, expiresAt: now + SYNC_LOCK_TTL_MS });
-    return true;
+  #initializeFresh() {
+    const next = emptyState(this.#config, this.#userId, this.#now());
+    this.#state = next;
+    this.#initialization = Promise.resolve(next);
+    this.#emit(next);
+    return Promise.resolve(next);
   }
-  #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);
-        this.#channel?.postMessage({ type: "unlock", lockKey: key, owner: this.#instanceId });
-      } catch {
+  #reconcile(state) {
+    const ids = new Set(this.#config.spots.map((spot2) => spot2.id));
+    const records = state.records.filter(
+      (record, index, all) => ids.has(record.stampId) && all.findIndex((candidate) => candidate.stampId === record.stampId) === index
+    );
+    return {
+      ...cloneState(state),
+      userId: this.#userId,
+      records,
+      rewards: reconcileRewardStates(
+        this.#config.rewards,
+        state.rewards,
+        records.length,
+        state.updatedAt
+      )
+    };
+  }
+  async #handleOfflineSyncResult(event) {
+    if (event.status === "ACCEPTED") {
+      if (this.#syncMetrics !== null) this.#syncMetrics.processed += 1;
+      if (event.state !== void 0) {
+        const next = this.#reconcile(event.state);
+        await this.#storage.save(next);
+        this.#state = next;
+        this.#emit(next);
+      }
+      this.#emitSyncEvent({
+        type: "OPERATION_ACCEPTED",
+        operationId: this.#operationId(event.operation),
+        resourceId: this.#resourceId(event.operation)
+      });
+    } else if (event.status === "REJECTED_PERMANENT") {
+      const error = event.error ?? {
+        code: "REJECTED_PERMANENT",
+        message: "Offline operation was rejected."
+      };
+      if (this.#syncMetrics !== null) {
+        this.#syncMetrics.processed += 1;
+        this.#syncMetrics.failed += 1;
       }
+      const base = event.state ?? this.#state ?? event.operation.request.state;
+      const next = this.#reconcile(rollbackOptimisticOperation(base, event.operation));
+      await this.#storage.save(next);
+      this.#state = next;
+      this.#emit(next);
+      this.#emitSyncEvent({
+        type: "OPERATION_ROLLED_BACK",
+        operationId: this.#operationId(event.operation),
+        resourceId: this.#resourceId(event.operation),
+        reason: errorMessage(error, "Offline operation was rejected."),
+        errorCode: error.code
+      });
+    } else if (event.status === "RETRYABLE_ERROR") {
+      if (this.#syncMetrics !== null) this.#syncMetrics.failed += 1;
+      this.#emitSyncEvent({
+        type: "OPERATION_RETRYABLE_ERROR",
+        operationId: this.#operationId(event.operation),
+        error: errorMessage(event.error, "Retryable sync error.")
+      });
+    }
+    if (event.state !== void 0 && event.status === void 0) {
+      const next = this.#reconcile(event.state);
+      await this.#storage.save(next);
+      this.#state = next;
+      this.#emit(next);
     }
+    if (event.error !== void 0) this.#emitEvent({ type: "error", error: event.error });
+    else if (event.result !== void 0 && "ok" in event.result && !event.result.ok)
+      this.#emitEvent({ type: "error", error: event.result.error });
   }
-  #storageKey() {
-    if (this.#configuredKey !== void 0) return this.#configuredKey;
-    return `stamprally:queue:${this.#rallyId ?? "unscoped"}:${this.#userId ?? "anonymous"}`;
+  #now() {
+    return this.#options.clock?.() ?? (/* @__PURE__ */ new Date()).toISOString();
   }
-  #normalizeResponse(value) {
-    if ("ok" in value) {
-      if (value.ok === false) {
-        if ("status" in value && value.status === "RETRYABLE_ERROR")
-          return { status: "RETRYABLE_ERROR", error: errorValue(value.error, "RETRYABLE_ERROR") };
-        return { status: "REJECTED_PERMANENT", result: value };
-      }
-      return { status: "ACCEPTED", result: value };
+  #fail(error) {
+    this.#emitEvent({ type: "error", error });
+    return { ok: false, error };
+  }
+  #commitCheckIn(result) {
+    if (result.ok) {
+      this.#state = result.value.state;
+      this.#emit(this.#state);
     }
-    if ("status" in value) {
-      if (value.status === "ACCEPTED") return value;
-      return value;
+    this.#emitEvent({ type: "checkIn", result });
+    return result;
+  }
+  #commitClaim(result) {
+    if (result.ok) {
+      this.#state = result.value.state;
+      this.#emit(this.#state);
     }
-    return { status: "ACCEPTED", result: value };
+    this.#emitEvent({ type: "rewardClaimed", result });
+    return result;
   }
-  async resolveConflict(operation, localState, serverState) {
-    const configured = this.#onSyncConflict;
-    const policy = (typeof configured === "function" ? await configured({ operation, localState, serverState }) : configured) ?? this.#conflictPolicy;
-    return resolveRallyStateConflict(serverState, localState, { policy });
+  #emit(state) {
+    for (const listener of this.#listeners) listener(state);
   }
-  async #saveRejectedHistory() {
-    await this.#storage.saveRejectedHistory?.(this.#storageKey(), this.#rejectedHistory);
+  #emitEvent(event) {
+    for (const listener of this.#eventListeners) listener(event);
   }
-  #warnMemoryLock(message) {
-    if (this.#warnedMemoryLock) return;
-    this.#warnedMemoryLock = true;
-    console.warn(`[@stamprally/core] ${message}`);
+  #emitSyncEvent(event) {
+    for (const listener of this.#syncEventListeners) listener(event);
+    this.#emitEvent({ type: "syncLifecycle", event });
+  }
+  #operationId(operation) {
+    const identity = operation.request.userId ?? operation.request.anonymousSessionId ?? "anonymous";
+    return `${operation.kind}:${operation.request.rallyId}:${identity}:${operation.request.idempotencyKey}`;
+  }
+  #resourceId(operation) {
+    return operation.kind === "checkIn" ? operation.request.spotId : operation.request.rewardId;
   }
 };
-function normalizeOperation(operation) {
-  const status = operation.status;
-  return {
-    ...operation,
-    status: status === "IN_FLIGHT" || status === "REJECTED" ? "PENDING" : status === "RETRYABLE_ERROR" ? "FAILED_RETRYABLE" : operation.status ?? "PENDING",
-    attempts: operation.attempts ?? 0
-  };
-}
-function normalizeRejectedHistory(entry) {
-  return {
-    ...entry,
-    operation: normalizeOperation(entry.operation),
-    reason: errorValue(entry.reason, "REJECTED_PERMANENT"),
-    errorCode: entry.errorCode || entry.reason.code,
-    rejectedAt: entry.rejectedAt || (/* @__PURE__ */ new Date(0)).toISOString(),
-    attempts: entry.attempts ?? entry.operation.attempts ?? 0
-  };
-}
 
 // src/crypto/token.ts
 var encoder = new TextEncoder();
@@ -2624,6 +2768,18 @@ function finiteNumber(value, key, path, errors, minimum) {
     );
   }
 }
+function nonNegativeInteger(value, key, path, errors) {
+  const item = value[key];
+  if (typeof item !== "number" || !Number.isFinite(item)) {
+    add(errors, `${path}.${key}`, "Expected a finite number.", "invalid_number");
+    return;
+  }
+  if (!Number.isInteger(item)) {
+    add(errors, `${path}.${key}`, "Expected a non-negative integer.", "invalid_integer");
+    return;
+  }
+  if (item < 0) add(errors, `${path}.${key}`, "Expected a non-negative integer.", "out_of_range");
+}
 function localizedText(value, path, errors) {
   if (typeof value === "string") return;
   if (!isRecord3(value)) {
@@ -2818,9 +2974,7 @@ function reward(value, path, errors, isPublic) {
   finiteNumber(value, "requiredStampCount", path, errors, 0);
   for (const key of ["stockLimit", "userClaimLimit"]) {
     if (hasOwn(value, key) && value[key] !== void 0) {
-      finiteNumber(value, key, path, errors, 0);
-      if (typeof value[key] === "number" && !Number.isInteger(value[key]))
-        add(errors, `${path}.${key}`, "Expected an integer.", "invalid_integer");
+      nonNegativeInteger(value, key, path, errors);
     }
   }
   optionalString(value, "validUntil", path, errors);
@@ -2866,8 +3020,14 @@ function validate(value, isPublic) {
     });
   if (!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, "inventory") && value.inventory !== void 0) {
+      if (!isRecord3(value.inventory))
+        add(errors, "$.inventory", "Expected an object.", "invalid_type");
+      else {
+        for (const [key, item] of Object.entries(value.inventory))
+          if (item !== void 0) nonNegativeInteger(value.inventory, key, "$.inventory", errors);
+      }
+    }
     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))
@@ -3156,6 +3316,7 @@ exports.readQrContext = readQrContext;
 exports.reconcileRewardStates = reconcileRewardStates;
 exports.resolveLocalizedText = resolveLocalizedText;
 exports.resolveRallyStateConflict = resolveRallyStateConflict;
+exports.rollbackOptimisticOperation = rollbackOptimisticOperation;
 exports.safeParseAdminConfig = safeParseAdminConfig;
 exports.safeParsePublicConfig = safeParsePublicConfig;
 exports.sanitizeAdminConfig = sanitizeAdminConfig;