firebird-wasm 0.1.0

package/dist/firebird.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirebirdTransaction = exports.FirebirdLite = void 0;
+const node_firebird_driver_native_1 = require("node-firebird-driver-native");
+const node_firebird_driver_1 = require("node-firebird-driver");
+/**
+ * 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();
+ * ```
+ */
+class FirebirdLite {
+    constructor(dbPath, options = {}) {
+        this.client = null;
+        this.attachment = null;
+        this.closed = false;
+        this.dbPath = dbPath;
+        this.libraryPath = options.libraryPath ?? (0, node_firebird_driver_native_1.getDefaultLibraryFilename)();
+        this.connectOptions = {
+            username: options.username,
+            password: options.password,
+            charSetForNONE: options.charset,
+        };
+    }
+    /**
+     * Lazily initialize the native client and open (or create) the database.
+     */
+    async ensureReady() {
+        if (this.attachment)
+            return;
+        if (this.closed) {
+            throw new Error('FirebirdLite instance has been closed');
+        }
+        this.client = (0, node_firebird_driver_native_1.createNativeClient)(this.libraryPath);
+        try {
+            this.attachment = await this.client.connect(this.dbPath, this.connectOptions);
+        }
+        catch {
+            // Database does not exist yet – create it.
+            this.attachment = await this.client.createDatabase(this.dbPath, this.connectOptions);
+        }
+    }
+    /**
+     * Execute a DDL or DML statement that does not return rows.
+     *
+     * The statement is executed in its own auto-committed transaction.
+     */
+    async exec(sql) {
+        await this.ensureReady();
+        const attachment = this.attachment;
+        const transaction = await attachment.startTransaction();
+        try {
+            await attachment.execute(transaction, sql);
+            await transaction.commit();
+        }
+        catch (err) {
+            await transaction.rollback().catch(() => undefined);
+            throw err;
+        }
+    }
+    /**
+     * 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.
+     */
+    async query(sql, params = [], options = {}) {
+        await this.ensureReady();
+        const attachment = this.attachment;
+        const txOptions = buildTransactionOptions(options);
+        const transaction = await attachment.startTransaction(txOptions);
+        try {
+            const stmt = await attachment.prepare(transaction, sql);
+            const columnLabels = await stmt.columnLabels;
+            const fields = columnLabels.map((label) => ({
+                name: label.toUpperCase(),
+            }));
+            let rows;
+            if (stmt.hasResultSet) {
+                const resultSet = await stmt.executeQuery(transaction, params);
+                const rawRows = await resultSet.fetch();
+                await resultSet.close();
+                rows = rawRows.map((cols) => Object.fromEntries(fields.map((f, i) => [f.name, cols[i]])));
+            }
+            else {
+                await stmt.execute(transaction, params);
+                rows = [];
+            }
+            await stmt.dispose();
+            await transaction.commit();
+            return { rows, fields };
+        }
+        catch (err) {
+            await transaction.rollback().catch(() => undefined);
+            throw err;
+        }
+    }
+    /**
+     * Run a function inside an explicit transaction.
+     *
+     * The transaction is automatically committed on success or rolled back on
+     * error.
+     */
+    async transaction(fn, options = {}) {
+        await this.ensureReady();
+        const attachment = this.attachment;
+        const txOptions = buildTransactionOptions(options);
+        const transaction = await attachment.startTransaction(txOptions);
+        const tx = new FirebirdTransaction(attachment, transaction);
+        try {
+            const result = await fn(tx);
+            await transaction.commit();
+            return result;
+        }
+        catch (err) {
+            await transaction.rollback().catch(() => undefined);
+            throw err;
+        }
+    }
+    /**
+     * Close the database connection and release all resources.
+     */
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        if (this.attachment) {
+            await this.attachment.disconnect().catch(() => undefined);
+            this.attachment = null;
+        }
+        if (this.client) {
+            await this.client.dispose().catch(() => undefined);
+            this.client = null;
+        }
+    }
+}
+exports.FirebirdLite = FirebirdLite;
+/**
+ * A handle to an active Firebird transaction, exposed to callers of
+ * `FirebirdLite.transaction()`.
+ */
+class FirebirdTransaction {
+    constructor(attachment, transaction) {
+        this.attachment = attachment;
+        this.transaction = transaction;
+    }
+    /**
+     * Execute a DDL or DML statement inside this transaction.
+     */
+    async exec(sql, params = []) {
+        if (params.length > 0) {
+            const stmt = await this.attachment.prepare(this.transaction, sql);
+            try {
+                await stmt.execute(this.transaction, params);
+            }
+            finally {
+                await stmt.dispose().catch(() => undefined);
+            }
+        }
+        else {
+            await this.attachment.execute(this.transaction, sql);
+        }
+    }
+    /**
+     * Execute a SELECT statement inside this transaction and return rows.
+     */
+    async query(sql, params = []) {
+        const stmt = await this.attachment.prepare(this.transaction, sql);
+        const columnLabels = await stmt.columnLabels;
+        const fields = columnLabels.map((label) => ({
+            name: label.toUpperCase(),
+        }));
+        const resultSet = await stmt.executeQuery(this.transaction, params);
+        const rawRows = await resultSet.fetch();
+        await resultSet.close();
+        await stmt.dispose();
+        const rows = rawRows.map((cols) => Object.fromEntries(fields.map((f, i) => [f.name, cols[i]])));
+        return { rows, fields };
+    }
+}
+exports.FirebirdTransaction = FirebirdTransaction;
+// ---------------------------------------------------------------------------
+// Module-level helpers
+// ---------------------------------------------------------------------------
+function buildTransactionOptions(options) {
+    const isolationMap = {
+        READ_COMMITTED: node_firebird_driver_1.TransactionIsolation.READ_COMMITTED,
+        SNAPSHOT: node_firebird_driver_1.TransactionIsolation.SNAPSHOT,
+        SNAPSHOT_TABLE_STABILITY: node_firebird_driver_1.TransactionIsolation.CONSISTENCY,
+    };
+    return {
+        isolation: options.isolationLevel
+            ? isolationMap[options.isolationLevel]
+            : undefined,
+        accessMode: options.readOnly ? 'READ_ONLY' : undefined,
+    };
+}
+//# sourceMappingURL=firebird.js.map

package/dist/firebird.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * firebird-wasm – Firebird Embedded for Node.js / TypeScript
+ *
+ * Provides a PGlite-style async API backed by the Firebird embedded engine.
+ *
+ * @example
+ * ```ts
+ * import { FirebirdLite } from 'firebird-wasm';
+ *
+ * const db = new FirebirdLite('/tmp/my-app.fdb');
+ * await db.exec('CREATE TABLE items (id INTEGER, name VARCHAR(100))');
+ * await db.exec('INSERT INTO items VALUES (1, \'hello\')');
+ * const result = await db.query('SELECT * FROM items');
+ * console.log(result.rows); // [{ ID: 1, NAME: 'hello' }]
+ * await db.close();
+ * ```
+ */
+export { FirebirdLite, FirebirdTransaction } from './firebird';
+export type { FirebirdLiteOptions, QueryResult, QueryParams, Row, FieldInfo, TransactionOptions, IsolationLevel, } from './types';
+export { loadFirebirdWasm, allocString } from './wasm-loader';
+export type { FirebirdWasmModule, WasmLoadOptions, EmscriptenFS, FbHandle, } from './wasm-loader';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,GAAG,EACH,SAAS,EACT,kBAAkB,EAClB,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,QAAQ,GACT,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * firebird-wasm – Firebird Embedded for Node.js / TypeScript
+ *
+ * Provides a PGlite-style async API backed by the Firebird embedded engine.
+ *
+ * @example
+ * ```ts
+ * import { FirebirdLite } from 'firebird-wasm';
+ *
+ * const db = new FirebirdLite('/tmp/my-app.fdb');
+ * await db.exec('CREATE TABLE items (id INTEGER, name VARCHAR(100))');
+ * await db.exec('INSERT INTO items VALUES (1, \'hello\')');
+ * const result = await db.query('SELECT * FROM items');
+ * console.log(result.rows); // [{ ID: 1, NAME: 'hello' }]
+ * await db.close();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocString = exports.loadFirebirdWasm = exports.FirebirdTransaction = exports.FirebirdLite = void 0;
+var firebird_1 = require("./firebird");
+Object.defineProperty(exports, "FirebirdLite", { enumerable: true, get: function () { return firebird_1.FirebirdLite; } });
+Object.defineProperty(exports, "FirebirdTransaction", { enumerable: true, get: function () { return firebird_1.FirebirdTransaction; } });
+// WASM loader (available on all platforms)
+var wasm_loader_1 = require("./wasm-loader");
+Object.defineProperty(exports, "loadFirebirdWasm", { enumerable: true, get: function () { return wasm_loader_1.loadFirebirdWasm; } });
+Object.defineProperty(exports, "allocString", { enumerable: true, get: function () { return wasm_loader_1.allocString; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,uCAA+D;AAAtD,wGAAA,YAAY,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAW1C,2CAA2C;AAC3C,6CAA8D;AAArD,+GAAA,gBAAgB,OAAA;AAAE,0GAAA,WAAW,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * TypeScript types for FirebirdLite
+ */
+/**
+ * Options for creating a FirebirdLite instance.
+ */
+export interface FirebirdLiteOptions {
+    /** Path to the Firebird client library. Defaults to the system default. */
+    libraryPath?: string;
+    /**
+     * Character set for `NONE`-charset columns/parameters.
+     * Passed as `charSetForNONE` to the underlying driver.
+     */
+    charset?: string;
+    /** Firebird user name. Defaults to 'SYSDBA'. */
+    username?: string;
+    /** Firebird user password. */
+    password?: string;
+}
+/**
+ * Result returned from a query execution.
+ */
+export interface QueryResult<T = Row> {
+    /** Array of result rows. */
+    rows: T[];
+    /** Column names in the result set (in order). */
+    fields: FieldInfo[];
+    /** Number of rows affected (for INSERT/UPDATE/DELETE). */
+    affectedRows?: number;
+}
+/**
+ * Information about a result set column.
+ *
+ * Everything beyond `name` is optional because the Node.js native driver does
+ * not expose it; the WASM backend fills it in.
+ */
+export interface FieldInfo {
+    /** Column name (alias if provided, otherwise the field name). */
+    name: string;
+    /**
+     * Firebird SQL type code — `SQL_LONG` (496), `SQL_VARYING` (448) and so on.
+     *
+     * Worth having because the JSON encoding is lossy about types: a
+     * `NUMERIC(10,2)` arrives as the string `"20.25"` to preserve its exactness,
+     * and without this it is indistinguishable from a `VARCHAR` containing
+     * digits.
+     */
+    type?: number;
+    /** A readable form of {@link FieldInfo.type}, e.g. `'NUMERIC'`. */
+    typeName?: FirebirdTypeName;
+    /** Type-specific subtype; for BLOBs, 1 means text. */
+    subType?: number;
+    /** Decimal scale.  Non-zero means the value is exact and arrives as a string. */
+    scale?: number;
+    /** Declared length in bytes. */
+    length?: number;
+    /** Whether the column may be NULL. */
+    nullable?: boolean;
+}
+/** Readable names for the Firebird SQL type codes this library reports. */
+export type FirebirdTypeName = 'TEXT' | 'VARYING' | 'SMALLINT' | 'INTEGER' | 'BIGINT' | 'INT128' | 'FLOAT' | 'DOUBLE' | 'DECFLOAT16' | 'DECFLOAT34' | 'NUMERIC' | 'DATE' | 'TIME' | 'TIMESTAMP' | 'TIME_TZ' | 'TIMESTAMP_TZ' | 'BOOLEAN' | 'BLOB' | 'ARRAY' | 'NULL' | 'UNKNOWN';
+/**
+ * A single row from a query result, keyed by column name.
+ */
+export type Row = Record<string, unknown>;
+/**
+ * Parameters passed to a parameterized query.
+ */
+export type QueryParams = unknown[];
+/**
+ * Transaction isolation level.
+ *
+ * - `READ_COMMITTED` – reads the latest committed version of each row;
+ *   other transactions' commits become visible during the transaction.
+ * - `SNAPSHOT` – provides a stable, point-in-time view of the database
+ *   from the moment the transaction started (Firebird's default).
+ * - `SNAPSHOT_TABLE_STABILITY` – acquires shared table locks to prevent
+ *   concurrent writes; mapped to Firebird `CONSISTENCY` isolation.
+ */
+export type IsolationLevel = 'READ_COMMITTED' | 'SNAPSHOT' | 'SNAPSHOT_TABLE_STABILITY';
+/**
+ * Options for beginning a transaction.
+ */
+export interface TransactionOptions {
+    isolationLevel?: IsolationLevel;
+    readOnly?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,4BAA4B;IAC5B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,iDAAiD;IACjD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,MAAM,GACN,MAAM,GACN,WAAW,GACX,SAAS,GACT,cAAc,GACd,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,EAAE,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,UAAU,GACV,0BAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * TypeScript types for FirebirdLite
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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