@getplumb/core 0.1.6 → 0.4.0

package/dist/wasm-db.d.ts

@@ -1,14 +1,69 @@
 /**
- * WASM SQLite database wrapper.
- * Provides the WasmDb type for use across the codebase.
- * The @sqlite.org/sqlite-wasm oo1 API is used directly - this file only exports types.
+ * SQLite database wrapper using better-sqlite3.
+ *
+ * Replaces the previous @sqlite.org/sqlite-wasm implementation which cannot
+ * open real filesystem paths in a Node.js environment.
+ *
+ * Exposes a WasmDb-compatible interface so local-store.ts and schema.ts
+ * require no changes:
+ *   - db.exec(sql: string)
+ *   - db.exec({ sql, rowMode: 'object', returnValue: 'resultRows' }) → rows[]
+ *   - db.prepare(sql) → stmt with .bind([...]), .step(), .get(colOrObj), .finalize()
+ *   - db.selectValue(sql)
+ *   - db.close()
  */
-import type SqliteWasm from '@sqlite.org/sqlite-wasm';
-type Sqlite3Init = typeof SqliteWasm;
-export type WasmDb = InstanceType<Awaited<ReturnType<Sqlite3Init>>['oo1']['DB']>;
+import Database from 'better-sqlite3';
+type ExecOptions = {
+    sql: string;
+    rowMode?: 'object' | 'array';
+    returnValue?: 'resultRows';
+};
 /**
- * Open a WASM SQLite database.
- * @param path Absolute path to the database file
+ * Thin statement wrapper that adapts better-sqlite3's API to the wasm oo1 style
+ * used throughout local-store.ts, fact-search.ts, and raw-log-search.ts.
+ */
+declare class CompatStatement {
+    #private;
+    constructor(stmt: Database.Statement);
+    bind(params: unknown[]): void;
+    /**
+     * Execute the statement. For SELECT statements, caches all rows for get().
+     * For write statements (INSERT/UPDATE/DELETE/PRAGMA writes), runs immediately.
+     */
+    step(): boolean;
+    /**
+     * Get a value from the current row.
+     * - get(colIndex: number) → scalar at that column index
+     * - get({}) → plain object with column names as keys
+     */
+    get(colOrObj: number | Record<string, unknown>): unknown;
+    finalize(): void;
+}
+/**
+ * Thin database wrapper adapting better-sqlite3 to the wasm oo1 API surface
+ * used by local-store.ts and schema.ts.
+ */
+declare class CompatDb {
+    #private;
+    constructor(path: string);
+    /**
+     * Execute SQL.
+     * - exec(sql: string) — plain execution, no return value
+     * - exec({ sql, returnValue: 'resultRows' }) — returns array of row objects
+     */
+    exec(sqlOrOpts: string | ExecOptions): unknown[] | void;
+    prepare(sql: string): CompatStatement;
+    /**
+     * Execute a single-value query and return the first column of the first row.
+     */
+    selectValue(sql: string): unknown;
+    close(): void;
+}
+export type WasmDb = CompatDb;
+/**
+ * Open a SQLite database file.
+ * Creates the file if it doesn't exist.
+ * Returns a promise for API compatibility with the previous wasm implementation.
  */
 export declare function openDb(path: string): Promise<WasmDb>;
 export {};

package/dist/wasm-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-db.d.ts","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,KAAK,WAAW,GAAG,OAAO,UAAU,CAAC;AAarC,MAAM,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAEjF;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1D"}
+{"version":3,"file":"wasm-db.d.ts","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,cAAM,eAAe;;gBAOP,IAAI,EAAE,QAAQ,CAAC,SAAS;IAIpC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7B;;;OAGG;IACH,IAAI,IAAI,OAAO;IAqBf;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAgBxD,QAAQ,IAAI,IAAI;CAMjB;AAED;;;GAGG;AACH,cAAM,QAAQ;;gBAGA,IAAI,EAAE,MAAM;IAIxB;;;;OAIG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,EAAE,GAAG,IAAI;IAYvD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAKrC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKjC,KAAK,IAAI,IAAI;CAGd;AAED,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE9B;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D"}

package/dist/wasm-db.js

@@ -1,39 +1,132 @@
 /**
- * WASM SQLite database wrapper.
- * Provides the WasmDb type for use across the codebase.
- * The @sqlite.org/sqlite-wasm oo1 API is used directly - this file only exports types.
+ * SQLite database wrapper using better-sqlite3.
+ *
+ * Replaces the previous @sqlite.org/sqlite-wasm implementation which cannot
+ * open real filesystem paths in a Node.js environment.
+ *
+ * Exposes a WasmDb-compatible interface so local-store.ts and schema.ts
+ * require no changes:
+ *   - db.exec(sql: string)
+ *   - db.exec({ sql, rowMode: 'object', returnValue: 'resultRows' }) → rows[]
+ *   - db.prepare(sql) → stmt with .bind([...]), .step(), .get(colOrObj), .finalize()
+ *   - db.selectValue(sql)
+ *   - db.close()
  */
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-// Load sqlite3-node.mjs using require to bypass package.json exports restriction
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const require = createRequire(import.meta.url);
-// Find node_modules path by resolving the package directory
-// We need to use a file that IS exported (sqlite3.wasm) to find the package root
-const wasmFilePath = require.resolve('@sqlite.org/sqlite-wasm/sqlite3.wasm');
-// wasmFilePath = /node_modules/@sqlite.org/sqlite-wasm/sqlite-wasm/jswasm/sqlite3.wasm
-// Go up from jswasm/ to sqlite-wasm/ to package root (3 levels up)
-const packageDir = dirname(dirname(dirname(wasmFilePath)));
-const sqlite3NodePath = join(packageDir, 'sqlite-wasm', 'jswasm', 'sqlite3-node.mjs');
-// Global WASM module singleton (initialized once per process)
-let wasmModule = null;
-async function initWasmModule() {
-    if (!wasmModule) {
-        const { default: sqlite3Init } = await import(sqlite3NodePath);
-        wasmModule = await sqlite3Init();
-    }
-    return wasmModule;
+import Database from 'better-sqlite3';
+/**
+ * Thin statement wrapper that adapts better-sqlite3's API to the wasm oo1 style
+ * used throughout local-store.ts, fact-search.ts, and raw-log-search.ts.
+ */
+class CompatStatement {
+    #stmt;
+    #params = [];
+    #rows = null;
+    #rowIndex = 0;
+    #columnNames = [];
+    constructor(stmt) {
+        this.#stmt = stmt;
+    }
+    bind(params) {
+        this.#params = params;
+    }
+    /**
+     * Execute the statement. For SELECT statements, caches all rows for get().
+     * For write statements (INSERT/UPDATE/DELETE/PRAGMA writes), runs immediately.
+     */
+    step() {
+        if (this.#stmt.reader) {
+            // SELECT — cache all rows on first call
+            if (this.#rows === null) {
+                const raw = this.#stmt.raw(true).all(...this.#params);
+                this.#rows = raw;
+                this.#rowIndex = 0;
+                this.#columnNames = this.#stmt.columns().map((c) => c.name);
+            }
+            if (this.#rowIndex < this.#rows.length) {
+                this.#rowIndex++;
+                return true;
+            }
+            return false;
+        }
+        else {
+            // Write statement
+            this.#stmt.run(...this.#params);
+            return false;
+        }
+    }
+    /**
+     * Get a value from the current row.
+     * - get(colIndex: number) → scalar at that column index
+     * - get({}) → plain object with column names as keys
+     */
+    get(colOrObj) {
+        if (this.#rows === null || this.#rowIndex === 0)
+            return null;
+        const row = this.#rows[this.#rowIndex - 1];
+        if (row === undefined)
+            return null;
+        if (typeof colOrObj === 'number') {
+            return row[colOrObj];
+        }
+        // Object form — zip column names with row values
+        const obj = {};
+        for (let i = 0; i < this.#columnNames.length; i++) {
+            obj[this.#columnNames[i]] = row[i];
+        }
+        return obj;
+    }
+    finalize() {
+        // better-sqlite3 statements don't need explicit finalization
+        this.#rows = null;
+        this.#rowIndex = 0;
+        this.#params = [];
+    }
+}
+/**
+ * Thin database wrapper adapting better-sqlite3 to the wasm oo1 API surface
+ * used by local-store.ts and schema.ts.
+ */
+class CompatDb {
+    #db;
+    constructor(path) {
+        this.#db = new Database(path);
+    }
+    /**
+     * Execute SQL.
+     * - exec(sql: string) — plain execution, no return value
+     * - exec({ sql, returnValue: 'resultRows' }) — returns array of row objects
+     */
+    exec(sqlOrOpts) {
+        if (typeof sqlOrOpts === 'string') {
+            this.#db.exec(sqlOrOpts);
+            return;
+        }
+        // Object form — run as query and return rows
+        const { sql } = sqlOrOpts;
+        const rows = this.#db.prepare(sql).all();
+        return rows;
+    }
+    prepare(sql) {
+        const stmt = this.#db.prepare(sql);
+        return new CompatStatement(stmt);
+    }
+    /**
+     * Execute a single-value query and return the first column of the first row.
+     */
+    selectValue(sql) {
+        const row = this.#db.prepare(sql).raw(true).get();
+        return row ? row[0] : null;
+    }
+    close() {
+        this.#db.close();
+    }
 }
 /**
- * Open a WASM SQLite database.
- * @param path Absolute path to the database file
+ * Open a SQLite database file.
+ * Creates the file if it doesn't exist.
+ * Returns a promise for API compatibility with the previous wasm implementation.
  */
 export async function openDb(path) {
-    const sqlite3 = await initWasmModule();
-    // 'ct' flags: create if not exists, throw on error
-    const db = new sqlite3.oo1.DB(path, 'ct');
-    return db;
+    return new CompatDb(path);
 }
 //# sourceMappingURL=wasm-db.js.map

package/dist/wasm-db.js.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-db.js","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,iFAAiF;AACjF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,4DAA4D;AAC5D,iFAAiF;AACjF,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;AAC7E,uFAAuF;AACvF,mEAAmE;AACnE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AAMtF,8DAA8D;AAC9D,IAAI,UAAU,GAA4C,IAAI,CAAC;AAE/D,KAAK,UAAU,cAAc;IAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAA6B,CAAC;QAC3F,UAAU,GAAG,MAAM,WAAW,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAID;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,MAAM,cAAc,EAAE,CAAC;IACvC,mDAAmD;IACnD,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"wasm-db.js","sourceRoot":"","sources":["../src/wasm-db.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,15 @@
 {
   "name": "@getplumb/core",
-  "version": "0.1.6",
+  "version": "0.4.0",
   "description": "Plumb memory engine — storage abstraction, types, and local SQLite driver",
   "license": "MIT",
+  "author": "Clay Waters <hello@plumb.run>",
+  "homepage": "https://plumb.run",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getplumb/plumb",
+    "directory": "packages/core"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -14,6 +21,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -25,14 +35,16 @@
     "test": "node --import tsx/esm --test src/**/*.test.ts",
     "lint": "echo \"No lint yet\" && exit 0",
     "clean": "rm -rf dist *.tsbuildinfo",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "pnpm build"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "tsx": "^4.0.0",
     "typescript": "^5.4.0"
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "3.47.2-build1",
+    "better-sqlite3": "^12.6.2",
     "openai": "^4.80.0"
   },
   "optionalDependencies": {