@graphrefly/graphrefly 0.43.0 → 0.45.0

package/dist/extra/storage-browser.d.cts

@@ -1,37 +1 @@
-import { N as Node } from '../node-ClS5yC-B.cjs';
-
-/**
- * Browser-only IndexedDB reactive sources.
- *
- * `fromIDBRequest` / `fromIDBTransaction` wrap raw IDB primitives as reactive
- * sources. The old `indexedDbStorage` kv adapter has been replaced by
- * `indexedDbKv` in `./storage-tiers-browser.js` (Audit 4, 2026-04-24).
- *
- * Imports require the DOM lib — not safe to pull into Node-only bundles
- * without `lib: ["dom"]` in the consumer's tsconfig.
- *
- * @module
- */
-
-/**
- * Wraps an `IDBRequest` as a one-shot reactive source.
- *
- * @param req - Request whose callbacks are converted to protocol messages.
- * @returns `Node<T>` that emits `DATA` once on success then `COMPLETE`;
- *   emits `ERROR` on failure.
- *
- * @category extra
- */
-declare function fromIDBRequest<T>(req: IDBRequest<T>): Node<T>;
-/**
- * Wraps an `IDBTransaction` terminal lifecycle as a one-shot reactive source.
- *
- * @param tx - Transaction to observe.
- * @returns `Node<void>` that emits `DATA` (`undefined`) then `COMPLETE` on
- *   success; emits `ERROR` on `error`/`abort`.
- *
- * @category extra
- */
-declare function fromIDBTransaction(tx: IDBTransaction): Node<void>;
-
-export { fromIDBRequest, fromIDBTransaction };
+export * from '@graphrefly/pure-ts/extra/storage-browser';

package/dist/extra/storage-browser.d.ts

@@ -1,37 +1 @@
-import { N as Node } from '../node-ClS5yC-B.js';
-
-/**
- * Browser-only IndexedDB reactive sources.
- *
- * `fromIDBRequest` / `fromIDBTransaction` wrap raw IDB primitives as reactive
- * sources. The old `indexedDbStorage` kv adapter has been replaced by
- * `indexedDbKv` in `./storage-tiers-browser.js` (Audit 4, 2026-04-24).
- *
- * Imports require the DOM lib — not safe to pull into Node-only bundles
- * without `lib: ["dom"]` in the consumer's tsconfig.
- *
- * @module
- */
-
-/**
- * Wraps an `IDBRequest` as a one-shot reactive source.
- *
- * @param req - Request whose callbacks are converted to protocol messages.
- * @returns `Node<T>` that emits `DATA` once on success then `COMPLETE`;
- *   emits `ERROR` on failure.
- *
- * @category extra
- */
-declare function fromIDBRequest<T>(req: IDBRequest<T>): Node<T>;
-/**
- * Wraps an `IDBTransaction` terminal lifecycle as a one-shot reactive source.
- *
- * @param tx - Transaction to observe.
- * @returns `Node<void>` that emits `DATA` (`undefined`) then `COMPLETE` on
- *   success; emits `ERROR` on `error`/`abort`.
- *
- * @category extra
- */
-declare function fromIDBTransaction(tx: IDBTransaction): Node<void>;
-
-export { fromIDBRequest, fromIDBTransaction };
+export * from '@graphrefly/pure-ts/extra/storage-browser';

package/dist/extra/storage-browser.js

@@ -1 +1,3 @@
-import{a,b}from"../chunk-F3IGTWCQ.js";import"../chunk-LYCLF26R.js";import"../chunk-CK2E7BTU.js";import"../chunk-QYADASLV.js";export{a as fromIDBRequest,b as fromIDBTransaction};
+// src/extra/storage-browser.ts
+export * from "@graphrefly/pure-ts/extra/storage-browser";
+//# sourceMappingURL=storage-browser.js.map

package/dist/extra/storage-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-browser.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-browser\";\n"],"mappings":";AAEA,cAAc;","names":[]}

package/dist/extra/storage-core.cjs

@@ -1 +1,21 @@
-"use strict";var i=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var k=(n,o)=>{for(var t in o)i(n,t,{get:o[t],enumerable:!0})},d=(n,o,t,s)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of f(o))!u.call(n,r)&&r!==t&&i(n,r,{get:()=>o[r],enumerable:!(s=c(o,r))||s.enumerable});return n};var g=n=>d(i({},"__esModule",{value:!0}),n);var y={};k(y,{sortJsonValue:()=>e,stableJsonString:()=>p});module.exports=g(y);function e(n){if(n===null||typeof n!="object")return n;if(Array.isArray(n))return n.map(e);let o=n,t=Object.keys(o).sort(),s={};for(let r of t)s[r]=e(o[r]);return s}function p(n){return JSON.stringify(e(n),void 0,0)}0&&(module.exports={sortJsonValue,stableJsonString});
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/extra/storage-core.ts
+var storage_core_exports = {};
+module.exports = __toCommonJS(storage_core_exports);
+__reExport(storage_core_exports, require("@graphrefly/pure-ts/extra/storage-core"), module.exports);
+//# sourceMappingURL=storage-core.cjs.map

package/dist/extra/storage-core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-core.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-core\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,iCAAc,mDAFd;","names":[]}

package/dist/extra/storage-core.d.cts

@@ -1,28 +1 @@
-/**
- * Storage core — browser-safe shared helpers.
- *
- * This module exposes only the stable shared utilities (`StorageHandle`,
- * `sortJsonValue`, `stableJsonString`). The old `StorageTier` interface and
- * its in-memory factories (`memoryStorage`, `dictStorage`) have been removed
- * — use `KvStorageTier` + `memoryKv` / `dictKv` from `./storage-tiers.js`
- * instead (Audit 4, 2026-04-24).
- *
- * Node-only backends (`fileKv`, `sqliteKv`) live in `./storage-tiers-node.js`;
- * browser-only ones (`indexedDbKv`) live in `./storage-tiers-browser.js`.
- *
- * @module
- */
-/** Handle returned by `Graph.attachSnapshotStorage` — dispose to stop observing. */
-interface StorageHandle {
-    dispose(): void;
-}
-/** Recursively sort object keys so `JSON.stringify` output is order-independent. */
-declare function sortJsonValue(value: unknown): unknown;
-/**
- * Stable JSON encoding (no trailing newline). Tiers that want POSIX newline
- * convention (e.g. `fileKv`) append their own; in-database tiers (`sqliteKv`)
- * keep the payload byte-identical for cross-tier hash/CID comparison.
- */
-declare function stableJsonString(data: unknown): string;
-
-export { type StorageHandle, sortJsonValue, stableJsonString };
+export * from '@graphrefly/pure-ts/extra/storage-core';

package/dist/extra/storage-core.d.ts

@@ -1,28 +1 @@
-/**
- * Storage core — browser-safe shared helpers.
- *
- * This module exposes only the stable shared utilities (`StorageHandle`,
- * `sortJsonValue`, `stableJsonString`). The old `StorageTier` interface and
- * its in-memory factories (`memoryStorage`, `dictStorage`) have been removed
- * — use `KvStorageTier` + `memoryKv` / `dictKv` from `./storage-tiers.js`
- * instead (Audit 4, 2026-04-24).
- *
- * Node-only backends (`fileKv`, `sqliteKv`) live in `./storage-tiers-node.js`;
- * browser-only ones (`indexedDbKv`) live in `./storage-tiers-browser.js`.
- *
- * @module
- */
-/** Handle returned by `Graph.attachSnapshotStorage` — dispose to stop observing. */
-interface StorageHandle {
-    dispose(): void;
-}
-/** Recursively sort object keys so `JSON.stringify` output is order-independent. */
-declare function sortJsonValue(value: unknown): unknown;
-/**
- * Stable JSON encoding (no trailing newline). Tiers that want POSIX newline
- * convention (e.g. `fileKv`) append their own; in-database tiers (`sqliteKv`)
- * keep the payload byte-identical for cross-tier hash/CID comparison.
- */
-declare function stableJsonString(data: unknown): string;
-
-export { type StorageHandle, sortJsonValue, stableJsonString };
+export * from '@graphrefly/pure-ts/extra/storage-core';

package/dist/extra/storage-core.js

@@ -1 +1,3 @@
-import{a,b}from"../chunk-CE72X3WO.js";import"../chunk-QYADASLV.js";export{a as sortJsonValue,b as stableJsonString};
+// src/extra/storage-core.ts
+export * from "@graphrefly/pure-ts/extra/storage-core";
+//# sourceMappingURL=storage-core.js.map

package/dist/extra/storage-core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-core.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-core\";\n"],"mappings":";AAEA,cAAc;","names":[]}

package/dist/extra/storage-node.cjs

@@ -1 +1,21 @@
 "use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/extra/storage-node.ts
+var storage_node_exports = {};
+module.exports = __toCommonJS(storage_node_exports);
+__reExport(storage_node_exports, require("@graphrefly/pure-ts/extra/storage-node"), module.exports);
+//# sourceMappingURL=storage-node.cjs.map

package/dist/extra/storage-node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-node.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-node\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,iCAAc,mDAFd;","names":[]}

package/dist/extra/storage-node.d.cts

@@ -1,2 +1 @@
-
-export {  }
+export * from '@graphrefly/pure-ts/extra/storage-node';

package/dist/extra/storage-node.d.ts

@@ -1,2 +1 @@
-
-export {  }
+export * from '@graphrefly/pure-ts/extra/storage-node';

package/dist/extra/storage-node.js

@@ -0,0 +1,3 @@
+// src/extra/storage-node.ts
+export * from "@graphrefly/pure-ts/extra/storage-node";
+//# sourceMappingURL=storage-node.js.map

package/dist/extra/storage-node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-node.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-node\";\n"],"mappings":";AAEA,cAAc;","names":[]}

package/dist/extra/storage-tiers-browser.cjs

@@ -1 +1,21 @@
-"use strict";var b=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var E=(e,n)=>{for(var t in n)b(e,t,{get:n[t],enumerable:!0})},K=(e,n,t,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of N(n))!C.call(e,r)&&r!==t&&b(e,r,{get:()=>n[r],enumerable:!(o=M(n,r))||o.enumerable});return e};var U=e=>K(b({},"__esModule",{value:!0}),e);var W={};E(W,{indexedDbAppendLog:()=>J,indexedDbBackend:()=>v,indexedDbKv:()=>F,indexedDbSnapshot:()=>R});module.exports=U(W);function h(e){if(e===null||typeof e!="object")return e;if(Array.isArray(e))return e.map(h);let n=e,t=Object.keys(n).sort(),o={};for(let r of t)o[r]=h(n[r]);return o}function x(e){return JSON.stringify(h(e),void 0,0)}var L=new TextEncoder,j=new TextDecoder("utf-8",{fatal:!0}),k={name:"json",version:1,encode(e){return L.encode(x(e))},decode(e){return JSON.parse(j.decode(e))}};function P(e,n={}){let t=n.codec??k,o=n.name??e.name??"snapshot",r=n.keyOf??(l=>l.name??n.name??e.name??"snapshot"),d,u=0,p=n.compactEvery,s,i={name:o,debounceMs:n.debounceMs,compactEvery:p,filter:n.filter,keyOf:r,save(l){if(!(n.filter&&!n.filter(l))&&(d={snapshot:l},u+=1,p!==void 0&&u%p===0||!n.debounceMs))return a()},load(){let l=s??o,c=e.read(l);if(c!==void 0)return c instanceof Uint8Array?c.length===0?void 0:t.decode(c):Promise.resolve(c).then(f=>f===void 0||f.length===0?void 0:t.decode(f))},async flush(){await a()},async rollback(){d=void 0}};function a(){let l=d;if(!l)return;d=void 0;let c=r(l.snapshot),f=t.encode(l.snapshot),m=e.write(c,f);if(m instanceof Promise)return m.then(()=>{s=c});s=c}return i}function A(e,n={}){let t=n.codec??k,o=n.name??e.name??"append-log",r=n.keyOf??(c=>o),d=n.compactEvery,u=new Map,p=0,s,i={name:o,debounceMs:n.debounceMs,compactEvery:d,keyOf:r,appendEntries(c){if(c.length!==0){for(let f of c){let m=r(f),y=u.get(m);y||(y=[],u.set(m,y)),y.push(f)}if(p+=c.length,d!==void 0&&p%d===0||!n.debounceMs)return a()}},async loadEntries(c){let f=c?.keyFilter,m=e.list===void 0?f!==void 0?[f]:[o]:await Promise.resolve(e.list(f)),y=[];for(let S of m){let T=await Promise.resolve(e.read(S));if(T===void 0||T.length===0)continue;let g=t.decode(T);Array.isArray(g)&&y.push(...g)}return{entries:y,cursor:void 0}},async flush(){await a()},async rollback(){u=new Map}};function a(){if(u.size===0)return;let c=u;u=new Map;let f=(s??Promise.resolve()).then(()=>{let m=l(c);return m instanceof Promise?m:Promise.resolve()},()=>{let m=l(c);return m instanceof Promise?m:Promise.resolve()});return s=f.finally(()=>{s===f&&(s=void 0)}),s}function l(c){let f=[];for(let[m,y]of c){let S=e.read(m),T=g=>{let B=[...g===void 0||g.length===0?[]:t.decode(g)??[],...y],D=t.encode(B);return e.write(m,D)};if(S instanceof Promise)f.push(S.then(async g=>{let w=T(g);w instanceof Promise&&await w}));else{let g=T(S);g instanceof Promise&&f.push(g)}}if(f.length>0)return Promise.all(f).then(()=>{})}return i}function O(e,n={}){let t=n.codec??k,o=n.name??e.name??"kv",r=n.compactEvery,d=new Map,u=0,p={name:o,debounceMs:n.debounceMs,compactEvery:r,filter:n.filter,save(i,a){if(!(n.filter&&!n.filter(i,a))&&(d.set(i,a),u+=1,r!==void 0&&u%r===0||!n.debounceMs))return s()},load(i){let a=e.read(i);if(a!==void 0)return a instanceof Uint8Array?a.length===0?void 0:t.decode(a):Promise.resolve(a).then(l=>l===void 0||l.length===0?void 0:t.decode(l))},delete(i){if(d.delete(i),!!e.delete)return e.delete(i)},list(i){return e.list?e.list(i):[]},async flush(){await s()},async rollback(){d=new Map}};function s(){if(d.size===0)return;let i=d;d=new Map;let a=[];for(let[l,c]of i){let f=t.encode(c),m=e.write(l,f);m instanceof Promise&&a.push(m)}if(a.length>0)return Promise.all(a).then(()=>{})}return p}function I(e){return new Promise((n,t)=>{if(typeof indexedDB>"u"){t(new TypeError("indexedDB is not available in this environment"));return}let o=indexedDB.open(e.dbName,e.version??1);o.onupgradeneeded=()=>{let r=o.result;r.objectStoreNames.contains(e.storeName)||r.createObjectStore(e.storeName)},o.onsuccess=()=>n(o.result),o.onerror=()=>t(o.error??new Error(`indexedDbBackend: open(${e.dbName}) failed`))})}function v(e){let n=I(e);return{name:`idb:${e.dbName}/${e.storeName}`,async read(t){let o=await n;return new Promise((r,d)=>{let s=o.transaction(e.storeName,"readonly").objectStore(e.storeName).get(t);s.onsuccess=()=>{let i=s.result;i==null?r(void 0):i instanceof Uint8Array?r(i):i instanceof ArrayBuffer?r(new Uint8Array(i)):r(void 0)},s.onerror=()=>d(s.error)})},async write(t,o){let r=await n;await new Promise((d,u)=>{let p=r.transaction(e.storeName,"readwrite");p.objectStore(e.storeName).put(o,t),p.oncomplete=()=>d(),p.onerror=()=>u(p.error),p.onabort=()=>u(p.error??new Error("indexedDbBackend: write aborted"))})},async delete(t){let o=await n;await new Promise((r,d)=>{let u=o.transaction(e.storeName,"readwrite");u.objectStore(e.storeName).delete(t),u.oncomplete=()=>r(),u.onerror=()=>d(u.error)})},async list(t){let o=await n;return new Promise((r,d)=>{let s=o.transaction(e.storeName,"readonly").objectStore(e.storeName).getAllKeys();s.onsuccess=()=>{let i=s.result.map(a=>String(a));r(t===void 0?i.sort():i.filter(a=>a.startsWith(t)).sort())},s.onerror=()=>d(s.error)})}}}function R(e,n){return P(v(e),n)}function J(e,n){return A(v(e),n)}function F(e,n){return O(v(e),n)}0&&(module.exports={indexedDbAppendLog,indexedDbBackend,indexedDbKv,indexedDbSnapshot});
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/extra/storage-tiers-browser.ts
+var storage_tiers_browser_exports = {};
+module.exports = __toCommonJS(storage_tiers_browser_exports);
+__reExport(storage_tiers_browser_exports, require("@graphrefly/pure-ts/extra/storage-tiers-browser"), module.exports);
+//# sourceMappingURL=storage-tiers-browser.cjs.map

package/dist/extra/storage-tiers-browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-tiers-browser.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-tiers-browser\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,0CAAc,4DAFd;","names":[]}

package/dist/extra/storage-tiers-browser.d.cts

@@ -1,120 +1 @@
-import { AppendLogStorageOptions, AppendLogStorageTier, StorageBackend, KvStorageOptions, KvStorageTier, SnapshotStorageOptions, SnapshotStorageTier } from './storage-tiers.cjs';
-
-/**
- * Browser-only Audit 4 storage backend + convenience factories.
- *
- * Uses DOM `IndexedDB`. Browser-safe consumers should import from this module;
- * Node consumers should not import here without the DOM lib in their tsconfig.
- *
- * @module
- */
-
-type IndexedDbBackendSpec = {
-    dbName: string;
-    storeName: string;
-    version?: number;
-};
-/**
- * Creates an IndexedDB backend for browser-based persistent storage.
- *
- * All operations (`read`, `write`, `delete`, `list`) are async and return
- * `Promise`. The backing object store is created automatically on first open
- * if it does not already exist.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @returns `StorageBackend` backed by an IndexedDB object store.
- *
- * @example
- * ```ts
- * import { indexedDbBackend, snapshotStorage } from "@graphrefly/graphrefly/extra/browser";
- *
- * const backend = indexedDbBackend({ dbName: "my-app", storeName: "snapshots" });
- * const tier = snapshotStorage(backend, { name: "graph1" });
- * await tier.save({ name: "graph1", state: {} });
- * ```
- *
- * @category extra
- */
-declare function indexedDbBackend(spec: IndexedDbBackendSpec): StorageBackend;
-/**
- * Creates an IndexedDB snapshot tier backed by an `indexedDbBackend`.
- *
- * Convenience wrapper for `snapshotStorage(indexedDbBackend(spec), opts)`.
- * All reads and writes are async via IndexedDB. Requires a browser or
- * browser-compatible environment.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @param opts - Optional snapshot storage options (name, codec, filter, keyOf, debounce, compactEvery).
- * @returns `SnapshotStorageTier<T>` backed by IndexedDB.
- *
- * @example
- * ```ts
- * import { indexedDbSnapshot } from "@graphrefly/graphrefly/extra/browser";
- *
- * const tier = indexedDbSnapshot<{ count: number }>(
- *   { dbName: "my-app", storeName: "snapshots" },
- *   { name: "counter" },
- * );
- * await tier.save({ count: 1 });
- * ```
- *
- * @category extra
- */
-declare function indexedDbSnapshot<T>(spec: IndexedDbBackendSpec, opts?: Omit<SnapshotStorageOptions<T>, "name"> & {
-    name?: string;
-}): SnapshotStorageTier<T>;
-/**
- * Creates an IndexedDB append-log tier backed by an `indexedDbBackend`.
- *
- * Convenience wrapper for `appendLogStorage(indexedDbBackend(spec), opts)`.
- * All reads and writes are async via IndexedDB. Requires a browser or
- * browser-compatible environment.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @param opts - Optional append-log storage options (name, codec, keyOf, debounce, compactEvery).
- * @returns `AppendLogStorageTier<T>` backed by IndexedDB.
- *
- * @example
- * ```ts
- * import { indexedDbAppendLog } from "@graphrefly/graphrefly/extra/browser";
- *
- * const tier = indexedDbAppendLog<{ type: string }>(
- *   { dbName: "my-app", storeName: "events" },
- * );
- * await tier.appendEntries([{ type: "init" }]);
- * ```
- *
- * @category extra
- */
-declare function indexedDbAppendLog<T>(spec: IndexedDbBackendSpec, opts?: Omit<AppendLogStorageOptions<T>, "name"> & {
-    name?: string;
-}): AppendLogStorageTier<T>;
-/**
- * Creates an IndexedDB key-value tier backed by an `indexedDbBackend`.
- *
- * Convenience wrapper for `kvStorage(indexedDbBackend(spec), opts)`.
- * All reads and writes are async via IndexedDB. Requires a browser or
- * browser-compatible environment.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @param opts - Optional kv storage options (name, codec, filter, debounce, compactEvery).
- * @returns `KvStorageTier<T>` backed by IndexedDB.
- *
- * @example
- * ```ts
- * import { indexedDbKv } from "@graphrefly/graphrefly/extra/browser";
- *
- * const kv = indexedDbKv<{ score: number }>(
- *   { dbName: "my-app", storeName: "scores" },
- * );
- * await kv.save("player1", { score: 100 });
- * const val = await kv.load("player1");
- * ```
- *
- * @category extra
- */
-declare function indexedDbKv<T>(spec: IndexedDbBackendSpec, opts?: Omit<KvStorageOptions<T>, "name"> & {
-    name?: string;
-}): KvStorageTier<T>;
-
-export { type IndexedDbBackendSpec, indexedDbAppendLog, indexedDbBackend, indexedDbKv, indexedDbSnapshot };
+export * from '@graphrefly/pure-ts/extra/storage-tiers-browser';

package/dist/extra/storage-tiers-browser.d.ts

@@ -1,120 +1 @@
-import { AppendLogStorageOptions, AppendLogStorageTier, StorageBackend, KvStorageOptions, KvStorageTier, SnapshotStorageOptions, SnapshotStorageTier } from './storage-tiers.js';
-
-/**
- * Browser-only Audit 4 storage backend + convenience factories.
- *
- * Uses DOM `IndexedDB`. Browser-safe consumers should import from this module;
- * Node consumers should not import here without the DOM lib in their tsconfig.
- *
- * @module
- */
-
-type IndexedDbBackendSpec = {
-    dbName: string;
-    storeName: string;
-    version?: number;
-};
-/**
- * Creates an IndexedDB backend for browser-based persistent storage.
- *
- * All operations (`read`, `write`, `delete`, `list`) are async and return
- * `Promise`. The backing object store is created automatically on first open
- * if it does not already exist.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @returns `StorageBackend` backed by an IndexedDB object store.
- *
- * @example
- * ```ts
- * import { indexedDbBackend, snapshotStorage } from "@graphrefly/graphrefly/extra/browser";
- *
- * const backend = indexedDbBackend({ dbName: "my-app", storeName: "snapshots" });
- * const tier = snapshotStorage(backend, { name: "graph1" });
- * await tier.save({ name: "graph1", state: {} });
- * ```
- *
- * @category extra
- */
-declare function indexedDbBackend(spec: IndexedDbBackendSpec): StorageBackend;
-/**
- * Creates an IndexedDB snapshot tier backed by an `indexedDbBackend`.
- *
- * Convenience wrapper for `snapshotStorage(indexedDbBackend(spec), opts)`.
- * All reads and writes are async via IndexedDB. Requires a browser or
- * browser-compatible environment.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @param opts - Optional snapshot storage options (name, codec, filter, keyOf, debounce, compactEvery).
- * @returns `SnapshotStorageTier<T>` backed by IndexedDB.
- *
- * @example
- * ```ts
- * import { indexedDbSnapshot } from "@graphrefly/graphrefly/extra/browser";
- *
- * const tier = indexedDbSnapshot<{ count: number }>(
- *   { dbName: "my-app", storeName: "snapshots" },
- *   { name: "counter" },
- * );
- * await tier.save({ count: 1 });
- * ```
- *
- * @category extra
- */
-declare function indexedDbSnapshot<T>(spec: IndexedDbBackendSpec, opts?: Omit<SnapshotStorageOptions<T>, "name"> & {
-    name?: string;
-}): SnapshotStorageTier<T>;
-/**
- * Creates an IndexedDB append-log tier backed by an `indexedDbBackend`.
- *
- * Convenience wrapper for `appendLogStorage(indexedDbBackend(spec), opts)`.
- * All reads and writes are async via IndexedDB. Requires a browser or
- * browser-compatible environment.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @param opts - Optional append-log storage options (name, codec, keyOf, debounce, compactEvery).
- * @returns `AppendLogStorageTier<T>` backed by IndexedDB.
- *
- * @example
- * ```ts
- * import { indexedDbAppendLog } from "@graphrefly/graphrefly/extra/browser";
- *
- * const tier = indexedDbAppendLog<{ type: string }>(
- *   { dbName: "my-app", storeName: "events" },
- * );
- * await tier.appendEntries([{ type: "init" }]);
- * ```
- *
- * @category extra
- */
-declare function indexedDbAppendLog<T>(spec: IndexedDbBackendSpec, opts?: Omit<AppendLogStorageOptions<T>, "name"> & {
-    name?: string;
-}): AppendLogStorageTier<T>;
-/**
- * Creates an IndexedDB key-value tier backed by an `indexedDbBackend`.
- *
- * Convenience wrapper for `kvStorage(indexedDbBackend(spec), opts)`.
- * All reads and writes are async via IndexedDB. Requires a browser or
- * browser-compatible environment.
- *
- * @param spec - Database name, object store name, and optional schema version.
- * @param opts - Optional kv storage options (name, codec, filter, debounce, compactEvery).
- * @returns `KvStorageTier<T>` backed by IndexedDB.
- *
- * @example
- * ```ts
- * import { indexedDbKv } from "@graphrefly/graphrefly/extra/browser";
- *
- * const kv = indexedDbKv<{ score: number }>(
- *   { dbName: "my-app", storeName: "scores" },
- * );
- * await kv.save("player1", { score: 100 });
- * const val = await kv.load("player1");
- * ```
- *
- * @category extra
- */
-declare function indexedDbKv<T>(spec: IndexedDbBackendSpec, opts?: Omit<KvStorageOptions<T>, "name"> & {
-    name?: string;
-}): KvStorageTier<T>;
-
-export { type IndexedDbBackendSpec, indexedDbAppendLog, indexedDbBackend, indexedDbKv, indexedDbSnapshot };
+export * from '@graphrefly/pure-ts/extra/storage-tiers-browser';

package/dist/extra/storage-tiers-browser.js

@@ -1 +1,3 @@
-import{a,b,c,d}from"../chunk-F672GV32.js";import"../chunk-D5RFJOZ2.js";import"../chunk-CE72X3WO.js";import"../chunk-QYADASLV.js";export{c as indexedDbAppendLog,a as indexedDbBackend,d as indexedDbKv,b as indexedDbSnapshot};
+// src/extra/storage-tiers-browser.ts
+export * from "@graphrefly/pure-ts/extra/storage-tiers-browser";
+//# sourceMappingURL=storage-tiers-browser.js.map

package/dist/extra/storage-tiers-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-tiers-browser.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-tiers-browser\";\n"],"mappings":";AAEA,cAAc;","names":[]}

package/dist/extra/storage-tiers-node.cjs

@@ -1 +1,21 @@
-"use strict";var A=Object.defineProperty;var U=Object.getOwnPropertyDescriptor;var N=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var j=(n,e)=>{for(var t in e)A(n,t,{get:e[t],enumerable:!0})},_=(n,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let l of N(e))!F.call(n,l)&&l!==t&&A(n,l,{get:()=>e[l],enumerable:!(s=U(e,l))||s.enumerable});return n};var W=n=>_(A({},"__esModule",{value:!0}),n);var V={};j(V,{fileAppendLog:()=>J,fileBackend:()=>k,fileKv:()=>H,fileSnapshot:()=>I,sqliteAppendLog:()=>z,sqliteBackend:()=>w,sqliteKv:()=>Y,sqliteSnapshot:()=>q});module.exports=W(V);var C=require("node:crypto"),m=require("node:fs"),S=require("node:path"),R=require("node:sqlite");function E(n){if(n===null||typeof n!="object")return n;if(Array.isArray(n))return n.map(E);let e=n,t=Object.keys(e).sort(),s={};for(let l of t)s[l]=E(e[l]);return s}function M(n){return JSON.stringify(E(n),void 0,0)}var $=new TextEncoder,D=new TextDecoder("utf-8",{fatal:!0}),b={name:"json",version:1,encode(n){return $.encode(M(n))},decode(n){return JSON.parse(D.decode(n))}};function P(n,e={}){let t=e.codec??b,s=e.name??n.name??"snapshot",l=e.keyOf??(d=>d.name??e.name??n.name??"snapshot"),o,r=0,c=e.compactEvery,f,a={name:s,debounceMs:e.debounceMs,compactEvery:c,filter:e.filter,keyOf:l,save(d){if(!(e.filter&&!e.filter(d))&&(o={snapshot:d},r+=1,c!==void 0&&r%c===0||!e.debounceMs))return i()},load(){let d=f??s,u=n.read(d);if(u!==void 0)return u instanceof Uint8Array?u.length===0?void 0:t.decode(u):Promise.resolve(u).then(p=>p===void 0||p.length===0?void 0:t.decode(p))},async flush(){await i()},async rollback(){o=void 0}};function i(){let d=o;if(!d)return;o=void 0;let u=l(d.snapshot),p=t.encode(d.snapshot),g=n.write(u,p);if(g instanceof Promise)return g.then(()=>{f=u});f=u}return a}function x(n,e={}){let t=e.codec??b,s=e.name??n.name??"append-log",l=e.keyOf??(u=>s),o=e.compactEvery,r=new Map,c=0,f,a={name:s,debounceMs:e.debounceMs,compactEvery:o,keyOf:l,appendEntries(u){if(u.length!==0){for(let p of u){let g=l(p),y=r.get(g);y||(y=[],r.set(g,y)),y.push(p)}if(c+=u.length,o!==void 0&&c%o===0||!e.debounceMs)return i()}},async loadEntries(u){let p=u?.keyFilter,g=n.list===void 0?p!==void 0?[p]:[s]:await Promise.resolve(n.list(p)),y=[];for(let v of g){let h=await Promise.resolve(n.read(v));if(h===void 0||h.length===0)continue;let T=t.decode(h);Array.isArray(T)&&y.push(...T)}return{entries:y,cursor:void 0}},async flush(){await i()},async rollback(){r=new Map}};function i(){if(r.size===0)return;let u=r;r=new Map;let p=(f??Promise.resolve()).then(()=>{let g=d(u);return g instanceof Promise?g:Promise.resolve()},()=>{let g=d(u);return g instanceof Promise?g:Promise.resolve()});return f=p.finally(()=>{f===p&&(f=void 0)}),f}function d(u){let p=[];for(let[g,y]of u){let v=n.read(g),h=T=>{let B=[...T===void 0||T.length===0?[]:t.decode(T)??[],...y],K=t.encode(B);return n.write(g,K)};if(v instanceof Promise)p.push(v.then(async T=>{let O=h(T);O instanceof Promise&&await O}));else{let T=h(v);T instanceof Promise&&p.push(T)}}if(p.length>0)return Promise.all(p).then(()=>{})}return a}function L(n,e={}){let t=e.codec??b,s=e.name??n.name??"kv",l=e.compactEvery,o=new Map,r=0,c={name:s,debounceMs:e.debounceMs,compactEvery:l,filter:e.filter,save(a,i){if(!(e.filter&&!e.filter(a,i))&&(o.set(a,i),r+=1,l!==void 0&&r%l===0||!e.debounceMs))return f()},load(a){let i=n.read(a);if(i!==void 0)return i instanceof Uint8Array?i.length===0?void 0:t.decode(i):Promise.resolve(i).then(d=>d===void 0||d.length===0?void 0:t.decode(d))},delete(a){if(o.delete(a),!!n.delete)return n.delete(a)},list(a){return n.list?n.list(a):[]},async flush(){await f()},async rollback(){o=new Map}};function f(){if(o.size===0)return;let a=o;o=new Map;let i=[];for(let[d,u]of a){let p=t.encode(u),g=n.write(d,p);g instanceof Promise&&i.push(g)}if(i.length>0)return Promise.all(i).then(()=>{})}return c}function k(n){let e=new TextEncoder,t=new TextDecoder("utf-8",{fatal:!0}),s=o=>{let r="";for(let c of o){if(c.length===1&&/[a-zA-Z0-9_-]/.test(c)){r+=c;continue}for(let f of e.encode(c))r+=`%${f.toString(16).padStart(2,"0")}`}return(0,S.join)(n,`${r}.bin`)},l=o=>{if(!o.endsWith(".bin"))return null;let r=o.slice(0,-4),c=[],f=i=>{for(let d=0;d<i.length;d++)c.push(i.charCodeAt(d))},a=0;for(;a<r.length;){let i=r[a];if(i==="%"&&a+2<r.length){let d=r.slice(a+1,a+3);if(/^[0-9a-f]{2}$/i.test(d)){c.push(Number.parseInt(d,16)),a+=3;continue}}f(i),a+=1}try{return t.decode(new Uint8Array(c))}catch{return null}};return{name:`file:${n}`,read(o){try{let r=(0,m.readFileSync)(s(o));return new Uint8Array(r.buffer,r.byteOffset,r.byteLength)}catch{return}},write(o,r){(0,m.mkdirSync)(n,{recursive:!0});let c=s(o),f=(0,S.basename)(c),a=(0,S.dirname)(c),i=(0,S.join)(a,`.${f}.${(0,C.randomBytes)(8).toString("hex")}.tmp`);try{(0,m.writeFileSync)(i,r),(0,m.renameSync)(i,c)}catch(d){try{(0,m.unlinkSync)(i)}catch{}throw d}},delete(o){try{(0,m.unlinkSync)(s(o))}catch(r){if(r.code!=="ENOENT")throw r}},list(o){try{let r=(0,m.readdirSync)(n),c=[];for(let f of r){if(f.startsWith("."))continue;let a=l(f);a!==null&&(o!==void 0&&!a.startsWith(o)||c.push(a))}return c.sort()}catch(r){if(r.code==="ENOENT")return[];throw r}}}}function w(n){let e=new R.DatabaseSync(n);return e.exec("CREATE TABLE IF NOT EXISTS graphrefly_storage (k TEXT PRIMARY KEY, v BLOB NOT NULL)"),{name:`sqlite:${n}`,read(t){return e.prepare("SELECT v FROM graphrefly_storage WHERE k = ?").get(t)?.v},write(t,s){e.prepare("INSERT OR REPLACE INTO graphrefly_storage (k, v) VALUES (?, ?)").run(t,s)},delete(t){e.prepare("DELETE FROM graphrefly_storage WHERE k = ?").run(t)},list(t){if(t===void 0)return e.prepare("SELECT k FROM graphrefly_storage ORDER BY k").all().map(r=>r.k);let s=t.replace(/[\\%_]/g,"\\$&");return e.prepare("SELECT k FROM graphrefly_storage WHERE k LIKE ? ESCAPE '\\' ORDER BY k").all(`${s}%`).map(o=>o.k)},close(){try{e.close()}catch{}}}}function I(n,e){return P(k(n),e)}function J(n,e){return x(k(n),e)}function q(n,e){let t=w(n),s=P(t,e);return Object.assign(s,{close:()=>t.close()})}function z(n,e){let t=w(n),s=x(t,e);return Object.assign(s,{close:()=>t.close()})}function H(n,e){return L(k(n),e)}function Y(n,e){let t=w(n),s=L(t,e);return Object.assign(s,{close:()=>t.close()})}0&&(module.exports={fileAppendLog,fileBackend,fileKv,fileSnapshot,sqliteAppendLog,sqliteBackend,sqliteKv,sqliteSnapshot});
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/extra/storage-tiers-node.ts
+var storage_tiers_node_exports = {};
+module.exports = __toCommonJS(storage_tiers_node_exports);
+__reExport(storage_tiers_node_exports, require("@graphrefly/pure-ts/extra/storage-tiers-node"), module.exports);
+//# sourceMappingURL=storage-tiers-node.cjs.map

package/dist/extra/storage-tiers-node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/extra/storage-tiers-node.ts"],"sourcesContent":["// Phase 13.9.A shim — re-export from pure-TS sibling until\n// @graphrefly/native (napi binding) and per-milestone swap-overs land.\nexport * from \"@graphrefly/pure-ts/extra/storage-tiers-node\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,uCAAc,yDAFd;","names":[]}