firebird-wasm 0.6.0 → 0.7.0

package/dist/wasm-loader.d.ts

@@ -115,6 +115,12 @@ export interface FirebirdWasmModule {
      * in its own transaction.
      */
     _fb_read_transaction(dbHandle: number, on: number): number;
+    /**
+     * The columns of a kept statement's shape, `{"columns":[...]}`, for a
+     * result that named them by id (`{"shape":N,...}`); 0 if no kept statement
+     * has that shape any more. Free with `_fb_free_result`.
+     */
+    _fb_shape_columns(id: number): number;
     /**
      * Pointer to the binary BLOB side buffer for the most recent query, or 0.
      *
@@ -193,7 +199,35 @@ export interface WasmLoadOptions {
      * automatically (e.g. bundled browser apps).
      */
     locateFile?: (filename: string) => string;
+    /**
+     * Which build to load.  `true` is `firebird-embedded.js`: pthreads over Web
+     * Workers, whose heap is a `SharedArrayBuffer` and which a browser gives
+     * only to a cross-origin isolated page.  `false` is
+     * `firebird-embedded-st.js`: no threads and a plain `ArrayBuffer` heap, at
+     * the cost of statement and idle timeouts.  `'auto'` (the default) is `true`
+     * in Node.
+     *
+     * In Node this picks the file the loader requires.  In a browser the page
+     * loads the glue itself, so the choice is made there:
+     * {@link wasmGlueFile} names the file to load.
+     */
+    threads?: boolean | 'auto';
 }
+/**
+ * The glue script of the build `threads` selects.
+ *
+ * `'auto'` (the default) picks the threaded build where it can run: in Node,
+ * and in a browser page or worker that is cross-origin isolated.  Elsewhere,
+ * GitHub Pages and other static hosts that cannot send COOP/COEP among them,
+ * it picks the build without threads, which needs neither.
+ *
+ * @example
+ * ```js
+ * // in the engine's Worker, before the transport loads the module
+ * importScripts(`/wasm/${wasmGlueFile()}`);
+ * ```
+ */
+export declare function wasmGlueFile(threads?: boolean | 'auto'): string;
 /**
  * Load the Firebird Embedded WASM module.
  *
@@ -210,6 +244,54 @@ export interface WasmLoadOptions {
  * ```
  */
 export declare function loadFirebirdWasm(options?: WasmLoadOptions): Promise<FirebirdWasmModule>;
+/** Options for {@link cdnArtifacts}. */
+export interface CdnOptions {
+    /** Which build; as {@link wasmGlueFile}.  Default `'auto'`. */
+    threads?: boolean | 'auto';
+    /**
+     * `'jsdelivr'` (the default), `'unpkg'`, or the base URL of a directory
+     * holding the four artifacts, such as a mirror of `dist/wasm/`.
+     */
+    cdn?: 'jsdelivr' | 'unpkg' | string;
+    /** The package version to load.  Default: this package's own. */
+    version?: string;
+}
+/** Where to load the engine from: the glue script, and a `locateFile` for its `.wasm`. */
+export interface CdnArtifacts {
+    /** URL of the glue script, for `importScripts()` or a `<script src>`. */
+    glueUrl: string;
+    /** Pass to `FirebirdBrowser`, `DirectTransport` or `FIREBIRD_WORKER_OPTIONS`. */
+    locateFile: (file: string) => string;
+}
+/**
+ * The engine's URLs on a CDN, so nothing has to be copied next to the app.
+ *
+ * Emscripten finds the `.wasm` next to the script that loaded the glue.  Glue
+ * pulled into a Worker with `importScripts()` sees the *Worker's* URL instead,
+ * so without a `locateFile` it fetches the binary from the app's own origin;
+ * this pairs the glue's URL with one that points at the CDN.  The URLs name
+ * this package's exact version by default, so the glue and the TypeScript
+ * calling it always match.
+ *
+ * Both builds load this way.  jsDelivr and unpkg send
+ * `Cross-Origin-Resource-Policy: cross-origin`, which a cross-origin isolated
+ * page needs for the threaded build; the threaded build's own workers start
+ * from the Worker's script, which must be on the app's origin.
+ *
+ * @example
+ * ```js
+ * // the engine Worker, on the app's own origin
+ * const { glueUrl, locateFile } = cdnArtifacts();
+ * importScripts(glueUrl);
+ * self.FIREBIRD_WORKER_OPTIONS = { locateFile };
+ * ```
+ */
+export declare function cdnArtifacts(options?: CdnOptions): CdnArtifacts;
+/**
+ * True when the module's heap is a `SharedArrayBuffer`, which is the case for
+ * the threaded build only.
+ */
+export declare function hasSharedHeap(mod: FirebirdWasmModule): boolean;
 /**
  * Allocate a UTF-8 C string on the WASM heap and return its pointer.
  * The caller is responsible for calling `mod._free(ptr)` afterwards.

package/dist/wasm-loader.d.ts.map

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

package/dist/wasm-loader.js

@@ -11,13 +11,45 @@
  *      library.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.wasmGlueFile = wasmGlueFile;
 exports.loadFirebirdWasm = loadFirebirdWasm;
+exports.cdnArtifacts = cdnArtifacts;
+exports.hasSharedHeap = hasSharedHeap;
 exports.allocString = allocString;
 exports.lastError = lastError;
+const version_1 = require("./version");
 // ---------------------------------------------------------------------------
 // Module state
 // ---------------------------------------------------------------------------
-let cachedModule = null;
+/** One module per build: the two can live side by side in one process. */
+const cachedModules = new Map();
+/**
+ * The glue script of the build `threads` selects.
+ *
+ * `'auto'` (the default) picks the threaded build where it can run: in Node,
+ * and in a browser page or worker that is cross-origin isolated.  Elsewhere,
+ * GitHub Pages and other static hosts that cannot send COOP/COEP among them,
+ * it picks the build without threads, which needs neither.
+ *
+ * @example
+ * ```js
+ * // in the engine's Worker, before the transport loads the module
+ * importScripts(`/wasm/${wasmGlueFile()}`);
+ * ```
+ */
+function wasmGlueFile(threads = 'auto') {
+    return useThreads(threads) ? 'firebird-embedded.js' : 'firebird-embedded-st.js';
+}
+function useThreads(threads) {
+    if (threads === true || threads === false)
+        return threads;
+    const g = globalThis;
+    if (typeof g['process'] !== 'undefined' && typeof g['window'] === 'undefined'
+        && typeof g['WorkerGlobalScope'] === 'undefined') {
+        return true;
+    }
+    return g['crossOriginIsolated'] === true;
+}
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
@@ -37,13 +69,24 @@ let cachedModule = null;
  * ```
  */
 async function loadFirebirdWasm(options = {}) {
-    if (cachedModule)
-        return cachedModule;
+    const glueFile = wasmGlueFile(options.threads);
+    const cached = cachedModules.get(glueFile);
+    if (cached)
+        return cached;
     // The Emscripten glue script exports a factory function named
     // `createFirebirdModule` (configured via `-s EXPORT_NAME` in CMake).
     // In Node it can be `require()`-d; in browsers it is expected to be
     // available on `globalThis` or loaded via a <script> tag / importmap.
-    const factory = await resolveFactory(options);
+    const factory = await resolveFactory(glueFile);
+    // Each build marks its factory (wasm/glue-threads.js, wasm/glue-st.js).
+    // The threaded one cannot run without SharedArrayBuffer: its runtime fails
+    // to hand its memory to its own workers, the error is not reported to the
+    // caller, and every call waits forever.  Say so instead.
+    if (factory.threads === true && globalThis['crossOriginIsolated'] === false) {
+        throw new Error('firebird-embedded.js is the threaded build, which needs SharedArrayBuffer, and this page is ' +
+            'not cross-origin isolated (it needs COOP/COEP headers).  Load firebird-embedded-st.js, the ' +
+            'build without threads, instead: wasmGlueFile() names the build a page can run.');
+    }
     const moduleOptions = {};
     if (options.locateFile) {
         moduleOptions['locateFile'] = options.locateFile;
@@ -57,9 +100,52 @@ async function loadFirebirdWasm(options = {}) {
         }
     }
     const mod = await factory(moduleOptions);
-    cachedModule = mod;
+    cachedModules.set(glueFile, mod);
     return mod;
 }
+/**
+ * The engine's URLs on a CDN, so nothing has to be copied next to the app.
+ *
+ * Emscripten finds the `.wasm` next to the script that loaded the glue.  Glue
+ * pulled into a Worker with `importScripts()` sees the *Worker's* URL instead,
+ * so without a `locateFile` it fetches the binary from the app's own origin;
+ * this pairs the glue's URL with one that points at the CDN.  The URLs name
+ * this package's exact version by default, so the glue and the TypeScript
+ * calling it always match.
+ *
+ * Both builds load this way.  jsDelivr and unpkg send
+ * `Cross-Origin-Resource-Policy: cross-origin`, which a cross-origin isolated
+ * page needs for the threaded build; the threaded build's own workers start
+ * from the Worker's script, which must be on the app's origin.
+ *
+ * @example
+ * ```js
+ * // the engine Worker, on the app's own origin
+ * const { glueUrl, locateFile } = cdnArtifacts();
+ * importScripts(glueUrl);
+ * self.FIREBIRD_WORKER_OPTIONS = { locateFile };
+ * ```
+ */
+function cdnArtifacts(options = {}) {
+    const version = options.version ?? version_1.VERSION;
+    const cdn = options.cdn ?? 'jsdelivr';
+    const base = cdn === 'jsdelivr'
+        ? `https://cdn.jsdelivr.net/npm/firebird-wasm@${version}/dist/wasm/`
+        : cdn === 'unpkg'
+            ? `https://unpkg.com/firebird-wasm@${version}/dist/wasm/`
+            : cdn.endsWith('/') ? cdn : `${cdn}/`;
+    return {
+        glueUrl: base + wasmGlueFile(options.threads),
+        locateFile: (file) => base + file,
+    };
+}
+/**
+ * True when the module's heap is a `SharedArrayBuffer`, which is the case for
+ * the threaded build only.
+ */
+function hasSharedHeap(mod) {
+    return typeof SharedArrayBuffer !== 'undefined' && mod.HEAPU8.buffer instanceof SharedArrayBuffer;
+}
 /**
  * Allocate a UTF-8 C string on the WASM heap and return its pointer.
  * The caller is responsible for calling `mod._free(ptr)` afterwards.
@@ -80,16 +166,22 @@ function lastError(mod) {
     const ptr = mod._fb_last_error();
     return ptr ? mod.UTF8ToString(ptr) : '';
 }
-async function resolveFactory(_options) {
+async function resolveFactory(glueFile) {
     // Node.js environment
     if (typeof globalThis !== 'undefined' && typeof globalThis['process'] !== 'undefined') {
         try {
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            const glue = require('../dist/wasm/firebird-embedded.js');
+            // Two literal requires, not one with the name in a template: a bundler
+            // resolves string literals (and marks these external), but turns a
+            // template into a glob over dist/wasm, .wasm files included.
+            const glue = glueFile === 'firebird-embedded-st.js'
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                ? require('../dist/wasm/firebird-embedded-st.js')
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                : require('../dist/wasm/firebird-embedded.js');
             return glue;
         }
         catch {
-            throw new Error('firebird-embedded.js not found.  Run the WASM build first: packages/firebird-wasm/wasm/build.sh');
+            throw new Error(`${glueFile} not found.  Run the WASM build first: packages/firebird-wasm/wasm/build.sh`);
         }
     }
     // Browser environment – look on globalThis

package/dist/wasm-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-loader.js","sourceRoot":"","sources":["../src/wasm-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA0PH,4CA4BC;AAMD,kCAKC;AAQD,8BAGC;AA3ED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,IAAI,YAAY,GAA8B,IAAI,CAAC;AAEnD,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,gBAAgB,CACpC,UAA2B,EAAE;IAE7B,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,8DAA8D;IAC9D,qEAAqE;IACrE,oEAAoE;IACpE,sEAAsE;IACtE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,aAAa,GAA4B,EAAE,CAAC;IAElD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IACnD,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC3C,aAAa,CAAC,YAAY,CAAC,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,UAAoB,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAuB,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7D,YAAY,GAAG,GAAG,CAAC;IACnB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,GAAuB,EAAE,GAAW;IAC9D,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,GAAuB;IAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IACjC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC;AAQD,KAAK,UAAU,cAAc,CAAC,QAAyB;IACrD,sBAAsB;IACtB,IAAI,OAAO,UAAU,KAAK,WAAW,IAAI,OAAQ,UAAsC,CAAC,SAAS,CAAC,KAAK,WAAW,EAAE,CAAC;QACnH,IAAI,CAAC;YACH,8DAA8D;YAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,mCAAmC,CAAC,CAAC;YAC1D,OAAO,IAAqB,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,MAAM,CAAC,GAAG,UAAqC,CAAC;IAChD,IAAI,OAAO,CAAC,CAAC,sBAAsB,CAAC,KAAK,UAAU,EAAE,CAAC;QACpD,OAAO,CAAC,CAAC,sBAAsB,CAAkB,CAAC;IACpD,CAAC;IAED,MAAM,IAAI,KAAK,CACb,8CAA8C;QAC5C,8FAA8F,CACjG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"wasm-loader.js","sourceRoot":"","sources":["../src/wasm-loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebird-wasm",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Firebird embedded database in WebAssembly — runs in the browser and Node, like PGlite for PostgreSQL",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,6 +20,8 @@
     "build:wasm": "bash wasm/build.sh",
     "test": "jest --forceExit",
     "bench": "node bench/decode-bench.js",
+    "bench:calls": "node bench/call-cost.js",
+    "size": "node scripts/size-budget.mjs",
     "lint": "eslint src --ext .ts",
     "clean": "rm -rf dist",
     "prepublishOnly": "node scripts/check-publish.mjs"

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

@@ -1,18 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,39 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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"}