@graphrefly/ts 0.0.0 → 0.0.1

package/dist/storage/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/storage/browser.ts"],"sourcesContent":["/**\n * Browser-only passive storage backend (D103).\n *\n * Uses DOM IndexedDB to provide async byte storage, no graph methods.\n */\n\n/// <reference lib=\"dom\" />\n\nimport { type AppendLogStorageTier, appendLogStorage } from \"./append-log.js\";\nimport type { StorageBackend } from \"./backend.js\";\nimport type { Codec } from \"./codec.js\";\nimport { type KvStorageOptions, type KvStorageTier, kvStorage } from \"./kv.js\";\n\nexport type IndexedDbBackendSpec = {\n\tdbName: string;\n\tstoreName: string;\n\tversion?: number;\n};\n\nexport interface NamedIndexedDbBackend extends StorageBackend {\n\treadonly name: string;\n}\n\ntype IndexedDbError = DOMException | Error;\n\nconst KEY_SEPARATOR = \"\\u0000\";\n\nfunction isConstraintError(error: unknown): error is DOMException {\n\treturn error instanceof DOMException && error.name === \"ConstraintError\";\n}\n\nfunction validateKey(key: string): string {\n\tif (typeof key !== \"string\") {\n\t\tthrow new TypeError(\"indexedDbBackend: key must be a string\");\n\t}\n\tif (key.includes(KEY_SEPARATOR)) {\n\t\tthrow new TypeError(\"indexedDbBackend: key must not contain U+0000\");\n\t}\n\treturn key;\n}\n\nfunction validateListPrefix(prefix: string): string {\n\tif (typeof prefix !== \"string\") {\n\t\tthrow new TypeError(\"indexedDbBackend: list prefix must be a string\");\n\t}\n\tif (prefix.includes(KEY_SEPARATOR)) {\n\t\tthrow new TypeError(\"indexedDbBackend: list prefix must not contain U+0000\");\n\t}\n\treturn prefix;\n}\n\nfunction decodeStoredBytes(raw: unknown): Uint8Array | undefined {\n\tif (raw === undefined || raw === null) return undefined;\n\tif (raw instanceof Uint8Array) return Uint8Array.from(raw);\n\tif (raw instanceof ArrayBuffer) return new Uint8Array(raw.slice(0));\n\tthrow new TypeError(\"indexedDbBackend: malformed stored bytes\");\n}\n\nfunction normalizeKeys(prefix: string, raw: unknown[]): string[] {\n\tconst out: string[] = [];\n\tfor (const key of raw) {\n\t\tif (typeof key !== \"string\") {\n\t\t\tthrow new TypeError(\"indexedDbBackend: stored key must be a string\");\n\t\t}\n\t\tif (key.includes(KEY_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"indexedDbBackend: malformed stored key\");\n\t\t}\n\t\tif (key.startsWith(prefix)) out.push(key);\n\t}\n\tout.sort();\n\treturn out;\n}\n\nfunction openDb(spec: IndexedDbBackendSpec, version = spec.version): Promise<IDBDatabase> {\n\treturn new Promise<IDBDatabase>((resolve, reject) => {\n\t\tif (typeof indexedDB === \"undefined\") {\n\t\t\treject(new TypeError(\"indexedDbBackend: indexedDB is not available in this environment\"));\n\t\t\treturn;\n\t\t}\n\t\tconst req =\n\t\t\tversion === undefined ? indexedDB.open(spec.dbName) : indexedDB.open(spec.dbName, version);\n\t\treq.onupgradeneeded = () => {\n\t\t\tconst db = req.result;\n\t\t\tif (!db.objectStoreNames.contains(spec.storeName)) {\n\t\t\t\tdb.createObjectStore(spec.storeName);\n\t\t\t}\n\t\t};\n\t\treq.onblocked = () =>\n\t\t\treject(\n\t\t\t\tnew Error(\"indexedDbBackend: open blocked; close existing database connections and retry\"),\n\t\t\t);\n\t\treq.onsuccess = () => resolve(req.result);\n\t\treq.onerror = () => reject(req.error ?? new TypeError(\"indexedDbBackend: open failed\"));\n\t});\n}\n\nfunction openDbWithStore(spec: IndexedDbBackendSpec): Promise<IDBDatabase> {\n\treturn openDb(spec).then((db) => {\n\t\tif (db.objectStoreNames.contains(spec.storeName)) return db;\n\t\tif (spec.version !== undefined) {\n\t\t\tdb.close();\n\t\t\tthrow new Error(\n\t\t\t\t`indexedDbBackend: object store \"${spec.storeName}\" is missing; bump the IndexedDB version to create it`,\n\t\t\t);\n\t\t}\n\t\tconst nextVersion = db.version + 1;\n\t\tdb.close();\n\t\treturn openDb(spec, nextVersion).then((upgraded) => {\n\t\t\tif (upgraded.objectStoreNames.contains(spec.storeName)) return upgraded;\n\t\t\tupgraded.close();\n\t\t\tthrow new Error(`indexedDbBackend: object store \"${spec.storeName}\" was not created`);\n\t\t});\n\t});\n}\n\nexport type IndexedDbKvOptions<T> = Omit<KvStorageOptions<T>, \"backend\">;\n\nexport interface IndexedDbAppendLogOptions<T> {\n\t/** Optional append-log key prefix. */\n\tprefix?: string;\n\t/** Optional payload codec before persistence. */\n\tcodec?: Codec<T>;\n}\n\n/**\n * Creates an IndexedDB backend for browser environments.\n *\n * All methods are async (`Promise`) and do not cross graph layer boundaries.\n */\nexport function indexedDbBackend(spec: IndexedDbBackendSpec): NamedIndexedDbBackend {\n\tlet dbCache: Promise<IDBDatabase> | undefined;\n\tconst db = (): Promise<IDBDatabase> => {\n\t\tif (dbCache !== undefined) return dbCache;\n\t\tconst attempt = openDbWithStore(spec);\n\t\tconst cached = attempt.catch((error) => {\n\t\t\tif (dbCache === cached) dbCache = undefined;\n\t\t\tthrow error;\n\t\t});\n\t\tdbCache = cached;\n\t\treturn dbCache;\n\t};\n\treturn {\n\t\tname: `idb:${spec.dbName}/${spec.storeName}`,\n\t\tget(key) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<Uint8Array | undefined>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readonly\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.get(key);\n\t\t\t\t\t\t\treq.onsuccess = () => {\n\t\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\t\tresolve(decodeStoredBytes(req.result));\n\t\t\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: read failed\"));\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: read transaction aborted\"));\n\t\t\t\t\t\t\ttx.oncomplete = () => {\n\t\t\t\t\t\t\t\t/* read resolved already; no-op */\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tput(key, value) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<void>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readwrite\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.put(value, key);\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: write failed\"));\n\t\t\t\t\t\t\ttx.oncomplete = () => resolve();\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: write transaction aborted\"));\n\t\t\t\t\t\t\ttx.onerror = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: write transaction failed\"));\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<boolean>((resolve, reject) => {\n\t\t\t\t\t\tlet requestOk = false;\n\t\t\t\t\t\tlet requestConflict = false;\n\t\t\t\t\t\tlet requestError: unknown;\n\t\t\t\t\t\tlet settled = false;\n\t\t\t\t\t\tconst settle = (fn: () => void): void => {\n\t\t\t\t\t\t\tif (settled) return;\n\t\t\t\t\t\t\tsettled = true;\n\t\t\t\t\t\t\tfn();\n\t\t\t\t\t\t};\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readwrite\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.add(value, key);\n\t\t\t\t\t\t\treq.onsuccess = () => {\n\t\t\t\t\t\t\t\trequestOk = true;\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\treq.onerror = (event) => {\n\t\t\t\t\t\t\t\tconst error = req.error;\n\t\t\t\t\t\t\t\tif (isConstraintError(error)) {\n\t\t\t\t\t\t\t\t\trequestConflict = true;\n\t\t\t\t\t\t\t\t\tevent.preventDefault();\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\trequestError = error ?? new Error(\"indexedDbBackend: write-if-absent failed\");\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\ttx.oncomplete = () =>\n\t\t\t\t\t\t\t\tsettle(() => {\n\t\t\t\t\t\t\t\t\tif (requestConflict) {\n\t\t\t\t\t\t\t\t\t\tresolve(false);\n\t\t\t\t\t\t\t\t\t} else if (requestOk) {\n\t\t\t\t\t\t\t\t\t\tresolve(true);\n\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\treject(\n\t\t\t\t\t\t\t\t\t\t\trequestError ??\n\t\t\t\t\t\t\t\t\t\t\t\tnew Error(\"indexedDbBackend: write-if-absent did not complete\"),\n\t\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\ttx.onabort = () => {\n\t\t\t\t\t\t\t\tconst error = tx.error;\n\t\t\t\t\t\t\t\tif (isConstraintError(error)) {\n\t\t\t\t\t\t\t\t\tsettle(() => resolve(false));\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tsettle(() =>\n\t\t\t\t\t\t\t\t\treject(\n\t\t\t\t\t\t\t\t\t\trequestError ??\n\t\t\t\t\t\t\t\t\t\t\ttx.error ??\n\t\t\t\t\t\t\t\t\t\t\tnew Error(\"indexedDbBackend: write-if-absent transaction aborted\"),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\ttx.onerror = () => {\n\t\t\t\t\t\t\t\tconst error = tx.error;\n\t\t\t\t\t\t\t\tif (isConstraintError(error)) {\n\t\t\t\t\t\t\t\t\tsettle(() => resolve(false));\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tsettle(() =>\n\t\t\t\t\t\t\t\t\treject(\n\t\t\t\t\t\t\t\t\t\trequestError ??\n\t\t\t\t\t\t\t\t\t\t\terror ??\n\t\t\t\t\t\t\t\t\t\t\tnew Error(\"indexedDbBackend: write-if-absent transaction failed\"),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tsettle(() => reject(error as IndexedDbError));\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tdelete(key) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<void>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readwrite\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.delete(key);\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: delete failed\"));\n\t\t\t\t\t\t\ttx.oncomplete = () => resolve();\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: delete transaction aborted\"));\n\t\t\t\t\t\t\ttx.onerror = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: delete transaction failed\"));\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(prefix);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<readonly string[]>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readonly\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.getAllKeys();\n\t\t\t\t\t\t\treq.onsuccess = () => {\n\t\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\t\tresolve(normalizeKeys(validatedPrefix, req.result));\n\t\t\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: list failed\"));\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: list transaction aborted\"));\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * Creates an IndexedDB-backed KV storage tier.\n */\nexport function indexedDbKv<T>(\n\tspec: IndexedDbBackendSpec,\n\topts: IndexedDbKvOptions<T> = {},\n): KvStorageTier<T> {\n\treturn kvStorage<T>({ backend: indexedDbBackend(spec), ...opts });\n}\n\n/**\n * Creates an IndexedDB-backed append-log storage tier.\n */\nexport function indexedDbAppendLog<T>(\n\tspec: IndexedDbBackendSpec,\n\topts: IndexedDbAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> {\n\tconst kv = kvStorage<T>({\n\t\tbackend: indexedDbBackend(spec),\n\t\tcodec: opts.codec,\n\t});\n\treturn appendLogStorage<T>({ kv, prefix: opts.prefix ?? \"append-log\" });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/storage/browser.ts"],"sourcesContent":["/**\n * Browser-only passive storage backend (D103).\n *\n * Uses DOM IndexedDB to provide async byte storage, no graph methods.\n */\n\n/// <reference lib=\"dom\" />\n\nimport { type AppendLogStorageTier, appendLogStorage } from \"./append-log.js\";\nimport type { StorageBackend } from \"./backend.js\";\nimport type { Codec } from \"./codec.js\";\nimport { type KvStorageOptions, type KvStorageTier, kvStorage } from \"./kv.js\";\n\nexport type IndexedDbBackendSpec = {\n\tdbName: string;\n\tstoreName: string;\n\tversion?: number;\n};\n\nexport interface NamedIndexedDbBackend extends StorageBackend {\n\treadonly name: string;\n}\n\ntype IndexedDbError = DOMException | Error;\n\nconst KEY_SEPARATOR = \"\\u0000\";\n\nfunction isConstraintError(error: unknown): error is DOMException {\n\treturn error instanceof DOMException && error.name === \"ConstraintError\";\n}\n\nfunction validateKey(key: string): string {\n\tif (typeof key !== \"string\") {\n\t\tthrow new TypeError(\"indexedDbBackend: key must be a string\");\n\t}\n\tif (key.includes(KEY_SEPARATOR)) {\n\t\tthrow new TypeError(\"indexedDbBackend: key must not contain U+0000\");\n\t}\n\treturn key;\n}\n\nfunction validateListPrefix(prefix: string): string {\n\tif (typeof prefix !== \"string\") {\n\t\tthrow new TypeError(\"indexedDbBackend: list prefix must be a string\");\n\t}\n\tif (prefix.includes(KEY_SEPARATOR)) {\n\t\tthrow new TypeError(\"indexedDbBackend: list prefix must not contain U+0000\");\n\t}\n\treturn prefix;\n}\n\nfunction decodeStoredBytes(raw: unknown): Uint8Array | undefined {\n\tif (raw === undefined || raw === null) return undefined;\n\tif (raw instanceof Uint8Array) return Uint8Array.from(raw);\n\tif (raw instanceof ArrayBuffer) return new Uint8Array(raw.slice(0));\n\tthrow new TypeError(\"indexedDbBackend: malformed stored bytes\");\n}\n\nfunction normalizeKeys(prefix: string, raw: unknown[]): string[] {\n\tconst out: string[] = [];\n\tfor (const key of raw) {\n\t\tif (typeof key !== \"string\") {\n\t\t\tthrow new TypeError(\"indexedDbBackend: stored key must be a string\");\n\t\t}\n\t\tif (key.includes(KEY_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"indexedDbBackend: malformed stored key\");\n\t\t}\n\t\tif (key.startsWith(prefix)) out.push(key);\n\t}\n\tout.sort();\n\treturn out;\n}\n\nfunction openDb(spec: IndexedDbBackendSpec, version = spec.version): Promise<IDBDatabase> {\n\treturn new Promise<IDBDatabase>((resolve, reject) => {\n\t\tif (typeof indexedDB === \"undefined\") {\n\t\t\treject(new TypeError(\"indexedDbBackend: indexedDB is not available in this environment\"));\n\t\t\treturn;\n\t\t}\n\t\tconst req =\n\t\t\tversion === undefined ? indexedDB.open(spec.dbName) : indexedDB.open(spec.dbName, version);\n\t\treq.onupgradeneeded = () => {\n\t\t\tconst db = req.result;\n\t\t\tif (!db.objectStoreNames.contains(spec.storeName)) {\n\t\t\t\tdb.createObjectStore(spec.storeName);\n\t\t\t}\n\t\t};\n\t\treq.onblocked = () =>\n\t\t\treject(\n\t\t\t\tnew Error(\"indexedDbBackend: open blocked; close existing database connections and retry\"),\n\t\t\t);\n\t\treq.onsuccess = () => resolve(req.result);\n\t\treq.onerror = () => reject(req.error ?? new TypeError(\"indexedDbBackend: open failed\"));\n\t});\n}\n\nfunction openDbWithStore(spec: IndexedDbBackendSpec): Promise<IDBDatabase> {\n\treturn openDb(spec).then((db) => {\n\t\tif (db.objectStoreNames.contains(spec.storeName)) return db;\n\t\tif (spec.version !== undefined) {\n\t\t\tdb.close();\n\t\t\tthrow new Error(\n\t\t\t\t`indexedDbBackend: object store \"${spec.storeName}\" is missing; bump the IndexedDB version to create it`,\n\t\t\t);\n\t\t}\n\t\tconst nextVersion = db.version + 1;\n\t\tdb.close();\n\t\treturn openDb(spec, nextVersion).then((upgraded) => {\n\t\t\tif (upgraded.objectStoreNames.contains(spec.storeName)) return upgraded;\n\t\t\tupgraded.close();\n\t\t\tthrow new Error(`indexedDbBackend: object store \"${spec.storeName}\" was not created`);\n\t\t});\n\t});\n}\n\nexport type IndexedDbKvOptions<T> = Omit<KvStorageOptions<T>, \"backend\">;\n\nexport interface IndexedDbAppendLogOptions<T> {\n\t/** Optional append-log key prefix. */\n\tprefix?: string;\n\t/** Optional payload codec before persistence. */\n\tcodec?: Codec<T>;\n}\n\n/**\n * Creates an IndexedDB backend for browser environments.\n *\n * All methods are async (`Promise`) and do not cross graph layer boundaries.\n */\nexport function indexedDbBackend(spec: IndexedDbBackendSpec): NamedIndexedDbBackend {\n\tlet dbCache: Promise<IDBDatabase> | undefined;\n\tconst db = (): Promise<IDBDatabase> => {\n\t\tif (dbCache !== undefined) return dbCache;\n\t\tconst attempt = openDbWithStore(spec);\n\t\tconst cached = attempt.catch((error) => {\n\t\t\tif (dbCache === cached) dbCache = undefined;\n\t\t\tthrow error;\n\t\t});\n\t\tdbCache = cached;\n\t\treturn dbCache;\n\t};\n\treturn {\n\t\tname: `idb:${spec.dbName}/${spec.storeName}`,\n\t\tget(key) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<Uint8Array | undefined>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readonly\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.get(key);\n\t\t\t\t\t\t\treq.onsuccess = () => {\n\t\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\t\tresolve(decodeStoredBytes(req.result));\n\t\t\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: read failed\"));\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: read transaction aborted\"));\n\t\t\t\t\t\t\ttx.oncomplete = () => {\n\t\t\t\t\t\t\t\t/* read resolved already; no-op */\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tput(key, value) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<void>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readwrite\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.put(value, key);\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: write failed\"));\n\t\t\t\t\t\t\ttx.oncomplete = () => resolve();\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: write transaction aborted\"));\n\t\t\t\t\t\t\ttx.onerror = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: write transaction failed\"));\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<boolean>((resolve, reject) => {\n\t\t\t\t\t\tlet requestOk = false;\n\t\t\t\t\t\tlet requestConflict = false;\n\t\t\t\t\t\tlet requestError: unknown;\n\t\t\t\t\t\tlet settled = false;\n\t\t\t\t\t\tconst settle = (fn: () => void): void => {\n\t\t\t\t\t\t\tif (settled) return;\n\t\t\t\t\t\t\tsettled = true;\n\t\t\t\t\t\t\tfn();\n\t\t\t\t\t\t};\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readwrite\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.add(value, key);\n\t\t\t\t\t\t\treq.onsuccess = () => {\n\t\t\t\t\t\t\t\trequestOk = true;\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\treq.onerror = (event) => {\n\t\t\t\t\t\t\t\tconst error = req.error;\n\t\t\t\t\t\t\t\tif (isConstraintError(error)) {\n\t\t\t\t\t\t\t\t\trequestConflict = true;\n\t\t\t\t\t\t\t\t\tevent.preventDefault();\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\trequestError = error ?? new Error(\"indexedDbBackend: write-if-absent failed\");\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\ttx.oncomplete = () =>\n\t\t\t\t\t\t\t\tsettle(() => {\n\t\t\t\t\t\t\t\t\tif (requestConflict) {\n\t\t\t\t\t\t\t\t\t\tresolve(false);\n\t\t\t\t\t\t\t\t\t} else if (requestOk) {\n\t\t\t\t\t\t\t\t\t\tresolve(true);\n\t\t\t\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t\t\t\treject(\n\t\t\t\t\t\t\t\t\t\t\trequestError ??\n\t\t\t\t\t\t\t\t\t\t\t\tnew Error(\"indexedDbBackend: write-if-absent did not complete\"),\n\t\t\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\ttx.onabort = () => {\n\t\t\t\t\t\t\t\tconst error = tx.error;\n\t\t\t\t\t\t\t\tif (isConstraintError(error)) {\n\t\t\t\t\t\t\t\t\tsettle(() => resolve(false));\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tsettle(() =>\n\t\t\t\t\t\t\t\t\treject(\n\t\t\t\t\t\t\t\t\t\trequestError ??\n\t\t\t\t\t\t\t\t\t\t\ttx.error ??\n\t\t\t\t\t\t\t\t\t\t\tnew Error(\"indexedDbBackend: write-if-absent transaction aborted\"),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\ttx.onerror = () => {\n\t\t\t\t\t\t\t\tconst error = tx.error;\n\t\t\t\t\t\t\t\tif (isConstraintError(error)) {\n\t\t\t\t\t\t\t\t\tsettle(() => resolve(false));\n\t\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tsettle(() =>\n\t\t\t\t\t\t\t\t\treject(\n\t\t\t\t\t\t\t\t\t\trequestError ??\n\t\t\t\t\t\t\t\t\t\t\terror ??\n\t\t\t\t\t\t\t\t\t\t\tnew Error(\"indexedDbBackend: write-if-absent transaction failed\"),\n\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tsettle(() => reject(error as IndexedDbError));\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tdelete(key) {\n\t\t\tvalidateKey(key);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<void>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readwrite\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.delete(key);\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: delete failed\"));\n\t\t\t\t\t\t\ttx.oncomplete = () => resolve();\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: delete transaction aborted\"));\n\t\t\t\t\t\t\ttx.onerror = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: delete transaction failed\"));\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(prefix);\n\t\t\treturn db().then(\n\t\t\t\t(database) =>\n\t\t\t\t\tnew Promise<readonly string[]>((resolve, reject) => {\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tconst tx = database.transaction(spec.storeName, \"readonly\");\n\t\t\t\t\t\t\tconst store = tx.objectStore(spec.storeName);\n\t\t\t\t\t\t\tconst req = store.getAllKeys();\n\t\t\t\t\t\t\treq.onsuccess = () => {\n\t\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\t\tresolve(normalizeKeys(validatedPrefix, req.result));\n\t\t\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\treq.onerror = () => reject(req.error ?? new Error(\"indexedDbBackend: list failed\"));\n\t\t\t\t\t\t\ttx.onabort = () =>\n\t\t\t\t\t\t\t\treject(tx.error ?? new Error(\"indexedDbBackend: list transaction aborted\"));\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\treject(error as IndexedDbError);\n\t\t\t\t\t\t}\n\t\t\t\t\t}),\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * Creates an IndexedDB-backed KV storage tier.\n */\nexport function indexedDbKv<T>(\n\tspec: IndexedDbBackendSpec,\n\topts: IndexedDbKvOptions<T> = {},\n): KvStorageTier<T> {\n\treturn kvStorage<T>({ backend: indexedDbBackend(spec), ...opts });\n}\n\n/**\n * Creates an IndexedDB-backed append-log storage tier.\n */\nexport function indexedDbAppendLog<T>(\n\tspec: IndexedDbBackendSpec,\n\topts: IndexedDbAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> {\n\tconst kv = kvStorage<T>({\n\t\tbackend: indexedDbBackend(spec),\n\t\tcodec: opts.codec,\n\t});\n\treturn appendLogStorage<T>({ kv, prefix: opts.prefix ?? \"append-log\" });\n}\n"],"mappings":";;;;;;;;;;AAyBA,IAAM,gBAAgB;AAEtB,SAAS,kBAAkB,OAAuC;AACjE,SAAO,iBAAiB,gBAAgB,MAAM,SAAS;AACxD;AAEA,SAAS,YAAY,KAAqB;AACzC,MAAI,OAAO,QAAQ,UAAU;AAC5B,UAAM,IAAI,UAAU,wCAAwC;AAAA,EAC7D;AACA,MAAI,IAAI,SAAS,aAAa,GAAG;AAChC,UAAM,IAAI,UAAU,+CAA+C;AAAA,EACpE;AACA,SAAO;AACR;AAEA,SAAS,mBAAmB,QAAwB;AACnD,MAAI,OAAO,WAAW,UAAU;AAC/B,UAAM,IAAI,UAAU,gDAAgD;AAAA,EACrE;AACA,MAAI,OAAO,SAAS,aAAa,GAAG;AACnC,UAAM,IAAI,UAAU,uDAAuD;AAAA,EAC5E;AACA,SAAO;AACR;AAEA,SAAS,kBAAkB,KAAsC;AAChE,MAAI,QAAQ,UAAa,QAAQ,KAAM,QAAO;AAC9C,MAAI,eAAe,WAAY,QAAO,WAAW,KAAK,GAAG;AACzD,MAAI,eAAe,YAAa,QAAO,IAAI,WAAW,IAAI,MAAM,CAAC,CAAC;AAClE,QAAM,IAAI,UAAU,0CAA0C;AAC/D;AAEA,SAAS,cAAc,QAAgB,KAA0B;AAChE,QAAM,MAAgB,CAAC;AACvB,aAAW,OAAO,KAAK;AACtB,QAAI,OAAO,QAAQ,UAAU;AAC5B,YAAM,IAAI,UAAU,+CAA+C;AAAA,IACpE;AACA,QAAI,IAAI,SAAS,aAAa,GAAG;AAChC,YAAM,IAAI,UAAU,wCAAwC;AAAA,IAC7D;AACA,QAAI,IAAI,WAAW,MAAM,EAAG,KAAI,KAAK,GAAG;AAAA,EACzC;AACA,MAAI,KAAK;AACT,SAAO;AACR;AAEA,SAAS,OAAO,MAA4B,UAAU,KAAK,SAA+B;AACzF,SAAO,IAAI,QAAqB,CAAC,SAAS,WAAW;AACpD,QAAI,OAAO,cAAc,aAAa;AACrC,aAAO,IAAI,UAAU,kEAAkE,CAAC;AACxF;AAAA,IACD;AACA,UAAM,MACL,YAAY,SAAY,UAAU,KAAK,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,QAAQ,OAAO;AAC1F,QAAI,kBAAkB,MAAM;AAC3B,YAAM,KAAK,IAAI;AACf,UAAI,CAAC,GAAG,iBAAiB,SAAS,KAAK,SAAS,GAAG;AAClD,WAAG,kBAAkB,KAAK,SAAS;AAAA,MACpC;AAAA,IACD;AACA,QAAI,YAAY,MACf;AAAA,MACC,IAAI,MAAM,+EAA+E;AAAA,IAC1F;AACD,QAAI,YAAY,MAAM,QAAQ,IAAI,MAAM;AACxC,QAAI,UAAU,MAAM,OAAO,IAAI,SAAS,IAAI,UAAU,+BAA+B,CAAC;AAAA,EACvF,CAAC;AACF;AAEA,SAAS,gBAAgB,MAAkD;AAC1E,SAAO,OAAO,IAAI,EAAE,KAAK,CAAC,OAAO;AAChC,QAAI,GAAG,iBAAiB,SAAS,KAAK,SAAS,EAAG,QAAO;AACzD,QAAI,KAAK,YAAY,QAAW;AAC/B,SAAG,MAAM;AACT,YAAM,IAAI;AAAA,QACT,mCAAmC,KAAK,SAAS;AAAA,MAClD;AAAA,IACD;AACA,UAAM,cAAc,GAAG,UAAU;AACjC,OAAG,MAAM;AACT,WAAO,OAAO,MAAM,WAAW,EAAE,KAAK,CAAC,aAAa;AACnD,UAAI,SAAS,iBAAiB,SAAS,KAAK,SAAS,EAAG,QAAO;AAC/D,eAAS,MAAM;AACf,YAAM,IAAI,MAAM,mCAAmC,KAAK,SAAS,mBAAmB;AAAA,IACrF,CAAC;AAAA,EACF,CAAC;AACF;AAgBO,SAAS,iBAAiB,MAAmD;AACnF,MAAI;AACJ,QAAM,KAAK,MAA4B;AACtC,QAAI,YAAY,OAAW,QAAO;AAClC,UAAM,UAAU,gBAAgB,IAAI;AACpC,UAAM,SAAS,QAAQ,MAAM,CAAC,UAAU;AACvC,UAAI,YAAY,OAAQ,WAAU;AAClC,YAAM;AAAA,IACP,CAAC;AACD,cAAU;AACV,WAAO;AAAA,EACR;AACA,SAAO;AAAA,IACN,MAAM,OAAO,KAAK,MAAM,IAAI,KAAK,SAAS;AAAA,IAC1C,IAAI,KAAK;AACR,kBAAY,GAAG;AACf,aAAO,GAAG,EAAE;AAAA,QACX,CAAC,aACA,IAAI,QAAgC,CAAC,SAAS,WAAW;AACxD,cAAI;AACH,kBAAM,KAAK,SAAS,YAAY,KAAK,WAAW,UAAU;AAC1D,kBAAM,QAAQ,GAAG,YAAY,KAAK,SAAS;AAC3C,kBAAM,MAAM,MAAM,IAAI,GAAG;AACzB,gBAAI,YAAY,MAAM;AACrB,kBAAI;AACH,wBAAQ,kBAAkB,IAAI,MAAM,CAAC;AAAA,cACtC,SAAS,OAAO;AACf,uBAAO,KAAuB;AAAA,cAC/B;AAAA,YACD;AACA,gBAAI,UAAU,MAAM,OAAO,IAAI,SAAS,IAAI,MAAM,+BAA+B,CAAC;AAClF,eAAG,UAAU,MACZ,OAAO,GAAG,SAAS,IAAI,MAAM,4CAA4C,CAAC;AAC3E,eAAG,aAAa,MAAM;AAAA,YAEtB;AAAA,UACD,SAAS,OAAO;AACf,mBAAO,KAAuB;AAAA,UAC/B;AAAA,QACD,CAAC;AAAA,MACH;AAAA,IACD;AAAA,IACA,IAAI,KAAK,OAAO;AACf,kBAAY,GAAG;AACf,aAAO,GAAG,EAAE;AAAA,QACX,CAAC,aACA,IAAI,QAAc,CAAC,SAAS,WAAW;AACtC,cAAI;AACH,kBAAM,KAAK,SAAS,YAAY,KAAK,WAAW,WAAW;AAC3D,kBAAM,QAAQ,GAAG,YAAY,KAAK,SAAS;AAC3C,kBAAM,MAAM,MAAM,IAAI,OAAO,GAAG;AAChC,gBAAI,UAAU,MAAM,OAAO,IAAI,SAAS,IAAI,MAAM,gCAAgC,CAAC;AACnF,eAAG,aAAa,MAAM,QAAQ;AAC9B,eAAG,UAAU,MACZ,OAAO,GAAG,SAAS,IAAI,MAAM,6CAA6C,CAAC;AAC5E,eAAG,UAAU,MACZ,OAAO,GAAG,SAAS,IAAI,MAAM,4CAA4C,CAAC;AAAA,UAC5E,SAAS,OAAO;AACf,mBAAO,KAAuB;AAAA,UAC/B;AAAA,QACD,CAAC;AAAA,MACH;AAAA,IACD;AAAA,IACA,YAAY,KAAK,OAAO;AACvB,kBAAY,GAAG;AACf,aAAO,GAAG,EAAE;AAAA,QACX,CAAC,aACA,IAAI,QAAiB,CAAC,SAAS,WAAW;AACzC,cAAI,YAAY;AAChB,cAAI,kBAAkB;AACtB,cAAI;AACJ,cAAI,UAAU;AACd,gBAAM,SAAS,CAAC,OAAyB;AACxC,gBAAI,QAAS;AACb,sBAAU;AACV,eAAG;AAAA,UACJ;AACA,cAAI;AACH,kBAAM,KAAK,SAAS,YAAY,KAAK,WAAW,WAAW;AAC3D,kBAAM,QAAQ,GAAG,YAAY,KAAK,SAAS;AAC3C,kBAAM,MAAM,MAAM,IAAI,OAAO,GAAG;AAChC,gBAAI,YAAY,MAAM;AACrB,0BAAY;AAAA,YACb;AACA,gBAAI,UAAU,CAAC,UAAU;AACxB,oBAAM,QAAQ,IAAI;AAClB,kBAAI,kBAAkB,KAAK,GAAG;AAC7B,kCAAkB;AAClB,sBAAM,eAAe;AACrB;AAAA,cACD;AACA,6BAAe,SAAS,IAAI,MAAM,0CAA0C;AAAA,YAC7E;AACA,eAAG,aAAa,MACf,OAAO,MAAM;AACZ,kBAAI,iBAAiB;AACpB,wBAAQ,KAAK;AAAA,cACd,WAAW,WAAW;AACrB,wBAAQ,IAAI;AAAA,cACb,OAAO;AACN;AAAA,kBACC,gBACC,IAAI,MAAM,oDAAoD;AAAA,gBAChE;AAAA,cACD;AAAA,YACD,CAAC;AACF,eAAG,UAAU,MAAM;AAClB,oBAAM,QAAQ,GAAG;AACjB,kBAAI,kBAAkB,KAAK,GAAG;AAC7B,uBAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B;AAAA,cACD;AACA;AAAA,gBAAO,MACN;AAAA,kBACC,gBACC,GAAG,SACH,IAAI,MAAM,uDAAuD;AAAA,gBACnE;AAAA,cACD;AAAA,YACD;AACA,eAAG,UAAU,MAAM;AAClB,oBAAM,QAAQ,GAAG;AACjB,kBAAI,kBAAkB,KAAK,GAAG;AAC7B,uBAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B;AAAA,cACD;AACA;AAAA,gBAAO,MACN;AAAA,kBACC,gBACC,SACA,IAAI,MAAM,sDAAsD;AAAA,gBAClE;AAAA,cACD;AAAA,YACD;AAAA,UACD,SAAS,OAAO;AACf,mBAAO,MAAM,OAAO,KAAuB,CAAC;AAAA,UAC7C;AAAA,QACD,CAAC;AAAA,MACH;AAAA,IACD;AAAA,IACA,OAAO,KAAK;AACX,kBAAY,GAAG;AACf,aAAO,GAAG,EAAE;AAAA,QACX,CAAC,aACA,IAAI,QAAc,CAAC,SAAS,WAAW;AACtC,cAAI;AACH,kBAAM,KAAK,SAAS,YAAY,KAAK,WAAW,WAAW;AAC3D,kBAAM,QAAQ,GAAG,YAAY,KAAK,SAAS;AAC3C,kBAAM,MAAM,MAAM,OAAO,GAAG;AAC5B,gBAAI,UAAU,MAAM,OAAO,IAAI,SAAS,IAAI,MAAM,iCAAiC,CAAC;AACpF,eAAG,aAAa,MAAM,QAAQ;AAC9B,eAAG,UAAU,MACZ,OAAO,GAAG,SAAS,IAAI,MAAM,8CAA8C,CAAC;AAC7E,eAAG,UAAU,MACZ,OAAO,GAAG,SAAS,IAAI,MAAM,6CAA6C,CAAC;AAAA,UAC7E,SAAS,OAAO;AACf,mBAAO,KAAuB;AAAA,UAC/B;AAAA,QACD,CAAC;AAAA,MACH;AAAA,IACD;AAAA,IACA,KAAK,SAAS,IAAI;AACjB,YAAM,kBAAkB,mBAAmB,MAAM;AACjD,aAAO,GAAG,EAAE;AAAA,QACX,CAAC,aACA,IAAI,QAA2B,CAAC,SAAS,WAAW;AACnD,cAAI;AACH,kBAAM,KAAK,SAAS,YAAY,KAAK,WAAW,UAAU;AAC1D,kBAAM,QAAQ,GAAG,YAAY,KAAK,SAAS;AAC3C,kBAAM,MAAM,MAAM,WAAW;AAC7B,gBAAI,YAAY,MAAM;AACrB,kBAAI;AACH,wBAAQ,cAAc,iBAAiB,IAAI,MAAM,CAAC;AAAA,cACnD,SAAS,OAAO;AACf,uBAAO,KAAuB;AAAA,cAC/B;AAAA,YACD;AACA,gBAAI,UAAU,MAAM,OAAO,IAAI,SAAS,IAAI,MAAM,+BAA+B,CAAC;AAClF,eAAG,UAAU,MACZ,OAAO,GAAG,SAAS,IAAI,MAAM,4CAA4C,CAAC;AAAA,UAC5E,SAAS,OAAO;AACf,mBAAO,KAAuB;AAAA,UAC/B;AAAA,QACD,CAAC;AAAA,MACH;AAAA,IACD;AAAA,EACD;AACD;AAKO,SAAS,YACf,MACA,OAA8B,CAAC,GACZ;AACnB,SAAO,UAAa,EAAE,SAAS,iBAAiB,IAAI,GAAG,GAAG,KAAK,CAAC;AACjE;AAKO,SAAS,mBACf,MACA,OAAqC,CAAC,GACZ;AAC1B,QAAM,KAAK,UAAa;AAAA,IACvB,SAAS,iBAAiB,IAAI;AAAA,IAC9B,OAAO,KAAK;AAAA,EACb,CAAC;AACD,SAAO,iBAAoB,EAAE,IAAI,QAAQ,KAAK,UAAU,aAAa,CAAC;AACvE;","names":[]}

package/dist/storage/index.d.cts

@@ -4,13 +4,13 @@ import { b as ChangeLifecycle, S as StorageTimestampNs, N as NonNegativeDecimalI
 export { C as ChangeEnvelope, a as ChangeEnvelopeOptions, D as DecimalIntegerString, O as ObserveEventFrame, c as ObserveEventLogPage, d as assertChangeEnvelope, e as assertDecimalIntegerString, f as assertNonNegativeDecimalIntegerString, g as assertObserveEventFrame, h as bigIntToDecimalString, i as bigIntToNonNegativeDecimalString, j as changeEnvelopeCodec, k as decimalStringToBigInt, l as envelopeChange, m as isDecimalIntegerString, n as isNonNegativeDecimalIntegerString, o as nonNegativeDecimalStringToBigInt, p as nowNs, q as observeEventFrame, r as observeEventFrameCodec, s as readObserveEventLogPage } from '../observe-event-log-0SVsx7JG.cjs';
 import { C as Codec } from '../codec-BB7p8fJc.cjs';
 export { S as StrictJsonObject, a as StrictJsonScalar, b as StrictJsonValue, c as assertStrictJsonObject, d as assertStrictJsonValue, j as jsonCodec, e as jsonCodecFor, s as stableJsonString, g as strictJsonCodec, h as strictJsonCodecFor } from '../codec-BB7p8fJc.cjs';
-export { b as LoadReactiveCollectionStateOptions, R as REACTIVE_COLLECTION_CHANGE_FORMAT, d as REACTIVE_COLLECTION_FRAME_VERSION, e as REACTIVE_COLLECTION_SNAPSHOT_FORMAT, f as ReactiveCollectionChangeFrame, g as ReactiveCollectionRestoreState, h as ReactiveCollectionSnapshotFrame, i as ReactiveCollectionStorageKind, o as ReactiveIndexRestoreState, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState, v as assertReactiveCollectionChangeFrame, w as assertReactiveCollectionSnapshotFrame, x as collectionSnapshotKey, y as loadReactiveIndexState, z as loadReactiveListState, A as loadReactiveLogState, B as loadReactiveMapState, D as reactiveCollectionChangeFrame, E as reactiveCollectionChangeFrameCodec, F as reactiveCollectionSnapshotFrame, G as reactiveCollectionSnapshotFrameCodec } from '../reactive-collection-BxBqtIOE.cjs';
+export { b as LoadReactiveCollectionStateOptions, R as REACTIVE_COLLECTION_CHANGE_FORMAT, d as REACTIVE_COLLECTION_FRAME_VERSION, e as REACTIVE_COLLECTION_SNAPSHOT_FORMAT, f as ReactiveCollectionChangeFrame, g as ReactiveCollectionRestoreState, h as ReactiveCollectionSnapshotFrame, i as ReactiveCollectionStorageKind, o as ReactiveIndexRestoreState, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState, v as assertReactiveCollectionChangeFrame, w as assertReactiveCollectionSnapshotFrame, x as collectionSnapshotKey, y as loadReactiveIndexState, z as loadReactiveListState, A as loadReactiveLogState, B as loadReactiveMapState, D as reactiveCollectionChangeFrame, E as reactiveCollectionChangeFrameCodec, F as reactiveCollectionSnapshotFrame, G as reactiveCollectionSnapshotFrameCodec } from '../reactive-collection-DNV0-gFi.cjs';
 export { R as ReadThroughErrorContext, a as ReadThroughLookupFact, b as ReadThroughLookupTier, c as ReadThroughMissContext, d as ReadThroughPromotionFact, T as TieredReadThroughOptions, e as TieredReadThroughResult, r as readThroughKv, t as tieredReadThrough } from '../read-through-B1CYPfq_.cjs';
-import '../types-bNMSWKqF.cjs';
-import '../messages-BZqrGGm1.cjs';
-import '../graph-s23RbbFO.cjs';
+import '../types-CcPIn7sy.cjs';
+import '../messages-CAzUPPJM.cjs';
+import '../graph-DCEWh4T2.cjs';
 import '../core/index.cjs';
-import '../describe-Ciu8SUnN.cjs';
+import '../describe-DYMw_l1C.cjs';
 
 /** Content-addressed KV access mode for D82 passive storage helpers. */
 type ContentAddressedMode = "read" | "write" | "read-write" | "read-strict";

package/dist/storage/index.d.ts

@@ -4,13 +4,13 @@ import { b as ChangeLifecycle, S as StorageTimestampNs, N as NonNegativeDecimalI
 export { C as ChangeEnvelope, a as ChangeEnvelopeOptions, D as DecimalIntegerString, O as ObserveEventFrame, c as ObserveEventLogPage, d as assertChangeEnvelope, e as assertDecimalIntegerString, f as assertNonNegativeDecimalIntegerString, g as assertObserveEventFrame, h as bigIntToDecimalString, i as bigIntToNonNegativeDecimalString, j as changeEnvelopeCodec, k as decimalStringToBigInt, l as envelopeChange, m as isDecimalIntegerString, n as isNonNegativeDecimalIntegerString, o as nonNegativeDecimalStringToBigInt, p as nowNs, q as observeEventFrame, r as observeEventFrameCodec, s as readObserveEventLogPage } from '../observe-event-log-Dnm76owp.js';
 import { C as Codec } from '../codec-BB7p8fJc.js';
 export { S as StrictJsonObject, a as StrictJsonScalar, b as StrictJsonValue, c as assertStrictJsonObject, d as assertStrictJsonValue, j as jsonCodec, e as jsonCodecFor, s as stableJsonString, g as strictJsonCodec, h as strictJsonCodecFor } from '../codec-BB7p8fJc.js';
-export { b as LoadReactiveCollectionStateOptions, R as REACTIVE_COLLECTION_CHANGE_FORMAT, d as REACTIVE_COLLECTION_FRAME_VERSION, e as REACTIVE_COLLECTION_SNAPSHOT_FORMAT, f as ReactiveCollectionChangeFrame, g as ReactiveCollectionRestoreState, h as ReactiveCollectionSnapshotFrame, i as ReactiveCollectionStorageKind, o as ReactiveIndexRestoreState, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState, v as assertReactiveCollectionChangeFrame, w as assertReactiveCollectionSnapshotFrame, x as collectionSnapshotKey, y as loadReactiveIndexState, z as loadReactiveListState, A as loadReactiveLogState, B as loadReactiveMapState, D as reactiveCollectionChangeFrame, E as reactiveCollectionChangeFrameCodec, F as reactiveCollectionSnapshotFrame, G as reactiveCollectionSnapshotFrameCodec } from '../reactive-collection-Cb1II1Fi.js';
+export { b as LoadReactiveCollectionStateOptions, R as REACTIVE_COLLECTION_CHANGE_FORMAT, d as REACTIVE_COLLECTION_FRAME_VERSION, e as REACTIVE_COLLECTION_SNAPSHOT_FORMAT, f as ReactiveCollectionChangeFrame, g as ReactiveCollectionRestoreState, h as ReactiveCollectionSnapshotFrame, i as ReactiveCollectionStorageKind, o as ReactiveIndexRestoreState, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState, v as assertReactiveCollectionChangeFrame, w as assertReactiveCollectionSnapshotFrame, x as collectionSnapshotKey, y as loadReactiveIndexState, z as loadReactiveListState, A as loadReactiveLogState, B as loadReactiveMapState, D as reactiveCollectionChangeFrame, E as reactiveCollectionChangeFrameCodec, F as reactiveCollectionSnapshotFrame, G as reactiveCollectionSnapshotFrameCodec } from '../reactive-collection-BAmfrGjd.js';
 export { R as ReadThroughErrorContext, a as ReadThroughLookupFact, b as ReadThroughLookupTier, c as ReadThroughMissContext, d as ReadThroughPromotionFact, T as TieredReadThroughOptions, e as TieredReadThroughResult, r as readThroughKv, t as tieredReadThrough } from '../read-through-DwyJhGs1.js';
-import '../types-h12mNYbq.js';
-import '../messages-BZqrGGm1.js';
-import '../graph-DfdF9zy4.js';
+import '../types-BsJvElYZ.js';
+import '../messages-CAzUPPJM.js';
+import '../graph-D-1-SQeC.js';
 import '../core/index.js';
-import '../describe-BZb7AS2y.js';
+import '../describe-BpyJuWkw.js';
 
 /** Content-addressed KV access mode for D82 passive storage helpers. */
 type ContentAddressedMode = "read" | "write" | "read-write" | "read-strict";

package/dist/storage/index.js

@@ -27,6 +27,10 @@ import {
   walFrameKey,
   walFramePrefix
 } from "../chunk-GTPCOEOZ.js";
+import {
+  readThroughKv,
+  tieredReadThrough
+} from "../chunk-Z2ANQ6JW.js";
 import {
   assertChangeEnvelope,
   assertDecimalIntegerString,
@@ -54,10 +58,6 @@ import {
   multiWriterAppendLogStorage,
   readAppendLogPage
 } from "../chunk-6PHB5CJS.js";
-import {
-  readThroughKv,
-  tieredReadThrough
-} from "../chunk-Z2ANQ6JW.js";
 import {
   dictKv,
   hasKvPutIfAbsent,
@@ -83,6 +83,7 @@ import {
   strictJsonCodec,
   strictJsonCodecFor
 } from "../chunk-4VLAQHZI.js";
+import "../chunk-DGUM43GV.js";
 export {
   APPEND_LOG_SEQ_PAD,
   ContentAddressedMissError,

package/dist/storage/node.js

@@ -5,6 +5,7 @@ import {
   kvStorage
 } from "../chunk-DKP56CSW.js";
 import "../chunk-4VLAQHZI.js";
+import "../chunk-DGUM43GV.js";
 
 // src/storage/node.ts
 import { randomBytes } from "crypto";

package/dist/storage/node.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/storage/node.ts"],"sourcesContent":["/**\n * Node-only passive storage backends (D103).\n *\n * Import from `@graphrefly/ts/storage/node`; the universal storage barrel stays browser-safe.\n */\n\nimport { randomBytes } from \"node:crypto\";\nimport {\n\tcloseSync,\n\tmkdirSync,\n\topenSync,\n\treaddirSync,\n\treadFileSync,\n\trenameSync,\n\tunlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { basename, dirname, join } from \"node:path\";\nimport { type AppendLogStorageTier, appendLogStorage } from \"./append-log.js\";\nimport type { StorageBackend, StorageGeneration, StorageNamespaceOptions } from \"./backend.js\";\nimport type { Codec } from \"./codec.js\";\nimport { type KvStorageTier, kvStorage } from \"./kv.js\";\n\nexport interface FileBackendOptions extends StorageNamespaceOptions {\n\t/** File suffix used for stored byte blobs. Defaults to `.bin`. */\n\textension?: string;\n}\n\nexport interface FileKvOptions<T> extends FileBackendOptions {\n\tcodec?: Codec<T>;\n}\n\nexport interface FileAppendLogOptions<T> extends FileKvOptions<T> {\n\t/** Append-log key prefix. Defaults to `event-log`. */\n\tprefix?: string;\n}\n\nexport interface SqliteBackendOptions extends StorageNamespaceOptions {\n\t/** Table name used for passive byte storage. Defaults to `graphrefly_storage`. */\n\ttableName?: string;\n}\n\nexport interface SqliteKvOptions<T> extends SqliteBackendOptions {\n\tcodec?: Codec<T>;\n}\n\nexport interface SqliteAppendLogOptions<T> extends SqliteKvOptions<T> {\n\t/** Append-log key prefix. Defaults to `event-log`. */\n\tprefix?: string;\n}\n\nexport interface ClosableStorageBackend extends StorageBackend {\n\treadonly name: string;\n\tclose(): void;\n}\n\ntype SqliteDatabaseConstructor = new (path: string) => SqliteDatabase;\n\ninterface SqliteDatabase {\n\texec(sql: string): void;\n\tprepare(sql: string): SqliteStatement;\n\tclose(): void;\n}\n\ninterface SqliteStatement {\n\tget(...params: unknown[]): unknown;\n\trun(...params: unknown[]): unknown;\n\tall(...params: unknown[]): unknown[];\n}\n\nconst FILE_STEM_PREFIX = \"k-\";\nconst NAMESPACE_SEPARATOR = \"\\u0000\";\nconst SQLITE_GENERATION = Symbol(\"graphrefly.sqliteBackend.generation\");\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder(\"utf-8\", { fatal: true });\nconst require = createRequire(\"/graphrefly-storage-node.js\");\n\ninterface SqliteGeneration {\n\treadonly [SQLITE_GENERATION]: readonly [\n\t\tstorageId: object,\n\t\tkey: string,\n\t\trowGeneration: number | null,\n\t\tepoch: number,\n\t];\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\t(error as { code?: unknown }).code === code\n\t);\n}\n\nfunction keyToStem(key: string): string {\n\tlet out = \"\";\n\tfor (const ch of key) {\n\t\tif (/^[a-zA-Z0-9_-]$/.test(ch)) {\n\t\t\tout += ch;\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const byte of encoder.encode(ch)) out += `%${byte.toString(16).padStart(2, \"0\")}`;\n\t}\n\treturn out;\n}\n\nfunction stemToKey(stem: string): string | null {\n\tconst bytes: number[] = [];\n\tlet i = 0;\n\twhile (i < stem.length) {\n\t\tconst ch = stem[i]!;\n\t\tif (ch === \"%\" && i + 2 < stem.length) {\n\t\t\tconst hex = stem.slice(i + 1, i + 3);\n\t\t\tif (/^[0-9a-f]{2}$/i.test(hex)) {\n\t\t\t\tbytes.push(Number.parseInt(hex, 16));\n\t\t\t\ti += 3;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tconst code = ch.charCodeAt(0);\n\t\tif (code > 0x7f) return null;\n\t\tbytes.push(code);\n\t\ti += 1;\n\t}\n\ttry {\n\t\treturn decoder.decode(new Uint8Array(bytes));\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction validateExtension(extension: string): string {\n\tif (\n\t\textension.length < 2 ||\n\t\t!extension.startsWith(\".\") ||\n\t\textension.includes(\"..\") ||\n\t\t/[/\\\\\\0]/.test(extension) ||\n\t\t!/^[.A-Za-z0-9_-]+$/.test(extension)\n\t) {\n\t\tthrow new TypeError(\"fileBackend: extension must be a simple suffix such as .bin\");\n\t}\n\treturn extension;\n}\n\nfunction validateNamespace(label: string, namespace: string): string {\n\tif (typeof namespace !== \"string\") {\n\t\tthrow new TypeError(`${label}: namespace must be a string`);\n\t}\n\tif (namespace.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: namespace must not contain U+0000`);\n\t}\n\treturn namespace;\n}\n\nfunction validateLogicalKey(label: string, key: string): string {\n\tif (typeof key !== \"string\") {\n\t\tthrow new TypeError(`${label}: key must be a string`);\n\t}\n\tif (key.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: key must not contain U+0000`);\n\t}\n\treturn key;\n}\n\nfunction validateListPrefix(label: string, prefix: string): string {\n\tif (typeof prefix !== \"string\") {\n\t\tthrow new TypeError(`${label}: list prefix must be a string`);\n\t}\n\tif (prefix.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: list prefix must not contain U+0000`);\n\t}\n\treturn prefix;\n}\n\nfunction validateSqliteTableName(tableName: string): string {\n\tif (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(tableName)) {\n\t\tthrow new TypeError(\"sqliteBackend: tableName must be a simple SQLite identifier\");\n\t}\n\treturn tableName;\n}\n\nfunction sqliteGeneration(\n\tstorageId: object,\n\tkey: string,\n\trowGeneration: number | null,\n\tepoch: number,\n): SqliteGeneration {\n\treturn Object.freeze({\n\t\t[SQLITE_GENERATION]: Object.freeze([storageId, key, rowGeneration, epoch] as const),\n\t});\n}\n\nfunction readSqliteGeneration(\n\tgeneration: StorageGeneration,\n):\n\t| readonly [storageId: object, key: string, rowGeneration: number | null, epoch: number]\n\t| undefined {\n\tif (typeof generation !== \"object\" || generation === null) return undefined;\n\tconst maybe = generation as Partial<SqliteGeneration>;\n\tconst token = maybe[SQLITE_GENERATION];\n\tif (\n\t\tArray.isArray(token) &&\n\t\ttoken.length === 4 &&\n\t\ttypeof token[0] === \"object\" &&\n\t\ttoken[0] !== null &&\n\t\ttypeof token[1] === \"string\" &&\n\t\t(token[2] === null || typeof token[2] === \"number\") &&\n\t\ttypeof token[3] === \"number\"\n\t) {\n\t\treturn token as readonly [object, string, number | null, number];\n\t}\n\treturn undefined;\n}\n\nfunction sqliteChanges(result: unknown): number {\n\treturn typeof result === \"object\" &&\n\t\tresult !== null &&\n\t\t\"changes\" in result &&\n\t\ttypeof (result as { changes?: unknown }).changes === \"number\"\n\t\t? (result as { changes: number }).changes\n\t\t: 0;\n}\n\nfunction sqliteBytes(value: Uint8Array | ArrayBuffer): Uint8Array {\n\treturn Uint8Array.from(value instanceof Uint8Array ? value : new Uint8Array(value));\n}\n\nfunction loadSqliteDatabaseSync(): SqliteDatabaseConstructor {\n\ttry {\n\t\tconst DatabaseSync = (require(\"node:sqlite\") as { DatabaseSync?: unknown }).DatabaseSync;\n\t\tif (typeof DatabaseSync !== \"function\") {\n\t\t\tthrow new TypeError(\"DatabaseSync export is missing\");\n\t\t}\n\t\treturn DatabaseSync as SqliteDatabaseConstructor;\n\t} catch (error) {\n\t\tthrow new Error(\"sqliteBackend: node:sqlite is not available in this Node runtime\", {\n\t\t\tcause: error,\n\t\t});\n\t}\n}\n\n/** Node filesystem byte backend with atomic replace writes and D85 conditional create. */\nexport function fileBackend(dir: string, opts: FileBackendOptions = {}): StorageBackend {\n\tconst extension = validateExtension(opts.extension ?? \".bin\");\n\tconst namespace =\n\t\topts.namespace === undefined ? \"\" : validateNamespace(\"fileBackend\", opts.namespace);\n\tconst namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : \"\";\n\tconst storageKey = (key: string) => `${namespacePrefix}${validateLogicalKey(\"fileBackend\", key)}`;\n\tconst pathFor = (key: string) =>\n\t\tjoin(dir, `${FILE_STEM_PREFIX}${keyToStem(storageKey(key))}${extension}`);\n\tconst keyFromFilename = (filename: string): string | null => {\n\t\tif (!filename.endsWith(extension)) return null;\n\t\tconst stem = filename.slice(0, -extension.length);\n\t\tif (!stem.startsWith(FILE_STEM_PREFIX)) return null;\n\t\tconst key = stemToKey(stem.slice(FILE_STEM_PREFIX.length));\n\t\tif (key === null || !key.startsWith(namespacePrefix)) return null;\n\t\tconst logical = key.slice(namespacePrefix.length);\n\t\tif (logical.includes(NAMESPACE_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"fileBackend: malformed stored key\");\n\t\t}\n\t\treturn logical;\n\t};\n\n\treturn {\n\t\tget(key) {\n\t\t\ttry {\n\t\t\t\treturn Uint8Array.from(readFileSync(pathFor(key)));\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"ENOENT\")) return undefined;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tput(key, value) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\tconst filePath = pathFor(key);\n\t\t\tconst base = basename(filePath);\n\t\t\tconst parent = dirname(filePath);\n\t\t\tconst tmp = join(parent, `.${base}.${randomBytes(8).toString(\"hex\")}.tmp`);\n\t\t\ttry {\n\t\t\t\twriteFileSync(tmp, value);\n\t\t\t\trenameSync(tmp, filePath);\n\t\t\t} catch (error) {\n\t\t\t\ttry {\n\t\t\t\t\tunlinkSync(tmp);\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore cleanup failures; the original write error is the useful one.\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\tconst filePath = pathFor(key);\n\t\t\tlet fd: number | undefined;\n\t\t\ttry {\n\t\t\t\tfd = openSync(filePath, \"wx\");\n\t\t\t\twriteFileSync(fd, value);\n\t\t\t\treturn true;\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"EEXIST\")) return false;\n\t\t\t\tif (fd !== undefined) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tunlinkSync(filePath);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Best effort cleanup of a partially-created file.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t} finally {\n\t\t\t\tif (fd !== undefined) closeSync(fd);\n\t\t\t}\n\t\t},\n\t\tdelete(key) {\n\t\t\ttry {\n\t\t\t\tunlinkSync(pathFor(key));\n\t\t\t} catch (error) {\n\t\t\t\tif (!isErrno(error, \"ENOENT\")) throw error;\n\t\t\t}\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(\"fileBackend\", prefix);\n\t\t\tlet entries: string[];\n\t\t\ttry {\n\t\t\t\tentries = readdirSync(dir);\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"ENOENT\")) return [];\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst keys: string[] = [];\n\t\t\tfor (const entry of entries) {\n\t\t\t\tif (entry.startsWith(\".\")) continue;\n\t\t\t\tconst key = keyFromFilename(entry);\n\t\t\t\tif (key?.startsWith(validatedPrefix)) keys.push(key);\n\t\t\t}\n\t\t\treturn keys.sort();\n\t\t},\n\t};\n}\n\n/**\n * Create a typed KV tier over a Node filesystem backend (D106 passive storage).\n */\nexport function fileKv<T>(dir: string, opts: FileKvOptions<T> = {}): KvStorageTier<T> {\n\treturn kvStorage<T>({\n\t\tbackend: fileBackend(dir, opts),\n\t\tcodec: opts.codec,\n\t});\n}\n\n/**\n * Create an append-log tier over a Node filesystem backend (D106 passive storage).\n */\nexport function fileAppendLog<T>(\n\tdir: string,\n\topts: FileAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> {\n\treturn appendLogStorage<T>({\n\t\tkv: fileKv<T>(dir, opts),\n\t\tprefix: opts.prefix ?? \"event-log\",\n\t});\n}\n\n/**\n * Optional Node SQLite byte backend (D106 passive storage).\n *\n * Uses `node:sqlite` when the current Node runtime provides it; otherwise throws a clear\n * runtime error at construction time. The caller owns `close()`.\n */\nexport function sqliteBackend(\n\tpath: string,\n\topts: SqliteBackendOptions = {},\n): ClosableStorageBackend {\n\tconst table = validateSqliteTableName(opts.tableName ?? \"graphrefly_storage\");\n\tconst metaTable = validateSqliteTableName(`${table}_meta`);\n\tconst namespace =\n\t\topts.namespace === undefined ? \"\" : validateNamespace(\"sqliteBackend\", opts.namespace);\n\tconst DatabaseSync = loadSqliteDatabaseSync();\n\tconst namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : \"\";\n\tconst storageKey = (key: string) =>\n\t\t`${namespacePrefix}${validateLogicalKey(\"sqliteBackend\", key)}`;\n\tconst storageId = Object.freeze({});\n\tconst logicalKey = (key: string): string | undefined => {\n\t\tif (typeof key !== \"string\") {\n\t\t\tthrow new TypeError(\"sqliteBackend: stored key is corrupt\");\n\t\t}\n\t\tif (!key.startsWith(namespacePrefix)) return undefined;\n\t\tconst logical = key.slice(namespacePrefix.length);\n\t\tif (logical.includes(NAMESPACE_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"sqliteBackend: malformed stored key\");\n\t\t}\n\t\treturn logical;\n\t};\n\tconst db = new DatabaseSync(path);\n\tdb.exec(\n\t\t`CREATE TABLE IF NOT EXISTS ${table} (k TEXT PRIMARY KEY, v BLOB NOT NULL, g INTEGER NOT NULL DEFAULT 0)`,\n\t);\n\tconst columns = db.prepare(`PRAGMA table_info(${table})`).all() as Array<{ name?: string }>;\n\tif (!columns.some((column) => column.name === \"g\")) {\n\t\tdb.exec(`ALTER TABLE ${table} ADD COLUMN g INTEGER NOT NULL DEFAULT 0`);\n\t}\n\tdb.exec(`CREATE TABLE IF NOT EXISTS ${metaTable} (k TEXT PRIMARY KEY, v INTEGER NOT NULL)`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_insert\n\t\tAFTER INSERT ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_update\n\t\tAFTER UPDATE ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_delete\n\t\tAFTER DELETE ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (OLD.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\n\tconst keyEpoch = (key: string): number => {\n\t\tconst row = db.prepare(`SELECT v FROM ${metaTable} WHERE k = ?`).get(key) as\n\t\t\t| { v?: number }\n\t\t\t| undefined;\n\t\tconst value = row?.v ?? 0;\n\t\tif (typeof value !== \"number\" || !Number.isSafeInteger(value) || value < 0) {\n\t\t\tthrow new Error(\"sqliteBackend: per-key generation epoch is corrupt\");\n\t\t}\n\t\treturn value;\n\t};\n\tconst readRow = (\n\t\tkey: string,\n\t):\n\t\t| {\n\t\t\t\treadonly value: Uint8Array;\n\t\t\t\treadonly generation: number;\n\t\t  }\n\t\t| undefined => {\n\t\tconst row = db.prepare(`SELECT v, g FROM ${table} WHERE k = ?`).get(storageKey(key)) as\n\t\t\t| { v?: Uint8Array | ArrayBuffer; g?: number }\n\t\t\t| undefined;\n\t\tif (row?.v === undefined) return undefined;\n\t\tconst generation = row.g;\n\t\tif (typeof generation !== \"number\" || !Number.isSafeInteger(generation) || generation < 0) {\n\t\t\tthrow new Error(\"sqliteBackend: row generation is corrupt\");\n\t\t}\n\t\treturn { value: sqliteBytes(row.v), generation };\n\t};\n\n\treturn {\n\t\tname: `sqlite:${path}/${table}`,\n\t\tget(key) {\n\t\t\treturn readRow(key)?.value;\n\t\t},\n\t\tput(key, value) {\n\t\t\tdb.prepare(\n\t\t\t\t`INSERT INTO ${table} (k, v, g) VALUES (?, ?, 0) ON CONFLICT(k) DO UPDATE SET v = excluded.v, g = ${table}.g + 1`,\n\t\t\t).run(storageKey(key), value);\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tconst result = db\n\t\t\t\t.prepare(`INSERT OR IGNORE INTO ${table} (k, v, g) VALUES (?, ?, 0)`)\n\t\t\t\t.run(storageKey(key), value) as { changes?: number };\n\t\t\treturn sqliteChanges(result) === 1;\n\t\t},\n\t\tgetVersioned(key) {\n\t\t\tconst row = readRow(key);\n\t\t\tif (row === undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tkind: \"miss\",\n\t\t\t\t\tgeneration: sqliteGeneration(storageId, storageKey(key), null, keyEpoch(storageKey(key))),\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tkind: \"hit\",\n\t\t\t\tvalue: row.value,\n\t\t\t\tgeneration: sqliteGeneration(\n\t\t\t\t\tstorageId,\n\t\t\t\t\tstorageKey(key),\n\t\t\t\t\trow.generation,\n\t\t\t\t\tkeyEpoch(storageKey(key)),\n\t\t\t\t),\n\t\t\t};\n\t\t},\n\t\tsetIfMatch(key, value, generation) {\n\t\t\tconst keyForStorage = storageKey(key);\n\t\t\tconst observed = readSqliteGeneration(generation);\n\t\t\tif (observed === undefined || observed[0] !== storageId || observed[1] !== keyForStorage) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tif (observed[2] === null) {\n\t\t\t\treturn (\n\t\t\t\t\tsqliteChanges(\n\t\t\t\t\t\tdb\n\t\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t\t`INSERT INTO ${table} (k, v, g) SELECT ?, ?, 0 WHERE COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ? AND NOT EXISTS (SELECT 1 FROM ${table} WHERE k = ?)`,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.run(keyForStorage, value, keyForStorage, observed[3], keyForStorage),\n\t\t\t\t\t) === 1\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn (\n\t\t\t\tsqliteChanges(\n\t\t\t\t\tdb\n\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t`UPDATE ${table} SET v = ?, g = g + 1 WHERE k = ? AND g = ? AND COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ?`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.run(value, keyForStorage, observed[2], keyForStorage, observed[3]),\n\t\t\t\t) === 1\n\t\t\t);\n\t\t},\n\t\tdelete(key) {\n\t\t\tdb.prepare(`DELETE FROM ${table} WHERE k = ?`).run(storageKey(key));\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(\"sqliteBackend\", prefix);\n\t\t\tconst rows = db.prepare(`SELECT k FROM ${table} ORDER BY k`).all() as { k: string }[];\n\t\t\tconst out: string[] = [];\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst key = logicalKey(row.k);\n\t\t\t\tif (key?.startsWith(validatedPrefix)) out.push(key);\n\t\t\t}\n\t\t\treturn out.sort();\n\t\t},\n\t\tclose() {\n\t\t\tdb.close();\n\t\t},\n\t};\n}\n\n/**\n * Create a typed KV tier over an optional Node SQLite backend.\n */\nexport function sqliteKv<T>(\n\tpath: string,\n\topts: SqliteKvOptions<T> = {},\n): KvStorageTier<T> & { close(): void } {\n\tconst backend = sqliteBackend(path, opts);\n\tconst tier = kvStorage<T>({\n\t\tbackend,\n\t\tcodec: opts.codec,\n\t});\n\treturn Object.assign(tier, { close: () => backend.close() });\n}\n\n/**\n * Create an append-log tier over an optional Node SQLite backend.\n */\nexport function sqliteAppendLog<T>(\n\tpath: string,\n\topts: SqliteAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> & { close(): void } {\n\tconst kv = sqliteKv<T>(path, opts);\n\tconst log = appendLogStorage<T>({ kv, prefix: opts.prefix ?? \"event-log\" });\n\treturn Object.assign(log, { close: () => kv.close() });\n}\n"],"mappings":"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","names":["require"]}
+{"version":3,"sources":["../../src/storage/node.ts"],"sourcesContent":["/**\n * Node-only passive storage backends (D103).\n *\n * Import from `@graphrefly/ts/storage/node`; the universal storage barrel stays browser-safe.\n */\n\nimport { randomBytes } from \"node:crypto\";\nimport {\n\tcloseSync,\n\tmkdirSync,\n\topenSync,\n\treaddirSync,\n\treadFileSync,\n\trenameSync,\n\tunlinkSync,\n\twriteFileSync,\n} from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { basename, dirname, join } from \"node:path\";\nimport { type AppendLogStorageTier, appendLogStorage } from \"./append-log.js\";\nimport type { StorageBackend, StorageGeneration, StorageNamespaceOptions } from \"./backend.js\";\nimport type { Codec } from \"./codec.js\";\nimport { type KvStorageTier, kvStorage } from \"./kv.js\";\n\nexport interface FileBackendOptions extends StorageNamespaceOptions {\n\t/** File suffix used for stored byte blobs. Defaults to `.bin`. */\n\textension?: string;\n}\n\nexport interface FileKvOptions<T> extends FileBackendOptions {\n\tcodec?: Codec<T>;\n}\n\nexport interface FileAppendLogOptions<T> extends FileKvOptions<T> {\n\t/** Append-log key prefix. Defaults to `event-log`. */\n\tprefix?: string;\n}\n\nexport interface SqliteBackendOptions extends StorageNamespaceOptions {\n\t/** Table name used for passive byte storage. Defaults to `graphrefly_storage`. */\n\ttableName?: string;\n}\n\nexport interface SqliteKvOptions<T> extends SqliteBackendOptions {\n\tcodec?: Codec<T>;\n}\n\nexport interface SqliteAppendLogOptions<T> extends SqliteKvOptions<T> {\n\t/** Append-log key prefix. Defaults to `event-log`. */\n\tprefix?: string;\n}\n\nexport interface ClosableStorageBackend extends StorageBackend {\n\treadonly name: string;\n\tclose(): void;\n}\n\ntype SqliteDatabaseConstructor = new (path: string) => SqliteDatabase;\n\ninterface SqliteDatabase {\n\texec(sql: string): void;\n\tprepare(sql: string): SqliteStatement;\n\tclose(): void;\n}\n\ninterface SqliteStatement {\n\tget(...params: unknown[]): unknown;\n\trun(...params: unknown[]): unknown;\n\tall(...params: unknown[]): unknown[];\n}\n\nconst FILE_STEM_PREFIX = \"k-\";\nconst NAMESPACE_SEPARATOR = \"\\u0000\";\nconst SQLITE_GENERATION = Symbol(\"graphrefly.sqliteBackend.generation\");\nconst encoder = new TextEncoder();\nconst decoder = new TextDecoder(\"utf-8\", { fatal: true });\nconst require = createRequire(\"/graphrefly-storage-node.js\");\n\ninterface SqliteGeneration {\n\treadonly [SQLITE_GENERATION]: readonly [\n\t\tstorageId: object,\n\t\tkey: string,\n\t\trowGeneration: number | null,\n\t\tepoch: number,\n\t];\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n\treturn (\n\t\ttypeof error === \"object\" &&\n\t\terror !== null &&\n\t\t\"code\" in error &&\n\t\t(error as { code?: unknown }).code === code\n\t);\n}\n\nfunction keyToStem(key: string): string {\n\tlet out = \"\";\n\tfor (const ch of key) {\n\t\tif (/^[a-zA-Z0-9_-]$/.test(ch)) {\n\t\t\tout += ch;\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const byte of encoder.encode(ch)) out += `%${byte.toString(16).padStart(2, \"0\")}`;\n\t}\n\treturn out;\n}\n\nfunction stemToKey(stem: string): string | null {\n\tconst bytes: number[] = [];\n\tlet i = 0;\n\twhile (i < stem.length) {\n\t\tconst ch = stem[i]!;\n\t\tif (ch === \"%\" && i + 2 < stem.length) {\n\t\t\tconst hex = stem.slice(i + 1, i + 3);\n\t\t\tif (/^[0-9a-f]{2}$/i.test(hex)) {\n\t\t\t\tbytes.push(Number.parseInt(hex, 16));\n\t\t\t\ti += 3;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\t\tconst code = ch.charCodeAt(0);\n\t\tif (code > 0x7f) return null;\n\t\tbytes.push(code);\n\t\ti += 1;\n\t}\n\ttry {\n\t\treturn decoder.decode(new Uint8Array(bytes));\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction validateExtension(extension: string): string {\n\tif (\n\t\textension.length < 2 ||\n\t\t!extension.startsWith(\".\") ||\n\t\textension.includes(\"..\") ||\n\t\t/[/\\\\\\0]/.test(extension) ||\n\t\t!/^[.A-Za-z0-9_-]+$/.test(extension)\n\t) {\n\t\tthrow new TypeError(\"fileBackend: extension must be a simple suffix such as .bin\");\n\t}\n\treturn extension;\n}\n\nfunction validateNamespace(label: string, namespace: string): string {\n\tif (typeof namespace !== \"string\") {\n\t\tthrow new TypeError(`${label}: namespace must be a string`);\n\t}\n\tif (namespace.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: namespace must not contain U+0000`);\n\t}\n\treturn namespace;\n}\n\nfunction validateLogicalKey(label: string, key: string): string {\n\tif (typeof key !== \"string\") {\n\t\tthrow new TypeError(`${label}: key must be a string`);\n\t}\n\tif (key.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: key must not contain U+0000`);\n\t}\n\treturn key;\n}\n\nfunction validateListPrefix(label: string, prefix: string): string {\n\tif (typeof prefix !== \"string\") {\n\t\tthrow new TypeError(`${label}: list prefix must be a string`);\n\t}\n\tif (prefix.includes(NAMESPACE_SEPARATOR)) {\n\t\tthrow new TypeError(`${label}: list prefix must not contain U+0000`);\n\t}\n\treturn prefix;\n}\n\nfunction validateSqliteTableName(tableName: string): string {\n\tif (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(tableName)) {\n\t\tthrow new TypeError(\"sqliteBackend: tableName must be a simple SQLite identifier\");\n\t}\n\treturn tableName;\n}\n\nfunction sqliteGeneration(\n\tstorageId: object,\n\tkey: string,\n\trowGeneration: number | null,\n\tepoch: number,\n): SqliteGeneration {\n\treturn Object.freeze({\n\t\t[SQLITE_GENERATION]: Object.freeze([storageId, key, rowGeneration, epoch] as const),\n\t});\n}\n\nfunction readSqliteGeneration(\n\tgeneration: StorageGeneration,\n):\n\t| readonly [storageId: object, key: string, rowGeneration: number | null, epoch: number]\n\t| undefined {\n\tif (typeof generation !== \"object\" || generation === null) return undefined;\n\tconst maybe = generation as Partial<SqliteGeneration>;\n\tconst token = maybe[SQLITE_GENERATION];\n\tif (\n\t\tArray.isArray(token) &&\n\t\ttoken.length === 4 &&\n\t\ttypeof token[0] === \"object\" &&\n\t\ttoken[0] !== null &&\n\t\ttypeof token[1] === \"string\" &&\n\t\t(token[2] === null || typeof token[2] === \"number\") &&\n\t\ttypeof token[3] === \"number\"\n\t) {\n\t\treturn token as readonly [object, string, number | null, number];\n\t}\n\treturn undefined;\n}\n\nfunction sqliteChanges(result: unknown): number {\n\treturn typeof result === \"object\" &&\n\t\tresult !== null &&\n\t\t\"changes\" in result &&\n\t\ttypeof (result as { changes?: unknown }).changes === \"number\"\n\t\t? (result as { changes: number }).changes\n\t\t: 0;\n}\n\nfunction sqliteBytes(value: Uint8Array | ArrayBuffer): Uint8Array {\n\treturn Uint8Array.from(value instanceof Uint8Array ? value : new Uint8Array(value));\n}\n\nfunction loadSqliteDatabaseSync(): SqliteDatabaseConstructor {\n\ttry {\n\t\tconst DatabaseSync = (require(\"node:sqlite\") as { DatabaseSync?: unknown }).DatabaseSync;\n\t\tif (typeof DatabaseSync !== \"function\") {\n\t\t\tthrow new TypeError(\"DatabaseSync export is missing\");\n\t\t}\n\t\treturn DatabaseSync as SqliteDatabaseConstructor;\n\t} catch (error) {\n\t\tthrow new Error(\"sqliteBackend: node:sqlite is not available in this Node runtime\", {\n\t\t\tcause: error,\n\t\t});\n\t}\n}\n\n/** Node filesystem byte backend with atomic replace writes and D85 conditional create. */\nexport function fileBackend(dir: string, opts: FileBackendOptions = {}): StorageBackend {\n\tconst extension = validateExtension(opts.extension ?? \".bin\");\n\tconst namespace =\n\t\topts.namespace === undefined ? \"\" : validateNamespace(\"fileBackend\", opts.namespace);\n\tconst namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : \"\";\n\tconst storageKey = (key: string) => `${namespacePrefix}${validateLogicalKey(\"fileBackend\", key)}`;\n\tconst pathFor = (key: string) =>\n\t\tjoin(dir, `${FILE_STEM_PREFIX}${keyToStem(storageKey(key))}${extension}`);\n\tconst keyFromFilename = (filename: string): string | null => {\n\t\tif (!filename.endsWith(extension)) return null;\n\t\tconst stem = filename.slice(0, -extension.length);\n\t\tif (!stem.startsWith(FILE_STEM_PREFIX)) return null;\n\t\tconst key = stemToKey(stem.slice(FILE_STEM_PREFIX.length));\n\t\tif (key === null || !key.startsWith(namespacePrefix)) return null;\n\t\tconst logical = key.slice(namespacePrefix.length);\n\t\tif (logical.includes(NAMESPACE_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"fileBackend: malformed stored key\");\n\t\t}\n\t\treturn logical;\n\t};\n\n\treturn {\n\t\tget(key) {\n\t\t\ttry {\n\t\t\t\treturn Uint8Array.from(readFileSync(pathFor(key)));\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"ENOENT\")) return undefined;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tput(key, value) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\tconst filePath = pathFor(key);\n\t\t\tconst base = basename(filePath);\n\t\t\tconst parent = dirname(filePath);\n\t\t\tconst tmp = join(parent, `.${base}.${randomBytes(8).toString(\"hex\")}.tmp`);\n\t\t\ttry {\n\t\t\t\twriteFileSync(tmp, value);\n\t\t\t\trenameSync(tmp, filePath);\n\t\t\t} catch (error) {\n\t\t\t\ttry {\n\t\t\t\t\tunlinkSync(tmp);\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore cleanup failures; the original write error is the useful one.\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tmkdirSync(dir, { recursive: true });\n\t\t\tconst filePath = pathFor(key);\n\t\t\tlet fd: number | undefined;\n\t\t\ttry {\n\t\t\t\tfd = openSync(filePath, \"wx\");\n\t\t\t\twriteFileSync(fd, value);\n\t\t\t\treturn true;\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"EEXIST\")) return false;\n\t\t\t\tif (fd !== undefined) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tunlinkSync(filePath);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Best effort cleanup of a partially-created file.\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t} finally {\n\t\t\t\tif (fd !== undefined) closeSync(fd);\n\t\t\t}\n\t\t},\n\t\tdelete(key) {\n\t\t\ttry {\n\t\t\t\tunlinkSync(pathFor(key));\n\t\t\t} catch (error) {\n\t\t\t\tif (!isErrno(error, \"ENOENT\")) throw error;\n\t\t\t}\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(\"fileBackend\", prefix);\n\t\t\tlet entries: string[];\n\t\t\ttry {\n\t\t\t\tentries = readdirSync(dir);\n\t\t\t} catch (error) {\n\t\t\t\tif (isErrno(error, \"ENOENT\")) return [];\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst keys: string[] = [];\n\t\t\tfor (const entry of entries) {\n\t\t\t\tif (entry.startsWith(\".\")) continue;\n\t\t\t\tconst key = keyFromFilename(entry);\n\t\t\t\tif (key?.startsWith(validatedPrefix)) keys.push(key);\n\t\t\t}\n\t\t\treturn keys.sort();\n\t\t},\n\t};\n}\n\n/**\n * Create a typed KV tier over a Node filesystem backend (D106 passive storage).\n */\nexport function fileKv<T>(dir: string, opts: FileKvOptions<T> = {}): KvStorageTier<T> {\n\treturn kvStorage<T>({\n\t\tbackend: fileBackend(dir, opts),\n\t\tcodec: opts.codec,\n\t});\n}\n\n/**\n * Create an append-log tier over a Node filesystem backend (D106 passive storage).\n */\nexport function fileAppendLog<T>(\n\tdir: string,\n\topts: FileAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> {\n\treturn appendLogStorage<T>({\n\t\tkv: fileKv<T>(dir, opts),\n\t\tprefix: opts.prefix ?? \"event-log\",\n\t});\n}\n\n/**\n * Optional Node SQLite byte backend (D106 passive storage).\n *\n * Uses `node:sqlite` when the current Node runtime provides it; otherwise throws a clear\n * runtime error at construction time. The caller owns `close()`.\n */\nexport function sqliteBackend(\n\tpath: string,\n\topts: SqliteBackendOptions = {},\n): ClosableStorageBackend {\n\tconst table = validateSqliteTableName(opts.tableName ?? \"graphrefly_storage\");\n\tconst metaTable = validateSqliteTableName(`${table}_meta`);\n\tconst namespace =\n\t\topts.namespace === undefined ? \"\" : validateNamespace(\"sqliteBackend\", opts.namespace);\n\tconst DatabaseSync = loadSqliteDatabaseSync();\n\tconst namespacePrefix = namespace.length > 0 ? `${namespace}${NAMESPACE_SEPARATOR}` : \"\";\n\tconst storageKey = (key: string) =>\n\t\t`${namespacePrefix}${validateLogicalKey(\"sqliteBackend\", key)}`;\n\tconst storageId = Object.freeze({});\n\tconst logicalKey = (key: string): string | undefined => {\n\t\tif (typeof key !== \"string\") {\n\t\t\tthrow new TypeError(\"sqliteBackend: stored key is corrupt\");\n\t\t}\n\t\tif (!key.startsWith(namespacePrefix)) return undefined;\n\t\tconst logical = key.slice(namespacePrefix.length);\n\t\tif (logical.includes(NAMESPACE_SEPARATOR)) {\n\t\t\tthrow new TypeError(\"sqliteBackend: malformed stored key\");\n\t\t}\n\t\treturn logical;\n\t};\n\tconst db = new DatabaseSync(path);\n\tdb.exec(\n\t\t`CREATE TABLE IF NOT EXISTS ${table} (k TEXT PRIMARY KEY, v BLOB NOT NULL, g INTEGER NOT NULL DEFAULT 0)`,\n\t);\n\tconst columns = db.prepare(`PRAGMA table_info(${table})`).all() as Array<{ name?: string }>;\n\tif (!columns.some((column) => column.name === \"g\")) {\n\t\tdb.exec(`ALTER TABLE ${table} ADD COLUMN g INTEGER NOT NULL DEFAULT 0`);\n\t}\n\tdb.exec(`CREATE TABLE IF NOT EXISTS ${metaTable} (k TEXT PRIMARY KEY, v INTEGER NOT NULL)`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_insert\n\t\tAFTER INSERT ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_update\n\t\tAFTER UPDATE ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (NEW.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\tdb.exec(`\n\t\tCREATE TRIGGER IF NOT EXISTS ${table}_generation_delete\n\t\tAFTER DELETE ON ${table}\n\t\tBEGIN\n\t\t\tINSERT INTO ${metaTable} (k, v) VALUES (OLD.k, 1)\n\t\t\tON CONFLICT(k) DO UPDATE SET v = ${metaTable}.v + 1;\n\t\tEND\n\t`);\n\n\tconst keyEpoch = (key: string): number => {\n\t\tconst row = db.prepare(`SELECT v FROM ${metaTable} WHERE k = ?`).get(key) as\n\t\t\t| { v?: number }\n\t\t\t| undefined;\n\t\tconst value = row?.v ?? 0;\n\t\tif (typeof value !== \"number\" || !Number.isSafeInteger(value) || value < 0) {\n\t\t\tthrow new Error(\"sqliteBackend: per-key generation epoch is corrupt\");\n\t\t}\n\t\treturn value;\n\t};\n\tconst readRow = (\n\t\tkey: string,\n\t):\n\t\t| {\n\t\t\t\treadonly value: Uint8Array;\n\t\t\t\treadonly generation: number;\n\t\t  }\n\t\t| undefined => {\n\t\tconst row = db.prepare(`SELECT v, g FROM ${table} WHERE k = ?`).get(storageKey(key)) as\n\t\t\t| { v?: Uint8Array | ArrayBuffer; g?: number }\n\t\t\t| undefined;\n\t\tif (row?.v === undefined) return undefined;\n\t\tconst generation = row.g;\n\t\tif (typeof generation !== \"number\" || !Number.isSafeInteger(generation) || generation < 0) {\n\t\t\tthrow new Error(\"sqliteBackend: row generation is corrupt\");\n\t\t}\n\t\treturn { value: sqliteBytes(row.v), generation };\n\t};\n\n\treturn {\n\t\tname: `sqlite:${path}/${table}`,\n\t\tget(key) {\n\t\t\treturn readRow(key)?.value;\n\t\t},\n\t\tput(key, value) {\n\t\t\tdb.prepare(\n\t\t\t\t`INSERT INTO ${table} (k, v, g) VALUES (?, ?, 0) ON CONFLICT(k) DO UPDATE SET v = excluded.v, g = ${table}.g + 1`,\n\t\t\t).run(storageKey(key), value);\n\t\t},\n\t\tputIfAbsent(key, value) {\n\t\t\tconst result = db\n\t\t\t\t.prepare(`INSERT OR IGNORE INTO ${table} (k, v, g) VALUES (?, ?, 0)`)\n\t\t\t\t.run(storageKey(key), value) as { changes?: number };\n\t\t\treturn sqliteChanges(result) === 1;\n\t\t},\n\t\tgetVersioned(key) {\n\t\t\tconst row = readRow(key);\n\t\t\tif (row === undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tkind: \"miss\",\n\t\t\t\t\tgeneration: sqliteGeneration(storageId, storageKey(key), null, keyEpoch(storageKey(key))),\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tkind: \"hit\",\n\t\t\t\tvalue: row.value,\n\t\t\t\tgeneration: sqliteGeneration(\n\t\t\t\t\tstorageId,\n\t\t\t\t\tstorageKey(key),\n\t\t\t\t\trow.generation,\n\t\t\t\t\tkeyEpoch(storageKey(key)),\n\t\t\t\t),\n\t\t\t};\n\t\t},\n\t\tsetIfMatch(key, value, generation) {\n\t\t\tconst keyForStorage = storageKey(key);\n\t\t\tconst observed = readSqliteGeneration(generation);\n\t\t\tif (observed === undefined || observed[0] !== storageId || observed[1] !== keyForStorage) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tif (observed[2] === null) {\n\t\t\t\treturn (\n\t\t\t\t\tsqliteChanges(\n\t\t\t\t\t\tdb\n\t\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t\t`INSERT INTO ${table} (k, v, g) SELECT ?, ?, 0 WHERE COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ? AND NOT EXISTS (SELECT 1 FROM ${table} WHERE k = ?)`,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t.run(keyForStorage, value, keyForStorage, observed[3], keyForStorage),\n\t\t\t\t\t) === 1\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn (\n\t\t\t\tsqliteChanges(\n\t\t\t\t\tdb\n\t\t\t\t\t\t.prepare(\n\t\t\t\t\t\t\t`UPDATE ${table} SET v = ?, g = g + 1 WHERE k = ? AND g = ? AND COALESCE((SELECT v FROM ${metaTable} WHERE k = ?), 0) = ?`,\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.run(value, keyForStorage, observed[2], keyForStorage, observed[3]),\n\t\t\t\t) === 1\n\t\t\t);\n\t\t},\n\t\tdelete(key) {\n\t\t\tdb.prepare(`DELETE FROM ${table} WHERE k = ?`).run(storageKey(key));\n\t\t},\n\t\tlist(prefix = \"\") {\n\t\t\tconst validatedPrefix = validateListPrefix(\"sqliteBackend\", prefix);\n\t\t\tconst rows = db.prepare(`SELECT k FROM ${table} ORDER BY k`).all() as { k: string }[];\n\t\t\tconst out: string[] = [];\n\t\t\tfor (const row of rows) {\n\t\t\t\tconst key = logicalKey(row.k);\n\t\t\t\tif (key?.startsWith(validatedPrefix)) out.push(key);\n\t\t\t}\n\t\t\treturn out.sort();\n\t\t},\n\t\tclose() {\n\t\t\tdb.close();\n\t\t},\n\t};\n}\n\n/**\n * Create a typed KV tier over an optional Node SQLite backend.\n */\nexport function sqliteKv<T>(\n\tpath: string,\n\topts: SqliteKvOptions<T> = {},\n): KvStorageTier<T> & { close(): void } {\n\tconst backend = sqliteBackend(path, opts);\n\tconst tier = kvStorage<T>({\n\t\tbackend,\n\t\tcodec: opts.codec,\n\t});\n\treturn Object.assign(tier, { close: () => backend.close() });\n}\n\n/**\n * Create an append-log tier over an optional Node SQLite backend.\n */\nexport function sqliteAppendLog<T>(\n\tpath: string,\n\topts: SqliteAppendLogOptions<T> = {},\n): AppendLogStorageTier<T> & { close(): void } {\n\tconst kv = sqliteKv<T>(path, opts);\n\tconst log = appendLogStorage<T>({ kv, prefix: opts.prefix ?? \"event-log\" });\n\treturn Object.assign(log, { close: () => kv.close() });\n}\n"],"mappings":"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","names":["require"]}

package/dist/store-C-joM4gh.d.ts

@@ -0,0 +1,123 @@
+import { N as Node } from './types-BsJvElYZ.js';
+
+/**
+ * Framework-neutral store adapters.
+ *
+ * Focused framework bindings build on this tiny Node-facing layer without
+ * importing framework packages into the dependency-free adapters barrel
+ * (D125/D238).
+ */
+
+/** A minimal readable store contract shared by Svelte/Nanostores-style adapters. */
+interface ReadableStore<T> {
+    get(): T | undefined;
+    subscribe(run: (value: T | undefined) => void): () => void;
+}
+/** A minimal writable store contract over a clean-slate writable node. */
+interface WritableStore<T> extends ReadableStore<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+/** React `useSyncExternalStore`-compatible shape, without importing React. */
+interface ExternalStore<T> {
+    getSnapshot(): T | undefined;
+    getServerSnapshot(): T | undefined;
+    subscribe(onStoreChange: () => void): () => void;
+}
+/** Object-of-nodes factory used by record subscription adapters. */
+type NodeRecordFactory<K extends string, R extends Record<string, unknown>> = (key: K) => {
+    [P in keyof R]: Node<R[P]>;
+};
+/** Zustand-compatible store API over a caller-owned clean-slate state node. */
+interface ZustandStoreApi<T extends object> {
+    getState(): T;
+    setState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean): void;
+    getInitialState(): T;
+    subscribe(listener: (state: T, prevState: T) => void): () => void;
+    destroy(): void;
+}
+/** Jotai-style atom facade over a caller-owned node. */
+interface JotaiAtom<T> {
+    get(): T | undefined;
+    subscribe(callback: (value: T | undefined) => void): () => void;
+    readonly _node: Node<T>;
+}
+/** Writable Jotai-style atom facade over a caller-owned writable node. */
+interface WritableJotaiAtom<T> extends JotaiAtom<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+/** Nanostores-style atom facade over a caller-owned node. */
+interface NanoAtom<T> {
+    get(): T | undefined;
+    subscribe(callback: (value: T | undefined) => void): () => void;
+    listen(callback: (value: T | undefined) => void): () => void;
+    readonly _node: Node<T>;
+}
+/** Writable Nanostores-style atom facade over a caller-owned writable node. */
+interface WritableNanoAtom<T> extends NanoAtom<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+/** TC39-Signals-style facade over a caller-owned node. */
+interface SignalLike<T> {
+    get(): T | undefined;
+    subscribe(callback: (value: T | undefined) => void): () => void;
+    readonly _node: Node<T>;
+}
+/** Writable TC39-Signals-style facade over a caller-owned writable node. */
+interface WritableSignalLike<T> extends SignalLike<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+interface SubscribeValuesOptions<T> {
+    /** Emit the current cache snapshot immediately. `undefined` means SENTINEL/no DATA. */
+    immediate?: boolean;
+    /** Suppress synchronous push-on-subscribe/replay DATA. Useful for change-only store listeners. */
+    changesOnly?: boolean;
+    onError?: (error: unknown) => void;
+    onComplete?: () => void;
+    /** Custom cache reader for wrappers that keep their own snapshot object. */
+    getSnapshot?: () => T | undefined;
+}
+interface WritableNode<T> extends Node<T> {
+    set(value: T): void;
+}
+interface WritableStoreOptions<T> extends SubscribeValuesOptions<T> {
+    /** Override writes for adapters that need a framework-owned reducer. */
+    write?: (node: WritableNode<T>, value: T) => void;
+}
+/** Read a node cache without activating it. */
+declare function nodeSnapshot<T>(node: Node<T>): T | undefined;
+/**
+ * Subscribe to DATA values from a Node. Protocol internals stay below the adapter boundary:
+ * DATA drives value listeners, ERROR/COMPLETE route to optional lifecycle callbacks.
+ */
+declare function subscribeNodeValues<T>(node: Node<T>, run: (value: T | undefined) => void, opts?: SubscribeValuesOptions<T>): () => void;
+/** Build a Svelte/Nanostores-style readable store from a clean-slate Node. */
+declare function readableStore<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): ReadableStore<T>;
+/** Build a writable store over a StateNode or compatible clean-slate writable Node. */
+declare function writableStore<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableStore<T>;
+declare function writableStore<T>(node: Node<T>, opts: WritableStoreOptions<T> & {
+    write: (node: WritableNode<T>, value: T) => void;
+}): WritableStore<T>;
+/** Build the tiny shape React's `useSyncExternalStore` expects, without importing React. */
+declare function externalStore<T>(node: Node<T>, opts?: Pick<SubscribeValuesOptions<T>, "getSnapshot" | "onError" | "onComplete">): ExternalStore<T>;
+/** Build a framework-neutral keyed record store for focused framework record bindings. */
+declare function recordReadableStore<K extends string, R extends Record<string, unknown>>(keysNode: Node<readonly K[]>, factory: NodeRecordFactory<K, R>, opts?: SubscribeValuesOptions<Record<K, R>>): ReadableStore<Record<K, R>>;
+/** Build a Zustand-compatible StoreApi over a caller-owned clean-slate state node. */
+declare function zustandStore<T extends object>(node: WritableNode<T>, initialState?: T, opts?: WritableStoreOptions<T>): ZustandStoreApi<T>;
+declare function zustandStore<T extends object>(node: Node<T>, initialState: T | undefined, opts: WritableStoreOptions<T> & {
+    write: (node: WritableNode<T>, value: T) => void;
+}): ZustandStoreApi<T>;
+/** Build a Jotai-style atom facade over a caller-owned node. */
+declare function jotaiAtom<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableJotaiAtom<T>;
+declare function jotaiAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): JotaiAtom<T>;
+/** Build a Nanostores-style atom facade over a caller-owned node. */
+declare function nanoAtom<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableNanoAtom<T>;
+declare function nanoAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): NanoAtom<T>;
+/** Build a TC39-Signals-style facade over a caller-owned node. */
+declare function signalFromNode<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableSignalLike<T>;
+declare function signalFromNode<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): SignalLike<T>;
+
+export { type ExternalStore as E, type JotaiAtom as J, type NanoAtom as N, type ReadableStore as R, type SignalLike as S, type WritableNode as W, type ZustandStoreApi as Z, type NodeRecordFactory as a, type SubscribeValuesOptions as b, type WritableJotaiAtom as c, type WritableNanoAtom as d, type WritableSignalLike as e, type WritableStore as f, type WritableStoreOptions as g, externalStore as h, nodeSnapshot as i, jotaiAtom as j, recordReadableStore as k, subscribeNodeValues as l, nanoAtom as n, readableStore as r, signalFromNode as s, writableStore as w, zustandStore as z };

package/dist/store-CNJwmT-h.d.cts

@@ -0,0 +1,123 @@
+import { N as Node } from './types-CcPIn7sy.cjs';
+
+/**
+ * Framework-neutral store adapters.
+ *
+ * Focused framework bindings build on this tiny Node-facing layer without
+ * importing framework packages into the dependency-free adapters barrel
+ * (D125/D238).
+ */
+
+/** A minimal readable store contract shared by Svelte/Nanostores-style adapters. */
+interface ReadableStore<T> {
+    get(): T | undefined;
+    subscribe(run: (value: T | undefined) => void): () => void;
+}
+/** A minimal writable store contract over a clean-slate writable node. */
+interface WritableStore<T> extends ReadableStore<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+/** React `useSyncExternalStore`-compatible shape, without importing React. */
+interface ExternalStore<T> {
+    getSnapshot(): T | undefined;
+    getServerSnapshot(): T | undefined;
+    subscribe(onStoreChange: () => void): () => void;
+}
+/** Object-of-nodes factory used by record subscription adapters. */
+type NodeRecordFactory<K extends string, R extends Record<string, unknown>> = (key: K) => {
+    [P in keyof R]: Node<R[P]>;
+};
+/** Zustand-compatible store API over a caller-owned clean-slate state node. */
+interface ZustandStoreApi<T extends object> {
+    getState(): T;
+    setState(partial: T | Partial<T> | ((state: T) => T | Partial<T>), replace?: boolean): void;
+    getInitialState(): T;
+    subscribe(listener: (state: T, prevState: T) => void): () => void;
+    destroy(): void;
+}
+/** Jotai-style atom facade over a caller-owned node. */
+interface JotaiAtom<T> {
+    get(): T | undefined;
+    subscribe(callback: (value: T | undefined) => void): () => void;
+    readonly _node: Node<T>;
+}
+/** Writable Jotai-style atom facade over a caller-owned writable node. */
+interface WritableJotaiAtom<T> extends JotaiAtom<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+/** Nanostores-style atom facade over a caller-owned node. */
+interface NanoAtom<T> {
+    get(): T | undefined;
+    subscribe(callback: (value: T | undefined) => void): () => void;
+    listen(callback: (value: T | undefined) => void): () => void;
+    readonly _node: Node<T>;
+}
+/** Writable Nanostores-style atom facade over a caller-owned writable node. */
+interface WritableNanoAtom<T> extends NanoAtom<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+/** TC39-Signals-style facade over a caller-owned node. */
+interface SignalLike<T> {
+    get(): T | undefined;
+    subscribe(callback: (value: T | undefined) => void): () => void;
+    readonly _node: Node<T>;
+}
+/** Writable TC39-Signals-style facade over a caller-owned writable node. */
+interface WritableSignalLike<T> extends SignalLike<T> {
+    set(value: T): void;
+    update(fn: (value: T | undefined) => T): void;
+}
+interface SubscribeValuesOptions<T> {
+    /** Emit the current cache snapshot immediately. `undefined` means SENTINEL/no DATA. */
+    immediate?: boolean;
+    /** Suppress synchronous push-on-subscribe/replay DATA. Useful for change-only store listeners. */
+    changesOnly?: boolean;
+    onError?: (error: unknown) => void;
+    onComplete?: () => void;
+    /** Custom cache reader for wrappers that keep their own snapshot object. */
+    getSnapshot?: () => T | undefined;
+}
+interface WritableNode<T> extends Node<T> {
+    set(value: T): void;
+}
+interface WritableStoreOptions<T> extends SubscribeValuesOptions<T> {
+    /** Override writes for adapters that need a framework-owned reducer. */
+    write?: (node: WritableNode<T>, value: T) => void;
+}
+/** Read a node cache without activating it. */
+declare function nodeSnapshot<T>(node: Node<T>): T | undefined;
+/**
+ * Subscribe to DATA values from a Node. Protocol internals stay below the adapter boundary:
+ * DATA drives value listeners, ERROR/COMPLETE route to optional lifecycle callbacks.
+ */
+declare function subscribeNodeValues<T>(node: Node<T>, run: (value: T | undefined) => void, opts?: SubscribeValuesOptions<T>): () => void;
+/** Build a Svelte/Nanostores-style readable store from a clean-slate Node. */
+declare function readableStore<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): ReadableStore<T>;
+/** Build a writable store over a StateNode or compatible clean-slate writable Node. */
+declare function writableStore<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableStore<T>;
+declare function writableStore<T>(node: Node<T>, opts: WritableStoreOptions<T> & {
+    write: (node: WritableNode<T>, value: T) => void;
+}): WritableStore<T>;
+/** Build the tiny shape React's `useSyncExternalStore` expects, without importing React. */
+declare function externalStore<T>(node: Node<T>, opts?: Pick<SubscribeValuesOptions<T>, "getSnapshot" | "onError" | "onComplete">): ExternalStore<T>;
+/** Build a framework-neutral keyed record store for focused framework record bindings. */
+declare function recordReadableStore<K extends string, R extends Record<string, unknown>>(keysNode: Node<readonly K[]>, factory: NodeRecordFactory<K, R>, opts?: SubscribeValuesOptions<Record<K, R>>): ReadableStore<Record<K, R>>;
+/** Build a Zustand-compatible StoreApi over a caller-owned clean-slate state node. */
+declare function zustandStore<T extends object>(node: WritableNode<T>, initialState?: T, opts?: WritableStoreOptions<T>): ZustandStoreApi<T>;
+declare function zustandStore<T extends object>(node: Node<T>, initialState: T | undefined, opts: WritableStoreOptions<T> & {
+    write: (node: WritableNode<T>, value: T) => void;
+}): ZustandStoreApi<T>;
+/** Build a Jotai-style atom facade over a caller-owned node. */
+declare function jotaiAtom<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableJotaiAtom<T>;
+declare function jotaiAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): JotaiAtom<T>;
+/** Build a Nanostores-style atom facade over a caller-owned node. */
+declare function nanoAtom<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableNanoAtom<T>;
+declare function nanoAtom<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): NanoAtom<T>;
+/** Build a TC39-Signals-style facade over a caller-owned node. */
+declare function signalFromNode<T>(node: WritableNode<T>, opts?: WritableStoreOptions<T>): WritableSignalLike<T>;
+declare function signalFromNode<T>(node: Node<T>, opts?: SubscribeValuesOptions<T>): SignalLike<T>;
+
+export { type ExternalStore as E, type JotaiAtom as J, type NanoAtom as N, type ReadableStore as R, type SignalLike as S, type WritableNode as W, type ZustandStoreApi as Z, type NodeRecordFactory as a, type SubscribeValuesOptions as b, type WritableJotaiAtom as c, type WritableNanoAtom as d, type WritableSignalLike as e, type WritableStore as f, type WritableStoreOptions as g, externalStore as h, nodeSnapshot as i, jotaiAtom as j, recordReadableStore as k, subscribeNodeValues as l, nanoAtom as n, readableStore as r, signalFromNode as s, writableStore as w, zustandStore as z };

package/dist/testing/index.cjs

@@ -36,6 +36,7 @@ var TIER = {
   START: TIER_START,
   PAUSE: TIER_CONTROL,
   RESUME: TIER_CONTROL,
+  PULL: TIER_CONTROL,
   DIRTY: TIER_NOTIFICATION,
   DATA: TIER_VALUE,
   RESOLVED: TIER_VALUE,

package/dist/testing/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts","../../src/protocol/messages.ts","../../src/testing/assertions.ts"],"sourcesContent":["export {\n\tassertDirtyPrecedesTerminalData,\n\ttype MessageSequence,\n} from \"./assertions.js\";\n","/**\n * Wave-protocol message types and the tier const table.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-msg-format, R-msg-closed-set, R-tier (D34), R-data-payload, R-sentinel.\n */\n\n/** Opaque pause-lock identifier (R-pause-lockset). */\nexport type LockId = string | symbol;\n\n/**\n * The CLOSED set of 10 message types (R-msg-closed-set / D9 + START handshake).\n * No open set, no user-defined custom types. Adding a type is a spec change.\n */\nexport type Message =\n\t| readonly [\"START\"]\n\t| readonly [\"DIRTY\"]\n\t| readonly [\"DATA\", unknown]\n\t| readonly [\"RESOLVED\"]\n\t| readonly [\"INVALIDATE\"]\n\t| readonly [\"COMPLETE\"]\n\t| readonly [\"ERROR\", unknown]\n\t| readonly [\"TEARDOWN\"]\n\t| readonly [\"PAUSE\", LockId]\n\t| readonly [\"RESUME\", LockId];\n\n/** One array of messages delivered in one call = one Wave (R-wave-boundary). */\nexport type Wave = readonly Message[];\n\n/** The message-type tag (the first tuple element). */\nexport type MessageType = Message[0];\n\n/**\n * SENTINEL = absence-of-DATA (R-sentinel / D16). TS representation is `undefined`.\n * Never a valid DATA payload; `null` IS a valid DATA value (domain-level absence).\n */\nexport const SENTINEL = undefined;\n\n/** R-data-payload: ERROR payloads must not collide with terminal metadata shorthand. */\nexport function isInvalidErrorPayload(v: unknown): boolean {\n\treturn v === SENTINEL || typeof v === \"boolean\";\n}\n\n/** R-data-payload / D78: host-language failures that collide with ctx.terminal shorthand become diagnostics. */\nexport function errorPayload(reason: unknown, fallback = \"error without a valid payload\"): unknown {\n\treturn isInvalidErrorPayload(reason) ? new Error(fallback) : reason;\n}\n\nexport const TIER_START = 0;\nexport const TIER_CONTROL = 1;\nexport const TIER_NOTIFICATION = 2;\nexport const TIER_VALUE = 3;\nexport const TIER_SETTLE = 4;\nexport const TIER_TERMINAL = 5;\nexport const TIER_TEARDOWN = 6;\n\n/**\n * Tier const table (R-tier / D34). Tiers below value dispatch immediately; value\n * and above are batch-deferred. This is a compile-time const table (D18), not runtime config.\n */\nconst TIER: Record<MessageType, number> = {\n\tSTART: TIER_START,\n\tPAUSE: TIER_CONTROL,\n\tRESUME: TIER_CONTROL,\n\tDIRTY: TIER_NOTIFICATION,\n\tDATA: TIER_VALUE,\n\tRESOLVED: TIER_VALUE,\n\tINVALIDATE: TIER_SETTLE,\n\tCOMPLETE: TIER_TERMINAL,\n\tERROR: TIER_TERMINAL,\n\tTEARDOWN: TIER_TEARDOWN,\n};\n\nexport function messageTier(t: MessageType): number {\n\treturn TIER[t];\n}\n\n/** Value and above are deferred inside a batch (DATA/RESOLVED/INVALIDATE/terminal/teardown). */\nexport function isDeferredTier(t: MessageType): boolean {\n\treturn TIER[t] >= TIER_VALUE;\n}\n\n/** Value-tier messages (DATA/RESOLVED) occupy the tier-3 slot. */\nexport function isValueTier(t: MessageType): boolean {\n\treturn TIER[t] === TIER_VALUE;\n}\n\n/** The pause buffer holds the settle slice only: value-tier DATA/RESOLVED plus INVALIDATE. */\nexport function isPauseBufferedTier(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier === TIER_VALUE || tier === TIER_SETTLE;\n}\n\n/**\n * A TERMINAL message = tier 5 (COMPLETE | ERROR), R-tier / D34. Detected via the CENTRAL tier\n * table, NOT a per-variant `=== \"COMPLETE\" || === \"ERROR\"` check — so terminal routing stays\n * driven by the one const table (feedback_use_tier_for_signal_routing); discriminate COMPLETE vs\n * ERROR within the tier by the message type only where the handling actually differs.\n */\nexport function isTerminal(t: MessageType): boolean {\n\treturn TIER[t] === TIER_TERMINAL;\n}\n\n/**\n * ctx.up carries control tiers only (R-ctx-up / DR-5): DIRTY, PAUSE, RESUME,\n * INVALIDATE, TEARDOWN. DATA/RESOLVED (tier 3) and COMPLETE/ERROR (tier 5) are\n * down-only.\n */\nexport function isUpAllowed(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier !== TIER_VALUE && tier !== TIER_TERMINAL;\n}\n","/**\n * Public testing assertions for clean-slate GraphReFly message streams.\n *\n * These helpers validate captured protocol output; they do not participate in propagation.\n */\n\nimport { isValueTier, type Message, type Wave } from \"../protocol/messages.js\";\n\n/** Captured subscriber messages grouped by wave. START/replay handshake messages occupy one wave. */\nexport type MessageSequence = readonly Wave[];\n\n/**\n * Assert that observed tier-3 settlements (DATA/RESOLVED) are preceded by DIRTY.\n *\n * This encodes R-dirty-before-data for wave-framed subscriber traces. The leading\n * START push-on-subscribe/replay handshake wave is exempt because cached/replay DATA is\n * advertised to a new subscriber without opening a propagation wave.\n */\nexport function assertDirtyPrecedesTerminalData(messages: MessageSequence): void {\n\tfor (let waveIndex = 0; waveIndex < messages.length; waveIndex += 1) {\n\t\tconst wave = messages[waveIndex];\n\t\tlet handshake = false;\n\t\tlet openedByDirty = false;\n\n\t\tfor (let msgIndex = 0; msgIndex < wave.length; msgIndex += 1) {\n\t\t\tconst msg = wave[msgIndex] as Message;\n\t\t\tconst type = msg[0];\n\n\t\t\tif (msgIndex === 0 && type === \"START\") {\n\t\t\t\thandshake = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (handshake && type === \"DATA\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\thandshake = false;\n\n\t\t\tif (type === \"DIRTY\") {\n\t\t\t\topenedByDirty = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (isValueTier(type)) {\n\t\t\t\tif (!openedByDirty) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`assertDirtyPrecedesTerminalData: ${type} at wave ${waveIndex}, index ${msgIndex} arrived without a preceding DIRTY in the same wave (R-dirty-before-data). Wave: ${describeWave(wave, msgIndex)}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\topenedByDirty = false;\n\t\t}\n\t}\n}\n\nfunction describeWave(wave: Wave, around: number): string {\n\tconst parts: string[] = [];\n\tfor (let i = 0; i < wave.length; i += 1) {\n\t\tparts.push(`${i === around ? \"-> \" : \"   \"}[${wave[i]?.[0] ?? \"?\"}]`);\n\t}\n\treturn parts.join(\", \");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACgDO,IAAM,aAAa;AACnB,IAAM,eAAe;AACrB,IAAM,oBAAoB;AAC1B,IAAM,aAAa;AACnB,IAAM,cAAc;AACpB,IAAM,gBAAgB;AACtB,IAAM,gBAAgB;AAM7B,IAAM,OAAoC;AAAA,EACzC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,MAAM;AAAA,EACN,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,OAAO;AAAA,EACP,UAAU;AACX;AAYO,SAAS,YAAY,GAAyB;AACpD,SAAO,KAAK,CAAC,MAAM;AACpB;;;ACnEO,SAAS,gCAAgC,UAAiC;AAChF,WAAS,YAAY,GAAG,YAAY,SAAS,QAAQ,aAAa,GAAG;AACpE,UAAM,OAAO,SAAS,SAAS;AAC/B,QAAI,YAAY;AAChB,QAAI,gBAAgB;AAEpB,aAAS,WAAW,GAAG,WAAW,KAAK,QAAQ,YAAY,GAAG;AAC7D,YAAM,MAAM,KAAK,QAAQ;AACzB,YAAM,OAAO,IAAI,CAAC;AAElB,UAAI,aAAa,KAAK,SAAS,SAAS;AACvC,oBAAY;AACZ;AAAA,MACD;AAEA,UAAI,aAAa,SAAS,QAAQ;AACjC;AAAA,MACD;AACA,kBAAY;AAEZ,UAAI,SAAS,SAAS;AACrB,wBAAgB;AAChB;AAAA,MACD;AAEA,UAAI,YAAY,IAAI,GAAG;AACtB,YAAI,CAAC,eAAe;AACnB,gBAAM,IAAI;AAAA,YACT,oCAAoC,IAAI,YAAY,SAAS,WAAW,QAAQ,oFAAoF,aAAa,MAAM,QAAQ,CAAC;AAAA,UACjM;AAAA,QACD;AACA;AAAA,MACD;AAEA,sBAAgB;AAAA,IACjB;AAAA,EACD;AACD;AAEA,SAAS,aAAa,MAAY,QAAwB;AACzD,QAAM,QAAkB,CAAC;AACzB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,GAAG;AACxC,UAAM,KAAK,GAAG,MAAM,SAAS,QAAQ,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG;AAAA,EACrE;AACA,SAAO,MAAM,KAAK,IAAI;AACvB;","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts","../../src/protocol/messages.ts","../../src/testing/assertions.ts"],"sourcesContent":["export {\n\tassertDirtyPrecedesTerminalData,\n\ttype MessageSequence,\n} from \"./assertions.js\";\n","/**\n * Wave-protocol message types and the tier const table.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-msg-format, R-msg-closed-set, R-tier (D34), R-data-payload, R-sentinel.\n */\n\n/** Opaque pause-lock / pull identifier (R-pause-lockset, R-pull). */\nexport type LockId = string | symbol;\n\n/** Explicit pull demand payload (D269/D272). Params are holder-visible context, never DATA-up. */\nexport interface PullDemand {\n\treadonly pullId: LockId;\n\treadonly params?: unknown;\n}\n\n/**\n * The CLOSED set of 11 message types (R-msg-closed-set / D9 + D269 + START handshake).\n * No open set, no user-defined custom types. Adding a type is a spec change.\n */\nexport type Message =\n\t| readonly [\"START\"]\n\t| readonly [\"DIRTY\"]\n\t| readonly [\"DATA\", unknown]\n\t| readonly [\"RESOLVED\"]\n\t| readonly [\"INVALIDATE\"]\n\t| readonly [\"COMPLETE\"]\n\t| readonly [\"ERROR\", unknown]\n\t| readonly [\"TEARDOWN\"]\n\t| readonly [\"PAUSE\", LockId]\n\t| readonly [\"RESUME\", LockId]\n\t| readonly [\"PULL\", PullDemand];\n\n/** One array of messages delivered in one call = one Wave (R-wave-boundary). */\nexport type Wave = readonly Message[];\n\n/** The message-type tag (the first tuple element). */\nexport type MessageType = Message[0];\n\n/**\n * SENTINEL = absence-of-DATA (R-sentinel / D16). TS representation is `undefined`.\n * Never a valid DATA payload; `null` IS a valid DATA value (domain-level absence).\n */\nexport const SENTINEL = undefined;\n\n/** R-data-payload: ERROR payloads must not collide with terminal metadata shorthand. */\nexport function isInvalidErrorPayload(v: unknown): boolean {\n\treturn v === SENTINEL || typeof v === \"boolean\";\n}\n\n/** R-data-payload / D78: host-language failures that collide with ctx.terminal shorthand become diagnostics. */\nexport function errorPayload(reason: unknown, fallback = \"error without a valid payload\"): unknown {\n\treturn isInvalidErrorPayload(reason) ? new Error(fallback) : reason;\n}\n\nexport const TIER_START = 0;\nexport const TIER_CONTROL = 1;\nexport const TIER_NOTIFICATION = 2;\nexport const TIER_VALUE = 3;\nexport const TIER_SETTLE = 4;\nexport const TIER_TERMINAL = 5;\nexport const TIER_TEARDOWN = 6;\n\n/**\n * Tier const table (R-tier / D34). Tiers below value dispatch immediately; value\n * and above are batch-deferred. This is a compile-time const table (D18), not runtime config.\n */\nconst TIER: Record<MessageType, number> = {\n\tSTART: TIER_START,\n\tPAUSE: TIER_CONTROL,\n\tRESUME: TIER_CONTROL,\n\tPULL: TIER_CONTROL,\n\tDIRTY: TIER_NOTIFICATION,\n\tDATA: TIER_VALUE,\n\tRESOLVED: TIER_VALUE,\n\tINVALIDATE: TIER_SETTLE,\n\tCOMPLETE: TIER_TERMINAL,\n\tERROR: TIER_TERMINAL,\n\tTEARDOWN: TIER_TEARDOWN,\n};\n\nexport function messageTier(t: MessageType): number {\n\treturn TIER[t];\n}\n\n/** Value and above are deferred inside a batch (DATA/RESOLVED/INVALIDATE/terminal/teardown). */\nexport function isDeferredTier(t: MessageType): boolean {\n\treturn TIER[t] >= TIER_VALUE;\n}\n\n/** Value-tier messages (DATA/RESOLVED) occupy the tier-3 slot. */\nexport function isValueTier(t: MessageType): boolean {\n\treturn TIER[t] === TIER_VALUE;\n}\n\n/** The pause buffer holds the settle slice only: value-tier DATA/RESOLVED plus INVALIDATE. */\nexport function isPauseBufferedTier(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier === TIER_VALUE || tier === TIER_SETTLE;\n}\n\n/**\n * A TERMINAL message = tier 5 (COMPLETE | ERROR), R-tier / D34. Detected via the CENTRAL tier\n * table, NOT a per-variant `=== \"COMPLETE\" || === \"ERROR\"` check — so terminal routing stays\n * driven by the one const table (feedback_use_tier_for_signal_routing); discriminate COMPLETE vs\n * ERROR within the tier by the message type only where the handling actually differs.\n */\nexport function isTerminal(t: MessageType): boolean {\n\treturn TIER[t] === TIER_TERMINAL;\n}\n\n/**\n * ctx.up carries control/demand tiers only (R-ctx-up / D269): DIRTY, PAUSE, RESUME, PULL,\n * INVALIDATE, TEARDOWN. DATA/RESOLVED (tier 3) and COMPLETE/ERROR (tier 5) are\n * down-only.\n */\nexport function isUpAllowed(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier !== TIER_VALUE && tier !== TIER_TERMINAL;\n}\n","/**\n * Public testing assertions for clean-slate GraphReFly message streams.\n *\n * These helpers validate captured protocol output; they do not participate in propagation.\n */\n\nimport { isValueTier, type Message, type Wave } from \"../protocol/messages.js\";\n\n/** Captured subscriber messages grouped by wave. START/replay handshake messages occupy one wave. */\nexport type MessageSequence = readonly Wave[];\n\n/**\n * Assert that observed tier-3 settlements (DATA/RESOLVED) are preceded by DIRTY.\n *\n * This encodes R-dirty-before-data for wave-framed subscriber traces. The leading\n * START push-on-subscribe/replay handshake wave is exempt because cached/replay DATA is\n * advertised to a new subscriber without opening a propagation wave.\n */\nexport function assertDirtyPrecedesTerminalData(messages: MessageSequence): void {\n\tfor (let waveIndex = 0; waveIndex < messages.length; waveIndex += 1) {\n\t\tconst wave = messages[waveIndex];\n\t\tlet handshake = false;\n\t\tlet openedByDirty = false;\n\n\t\tfor (let msgIndex = 0; msgIndex < wave.length; msgIndex += 1) {\n\t\t\tconst msg = wave[msgIndex] as Message;\n\t\t\tconst type = msg[0];\n\n\t\t\tif (msgIndex === 0 && type === \"START\") {\n\t\t\t\thandshake = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (handshake && type === \"DATA\") {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\thandshake = false;\n\n\t\t\tif (type === \"DIRTY\") {\n\t\t\t\topenedByDirty = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (isValueTier(type)) {\n\t\t\t\tif (!openedByDirty) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`assertDirtyPrecedesTerminalData: ${type} at wave ${waveIndex}, index ${msgIndex} arrived without a preceding DIRTY in the same wave (R-dirty-before-data). Wave: ${describeWave(wave, msgIndex)}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\topenedByDirty = false;\n\t\t}\n\t}\n}\n\nfunction describeWave(wave: Wave, around: number): string {\n\tconst parts: string[] = [];\n\tfor (let i = 0; i < wave.length; i += 1) {\n\t\tparts.push(`${i === around ? \"-> \" : \"   \"}[${wave[i]?.[0] ?? \"?\"}]`);\n\t}\n\treturn parts.join(\", \");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACuDO,IAAM,aAAa;AACnB,IAAM,eAAe;AACrB,IAAM,oBAAoB;AAC1B,IAAM,aAAa;AACnB,IAAM,cAAc;AACpB,IAAM,gBAAgB;AACtB,IAAM,gBAAgB;AAM7B,IAAM,OAAoC;AAAA,EACzC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,OAAO;AAAA,EACP,UAAU;AACX;AAYO,SAAS,YAAY,GAAyB;AACpD,SAAO,KAAK,CAAC,MAAM;AACpB;;;AC3EO,SAAS,gCAAgC,UAAiC;AAChF,WAAS,YAAY,GAAG,YAAY,SAAS,QAAQ,aAAa,GAAG;AACpE,UAAM,OAAO,SAAS,SAAS;AAC/B,QAAI,YAAY;AAChB,QAAI,gBAAgB;AAEpB,aAAS,WAAW,GAAG,WAAW,KAAK,QAAQ,YAAY,GAAG;AAC7D,YAAM,MAAM,KAAK,QAAQ;AACzB,YAAM,OAAO,IAAI,CAAC;AAElB,UAAI,aAAa,KAAK,SAAS,SAAS;AACvC,oBAAY;AACZ;AAAA,MACD;AAEA,UAAI,aAAa,SAAS,QAAQ;AACjC;AAAA,MACD;AACA,kBAAY;AAEZ,UAAI,SAAS,SAAS;AACrB,wBAAgB;AAChB;AAAA,MACD;AAEA,UAAI,YAAY,IAAI,GAAG;AACtB,YAAI,CAAC,eAAe;AACnB,gBAAM,IAAI;AAAA,YACT,oCAAoC,IAAI,YAAY,SAAS,WAAW,QAAQ,oFAAoF,aAAa,MAAM,QAAQ,CAAC;AAAA,UACjM;AAAA,QACD;AACA;AAAA,MACD;AAEA,sBAAgB;AAAA,IACjB;AAAA,EACD;AACD;AAEA,SAAS,aAAa,MAAY,QAAwB;AACzD,QAAM,QAAkB,CAAC;AACzB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,GAAG;AACxC,UAAM,KAAK,GAAG,MAAM,SAAS,QAAQ,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG;AAAA,EACrE;AACA,SAAO,MAAM,KAAK,IAAI;AACvB;","names":[]}

package/dist/testing/index.d.cts

@@ -1,4 +1,4 @@
-import { W as Wave } from '../messages-BZqrGGm1.cjs';
+import { W as Wave } from '../messages-CAzUPPJM.cjs';
 
 /**
  * Public testing assertions for clean-slate GraphReFly message streams.