firebird-wasm 0.1.0

package/dist/browser/db-lock.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * db-lock.ts – cross-tab exclusion for a single logical database.
+ *
+ * ## The hazard
+ *
+ * Every tab runs its own engine with its own complete copy of the database in
+ * Emscripten's in-memory filesystem, and `persist()` writes that **whole
+ * image** to IndexedDB.  So two tabs on one database is not a
+ * write-interleaving problem that finer-grained locking would fix — it is
+ * last-writer-wins over the entire file:
+ *
+ *   tab A: open (image v1) ─── write x ─────────────── persist (v1+x)
+ *   tab B: open (image v1) ─── write y ─── persist (v1+y)
+ *
+ * B's `y` is gone.  Not corrupted, not conflicted — silently absent, with both
+ * tabs showing a successful commit.  `importDatabase()` being atomic does not
+ * help: each write is individually perfect and still wrong.
+ *
+ * ## Why the Web Locks API
+ *
+ * The property that matters is release-on-death.  A lock built out of a flag
+ * in IndexedDB has to answer "the holder set this 40 seconds ago and stopped —
+ * crashed, or just busy?", and every answer is either a deadlock or a
+ * corruption window.  Web Locks are held by the *agent*, so a closed tab, a
+ * crashed renderer or a killed background process releases immediately and
+ * exactly.  There is no stale state to recover and no heartbeat to tune.
+ *
+ * Queueing is also free: a second tab waits for the first rather than
+ * spinning, and is granted the moment the first closes.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseLockedError = void 0;
+exports.databaseLockName = databaseLockName;
+exports.acquireDatabaseLock = acquireDatabaseLock;
+/** Thrown when another tab holds the database and did not release in time. */
+class DatabaseLockedError extends Error {
+    constructor(
+    /** The logical database name that is held elsewhere. */
+    dbName, 
+    /** How long we waited, in milliseconds. */
+    waitedMs) {
+        super(`Database "${dbName}" is already open in another tab or worker ` +
+            `(waited ${waitedMs}ms).  Each tab keeps its own full copy of the ` +
+            `database, so allowing both would silently discard one tab's writes.  ` +
+            `Close the other tab, or pass multiTab: 'allow-unsafe' if you are ` +
+            `certain only one of them writes.`);
+        this.dbName = dbName;
+        this.waitedMs = waitedMs;
+        this.name = 'DatabaseLockedError';
+    }
+}
+exports.DatabaseLockedError = DatabaseLockedError;
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+const DEFAULT_TIMEOUT_MS = 5000;
+/** Lock names are namespaced so they cannot collide with an app's own locks. */
+function databaseLockName(dbName) {
+    return `firebird-wasm:db:${dbName}`;
+}
+/** Whether this environment can enforce cross-tab exclusion at all. */
+function locksAvailable() {
+    return (typeof navigator !== 'undefined' &&
+        typeof navigator.locks?.request === 'function');
+}
+/**
+ * Take the exclusive lock for `dbName`, waiting up to `timeoutMs`.
+ *
+ * Call this *before* reading the stored image.  A tab that loads the database
+ * and then waits for the lock resumes with a snapshot that the departing tab
+ * has since replaced, which is the very overwrite the lock exists to prevent.
+ *
+ * Where the Web Locks API is missing — Node, jsdom, a non-secure context —
+ * there is nothing to enforce exclusion with.  Rather than refuse to run, this
+ * warns and returns a lock with `enforced: false`: the single-tab case that
+ * covers Node and tests is safe on its own, and failing there would break
+ * environments that never had the hazard.
+ *
+ * @throws {DatabaseLockedError} if another tab holds it past the timeout.
+ */
+async function acquireDatabaseLock(dbName, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    if (!locksAvailable()) {
+        const warn = options.onUnavailable ?? ((m) => console.warn(m));
+        warn('[firebird-wasm] the Web Locks API is unavailable, so concurrent tabs ' +
+            'cannot be detected.  Opening the same database in two places will ' +
+            'silently lose writes.');
+        return { enforced: false, release: async () => { } };
+    }
+    const name = databaseLockName(dbName);
+    const startedAt = nowMs();
+    // Two promises, because "granted" and "released" are different moments and
+    // the caller needs both.  The lock is held for exactly as long as the
+    // callback's returned promise is pending, so `release` is what settles it.
+    let release;
+    const held = new Promise((resolve) => {
+        release = resolve;
+    });
+    let onGranted;
+    let onFailed;
+    const granted = new Promise((resolve, reject) => {
+        onGranted = resolve;
+        onFailed = reject;
+    });
+    // Aborting the signal cancels a *pending* request.  Once granted it has no
+    // further effect, which is what makes it usable as an acquisition timeout.
+    const controller = new AbortController();
+    const timer = timeoutMs === Infinity
+        ? null
+        : setTimeout(() => controller.abort(), timeoutMs);
+    const done = navigator.locks.request(name, { mode: 'exclusive', signal: controller.signal }, () => {
+        onGranted();
+        return held;
+    });
+    // Rejects only if the request was abandoned before the callback ran; after a
+    // grant `granted` has already settled and this is a no-op.
+    done.catch(onFailed);
+    try {
+        await granted;
+    }
+    catch (err) {
+        if (timer !== null)
+            clearTimeout(timer);
+        // AbortError is our own timeout firing; anything else is a real fault and
+        // should not be dressed up as contention.
+        if (isAbortError(err)) {
+            throw new DatabaseLockedError(dbName, Math.round(nowMs() - startedAt));
+        }
+        throw err;
+    }
+    if (timer !== null)
+        clearTimeout(timer);
+    let released = false;
+    return {
+        enforced: true,
+        release: async () => {
+            if (released)
+                return;
+            released = true;
+            release();
+            // Await the request promise, so the lock is provably gone once this
+            // resolves: a caller that reopens immediately must not race itself.
+            await done.catch(() => { });
+        },
+    };
+}
+/**
+ * Checked by `name`, not `instanceof`.  The abort arrives as a `DOMException`,
+ * which inherits from `Error` in a browser but not in Node, and not across
+ * realms even in a browser — a Worker's exception reaching the main thread
+ * fails an `instanceof Error` test that has nothing wrong with it.
+ */
+function isAbortError(err) {
+    return (typeof err === 'object' &&
+        err !== null &&
+        err.name === 'AbortError');
+}
+/** Monotonic where available; only ever used for a human-facing duration. */
+function nowMs() {
+    return typeof performance !== 'undefined' ? performance.now() : Date.now();
+}
+//# sourceMappingURL=db-lock.js.map

package/dist/browser/db-lock.js.map

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

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

@@ -0,0 +1,94 @@
+/**
+ * engine-transport.ts – the boundary between `FirebirdBrowser` and the engine.
+ *
+ * There are two ways to reach the compiled engine, and they differ enough to
+ * be worth naming:
+ *
+ *   • {@link DirectTransport} calls the WASM exports in this thread.  Simple,
+ *     and what Node uses.
+ *   • {@link WorkerTransport} (see `worker-transport.ts`) forwards to a Web
+ *     Worker.  Browsers *must* use it: the build uses pthreads, Firebird
+ *     blocks on mutexes while opening a database, and a browser main thread is
+ *     not allowed to block — calling the engine directly from a page deadlocks.
+ *
+ * Both sides of that split need the same operations, including filesystem
+ * access: persistence copies the database between Emscripten's in-memory FS
+ * and IndexedDB, and in the Worker case that filesystem lives in the Worker.
+ *
+ * Every method is async so the two are interchangeable, even though the direct
+ * one never actually suspends.
+ */
+import type { Row, QueryResult, QueryParams } from '../types';
+/** Opaque engine handle (database or transaction). 0 means "none". */
+export type EngineHandle = number;
+/**
+ * The operations `FirebirdBrowser` needs from the engine, wherever it runs.
+ *
+ * `txHandle` of 0 means "run this statement in its own transaction", matching
+ * the C API.
+ */
+export interface EngineTransport {
+    /** Initialise the engine.  Safe to call more than once. */
+    init(): Promise<void>;
+    createDatabase(path: string): Promise<EngineHandle>;
+    attachDatabase(path: string): Promise<EngineHandle>;
+    detachDatabase(dbHandle: EngineHandle): Promise<void>;
+    /** Returns the number of rows the statement affected. */
+    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>;
+    /** Release anything the transport owns.  Does not detach databases. */
+    dispose(): Promise<void>;
+}
+/** Options accepted by {@link DirectTransport}. */
+export interface DirectTransportOptions {
+    wasmBinary?: ArrayBuffer | string;
+    locateFile?: (filename: string) => string;
+}
+/** Decode the engine's JSON result set into rows keyed by column name. */
+export declare function decodeResultSet<T extends Row>(json: string): QueryResult<T>;
+/**
+ * Calls the engine in the current thread.
+ *
+ * Used by Node, by the Worker (which is where a browser's engine actually
+ * runs), and by tests that install a stub `createFirebirdModule`.
+ */
+export declare class DirectTransport implements EngineTransport {
+    private readonly options;
+    private mod;
+    private initPromise;
+    constructor(options?: DirectTransportOptions);
+    init(): Promise<void>;
+    private doInit;
+    private get module();
+    /** Run `fn` with `str` allocated on the WASM heap, freeing it afterwards. */
+    private withString;
+    createDatabase(path: string): Promise<EngineHandle>;
+    attachDatabase(path: string): Promise<EngineHandle>;
+    detachDatabase(dbHandle: EngineHandle): Promise<void>;
+    /**
+     * Run `fn` with the packed parameters on the WASM heap.
+     *
+     * An empty list is passed as a null pointer rather than an empty buffer, so
+     * the C side takes its "no parameters" path and skips preparing an input
+     * message it would not use.
+     */
+    private withParams;
+    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=engine-transport.d.ts.map

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

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

package/dist/browser/engine-transport.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * engine-transport.ts – the boundary between `FirebirdBrowser` and the engine.
+ *
+ * There are two ways to reach the compiled engine, and they differ enough to
+ * be worth naming:
+ *
+ *   • {@link DirectTransport} calls the WASM exports in this thread.  Simple,
+ *     and what Node uses.
+ *   • {@link WorkerTransport} (see `worker-transport.ts`) forwards to a Web
+ *     Worker.  Browsers *must* use it: the build uses pthreads, Firebird
+ *     blocks on mutexes while opening a database, and a browser main thread is
+ *     not allowed to block — calling the engine directly from a page deadlocks.
+ *
+ * Both sides of that split need the same operations, including filesystem
+ * access: persistence copies the database between Emscripten's in-memory FS
+ * and IndexedDB, and in the Worker case that filesystem lives in the Worker.
+ *
+ * Every method is async so the two are interchangeable, even though the direct
+ * one never actually suspends.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectTransport = void 0;
+exports.decodeResultSet = decodeResultSet;
+const wasm_loader_1 = require("../wasm-loader");
+const params_1 = require("./params");
+const field_types_1 = require("./field-types");
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+/**
+ * Build an Error carrying whatever the engine reported.
+ *
+ * The C API returns only a numeric code; the readable Firebird message lives
+ * behind `_fb_last_error()` and is lost unless it is read immediately, before
+ * another call overwrites it.
+ */
+function engineError(mod, context, code) {
+    const detail = (0, wasm_loader_1.lastError)(mod);
+    const suffix = code === undefined ? '' : ` (code ${code})`;
+    return new Error(detail ? `${context}${suffix}: ${detail}` : `${context}${suffix}`);
+}
+/** Decode the engine's JSON result set into rows keyed by column name. */
+function decodeResultSet(json) {
+    const parsed = JSON.parse(json);
+    const fields = parsed.columns.map((c) => ({
+        name: c.name.toUpperCase(),
+        type: c.type,
+        typeName: (0, field_types_1.firebirdTypeName)(c.type, c.scale),
+        subType: c.subType,
+        scale: c.scale,
+        length: c.length,
+        nullable: c.nullable,
+    }));
+    const rows = parsed.rows.map((cols) => Object.fromEntries(fields.map((f, i) => [f.name, cols[i]])));
+    return { rows, fields };
+}
+// ---------------------------------------------------------------------------
+// DirectTransport
+// ---------------------------------------------------------------------------
+/**
+ * Calls the engine in the current thread.
+ *
+ * Used by Node, by the Worker (which is where a browser's engine actually
+ * runs), and by tests that install a stub `createFirebirdModule`.
+ */
+class DirectTransport {
+    constructor(options = {}) {
+        this.options = options;
+        this.mod = null;
+        this.initPromise = null;
+    }
+    async init() {
+        // Concurrent first calls must not each load the module.
+        if (!this.initPromise) {
+            this.initPromise = this.doInit();
+        }
+        await this.initPromise;
+    }
+    async doInit() {
+        this.mod = await (0, wasm_loader_1.loadFirebirdWasm)({
+            wasmBinary: this.options.wasmBinary,
+            locateFile: this.options.locateFile,
+        });
+        const rc = this.mod._fb_init();
+        if (rc !== 0) {
+            throw engineError(this.mod, 'Failed to initialise the Firebird engine', rc);
+        }
+    }
+    get module() {
+        if (!this.mod) {
+            throw new Error('EngineTransport used before init()');
+        }
+        return this.mod;
+    }
+    /** Run `fn` with `str` allocated on the WASM heap, freeing it afterwards. */
+    withString(str, fn) {
+        const mod = this.module;
+        const ptr = (0, wasm_loader_1.allocString)(mod, str);
+        try {
+            return fn(ptr);
+        }
+        finally {
+            mod._free(ptr);
+        }
+    }
+    async createDatabase(path) {
+        const mod = this.module;
+        const handle = this.withString(path, (p) => mod._fb_create_database(p));
+        if (handle === 0) {
+            throw engineError(mod, `Failed to create database "${path}"`);
+        }
+        return handle;
+    }
+    async attachDatabase(path) {
+        const mod = this.module;
+        const handle = this.withString(path, (p) => mod._fb_attach_database(p));
+        if (handle === 0) {
+            throw engineError(mod, `Failed to open database "${path}"`);
+        }
+        return handle;
+    }
+    async detachDatabase(dbHandle) {
+        this.module._fb_detach_database(dbHandle);
+    }
+    /**
+     * Run `fn` with the packed parameters on the WASM heap.
+     *
+     * An empty list is passed as a null pointer rather than an empty buffer, so
+     * the C side takes its "no parameters" path and skips preparing an input
+     * message it would not use.
+     */
+    withParams(params, fn) {
+        if (!params || params.length === 0) {
+            return fn(0, 0);
+        }
+        const mod = this.module;
+        const packed = (0, params_1.encodeParams)(params);
+        const ptr = mod._malloc(packed.length);
+        try {
+            mod.HEAPU8.set(packed, ptr);
+            return fn(ptr, packed.length);
+        }
+        finally {
+            mod._free(ptr);
+        }
+    }
+    async execute(dbHandle, txHandle, sql, params = []) {
+        const mod = this.module;
+        const rc = this.withString(sql, (sqlPtr) => this.withParams(params, (paramPtr, paramLen) => params.length === 0
+            ? mod._fb_execute(dbHandle, txHandle, sqlPtr)
+            : mod._fb_execute_params(dbHandle, txHandle, sqlPtr, paramPtr, paramLen)));
+        if (rc !== 0) {
+            throw engineError(mod, `Firebird exec failed for: ${sql}`, rc);
+        }
+        return mod._fb_last_affected_rows();
+    }
+    async query(dbHandle, txHandle, sql, params = []) {
+        const mod = this.module;
+        return this.withString(sql, (sqlPtr) => this.withParams(params, (paramPtr, paramLen) => {
+            const resultPtr = params.length === 0
+                ? mod._fb_query(dbHandle, txHandle, sqlPtr)
+                : mod._fb_query_params(dbHandle, txHandle, sqlPtr, paramPtr, paramLen);
+            if (resultPtr === 0) {
+                throw engineError(mod, `Firebird query failed for: ${sql}`);
+            }
+            // The engine owns the buffer until fb_free_result.
+            const json = mod.UTF8ToString(resultPtr);
+            mod._fb_free_result(resultPtr);
+            return decodeResultSet(json);
+        }));
+    }
+    async startTransaction(dbHandle) {
+        const mod = this.module;
+        const txHandle = mod._fb_start_transaction(dbHandle);
+        if (txHandle === 0) {
+            throw engineError(mod, 'Failed to start transaction');
+        }
+        return txHandle;
+    }
+    async commit(txHandle) {
+        const mod = this.module;
+        const rc = mod._fb_commit(txHandle);
+        if (rc !== 0) {
+            // fb_commit finishes the transaction whatever the outcome, so there is
+            // nothing left to roll back here.
+            throw engineError(mod, 'Transaction commit failed', rc);
+        }
+    }
+    async rollback(txHandle) {
+        this.module._fb_rollback(txHandle);
+    }
+    // ── Filesystem ─────────────────────────────────────────────────────────
+    async mkdir(path) {
+        const mod = this.module;
+        if (!mod.FS.analyzePath(path).exists) {
+            mod.FS.mkdir(path);
+        }
+    }
+    async exists(path) {
+        return this.module.FS.analyzePath(path).exists;
+    }
+    async readFile(path) {
+        return this.module.FS.readFile(path);
+    }
+    async writeFile(path, data) {
+        this.module.FS.writeFile(path, data);
+    }
+    async dispose() {
+        // The module is cached process-wide by loadFirebirdWasm and shared with
+        // any other instance, so it is deliberately not torn down here.
+        this.mod = null;
+        this.initPromise = null;
+    }
+}
+exports.DirectTransport = DirectTransport;
+//# sourceMappingURL=engine-transport.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * field-types.ts – readable names for Firebird's SQL type codes.
+ *
+ * The engine reports numeric type codes.  Turning them into names is not
+ * decoration: `NUMERIC` and `DECIMAL` are stored as scaled integers and arrive
+ * as exact decimal strings, so a caller has to be able to tell them from a
+ * `VARCHAR` to know whether `"20.25"` is a number or text.
+ */
+import type { FirebirdTypeName } from '../types';
+/**
+ * Name a Firebird SQL type code.
+ *
+ * A non-zero `scale` reports `NUMERIC`: Firebird stores `NUMERIC` and
+ * `DECIMAL` as scaled `SMALLINT`, `INTEGER`, `BIGINT` or `INT128`, so the type
+ * code alone would call them integers and hide that the value is exact and
+ * arrives as a string.
+ */
+export declare function firebirdTypeName(type: number, scale?: number): FirebirdTypeName;
+//# sourceMappingURL=field-types.d.ts.map

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

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

package/dist/browser/field-types.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * field-types.ts – readable names for Firebird's SQL type codes.
+ *
+ * The engine reports numeric type codes.  Turning them into names is not
+ * decoration: `NUMERIC` and `DECIMAL` are stored as scaled integers and arrive
+ * as exact decimal strings, so a caller has to be able to tell them from a
+ * `VARCHAR` to know whether `"20.25"` is a number or text.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firebirdTypeName = firebirdTypeName;
+// From firebird/impl/sqlda_pub.h. The nullable flag is the low bit, and is
+// masked off before lookup.
+const SQL_TEXT = 452;
+const SQL_VARYING = 448;
+const SQL_SHORT = 500;
+const SQL_LONG = 496;
+const SQL_FLOAT = 482;
+const SQL_DOUBLE = 480;
+const SQL_D_FLOAT = 530;
+const SQL_TIMESTAMP = 510;
+const SQL_BLOB = 520;
+const SQL_ARRAY = 540;
+const SQL_TYPE_TIME = 560;
+const SQL_TYPE_DATE = 570;
+const SQL_INT64 = 580;
+const SQL_TIMESTAMP_TZ = 32754;
+const SQL_TIME_TZ = 32756;
+const SQL_INT128 = 32752;
+const SQL_DEC16 = 32760;
+const SQL_DEC34 = 32762;
+const SQL_BOOLEAN = 32764;
+const SQL_NULL = 32766;
+const NAMES = {
+    [SQL_TEXT]: 'TEXT',
+    [SQL_VARYING]: 'VARYING',
+    [SQL_SHORT]: 'SMALLINT',
+    [SQL_LONG]: 'INTEGER',
+    [SQL_FLOAT]: 'FLOAT',
+    [SQL_DOUBLE]: 'DOUBLE',
+    [SQL_D_FLOAT]: 'DOUBLE',
+    [SQL_TIMESTAMP]: 'TIMESTAMP',
+    [SQL_BLOB]: 'BLOB',
+    [SQL_ARRAY]: 'ARRAY',
+    [SQL_TYPE_TIME]: 'TIME',
+    [SQL_TYPE_DATE]: 'DATE',
+    [SQL_INT64]: 'BIGINT',
+    [SQL_TIMESTAMP_TZ]: 'TIMESTAMP_TZ',
+    [SQL_TIME_TZ]: 'TIME_TZ',
+    [SQL_INT128]: 'INT128',
+    [SQL_DEC16]: 'DECFLOAT16',
+    [SQL_DEC34]: 'DECFLOAT34',
+    [SQL_BOOLEAN]: 'BOOLEAN',
+    [SQL_NULL]: 'NULL',
+};
+/**
+ * Name a Firebird SQL type code.
+ *
+ * A non-zero `scale` reports `NUMERIC`: Firebird stores `NUMERIC` and
+ * `DECIMAL` as scaled `SMALLINT`, `INTEGER`, `BIGINT` or `INT128`, so the type
+ * code alone would call them integers and hide that the value is exact and
+ * arrives as a string.
+ */
+function firebirdTypeName(type, scale = 0) {
+    const base = type & ~1; // strip the nullable flag
+    if (scale !== 0) {
+        switch (base) {
+            case SQL_SHORT:
+            case SQL_LONG:
+            case SQL_INT64:
+            case SQL_INT128:
+                return 'NUMERIC';
+            default:
+                break;
+        }
+    }
+    return NAMES[base] ?? 'UNKNOWN';
+}
+//# sourceMappingURL=field-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.js","sourceRoot":"","sources":["../../src/browser/field-types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA0DH,4CAgBC;AAtED,2EAA2E;AAC3E,4BAA4B;AAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,UAAU,GAAG,KAAK,CAAC;AACzB,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC;AAEvB,MAAM,KAAK,GAAqC;IAC9C,CAAC,QAAQ,CAAC,EAAE,MAAM;IAClB,CAAC,WAAW,CAAC,EAAE,SAAS;IACxB,CAAC,SAAS,CAAC,EAAE,UAAU;IACvB,CAAC,QAAQ,CAAC,EAAE,SAAS;IACrB,CAAC,SAAS,CAAC,EAAE,OAAO;IACpB,CAAC,UAAU,CAAC,EAAE,QAAQ;IACtB,CAAC,WAAW,CAAC,EAAE,QAAQ;IACvB,CAAC,aAAa,CAAC,EAAE,WAAW;IAC5B,CAAC,QAAQ,CAAC,EAAE,MAAM;IAClB,CAAC,SAAS,CAAC,EAAE,OAAO;IACpB,CAAC,aAAa,CAAC,EAAE,MAAM;IACvB,CAAC,aAAa,CAAC,EAAE,MAAM;IACvB,CAAC,SAAS,CAAC,EAAE,QAAQ;IACrB,CAAC,gBAAgB,CAAC,EAAE,cAAc;IAClC,CAAC,WAAW,CAAC,EAAE,SAAS;IACxB,CAAC,UAAU,CAAC,EAAE,QAAQ;IACtB,CAAC,SAAS,CAAC,EAAE,YAAY;IACzB,CAAC,SAAS,CAAC,EAAE,YAAY;IACzB,CAAC,WAAW,CAAC,EAAE,SAAS;IACxB,CAAC,QAAQ,CAAC,EAAE,MAAM;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,IAAY,EAAE,KAAK,GAAG,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B;IAElD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,SAAS,CAAC;YACf,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS,CAAC;YACf,KAAK,UAAU;gBACb,OAAO,SAAS,CAAC;YACnB;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AAClC,CAAC"}