@evolu/web 1.0.1-preview.2 → 1.0.1-preview.4

package/dist/src/Evolu/AppState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppState.d.ts","sourceRoot":"","sources":["../../../src/Evolu/AppState.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE/D,eAAO,MAAM,cAAc,EAAE,cAe5B,CAAC"}

package/dist/{Evolu → src/Evolu}/Db.worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Db.worker.d.ts","sourceRoot":"","sources":["../../src/Evolu/Db.worker.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Db.worker.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Db.worker.ts"],"names":[],"mappings":""}

package/dist/src/Evolu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Evolu/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,SAAS,EACV,MAAM,qBAAqB,CAAC;AAa7B,eAAO,MAAM,YAAY,EAAE,SAM1B,CAAC"}

package/dist/src/SharedWebWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedWebWorker.d.ts","sourceRoot":"","sources":["../../src/SharedWebWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAa,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AA8B9D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,EAAE,MAAM,EACjD,MAAM,UAAU,EAChB,iBAAiB,MAAM,UAAU,CAAC,MAAM,KACvC,MAAM,CAAC,KAAK,EAAE,MAAM,CAuFtB,CAAC"}

package/dist/src/WasmSqliteDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WasmSqliteDriver.d.ts","sourceRoot":"","sources":["../../src/WasmSqliteDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAGnB,MAAM,eAAe,CAAC;AAavB,eAAO,MAAM,sBAAsB,EAAE,kBAsEpC,CAAC"}

package/dist/{WasmSqliteDriver.js → src/WasmSqliteDriver.js}

@@ -8,10 +8,11 @@ globalThis.sqlite3ApiConfig = {
 };
 // Init ASAP.
 const sqlite3Promise = sqlite3InitModule();
-export const createWasmSqliteDriver = async (name) => {
+export const createWasmSqliteDriver = async (name, options) => {
     const sqlite3 = await sqlite3Promise;
-    const poolUtil = await sqlite3.installOpfsSAHPoolVfs({ name });
-    const db = new poolUtil.OpfsSAHPoolDb("/evolu1.db");
+    const db = options?.memory
+        ? new sqlite3.oo1.DB(":memory:")
+        : new (await sqlite3.installOpfsSAHPoolVfs({ name })).OpfsSAHPoolDb("/evolu1.db");
     let isDisposed = false;
     const cache = createPreparedStatementsCache((sql) => db.prepare(sql), (statement) => {
         statement.finalize();

package/dist/src/WebWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebWorker.d.ts","sourceRoot":"","sources":["../../src/WebWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAa,MAAM,EAAE,MAAM,eAAe,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,EAAE,MAAM,EACzC,iBAAiB,MAAM,UAAU,CAAC,MAAM,KACvC,MAAM,CAAC,KAAK,EAAE,MAAM,CAuBtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,KAAK,EAAE,MAAM,EAC7C,QAAQ,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAC5B,IAQF,CAAC"}

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}

package/dist/test/SharedWebWorker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SharedWebWorker.test.d.ts.map

package/dist/test/SharedWebWorker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedWebWorker.test.d.ts","sourceRoot":"","sources":["../../test/SharedWebWorker.test.ts"],"names":[],"mappings":""}

package/dist/test/SharedWebWorker.test.js

@@ -0,0 +1,246 @@
+/* eslint-disable @typescript-eslint/no-unsafe-call */
+/* eslint-disable @typescript-eslint/no-unsafe-member-access */
+/* eslint-disable @typescript-eslint/no-unsafe-return */
+/* eslint-disable @typescript-eslint/no-unsafe-assignment */
+import { expect, test, vi, beforeEach, afterEach } from "vitest";
+import { createSharedWebWorker } from "../src/SharedWebWorker.js";
+import { getOrThrow, SimpleName, wait } from "@evolu/common";
+// Mock BroadcastChannel
+class MockBroadcastChannel {
+    name;
+    onmessage = null;
+    constructor(name) {
+        this.name = name;
+    }
+    postMessage = vi.fn();
+    close = vi.fn();
+}
+// Mock Web Locks API
+const mockLocks = {
+    request: vi.fn(),
+};
+// Mock Web Worker
+class MockWorker {
+    onmessage = null;
+    postMessage = vi.fn();
+    terminate = vi.fn();
+}
+beforeEach(() => {
+    // Create a spy for BroadcastChannel constructor
+    global.BroadcastChannel = vi
+        .fn()
+        .mockImplementation((name) => new MockBroadcastChannel(name));
+    global.document = {}; // Simulate browser environment
+    // Mock navigator.locks properly - remove the global.navigator assignment
+    Object.defineProperty(global.navigator, "locks", {
+        value: mockLocks,
+        writable: true,
+        configurable: true,
+    });
+    vi.clearAllMocks();
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+test("createSharedWebWorker creates BroadcastChannel and requests lock", () => {
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    const sharedWorker = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    // Should create BroadcastChannel with namespaced name
+    expect(global.BroadcastChannel).toHaveBeenCalledWith("evolu-sharedwebworker-test-worker");
+    // Should request owner-ready immediately
+    const channelInstance = vi.mocked(global.BroadcastChannel).mock.results[0]
+        .value;
+    expect(channelInstance.postMessage).toHaveBeenCalledWith({
+        type: "request-owner-ready",
+    });
+    // Should attempt to acquire Web Lock
+    expect(mockLocks.request).toHaveBeenCalledWith("evolu-sharedwebworker-test-worker", expect.any(Function));
+    // Should return worker interface
+    expect(sharedWorker).toHaveProperty("postMessage");
+    expect(sharedWorker).toHaveProperty("onMessage");
+    expect(typeof sharedWorker.postMessage).toBe("function");
+    expect(typeof sharedWorker.onMessage).toBe("function");
+});
+test("createSharedWebWorker returns no-op on server", () => {
+    // Simulate server environment
+    delete global.document;
+    const mockCreateWorker = vi.fn();
+    const sharedWorker = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    // Should not create BroadcastChannel or request locks
+    expect(global.BroadcastChannel).not.toHaveBeenCalled();
+    expect(mockLocks.request).not.toHaveBeenCalled();
+    // Should return no-op worker
+    expect(sharedWorker.postMessage).toBeDefined();
+    expect(sharedWorker.onMessage).toBeDefined();
+    // Restore document for other tests
+    global.document = {};
+});
+test("createSharedWebWorker queues messages when owner not ready", () => {
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    const sharedWorker = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    const channelInstance = vi.mocked(global.BroadcastChannel).mock.results[0]
+        .value;
+    // Send message before owner is ready
+    sharedWorker.postMessage({ type: "test-message" });
+    // Should not send to channel yet (owner not ready)
+    expect(channelInstance.postMessage).toHaveBeenCalledTimes(1); // Only request-owner-ready
+    // Simulate owner-ready message
+    const ownerReadyEvent = new MessageEvent("message", {
+        data: { type: "owner-ready" },
+    });
+    channelInstance.onmessage?.(ownerReadyEvent);
+    // Should now send the queued message
+    expect(channelInstance.postMessage).toHaveBeenCalledWith({
+        type: "to-worker",
+        message: { type: "test-message" },
+    });
+});
+test("createSharedWebWorker forwards messages when owner ready", () => {
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    const sharedWorker = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    const channelInstance = vi.mocked(global.BroadcastChannel).mock.results[0]
+        .value;
+    // Simulate owner-ready message
+    const ownerReadyEvent = new MessageEvent("message", {
+        data: { type: "owner-ready" },
+    });
+    channelInstance.onmessage?.(ownerReadyEvent);
+    // Send message after owner is ready
+    sharedWorker.postMessage({ type: "test-message" });
+    // Should send directly to channel
+    expect(channelInstance.postMessage).toHaveBeenCalledWith({
+        type: "to-worker",
+        message: { type: "test-message" },
+    });
+});
+test("createSharedWebWorker handles onMessage callback", () => {
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    const onMessageCallback = vi.fn();
+    const sharedWorker = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    sharedWorker.onMessage(onMessageCallback);
+    const channelInstance = vi.mocked(global.BroadcastChannel).mock.results[0]
+        .value;
+    // Simulate message from worker
+    const workerMessage = new MessageEvent("message", {
+        data: { type: "from-worker", message: { result: "test" } },
+    });
+    channelInstance.onmessage?.(workerMessage);
+    // Should call the callback
+    expect(onMessageCallback).toHaveBeenCalledWith({ result: "test" });
+});
+test("createSharedWebWorker handles multiple tabs - first tab becomes owner", async () => {
+    let lockCallback;
+    // Mock locks.request to capture the callback but not execute it immediately
+    mockLocks.request.mockImplementation((_name, callback) => {
+        if (!lockCallback) {
+            lockCallback = callback;
+            // Simulate first tab acquiring the lock
+            setTimeout(() => {
+                void lockCallback?.();
+            }, 0);
+        }
+        return Promise.resolve();
+    });
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    // Create first tab (will become owner)
+    createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    // Create second tab
+    createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    // Both tabs should create BroadcastChannels
+    expect(global.BroadcastChannel).toHaveBeenCalledTimes(2);
+    const tab1Channel = vi.mocked(global.BroadcastChannel).mock.results[0].value;
+    const tab2Channel = vi.mocked(global.BroadcastChannel).mock.results[1].value;
+    // Both tabs should request owner-ready
+    expect(tab1Channel.postMessage).toHaveBeenCalledWith({
+        type: "request-owner-ready",
+    });
+    expect(tab2Channel.postMessage).toHaveBeenCalledWith({
+        type: "request-owner-ready",
+    });
+    // Wait for lock acquisition
+    await wait(10);
+    // Only first tab should create worker (it became owner)
+    expect(mockCreateWorker).toHaveBeenCalledTimes(1);
+    // First tab should announce ownership
+    expect(tab1Channel.postMessage).toHaveBeenCalledWith({ type: "owner-ready" });
+});
+test("createSharedWebWorker handles cross-tab message forwarding", () => {
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    // Create two tabs
+    const tab1 = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    const tab2 = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    const tab1Channel = vi.mocked(global.BroadcastChannel).mock.results[0].value;
+    const tab2Channel = vi.mocked(global.BroadcastChannel).mock.results[1].value;
+    // Simulate tab1 receiving owner-ready (tab1 becomes aware of owner)
+    const ownerReadyEvent = new MessageEvent("message", {
+        data: { type: "owner-ready" },
+    });
+    tab1Channel.onmessage?.(ownerReadyEvent);
+    // Simulate tab2 receiving owner-ready
+    tab2Channel.onmessage?.(ownerReadyEvent);
+    // Both tabs send messages
+    tab1.postMessage({ from: "tab1" });
+    tab2.postMessage({ from: "tab2" });
+    // Both should forward to channel
+    expect(tab1Channel.postMessage).toHaveBeenCalledWith({
+        type: "to-worker",
+        message: { from: "tab1" },
+    });
+    expect(tab2Channel.postMessage).toHaveBeenCalledWith({
+        type: "to-worker",
+        message: { from: "tab2" },
+    });
+});
+test("createSharedWebWorker handles worker responses across tabs", () => {
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    const tab1Callback = vi.fn();
+    const tab2Callback = vi.fn();
+    // Create two tabs
+    const tab1 = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    const tab2 = createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    // Set up message callbacks
+    tab1.onMessage(tab1Callback);
+    tab2.onMessage(tab2Callback);
+    const tab1Channel = vi.mocked(global.BroadcastChannel).mock.results[0].value;
+    const tab2Channel = vi.mocked(global.BroadcastChannel).mock.results[1].value;
+    // Simulate worker response broadcast
+    const workerResponse = new MessageEvent("message", {
+        data: { type: "from-worker", message: { result: "shared-result" } },
+    });
+    // Both tabs receive the same worker response
+    tab1Channel.onmessage?.(workerResponse);
+    tab2Channel.onmessage?.(workerResponse);
+    // Both callbacks should be called with the same data
+    expect(tab1Callback).toHaveBeenCalledWith({ result: "shared-result" });
+    expect(tab2Callback).toHaveBeenCalledWith({ result: "shared-result" });
+});
+test("createSharedWebWorker multi-tab scenario", () => {
+    const mockCreateWorker = vi.fn(() => new MockWorker());
+    const channelInstances = [];
+    // Track all BroadcastChannel instances
+    global.BroadcastChannel = vi.fn().mockImplementation((name) => {
+        const instance = new MockBroadcastChannel(name);
+        channelInstances.push(instance);
+        // Override postMessage to broadcast to all instances with same name
+        instance.postMessage = vi.fn().mockImplementation((data) => {
+            channelInstances
+                .filter((ch) => ch.name === name)
+                .forEach((ch) => ch.onmessage?.(new MessageEvent("message", { data })));
+        });
+        return instance;
+    });
+    // Mock lock - only first caller gets the lock
+    let lockAcquired = false;
+    mockLocks.request.mockImplementation((_name, callback) => {
+        if (!lockAcquired) {
+            lockAcquired = true;
+            void callback(); // First tab becomes owner
+        }
+        return Promise.resolve();
+    });
+    // Create two tabs
+    createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    createSharedWebWorker(getOrThrow(SimpleName.from("test-worker")), mockCreateWorker);
+    // Only first tab should create worker (owner)
+    expect(mockCreateWorker).toHaveBeenCalledTimes(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/web",
-  "version": "1.0.1-preview.2",
+  "version": "1.0.1-preview.4",
   "description": "Evolu for web",
   "keywords": [
     "evolu",
@@ -17,9 +17,9 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "browser": "./dist/index.js"
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "browser": "./dist/src/index.js"
     }
   },
   "files": [
@@ -28,18 +28,18 @@
     "README.md"
   ],
   "dependencies": {
-    "@sqlite.org/sqlite-wasm": "3.50.1-build1"
+    "@sqlite.org/sqlite-wasm": "3.50.3-build1"
   },
   "devDependencies": {
     "@types/web-locks-api": "^0.0.5",
     "typescript": "^5.8.3",
     "user-agent-data-types": "^0.4.2",
     "vitest": "^3.2.3",
-    "@evolu/common": "6.0.1-preview.3",
+    "@evolu/common": "6.0.1-preview.17",
     "@evolu/tsconfig": "0.0.2"
   },
   "peerDependencies": {
-    "@evolu/common": "^6.0.1-preview.3"
+    "@evolu/common": "^6.0.1-preview.17"
   },
   "publishConfig": {
     "access": "public"
@@ -51,6 +51,8 @@
   "scripts": {
     "dev": "tsc --watch",
     "build": "shx rm -rf dist && tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "clean": "shx rm -rf .turbo node_modules dist",
     "format": "prettier --write \"src/*.{ts,tsx,md}\""
   }

package/src/WasmSqliteDriver.ts

@@ -17,10 +17,17 @@ globalThis.sqlite3ApiConfig = {
 // Init ASAP.
 const sqlite3Promise = sqlite3InitModule();
 
-export const createWasmSqliteDriver: CreateSqliteDriver = async (name) => {
+export const createWasmSqliteDriver: CreateSqliteDriver = async (
+  name,
+  options,
+) => {
   const sqlite3 = await sqlite3Promise;
-  const poolUtil = await sqlite3.installOpfsSAHPoolVfs({ name });
-  const db = new poolUtil.OpfsSAHPoolDb("/evolu1.db");
+
+  const db = options?.memory
+    ? new sqlite3.oo1.DB(":memory:")
+    : new (await sqlite3.installOpfsSAHPoolVfs({ name })).OpfsSAHPoolDb(
+        "/evolu1.db",
+      );
   let isDisposed = false;
 
   const cache = createPreparedStatementsCache<PreparedStatement>(

package/dist/Evolu/AppState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AppState.d.ts","sourceRoot":"","sources":["../../src/Evolu/AppState.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE/D,eAAO,MAAM,cAAc,EAAE,cAe5B,CAAC"}

package/dist/Evolu/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Evolu/index.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,SAAS,EACV,MAAM,qBAAqB,CAAC;AAa7B,eAAO,MAAM,YAAY,EAAE,SAM1B,CAAC"}

package/dist/SharedWebWorker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SharedWebWorker.d.ts","sourceRoot":"","sources":["../src/SharedWebWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAa,UAAU,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AA8B9D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,EAAE,MAAM,EACjD,MAAM,UAAU,EAChB,iBAAiB,MAAM,UAAU,CAAC,MAAM,KACvC,MAAM,CAAC,KAAK,EAAE,MAAM,CAuFtB,CAAC"}

package/dist/WasmSqliteDriver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WasmSqliteDriver.d.ts","sourceRoot":"","sources":["../src/WasmSqliteDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAGnB,MAAM,eAAe,CAAC;AAavB,eAAO,MAAM,sBAAsB,EAAE,kBA+DpC,CAAC"}

package/dist/WebWorker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebWorker.d.ts","sourceRoot":"","sources":["../src/WebWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAa,MAAM,EAAE,MAAM,eAAe,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,EAAE,MAAM,EACzC,iBAAiB,MAAM,UAAU,CAAC,MAAM,KACvC,MAAM,CAAC,KAAK,EAAE,MAAM,CAuBtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,KAAK,EAAE,MAAM,EAC7C,QAAQ,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAC5B,IAQF,CAAC"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}