@workglow/storage 0.0.124 → 0.0.126

package/README.md

@@ -142,6 +142,10 @@ The package uses conditional exports, so importing from `@workglow/storage` auto
 import { InMemoryKvStorage, SqliteTabularStorage } from "@workglow/storage";
 ```
 
+### SQLite setup (`@workglow/storage/sqlite`)
+
+Before you open SQLite with a **file path** or construct **`new Sqlite.Database(...)`**, call **`await Sqlite.init()`** once per runtime (Node.js, Bun, or browser). Export is available from **`workglow`** and **`@workglow/storage/sqlite`**. The call is idempotent. On the browser it loads the SQLite WASM build; on Node.js it loads `better-sqlite3`; on Bun it resolves `bun:sqlite`.
+
 ## Storage Types
 
 ### Key-Value Storage
@@ -171,12 +175,15 @@ const browserStore = new IndexedDbKvRepository("my-app-storage");
 
 // Node.js/Bun (using SQLite)
 import { SqliteKvRepository } from "@workglow/storage";
-// Pass a file path or a Database instance (see @workglow/sqlite)
+import { Sqlite } from "@workglow/storage/sqlite";
+
+await Sqlite.init();
+// Pass a file path or a Sqlite.Database instance (see @workglow/storage/sqlite)
 const sqliteStore = new SqliteKvRepository("./data.db", "config_table");
 
 // PostgreSQL (Node.js/Bun)
 import { PostgresKvRepository } from "@workglow/storage";
-import { Pool } from "pg";
+import type { Pool } from "@workglow/storage/postgres";
 const pool = new Pool({ connectionString: "postgresql://..." });
 const pgStore = new PostgresKvRepository(pool, "settings");
 
@@ -390,7 +397,9 @@ await userRepo.deleteSearch({
 ```typescript
 // SQLite (Node.js/Bun)
 import { SqliteTabularStorage } from "@workglow/storage";
+import { Sqlite } from "@workglow/storage/sqlite";
 
+await Sqlite.init();
 const sqliteUsers = new SqliteTabularStorage<typeof UserSchema, ["id"]>(
   "./users.db",
   "users",
@@ -401,7 +410,7 @@ const sqliteUsers = new SqliteTabularStorage<typeof UserSchema, ["id"]>(
 
 // PostgreSQL (Node.js/Bun)
 import { PostgresTabularStorage } from "@workglow/storage";
-import { Pool } from "pg";
+import type { Pool } from "@workglow/storage/postgres";
 
 const pool = new Pool({ connectionString: "postgresql://..." });
 const pgUsers = new PostgresTabularStorage<typeof UserSchema, ["id"]>(
@@ -554,11 +563,11 @@ import {
   PostgresQueueStorage,
   SupabaseTabularStorage,
 } from "@workglow/storage";
-
-import { Database } from "bun:sqlite";
+import { Sqlite } from "@workglow/storage/sqlite";
 import { createClient } from "@supabase/supabase-js";
 
-const db = new Database("./app.db");
+await Sqlite.init();
+const db = new Sqlite.Database("./app.db");
 const data = new SqliteTabularStorage(db, "items", ItemSchema, ["id"]);
 
 // Or use Supabase for cloud storage

package/dist/browser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./common";
+export * from "./tabular/IndexedDbTabularStorage";
+export * from "./tabular/SharedInMemoryTabularStorage";
+export * from "./tabular/SupabaseTabularStorage";
+export * from "./kv/IndexedDbKvStorage";
+export * from "./kv/SupabaseKvStorage";
+export * from "./queue/IndexedDbQueueStorage";
+export * from "./queue/SupabaseQueueStorage";
+export * from "./queue-limiter/IndexedDbRateLimiterStorage";
+export * from "./queue-limiter/SupabaseRateLimiterStorage";
+export * from "./vector/IndexedDbVectorStorage";
+export * from "./util/IndexedDbTable";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AAEzB,cAAc,mCAAmC,CAAC;AAClD,cAAc,wCAAwC,CAAC;AACvD,cAAc,kCAAkC,CAAC;AAEjD,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,6CAA6C,CAAC;AAC5D,cAAc,4CAA4C,CAAC;AAE3D,cAAc,iCAAiC,CAAC;AAEhD,cAAc,uBAAuB,CAAC"}

package/dist/{types.d.ts → bun.d.ts}

@@ -4,4 +4,4 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 export * from "./common-server";
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=bun.d.ts.map

package/dist/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../src/bun.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC"}

package/dist/bun.js

@@ -3108,10 +3108,9 @@ class PostgresTabularStorage extends BaseSqlTabularStorage {
   }
 }
 // src/tabular/SqliteTabularStorage.ts
-import { Sqlite } from "@workglow/sqlite";
+import { Sqlite } from "@workglow/storage/sqlite";
 import { createServiceToken as createServiceToken14, uuid4 as uuid44 } from "@workglow/util";
 var SQLITE_TABULAR_REPOSITORY = createServiceToken14("storage.tabularRepository.sqlite");
-var Database = Sqlite.Database;
 
 class SqliteTabularStorage extends BaseSqlTabularStorage {
   db;
@@ -3121,7 +3120,7 @@ class SqliteTabularStorage extends BaseSqlTabularStorage {
   constructor(dbOrPath, table = "tabular_store", schema, primaryKeyNames, indexes = [], clientProvidedKeys = "if-missing") {
     super(table, schema, primaryKeyNames, indexes, clientProvidedKeys);
     if (typeof dbOrPath === "string") {
-      this.db = new Database(dbOrPath);
+      this.db = new Sqlite.Database(dbOrPath);
     } else {
       this.db = dbOrPath;
     }
@@ -8259,4 +8258,4 @@ export {
   BaseTabularStorage
 };
 
-//# debugId=1B6C712B3A2F880E64756E2164756E21
+//# debugId=0AEFE15161887D3364756E2164756E21