firebird-wasm 0.1.1 → 0.3.0

package/dist/browser/opfs-fs.js.map

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

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

@@ -0,0 +1,134 @@
+/**
+ * shared-transport.ts – one engine, many tabs.
+ *
+ * `multiTab: 'exclusive'` keeps a second tab safe by refusing it. This serves
+ * it instead: one tab wins the election, runs the engine, and answers for
+ * everyone else over a `BroadcastChannel`.
+ *
+ * ## Why only one tab may run the engine
+ *
+ * Not because concurrent access needs coordinating — because each tab holds
+ * its own complete copy of the database in memory and persists the whole
+ * image. Two engines on one database is not a race to be locked around; the
+ * later persist discards the other's work entirely. So the engine is
+ * singular by construction, and the other tabs are clients of it.
+ *
+ * ## What happens when the leader disappears
+ *
+ * The lock releases, a follower is promoted, and it starts its own engine from
+ * the last persisted image. Writes made in the departed leader's final
+ * debounce window are lost — the same exposure a single tab has always had,
+ * and no worse.
+ *
+ * In-flight calls at that moment are handled by what they are, not uniformly:
+ * a read is re-issued to the new leader, because running a query twice is
+ * indistinguishable from running it once; a write is **rejected**. The old
+ * leader may have committed it and died before the reply, so re-issuing could
+ * apply it twice. An error a caller can see beats a duplicate row it cannot.
+ */
+import type { Row, QueryResult, QueryDescription, QueryParams, RowMode, TransactionOptions } from '../types';
+import type { EngineHandle, EngineTransport } from './engine-transport';
+/** Options for {@link SharedEngineTransport}. */
+export interface SharedEngineTransportOptions {
+    /** Logical database name; scopes both the lock and the channel. */
+    dbName: string;
+    /**
+     * Builds the engine.  Called **only** if this tab becomes leader, so a
+     * follower never loads the 9 MB artifact it would not use.
+     */
+    createEngine: () => EngineTransport;
+    /**
+     * How long a follower waits for the leader to answer, in milliseconds.
+     *
+     * Generous by default because creating a database is slow and the follower
+     * cannot tell a slow leader from a dead one.
+     *
+     * @default 120000
+     */
+    timeoutMs?: number;
+    /**
+     * Called on the leader when it serves an operation that changed data.
+     *
+     * Persistence lives with whoever owns the engine, and a follower's writes
+     * are executed by the leader — so without this the leader would never learn
+     * that anything needs saving.
+     */
+    onServedMutation?: () => void;
+    /**
+     * Called when the engine behind this transport has been replaced.
+     *
+     * Handles are issued by whichever engine is running, so a leadership change
+     * voids every one of them — in every tab, not just the promoted one. The
+     * owner must re-open the database before using it again, and it must happen
+     * on the leader before any follower is told there is a leader to talk to.
+     */
+    onEngineReplaced?: () => Promise<void>;
+}
+/**
+ * An {@link EngineTransport} backed by whichever tab currently owns the engine.
+ *
+ * @example
+ * ```ts
+ * const db = new FirebirdBrowser('mydb', {
+ *   multiTab: 'shared',
+ *   worker: () => new Worker('/firebird-engine-worker.js'),
+ * });
+ * ```
+ */
+export declare class SharedEngineTransport implements EngineTransport {
+    private readonly dbName;
+    private readonly createEngine;
+    private readonly timeoutMs;
+    private readonly onServedMutation?;
+    private readonly onEngineReplaced?;
+    private readonly channel;
+    private readonly clientId;
+    private readonly election;
+    /** The real engine.  Non-null exactly when this tab is the leader. */
+    private engine;
+    private readonly pending;
+    private nextCallId;
+    private disposed;
+    /** Highest leadership generation seen; guards against stale announcements. */
+    private epoch;
+    /** True while this tab is standing its engine up, so calls stay local. */
+    private promoting;
+    /** Resolves once a leader is known to exist, so calls do not go nowhere. */
+    private leaderKnown;
+    private announceLeaderKnown;
+    constructor(options: SharedEngineTransportOptions);
+    /** Whether this tab currently runs the engine. */
+    get isLeader(): boolean;
+    private assumeLeadership;
+    private recoverPending;
+    /** Follower side: the leader changed, so re-open against the new one. */
+    private reopenAfterLeaderChange;
+    private readonly onMessage;
+    /** Leader side: run the operation and reply to the caller. */
+    private serve;
+    private settle;
+    private runLocally;
+    /** Run `op` here if this tab leads, otherwise ask whoever does. */
+    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 = Row>(dbHandle: EngineHandle, txHandle: EngineHandle, sql: string, params?: QueryParams, rowMode?: RowMode, binaryBlobs?: boolean): Promise<QueryResult<T>>;
+    describe(dbHandle: EngineHandle, txHandle: EngineHandle, sql: string): Promise<QueryDescription>;
+    startTransaction(dbHandle: EngineHandle, options?: TransactionOptions): 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>;
+    unlink(path: string): Promise<void>;
+    eventsSubscribe(dbHandle: EngineHandle, names: string[]): Promise<number>;
+    eventsPoll(subscription: number): Promise<Record<string, number>>;
+    eventsCancel(subscription: number): Promise<void>;
+    mountOpfs(dbName: string): Promise<string>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=shared-transport.d.ts.map

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

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

package/dist/browser/shared-transport.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * shared-transport.ts – one engine, many tabs.
+ *
+ * `multiTab: 'exclusive'` keeps a second tab safe by refusing it. This serves
+ * it instead: one tab wins the election, runs the engine, and answers for
+ * everyone else over a `BroadcastChannel`.
+ *
+ * ## Why only one tab may run the engine
+ *
+ * Not because concurrent access needs coordinating — because each tab holds
+ * its own complete copy of the database in memory and persists the whole
+ * image. Two engines on one database is not a race to be locked around; the
+ * later persist discards the other's work entirely. So the engine is
+ * singular by construction, and the other tabs are clients of it.
+ *
+ * ## What happens when the leader disappears
+ *
+ * The lock releases, a follower is promoted, and it starts its own engine from
+ * the last persisted image. Writes made in the departed leader's final
+ * debounce window are lost — the same exposure a single tab has always had,
+ * and no worse.
+ *
+ * In-flight calls at that moment are handled by what they are, not uniformly:
+ * a read is re-issued to the new leader, because running a query twice is
+ * indistinguishable from running it once; a write is **rejected**. The old
+ * leader may have committed it and died before the reply, so re-issuing could
+ * apply it twice. An error a caller can see beats a duplicate row it cannot.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedEngineTransport = void 0;
+const leader_election_1 = require("./leader-election");
+/**
+ * Operations safe to re-issue to a new leader after the old one vanished.
+ *
+ * Reads and existence checks only. Every mutation is absent deliberately: its
+ * outcome is unknown once the leader dies mid-call, and "unknown" must not be
+ * quietly resolved as "did not happen".
+ */
+const REPLAYABLE = new Set([
+    'init',
+    'query',
+    // Prepares a statement and drops it, executing nothing, so re-issuing it is
+    // indistinguishable from issuing it once.
+    'describe',
+    'exists',
+    'readFile',
+]);
+/** Ops that change the database, and so make the leader's image dirty. */
+const MUTATING = new Set([
+    'execute',
+    'commit',
+    'createDatabase',
+    'writeFile',
+]);
+const DEFAULT_TIMEOUT_MS = 120000;
+/**
+ * An {@link EngineTransport} backed by whichever tab currently owns the engine.
+ *
+ * @example
+ * ```ts
+ * const db = new FirebirdBrowser('mydb', {
+ *   multiTab: 'shared',
+ *   worker: () => new Worker('/firebird-engine-worker.js'),
+ * });
+ * ```
+ */
+class SharedEngineTransport {
+    constructor(options) {
+        /** The real engine.  Non-null exactly when this tab is the leader. */
+        this.engine = null;
+        this.pending = new Map();
+        this.nextCallId = 1;
+        this.disposed = false;
+        /** Highest leadership generation seen; guards against stale announcements. */
+        this.epoch = 0;
+        /** True while this tab is standing its engine up, so calls stay local. */
+        this.promoting = false;
+        // ── Channel ────────────────────────────────────────────────────────────
+        this.onMessage = (event) => {
+            const message = event.data;
+            switch (message.kind) {
+                case 'who-leads':
+                    // Only a leader answers, and only if it has an engine standing.
+                    if (this.engine) {
+                        this.channel.postMessage({
+                            kind: 'leader',
+                            epoch: this.epoch,
+                        });
+                    }
+                    return;
+                case 'leader':
+                    this.announceLeaderKnown();
+                    // A *new* leader, not the one this tab already knew about: its engine
+                    // is a different engine, so this tab's handles mean nothing to it.
+                    if (message.epoch > this.epoch) {
+                        this.epoch = message.epoch;
+                        if (!this.engine)
+                            void this.reopenAfterLeaderChange();
+                    }
+                    return;
+                case 'call':
+                    if (this.engine)
+                        void this.serve(message);
+                    return;
+                case 'reply':
+                    if (message.to === this.clientId)
+                        this.settle(message);
+                    return;
+            }
+        };
+        this.dbName = options.dbName;
+        this.createEngine = options.createEngine;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.onServedMutation = options.onServedMutation;
+        this.onEngineReplaced = options.onEngineReplaced;
+        this.clientId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+        this.channel = new BroadcastChannel(`firebird-wasm:shared:${this.dbName}`);
+        this.channel.addEventListener('message', this.onMessage);
+        this.leaderKnown = new Promise((resolve) => {
+            this.announceLeaderKnown = resolve;
+        });
+        this.election = (0, leader_election_1.electLeader)(this.dbName, {
+            onPromoted: () => this.assumeLeadership(),
+        });
+        // A follower that starts while a leader already exists hears nothing until
+        // it asks; the leader's announcement happened before this tab existed.
+        this.channel.postMessage({ kind: 'who-leads' });
+    }
+    /** Whether this tab currently runs the engine. */
+    get isLeader() {
+        return this.election.isLeader;
+    }
+    // ── Leadership ─────────────────────────────────────────────────────────
+    async assumeLeadership() {
+        if (this.disposed)
+            return;
+        this.engine = this.createEngine();
+        await this.engine.init();
+        // Re-open before announcing.  A follower that heard "leader" and attached
+        // straight away would be attaching to an engine with no database in it.
+        this.promoting = true;
+        try {
+            await this.onEngineReplaced?.();
+        }
+        finally {
+            this.promoting = false;
+        }
+        this.announceLeaderKnown();
+        this.channel.postMessage({ kind: 'leader', epoch: ++this.epoch });
+        // Anything still outstanding was addressed to a leader that no longer
+        // exists.  Replay what is safe to replay; fail the rest loudly.
+        this.recoverPending();
+    }
+    recoverPending() {
+        const outstanding = [...this.pending.entries()];
+        this.pending.clear();
+        for (const [, call] of outstanding) {
+            clearTimeout(call.timer);
+            if (REPLAYABLE.has(call.op)) {
+                this.runLocally(call.op, call.args).then((value) => call.resolve(value), (err) => call.reject(err instanceof Error ? err : new Error(String(err))));
+                continue;
+            }
+            call.reject(new Error(`The tab running the database closed while "${call.op}" was in ` +
+                `flight, and this tab has taken over. The operation may or may ` +
+                `not have been applied, so it was not retried — re-check the ` +
+                `data before repeating it.`));
+        }
+    }
+    /** Follower side: the leader changed, so re-open against the new one. */
+    async reopenAfterLeaderChange() {
+        if (this.disposed || this.engine)
+            return;
+        try {
+            await this.onEngineReplaced?.();
+        }
+        catch {
+            // Reported through the owner's own error handling; a throw here would
+            // become an unhandled rejection in a channel event listener.
+        }
+    }
+    /** Leader side: run the operation and reply to the caller. */
+    async serve(message) {
+        let reply;
+        try {
+            const result = await this.runLocally(message.op, message.args);
+            reply = {
+                kind: 'reply',
+                to: message.from,
+                id: message.id,
+                ok: true,
+                result: result ?? null,
+            };
+            if (MUTATING.has(message.op)) {
+                // The write happened here, but the caller that wanted it is in
+                // another tab and will never mark this engine dirty.
+                this.onServedMutation?.();
+            }
+        }
+        catch (err) {
+            reply = {
+                kind: 'reply',
+                to: message.from,
+                id: message.id,
+                ok: false,
+                // A string, not an Error: structured cloning drops the prototype and
+                // the stack belongs to a tab the caller cannot see anyway.
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+        this.channel.postMessage(reply);
+    }
+    settle(message) {
+        const call = this.pending.get(message.id);
+        if (!call)
+            return; // already timed out, or replayed after a promotion
+        this.pending.delete(message.id);
+        clearTimeout(call.timer);
+        if (message.ok) {
+            call.resolve(message.result);
+        }
+        else {
+            call.reject(new Error(message.error ?? 'the database tab reported an error'));
+        }
+    }
+    runLocally(op, args) {
+        const engine = this.engine;
+        if (!engine) {
+            return Promise.reject(new Error('not the leader'));
+        }
+        const fn = engine[op];
+        if (typeof fn !== 'function') {
+            return Promise.reject(new Error(`unknown engine operation: ${op}`));
+        }
+        return fn.apply(engine, args);
+    }
+    // ── Dispatch ───────────────────────────────────────────────────────────
+    /** Run `op` here if this tab leads, otherwise ask whoever does. */
+    async call(op, ...args) {
+        if (this.disposed) {
+            throw new Error('SharedEngineTransport has been disposed');
+        }
+        if (this.engine) {
+            return (await this.runLocally(op, args));
+        }
+        // Do not shout into an empty channel: on a cold start every tab is a
+        // follower for the moment it takes the winner to stand its engine up.
+        await this.leaderKnown;
+        // Promotion can happen while waiting, in which case this is now local.
+        if (this.engine) {
+            return (await this.runLocally(op, args));
+        }
+        const id = this.nextCallId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`the tab running database "${this.dbName}" did not answer ` +
+                    `"${op}" within ${this.timeoutMs}ms`));
+            }, this.timeoutMs);
+            this.pending.set(id, {
+                op,
+                args,
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            this.channel.postMessage({
+                kind: 'call',
+                from: this.clientId,
+                id,
+                op,
+                args,
+            });
+        });
+    }
+    // ── EngineTransport ────────────────────────────────────────────────────
+    async init() {
+        // Whoever wins the election calls the engine's own init(); a follower has
+        // nothing to initialise and must not wait for an engine it will not build.
+        await Promise.race([this.election.promoted, this.leaderKnown]);
+    }
+    createDatabase(path) {
+        return this.call('createDatabase', path);
+    }
+    attachDatabase(path) {
+        return this.call('attachDatabase', path);
+    }
+    detachDatabase(dbHandle) {
+        // Followers share the leader's attachment; detaching it because one tab
+        // closed would pull the database out from under every other tab.
+        if (!this.engine)
+            return Promise.resolve();
+        return this.call('detachDatabase', dbHandle);
+    }
+    execute(dbHandle, txHandle, sql, params = []) {
+        return this.call('execute', dbHandle, txHandle, sql, params);
+    }
+    query(dbHandle, txHandle, sql, params = [], rowMode = 'object', binaryBlobs = false) {
+        // Decoding happens on the far side, so both of these have to travel with
+        // the call rather than being applied to what comes back. They are a string
+        // and a boolean, so they survive structured cloning like the rest of the
+        // arguments — and the Uint8Arrays that come back from a side-channelled
+        // BLOB survive it too, which is what made this placement possible.
+        return this.call('query', dbHandle, txHandle, sql, params, rowMode, binaryBlobs);
+    }
+    describe(dbHandle, txHandle, sql) {
+        return this.call('describe', dbHandle, txHandle, sql);
+    }
+    startTransaction(dbHandle, options = {}) {
+        return this.call('startTransaction', dbHandle, options);
+    }
+    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);
+    }
+    unlink(path) {
+        return this.call('unlink', path);
+    }
+    eventsSubscribe(dbHandle, names) {
+        return this.call('eventsSubscribe', dbHandle, names);
+    }
+    eventsPoll(subscription) {
+        return this.call('eventsPoll', subscription);
+    }
+    eventsCancel(subscription) {
+        return this.call('eventsCancel', subscription);
+    }
+    mountOpfs(dbName) {
+        // The mount happens on the far side; only the resulting path comes back.
+        return this.call('mountOpfs', dbName);
+    }
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const [, call] of this.pending) {
+            clearTimeout(call.timer);
+            call.reject(new Error('SharedEngineTransport has been disposed'));
+        }
+        this.pending.clear();
+        this.channel.removeEventListener('message', this.onMessage);
+        this.channel.close();
+        const engine = this.engine;
+        this.engine = null;
+        // Resign last: releasing the lock promotes another tab, which will build
+        // its own engine, and this one should be gone before that happens.
+        await engine?.dispose();
+        await this.election.resign();
+    }
+}
+exports.SharedEngineTransport = SharedEngineTransport;
+//# sourceMappingURL=shared-transport.js.map

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

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

package/dist/browser/statement-types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * statement-types.ts – names for Firebird's statement-type codes.
+ *
+ * The engine reports what a statement *is* as one of the `isc_info_sql_stmt_*`
+ * constants. A caller asking `describeQuery()` what they have wants the name,
+ * not the number — the number is only meaningful next to a copy of
+ * `iberror.h`.
+ */
+import type { StatementKind } from '../types';
+/**
+ * Name a statement-type code.
+ *
+ * An unrecognised code is `'UNKNOWN'` rather than an error: a Firebird release
+ * may add one, and a name this library has not learned yet is no reason to
+ * fail a description that is otherwise complete.
+ */
+export declare function statementKind(code: number): StatementKind;
+//# sourceMappingURL=statement-types.d.ts.map

package/dist/browser/statement-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement-types.d.ts","sourceRoot":"","sources":["../../src/browser/statement-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAoB9C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAEzD"}

package/dist/browser/statement-types.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * statement-types.ts – names for Firebird's statement-type codes.
+ *
+ * The engine reports what a statement *is* as one of the `isc_info_sql_stmt_*`
+ * constants. A caller asking `describeQuery()` what they have wants the name,
+ * not the number — the number is only meaningful next to a copy of
+ * `iberror.h`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statementKind = statementKind;
+// From firebird/impl/consts_pub.h (isc_info_sql_stmt_*).
+const NAMES = {
+    1: 'SELECT',
+    2: 'INSERT',
+    3: 'UPDATE',
+    4: 'DELETE',
+    5: 'DDL',
+    6: 'GET_SEGMENT',
+    7: 'PUT_SEGMENT',
+    8: 'EXEC_PROCEDURE',
+    9: 'START_TRANS',
+    10: 'COMMIT',
+    11: 'ROLLBACK',
+    12: 'SELECT_FOR_UPD',
+    13: 'SET_GENERATOR',
+    14: 'SAVEPOINT',
+};
+/**
+ * Name a statement-type code.
+ *
+ * An unrecognised code is `'UNKNOWN'` rather than an error: a Firebird release
+ * may add one, and a name this library has not learned yet is no reason to
+ * fail a description that is otherwise complete.
+ */
+function statementKind(code) {
+    return NAMES[code] ?? 'UNKNOWN';
+}
+//# sourceMappingURL=statement-types.js.map

package/dist/browser/statement-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement-types.js","sourceRoot":"","sources":["../../src/browser/statement-types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA6BH,sCAEC;AA3BD,yDAAyD;AACzD,MAAM,KAAK,GAAkC;IAC3C,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,aAAa;IAChB,CAAC,EAAE,aAAa;IAChB,CAAC,EAAE,gBAAgB;IACnB,CAAC,EAAE,aAAa;IAChB,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,gBAAgB;IACpB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,WAAW;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AAClC,CAAC"}