@objectstack/driver-sqlite-wasm 17.0.0-rc.1 → 17.0.0-rc.2

package/CHANGELOG.md

@@ -1,5 +1,211 @@
 # @objectstack/driver-sqlite-wasm
 
+## 17.0.0-rc.2
+
+### Patch Changes
+
+- 9b43ee2: test(drivers): the filter-logic standard now covers the backend it was counted without (#4405)
+
+  `FILTER_LOGIC_CASES` (#3774) opens by calling itself the standard "the four
+  independent FilterCondition backends are each checked against". Five backends
+  exist. `driver-mongodb`'s `translateFilter` was missed, not excluded — an
+  independent implementation whose `$and`/`$or`/`$not` translation shares no line
+  of code with the SQL compiler or the in-memory matcher, and the only one whose
+  target language cannot spell the standard directly: MongoDB has no
+  document-level `$not` at all (the server answers `unknown top level operator:
+$not`), so a negation has to leave as `$nor`, and a branch's own keys have to
+  stay in one document while `$and`/`$or` clauses are lifted beside them. That
+  route was never checked against the shared cases. Both DEBT rows the #4363 gate
+  recorded are now cleared, and `scripts/check-driver-conformance.mjs` reports
+  `ok` for every cell of the matrix.
+
+  **`driver-mongodb` runs the table twice, and the split is deliberate.**
+  `mongodb-filter-logic-translation.test.ts` drives every shared case through
+  `translateFilter` and evaluates the emitted MongoDB _document_ over the shared
+  fixture — a pure function, no server, so it always runs. That matters here more
+  than anywhere: `mongodb-memory-server` downloads a ~123 MB binary from
+  fastdl.mongodb.org, and a defect only a downloadable binary can catch is a
+  defect nobody catches on a restricted network. Its in-process reader is strict
+  by construction — every shape it does not model throws instead of evaluating to
+  true, a document-level `$not` included — and its own discrimination is pinned by
+  cases that require a widened document to FAIL the case it widens, so "all green"
+  cannot mean "the reader says yes to everything".
+  `mongodb-filter-logic-conformance.test.ts` runs the same table against a real
+  mongod and answers the one question the first half cannot — does MongoDB agree?
+  — skipping cleanly (never silently) when the binary is unreachable.
+
+  **`driver-sqlite-wasm` runs the table through its own engine.** It inherits
+  `SqlDriver`'s filter compiler, so nothing is re-implemented; what the suite pins
+  is that a nested `(… AND …) OR (… AND …)` survives the custom sql.js dialect
+  that compiles, binds and marshals it — the same seam its temporal and pagination
+  suites cover for their clauses. Tracked as DEBT rather than EXEMPT because
+  "inherits, therefore fine" is the assumption those suites exist to disprove; the
+  suite is what disproves it.
+
+  **No divergence was found.** `translateFilter` answers all seventeen shared
+  cases correctly today, `$not`-inside-a-branch and nested `$and`-inside-`$or`
+  included, so no translation change ships here — what changes is that the next
+  edit to it cannot quietly widen a filter. Both suites were verified to be
+  discriminating rather than decorative by reintroducing the #3774 miscompile
+  (propagating `or` into a branch's own contents): 15 of the mongodb translation
+  suite's 26 tests fail, and 13 of the wasm suite's 18.
+
+  `packages/spec`'s `filter-logic-conformance.ts` header now says five and names
+  the fifth — a code comment; no schema, export or generated artifact moved.
+
+- 24915d2: fix(driver-sqlite-wasm): a `RETURNING` write is a write — persist it (#4518)
+
+  A file-backed `sqlite-wasm` database flushed its schema at boot and then
+  recorded nothing else. Every table was on disk; every row written after schema
+  sync lived only in the WASM heap and died with the process. Reopening the file
+  found a complete, empty database.
+
+  **Cause.** The Knex dialect picked its execution branch from _"does this
+  statement return rows"_ — and then marked the database dirty only on the other,
+  row-less branch. `INSERT … RETURNING *` returns rows, so it executed on the
+  row-returning branch and never set the flag. Since the `on-disconnect` flush is
+  gated on the same flag, nothing rescued it afterwards either: **both** persist
+  strategies dropped the write. ObjectQL writes through `RETURNING *` (it hands
+  the stored row back to the caller), so this covered essentially all business
+  data, along with `knex.raw('INSERT …')` and any other mutation arriving without
+  a Knex `method`.
+
+  **Fix.** "Does this statement change the database?" is now one exported
+  predicate — `statementMutatesDatabase(sql, method)` — classifying by Knex method
+  _and_ SQL text, applied at a single funnel after execution. It is independent of
+  which branch executed the statement, so a mutation can no longer slip through by
+  returning rows, by arriving without a method, or by taking a branch that forgot
+  to say so. Transaction control still routes to `noteTransactionControl`, which
+  keeps deferring flushes until the transaction closes (#1494), and mutating
+  `PRAGMA` assignments (`auto_vacuum`, `user_version`) now count as writes too.
+
+  **What changes for you.** Nothing to author. File-backed wasm SQLite now
+  actually persists under `on-write` / `debounced:*`, and `disconnect()` is a real
+  durability boundary: when it returns, committed data is on disk. This is what
+  `bootStack({ databaseFile })` in `@objectstack/verify` needed to make `stop()` →
+  second `bootStack` a genuine cold boot — the suspended-run restart proof
+  ADR-0019 promises is now asserted end to end in the dogfood gate. Expect more
+  disk writes than before on a file-backed dev database, because previously there
+  were almost none.
+
+  **One internal signature moved.** `WasmSqliteConnection.markDirty(method?)` is
+  now `markDirty()`. It used to re-filter the caller's Knex method against its own
+  allowlist, which made "did this mutate?" a decision taken in two places that
+  could — and did — disagree. If you call it directly, drop the argument; the
+  dialect classifies, the connection obeys.
+
+- Updated dependencies [430dcc2]
+- Updated dependencies [e6ac4bd]
+- Updated dependencies [80334c7]
+- Updated dependencies [ce5242c]
+- Updated dependencies [a7163ea]
+- Updated dependencies [e6e9379]
+- Updated dependencies [98877c9]
+- Updated dependencies [98877c9]
+- Updated dependencies [e6b1b69]
+- Updated dependencies [ad047d2]
+- Updated dependencies [2826d1e]
+- Updated dependencies [5a84d41]
+- Updated dependencies [20b1a9e]
+- Updated dependencies [203a449]
+- Updated dependencies [ac37fc6]
+- Updated dependencies [4820f55]
+- Updated dependencies [462d9c4]
+- Updated dependencies [7d21581]
+- Updated dependencies [f2445c9]
+- Updated dependencies [23338c3]
+- Updated dependencies [5b843fb]
+- Updated dependencies [b4487aa]
+- Updated dependencies [65ca83a]
+- Updated dependencies [67bf2e2]
+- Updated dependencies [c6d1cb4]
+- Updated dependencies [36030ff]
+- Updated dependencies [6117f7b]
+- Updated dependencies [e533b0b]
+- Updated dependencies [cdf4d9a]
+- Updated dependencies [aee1806]
+- Updated dependencies [c13350b]
+- Updated dependencies [c13350b]
+- Updated dependencies [9ca2d85]
+- Updated dependencies [c13350b]
+- Updated dependencies [891d345]
+- Updated dependencies [a52e2ef]
+- Updated dependencies [5293114]
+- Updated dependencies [20bc357]
+- Updated dependencies [5966c2a]
+- Updated dependencies [2382580]
+- Updated dependencies [d9fa683]
+- Updated dependencies [3c7bcc0]
+- Updated dependencies [4b6cac7]
+- Updated dependencies [7631964]
+- Updated dependencies [ac471a0]
+- Updated dependencies [60ae58e]
+- Updated dependencies [ce92674]
+- Updated dependencies [9f601e8]
+- Updated dependencies [51c5227]
+- Updated dependencies [a4a85c8]
+- Updated dependencies [07a4e26]
+- Updated dependencies [ec975f1]
+- Updated dependencies [eb4204b]
+- Updated dependencies [4f13be2]
+- Updated dependencies [61cc079]
+- Updated dependencies [0e96e46]
+- Updated dependencies [d52d4fe]
+- Updated dependencies [742cebb]
+- Updated dependencies [ce92674]
+- Updated dependencies [cf2c9b7]
+- Updated dependencies [833b512]
+- Updated dependencies [0f9faa2]
+- Updated dependencies [7cf42fe]
+- Updated dependencies [5966c2a]
+- Updated dependencies [f78dd83]
+- Updated dependencies [a2cd18a]
+- Updated dependencies [4638aaa]
+- Updated dependencies [0222d3c]
+- Updated dependencies [071d0dc]
+- Updated dependencies [0a936ea]
+- Updated dependencies [023c00b]
+- Updated dependencies [155507e]
+- Updated dependencies [7bba90b]
+- Updated dependencies [7e05d8e]
+- Updated dependencies [061406d]
+- Updated dependencies [c1f344b]
+- Updated dependencies [9c93465]
+- Updated dependencies [ebb209c]
+- Updated dependencies [63b33e6]
+- Updated dependencies [2a44c1d]
+- Updated dependencies [695cfbd]
+- Updated dependencies [7445149]
+- Updated dependencies [071d0dc]
+- Updated dependencies [0848bea]
+- Updated dependencies [d51bed2]
+- Updated dependencies [b8b3c64]
+- Updated dependencies [0c0fbd9]
+- Updated dependencies [f3141d8]
+- Updated dependencies [5a84d41]
+- Updated dependencies [fd3013a]
+- Updated dependencies [21676eb]
+- Updated dependencies [e336549]
+- Updated dependencies [d40f43a]
+- Updated dependencies [e5e7ee0]
+- Updated dependencies [a2ebea2]
+- Updated dependencies [800bdb0]
+- Updated dependencies [04f1182]
+- Updated dependencies [5647006]
+- Updated dependencies [38f7e4f]
+- Updated dependencies [c57f3cf]
+- Updated dependencies [97faca3]
+- Updated dependencies [ad5fe25]
+- Updated dependencies [ea90179]
+- Updated dependencies [ce92674]
+- Updated dependencies [5ef0b5b]
+- Updated dependencies [48fbacb]
+- Updated dependencies [355e951]
+- Updated dependencies [dadb43f]
+  - @objectstack/spec@17.0.0-rc.2
+  - @objectstack/core@17.0.0-rc.2
+  - @objectstack/driver-sql@17.0.0-rc.2
+
 ## 17.0.0-rc.1
 
 ### Patch Changes

package/dist/index.d.mts

@@ -116,8 +116,21 @@ declare class WasmSqliteConnection {
      * (which would abort it).
      */
     noteTransactionControl(sql: string): void;
-    /** Hint that a mutation just executed; schedule a flush if needed. */
-    markDirty(method?: string): void;
+    /**
+     * Record that the statement just executed CHANGED the database, and schedule
+     * a flush according to {@link persist}.
+     *
+     * Deliberately takes no argument. It used to filter the caller's Knex
+     * `method` against a local write-method allowlist, which made "did this
+     * mutate?" a decision taken in TWO places — here and in the dialect's
+     * execution-path branch — and the two disagreed: an `INSERT … RETURNING`
+     * runs down the dialect's ROW-returning branch (it has rows to return), that
+     * branch never called this method at all, and so a whole class of committed
+     * writes was never marked dirty and never reached disk (#4518). One decision,
+     * one owner: {@link statementMutatesDatabase} in the dialect classifies the
+     * statement, and this method just does what it is told.
+     */
+    markDirty(): void;
     /**
      * Force a write of the current database state to disk.
      *

package/dist/index.d.ts

@@ -116,8 +116,21 @@ declare class WasmSqliteConnection {
      * (which would abort it).
      */
     noteTransactionControl(sql: string): void;
-    /** Hint that a mutation just executed; schedule a flush if needed. */
-    markDirty(method?: string): void;
+    /**
+     * Record that the statement just executed CHANGED the database, and schedule
+     * a flush according to {@link persist}.
+     *
+     * Deliberately takes no argument. It used to filter the caller's Knex
+     * `method` against a local write-method allowlist, which made "did this
+     * mutate?" a decision taken in TWO places — here and in the dialect's
+     * execution-path branch — and the two disagreed: an `INSERT … RETURNING`
+     * runs down the dialect's ROW-returning branch (it has rows to return), that
+     * branch never called this method at all, and so a whole class of committed
+     * writes was never marked dirty and never reached disk (#4518). One decision,
+     * one owner: {@link statementMutatesDatabase} in the dialect classifies the
+     * statement, and this method just does what it is told.
+     */
+    markDirty(): void;
     /**
      * Force a write of the current database state to disk.
      *

package/dist/index.js

@@ -45,13 +45,6 @@ var import_node_module = require("module");
 
 // src/wasm-connection.ts
 var import_meta = {};
-var WRITE_METHODS = /* @__PURE__ */ new Set([
-  "run",
-  "insert",
-  "update",
-  "del",
-  "counter"
-]);
 async function tryLoadFs() {
   try {
     return await import("fs/promises");
@@ -262,10 +255,22 @@ var _WasmSqliteConnection = class _WasmSqliteConnection {
       void this.flush();
     }
   }
-  /** Hint that a mutation just executed; schedule a flush if needed. */
-  markDirty(method) {
+  /**
+   * Record that the statement just executed CHANGED the database, and schedule
+   * a flush according to {@link persist}.
+   *
+   * Deliberately takes no argument. It used to filter the caller's Knex
+   * `method` against a local write-method allowlist, which made "did this
+   * mutate?" a decision taken in TWO places — here and in the dialect's
+   * execution-path branch — and the two disagreed: an `INSERT … RETURNING`
+   * runs down the dialect's ROW-returning branch (it has rows to return), that
+   * branch never called this method at all, and so a whole class of committed
+   * writes was never marked dirty and never reached disk (#4518). One decision,
+   * one owner: {@link statementMutatesDatabase} in the dialect classifies the
+   * statement, and this method just does what it is told.
+   */
+  markDirty() {
     if (this.isEphemeral || !this.fs) return;
-    if (method && !WRITE_METHODS.has(method)) return;
     this.dirty = true;
     if (this.persist === "on-write") {
       void this.flush();
@@ -401,11 +406,23 @@ function formatBindings(bindings) {
     return b;
   });
 }
-function isReadMethod(method, returning) {
+function isRowReturningExecution(method, returning) {
   if (method === "insert" || method === "update") return !!returning ? true : false;
   if (method === "counter" || method === "del") return false;
   return true;
 }
+var MUTATING_METHODS = /* @__PURE__ */ new Set(["insert", "update", "del", "counter"]);
+var TRANSACTION_CONTROL_RE = /^\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\b/i;
+var DDL_RE = /^\s*(CREATE|ALTER|DROP|BEGIN|COMMIT|ROLLBACK|SAVEPOINT|RELEASE|REINDEX|VACUUM|ATTACH|DETACH|TRUNCATE)\b/i;
+var MUTATING_DML_RE = /^\s*(INSERT|UPDATE|DELETE|REPLACE|UPSERT)\b/i;
+var MUTATING_PRAGMA_RE = /^\s*PRAGMA\b(?:[^;]*=|\s+incremental_vacuum\b)/i;
+function statementMutatesDatabase(sql, method) {
+  if (TRANSACTION_CONTROL_RE.test(sql)) return false;
+  if (method && MUTATING_METHODS.has(method)) return true;
+  if (DDL_RE.test(sql)) return true;
+  if (MUTATING_DML_RE.test(sql)) return true;
+  return MUTATING_PRAGMA_RE.test(sql);
+}
 function resolveKnexSqlite3Dialect() {
   const g = globalThis;
   if (typeof g.require === "function") {
@@ -447,20 +464,10 @@ function getClient_WasmSqlite() {
       if (!connection) throw new Error("No connection provided");
       const db = connection.raw;
       const bindings = formatBindings(obj.bindings);
-      const isDdl = /^\s*(CREATE|ALTER|DROP|BEGIN|COMMIT|ROLLBACK|SAVEPOINT|RELEASE|REINDEX|VACUUM|ATTACH|DETACH|TRUNCATE)\b/i.test(
-        obj.sql
-      );
-      if (isDdl) {
+      if (DDL_RE.test(obj.sql)) {
         db.run(obj.sql, bindings);
         obj.response = [];
-        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)) {
+      } else if (isRowReturningExecution(obj.method, obj.returning) || /^\s*PRAGMA\b/i.test(obj.sql)) {
         const stmt = db.prepare(obj.sql);
         try {
           if (bindings.length) stmt.bind(bindings);
@@ -472,18 +479,22 @@ function getClient_WasmSqlite() {
         } finally {
           stmt.free();
         }
-        return obj;
+      } else {
+        db.run(obj.sql, bindings);
+        const changes = db.getRowsModified();
+        let lastID = 0;
+        if (obj.method === "insert") {
+          const r = db.exec("SELECT last_insert_rowid() AS id");
+          lastID = r?.[0]?.values?.[0]?.[0] ?? 0;
+        }
+        obj.response = [];
+        obj.context = { lastID, changes };
       }
-      db.run(obj.sql, bindings);
-      const changes = db.getRowsModified();
-      let lastID = 0;
-      if (obj.method === "insert") {
-        const r = db.exec("SELECT last_insert_rowid() AS id");
-        lastID = r?.[0]?.values?.[0]?.[0] ?? 0;
+      if (TRANSACTION_CONTROL_RE.test(obj.sql)) {
+        connection.noteTransactionControl(obj.sql);
+      } else if (statementMutatesDatabase(obj.sql, obj.method)) {
+        connection.markDirty();
       }
-      obj.response = [];
-      obj.context = { lastID, changes };
-      connection.markDirty(obj.method);
       return obj;
     }
   }

package/dist/index.js.map

@@ -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  /**\n   * Never WAL (#3941). The base driver switches a file-backed SQLite database to\n   * WAL so several processes can share one file. Nothing here is shared: the live\n   * database sits in this process's WASM heap, and what reaches disk is a byte\n   * image {@link flush} exports from it — another process reads that snapshot,\n   * never the database. So the pragma buys this transport nothing.\n   *\n   * It is also not free. Journal mode is a persistent header change in the\n   * operator's file, and under WAL the export path's correctness would rest on\n   * sql.js checkpointing the log while `export()` closes and reopens the\n   * database. Measured, it does — no row is lost today — which is why this is a\n   * declined default and not a bug report. But a transport that persists by\n   * serializing an image should not be one implementation detail away from\n   * dropping committed rows for a concurrency benefit it cannot use.\n   *\n   * Declared rather than discovered: sql.js *accepts* `journal_mode = WAL`,\n   * because its VFS is memory-backed, so the refusal the base class gets from\n   * `:memory:` never comes — and an image whose header already says WAL (one a\n   * native run left behind) reports `wal` here too.\n   */\n  protected override get supportsWalJournal(): boolean {\n    return false;\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 *\n * `undefined` is mapped to `null`: sql.js's binder only accepts\n * string/number/bigint/boolean/null (and array/blob) and `throw`s a *raw\n * string* — `\"Wrong API use : tried to bind a value of an unknown type\n * (undefined).\"` — for anything else. Because it throws a string rather than\n * an `Error`, it logs as a garbled char-indexed object and aborts the whole\n * write. Mapping to `null` matches the `useNullAsDefault` semantics the\n * dialect is configured with, so a missing/undefined value persists as SQL\n * `NULL` exactly as it would through better-sqlite3.\n */\nfunction formatBindings(bindings: unknown[] | undefined): unknown[] {\n  if (!bindings) return [];\n  return bindings.map((b) => {\n    if (b === undefined) return null;\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) || /^\\s*PRAGMA\\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  /**\n   * Process-wide counter making each atomic-write temp filename unique, so\n   * concurrent connections (or overlapping flushes) never target the same\n   * temp path. Combined with `process.pid` for cross-process uniqueness.\n   */\n  private static tmpSeq = 0;\n\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    if (!bytes) {\n      this.db = new SQL.Database();\n      return;\n    }\n\n    await this.quarantineOrphanedWal();\n\n    // Open the on-disk bytes, but guard against a corrupt image. A torn write\n    // (process killed mid-flush before atomic writes existed) or otherwise\n    // damaged file makes `new SQL.Database(bytes)` either throw (\"file is not a\n    // database\") or open a handle whose every query fails with \"database disk\n    // image is malformed\" — which, for a background dispatcher on a tick loop,\n    // means the same error spammed forever with no path to recovery. Detect it\n    // once at open, quarantine the bad file, and start fresh so the dev server\n    // becomes usable again instead of wedging.\n    try {\n      const candidate = new SQL.Database(bytes);\n      this.assertReadable(candidate);\n      this.db = candidate;\n    } catch (err) {\n      await this.quarantineCorruptFile(err);\n      this.db = new SQL.Database();\n    }\n  }\n\n  /**\n   * Force sql.js to actually read a page so a malformed image surfaces now\n   * rather than on the first business query. `PRAGMA quick_check` walks the\n   * b-tree structure without the full-scan cost of `integrity_check`; a healthy\n   * database returns a single `ok` row. Any thrown error (raw string or Error)\n   * or a non-`ok` result is treated as corruption.\n   */\n  private assertReadable(db: Database): void {\n    const res = db.exec('PRAGMA quick_check(1)');\n    const first = res?.[0]?.values?.[0]?.[0];\n    if (typeof first === 'string' && first.toLowerCase() !== 'ok') {\n      throw new Error(`sqlite quick_check failed: ${first}`);\n    }\n  }\n\n  /**\n   * Move a corrupt database file aside so its bytes are preserved for\n   * post-mortem while a fresh, empty database takes its place. Best-effort:\n   * failures here must not prevent the server from booting on a clean DB.\n   */\n  private async quarantineCorruptFile(cause: unknown): Promise<void> {\n    if (!this.fs) return;\n    const reason =\n      typeof cause === 'string' ? cause : (cause as Error)?.message ?? String(cause);\n    const backup = `${this.filename}.corrupt-${Date.now()}`;\n    try {\n      await this.fs.rename(this.filename, backup);\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}). Quarantined to ${backup} and starting from an empty ` +\n          `database so the server can boot.`,\n      );\n    } catch (renameErr) {\n      // Could not move it aside (e.g. permissions) — overwrite is still better\n      // than looping forever on a malformed image. Warn loudly and continue.\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}) and could not be quarantined (${String(renameErr)}). ` +\n          `Starting from an empty database; the corrupt file will be overwritten ` +\n          `on the next flush.`,\n      );\n    }\n  }\n\n  /**\n   * Move a write-ahead log left behind by a *real* SQLite aside (#3941).\n   *\n   * The native driver keeps file-backed databases in WAL mode, and a clean close\n   * checkpoints the log away — so a non-empty `<db>-wal` here means the last\n   * process died without one. That log is a problem in both directions, and\n   * neither is something wasm SQLite can fix: it cannot read the log (we load\n   * only the main image, so any transaction still in there is invisible), and it\n   * must not leave it in place either — the next {@link flush} rewrites the\n   * image, and a real SQLite opening a fresh image beside a stale log would\n   * replay frames that no longer belong to it.\n   *\n   * So rename it, which loses nothing recoverable (the bytes are preserved for a\n   * real `sqlite3` to recover from) and disarms the mismatch. Best-effort: this\n   * is a dev-only step-down path and must never prevent a boot.\n   */\n  private async quarantineOrphanedWal(): Promise<void> {\n    if (!this.fs) return;\n    const wal = `${this.filename}-wal`;\n    let size: number;\n    try {\n      size = (await this.fs.stat(wal)).size;\n    } catch {\n      return; // no sidecar (the normal case) or an unreadable one\n    }\n    if (size <= 0) return; // checkpointed-and-truncated: nothing in it\n\n    const parked = `${wal}.orphaned-${Date.now()}`;\n    try {\n      await this.fs.rename(wal, parked);\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read — this database was last used in WAL mode and closed uncleanly. Parked it ` +\n          `at ${parked} and loaded the main image without it, so anything committed only to the ` +\n          `log is NOT in this session. To recover it, rebuild better-sqlite3 (or use \\`sqlite3\\`), ` +\n          `restore the log next to the database, and run \\`PRAGMA wal_checkpoint(TRUNCATE)\\`.`,\n      );\n    } catch (renameErr) {\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read, and it could not be moved aside (${String(renameErr)}). Data committed ` +\n          `only to the log is missing from this session; checkpoint it with a real sqlite3 before ` +\n          `writing further.`,\n      );\n    }\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 atomic write below.\n        await this.atomicWriteFile(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  /**\n   * Write the database bytes to disk atomically: write to a sibling temp file,\n   * fsync it, then `rename()` it over the target.\n   *\n   * A plain `writeFile(this.filename, …)` truncates the target and streams the\n   * new bytes in place, so a process killed mid-write (a dev-server restart,\n   * Ctrl-C, or crash — likely under `on-write`, where every dispatcher tick\n   * flushes) leaves a half-written file. sql.js then rejects that file on the\n   * next boot with \"database disk image is malformed\". `rename(2)` is atomic\n   * within a filesystem, so a reader always sees either the complete old file\n   * or the complete new one — never a torn image. The temp file lives in the\n   * same directory as the target so the rename stays intra-filesystem.\n   */\n  private async atomicWriteFile(data: Buffer): Promise<void> {\n    if (!this.fs) return;\n    const tmp = `${this.filename}.tmp-${process.pid}-${(WasmSqliteConnection.tmpSeq += 1)}`;\n    let handle: import('node:fs/promises').FileHandle | undefined;\n    try {\n      handle = await this.fs.open(tmp, 'w');\n      await handle.writeFile(data);\n      // Flush the bytes to the platter before the rename so a crash can't leave\n      // a renamed-but-empty file behind on filesystems that reorder the two.\n      await handle.sync();\n      await handle.close();\n      handle = undefined;\n      await this.fs.rename(tmp, this.filename);\n    } catch (err) {\n      if (handle) {\n        try {\n          await handle.close();\n        } catch {\n          /* ignore */\n        }\n      }\n      // Clean up the temp file so a failed flush doesn't litter the data dir.\n      try {\n        await this.fs.unlink(tmp);\n      } catch {\n        /* ignore */\n      }\n      throw err;\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    // 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":"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","names":["createRequire","require","import_meta","Client_WasmSqlite"]}
+{"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  /**\n   * Never WAL (#3941). The base driver switches a file-backed SQLite database to\n   * WAL so several processes can share one file. Nothing here is shared: the live\n   * database sits in this process's WASM heap, and what reaches disk is a byte\n   * image {@link flush} exports from it — another process reads that snapshot,\n   * never the database. So the pragma buys this transport nothing.\n   *\n   * It is also not free. Journal mode is a persistent header change in the\n   * operator's file, and under WAL the export path's correctness would rest on\n   * sql.js checkpointing the log while `export()` closes and reopens the\n   * database. Measured, it does — no row is lost today — which is why this is a\n   * declined default and not a bug report. But a transport that persists by\n   * serializing an image should not be one implementation detail away from\n   * dropping committed rows for a concurrency benefit it cannot use.\n   *\n   * Declared rather than discovered: sql.js *accepts* `journal_mode = WAL`,\n   * because its VFS is memory-backed, so the refusal the base class gets from\n   * `:memory:` never comes — and an image whose header already says WAL (one a\n   * native run left behind) reports `wal` here too.\n   */\n  protected override get supportsWalJournal(): boolean {\n    return false;\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 *\n * `undefined` is mapped to `null`: sql.js's binder only accepts\n * string/number/bigint/boolean/null (and array/blob) and `throw`s a *raw\n * string* — `\"Wrong API use : tried to bind a value of an unknown type\n * (undefined).\"` — for anything else. Because it throws a string rather than\n * an `Error`, it logs as a garbled char-indexed object and aborts the whole\n * write. Mapping to `null` matches the `useNullAsDefault` semantics the\n * dialect is configured with, so a missing/undefined value persists as SQL\n * `NULL` exactly as it would through better-sqlite3.\n */\nfunction formatBindings(bindings: unknown[] | undefined): unknown[] {\n  if (!bindings) return [];\n  return bindings.map((b) => {\n    if (b === undefined) return null;\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 *\n * ⚠️ This answers \"how do I EXECUTE this statement\", never \"does this statement\n * change the database\" — an `INSERT … RETURNING *` is executed down the\n * row-returning branch and mutates. Persistence is classified separately by\n * {@link statementMutatesDatabase}; conflating the two is #4518.\n */\nfunction isRowReturningExecution(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/** Knex `method` values that always denote a mutation. */\nconst MUTATING_METHODS = new Set(['insert', 'update', 'del', 'counter']);\n\n/** Statement-control forms whose persistence is owned by the transaction lifecycle. */\nconst TRANSACTION_CONTROL_RE = /^\\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\\b/i;\n\n/**\n * DDL / schema statements. `BEGIN…RELEASE` share this prefix set in SQLite's\n * grammar but are transaction control, so they are matched (and routed) first.\n */\nconst DDL_RE =\n  /^\\s*(CREATE|ALTER|DROP|BEGIN|COMMIT|ROLLBACK|SAVEPOINT|RELEASE|REINDEX|VACUUM|ATTACH|DETACH|TRUNCATE)\\b/i;\n\n/** DML that changes rows, whatever execution branch it happens to run down. */\nconst MUTATING_DML_RE = /^\\s*(INSERT|UPDATE|DELETE|REPLACE|UPSERT)\\b/i;\n\n/**\n * PRAGMA forms that change bytes in the database file: any assignment\n * (`PRAGMA auto_vacuum = INCREMENTAL`, `PRAGMA user_version = 3` — both\n * persistent header state) and `incremental_vacuum`, which actually moves\n * pages. Introspection PRAGMAs (`table_info`, `index_list`, …) are reads.\n */\nconst MUTATING_PRAGMA_RE = /^\\s*PRAGMA\\b(?:[^;]*=|\\s+incremental_vacuum\\b)/i;\n\n/**\n * THE single answer to \"did this statement change the database, so that the\n * in-memory image must eventually be written back to disk?\"\n *\n * It is deliberately independent of which execution branch {@link\n * isRowReturningExecution} picks, because those are different questions and\n * answering them with one predicate is what broke persistence in #4518: the\n * ObjectQL engine writes through `INSERT … RETURNING *` / `UPDATE … RETURNING *`\n * (it needs the stored row back), those run down the row-returning branch, and\n * the dirty flag was only ever set on the other branch. The result was a\n * file-backed database that flushed its schema and then silently stopped\n * recording anything — a cold boot found every table present and every row\n * gone, and `on-disconnect` did not save it either, because the final flush\n * also keys off the same flag.\n *\n * Classifying by BOTH the Knex `method` and the SQL text means a mutation\n * cannot slip through by arriving without a method (`knex.raw('INSERT …')`,\n * seed/migration SQL) or by taking an unexpected branch.\n */\nexport function statementMutatesDatabase(sql: string, method?: string): boolean {\n  if (TRANSACTION_CONTROL_RE.test(sql)) return false; // owned by noteTransactionControl\n  if (method && MUTATING_METHODS.has(method)) return true;\n  if (DDL_RE.test(sql)) return true;\n  if (MUTATING_DML_RE.test(sql)) return true;\n  return MUTATING_PRAGMA_RE.test(sql);\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      // ── 1. EXECUTE ────────────────────────────────────────────────────────\n      // Three execution shapes. None of them decides persistence: that is\n      // settled once, below, so a statement cannot mutate the database on a\n      // branch that forgot to say so (#4518).\n\n      // DDL / transaction control 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      if (DDL_RE.test(obj.sql)) {\n        db.run(obj.sql, bindings as any);\n        obj.response = [];\n      } else if (\n        isRowReturningExecution(obj.method, obj.returning) ||\n        /^\\s*PRAGMA\\b/i.test(obj.sql)\n      ) {\n        // Row-returning branch. NOTE this is also where `INSERT … RETURNING *`\n        // and `UPDATE … RETURNING *` land — statements that very much write.\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      } else {\n        // Row-less write path: execute via `run` and capture SQLite's\n        // 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      }\n\n      // ── 2. PERSIST ────────────────────────────────────────────────────────\n      // Exactly one place decides whether the on-disk image is now stale.\n      //\n      // Transaction-control statements are routed to `noteTransactionControl`,\n      // which owns flushing across the transaction lifecycle: it suppresses\n      // flushes while a transaction is open (sql.js `export()` closes+reopens\n      // the db, which would abort the txn) and performs a single flush once the\n      // transaction fully closes. Routing them away from `markDirty` avoids a\n      // second, racing flush on COMMIT.\n      if (TRANSACTION_CONTROL_RE.test(obj.sql)) {\n        connection.noteTransactionControl(obj.sql);\n      } else if (statementMutatesDatabase(obj.sql, obj.method)) {\n        connection.markDirty();\n      }\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/**\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  /**\n   * Process-wide counter making each atomic-write temp filename unique, so\n   * concurrent connections (or overlapping flushes) never target the same\n   * temp path. Combined with `process.pid` for cross-process uniqueness.\n   */\n  private static tmpSeq = 0;\n\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    if (!bytes) {\n      this.db = new SQL.Database();\n      return;\n    }\n\n    await this.quarantineOrphanedWal();\n\n    // Open the on-disk bytes, but guard against a corrupt image. A torn write\n    // (process killed mid-flush before atomic writes existed) or otherwise\n    // damaged file makes `new SQL.Database(bytes)` either throw (\"file is not a\n    // database\") or open a handle whose every query fails with \"database disk\n    // image is malformed\" — which, for a background dispatcher on a tick loop,\n    // means the same error spammed forever with no path to recovery. Detect it\n    // once at open, quarantine the bad file, and start fresh so the dev server\n    // becomes usable again instead of wedging.\n    try {\n      const candidate = new SQL.Database(bytes);\n      this.assertReadable(candidate);\n      this.db = candidate;\n    } catch (err) {\n      await this.quarantineCorruptFile(err);\n      this.db = new SQL.Database();\n    }\n  }\n\n  /**\n   * Force sql.js to actually read a page so a malformed image surfaces now\n   * rather than on the first business query. `PRAGMA quick_check` walks the\n   * b-tree structure without the full-scan cost of `integrity_check`; a healthy\n   * database returns a single `ok` row. Any thrown error (raw string or Error)\n   * or a non-`ok` result is treated as corruption.\n   */\n  private assertReadable(db: Database): void {\n    const res = db.exec('PRAGMA quick_check(1)');\n    const first = res?.[0]?.values?.[0]?.[0];\n    if (typeof first === 'string' && first.toLowerCase() !== 'ok') {\n      throw new Error(`sqlite quick_check failed: ${first}`);\n    }\n  }\n\n  /**\n   * Move a corrupt database file aside so its bytes are preserved for\n   * post-mortem while a fresh, empty database takes its place. Best-effort:\n   * failures here must not prevent the server from booting on a clean DB.\n   */\n  private async quarantineCorruptFile(cause: unknown): Promise<void> {\n    if (!this.fs) return;\n    const reason =\n      typeof cause === 'string' ? cause : (cause as Error)?.message ?? String(cause);\n    const backup = `${this.filename}.corrupt-${Date.now()}`;\n    try {\n      await this.fs.rename(this.filename, backup);\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}). Quarantined to ${backup} and starting from an empty ` +\n          `database so the server can boot.`,\n      );\n    } catch (renameErr) {\n      // Could not move it aside (e.g. permissions) — overwrite is still better\n      // than looping forever on a malformed image. Warn loudly and continue.\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}) and could not be quarantined (${String(renameErr)}). ` +\n          `Starting from an empty database; the corrupt file will be overwritten ` +\n          `on the next flush.`,\n      );\n    }\n  }\n\n  /**\n   * Move a write-ahead log left behind by a *real* SQLite aside (#3941).\n   *\n   * The native driver keeps file-backed databases in WAL mode, and a clean close\n   * checkpoints the log away — so a non-empty `<db>-wal` here means the last\n   * process died without one. That log is a problem in both directions, and\n   * neither is something wasm SQLite can fix: it cannot read the log (we load\n   * only the main image, so any transaction still in there is invisible), and it\n   * must not leave it in place either — the next {@link flush} rewrites the\n   * image, and a real SQLite opening a fresh image beside a stale log would\n   * replay frames that no longer belong to it.\n   *\n   * So rename it, which loses nothing recoverable (the bytes are preserved for a\n   * real `sqlite3` to recover from) and disarms the mismatch. Best-effort: this\n   * is a dev-only step-down path and must never prevent a boot.\n   */\n  private async quarantineOrphanedWal(): Promise<void> {\n    if (!this.fs) return;\n    const wal = `${this.filename}-wal`;\n    let size: number;\n    try {\n      size = (await this.fs.stat(wal)).size;\n    } catch {\n      return; // no sidecar (the normal case) or an unreadable one\n    }\n    if (size <= 0) return; // checkpointed-and-truncated: nothing in it\n\n    const parked = `${wal}.orphaned-${Date.now()}`;\n    try {\n      await this.fs.rename(wal, parked);\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read — this database was last used in WAL mode and closed uncleanly. Parked it ` +\n          `at ${parked} and loaded the main image without it, so anything committed only to the ` +\n          `log is NOT in this session. To recover it, rebuild better-sqlite3 (or use \\`sqlite3\\`), ` +\n          `restore the log next to the database, and run \\`PRAGMA wal_checkpoint(TRUNCATE)\\`.`,\n      );\n    } catch (renameErr) {\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read, and it could not be moved aside (${String(renameErr)}). Data committed ` +\n          `only to the log is missing from this session; checkpoint it with a real sqlite3 before ` +\n          `writing further.`,\n      );\n    }\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  /**\n   * Record that the statement just executed CHANGED the database, and schedule\n   * a flush according to {@link persist}.\n   *\n   * Deliberately takes no argument. It used to filter the caller's Knex\n   * `method` against a local write-method allowlist, which made \"did this\n   * mutate?\" a decision taken in TWO places — here and in the dialect's\n   * execution-path branch — and the two disagreed: an `INSERT … RETURNING`\n   * runs down the dialect's ROW-returning branch (it has rows to return), that\n   * branch never called this method at all, and so a whole class of committed\n   * writes was never marked dirty and never reached disk (#4518). One decision,\n   * one owner: {@link statementMutatesDatabase} in the dialect classifies the\n   * statement, and this method just does what it is told.\n   */\n  markDirty(): void {\n    if (this.isEphemeral || !this.fs) 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 atomic write below.\n        await this.atomicWriteFile(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  /**\n   * Write the database bytes to disk atomically: write to a sibling temp file,\n   * fsync it, then `rename()` it over the target.\n   *\n   * A plain `writeFile(this.filename, …)` truncates the target and streams the\n   * new bytes in place, so a process killed mid-write (a dev-server restart,\n   * Ctrl-C, or crash — likely under `on-write`, where every dispatcher tick\n   * flushes) leaves a half-written file. sql.js then rejects that file on the\n   * next boot with \"database disk image is malformed\". `rename(2)` is atomic\n   * within a filesystem, so a reader always sees either the complete old file\n   * or the complete new one — never a torn image. The temp file lives in the\n   * same directory as the target so the rename stays intra-filesystem.\n   */\n  private async atomicWriteFile(data: Buffer): Promise<void> {\n    if (!this.fs) return;\n    const tmp = `${this.filename}.tmp-${process.pid}-${(WasmSqliteConnection.tmpSeq += 1)}`;\n    let handle: import('node:fs/promises').FileHandle | undefined;\n    try {\n      handle = await this.fs.open(tmp, 'w');\n      await handle.writeFile(data);\n      // Flush the bytes to the platter before the rename so a crash can't leave\n      // a renamed-but-empty file behind on filesystems that reorder the two.\n      await handle.sync();\n      await handle.close();\n      handle = undefined;\n      await this.fs.rename(tmp, this.filename);\n    } catch (err) {\n      if (handle) {\n        try {\n          await handle.close();\n        } catch {\n          /* ignore */\n        }\n      }\n      // Clean up the temp file so a failed flush doesn't litter the data dir.\n      try {\n        await this.fs.unlink(tmp);\n      } catch {\n        /* ignore */\n      }\n      throw err;\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    // 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":"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","names":["createRequire","require","import_meta","Client_WasmSqlite"]}

package/dist/index.mjs

@@ -5,13 +5,6 @@ import { SqlDriver } from "@objectstack/driver-sql";
 import { createRequire } from "module";
 
 // src/wasm-connection.ts
-var WRITE_METHODS = /* @__PURE__ */ new Set([
-  "run",
-  "insert",
-  "update",
-  "del",
-  "counter"
-]);
 async function tryLoadFs() {
   try {
     return await import("fs/promises");
@@ -222,10 +215,22 @@ var _WasmSqliteConnection = class _WasmSqliteConnection {
       void this.flush();
     }
   }
-  /** Hint that a mutation just executed; schedule a flush if needed. */
-  markDirty(method) {
+  /**
+   * Record that the statement just executed CHANGED the database, and schedule
+   * a flush according to {@link persist}.
+   *
+   * Deliberately takes no argument. It used to filter the caller's Knex
+   * `method` against a local write-method allowlist, which made "did this
+   * mutate?" a decision taken in TWO places — here and in the dialect's
+   * execution-path branch — and the two disagreed: an `INSERT … RETURNING`
+   * runs down the dialect's ROW-returning branch (it has rows to return), that
+   * branch never called this method at all, and so a whole class of committed
+   * writes was never marked dirty and never reached disk (#4518). One decision,
+   * one owner: {@link statementMutatesDatabase} in the dialect classifies the
+   * statement, and this method just does what it is told.
+   */
+  markDirty() {
     if (this.isEphemeral || !this.fs) return;
-    if (method && !WRITE_METHODS.has(method)) return;
     this.dirty = true;
     if (this.persist === "on-write") {
       void this.flush();
@@ -360,11 +365,23 @@ function formatBindings(bindings) {
     return b;
   });
 }
-function isReadMethod(method, returning) {
+function isRowReturningExecution(method, returning) {
   if (method === "insert" || method === "update") return !!returning ? true : false;
   if (method === "counter" || method === "del") return false;
   return true;
 }
+var MUTATING_METHODS = /* @__PURE__ */ new Set(["insert", "update", "del", "counter"]);
+var TRANSACTION_CONTROL_RE = /^\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\b/i;
+var DDL_RE = /^\s*(CREATE|ALTER|DROP|BEGIN|COMMIT|ROLLBACK|SAVEPOINT|RELEASE|REINDEX|VACUUM|ATTACH|DETACH|TRUNCATE)\b/i;
+var MUTATING_DML_RE = /^\s*(INSERT|UPDATE|DELETE|REPLACE|UPSERT)\b/i;
+var MUTATING_PRAGMA_RE = /^\s*PRAGMA\b(?:[^;]*=|\s+incremental_vacuum\b)/i;
+function statementMutatesDatabase(sql, method) {
+  if (TRANSACTION_CONTROL_RE.test(sql)) return false;
+  if (method && MUTATING_METHODS.has(method)) return true;
+  if (DDL_RE.test(sql)) return true;
+  if (MUTATING_DML_RE.test(sql)) return true;
+  return MUTATING_PRAGMA_RE.test(sql);
+}
 function resolveKnexSqlite3Dialect() {
   const g = globalThis;
   if (typeof g.require === "function") {
@@ -406,20 +423,10 @@ function getClient_WasmSqlite() {
       if (!connection) throw new Error("No connection provided");
       const db = connection.raw;
       const bindings = formatBindings(obj.bindings);
-      const isDdl = /^\s*(CREATE|ALTER|DROP|BEGIN|COMMIT|ROLLBACK|SAVEPOINT|RELEASE|REINDEX|VACUUM|ATTACH|DETACH|TRUNCATE)\b/i.test(
-        obj.sql
-      );
-      if (isDdl) {
+      if (DDL_RE.test(obj.sql)) {
         db.run(obj.sql, bindings);
         obj.response = [];
-        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)) {
+      } else if (isRowReturningExecution(obj.method, obj.returning) || /^\s*PRAGMA\b/i.test(obj.sql)) {
         const stmt = db.prepare(obj.sql);
         try {
           if (bindings.length) stmt.bind(bindings);
@@ -431,18 +438,22 @@ function getClient_WasmSqlite() {
         } finally {
           stmt.free();
         }
-        return obj;
+      } else {
+        db.run(obj.sql, bindings);
+        const changes = db.getRowsModified();
+        let lastID = 0;
+        if (obj.method === "insert") {
+          const r = db.exec("SELECT last_insert_rowid() AS id");
+          lastID = r?.[0]?.values?.[0]?.[0] ?? 0;
+        }
+        obj.response = [];
+        obj.context = { lastID, changes };
       }
-      db.run(obj.sql, bindings);
-      const changes = db.getRowsModified();
-      let lastID = 0;
-      if (obj.method === "insert") {
-        const r = db.exec("SELECT last_insert_rowid() AS id");
-        lastID = r?.[0]?.values?.[0]?.[0] ?? 0;
+      if (TRANSACTION_CONTROL_RE.test(obj.sql)) {
+        connection.noteTransactionControl(obj.sql);
+      } else if (statementMutatesDatabase(obj.sql, obj.method)) {
+        connection.markDirty();
       }
-      obj.response = [];
-      obj.context = { lastID, changes };
-      connection.markDirty(obj.method);
       return obj;
     }
   }

package/dist/index.mjs.map

@@ -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  /**\n   * Never WAL (#3941). The base driver switches a file-backed SQLite database to\n   * WAL so several processes can share one file. Nothing here is shared: the live\n   * database sits in this process's WASM heap, and what reaches disk is a byte\n   * image {@link flush} exports from it — another process reads that snapshot,\n   * never the database. So the pragma buys this transport nothing.\n   *\n   * It is also not free. Journal mode is a persistent header change in the\n   * operator's file, and under WAL the export path's correctness would rest on\n   * sql.js checkpointing the log while `export()` closes and reopens the\n   * database. Measured, it does — no row is lost today — which is why this is a\n   * declined default and not a bug report. But a transport that persists by\n   * serializing an image should not be one implementation detail away from\n   * dropping committed rows for a concurrency benefit it cannot use.\n   *\n   * Declared rather than discovered: sql.js *accepts* `journal_mode = WAL`,\n   * because its VFS is memory-backed, so the refusal the base class gets from\n   * `:memory:` never comes — and an image whose header already says WAL (one a\n   * native run left behind) reports `wal` here too.\n   */\n  protected override get supportsWalJournal(): boolean {\n    return false;\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 *\n * `undefined` is mapped to `null`: sql.js's binder only accepts\n * string/number/bigint/boolean/null (and array/blob) and `throw`s a *raw\n * string* — `\"Wrong API use : tried to bind a value of an unknown type\n * (undefined).\"` — for anything else. Because it throws a string rather than\n * an `Error`, it logs as a garbled char-indexed object and aborts the whole\n * write. Mapping to `null` matches the `useNullAsDefault` semantics the\n * dialect is configured with, so a missing/undefined value persists as SQL\n * `NULL` exactly as it would through better-sqlite3.\n */\nfunction formatBindings(bindings: unknown[] | undefined): unknown[] {\n  if (!bindings) return [];\n  return bindings.map((b) => {\n    if (b === undefined) return null;\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) || /^\\s*PRAGMA\\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  /**\n   * Process-wide counter making each atomic-write temp filename unique, so\n   * concurrent connections (or overlapping flushes) never target the same\n   * temp path. Combined with `process.pid` for cross-process uniqueness.\n   */\n  private static tmpSeq = 0;\n\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    if (!bytes) {\n      this.db = new SQL.Database();\n      return;\n    }\n\n    await this.quarantineOrphanedWal();\n\n    // Open the on-disk bytes, but guard against a corrupt image. A torn write\n    // (process killed mid-flush before atomic writes existed) or otherwise\n    // damaged file makes `new SQL.Database(bytes)` either throw (\"file is not a\n    // database\") or open a handle whose every query fails with \"database disk\n    // image is malformed\" — which, for a background dispatcher on a tick loop,\n    // means the same error spammed forever with no path to recovery. Detect it\n    // once at open, quarantine the bad file, and start fresh so the dev server\n    // becomes usable again instead of wedging.\n    try {\n      const candidate = new SQL.Database(bytes);\n      this.assertReadable(candidate);\n      this.db = candidate;\n    } catch (err) {\n      await this.quarantineCorruptFile(err);\n      this.db = new SQL.Database();\n    }\n  }\n\n  /**\n   * Force sql.js to actually read a page so a malformed image surfaces now\n   * rather than on the first business query. `PRAGMA quick_check` walks the\n   * b-tree structure without the full-scan cost of `integrity_check`; a healthy\n   * database returns a single `ok` row. Any thrown error (raw string or Error)\n   * or a non-`ok` result is treated as corruption.\n   */\n  private assertReadable(db: Database): void {\n    const res = db.exec('PRAGMA quick_check(1)');\n    const first = res?.[0]?.values?.[0]?.[0];\n    if (typeof first === 'string' && first.toLowerCase() !== 'ok') {\n      throw new Error(`sqlite quick_check failed: ${first}`);\n    }\n  }\n\n  /**\n   * Move a corrupt database file aside so its bytes are preserved for\n   * post-mortem while a fresh, empty database takes its place. Best-effort:\n   * failures here must not prevent the server from booting on a clean DB.\n   */\n  private async quarantineCorruptFile(cause: unknown): Promise<void> {\n    if (!this.fs) return;\n    const reason =\n      typeof cause === 'string' ? cause : (cause as Error)?.message ?? String(cause);\n    const backup = `${this.filename}.corrupt-${Date.now()}`;\n    try {\n      await this.fs.rename(this.filename, backup);\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}). Quarantined to ${backup} and starting from an empty ` +\n          `database so the server can boot.`,\n      );\n    } catch (renameErr) {\n      // Could not move it aside (e.g. permissions) — overwrite is still better\n      // than looping forever on a malformed image. Warn loudly and continue.\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}) and could not be quarantined (${String(renameErr)}). ` +\n          `Starting from an empty database; the corrupt file will be overwritten ` +\n          `on the next flush.`,\n      );\n    }\n  }\n\n  /**\n   * Move a write-ahead log left behind by a *real* SQLite aside (#3941).\n   *\n   * The native driver keeps file-backed databases in WAL mode, and a clean close\n   * checkpoints the log away — so a non-empty `<db>-wal` here means the last\n   * process died without one. That log is a problem in both directions, and\n   * neither is something wasm SQLite can fix: it cannot read the log (we load\n   * only the main image, so any transaction still in there is invisible), and it\n   * must not leave it in place either — the next {@link flush} rewrites the\n   * image, and a real SQLite opening a fresh image beside a stale log would\n   * replay frames that no longer belong to it.\n   *\n   * So rename it, which loses nothing recoverable (the bytes are preserved for a\n   * real `sqlite3` to recover from) and disarms the mismatch. Best-effort: this\n   * is a dev-only step-down path and must never prevent a boot.\n   */\n  private async quarantineOrphanedWal(): Promise<void> {\n    if (!this.fs) return;\n    const wal = `${this.filename}-wal`;\n    let size: number;\n    try {\n      size = (await this.fs.stat(wal)).size;\n    } catch {\n      return; // no sidecar (the normal case) or an unreadable one\n    }\n    if (size <= 0) return; // checkpointed-and-truncated: nothing in it\n\n    const parked = `${wal}.orphaned-${Date.now()}`;\n    try {\n      await this.fs.rename(wal, parked);\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read — this database was last used in WAL mode and closed uncleanly. Parked it ` +\n          `at ${parked} and loaded the main image without it, so anything committed only to the ` +\n          `log is NOT in this session. To recover it, rebuild better-sqlite3 (or use \\`sqlite3\\`), ` +\n          `restore the log next to the database, and run \\`PRAGMA wal_checkpoint(TRUNCATE)\\`.`,\n      );\n    } catch (renameErr) {\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read, and it could not be moved aside (${String(renameErr)}). Data committed ` +\n          `only to the log is missing from this session; checkpoint it with a real sqlite3 before ` +\n          `writing further.`,\n      );\n    }\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 atomic write below.\n        await this.atomicWriteFile(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  /**\n   * Write the database bytes to disk atomically: write to a sibling temp file,\n   * fsync it, then `rename()` it over the target.\n   *\n   * A plain `writeFile(this.filename, …)` truncates the target and streams the\n   * new bytes in place, so a process killed mid-write (a dev-server restart,\n   * Ctrl-C, or crash — likely under `on-write`, where every dispatcher tick\n   * flushes) leaves a half-written file. sql.js then rejects that file on the\n   * next boot with \"database disk image is malformed\". `rename(2)` is atomic\n   * within a filesystem, so a reader always sees either the complete old file\n   * or the complete new one — never a torn image. The temp file lives in the\n   * same directory as the target so the rename stays intra-filesystem.\n   */\n  private async atomicWriteFile(data: Buffer): Promise<void> {\n    if (!this.fs) return;\n    const tmp = `${this.filename}.tmp-${process.pid}-${(WasmSqliteConnection.tmpSeq += 1)}`;\n    let handle: import('node:fs/promises').FileHandle | undefined;\n    try {\n      handle = await this.fs.open(tmp, 'w');\n      await handle.writeFile(data);\n      // Flush the bytes to the platter before the rename so a crash can't leave\n      // a renamed-but-empty file behind on filesystems that reorder the two.\n      await handle.sync();\n      await handle.close();\n      handle = undefined;\n      await this.fs.rename(tmp, this.filename);\n    } catch (err) {\n      if (handle) {\n        try {\n          await handle.close();\n        } catch {\n          /* ignore */\n        }\n      }\n      // Clean up the temp file so a failed flush doesn't litter the data dir.\n      try {\n        await this.fs.unlink(tmp);\n      } catch {\n        /* ignore */\n      }\n      throw err;\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    // 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":";AAaA,SAAS,iBAAuC;;;ACWhD,SAAS,qBAAqB;;;ACe9B,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,wBAAN,MAAM,sBAAqB;AAAA,EAyChC,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,QAAI,CAAC,OAAO;AACV,WAAK,KAAK,IAAI,IAAI,SAAS;AAC3B;AAAA,IACF;AAEA,UAAM,KAAK,sBAAsB;AAUjC,QAAI;AACF,YAAM,YAAY,IAAI,IAAI,SAAS,KAAK;AACxC,WAAK,eAAe,SAAS;AAC7B,WAAK,KAAK;AAAA,IACZ,SAAS,KAAK;AACZ,YAAM,KAAK,sBAAsB,GAAG;AACpC,WAAK,KAAK,IAAI,IAAI,SAAS;AAAA,IAC7B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,eAAe,IAAoB;AACzC,UAAM,MAAM,GAAG,KAAK,uBAAuB;AAC3C,UAAM,QAAQ,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC;AACvC,QAAI,OAAO,UAAU,YAAY,MAAM,YAAY,MAAM,MAAM;AAC7D,YAAM,IAAI,MAAM,8BAA8B,KAAK,EAAE;AAAA,IACvD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,sBAAsB,OAA+B;AACjE,QAAI,CAAC,KAAK,GAAI;AACd,UAAM,SACJ,OAAO,UAAU,WAAW,QAAS,OAAiB,WAAW,OAAO,KAAK;AAC/E,UAAM,SAAS,GAAG,KAAK,QAAQ,YAAY,KAAK,IAAI,CAAC;AACrD,QAAI;AACF,YAAM,KAAK,GAAG,OAAO,KAAK,UAAU,MAAM;AAC1C,WAAK,OAAO;AAAA,QACV,0CAA0C,KAAK,QAAQ,gBACjD,MAAM,qBAAqB,MAAM;AAAA,MAEzC;AAAA,IACF,SAAS,WAAW;AAGlB,WAAK,OAAO;AAAA,QACV,0CAA0C,KAAK,QAAQ,gBACjD,MAAM,mCAAmC,OAAO,SAAS,CAAC;AAAA,MAGlE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,MAAc,wBAAuC;AACnD,QAAI,CAAC,KAAK,GAAI;AACd,UAAM,MAAM,GAAG,KAAK,QAAQ;AAC5B,QAAI;AACJ,QAAI;AACF,cAAQ,MAAM,KAAK,GAAG,KAAK,GAAG,GAAG;AAAA,IACnC,QAAQ;AACN;AAAA,IACF;AACA,QAAI,QAAQ,EAAG;AAEf,UAAM,SAAS,GAAG,GAAG,aAAa,KAAK,IAAI,CAAC;AAC5C,QAAI;AACF,YAAM,KAAK,GAAG,OAAO,KAAK,MAAM;AAChC,WAAK,OAAO;AAAA,QACV,wBAAwB,GAAG,UAAU,IAAI,4IAEjC,MAAM;AAAA,MAGhB;AAAA,IACF,SAAS,WAAW;AAClB,WAAK,OAAO;AAAA,QACV,wBAAwB,GAAG,UAAU,IAAI,4FACU,OAAO,SAAS,CAAC;AAAA,MAGtE;AAAA,IACF;AAAA,EACF;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,gBAAgB,OAAO,KAAK,QAAQ,CAAC;AAAA,MAClD,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAc,gBAAgB,MAA6B;AACzD,QAAI,CAAC,KAAK,GAAI;AACd,UAAM,MAAM,GAAG,KAAK,QAAQ,QAAQ,QAAQ,GAAG,IAAK,sBAAqB,UAAU,CAAE;AACrF,QAAI;AACJ,QAAI;AACF,eAAS,MAAM,KAAK,GAAG,KAAK,KAAK,GAAG;AACpC,YAAM,OAAO,UAAU,IAAI;AAG3B,YAAM,OAAO,KAAK;AAClB,YAAM,OAAO,MAAM;AACnB,eAAS;AACT,YAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ;AAAA,IACzC,SAAS,KAAK;AACZ,UAAI,QAAQ;AACV,YAAI;AACF,gBAAM,OAAO,MAAM;AAAA,QACrB,QAAQ;AAAA,QAER;AAAA,MACF;AAEA,UAAI;AACF,cAAM,KAAK,GAAG,OAAO,GAAG;AAAA,MAC1B,QAAQ;AAAA,MAER;AACA,YAAM;AAAA,IACR;AAAA,EACF;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;AAAA;AAAA;AAAA;AAAA;AAAA;AA5Xa,sBAMI,SAAS;AANnB,IAAM,uBAAN;;;AD1DP,IAAI,mBAAwB;AAC5B,SAAS,gBAAqB;AAC5B,MAAI,iBAAkB,QAAO;AAG7B,QAAM,SACJ,OAAO,gBAAgB,eAAgB,YAAoB,MACtD,YAAoB,MACrB,OAAO,eAAe,cACpB,aACA,QAAQ,IAAI,IAAI;AACxB,qBAAmB,cAAc,MAAM;AACvC,SAAO;AACT;AAwBA,SAAS,eAAe,UAA4C;AAClE,MAAI,CAAC,SAAU,QAAO,CAAC;AACvB,SAAO,SAAS,IAAI,CAAC,MAAM;AACzB,QAAI,MAAM,OAAW,QAAO;AAC5B,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;;;AD7MM,IAAM,mBAAN,MAAM,0BAAyB,UAAU;AAAA,EAwC9C,YAAY,QAAgC;AAC1C,UAAM,aAAa,kBAAiB,aAAa,MAAM;AACvD,UAAM,UAAU;AAzClB,SAAyB,OAAe;AACxC,SAAyB,UAAkB;AAoC3C,SAAQ,oBAAyC;AAK/C,SAAK,aAAa;AAClB,QAAI,OAAO,OAAQ,MAAK,SAAS,OAAO;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EApCA,IAAuB,WAAoB;AACzC,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,IAAuB,qBAA8B;AACnD,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;;;AGpLA,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","Client_WasmSqlite"]}
+{"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  /**\n   * Never WAL (#3941). The base driver switches a file-backed SQLite database to\n   * WAL so several processes can share one file. Nothing here is shared: the live\n   * database sits in this process's WASM heap, and what reaches disk is a byte\n   * image {@link flush} exports from it — another process reads that snapshot,\n   * never the database. So the pragma buys this transport nothing.\n   *\n   * It is also not free. Journal mode is a persistent header change in the\n   * operator's file, and under WAL the export path's correctness would rest on\n   * sql.js checkpointing the log while `export()` closes and reopens the\n   * database. Measured, it does — no row is lost today — which is why this is a\n   * declined default and not a bug report. But a transport that persists by\n   * serializing an image should not be one implementation detail away from\n   * dropping committed rows for a concurrency benefit it cannot use.\n   *\n   * Declared rather than discovered: sql.js *accepts* `journal_mode = WAL`,\n   * because its VFS is memory-backed, so the refusal the base class gets from\n   * `:memory:` never comes — and an image whose header already says WAL (one a\n   * native run left behind) reports `wal` here too.\n   */\n  protected override get supportsWalJournal(): boolean {\n    return false;\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 *\n * `undefined` is mapped to `null`: sql.js's binder only accepts\n * string/number/bigint/boolean/null (and array/blob) and `throw`s a *raw\n * string* — `\"Wrong API use : tried to bind a value of an unknown type\n * (undefined).\"` — for anything else. Because it throws a string rather than\n * an `Error`, it logs as a garbled char-indexed object and aborts the whole\n * write. Mapping to `null` matches the `useNullAsDefault` semantics the\n * dialect is configured with, so a missing/undefined value persists as SQL\n * `NULL` exactly as it would through better-sqlite3.\n */\nfunction formatBindings(bindings: unknown[] | undefined): unknown[] {\n  if (!bindings) return [];\n  return bindings.map((b) => {\n    if (b === undefined) return null;\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 *\n * ⚠️ This answers \"how do I EXECUTE this statement\", never \"does this statement\n * change the database\" — an `INSERT … RETURNING *` is executed down the\n * row-returning branch and mutates. Persistence is classified separately by\n * {@link statementMutatesDatabase}; conflating the two is #4518.\n */\nfunction isRowReturningExecution(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/** Knex `method` values that always denote a mutation. */\nconst MUTATING_METHODS = new Set(['insert', 'update', 'del', 'counter']);\n\n/** Statement-control forms whose persistence is owned by the transaction lifecycle. */\nconst TRANSACTION_CONTROL_RE = /^\\s*(BEGIN|COMMIT|END|ROLLBACK|SAVEPOINT|RELEASE)\\b/i;\n\n/**\n * DDL / schema statements. `BEGIN…RELEASE` share this prefix set in SQLite's\n * grammar but are transaction control, so they are matched (and routed) first.\n */\nconst DDL_RE =\n  /^\\s*(CREATE|ALTER|DROP|BEGIN|COMMIT|ROLLBACK|SAVEPOINT|RELEASE|REINDEX|VACUUM|ATTACH|DETACH|TRUNCATE)\\b/i;\n\n/** DML that changes rows, whatever execution branch it happens to run down. */\nconst MUTATING_DML_RE = /^\\s*(INSERT|UPDATE|DELETE|REPLACE|UPSERT)\\b/i;\n\n/**\n * PRAGMA forms that change bytes in the database file: any assignment\n * (`PRAGMA auto_vacuum = INCREMENTAL`, `PRAGMA user_version = 3` — both\n * persistent header state) and `incremental_vacuum`, which actually moves\n * pages. Introspection PRAGMAs (`table_info`, `index_list`, …) are reads.\n */\nconst MUTATING_PRAGMA_RE = /^\\s*PRAGMA\\b(?:[^;]*=|\\s+incremental_vacuum\\b)/i;\n\n/**\n * THE single answer to \"did this statement change the database, so that the\n * in-memory image must eventually be written back to disk?\"\n *\n * It is deliberately independent of which execution branch {@link\n * isRowReturningExecution} picks, because those are different questions and\n * answering them with one predicate is what broke persistence in #4518: the\n * ObjectQL engine writes through `INSERT … RETURNING *` / `UPDATE … RETURNING *`\n * (it needs the stored row back), those run down the row-returning branch, and\n * the dirty flag was only ever set on the other branch. The result was a\n * file-backed database that flushed its schema and then silently stopped\n * recording anything — a cold boot found every table present and every row\n * gone, and `on-disconnect` did not save it either, because the final flush\n * also keys off the same flag.\n *\n * Classifying by BOTH the Knex `method` and the SQL text means a mutation\n * cannot slip through by arriving without a method (`knex.raw('INSERT …')`,\n * seed/migration SQL) or by taking an unexpected branch.\n */\nexport function statementMutatesDatabase(sql: string, method?: string): boolean {\n  if (TRANSACTION_CONTROL_RE.test(sql)) return false; // owned by noteTransactionControl\n  if (method && MUTATING_METHODS.has(method)) return true;\n  if (DDL_RE.test(sql)) return true;\n  if (MUTATING_DML_RE.test(sql)) return true;\n  return MUTATING_PRAGMA_RE.test(sql);\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      // ── 1. EXECUTE ────────────────────────────────────────────────────────\n      // Three execution shapes. None of them decides persistence: that is\n      // settled once, below, so a statement cannot mutate the database on a\n      // branch that forgot to say so (#4518).\n\n      // DDL / transaction control 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      if (DDL_RE.test(obj.sql)) {\n        db.run(obj.sql, bindings as any);\n        obj.response = [];\n      } else if (\n        isRowReturningExecution(obj.method, obj.returning) ||\n        /^\\s*PRAGMA\\b/i.test(obj.sql)\n      ) {\n        // Row-returning branch. NOTE this is also where `INSERT … RETURNING *`\n        // and `UPDATE … RETURNING *` land — statements that very much write.\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      } else {\n        // Row-less write path: execute via `run` and capture SQLite's\n        // 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      }\n\n      // ── 2. PERSIST ────────────────────────────────────────────────────────\n      // Exactly one place decides whether the on-disk image is now stale.\n      //\n      // Transaction-control statements are routed to `noteTransactionControl`,\n      // which owns flushing across the transaction lifecycle: it suppresses\n      // flushes while a transaction is open (sql.js `export()` closes+reopens\n      // the db, which would abort the txn) and performs a single flush once the\n      // transaction fully closes. Routing them away from `markDirty` avoids a\n      // second, racing flush on COMMIT.\n      if (TRANSACTION_CONTROL_RE.test(obj.sql)) {\n        connection.noteTransactionControl(obj.sql);\n      } else if (statementMutatesDatabase(obj.sql, obj.method)) {\n        connection.markDirty();\n      }\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/**\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  /**\n   * Process-wide counter making each atomic-write temp filename unique, so\n   * concurrent connections (or overlapping flushes) never target the same\n   * temp path. Combined with `process.pid` for cross-process uniqueness.\n   */\n  private static tmpSeq = 0;\n\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    if (!bytes) {\n      this.db = new SQL.Database();\n      return;\n    }\n\n    await this.quarantineOrphanedWal();\n\n    // Open the on-disk bytes, but guard against a corrupt image. A torn write\n    // (process killed mid-flush before atomic writes existed) or otherwise\n    // damaged file makes `new SQL.Database(bytes)` either throw (\"file is not a\n    // database\") or open a handle whose every query fails with \"database disk\n    // image is malformed\" — which, for a background dispatcher on a tick loop,\n    // means the same error spammed forever with no path to recovery. Detect it\n    // once at open, quarantine the bad file, and start fresh so the dev server\n    // becomes usable again instead of wedging.\n    try {\n      const candidate = new SQL.Database(bytes);\n      this.assertReadable(candidate);\n      this.db = candidate;\n    } catch (err) {\n      await this.quarantineCorruptFile(err);\n      this.db = new SQL.Database();\n    }\n  }\n\n  /**\n   * Force sql.js to actually read a page so a malformed image surfaces now\n   * rather than on the first business query. `PRAGMA quick_check` walks the\n   * b-tree structure without the full-scan cost of `integrity_check`; a healthy\n   * database returns a single `ok` row. Any thrown error (raw string or Error)\n   * or a non-`ok` result is treated as corruption.\n   */\n  private assertReadable(db: Database): void {\n    const res = db.exec('PRAGMA quick_check(1)');\n    const first = res?.[0]?.values?.[0]?.[0];\n    if (typeof first === 'string' && first.toLowerCase() !== 'ok') {\n      throw new Error(`sqlite quick_check failed: ${first}`);\n    }\n  }\n\n  /**\n   * Move a corrupt database file aside so its bytes are preserved for\n   * post-mortem while a fresh, empty database takes its place. Best-effort:\n   * failures here must not prevent the server from booting on a clean DB.\n   */\n  private async quarantineCorruptFile(cause: unknown): Promise<void> {\n    if (!this.fs) return;\n    const reason =\n      typeof cause === 'string' ? cause : (cause as Error)?.message ?? String(cause);\n    const backup = `${this.filename}.corrupt-${Date.now()}`;\n    try {\n      await this.fs.rename(this.filename, backup);\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}). Quarantined to ${backup} and starting from an empty ` +\n          `database so the server can boot.`,\n      );\n    } catch (renameErr) {\n      // Could not move it aside (e.g. permissions) — overwrite is still better\n      // than looping forever on a malformed image. Warn loudly and continue.\n      this.logger.warn(\n        `[driver-sqlite-wasm] Database image at ${this.filename} is corrupt ` +\n          `(${reason}) and could not be quarantined (${String(renameErr)}). ` +\n          `Starting from an empty database; the corrupt file will be overwritten ` +\n          `on the next flush.`,\n      );\n    }\n  }\n\n  /**\n   * Move a write-ahead log left behind by a *real* SQLite aside (#3941).\n   *\n   * The native driver keeps file-backed databases in WAL mode, and a clean close\n   * checkpoints the log away — so a non-empty `<db>-wal` here means the last\n   * process died without one. That log is a problem in both directions, and\n   * neither is something wasm SQLite can fix: it cannot read the log (we load\n   * only the main image, so any transaction still in there is invisible), and it\n   * must not leave it in place either — the next {@link flush} rewrites the\n   * image, and a real SQLite opening a fresh image beside a stale log would\n   * replay frames that no longer belong to it.\n   *\n   * So rename it, which loses nothing recoverable (the bytes are preserved for a\n   * real `sqlite3` to recover from) and disarms the mismatch. Best-effort: this\n   * is a dev-only step-down path and must never prevent a boot.\n   */\n  private async quarantineOrphanedWal(): Promise<void> {\n    if (!this.fs) return;\n    const wal = `${this.filename}-wal`;\n    let size: number;\n    try {\n      size = (await this.fs.stat(wal)).size;\n    } catch {\n      return; // no sidecar (the normal case) or an unreadable one\n    }\n    if (size <= 0) return; // checkpointed-and-truncated: nothing in it\n\n    const parked = `${wal}.orphaned-${Date.now()}`;\n    try {\n      await this.fs.rename(wal, parked);\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read — this database was last used in WAL mode and closed uncleanly. Parked it ` +\n          `at ${parked} and loaded the main image without it, so anything committed only to the ` +\n          `log is NOT in this session. To recover it, rebuild better-sqlite3 (or use \\`sqlite3\\`), ` +\n          `restore the log next to the database, and run \\`PRAGMA wal_checkpoint(TRUNCATE)\\`.`,\n      );\n    } catch (renameErr) {\n      this.logger.warn(\n        `[driver-sqlite-wasm] ${wal} holds ${size} bytes of write-ahead log that wasm SQLite ` +\n          `cannot read, and it could not be moved aside (${String(renameErr)}). Data committed ` +\n          `only to the log is missing from this session; checkpoint it with a real sqlite3 before ` +\n          `writing further.`,\n      );\n    }\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  /**\n   * Record that the statement just executed CHANGED the database, and schedule\n   * a flush according to {@link persist}.\n   *\n   * Deliberately takes no argument. It used to filter the caller's Knex\n   * `method` against a local write-method allowlist, which made \"did this\n   * mutate?\" a decision taken in TWO places — here and in the dialect's\n   * execution-path branch — and the two disagreed: an `INSERT … RETURNING`\n   * runs down the dialect's ROW-returning branch (it has rows to return), that\n   * branch never called this method at all, and so a whole class of committed\n   * writes was never marked dirty and never reached disk (#4518). One decision,\n   * one owner: {@link statementMutatesDatabase} in the dialect classifies the\n   * statement, and this method just does what it is told.\n   */\n  markDirty(): void {\n    if (this.isEphemeral || !this.fs) 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 atomic write below.\n        await this.atomicWriteFile(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  /**\n   * Write the database bytes to disk atomically: write to a sibling temp file,\n   * fsync it, then `rename()` it over the target.\n   *\n   * A plain `writeFile(this.filename, …)` truncates the target and streams the\n   * new bytes in place, so a process killed mid-write (a dev-server restart,\n   * Ctrl-C, or crash — likely under `on-write`, where every dispatcher tick\n   * flushes) leaves a half-written file. sql.js then rejects that file on the\n   * next boot with \"database disk image is malformed\". `rename(2)` is atomic\n   * within a filesystem, so a reader always sees either the complete old file\n   * or the complete new one — never a torn image. The temp file lives in the\n   * same directory as the target so the rename stays intra-filesystem.\n   */\n  private async atomicWriteFile(data: Buffer): Promise<void> {\n    if (!this.fs) return;\n    const tmp = `${this.filename}.tmp-${process.pid}-${(WasmSqliteConnection.tmpSeq += 1)}`;\n    let handle: import('node:fs/promises').FileHandle | undefined;\n    try {\n      handle = await this.fs.open(tmp, 'w');\n      await handle.writeFile(data);\n      // Flush the bytes to the platter before the rename so a crash can't leave\n      // a renamed-but-empty file behind on filesystems that reorder the two.\n      await handle.sync();\n      await handle.close();\n      handle = undefined;\n      await this.fs.rename(tmp, this.filename);\n    } catch (err) {\n      if (handle) {\n        try {\n          await handle.close();\n        } catch {\n          /* ignore */\n        }\n      }\n      // Clean up the temp file so a failed flush doesn't litter the data dir.\n      try {\n        await this.fs.unlink(tmp);\n      } catch {\n        /* ignore */\n      }\n      throw err;\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    // 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

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/driver-sqlite-wasm",
-  "version": "17.0.0-rc.1",
+  "version": "17.0.0-rc.2",
   "license": "Apache-2.0",
   "description": "WASM SQLite Driver for ObjectStack — runs in browser/WebContainer (StackBlitz) without native bindings",
   "keywords": [
@@ -26,12 +26,12 @@
     "knex": "^3.3.0",
     "nanoid": "^6.0.0",
     "sql.js": "^1.14.1",
-    "@objectstack/core": "17.0.0-rc.1",
-    "@objectstack/driver-sql": "17.0.0-rc.1",
-    "@objectstack/spec": "17.0.0-rc.1"
+    "@objectstack/driver-sql": "17.0.0-rc.2",
+    "@objectstack/spec": "17.0.0-rc.2",
+    "@objectstack/core": "17.0.0-rc.2"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "@types/sql.js": "^1.4.11",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"