@lix-js/sdk 0.12.1 → 0.12.3

package/README.md

@@ -155,6 +155,9 @@ try {
 - The package uses conditional ESM imports internally: Node.js resolves the
   native N-API binding, while browsers and other runtimes resolve the portable
   WebAssembly binding. Vite follows this split without consumer configuration.
+- If the native addon cannot load in Node.js, in-memory Lix instances fall back
+  to the bundled WebAssembly engine. Filesystem storage and Component API v1
+  plugin execution still require the native addon.
 - Every browser `openLix()` owns one dedicated worker, so database work does
   not block the page's main thread. Node.js uses the native binding's actor.
 - Node.js executes installed Component API v1 plugins with the Rust SDK's

package/dist/binding.node-wasm.d.ts

@@ -0,0 +1,2 @@
+import type { LixBinding, TelemetryDispatch } from "./binding-types.js";
+export declare function openMemoryWasmBinding(telemetry?: TelemetryDispatch): Promise<LixBinding>;

package/dist/binding.node-wasm.js

@@ -0,0 +1,14 @@
+import { readFile } from "node:fs/promises";
+// Generated before TypeScript compilation and emitted beside this module.
+// @ts-expect-error Generated by build:wasm.
+import initWasm, { openMemory } from "./wasm/lix_js_sdk.js";
+let wasmInitialized;
+function initializeWasm() {
+    return (wasmInitialized ??= initWasm({
+        module_or_path: readFile(new URL("./wasm/lix_js_sdk_bg.wasm", import.meta.url)),
+    }));
+}
+export async function openMemoryWasmBinding(telemetry) {
+    await initializeWasm();
+    return openMemory(telemetry);
+}

package/dist/binding.node.d.ts

@@ -1,2 +1,3 @@
 import type { LixStorageConfig, LixBinding, TelemetryDispatch } from "./binding-types.js";
 export declare function openLixBinding(storage: LixStorageConfig, telemetry?: TelemetryDispatch): Promise<LixBinding>;
+export declare function openNativeLixBinding(storage: LixStorageConfig, telemetry?: TelemetryDispatch): Promise<LixBinding>;

package/dist/binding.node.js

@@ -29,31 +29,62 @@ function resolveNativePath() {
     throw packageResolutionError;
 }
 let addon;
-try {
-    addon = require(resolveNativePath());
+let addonLoadError;
+function loadNativeAddon() {
+    if (addon)
+        return addon;
+    if (addonLoadError)
+        throw addonLoadError;
+    try {
+        addon = require(resolveNativePath());
+        return addon;
+    }
+    catch (cause) {
+        const error = new Error(`Failed to load @lix-js/sdk native addon for ${process.platform}-${process.arch}. ` +
+            "This package requires the matching optional native binary package. " +
+            "Run `npm run build` from packages/js-sdk for local development, or install a release that includes your platform binary.", { cause });
+        addonLoadError = error;
+        throw error;
+    }
 }
-catch (cause) {
-    const error = new Error(`Failed to load @lix-js/sdk native addon for ${process.platform}-${process.arch}. ` +
-        "This package requires the matching optional native binary package. " +
-        "Run `npm run build` from packages/js-sdk for local development, or install a release that includes your platform binary.");
-    error.cause = cause;
-    throw error;
+export async function openLixBinding(storage, telemetry) {
+    try {
+        return await openNativeLixBinding(storage, telemetry);
+    }
+    catch (nativeError) {
+        if (storage.kind !== "memory")
+            throw nativeError;
+        try {
+            const { openMemoryWasmBinding } = await import("./binding.node-wasm.js");
+            return await openMemoryWasmBinding(telemetry);
+        }
+        catch (wasmError) {
+            throw new AggregateError([nativeError, wasmError], "Failed to open in-memory Lix with either the native or WebAssembly binding.");
+        }
+    }
 }
-export function openLixBinding(storage, telemetry) {
-    const nativeTelemetry = telemetry
-        ? (spanJson) => telemetry(JSON.parse(spanJson))
-        : undefined;
+export async function openNativeLixBinding(storage, telemetry) {
     switch (storage.kind) {
-        case "memory":
+        case "memory": {
+            const nativeAddon = loadNativeAddon();
+            const nativeTelemetry = telemetry
+                ? (spanJson) => telemetry(JSON.parse(spanJson))
+                : undefined;
             if (nativeTelemetry)
-                return addon.Lix.openMemory(nativeTelemetry);
-            return addon.Lix.openMemory();
+                return nativeAddon.Lix.openMemory(nativeTelemetry);
+            return nativeAddon.Lix.openMemory();
+        }
         case "indexedDb":
             throw new Error("IndexedDbStorage is only available in browsers");
-        case "filesystem":
+        case "filesystem": {
+            const nativeAddon = loadNativeAddon();
+            const nativeTelemetry = telemetry
+                ? (spanJson) => telemetry(JSON.parse(spanJson))
+                : undefined;
             if (nativeTelemetry) {
-                return addon.Lix.openFilesystemStorage(storage.path, storage.syncAllFiles, nativeTelemetry);
+                return nativeAddon.Lix.openFilesystemStorage(storage.path, storage.syncAllFiles, nativeTelemetry);
             }
-            return addon.Lix.openFilesystemStorage(storage.path, storage.syncAllFiles);
+            return nativeAddon.Lix.openFilesystemStorage(storage.path, storage.syncAllFiles);
+        }
     }
 }

package/dist/lix.js

@@ -118,7 +118,10 @@ export class Lix {
     async close() {
         if (!this.closePromise) {
             if (this.#transactionsOpening > 0 || this.#activeTransactions > 0) {
-                throw activeTransactionCloseError();
+                const error = new Error("cannot close Lix while an explicit transaction is active");
+                error.name = "LixError";
+                error.code = "LIX_INVALID_TRANSACTION_STATE";
+                throw error;
             }
             // Flip the public lifecycle gate before the first await. Operations that
             // already entered the gate are allowed to finish; later calls fail closed.
@@ -161,12 +164,6 @@ export class Lix {
         throw error;
     }
 }
-function activeTransactionCloseError() {
-    const error = new Error("cannot close Lix while an explicit transaction is active");
-    error.name = "LixError";
-    error.code = "LIX_INVALID_TRANSACTION_STATE";
-    return error;
-}
 export class ObserveEvents {
     onClose;
     setup = {};

package/dist/remote/server-protocol.js

@@ -265,9 +265,6 @@ export function record(value, description) {
     }
     return value;
 }
-function isRecord(value) {
-    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
 function decodeWireValue(value) {
     const wire = record(value, "wire value");
     switch (wire.kind) {

package/dist/wasm/lix_js_sdk.d.ts

@@ -78,8 +78,8 @@ export interface InitOutput {
     readonly wasmlixtransaction_rollback: (a: number) => number;
     readonly wasmobserveevents_close: (a: number) => void;
     readonly wasmobserveevents_next: (a: number) => number;
-    readonly __wasm_bindgen_func_elem_119237: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_119239: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_119238: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_119240: (a: number, b: number, c: number, d: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/dist/wasm/lix_js_sdk.js

@@ -362,7 +362,7 @@ function __wbg_get_imports() {
         __wbg__wbg_cb_unref_61db23ac97f16c31: function(arg0) {
             getObject(arg0)._wbg_cb_unref();
         },
-        __wbg_applyChanges_e055d59b63743afd: function(arg0, arg1) {
+        __wbg_applyChanges_fa5b3bf30f8b61a3: function(arg0, arg1) {
             const ret = getObject(arg0).applyChanges(takeObject(arg1));
             return addHeapObject(ret);
         },
@@ -374,7 +374,7 @@ function __wbg_get_imports() {
             const ret = getObject(arg0).call(getObject(arg1), getObject(arg2));
             return addHeapObject(ret);
         }, arguments); },
-        __wbg_close_93c7ea4f94bb464a: function(arg0) {
+        __wbg_close_65d6792c6f40ad89: function(arg0) {
             const ret = getObject(arg0).close();
             return addHeapObject(ret);
         },
@@ -481,7 +481,7 @@ function __wbg_get_imports() {
             const ret = getObject(arg0).length;
             return ret;
         },
-        __wbg_loadEntries_7336ebc0a13d5ac7: function(arg0) {
+        __wbg_loadEntries_032470abc2177798: function(arg0) {
             const ret = getObject(arg0).loadEntries();
             return addHeapObject(ret);
         },
@@ -520,7 +520,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_119239(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_119240(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -634,8 +634,8 @@ function __wbg_get_imports() {
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 28427, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_119237);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 28366, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, __wasm_bindgen_func_elem_119238);
             return addHeapObject(ret);
         },
         __wbindgen_cast_0000000000000002: function(arg0) {
@@ -684,10 +684,10 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_119237(arg0, arg1, arg2) {
+function __wasm_bindgen_func_elem_119238(arg0, arg1, arg2) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.__wasm_bindgen_func_elem_119237(retptr, arg0, arg1, addHeapObject(arg2));
+        wasm.__wasm_bindgen_func_elem_119238(retptr, arg0, arg1, addHeapObject(arg2));
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         if (r1) {
@@ -698,8 +698,8 @@ function __wasm_bindgen_func_elem_119237(arg0, arg1, arg2) {
     }
 }
 
-function __wasm_bindgen_func_elem_119239(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_119239(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+function __wasm_bindgen_func_elem_119240(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_119240(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
 }
 
 const WasmLixFinalization = (typeof FinalizationRegistry === 'undefined')

package/dist/wasm/lix_js_sdk_bg.wasm.d.ts

@@ -28,8 +28,8 @@ export const wasmlixtransaction_execute: (a: number, b: number, c: number, d: nu
 export const wasmlixtransaction_rollback: (a: number) => number;
 export const wasmobserveevents_close: (a: number) => void;
 export const wasmobserveevents_next: (a: number) => number;
-export const __wasm_bindgen_func_elem_119237: (a: number, b: number, c: number, d: number) => void;
-export const __wasm_bindgen_func_elem_119239: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_119238: (a: number, b: number, c: number, d: number) => void;
+export const __wasm_bindgen_func_elem_119240: (a: number, b: number, c: number, d: number) => void;
 export const __wbindgen_export: (a: number, b: number) => number;
 export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_export3: (a: number) => void;

package/dist/worker/client.js

@@ -37,28 +37,30 @@ export async function openLixWorkerBinding(storage, onDisposed, telemetry) {
             }
             : undefined;
         const binding = await openDirectLixBinding(storage, telemetryDispatch);
-        if (!onDisposed)
-            return binding;
-        let disposed = false;
-        return new Proxy(binding, {
-            get(target, property, receiver) {
-                if (property === "close") {
-                    return async () => {
-                        try {
-                            await target.close();
-                        }
-                        finally {
-                            if (!disposed) {
-                                disposed = true;
-                                onDisposed();
+        if (binding) {
+            if (!onDisposed)
+                return binding;
+            let disposed = false;
+            return new Proxy(binding, {
+                get(target, property, receiver) {
+                    if (property === "close") {
+                        return async () => {
+                            try {
+                                await target.close();
                             }
-                        }
-                    };
+                            finally {
+                                if (!disposed) {
+                                    disposed = true;
+                                    onDisposed();
+                                }
+                            }
+                        };
+                    }
+                    const value = Reflect.get(target, property, receiver);
+                    return typeof value === "function" ? value.bind(target) : value;
                 }
-                const value = Reflect.get(target, property, receiver);
-                return typeof value === "function" ? value.bind(target) : value;
-            },
-        });
+            });
+        }
     }
     const client = await openLixWorker(storage, onDisposed, telemetry);
     return workerBinding(client);

package/dist/worker/factory.node.d.ts

@@ -1,4 +1,5 @@
 import type { LixBinding, LixStorageConfig, TelemetryDispatch } from "../binding-types.js";
 import type { WorkerConnection } from "./protocol.js";
 export declare function createWorkerConnection(): WorkerConnection;
-export declare const openDirectLixBinding: (storage: LixStorageConfig, telemetry?: TelemetryDispatch) => Promise<LixBinding>;
+export declare function workerExecArgv(execArgv: readonly string[]): string[];
+export declare const openDirectLixBinding: (storage: LixStorageConfig, telemetry?: TelemetryDispatch) => Promise<LixBinding | undefined>;

package/dist/worker/factory.node.js

@@ -1,8 +1,9 @@
 import { Worker } from "node:worker_threads";
-import { openLixBinding } from "../binding.node.js";
+import { openNativeLixBinding } from "../binding.node.js";
 export function createWorkerConnection() {
     const worker = new Worker(new URL("./entry.node.js", import.meta.url), {
         name: "lix",
+        execArgv: workerExecArgv(process.execArgv),
     });
     let terminating = false;
     return {
@@ -34,7 +35,30 @@ export function createWorkerConnection() {
         },
     };
 }
+export function workerExecArgv(execArgv) {
+    const filtered = [];
+    for (let index = 0; index < execArgv.length; index++) {
+        const arg = execArgv[index];
+        if (arg === "--input-type") {
+            index += 1;
+            continue;
+        }
+        if (arg === "--expose-gc" || arg.startsWith("--input-type="))
+            continue;
+        filtered.push(arg);
+    }
+    return filtered;
+}
 /// Native Lix already owns a dedicated serialized engine actor. Routing it
 /// through a second JavaScript worker adds two message-port hops per query
 /// without adding isolation or concurrency.
-export const openDirectLixBinding = (storage, telemetry) => openLixBinding(storage, telemetry);
+export const openDirectLixBinding = async (storage, telemetry) => {
+    try {
+        return await openNativeLixBinding(storage, telemetry);
+    }
+    catch (error) {
+        if (storage.kind === "memory")
+            return undefined;
+        throw error;
+    }
+};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@lix-js/sdk",
 	"type": "module",
-	"version": "0.12.1",
+	"version": "0.12.3",
 	"license": "MIT",
 	"repository": {
 		"type": "git",
@@ -53,10 +53,10 @@
 		"typecheck": "tsc -p tsconfig.test.json --noEmit"
 	},
 	"optionalDependencies": {
-		"@lix-js/sdk-darwin-arm64": "0.12.1",
-		"@lix-js/sdk-linux-arm64": "0.12.1",
-		"@lix-js/sdk-linux-x64": "0.12.1",
-		"@lix-js/sdk-win32-x64": "0.12.1"
+		"@lix-js/sdk-darwin-arm64": "0.12.3",
+		"@lix-js/sdk-linux-arm64": "0.12.3",
+		"@lix-js/sdk-linux-x64": "0.12.3",
+		"@lix-js/sdk-win32-x64": "0.12.3"
 	},
 	"devDependencies": {
 		"@vitest/browser-playwright": "4.1.10",