firebird-wasm 0.1.0

package/dist/browser/sql-script.d.ts

@@ -0,0 +1,27 @@
+/**
+ * sql-script.ts – split a SQL script into individual statements.
+ *
+ * The engine executes one statement at a time, so running a migration means
+ * splitting it first.  Splitting on `;` alone is wrong in ways that corrupt
+ * data rather than merely failing: a semicolon inside a string literal, an
+ * identifier or a comment is not a terminator.
+ *
+ * Firebird adds `SET TERM`, which changes the terminator so that PSQL bodies —
+ * full of their own semicolons — can be written at all.  A splitter that
+ * ignores it cuts every stored procedure and trigger in half, which is most of
+ * what a real migration contains.
+ */
+/** A statement and where it started, for error messages. */
+export interface ScriptStatement {
+    sql: string;
+    /** 1-based line number of the statement's first character. */
+    line: number;
+}
+/**
+ * Split `script` into executable statements.
+ *
+ * Comments and empty statements are dropped; `SET TERM` directives are obeyed
+ * and not emitted, since they configure the splitter rather than the engine.
+ */
+export declare function splitStatements(script: string): ScriptStatement[];
+//# sourceMappingURL=sql-script.d.ts.map

package/dist/browser/sql-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-script.d.ts","sourceRoot":"","sources":["../../src/browser/sql-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AA+BD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE,CA+FjE"}

package/dist/browser/sql-script.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * sql-script.ts – split a SQL script into individual statements.
+ *
+ * The engine executes one statement at a time, so running a migration means
+ * splitting it first.  Splitting on `;` alone is wrong in ways that corrupt
+ * data rather than merely failing: a semicolon inside a string literal, an
+ * identifier or a comment is not a terminator.
+ *
+ * Firebird adds `SET TERM`, which changes the terminator so that PSQL bodies —
+ * full of their own semicolons — can be written at all.  A splitter that
+ * ignores it cuts every stored procedure and trigger in half, which is most of
+ * what a real migration contains.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitStatements = splitStatements;
+const DEFAULT_TERMINATOR = ';';
+/** Is `text` at `pos` the start of a `SET TERM <new> <old>` directive? */
+function matchSetTerm(text, pos, terminator) {
+    const match = /^set\s+term\s+(\S+)/i.exec(text.slice(pos));
+    if (!match)
+        return null;
+    let newTerminator = match[1];
+    let end = pos + match[0].length;
+    // isql accepts "SET TERM ^;" — the old terminator glued to the new one.
+    if (newTerminator.length > terminator.length && newTerminator.endsWith(terminator)) {
+        newTerminator = newTerminator.slice(0, -terminator.length);
+    }
+    else {
+        // Otherwise the directive is itself closed by the current terminator.
+        const rest = text.slice(end);
+        const closing = rest.indexOf(terminator);
+        if (closing !== -1) {
+            end += closing + terminator.length;
+        }
+    }
+    return { newTerminator, end };
+}
+/**
+ * Split `script` into executable statements.
+ *
+ * Comments and empty statements are dropped; `SET TERM` directives are obeyed
+ * and not emitted, since they configure the splitter rather than the engine.
+ */
+function splitStatements(script) {
+    const statements = [];
+    let terminator = DEFAULT_TERMINATOR;
+    let current = '';
+    let statementLine = 1;
+    let line = 1;
+    let i = 0;
+    const push = () => {
+        const sql = current.trim();
+        if (sql)
+            statements.push({ sql, line: statementLine });
+        current = '';
+    };
+    while (i < script.length) {
+        const ch = script[i];
+        const two = script.slice(i, i + 2);
+        // Line comment: to end of line, newline preserved so line numbers hold.
+        if (two === '--') {
+            const nl = script.indexOf('\n', i);
+            i = nl === -1 ? script.length : nl;
+            continue;
+        }
+        // Block comment.
+        if (two === '/*') {
+            const close = script.indexOf('*/', i + 2);
+            const end = close === -1 ? script.length : close + 2;
+            line += (script.slice(i, end).match(/\n/g) ?? []).length;
+            i = end;
+            continue;
+        }
+        // String literal or quoted identifier: copied verbatim, terminators inside
+        // are just characters.
+        if (ch === "'" || ch === '"') {
+            const quote = ch;
+            let j = i + 1;
+            current += quote;
+            while (j < script.length) {
+                if (script[j] === quote) {
+                    // A doubled quote is an escaped quote, not the end.
+                    if (script[j + 1] === quote) {
+                        current += quote + quote;
+                        j += 2;
+                        continue;
+                    }
+                    current += quote;
+                    j++;
+                    break;
+                }
+                if (script[j] === '\n')
+                    line++;
+                current += script[j];
+                j++;
+            }
+            i = j;
+            continue;
+        }
+        // SET TERM, only at the start of a statement.
+        if ((ch === 's' || ch === 'S') && current.trim() === '') {
+            const directive = matchSetTerm(script, i, terminator);
+            if (directive) {
+                line += (script.slice(i, directive.end).match(/\n/g) ?? []).length;
+                terminator = directive.newTerminator;
+                i = directive.end;
+                current = '';
+                statementLine = line;
+                continue;
+            }
+        }
+        // Statement terminator.
+        if (script.startsWith(terminator, i)) {
+            i += terminator.length;
+            push();
+            statementLine = line;
+            continue;
+        }
+        if (ch === '\n') {
+            line++;
+            if (current.trim() === '')
+                statementLine = line;
+        }
+        current += ch;
+        i++;
+    }
+    // Trailing statement without a terminator.
+    push();
+    return statements;
+}
+//# sourceMappingURL=sql-script.js.map

package/dist/browser/sql-script.js.map

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

package/dist/browser/worker-entry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * worker-entry.ts – the Worker side of the engine.
+ *
+ * Bundle this as the Worker script:
+ *
+ * ```ts
+ * // firebird-engine-worker.ts
+ * import 'firebird-wasm/browser/worker-entry';
+ * ```
+ *
+ * ```ts
+ * // application code
+ * const worker = new Worker('/firebird-engine-worker.js');
+ * const db = new FirebirdBrowser('mydb', { worker });
+ * ```
+ *
+ * The Worker owns the WASM module and therefore Emscripten's filesystem, so it
+ * serves filesystem requests too — persistence copies the database between
+ * that filesystem and IndexedDB, and only this side can read it.
+ *
+ * The page must be cross-origin isolated (COOP/COEP): Emscripten's pthreads
+ * need SharedArrayBuffer, which browsers withhold otherwise.
+ */
+import type { EngineTransport } from './engine-transport';
+import type { EngineRequest } from './worker-protocol';
+/**
+ * The part of a Worker's global scope this file uses.
+ *
+ * Declared structurally rather than using `DedicatedWorkerGlobalScope`, which
+ * lives in TypeScript's `WebWorker` lib — and that cannot be combined with
+ * `DOM` in one compilation without duplicate-declaration errors.  A library
+ * shipping both browser and worker code has to avoid the clash.
+ */
+export interface EngineWorkerScope {
+    postMessage(message: unknown, transfer?: Transferable[]): void;
+    addEventListener(type: 'message', listener: (event: MessageEvent<EngineRequest>) => void): void;
+}
+/**
+ * Wire a transport up to a Worker scope.
+ *
+ * Exported so a host application can build its own Worker entry point — for
+ * example to set `locateFile` before any message is handled.
+ */
+export declare function serveEngine(scope: EngineWorkerScope, transport: EngineTransport): void;
+//# sourceMappingURL=worker-entry.d.ts.map

package/dist/browser/worker-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-entry.d.ts","sourceRoot":"","sources":["../../src/browser/worker-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAA0B,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC/D,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,IAAI,GACrD,IAAI,CAAC;CACT;AAOD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,eAAe,GACzB,IAAI,CAiCN"}

package/dist/browser/worker-entry.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * worker-entry.ts – the Worker side of the engine.
+ *
+ * Bundle this as the Worker script:
+ *
+ * ```ts
+ * // firebird-engine-worker.ts
+ * import 'firebird-wasm/browser/worker-entry';
+ * ```
+ *
+ * ```ts
+ * // application code
+ * const worker = new Worker('/firebird-engine-worker.js');
+ * const db = new FirebirdBrowser('mydb', { worker });
+ * ```
+ *
+ * The Worker owns the WASM module and therefore Emscripten's filesystem, so it
+ * serves filesystem requests too — persistence copies the database between
+ * that filesystem and IndexedDB, and only this side can read it.
+ *
+ * The page must be cross-origin isolated (COOP/COEP): Emscripten's pthreads
+ * need SharedArrayBuffer, which browsers withhold otherwise.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveEngine = serveEngine;
+const engine_transport_1 = require("./engine-transport");
+/**
+ * Wire a transport up to a Worker scope.
+ *
+ * Exported so a host application can build its own Worker entry point — for
+ * example to set `locateFile` before any message is handled.
+ */
+function serveEngine(scope, transport) {
+    const reply = (response) => {
+        // Transfer the buffer for readFile rather than copying it: a database
+        // image is measured in megabytes and this runs on every persist.
+        const transfer = response.result instanceof Uint8Array ? [response.result.buffer] : [];
+        scope.postMessage(response, transfer);
+    };
+    scope.addEventListener('message', (event) => {
+        const { id, op, args } = event.data;
+        void (async () => {
+            try {
+                // The op names are exactly the transport's method names, so this is a
+                // direct dispatch rather than a switch that has to be kept in step.
+                const fn = transport[op];
+                if (typeof fn !== 'function') {
+                    throw new Error(`unknown engine operation: ${op}`);
+                }
+                const result = (await fn.apply(transport, args)) ?? null;
+                reply({ id, ok: true, result: result });
+            }
+            catch (err) {
+                reply({
+                    id,
+                    ok: false,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        })();
+    });
+}
+// Auto-start when loaded as a Worker script.
+if (typeof self !== 'undefined' && typeof self.postMessage === 'function') {
+    try {
+        serveEngine(self, new engine_transport_1.DirectTransport(self.FIREBIRD_WORKER_OPTIONS ?? {}));
+    }
+    catch (err) {
+        // No request to answer yet, so report the bootstrap failure out of band;
+        // WorkerTransport treats id -1 as "this worker is unusable".
+        self.postMessage({
+            id: -1,
+            ok: false,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=worker-entry.js.map

package/dist/browser/worker-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-entry.js","sourceRoot":"","sources":["../../src/browser/worker-entry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;AAiCH,kCAoCC;AAnED,yDAAqD;AAyBrD;;;;;GAKG;AACH,SAAgB,WAAW,CACzB,KAAwB,EACxB,SAA0B;IAE1B,MAAM,KAAK,GAAG,CAAC,QAAwB,EAAQ,EAAE;QAC/C,sEAAsE;QACtE,iEAAiE;QACjE,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,YAAY,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,QAA0B,CAAC,CAAC;IAC1D,CAAC,CAAC;IAEF,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAkC,EAAE,EAAE;QACvE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;QAEpC,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,sEAAsE;gBACtE,oEAAoE;gBACpE,MAAM,EAAE,GAAI,SAA8E,CAAC,EAAE,CAAC,CAAC;gBAE/F,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;oBAC7B,MAAM,IAAI,KAAK,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;gBACrD,CAAC;gBAED,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC;gBACzD,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAkC,EAAE,CAAC,CAAC;YACtE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,CAAC;oBACJ,EAAE;oBACF,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6CAA6C;AAC7C,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;IAC1E,IAAI,CAAC;QACH,WAAW,CAAC,IAAI,EAAE,IAAI,kCAAe,CAAC,IAAI,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yEAAyE;QACzE,6DAA6D;QAC7D,IAAI,CAAC,WAAW,CAAC;YACf,EAAE,EAAE,CAAC,CAAC;YACN,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/browser/worker-protocol.d.ts

@@ -0,0 +1,37 @@
+/**
+ * worker-protocol.ts – the messages exchanged with the engine Worker.
+ *
+ * Shared by both ends so the request and response shapes cannot drift apart.
+ * Every request carries an `id`; the reply quotes it, which is what lets
+ * several calls be in flight at once.
+ */
+import type { Row, QueryResult } from '../types';
+import type { EngineHandle } from './engine-transport';
+/** Operations the Worker understands.  One per EngineTransport method. */
+export type EngineOp = 'init' | 'createDatabase' | 'attachDatabase' | 'detachDatabase' | 'execute' | 'query' | 'startTransaction' | 'commit' | 'rollback' | 'mkdir' | 'exists' | 'readFile' | 'writeFile';
+/** A call from the main thread to the Worker. */
+export interface EngineRequest {
+    id: number;
+    op: EngineOp;
+    args: unknown[];
+}
+/** The Worker's reply.  Exactly one of `result` / `error` is meaningful. */
+export interface EngineResponse {
+    id: number;
+    ok: boolean;
+    /** Present when `ok`. */
+    result?: EngineHandle | number | boolean | Uint8Array | QueryResult<Row> | null;
+    /**
+     * Present when not `ok`.  A string rather than an Error because structured
+     * cloning drops the prototype and the stack is the Worker's, not the
+     * caller's — the message is the part worth keeping.
+     */
+    error?: string;
+}
+/** Sent once when the Worker's own bootstrap fails, without a request to quote. */
+export interface EngineFatal {
+    id: -1;
+    ok: false;
+    error: string;
+}
+//# sourceMappingURL=worker-protocol.d.ts.map

package/dist/browser/worker-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.d.ts","sourceRoot":"","sources":["../../src/browser/worker-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,0EAA0E;AAC1E,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,SAAS,GACT,OAAO,GACP,kBAAkB,GAClB,QAAQ,GACR,UAAU,GACV,OAAO,GACP,QAAQ,GACR,UAAU,GACV,WAAW,CAAC;AAEhB,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,yBAAyB;IACzB,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAChF;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,CAAC,CAAC,CAAC;IACP,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/browser/worker-protocol.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * worker-protocol.ts – the messages exchanged with the engine Worker.
+ *
+ * Shared by both ends so the request and response shapes cannot drift apart.
+ * Every request carries an `id`; the reply quotes it, which is what lets
+ * several calls be in flight at once.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=worker-protocol.js.map

package/dist/browser/worker-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.js","sourceRoot":"","sources":["../../src/browser/worker-protocol.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/browser/worker-transport.d.ts

@@ -0,0 +1,63 @@
+/**
+ * worker-transport.ts – reaches the engine running in a Web Worker.
+ *
+ * Browsers have to use this.  The build uses pthreads, Firebird blocks on
+ * mutexes while opening a database, and a browser main thread is not allowed
+ * to block, so calling the engine from a page deadlocks.  Inside a Worker
+ * blocking is fine.
+ *
+ * The Worker also owns Emscripten's filesystem, which is why the filesystem
+ * operations are part of the transport rather than being done by the caller.
+ */
+import type { Row, QueryResult, QueryParams } from '../types';
+import type { EngineHandle, EngineTransport } from './engine-transport';
+/** Options accepted by {@link WorkerTransport}. */
+export interface WorkerTransportOptions {
+    /**
+     * How long to wait for a single call before rejecting, in milliseconds.
+     *
+     * Creating a database is slow — the engine writes the whole system
+     * catalogue — so this is generous by default.  Without a timeout a Worker
+     * that dies mid-call would leave the caller waiting forever.
+     *
+     * @default 120000
+     */
+    timeoutMs?: number;
+}
+/**
+ * Forwards {@link EngineTransport} calls to a Worker over `postMessage`.
+ *
+ * @example
+ * ```ts
+ * const worker = new Worker('/firebird-engine-worker.js');
+ * const db = new FirebirdBrowser('mydb', { worker });
+ * ```
+ */
+export declare class WorkerTransport implements EngineTransport {
+    private readonly worker;
+    private readonly timeoutMs;
+    private readonly pending;
+    private nextId;
+    private failure;
+    constructor(worker: Worker, options?: WorkerTransportOptions);
+    private readonly onMessage;
+    private readonly onError;
+    /** Reject everything outstanding and refuse further calls. */
+    private fail;
+    private call;
+    init(): Promise<void>;
+    createDatabase(path: string): Promise<EngineHandle>;
+    attachDatabase(path: string): Promise<EngineHandle>;
+    detachDatabase(dbHandle: EngineHandle): Promise<void>;
+    execute(dbHandle: EngineHandle, txHandle: EngineHandle, sql: string, params?: QueryParams): Promise<number>;
+    query<T extends Row = Row>(dbHandle: EngineHandle, txHandle: EngineHandle, sql: string, params?: QueryParams): Promise<QueryResult<T>>;
+    startTransaction(dbHandle: EngineHandle): Promise<EngineHandle>;
+    commit(txHandle: EngineHandle): Promise<void>;
+    rollback(txHandle: EngineHandle): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    readFile(path: string): Promise<Uint8Array>;
+    writeFile(path: string, data: Uint8Array): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=worker-transport.d.ts.map

package/dist/browser/worker-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-transport.d.ts","sourceRoot":"","sources":["../../src/browser/worker-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxE,mDAAmD;AACnD,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAsB;gBAEzB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;IAQhE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAqBxB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IAEF,8DAA8D;IAC9D,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,IAAI;IAwBZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAInD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAInD,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,OAAO,CACL,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,MAAM,CAAC;IAIlB,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EACvB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,YAAY,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAI1B,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAI/D,MAAM,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}

package/dist/browser/worker-transport.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * worker-transport.ts – reaches the engine running in a Web Worker.
+ *
+ * Browsers have to use this.  The build uses pthreads, Firebird blocks on
+ * mutexes while opening a database, and a browser main thread is not allowed
+ * to block, so calling the engine from a page deadlocks.  Inside a Worker
+ * blocking is fine.
+ *
+ * The Worker also owns Emscripten's filesystem, which is why the filesystem
+ * operations are part of the transport rather than being done by the caller.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerTransport = void 0;
+const DEFAULT_TIMEOUT_MS = 120000;
+/**
+ * Forwards {@link EngineTransport} calls to a Worker over `postMessage`.
+ *
+ * @example
+ * ```ts
+ * const worker = new Worker('/firebird-engine-worker.js');
+ * const db = new FirebirdBrowser('mydb', { worker });
+ * ```
+ */
+class WorkerTransport {
+    constructor(worker, options = {}) {
+        this.pending = new Map();
+        this.nextId = 1;
+        this.failure = null;
+        this.onMessage = (event) => {
+            const data = event.data;
+            // id -1 is the Worker reporting that its own bootstrap failed; there is no
+            // request to answer, so fail everything outstanding and everything later.
+            if (data.id === -1) {
+                this.fail(new Error(data.error ?? 'engine worker failed to start'));
+                return;
+            }
+            const entry = this.pending.get(data.id);
+            if (!entry)
+                return; // already timed out, or a stray reply
+            this.pending.delete(data.id);
+            clearTimeout(entry.timer);
+            if (data.ok) {
+                entry.resolve(data.result);
+            }
+            else {
+                entry.reject(new Error(data.error ?? 'engine worker returned an error'));
+            }
+        };
+        this.onError = (event) => {
+            this.fail(new Error(`engine worker error: ${event.message}`));
+        };
+        this.worker = worker;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.worker.addEventListener('message', this.onMessage);
+        this.worker.addEventListener('error', this.onError);
+    }
+    /** Reject everything outstanding and refuse further calls. */
+    fail(error) {
+        this.failure = error;
+        for (const [, entry] of this.pending) {
+            clearTimeout(entry.timer);
+            entry.reject(error);
+        }
+        this.pending.clear();
+    }
+    call(op, ...args) {
+        if (this.failure) {
+            return Promise.reject(this.failure);
+        }
+        const id = this.nextId++;
+        const request = { id, op, args };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`engine worker timed out after ${this.timeoutMs}ms: ${op}`));
+            }, this.timeoutMs);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            this.worker.postMessage(request);
+        });
+    }
+    init() {
+        return this.call('init');
+    }
+    createDatabase(path) {
+        return this.call('createDatabase', path);
+    }
+    attachDatabase(path) {
+        return this.call('attachDatabase', path);
+    }
+    detachDatabase(dbHandle) {
+        return this.call('detachDatabase', dbHandle);
+    }
+    execute(dbHandle, txHandle, sql, params = []) {
+        return this.call('execute', dbHandle, txHandle, sql, params);
+    }
+    query(dbHandle, txHandle, sql, params = []) {
+        return this.call('query', dbHandle, txHandle, sql, params);
+    }
+    startTransaction(dbHandle) {
+        return this.call('startTransaction', dbHandle);
+    }
+    commit(txHandle) {
+        return this.call('commit', txHandle);
+    }
+    rollback(txHandle) {
+        return this.call('rollback', txHandle);
+    }
+    mkdir(path) {
+        return this.call('mkdir', path);
+    }
+    exists(path) {
+        return this.call('exists', path);
+    }
+    readFile(path) {
+        return this.call('readFile', path);
+    }
+    writeFile(path, data) {
+        return this.call('writeFile', path, data);
+    }
+    async dispose() {
+        this.worker.removeEventListener('message', this.onMessage);
+        this.worker.removeEventListener('error', this.onError);
+        this.fail(new Error('engine worker disposed'));
+        this.worker.terminate();
+    }
+}
+exports.WorkerTransport = WorkerTransport;
+//# sourceMappingURL=worker-transport.js.map

package/dist/browser/worker-transport.js.map

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

package/dist/firebird.d.ts

@@ -0,0 +1,73 @@
+import type { Attachment, Transaction } from 'node-firebird-driver';
+import type { FirebirdLiteOptions, QueryResult, Row, QueryParams, TransactionOptions } from './types';
+/**
+ * FirebirdLite – a PGlite-style wrapper around Firebird Embedded.
+ *
+ * Provides a simple async API for running SQL against a Firebird database
+ * using the Firebird embedded engine (single-process mode).
+ *
+ * @example
+ * ```ts
+ * const db = new FirebirdLite('/tmp/my-database.fdb');
+ * await db.exec('CREATE TABLE t (id INTEGER, name VARCHAR(100))');
+ * await db.query('INSERT INTO t VALUES (?, ?)', [1, 'hello']);
+ * const result = await db.query('SELECT * FROM t');
+ * // { rows: [ { ID: 1, NAME: 'hello' } ], fields: [...] }
+ * await db.close();
+ * ```
+ */
+export declare class FirebirdLite {
+    private readonly dbPath;
+    private readonly libraryPath;
+    private readonly connectOptions;
+    private client;
+    private attachment;
+    private closed;
+    constructor(dbPath: string, options?: FirebirdLiteOptions);
+    /**
+     * Lazily initialize the native client and open (or create) the database.
+     */
+    private ensureReady;
+    /**
+     * Execute a DDL or DML statement that does not return rows.
+     *
+     * The statement is executed in its own auto-committed transaction.
+     */
+    exec(sql: string): Promise<void>;
+    /**
+     * Execute a (parameterised) SQL statement and return the result rows.
+     *
+     * For SELECT queries the rows are returned as plain objects keyed by the
+     * (upper-cased) column name, mirroring the PGlite convention.
+     */
+    query<T extends Row = Row>(sql: string, params?: QueryParams, options?: TransactionOptions): Promise<QueryResult<T>>;
+    /**
+     * Run a function inside an explicit transaction.
+     *
+     * The transaction is automatically committed on success or rolled back on
+     * error.
+     */
+    transaction<T>(fn: (tx: FirebirdTransaction) => Promise<T>, options?: TransactionOptions): Promise<T>;
+    /**
+     * Close the database connection and release all resources.
+     */
+    close(): Promise<void>;
+}
+/**
+ * A handle to an active Firebird transaction, exposed to callers of
+ * `FirebirdLite.transaction()`.
+ */
+export declare class FirebirdTransaction {
+    private readonly attachment;
+    private readonly transaction;
+    constructor(attachment: Attachment, transaction: Transaction);
+    /**
+     * Execute a DDL or DML statement inside this transaction.
+     */
+    exec(sql: string, params?: QueryParams): Promise<void>;
+    /**
+     * Execute a SELECT statement inside this transaction and return rows.
+     */
+    query<T extends Row = Row>(sql: string, params?: QueryParams): Promise<QueryResult<T>>;
+}
+//# sourceMappingURL=firebird.d.ts.map

package/dist/firebird.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebird.d.ts","sourceRoot":"","sources":["../src/firebird.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,UAAU,EACV,WAAW,EAEZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,GAAG,EACH,WAAW,EACX,kBAAkB,EAEnB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoE;IACnG,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;IAU7D;;OAEG;YACW,WAAW;IAgBzB;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAatC;;;;;OAKG;IACG,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAC7B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,WAAgB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAqC1B;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EACjB,EAAE,EAAE,CAAC,EAAE,EAAE,mBAAmB,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3C,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW;IAG3C;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE;;OAEG;IACG,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAC7B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAkB3B"}