@workglow/storage 0.2.27 → 0.2.29

package/dist/sqlite/bun.d.ts

@@ -1,32 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { SqliteApi } from "./canonical-api";
-export type { SqliteApi };
-/**
- * Resolves `bun:sqlite` via dynamic import. Idempotent; concurrent callers share one load.
- */
-declare function initSqlite(): Promise<void>;
-/**
- * Bun `bun:sqlite` database wrapped to match {@link SqliteApi.Database}:
- * `prepare<Bind, Result>` uses bindings-first generics; `get()` maps `null` → `undefined`.
- */
-export declare class BunSqliteDatabase implements SqliteApi.Database {
-    #private;
-    constructor(filename?: string, options?: number | import("bun:sqlite").DatabaseOptions);
-    exec(sql: string): void;
-    prepare<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown>(sql: string): SqliteApi.Statement<BindParameters, Result>;
-    transaction<T extends unknown[]>(fn: (...args: T) => void): (...args: T) => void;
-    close(): void;
-    loadExtension(path: string, entryPoint?: string): void;
-}
-export declare const Sqlite: {
-    readonly init: typeof initSqlite;
-    readonly Database: typeof BunSqliteDatabase;
-};
-export declare namespace Sqlite {
-    type Database = BunSqliteDatabase;
-}
-//# sourceMappingURL=bun.d.ts.map

package/dist/sqlite/bun.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/sqlite/bun.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,YAAY,EAAE,SAAS,EAAE,CAAC;AAc1B;;GAEG;AACH,iBAAS,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAOnC;AAuCD;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,SAAS,CAAC,QAAQ;;IAG1D,YAAY,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,YAAY,EAAE,eAAe,EAGrF;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtB;IAED,OAAO,CAAC,cAAc,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAAE,MAAM,GAAG,OAAO,EAC9F,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAG7C;IAED,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAK/E;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAErD;CACF;AAED,eAAO,MAAM,MAAM;aACjB,IAAI;aACJ,QAAQ;CACA,CAAC;AAEX,yBAAiB,MAAM,CAAC,CAAC;IACvB,KAAY,QAAQ,GAAG,iBAAiB,CAAC;CAC1C"}

package/dist/sqlite/bun.js

@@ -1,84 +0,0 @@
-// @bun
-var __require = import.meta.require;
-
-// src/sqlite/bun.ts
-var _bunSqlite;
-var initPromise;
-function assertBunLoaded() {
-  if (!_bunSqlite) {
-    throw new Error("SQLite is not ready. Await Sqlite.init() before using new Sqlite.Database().");
-  }
-  return _bunSqlite;
-}
-function initSqlite() {
-  return initPromise ??= (async () => {
-    if (_bunSqlite) {
-      return;
-    }
-    _bunSqlite = await import("bun:sqlite");
-  })();
-}
-function getBunSqlite() {
-  return assertBunLoaded();
-}
-function toRunResult(changes, lastInsertRowid) {
-  return { changes, lastInsertRowid };
-}
-
-class BunStatementAdapter {
-  #stmt;
-  constructor(stmt) {
-    this.#stmt = stmt;
-  }
-  run(...params) {
-    const meta = this.#stmt.run(...params);
-    return toRunResult(meta.changes, meta.lastInsertRowid);
-  }
-  get(...params) {
-    const row = this.#stmt.get(...params);
-    return row === null ? undefined : row;
-  }
-  all(...params) {
-    return this.#stmt.all(...params);
-  }
-  finalize() {
-    this.#stmt.finalize();
-  }
-}
-
-class BunSqliteDatabase {
-  #db;
-  constructor(filename, options) {
-    const { Database } = getBunSqlite();
-    this.#db = new Database(filename, options);
-  }
-  exec(sql) {
-    this.#db.run(sql);
-  }
-  prepare(sql) {
-    const stmt = this.#db.prepare(sql);
-    return new BunStatementAdapter(stmt);
-  }
-  transaction(fn) {
-    const tx = this.#db.transaction(fn);
-    return (...args) => {
-      tx(...args);
-    };
-  }
-  close() {
-    this.#db.close();
-  }
-  loadExtension(path, entryPoint) {
-    this.#db.loadExtension(path, entryPoint);
-  }
-}
-var Sqlite = {
-  init: initSqlite,
-  Database: BunSqliteDatabase
-};
-export {
-  Sqlite,
-  BunSqliteDatabase
-};
-
-//# debugId=A1427F3CD043959764756E2164756E21

package/dist/sqlite/bun.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/sqlite/bun.ts"],
-  "sourcesContent": [
-    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Database as BunDatabaseCtor, Statement as BunStatementType } from \"bun:sqlite\";\n\nimport type { SqliteApi } from \"./canonical-api\";\n\nexport type { SqliteApi };\n\ntype BunSqliteModule = typeof import(\"bun:sqlite\");\n\nlet _bunSqlite: BunSqliteModule | undefined;\nlet initPromise: Promise<void> | undefined;\n\nfunction assertBunLoaded(): BunSqliteModule {\n  if (!_bunSqlite) {\n    throw new Error(\"SQLite is not ready. Await Sqlite.init() before using new Sqlite.Database().\");\n  }\n  return _bunSqlite;\n}\n\n/**\n * Resolves `bun:sqlite` via dynamic import. Idempotent; concurrent callers share one load.\n */\nfunction initSqlite(): Promise<void> {\n  return (initPromise ??= (async () => {\n    if (_bunSqlite) {\n      return;\n    }\n    _bunSqlite = await import(\"bun:sqlite\");\n  })());\n}\n\nfunction getBunSqlite(): BunSqliteModule {\n  return assertBunLoaded();\n}\n\nfunction toRunResult(changes: number, lastInsertRowid: number | bigint): SqliteApi.RunResult {\n  return { changes, lastInsertRowid };\n}\n\nclass BunStatementAdapter<\n  BindParameters extends unknown[] | Record<string, unknown> = unknown[],\n  Result = unknown,\n> implements SqliteApi.Statement<BindParameters, Result> {\n  readonly #stmt: BunStatementType<Result, any>;\n\n  constructor(stmt: BunStatementType<Result, any>) {\n    this.#stmt = stmt;\n  }\n\n  run(...params: unknown[]): SqliteApi.RunResult {\n    const meta = this.#stmt.run(...(params as never[]));\n    return toRunResult(meta.changes, meta.lastInsertRowid);\n  }\n\n  get(...params: unknown[]): Result | undefined {\n    const row = this.#stmt.get(...(params as never[]));\n    return row === null ? undefined : row;\n  }\n\n  all(...params: unknown[]): Result[] {\n    return this.#stmt.all(...(params as never[]));\n  }\n\n  finalize(): void {\n    this.#stmt.finalize();\n  }\n}\n\n/**\n * Bun `bun:sqlite` database wrapped to match {@link SqliteApi.Database}:\n * `prepare<Bind, Result>` uses bindings-first generics; `get()` maps `null` → `undefined`.\n */\nexport class BunSqliteDatabase implements SqliteApi.Database {\n  readonly #db: InstanceType<typeof BunDatabaseCtor>;\n\n  constructor(filename?: string, options?: number | import(\"bun:sqlite\").DatabaseOptions) {\n    const { Database } = getBunSqlite();\n    this.#db = new Database(filename, options);\n  }\n\n  exec(sql: string): void {\n    this.#db.run(sql);\n  }\n\n  prepare<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown>(\n    sql: string\n  ): SqliteApi.Statement<BindParameters, Result> {\n    const stmt = this.#db.prepare<Result, any>(sql);\n    return new BunStatementAdapter<BindParameters, Result>(stmt);\n  }\n\n  transaction<T extends unknown[]>(fn: (...args: T) => void): (...args: T) => void {\n    const tx = this.#db.transaction(fn);\n    return (...args: T) => {\n      tx(...args);\n    };\n  }\n\n  close(): void {\n    this.#db.close();\n  }\n\n  loadExtension(path: string, entryPoint?: string): void {\n    this.#db.loadExtension(path, entryPoint);\n  }\n}\n\nexport const Sqlite = {\n  init: initSqlite,\n  Database: BunSqliteDatabase,\n} as const;\n\nexport namespace Sqlite {\n  export type Database = BunSqliteDatabase;\n}\n"
-  ],
-  "mappings": ";;;;AAcA,IAAI;AACJ,IAAI;AAEJ,SAAS,eAAe,GAAoB;AAAA,EAC1C,IAAI,CAAC,YAAY;AAAA,IACf,MAAM,IAAI,MAAM,8EAA8E;AAAA,EAChG;AAAA,EACA,OAAO;AAAA;AAMT,SAAS,UAAU,GAAkB;AAAA,EACnC,OAAQ,iBAAiB,YAAY;AAAA,IACnC,IAAI,YAAY;AAAA,MACd;AAAA,IACF;AAAA,IACA,aAAa,MAAa;AAAA,KACzB;AAAA;AAGL,SAAS,YAAY,GAAoB;AAAA,EACvC,OAAO,gBAAgB;AAAA;AAGzB,SAAS,WAAW,CAAC,SAAiB,iBAAuD;AAAA,EAC3F,OAAO,EAAE,SAAS,gBAAgB;AAAA;AAAA;AAGpC,MAAM,oBAGmD;AAAA,EAC9C;AAAA,EAET,WAAW,CAAC,MAAqC;AAAA,IAC/C,KAAK,QAAQ;AAAA;AAAA,EAGf,GAAG,IAAI,QAAwC;AAAA,IAC7C,MAAM,OAAO,KAAK,MAAM,IAAI,GAAI,MAAkB;AAAA,IAClD,OAAO,YAAY,KAAK,SAAS,KAAK,eAAe;AAAA;AAAA,EAGvD,GAAG,IAAI,QAAuC;AAAA,IAC5C,MAAM,MAAM,KAAK,MAAM,IAAI,GAAI,MAAkB;AAAA,IACjD,OAAO,QAAQ,OAAO,YAAY;AAAA;AAAA,EAGpC,GAAG,IAAI,QAA6B;AAAA,IAClC,OAAO,KAAK,MAAM,IAAI,GAAI,MAAkB;AAAA;AAAA,EAG9C,QAAQ,GAAS;AAAA,IACf,KAAK,MAAM,SAAS;AAAA;AAExB;AAAA;AAMO,MAAM,kBAAgD;AAAA,EAClD;AAAA,EAET,WAAW,CAAC,UAAmB,SAAyD;AAAA,IACtF,QAAQ,aAAa,aAAa;AAAA,IAClC,KAAK,MAAM,IAAI,SAAS,UAAU,OAAO;AAAA;AAAA,EAG3C,IAAI,CAAC,KAAmB;AAAA,IACtB,KAAK,IAAI,IAAI,GAAG;AAAA;AAAA,EAGlB,OAAiG,CAC/F,KAC6C;AAAA,IAC7C,MAAM,OAAO,KAAK,IAAI,QAAqB,GAAG;AAAA,IAC9C,OAAO,IAAI,oBAA4C,IAAI;AAAA;AAAA,EAG7D,WAAgC,CAAC,IAAgD;AAAA,IAC/E,MAAM,KAAK,KAAK,IAAI,YAAY,EAAE;AAAA,IAClC,OAAO,IAAI,SAAY;AAAA,MACrB,GAAG,GAAG,IAAI;AAAA;AAAA;AAAA,EAId,KAAK,GAAS;AAAA,IACZ,KAAK,IAAI,MAAM;AAAA;AAAA,EAGjB,aAAa,CAAC,MAAc,YAA2B;AAAA,IACrD,KAAK,IAAI,cAAc,MAAM,UAAU;AAAA;AAE3C;AAEO,IAAM,SAAS;AAAA,EACpB,MAAM;AAAA,EACN,UAAU;AACZ;",
-  "debugId": "A1427F3CD043959764756E2164756E21",
-  "names": []
-}

package/dist/sqlite/canonical-api.d.ts

@@ -1,34 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-/**
- * Canonical SQLite surface for `@workglow/storage/sqlite` across Node (better-sqlite3),
- * Bun (native, via adapter), and browser (WASM).
- *
- * On every platform, call `await Sqlite.init()` once before `new Sqlite.Database(...)`.
- *
- * **Generic order:** `prepare<BindParameters, Result>(sql)` — bindings first,
- * row/result second (better-sqlite3 order), not `bun:sqlite`’s reversed order.
- */
-export declare namespace SqliteApi {
-    interface RunResult {
-        readonly changes: number;
-        readonly lastInsertRowid: number | bigint;
-    }
-    interface Statement<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown> {
-        run(...params: unknown[]): RunResult;
-        get(...params: unknown[]): Result | undefined;
-        all(...params: unknown[]): Result[];
-        finalize(): void;
-    }
-    interface Database {
-        exec(sql: string): void;
-        prepare<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown>(sql: string): Statement<BindParameters, Result>;
-        transaction<T extends unknown[]>(fn: (...args: T) => void): (...args: T) => void;
-        close(): void;
-        loadExtension(path: string, entryPoint?: string): void;
-    }
-}
-//# sourceMappingURL=canonical-api.d.ts.map

package/dist/sqlite/canonical-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"canonical-api.d.ts","sourceRoot":"","sources":["../../src/sqlite/canonical-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,yBAAiB,SAAS,CAAC,CAAC;IAC1B,UAAiB,SAAS;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;KAC3C;IAED,UAAiB,SAAS,CACxB,cAAc,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EACtE,MAAM,GAAG,OAAO;QAEhB,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;QACrC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;QAC9C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;QACpC,QAAQ,IAAI,IAAI,CAAC;KAClB;IAED,UAAiB,QAAQ;QACvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,OAAO,CACL,cAAc,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EACtE,MAAM,GAAG,OAAO,EAEhB,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACrC,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;QACjF,KAAK,IAAI,IAAI,CAAC;QACd,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxD;CACF"}

package/dist/sqlite/node.d.ts

@@ -1,34 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import type BetterSqlite3 from "better-sqlite3";
-import type { SqliteApi } from "./canonical-api";
-export type { SqliteApi };
-/**
- * Loads better-sqlite3 via dynamic import. Idempotent; concurrent callers share one load.
- */
-declare function initSqlite(): Promise<void>;
-/**
- * better-sqlite3 database wrapped as {@link SqliteApi.Database} (bindings-first `prepare`
- * generics). Construct only after {@link Sqlite.init}.
- */
-export declare class NodeSqliteDatabase implements SqliteApi.Database {
-    #private;
-    constructor(filename?: string, options?: BetterSqlite3.Options);
-    exec(sql: string): void;
-    prepare<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown>(sql: string): SqliteApi.Statement<BindParameters, Result>;
-    transaction<T extends unknown[]>(fn: (...args: T) => void): (...args: T) => void;
-    close(): void;
-    loadExtension(path: string, entryPoint?: string): void;
-}
-export declare const Sqlite: {
-    readonly init: typeof initSqlite;
-    readonly Database: typeof NodeSqliteDatabase;
-};
-/** Merged with {@link Sqlite} so `Sqlite.Database` works in type positions (not only as a value). */
-export declare namespace Sqlite {
-    type Database = NodeSqliteDatabase;
-}
-//# sourceMappingURL=node.d.ts.map

package/dist/sqlite/node.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/sqlite/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,YAAY,EAAE,SAAS,EAAE,CAAC;AAc1B;;GAEG;AACH,iBAAS,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBnC;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,SAAS,CAAC,QAAQ;;IAG3D,YAAY,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,EAG7D;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtB;IAED,OAAO,CAAC,cAAc,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,EAAE,MAAM,GAAG,OAAO,EAC9F,GAAG,EAAE,MAAM,GACV,SAAS,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAE7C;IAED,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAK/E;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CASrD;CACF;AAED,eAAO,MAAM,MAAM;aACjB,IAAI;aACJ,QAAQ;CACA,CAAC;AAEX,qGAAqG;AACrG,yBAAiB,MAAM,CAAC,CAAC;IACvB,KAAY,QAAQ,GAAG,kBAAkB,CAAC;CAC3C"}

package/dist/sqlite/node.js

@@ -1,65 +0,0 @@
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// src/sqlite/node.ts
-var BetterCtor;
-var initPromise;
-function assertLoaded() {
-  if (!BetterCtor) {
-    throw new Error("SQLite is not ready. Await Sqlite.init() before using new Sqlite.Database().");
-  }
-  return BetterCtor;
-}
-function initSqlite() {
-  return initPromise ??= (async () => {
-    if (BetterCtor) {
-      return;
-    }
-    try {
-      const mod = await import("better-sqlite3");
-      BetterCtor = mod.default ?? mod;
-    } catch {
-      throw new Error("better-sqlite3 is required for @workglow/storage/sqlite on Node.js. Install it with: bun add better-sqlite3");
-    }
-  })();
-}
-
-class NodeSqliteDatabase {
-  #inner;
-  constructor(filename, options) {
-    const Ctor = assertLoaded();
-    this.#inner = new Ctor(filename ?? ":memory:", options);
-  }
-  exec(sql) {
-    this.#inner.exec(sql);
-  }
-  prepare(sql) {
-    return this.#inner.prepare(sql);
-  }
-  transaction(fn) {
-    const tx = this.#inner.transaction(fn);
-    return (...args) => {
-      tx(...args);
-    };
-  }
-  close() {
-    this.#inner.close();
-  }
-  loadExtension(path, entryPoint) {
-    if (entryPoint === undefined) {
-      this.#inner.loadExtension(path);
-    } else {
-      this.#inner.loadExtension(path, entryPoint);
-    }
-  }
-}
-var Sqlite = {
-  init: initSqlite,
-  Database: NodeSqliteDatabase
-};
-export {
-  Sqlite,
-  NodeSqliteDatabase
-};
-
-//# debugId=0C6C96D699E34FE664756E2164756E21

package/dist/sqlite/node.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/sqlite/node.ts"],
-  "sourcesContent": [
-    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type BetterSqlite3 from \"better-sqlite3\";\n\nimport type { SqliteApi } from \"./canonical-api\";\n\nexport type { SqliteApi };\n\ntype BetterDatabase = InstanceType<typeof BetterSqlite3>;\n\nlet BetterCtor: typeof BetterSqlite3 | undefined;\nlet initPromise: Promise<void> | undefined;\n\nfunction assertLoaded(): typeof BetterSqlite3 {\n  if (!BetterCtor) {\n    throw new Error(\"SQLite is not ready. Await Sqlite.init() before using new Sqlite.Database().\");\n  }\n  return BetterCtor;\n}\n\n/**\n * Loads better-sqlite3 via dynamic import. Idempotent; concurrent callers share one load.\n */\nfunction initSqlite(): Promise<void> {\n  return (initPromise ??= (async () => {\n    if (BetterCtor) {\n      return;\n    }\n    try {\n      const mod = await import(\"better-sqlite3\");\n      BetterCtor =\n        (mod as { default?: typeof BetterSqlite3 }).default ??\n        (mod as unknown as typeof BetterSqlite3);\n    } catch {\n      throw new Error(\n        \"better-sqlite3 is required for @workglow/storage/sqlite on Node.js. Install it with: bun add better-sqlite3\"\n      );\n    }\n  })());\n}\n\n/**\n * better-sqlite3 database wrapped as {@link SqliteApi.Database} (bindings-first `prepare`\n * generics). Construct only after {@link Sqlite.init}.\n */\nexport class NodeSqliteDatabase implements SqliteApi.Database {\n  readonly #inner: BetterDatabase;\n\n  constructor(filename?: string, options?: BetterSqlite3.Options) {\n    const Ctor = assertLoaded();\n    this.#inner = new Ctor(filename ?? \":memory:\", options);\n  }\n\n  exec(sql: string): void {\n    this.#inner.exec(sql);\n  }\n\n  prepare<BindParameters extends unknown[] | Record<string, unknown> = unknown[], Result = unknown>(\n    sql: string\n  ): SqliteApi.Statement<BindParameters, Result> {\n    return this.#inner.prepare(sql) as unknown as SqliteApi.Statement<BindParameters, Result>;\n  }\n\n  transaction<T extends unknown[]>(fn: (...args: T) => void): (...args: T) => void {\n    const tx = this.#inner.transaction(fn);\n    return (...args: T) => {\n      tx(...args);\n    };\n  }\n\n  close(): void {\n    this.#inner.close();\n  }\n\n  loadExtension(path: string, entryPoint?: string): void {\n    if (entryPoint === undefined) {\n      this.#inner.loadExtension(path);\n    } else {\n      (this.#inner as unknown as { loadExtension(p: string, e?: string): void }).loadExtension(\n        path,\n        entryPoint\n      );\n    }\n  }\n}\n\nexport const Sqlite = {\n  init: initSqlite,\n  Database: NodeSqliteDatabase,\n} as const;\n\n/** Merged with {@link Sqlite} so `Sqlite.Database` works in type positions (not only as a value). */\nexport namespace Sqlite {\n  export type Database = NodeSqliteDatabase;\n}\n"
-  ],
-  "mappings": ";;;;AAcA,IAAI;AACJ,IAAI;AAEJ,SAAS,YAAY,GAAyB;AAAA,EAC5C,IAAI,CAAC,YAAY;AAAA,IACf,MAAM,IAAI,MAAM,8EAA8E;AAAA,EAChG;AAAA,EACA,OAAO;AAAA;AAMT,SAAS,UAAU,GAAkB;AAAA,EACnC,OAAQ,iBAAiB,YAAY;AAAA,IACnC,IAAI,YAAY;AAAA,MACd;AAAA,IACF;AAAA,IACA,IAAI;AAAA,MACF,MAAM,MAAM,MAAa;AAAA,MACzB,aACG,IAA2C,WAC3C;AAAA,MACH,MAAM;AAAA,MACN,MAAM,IAAI,MACR,6GACF;AAAA;AAAA,KAED;AAAA;AAAA;AAOE,MAAM,mBAAiD;AAAA,EACnD;AAAA,EAET,WAAW,CAAC,UAAmB,SAAiC;AAAA,IAC9D,MAAM,OAAO,aAAa;AAAA,IAC1B,KAAK,SAAS,IAAI,KAAK,YAAY,YAAY,OAAO;AAAA;AAAA,EAGxD,IAAI,CAAC,KAAmB;AAAA,IACtB,KAAK,OAAO,KAAK,GAAG;AAAA;AAAA,EAGtB,OAAiG,CAC/F,KAC6C;AAAA,IAC7C,OAAO,KAAK,OAAO,QAAQ,GAAG;AAAA;AAAA,EAGhC,WAAgC,CAAC,IAAgD;AAAA,IAC/E,MAAM,KAAK,KAAK,OAAO,YAAY,EAAE;AAAA,IACrC,OAAO,IAAI,SAAY;AAAA,MACrB,GAAG,GAAG,IAAI;AAAA;AAAA;AAAA,EAId,KAAK,GAAS;AAAA,IACZ,KAAK,OAAO,MAAM;AAAA;AAAA,EAGpB,aAAa,CAAC,MAAc,YAA2B;AAAA,IACrD,IAAI,eAAe,WAAW;AAAA,MAC5B,KAAK,OAAO,cAAc,IAAI;AAAA,IAChC,EAAO;AAAA,MACJ,KAAK,OAAqE,cACzE,MACA,UACF;AAAA;AAAA;AAGN;AAEO,IAAM,SAAS;AAAA,EACpB,MAAM;AAAA,EACN,UAAU;AACZ;",
-  "debugId": "0C6C96D699E34FE664756E2164756E21",
-  "names": []
-}

package/dist/tabular/IndexedDbTabularStorage.d.ts

@@ -1,199 +0,0 @@
-/**
- * @license
- * Copyright 2025 Steven Roussey <sroussey@gmail.com>
- * SPDX-License-Identifier: Apache-2.0
- */
-import { DataPortSchemaObject, FromSchema, TypedArraySchemaOptions } from "@workglow/util/schema";
-import { MigrationOptions } from "../util/IndexedDbTable";
-import { BaseTabularStorage, ClientProvidedKeysOption, KeyGenerationStrategy } from "./BaseTabularStorage";
-import { AnyTabularStorage, AutoGeneratedKeys, CoveringIndexQueryOptions, DeleteSearchCriteria, InsertEntity, QueryOptions, SearchCriteria, SimplifyPrimaryKey, TabularChangePayload, TabularSubscribeOptions } from "./ITabularStorage";
-export declare const IDB_TABULAR_REPOSITORY: import("@workglow/util").ServiceToken<AnyTabularStorage>;
-/**
- * A tabular repository implementation using IndexedDB for browser-based storage.
- *
- * @template Schema - The schema definition for the entity
- * @template PrimaryKeyNames - Array of property names that form the primary key
- */
-export declare class IndexedDbTabularStorage<Schema extends DataPortSchemaObject, PrimaryKeyNames extends ReadonlyArray<keyof Schema["properties"]>, Entity = FromSchema<Schema, TypedArraySchemaOptions>, PrimaryKey = SimplifyPrimaryKey<Entity, PrimaryKeyNames>, Value = Omit<Entity, PrimaryKeyNames[number] & keyof Entity>, InsertType extends InsertEntity<Entity, AutoGeneratedKeys<Schema>> = InsertEntity<Entity, AutoGeneratedKeys<Schema>>> extends BaseTabularStorage<Schema, PrimaryKeyNames, Entity, PrimaryKey, Value, InsertType> {
-    table: string;
-    /** Promise that resolves to the IndexedDB database instance */
-    private db;
-    /** Promise to track ongoing database setup to prevent concurrent setup calls */
-    private setupPromise;
-    /** Migration options for database schema changes */
-    private migrationOptions;
-    /** Shared hybrid subscription manager */
-    private hybridManager;
-    /** Hybrid subscription options */
-    private readonly hybridOptions;
-    /**
-     * Indexes safe for cursor-based narrowing. An IDB index excludes records
-     * whose keyPath has any undefined component, so iterating an index can miss
-     * records when an indexed column is optional in the schema. Native
-     * `count(range)` and cursor scans are only correct over indexes whose every
-     * column is required. Computed lazily on first use.
-     */
-    private cursorSafeIndexes;
-    /**
-     * Creates a new IndexedDB-based tabular repository.
-     * @param table - Name of the IndexedDB store to use.
-     * @param schema - Schema defining the structure of the entity
-     * @param primaryKeyNames - Array of property names that form the primary key
-     * @param indexes - Array of columns or column arrays to make searchable. Each string or single column creates a single-column index,
-     *                    while each array creates a compound index with columns in the specified order.
-     * @param migrationOptions - Options for handling database schema migrations
-     * @param clientProvidedKeys - How to handle client-provided values for auto-generated keys
-     */
-    constructor(table: string | undefined, schema: Schema, primaryKeyNames: PrimaryKeyNames, indexes?: readonly (keyof NoInfer<Entity> | readonly (keyof NoInfer<Entity>)[])[], migrationOptions?: MigrationOptions & {
-        readonly useBroadcastChannel?: boolean;
-        readonly backupPollingIntervalMs?: number;
-    }, clientProvidedKeys?: ClientProvidedKeysOption);
-    private getDb;
-    /**
-     * Sets up the IndexedDB database table with the required schema and indexes.
-     * Must be called before using any other methods.
-     */
-    setupDatabase(): Promise<void>;
-    private performSetup;
-    /**
-     * Generates a key value for UUID keys
-     * Integer autoincrement keys are handled by IndexedDB's autoIncrement
-     * @param columnName - Name of the column to generate a key for
-     * @param strategy - The generation strategy to use
-     * @returns The generated key value
-     */
-    protected generateKeyValue(columnName: string, strategy: KeyGenerationStrategy): string | number;
-    /**
-     * Stores a row in the repository.
-     * @param record - The entity to store (may be missing auto-generated keys).
-     * @returns The stored entity
-     * @emits put - Emitted when the value is successfully stored
-     */
-    put(record: InsertType): Promise<Entity>;
-    /**
-     * Stores multiple rows in the repository in a bulk operation.
-     * @param records - Array of entities to store (may be missing auto-generated keys).
-     * @returns Array of stored entities
-     * @emits put - Emitted for each record successfully stored
-     */
-    putBulk(records: InsertType[]): Promise<Entity[]>;
-    protected getPrimaryKeyAsOrderedArray(key: PrimaryKey): (string | number | boolean | Uint8Array<ArrayBufferLike> | null)[];
-    private getIndexedKey;
-    /**
-     * Retrieves a value from the repository by its key.
-     * @param key - The key object.
-     * @returns The value object or undefined if not found.
-     * @emits get - Emitted when the value is successfully retrieved
-     */
-    get(key: PrimaryKey): Promise<Entity | undefined>;
-    /**
-     * Returns an array of all entries in the repository, with optional ordering, offset, and limit.
-     * @param options - Optional ordering, limit, and offset options
-     * @returns Array of all entries in the repository.
-     */
-    getAll(options?: QueryOptions<Entity>): Promise<Entity[] | undefined>;
-    /**
-     * Deletes a row from the repository.
-     * @param key - The key object to delete.
-     */
-    delete(key: PrimaryKey): Promise<void>;
-    /**
-     * Deletes all records from the repository.
-     * @emits clearall - Emitted when all values are deleted
-     */
-    deleteAll(): Promise<void>;
-    /**
-     * Returns the total number of rows in the repository.
-     * @returns Count of stored items.
-     */
-    size(): Promise<number>;
-    /**
-     * Returns the subset of configured indexes safe to use for cursor-based
-     * narrowing — those whose every column is required by the schema. IDB
-     * excludes records with undefined keyPath components from indexes, so
-     * iterating an index would silently miss records when any indexed column
-     * is optional.
-     */
-    private getCursorSafeIndexes;
-    /**
-     * Picks the best index to narrow a criteria-based scan, preferring indexes
-     * whose prefix covers every criteria column (so callers can use the native
-     * `count()` API) and falling back to the longest equality-prefix match.
-     *
-     * Upper bound uses `[]` as a sentinel that compares greater than any
-     * primitive value at the next index position (per IndexedDB key ordering:
-     * array > binary > string > date > number). Assumes subsequent indexed
-     * columns hold primitive values — array-valued columns would compare
-     * greater than `[]` and slip outside the range.
-     */
-    private createIndexedRange;
-    /**
-     * Counts rows matching the specified search criteria.
-     *
-     * Uses the native `count()` API when an index prefix covers every criteria
-     * column. Otherwise narrows via the longest matching index prefix and
-     * filters the remaining columns during cursor iteration. Falls back to a
-     * full store scan only when no index applies.
-     */
-    count(criteria?: SearchCriteria<Entity>): Promise<number>;
-    /**
-     * Fetches a page of records from the repository.
-     * @param offset - Number of records to skip
-     * @param limit - Maximum number of records to return
-     * @returns Array of entities or undefined if no records found
-     */
-    getBulk(offset: number, limit: number): Promise<Entity[] | undefined>;
-    /**
-     * Checks if a record matches all criteria conditions.
-     * @param record - The record to check
-     * @param criteria - The search criteria
-     * @returns true if all conditions match
-     */
-    private matchesCriteria;
-    /**
-     * Deletes all entries matching the specified search criteria.
-     * Supports multiple columns with optional comparison operators.
-     *
-     * @param criteria - Object with column names as keys and values or SearchConditions
-     */
-    deleteSearch(criteria: DeleteSearchCriteria<Entity>): Promise<void>;
-    private getEqualityCriterionValue;
-    private compareByOrder;
-    private createIndexedQuery;
-    /**
-     * Queries entries matching the specified search criteria with optional ordering, limit, and offset.
-     *
-     * @param criteria - Object with column names as keys and values or SearchConditions
-     * @param options - Optional ordering, limit, and offset options
-     * @returns Array of matching entities or undefined if no matches found
-     */
-    query(criteria: SearchCriteria<Entity>, options?: QueryOptions<Entity>): Promise<Entity[] | undefined>;
-    /**
-     * Strict, projected query served entirely by a covering compound index.
-     * Uses `openKeyCursor` — never reads `cursor.value` — so only the index key
-     * bytes are loaded into memory. Ideal for tables with large value blobs.
-     *
-     * Throws {@link CoveringIndexMissingError} when no registered index can serve
-     * the request (i.e. the index does not cover all select + orderBy columns).
-     */
-    queryIndex<K extends keyof Entity & string>(criteria: SearchCriteria<Entity>, options: CoveringIndexQueryOptions<Entity, K>): Promise<Pick<Entity, K>[]>;
-    /**
-     * Gets or creates the shared hybrid subscription manager.
-     * This ensures all subscriptions share a single manager.
-     */
-    private getHybridManager;
-    /**
-     * Subscribes to changes in the repository.
-     * Uses polling since IndexedDB has no native cross-tab change notifications.
-     *
-     * @param callback - Function called when a change occurs
-     * @param options - Optional subscription options including polling interval
-     * @returns Unsubscribe function
-     */
-    subscribeToChanges(callback: (change: TabularChangePayload<Entity>) => void, options?: TabularSubscribeOptions): () => void;
-    /**
-     * Destroys this repository and frees up resources.
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=IndexedDbTabularStorage.d.ts.map

package/dist/tabular/IndexedDbTabularStorage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IndexedDbTabularStorage.d.ts","sourceRoot":"","sources":["../../src/tabular/IndexedDbTabularStorage.ts"],"names":[],"mappings":"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"}