firebird-wasm 0.2.0 → 0.4.0

package/dist/browser/index.js

@@ -10,26 +10,42 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.allocString = exports.loadFirebirdWasm = exports.IndexedDBVFS = exports.serveEngine = exports.WorkerTransport = exports.electLeader = exports.SharedEngineTransport = exports.DirectTransport = exports.splitStatements = exports.DatabaseLockedError = exports.databaseLockName = exports.acquireDatabaseLock = exports.hasTransactionOptions = exports.isolationCode = exports.firebirdTypeName = exports.encodeParamValue = exports.encodeParams = exports.FirebirdBrowserTransaction = exports.FirebirdBrowser = void 0;
+exports.allocString = exports.loadFirebirdWasm = exports.IndexedDBVFS = exports.serveEngine = exports.WorkerTransport = exports.electLeader = exports.SharedEngineTransport = exports.DirectTransport = exports.splitStatements = exports.DatabaseLockedError = exports.databaseLockName = exports.acquireDatabaseLock = exports.hasTypeOptions = exports.applySerializers = exports.applyTypes = exports.hasTransactionOptions = exports.isolationCode = exports.BLOB_SIDE_CHANNEL = exports.attachBlobs = exports.decodeDescription = exports.statementKind = exports.firebirdTypeName = exports.encodeParamValue = exports.encodeParams = exports.toStatement = exports.isSqlFragment = exports.RawSql = exports.SqlFragment = exports.sql = exports.FirebirdBrowserTransaction = exports.FirebirdBrowser = void 0;
 var firebird_browser_1 = require("./firebird-browser");
 Object.defineProperty(exports, "FirebirdBrowser", { enumerable: true, get: function () { return firebird_browser_1.FirebirdBrowser; } });
 Object.defineProperty(exports, "FirebirdBrowserTransaction", { enumerable: true, get: function () { return firebird_browser_1.FirebirdBrowserTransaction; } });
+var sql_tag_1 = require("../sql-tag");
+Object.defineProperty(exports, "sql", { enumerable: true, get: function () { return sql_tag_1.sql; } });
+Object.defineProperty(exports, "SqlFragment", { enumerable: true, get: function () { return sql_tag_1.SqlFragment; } });
+Object.defineProperty(exports, "RawSql", { enumerable: true, get: function () { return sql_tag_1.RawSql; } });
+Object.defineProperty(exports, "isSqlFragment", { enumerable: true, get: function () { return sql_tag_1.isSqlFragment; } });
+Object.defineProperty(exports, "toStatement", { enumerable: true, get: function () { return sql_tag_1.toStatement; } });
 var params_1 = require("./params");
 Object.defineProperty(exports, "encodeParams", { enumerable: true, get: function () { return params_1.encodeParams; } });
 Object.defineProperty(exports, "encodeParamValue", { enumerable: true, get: function () { return params_1.encodeParamValue; } });
 var field_types_1 = require("./field-types");
 Object.defineProperty(exports, "firebirdTypeName", { enumerable: true, get: function () { return field_types_1.firebirdTypeName; } });
+var statement_types_1 = require("../statement-types");
+Object.defineProperty(exports, "statementKind", { enumerable: true, get: function () { return statement_types_1.statementKind; } });
+var engine_transport_1 = require("./engine-transport");
+Object.defineProperty(exports, "decodeDescription", { enumerable: true, get: function () { return engine_transport_1.decodeDescription; } });
+Object.defineProperty(exports, "attachBlobs", { enumerable: true, get: function () { return engine_transport_1.attachBlobs; } });
+Object.defineProperty(exports, "BLOB_SIDE_CHANNEL", { enumerable: true, get: function () { return engine_transport_1.BLOB_SIDE_CHANNEL; } });
 var isolation_1 = require("./isolation");
 Object.defineProperty(exports, "isolationCode", { enumerable: true, get: function () { return isolation_1.isolationCode; } });
 Object.defineProperty(exports, "hasTransactionOptions", { enumerable: true, get: function () { return isolation_1.hasTransactionOptions; } });
+var value_types_1 = require("./value-types");
+Object.defineProperty(exports, "applyTypes", { enumerable: true, get: function () { return value_types_1.applyTypes; } });
+Object.defineProperty(exports, "applySerializers", { enumerable: true, get: function () { return value_types_1.applySerializers; } });
+Object.defineProperty(exports, "hasTypeOptions", { enumerable: true, get: function () { return value_types_1.hasTypeOptions; } });
 var db_lock_1 = require("./db-lock");
 Object.defineProperty(exports, "acquireDatabaseLock", { enumerable: true, get: function () { return db_lock_1.acquireDatabaseLock; } });
 Object.defineProperty(exports, "databaseLockName", { enumerable: true, get: function () { return db_lock_1.databaseLockName; } });
 Object.defineProperty(exports, "DatabaseLockedError", { enumerable: true, get: function () { return db_lock_1.DatabaseLockedError; } });
 var sql_script_1 = require("./sql-script");
 Object.defineProperty(exports, "splitStatements", { enumerable: true, get: function () { return sql_script_1.splitStatements; } });
-var engine_transport_1 = require("./engine-transport");
-Object.defineProperty(exports, "DirectTransport", { enumerable: true, get: function () { return engine_transport_1.DirectTransport; } });
+var engine_transport_2 = require("./engine-transport");
+Object.defineProperty(exports, "DirectTransport", { enumerable: true, get: function () { return engine_transport_2.DirectTransport; } });
 var shared_transport_1 = require("./shared-transport");
 Object.defineProperty(exports, "SharedEngineTransport", { enumerable: true, get: function () { return shared_transport_1.SharedEngineTransport; } });
 var leader_election_1 = require("./leader-election");

package/dist/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,uDAAiF;AAAxE,mHAAA,eAAe,OAAA;AAAE,8HAAA,0BAA0B,OAAA;AAGpD,mCAA0D;AAAjD,sGAAA,YAAY,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAEvC,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAEzB,yCAAmE;AAA1D,0GAAA,aAAa,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAE7C,qCAImB;AAHjB,8GAAA,mBAAmB,OAAA;AACnB,2GAAA,gBAAgB,OAAA;AAChB,8GAAA,mBAAmB,OAAA;AAIrB,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAGxB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAOxB,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA;AAG9B,qDAAgD;AAAvC,8GAAA,WAAW,OAAA;AAGpB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAQpB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAGrB,8CAA+D;AAAtD,+GAAA,gBAAgB,OAAA;AAAE,0GAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,uDAAiF;AAAxE,mHAAA,eAAe,OAAA;AAAE,8HAAA,0BAA0B,OAAA;AAUpD,sCAAkF;AAAzE,8FAAA,GAAG,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,iGAAA,MAAM,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,sGAAA,WAAW,OAAA;AAG7D,mCAA0D;AAAjD,sGAAA,YAAY,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAEvC,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AACzB,sDAAmD;AAA1C,gHAAA,aAAa,OAAA;AACtB,uDAAuF;AAA9E,qHAAA,iBAAiB,OAAA;AAAE,+GAAA,WAAW,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAE1D,yCAAmE;AAA1D,0GAAA,aAAa,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAE7C,6CAA6E;AAApE,yGAAA,UAAU,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAAE,6GAAA,cAAc,OAAA;AAGrD,qCAImB;AAHjB,8GAAA,mBAAmB,OAAA;AACnB,2GAAA,gBAAgB,OAAA;AAChB,8GAAA,mBAAmB,OAAA;AAIrB,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AAGxB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAOxB,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA;AAG9B,qDAAgD;AAAvC,8GAAA,WAAW,OAAA;AAGpB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAQpB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAGrB,8CAA+D;AAAtD,+GAAA,gBAAgB,OAAA;AAAE,0GAAA,WAAW,OAAA"}

package/dist/browser/opfs-fs.d.ts

@@ -0,0 +1,72 @@
+/**
+ * opfs-fs.ts – an Emscripten filesystem backed by OPFS sync access handles.
+ *
+ * The IndexedDB path keeps the whole database in memory and copies the image
+ * out on every persist. That is a durability strategy bolted beside the engine.
+ * This is the other shape: Firebird's own reads and writes land in a file, and
+ * there is no persist step because there is nothing to copy.
+ *
+ * Three facts make it possible, and each was checked rather than assumed:
+ *
+ *   1. **Firebird's I/O reaches JavaScript.** A custom filesystem mounted in
+ *      Emscripten's FS sees the engine's reads and writes — measured at 1,678
+ *      writes and 14.1 MB for a create-plus-insert, all through `stream_ops`.
+ *   2. **`FileSystemSyncAccessHandle` is synchronous**, which is what a
+ *      filesystem callback needs: `read`, `write`, `truncate` and `getSize`
+ *      return values rather than promises. It exists only in a Worker, and the
+ *      engine already runs in one — a browser cannot run it anywhere else.
+ *   3. **Handles are opened before the mount.** Opening one is async and a
+ *      stream op cannot await, so the database's handle is acquired up front
+ *      and the mount owns it from then on.
+ *
+ * What this deliberately does not do is host a general filesystem. One mount
+ * holds one database, because that is what Firebird opens: the probe recorded
+ * exactly one `open` for a create-and-query cycle. Temporary files, if the
+ * engine ever wants them, stay on MEMFS where they belong — they are scratch,
+ * and paying an OPFS round trip for them would be a cost with no durability to
+ * show for it.
+ */
+import type { FirebirdWasmModule } from '../wasm-loader';
+/**
+ * `FileSystemSyncAccessHandle`, as much of it as is used here.
+ *
+ * Declared rather than imported: the DOM lib in this project's TypeScript
+ * target does not carry it, and a hand-written interface says exactly which
+ * four methods this depends on.
+ */
+interface SyncAccessHandle {
+    read(buffer: ArrayBufferView, options?: {
+        at?: number;
+    }): number;
+    write(buffer: ArrayBufferView, options?: {
+        at?: number;
+    }): number;
+    truncate(size: number): void;
+    getSize(): number;
+    flush(): void;
+    close(): void;
+}
+/** True where OPFS sync access handles can actually be used. */
+export declare function opfsAvailable(): boolean;
+/**
+ * Open — creating if needed — the sync access handle for one database.
+ *
+ * @throws if another handle on the same file is already open. OPFS enforces
+ *   that exclusively, which is a stronger and more honest guarantee than the
+ *   Web Lock the IndexedDB path uses: two tabs cannot both hold the file, and
+ *   the second one is told so by the platform rather than by a convention.
+ */
+export declare function openDatabaseHandle(name: string): Promise<SyncAccessHandle>;
+/** Delete a database's file.  Fails silently when there is nothing to delete. */
+export declare function removeDatabaseFile(name: string): Promise<void>;
+/**
+ * Mount a filesystem at `mountpoint` whose files are OPFS sync access handles.
+ *
+ * `files` maps a name inside the mount to its already-open handle. Nothing
+ * else can be created there: a filesystem that silently accepted a second file
+ * would be one that silently lost it, since only the listed handles are backed
+ * by anything.
+ */
+export declare function mountOpfs(mod: FirebirdWasmModule, mountpoint: string, files: Map<string, SyncAccessHandle>): void;
+export {};
+//# sourceMappingURL=opfs-fs.d.ts.map

package/dist/browser/opfs-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs-fs.d.ts","sourceRoot":"","sources":["../../src/browser/opfs-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMzD;;;;;;GAMG;AACH,UAAU,gBAAgB;IACxB,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IACjE,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,IAAI,MAAM,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,IAAI,CAAC;CACf;AAeD,gEAAgE;AAChE,wBAAgB,aAAa,IAAI,OAAO,CAgBvC;AASD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKhF;AAED,iFAAiF;AACjF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE;AAuCD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,kBAAkB,EACvB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACnC,IAAI,CA8KN"}

package/dist/browser/opfs-fs.js

@@ -0,0 +1,249 @@
+"use strict";
+/**
+ * opfs-fs.ts – an Emscripten filesystem backed by OPFS sync access handles.
+ *
+ * The IndexedDB path keeps the whole database in memory and copies the image
+ * out on every persist. That is a durability strategy bolted beside the engine.
+ * This is the other shape: Firebird's own reads and writes land in a file, and
+ * there is no persist step because there is nothing to copy.
+ *
+ * Three facts make it possible, and each was checked rather than assumed:
+ *
+ *   1. **Firebird's I/O reaches JavaScript.** A custom filesystem mounted in
+ *      Emscripten's FS sees the engine's reads and writes — measured at 1,678
+ *      writes and 14.1 MB for a create-plus-insert, all through `stream_ops`.
+ *   2. **`FileSystemSyncAccessHandle` is synchronous**, which is what a
+ *      filesystem callback needs: `read`, `write`, `truncate` and `getSize`
+ *      return values rather than promises. It exists only in a Worker, and the
+ *      engine already runs in one — a browser cannot run it anywhere else.
+ *   3. **Handles are opened before the mount.** Opening one is async and a
+ *      stream op cannot await, so the database's handle is acquired up front
+ *      and the mount owns it from then on.
+ *
+ * What this deliberately does not do is host a general filesystem. One mount
+ * holds one database, because that is what Firebird opens: the probe recorded
+ * exactly one `open` for a create-and-query cycle. Temporary files, if the
+ * engine ever wants them, stay on MEMFS where they belong — they are scratch,
+ * and paying an OPFS round trip for them would be a cost with no durability to
+ * show for it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.opfsAvailable = opfsAvailable;
+exports.openDatabaseHandle = openDatabaseHandle;
+exports.removeDatabaseFile = removeDatabaseFile;
+exports.mountOpfs = mountOpfs;
+/** True where OPFS sync access handles can actually be used. */
+function opfsAvailable() {
+    const scope = globalThis;
+    if (typeof scope.navigator?.storage?.getDirectory !== 'function')
+        return false;
+    // Sync access handles are Worker-only. On a main thread the API is present
+    // and `createSyncAccessHandle` rejects, which would surface as a failure deep
+    // inside a mount rather than as a refusal to start. `importScripts` is the
+    // cheapest reliable marker of a worker scope and needs no DOM lib types.
+    return (scope.WorkerGlobalScope !== undefined || typeof scope.importScripts === 'function');
+}
+// ---------------------------------------------------------------------------
+// Opening the file
+// ---------------------------------------------------------------------------
+/** Directory under the OPFS root holding this library's databases. */
+const OPFS_DIRECTORY = 'firebird';
+/**
+ * Open — creating if needed — the sync access handle for one database.
+ *
+ * @throws if another handle on the same file is already open. OPFS enforces
+ *   that exclusively, which is a stronger and more honest guarantee than the
+ *   Web Lock the IndexedDB path uses: two tabs cannot both hold the file, and
+ *   the second one is told so by the platform rather than by a convention.
+ */
+async function openDatabaseHandle(name) {
+    const root = (await navigator.storage.getDirectory());
+    const dir = await root.getDirectoryHandle(OPFS_DIRECTORY, { create: true });
+    const file = await dir.getFileHandle(`${name}.fdb`, { create: true });
+    return file.createSyncAccessHandle();
+}
+/** Delete a database's file.  Fails silently when there is nothing to delete. */
+async function removeDatabaseFile(name) {
+    const root = (await navigator.storage.getDirectory());
+    const dir = await root.getDirectoryHandle(OPFS_DIRECTORY, { create: true });
+    await dir.removeEntry(`${name}.fdb`).catch(() => undefined);
+}
+const S_IFDIR = 0o040000;
+const S_IFREG = 0o100000;
+const ENOENT = 44;
+const EPERM = 63;
+/**
+ * Mount a filesystem at `mountpoint` whose files are OPFS sync access handles.
+ *
+ * `files` maps a name inside the mount to its already-open handle. Nothing
+ * else can be created there: a filesystem that silently accepted a second file
+ * would be one that silently lost it, since only the listed handles are backed
+ * by anything.
+ */
+function mountOpfs(mod, mountpoint, files) {
+    const FS = mod.FS;
+    // A scratch buffer, because the WASM heap is a SharedArrayBuffer under
+    // pthreads and OPFS rejects views onto one. Grown as needed and reused, so
+    // the cost is one copy per operation rather than one allocation.
+    let scratch = new Uint8Array(65536);
+    const scratchFor = (length) => {
+        if (scratch.byteLength < length) {
+            scratch = new Uint8Array(Math.max(length, scratch.byteLength * 2));
+        }
+        return scratch.subarray(0, length);
+    };
+    const attrs = (node, size) => ({
+        dev: 1,
+        ino: node.id,
+        mode: node.mode,
+        nlink: 1,
+        uid: 0,
+        gid: 0,
+        rdev: node.rdev,
+        size,
+        atime: new Date(node.timestamp),
+        mtime: new Date(node.timestamp),
+        ctime: new Date(node.timestamp),
+        blksize: 4096,
+        blocks: Math.ceil(size / 4096),
+    });
+    const streamOps = {
+        open() {
+            /* The handle is already open; there is nothing per-stream to do. */
+        },
+        close() {
+            // Deliberately not closed here. The handle outlives any single open —
+            // Firebird opens and closes the database repeatedly within one session,
+            // and reopening a sync access handle is both async and exclusive, so a
+            // close here would make the next open fail.
+        },
+        llseek(stream, offset, whence) {
+            let position = offset;
+            if (whence === 1)
+                position += stream.position;
+            else if (whence === 2)
+                position += stream.node.handle.getSize();
+            if (position < 0)
+                throw new FS.ErrnoError(28); // EINVAL
+            return position;
+        },
+        read(stream, buffer, offset, length, position) {
+            const handle = stream.node.handle;
+            const target = scratchFor(length);
+            const read = handle.read(target, { at: position });
+            if (read > 0)
+                buffer.set(target.subarray(0, read), offset);
+            return read;
+        },
+        write(stream, buffer, offset, length, position) {
+            const handle = stream.node.handle;
+            const source = scratchFor(length);
+            source.set(buffer.subarray(offset, offset + length));
+            return handle.write(source, { at: position });
+        },
+    };
+    const fileOps = {
+        getattr(node) {
+            return attrs(node, node.handle.getSize());
+        },
+        setattr(node, attr) {
+            if (attr.mode !== undefined)
+                node.mode = attr.mode;
+            if (attr.timestamp !== undefined)
+                node.timestamp = attr.timestamp;
+            if (attr.size !== undefined)
+                node.handle.truncate(attr.size);
+        },
+    };
+    /**
+     * Bind a name to its pre-opened handle as a file node, once.
+     *
+     * Cached on the directory so `lookup` keeps returning the same node: the FS
+     * treats node identity as file identity, and a fresh object each time would
+     * make the same file look like a different one.
+     */
+    const materialise = (parent, name) => {
+        const existing = parent.contents?.[name];
+        if (existing)
+            return existing;
+        const handle = files.get(name);
+        if (!handle)
+            throw new FS.ErrnoError(ENOENT);
+        const node = FS.createNode(parent, name, S_IFREG | 0o666, 0);
+        node.node_ops = fileOps;
+        node.stream_ops = streamOps;
+        node.handle = handle;
+        node.timestamp = Date.now();
+        parent.contents[name] = node;
+        return node;
+    };
+    const dirOps = {
+        getattr(node) {
+            return attrs(node, 4096);
+        },
+        setattr(node, attr) {
+            if (attr.mode !== undefined)
+                node.mode = attr.mode;
+            if (attr.timestamp !== undefined)
+                node.timestamp = attr.timestamp;
+        },
+        /**
+         * A file exists here when its handle has bytes in it.
+         *
+         * Opening a sync access handle creates the underlying file, so the file is
+         * always *there* — which would make every database look pre-existing and
+         * Firebird's `O_CREAT | O_EXCL` fail with EEXIST on a database that has
+         * never been written. Size is what actually distinguishes "not yet a
+         * database" from "a database", so size is what existence means.
+         */
+        lookup(parent, name) {
+            const cached = parent.contents?.[name];
+            if (cached)
+                return cached;
+            const handle = files.get(name);
+            if (!handle || handle.getSize() === 0)
+                throw new FS.ErrnoError(ENOENT);
+            return materialise(parent, name);
+        },
+        mknod(parent, name) {
+            // Creating the database is the engine binding itself to the handle that
+            // was opened for it. Any other name has no backing store, and a file
+            // with none would read back empty later rather than failing now.
+            if (!files.has(name))
+                throw new FS.ErrnoError(EPERM);
+            return materialise(parent, name);
+        },
+        rename() {
+            throw new FS.ErrnoError(EPERM);
+        },
+        unlink() {
+            throw new FS.ErrnoError(EPERM);
+        },
+        rmdir() {
+            throw new FS.ErrnoError(EPERM);
+        },
+        readdir(node) {
+            return ['.', '..', ...Object.keys(node.contents ?? {})];
+        },
+        symlink() {
+            throw new FS.ErrnoError(EPERM);
+        },
+    };
+    const filesystem = {
+        mount() {
+            // Only the directory. Its files appear through `lookup`, which is what
+            // lets an unwritten database be absent rather than empty.
+            const root = FS.createNode(null, '/', S_IFDIR | 0o777, 0);
+            root.node_ops = dirOps;
+            root.stream_ops = {};
+            root.contents = {};
+            root.timestamp = Date.now();
+            return root;
+        },
+    };
+    if (!FS.analyzePath(mountpoint).exists) {
+        FS.mkdir(mountpoint);
+    }
+    FS.mount(filesystem, {}, mountpoint);
+}
+//# sourceMappingURL=opfs-fs.js.map

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/params.d.ts

@@ -6,15 +6,25 @@
  *
  *     u32  count
  *     per parameter:
- *       u8   isNull
- *       u32  byteLength    (absent when isNull)
- *       ...  UTF-8 bytes   (absent when isNull)
+ *       u8   flags         bit 0: SQL NULL; bit 1: a binary form follows the text
+ *       u32  byteLength    (absent when NULL)
+ *       ...  UTF-8 bytes   (absent when NULL)
+ *       u8   kind          (only with bit 1) 1: INT64, 2: DOUBLE
+ *       8    the value     (only with bit 1) little-endian
  *
  * Every value is sent as text.  The engine describes the input message as
  * VARCHAR UTF-8 and converts to each column's actual type, which is why one
  * path handles integers, dates and strings alike — the alternative is
  * reimplementing Firebird's conversion rules here and getting them subtly
  * wrong.
+ *
+ * A number or bigint also travels as the 64-bit value it is, beside its text.
+ * The engine uses that form where the column is floating-point or a whole
+ * number: no text is parsed, and a double arrives bit for bit (Firebird's
+ * text-to-double conversion is off by an ulp for about one value in six).
+ * Every other column — NUMERIC and DECIMAL with their exact decimal
+ * conversion, VARCHAR, dates — gets the text, so `1.1` into a NUMERIC(18,2)
+ * is still 1.10 and into a VARCHAR still '1.1'.
  */
 import type { QueryParams } from '../types';
 /**
@@ -23,6 +33,18 @@ import type { QueryParams } from '../types';
  * @throws if the value has no unambiguous SQL text form.
  */
 export declare function encodeParamValue(value: unknown, index: number): string;
+/** The binary form of a parameter, when it has one. */
+export declare const BINARY_INT64 = 1;
+export declare const BINARY_DOUBLE = 2;
+/**
+ * A number's or bigint's binary form: a safe integer and a bigint within
+ * INT64 go as INT64, any other finite number as DOUBLE.  Anything else — a
+ * bigint beyond 64 bits included, which only the text can carry — has none.
+ */
+export declare function binaryParamForm(value: unknown): {
+    kind: number;
+    value: bigint | number;
+} | null;
 /**
  * Pack parameters into the buffer the C API expects.
  *
@@ -30,4 +52,9 @@ export declare function encodeParamValue(value: unknown, index: number): string;
  * interchangeably for "absent", and rejecting one would be a trap.
  */
 export declare function encodeParams(params: QueryParams): Uint8Array;
+/**
+ * Pack the parameter sets of a batch: a u32 row count, then each row's
+ * parameters exactly as encodeParams lays one set out, back to back.
+ */
+export declare function encodeParamRows(rows: QueryParams[]): Uint8Array;
 //# sourceMappingURL=params.d.ts.map

package/dist/browser/params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/browser/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA6CtE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAkC5D"}
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/browser/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA6CtE;AAED,uDAAuD;AACvD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,aAAa,IAAI,CAAC;AAK/B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,IAAI,CAW/F;AAuCD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,CAU5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,UAAU,CAqB/D"}

package/dist/browser/params.js

@@ -7,19 +7,32 @@
  *
  *     u32  count
  *     per parameter:
- *       u8   isNull
- *       u32  byteLength    (absent when isNull)
- *       ...  UTF-8 bytes   (absent when isNull)
+ *       u8   flags         bit 0: SQL NULL; bit 1: a binary form follows the text
+ *       u32  byteLength    (absent when NULL)
+ *       ...  UTF-8 bytes   (absent when NULL)
+ *       u8   kind          (only with bit 1) 1: INT64, 2: DOUBLE
+ *       8    the value     (only with bit 1) little-endian
  *
  * Every value is sent as text.  The engine describes the input message as
  * VARCHAR UTF-8 and converts to each column's actual type, which is why one
  * path handles integers, dates and strings alike — the alternative is
  * reimplementing Firebird's conversion rules here and getting them subtly
  * wrong.
+ *
+ * A number or bigint also travels as the 64-bit value it is, beside its text.
+ * The engine uses that form where the column is floating-point or a whole
+ * number: no text is parsed, and a double arrives bit for bit (Firebird's
+ * text-to-double conversion is off by an ulp for about one value in six).
+ * Every other column — NUMERIC and DECIMAL with their exact decimal
+ * conversion, VARCHAR, dates — gets the text, so `1.1` into a NUMERIC(18,2)
+ * is still 1.10 and into a VARCHAR still '1.1'.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.BINARY_DOUBLE = exports.BINARY_INT64 = void 0;
 exports.encodeParamValue = encodeParamValue;
+exports.binaryParamForm = binaryParamForm;
 exports.encodeParams = encodeParams;
+exports.encodeParamRows = encodeParamRows;
 /**
  * Render one parameter the way Firebird's string-to-type conversion expects.
  *
@@ -56,6 +69,59 @@ function encodeParamValue(value, index) {
     }
     throw new TypeError(`Parameter ${index} has unsupported type ${value === null ? 'null' : typeof value}; pass a string, number, bigint, boolean, Date, null or undefined`);
 }
+/** The binary form of a parameter, when it has one. */
+exports.BINARY_INT64 = 1;
+exports.BINARY_DOUBLE = 2;
+const INT64_MIN = -(2n ** 63n);
+const INT64_MAX = 2n ** 63n - 1n;
+/**
+ * A number's or bigint's binary form: a safe integer and a bigint within
+ * INT64 go as INT64, any other finite number as DOUBLE.  Anything else — a
+ * bigint beyond 64 bits included, which only the text can carry — has none.
+ */
+function binaryParamForm(value) {
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            return null;
+        return Number.isSafeInteger(value)
+            ? { kind: exports.BINARY_INT64, value: BigInt(value) }
+            : { kind: exports.BINARY_DOUBLE, value };
+    }
+    if (typeof value === 'bigint' && value >= INT64_MIN && value <= INT64_MAX) {
+        return { kind: exports.BINARY_INT64, value };
+    }
+    return null;
+}
+function encodeOne(value, index, encoder) {
+    if (value === null || value === undefined)
+        return { text: null, binary: null };
+    return { text: encoder.encode(encodeParamValue(value, index)), binary: binaryParamForm(value) };
+}
+function sizeOf(p) {
+    return 1 + (p.text ? 4 + p.text.length : 0) + (p.binary ? 9 : 0);
+}
+function writeParams(out, view, pos, encoded) {
+    view.setUint32(pos, encoded.length, true);
+    pos += 4;
+    for (const p of encoded) {
+        out[pos++] = (p.text ? 0 : 1) | (p.binary ? 2 : 0);
+        if (p.text) {
+            view.setUint32(pos, p.text.length, true);
+            pos += 4;
+            out.set(p.text, pos);
+            pos += p.text.length;
+        }
+        if (p.binary) {
+            out[pos++] = p.binary.kind;
+            if (p.binary.kind === exports.BINARY_INT64)
+                view.setBigInt64(pos, p.binary.value, true);
+            else
+                view.setFloat64(pos, p.binary.value, true);
+            pos += 8;
+        }
+    }
+    return pos;
+}
 /**
  * Pack parameters into the buffer the C API expects.
  *
@@ -64,29 +130,38 @@ function encodeParamValue(value, index) {
  */
 function encodeParams(params) {
     const encoder = new TextEncoder();
-    const encoded = params.map((value, index) => value === null || value === undefined
-        ? null
-        : encoder.encode(encodeParamValue(value, index)));
+    const encoded = params.map((value, index) => encodeOne(value, index, encoder));
     let size = 4;
-    for (const bytes of encoded) {
-        size += 1 + (bytes ? 4 + bytes.length : 0);
-    }
+    for (const p of encoded)
+        size += sizeOf(p);
     const out = new Uint8Array(size);
-    const view = new DataView(out.buffer);
-    let pos = 0;
-    view.setUint32(pos, encoded.length, true);
-    pos += 4;
-    for (const bytes of encoded) {
-        if (!bytes) {
-            out[pos++] = 1; // isNull
-            continue;
+    writeParams(out, new DataView(out.buffer), 0, encoded);
+    return out;
+}
+/**
+ * Pack the parameter sets of a batch: a u32 row count, then each row's
+ * parameters exactly as encodeParams lays one set out, back to back.
+ */
+function encodeParamRows(rows) {
+    const encoder = new TextEncoder();
+    const encodedRows = rows.map((row, r) => {
+        if (!Array.isArray(row)) {
+            throw new TypeError(`Row ${r} of the batch is not an array of parameters`);
         }
-        out[pos++] = 0;
-        view.setUint32(pos, bytes.length, true);
-        pos += 4;
-        out.set(bytes, pos);
-        pos += bytes.length;
+        return row.map((value, index) => encodeOne(value, index, encoder));
+    });
+    let size = 4;
+    for (const row of encodedRows) {
+        size += 4;
+        for (const p of row)
+            size += sizeOf(p);
     }
+    const out = new Uint8Array(size);
+    const view = new DataView(out.buffer);
+    view.setUint32(0, encodedRows.length, true);
+    let pos = 4;
+    for (const row of encodedRows)
+        pos = writeParams(out, view, pos, row);
     return out;
 }
 //# sourceMappingURL=params.js.map

package/dist/browser/params.js.map

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