@stamprally/core 0.20.0 → 0.21.0

package/README.md

@@ -1,4 +1,4 @@
-# @stamprally/core v0.20.0
+# @stamprally/core v0.21.0
 
 Dependency-free domain models, immutable state transitions, storage adapters, browser detectors, and safe configuration parsers.
 
@@ -7,7 +7,7 @@ import { InMemoryStorage, StampRallyClient, type PublicRallyConfig } from "@stam
 
 const config: PublicRallyConfig = {
   id: "city-tour",
-  version: "0.20.0",
+  version: "0.21.0",
   title: "City Tour",
   spots: [{ id: "station", orderIndex: 0, name: "Central Station", conditions: [{ type: "passcode" }] }],
   rewards: [],
@@ -23,7 +23,7 @@ The browser detectors `getCurrentGeoContext`, `readNfcContext`, and `readQrConte
 
 `InMemoryStorage`, `LocalStorageAdapter`, and `IndexedDBAdapter` implement `StampStorage`. `updateLocalizedField` updates one locale without dropping existing translations.
 
-## v0.17.0 offline synchronization
+## v0.21.0 offline synchronization
 
 Configure `OfflineQueue` with `rallyId` and `userId` to persist pending work under
 `stamprally:queue:<rallyId>:<userId-or-anonymous>`. `switchUser` loads the other
@@ -35,7 +35,7 @@ When no authenticated user is supplied, the client creates a persistent UUID v4
 `anonymousSessionId` and includes it in sync requests. Queue replay uses Web Locks
 when available and supports bounded exponential backoff through `retryOptions`.
 
-### v0.20.0 batch sync and storage capability
+### v0.21.0 batch sync, queue capability, and storage capability
 
 An adapter can return `SyncProgressResponse` from `sync` when it sends queued
 operations to a server-side `syncProgress` endpoint. The adapter passes queued
@@ -62,6 +62,11 @@ cross-tab automatic synchronization is disabled, the foreground tab must trigger
 sync explicitly, and a `storageCapabilityWarning` event is emitted. localStorage
 may still be used for durable queue data, but it is never used as a lock.
 
+`client.queueCapability` also exposes `mode` (`"persistent"` or
+`"volatile_memory"`), `isPersistent`, and the actual `storage` type. The
+deprecated `legacy` property and `getLegacyQueueCapability` helper expose
+`"persistent"` or `"volatile"` while callers migrate to `mode`.
+
 `evaluateSpotStatus` derives `UNCLAIMED`, `CLAIMED`, `LOCKED`, or `VERIFYING`
 without mutating state. A spot with incomplete `prerequisites` is `LOCKED` and
 must not be verified by a client or viewer.

package/dist/index.cjs

@@ -1007,6 +1007,9 @@ var IndexedDBAdapter = class {
 };
 
 // src/client/offlineQueue.ts
+function getLegacyQueueCapability(capability) {
+  return capability.isPersistent ? "persistent" : "volatile";
+}
 function rollbackOptimisticOperation(state, operation) {
   const previous = operation.request.state;
   if (operation.kind === "checkIn") {
@@ -1265,9 +1268,13 @@ var OfflineQueue = class {
     return this.#operations.length;
   }
   get queueCapability() {
+    const isPersistent = this.#queueCapability !== "memory";
     return {
       storage: this.#queueCapability,
-      multiTabSync: this.#hasWebLocks() ? "supported_web_locks" : "disabled_unsafe_environment"
+      mode: isPersistent ? "persistent" : "volatile_memory",
+      multiTabSync: this.#hasWebLocks() ? "supported_web_locks" : "disabled_unsafe_environment",
+      isPersistent,
+      legacy: isPersistent ? "persistent" : "volatile"
     };
   }
   get storageCapability() {
@@ -1991,7 +1998,10 @@ var StampRallyClient = class {
   get queueCapability() {
     return this.#offlineQueue?.queueCapability ?? {
       storage: "custom",
-      multiTabSync: "disabled_unsafe_environment"
+      mode: "persistent",
+      multiTabSync: "disabled_unsafe_environment",
+      isPersistent: true,
+      legacy: "persistent"
     };
   }
   get storageCapability() {
@@ -3481,6 +3491,7 @@ exports.evaluateConditionDetailed = evaluateConditionDetailed;
 exports.evaluateSpotStatus = evaluateSpotStatus;
 exports.exportProgressToken = exportProgressToken;
 exports.getCurrentGeoContext = getCurrentGeoContext;
+exports.getLegacyQueueCapability = getLegacyQueueCapability;
 exports.getOrderedSpots = getOrderedSpots;
 exports.getSpotStatus = getSpotStatus;
 exports.importProgressToken = importProgressToken;