@sweidos/eidos 1.0.30 → 1.0.31

package/README.md

@@ -756,6 +756,63 @@ it('caches the resource after first fetch', async () => {
 
 ---
 
+## OpenAPI Codegen
+
+`eidos-gen` is a standalone CLI that reads an OpenAPI 3.x spec (JSON or YAML) and generates a fully-typed Eidos declarations file — `resource()` for every GET endpoint, `action()` for every POST / PUT / PATCH / DELETE.
+
+```bash
+npx eidos-gen openapi.json
+# → writes eidos.generated.ts
+```
+
+**Example output** (from a Store API spec):
+
+```ts
+// Generated by eidos-gen — edit function bodies freely, re-run to refresh declarations.
+import { resource, action } from '@sweidos/eidos'
+
+export interface Product { id: string; name: string; price: number; inStock?: boolean }
+export interface CreateProductRequest { name: string; price: number }
+
+// Resources (GET)
+export const listProducts = resource('/api/products', { offline: true })
+export const getProduct   = resource('/api/products/:id', { offline: true })
+
+// Actions (POST / PUT / PATCH / DELETE)
+export const createProduct = action(
+  async (payload: CreateProductRequest): Promise<Product> => {
+    const res = await fetch('/api/products', { method: 'POST', ... })
+    return res.json()
+  },
+  { reliability: 'neverLose', name: 'createProduct' },
+)
+export const deleteProduct = action(
+  async (payload: { id: string }): Promise<void> => {
+    const res = await fetch(`/api/products/${payload.id}`, { method: 'DELETE' })
+    ...
+  },
+  { reliability: 'neverLose', name: 'deleteProduct' },
+)
+```
+
+`eidos-gen` handles:
+- **Path params** — `{id}` → `:id` on resources; `{ id: string } & RequestBody` on actions with template-literal URL interpolation
+- **Type generation** — interfaces from `components/schemas` (objects, enums, unions, arrays)
+- **`$ref` resolution** — schema references inline as type names
+- **Response types** — `200`/`201`/`202` response body type used as the action return type
+- **DELETE with no body** — omits `Content-Type` / `body`, handles 204 no-content
+
+**Options:**
+
+```bash
+npx eidos-gen <spec>                   # JSON or YAML
+npx eidos-gen <spec> --out src/lib/eidos.ts
+npx eidos-gen <spec> --no-offline       # set offline:false on resources
+npx eidos-gen <spec> --eidos ./my-fork  # custom import path
+```
+
+---
+
 ## SSR Adapters
 
 Eidos is browser-only — Service Workers, Cache API, and IndexedDB are not available in Node.js. The runtime already no-ops safely when `window` is undefined, but two subpath exports make integration with SSR frameworks seamless.
@@ -793,6 +850,83 @@ Use `initEidosSvelteKit()` inside `onMount` in your root `+layout.svelte`. The h
 
 Use the framework-agnostic stores (`eidosQueue`, `eidosStatus`, etc.) from the main `@sweidos/eidos` import in your Svelte components — they work with Svelte's `$` auto-subscribe prefix out of the box.
 
+### React Native (`@sweidos/eidos/react-native`)
+
+The React Native subpath swaps the browser-specific backends (IndexedDB, Service Worker, Cache API) for a pluggable `AsyncStorage`-backed queue while keeping the same `action()` / `resource()` API surface.
+
+**Setup**
+
+```bash
+# peer deps
+npm install @react-native-async-storage/async-storage @react-native-community/netinfo
+```
+
+```ts
+// index.js — before rendering anything
+import AsyncStorage from '@react-native-async-storage/async-storage'
+import { initEidosRN } from '@sweidos/eidos/react-native'
+
+await initEidosRN({ storage: AsyncStorage })
+```
+
+```tsx
+// App.tsx
+import { useNetInfo } from '@react-native-community/netinfo'
+import { EidosProviderRN } from '@sweidos/eidos/react-native'
+
+export function App() {
+  const { isConnected } = useNetInfo()
+  return (
+    <EidosProviderRN isConnected={isConnected ?? true}>
+      <Navigation />
+    </EidosProviderRN>
+  )
+}
+```
+
+```ts
+// Declare actions exactly as you would in a web app
+import { action } from '@sweidos/eidos'
+
+export const createOrder = action(
+  async (payload: CreateOrderInput) => {
+    const res = await fetch('/api/orders', { method: 'POST', body: JSON.stringify(payload) })
+    if (!res.ok) throw res
+    return res.json()
+  },
+  { reliability: 'neverLose', name: 'createOrder' },
+)
+```
+
+Actions queued while offline are persisted to AsyncStorage and replayed automatically when the device reconnects.
+
+**Custom storage**
+
+`AsyncStorageLike` accepts any key-value store that implements `getItem` / `setItem` / `removeItem` — you can use MMKV or SQLite instead of AsyncStorage:
+
+```ts
+import { MMKV } from 'react-native-mmkv'
+import { AsyncStorageQueueStorage, setQueueStorage } from '@sweidos/eidos/react-native'
+
+const mmkv = new MMKV()
+setQueueStorage(new AsyncStorageQueueStorage({
+  getItem: async (key) => mmkv.getString(key) ?? null,
+  setItem: async (key, value) => mmkv.set(key, value),
+  removeItem: async (key) => mmkv.delete(key),
+}))
+```
+
+**What works in RN vs web**
+
+| Feature | Web | React Native |
+|---------|-----|--------------|
+| `action()` queue + replay | ✅ IndexedDB | ✅ AsyncStorage |
+| Offline-aware (auto-queue) | ✅ | ✅ |
+| `resource()` in-memory caching | ✅ | ✅ (in-memory only — no SW) |
+| `resource()` offline persistence | ✅ Cache API + SW | ❌ (fetch from API when online) |
+| `useEidos`, `useEidosQueue` hooks | ✅ | ✅ |
+| Background Sync | ✅ | ❌ (App must be foregrounded) |
+
 ---
 
 ## Devtools
@@ -869,8 +1003,8 @@ The component is self-contained with inline styles — no CSS import needed, no
 - [x] Cache warming — `warmCache(handles[])` bulk-prefetches a list of resources on init (e.g. on login)
 
 **Ecosystem**
-- [ ] React Native support — AsyncStorage + fetch-based backend (no Cache API / SW); same `resource` / `action` API surface
-- [ ] OpenAPI codegen CLI — `npx eidos-gen ./openapi.json` generates typed `resource()` and `action()` declarations
+- [x] React Native support — `@sweidos/eidos/react-native`; AsyncStorage-backed queue, same `action()` API surface; `EidosProviderRN` syncs NetInfo connectivity into the replay loop
+- [x] OpenAPI codegen CLI — `npx eidos-gen ./openapi.json` generates typed `resource()` and `action()` declarations
 
 ---
 

package/dist/action.js

@@ -1,34 +1,45 @@
 import { useEidosStore as d } from "./store.js";
-import { getSwRegistration as h } from "./sw-bridge.js";
-import { idbClearQueue as I, idbGetPendingItems as Q, idbAddToQueue as R, idbUpdateQueueItem as u, idbRemoveFromQueue as p } from "./idb.js";
-const l = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map(), w = /* @__PURE__ */ new Map();
+import { getSwRegistration as b } from "./sw-bridge.js";
+import { idbClearQueue as g, idbRemoveFromQueue as Q, idbUpdateQueueItem as h, idbGetPendingItems as I, idbGetQueue as R, idbAddToQueue as k } from "./idb.js";
+import { _getQueueStorage as v } from "./queue-storage.js";
+const l = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map(), S = {
+  add: (e) => k(e),
+  getAll: () => R(),
+  getPending: () => I(),
+  update: (e, t) => h(e, t),
+  remove: (e) => Q(e),
+  clear: () => g()
+};
+function o() {
+  return v() ?? S;
+}
 function m() {
   return crypto.randomUUID();
 }
-function M(e, t) {
+function U(e, t) {
   const r = t.name || e.name || m();
-  l.set(r, e), t.onRollback && y.set(r, t.onRollback), t.onConflict && w.set(r, t.onConflict);
-  const s = async (...a) => {
-    var i, o;
+  l.set(r, e), t.onRollback && f.set(r, t.onRollback), t.onConflict && y.set(r, t.onConflict);
+  const u = async (...a) => {
+    var i, s;
     const { isOnline: n } = d.getState();
     if ((i = t.onOptimistic) == null || i.call(t, ...a), t.reliability === "neverLose") {
       if (!n)
-        return f(r, r, a, t);
+        return p(r, r, a, t);
       try {
         return await e(...a);
       } catch {
-        return f(r, r, a, t);
+        return p(r, r, a, t);
       }
     }
     try {
       return await e(...a);
-    } catch (b) {
-      throw (o = t.onRollback) == null || o.call(t, ...a), b;
+    } catch (w) {
+      throw (s = t.onRollback) == null || s.call(t, ...a), w;
     }
   };
-  return Object.defineProperty(s, "id", { value: r, writable: !1 }), Object.defineProperty(s, "config", { value: t, writable: !1 }), s;
+  return Object.defineProperty(u, "id", { value: r, writable: !1 }), Object.defineProperty(u, "config", { value: t, writable: !1 }), u;
 }
-async function f(e, t, r, s) {
+async function p(e, t, r, u) {
   const a = m(), n = {
     id: a,
     actionId: e,
@@ -36,13 +47,13 @@ async function f(e, t, r, s) {
     args: r,
     queuedAt: Date.now(),
     retryCount: 0,
-    maxRetries: s.maxRetries ?? 3,
+    maxRetries: u.maxRetries ?? 3,
     status: "pending",
-    priority: s.priority ?? "normal"
+    priority: u.priority ?? "normal"
   };
-  await R(n), d.getState().addQueueItem(n);
+  await o().add(n), d.getState().addQueueItem(n);
   try {
-    const i = h();
+    const i = b();
     i && "sync" in i && await i.sync.register("eidos-queue-replay");
   } catch {
   }
@@ -52,7 +63,7 @@ async function f(e, t, r, s) {
     message: `"${t}" queued — will execute when online`
   };
 }
-function g(e) {
+function _(e) {
   if (e instanceof Response) return e.status >= 400 && e.status < 500;
   if (typeof e == "object" && e !== null) {
     const t = e.status;
@@ -60,74 +71,74 @@ function g(e) {
   }
   return !1;
 }
-function k(e) {
+function x(e) {
   return Math.min(2e3 * 2 ** e, 3e5) * (0.8 + Math.random() * 0.4);
 }
 let c = !1;
-async function D() {
+async function j() {
   const e = d.getState();
   if (!e.isOnline || c)
     return { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 };
   c = !0;
   try {
-    return await C(e);
+    return await M(e);
   } finally {
     c = !1;
   }
 }
-async function S(e, t) {
-  var s;
+async function A(e, t) {
+  var u;
   const r = l.get(e.actionId);
   if (!r) return "skipped";
   try {
     await r(...e.args);
     const a = Date.now();
-    return t.updateQueueItem(e.id, { status: "succeeded", completedAt: a }), await u(e.id, { status: "succeeded", completedAt: a }), setTimeout(() => {
-      t.removeQueueItem(e.id), p(e.id);
+    return t.updateQueueItem(e.id, { status: "succeeded", completedAt: a }), await o().update(e.id, { status: "succeeded", completedAt: a }), setTimeout(() => {
+      t.removeQueueItem(e.id), o().remove(e.id);
     }, 3e3), "succeeded";
   } catch (a) {
-    if (g(a)) {
-      const i = w.get(e.actionId);
+    if (_(a)) {
+      const i = y.get(e.actionId);
       if (i && i(a, e.args) === "skip")
-        return t.removeQueueItem(e.id), await p(e.id), "conflicted";
+        return t.removeQueueItem(e.id), await o().remove(e.id), "conflicted";
     }
     const n = e.retryCount + 1;
     if (n >= e.maxRetries)
-      return t.updateQueueItem(e.id, { status: "failed", error: String(a), retryCount: n }), await u(e.id, { status: "failed", error: String(a), retryCount: n }), (s = y.get(e.actionId)) == null || s(...e.args), "failed";
+      return t.updateQueueItem(e.id, { status: "failed", error: String(a), retryCount: n }), await o().update(e.id, { status: "failed", error: String(a), retryCount: n }), (u = f.get(e.actionId)) == null || u(...e.args), "failed";
     {
-      const i = Date.now() + k(n);
-      return t.updateQueueItem(e.id, { status: "pending", retryCount: n, nextRetryAt: i }), await u(e.id, { status: "pending", retryCount: n, nextRetryAt: i }), "retrying";
+      const i = Date.now() + x(n);
+      return t.updateQueueItem(e.id, { status: "pending", retryCount: n, nextRetryAt: i }), await o().update(e.id, { status: "pending", retryCount: n, nextRetryAt: i }), "retrying";
     }
   }
 }
-async function x(e, t, r) {
+async function C(e, t, r) {
   if (e.length === 0) return;
-  const s = e.filter((n) => l.has(n.actionId));
-  if (r.skipped += e.length - s.length, s.length > 0) {
-    t.batchUpdateQueueItems(s.map((n) => ({ id: n.id, update: { status: "replaying" } })));
-    for (const n of s)
-      u(n.id, { status: "replaying" });
+  const u = e.filter((n) => l.has(n.actionId));
+  if (r.skipped += e.length - u.length, u.length > 0) {
+    t.batchUpdateQueueItems(u.map((n) => ({ id: n.id, update: { status: "replaying" } })));
+    for (const n of u)
+      o().update(n.id, { status: "replaying" });
   }
-  const a = await Promise.allSettled(s.map((n) => S(n, t)));
+  const a = await Promise.allSettled(u.map((n) => A(n, t)));
   for (const n of a) {
     const i = n.status === "fulfilled" ? n.value : "failed";
     i === "skipped" ? r.skipped++ : i === "conflicted" ? r.conflicted++ : (r.attempted++, r[i]++);
   }
 }
-async function C(e) {
-  const t = await Q(), r = Date.now(), s = t.filter((n) => !n.nextRetryAt || n.nextRetryAt <= r), a = { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 };
+async function M(e) {
+  const t = await o().getPending(), r = Date.now(), u = t.filter((n) => !n.nextRetryAt || n.nextRetryAt <= r), a = { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 };
   for (const n of ["high", "normal", "low"]) {
-    const i = s.filter((o) => (o.priority ?? "normal") === n);
-    await x(i, e, a);
+    const i = u.filter((s) => (s.priority ?? "normal") === n);
+    await C(i, e, a);
   }
   return a;
 }
-async function O() {
-  await I(), d.getState().hydrateQueue([]);
+async function T() {
+  await o().clear(), d.getState().hydrateQueue([]);
 }
 export {
-  M as action,
-  O as clearQueue,
-  D as replayQueue
+  U as action,
+  T as clearQueue,
+  j as replayQueue
 };
 //# sourceMappingURL=action.js.map

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sources":["../src/action.ts"],"sourcesContent":["import { useEidosStore } from './store'\nimport { getSwRegistration } from './sw-bridge'\nimport {\n  idbAddToQueue,\n  idbGetPendingItems,\n  idbUpdateQueueItem,\n  idbRemoveFromQueue,\n  idbClearQueue,\n} from './idb'\nimport type {\n  ActionConfig,\n  ActionHandle,\n  ActionFn,\n  ActionQueueItem,\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>()\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst _conflictRegistry = new Map<string, (error: unknown, args: any[]) => 'retry' | 'skip'>()\n\nfunction uid() {\n  return crypto.randomUUID()\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,\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 actionId = config.name || fn.name || uid()\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  // 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\n  if (config.onRollback) {\n    _rollbackRegistry.set(actionId, config.onRollback)\n  }\n\n  if (config.onConflict) {\n    _conflictRegistry.set(actionId, config.onConflict)\n  }\n\n  const wrapped = async (...args: TArgs): Promise<TReturn | QueuedResult> => {\n    const { isOnline } = useEidosStore.getState()\n\n    config.onOptimistic?.(...args)\n\n    if (config.reliability === 'neverLose') {\n      if (!isOnline) {\n        return persistAndQueue(actionId, actionId, args, config)\n      }\n      // Online + neverLose: execute, queue on failure\n      try {\n        return await fn(...args)\n      } catch {\n        return persistAndQueue(actionId, actionId, args, config)\n      }\n    }\n\n    // best-effort: execute directly, rollback on failure\n    try {\n      return await fn(...args)\n    } catch (err) {\n      config.onRollback?.(...args)\n      throw err\n    }\n  }\n\n  Object.defineProperty(wrapped, 'id', { value: actionId, writable: false })\n  Object.defineProperty(wrapped, 'config', { value: config, writable: false })\n\n  return wrapped as unknown as ActionHandle<TArgs, TReturn>\n}\n\nfunction isJsonSerializable(value: unknown): boolean {\n  try {\n    JSON.stringify(value)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function persistAndQueue(\n  actionId: string,\n  actionName: string,\n  args: unknown[],\n  config: ActionConfig,\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    id,\n    actionId,\n    actionName,\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 idbAddToQueue(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('eidos-queue-replay')\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 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\nlet _replaying = false\n\nexport async function replayQueue(): Promise<ReplayResult> {\n  const store = useEidosStore.getState()\n  if (!store.isOnline || _replaying) {\n    return { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 }\n  }\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'\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  try {\n    await fn(...(item.args as unknown[]))\n    const completedAt = Date.now()\n    store.updateQueueItem(item.id, { status: 'succeeded', completedAt })\n    await idbUpdateQueueItem(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      idbRemoveFromQueue(item.id)\n    }, 3000)\n    return 'succeeded'\n  } catch (err) {\n    // 4xx: give onConflict a chance to decide before normal retry/fail logic\n    if (isClientError(err)) {\n      const onConflict = _conflictRegistry.get(item.actionId)\n      if (onConflict) {\n        const resolution = onConflict(err, item.args as unknown[])\n        if (resolution === 'skip') {\n          store.removeQueueItem(item.id)\n          await idbRemoveFromQueue(item.id)\n          return 'conflicted'\n        }\n        // 'retry' falls through to normal retry/fail logic below\n      }\n    }\n\n    const retryCount = item.retryCount + 1\n    if (retryCount >= item.maxRetries) {\n      store.updateQueueItem(item.id, { status: 'failed', error: String(err), retryCount })\n      await idbUpdateQueueItem(item.id, { status: 'failed', error: String(err), retryCount })\n      _rollbackRegistry.get(item.actionId)?.(...(item.args as unknown[]))\n      return 'failed'\n    } else {\n      const nextRetryAt = Date.now() + backoffMs(retryCount)\n      store.updateQueueItem(item.id, { status: 'pending', retryCount, nextRetryAt })\n      await idbUpdateQueueItem(item.id, { status: 'pending', retryCount, nextRetryAt })\n      return 'retrying'\n    }\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    store.batchUpdateQueueItems(replayable.map((item) => ({ id: item.id, update: { status: 'replaying' } })))\n    for (const item of replayable) {\n      idbUpdateQueueItem(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') { result.skipped++ }\n    else if (outcome === 'conflicted') { result.conflicted++ }\n    else { result.attempted++; result[outcome]++ }\n  }\n}\n\nasync function _doReplayQueue(store: ReturnType<typeof useEidosStore.getState>): Promise<ReplayResult> {\n  const candidates = await idbGetPendingItems()\n  const now = Date.now()\n  const pending = candidates.filter((item) => !item.nextRetryAt || item.nextRetryAt <= now)\n\n  const result: ReplayResult = { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 }\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 (IDB + in-memory store). */\nexport async function clearQueue(): Promise<void> {\n  await idbClearQueue()\n  useEidosStore.getState().hydrateQueue([])\n}\n"],"names":["_actionRegistry","_rollbackRegistry","_conflictRegistry","uid","action","fn","config","actionId","wrapped","args","isOnline","useEidosStore","_a","persistAndQueue","err","_b","actionName","id","item","idbAddToQueue","reg","getSwRegistration","isClientError","s","backoffMs","retryCount","_replaying","replayQueue","store","_doReplayQueue","_replayItem","completedAt","idbUpdateQueueItem","idbRemoveFromQueue","onConflict","nextRetryAt","_replayTier","items","result","replayable","outcomes","o","outcome","candidates","idbGetPendingItems","now","pending","tier","tierItems","clearQueue","idbClearQueue"],"mappings":"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"}
+{"version":3,"file":"action.js","sources":["../src/action.ts"],"sourcesContent":["import { useEidosStore } from './store'\nimport { getSwRegistration } from './sw-bridge'\nimport {\n  idbAddToQueue,\n  idbGetQueue,\n  idbGetPendingItems,\n  idbUpdateQueueItem,\n  idbRemoveFromQueue,\n  idbClearQueue,\n} from './idb'\nimport { _getQueueStorage } from './queue-storage'\nimport type { QueueStorage } from './queue-storage'\nimport type {\n  ActionConfig,\n  ActionHandle,\n  ActionFn,\n  ActionQueueItem,\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>()\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst _conflictRegistry = new Map<string, (error: unknown, args: any[]) => 'retry' | 'skip'>()\n\n// IDB fallback — used when no custom storage is set (default browser behavior).\nconst _idbFallback: QueueStorage = {\n  add: (item) => idbAddToQueue(item),\n  getAll: () => idbGetQueue(),\n  getPending: () => idbGetPendingItems(),\n  update: (id, patch) => idbUpdateQueueItem(id, patch),\n  remove: (id) => idbRemoveFromQueue(id),\n  clear: () => idbClearQueue(),\n}\n\nfunction qs(): QueueStorage {\n  return _getQueueStorage() ?? _idbFallback\n}\n\nfunction uid() {\n  return crypto.randomUUID()\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,\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 actionId = config.name || fn.name || uid()\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  // 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\n  if (config.onRollback) {\n    _rollbackRegistry.set(actionId, config.onRollback)\n  }\n\n  if (config.onConflict) {\n    _conflictRegistry.set(actionId, config.onConflict)\n  }\n\n  const wrapped = async (...args: TArgs): Promise<TReturn | QueuedResult> => {\n    const { isOnline } = useEidosStore.getState()\n\n    config.onOptimistic?.(...args)\n\n    if (config.reliability === 'neverLose') {\n      if (!isOnline) {\n        return persistAndQueue(actionId, actionId, args, config)\n      }\n      // Online + neverLose: execute, queue on failure\n      try {\n        return await fn(...args)\n      } catch {\n        return persistAndQueue(actionId, actionId, args, config)\n      }\n    }\n\n    // best-effort: execute directly, rollback on failure\n    try {\n      return await fn(...args)\n    } catch (err) {\n      config.onRollback?.(...args)\n      throw err\n    }\n  }\n\n  Object.defineProperty(wrapped, 'id', { value: actionId, writable: false })\n  Object.defineProperty(wrapped, 'config', { value: config, writable: false })\n\n  return wrapped as unknown as ActionHandle<TArgs, TReturn>\n}\n\nfunction isJsonSerializable(value: unknown): boolean {\n  try {\n    JSON.stringify(value)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function persistAndQueue(\n  actionId: string,\n  actionName: string,\n  args: unknown[],\n  config: ActionConfig,\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    id,\n    actionId,\n    actionName,\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('eidos-queue-replay')\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 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\nlet _replaying = false\n\nexport async function replayQueue(): Promise<ReplayResult> {\n  const store = useEidosStore.getState()\n  if (!store.isOnline || _replaying) {\n    return { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 }\n  }\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'\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  try {\n    await fn(...(item.args as unknown[]))\n    const completedAt = Date.now()\n    store.updateQueueItem(item.id, { 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      qs().remove(item.id)\n    }, 3000)\n    return 'succeeded'\n  } catch (err) {\n    // 4xx: give onConflict a chance to decide before normal retry/fail logic\n    if (isClientError(err)) {\n      const onConflict = _conflictRegistry.get(item.actionId)\n      if (onConflict) {\n        const resolution = onConflict(err, item.args as unknown[])\n        if (resolution === 'skip') {\n          store.removeQueueItem(item.id)\n          await qs().remove(item.id)\n          return 'conflicted'\n        }\n        // 'retry' falls through to normal retry/fail logic below\n      }\n    }\n\n    const retryCount = item.retryCount + 1\n    if (retryCount >= item.maxRetries) {\n      store.updateQueueItem(item.id, { status: 'failed', error: String(err), retryCount })\n      await qs().update(item.id, { status: 'failed', error: String(err), retryCount })\n      _rollbackRegistry.get(item.actionId)?.(...(item.args as unknown[]))\n      return 'failed'\n    } else {\n      const nextRetryAt = Date.now() + backoffMs(retryCount)\n      store.updateQueueItem(item.id, { status: 'pending', retryCount, nextRetryAt })\n      await qs().update(item.id, { status: 'pending', retryCount, nextRetryAt })\n      return 'retrying'\n    }\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    store.batchUpdateQueueItems(replayable.map((item) => ({ id: item.id, update: { status: 'replaying' } })))\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') { result.skipped++ }\n    else if (outcome === 'conflicted') { result.conflicted++ }\n    else { result.attempted++; result[outcome]++ }\n  }\n}\n\nasync function _doReplayQueue(store: ReturnType<typeof useEidosStore.getState>): Promise<ReplayResult> {\n  const candidates = await qs().getPending()\n  const now = Date.now()\n  const pending = candidates.filter((item) => !item.nextRetryAt || item.nextRetryAt <= now)\n\n  const result: ReplayResult = { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 }\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"],"names":["_actionRegistry","_rollbackRegistry","_conflictRegistry","_idbFallback","item","idbAddToQueue","idbGetQueue","idbGetPendingItems","id","patch","idbUpdateQueueItem","idbRemoveFromQueue","idbClearQueue","qs","_getQueueStorage","uid","action","fn","config","actionId","wrapped","args","isOnline","useEidosStore","_a","persistAndQueue","err","_b","actionName","reg","getSwRegistration","isClientError","s","backoffMs","retryCount","_replaying","replayQueue","store","_doReplayQueue","_replayItem","completedAt","onConflict","nextRetryAt","_replayTier","items","result","replayable","outcomes","o","outcome","candidates","now","pending","tier","tierItems","clearQueue"],"mappings":"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"}

package/dist/async-storage-adapter.js

@@ -0,0 +1,42 @@
+const i = "@eidos:queue";
+class l {
+  constructor(t) {
+    this.storage = t;
+  }
+  async readAll() {
+    try {
+      const t = await this.storage.getItem(i);
+      return t ? JSON.parse(t) : [];
+    } catch {
+      return [];
+    }
+  }
+  async writeAll(t) {
+    await this.storage.setItem(i, JSON.stringify(t));
+  }
+  async add(t) {
+    const e = await this.readAll();
+    e.push(t), await this.writeAll(e);
+  }
+  async getAll() {
+    return this.readAll();
+  }
+  async getPending() {
+    return (await this.readAll()).filter((e) => e.status === "pending" || e.status === "failed");
+  }
+  async update(t, e) {
+    const a = await this.readAll(), s = a.findIndex((r) => r.id === t);
+    s !== -1 && (a[s] = { ...a[s], ...e }), await this.writeAll(a);
+  }
+  async remove(t) {
+    const e = await this.readAll();
+    await this.writeAll(e.filter((a) => a.id !== t));
+  }
+  async clear() {
+    await this.storage.removeItem(i);
+  }
+}
+export {
+  l as AsyncStorageQueueStorage
+};
+//# sourceMappingURL=async-storage-adapter.js.map

package/dist/async-storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-storage-adapter.js","sources":["../src/async-storage-adapter.ts"],"sourcesContent":["import type { ActionQueueItem } from './types'\nimport type { QueueStorage } from './queue-storage'\n\n/** Minimal subset of @react-native-async-storage/async-storage (or any compatible key-value store). */\nexport interface AsyncStorageLike {\n  getItem(key: string): Promise<string | null>\n  setItem(key: string, value: string): Promise<void>\n  removeItem(key: string): Promise<void>\n}\n\nconst QUEUE_KEY = '@eidos:queue'\n\n/**\n * QueueStorage implementation backed by any AsyncStorage-compatible API.\n * Pass the AsyncStorage singleton from @react-native-async-storage/async-storage\n * (or MMKV, SQLite, or any store that satisfies AsyncStorageLike).\n */\nexport class AsyncStorageQueueStorage implements QueueStorage {\n  constructor(private readonly storage: AsyncStorageLike) {}\n\n  private async readAll(): Promise<ActionQueueItem[]> {\n    try {\n      const raw = await this.storage.getItem(QUEUE_KEY)\n      if (!raw) return []\n      return JSON.parse(raw) as ActionQueueItem[]\n    } catch {\n      return []\n    }\n  }\n\n  private async writeAll(items: ActionQueueItem[]): Promise<void> {\n    await this.storage.setItem(QUEUE_KEY, JSON.stringify(items))\n  }\n\n  async add(item: ActionQueueItem): Promise<void> {\n    const items = await this.readAll()\n    items.push(item)\n    await this.writeAll(items)\n  }\n\n  async getAll(): Promise<ActionQueueItem[]> {\n    return this.readAll()\n  }\n\n  async getPending(): Promise<ActionQueueItem[]> {\n    const items = await this.readAll()\n    return items.filter((i) => i.status === 'pending' || i.status === 'failed')\n  }\n\n  async update(id: string, patch: Partial<ActionQueueItem>): Promise<void> {\n    const items = await this.readAll()\n    const idx = items.findIndex((i) => i.id === id)\n    if (idx !== -1) items[idx] = { ...items[idx], ...patch }\n    await this.writeAll(items)\n  }\n\n  async remove(id: string): Promise<void> {\n    const items = await this.readAll()\n    await this.writeAll(items.filter((i) => i.id !== id))\n  }\n\n  async clear(): Promise<void> {\n    await this.storage.removeItem(QUEUE_KEY)\n  }\n}\n"],"names":["QUEUE_KEY","AsyncStorageQueueStorage","storage","raw","items","item","i","id","patch","idx"],"mappings":"AAUA,MAAMA,IAAY;AAOX,MAAMC,EAAiD;AAAA,EAC5D,YAA6BC,GAA2B;AAA3B,SAAA,UAAAA;AAAA,EAA4B;AAAA,EAEzD,MAAc,UAAsC;AAClD,QAAI;AACF,YAAMC,IAAM,MAAM,KAAK,QAAQ,QAAQH,CAAS;AAChD,aAAKG,IACE,KAAK,MAAMA,CAAG,IADJ,CAAA;AAAA,IAEnB,QAAQ;AACN,aAAO,CAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAc,SAASC,GAAyC;AAC9D,UAAM,KAAK,QAAQ,QAAQJ,GAAW,KAAK,UAAUI,CAAK,CAAC;AAAA,EAC7D;AAAA,EAEA,MAAM,IAAIC,GAAsC;AAC9C,UAAMD,IAAQ,MAAM,KAAK,QAAA;AACzB,IAAAA,EAAM,KAAKC,CAAI,GACf,MAAM,KAAK,SAASD,CAAK;AAAA,EAC3B;AAAA,EAEA,MAAM,SAAqC;AACzC,WAAO,KAAK,QAAA;AAAA,EACd;AAAA,EAEA,MAAM,aAAyC;AAE7C,YADc,MAAM,KAAK,QAAA,GACZ,OAAO,CAACE,MAAMA,EAAE,WAAW,aAAaA,EAAE,WAAW,QAAQ;AAAA,EAC5E;AAAA,EAEA,MAAM,OAAOC,GAAYC,GAAgD;AACvE,UAAMJ,IAAQ,MAAM,KAAK,QAAA,GACnBK,IAAML,EAAM,UAAU,CAACE,MAAMA,EAAE,OAAOC,CAAE;AAC9C,IAAIE,MAAQ,OAAIL,EAAMK,CAAG,IAAI,EAAE,GAAGL,EAAMK,CAAG,GAAG,GAAGD,EAAA,IACjD,MAAM,KAAK,SAASJ,CAAK;AAAA,EAC3B;AAAA,EAEA,MAAM,OAAOG,GAA2B;AACtC,UAAMH,IAAQ,MAAM,KAAK,QAAA;AACzB,UAAM,KAAK,SAASA,EAAM,OAAO,CAACE,MAAMA,EAAE,OAAOC,CAAE,CAAC;AAAA,EACtD;AAAA,EAEA,MAAM,QAAuB;AAC3B,UAAM,KAAK,QAAQ,WAAWP,CAAS;AAAA,EACzC;AACF;"}

package/dist/devtools.js

@@ -11,7 +11,8 @@ function _set(updater) {
   _notify();
 }
 _state = {
-  isOnline: typeof navigator !== "undefined" ? navigator.onLine : true,
+  // navigator.onLine is undefined in React Native — default to true unless explicitly false
+  isOnline: typeof navigator === "undefined" || navigator.onLine !== false,
   swStatus: "idle",
   swError: void 0,
   resources: {},
@@ -119,6 +120,24 @@ function openDB() {
     req.onerror = () => reject(req.error);
   });
 }
+async function idbAddToQueue(item) {
+  const db = await openDB();
+  return new Promise((resolve, reject) => {
+    const tx = db.transaction(QUEUE_STORE, "readwrite");
+    tx.objectStore(QUEUE_STORE).add(item);
+    tx.oncomplete = () => resolve();
+    tx.onerror = () => reject(tx.error);
+  });
+}
+async function idbGetQueue() {
+  const db = await openDB();
+  return new Promise((resolve, reject) => {
+    const tx = db.transaction(QUEUE_STORE, "readonly");
+    const req = tx.objectStore(QUEUE_STORE).getAll();
+    req.onsuccess = () => resolve(req.result);
+    req.onerror = () => reject(req.error);
+  });
+}
 async function idbUpdateQueueItem(id, update) {
   const db = await openDB();
   return new Promise((resolve, reject) => {
@@ -189,6 +208,17 @@ async function idbClearQueue() {
 const _actionRegistry = /* @__PURE__ */ new Map();
 const _rollbackRegistry = /* @__PURE__ */ new Map();
 const _conflictRegistry = /* @__PURE__ */ new Map();
+const _idbFallback = {
+  add: (item) => idbAddToQueue(item),
+  getAll: () => idbGetQueue(),
+  getPending: () => idbGetPendingItems(),
+  update: (id, patch) => idbUpdateQueueItem(id, patch),
+  remove: (id) => idbRemoveFromQueue(id),
+  clear: () => idbClearQueue()
+};
+function qs() {
+  return _idbFallback;
+}
 function isClientError(err) {
   if (err instanceof Response) return err.status >= 400 && err.status < 500;
   if (typeof err === "object" && err !== null) {
@@ -222,10 +252,10 @@ async function _replayItem(item, store) {
     await fn(...item.args);
     const completedAt = Date.now();
     store.updateQueueItem(item.id, { status: "succeeded", completedAt });
-    await idbUpdateQueueItem(item.id, { status: "succeeded", completedAt });
+    await qs().update(item.id, { status: "succeeded", completedAt });
     setTimeout(() => {
       store.removeQueueItem(item.id);
-      idbRemoveFromQueue(item.id);
+      qs().remove(item.id);
     }, 3e3);
     return "succeeded";
   } catch (err) {
@@ -235,7 +265,7 @@ async function _replayItem(item, store) {
         const resolution = onConflict(err, item.args);
         if (resolution === "skip") {
           store.removeQueueItem(item.id);
-          await idbRemoveFromQueue(item.id);
+          await qs().remove(item.id);
           return "conflicted";
         }
       }
@@ -243,13 +273,13 @@ async function _replayItem(item, store) {
     const retryCount = item.retryCount + 1;
     if (retryCount >= item.maxRetries) {
       store.updateQueueItem(item.id, { status: "failed", error: String(err), retryCount });
-      await idbUpdateQueueItem(item.id, { status: "failed", error: String(err), retryCount });
+      await qs().update(item.id, { status: "failed", error: String(err), retryCount });
       (_a = _rollbackRegistry.get(item.actionId)) == null ? void 0 : _a(...item.args);
       return "failed";
     } else {
       const nextRetryAt = Date.now() + backoffMs(retryCount);
       store.updateQueueItem(item.id, { status: "pending", retryCount, nextRetryAt });
-      await idbUpdateQueueItem(item.id, { status: "pending", retryCount, nextRetryAt });
+      await qs().update(item.id, { status: "pending", retryCount, nextRetryAt });
       return "retrying";
     }
   }
@@ -261,7 +291,7 @@ async function _replayTier(items, store, result) {
   if (replayable.length > 0) {
     store.batchUpdateQueueItems(replayable.map((item) => ({ id: item.id, update: { status: "replaying" } })));
     for (const item of replayable) {
-      idbUpdateQueueItem(item.id, { status: "replaying" });
+      qs().update(item.id, { status: "replaying" });
     }
   }
   const outcomes = await Promise.allSettled(replayable.map((item) => _replayItem(item, store)));
@@ -278,7 +308,7 @@ async function _replayTier(items, store, result) {
   }
 }
 async function _doReplayQueue(store) {
-  const candidates = await idbGetPendingItems();
+  const candidates = await qs().getPending();
   const now = Date.now();
   const pending = candidates.filter((item) => !item.nextRetryAt || item.nextRetryAt <= now);
   const result = { attempted: 0, succeeded: 0, failed: 0, retrying: 0, skipped: 0, conflicted: 0 };
@@ -289,7 +319,7 @@ async function _doReplayQueue(store) {
   return result;
 }
 async function clearQueue() {
-  await idbClearQueue();
+  await qs().clear();
   useEidosStore.getState().hydrateQueue([]);
 }
 const C = {