firebird-wasm 0.7.0 → 0.9.0

package/dist/wasm-loader.d.ts

@@ -45,6 +45,19 @@ export interface FirebirdWasmModule {
      * {@link FirebirdWasmModule._fb_last_error}.
      */
     _fb_init(): number;
+    /**
+     * End the engine for good: detach every database (rolling back what is
+     * open) and shut Firebird down.  `_fb_init` fails afterwards.  Call
+     * {@link disposeFirebirdWasm} rather than this: it also ends the threaded
+     * build's workers and lets the module go.  Returns 0, or non-zero when a
+     * detach or the shutdown failed.
+     */
+    _fb_dispose(): number;
+    /**
+     * The threaded build only: terminate its worker pool (wasm/post-threads.js).
+     * Called by {@link disposeFirebirdWasm}.
+     */
+    fbTerminateThreads?: () => void;
     /**
      * Pointer to a NUL-terminated message describing the most recent failure,
      * or to an empty string when the last call succeeded.
@@ -108,6 +121,12 @@ export interface FirebirdWasmModule {
      * Any change empties every database's cache.
      */
     _fb_statement_cache(size: number): number;
+    /**
+     * How many metadata changes (committed DDL, from any statement, procedure
+     * or attachment) the engine has seen in this module.  A database's kept
+     * statements are emptied when it moves; reads and writes never move it.
+     */
+    _fb_metadata_commits(): number;
     /**
      * 1 runs this database's autocommit SELECTs in a read-only transaction it
      * keeps open, 0 (the default) each in one of its own; returns the previous
@@ -204,8 +223,10 @@ export interface WasmLoadOptions {
      * 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.
+     * the cost of statement and idle timeouts.  `'auto'` (the default) is
+     * `false` since 0.9.0: the build without threads runs everywhere, starts in
+     * about a third of the time and was not slower in anything measured.  Pass
+     * `true` for the threaded build (Node, or a cross-origin isolated page).
      *
      * In Node this picks the file the loader requires.  In a browser the page
      * loads the glue itself, so the choice is made there:
@@ -216,22 +237,28 @@ export interface WasmLoadOptions {
 /**
  * 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.
+ * `'auto'` (the default) is the build without threads, which runs anywhere:
+ * it needs no `SharedArrayBuffer`, so no cross-origin isolation, and no
+ * Worker.  `true` is the threaded build, which a page can run only when it is
+ * cross-origin isolated; it adds statement and idle timeouts.  Until 0.9.0
+ * `'auto'` picked the threaded build where it could run.
  *
  * @example
  * ```js
  * // in the engine's Worker, before the transport loads the module
  * importScripts(`/wasm/${wasmGlueFile()}`);
+ * // threads where the page allows them
+ * importScripts(`/wasm/${wasmGlueFile(self.crossOriginIsolated)}`);
  * ```
  */
 export declare function wasmGlueFile(threads?: boolean | 'auto'): string;
 /**
  * Load the Firebird Embedded WASM module.
  *
- * The result is cached – subsequent calls return the same module instance.
+ * The result is cached – subsequent calls return the same module instance –
+ * and kept until {@link disposeFirebirdWasm}: whoever calls this owns the
+ * module.  `FirebirdBrowser` does not call it; its transport takes the module
+ * with {@link acquireFirebirdWasm}, and closing the last database disposes it.
  *
  * @param options - optional overrides for locating the WASM artefacts.
  * @returns The initialised Emscripten module with Firebird bindings.
@@ -241,9 +268,32 @@ export declare function wasmGlueFile(threads?: boolean | 'auto'): string;
  * const mod = await loadFirebirdWasm();
  * mod._fb_init();
  * const dbHandle = mod._fb_create_database(allocString(mod, '/data/test.fdb'));
+ * // …
+ * await disposeFirebirdWasm(mod);
  * ```
  */
 export declare function loadFirebirdWasm(options?: WasmLoadOptions): Promise<FirebirdWasmModule>;
+/**
+ * The module for `options`, counted as used until {@link releaseFirebirdWasm}.
+ * For transports: the last release of a module nobody loaded with
+ * {@link loadFirebirdWasm} disposes it.
+ */
+export declare function acquireFirebirdWasm(options?: WasmLoadOptions): Promise<FirebirdWasmModule>;
+/** Done with a module from {@link acquireFirebirdWasm}. */
+export declare function releaseFirebirdWasm(mod: FirebirdWasmModule): Promise<void>;
+/**
+ * End a module and let it go: every database is detached (what is open is
+ * rolled back) and the engine shut down, the threaded build's workers are
+ * terminated, the process listeners its glue added are removed, and the
+ * module leaves the cache, so its memory can be collected.  Until 0.9.0 a
+ * module stayed for the life of the process; the threaded build's worker pool
+ * alone held about 400 MB in Node.
+ *
+ * Anything still holding the module must not use it afterwards: the engine
+ * refuses (`_fb_init` fails).  The next {@link loadFirebirdWasm} loads a new
+ * one.  Idempotent.
+ */
+export declare function disposeFirebirdWasm(mod: FirebirdWasmModule): Promise<void>;
 /** Options for {@link cdnArtifacts}. */
 export interface CdnOptions {
     /** Which build; as {@link wasmGlueFile}.  Default `'auto'`. */

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":"AAAA;;;;;;;;;;GAUG;AAQH,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAChF,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAAC;IACjE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC;IAClD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACnE;AAED,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAEjC;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,WAAW,IAAI,MAAM,CAAC;IACtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC;;;;;;OAMG;IACH,cAAc,IAAI,MAAM,CAAC;IACzB,mFAAmF;IACnF,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/C,gEAAgE;IAChE,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/C,4EAA4E;IAC5E,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9C;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1E;;;;;;;OAOG;IACH,SAAS,CACP,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC;IACV;;;;;OAKG;IACH,kBAAkB,CAChB,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAAC;IACV;;;;OAIG;IACH,iBAAiB,CACf,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC;IACV;;;OAGG;IACH,gBAAgB,CACd,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC;IACV;;;;;;OAMG;IACH,sBAAsB,IAAI,MAAM,CAAC;IACjC;;;;OAIG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C;;;;OAIG;IACH,oBAAoB,IAAI,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3D;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC;;;;;;OAMG;IACH,cAAc,IAAI,MAAM,CAAC;IACzB,kFAAkF;IAClF,mBAAmB,IAAI,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,YAAY,CACV,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC;IACV;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACnE;;;;;;;OAOG;IACH,eAAe,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IACpD,gEAAgE;IAChE,iBAAiB,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAAC;IACtD,iDAAiD;IACjD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,4EAA4E;IAC5E,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAClD;;;;;;OAMG;IACH,wBAAwB,CACtB,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC;IACZ,0EAA0E;IAC1E,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IACvC,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAGzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;OAKG;IACH,MAAM,EAAE,UAAU,CAAC;IAGnB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACzE,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAGrC,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAClC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC5B;AA8BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,OAAO,GAAG,MAAe,GAAG,MAAM,CAEvE;AAWD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED,2DAA2D;AAC3D,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhF;AAgFD,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B;;;OAGG;IACH,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACpC,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0FAA0F;AAC1F,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,UAAe,GAAG,YAAY,CAanE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAGzD"}

package/dist/wasm-loader.js

@@ -13,42 +13,40 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wasmGlueFile = wasmGlueFile;
 exports.loadFirebirdWasm = loadFirebirdWasm;
+exports.acquireFirebirdWasm = acquireFirebirdWasm;
+exports.releaseFirebirdWasm = releaseFirebirdWasm;
+exports.disposeFirebirdWasm = disposeFirebirdWasm;
 exports.cdnArtifacts = cdnArtifacts;
 exports.hasSharedHeap = hasSharedHeap;
 exports.allocString = allocString;
 exports.lastError = lastError;
 const version_1 = require("./version");
-// ---------------------------------------------------------------------------
-// Module state
-// ---------------------------------------------------------------------------
-/** One module per build: the two can live side by side in one process. */
 const cachedModules = new Map();
+/** Loads one at a time, so each knows which process listeners are its own. */
+let loading = Promise.resolve();
 /**
  * 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.
+ * `'auto'` (the default) is the build without threads, which runs anywhere:
+ * it needs no `SharedArrayBuffer`, so no cross-origin isolation, and no
+ * Worker.  `true` is the threaded build, which a page can run only when it is
+ * cross-origin isolated; it adds statement and idle timeouts.  Until 0.9.0
+ * `'auto'` picked the threaded build where it could run.
  *
  * @example
  * ```js
  * // in the engine's Worker, before the transport loads the module
  * importScripts(`/wasm/${wasmGlueFile()}`);
+ * // threads where the page allows them
+ * importScripts(`/wasm/${wasmGlueFile(self.crossOriginIsolated)}`);
  * ```
  */
 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;
+    // 'auto' and undefined: the build without threads, everywhere.
+    return threads === true;
 }
 // ---------------------------------------------------------------------------
 // Public API
@@ -56,7 +54,10 @@ function useThreads(threads) {
 /**
  * Load the Firebird Embedded WASM module.
  *
- * The result is cached – subsequent calls return the same module instance.
+ * The result is cached – subsequent calls return the same module instance –
+ * and kept until {@link disposeFirebirdWasm}: whoever calls this owns the
+ * module.  `FirebirdBrowser` does not call it; its transport takes the module
+ * with {@link acquireFirebirdWasm}, and closing the last database disposes it.
  *
  * @param options - optional overrides for locating the WASM artefacts.
  * @returns The initialised Emscripten module with Firebird bindings.
@@ -66,13 +67,86 @@ function useThreads(threads) {
  * const mod = await loadFirebirdWasm();
  * mod._fb_init();
  * const dbHandle = mod._fb_create_database(allocString(mod, '/data/test.fdb'));
+ * // …
+ * await disposeFirebirdWasm(mod);
  * ```
  */
 async function loadFirebirdWasm(options = {}) {
+    const entry = moduleEntry(options);
+    entry.pinned = true;
+    return entry.module;
+}
+/**
+ * The module for `options`, counted as used until {@link releaseFirebirdWasm}.
+ * For transports: the last release of a module nobody loaded with
+ * {@link loadFirebirdWasm} disposes it.
+ */
+async function acquireFirebirdWasm(options = {}) {
+    const entry = moduleEntry(options);
+    entry.users++;
+    try {
+        return await entry.module;
+    }
+    catch (err) {
+        entry.users--;
+        throw err;
+    }
+}
+/** Done with a module from {@link acquireFirebirdWasm}. */
+async function releaseFirebirdWasm(mod) {
+    const entry = [...cachedModules.values()].find((e) => e.loaded === mod);
+    if (!entry)
+        return; // disposed already
+    entry.users = Math.max(0, entry.users - 1);
+    if (entry.users === 0 && !entry.pinned)
+        await disposeFirebirdWasm(mod);
+}
+/**
+ * End a module and let it go: every database is detached (what is open is
+ * rolled back) and the engine shut down, the threaded build's workers are
+ * terminated, the process listeners its glue added are removed, and the
+ * module leaves the cache, so its memory can be collected.  Until 0.9.0 a
+ * module stayed for the life of the process; the threaded build's worker pool
+ * alone held about 400 MB in Node.
+ *
+ * Anything still holding the module must not use it afterwards: the engine
+ * refuses (`_fb_init` fails).  The next {@link loadFirebirdWasm} loads a new
+ * one.  Idempotent.
+ */
+async function disposeFirebirdWasm(mod) {
+    const entry = [...cachedModules.values()].find((e) => e.loaded === mod);
+    if (entry)
+        cachedModules.delete(entry.glueFile);
+    mod._fb_dispose?.();
+    mod.fbTerminateThreads?.();
+    const proc = nodeProcess();
+    for (const [event, listener] of entry?.listeners ?? [])
+        proc?.removeListener(event, listener);
+}
+function moduleEntry(options) {
     const glueFile = wasmGlueFile(options.threads);
-    const cached = cachedModules.get(glueFile);
-    if (cached)
-        return cached;
+    let entry = cachedModules.get(glueFile);
+    if (!entry) {
+        const created = { glueFile, module: Promise.resolve(null), users: 0, pinned: false, listeners: [] };
+        const load = loading.catch(() => undefined).then(() => loadModule(glueFile, options, created));
+        loading = load;
+        created.module = load;
+        created.module.catch(() => {
+            // A failed load is not kept: the next call tries again.
+            if (cachedModules.get(glueFile) === created)
+                cachedModules.delete(glueFile);
+        });
+        cachedModules.set(glueFile, created);
+        entry = created;
+    }
+    return entry;
+}
+const LISTENED = ['uncaughtException', 'unhandledRejection', 'exit'];
+function nodeProcess() {
+    const proc = globalThis['process'];
+    return typeof proc?.listeners === 'function' && typeof proc.removeListener === 'function' ? proc : undefined;
+}
+async function loadModule(glueFile, options, entry) {
     // 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
@@ -99,8 +173,19 @@ async function loadFirebirdWasm(options = {}) {
             moduleOptions['wasmBinary'] = options.wasmBinary;
         }
     }
+    // The glue adds process listeners in Node (the threaded build an
+    // uncaughtException handler), which hold the whole module: note them so a
+    // dispose can take them off.
+    const proc = nodeProcess();
+    const before = new Map(LISTENED.map((event) => [event, new Set(proc?.listeners(event) ?? [])]));
     const mod = await factory(moduleOptions);
-    cachedModules.set(glueFile, mod);
+    for (const event of LISTENED) {
+        for (const listener of proc?.listeners(event) ?? []) {
+            if (!before.get(event).has(listener))
+                entry.listeners.push([event, listener]);
+        }
+    }
+    entry.loaded = mod;
     return mod;
 }
 /**

package/dist/wasm-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-loader.js","sourceRoot":"","sources":["../src/wasm-loader.ts"],"names":[],"mappings":"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"}
+{"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.7.0",
+  "version": "0.9.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",
@@ -13,7 +13,32 @@
     "./browser": {
       "types": "./dist/browser/index.d.ts",
       "default": "./dist/browser/index.js"
-    }
+    },
+    "./browser/worker-entry": {
+      "types": "./dist/browser/worker-entry.d.ts",
+      "default": "./dist/browser/worker-entry.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "default": "./dist/vue/index.js"
+    },
+    "./repl": {
+      "types": "./dist/repl/index.d.ts",
+      "default": "./dist/repl/index.js"
+    },
+    "./electric": {
+      "types": "./dist/electric/index.d.ts",
+      "default": "./dist/electric/index.js"
+    },
+    "./electric-server": {
+      "types": "./dist/electric-server/index.d.ts",
+      "default": "./dist/electric-server/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -40,15 +65,37 @@
   "dependencies": {
     "node-firebird-driver": "^3.5.0"
   },
+  "peerDependencies": {
+    "react": ">=18",
+    "vue": ">=3.3",
+    "@electric-sql/client": ">=1.5"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "@electric-sql/client": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@electric-sql/client": "^1.5.28",
     "@types/jest": "^29.5.12",
     "@types/node": "^20.14.10",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
     "@typescript-eslint/eslint-plugin": "^7.17.0",
     "@typescript-eslint/parser": "^7.17.0",
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "ts-jest": "^29.2.2",
-    "typescript": "^5.5.3"
+    "typescript": "^5.5.3",
+    "vue": "^3.5.22"
   },
   "jest": {
     "preset": "ts-jest",