firebird-wasm 0.1.0

package/dist/browser/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * firebird-wasm/browser – Browser entry point.
+ *
+ * Re-exports the browser-specific FirebirdBrowser class together with the
+ * shared types so that browser consumers can import from a single path:
+ *
+ * ```ts
+ * import { FirebirdBrowser } from 'firebird-wasm/browser';
+ * ```
+ */
+export { FirebirdBrowser, FirebirdBrowserTransaction } from './firebird-browser';
+export type { FirebirdBrowserOptions, ExecResult } from './firebird-browser';
+export { encodeParams, encodeParamValue } from './params';
+export { firebirdTypeName } from './field-types';
+export { acquireDatabaseLock, databaseLockName, DatabaseLockedError, } from './db-lock';
+export type { DatabaseLock, DatabaseLockOptions } from './db-lock';
+export { splitStatements } from './sql-script';
+export type { ScriptStatement } from './sql-script';
+export { DirectTransport } from './engine-transport';
+export type { EngineTransport, EngineHandle, DirectTransportOptions, } from './engine-transport';
+export { WorkerTransport } from './worker-transport';
+export type { WorkerTransportOptions } from './worker-transport';
+export { serveEngine } from './worker-entry';
+export type { EngineWorkerScope } from './worker-entry';
+export type { EngineOp, EngineRequest, EngineResponse, } from './worker-protocol';
+export { IndexedDBVFS } from './indexeddb-vfs';
+export type { IndexedDBVFSOptions, VFSMetadata } from './indexeddb-vfs';
+export { loadFirebirdWasm, allocString } from '../wasm-loader';
+export type { FirebirdWasmModule, WasmLoadOptions, EmscriptenFS, FbHandle, } from '../wasm-loader';
+export type { QueryResult, QueryParams, Row, FieldInfo, FirebirdTypeName, TransactionOptions, IsolationLevel, } from '../types';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACjF,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EACV,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EACV,QAAQ,EACR,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,WAAW,EACX,WAAW,EACX,GAAG,EACH,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,UAAU,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * firebird-wasm/browser – Browser entry point.
+ *
+ * Re-exports the browser-specific FirebirdBrowser class together with the
+ * shared types so that browser consumers can import from a single path:
+ *
+ * ```ts
+ * import { FirebirdBrowser } from 'firebird-wasm/browser';
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocString = exports.loadFirebirdWasm = exports.IndexedDBVFS = exports.serveEngine = exports.WorkerTransport = exports.DirectTransport = exports.splitStatements = exports.DatabaseLockedError = exports.databaseLockName = exports.acquireDatabaseLock = exports.firebirdTypeName = exports.encodeParamValue = exports.encodeParams = exports.FirebirdBrowserTransaction = exports.FirebirdBrowser = void 0;
+var firebird_browser_1 = require("./firebird-browser");
+Object.defineProperty(exports, "FirebirdBrowser", { enumerable: true, get: function () { return firebird_browser_1.FirebirdBrowser; } });
+Object.defineProperty(exports, "FirebirdBrowserTransaction", { enumerable: true, get: function () { return firebird_browser_1.FirebirdBrowserTransaction; } });
+var params_1 = require("./params");
+Object.defineProperty(exports, "encodeParams", { enumerable: true, get: function () { return params_1.encodeParams; } });
+Object.defineProperty(exports, "encodeParamValue", { enumerable: true, get: function () { return params_1.encodeParamValue; } });
+var field_types_1 = require("./field-types");
+Object.defineProperty(exports, "firebirdTypeName", { enumerable: true, get: function () { return field_types_1.firebirdTypeName; } });
+var db_lock_1 = require("./db-lock");
+Object.defineProperty(exports, "acquireDatabaseLock", { enumerable: true, get: function () { return db_lock_1.acquireDatabaseLock; } });
+Object.defineProperty(exports, "databaseLockName", { enumerable: true, get: function () { return db_lock_1.databaseLockName; } });
+Object.defineProperty(exports, "DatabaseLockedError", { enumerable: true, get: function () { return db_lock_1.DatabaseLockedError; } });
+var sql_script_1 = require("./sql-script");
+Object.defineProperty(exports, "splitStatements", { enumerable: true, get: function () { return sql_script_1.splitStatements; } });
+var engine_transport_1 = require("./engine-transport");
+Object.defineProperty(exports, "DirectTransport", { enumerable: true, get: function () { return engine_transport_1.DirectTransport; } });
+var worker_transport_1 = require("./worker-transport");
+Object.defineProperty(exports, "WorkerTransport", { enumerable: true, get: function () { return worker_transport_1.WorkerTransport; } });
+var worker_entry_1 = require("./worker-entry");
+Object.defineProperty(exports, "serveEngine", { enumerable: true, get: function () { return worker_entry_1.serveEngine; } });
+var indexeddb_vfs_1 = require("./indexeddb-vfs");
+Object.defineProperty(exports, "IndexedDBVFS", { enumerable: true, get: function () { return indexeddb_vfs_1.IndexedDBVFS; } });
+var wasm_loader_1 = require("../wasm-loader");
+Object.defineProperty(exports, "loadFirebirdWasm", { enumerable: true, get: function () { return wasm_loader_1.loadFirebirdWasm; } });
+Object.defineProperty(exports, "allocString", { enumerable: true, get: function () { return wasm_loader_1.allocString; } });
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,uDAAiF;AAAxE,mHAAA,eAAe,OAAA;AAAE,8HAAA,0BAA0B,OAAA;AAGpD,mCAA0D;AAAjD,sGAAA,YAAY,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAEvC,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAEzB,qCAImB;AAHjB,8GAAA,mBAAmB,OAAA;AACnB,2GAAA,gBAAgB,OAAA;AAChB,8GAAA,mBAAmB,OAAA;AAIrB,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAGxB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAOxB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAQpB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAGrB,8CAA+D;AAAtD,+GAAA,gBAAgB,OAAA;AAAE,0GAAA,WAAW,OAAA"}

package/dist/browser/indexeddb-vfs.d.ts

@@ -0,0 +1,132 @@
+/**
+ * indexeddb-vfs.ts – IndexedDB-backed virtual filesystem for Firebird WASM.
+ *
+ * Provides page-level persistence so that a Firebird database running inside
+ * the browser WASM sandbox can survive page reloads.  The API mirrors the
+ * operations that Emscripten's IDBFS performs, but is designed to be used
+ * directly as a persistence layer plugged into the Firebird WASM wrapper.
+ *
+ * ## Storage model
+ *
+ * Each database is stored in its own IndexedDB database and a single object
+ * store named `pages`.  Every record stores a fixed-size page of the database
+ * file, keyed by zero-based page number.
+ *
+ *   key (pageNumber: number) → value ({ data: ArrayBuffer })
+ *
+ * A special metadata record with key `__meta__` stores the page size and the
+ * total number of pages.
+ */
+/** Metadata record persisted alongside the page data. */
+export interface VFSMetadata {
+    /** Page size in bytes (Firebird default is usually 8 192). */
+    pageSize: number;
+    /** Total number of pages currently stored. */
+    pageCount: number;
+}
+/** Options for creating an {@link IndexedDBVFS} instance. */
+export interface IndexedDBVFSOptions {
+    /**
+     * Page size in bytes.  Must match the Firebird database page size.
+     * @default 8192
+     */
+    pageSize?: number;
+    /**
+     * IndexedDB database name prefix.  The actual database name is
+     * `${prefix}${dbName}`.
+     * @default 'firebird_'
+     */
+    prefix?: string;
+}
+/**
+ * IndexedDB-backed virtual filesystem for a single Firebird database.
+ *
+ * @example
+ * ```ts
+ * const vfs = new IndexedDBVFS({ pageSize: 8192 });
+ * await vfs.open('mydb');
+ *
+ * // Write the first page
+ * await vfs.writePage(0, someArrayBuffer);
+ *
+ * // Read it back
+ * const page = await vfs.readPage(0);
+ *
+ * // Persist all pending writes
+ * await vfs.sync();
+ *
+ * await vfs.close();
+ * ```
+ */
+export declare class IndexedDBVFS {
+    private readonly pageSize;
+    private readonly prefix;
+    private db;
+    private dbName;
+    constructor(options?: IndexedDBVFSOptions);
+    /**
+     * Open (or create) the IndexedDB store for `dbName`.
+     * Must be called before any read/write operations.
+     */
+    open(dbName: string): Promise<void>;
+    /** Close the underlying IndexedDB connection. */
+    close(): Promise<void>;
+    /**
+     * Read a page by its zero-based number.
+     * Returns a zero-filled buffer if the page has not been written yet.
+     */
+    readPage(pageNumber: number): Promise<ArrayBuffer>;
+    /** Write a page (full page overwrite). */
+    writePage(pageNumber: number, data: ArrayBuffer): Promise<void>;
+    /** Read the stored metadata, or return defaults if none exists. */
+    getMetadata(): Promise<VFSMetadata>;
+    /**
+     * Read the full database as a contiguous `Uint8Array`.
+     * Useful for exporting/downloading a database snapshot.
+     */
+    exportDatabase(): Promise<Uint8Array>;
+    /**
+     * Import a full database image, replacing any existing content.
+     * The `data` length must be a multiple of `pageSize`.
+     *
+     * The whole import runs in **one** IndexedDB transaction, and only pages
+     * whose contents actually changed are written.
+     *
+     * Both matter.  A transaction per page — which is what this used to do — is
+     * not atomic: a tab closed midway through leaves some pages new and some
+     * old, which is a corrupt database with no way back.  IndexedDB guarantees a
+     * transaction is all-or-nothing, so an interrupted persist now leaves the
+     * previous image intact.  Skipping unchanged pages then turns the common
+     * case (a few pages dirty in a large database) from O(database) into
+     * O(changes).
+     *
+     * Pages are compared against what is already stored rather than against an
+     * in-memory copy: the comparison is exact, and it costs no extra memory
+     * proportional to the database.
+     */
+    importDatabase(data: Uint8Array): Promise<void>;
+    /**
+     * Flush – a no-op for IndexedDB since each `put` is already durable once
+     * the transaction completes.  Provided for API symmetry.
+     */
+    sync(): Promise<void>;
+    /** Delete all stored pages and metadata for this database. */
+    clear(): Promise<void>;
+    /** Delete the entire IndexedDB database. */
+    destroy(): Promise<void>;
+    /**
+     * Synchronise pages between Emscripten's in-memory FS and IndexedDB.
+     *
+     * @param direction - `'persist'` writes MEMFS → IndexedDB,
+     *                    `'populate'` reads IndexedDB → MEMFS.
+     * @param readFile  - Callback to read a file from Emscripten's FS.
+     * @param writeFile - Callback to write a file into Emscripten's FS.
+     * @param dbPath    - The virtual path of the database in Emscripten's FS.
+     */
+    syncWithEmscriptenFS(direction: 'persist' | 'populate', readFile: (path: string) => Uint8Array, writeFile: (path: string, data: Uint8Array) => void, dbPath: string): Promise<void>;
+    private requireDb;
+    private idbGet;
+    private idbPut;
+    private updateMeta;
+}
+//# sourceMappingURL=indexeddb-vfs.d.ts.map

package/dist/browser/indexeddb-vfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-vfs.d.ts","sourceRoot":"","sources":["../../src/browser/indexeddb-vfs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,MAAM,CAAM;gBAER,OAAO,GAAE,mBAAwB;IAO7C;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzC,iDAAiD;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;OAGG;IACG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAMxD,0CAA0C;IACpC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrE,mEAAmE;IAC7D,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAKzC;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;IAa3C;;;;;;;;;;;;;;;;;;OAkBG;IACG,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDrD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,8DAA8D;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,4CAA4C;IACtC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B;;;;;;;;OAQG;IACG,oBAAoB,CACxB,SAAS,EAAE,SAAS,GAAG,UAAU,EACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,EACtC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EACnD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAchB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,MAAM;YAWA,UAAU;CAOzB"}

package/dist/browser/indexeddb-vfs.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * indexeddb-vfs.ts – IndexedDB-backed virtual filesystem for Firebird WASM.
+ *
+ * Provides page-level persistence so that a Firebird database running inside
+ * the browser WASM sandbox can survive page reloads.  The API mirrors the
+ * operations that Emscripten's IDBFS performs, but is designed to be used
+ * directly as a persistence layer plugged into the Firebird WASM wrapper.
+ *
+ * ## Storage model
+ *
+ * Each database is stored in its own IndexedDB database and a single object
+ * store named `pages`.  Every record stores a fixed-size page of the database
+ * file, keyed by zero-based page number.
+ *
+ *   key (pageNumber: number) → value ({ data: ArrayBuffer })
+ *
+ * A special metadata record with key `__meta__` stores the page size and the
+ * total number of pages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexedDBVFS = void 0;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_PAGE_SIZE = 8192;
+const DEFAULT_PREFIX = 'firebird_';
+const STORE_NAME = 'pages';
+const META_KEY = '__meta__';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Exact byte equality.  Used to decide whether a page needs rewriting. */
+function sameBytes(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * IndexedDB-backed virtual filesystem for a single Firebird database.
+ *
+ * @example
+ * ```ts
+ * const vfs = new IndexedDBVFS({ pageSize: 8192 });
+ * await vfs.open('mydb');
+ *
+ * // Write the first page
+ * await vfs.writePage(0, someArrayBuffer);
+ *
+ * // Read it back
+ * const page = await vfs.readPage(0);
+ *
+ * // Persist all pending writes
+ * await vfs.sync();
+ *
+ * await vfs.close();
+ * ```
+ */
+class IndexedDBVFS {
+    constructor(options = {}) {
+        this.db = null;
+        this.dbName = '';
+        this.pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE;
+        this.prefix = options.prefix ?? DEFAULT_PREFIX;
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────────────
+    /**
+     * Open (or create) the IndexedDB store for `dbName`.
+     * Must be called before any read/write operations.
+     */
+    async open(dbName) {
+        if (this.db) {
+            throw new Error(`IndexedDBVFS already open for "${this.dbName}"`);
+        }
+        this.dbName = dbName;
+        const idbName = `${this.prefix}${dbName}`;
+        this.db = await new Promise((resolve, reject) => {
+            const request = indexedDB.open(idbName, 1);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(STORE_NAME)) {
+                    db.createObjectStore(STORE_NAME);
+                }
+            };
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /** Close the underlying IndexedDB connection. */
+    async close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    // ── Page I/O ──────────────────────────────────────────────────────────
+    /**
+     * Read a page by its zero-based number.
+     * Returns a zero-filled buffer if the page has not been written yet.
+     */
+    async readPage(pageNumber) {
+        const record = await this.idbGet(pageNumber);
+        if (record)
+            return record.data;
+        return new ArrayBuffer(this.pageSize);
+    }
+    /** Write a page (full page overwrite). */
+    async writePage(pageNumber, data) {
+        if (data.byteLength !== this.pageSize) {
+            throw new RangeError(`Page data must be exactly ${this.pageSize} bytes (got ${data.byteLength})`);
+        }
+        await this.idbPut(pageNumber, { data });
+        await this.updateMeta(pageNumber);
+    }
+    /** Read the stored metadata, or return defaults if none exists. */
+    async getMetadata() {
+        const meta = await this.idbGet(META_KEY);
+        return meta ?? { pageSize: this.pageSize, pageCount: 0 };
+    }
+    /**
+     * Read the full database as a contiguous `Uint8Array`.
+     * Useful for exporting/downloading a database snapshot.
+     */
+    async exportDatabase() {
+        const meta = await this.getMetadata();
+        const totalBytes = meta.pageCount * meta.pageSize;
+        const output = new Uint8Array(totalBytes);
+        for (let i = 0; i < meta.pageCount; i++) {
+            const page = await this.readPage(i);
+            output.set(new Uint8Array(page), i * meta.pageSize);
+        }
+        return output;
+    }
+    /**
+     * Import a full database image, replacing any existing content.
+     * The `data` length must be a multiple of `pageSize`.
+     *
+     * The whole import runs in **one** IndexedDB transaction, and only pages
+     * whose contents actually changed are written.
+     *
+     * Both matter.  A transaction per page — which is what this used to do — is
+     * not atomic: a tab closed midway through leaves some pages new and some
+     * old, which is a corrupt database with no way back.  IndexedDB guarantees a
+     * transaction is all-or-nothing, so an interrupted persist now leaves the
+     * previous image intact.  Skipping unchanged pages then turns the common
+     * case (a few pages dirty in a large database) from O(database) into
+     * O(changes).
+     *
+     * Pages are compared against what is already stored rather than against an
+     * in-memory copy: the comparison is exact, and it costs no extra memory
+     * proportional to the database.
+     */
+    async importDatabase(data) {
+        if (data.byteLength % this.pageSize !== 0) {
+            throw new RangeError(`Database size (${data.byteLength}) is not a multiple of page size (${this.pageSize})`);
+        }
+        const pageCount = data.byteLength / this.pageSize;
+        const db = this.requireDb();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            // Resolve on the transaction, not on the last request: only completion
+            // means the changes are durable.
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+            tx.onabort = () => reject(tx.error ?? new Error('IndexedDB transaction aborted'));
+            // Previous size, so pages past the new end can be removed.
+            const metaRequest = store.get(META_KEY);
+            metaRequest.onsuccess = () => {
+                const previous = metaRequest.result?.pageCount ?? 0;
+                for (let i = pageCount; i < previous; i++) {
+                    store.delete(i);
+                }
+            };
+            for (let i = 0; i < pageCount; i++) {
+                const offset = i * this.pageSize;
+                const page = data.subarray(offset, offset + this.pageSize);
+                const existing = store.get(i);
+                existing.onsuccess = () => {
+                    const stored = existing.result?.data;
+                    if (stored && sameBytes(new Uint8Array(stored), page)) {
+                        return; // unchanged
+                    }
+                    // slice() copies: `page` is a view onto the caller's buffer, which
+                    // must not be captured by the store.
+                    store.put({ data: page.slice().buffer }, i);
+                };
+            }
+            store.put({ pageSize: this.pageSize, pageCount }, META_KEY);
+        });
+    }
+    /**
+     * Flush – a no-op for IndexedDB since each `put` is already durable once
+     * the transaction completes.  Provided for API symmetry.
+     */
+    async sync() {
+        // IndexedDB writes are durable after the transaction completes.
+    }
+    /** Delete all stored pages and metadata for this database. */
+    async clear() {
+        const db = this.requireDb();
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            const request = store.clear();
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /** Delete the entire IndexedDB database. */
+    async destroy() {
+        const idbName = `${this.prefix}${this.dbName}`;
+        await this.close();
+        await new Promise((resolve, reject) => {
+            const request = indexedDB.deleteDatabase(idbName);
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    // ── Emscripten FS integration ─────────────────────────────────────────
+    /**
+     * Synchronise pages between Emscripten's in-memory FS and IndexedDB.
+     *
+     * @param direction - `'persist'` writes MEMFS → IndexedDB,
+     *                    `'populate'` reads IndexedDB → MEMFS.
+     * @param readFile  - Callback to read a file from Emscripten's FS.
+     * @param writeFile - Callback to write a file into Emscripten's FS.
+     * @param dbPath    - The virtual path of the database in Emscripten's FS.
+     */
+    async syncWithEmscriptenFS(direction, readFile, writeFile, dbPath) {
+        if (direction === 'persist') {
+            const data = readFile(dbPath);
+            await this.importDatabase(data);
+        }
+        else {
+            const data = await this.exportDatabase();
+            if (data.byteLength > 0) {
+                writeFile(dbPath, data);
+            }
+        }
+    }
+    // ── Private helpers ───────────────────────────────────────────────────
+    requireDb() {
+        if (!this.db) {
+            throw new Error('IndexedDBVFS is not open. Call open() first.');
+        }
+        return this.db;
+    }
+    idbGet(key) {
+        const db = this.requireDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readonly');
+            const store = tx.objectStore(STORE_NAME);
+            const request = store.get(key);
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => reject(request.error);
+        });
+    }
+    idbPut(key, value) {
+        const db = this.requireDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, 'readwrite');
+            const store = tx.objectStore(STORE_NAME);
+            const request = store.put(value, key);
+            request.onsuccess = () => resolve();
+            request.onerror = () => reject(request.error);
+        });
+    }
+    async updateMeta(latestPageNumber) {
+        const meta = await this.getMetadata();
+        const newCount = Math.max(meta.pageCount, latestPageNumber + 1);
+        if (newCount !== meta.pageCount) {
+            await this.idbPut(META_KEY, { pageSize: this.pageSize, pageCount: newCount });
+        }
+    }
+}
+exports.IndexedDBVFS = IndexedDBVFS;
+//# sourceMappingURL=indexeddb-vfs.js.map

package/dist/browser/indexeddb-vfs.js.map

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

package/dist/browser/params.d.ts

@@ -0,0 +1,33 @@
+/**
+ * params.ts – encode query parameters for the WASM engine.
+ *
+ * Parameters cross the boundary as one packed buffer rather than JSON, so the
+ * C side needs no parser and there is no escaping to get wrong:
+ *
+ *     u32  count
+ *     per parameter:
+ *       u8   isNull
+ *       u32  byteLength    (absent when isNull)
+ *       ...  UTF-8 bytes   (absent when isNull)
+ *
+ * Every value is sent as text.  The engine describes the input message as
+ * VARCHAR UTF-8 and converts to each column's actual type, which is why one
+ * path handles integers, dates and strings alike — the alternative is
+ * reimplementing Firebird's conversion rules here and getting them subtly
+ * wrong.
+ */
+import type { QueryParams } from '../types';
+/**
+ * Render one parameter the way Firebird's string-to-type conversion expects.
+ *
+ * @throws if the value has no unambiguous SQL text form.
+ */
+export declare function encodeParamValue(value: unknown, index: number): string;
+/**
+ * Pack parameters into the buffer the C API expects.
+ *
+ * `null` and `undefined` both become SQL NULL — JavaScript uses them
+ * interchangeably for "absent", and rejecting one would be a trap.
+ */
+export declare function encodeParams(params: QueryParams): Uint8Array;
+//# sourceMappingURL=params.d.ts.map

package/dist/browser/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/browser/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA6CtE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAkC5D"}

package/dist/browser/params.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * params.ts – encode query parameters for the WASM engine.
+ *
+ * Parameters cross the boundary as one packed buffer rather than JSON, so the
+ * C side needs no parser and there is no escaping to get wrong:
+ *
+ *     u32  count
+ *     per parameter:
+ *       u8   isNull
+ *       u32  byteLength    (absent when isNull)
+ *       ...  UTF-8 bytes   (absent when isNull)
+ *
+ * Every value is sent as text.  The engine describes the input message as
+ * VARCHAR UTF-8 and converts to each column's actual type, which is why one
+ * path handles integers, dates and strings alike — the alternative is
+ * reimplementing Firebird's conversion rules here and getting them subtly
+ * wrong.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodeParamValue = encodeParamValue;
+exports.encodeParams = encodeParams;
+/**
+ * Render one parameter the way Firebird's string-to-type conversion expects.
+ *
+ * @throws if the value has no unambiguous SQL text form.
+ */
+function encodeParamValue(value, index) {
+    switch (typeof value) {
+        case 'string':
+            return value;
+        case 'number':
+            if (!Number.isFinite(value)) {
+                throw new RangeError(`Parameter ${index} is ${value}, which SQL has no representation for`);
+            }
+            return String(value);
+        case 'bigint':
+            return value.toString();
+        case 'boolean':
+            // Firebird's BOOLEAN literals.
+            return value ? 'TRUE' : 'FALSE';
+        default:
+            break;
+    }
+    if (value instanceof Date) {
+        if (Number.isNaN(value.getTime())) {
+            throw new RangeError(`Parameter ${index} is an invalid Date`);
+        }
+        // Firebird's TIMESTAMP literal format. toISOString() is always UTC, and
+        // its 'T'/'Z' are not accepted, so the pieces are reassembled.
+        return value.toISOString().replace('T', ' ').replace('Z', '');
+    }
+    if (value instanceof Uint8Array || value instanceof ArrayBuffer) {
+        throw new TypeError(`Parameter ${index} is binary, which the WASM build cannot bind yet — ` +
+            'the parameter encoding is text-based (see docs/roadmap.md, M2)');
+    }
+    throw new TypeError(`Parameter ${index} has unsupported type ${value === null ? 'null' : typeof value}; pass a string, number, bigint, boolean, Date, null or undefined`);
+}
+/**
+ * Pack parameters into the buffer the C API expects.
+ *
+ * `null` and `undefined` both become SQL NULL — JavaScript uses them
+ * interchangeably for "absent", and rejecting one would be a trap.
+ */
+function encodeParams(params) {
+    const encoder = new TextEncoder();
+    const encoded = params.map((value, index) => value === null || value === undefined
+        ? null
+        : encoder.encode(encodeParamValue(value, index)));
+    let size = 4;
+    for (const bytes of encoded) {
+        size += 1 + (bytes ? 4 + bytes.length : 0);
+    }
+    const out = new Uint8Array(size);
+    const view = new DataView(out.buffer);
+    let pos = 0;
+    view.setUint32(pos, encoded.length, true);
+    pos += 4;
+    for (const bytes of encoded) {
+        if (!bytes) {
+            out[pos++] = 1; // isNull
+            continue;
+        }
+        out[pos++] = 0;
+        view.setUint32(pos, bytes.length, true);
+        pos += 4;
+        out.set(bytes, pos);
+        pos += bytes.length;
+    }
+    return out;
+}
+//# sourceMappingURL=params.js.map

package/dist/browser/params.js.map

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