npm - @objectstack/driver-sqlite-wasm - Versions diffs - 7.5.0 → 7.6.0 - Mend

@objectstack/driver-sqlite-wasm 7.5.0 → 7.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -46,15 +46,53 @@ declare class WasmSqliteConnection {
     private dirty;
     private debounceMs;
     private debounceTimer;
-    private pendingFlush;
+    private flushChain;
     private destroyed;
     private logger;
+    /**
+     * Whether a `BEGIN…COMMIT/ROLLBACK` transaction is currently open. Tracked
+     * because sql.js's {@link Database.export} closes and reopens the database
+     * (it has no in-place serialize), and closing a connection rolls back any
+     * open transaction. Flushing mid-transaction would therefore silently
+     * abort it, leaving the eventual `COMMIT` to fail with
+     * "cannot commit - no transaction is active". We defer the flush until the
+     * transaction fully closes. See {@link noteTransactionControl}.
+     */
+    private rootTxActive;
+    /** Open `SAVEPOINT` depth (nested transactions emitted by Knex). */
+    private savepointDepth;
+    /** A flush was requested while a transaction was open; run it on close. */
+    private flushDeferred;
+    /** True while any transaction (root or savepoint) is in flight. */
+    private get inTransaction();
     constructor(opts: WasmConnectionOptions);
     /** Open the underlying sql.js database, loading bytes from disk if any. */
     open(sqlJs?: SqlJsStatic, locateFile?: (file: string) => string): Promise<void>;
+    /**
+     * Update transaction state from a transaction-control statement and, when a
+     * transaction has just fully closed, run any flush that was deferred while
+     * it was open. Called by the Knex dialect for every `BEGIN` / `COMMIT` /
+     * `ROLLBACK` / `SAVEPOINT` / `RELEASE` statement.
+     *
+     * We bias toward "in transaction": an unrecognised form leaves the flag set,
+     * which at worst delays a flush (safe) rather than exporting mid-transaction
+     * (which would abort it).
+     */
+    noteTransactionControl(sql: string): void;
     /** Hint that a mutation just executed; schedule a flush if needed. */
     markDirty(method?: string): void;
-    /** Force a write of the current database state to disk. */
+    /**
+     * Force a write of the current database state to disk.
+     *
+     * Flushes are strictly serialized through a single promise chain: every call
+     * appends an export+write step that runs after all previously-queued steps.
+     * This matters because sql.js `export()` mutates the live connection (it
+     * closes and reopens the database), so two exports must never overlap — and
+     * because the returned promise must not resolve until the caller's own write
+     * has hit disk (deterministic for tests and for `close()`). Each step
+     * re-checks `dirty` at run time, so a no-op write collapses cheaply and a
+     * write that arrived mid-flush is captured by the next queued step.
+     */
     flush(): Promise<void>;
     /** Close the database, flushing any pending writes first. */
     close(): Promise<void>;

package/dist/index.d.ts CHANGED Viewed

@@ -46,15 +46,53 @@ declare class WasmSqliteConnection {
     private dirty;
     private debounceMs;
     private debounceTimer;
-    private pendingFlush;
+    private flushChain;
     private destroyed;
     private logger;
+    /**
+     * Whether a `BEGIN…COMMIT/ROLLBACK` transaction is currently open. Tracked
+     * because sql.js's {@link Database.export} closes and reopens the database
+     * (it has no in-place serialize), and closing a connection rolls back any
+     * open transaction. Flushing mid-transaction would therefore silently
+     * abort it, leaving the eventual `COMMIT` to fail with
+     * "cannot commit - no transaction is active". We defer the flush until the
+     * transaction fully closes. See {@link noteTransactionControl}.
+     */
+    private rootTxActive;
+    /** Open `SAVEPOINT` depth (nested transactions emitted by Knex). */
+    private savepointDepth;
+    /** A flush was requested while a transaction was open; run it on close. */
+    private flushDeferred;
+    /** True while any transaction (root or savepoint) is in flight. */
+    private get inTransaction();
     constructor(opts: WasmConnectionOptions);
     /** Open the underlying sql.js database, loading bytes from disk if any. */
     open(sqlJs?: SqlJsStatic, locateFile?: (file: string) => string): Promise<void>;
+    /**
+     * Update transaction state from a transaction-control statement and, when a
+     * transaction has just fully closed, run any flush that was deferred while
+     * it was open. Called by the Knex dialect for every `BEGIN` / `COMMIT` /
+     * `ROLLBACK` / `SAVEPOINT` / `RELEASE` statement.
+     *
+     * We bias toward "in transaction": an unrecognised form leaves the flag set,
+     * which at worst delays a flush (safe) rather than exporting mid-transaction
+     * (which would abort it).
+     */
+    noteTransactionControl(sql: string): void;
     /** Hint that a mutation just executed; schedule a flush if needed. */
     markDirty(method?: string): void;
-    /** Force a write of the current database state to disk. */
+    /**
+     * Force a write of the current database state to disk.
+     *
+     * Flushes are strictly serialized through a single promise chain: every call
+     * appends an export+write step that runs after all previously-queued steps.
+     * This matters because sql.js `export()` mutates the live connection (it
+     * closes and reopens the database), so two exports must never overlap — and
+     * because the returned promise must not resolve until the caller's own write
+     * has hit disk (deterministic for tests and for `close()`). Each step
+     * re-checks `dirty` at run time, so a no-op write collapses cheaply and a
+     * write that arrived mid-flush is captured by the next queued step.
+     */
     flush(): Promise<void>;
     /** Close the database, flushing any pending writes first. */
     close(): Promise<void>;

package/dist/index.js CHANGED Viewed

@@ -89,8 +89,22 @@ var WasmSqliteConnection = class {
     this.dirty = false;
     this.debounceMs = 0;
     this.debounceTimer = null;
-    this.pendingFlush = null;
+    this.flushChain = null;
     this.destroyed = false;
+    /**
+     * Whether a `BEGIN…COMMIT/ROLLBACK` transaction is currently open. Tracked
+     * because sql.js's {@link Database.export} closes and reopens the database
+     * (it has no in-place serialize), and closing a connection rolls back any
+     * open transaction. Flushing mid-transaction would therefore silently
+     * abort it, leaving the eventual `COMMIT` to fail with
+     * "cannot commit - no transaction is active". We defer the flush until the
+     * transaction fully closes. See {@link noteTransactionControl}.
+     */
+    this.rootTxActive = false;
+    /** Open `SAVEPOINT` depth (nested transactions emitted by Knex). */
+    this.savepointDepth = 0;
+    /** A flush was requested while a transaction was open; run it on close. */
+    this.flushDeferred = false;
     this.filename = opts.filename;
     this.persist = opts.persist ?? "on-disconnect";
     this.isEphemeral = this.filename === ":memory:" || this.filename.startsWith(":");
@@ -100,6 +114,10 @@ var WasmSqliteConnection = class {
       this.debounceMs = Number.isFinite(ms) && ms > 0 ? ms : 250;
     }
   }
+  /** True while any transaction (root or savepoint) is in flight. */
+  get inTransaction() {
+    return this.rootTxActive || this.savepointDepth > 0;
+  }
   /** Open the underlying sql.js database, loading bytes from disk if any. */
   async open(sqlJs, locateFile) {
     const SQL = sqlJs ?? await loadSqlJs(locateFile);
@@ -129,6 +147,37 @@ var WasmSqliteConnection = class {
     }
     this.db = bytes ? new SQL.Database(bytes) : new SQL.Database();
   }
+  /**
+   * Update transaction state from a transaction-control statement and, when a
+   * transaction has just fully closed, run any flush that was deferred while
+   * it was open. Called by the Knex dialect for every `BEGIN` / `COMMIT` /
+   * `ROLLBACK` / `SAVEPOINT` / `RELEASE` statement.
+   *
+   * We bias toward "in transaction": an unrecognised form leaves the flag set,
+   * which at worst delays a flush (safe) rather than exporting mid-transaction
+   * (which would abort it).
+   */
+  noteTransactionControl(sql) {
+    const s = sql.trim().toUpperCase();
+    if (/^BEGIN\b/.test(s)) {
+      this.rootTxActive = true;
+    } else if (/^(COMMIT|END)\b/.test(s)) {
+      this.rootTxActive = false;
+      this.savepointDepth = 0;
+    } else if (/^ROLLBACK\s+TO\b/.test(s)) {
+    } else if (/^ROLLBACK\b/.test(s)) {
+      this.rootTxActive = false;
+      this.savepointDepth = 0;
+    } else if (/^SAVEPOINT\b/.test(s)) {
+      this.savepointDepth += 1;
+    } else if (/^RELEASE\b/.test(s)) {
+      this.savepointDepth = Math.max(0, this.savepointDepth - 1);
+    }
+    if (!this.inTransaction && this.flushDeferred) {
+      this.flushDeferred = false;
+      void this.flush();
+    }
+  }
   /** Hint that a mutation just executed; schedule a flush if needed. */
   markDirty(method) {
     if (this.isEphemeral || !this.fs) return;
@@ -146,30 +195,39 @@ var WasmSqliteConnection = class {
       }, this.debounceMs);
     }
   }
-  /** Force a write of the current database state to disk. */
+  /**
+   * Force a write of the current database state to disk.
+   *
+   * Flushes are strictly serialized through a single promise chain: every call
+   * appends an export+write step that runs after all previously-queued steps.
+   * This matters because sql.js `export()` mutates the live connection (it
+   * closes and reopens the database), so two exports must never overlap — and
+   * because the returned promise must not resolve until the caller's own write
+   * has hit disk (deterministic for tests and for `close()`). Each step
+   * re-checks `dirty` at run time, so a no-op write collapses cheaply and a
+   * write that arrived mid-flush is captured by the next queued step.
+   */
   async flush() {
     if (this.isEphemeral || !this.fs || this.destroyed) return;
-    if (this.pendingFlush) {
-      await this.pendingFlush;
-      if (!this.dirty || this.destroyed) return;
+    if (this.inTransaction) {
+      this.flushDeferred = true;
+      return;
     }
-    if (!this.dirty) return;
-    this.pendingFlush = (async () => {
+    const prev = this.flushChain;
+    const step = (prev ?? Promise.resolve()).then(async () => {
+      if (!this.dirty || this.destroyed || this.inTransaction) return;
+      this.dirty = false;
       try {
-        this.dirty = false;
         const exported = this.db.export();
         await this.fs.writeFile(this.filename, Buffer.from(exported));
       } catch (err) {
         this.dirty = true;
         throw err;
-      } finally {
-        this.pendingFlush = null;
       }
-    })();
-    await this.pendingFlush;
-    if (this.dirty && !this.destroyed) {
-      await this.flush();
-    }
+    });
+    this.flushChain = step.catch(() => {
+    });
+    await step;
   }
   /** Close the database, flushing any pending writes first. */
   async close() {
@@ -178,6 +236,8 @@ var WasmSqliteConnection = class {
       clearTimeout(this.debounceTimer);
       this.debounceTimer = null;
     }
+    this.rootTxActive = false;
+    this.savepointDepth = 0;
     try {
       await this.flush();
     } finally {
@@ -263,7 +323,11 @@ function getClient_WasmSqlite() {
       if (isDdl) {
         db.run(obj.sql, bindings);
         obj.response = [];
-        connection.markDirty("run");
+        if (/^\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\b/i.test(obj.sql)) {
+          connection.noteTransactionControl(obj.sql);
+        } else {
+          connection.markDirty("run");
+        }
         return obj;
       }
       if (isReadMethod(obj.method, obj.returning) || /^\s*PRAGMA\b/i.test(obj.sql)) {

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/sqlite-wasm-driver.ts","../src/knex-wasm-dialect.ts","../src/wasm-connection.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { SqliteWasmDriver } from './sqlite-wasm-driver.js';\n\nexport { SqliteWasmDriver };\nexport type { SqliteWasmDriverConfig } from './sqlite-wasm-driver.js';\nexport { Client_WasmSqlite } from './knex-wasm-dialect.js';\nexport type { WasmSqliteConnectionSettings } from './knex-wasm-dialect.js';\nexport { WasmSqliteConnection } from './wasm-connection.js';\nexport type { PersistMode, WasmConnectionOptions } from './wasm-connection.js';\n\nexport default {\n id: 'com.objectstack.driver.sqlite-wasm',\n version: '1.0.0',\n\n onEnable: async (context: any) => {\n const { logger, config, drivers } = context;\n logger?.info?.('[SQLite-WASM Driver] Initializing...');\n\n if (drivers) {\n const driver = new SqliteWasmDriver(config);\n drivers.register(driver);\n logger?.info?.(`[SQLite-WASM Driver] Registered driver: ${driver.name}`);\n } else {\n logger?.warn?.('[SQLite-WASM Driver] No driver registry found in context.');\n }\n },\n};\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/*\n SQLite-on-WASM driver for ObjectStack.\n \n Extends {@link SqlDriver} so all CRUD / schema / introspection / multi-tenant\n * logic is inherited as-is. Only the Knex transport is swapped to a custom\n * dialect ({@link Client_WasmSqlite}) backed by sql.js + Node `fs` persistence,\n * which lets the same `SqlDriver` codepath run inside StackBlitz WebContainer\n * (Node-in-browser) without the native `better-sqlite3` N-API binding.\n /\n\nimport type { SqlJsStatic } from 'sql.js';\nimport { SqlDriver, type SqlDriverConfig } from '@objectstack/driver-sql';\n\nimport { getClient_WasmSqlite } from './knex-wasm-dialect.js';\nimport type {\n PersistMode,\n WasmConnectionOptions,\n} from './wasm-connection.js';\n\n/* Public configuration for {@link SqliteWasmDriver}. /\nexport interface SqliteWasmDriverConfig {\n /\n SQLite filename. Use `:memory:` for an ephemeral database that is never\n * persisted. Any other value is treated as a Node `fs` path and the\n * sql.js database bytes are flushed back to disk according to {@link persist}.\n /\n filename: string;\n\n /\n Persistence strategy. Default: `'on-disconnect'`.\n \n - `'on-disconnect'` — flush once when the driver disconnects (and on\n * `process.beforeExit`).\n * - `'on-write'` — flush after every mutation. Safest, slowest.\n * - `` `debounced:${ms}` `` — debounce flushes by N milliseconds. Good\n * balance under bursty writes.\n /\n persist?: PersistMode;\n\n /* Pre-loaded sql.js module — skips lazy import. /\n sqlJs?: SqlJsStatic;\n\n /\n Override for sql.js's `locateFile`. Defaults to resolving the `.wasm`\n * file inside the installed `sql.js` package, which works in Node and\n * WebContainer.\n /\n locateFile?: (file: string) => string;\n\n /* Knex pool overrides. The dialect already defaults to `{ min: 1, max: 1 }`. /\n pool?: SqlDriverConfig['pool'];\n\n /* Optional logger. Defaults to `console`. /\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n SqlDriver subclass that runs Knex against sql.js (WASM SQLite).\n \n Behaves identically to the standard SQLite path — the dialect's\n * {@link Client_WasmSqlite._query} reports `lastID`/`changes` exactly the\n * way better-sqlite3 does, so {@link SqlDriver}'s SQL generation, returning\n * clauses, and schema introspection all keep working.\n /\nexport class SqliteWasmDriver extends SqlDriver {\n public override readonly name: string = 'com.objectstack.driver.sqlite-wasm';\n public override readonly version: string = '1.0.0';\n\n /\n Force the SQLite branch in {@link SqlDriver}. The base class detects\n * SQLite by string-matching `config.client`, but we pass the dialect class\n * directly so the string check would miss.\n /\n protected override get isSqlite(): boolean {\n return true;\n }\n\n private wasmConfig: SqliteWasmDriverConfig;\n private beforeExitHandler: (() => void) \| null = null;\n\n constructor(config: SqliteWasmDriverConfig) {\n const knexConfig = SqliteWasmDriver.toKnexConfig(config);\n super(knexConfig);\n this.wasmConfig = config;\n if (config.logger) this.logger = config.logger as any;\n }\n\n /* Translate the public config into a Knex config that uses our dialect. /\n static toKnexConfig(config: SqliteWasmDriverConfig): SqlDriverConfig {\n return {\n // Knex accepts a Client class as `client`. The dialect's `driverName`\n // is `'wasm-sqlite'` and its `dialect` is `'sqlite3'` so the SQLite\n // query compiler is reused.\n client: getClient_WasmSqlite() as any,\n connection: {\n filename: config.filename,\n persist: config.persist,\n sqlJs: config.sqlJs,\n locateFile: config.locateFile,\n logger: config.logger,\n } as any,\n // sql.js is single-threaded WASM — a single connection per pool keeps\n // semantics consistent with the upstream SQLite dialect.\n pool: config.pool ?? { min: 1, max: 1 },\n useNullAsDefault: true,\n } as SqlDriverConfig;\n }\n\n override async connect(): Promise<void> {\n await super.connect();\n\n // Best-effort flush on process exit so `on-disconnect` mode still saves\n // user data if the host process is shut down without explicit cleanup.\n if (\n this.wasmConfig.filename !== ':memory:' &&\n !this.wasmConfig.filename.startsWith(':') &&\n typeof process !== 'undefined' &&\n typeof process.once === 'function'\n ) {\n this.beforeExitHandler = () => {\n // Fire-and-forget — beforeExit cannot await.\n void this.flush().catch(() => {\n / ignore /\n });\n };\n process.once('beforeExit', this.beforeExitHandler);\n }\n }\n\n override async disconnect(): Promise<void> {\n if (this.beforeExitHandler && typeof process !== 'undefined') {\n try {\n process.removeListener('beforeExit', this.beforeExitHandler);\n } catch {\n / ignore /\n }\n this.beforeExitHandler = null;\n }\n await super.disconnect();\n }\n\n /\n Force a flush of the in-memory database to disk. No-op for ephemeral\n * databases or when no fs is available.\n /\n async flush(): Promise<void> {\n // Reach into the Knex pool and ask every live connection to flush.\n const knex = (this as any).knex;\n const client = knex?.client;\n const pool = client?.pool;\n if (!pool \|\| typeof pool.numUsed !== 'function') return;\n\n const acquire = client.acquireConnection?.bind(client);\n const release = client.releaseConnection?.bind(client);\n if (!acquire \|\| !release) return;\n\n const conn = await acquire();\n try {\n if (conn && typeof conn.flush === 'function') {\n await conn.flush();\n }\n } finally {\n await release(conn);\n }\n }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Custom Knex SQLite dialect backed by sql.js (WASM SQLite).\n \n Mimics the surface that `Client_BetterSQLite3` presents to Knex so the\n * upstream SQLite3 dialect's query compiler, schema builder, and column\n * compiler all keep working unchanged. Only the transport layer —\n * `_driver` / `acquireRawConnection` / `_query` — is swapped out.\n \n ## Why the dialect class is built lazily\n \n The class `Client_WasmSqlite extends Client_SQLite3` needs the upstream\n * SQLite3 dialect at class-definition time. Resolving it at module\n * top-level breaks when this file is re-bundled by another tsup/esbuild\n * pass (e.g. `packages/runtime`), because that pass rewrites our runtime\n * `createRequire(import.meta.url)` chain back into a static `__require2`\n * Proxy stub that throws `Dynamic require of \"X\" is not supported`.\n \n Building the class inside a lazy factory (`getClient_WasmSqlite()`)\n * keeps the `require` call out of module-init code, so the re-bundler\n * cannot intercept it.\n /\n\nimport { createRequire } from 'node:module';\n\nimport type { SqlJsStatic } from 'sql.js';\n\nimport {\n WasmSqliteConnection,\n type PersistMode,\n type WasmConnectionOptions,\n} from './wasm-connection.js';\n\n// Built lazily — `node:module` is a Node builtin and is left untouched\n// by esbuild/tsup, so the `createRequire` import survives downstream\n// re-bundling. We defer the actual `createRequire(...)` call so that the\n// CJS build (where `import.meta.url` is empty) doesn't blow up at module\n// init; the CJS path uses `globalThis.require` directly anyway.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedEsmRequire: any = null;\nfunction getEsmRequire(): any {\n if (cachedEsmRequire) return cachedEsmRequire;\n // `import.meta.url` is replaced with an empty string in CJS output;\n // fall back to the current file/cwd in that case.\n const anchor =\n typeof import.meta !== 'undefined' && (import.meta as any).url\n ? (import.meta as any).url\n : typeof __filename !== 'undefined'\n ? __filename\n : process.cwd() + '/';\n cachedEsmRequire = createRequire(anchor);\n return cachedEsmRequire;\n}\n\n/* Connection settings recognised by the WASM SQLite dialect. /\nexport interface WasmSqliteConnectionSettings {\n filename: string;\n persist?: PersistMode;\n sqlJs?: SqlJsStatic;\n locateFile?: (file: string) => string;\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n Coerce JS values that sql.js cannot bind directly. Mirrors\n * `Client_BetterSQLite3._formatBindings`.\n /\nfunction formatBindings(bindings: unknown[] \| undefined): unknown[] {\n if (!bindings) return [];\n return bindings.map((b) => {\n if (b instanceof Date) return b.valueOf();\n if (typeof b === 'boolean') return Number(b);\n return b;\n });\n}\n\n/\n Mirrors the dispatch in upstream `Client_SQLite3._query`: only\n * `insert/update/counter/del` go through the row-less write path (and even\n * those switch to the read path when a `RETURNING` clause is requested).\n * Everything else — `select`, `first`, `pluck`, `columnInfo`, raw PRAGMA,\n * DDL with no `method` — is read with `all`/row iteration so Knex sees the\n * same response shape it would from better-sqlite3.\n /\nfunction isReadMethod(method?: string, returning?: unknown): boolean {\n if (method === 'insert' \|\| method === 'update') return !!returning ? true : false;\n if (method === 'counter' \|\| method === 'del') return false;\n return true;\n}\n\n/\n Resolve the upstream `knex/lib/dialects/sqlite3` class at runtime.\n \n Tries every escape hatch we have so that this works in:\n * - Plain Node ESM (use `createRequire(import.meta.url)`).\n * - Plain Node CJS (use the ambient `require` on `globalThis`).\n * - Re-bundled ESM where esbuild/tsup has stubbed `__require` — we\n * fall back to `new Function('return require')()` which evades static\n * analysis and grabs the real Node `require` at runtime.\n \n Wrapped in a function so the bundler cannot execute it at module init.\n /\nfunction resolveKnexSqlite3Dialect(): any {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const g = globalThis as any;\n if (typeof g.require === 'function') {\n try {\n return g.require('knex/lib/dialects/sqlite3');\n } catch {\n / fall through /\n }\n }\n // ESM-safe path: `createRequire` was imported statically at the top of\n // this module from `node:module`. In a pure-ESM process there is no\n // ambient `require`, so this is the only reliable way to load a CJS\n // package like `knex/lib/dialects/sqlite3`.\n return getEsmRequire()('knex/lib/dialects/sqlite3');\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedDialect: any = null;\n\n/\n Build (and cache) the `Client_WasmSqlite` class. Building lazily keeps\n * the `require('knex/lib/dialects/sqlite3')` call out of module-init\n * code so downstream re-bundlers (e.g. `packages/runtime`) cannot collapse\n * it into a Dynamic-require stub.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getClient_WasmSqlite(): any {\n if (cachedDialect) return cachedDialect;\n const Client_SQLite3 = resolveKnexSqlite3Dialect();\n\n class Client_WasmSqlite extends Client_SQLite3 {\n // sql.js has no shared \"driver module\" the way better-sqlite3 does. Knex\n // only uses `this.driver` to construct connections, and we override\n // `acquireRawConnection`, so a sentinel object is enough.\n _driver(): { name: 'sql.js' } {\n return { name: 'sql.js' };\n }\n\n async acquireRawConnection(): Promise<WasmSqliteConnection> {\n const settings = (this as any)\n .connectionSettings as WasmSqliteConnectionSettings;\n\n const conn = new WasmSqliteConnection({\n filename: settings.filename,\n persist: settings.persist,\n sqlJs: settings.sqlJs,\n locateFile: settings.locateFile,\n logger: settings.logger,\n });\n await conn.open(settings.sqlJs, settings.locateFile);\n return conn;\n }\n\n async destroyRawConnection(connection: WasmSqliteConnection): Promise<void> {\n await connection.close();\n }\n\n async _query(\n connection: WasmSqliteConnection,\n obj: any,\n ): Promise<any> {\n if (!obj.sql) throw new Error('The query is empty');\n if (!connection) throw new Error('No connection provided');\n\n const db = connection.raw;\n const bindings = formatBindings(obj.bindings);\n\n // DDL / transactional control statements have no Knex `method`. sql.js's\n // `prepare`+`step` silently no-ops on many of these (e.g. CREATE TABLE),\n // so route them through `run` which is implemented via `exec` and\n // actually mutates the database. PRAGMA is intentionally excluded — many\n // PRAGMA forms (e.g. `PRAGMA table_info(...)`, `foreign_key_list(...)`)\n // return rows used by Knex's schema introspection/columnInfo, and\n // `db.run` discards those rows.\n const isDdl =\n /^\\s(CREATE\|ALTER\|DROP\|BEGIN\|COMMIT\|ROLLBACK\|SAVEPOINT\|RELEASE\|REINDEX\|VACUUM\|ATTACH\|DETACH\|TRUNCATE)\\b/i.test(\n obj.sql,\n );\n if (isDdl) {\n db.run(obj.sql, bindings as any);\n obj.response = [];\n connection.markDirty('run');\n return obj;\n }\n\n if (isReadMethod(obj.method, obj.returning) \|\| /^\\sPRAGMA\\b/i.test(obj.sql)) {\n const stmt = db.prepare(obj.sql);\n try {\n if (bindings.length) stmt.bind(bindings as any);\n const rows: Record<string, unknown>[] = [];\n while (stmt.step()) {\n rows.push(stmt.getAsObject());\n }\n obj.response = rows;\n } finally {\n stmt.free();\n }\n return obj;\n }\n\n // Write path: execute via `run` (no row iteration needed) and capture\n // SQLite's per-connection lastID / changes counters.\n db.run(obj.sql, bindings as any);\n const changes = db.getRowsModified();\n let lastID: number \| bigint = 0;\n if (obj.method === 'insert') {\n const r = db.exec('SELECT last_insert_rowid() AS id');\n lastID = (r?.[0]?.values?.[0]?.[0] as number) ?? 0;\n }\n obj.response = [];\n obj.context = { lastID, changes };\n connection.markDirty(obj.method);\n return obj;\n }\n }\n\n Object.assign(Client_WasmSqlite.prototype, {\n dialect: 'sqlite3',\n driverName: 'wasm-sqlite',\n });\n\n cachedDialect = Client_WasmSqlite;\n return Client_WasmSqlite;\n}\n\n/\n Back-compat re-export. Prefer `getClient_WasmSqlite()` so the dialect\n * is resolved lazily; the named export triggers the factory on first\n * access of any static property.\n \n Note: importing this binding will execute the factory at import time\n * in some bundlers, which defeats the lazy pattern. New code should call\n * `getClient_WasmSqlite()` directly.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const Client_WasmSqlite: any = new Proxy(function () {} as any, {\n get(_t, prop) {\n return (getClient_WasmSqlite() as any)[prop];\n },\n construct(_t, args) {\n const Klass = getClient_WasmSqlite();\n return new Klass(...args);\n },\n apply(_t, thisArg, args) {\n const Klass = getClient_WasmSqlite();\n return Reflect.apply(Klass, thisArg, args);\n },\n});\n\nexport default Client_WasmSqlite;\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Thin wrapper over sql.js {@link Database} that mimics the surface of\n * `better-sqlite3`'s `Database` (only the methods the Knex dialect uses).\n \n Persistence is handled here, not in the Knex dialect, so it can be\n * orchestrated per-connection without polluting the SQL execution path.\n /\n\nimport type { Database, SqlJsStatic } from 'sql.js';\n\n/* When to flush the in-memory WASM database to disk. /\nexport type PersistMode =\n \| 'on-disconnect'\n \| 'on-write'\n \| `debounced:${number}`;\n\nexport interface WasmConnectionOptions {\n /\n On-disk file path. `:memory:` (or any value starting with `:`) skips\n * persistence entirely and the database lives only for the process.\n /\n filename: string;\n /* When to persist. Default: `on-disconnect`. /\n persist?: PersistMode;\n /* Pre-loaded sql.js module. If omitted, loaded lazily on first connect. /\n sqlJs?: SqlJsStatic;\n /\n Optional override for the `.wasm` locator passed to `initSqlJs()`.\n * Defaults to resolving the file from the `sql.js` package on disk\n * (works in Node and WebContainer).\n /\n locateFile?: (file: string) => string;\n /* Optional logger; defaults to `console`. /\n logger?: { warn: (msg: string, meta?: unknown) => void };\n}\n\n/* Mutation method names that should trigger a persistence cycle. /\nconst WRITE_METHODS = new Set([\n 'run',\n 'insert',\n 'update',\n 'del',\n 'counter',\n]);\n\n/\n Detect whether a Node-style `fs` module is available. WebContainer\n * (StackBlitz) provides Node `fs`; pure-browser environments do not.\n /\nasync function tryLoadFs(): Promise<typeof import('node:fs/promises') \| null> {\n try {\n return await import('node:fs/promises');\n } catch {\n return null;\n }\n}\n\n/\n Resolve a default sql.js WASM locator. We point sql.js at the `.wasm`\n * file shipped inside `sql.js`'s own `dist/` folder. This avoids requiring\n * the caller to host the WASM separately.\n /\nasync function defaultLocateFile(): Promise<((file: string) => string) \| undefined> {\n try {\n const { createRequire } = await import('node:module');\n const require = createRequire(import.meta.url);\n const pkgJsonPath = require.resolve('sql.js/package.json');\n const { dirname, join } = await import('node:path');\n const dir = dirname(pkgJsonPath);\n return (file: string) => join(dir, 'dist', file);\n } catch {\n return undefined;\n }\n}\n\nlet cachedSqlJs: Promise<SqlJsStatic> \| null = null;\n\nasync function loadSqlJs(\n locateFile?: (file: string) => string,\n): Promise<SqlJsStatic> {\n if (cachedSqlJs) return cachedSqlJs;\n cachedSqlJs = (async () => {\n const mod = await import('sql.js');\n const initSqlJs = (mod as any).default ?? (mod as any);\n const locator = locateFile ?? (await defaultLocateFile());\n const SQL = await initSqlJs(locator ? { locateFile: locator } : undefined);\n return SQL as SqlJsStatic;\n })();\n return cachedSqlJs;\n}\n\n/\n A sql.js-backed connection that exposes the `prepare`/`exec`/`close`\n * subset used by Knex's SQLite dialect. Mutations are queued through a\n * configurable persistence strategy so the on-disk file stays in sync.\n /\nexport class WasmSqliteConnection {\n readonly filename: string;\n readonly persist: PersistMode;\n readonly isEphemeral: boolean;\n\n private db!: Database;\n private fs: typeof import('node:fs/promises') \| null = null;\n private dirty = false;\n private debounceMs = 0;\n private debounceTimer: ReturnType<typeof setTimeout> \| null = null;\n private pendingFlush: Promise<void> \| null = null;\n private destroyed = false;\n private logger: { warn: (msg: string, meta?: unknown) => void };\n\n constructor(opts: WasmConnectionOptions) {\n this.filename = opts.filename;\n this.persist = opts.persist ?? 'on-disconnect';\n this.isEphemeral =\n this.filename === ':memory:' \|\| this.filename.startsWith(':');\n this.logger = opts.logger ?? console;\n\n if (typeof this.persist === 'string' && this.persist.startsWith('debounced:')) {\n const ms = Number(this.persist.slice('debounced:'.length));\n this.debounceMs = Number.isFinite(ms) && ms > 0 ? ms : 250;\n }\n }\n\n /* Open the underlying sql.js database, loading bytes from disk if any. /\n async open(sqlJs?: SqlJsStatic, locateFile?: (file: string) => string): Promise<void> {\n const SQL = sqlJs ?? (await loadSqlJs(locateFile));\n\n if (this.isEphemeral) {\n this.db = new SQL.Database();\n return;\n }\n\n this.fs = await tryLoadFs();\n if (!this.fs) {\n this.logger.warn(\n '[driver-sqlite-wasm] No node:fs available — falling back to in-memory database. ' +\n 'Data will not be persisted across reloads.',\n );\n this.db = new SQL.Database();\n return;\n }\n\n // Ensure parent directory exists, then load bytes if the file exists.\n const { dirname } = await import('node:path');\n const dir = dirname(this.filename);\n if (dir && dir !== '.') {\n await this.fs.mkdir(dir, { recursive: true });\n }\n\n let bytes: Uint8Array \| undefined;\n try {\n const buf = await this.fs.readFile(this.filename);\n bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n } catch (e: any) {\n if (e?.code !== 'ENOENT') throw e;\n }\n\n this.db = bytes ? new SQL.Database(bytes) : new SQL.Database();\n }\n\n /* Hint that a mutation just executed; schedule a flush if needed. /\n markDirty(method?: string): void {\n if (this.isEphemeral \|\| !this.fs) return;\n if (method && !WRITE_METHODS.has(method)) return;\n this.dirty = true;\n\n if (this.persist === 'on-write') {\n void this.flush();\n return;\n }\n if (this.debounceMs > 0) {\n if (this.debounceTimer) clearTimeout(this.debounceTimer);\n this.debounceTimer = setTimeout(() => {\n this.debounceTimer = null;\n void this.flush();\n }, this.debounceMs);\n }\n // 'on-disconnect' → flush only at close()\n }\n\n /* Force a write of the current database state to disk. /\n async flush(): Promise<void> {\n if (this.isEphemeral \|\| !this.fs \|\| this.destroyed) return;\n // If a flush is already in flight, wait for it and then re-flush so any\n // writes that arrived after the in-flight flush's `db.export()` call get\n // persisted too. Without this, on-write mode loses writes that happen\n // between a flush's synchronous export and its async file write.\n if (this.pendingFlush) {\n await this.pendingFlush;\n if (!this.dirty \|\| this.destroyed) return;\n }\n if (!this.dirty) return;\n\n this.pendingFlush = (async () => {\n try {\n // Snapshot dirty=false BEFORE export so concurrent writes that occur\n // during the async writeFile mark us dirty again and trigger another\n // flush via markDirty.\n this.dirty = false;\n const exported = this.db.export();\n // sql.js returns a Uint8Array; Buffer.from on it shares memory but\n // works fine for writeFile.\n await this.fs!.writeFile(this.filename, Buffer.from(exported));\n } catch (err) {\n // Restore dirty state so a subsequent flush retries.\n this.dirty = true;\n throw err;\n } finally {\n this.pendingFlush = null;\n }\n })();\n\n await this.pendingFlush;\n\n // A write that arrived after `db.export()` (synchronous) but before the\n // file write completed will have set dirty=true again. Re-flush to\n // persist it.\n if (this.dirty && !this.destroyed) {\n await this.flush();\n }\n }\n\n /* Close the database, flushing any pending writes first. /\n async close(): Promise<void> {\n if (this.destroyed) return;\n if (this.debounceTimer) {\n clearTimeout(this.debounceTimer);\n this.debounceTimer = null;\n }\n try {\n await this.flush();\n } finally {\n this.destroyed = true;\n try {\n this.db.close();\n } catch {\n / ignore /\n }\n }\n }\n\n /* Access the raw sql.js database (for the Knex dialect). */\n get raw(): Database {\n return this.db;\n }\n}\n"],"mappings":"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","names":["createRequire","require","import_meta","Client_WasmSqlite"]}
1	+ {"version":3,"sources":["../src/index.ts","../src/sqlite-wasm-driver.ts","../src/knex-wasm-dialect.ts","../src/wasm-connection.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { SqliteWasmDriver } from './sqlite-wasm-driver.js';\n\nexport { SqliteWasmDriver };\nexport type { SqliteWasmDriverConfig } from './sqlite-wasm-driver.js';\nexport { Client_WasmSqlite } from './knex-wasm-dialect.js';\nexport type { WasmSqliteConnectionSettings } from './knex-wasm-dialect.js';\nexport { WasmSqliteConnection } from './wasm-connection.js';\nexport type { PersistMode, WasmConnectionOptions } from './wasm-connection.js';\n\nexport default {\n id: 'com.objectstack.driver.sqlite-wasm',\n version: '1.0.0',\n\n onEnable: async (context: any) => {\n const { logger, config, drivers } = context;\n logger?.info?.('[SQLite-WASM Driver] Initializing...');\n\n if (drivers) {\n const driver = new SqliteWasmDriver(config);\n drivers.register(driver);\n logger?.info?.(`[SQLite-WASM Driver] Registered driver: ${driver.name}`);\n } else {\n logger?.warn?.('[SQLite-WASM Driver] No driver registry found in context.');\n }\n },\n};\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/*\n SQLite-on-WASM driver for ObjectStack.\n \n Extends {@link SqlDriver} so all CRUD / schema / introspection / multi-tenant\n * logic is inherited as-is. Only the Knex transport is swapped to a custom\n * dialect ({@link Client_WasmSqlite}) backed by sql.js + Node `fs` persistence,\n * which lets the same `SqlDriver` codepath run inside StackBlitz WebContainer\n * (Node-in-browser) without the native `better-sqlite3` N-API binding.\n /\n\nimport type { SqlJsStatic } from 'sql.js';\nimport { SqlDriver, type SqlDriverConfig } from '@objectstack/driver-sql';\n\nimport { getClient_WasmSqlite } from './knex-wasm-dialect.js';\nimport type {\n PersistMode,\n WasmConnectionOptions,\n} from './wasm-connection.js';\n\n/* Public configuration for {@link SqliteWasmDriver}. /\nexport interface SqliteWasmDriverConfig {\n /\n SQLite filename. Use `:memory:` for an ephemeral database that is never\n * persisted. Any other value is treated as a Node `fs` path and the\n * sql.js database bytes are flushed back to disk according to {@link persist}.\n /\n filename: string;\n\n /\n Persistence strategy. Default: `'on-disconnect'`.\n \n - `'on-disconnect'` — flush once when the driver disconnects (and on\n * `process.beforeExit`).\n * - `'on-write'` — flush after every mutation. Safest, slowest.\n * - `` `debounced:${ms}` `` — debounce flushes by N milliseconds. Good\n * balance under bursty writes.\n /\n persist?: PersistMode;\n\n /* Pre-loaded sql.js module — skips lazy import. /\n sqlJs?: SqlJsStatic;\n\n /\n Override for sql.js's `locateFile`. Defaults to resolving the `.wasm`\n * file inside the installed `sql.js` package, which works in Node and\n * WebContainer.\n /\n locateFile?: (file: string) => string;\n\n /* Knex pool overrides. The dialect already defaults to `{ min: 1, max: 1 }`. /\n pool?: SqlDriverConfig['pool'];\n\n /* Optional logger. Defaults to `console`. /\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n SqlDriver subclass that runs Knex against sql.js (WASM SQLite).\n \n Behaves identically to the standard SQLite path — the dialect's\n * {@link Client_WasmSqlite._query} reports `lastID`/`changes` exactly the\n * way better-sqlite3 does, so {@link SqlDriver}'s SQL generation, returning\n * clauses, and schema introspection all keep working.\n /\nexport class SqliteWasmDriver extends SqlDriver {\n public override readonly name: string = 'com.objectstack.driver.sqlite-wasm';\n public override readonly version: string = '1.0.0';\n\n /\n Force the SQLite branch in {@link SqlDriver}. The base class detects\n * SQLite by string-matching `config.client`, but we pass the dialect class\n * directly so the string check would miss.\n /\n protected override get isSqlite(): boolean {\n return true;\n }\n\n private wasmConfig: SqliteWasmDriverConfig;\n private beforeExitHandler: (() => void) \| null = null;\n\n constructor(config: SqliteWasmDriverConfig) {\n const knexConfig = SqliteWasmDriver.toKnexConfig(config);\n super(knexConfig);\n this.wasmConfig = config;\n if (config.logger) this.logger = config.logger as any;\n }\n\n /* Translate the public config into a Knex config that uses our dialect. /\n static toKnexConfig(config: SqliteWasmDriverConfig): SqlDriverConfig {\n return {\n // Knex accepts a Client class as `client`. The dialect's `driverName`\n // is `'wasm-sqlite'` and its `dialect` is `'sqlite3'` so the SQLite\n // query compiler is reused.\n client: getClient_WasmSqlite() as any,\n connection: {\n filename: config.filename,\n persist: config.persist,\n sqlJs: config.sqlJs,\n locateFile: config.locateFile,\n logger: config.logger,\n } as any,\n // sql.js is single-threaded WASM — a single connection per pool keeps\n // semantics consistent with the upstream SQLite dialect.\n pool: config.pool ?? { min: 1, max: 1 },\n useNullAsDefault: true,\n } as SqlDriverConfig;\n }\n\n override async connect(): Promise<void> {\n await super.connect();\n\n // Best-effort flush on process exit so `on-disconnect` mode still saves\n // user data if the host process is shut down without explicit cleanup.\n if (\n this.wasmConfig.filename !== ':memory:' &&\n !this.wasmConfig.filename.startsWith(':') &&\n typeof process !== 'undefined' &&\n typeof process.once === 'function'\n ) {\n this.beforeExitHandler = () => {\n // Fire-and-forget — beforeExit cannot await.\n void this.flush().catch(() => {\n / ignore /\n });\n };\n process.once('beforeExit', this.beforeExitHandler);\n }\n }\n\n override async disconnect(): Promise<void> {\n if (this.beforeExitHandler && typeof process !== 'undefined') {\n try {\n process.removeListener('beforeExit', this.beforeExitHandler);\n } catch {\n / ignore /\n }\n this.beforeExitHandler = null;\n }\n await super.disconnect();\n }\n\n /\n Force a flush of the in-memory database to disk. No-op for ephemeral\n * databases or when no fs is available.\n /\n async flush(): Promise<void> {\n // Reach into the Knex pool and ask every live connection to flush.\n const knex = (this as any).knex;\n const client = knex?.client;\n const pool = client?.pool;\n if (!pool \|\| typeof pool.numUsed !== 'function') return;\n\n const acquire = client.acquireConnection?.bind(client);\n const release = client.releaseConnection?.bind(client);\n if (!acquire \|\| !release) return;\n\n const conn = await acquire();\n try {\n if (conn && typeof conn.flush === 'function') {\n await conn.flush();\n }\n } finally {\n await release(conn);\n }\n }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Custom Knex SQLite dialect backed by sql.js (WASM SQLite).\n \n Mimics the surface that `Client_BetterSQLite3` presents to Knex so the\n * upstream SQLite3 dialect's query compiler, schema builder, and column\n * compiler all keep working unchanged. Only the transport layer —\n * `_driver` / `acquireRawConnection` / `_query` — is swapped out.\n \n ## Why the dialect class is built lazily\n \n The class `Client_WasmSqlite extends Client_SQLite3` needs the upstream\n * SQLite3 dialect at class-definition time. Resolving it at module\n * top-level breaks when this file is re-bundled by another tsup/esbuild\n * pass (e.g. `packages/runtime`), because that pass rewrites our runtime\n * `createRequire(import.meta.url)` chain back into a static `__require2`\n * Proxy stub that throws `Dynamic require of \"X\" is not supported`.\n \n Building the class inside a lazy factory (`getClient_WasmSqlite()`)\n * keeps the `require` call out of module-init code, so the re-bundler\n * cannot intercept it.\n /\n\nimport { createRequire } from 'node:module';\n\nimport type { SqlJsStatic } from 'sql.js';\n\nimport {\n WasmSqliteConnection,\n type PersistMode,\n type WasmConnectionOptions,\n} from './wasm-connection.js';\n\n// Built lazily — `node:module` is a Node builtin and is left untouched\n// by esbuild/tsup, so the `createRequire` import survives downstream\n// re-bundling. We defer the actual `createRequire(...)` call so that the\n// CJS build (where `import.meta.url` is empty) doesn't blow up at module\n// init; the CJS path uses `globalThis.require` directly anyway.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedEsmRequire: any = null;\nfunction getEsmRequire(): any {\n if (cachedEsmRequire) return cachedEsmRequire;\n // `import.meta.url` is replaced with an empty string in CJS output;\n // fall back to the current file/cwd in that case.\n const anchor =\n typeof import.meta !== 'undefined' && (import.meta as any).url\n ? (import.meta as any).url\n : typeof __filename !== 'undefined'\n ? __filename\n : process.cwd() + '/';\n cachedEsmRequire = createRequire(anchor);\n return cachedEsmRequire;\n}\n\n/* Connection settings recognised by the WASM SQLite dialect. /\nexport interface WasmSqliteConnectionSettings {\n filename: string;\n persist?: PersistMode;\n sqlJs?: SqlJsStatic;\n locateFile?: (file: string) => string;\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n Coerce JS values that sql.js cannot bind directly. Mirrors\n * `Client_BetterSQLite3._formatBindings`.\n /\nfunction formatBindings(bindings: unknown[] \| undefined): unknown[] {\n if (!bindings) return [];\n return bindings.map((b) => {\n if (b instanceof Date) return b.valueOf();\n if (typeof b === 'boolean') return Number(b);\n return b;\n });\n}\n\n/\n Mirrors the dispatch in upstream `Client_SQLite3._query`: only\n * `insert/update/counter/del` go through the row-less write path (and even\n * those switch to the read path when a `RETURNING` clause is requested).\n * Everything else — `select`, `first`, `pluck`, `columnInfo`, raw PRAGMA,\n * DDL with no `method` — is read with `all`/row iteration so Knex sees the\n * same response shape it would from better-sqlite3.\n /\nfunction isReadMethod(method?: string, returning?: unknown): boolean {\n if (method === 'insert' \|\| method === 'update') return !!returning ? true : false;\n if (method === 'counter' \|\| method === 'del') return false;\n return true;\n}\n\n/\n Resolve the upstream `knex/lib/dialects/sqlite3` class at runtime.\n \n Tries every escape hatch we have so that this works in:\n * - Plain Node ESM (use `createRequire(import.meta.url)`).\n * - Plain Node CJS (use the ambient `require` on `globalThis`).\n * - Re-bundled ESM where esbuild/tsup has stubbed `__require` — we\n * fall back to `new Function('return require')()` which evades static\n * analysis and grabs the real Node `require` at runtime.\n \n Wrapped in a function so the bundler cannot execute it at module init.\n /\nfunction resolveKnexSqlite3Dialect(): any {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const g = globalThis as any;\n if (typeof g.require === 'function') {\n try {\n return g.require('knex/lib/dialects/sqlite3');\n } catch {\n / fall through /\n }\n }\n // ESM-safe path: `createRequire` was imported statically at the top of\n // this module from `node:module`. In a pure-ESM process there is no\n // ambient `require`, so this is the only reliable way to load a CJS\n // package like `knex/lib/dialects/sqlite3`.\n return getEsmRequire()('knex/lib/dialects/sqlite3');\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedDialect: any = null;\n\n/\n Build (and cache) the `Client_WasmSqlite` class. Building lazily keeps\n * the `require('knex/lib/dialects/sqlite3')` call out of module-init\n * code so downstream re-bundlers (e.g. `packages/runtime`) cannot collapse\n * it into a Dynamic-require stub.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getClient_WasmSqlite(): any {\n if (cachedDialect) return cachedDialect;\n const Client_SQLite3 = resolveKnexSqlite3Dialect();\n\n class Client_WasmSqlite extends Client_SQLite3 {\n // sql.js has no shared \"driver module\" the way better-sqlite3 does. Knex\n // only uses `this.driver` to construct connections, and we override\n // `acquireRawConnection`, so a sentinel object is enough.\n _driver(): { name: 'sql.js' } {\n return { name: 'sql.js' };\n }\n\n async acquireRawConnection(): Promise<WasmSqliteConnection> {\n const settings = (this as any)\n .connectionSettings as WasmSqliteConnectionSettings;\n\n const conn = new WasmSqliteConnection({\n filename: settings.filename,\n persist: settings.persist,\n sqlJs: settings.sqlJs,\n locateFile: settings.locateFile,\n logger: settings.logger,\n });\n await conn.open(settings.sqlJs, settings.locateFile);\n return conn;\n }\n\n async destroyRawConnection(connection: WasmSqliteConnection): Promise<void> {\n await connection.close();\n }\n\n async _query(\n connection: WasmSqliteConnection,\n obj: any,\n ): Promise<any> {\n if (!obj.sql) throw new Error('The query is empty');\n if (!connection) throw new Error('No connection provided');\n\n const db = connection.raw;\n const bindings = formatBindings(obj.bindings);\n\n // DDL / transactional control statements have no Knex `method`. sql.js's\n // `prepare`+`step` silently no-ops on many of these (e.g. CREATE TABLE),\n // so route them through `run` which is implemented via `exec` and\n // actually mutates the database. PRAGMA is intentionally excluded — many\n // PRAGMA forms (e.g. `PRAGMA table_info(...)`, `foreign_key_list(...)`)\n // return rows used by Knex's schema introspection/columnInfo, and\n // `db.run` discards those rows.\n const isDdl =\n /^\\s(CREATE\|ALTER\|DROP\|BEGIN\|COMMIT\|ROLLBACK\|SAVEPOINT\|RELEASE\|REINDEX\|VACUUM\|ATTACH\|DETACH\|TRUNCATE)\\b/i.test(\n obj.sql,\n );\n if (isDdl) {\n db.run(obj.sql, bindings as any);\n obj.response = [];\n // Transaction-control statements are routed through\n // `noteTransactionControl`, which owns flushing for the transaction\n // lifecycle: it suppresses flushes while a transaction is open (sql.js\n // `export()` closes+reopens the db, which would abort the txn) and\n // performs a single flush once the transaction fully closes. Routing\n // them away from `markDirty` avoids a second, racing flush on COMMIT.\n if (/^\\s(BEGIN\|COMMIT\|END\|ROLLBACK\|SAVEPOINT\|RELEASE)\\b/i.test(obj.sql)) {\n connection.noteTransactionControl(obj.sql);\n } else {\n connection.markDirty('run');\n }\n return obj;\n }\n\n if (isReadMethod(obj.method, obj.returning) \|\| /^\\sPRAGMA\\b/i.test(obj.sql)) {\n const stmt = db.prepare(obj.sql);\n try {\n if (bindings.length) stmt.bind(bindings as any);\n const rows: Record<string, unknown>[] = [];\n while (stmt.step()) {\n rows.push(stmt.getAsObject());\n }\n obj.response = rows;\n } finally {\n stmt.free();\n }\n return obj;\n }\n\n // Write path: execute via `run` (no row iteration needed) and capture\n // SQLite's per-connection lastID / changes counters.\n db.run(obj.sql, bindings as any);\n const changes = db.getRowsModified();\n let lastID: number \| bigint = 0;\n if (obj.method === 'insert') {\n const r = db.exec('SELECT last_insert_rowid() AS id');\n lastID = (r?.[0]?.values?.[0]?.[0] as number) ?? 0;\n }\n obj.response = [];\n obj.context = { lastID, changes };\n connection.markDirty(obj.method);\n return obj;\n }\n }\n\n Object.assign(Client_WasmSqlite.prototype, {\n dialect: 'sqlite3',\n driverName: 'wasm-sqlite',\n });\n\n cachedDialect = Client_WasmSqlite;\n return Client_WasmSqlite;\n}\n\n/*\n Back-compat re-export. Prefer `getClient_WasmSqlite()` so the dialect\n * is resolved lazily; the named export triggers the factory on first\n * access of any static property.\n \n Note: importing this binding will execute the factory at import time\n * in some bundlers, which defeats the lazy pattern. New code should call\n * `getClient_WasmSqlite()` directly.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const Client_WasmSqlite: any = new Proxy(function () {} as any, {\n get(_t, prop) {\n return (getClient_WasmSqlite() as any)[prop];\n },\n construct(_t, args) {\n const Klass = getClient_WasmSqlite();\n return new Klass(...args);\n },\n apply(_t, thisArg, args) {\n const Klass = getClient_WasmSqlite();\n return Reflect.apply(Klass, thisArg, args);\n },\n});\n\nexport default Client_WasmSqlite;\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Thin wrapper over sql.js {@link Database} that mimics the surface of\n * `better-sqlite3`'s `Database` (only the methods the Knex dialect uses).\n \n Persistence is handled here, not in the Knex dialect, so it can be\n * orchestrated per-connection without polluting the SQL execution path.\n /\n\nimport type { Database, SqlJsStatic } from 'sql.js';\n\n/* When to flush the in-memory WASM database to disk. /\nexport type PersistMode =\n \| 'on-disconnect'\n \| 'on-write'\n \| `debounced:${number}`;\n\nexport interface WasmConnectionOptions {\n /\n On-disk file path. `:memory:` (or any value starting with `:`) skips\n * persistence entirely and the database lives only for the process.\n /\n filename: string;\n /* When to persist. Default: `on-disconnect`. /\n persist?: PersistMode;\n /* Pre-loaded sql.js module. If omitted, loaded lazily on first connect. /\n sqlJs?: SqlJsStatic;\n /\n Optional override for the `.wasm` locator passed to `initSqlJs()`.\n * Defaults to resolving the file from the `sql.js` package on disk\n * (works in Node and WebContainer).\n /\n locateFile?: (file: string) => string;\n /* Optional logger; defaults to `console`. /\n logger?: { warn: (msg: string, meta?: unknown) => void };\n}\n\n/* Mutation method names that should trigger a persistence cycle. /\nconst WRITE_METHODS = new Set([\n 'run',\n 'insert',\n 'update',\n 'del',\n 'counter',\n]);\n\n/\n Detect whether a Node-style `fs` module is available. WebContainer\n * (StackBlitz) provides Node `fs`; pure-browser environments do not.\n /\nasync function tryLoadFs(): Promise<typeof import('node:fs/promises') \| null> {\n try {\n return await import('node:fs/promises');\n } catch {\n return null;\n }\n}\n\n/\n Resolve a default sql.js WASM locator. We point sql.js at the `.wasm`\n * file shipped inside `sql.js`'s own `dist/` folder. This avoids requiring\n * the caller to host the WASM separately.\n /\nasync function defaultLocateFile(): Promise<((file: string) => string) \| undefined> {\n try {\n const { createRequire } = await import('node:module');\n const require = createRequire(import.meta.url);\n const pkgJsonPath = require.resolve('sql.js/package.json');\n const { dirname, join } = await import('node:path');\n const dir = dirname(pkgJsonPath);\n return (file: string) => join(dir, 'dist', file);\n } catch {\n return undefined;\n }\n}\n\nlet cachedSqlJs: Promise<SqlJsStatic> \| null = null;\n\nasync function loadSqlJs(\n locateFile?: (file: string) => string,\n): Promise<SqlJsStatic> {\n if (cachedSqlJs) return cachedSqlJs;\n cachedSqlJs = (async () => {\n const mod = await import('sql.js');\n const initSqlJs = (mod as any).default ?? (mod as any);\n const locator = locateFile ?? (await defaultLocateFile());\n const SQL = await initSqlJs(locator ? { locateFile: locator } : undefined);\n return SQL as SqlJsStatic;\n })();\n return cachedSqlJs;\n}\n\n/\n A sql.js-backed connection that exposes the `prepare`/`exec`/`close`\n * subset used by Knex's SQLite dialect. Mutations are queued through a\n * configurable persistence strategy so the on-disk file stays in sync.\n /\nexport class WasmSqliteConnection {\n readonly filename: string;\n readonly persist: PersistMode;\n readonly isEphemeral: boolean;\n\n private db!: Database;\n private fs: typeof import('node:fs/promises') \| null = null;\n private dirty = false;\n private debounceMs = 0;\n private debounceTimer: ReturnType<typeof setTimeout> \| null = null;\n private flushChain: Promise<void> \| null = null;\n private destroyed = false;\n private logger: { warn: (msg: string, meta?: unknown) => void };\n\n /\n Whether a `BEGIN…COMMIT/ROLLBACK` transaction is currently open. Tracked\n * because sql.js's {@link Database.export} closes and reopens the database\n * (it has no in-place serialize), and closing a connection rolls back any\n * open transaction. Flushing mid-transaction would therefore silently\n * abort it, leaving the eventual `COMMIT` to fail with\n * \"cannot commit - no transaction is active\". We defer the flush until the\n * transaction fully closes. See {@link noteTransactionControl}.\n /\n private rootTxActive = false;\n /* Open `SAVEPOINT` depth (nested transactions emitted by Knex). /\n private savepointDepth = 0;\n /* A flush was requested while a transaction was open; run it on close. /\n private flushDeferred = false;\n\n /* True while any transaction (root or savepoint) is in flight. /\n private get inTransaction(): boolean {\n return this.rootTxActive \|\| this.savepointDepth > 0;\n }\n\n constructor(opts: WasmConnectionOptions) {\n this.filename = opts.filename;\n this.persist = opts.persist ?? 'on-disconnect';\n this.isEphemeral =\n this.filename === ':memory:' \|\| this.filename.startsWith(':');\n this.logger = opts.logger ?? console;\n\n if (typeof this.persist === 'string' && this.persist.startsWith('debounced:')) {\n const ms = Number(this.persist.slice('debounced:'.length));\n this.debounceMs = Number.isFinite(ms) && ms > 0 ? ms : 250;\n }\n }\n\n /* Open the underlying sql.js database, loading bytes from disk if any. /\n async open(sqlJs?: SqlJsStatic, locateFile?: (file: string) => string): Promise<void> {\n const SQL = sqlJs ?? (await loadSqlJs(locateFile));\n\n if (this.isEphemeral) {\n this.db = new SQL.Database();\n return;\n }\n\n this.fs = await tryLoadFs();\n if (!this.fs) {\n this.logger.warn(\n '[driver-sqlite-wasm] No node:fs available — falling back to in-memory database. ' +\n 'Data will not be persisted across reloads.',\n );\n this.db = new SQL.Database();\n return;\n }\n\n // Ensure parent directory exists, then load bytes if the file exists.\n const { dirname } = await import('node:path');\n const dir = dirname(this.filename);\n if (dir && dir !== '.') {\n await this.fs.mkdir(dir, { recursive: true });\n }\n\n let bytes: Uint8Array \| undefined;\n try {\n const buf = await this.fs.readFile(this.filename);\n bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n } catch (e: any) {\n if (e?.code !== 'ENOENT') throw e;\n }\n\n this.db = bytes ? new SQL.Database(bytes) : new SQL.Database();\n }\n\n /\n Update transaction state from a transaction-control statement and, when a\n * transaction has just fully closed, run any flush that was deferred while\n * it was open. Called by the Knex dialect for every `BEGIN` / `COMMIT` /\n * `ROLLBACK` / `SAVEPOINT` / `RELEASE` statement.\n \n We bias toward \"in transaction\": an unrecognised form leaves the flag set,\n * which at worst delays a flush (safe) rather than exporting mid-transaction\n * (which would abort it).\n /\n noteTransactionControl(sql: string): void {\n const s = sql.trim().toUpperCase();\n if (/^BEGIN\\b/.test(s)) {\n this.rootTxActive = true;\n } else if (/^(COMMIT\|END)\\b/.test(s)) {\n // A COMMIT/END ends the whole transaction regardless of savepoint nesting.\n this.rootTxActive = false;\n this.savepointDepth = 0;\n } else if (/^ROLLBACK\\s+TO\\b/.test(s)) {\n // Rolls back to a savepoint but keeps the (outer) transaction open.\n } else if (/^ROLLBACK\\b/.test(s)) {\n this.rootTxActive = false;\n this.savepointDepth = 0;\n } else if (/^SAVEPOINT\\b/.test(s)) {\n this.savepointDepth += 1;\n } else if (/^RELEASE\\b/.test(s)) {\n this.savepointDepth = Math.max(0, this.savepointDepth - 1);\n }\n // If the transaction just fully closed and a flush was deferred while it\n // was open, run it now. We key off `flushDeferred` (set only when\n // `markDirty` actually wanted to flush) rather than `dirty`, so persist\n // modes that don't flush per-write — e.g. `on-disconnect` — still defer to\n // close() instead of flushing on every COMMIT.\n if (!this.inTransaction && this.flushDeferred) {\n this.flushDeferred = false;\n void this.flush();\n }\n }\n\n /* Hint that a mutation just executed; schedule a flush if needed. /\n markDirty(method?: string): void {\n if (this.isEphemeral \|\| !this.fs) return;\n if (method && !WRITE_METHODS.has(method)) return;\n this.dirty = true;\n\n if (this.persist === 'on-write') {\n void this.flush();\n return;\n }\n if (this.debounceMs > 0) {\n if (this.debounceTimer) clearTimeout(this.debounceTimer);\n this.debounceTimer = setTimeout(() => {\n this.debounceTimer = null;\n void this.flush();\n }, this.debounceMs);\n }\n // 'on-disconnect' → flush only at close()\n }\n\n /\n Force a write of the current database state to disk.\n \n Flushes are strictly serialized through a single promise chain: every call\n * appends an export+write step that runs after all previously-queued steps.\n * This matters because sql.js `export()` mutates the live connection (it\n * closes and reopens the database), so two exports must never overlap — and\n * because the returned promise must not resolve until the caller's own write\n * has hit disk (deterministic for tests and for `close()`). Each step\n * re-checks `dirty` at run time, so a no-op write collapses cheaply and a\n * write that arrived mid-flush is captured by the next queued step.\n /\n async flush(): Promise<void> {\n if (this.isEphemeral \|\| !this.fs \|\| this.destroyed) return;\n // Never export while a transaction is open: sql.js's `export()` closes and\n // reopens the database, which rolls back the in-flight transaction and\n // makes the subsequent COMMIT fail. Defer until the transaction closes\n // (handled in `noteTransactionControl`).\n if (this.inTransaction) {\n this.flushDeferred = true;\n return;\n }\n\n const prev = this.flushChain;\n const step = (prev ?? Promise.resolve()).then(async () => {\n if (!this.dirty \|\| this.destroyed \|\| this.inTransaction) return;\n // Snapshot dirty=false before export so a concurrent write re-marks us\n // and is picked up by the next queued step.\n this.dirty = false;\n try {\n const exported = this.db.export();\n // sql.js returns a Uint8Array; Buffer.from on it shares memory but\n // works fine for the synchronous writeFile enqueue below.\n await this.fs!.writeFile(this.filename, Buffer.from(exported));\n } catch (err) {\n this.dirty = true; // let a later flush retry\n throw err;\n }\n });\n // Keep the chain tail alive but swallow its rejection there so one failed\n // flush doesn't poison every future flush; the awaited `step` still throws.\n this.flushChain = step.catch(() => {});\n await step;\n }\n\n /* Close the database, flushing any pending writes first. /\n async close(): Promise<void> {\n if (this.destroyed) return;\n if (this.debounceTimer) {\n clearTimeout(this.debounceTimer);\n this.debounceTimer = null;\n }\n // Any transaction still open at close is abandoned and will be rolled back\n // by `db.close()`; clear the flag so the final flush is not deferred and\n // already-committed data is persisted.\n this.rootTxActive = false;\n this.savepointDepth = 0;\n try {\n await this.flush();\n } finally {\n this.destroyed = true;\n try {\n this.db.close();\n } catch {\n / ignore /\n }\n }\n }\n\n /* Access the raw sql.js database (for the Knex dialect). */\n get raw(): Database {\n return this.db;\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaA,wBAAgD;;;ACWhD,yBAA8B;;;ACxB9B;AAuCA,IAAM,gBAAgB,oBAAI,IAAI;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAMD,eAAe,YAA+D;AAC5E,MAAI;AACF,WAAO,MAAM,OAAO,aAAkB;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAOA,eAAe,oBAAqE;AAClF,MAAI;AACF,UAAM,EAAE,eAAAA,eAAc,IAAI,MAAM,OAAO,QAAa;AACpD,UAAMC,WAAUD,eAAc,YAAY,GAAG;AAC7C,UAAM,cAAcC,SAAQ,QAAQ,qBAAqB;AACzD,UAAM,EAAE,SAAS,KAAK,IAAI,MAAM,OAAO,MAAW;AAClD,UAAM,MAAM,QAAQ,WAAW;AAC/B,WAAO,CAAC,SAAiB,KAAK,KAAK,QAAQ,IAAI;AAAA,EACjD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,IAAI,cAA2C;AAE/C,eAAe,UACb,YACsB;AACtB,MAAI,YAAa,QAAO;AACxB,iBAAe,YAAY;AACzB,UAAM,MAAM,MAAM,OAAO,QAAQ;AACjC,UAAM,YAAa,IAAY,WAAY;AAC3C,UAAM,UAAU,cAAe,MAAM,kBAAkB;AACvD,UAAM,MAAM,MAAM,UAAU,UAAU,EAAE,YAAY,QAAQ,IAAI,MAAS;AACzE,WAAO;AAAA,EACT,GAAG;AACH,SAAO;AACT;AAOO,IAAM,uBAAN,MAA2B;AAAA,EAkChC,YAAY,MAA6B;AA5BzC,SAAQ,KAA+C;AACvD,SAAQ,QAAQ;AAChB,SAAQ,aAAa;AACrB,SAAQ,gBAAsD;AAC9D,SAAQ,aAAmC;AAC3C,SAAQ,YAAY;AAYpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAQ,eAAe;AAEvB;AAAA,SAAQ,iBAAiB;AAEzB;AAAA,SAAQ,gBAAgB;AAQtB,SAAK,WAAW,KAAK;AACrB,SAAK,UAAU,KAAK,WAAW;AAC/B,SAAK,cACH,KAAK,aAAa,cAAc,KAAK,SAAS,WAAW,GAAG;AAC9D,SAAK,SAAS,KAAK,UAAU;AAE7B,QAAI,OAAO,KAAK,YAAY,YAAY,KAAK,QAAQ,WAAW,YAAY,GAAG;AAC7E,YAAM,KAAK,OAAO,KAAK,QAAQ,MAAM,aAAa,MAAM,CAAC;AACzD,WAAK,aAAa,OAAO,SAAS,EAAE,KAAK,KAAK,IAAI,KAAK;AAAA,IACzD;AAAA,EACF;AAAA;AAAA,EAfA,IAAY,gBAAyB;AACnC,WAAO,KAAK,gBAAgB,KAAK,iBAAiB;AAAA,EACpD;AAAA;AAAA,EAgBA,MAAM,KAAK,OAAqB,YAAsD;AACpF,UAAM,MAAM,SAAU,MAAM,UAAU,UAAU;AAEhD,QAAI,KAAK,aAAa;AACpB,WAAK,KAAK,IAAI,IAAI,SAAS;AAC3B;AAAA,IACF;AAEA,SAAK,KAAK,MAAM,UAAU;AAC1B,QAAI,CAAC,KAAK,IAAI;AACZ,WAAK,OAAO;AAAA,QACV;AAAA,MAEF;AACA,WAAK,KAAK,IAAI,IAAI,SAAS;AAC3B;AAAA,IACF;AAGA,UAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,MAAW;AAC5C,UAAM,MAAM,QAAQ,KAAK,QAAQ;AACjC,QAAI,OAAO,QAAQ,KAAK;AACtB,YAAM,KAAK,GAAG,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;AAAA,IAC9C;AAEA,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,MAAM,KAAK,GAAG,SAAS,KAAK,QAAQ;AAChD,cAAQ,IAAI,WAAW,IAAI,QAAQ,IAAI,YAAY,IAAI,UAAU;AAAA,IACnE,SAAS,GAAQ;AACf,UAAI,GAAG,SAAS,SAAU,OAAM;AAAA,IAClC;AAEA,SAAK,KAAK,QAAQ,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,IAAI,SAAS;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,uBAAuB,KAAmB;AACxC,UAAM,IAAI,IAAI,KAAK,EAAE,YAAY;AACjC,QAAI,WAAW,KAAK,CAAC,GAAG;AACtB,WAAK,eAAe;AAAA,IACtB,WAAW,kBAAkB,KAAK,CAAC,GAAG;AAEpC,WAAK,eAAe;AACpB,WAAK,iBAAiB;AAAA,IACxB,WAAW,mBAAmB,KAAK,CAAC,GAAG;AAAA,IAEvC,WAAW,cAAc,KAAK,CAAC,GAAG;AAChC,WAAK,eAAe;AACpB,WAAK,iBAAiB;AAAA,IACxB,WAAW,eAAe,KAAK,CAAC,GAAG;AACjC,WAAK,kBAAkB;AAAA,IACzB,WAAW,aAAa,KAAK,CAAC,GAAG;AAC/B,WAAK,iBAAiB,KAAK,IAAI,GAAG,KAAK,iBAAiB,CAAC;AAAA,IAC3D;AAMA,QAAI,CAAC,KAAK,iBAAiB,KAAK,eAAe;AAC7C,WAAK,gBAAgB;AACrB,WAAK,KAAK,MAAM;AAAA,IAClB;AAAA,EACF;AAAA;AAAA,EAGA,UAAU,QAAuB;AAC/B,QAAI,KAAK,eAAe,CAAC,KAAK,GAAI;AAClC,QAAI,UAAU,CAAC,cAAc,IAAI,MAAM,EAAG;AAC1C,SAAK,QAAQ;AAEb,QAAI,KAAK,YAAY,YAAY;AAC/B,WAAK,KAAK,MAAM;AAChB;AAAA,IACF;AACA,QAAI,KAAK,aAAa,GAAG;AACvB,UAAI,KAAK,cAAe,cAAa,KAAK,aAAa;AACvD,WAAK,gBAAgB,WAAW,MAAM;AACpC,aAAK,gBAAgB;AACrB,aAAK,KAAK,MAAM;AAAA,MAClB,GAAG,KAAK,UAAU;AAAA,IACpB;AAAA,EAEF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,QAAuB;AAC3B,QAAI,KAAK,eAAe,CAAC,KAAK,MAAM,KAAK,UAAW;AAKpD,QAAI,KAAK,eAAe;AACtB,WAAK,gBAAgB;AACrB;AAAA,IACF;AAEA,UAAM,OAAO,KAAK;AAClB,UAAM,QAAQ,QAAQ,QAAQ,QAAQ,GAAG,KAAK,YAAY;AACxD,UAAI,CAAC,KAAK,SAAS,KAAK,aAAa,KAAK,cAAe;AAGzD,WAAK,QAAQ;AACb,UAAI;AACF,cAAM,WAAW,KAAK,GAAG,OAAO;AAGhC,cAAM,KAAK,GAAI,UAAU,KAAK,UAAU,OAAO,KAAK,QAAQ,CAAC;AAAA,MAC/D,SAAS,KAAK;AACZ,aAAK,QAAQ;AACb,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAGD,SAAK,aAAa,KAAK,MAAM,MAAM;AAAA,IAAC,CAAC;AACrC,UAAM;AAAA,EACR;AAAA;AAAA,EAGA,MAAM,QAAuB;AAC3B,QAAI,KAAK,UAAW;AACpB,QAAI,KAAK,eAAe;AACtB,mBAAa,KAAK,aAAa;AAC/B,WAAK,gBAAgB;AAAA,IACvB;AAIA,SAAK,eAAe;AACpB,SAAK,iBAAiB;AACtB,QAAI;AACF,YAAM,KAAK,MAAM;AAAA,IACnB,UAAE;AACA,WAAK,YAAY;AACjB,UAAI;AACF,aAAK,GAAG,MAAM;AAAA,MAChB,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,MAAgB;AAClB,WAAO,KAAK;AAAA,EACd;AACF;;;AD1TA,IAAAC,eAAA;AAwCA,IAAI,mBAAwB;AAC5B,SAAS,gBAAqB;AAC5B,MAAI,iBAAkB,QAAO;AAG7B,QAAM,SACJ,OAAOA,iBAAgB,eAAgBA,aAAoB,MACtDA,aAAoB,MACrB,OAAO,eAAe,cACpB,aACA,QAAQ,IAAI,IAAI;AACxB,yBAAmB,kCAAc,MAAM;AACvC,SAAO;AACT;AAeA,SAAS,eAAe,UAA4C;AAClE,MAAI,CAAC,SAAU,QAAO,CAAC;AACvB,SAAO,SAAS,IAAI,CAAC,MAAM;AACzB,QAAI,aAAa,KAAM,QAAO,EAAE,QAAQ;AACxC,QAAI,OAAO,MAAM,UAAW,QAAO,OAAO,CAAC;AAC3C,WAAO;AAAA,EACT,CAAC;AACH;AAUA,SAAS,aAAa,QAAiB,WAA8B;AACnE,MAAI,WAAW,YAAY,WAAW,SAAU,QAAO,CAAC,CAAC,YAAY,OAAO;AAC5E,MAAI,WAAW,aAAa,WAAW,MAAO,QAAO;AACrD,SAAO;AACT;AAcA,SAAS,4BAAiC;AAExC,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,YAAY,YAAY;AACnC,QAAI;AACF,aAAO,EAAE,QAAQ,2BAA2B;AAAA,IAC9C,QAAQ;AAAA,IAER;AAAA,EACF;AAKA,SAAO,cAAc,EAAE,2BAA2B;AACpD;AAGA,IAAI,gBAAqB;AASlB,SAAS,uBAA4B;AAC1C,MAAI,cAAe,QAAO;AAC1B,QAAM,iBAAiB,0BAA0B;AAAA,EAEjD,MAAMC,2BAA0B,eAAe;AAAA;AAAA;AAAA;AAAA,IAI7C,UAA8B;AAC5B,aAAO,EAAE,MAAM,SAAS;AAAA,IAC1B;AAAA,IAEA,MAAM,uBAAsD;AAC1D,YAAM,WAAY,KACf;AAEH,YAAM,OAAO,IAAI,qBAAqB;AAAA,QACpC,UAAU,SAAS;AAAA,QACnB,SAAS,SAAS;AAAA,QAClB,OAAO,SAAS;AAAA,QAChB,YAAY,SAAS;AAAA,QACrB,QAAQ,SAAS;AAAA,MACnB,CAAC;AACD,YAAM,KAAK,KAAK,SAAS,OAAO,SAAS,UAAU;AACnD,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,qBAAqB,YAAiD;AAC1E,YAAM,WAAW,MAAM;AAAA,IACzB;AAAA,IAEA,MAAM,OACJ,YACA,KACc;AACd,UAAI,CAAC,IAAI,IAAK,OAAM,IAAI,MAAM,oBAAoB;AAClD,UAAI,CAAC,WAAY,OAAM,IAAI,MAAM,wBAAwB;AAEzD,YAAM,KAAK,WAAW;AACtB,YAAM,WAAW,eAAe,IAAI,QAAQ;AAS5C,YAAM,QACJ,2GAA2G;AAAA,QACzG,IAAI;AAAA,MACN;AACF,UAAI,OAAO;AACT,WAAG,IAAI,IAAI,KAAK,QAAe;AAC/B,YAAI,WAAW,CAAC;AAOhB,YAAI,uDAAuD,KAAK,IAAI,GAAG,GAAG;AACxE,qBAAW,uBAAuB,IAAI,GAAG;AAAA,QAC3C,OAAO;AACL,qBAAW,UAAU,KAAK;AAAA,QAC5B;AACA,eAAO;AAAA,MACT;AAEA,UAAI,aAAa,IAAI,QAAQ,IAAI,SAAS,KAAK,gBAAgB,KAAK,IAAI,GAAG,GAAG;AAC5E,cAAM,OAAO,GAAG,QAAQ,IAAI,GAAG;AAC/B,YAAI;AACF,cAAI,SAAS,OAAQ,MAAK,KAAK,QAAe;AAC9C,gBAAM,OAAkC,CAAC;AACzC,iBAAO,KAAK,KAAK,GAAG;AAClB,iBAAK,KAAK,KAAK,YAAY,CAAC;AAAA,UAC9B;AACA,cAAI,WAAW;AAAA,QACjB,UAAE;AACA,eAAK,KAAK;AAAA,QACZ;AACA,eAAO;AAAA,MACT;AAIA,SAAG,IAAI,IAAI,KAAK,QAAe;AAC/B,YAAM,UAAU,GAAG,gBAAgB;AACnC,UAAI,SAA0B;AAC9B,UAAI,IAAI,WAAW,UAAU;AAC3B,cAAM,IAAI,GAAG,KAAK,kCAAkC;AACpD,iBAAU,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,KAAgB;AAAA,MACnD;AACA,UAAI,WAAW,CAAC;AAChB,UAAI,UAAU,EAAE,QAAQ,QAAQ;AAChC,iBAAW,UAAU,IAAI,MAAM;AAC/B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO,OAAOA,mBAAkB,WAAW;AAAA,IACzC,SAAS;AAAA,IACT,YAAY;AAAA,EACd,CAAC;AAED,kBAAgBA;AAChB,SAAOA;AACT;AAYO,IAAM,oBAAyB,IAAI,MAAM,WAAY;AAAC,GAAU;AAAA,EACrE,IAAI,IAAI,MAAM;AACZ,WAAQ,qBAAqB,EAAU,IAAI;AAAA,EAC7C;AAAA,EACA,UAAU,IAAI,MAAM;AAClB,UAAM,QAAQ,qBAAqB;AACnC,WAAO,IAAI,MAAM,GAAG,IAAI;AAAA,EAC1B;AAAA,EACA,MAAM,IAAI,SAAS,MAAM;AACvB,UAAM,QAAQ,qBAAqB;AACnC,WAAO,QAAQ,MAAM,OAAO,SAAS,IAAI;AAAA,EAC3C;AACF,CAAC;;;ADnMM,IAAM,mBAAN,MAAM,0BAAyB,4BAAU;AAAA,EAgB9C,YAAY,QAAgC;AAC1C,UAAM,aAAa,kBAAiB,aAAa,MAAM;AACvD,UAAM,UAAU;AAjBlB,SAAyB,OAAe;AACxC,SAAyB,UAAkB;AAY3C,SAAQ,oBAAyC;AAK/C,SAAK,aAAa;AAClB,QAAI,OAAO,OAAQ,MAAK,SAAS,OAAO;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAZA,IAAuB,WAAoB;AACzC,WAAO;AAAA,EACT;AAAA;AAAA,EAaA,OAAO,aAAa,QAAiD;AACnE,WAAO;AAAA;AAAA;AAAA;AAAA,MAIL,QAAQ,qBAAqB;AAAA,MAC7B,YAAY;AAAA,QACV,UAAU,OAAO;AAAA,QACjB,SAAS,OAAO;AAAA,QAChB,OAAO,OAAO;AAAA,QACd,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,MACjB;AAAA;AAAA;AAAA,MAGA,MAAM,OAAO,QAAQ,EAAE,KAAK,GAAG,KAAK,EAAE;AAAA,MACtC,kBAAkB;AAAA,IACpB;AAAA,EACF;AAAA,EAEA,MAAe,UAAyB;AACtC,UAAM,MAAM,QAAQ;AAIpB,QACE,KAAK,WAAW,aAAa,cAC7B,CAAC,KAAK,WAAW,SAAS,WAAW,GAAG,KACxC,OAAO,YAAY,eACnB,OAAO,QAAQ,SAAS,YACxB;AACA,WAAK,oBAAoB,MAAM;AAE7B,aAAK,KAAK,MAAM,EAAE,MAAM,MAAM;AAAA,QAE9B,CAAC;AAAA,MACH;AACA,cAAQ,KAAK,cAAc,KAAK,iBAAiB;AAAA,IACnD;AAAA,EACF;AAAA,EAEA,MAAe,aAA4B;AACzC,QAAI,KAAK,qBAAqB,OAAO,YAAY,aAAa;AAC5D,UAAI;AACF,gBAAQ,eAAe,cAAc,KAAK,iBAAiB;AAAA,MAC7D,QAAQ;AAAA,MAER;AACA,WAAK,oBAAoB;AAAA,IAC3B;AACA,UAAM,MAAM,WAAW;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,QAAuB;AAE3B,UAAM,OAAQ,KAAa;AAC3B,UAAM,SAAS,MAAM;AACrB,UAAM,OAAO,QAAQ;AACrB,QAAI,CAAC,QAAQ,OAAO,KAAK,YAAY,WAAY;AAEjD,UAAM,UAAU,OAAO,mBAAmB,KAAK,MAAM;AACrD,UAAM,UAAU,OAAO,mBAAmB,KAAK,MAAM;AACrD,QAAI,CAAC,WAAW,CAAC,QAAS;AAE1B,UAAM,OAAO,MAAM,QAAQ;AAC3B,QAAI;AACF,UAAI,QAAQ,OAAO,KAAK,UAAU,YAAY;AAC5C,cAAM,KAAK,MAAM;AAAA,MACnB;AAAA,IACF,UAAE;AACA,YAAM,QAAQ,IAAI;AAAA,IACpB;AAAA,EACF;AACF;;;AD5JA,IAAO,gBAAQ;AAAA,EACb,IAAI;AAAA,EACJ,SAAS;AAAA,EAET,UAAU,OAAO,YAAiB;AAChC,UAAM,EAAE,QAAQ,QAAQ,QAAQ,IAAI;AACpC,YAAQ,OAAO,sCAAsC;AAErD,QAAI,SAAS;AACX,YAAM,SAAS,IAAI,iBAAiB,MAAM;AAC1C,cAAQ,SAAS,MAAM;AACvB,cAAQ,OAAO,2CAA2C,OAAO,IAAI,EAAE;AAAA,IACzE,OAAO;AACL,cAAQ,OAAO,2DAA2D;AAAA,IAC5E;AAAA,EACF;AACF;","names":["createRequire","require","import_meta","Client_WasmSqlite"]}

package/dist/index.mjs CHANGED Viewed

@@ -49,8 +49,22 @@ var WasmSqliteConnection = class {
     this.dirty = false;
     this.debounceMs = 0;
     this.debounceTimer = null;
-    this.pendingFlush = null;
+    this.flushChain = null;
     this.destroyed = false;
+    /**
+     * Whether a `BEGIN…COMMIT/ROLLBACK` transaction is currently open. Tracked
+     * because sql.js's {@link Database.export} closes and reopens the database
+     * (it has no in-place serialize), and closing a connection rolls back any
+     * open transaction. Flushing mid-transaction would therefore silently
+     * abort it, leaving the eventual `COMMIT` to fail with
+     * "cannot commit - no transaction is active". We defer the flush until the
+     * transaction fully closes. See {@link noteTransactionControl}.
+     */
+    this.rootTxActive = false;
+    /** Open `SAVEPOINT` depth (nested transactions emitted by Knex). */
+    this.savepointDepth = 0;
+    /** A flush was requested while a transaction was open; run it on close. */
+    this.flushDeferred = false;
     this.filename = opts.filename;
     this.persist = opts.persist ?? "on-disconnect";
     this.isEphemeral = this.filename === ":memory:" || this.filename.startsWith(":");
@@ -60,6 +74,10 @@ var WasmSqliteConnection = class {
       this.debounceMs = Number.isFinite(ms) && ms > 0 ? ms : 250;
     }
   }
+  /** True while any transaction (root or savepoint) is in flight. */
+  get inTransaction() {
+    return this.rootTxActive || this.savepointDepth > 0;
+  }
   /** Open the underlying sql.js database, loading bytes from disk if any. */
   async open(sqlJs, locateFile) {
     const SQL = sqlJs ?? await loadSqlJs(locateFile);
@@ -89,6 +107,37 @@ var WasmSqliteConnection = class {
     }
     this.db = bytes ? new SQL.Database(bytes) : new SQL.Database();
   }
+  /**
+   * Update transaction state from a transaction-control statement and, when a
+   * transaction has just fully closed, run any flush that was deferred while
+   * it was open. Called by the Knex dialect for every `BEGIN` / `COMMIT` /
+   * `ROLLBACK` / `SAVEPOINT` / `RELEASE` statement.
+   *
+   * We bias toward "in transaction": an unrecognised form leaves the flag set,
+   * which at worst delays a flush (safe) rather than exporting mid-transaction
+   * (which would abort it).
+   */
+  noteTransactionControl(sql) {
+    const s = sql.trim().toUpperCase();
+    if (/^BEGIN\b/.test(s)) {
+      this.rootTxActive = true;
+    } else if (/^(COMMIT|END)\b/.test(s)) {
+      this.rootTxActive = false;
+      this.savepointDepth = 0;
+    } else if (/^ROLLBACK\s+TO\b/.test(s)) {
+    } else if (/^ROLLBACK\b/.test(s)) {
+      this.rootTxActive = false;
+      this.savepointDepth = 0;
+    } else if (/^SAVEPOINT\b/.test(s)) {
+      this.savepointDepth += 1;
+    } else if (/^RELEASE\b/.test(s)) {
+      this.savepointDepth = Math.max(0, this.savepointDepth - 1);
+    }
+    if (!this.inTransaction && this.flushDeferred) {
+      this.flushDeferred = false;
+      void this.flush();
+    }
+  }
   /** Hint that a mutation just executed; schedule a flush if needed. */
   markDirty(method) {
     if (this.isEphemeral || !this.fs) return;
@@ -106,30 +155,39 @@ var WasmSqliteConnection = class {
       }, this.debounceMs);
     }
   }
-  /** Force a write of the current database state to disk. */
+  /**
+   * Force a write of the current database state to disk.
+   *
+   * Flushes are strictly serialized through a single promise chain: every call
+   * appends an export+write step that runs after all previously-queued steps.
+   * This matters because sql.js `export()` mutates the live connection (it
+   * closes and reopens the database), so two exports must never overlap — and
+   * because the returned promise must not resolve until the caller's own write
+   * has hit disk (deterministic for tests and for `close()`). Each step
+   * re-checks `dirty` at run time, so a no-op write collapses cheaply and a
+   * write that arrived mid-flush is captured by the next queued step.
+   */
   async flush() {
     if (this.isEphemeral || !this.fs || this.destroyed) return;
-    if (this.pendingFlush) {
-      await this.pendingFlush;
-      if (!this.dirty || this.destroyed) return;
+    if (this.inTransaction) {
+      this.flushDeferred = true;
+      return;
     }
-    if (!this.dirty) return;
-    this.pendingFlush = (async () => {
+    const prev = this.flushChain;
+    const step = (prev ?? Promise.resolve()).then(async () => {
+      if (!this.dirty || this.destroyed || this.inTransaction) return;
+      this.dirty = false;
       try {
-        this.dirty = false;
         const exported = this.db.export();
         await this.fs.writeFile(this.filename, Buffer.from(exported));
       } catch (err) {
         this.dirty = true;
         throw err;
-      } finally {
-        this.pendingFlush = null;
       }
-    })();
-    await this.pendingFlush;
-    if (this.dirty && !this.destroyed) {
-      await this.flush();
-    }
+    });
+    this.flushChain = step.catch(() => {
+    });
+    await step;
   }
   /** Close the database, flushing any pending writes first. */
   async close() {
@@ -138,6 +196,8 @@ var WasmSqliteConnection = class {
       clearTimeout(this.debounceTimer);
       this.debounceTimer = null;
     }
+    this.rootTxActive = false;
+    this.savepointDepth = 0;
     try {
       await this.flush();
     } finally {
@@ -222,7 +282,11 @@ function getClient_WasmSqlite() {
       if (isDdl) {
         db.run(obj.sql, bindings);
         obj.response = [];
-        connection.markDirty("run");
+        if (/^\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\b/i.test(obj.sql)) {
+          connection.noteTransactionControl(obj.sql);
+        } else {
+          connection.markDirty("run");
+        }
         return obj;
       }
       if (isReadMethod(obj.method, obj.returning) || /^\s*PRAGMA\b/i.test(obj.sql)) {

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/sqlite-wasm-driver.ts","../src/knex-wasm-dialect.ts","../src/wasm-connection.ts","../src/index.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/*\n SQLite-on-WASM driver for ObjectStack.\n \n Extends {@link SqlDriver} so all CRUD / schema / introspection / multi-tenant\n * logic is inherited as-is. Only the Knex transport is swapped to a custom\n * dialect ({@link Client_WasmSqlite}) backed by sql.js + Node `fs` persistence,\n * which lets the same `SqlDriver` codepath run inside StackBlitz WebContainer\n * (Node-in-browser) without the native `better-sqlite3` N-API binding.\n /\n\nimport type { SqlJsStatic } from 'sql.js';\nimport { SqlDriver, type SqlDriverConfig } from '@objectstack/driver-sql';\n\nimport { getClient_WasmSqlite } from './knex-wasm-dialect.js';\nimport type {\n PersistMode,\n WasmConnectionOptions,\n} from './wasm-connection.js';\n\n/* Public configuration for {@link SqliteWasmDriver}. /\nexport interface SqliteWasmDriverConfig {\n /\n SQLite filename. Use `:memory:` for an ephemeral database that is never\n * persisted. Any other value is treated as a Node `fs` path and the\n * sql.js database bytes are flushed back to disk according to {@link persist}.\n /\n filename: string;\n\n /\n Persistence strategy. Default: `'on-disconnect'`.\n \n - `'on-disconnect'` — flush once when the driver disconnects (and on\n * `process.beforeExit`).\n * - `'on-write'` — flush after every mutation. Safest, slowest.\n * - `` `debounced:${ms}` `` — debounce flushes by N milliseconds. Good\n * balance under bursty writes.\n /\n persist?: PersistMode;\n\n /* Pre-loaded sql.js module — skips lazy import. /\n sqlJs?: SqlJsStatic;\n\n /\n Override for sql.js's `locateFile`. Defaults to resolving the `.wasm`\n * file inside the installed `sql.js` package, which works in Node and\n * WebContainer.\n /\n locateFile?: (file: string) => string;\n\n /* Knex pool overrides. The dialect already defaults to `{ min: 1, max: 1 }`. /\n pool?: SqlDriverConfig['pool'];\n\n /* Optional logger. Defaults to `console`. /\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n SqlDriver subclass that runs Knex against sql.js (WASM SQLite).\n \n Behaves identically to the standard SQLite path — the dialect's\n * {@link Client_WasmSqlite._query} reports `lastID`/`changes` exactly the\n * way better-sqlite3 does, so {@link SqlDriver}'s SQL generation, returning\n * clauses, and schema introspection all keep working.\n /\nexport class SqliteWasmDriver extends SqlDriver {\n public override readonly name: string = 'com.objectstack.driver.sqlite-wasm';\n public override readonly version: string = '1.0.0';\n\n /\n Force the SQLite branch in {@link SqlDriver}. The base class detects\n * SQLite by string-matching `config.client`, but we pass the dialect class\n * directly so the string check would miss.\n /\n protected override get isSqlite(): boolean {\n return true;\n }\n\n private wasmConfig: SqliteWasmDriverConfig;\n private beforeExitHandler: (() => void) \| null = null;\n\n constructor(config: SqliteWasmDriverConfig) {\n const knexConfig = SqliteWasmDriver.toKnexConfig(config);\n super(knexConfig);\n this.wasmConfig = config;\n if (config.logger) this.logger = config.logger as any;\n }\n\n /* Translate the public config into a Knex config that uses our dialect. /\n static toKnexConfig(config: SqliteWasmDriverConfig): SqlDriverConfig {\n return {\n // Knex accepts a Client class as `client`. The dialect's `driverName`\n // is `'wasm-sqlite'` and its `dialect` is `'sqlite3'` so the SQLite\n // query compiler is reused.\n client: getClient_WasmSqlite() as any,\n connection: {\n filename: config.filename,\n persist: config.persist,\n sqlJs: config.sqlJs,\n locateFile: config.locateFile,\n logger: config.logger,\n } as any,\n // sql.js is single-threaded WASM — a single connection per pool keeps\n // semantics consistent with the upstream SQLite dialect.\n pool: config.pool ?? { min: 1, max: 1 },\n useNullAsDefault: true,\n } as SqlDriverConfig;\n }\n\n override async connect(): Promise<void> {\n await super.connect();\n\n // Best-effort flush on process exit so `on-disconnect` mode still saves\n // user data if the host process is shut down without explicit cleanup.\n if (\n this.wasmConfig.filename !== ':memory:' &&\n !this.wasmConfig.filename.startsWith(':') &&\n typeof process !== 'undefined' &&\n typeof process.once === 'function'\n ) {\n this.beforeExitHandler = () => {\n // Fire-and-forget — beforeExit cannot await.\n void this.flush().catch(() => {\n / ignore /\n });\n };\n process.once('beforeExit', this.beforeExitHandler);\n }\n }\n\n override async disconnect(): Promise<void> {\n if (this.beforeExitHandler && typeof process !== 'undefined') {\n try {\n process.removeListener('beforeExit', this.beforeExitHandler);\n } catch {\n / ignore /\n }\n this.beforeExitHandler = null;\n }\n await super.disconnect();\n }\n\n /\n Force a flush of the in-memory database to disk. No-op for ephemeral\n * databases or when no fs is available.\n /\n async flush(): Promise<void> {\n // Reach into the Knex pool and ask every live connection to flush.\n const knex = (this as any).knex;\n const client = knex?.client;\n const pool = client?.pool;\n if (!pool \|\| typeof pool.numUsed !== 'function') return;\n\n const acquire = client.acquireConnection?.bind(client);\n const release = client.releaseConnection?.bind(client);\n if (!acquire \|\| !release) return;\n\n const conn = await acquire();\n try {\n if (conn && typeof conn.flush === 'function') {\n await conn.flush();\n }\n } finally {\n await release(conn);\n }\n }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Custom Knex SQLite dialect backed by sql.js (WASM SQLite).\n \n Mimics the surface that `Client_BetterSQLite3` presents to Knex so the\n * upstream SQLite3 dialect's query compiler, schema builder, and column\n * compiler all keep working unchanged. Only the transport layer —\n * `_driver` / `acquireRawConnection` / `_query` — is swapped out.\n \n ## Why the dialect class is built lazily\n \n The class `Client_WasmSqlite extends Client_SQLite3` needs the upstream\n * SQLite3 dialect at class-definition time. Resolving it at module\n * top-level breaks when this file is re-bundled by another tsup/esbuild\n * pass (e.g. `packages/runtime`), because that pass rewrites our runtime\n * `createRequire(import.meta.url)` chain back into a static `__require2`\n * Proxy stub that throws `Dynamic require of \"X\" is not supported`.\n \n Building the class inside a lazy factory (`getClient_WasmSqlite()`)\n * keeps the `require` call out of module-init code, so the re-bundler\n * cannot intercept it.\n /\n\nimport { createRequire } from 'node:module';\n\nimport type { SqlJsStatic } from 'sql.js';\n\nimport {\n WasmSqliteConnection,\n type PersistMode,\n type WasmConnectionOptions,\n} from './wasm-connection.js';\n\n// Built lazily — `node:module` is a Node builtin and is left untouched\n// by esbuild/tsup, so the `createRequire` import survives downstream\n// re-bundling. We defer the actual `createRequire(...)` call so that the\n// CJS build (where `import.meta.url` is empty) doesn't blow up at module\n// init; the CJS path uses `globalThis.require` directly anyway.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedEsmRequire: any = null;\nfunction getEsmRequire(): any {\n if (cachedEsmRequire) return cachedEsmRequire;\n // `import.meta.url` is replaced with an empty string in CJS output;\n // fall back to the current file/cwd in that case.\n const anchor =\n typeof import.meta !== 'undefined' && (import.meta as any).url\n ? (import.meta as any).url\n : typeof __filename !== 'undefined'\n ? __filename\n : process.cwd() + '/';\n cachedEsmRequire = createRequire(anchor);\n return cachedEsmRequire;\n}\n\n/* Connection settings recognised by the WASM SQLite dialect. /\nexport interface WasmSqliteConnectionSettings {\n filename: string;\n persist?: PersistMode;\n sqlJs?: SqlJsStatic;\n locateFile?: (file: string) => string;\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n Coerce JS values that sql.js cannot bind directly. Mirrors\n * `Client_BetterSQLite3._formatBindings`.\n /\nfunction formatBindings(bindings: unknown[] \| undefined): unknown[] {\n if (!bindings) return [];\n return bindings.map((b) => {\n if (b instanceof Date) return b.valueOf();\n if (typeof b === 'boolean') return Number(b);\n return b;\n });\n}\n\n/\n Mirrors the dispatch in upstream `Client_SQLite3._query`: only\n * `insert/update/counter/del` go through the row-less write path (and even\n * those switch to the read path when a `RETURNING` clause is requested).\n * Everything else — `select`, `first`, `pluck`, `columnInfo`, raw PRAGMA,\n * DDL with no `method` — is read with `all`/row iteration so Knex sees the\n * same response shape it would from better-sqlite3.\n /\nfunction isReadMethod(method?: string, returning?: unknown): boolean {\n if (method === 'insert' \|\| method === 'update') return !!returning ? true : false;\n if (method === 'counter' \|\| method === 'del') return false;\n return true;\n}\n\n/\n Resolve the upstream `knex/lib/dialects/sqlite3` class at runtime.\n \n Tries every escape hatch we have so that this works in:\n * - Plain Node ESM (use `createRequire(import.meta.url)`).\n * - Plain Node CJS (use the ambient `require` on `globalThis`).\n * - Re-bundled ESM where esbuild/tsup has stubbed `__require` — we\n * fall back to `new Function('return require')()` which evades static\n * analysis and grabs the real Node `require` at runtime.\n \n Wrapped in a function so the bundler cannot execute it at module init.\n /\nfunction resolveKnexSqlite3Dialect(): any {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const g = globalThis as any;\n if (typeof g.require === 'function') {\n try {\n return g.require('knex/lib/dialects/sqlite3');\n } catch {\n / fall through /\n }\n }\n // ESM-safe path: `createRequire` was imported statically at the top of\n // this module from `node:module`. In a pure-ESM process there is no\n // ambient `require`, so this is the only reliable way to load a CJS\n // package like `knex/lib/dialects/sqlite3`.\n return getEsmRequire()('knex/lib/dialects/sqlite3');\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedDialect: any = null;\n\n/\n Build (and cache) the `Client_WasmSqlite` class. Building lazily keeps\n * the `require('knex/lib/dialects/sqlite3')` call out of module-init\n * code so downstream re-bundlers (e.g. `packages/runtime`) cannot collapse\n * it into a Dynamic-require stub.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getClient_WasmSqlite(): any {\n if (cachedDialect) return cachedDialect;\n const Client_SQLite3 = resolveKnexSqlite3Dialect();\n\n class Client_WasmSqlite extends Client_SQLite3 {\n // sql.js has no shared \"driver module\" the way better-sqlite3 does. Knex\n // only uses `this.driver` to construct connections, and we override\n // `acquireRawConnection`, so a sentinel object is enough.\n _driver(): { name: 'sql.js' } {\n return { name: 'sql.js' };\n }\n\n async acquireRawConnection(): Promise<WasmSqliteConnection> {\n const settings = (this as any)\n .connectionSettings as WasmSqliteConnectionSettings;\n\n const conn = new WasmSqliteConnection({\n filename: settings.filename,\n persist: settings.persist,\n sqlJs: settings.sqlJs,\n locateFile: settings.locateFile,\n logger: settings.logger,\n });\n await conn.open(settings.sqlJs, settings.locateFile);\n return conn;\n }\n\n async destroyRawConnection(connection: WasmSqliteConnection): Promise<void> {\n await connection.close();\n }\n\n async _query(\n connection: WasmSqliteConnection,\n obj: any,\n ): Promise<any> {\n if (!obj.sql) throw new Error('The query is empty');\n if (!connection) throw new Error('No connection provided');\n\n const db = connection.raw;\n const bindings = formatBindings(obj.bindings);\n\n // DDL / transactional control statements have no Knex `method`. sql.js's\n // `prepare`+`step` silently no-ops on many of these (e.g. CREATE TABLE),\n // so route them through `run` which is implemented via `exec` and\n // actually mutates the database. PRAGMA is intentionally excluded — many\n // PRAGMA forms (e.g. `PRAGMA table_info(...)`, `foreign_key_list(...)`)\n // return rows used by Knex's schema introspection/columnInfo, and\n // `db.run` discards those rows.\n const isDdl =\n /^\\s(CREATE\|ALTER\|DROP\|BEGIN\|COMMIT\|ROLLBACK\|SAVEPOINT\|RELEASE\|REINDEX\|VACUUM\|ATTACH\|DETACH\|TRUNCATE)\\b/i.test(\n obj.sql,\n );\n if (isDdl) {\n db.run(obj.sql, bindings as any);\n obj.response = [];\n connection.markDirty('run');\n return obj;\n }\n\n if (isReadMethod(obj.method, obj.returning) \|\| /^\\sPRAGMA\\b/i.test(obj.sql)) {\n const stmt = db.prepare(obj.sql);\n try {\n if (bindings.length) stmt.bind(bindings as any);\n const rows: Record<string, unknown>[] = [];\n while (stmt.step()) {\n rows.push(stmt.getAsObject());\n }\n obj.response = rows;\n } finally {\n stmt.free();\n }\n return obj;\n }\n\n // Write path: execute via `run` (no row iteration needed) and capture\n // SQLite's per-connection lastID / changes counters.\n db.run(obj.sql, bindings as any);\n const changes = db.getRowsModified();\n let lastID: number \| bigint = 0;\n if (obj.method === 'insert') {\n const r = db.exec('SELECT last_insert_rowid() AS id');\n lastID = (r?.[0]?.values?.[0]?.[0] as number) ?? 0;\n }\n obj.response = [];\n obj.context = { lastID, changes };\n connection.markDirty(obj.method);\n return obj;\n }\n }\n\n Object.assign(Client_WasmSqlite.prototype, {\n dialect: 'sqlite3',\n driverName: 'wasm-sqlite',\n });\n\n cachedDialect = Client_WasmSqlite;\n return Client_WasmSqlite;\n}\n\n/\n Back-compat re-export. Prefer `getClient_WasmSqlite()` so the dialect\n * is resolved lazily; the named export triggers the factory on first\n * access of any static property.\n \n Note: importing this binding will execute the factory at import time\n * in some bundlers, which defeats the lazy pattern. New code should call\n * `getClient_WasmSqlite()` directly.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const Client_WasmSqlite: any = new Proxy(function () {} as any, {\n get(_t, prop) {\n return (getClient_WasmSqlite() as any)[prop];\n },\n construct(_t, args) {\n const Klass = getClient_WasmSqlite();\n return new Klass(...args);\n },\n apply(_t, thisArg, args) {\n const Klass = getClient_WasmSqlite();\n return Reflect.apply(Klass, thisArg, args);\n },\n});\n\nexport default Client_WasmSqlite;\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Thin wrapper over sql.js {@link Database} that mimics the surface of\n * `better-sqlite3`'s `Database` (only the methods the Knex dialect uses).\n \n Persistence is handled here, not in the Knex dialect, so it can be\n * orchestrated per-connection without polluting the SQL execution path.\n /\n\nimport type { Database, SqlJsStatic } from 'sql.js';\n\n/* When to flush the in-memory WASM database to disk. /\nexport type PersistMode =\n \| 'on-disconnect'\n \| 'on-write'\n \| `debounced:${number}`;\n\nexport interface WasmConnectionOptions {\n /\n On-disk file path. `:memory:` (or any value starting with `:`) skips\n * persistence entirely and the database lives only for the process.\n /\n filename: string;\n /* When to persist. Default: `on-disconnect`. /\n persist?: PersistMode;\n /* Pre-loaded sql.js module. If omitted, loaded lazily on first connect. /\n sqlJs?: SqlJsStatic;\n /\n Optional override for the `.wasm` locator passed to `initSqlJs()`.\n * Defaults to resolving the file from the `sql.js` package on disk\n * (works in Node and WebContainer).\n /\n locateFile?: (file: string) => string;\n /* Optional logger; defaults to `console`. /\n logger?: { warn: (msg: string, meta?: unknown) => void };\n}\n\n/* Mutation method names that should trigger a persistence cycle. /\nconst WRITE_METHODS = new Set([\n 'run',\n 'insert',\n 'update',\n 'del',\n 'counter',\n]);\n\n/\n Detect whether a Node-style `fs` module is available. WebContainer\n * (StackBlitz) provides Node `fs`; pure-browser environments do not.\n /\nasync function tryLoadFs(): Promise<typeof import('node:fs/promises') \| null> {\n try {\n return await import('node:fs/promises');\n } catch {\n return null;\n }\n}\n\n/\n Resolve a default sql.js WASM locator. We point sql.js at the `.wasm`\n * file shipped inside `sql.js`'s own `dist/` folder. This avoids requiring\n * the caller to host the WASM separately.\n /\nasync function defaultLocateFile(): Promise<((file: string) => string) \| undefined> {\n try {\n const { createRequire } = await import('node:module');\n const require = createRequire(import.meta.url);\n const pkgJsonPath = require.resolve('sql.js/package.json');\n const { dirname, join } = await import('node:path');\n const dir = dirname(pkgJsonPath);\n return (file: string) => join(dir, 'dist', file);\n } catch {\n return undefined;\n }\n}\n\nlet cachedSqlJs: Promise<SqlJsStatic> \| null = null;\n\nasync function loadSqlJs(\n locateFile?: (file: string) => string,\n): Promise<SqlJsStatic> {\n if (cachedSqlJs) return cachedSqlJs;\n cachedSqlJs = (async () => {\n const mod = await import('sql.js');\n const initSqlJs = (mod as any).default ?? (mod as any);\n const locator = locateFile ?? (await defaultLocateFile());\n const SQL = await initSqlJs(locator ? { locateFile: locator } : undefined);\n return SQL as SqlJsStatic;\n })();\n return cachedSqlJs;\n}\n\n/\n A sql.js-backed connection that exposes the `prepare`/`exec`/`close`\n * subset used by Knex's SQLite dialect. Mutations are queued through a\n * configurable persistence strategy so the on-disk file stays in sync.\n /\nexport class WasmSqliteConnection {\n readonly filename: string;\n readonly persist: PersistMode;\n readonly isEphemeral: boolean;\n\n private db!: Database;\n private fs: typeof import('node:fs/promises') \| null = null;\n private dirty = false;\n private debounceMs = 0;\n private debounceTimer: ReturnType<typeof setTimeout> \| null = null;\n private pendingFlush: Promise<void> \| null = null;\n private destroyed = false;\n private logger: { warn: (msg: string, meta?: unknown) => void };\n\n constructor(opts: WasmConnectionOptions) {\n this.filename = opts.filename;\n this.persist = opts.persist ?? 'on-disconnect';\n this.isEphemeral =\n this.filename === ':memory:' \|\| this.filename.startsWith(':');\n this.logger = opts.logger ?? console;\n\n if (typeof this.persist === 'string' && this.persist.startsWith('debounced:')) {\n const ms = Number(this.persist.slice('debounced:'.length));\n this.debounceMs = Number.isFinite(ms) && ms > 0 ? ms : 250;\n }\n }\n\n /* Open the underlying sql.js database, loading bytes from disk if any. /\n async open(sqlJs?: SqlJsStatic, locateFile?: (file: string) => string): Promise<void> {\n const SQL = sqlJs ?? (await loadSqlJs(locateFile));\n\n if (this.isEphemeral) {\n this.db = new SQL.Database();\n return;\n }\n\n this.fs = await tryLoadFs();\n if (!this.fs) {\n this.logger.warn(\n '[driver-sqlite-wasm] No node:fs available — falling back to in-memory database. ' +\n 'Data will not be persisted across reloads.',\n );\n this.db = new SQL.Database();\n return;\n }\n\n // Ensure parent directory exists, then load bytes if the file exists.\n const { dirname } = await import('node:path');\n const dir = dirname(this.filename);\n if (dir && dir !== '.') {\n await this.fs.mkdir(dir, { recursive: true });\n }\n\n let bytes: Uint8Array \| undefined;\n try {\n const buf = await this.fs.readFile(this.filename);\n bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n } catch (e: any) {\n if (e?.code !== 'ENOENT') throw e;\n }\n\n this.db = bytes ? new SQL.Database(bytes) : new SQL.Database();\n }\n\n /* Hint that a mutation just executed; schedule a flush if needed. /\n markDirty(method?: string): void {\n if (this.isEphemeral \|\| !this.fs) return;\n if (method && !WRITE_METHODS.has(method)) return;\n this.dirty = true;\n\n if (this.persist === 'on-write') {\n void this.flush();\n return;\n }\n if (this.debounceMs > 0) {\n if (this.debounceTimer) clearTimeout(this.debounceTimer);\n this.debounceTimer = setTimeout(() => {\n this.debounceTimer = null;\n void this.flush();\n }, this.debounceMs);\n }\n // 'on-disconnect' → flush only at close()\n }\n\n /* Force a write of the current database state to disk. /\n async flush(): Promise<void> {\n if (this.isEphemeral \|\| !this.fs \|\| this.destroyed) return;\n // If a flush is already in flight, wait for it and then re-flush so any\n // writes that arrived after the in-flight flush's `db.export()` call get\n // persisted too. Without this, on-write mode loses writes that happen\n // between a flush's synchronous export and its async file write.\n if (this.pendingFlush) {\n await this.pendingFlush;\n if (!this.dirty \|\| this.destroyed) return;\n }\n if (!this.dirty) return;\n\n this.pendingFlush = (async () => {\n try {\n // Snapshot dirty=false BEFORE export so concurrent writes that occur\n // during the async writeFile mark us dirty again and trigger another\n // flush via markDirty.\n this.dirty = false;\n const exported = this.db.export();\n // sql.js returns a Uint8Array; Buffer.from on it shares memory but\n // works fine for writeFile.\n await this.fs!.writeFile(this.filename, Buffer.from(exported));\n } catch (err) {\n // Restore dirty state so a subsequent flush retries.\n this.dirty = true;\n throw err;\n } finally {\n this.pendingFlush = null;\n }\n })();\n\n await this.pendingFlush;\n\n // A write that arrived after `db.export()` (synchronous) but before the\n // file write completed will have set dirty=true again. Re-flush to\n // persist it.\n if (this.dirty && !this.destroyed) {\n await this.flush();\n }\n }\n\n /* Close the database, flushing any pending writes first. /\n async close(): Promise<void> {\n if (this.destroyed) return;\n if (this.debounceTimer) {\n clearTimeout(this.debounceTimer);\n this.debounceTimer = null;\n }\n try {\n await this.flush();\n } finally {\n this.destroyed = true;\n try {\n this.db.close();\n } catch {\n / ignore /\n }\n }\n }\n\n /* Access the raw sql.js database (for the Knex dialect). */\n get raw(): Database {\n return this.db;\n }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { SqliteWasmDriver } from './sqlite-wasm-driver.js';\n\nexport { SqliteWasmDriver };\nexport type { SqliteWasmDriverConfig } from './sqlite-wasm-driver.js';\nexport { Client_WasmSqlite } from './knex-wasm-dialect.js';\nexport type { WasmSqliteConnectionSettings } from './knex-wasm-dialect.js';\nexport { WasmSqliteConnection } from './wasm-connection.js';\nexport type { PersistMode, WasmConnectionOptions } from './wasm-connection.js';\n\nexport default {\n id: 'com.objectstack.driver.sqlite-wasm',\n version: '1.0.0',\n\n onEnable: async (context: any) => {\n const { logger, config, drivers } = context;\n logger?.info?.('[SQLite-WASM Driver] Initializing...');\n\n if (drivers) {\n const driver = new SqliteWasmDriver(config);\n drivers.register(driver);\n logger?.info?.(`[SQLite-WASM Driver] Registered driver: ${driver.name}`);\n } else {\n logger?.warn?.('[SQLite-WASM Driver] No driver registry found in context.');\n }\n },\n};\n"],"mappings":"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","names":["createRequire","require","Client_WasmSqlite"]}
1	+ {"version":3,"sources":["../src/sqlite-wasm-driver.ts","../src/knex-wasm-dialect.ts","../src/wasm-connection.ts","../src/index.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/*\n SQLite-on-WASM driver for ObjectStack.\n \n Extends {@link SqlDriver} so all CRUD / schema / introspection / multi-tenant\n * logic is inherited as-is. Only the Knex transport is swapped to a custom\n * dialect ({@link Client_WasmSqlite}) backed by sql.js + Node `fs` persistence,\n * which lets the same `SqlDriver` codepath run inside StackBlitz WebContainer\n * (Node-in-browser) without the native `better-sqlite3` N-API binding.\n /\n\nimport type { SqlJsStatic } from 'sql.js';\nimport { SqlDriver, type SqlDriverConfig } from '@objectstack/driver-sql';\n\nimport { getClient_WasmSqlite } from './knex-wasm-dialect.js';\nimport type {\n PersistMode,\n WasmConnectionOptions,\n} from './wasm-connection.js';\n\n/* Public configuration for {@link SqliteWasmDriver}. /\nexport interface SqliteWasmDriverConfig {\n /\n SQLite filename. Use `:memory:` for an ephemeral database that is never\n * persisted. Any other value is treated as a Node `fs` path and the\n * sql.js database bytes are flushed back to disk according to {@link persist}.\n /\n filename: string;\n\n /\n Persistence strategy. Default: `'on-disconnect'`.\n \n - `'on-disconnect'` — flush once when the driver disconnects (and on\n * `process.beforeExit`).\n * - `'on-write'` — flush after every mutation. Safest, slowest.\n * - `` `debounced:${ms}` `` — debounce flushes by N milliseconds. Good\n * balance under bursty writes.\n /\n persist?: PersistMode;\n\n /* Pre-loaded sql.js module — skips lazy import. /\n sqlJs?: SqlJsStatic;\n\n /\n Override for sql.js's `locateFile`. Defaults to resolving the `.wasm`\n * file inside the installed `sql.js` package, which works in Node and\n * WebContainer.\n /\n locateFile?: (file: string) => string;\n\n /* Knex pool overrides. The dialect already defaults to `{ min: 1, max: 1 }`. /\n pool?: SqlDriverConfig['pool'];\n\n /* Optional logger. Defaults to `console`. /\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n SqlDriver subclass that runs Knex against sql.js (WASM SQLite).\n \n Behaves identically to the standard SQLite path — the dialect's\n * {@link Client_WasmSqlite._query} reports `lastID`/`changes` exactly the\n * way better-sqlite3 does, so {@link SqlDriver}'s SQL generation, returning\n * clauses, and schema introspection all keep working.\n /\nexport class SqliteWasmDriver extends SqlDriver {\n public override readonly name: string = 'com.objectstack.driver.sqlite-wasm';\n public override readonly version: string = '1.0.0';\n\n /\n Force the SQLite branch in {@link SqlDriver}. The base class detects\n * SQLite by string-matching `config.client`, but we pass the dialect class\n * directly so the string check would miss.\n /\n protected override get isSqlite(): boolean {\n return true;\n }\n\n private wasmConfig: SqliteWasmDriverConfig;\n private beforeExitHandler: (() => void) \| null = null;\n\n constructor(config: SqliteWasmDriverConfig) {\n const knexConfig = SqliteWasmDriver.toKnexConfig(config);\n super(knexConfig);\n this.wasmConfig = config;\n if (config.logger) this.logger = config.logger as any;\n }\n\n /* Translate the public config into a Knex config that uses our dialect. /\n static toKnexConfig(config: SqliteWasmDriverConfig): SqlDriverConfig {\n return {\n // Knex accepts a Client class as `client`. The dialect's `driverName`\n // is `'wasm-sqlite'` and its `dialect` is `'sqlite3'` so the SQLite\n // query compiler is reused.\n client: getClient_WasmSqlite() as any,\n connection: {\n filename: config.filename,\n persist: config.persist,\n sqlJs: config.sqlJs,\n locateFile: config.locateFile,\n logger: config.logger,\n } as any,\n // sql.js is single-threaded WASM — a single connection per pool keeps\n // semantics consistent with the upstream SQLite dialect.\n pool: config.pool ?? { min: 1, max: 1 },\n useNullAsDefault: true,\n } as SqlDriverConfig;\n }\n\n override async connect(): Promise<void> {\n await super.connect();\n\n // Best-effort flush on process exit so `on-disconnect` mode still saves\n // user data if the host process is shut down without explicit cleanup.\n if (\n this.wasmConfig.filename !== ':memory:' &&\n !this.wasmConfig.filename.startsWith(':') &&\n typeof process !== 'undefined' &&\n typeof process.once === 'function'\n ) {\n this.beforeExitHandler = () => {\n // Fire-and-forget — beforeExit cannot await.\n void this.flush().catch(() => {\n / ignore /\n });\n };\n process.once('beforeExit', this.beforeExitHandler);\n }\n }\n\n override async disconnect(): Promise<void> {\n if (this.beforeExitHandler && typeof process !== 'undefined') {\n try {\n process.removeListener('beforeExit', this.beforeExitHandler);\n } catch {\n / ignore /\n }\n this.beforeExitHandler = null;\n }\n await super.disconnect();\n }\n\n /\n Force a flush of the in-memory database to disk. No-op for ephemeral\n * databases or when no fs is available.\n /\n async flush(): Promise<void> {\n // Reach into the Knex pool and ask every live connection to flush.\n const knex = (this as any).knex;\n const client = knex?.client;\n const pool = client?.pool;\n if (!pool \|\| typeof pool.numUsed !== 'function') return;\n\n const acquire = client.acquireConnection?.bind(client);\n const release = client.releaseConnection?.bind(client);\n if (!acquire \|\| !release) return;\n\n const conn = await acquire();\n try {\n if (conn && typeof conn.flush === 'function') {\n await conn.flush();\n }\n } finally {\n await release(conn);\n }\n }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Custom Knex SQLite dialect backed by sql.js (WASM SQLite).\n \n Mimics the surface that `Client_BetterSQLite3` presents to Knex so the\n * upstream SQLite3 dialect's query compiler, schema builder, and column\n * compiler all keep working unchanged. Only the transport layer —\n * `_driver` / `acquireRawConnection` / `_query` — is swapped out.\n \n ## Why the dialect class is built lazily\n \n The class `Client_WasmSqlite extends Client_SQLite3` needs the upstream\n * SQLite3 dialect at class-definition time. Resolving it at module\n * top-level breaks when this file is re-bundled by another tsup/esbuild\n * pass (e.g. `packages/runtime`), because that pass rewrites our runtime\n * `createRequire(import.meta.url)` chain back into a static `__require2`\n * Proxy stub that throws `Dynamic require of \"X\" is not supported`.\n \n Building the class inside a lazy factory (`getClient_WasmSqlite()`)\n * keeps the `require` call out of module-init code, so the re-bundler\n * cannot intercept it.\n /\n\nimport { createRequire } from 'node:module';\n\nimport type { SqlJsStatic } from 'sql.js';\n\nimport {\n WasmSqliteConnection,\n type PersistMode,\n type WasmConnectionOptions,\n} from './wasm-connection.js';\n\n// Built lazily — `node:module` is a Node builtin and is left untouched\n// by esbuild/tsup, so the `createRequire` import survives downstream\n// re-bundling. We defer the actual `createRequire(...)` call so that the\n// CJS build (where `import.meta.url` is empty) doesn't blow up at module\n// init; the CJS path uses `globalThis.require` directly anyway.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedEsmRequire: any = null;\nfunction getEsmRequire(): any {\n if (cachedEsmRequire) return cachedEsmRequire;\n // `import.meta.url` is replaced with an empty string in CJS output;\n // fall back to the current file/cwd in that case.\n const anchor =\n typeof import.meta !== 'undefined' && (import.meta as any).url\n ? (import.meta as any).url\n : typeof __filename !== 'undefined'\n ? __filename\n : process.cwd() + '/';\n cachedEsmRequire = createRequire(anchor);\n return cachedEsmRequire;\n}\n\n/* Connection settings recognised by the WASM SQLite dialect. /\nexport interface WasmSqliteConnectionSettings {\n filename: string;\n persist?: PersistMode;\n sqlJs?: SqlJsStatic;\n locateFile?: (file: string) => string;\n logger?: WasmConnectionOptions['logger'];\n}\n\n/\n Coerce JS values that sql.js cannot bind directly. Mirrors\n * `Client_BetterSQLite3._formatBindings`.\n /\nfunction formatBindings(bindings: unknown[] \| undefined): unknown[] {\n if (!bindings) return [];\n return bindings.map((b) => {\n if (b instanceof Date) return b.valueOf();\n if (typeof b === 'boolean') return Number(b);\n return b;\n });\n}\n\n/\n Mirrors the dispatch in upstream `Client_SQLite3._query`: only\n * `insert/update/counter/del` go through the row-less write path (and even\n * those switch to the read path when a `RETURNING` clause is requested).\n * Everything else — `select`, `first`, `pluck`, `columnInfo`, raw PRAGMA,\n * DDL with no `method` — is read with `all`/row iteration so Knex sees the\n * same response shape it would from better-sqlite3.\n /\nfunction isReadMethod(method?: string, returning?: unknown): boolean {\n if (method === 'insert' \|\| method === 'update') return !!returning ? true : false;\n if (method === 'counter' \|\| method === 'del') return false;\n return true;\n}\n\n/\n Resolve the upstream `knex/lib/dialects/sqlite3` class at runtime.\n \n Tries every escape hatch we have so that this works in:\n * - Plain Node ESM (use `createRequire(import.meta.url)`).\n * - Plain Node CJS (use the ambient `require` on `globalThis`).\n * - Re-bundled ESM where esbuild/tsup has stubbed `__require` — we\n * fall back to `new Function('return require')()` which evades static\n * analysis and grabs the real Node `require` at runtime.\n \n Wrapped in a function so the bundler cannot execute it at module init.\n /\nfunction resolveKnexSqlite3Dialect(): any {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const g = globalThis as any;\n if (typeof g.require === 'function') {\n try {\n return g.require('knex/lib/dialects/sqlite3');\n } catch {\n / fall through /\n }\n }\n // ESM-safe path: `createRequire` was imported statically at the top of\n // this module from `node:module`. In a pure-ESM process there is no\n // ambient `require`, so this is the only reliable way to load a CJS\n // package like `knex/lib/dialects/sqlite3`.\n return getEsmRequire()('knex/lib/dialects/sqlite3');\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet cachedDialect: any = null;\n\n/\n Build (and cache) the `Client_WasmSqlite` class. Building lazily keeps\n * the `require('knex/lib/dialects/sqlite3')` call out of module-init\n * code so downstream re-bundlers (e.g. `packages/runtime`) cannot collapse\n * it into a Dynamic-require stub.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getClient_WasmSqlite(): any {\n if (cachedDialect) return cachedDialect;\n const Client_SQLite3 = resolveKnexSqlite3Dialect();\n\n class Client_WasmSqlite extends Client_SQLite3 {\n // sql.js has no shared \"driver module\" the way better-sqlite3 does. Knex\n // only uses `this.driver` to construct connections, and we override\n // `acquireRawConnection`, so a sentinel object is enough.\n _driver(): { name: 'sql.js' } {\n return { name: 'sql.js' };\n }\n\n async acquireRawConnection(): Promise<WasmSqliteConnection> {\n const settings = (this as any)\n .connectionSettings as WasmSqliteConnectionSettings;\n\n const conn = new WasmSqliteConnection({\n filename: settings.filename,\n persist: settings.persist,\n sqlJs: settings.sqlJs,\n locateFile: settings.locateFile,\n logger: settings.logger,\n });\n await conn.open(settings.sqlJs, settings.locateFile);\n return conn;\n }\n\n async destroyRawConnection(connection: WasmSqliteConnection): Promise<void> {\n await connection.close();\n }\n\n async _query(\n connection: WasmSqliteConnection,\n obj: any,\n ): Promise<any> {\n if (!obj.sql) throw new Error('The query is empty');\n if (!connection) throw new Error('No connection provided');\n\n const db = connection.raw;\n const bindings = formatBindings(obj.bindings);\n\n // DDL / transactional control statements have no Knex `method`. sql.js's\n // `prepare`+`step` silently no-ops on many of these (e.g. CREATE TABLE),\n // so route them through `run` which is implemented via `exec` and\n // actually mutates the database. PRAGMA is intentionally excluded — many\n // PRAGMA forms (e.g. `PRAGMA table_info(...)`, `foreign_key_list(...)`)\n // return rows used by Knex's schema introspection/columnInfo, and\n // `db.run` discards those rows.\n const isDdl =\n /^\\s(CREATE\|ALTER\|DROP\|BEGIN\|COMMIT\|ROLLBACK\|SAVEPOINT\|RELEASE\|REINDEX\|VACUUM\|ATTACH\|DETACH\|TRUNCATE)\\b/i.test(\n obj.sql,\n );\n if (isDdl) {\n db.run(obj.sql, bindings as any);\n obj.response = [];\n // Transaction-control statements are routed through\n // `noteTransactionControl`, which owns flushing for the transaction\n // lifecycle: it suppresses flushes while a transaction is open (sql.js\n // `export()` closes+reopens the db, which would abort the txn) and\n // performs a single flush once the transaction fully closes. Routing\n // them away from `markDirty` avoids a second, racing flush on COMMIT.\n if (/^\\s(BEGIN\|COMMIT\|END\|ROLLBACK\|SAVEPOINT\|RELEASE)\\b/i.test(obj.sql)) {\n connection.noteTransactionControl(obj.sql);\n } else {\n connection.markDirty('run');\n }\n return obj;\n }\n\n if (isReadMethod(obj.method, obj.returning) \|\| /^\\sPRAGMA\\b/i.test(obj.sql)) {\n const stmt = db.prepare(obj.sql);\n try {\n if (bindings.length) stmt.bind(bindings as any);\n const rows: Record<string, unknown>[] = [];\n while (stmt.step()) {\n rows.push(stmt.getAsObject());\n }\n obj.response = rows;\n } finally {\n stmt.free();\n }\n return obj;\n }\n\n // Write path: execute via `run` (no row iteration needed) and capture\n // SQLite's per-connection lastID / changes counters.\n db.run(obj.sql, bindings as any);\n const changes = db.getRowsModified();\n let lastID: number \| bigint = 0;\n if (obj.method === 'insert') {\n const r = db.exec('SELECT last_insert_rowid() AS id');\n lastID = (r?.[0]?.values?.[0]?.[0] as number) ?? 0;\n }\n obj.response = [];\n obj.context = { lastID, changes };\n connection.markDirty(obj.method);\n return obj;\n }\n }\n\n Object.assign(Client_WasmSqlite.prototype, {\n dialect: 'sqlite3',\n driverName: 'wasm-sqlite',\n });\n\n cachedDialect = Client_WasmSqlite;\n return Client_WasmSqlite;\n}\n\n/*\n Back-compat re-export. Prefer `getClient_WasmSqlite()` so the dialect\n * is resolved lazily; the named export triggers the factory on first\n * access of any static property.\n \n Note: importing this binding will execute the factory at import time\n * in some bundlers, which defeats the lazy pattern. New code should call\n * `getClient_WasmSqlite()` directly.\n /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport const Client_WasmSqlite: any = new Proxy(function () {} as any, {\n get(_t, prop) {\n return (getClient_WasmSqlite() as any)[prop];\n },\n construct(_t, args) {\n const Klass = getClient_WasmSqlite();\n return new Klass(...args);\n },\n apply(_t, thisArg, args) {\n const Klass = getClient_WasmSqlite();\n return Reflect.apply(Klass, thisArg, args);\n },\n});\n\nexport default Client_WasmSqlite;\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n Thin wrapper over sql.js {@link Database} that mimics the surface of\n * `better-sqlite3`'s `Database` (only the methods the Knex dialect uses).\n \n Persistence is handled here, not in the Knex dialect, so it can be\n * orchestrated per-connection without polluting the SQL execution path.\n /\n\nimport type { Database, SqlJsStatic } from 'sql.js';\n\n/* When to flush the in-memory WASM database to disk. /\nexport type PersistMode =\n \| 'on-disconnect'\n \| 'on-write'\n \| `debounced:${number}`;\n\nexport interface WasmConnectionOptions {\n /\n On-disk file path. `:memory:` (or any value starting with `:`) skips\n * persistence entirely and the database lives only for the process.\n /\n filename: string;\n /* When to persist. Default: `on-disconnect`. /\n persist?: PersistMode;\n /* Pre-loaded sql.js module. If omitted, loaded lazily on first connect. /\n sqlJs?: SqlJsStatic;\n /\n Optional override for the `.wasm` locator passed to `initSqlJs()`.\n * Defaults to resolving the file from the `sql.js` package on disk\n * (works in Node and WebContainer).\n /\n locateFile?: (file: string) => string;\n /* Optional logger; defaults to `console`. /\n logger?: { warn: (msg: string, meta?: unknown) => void };\n}\n\n/* Mutation method names that should trigger a persistence cycle. /\nconst WRITE_METHODS = new Set([\n 'run',\n 'insert',\n 'update',\n 'del',\n 'counter',\n]);\n\n/\n Detect whether a Node-style `fs` module is available. WebContainer\n * (StackBlitz) provides Node `fs`; pure-browser environments do not.\n /\nasync function tryLoadFs(): Promise<typeof import('node:fs/promises') \| null> {\n try {\n return await import('node:fs/promises');\n } catch {\n return null;\n }\n}\n\n/\n Resolve a default sql.js WASM locator. We point sql.js at the `.wasm`\n * file shipped inside `sql.js`'s own `dist/` folder. This avoids requiring\n * the caller to host the WASM separately.\n /\nasync function defaultLocateFile(): Promise<((file: string) => string) \| undefined> {\n try {\n const { createRequire } = await import('node:module');\n const require = createRequire(import.meta.url);\n const pkgJsonPath = require.resolve('sql.js/package.json');\n const { dirname, join } = await import('node:path');\n const dir = dirname(pkgJsonPath);\n return (file: string) => join(dir, 'dist', file);\n } catch {\n return undefined;\n }\n}\n\nlet cachedSqlJs: Promise<SqlJsStatic> \| null = null;\n\nasync function loadSqlJs(\n locateFile?: (file: string) => string,\n): Promise<SqlJsStatic> {\n if (cachedSqlJs) return cachedSqlJs;\n cachedSqlJs = (async () => {\n const mod = await import('sql.js');\n const initSqlJs = (mod as any).default ?? (mod as any);\n const locator = locateFile ?? (await defaultLocateFile());\n const SQL = await initSqlJs(locator ? { locateFile: locator } : undefined);\n return SQL as SqlJsStatic;\n })();\n return cachedSqlJs;\n}\n\n/\n A sql.js-backed connection that exposes the `prepare`/`exec`/`close`\n * subset used by Knex's SQLite dialect. Mutations are queued through a\n * configurable persistence strategy so the on-disk file stays in sync.\n /\nexport class WasmSqliteConnection {\n readonly filename: string;\n readonly persist: PersistMode;\n readonly isEphemeral: boolean;\n\n private db!: Database;\n private fs: typeof import('node:fs/promises') \| null = null;\n private dirty = false;\n private debounceMs = 0;\n private debounceTimer: ReturnType<typeof setTimeout> \| null = null;\n private flushChain: Promise<void> \| null = null;\n private destroyed = false;\n private logger: { warn: (msg: string, meta?: unknown) => void };\n\n /\n Whether a `BEGIN…COMMIT/ROLLBACK` transaction is currently open. Tracked\n * because sql.js's {@link Database.export} closes and reopens the database\n * (it has no in-place serialize), and closing a connection rolls back any\n * open transaction. Flushing mid-transaction would therefore silently\n * abort it, leaving the eventual `COMMIT` to fail with\n * \"cannot commit - no transaction is active\". We defer the flush until the\n * transaction fully closes. See {@link noteTransactionControl}.\n /\n private rootTxActive = false;\n /* Open `SAVEPOINT` depth (nested transactions emitted by Knex). /\n private savepointDepth = 0;\n /* A flush was requested while a transaction was open; run it on close. /\n private flushDeferred = false;\n\n /* True while any transaction (root or savepoint) is in flight. /\n private get inTransaction(): boolean {\n return this.rootTxActive \|\| this.savepointDepth > 0;\n }\n\n constructor(opts: WasmConnectionOptions) {\n this.filename = opts.filename;\n this.persist = opts.persist ?? 'on-disconnect';\n this.isEphemeral =\n this.filename === ':memory:' \|\| this.filename.startsWith(':');\n this.logger = opts.logger ?? console;\n\n if (typeof this.persist === 'string' && this.persist.startsWith('debounced:')) {\n const ms = Number(this.persist.slice('debounced:'.length));\n this.debounceMs = Number.isFinite(ms) && ms > 0 ? ms : 250;\n }\n }\n\n /* Open the underlying sql.js database, loading bytes from disk if any. /\n async open(sqlJs?: SqlJsStatic, locateFile?: (file: string) => string): Promise<void> {\n const SQL = sqlJs ?? (await loadSqlJs(locateFile));\n\n if (this.isEphemeral) {\n this.db = new SQL.Database();\n return;\n }\n\n this.fs = await tryLoadFs();\n if (!this.fs) {\n this.logger.warn(\n '[driver-sqlite-wasm] No node:fs available — falling back to in-memory database. ' +\n 'Data will not be persisted across reloads.',\n );\n this.db = new SQL.Database();\n return;\n }\n\n // Ensure parent directory exists, then load bytes if the file exists.\n const { dirname } = await import('node:path');\n const dir = dirname(this.filename);\n if (dir && dir !== '.') {\n await this.fs.mkdir(dir, { recursive: true });\n }\n\n let bytes: Uint8Array \| undefined;\n try {\n const buf = await this.fs.readFile(this.filename);\n bytes = new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n } catch (e: any) {\n if (e?.code !== 'ENOENT') throw e;\n }\n\n this.db = bytes ? new SQL.Database(bytes) : new SQL.Database();\n }\n\n /\n Update transaction state from a transaction-control statement and, when a\n * transaction has just fully closed, run any flush that was deferred while\n * it was open. Called by the Knex dialect for every `BEGIN` / `COMMIT` /\n * `ROLLBACK` / `SAVEPOINT` / `RELEASE` statement.\n \n We bias toward \"in transaction\": an unrecognised form leaves the flag set,\n * which at worst delays a flush (safe) rather than exporting mid-transaction\n * (which would abort it).\n /\n noteTransactionControl(sql: string): void {\n const s = sql.trim().toUpperCase();\n if (/^BEGIN\\b/.test(s)) {\n this.rootTxActive = true;\n } else if (/^(COMMIT\|END)\\b/.test(s)) {\n // A COMMIT/END ends the whole transaction regardless of savepoint nesting.\n this.rootTxActive = false;\n this.savepointDepth = 0;\n } else if (/^ROLLBACK\\s+TO\\b/.test(s)) {\n // Rolls back to a savepoint but keeps the (outer) transaction open.\n } else if (/^ROLLBACK\\b/.test(s)) {\n this.rootTxActive = false;\n this.savepointDepth = 0;\n } else if (/^SAVEPOINT\\b/.test(s)) {\n this.savepointDepth += 1;\n } else if (/^RELEASE\\b/.test(s)) {\n this.savepointDepth = Math.max(0, this.savepointDepth - 1);\n }\n // If the transaction just fully closed and a flush was deferred while it\n // was open, run it now. We key off `flushDeferred` (set only when\n // `markDirty` actually wanted to flush) rather than `dirty`, so persist\n // modes that don't flush per-write — e.g. `on-disconnect` — still defer to\n // close() instead of flushing on every COMMIT.\n if (!this.inTransaction && this.flushDeferred) {\n this.flushDeferred = false;\n void this.flush();\n }\n }\n\n /* Hint that a mutation just executed; schedule a flush if needed. /\n markDirty(method?: string): void {\n if (this.isEphemeral \|\| !this.fs) return;\n if (method && !WRITE_METHODS.has(method)) return;\n this.dirty = true;\n\n if (this.persist === 'on-write') {\n void this.flush();\n return;\n }\n if (this.debounceMs > 0) {\n if (this.debounceTimer) clearTimeout(this.debounceTimer);\n this.debounceTimer = setTimeout(() => {\n this.debounceTimer = null;\n void this.flush();\n }, this.debounceMs);\n }\n // 'on-disconnect' → flush only at close()\n }\n\n /\n Force a write of the current database state to disk.\n \n Flushes are strictly serialized through a single promise chain: every call\n * appends an export+write step that runs after all previously-queued steps.\n * This matters because sql.js `export()` mutates the live connection (it\n * closes and reopens the database), so two exports must never overlap — and\n * because the returned promise must not resolve until the caller's own write\n * has hit disk (deterministic for tests and for `close()`). Each step\n * re-checks `dirty` at run time, so a no-op write collapses cheaply and a\n * write that arrived mid-flush is captured by the next queued step.\n /\n async flush(): Promise<void> {\n if (this.isEphemeral \|\| !this.fs \|\| this.destroyed) return;\n // Never export while a transaction is open: sql.js's `export()` closes and\n // reopens the database, which rolls back the in-flight transaction and\n // makes the subsequent COMMIT fail. Defer until the transaction closes\n // (handled in `noteTransactionControl`).\n if (this.inTransaction) {\n this.flushDeferred = true;\n return;\n }\n\n const prev = this.flushChain;\n const step = (prev ?? Promise.resolve()).then(async () => {\n if (!this.dirty \|\| this.destroyed \|\| this.inTransaction) return;\n // Snapshot dirty=false before export so a concurrent write re-marks us\n // and is picked up by the next queued step.\n this.dirty = false;\n try {\n const exported = this.db.export();\n // sql.js returns a Uint8Array; Buffer.from on it shares memory but\n // works fine for the synchronous writeFile enqueue below.\n await this.fs!.writeFile(this.filename, Buffer.from(exported));\n } catch (err) {\n this.dirty = true; // let a later flush retry\n throw err;\n }\n });\n // Keep the chain tail alive but swallow its rejection there so one failed\n // flush doesn't poison every future flush; the awaited `step` still throws.\n this.flushChain = step.catch(() => {});\n await step;\n }\n\n /* Close the database, flushing any pending writes first. /\n async close(): Promise<void> {\n if (this.destroyed) return;\n if (this.debounceTimer) {\n clearTimeout(this.debounceTimer);\n this.debounceTimer = null;\n }\n // Any transaction still open at close is abandoned and will be rolled back\n // by `db.close()`; clear the flag so the final flush is not deferred and\n // already-committed data is persisted.\n this.rootTxActive = false;\n this.savepointDepth = 0;\n try {\n await this.flush();\n } finally {\n this.destroyed = true;\n try {\n this.db.close();\n } catch {\n / ignore /\n }\n }\n }\n\n /* Access the raw sql.js database (for the Knex dialect). */\n get raw(): Database {\n return this.db;\n }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { SqliteWasmDriver } from './sqlite-wasm-driver.js';\n\nexport { SqliteWasmDriver };\nexport type { SqliteWasmDriverConfig } from './sqlite-wasm-driver.js';\nexport { Client_WasmSqlite } from './knex-wasm-dialect.js';\nexport type { WasmSqliteConnectionSettings } from './knex-wasm-dialect.js';\nexport { WasmSqliteConnection } from './wasm-connection.js';\nexport type { PersistMode, WasmConnectionOptions } from './wasm-connection.js';\n\nexport default {\n id: 'com.objectstack.driver.sqlite-wasm',\n version: '1.0.0',\n\n onEnable: async (context: any) => {\n const { logger, config, drivers } = context;\n logger?.info?.('[SQLite-WASM Driver] Initializing...');\n\n if (drivers) {\n const driver = new SqliteWasmDriver(config);\n drivers.register(driver);\n logger?.info?.(`[SQLite-WASM Driver] Registered driver: ${driver.name}`);\n } else {\n logger?.warn?.('[SQLite-WASM Driver] No driver registry found in context.');\n }\n },\n};\n"],"mappings":"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","names":["createRequire","require","Client_WasmSqlite"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/driver-sqlite-wasm",
-  "version": "7.5.0",
+  "version": "7.6.0",
   "license": "Apache-2.0",
   "description": "WASM SQLite Driver for ObjectStack — runs in browser/WebContainer (StackBlitz) without native bindings",
   "keywords": [
@@ -26,9 +26,9 @@
     "knex": "^3.2.10",
     "nanoid": "^5.1.11",
     "sql.js": "^1.14.1",
-    "@objectstack/core": "7.5.0",
-    "@objectstack/driver-sql": "7.5.0",
-    "@objectstack/spec": "7.5.0"
+    "@objectstack/core": "7.6.0",
+    "@objectstack/driver-sql": "7.6.0",
+    "@objectstack/spec": "7.6.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",