@sweidos/eidos 2.1.0 → 2.3.0

package/dist/action.js

@@ -1,11 +1,11 @@
 import { useEidosStore as l } from "./store.js";
 import { getSwRegistration as A } from "./sw-bridge.js";
 import { idbQueueStorage as C } from "./idb.js";
-import { _getQueueStorage as _ } from "./queue-storage.js";
-import { broadcastQueueSync as u } from "./queue-sync.js";
-var w = /* @__PURE__ */ new Map(), R = /* @__PURE__ */ new Map(), Q = /* @__PURE__ */ new Map(), k = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map();
+import { _getQueueStorage as S } from "./queue-storage.js";
+import { broadcastQueueSync as s } from "./queue-sync.js";
+var g = /* @__PURE__ */ new Map(), I = /* @__PURE__ */ new Map(), Q = /* @__PURE__ */ new Map(), k = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map();
 function c() {
-  return _() ?? C;
+  return S() ?? C;
 }
 function m() {
   return crypto.randomUUID();
@@ -15,29 +15,29 @@ function v(e, t, n) {
 }
 function B(e, t) {
   const n = t.name || e.name || m(), a = t.namespace ? `${t.namespace}::${n}` : n;
-  if (w.has(a)) throw new Error(`[eidos] duplicate action id "${a}" — an action with this id is already registered. Pass a unique config.name or config.namespace.`);
-  w.set(a, e), k.set(a, t), t.onRollback && R.set(a, t.onRollback), t.conflict && Q.set(a, t.conflict);
+  if (g.has(a)) throw new Error(`[eidos] duplicate action id "${a}" — an action with this id is already registered. Pass a unique config.name or config.namespace.`);
+  g.set(a, e), k.set(a, t), t.onRollback && I.set(a, t.onRollback), t.conflict && Q.set(a, t.conflict);
   const i = async (...r) => {
-    const { isOnline: o } = l.getState(), s = m();
+    const { isOnline: o } = l.getState(), u = m();
     let b;
     if (t.cancellable) {
       const d = new AbortController();
-      p.set(s, d), b = d.signal;
+      p.set(u, d), b = d.signal;
     }
     const y = {
-      idempotencyKey: s,
+      idempotencyKey: u,
       attempt: 0,
       signal: b
     };
     t.onOptimistic?.(...r, y);
     try {
       if (t.reliability === "neverLose") {
-        if (!o) return h(a, a, r, t, s);
+        if (!o) return h(a, a, r, t, u);
         try {
           return await v(e, r, y);
         } catch (d) {
           if (x(d)) throw d;
-          return h(a, a, r, t, s);
+          return h(a, a, r, t, u);
         }
       }
       try {
@@ -46,7 +46,7 @@ function B(e, t) {
         throw t.onRollback?.(...r, y), d;
       }
     } finally {
-      t.cancellable && p.delete(s);
+      t.cancellable && p.delete(u);
     }
   };
   return Object.defineProperty(i, "id", {
@@ -56,16 +56,16 @@ function B(e, t) {
     value: t,
     writable: !1
   }), Object.defineProperty(i, "cancel", {
-    value: S,
+    value: _,
     writable: !1
   }), i;
 }
-async function S(e) {
+async function _(e) {
   const t = p.get(e);
   if (t)
     return t.abort(), !0;
   const n = (await c().getAll()).find((a) => a.idempotencyKey === e && a.status === "pending");
-  return n ? (l.getState().removeQueueItem(n.id), u({
+  return n ? (l.getState().removeQueueItem(n.id), s({
     type: "remove",
     id: n.id
   }), await c().remove(n.id), !0) : !1;
@@ -79,7 +79,7 @@ async function F(e) {
     nextRetryAt: void 0,
     retryCount: 0
   };
-  return l.getState().updateQueueItem(e, n), u({
+  return l.getState().updateQueueItem(e, n), s({
     type: "update",
     id: e,
     update: n
@@ -99,10 +99,10 @@ async function h(e, t, n, a, i) {
     status: "pending",
     priority: a.priority ?? "normal"
   };
-  await c().add(o), l.getState().addQueueItem(o);
+  await c().add(o), l.getState().addQueueItem(o), l.getState().recordReliabilityEvent("queued");
   try {
-    const s = A();
-    s && "sync" in s && await s.sync.register("eidos-queue-replay");
+    const u = A();
+    u && "sync" in u && await u.sync.register("eidos-queue-replay");
   } catch {
   }
   return {
@@ -114,7 +114,7 @@ async function h(e, t, n, a, i) {
 function x(e) {
   return e instanceof DOMException && e.name === "AbortError";
 }
-function K(e) {
+function E(e) {
   if (e instanceof Response) return e.status >= 400 && e.status < 500;
   if (typeof e == "object" && e !== null) {
     const t = e.status;
@@ -122,7 +122,7 @@ function K(e) {
   }
   return !1;
 }
-function M(e) {
+function K(e) {
   return Math.min(2e3 * 2 ** e, 3e5) * (0.8 + Math.random() * 0.4);
 }
 function f() {
@@ -136,25 +136,25 @@ function f() {
     cancelled: 0
   };
 }
-var g = !1, q = "eidos-queue-replay";
+var w = !1, q = "eidos-queue-replay";
 async function V() {
   const e = l.getState();
   if (!e.isOnline) return f();
-  if (typeof navigator < "u" && navigator.locks) return navigator.locks.request(q, { ifAvailable: !0 }, async (t) => t ? I(e) : f());
-  if (g) return f();
-  g = !0;
+  if (typeof navigator < "u" && navigator.locks) return navigator.locks.request(q, { ifAvailable: !0 }, async (t) => t ? R(e) : f());
+  if (w) return f();
+  w = !0;
   try {
-    return await I(e);
+    return await R(e);
   } finally {
-    g = !1;
+    w = !1;
   }
 }
-async function O(e, t) {
+async function M(e, t) {
   const n = Date.now();
   t.updateQueueItem(e.id, {
     status: "succeeded",
     completedAt: n
-  }), u({
+  }), t.recordReliabilityEvent("succeeded"), s({
     type: "update",
     id: e.id,
     update: {
@@ -165,13 +165,13 @@ async function O(e, t) {
     status: "succeeded",
     completedAt: n
   }), setTimeout(() => {
-    t.removeQueueItem(e.id), u({
+    t.removeQueueItem(e.id), s({
       type: "remove",
       id: e.id
     }), c().remove(e.id);
   }, 3e3);
 }
-async function E(e, t, n) {
+async function O(e, t, n) {
   const a = Q.get(e.actionId);
   let i;
   if (a) switch (a.strategy) {
@@ -194,11 +194,11 @@ async function E(e, t, n) {
     }
   }
   if (i === "skip")
-    return t.removeQueueItem(e.id), u({
+    return t.removeQueueItem(e.id), t.recordReliabilityEvent("conflicted"), s({
       type: "remove",
       id: e.id
     }), await c().remove(e.id), "conflicted";
-  i && typeof i == "object" && (e.args = i.resolved, t.updateQueueItem(e.id, { args: i.resolved }), u({
+  i && typeof i == "object" && (e.args = i.resolved, t.updateQueueItem(e.id, { args: i.resolved }), s({
     type: "update",
     id: e.id,
     update: { args: i.resolved }
@@ -212,7 +212,7 @@ async function P(e, t, n) {
       error: String(n),
       retryCount: a
     };
-    t.updateQueueItem(e.id, r), u({
+    t.updateQueueItem(e.id, r), t.recordReliabilityEvent("failed"), s({
       type: "update",
       id: e.id,
       update: r
@@ -221,21 +221,21 @@ async function P(e, t, n) {
       idempotencyKey: e.idempotencyKey,
       attempt: a
     };
-    return R.get(e.actionId)?.(...e.args, o), "failed";
+    return I.get(e.actionId)?.(...e.args, o), "failed";
   }
   const i = {
     status: "pending",
     retryCount: a,
-    nextRetryAt: Date.now() + M(a)
+    nextRetryAt: Date.now() + K(a)
   };
-  return t.updateQueueItem(e.id, i), u({
+  return t.updateQueueItem(e.id, i), t.recordReliabilityEvent("retried"), s({
     type: "update",
     id: e.id,
     update: i
   }), await c().update(e.id, i), "retrying";
 }
 async function D(e, t) {
-  const n = w.get(e.actionId);
+  const n = g.get(e.actionId);
   if (!n) return "skipped";
   const a = k.get(e.actionId)?.cancellable;
   let i;
@@ -249,16 +249,16 @@ async function D(e, t) {
     signal: i
   };
   try {
-    return await v(n, e.args, r), await O(e, t), "succeeded";
+    return await v(n, e.args, r), await M(e, t), "succeeded";
   } catch (o) {
     if (x(o))
-      return t.removeQueueItem(e.id), u({
+      return t.removeQueueItem(e.id), t.recordReliabilityEvent("cancelled"), s({
         type: "remove",
         id: e.id
       }), await c().remove(e.id), "cancelled";
-    if (K(o)) {
-      const s = await E(e, t, o);
-      if (s) return s;
+    if (E(o)) {
+      const u = await O(e, t, o);
+      if (u) return u;
     }
     return P(e, t, o);
   } finally {
@@ -267,13 +267,13 @@ async function D(e, t) {
 }
 async function j(e, t, n) {
   if (e.length === 0) return;
-  const a = e.filter((r) => w.has(r.actionId));
+  const a = e.filter((r) => g.has(r.actionId));
   if (n.skipped += e.length - a.length, a.length > 0) {
     const r = a.map((o) => ({
       id: o.id,
       update: { status: "replaying" }
     }));
-    t.batchUpdateQueueItems(r), u({
+    t.batchUpdateQueueItems(r), s({
       type: "batchUpdate",
       updates: r
     });
@@ -285,7 +285,7 @@ async function j(e, t, n) {
     o === "skipped" ? n.skipped++ : o === "conflicted" ? n.conflicted++ : o === "cancelled" ? n.cancelled++ : (n.attempted++, n[o]++);
   }
 }
-async function I(e) {
+async function R(e) {
   const t = await c().getPending(), n = Date.now(), a = t.filter((r) => r.retryCount < r.maxRetries && (!r.nextRetryAt || r.nextRetryAt <= n)), i = f();
   for (const r of [
     "high",
@@ -299,7 +299,7 @@ async function Y() {
 }
 export {
   B as action,
-  S as cancelByIdempotencyKey,
+  _ as cancelByIdempotencyKey,
   Y as clearQueue,
   V as replayQueue,
   F as requeueItem

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","names":[],"sources":["../src/action.ts"],"sourcesContent":["import { useEidosStore } from './store';\nimport { getSwRegistration } from './sw-bridge';\nimport { idbQueueStorage } from './idb';\nimport { _getQueueStorage } from './queue-storage';\nimport { broadcastQueueSync } from './queue-sync';\nimport type { QueueStorage } from './queue-storage';\nimport { CURRENT_QUEUE_SCHEMA_VERSION } from './types';\nimport type {\n  ActionConfig,\n  ActionContext,\n  ActionHandle,\n  ActionFn,\n  ActionQueueItem,\n  ConflictConfig,\n  ConflictContext,\n  ConflictResolution,\n  QueuedResult,\n  ReplayResult,\n} from './types';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst _actionRegistry = new Map<string, ActionFn<any[], any>>();\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst _rollbackRegistry = new Map<string, (...args: any[]) => void>();\nconst _conflictConfigRegistry = new Map<string, ConflictConfig>();\nconst _configRegistry = new Map<string, ActionConfig>();\n\n// In-flight AbortControllers for `cancellable` actions, keyed by idempotencyKey.\n// Populated for direct calls and replays alike; removed once the call settles.\nconst _inflightControllers = new Map<string, AbortController>();\n\nfunction qs(): QueueStorage {\n  // idbQueueStorage is the default browser fallback when no custom storage is set.\n  return _getQueueStorage() ?? idbQueueStorage;\n}\n\nfunction uid() {\n  return crypto.randomUUID();\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction callWithContext<TArgs extends any[], TReturn>(\n  fn: ActionFn<TArgs, TReturn>,\n  args: TArgs,\n  ctx: ActionContext,\n): Promise<TReturn> {\n  return fn(...args, ctx);\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function action<TArgs extends any[], TReturn>(\n  fn: ActionFn<TArgs, TReturn>,\n  config: ActionConfig<TArgs>,\n): ActionHandle<TArgs, TReturn> {\n  // || not ?? — fn.name can be '' (anonymous arrow fn) which ?? treats as a\n  // valid value, causing all anonymous actions to share actionId ''.\n  const baseId = config.name || fn.name || uid();\n  const actionId = config.namespace ? `${config.namespace}::${baseId}` : baseId;\n\n  if (import.meta.env.DEV && config.reliability === 'neverLose' && !config.name && !fn.name) {\n    console.warn(\n      `[eidos] action() registered with neverLose but no stable name was found (fn.name=\"${fn.name}\"). Pass config.name so queued items survive a page reload and can be replayed.`,\n    );\n  }\n\n  if (_actionRegistry.has(actionId)) {\n    throw new Error(\n      `[eidos] duplicate action id \"${actionId}\" — an action with this id is already registered. Pass a unique config.name or config.namespace.`,\n    );\n  }\n\n  // Registering here means the function is available for replay after\n  // the user refreshes the page (actions are defined at module scope).\n  _actionRegistry.set(actionId, fn as ActionFn<unknown[], unknown>);\n  _configRegistry.set(actionId, config as ActionConfig);\n\n  if (config.onRollback) {\n    _rollbackRegistry.set(actionId, config.onRollback);\n  }\n\n  if (config.conflict) {\n    if (\n      import.meta.env.DEV &&\n      (config.conflict.strategy === 'merge' || config.conflict.strategy === 'custom') &&\n      !config.conflict.resolve\n    ) {\n      console.error(\n        `[eidos] action \"${actionId}\" has conflict.strategy \"${config.conflict.strategy}\" but no resolve() — items will retry indefinitely on 4xx.`,\n      );\n    }\n    _conflictConfigRegistry.set(actionId, config.conflict);\n  }\n\n  const wrapped = async (...args: TArgs): Promise<TReturn | QueuedResult> => {\n    const { isOnline } = useEidosStore.getState();\n\n    // Generated for every invocation — reused across every retry/replay of a\n    // neverLose item, and used to key handle.cancel() for in-flight cancellable calls.\n    const idempotencyKey = uid();\n\n    let signal: AbortSignal | undefined;\n    if (config.cancellable) {\n      const controller = new AbortController();\n      _inflightControllers.set(idempotencyKey, controller);\n      signal = controller.signal;\n    }\n\n    const ctx: ActionContext = { idempotencyKey, attempt: 0, signal };\n\n    config.onOptimistic?.(...args, ctx);\n\n    try {\n      if (config.reliability === 'neverLose') {\n        if (!isOnline) {\n          return persistAndQueue(actionId, actionId, args, config, idempotencyKey);\n        }\n        // Online + neverLose: execute, queue on failure\n        try {\n          return await callWithContext(fn, args, ctx);\n        } catch (err) {\n          if (isAbortError(err)) throw err;\n          return persistAndQueue(actionId, actionId, args, config, idempotencyKey);\n        }\n      }\n\n      // best-effort: execute directly, rollback on failure\n      try {\n        return await callWithContext(fn, args, ctx);\n      } catch (err) {\n        config.onRollback?.(...args, ctx);\n        throw err;\n      }\n    } finally {\n      if (config.cancellable) _inflightControllers.delete(idempotencyKey);\n    }\n  };\n\n  Object.defineProperty(wrapped, 'id', { value: actionId, writable: false });\n  Object.defineProperty(wrapped, 'config', { value: config, writable: false });\n  Object.defineProperty(wrapped, 'cancel', { value: cancelByIdempotencyKey, writable: false });\n\n  return wrapped as unknown as ActionHandle<TArgs, TReturn>;\n}\n\n/**\n * Cancel an invocation by its `idempotencyKey` (from `ActionContext` /\n * `onOptimistic`). Aborts the in-flight call if `cancellable: true` and\n * still running, otherwise removes a not-yet-replayed queued item.\n * Returns `true` if something was cancelled/removed.\n *\n * Shared by every `ActionHandle.cancel()` and by devtools, which can't\n * address a specific handle from a queue item alone.\n */\nexport async function cancelByIdempotencyKey(idempotencyKey: string): Promise<boolean> {\n  const controller = _inflightControllers.get(idempotencyKey);\n  if (controller) {\n    controller.abort();\n    return true;\n  }\n\n  // Not in flight — check for a not-yet-replayed queued item with this key.\n  const items = await qs().getAll();\n  const item = items.find((i) => i.idempotencyKey === idempotencyKey && i.status === 'pending');\n  if (!item) return false;\n\n  useEidosStore.getState().removeQueueItem(item.id);\n  broadcastQueueSync({ type: 'remove', id: item.id });\n  await qs().remove(item.id);\n  return true;\n}\n\n/**\n * Reset a `'failed'` queue item back to `'pending'` so the next\n * `replayQueue()` retries it — clears `error`/`nextRetryAt` and resets\n * `retryCount` to 0. Returns `true` if the item existed and was failed.\n * Used by devtools' per-item \"Retry\" action.\n */\nexport async function requeueItem(id: string): Promise<boolean> {\n  const items = await qs().getAll();\n  const item = items.find((i) => i.id === id);\n  if (!item || item.status !== 'failed') return false;\n\n  const update: Partial<ActionQueueItem> = {\n    status: 'pending',\n    error: undefined,\n    nextRetryAt: undefined,\n    retryCount: 0,\n  };\n  useEidosStore.getState().updateQueueItem(id, update);\n  broadcastQueueSync({ type: 'update', id, update });\n  await qs().update(id, update);\n  return true;\n}\n\nfunction isJsonSerializable(value: unknown): boolean {\n  try {\n    JSON.stringify(value);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nasync function persistAndQueue<TArgs extends any[]>(\n  actionId: string,\n  actionName: string,\n  args: TArgs,\n  config: ActionConfig<TArgs>,\n  idempotencyKey: string,\n): Promise<QueuedResult> {\n  if (import.meta.env.DEV && !isJsonSerializable(args)) {\n    console.warn(\n      `[eidos] action \"${actionName}\" queued with non-JSON-serializable args. These args will be lost after a page reload. Use plain JSON values for neverLose actions.`,\n      args,\n    );\n  }\n\n  const id = uid();\n  const item: ActionQueueItem = {\n    schemaVersion: CURRENT_QUEUE_SCHEMA_VERSION,\n    id,\n    actionId,\n    actionName,\n    idempotencyKey,\n    args,\n    queuedAt: Date.now(),\n    retryCount: 0,\n    maxRetries: config.maxRetries ?? 3,\n    status: 'pending',\n    priority: config.priority ?? 'normal',\n  };\n\n  await qs().add(item);\n  useEidosStore.getState().addQueueItem(item);\n\n  // Register Background Sync tag so the browser can wake up open clients\n  // when connectivity returns, even if the user navigated away briefly.\n  // Graceful no-op when Background Sync is unsupported.\n  try {\n    const reg = getSwRegistration();\n    if (reg && 'sync' in reg) {\n      await (reg as unknown as { sync: { register(tag: string): Promise<void> } }).sync.register(\n        'eidos-queue-replay',\n      );\n    }\n  } catch {\n    // Background Sync not available — online-event replay remains the fallback\n  }\n\n  return {\n    queued: true,\n    id,\n    message: `\"${actionName}\" queued — will execute when online`,\n  };\n}\n\nfunction isAbortError(err: unknown): boolean {\n  return err instanceof DOMException && err.name === 'AbortError';\n}\n\nfunction isClientError(err: unknown): boolean {\n  if (err instanceof Response) return err.status >= 400 && err.status < 500;\n  if (typeof err === 'object' && err !== null) {\n    const s = (err as Record<string, unknown>).status;\n    if (typeof s === 'number') return s >= 400 && s < 500;\n  }\n  return false;\n}\n\n// Base delay 2s, doubles per retry, capped at 5 minutes, ±20% jitter\nfunction backoffMs(retryCount: number): number {\n  const base = Math.min(2000 * 2 ** retryCount, 300_000);\n  return base * (0.8 + Math.random() * 0.4);\n}\n\nfunction emptyReplayResult(): ReplayResult {\n  return {\n    attempted: 0,\n    succeeded: 0,\n    failed: 0,\n    retrying: 0,\n    skipped: 0,\n    conflicted: 0,\n    cancelled: 0,\n  };\n}\n\nlet _replaying = false;\nconst REPLAY_LOCK_NAME = 'eidos-queue-replay';\n\nexport async function replayQueue(): Promise<ReplayResult> {\n  const store = useEidosStore.getState();\n  if (!store.isOnline) return emptyReplayResult();\n\n  // Web Locks coordinate replay across tabs sharing the same IndexedDB queue —\n  // only the lock holder replays; other tabs no-op rather than re-executing\n  // the same queued actions in parallel.\n  if (typeof navigator !== 'undefined' && navigator.locks) {\n    return navigator.locks.request(REPLAY_LOCK_NAME, { ifAvailable: true }, async (lock) => {\n      if (!lock) return emptyReplayResult();\n      return _doReplayQueue(store);\n    });\n  }\n\n  // Fallback for environments without the Web Locks API (older Safari, React\n  // Native, test runners) — guards against concurrent replay within this tab only.\n  if (_replaying) return emptyReplayResult();\n  _replaying = true;\n  try {\n    return await _doReplayQueue(store);\n  } finally {\n    _replaying = false;\n  }\n}\n\ntype ItemOutcome = 'succeeded' | 'failed' | 'retrying' | 'skipped' | 'conflicted' | 'cancelled';\n\nasync function _markSucceeded(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n): Promise<void> {\n  const completedAt = Date.now();\n  store.updateQueueItem(item.id, { status: 'succeeded', completedAt });\n  broadcastQueueSync({ type: 'update', id: item.id, update: { status: 'succeeded', completedAt } });\n  await qs().update(item.id, { status: 'succeeded', completedAt });\n\n  // Remove from queue after a short delay so UI can show the success state briefly\n  setTimeout(() => {\n    store.removeQueueItem(item.id);\n    broadcastQueueSync({ type: 'remove', id: item.id });\n    qs().remove(item.id);\n  }, 3000);\n}\n\n/**\n * Resolves a 4xx error against the action's conflict strategy.\n * Returns 'conflicted' if the item was dropped, undefined if normal\n * retry/fail logic should run (possibly with `item.args` rewritten by `merge`).\n */\nasync function _resolveConflict(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n  err: unknown,\n): Promise<ItemOutcome | undefined> {\n  const conflictConfig = _conflictConfigRegistry.get(item.actionId);\n  let resolution: ConflictResolution | undefined;\n\n  if (conflictConfig) {\n    switch (conflictConfig.strategy) {\n      case 'serverWins':\n        resolution = 'skip';\n        break;\n      case 'clientWins':\n        resolution = 'retry';\n        break;\n      case 'merge':\n      case 'custom': {\n        const ctx: ConflictContext = {\n          error: err,\n          args: item.args as unknown[],\n          attempt: item.retryCount,\n          idempotencyKey: item.idempotencyKey,\n        };\n        resolution = conflictConfig.resolve?.(ctx) ?? 'retry';\n        break;\n      }\n    }\n  }\n\n  if (resolution === 'skip') {\n    store.removeQueueItem(item.id);\n    broadcastQueueSync({ type: 'remove', id: item.id });\n    await qs().remove(item.id);\n    return 'conflicted';\n  }\n  if (resolution && typeof resolution === 'object') {\n    item.args = resolution.resolved;\n    store.updateQueueItem(item.id, { args: resolution.resolved });\n    broadcastQueueSync({ type: 'update', id: item.id, update: { args: resolution.resolved } });\n    await qs().update(item.id, { args: resolution.resolved });\n  }\n  // 'retry' (or merged args) falls through to normal retry/fail logic\n  return undefined;\n}\n\nasync function _scheduleRetryOrFail(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n  err: unknown,\n): Promise<ItemOutcome> {\n  const retryCount = item.retryCount + 1;\n  if (retryCount >= item.maxRetries) {\n    const update = { status: 'failed' as const, error: String(err), retryCount };\n    store.updateQueueItem(item.id, update);\n    broadcastQueueSync({ type: 'update', id: item.id, update });\n    await qs().update(item.id, update);\n    const ctx: ActionContext = { idempotencyKey: item.idempotencyKey, attempt: retryCount };\n    _rollbackRegistry.get(item.actionId)?.(...(item.args as unknown[]), ctx);\n    return 'failed';\n  }\n\n  const nextRetryAt = Date.now() + backoffMs(retryCount);\n  const update = { status: 'pending' as const, retryCount, nextRetryAt };\n  store.updateQueueItem(item.id, update);\n  broadcastQueueSync({ type: 'update', id: item.id, update });\n  await qs().update(item.id, update);\n  return 'retrying';\n}\n\nasync function _replayItem(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n): Promise<ItemOutcome> {\n  const fn = _actionRegistry.get(item.actionId);\n  if (!fn) return 'skipped';\n\n  const cancellable = _configRegistry.get(item.actionId)?.cancellable;\n  let signal: AbortSignal | undefined;\n  if (cancellable) {\n    const controller = new AbortController();\n    _inflightControllers.set(item.idempotencyKey, controller);\n    signal = controller.signal;\n  }\n\n  const ctx: ActionContext = {\n    idempotencyKey: item.idempotencyKey,\n    attempt: item.retryCount,\n    signal,\n  };\n\n  try {\n    await callWithContext(fn, item.args as unknown[], ctx);\n    await _markSucceeded(item, store);\n    return 'succeeded';\n  } catch (err) {\n    // Cancelled via handle.cancel(idempotencyKey) — drop the item, no rollback/retry.\n    if (isAbortError(err)) {\n      store.removeQueueItem(item.id);\n      broadcastQueueSync({ type: 'remove', id: item.id });\n      await qs().remove(item.id);\n      return 'cancelled';\n    }\n\n    // 4xx: give the conflict strategy a chance to decide before normal retry/fail logic\n    if (isClientError(err)) {\n      const outcome = await _resolveConflict(item, store, err);\n      if (outcome) return outcome;\n    }\n\n    return _scheduleRetryOrFail(item, store, err);\n  } finally {\n    if (cancellable) _inflightControllers.delete(item.idempotencyKey);\n  }\n}\n\nasync function _replayTier(\n  items: ActionQueueItem[],\n  store: ReturnType<typeof useEidosStore.getState>,\n  result: ReplayResult,\n): Promise<void> {\n  if (items.length === 0) return;\n\n  // Batch 'replaying' status update — N items → 1 store notify.\n  // IDB write is fire-and-forget: on reload items stay 'pending', safe to re-replay.\n  const replayable = items.filter((item) => _actionRegistry.has(item.actionId));\n  result.skipped += items.length - replayable.length;\n\n  if (replayable.length > 0) {\n    const updates = replayable.map((item) => ({\n      id: item.id,\n      update: { status: 'replaying' as const },\n    }));\n    store.batchUpdateQueueItems(updates);\n    broadcastQueueSync({ type: 'batchUpdate', updates });\n    for (const item of replayable) {\n      qs().update(item.id, { status: 'replaying' });\n    }\n  }\n\n  const outcomes = await Promise.allSettled(replayable.map((item) => _replayItem(item, store)));\n\n  for (const o of outcomes) {\n    const outcome = o.status === 'fulfilled' ? o.value : 'failed';\n    if (outcome === 'skipped') {\n      result.skipped++;\n    } else if (outcome === 'conflicted') {\n      result.conflicted++;\n    } else if (outcome === 'cancelled') {\n      result.cancelled++;\n    } else {\n      result.attempted++;\n      result[outcome]++;\n    }\n  }\n}\n\nasync function _doReplayQueue(\n  store: ReturnType<typeof useEidosStore.getState>,\n): Promise<ReplayResult> {\n  const candidates = await qs().getPending();\n  const now = Date.now();\n  // getPending() includes 'failed' items (for UI/queue-stats visibility), but\n  // items that already exhausted maxRetries must not be auto-replayed again —\n  // otherwise every reconnect re-executes the action and re-fires onRollback.\n  // Those items stay 'failed' until the host app explicitly clears/re-queues them.\n  const pending = candidates.filter(\n    (item) => item.retryCount < item.maxRetries && (!item.nextRetryAt || item.nextRetryAt <= now),\n  );\n\n  const result: ReplayResult = emptyReplayResult();\n\n  // Process tiers sequentially: high items complete before normal, normal before low.\n  // Within each tier items run in parallel via Promise.allSettled.\n  for (const tier of ['high', 'normal', 'low'] as const) {\n    const tierItems = pending.filter((item) => (item.priority ?? 'normal') === tier);\n    await _replayTier(tierItems, store, result);\n  }\n\n  return result;\n}\n\n/** Remove all items from the action queue (storage + in-memory store). */\nexport async function clearQueue(): Promise<void> {\n  await qs().clear();\n  useEidosStore.getState().hydrateQueue([]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"action.js","names":[],"sources":["../src/action.ts"],"sourcesContent":["import { useEidosStore } from './store';\nimport { getSwRegistration } from './sw-bridge';\nimport { idbQueueStorage } from './idb';\nimport { _getQueueStorage } from './queue-storage';\nimport { broadcastQueueSync } from './queue-sync';\nimport type { QueueStorage } from './queue-storage';\nimport { CURRENT_QUEUE_SCHEMA_VERSION } from './types';\nimport type {\n  ActionConfig,\n  ActionContext,\n  ActionHandle,\n  ActionFn,\n  ActionQueueItem,\n  ConflictConfig,\n  ConflictContext,\n  ConflictResolution,\n  QueuedResult,\n  ReplayResult,\n} from './types';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst _actionRegistry = new Map<string, ActionFn<any[], any>>();\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst _rollbackRegistry = new Map<string, (...args: any[]) => void>();\nconst _conflictConfigRegistry = new Map<string, ConflictConfig>();\nconst _configRegistry = new Map<string, ActionConfig>();\n\n// In-flight AbortControllers for `cancellable` actions, keyed by idempotencyKey.\n// Populated for direct calls and replays alike; removed once the call settles.\nconst _inflightControllers = new Map<string, AbortController>();\n\nfunction qs(): QueueStorage {\n  // idbQueueStorage is the default browser fallback when no custom storage is set.\n  return _getQueueStorage() ?? idbQueueStorage;\n}\n\nfunction uid() {\n  return crypto.randomUUID();\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction callWithContext<TArgs extends any[], TReturn>(\n  fn: ActionFn<TArgs, TReturn>,\n  args: TArgs,\n  ctx: ActionContext,\n): Promise<TReturn> {\n  return fn(...args, ctx);\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function action<TArgs extends any[], TReturn>(\n  fn: ActionFn<TArgs, TReturn>,\n  config: ActionConfig<TArgs>,\n): ActionHandle<TArgs, TReturn> {\n  // || not ?? — fn.name can be '' (anonymous arrow fn) which ?? treats as a\n  // valid value, causing all anonymous actions to share actionId ''.\n  const baseId = config.name || fn.name || uid();\n  const actionId = config.namespace ? `${config.namespace}::${baseId}` : baseId;\n\n  if (import.meta.env.DEV && config.reliability === 'neverLose' && !config.name && !fn.name) {\n    console.warn(\n      `[eidos] action() registered with neverLose but no stable name was found (fn.name=\"${fn.name}\"). Pass config.name so queued items survive a page reload and can be replayed.`,\n    );\n  }\n\n  if (_actionRegistry.has(actionId)) {\n    throw new Error(\n      `[eidos] duplicate action id \"${actionId}\" — an action with this id is already registered. Pass a unique config.name or config.namespace.`,\n    );\n  }\n\n  // Registering here means the function is available for replay after\n  // the user refreshes the page (actions are defined at module scope).\n  _actionRegistry.set(actionId, fn as ActionFn<unknown[], unknown>);\n  _configRegistry.set(actionId, config as ActionConfig);\n\n  if (config.onRollback) {\n    _rollbackRegistry.set(actionId, config.onRollback);\n  }\n\n  if (config.conflict) {\n    if (\n      import.meta.env.DEV &&\n      (config.conflict.strategy === 'merge' || config.conflict.strategy === 'custom') &&\n      !config.conflict.resolve\n    ) {\n      console.error(\n        `[eidos] action \"${actionId}\" has conflict.strategy \"${config.conflict.strategy}\" but no resolve() — items will retry indefinitely on 4xx.`,\n      );\n    }\n    _conflictConfigRegistry.set(actionId, config.conflict);\n  }\n\n  const wrapped = async (...args: TArgs): Promise<TReturn | QueuedResult> => {\n    const { isOnline } = useEidosStore.getState();\n\n    // Generated for every invocation — reused across every retry/replay of a\n    // neverLose item, and used to key handle.cancel() for in-flight cancellable calls.\n    const idempotencyKey = uid();\n\n    let signal: AbortSignal | undefined;\n    if (config.cancellable) {\n      const controller = new AbortController();\n      _inflightControllers.set(idempotencyKey, controller);\n      signal = controller.signal;\n    }\n\n    const ctx: ActionContext = { idempotencyKey, attempt: 0, signal };\n\n    config.onOptimistic?.(...args, ctx);\n\n    try {\n      if (config.reliability === 'neverLose') {\n        if (!isOnline) {\n          return persistAndQueue(actionId, actionId, args, config, idempotencyKey);\n        }\n        // Online + neverLose: execute, queue on failure\n        try {\n          return await callWithContext(fn, args, ctx);\n        } catch (err) {\n          if (isAbortError(err)) throw err;\n          return persistAndQueue(actionId, actionId, args, config, idempotencyKey);\n        }\n      }\n\n      // best-effort: execute directly, rollback on failure\n      try {\n        return await callWithContext(fn, args, ctx);\n      } catch (err) {\n        config.onRollback?.(...args, ctx);\n        throw err;\n      }\n    } finally {\n      if (config.cancellable) _inflightControllers.delete(idempotencyKey);\n    }\n  };\n\n  Object.defineProperty(wrapped, 'id', { value: actionId, writable: false });\n  Object.defineProperty(wrapped, 'config', { value: config, writable: false });\n  Object.defineProperty(wrapped, 'cancel', { value: cancelByIdempotencyKey, writable: false });\n\n  return wrapped as unknown as ActionHandle<TArgs, TReturn>;\n}\n\n/**\n * Cancel an invocation by its `idempotencyKey` (from `ActionContext` /\n * `onOptimistic`). Aborts the in-flight call if `cancellable: true` and\n * still running, otherwise removes a not-yet-replayed queued item.\n * Returns `true` if something was cancelled/removed.\n *\n * Shared by every `ActionHandle.cancel()` and by devtools, which can't\n * address a specific handle from a queue item alone.\n */\nexport async function cancelByIdempotencyKey(idempotencyKey: string): Promise<boolean> {\n  const controller = _inflightControllers.get(idempotencyKey);\n  if (controller) {\n    controller.abort();\n    return true;\n  }\n\n  // Not in flight — check for a not-yet-replayed queued item with this key.\n  const items = await qs().getAll();\n  const item = items.find((i) => i.idempotencyKey === idempotencyKey && i.status === 'pending');\n  if (!item) return false;\n\n  useEidosStore.getState().removeQueueItem(item.id);\n  broadcastQueueSync({ type: 'remove', id: item.id });\n  await qs().remove(item.id);\n  return true;\n}\n\n/**\n * Reset a `'failed'` queue item back to `'pending'` so the next\n * `replayQueue()` retries it — clears `error`/`nextRetryAt` and resets\n * `retryCount` to 0. Returns `true` if the item existed and was failed.\n * Used by devtools' per-item \"Retry\" action.\n */\nexport async function requeueItem(id: string): Promise<boolean> {\n  const items = await qs().getAll();\n  const item = items.find((i) => i.id === id);\n  if (!item || item.status !== 'failed') return false;\n\n  const update: Partial<ActionQueueItem> = {\n    status: 'pending',\n    error: undefined,\n    nextRetryAt: undefined,\n    retryCount: 0,\n  };\n  useEidosStore.getState().updateQueueItem(id, update);\n  broadcastQueueSync({ type: 'update', id, update });\n  await qs().update(id, update);\n  return true;\n}\n\nfunction isJsonSerializable(value: unknown): boolean {\n  try {\n    JSON.stringify(value);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nasync function persistAndQueue<TArgs extends any[]>(\n  actionId: string,\n  actionName: string,\n  args: TArgs,\n  config: ActionConfig<TArgs>,\n  idempotencyKey: string,\n): Promise<QueuedResult> {\n  if (import.meta.env.DEV && !isJsonSerializable(args)) {\n    console.warn(\n      `[eidos] action \"${actionName}\" queued with non-JSON-serializable args. These args will be lost after a page reload. Use plain JSON values for neverLose actions.`,\n      args,\n    );\n  }\n\n  const id = uid();\n  const item: ActionQueueItem = {\n    schemaVersion: CURRENT_QUEUE_SCHEMA_VERSION,\n    id,\n    actionId,\n    actionName,\n    idempotencyKey,\n    args,\n    queuedAt: Date.now(),\n    retryCount: 0,\n    maxRetries: config.maxRetries ?? 3,\n    status: 'pending',\n    priority: config.priority ?? 'normal',\n  };\n\n  await qs().add(item);\n  useEidosStore.getState().addQueueItem(item);\n  useEidosStore.getState().recordReliabilityEvent('queued');\n\n  // Register Background Sync tag so the browser can wake up open clients\n  // when connectivity returns, even if the user navigated away briefly.\n  // Graceful no-op when Background Sync is unsupported.\n  try {\n    const reg = getSwRegistration();\n    if (reg && 'sync' in reg) {\n      await (reg as unknown as { sync: { register(tag: string): Promise<void> } }).sync.register(\n        'eidos-queue-replay',\n      );\n    }\n  } catch {\n    // Background Sync not available — online-event replay remains the fallback\n  }\n\n  return {\n    queued: true,\n    id,\n    message: `\"${actionName}\" queued — will execute when online`,\n  };\n}\n\nfunction isAbortError(err: unknown): boolean {\n  return err instanceof DOMException && err.name === 'AbortError';\n}\n\nfunction isClientError(err: unknown): boolean {\n  if (err instanceof Response) return err.status >= 400 && err.status < 500;\n  if (typeof err === 'object' && err !== null) {\n    const s = (err as Record<string, unknown>).status;\n    if (typeof s === 'number') return s >= 400 && s < 500;\n  }\n  return false;\n}\n\n// Base delay 2s, doubles per retry, capped at 5 minutes, ±20% jitter\nfunction backoffMs(retryCount: number): number {\n  const base = Math.min(2000 * 2 ** retryCount, 300_000);\n  return base * (0.8 + Math.random() * 0.4);\n}\n\nfunction emptyReplayResult(): ReplayResult {\n  return {\n    attempted: 0,\n    succeeded: 0,\n    failed: 0,\n    retrying: 0,\n    skipped: 0,\n    conflicted: 0,\n    cancelled: 0,\n  };\n}\n\nlet _replaying = false;\nconst REPLAY_LOCK_NAME = 'eidos-queue-replay';\n\nexport async function replayQueue(): Promise<ReplayResult> {\n  const store = useEidosStore.getState();\n  if (!store.isOnline) return emptyReplayResult();\n\n  // Web Locks coordinate replay across tabs sharing the same IndexedDB queue —\n  // only the lock holder replays; other tabs no-op rather than re-executing\n  // the same queued actions in parallel.\n  if (typeof navigator !== 'undefined' && navigator.locks) {\n    return navigator.locks.request(REPLAY_LOCK_NAME, { ifAvailable: true }, async (lock) => {\n      if (!lock) return emptyReplayResult();\n      return _doReplayQueue(store);\n    });\n  }\n\n  // Fallback for environments without the Web Locks API (older Safari, React\n  // Native, test runners) — guards against concurrent replay within this tab only.\n  if (_replaying) return emptyReplayResult();\n  _replaying = true;\n  try {\n    return await _doReplayQueue(store);\n  } finally {\n    _replaying = false;\n  }\n}\n\ntype ItemOutcome = 'succeeded' | 'failed' | 'retrying' | 'skipped' | 'conflicted' | 'cancelled';\n\nasync function _markSucceeded(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n): Promise<void> {\n  const completedAt = Date.now();\n  store.updateQueueItem(item.id, { status: 'succeeded', completedAt });\n  store.recordReliabilityEvent('succeeded');\n  broadcastQueueSync({ type: 'update', id: item.id, update: { status: 'succeeded', completedAt } });\n  await qs().update(item.id, { status: 'succeeded', completedAt });\n\n  // Remove from queue after a short delay so UI can show the success state briefly\n  setTimeout(() => {\n    store.removeQueueItem(item.id);\n    broadcastQueueSync({ type: 'remove', id: item.id });\n    qs().remove(item.id);\n  }, 3000);\n}\n\n/**\n * Resolves a 4xx error against the action's conflict strategy.\n * Returns 'conflicted' if the item was dropped, undefined if normal\n * retry/fail logic should run (possibly with `item.args` rewritten by `merge`).\n */\nasync function _resolveConflict(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n  err: unknown,\n): Promise<ItemOutcome | undefined> {\n  const conflictConfig = _conflictConfigRegistry.get(item.actionId);\n  let resolution: ConflictResolution | undefined;\n\n  if (conflictConfig) {\n    switch (conflictConfig.strategy) {\n      case 'serverWins':\n        resolution = 'skip';\n        break;\n      case 'clientWins':\n        resolution = 'retry';\n        break;\n      case 'merge':\n      case 'custom': {\n        const ctx: ConflictContext = {\n          error: err,\n          args: item.args as unknown[],\n          attempt: item.retryCount,\n          idempotencyKey: item.idempotencyKey,\n        };\n        resolution = conflictConfig.resolve?.(ctx) ?? 'retry';\n        break;\n      }\n    }\n  }\n\n  if (resolution === 'skip') {\n    store.removeQueueItem(item.id);\n    store.recordReliabilityEvent('conflicted');\n    broadcastQueueSync({ type: 'remove', id: item.id });\n    await qs().remove(item.id);\n    return 'conflicted';\n  }\n  if (resolution && typeof resolution === 'object') {\n    item.args = resolution.resolved;\n    store.updateQueueItem(item.id, { args: resolution.resolved });\n    broadcastQueueSync({ type: 'update', id: item.id, update: { args: resolution.resolved } });\n    await qs().update(item.id, { args: resolution.resolved });\n  }\n  // 'retry' (or merged args) falls through to normal retry/fail logic\n  return undefined;\n}\n\nasync function _scheduleRetryOrFail(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n  err: unknown,\n): Promise<ItemOutcome> {\n  const retryCount = item.retryCount + 1;\n  if (retryCount >= item.maxRetries) {\n    const update = { status: 'failed' as const, error: String(err), retryCount };\n    store.updateQueueItem(item.id, update);\n    store.recordReliabilityEvent('failed');\n    broadcastQueueSync({ type: 'update', id: item.id, update });\n    await qs().update(item.id, update);\n    const ctx: ActionContext = { idempotencyKey: item.idempotencyKey, attempt: retryCount };\n    _rollbackRegistry.get(item.actionId)?.(...(item.args as unknown[]), ctx);\n    return 'failed';\n  }\n\n  const nextRetryAt = Date.now() + backoffMs(retryCount);\n  const update = { status: 'pending' as const, retryCount, nextRetryAt };\n  store.updateQueueItem(item.id, update);\n  store.recordReliabilityEvent('retried');\n  broadcastQueueSync({ type: 'update', id: item.id, update });\n  await qs().update(item.id, update);\n  return 'retrying';\n}\n\nasync function _replayItem(\n  item: ActionQueueItem,\n  store: ReturnType<typeof useEidosStore.getState>,\n): Promise<ItemOutcome> {\n  const fn = _actionRegistry.get(item.actionId);\n  if (!fn) return 'skipped';\n\n  const cancellable = _configRegistry.get(item.actionId)?.cancellable;\n  let signal: AbortSignal | undefined;\n  if (cancellable) {\n    const controller = new AbortController();\n    _inflightControllers.set(item.idempotencyKey, controller);\n    signal = controller.signal;\n  }\n\n  const ctx: ActionContext = {\n    idempotencyKey: item.idempotencyKey,\n    attempt: item.retryCount,\n    signal,\n  };\n\n  try {\n    await callWithContext(fn, item.args as unknown[], ctx);\n    await _markSucceeded(item, store);\n    return 'succeeded';\n  } catch (err) {\n    // Cancelled via handle.cancel(idempotencyKey) — drop the item, no rollback/retry.\n    if (isAbortError(err)) {\n      store.removeQueueItem(item.id);\n      store.recordReliabilityEvent('cancelled');\n      broadcastQueueSync({ type: 'remove', id: item.id });\n      await qs().remove(item.id);\n      return 'cancelled';\n    }\n\n    // 4xx: give the conflict strategy a chance to decide before normal retry/fail logic\n    if (isClientError(err)) {\n      const outcome = await _resolveConflict(item, store, err);\n      if (outcome) return outcome;\n    }\n\n    return _scheduleRetryOrFail(item, store, err);\n  } finally {\n    if (cancellable) _inflightControllers.delete(item.idempotencyKey);\n  }\n}\n\nasync function _replayTier(\n  items: ActionQueueItem[],\n  store: ReturnType<typeof useEidosStore.getState>,\n  result: ReplayResult,\n): Promise<void> {\n  if (items.length === 0) return;\n\n  // Batch 'replaying' status update — N items → 1 store notify.\n  // IDB write is fire-and-forget: on reload items stay 'pending', safe to re-replay.\n  const replayable = items.filter((item) => _actionRegistry.has(item.actionId));\n  result.skipped += items.length - replayable.length;\n\n  if (replayable.length > 0) {\n    const updates = replayable.map((item) => ({\n      id: item.id,\n      update: { status: 'replaying' as const },\n    }));\n    store.batchUpdateQueueItems(updates);\n    broadcastQueueSync({ type: 'batchUpdate', updates });\n    for (const item of replayable) {\n      qs().update(item.id, { status: 'replaying' });\n    }\n  }\n\n  const outcomes = await Promise.allSettled(replayable.map((item) => _replayItem(item, store)));\n\n  for (const o of outcomes) {\n    const outcome = o.status === 'fulfilled' ? o.value : 'failed';\n    if (outcome === 'skipped') {\n      result.skipped++;\n    } else if (outcome === 'conflicted') {\n      result.conflicted++;\n    } else if (outcome === 'cancelled') {\n      result.cancelled++;\n    } else {\n      result.attempted++;\n      result[outcome]++;\n    }\n  }\n}\n\nasync function _doReplayQueue(\n  store: ReturnType<typeof useEidosStore.getState>,\n): Promise<ReplayResult> {\n  const candidates = await qs().getPending();\n  const now = Date.now();\n  // getPending() includes 'failed' items (for UI/queue-stats visibility), but\n  // items that already exhausted maxRetries must not be auto-replayed again —\n  // otherwise every reconnect re-executes the action and re-fires onRollback.\n  // Those items stay 'failed' until the host app explicitly clears/re-queues them.\n  const pending = candidates.filter(\n    (item) => item.retryCount < item.maxRetries && (!item.nextRetryAt || item.nextRetryAt <= now),\n  );\n\n  const result: ReplayResult = emptyReplayResult();\n\n  // Process tiers sequentially: high items complete before normal, normal before low.\n  // Within each tier items run in parallel via Promise.allSettled.\n  for (const tier of ['high', 'normal', 'low'] as const) {\n    const tierItems = pending.filter((item) => (item.priority ?? 'normal') === tier);\n    await _replayTier(tierItems, store, result);\n  }\n\n  return result;\n}\n\n/** Remove all items from the action queue (storage + in-memory store). */\nexport async function clearQueue(): Promise<void> {\n  await qs().clear();\n  useEidosStore.getState().hydrateQueue([]);\n}\n"],"mappings":"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"}

package/dist/async-storage-adapter.d.ts

@@ -0,0 +1,25 @@
+import { ActionQueueItem } from './types';
+import { QueueStorage } from './queue-storage';
+/** Minimal subset of @react-native-async-storage/async-storage (or any compatible key-value store). */
+export interface AsyncStorageLike {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/**
+ * QueueStorage implementation backed by any AsyncStorage-compatible API.
+ * Pass the AsyncStorage singleton from @react-native-async-storage/async-storage
+ * (or MMKV, SQLite, or any store that satisfies AsyncStorageLike).
+ */
+export declare class AsyncStorageQueueStorage implements QueueStorage {
+    private readonly storage;
+    constructor(storage: AsyncStorageLike);
+    private readAll;
+    private writeAll;
+    add(item: ActionQueueItem): Promise<void>;
+    getAll(): Promise<ActionQueueItem[]>;
+    getPending(): Promise<ActionQueueItem[]>;
+    update(id: string, patch: Partial<ActionQueueItem>): Promise<void>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/debug.d.ts

@@ -0,0 +1,46 @@
+import { ReliabilityStats } from './types';
+export interface EidosDebugSnapshot {
+    version: string;
+    swStatus: string;
+    swError?: string;
+    isOnline: boolean;
+    resourceCount: number;
+    resources: Record<string, {
+        url: string;
+        strategy: string;
+        status: string;
+        cacheHits: number;
+        cacheMisses: number;
+        cachedAt?: number;
+    }>;
+    queue: {
+        id: string;
+        actionId: string;
+        actionName: string;
+        status: string;
+        retryCount: number;
+        maxRetries: number;
+        idempotencyKey: string;
+        schemaVersion: number;
+        queuedAt: number;
+    }[];
+    reliability: ReliabilityStats;
+    swRegistration: {
+        scope: string;
+        scriptURL: string;
+        state: 'installing' | 'waiting' | 'active' | null;
+    } | null;
+}
+/**
+ * Returns a plain-object snapshot of the current Eidos runtime state.
+ * Safe to serialize with `JSON.stringify`. Useful for bug reports,
+ * attaching to error tracking breadcrumbs, and the devtools SW tab.
+ *
+ * @example
+ * // Print for a bug report:
+ * console.log(JSON.stringify(eidosDebug(), null, 2));
+ *
+ * // Attach to a Sentry breadcrumb:
+ * Sentry.addBreadcrumb({ data: eidosDebug() });
+ */
+export declare function eidosDebug(): EidosDebugSnapshot;

package/dist/debug.js

@@ -0,0 +1,43 @@
+import { useEidosStore as a } from "./store.js";
+import { getSwRegistration as r } from "./sw-bridge.js";
+import { VERSION as c } from "./version.js";
+function l() {
+  const t = a.getState(), s = r();
+  return {
+    version: c,
+    swStatus: t.swStatus,
+    ...t.swError !== void 0 && { swError: t.swError },
+    isOnline: t.isOnline,
+    resourceCount: Object.keys(t.resources).length,
+    resources: Object.fromEntries(Object.entries(t.resources).map(([e, i]) => [e, {
+      url: i.url,
+      strategy: i.strategy.swStrategy,
+      status: i.status,
+      cacheHits: i.cacheHits,
+      cacheMisses: i.cacheMisses,
+      ...i.cachedAt !== void 0 && { cachedAt: i.cachedAt }
+    }])),
+    queue: t.queue.map((e) => ({
+      id: e.id,
+      actionId: e.actionId,
+      actionName: e.actionName,
+      status: e.status,
+      retryCount: e.retryCount,
+      maxRetries: e.maxRetries,
+      idempotencyKey: e.idempotencyKey,
+      schemaVersion: e.schemaVersion,
+      queuedAt: e.queuedAt
+    })),
+    reliability: { ...t.reliability },
+    swRegistration: s ? {
+      scope: s.scope,
+      scriptURL: (s.active ?? s.waiting ?? s.installing)?.scriptURL ?? "",
+      state: s.installing ? "installing" : s.waiting ? "waiting" : s.active ? "active" : null
+    } : null
+  };
+}
+export {
+  l as eidosDebug
+};
+
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","names":[],"sources":["../src/debug.ts"],"sourcesContent":["import { useEidosStore } from './store';\nimport { getSwRegistration } from './sw-bridge';\nimport { VERSION } from './version';\nimport type { ReliabilityStats } from './types';\n\nexport interface EidosDebugSnapshot {\n  version: string;\n  swStatus: string;\n  swError?: string;\n  isOnline: boolean;\n  resourceCount: number;\n  resources: Record<\n    string,\n    {\n      url: string;\n      strategy: string;\n      status: string;\n      cacheHits: number;\n      cacheMisses: number;\n      cachedAt?: number;\n    }\n  >;\n  queue: {\n    id: string;\n    actionId: string;\n    actionName: string;\n    status: string;\n    retryCount: number;\n    maxRetries: number;\n    idempotencyKey: string;\n    schemaVersion: number;\n    queuedAt: number;\n  }[];\n  reliability: ReliabilityStats;\n  swRegistration: {\n    scope: string;\n    scriptURL: string;\n    state: 'installing' | 'waiting' | 'active' | null;\n  } | null;\n}\n\n/**\n * Returns a plain-object snapshot of the current Eidos runtime state.\n * Safe to serialize with `JSON.stringify`. Useful for bug reports,\n * attaching to error tracking breadcrumbs, and the devtools SW tab.\n *\n * @example\n * // Print for a bug report:\n * console.log(JSON.stringify(eidosDebug(), null, 2));\n *\n * // Attach to a Sentry breadcrumb:\n * Sentry.addBreadcrumb({ data: eidosDebug() });\n */\nexport function eidosDebug(): EidosDebugSnapshot {\n  const state = useEidosStore.getState();\n  const swReg = getSwRegistration();\n\n  return {\n    version: VERSION,\n    swStatus: state.swStatus,\n    ...(state.swError !== undefined && { swError: state.swError }),\n    isOnline: state.isOnline,\n    resourceCount: Object.keys(state.resources).length,\n    resources: Object.fromEntries(\n      Object.entries(state.resources).map(([url, entry]) => [\n        url,\n        {\n          url: entry.url,\n          strategy: entry.strategy.swStrategy,\n          status: entry.status,\n          cacheHits: entry.cacheHits,\n          cacheMisses: entry.cacheMisses,\n          ...(entry.cachedAt !== undefined && { cachedAt: entry.cachedAt }),\n        },\n      ]),\n    ),\n    queue: state.queue.map((item) => ({\n      id: item.id,\n      actionId: item.actionId,\n      actionName: item.actionName,\n      status: item.status,\n      retryCount: item.retryCount,\n      maxRetries: item.maxRetries,\n      idempotencyKey: item.idempotencyKey,\n      schemaVersion: item.schemaVersion,\n      queuedAt: item.queuedAt,\n    })),\n    reliability: { ...state.reliability },\n    swRegistration: swReg\n      ? {\n          scope: swReg.scope,\n          scriptURL: (swReg.active ?? swReg.waiting ?? swReg.installing)?.scriptURL ?? '',\n          state: swReg.installing\n            ? 'installing'\n            : swReg.waiting\n              ? 'waiting'\n              : swReg.active\n                ? 'active'\n                : null,\n        }\n      : null,\n  };\n}\n"],"mappings":";;;AAqDA,SAAgB,IAAiC;AAC/C,QAAM,IAAQ,EAAc,SAAS,GAC/B,IAAQ,EAAkB;AAEhC,SAAO;AAAA,IACL,SAAS;AAAA,IACT,UAAU,EAAM;AAAA,IAChB,GAAI,EAAM,YAAY,UAAa,EAAE,SAAS,EAAM,QAAQ;AAAA,IAC5D,UAAU,EAAM;AAAA,IAChB,eAAe,OAAO,KAAK,EAAM,SAAS,EAAE;AAAA,IAC5C,WAAW,OAAO,YAChB,OAAO,QAAQ,EAAM,SAAS,EAAE,IAAA,CAAK,CAAC,GAAK,CAAA,MAAW,CACpD,GACA;AAAA,MACE,KAAK,EAAM;AAAA,MACX,UAAU,EAAM,SAAS;AAAA,MACzB,QAAQ,EAAM;AAAA,MACd,WAAW,EAAM;AAAA,MACjB,aAAa,EAAM;AAAA,MACnB,GAAI,EAAM,aAAa,UAAa,EAAE,UAAU,EAAM,SAAS;AAAA,IACjE,CACF,CAAC,CACH;AAAA,IACA,OAAO,EAAM,MAAM,IAAA,CAAK,OAAU;AAAA,MAChC,IAAI,EAAK;AAAA,MACT,UAAU,EAAK;AAAA,MACf,YAAY,EAAK;AAAA,MACjB,QAAQ,EAAK;AAAA,MACb,YAAY,EAAK;AAAA,MACjB,YAAY,EAAK;AAAA,MACjB,gBAAgB,EAAK;AAAA,MACrB,eAAe,EAAK;AAAA,MACpB,UAAU,EAAK;AAAA,IACjB,EAAE;AAAA,IACF,aAAa,EAAE,GAAG,EAAM,YAAY;AAAA,IACpC,gBAAgB,IACZ;AAAA,MACE,OAAO,EAAM;AAAA,MACb,YAAY,EAAM,UAAU,EAAM,WAAW,EAAM,aAAa,aAAa;AAAA,MAC7E,OAAO,EAAM,aACT,eACA,EAAM,UACJ,YACA,EAAM,SACJ,WACA;AAAA,IACV,IACA;AAAA,EACN;AACF"}