@columenlabs/lumen-ui 0.1.120 → 0.1.121

package/dist/index.d.ts

@@ -76,6 +76,7 @@ export { type McpServer, McpSettings } from './mcp-settings.js';
 export { lumenToast } from './lumen-toast.js';
 export { LumenShell, type LumenShellProps, type ShellUser, StatusItem, firstName, initials, maskAmount, useAmountsHidden, useApp, useShell, } from './shell.js';
 export { apiJson } from './api-fetch.js';
+export { savedAnswers, type SavedAnswersOptions, type SavedAnswersPersister, } from './saved-answers.js';
 export { cn } from './lib/utils.js';
 export { type HealthProbe, StatusHealth } from './status-health.js';
 export { type StatusMessage, type StatusMessageTone, StatusMessages, groupStatusMessages, } from './status-messages.js';

package/dist/index.js

@@ -83,6 +83,7 @@ export { McpSettings } from './mcp-settings.js';
 export { lumenToast } from './lumen-toast.js';
 export { LumenShell, StatusItem, firstName, initials, maskAmount, useAmountsHidden, useApp, useShell, } from './shell.js';
 export { apiJson } from './api-fetch.js';
+export { savedAnswers, } from './saved-answers.js';
 export { cn } from './lib/utils.js';
 export { StatusHealth } from './status-health.js';
 export { StatusMessages, groupStatusMessages, } from './status-messages.js';

package/dist/saved-answers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Saved answers: a react-query persister that keeps an app's answers in IndexedDB, so a page
+ * paints at once from the last visit. Pass it to `PersistQueryClientProvider` as `persister`.
+ *
+ * Nothing waits on the device for good: a read that has not answered within `restoreMs` (another
+ * tab holding a write, a broken store) gives up and the app asks the server, and an aborted or
+ * blocked store fails instead of hanging. The provider shows nothing until the restore settles,
+ * so a hung read would otherwise leave the app blank. Writes go out at most once a second, as one
+ * record kept as an object (no JSON round trip).
+ */
+/** The shape `@tanstack/react-query-persist-client` expects; kept structural so the kit needs no extra package. */
+export interface SavedAnswersPersister<C = unknown> {
+    persistClient: (client: C) => void;
+    restoreClient: () => Promise<C | undefined>;
+    removeClient: () => Promise<void> | void;
+}
+export interface SavedAnswersOptions {
+    /** The IndexedDB database name; one per app. */
+    name: string;
+    /** How long the first paint waits for the saved answers before asking the server (ms). Default 1500. */
+    restoreMs?: number;
+    /** How long writes wait to batch (ms). Default 1000. */
+    writeMs?: number;
+}
+export declare function savedAnswers<C = unknown>({ name, restoreMs, writeMs, }: SavedAnswersOptions): SavedAnswersPersister<C>;

package/dist/saved-answers.js

@@ -0,0 +1,60 @@
+/**
+ * Saved answers: a react-query persister that keeps an app's answers in IndexedDB, so a page
+ * paints at once from the last visit. Pass it to `PersistQueryClientProvider` as `persister`.
+ *
+ * Nothing waits on the device for good: a read that has not answered within `restoreMs` (another
+ * tab holding a write, a broken store) gives up and the app asks the server, and an aborted or
+ * blocked store fails instead of hanging. The provider shows nothing until the restore settles,
+ * so a hung read would otherwise leave the app blank. Writes go out at most once a second, as one
+ * record kept as an object (no JSON round trip).
+ */
+const KEY = 'queries';
+export function savedAnswers({ name, restoreMs = 1500, writeMs = 1000, }) {
+    // No IndexedDB (a test runner, a locked-down browser): nothing is saved, every load asks the server.
+    if (typeof indexedDB === 'undefined')
+        return {
+            persistClient: () => { },
+            restoreClient: async () => undefined,
+            removeClient: () => { },
+        };
+    let db;
+    const open = () => {
+        if (!db)
+            db = new Promise((resolve, reject) => {
+                const req = indexedDB.open(name, 1);
+                req.onupgradeneeded = () => req.result.createObjectStore('cache');
+                req.onsuccess = () => resolve(req.result);
+                req.onerror = () => reject(req.error);
+                req.onblocked = () => reject(new Error(`${name}: saved answers blocked`));
+            }).catch((e) => {
+                // A failed open is tried again on the next read or write.
+                db = undefined;
+                throw e;
+            });
+        return db;
+    };
+    const run = (mode, op) => open().then((d) => new Promise((resolve, reject) => {
+        const tx = d.transaction('cache', mode);
+        const req = op(tx.objectStore('cache'));
+        tx.oncomplete = () => resolve(req.result);
+        tx.onerror = () => reject(tx.error);
+        // An aborted transaction (storage full, the browser gave up) fires only abort, never error.
+        tx.onabort = () => reject(tx.error ?? new Error(`${name}: saved answers aborted`));
+    }));
+    let next;
+    let timer;
+    return {
+        persistClient: (client) => {
+            next = client;
+            timer ??= setTimeout(() => {
+                timer = undefined;
+                void run('readwrite', (s) => s.put(next, KEY)).catch(() => { });
+            }, writeMs);
+        },
+        restoreClient: () => Promise.race([
+            run('readonly', (s) => s.get(KEY)).catch(() => undefined),
+            new Promise((resolve) => setTimeout(() => resolve(undefined), restoreMs)),
+        ]),
+        removeClient: () => run('readwrite', (s) => s.delete(KEY)).then(() => { }, () => { }),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ui",
-  "version": "0.1.120",
+  "version": "0.1.121",
   "description": "Lumen: shared React components (frame, views, widgets, charts, drawers).",
   "license": "MIT",
   "type": "module",
@@ -49,7 +49,7 @@
     "@codemirror/lang-javascript": "6.2.5",
     "@codemirror/lang-json": "6.0.2",
     "@codemirror/lang-sql": "6.10.0",
-    "@columenlabs/lumen-ui-types": "0.1.120",
+    "@columenlabs/lumen-ui-types": "0.1.121",
     "@dnd-kit/core": "6.3.1",
     "@dnd-kit/sortable": "10.0.0",
     "@dnd-kit/utilities": "3.2.2",