firebird-wasm 0.1.0

package/dist/browser/firebird-browser.d.ts

@@ -0,0 +1,249 @@
+/**
+ * firebird-browser.ts – Browser-compatible FirebirdLite backed by WASM + IndexedDB.
+ *
+ * Provides the same PGlite-style async API as the Node.js `FirebirdLite` class,
+ * but runs entirely in the browser using:
+ *
+ *   1. The Firebird Embedded engine compiled to WebAssembly (see `wasm/`).
+ *   2. An IndexedDB-backed virtual filesystem for durable page storage.
+ *
+ * @example
+ * ```ts
+ * import { FirebirdBrowser } from 'firebird-wasm/browser';
+ *
+ * // A browser must run the engine in a Worker — see the `worker` option.
+ * const db = new FirebirdBrowser('mydb', {
+ *   worker: new Worker('/firebird-engine-worker.js'),
+ * });
+ *
+ * await db.exec('CREATE TABLE t (id INTEGER, name VARCHAR(100))');
+ * const result = await db.query('SELECT * FROM t');
+ * await db.close();
+ * ```
+ */
+import type { IndexedDBVFSOptions } from './indexeddb-vfs';
+import type { EngineHandle, EngineTransport } from './engine-transport';
+import type { QueryResult, Row, QueryParams, TransactionOptions } from '../types';
+/** What a statement did.  Returned by `exec()`. */
+export interface ExecResult {
+    /** Rows affected — for INSERT, UPDATE and DELETE.  0 for DDL. */
+    affectedRows: number;
+}
+/** Options for creating a {@link FirebirdBrowser} instance. */
+export interface FirebirdBrowserOptions {
+    /** Options forwarded to the IndexedDB VFS layer. */
+    vfs?: IndexedDBVFSOptions;
+    /**
+     * URL or `ArrayBuffer` of the `firebird-embedded.wasm` binary.
+     * Passed through to the engine loader.
+     */
+    wasmBinary?: ArrayBuffer | string;
+    /**
+     * Custom `locateFile` callback for Emscripten.
+     * @see {@link import('../wasm-loader').WasmLoadOptions.locateFile}
+     */
+    locateFile?: (filename: string) => string;
+    /**
+     * Worker running the engine.
+     *
+     * **Browsers need this.**  The WASM build uses pthreads, so Firebird blocks
+     * on mutexes while opening a database, and a browser main thread is not
+     * allowed to block — without a Worker the page deadlocks.  Build the Worker
+     * script from `firebird-wasm/browser/worker-entry`.
+     *
+     * Omit it only where blocking the calling thread is acceptable, such as
+     * Node or a test harness driving a stub engine.
+     */
+    worker?: Worker;
+    /**
+     * Use a transport of your own.  Takes precedence over `worker`; mainly a
+     * seam for tests.
+     */
+    transport?: EngineTransport;
+    /**
+     * Persist to IndexedDB automatically after writes.
+     *
+     * Without this, a tab closed without `close()` loses everything written in
+     * that session — the common way to leave a page.  Enabled by default:
+     * silently losing committed data is a worse default than the cost of
+     * writing it.
+     *
+     * Set `false` to persist only on `close()` and explicit `persist()` calls.
+     *
+     * @default true
+     */
+    autoPersist?: boolean;
+    /**
+     * How long to wait after the last write before persisting, in
+     * milliseconds.  Bursts of statements coalesce into one persist.
+     *
+     * @default 500
+     */
+    autoPersistDebounceMs?: number;
+    /**
+     * Called when a background persist fails.
+     *
+     * Background persists cannot reject into caller code, and swallowing the
+     * error would hide data loss, so it is reported here.  Defaults to
+     * `console.error`.
+     */
+    onPersistError?: (error: Error) => void;
+    /**
+     * What to do when the same database is already open in another tab.
+     *
+     * Every tab keeps its own complete copy of the database and persists the
+     * whole image, so two writers do not interleave — the later persist discards
+     * the earlier tab's work entirely, with both tabs reporting success.
+     *
+     * - `'exclusive'` (default) takes a cross-tab lock and fails with
+     *   {@link DatabaseLockedError} if another tab will not release it in time.
+     * - `'allow-unsafe'` skips the lock.  Only sound when at most one of the
+     *   tabs writes.
+     *
+     * @default 'exclusive'
+     */
+    multiTab?: 'exclusive' | 'allow-unsafe';
+    /**
+     * How long to wait for another tab to release the database, in
+     * milliseconds.  `Infinity` waits indefinitely.
+     *
+     * @default 5000
+     */
+    lockTimeoutMs?: number;
+}
+/**
+ * Browser-side Firebird database backed by WASM + IndexedDB.
+ *
+ * Mirrors the `FirebirdLite` API so application code can switch between the
+ * Node.js native driver and the in-browser WASM engine with minimal changes.
+ */
+export declare class FirebirdBrowser {
+    private readonly dbName;
+    private readonly options;
+    private readonly vfs;
+    private readonly engine;
+    private dbHandle;
+    private closed;
+    private initPromise;
+    private readonly autoPersist;
+    private readonly autoPersistDebounceMs;
+    private readonly onPersistError;
+    private persistTimer;
+    /** In-flight persist, so two never overlap. */
+    private persistInFlight;
+    /** A write arrived while a persist was running; persist again after it. */
+    private persistAgain;
+    private lifecycleAttached;
+    private readonly multiTab;
+    private readonly lockTimeoutMs;
+    /** Held for the connection's lifetime; released by close(). */
+    private lock;
+    /**
+     * @param dbName  Logical database name.  Used as the IndexedDB store name
+     *                and the filename inside Emscripten's virtual FS.
+     * @param options Optional configuration.
+     */
+    constructor(dbName: string, options?: FirebirdBrowserOptions);
+    /** Path of the database inside Emscripten's filesystem. */
+    private get dbPath();
+    /**
+     * Execute one or more statements that do not return rows.
+     *
+     * A script may contain several statements, which is what makes this usable
+     * for migrations.  Statement boundaries respect string literals, quoted
+     * identifiers, comments and `SET TERM`, so a stored procedure body full of
+     * semicolons survives intact.  Each statement runs in its own transaction,
+     * committed on success — a failure part-way leaves the statements before it
+     * committed, as it would in `isql`.
+     *
+     * Parameters may only be supplied for a single statement: there is no way to
+     * say which statement a value belongs to otherwise.  Use `query()` for
+     * parameterised statements that return rows.
+     *
+     * @returns one result per statement, in order.
+     */
+    exec(sql: string, params?: QueryParams): Promise<ExecResult[]>;
+    /**
+     * Execute a SQL query and return the result rows.
+     *
+     * Parameters are bound with `?` placeholders, as in the Node.js backend:
+     *
+     * ```ts
+     * await db.query('SELECT * FROM items WHERE id = ?', [1]);
+     * ```
+     */
+    query<T extends Row = Row>(sql: string, params?: QueryParams, _options?: TransactionOptions): Promise<QueryResult<T>>;
+    /**
+     * Run a function inside an explicit transaction.
+     */
+    transaction<T>(fn: (tx: FirebirdBrowserTransaction) => Promise<T>, _options?: TransactionOptions): Promise<T>;
+    /**
+     * Persist the in-memory database pages to IndexedDB.
+     * Call this periodically or before the page unloads to avoid data loss.
+     */
+    persist(): Promise<void>;
+    /**
+     * Close the database and release all resources.
+     */
+    close(): Promise<void>;
+    /** Release the cross-tab lock, if this instance holds one. */
+    private releaseLock;
+    /** Note that the database has changed and schedule a persist. */
+    private markDirty;
+    private cancelScheduledPersist;
+    /**
+     * Persist without a caller to reject into.
+     *
+     * Failures are reported through `onPersistError`; letting them become
+     * unhandled rejections would hide data loss.
+     */
+    private persistInBackground;
+    /**
+     * Flush when the page is being hidden or unloaded.
+     *
+     * `visibilitychange` to hidden is the event to rely on: it fires on mobile
+     * when an app is backgrounded, where `beforeunload` and `unload` often do
+     * not fire at all.  `pagehide` covers the bfcache case.  Neither can await
+     * an async write, so this is best-effort — which is why writes are also
+     * persisted on a debounce rather than only here.
+     */
+    private attachLifecycleListeners;
+    private detachLifecycleListeners;
+    private readonly onVisibilityChange;
+    private readonly onPageHide;
+    private ensureReady;
+    private init;
+}
+/**
+ * A handle to an active transaction in the browser WASM engine.
+ *
+ * Statements issued here are bound to the transaction handle, so a rollback
+ * really does undo them.
+ */
+export declare class FirebirdBrowserTransaction {
+    private readonly engine;
+    private readonly dbHandle;
+    private readonly txHandle;
+    private finished;
+    constructor(engine: EngineTransport, dbHandle: EngineHandle, txHandle: EngineHandle);
+    /** Whether this transaction has already been rolled back. */
+    get isFinished(): boolean;
+    /**
+     * Roll this transaction back and stop.
+     *
+     * The enclosing `transaction()` will not commit afterwards.  Use this to
+     * abandon a transaction deliberately, rather than throwing an error you do
+     * not mean — throwing also rolls back, but it propagates to the caller.
+     */
+    rollback(): Promise<void>;
+    private assertUsable;
+    /**
+     * Execute a DDL/DML statement inside this transaction.
+     *
+     * @returns the number of rows affected.
+     */
+    exec(sql: string, params?: QueryParams): Promise<ExecResult>;
+    /** Execute a SELECT inside this transaction and return rows. */
+    query<T extends Row = Row>(sql: string, params?: QueryParams): Promise<QueryResult<T>>;
+}
+//# sourceMappingURL=firebird-browser.d.ts.map

package/dist/browser/firebird-browser.d.ts.map

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

package/dist/browser/firebird-browser.js

@@ -0,0 +1,401 @@
+"use strict";
+/**
+ * firebird-browser.ts – Browser-compatible FirebirdLite backed by WASM + IndexedDB.
+ *
+ * Provides the same PGlite-style async API as the Node.js `FirebirdLite` class,
+ * but runs entirely in the browser using:
+ *
+ *   1. The Firebird Embedded engine compiled to WebAssembly (see `wasm/`).
+ *   2. An IndexedDB-backed virtual filesystem for durable page storage.
+ *
+ * @example
+ * ```ts
+ * import { FirebirdBrowser } from 'firebird-wasm/browser';
+ *
+ * // A browser must run the engine in a Worker — see the `worker` option.
+ * const db = new FirebirdBrowser('mydb', {
+ *   worker: new Worker('/firebird-engine-worker.js'),
+ * });
+ *
+ * await db.exec('CREATE TABLE t (id INTEGER, name VARCHAR(100))');
+ * const result = await db.query('SELECT * FROM t');
+ * await db.close();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirebirdBrowserTransaction = exports.FirebirdBrowser = void 0;
+const indexeddb_vfs_1 = require("./indexeddb-vfs");
+const engine_transport_1 = require("./engine-transport");
+const worker_transport_1 = require("./worker-transport");
+const sql_script_1 = require("./sql-script");
+const db_lock_1 = require("./db-lock");
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Browser-side Firebird database backed by WASM + IndexedDB.
+ *
+ * Mirrors the `FirebirdLite` API so application code can switch between the
+ * Node.js native driver and the in-browser WASM engine with minimal changes.
+ */
+class FirebirdBrowser {
+    /**
+     * @param dbName  Logical database name.  Used as the IndexedDB store name
+     *                and the filename inside Emscripten's virtual FS.
+     * @param options Optional configuration.
+     */
+    constructor(dbName, options = {}) {
+        this.dbHandle = 0;
+        this.closed = false;
+        this.initPromise = null;
+        this.persistTimer = null;
+        /** In-flight persist, so two never overlap. */
+        this.persistInFlight = null;
+        /** A write arrived while a persist was running; persist again after it. */
+        this.persistAgain = false;
+        this.lifecycleAttached = false;
+        /** Held for the connection's lifetime; released by close(). */
+        this.lock = null;
+        this.onVisibilityChange = () => {
+            if (document.visibilityState === 'hidden') {
+                this.cancelScheduledPersist();
+                void this.persistInBackground();
+            }
+        };
+        this.onPageHide = () => {
+            this.cancelScheduledPersist();
+            void this.persistInBackground();
+        };
+        this.dbName = dbName;
+        this.options = options;
+        this.vfs = new indexeddb_vfs_1.IndexedDBVFS(options.vfs);
+        this.multiTab = options.multiTab ?? 'exclusive';
+        this.lockTimeoutMs = options.lockTimeoutMs ?? 5000;
+        this.autoPersist = options.autoPersist ?? true;
+        this.autoPersistDebounceMs = options.autoPersistDebounceMs ?? 500;
+        this.onPersistError =
+            options.onPersistError ??
+                ((error) => console.error('[firebird-wasm] background persist failed', error));
+        this.engine =
+            options.transport ??
+                (options.worker
+                    ? new worker_transport_1.WorkerTransport(options.worker)
+                    : new engine_transport_1.DirectTransport({
+                        wasmBinary: options.wasmBinary,
+                        locateFile: options.locateFile,
+                    }));
+    }
+    /** Path of the database inside Emscripten's filesystem. */
+    get dbPath() {
+        return `/data/${this.dbName}.fdb`;
+    }
+    // ── Public API (mirrors FirebirdLite) ─────────────────────────────────
+    /**
+     * Execute one or more statements that do not return rows.
+     *
+     * A script may contain several statements, which is what makes this usable
+     * for migrations.  Statement boundaries respect string literals, quoted
+     * identifiers, comments and `SET TERM`, so a stored procedure body full of
+     * semicolons survives intact.  Each statement runs in its own transaction,
+     * committed on success — a failure part-way leaves the statements before it
+     * committed, as it would in `isql`.
+     *
+     * Parameters may only be supplied for a single statement: there is no way to
+     * say which statement a value belongs to otherwise.  Use `query()` for
+     * parameterised statements that return rows.
+     *
+     * @returns one result per statement, in order.
+     */
+    async exec(sql, params = []) {
+        await this.ensureReady();
+        const statements = (0, sql_script_1.splitStatements)(sql);
+        if (params.length > 0 && statements.length > 1) {
+            throw new Error(`Parameters cannot be used with a multi-statement script ` +
+                `(${statements.length} statements found); run the statements separately`);
+        }
+        const results = [];
+        for (const statement of statements) {
+            const affectedRows = await this.engine.execute(this.dbHandle, 0, statement.sql, params);
+            results.push({ affectedRows });
+        }
+        if (results.length > 0) {
+            this.markDirty();
+        }
+        return results;
+    }
+    /**
+     * Execute a SQL query and return the result rows.
+     *
+     * Parameters are bound with `?` placeholders, as in the Node.js backend:
+     *
+     * ```ts
+     * await db.query('SELECT * FROM items WHERE id = ?', [1]);
+     * ```
+     */
+    async query(sql, params = [], _options = {}) {
+        await this.ensureReady();
+        return this.engine.query(this.dbHandle, 0, sql, params);
+    }
+    /**
+     * Run a function inside an explicit transaction.
+     */
+    async transaction(fn, _options = {}) {
+        await this.ensureReady();
+        const txHandle = await this.engine.startTransaction(this.dbHandle);
+        const tx = new FirebirdBrowserTransaction(this.engine, this.dbHandle, txHandle);
+        let result;
+        try {
+            result = await fn(tx);
+        }
+        catch (err) {
+            if (!tx.isFinished) {
+                await this.engine.rollback(txHandle);
+            }
+            throw err;
+        }
+        // The callback may have rolled back explicitly; committing after that
+        // would target a handle the engine has already finished with.
+        if (tx.isFinished) {
+            this.markDirty();
+            return result;
+        }
+        // A failed commit finishes the transaction too, so there is nothing left
+        // to roll back here.
+        await this.engine.commit(txHandle);
+        this.markDirty();
+        return result;
+    }
+    /**
+     * Persist the in-memory database pages to IndexedDB.
+     * Call this periodically or before the page unloads to avoid data loss.
+     */
+    async persist() {
+        if (!this.dbHandle)
+            return;
+        // Two persists must not interleave: both read the image and write the
+        // same store, and the later one could finish first and roll the database
+        // back to an older state.
+        if (this.persistInFlight) {
+            this.persistAgain = true;
+            await this.persistInFlight;
+            return;
+        }
+        this.cancelScheduledPersist();
+        const run = (async () => {
+            const image = await this.engine.readFile(this.dbPath);
+            await this.vfs.importDatabase(image);
+        })();
+        this.persistInFlight = run;
+        try {
+            await run;
+        }
+        finally {
+            this.persistInFlight = null;
+        }
+        // Writes that arrived mid-persist are not covered by the image just
+        // written, so go again.
+        if (this.persistAgain) {
+            this.persistAgain = false;
+            await this.persist();
+        }
+    }
+    /**
+     * Close the database and release all resources.
+     */
+    async close() {
+        if (this.closed)
+            return;
+        // Stop scheduling before marking closed, so nothing fires mid-teardown.
+        this.cancelScheduledPersist();
+        this.detachLifecycleListeners();
+        // A background persist may still be running; let it finish so it cannot
+        // write after the engine has gone.
+        if (this.persistInFlight) {
+            try {
+                await this.persistInFlight;
+            }
+            catch {
+                // Already reported through onPersistError.
+            }
+        }
+        this.closed = true;
+        if (this.dbHandle) {
+            // Persist before closing.
+            await this.persist();
+            await this.engine.detachDatabase(this.dbHandle);
+            this.dbHandle = 0;
+        }
+        try {
+            await this.vfs.close();
+            await this.engine.dispose();
+        }
+        finally {
+            // Last, and unconditionally: a lock still held after a failed teardown
+            // locks the database out of every future tab until the page is gone.
+            await this.releaseLock();
+        }
+    }
+    /** Release the cross-tab lock, if this instance holds one. */
+    async releaseLock() {
+        const lock = this.lock;
+        this.lock = null;
+        await lock?.release();
+    }
+    // ── Automatic persistence ─────────────────────────────────────────────
+    /** Note that the database has changed and schedule a persist. */
+    markDirty() {
+        if (!this.autoPersist || this.closed)
+            return;
+        if (this.persistTimer !== null) {
+            clearTimeout(this.persistTimer);
+        }
+        this.persistTimer = setTimeout(() => {
+            this.persistTimer = null;
+            void this.persistInBackground();
+        }, this.autoPersistDebounceMs);
+    }
+    cancelScheduledPersist() {
+        if (this.persistTimer !== null) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = null;
+        }
+    }
+    /**
+     * Persist without a caller to reject into.
+     *
+     * Failures are reported through `onPersistError`; letting them become
+     * unhandled rejections would hide data loss.
+     */
+    async persistInBackground() {
+        if (this.closed)
+            return;
+        try {
+            await this.persist();
+        }
+        catch (err) {
+            this.onPersistError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    /**
+     * Flush when the page is being hidden or unloaded.
+     *
+     * `visibilitychange` to hidden is the event to rely on: it fires on mobile
+     * when an app is backgrounded, where `beforeunload` and `unload` often do
+     * not fire at all.  `pagehide` covers the bfcache case.  Neither can await
+     * an async write, so this is best-effort — which is why writes are also
+     * persisted on a debounce rather than only here.
+     */
+    attachLifecycleListeners() {
+        if (this.lifecycleAttached || !this.autoPersist)
+            return;
+        if (typeof document === 'undefined' || typeof addEventListener !== 'function') {
+            return; // not a browser
+        }
+        this.lifecycleAttached = true;
+        document.addEventListener('visibilitychange', this.onVisibilityChange);
+        addEventListener('pagehide', this.onPageHide);
+    }
+    detachLifecycleListeners() {
+        if (!this.lifecycleAttached)
+            return;
+        this.lifecycleAttached = false;
+        document.removeEventListener('visibilitychange', this.onVisibilityChange);
+        removeEventListener('pagehide', this.onPageHide);
+    }
+    // ── Initialisation ────────────────────────────────────────────────────
+    async ensureReady() {
+        if (this.dbHandle)
+            return;
+        if (this.closed) {
+            throw new Error('FirebirdBrowser instance has been closed');
+        }
+        // Prevent concurrent initialisation
+        if (!this.initPromise) {
+            this.initPromise = this.init();
+        }
+        await this.initPromise;
+    }
+    async init() {
+        // Before anything reads the stored image.  A tab that loaded the database
+        // and then waited for the lock would resume with a snapshot the departing
+        // tab has since replaced — the very overwrite the lock prevents.
+        if (this.multiTab === 'exclusive') {
+            this.lock = await (0, db_lock_1.acquireDatabaseLock)(this.dbName, {
+                timeoutMs: this.lockTimeoutMs,
+            });
+        }
+        await this.engine.init();
+        await this.engine.mkdir('/data');
+        // Restore any previously persisted image into the engine's filesystem
+        // before attaching, so a reload reopens the same database.
+        await this.vfs.open(this.dbName);
+        const stored = await this.vfs.exportDatabase();
+        if (stored.byteLength > 0) {
+            await this.engine.writeFile(this.dbPath, stored);
+        }
+        this.dbHandle = (await this.engine.exists(this.dbPath))
+            ? await this.engine.attachDatabase(this.dbPath)
+            : await this.engine.createDatabase(this.dbPath);
+        this.attachLifecycleListeners();
+    }
+}
+exports.FirebirdBrowser = FirebirdBrowser;
+// ---------------------------------------------------------------------------
+// Transaction handle
+// ---------------------------------------------------------------------------
+/**
+ * A handle to an active transaction in the browser WASM engine.
+ *
+ * Statements issued here are bound to the transaction handle, so a rollback
+ * really does undo them.
+ */
+class FirebirdBrowserTransaction {
+    constructor(engine, dbHandle, txHandle) {
+        this.engine = engine;
+        this.dbHandle = dbHandle;
+        this.txHandle = txHandle;
+        this.finished = false;
+    }
+    /** Whether this transaction has already been rolled back. */
+    get isFinished() {
+        return this.finished;
+    }
+    /**
+     * Roll this transaction back and stop.
+     *
+     * The enclosing `transaction()` will not commit afterwards.  Use this to
+     * abandon a transaction deliberately, rather than throwing an error you do
+     * not mean — throwing also rolls back, but it propagates to the caller.
+     */
+    async rollback() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        await this.engine.rollback(this.txHandle);
+    }
+    assertUsable() {
+        if (this.finished) {
+            throw new Error('Transaction has already been rolled back');
+        }
+    }
+    /**
+     * Execute a DDL/DML statement inside this transaction.
+     *
+     * @returns the number of rows affected.
+     */
+    async exec(sql, params = []) {
+        this.assertUsable();
+        const affectedRows = await this.engine.execute(this.dbHandle, this.txHandle, sql, params);
+        return { affectedRows };
+    }
+    /** Execute a SELECT inside this transaction and return rows. */
+    async query(sql, params = []) {
+        this.assertUsable();
+        return this.engine.query(this.dbHandle, this.txHandle, sql, params);
+    }
+}
+exports.FirebirdBrowserTransaction = FirebirdBrowserTransaction;
+//# sourceMappingURL=firebird-browser.js.map

package/dist/browser/firebird-browser.js.map

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