@lix-js/sdk 0.16.1 → 0.17.0

package/dist/worker/shared-engine.js

@@ -0,0 +1,194 @@
+import { fetchTransport, HttpTransportError } from "../http-transport.js";
+/** One physical owner; ports receive independent sessions, never the root. */
+export class SharedEngineOwner {
+    open;
+    root;
+    principalId;
+    state = "closed";
+    get lifecycleState() { return this.state; }
+    clients = new Set();
+    queue = Promise.resolve();
+    constructor(open) {
+        this.open = open;
+    }
+    backgroundTelemetry = span => {
+        for (const client of this.clients) {
+            try {
+                client.telemetry?.(span);
+            }
+            catch { /* Host telemetry cannot interrupt engine work. */ }
+        }
+    };
+    attach(client) {
+        const operation = this.queue.then(async () => {
+            if (client.isDisconnected?.())
+                throw new Error("Shared engine client disconnected before admission");
+            // Admission precedes storage opening and captures initial credentials.
+            if (this.state === "closing")
+                throw new HttpTransportError("LIX_OWNER_CLOSE_FAILED", "Storage owner has not completed closing");
+            const identity = await client.verifyIdentity();
+            if (client.isDisconnected?.())
+                throw new HttpTransportError("LIX_TRANSPORT_UNAVAILABLE", "Client disconnected during admission");
+            if (identity.authorityUrl !== client.server.url)
+                throw new HttpTransportError("LIX_SHARED_ENGINE_IDENTITY_MISMATCH", "Admission authority does not match this client");
+            const opensRoot = this.root === undefined;
+            if (!this.root) {
+                this.state = "opening";
+                const originalServer = client.server;
+                const headers = identity.headers;
+                // Bind native admission to the exact credentials actually used during
+                // opening; a later dynamic-header read cannot authorize another principal.
+                client.server = { ...originalServer, headers, headerProvider: identity.online === false
+                        ? async () => { throw new HttpTransportError("LIX_IDENTITY_UNVERIFIED_OFFLINE", "Cached local admission does not authorize remote requests"); }
+                        : undefined };
+                this.clients.add(client);
+                try {
+                    this.root = await this.open(this.transport(), this.backgroundTelemetry, client);
+                    const principal = await this.root.activeAccountId();
+                    if (principal !== identity.accountId)
+                        throw new HttpTransportError("LIX_SHARED_ENGINE_IDENTITY_MISMATCH", "Stored replica account does not match admission");
+                    this.principalId = principal;
+                    this.state = "ready";
+                }
+                catch (error) {
+                    this.clients.delete(client);
+                    if (this.root) {
+                        this.state = "closing";
+                        await this.root.close();
+                        this.root = undefined;
+                        this.principalId = undefined;
+                    }
+                    this.state = "closed";
+                    throw error;
+                }
+                finally {
+                    client.server = originalServer;
+                }
+            }
+            const root = this.root;
+            try {
+                if (client.server.url !== identity.authorityUrl ||
+                    this.principalId !== identity.accountId) {
+                    throw Object.assign(new Error("Shared engine repository/account does not match this client"), { code: "LIX_SHARED_ENGINE_IDENTITY_MISMATCH" });
+                }
+                await client.commitIdentity?.();
+                this.clients.add(client);
+                const report = opensRoot ? root.openReport?.() : undefined;
+                const child = await root.openAnotherSession({}, client.telemetry ?? (() => { }));
+                if (report === undefined)
+                    return child;
+                // Only the opening caller performed initialization/migration. Later
+                // attachments must not inherit that first caller's opening report.
+                return new Proxy(child, {
+                    get(target, property) {
+                        if (property === "openReport")
+                            return () => report;
+                        const value = Reflect.get(target, property, target);
+                        return typeof value === "function" ? value.bind(target) : value;
+                    },
+                });
+            }
+            catch (error) {
+                this.clients.delete(client);
+                if (this.clients.size === 0) {
+                    this.state = "closing";
+                    await root.close();
+                    this.root = undefined;
+                    this.principalId = undefined;
+                    this.state = "closed";
+                }
+                throw error;
+            }
+        });
+        this.queue = operation.catch(() => undefined);
+        return operation;
+    }
+    /** Serialize closed-storage conversion with root admission across all ports. */
+    convert(client, conversion, branchId) {
+        const operation = this.queue.then(async () => {
+            if (client.isDisconnected?.())
+                throw new Error("Shared engine client disconnected before conversion");
+            if (this.root) {
+                const identity = await client.verifyIdentity();
+                if (client.server.url !== identity.authorityUrl ||
+                    this.principalId !== identity.accountId) {
+                    throw Object.assign(new Error("Shared engine repository/account does not match this client"), { code: "LIX_SHARED_ENGINE_IDENTITY_MISMATCH" });
+                }
+                if (branchId !== undefined && branchId !== await this.root.activeBranchId()) {
+                    throw Object.assign(new Error("The converted replica selected a different branch"), { code: "LIX_PARTIAL_CONVERSION_BRANCH_MISMATCH" });
+                }
+                // A competing caller already admitted the converted partial store.
+                // Never close its live sessions just to repeat an explicit conversion.
+                return;
+            }
+            if (this.state !== "closed")
+                throw new HttpTransportError("LIX_OWNER_NOT_CLOSED", "Migration requires a closed storage owner");
+            this.state = "migration-exclusive";
+            this.clients.add(client);
+            try {
+                await conversion(this.transport());
+            }
+            finally {
+                this.clients.delete(client);
+                this.state = "closed";
+            }
+        });
+        this.queue = operation.catch(() => undefined);
+        return operation;
+    }
+    deactivate(client) {
+        this.clients.delete(client);
+    }
+    async detach(client) {
+        const operation = this.queue.then(async () => {
+            this.clients.delete(client);
+            if (this.clients.size === 0 && this.root) {
+                const root = this.root;
+                // Keep ownership on a failed close; never open a second engine over it.
+                this.state = "closing";
+                await root.close();
+                this.root = undefined;
+                this.principalId = undefined;
+                this.state = "closed";
+            }
+        });
+        this.queue = operation.catch(() => undefined);
+        await operation;
+    }
+    transport() {
+        const first = this.clients.values().next().value;
+        if (!first)
+            throw new HttpTransportError("LIX_TRANSPORT_UNAVAILABLE", "No live shared-engine transport");
+        return {
+            url: first.server.url,
+            headers: [],
+            transport: async (request) => {
+                let unavailable;
+                // Credentials and callback remain paired when a tab leaves or suspends.
+                for (const client of this.clients) {
+                    if (client.isDisconnected?.())
+                        continue;
+                    const server = client.server;
+                    let supplied;
+                    try {
+                        supplied = (server.headerProvider ? await server.headerProvider() : server.headers).map(([name, value]) => [name, value]);
+                    }
+                    catch (error) {
+                        unavailable = error;
+                        continue;
+                    }
+                    if (!this.clients.has(client) || client.isDisconnected?.())
+                        continue;
+                    const headers = new Headers(request.init.headers);
+                    for (const [name, value] of supplied)
+                        headers.set(name, value);
+                    const response = await (server.transport ?? fetchTransport())({ ...request, init: { ...request.init, headers, credentials: "omit" } });
+                    if (response.status === 401 || response.status === 403)
+                        await client.rejectCredentials?.(supplied);
+                    return response;
+                }
+                throw unavailable ?? new HttpTransportError("LIX_TRANSPORT_UNAVAILABLE", "No verified live shared-engine transport");
+            },
+        };
+    }
+}

package/package.json

@@ -1,13 +1,21 @@
 {
 	"name": "@lix-js/sdk",
 	"type": "module",
-	"version": "0.16.1",
+	"version": "0.17.0",
 	"license": "MIT",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/opral/lix"
 	},
 	"exports": {
+		"./compatibility": {
+			"types": "./dist/compatibility.d.ts",
+			"default": "./dist/compatibility.js"
+		},
+		"./migration": {
+			"types": "./dist/migration.d.ts",
+			"default": "./dist/migration.js"
+		},
 		".": {
 			"types": "./dist/index.d.ts",
 			"default": "./dist/index.js"
@@ -27,17 +35,19 @@
 		"dist"
 	],
 	"scripts": {
-		"build": "npm run clean && npm run build:native && npm run build:wasm && npm run build:ts && npm run build:plugins",
-		"build:browser": "npm run clean && npm run build:wasm && npm run build:ts && npm run build:plugins",
+		"build": "npm run clean && npm run build:native && npm run build:migration:native && npm run build:wasm && npm run build:migration:wasm && npm run build:ts && npm run build:plugins",
+		"build:browser": "npm run clean && npm run build:wasm && npm run build:migration:wasm && npm run build:ts && npm run build:plugins",
 		"build:native": "node ./scripts/build-native.js",
 		"build:wasm": "node ./scripts/build-wasm.js",
+		"build:migration:wasm": "LIX_OFFLINE_MIGRATION=1 node ./scripts/build-wasm.js",
+		"build:migration:native": "LIX_OFFLINE_MIGRATION=1 node ./scripts/build-native.js",
 		"build:wasm:dev": "LIX_WASM_PROFILE=dev node ./scripts/build-wasm.js",
 		"build:plugins": "node ./scripts/build-bundled-plugins.js",
 		"benchmark:plugin-reopen": "node ./scripts/benchmark-plugin-reopen.mjs",
 		"benchmark:storage-boundary": "LIX_WASM_STORAGE_BENCH=1 npm run build:browser && LIX_WASM_STORAGE_BENCH=1 vitest run --config vitest.browser.config.ts src/storage-bridge.bench.browser.test.ts",
 		"clean": "node ./scripts/clean.js",
 		"prepare:native-package": "node ./scripts/prepare-native-package.js",
-		"build:ts": "tsc -p tsconfig.json",
+		"build:ts": "tsc -p tsconfig.json && node ./scripts/build-compatibility.js",
 		"test": "npm run build && vitest run",
 		"test:browser": "npm run build:browser && vitest run --config vitest.browser.config.ts",
 		"test:browser:built": "vitest run --config vitest.browser.config.ts",
@@ -45,20 +55,22 @@
 		"typecheck": "tsc -p tsconfig.test.json --noEmit"
 	},
 	"optionalDependencies": {
-		"@lix-js/sdk-darwin-arm64": "0.16.1",
-		"@lix-js/sdk-linux-arm64": "0.16.1",
-		"@lix-js/sdk-linux-x64": "0.16.1",
-		"@lix-js/sdk-win32-x64": "0.16.1"
+		"@lix-js/sdk-darwin-arm64": "0.17.0",
+		"@lix-js/sdk-linux-arm64": "0.17.0",
+		"@lix-js/sdk-linux-x64": "0.17.0",
+		"@lix-js/sdk-win32-x64": "0.17.0"
 	},
 	"devDependencies": {
-		"@vitest/browser-playwright": "4.1.10",
 		"@types/node": "^24.10.2",
+		"@vitest/browser-playwright": "4.1.10",
 		"playwright": "1.57.0",
 		"typescript": "^5.5.4",
 		"vite": "8.1.4",
 		"vitest": "4.1.10"
 	},
 	"dependencies": {
+		"@bytecodealliance/jco-transpile": "0.13.0",
+		"binaryen": "130.0.0",
 		"fflate": "^0.8.3"
 	}
 }