@evolu/web 3.0.0-next.0 → 3.0.0-next.1

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 Evolu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -1 +1 @@
-{"version":3,"file":"Sqlite.d.ts","sourceRoot":"","sources":["../../src/Sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAa,MAAM,eAAe,CAAC;AAyBnE,eAAO,MAAM,sBAAsB,EAAE,kBAmFlC,CAAC"}
+{"version":3,"file":"Sqlite.d.ts","sourceRoot":"","sources":["../../src/Sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAa,MAAM,eAAe,CAAC;AA4BnE,eAAO,MAAM,sBAAsB,EAAE,kBA6GlC,CAAC"}

package/dist/src/Sqlite.js

@@ -1,3 +1,55 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
 import { bytesToHex, createPreparedStatementsCache, ok } from "@evolu/common";
 import sqlite3InitModule, {} from "@evolu/sqlite-wasm";
 // @ts-expect-error Missing types.
@@ -14,68 +66,97 @@ globalThis.sqlite3ApiConfig = {
 };
 // Init ASAP.
 const sqlite3Promise = sqlite3InitModule();
+const fileName = "evolu1.db";
 export const createWasmSqliteDriver = (name, options) => async () => {
-    const sqlite3 = await sqlite3Promise;
-    // This is used to make OPFS default vfs for multipleciphers
-    // @ts-expect-error Missing types (update @evolu/sqlite-wasm types)
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call
-    sqlite3.capi.sqlite3mc_vfs_create("opfs", 1);
-    const stack = new globalThis.DisposableStack();
-    let db;
-    switch (options?.mode) {
-        case "memory":
-            db = new sqlite3.oo1.DB(":memory:");
-            break;
-        case "encrypted": {
-            const pool = await sqlite3.installOpfsSAHPoolVfs({
-                directory: `.${name}`,
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const sqlite3 = await sqlite3Promise;
+        const disposer = __addDisposableResource(env_1, new DisposableStack(), false);
+        const useDatabase = (database) => disposer.adopt(database, (database) => {
+            database.close();
+        });
+        let deleteDatabaseFile = false;
+        const createOpfsSAHPoolVfs = async (options) => {
+            const pool = await sqlite3.installOpfsSAHPoolVfs(options);
+            if (pool.isPaused())
+                await pool.unpauseVfs();
+            disposer.defer(() => {
+                if (deleteDatabaseFile)
+                    pool.unlink(`/${fileName}`);
+                pool.pauseVfs();
             });
-            db = new pool.OpfsSAHPoolDb("file:evolu1.db?vfs=multipleciphers-opfs-sahpool");
-            db.exec(`
+            return pool;
+        };
+        let db;
+        switch (options?.mode) {
+            case "memory":
+                db = useDatabase(new sqlite3.oo1.DB(":memory:"));
+                break;
+            case "encrypted": {
+                // MultipleCiphers encryption requires its VFS wrapper for OPFS SAH-pool.
+                // @ts-expect-error Missing types (update @evolu/sqlite-wasm types)
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+                sqlite3.capi.sqlite3mc_vfs_create("opfs", 1);
+                const pool = await createOpfsSAHPoolVfs({
+                    directory: `.${name}`,
+                });
+                db = useDatabase(new pool.OpfsSAHPoolDb(
+                // SQLite normalizes this URI filename to SAH-pool path "/evolu1.db".
+                `file:${fileName}?vfs=multipleciphers-opfs-sahpool`));
+                db.exec(`
           PRAGMA cipher = 'sqlcipher';
           PRAGMA key = "x'${bytesToHex(options.encryptionKey)}'";
         `);
-            break;
-        }
-        default: {
-            const pool = await sqlite3.installOpfsSAHPoolVfs({ name });
-            db = new pool.OpfsSAHPoolDb("file:evolu1.db");
+                break;
+            }
+            default: {
+                const pool = await createOpfsSAHPoolVfs({ name });
+                db = useDatabase(new pool.OpfsSAHPoolDb(`file:${fileName}`));
+            }
         }
-    }
-    db = stack.adopt(db, (db) => {
-        db.close();
-    });
-    const cache = stack.use(createPreparedStatementsCache((sql) => db.prepare(sql), (statement) => {
-        statement.finalize();
-    }));
-    return ok({
-        exec: (query) => {
-            const prepared = cache.get(query);
-            if (prepared) {
-                if (query.parameters.length > 0)
-                    prepared.bind(query.parameters);
-                const rows = [];
-                while (prepared.step()) {
-                    rows.push(prepared.get({}));
+        const cache = disposer.use(createPreparedStatementsCache((sql) => db.prepare(sql), (statement) => {
+            statement.finalize();
+        }));
+        const disposables = disposer.move();
+        return ok({
+            exec: (query) => {
+                const prepared = cache.get(query);
+                if (prepared) {
+                    if (query.parameters.length > 0)
+                        prepared.bind(query.parameters);
+                    const rows = [];
+                    while (prepared.step()) {
+                        rows.push(prepared.get({}));
+                    }
+                    prepared.reset();
+                    return {
+                        rows: rows,
+                        changes: db.changes(),
+                    };
                 }
-                prepared.reset();
-                return {
-                    rows: rows,
-                    changes: db.changes(),
-                };
-            }
-            const rows = db.exec(query.sql, {
-                returnValue: "resultRows",
-                rowMode: "object",
-                bind: query.parameters,
-            });
-            const changes = db.changes();
-            return { rows, changes };
-        },
-        export: () => sqlite3.capi.sqlite3_js_db_export(db),
-        [Symbol.dispose]: () => {
-            // poolUtil.unlink?
-            stack.dispose();
-        },
-    });
+                const rows = db.exec(query.sql, {
+                    returnValue: "resultRows",
+                    rowMode: "object",
+                    bind: query.parameters,
+                });
+                const changes = db.changes();
+                return { rows, changes };
+            },
+            export: () => sqlite3.capi.sqlite3_js_db_export(db),
+            deleteDatabase: () => {
+                deleteDatabaseFile = true;
+                disposables.dispose();
+            },
+            [Symbol.dispose]: () => {
+                disposables.dispose();
+            },
+        });
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
 };

package/dist/src/Task.d.ts

@@ -3,16 +3,7 @@
  *
  * @module
  */
-import { type CreateRun, type LeaderLock, type RunDeps } from "@evolu/common";
-/**
- * Creates a {@link LeaderLock} backed by the Web Locks API.
- *
- * Waiting for the browser lock is intentionally unabortable. If a caller starts
- * waiting and its {@link Run} or fiber is later aborted, the underlying Web
- * Locks request keeps waiting until the browser grants the lock. Only the
- * returned lease releases it.
- */
-export declare const createLeaderLock: () => LeaderLock;
+import { type CreateRun, type RunDefaultDeps } from "@evolu/common";
 /**
  * Creates {@link Run} for the browser with global error handling.
  *
@@ -29,10 +20,10 @@ export declare const createLeaderLock: () => LeaderLock;
  * });
  *
  * await using run = createRun({ console });
- * await using stack = new AsyncDisposableStack();
+ * await using disposer = new AsyncDisposableStack();
  *
- * stack.use(await run.orThrow(startApp()));
+ * disposer.use(await run.orThrow(startApp()));
  * ```
  */
-export declare const createRun: CreateRun<RunDeps>;
+export declare const createRun: CreateRun<RunDefaultDeps>;
 //# sourceMappingURL=Task.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../src/Task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,UAAU,EAEf,KAAK,OAAO,EACb,MAAM,eAAe,CAAC;AAEvB;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,QAAO,UAuBlC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,CAAC,OAAO,CAuBxC,CAAC"}
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../src/Task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,SAAS,EAAE,SAAS,CAAC,cAAc,CAuB/C,CAAC"}

package/dist/src/Task.js

@@ -3,32 +3,7 @@
  *
  * @module
  */
-import { createRun as createCommonRun, createUnknownError, ok, } from "@evolu/common";
-/**
- * Creates a {@link LeaderLock} backed by the Web Locks API.
- *
- * Waiting for the browser lock is intentionally unabortable. If a caller starts
- * waiting and its {@link Run} or fiber is later aborted, the underlying Web
- * Locks request keeps waiting until the browser grants the lock. Only the
- * returned lease releases it.
- */
-export const createLeaderLock = () => ({
-    lock: (name) => async () => {
-        const acquired = Promise.withResolvers();
-        const release = Promise.withResolvers();
-        void globalThis.navigator.locks.request(`evolu-leaderlock-${name}`, { mode: "exclusive" }, async () => {
-            acquired.resolve();
-            await release.promise;
-        });
-        await acquired.promise;
-        return ok({
-            [Symbol.asyncDispose]: async () => {
-                release.resolve();
-                return Promise.resolve();
-            },
-        });
-    },
-});
+import { createRun as createCommonRun, createUnknownError, } from "@evolu/common";
 /**
  * Creates {@link Run} for the browser with global error handling.
  *
@@ -45,9 +20,9 @@ export const createLeaderLock = () => ({
  * });
  *
  * await using run = createRun({ console });
- * await using stack = new AsyncDisposableStack();
+ * await using disposer = new AsyncDisposableStack();
  *
- * stack.use(await run.orThrow(startApp()));
+ * disposer.use(await run.orThrow(startApp()));
  * ```
  */
 export const createRun = (deps) => {

package/dist/src/Worker.d.ts

@@ -1,7 +1,19 @@
-import type { CreateMessagePort, MessageChannel, SharedWorker, SharedWorkerSelf, Worker, WorkerDeps, WorkerSelf } from "@evolu/common";
+import type { CreateBroadcastChannel, CreateBroadcastChannelDep, CreateMessageChannelDep, CreateMessagePort, MessageChannel, SharedWorker, SharedWorkerSelf, Worker, WorkerDeps, WorkerSelf } from "@evolu/common";
 /** Creates a {@link Worker} from a Web Worker. */
 export declare const createWorker: <Input, Output>(nativeWorker: globalThis.Worker) => Worker<Input, Output>;
-/** Creates an Evolu {@link SharedWorker} from a Web SharedWorker. */
+/**
+ * Installs a one-tab SharedWorker polyfill backed by a Web Worker.
+ *
+ * Use it before constructing a SharedWorker in browsers without native
+ * SharedWorker support.
+ */
+export declare const installOneTabSharedWorkerPolyfill: () => void;
+/**
+ * Creates a {@link SharedWorker} from a Web SharedWorker.
+ *
+ * Call {@link installOneTabSharedWorkerPolyfill} first to support browsers
+ * without native SharedWorker support.
+ */
 export declare const createSharedWorker: <Input, Output = never>(nativeSharedWorker: globalThis.SharedWorker) => SharedWorker<Input, Output>;
 /**
  * Creates a {@link MessageChannel} from a Web MessageChannel.
@@ -21,6 +33,8 @@ export declare const createMessageChannel: <Input, Output = never>() => MessageC
  * Use this for ports received via postMessage transfer.
  */
 export declare const createMessagePort: CreateMessagePort;
+/** Creates an Evolu {@link BroadcastChannel} from a Web BroadcastChannel. */
+export declare const createBroadcastChannel: CreateBroadcastChannel;
 /**
  * Creates an Evolu {@link WorkerSelf} from a Web `DedicatedWorkerGlobalScope`
  * (`self` inside a dedicated worker).
@@ -33,6 +47,14 @@ export declare const createWorkerSelf: <Input, Output = never>(nativeSelf: globa
  * Disposing closes the shared worker scope for all connected clients.
  */
 export declare const createSharedWorkerSelf: <Input, Output = never>(nativeSelf: globalThis.SharedWorkerGlobalScope) => SharedWorkerSelf<Input, Output>;
+/**
+ * Creates a one-tab {@link SharedWorkerSelf} polyfill for browsers without
+ * native SharedWorker support.
+ *
+ * Delivers one synthetic `onConnect` port, queues startup messages until
+ * `onMessage` is set, and does not share state across tabs.
+ */
+export declare const createOneTabSharedWorkerSelfPolyfill: <Input, Output = never>(nativeSelf: globalThis.DedicatedWorkerGlobalScope) => SharedWorkerSelf<Input, Output>;
 /** Creates deps shared by web worker entry points. */
-export declare const createWorkerDeps: () => WorkerDeps;
+export declare const createWorkerDeps: () => WorkerDeps & CreateBroadcastChannelDep & CreateMessageChannelDep;
 //# sourceMappingURL=Worker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Worker.d.ts","sourceRoot":"","sources":["../../src/Worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EAGd,YAAY,EACZ,gBAAgB,EAEhB,MAAM,EACN,UAAU,EACV,UAAU,EACX,MAAM,eAAe,CAAC;AAGvB,kDAAkD;AAClD,eAAO,MAAM,YAAY,GAAI,KAAK,EAAE,MAAM,EACxC,cAAc,UAAU,CAAC,MAAM,KAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,CAAuB,CAAC;AAE/C,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,EACtD,oBAAoB,UAAU,CAAC,YAAY,KAC1C,YAAY,CAAC,KAAK,EAAE,MAAM,CAM5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,OAAK,cAAc,CAC3E,KAAK,EACL,MAAM,CAYP,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBACuB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,EACpD,YAAY,UAAU,CAAC,0BAA0B,KAChD,UAAU,CAAC,KAAK,EAAE,MAAM,CAAoC,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,EAC1D,YAAY,UAAU,CAAC,uBAAuB,KAC7C,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAkBhC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAO,UASnC,CAAC"}
+{"version":3,"file":"Worker.d.ts","sourceRoot":"","sources":["../../src/Worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,cAAc,EAGd,YAAY,EACZ,gBAAgB,EAEhB,MAAM,EACN,UAAU,EACV,UAAU,EACX,MAAM,eAAe,CAAC;AAQvB,kDAAkD;AAClD,eAAO,MAAM,YAAY,GAAI,KAAK,EAAE,MAAM,EACxC,cAAc,UAAU,CAAC,MAAM,KAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,CAAuB,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,QAAO,IAiBpD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,EACtD,oBAAoB,UAAU,CAAC,YAAY,KAC1C,YAAY,CAAC,KAAK,EAAE,MAAM,CAM5B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,OAAK,cAAc,CAC3E,KAAK,EACL,MAAM,CAcP,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,iBACuB,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,EAAE,sBAoCpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,EACpD,YAAY,UAAU,CAAC,0BAA0B,KAChD,UAAU,CAAC,KAAK,EAAE,MAAM,CAAoC,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,EAC1D,YAAY,UAAU,CAAC,uBAAuB,KAC7C,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAkBhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,EACxE,YAAY,UAAU,CAAC,0BAA0B,KAChD,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAyEhC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAO,UAAU,GAC5C,yBAAyB,GACzB,uBAWD,CAAC"}

package/dist/src/Worker.js

@@ -1,7 +1,84 @@
-import { assert, createConsole, createConsoleStoreOutput } from "@evolu/common";
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { assert, assertNotDisposed, createConsole, createConsoleStoreOutput, } from "@evolu/common";
 /** Creates a {@link Worker} from a Web Worker. */
 export const createWorker = (nativeWorker) => wrap(nativeWorker);
-/** Creates an Evolu {@link SharedWorker} from a Web SharedWorker. */
+/**
+ * Installs a one-tab SharedWorker polyfill backed by a Web Worker.
+ *
+ * Use it before constructing a SharedWorker in browsers without native
+ * SharedWorker support.
+ */
+export const installOneTabSharedWorkerPolyfill = () => {
+    if (typeof globalThis.SharedWorker === "function")
+        return;
+    Object.defineProperty(globalThis, "SharedWorker", {
+        configurable: true,
+        writable: true,
+        value: class {
+            port;
+            constructor(scriptURL, options) {
+                this.port = new globalThis.Worker(scriptURL, options);
+            }
+        },
+    });
+};
+/**
+ * Creates a {@link SharedWorker} from a Web SharedWorker.
+ *
+ * Call {@link installOneTabSharedWorkerPolyfill} first to support browsers
+ * without native SharedWorker support.
+ */
 export const createSharedWorker = (nativeSharedWorker) => {
     const port = wrap(nativeSharedWorker.port);
     return {
@@ -21,15 +98,26 @@ export const createSharedWorker = (nativeSharedWorker) => {
  * ```
  */
 export const createMessageChannel = () => {
-    const channel = new globalThis.MessageChannel();
-    const stack = new DisposableStack();
-    return {
-        port1: stack.use(wrap(channel.port1)),
-        port2: stack.use(wrap(channel.port2)),
-        [Symbol.dispose]: () => {
-            stack.dispose();
-        },
-    };
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const channel = new globalThis.MessageChannel();
+        const disposer = __addDisposableResource(env_1, new DisposableStack(), false);
+        const port1 = disposer.use(wrap(channel.port1));
+        const port2 = disposer.use(wrap(channel.port2));
+        const disposables = disposer.move();
+        return {
+            port1,
+            port2,
+            [Symbol.dispose]: () => disposables.dispose(),
+        };
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
 };
 /**
  * Creates an Evolu {@link MessagePort} from a Web MessagePort.
@@ -37,6 +125,47 @@ export const createMessageChannel = () => {
  * Use this for ports received via postMessage transfer.
  */
 export const createMessagePort = (nativePort) => wrap(nativePort);
+/** Creates an Evolu {@link BroadcastChannel} from a Web BroadcastChannel. */
+export const createBroadcastChannel = (name) => {
+    const env_2 = { stack: [], error: void 0, hasError: false };
+    try {
+        const nativeBroadcastChannel = new globalThis.BroadcastChannel(name);
+        const disposer = __addDisposableResource(env_2, new DisposableStack(), false);
+        disposer.defer(() => {
+            nativeBroadcastChannel.onmessage = null;
+            nativeBroadcastChannel.close();
+        });
+        const disposables = disposer.move();
+        let onMessageHandler = null;
+        return {
+            postMessage: (message) => {
+                assertNotDisposed(disposables);
+                nativeBroadcastChannel.postMessage(message);
+            },
+            get onMessage() {
+                return disposables.disposed ? null : onMessageHandler;
+            },
+            set onMessage(fn) {
+                if (disposables.disposed)
+                    return;
+                onMessageHandler = fn;
+                nativeBroadcastChannel.onmessage = fn
+                    ? (event) => {
+                        fn(event.data);
+                    }
+                    : null;
+            },
+            [Symbol.dispose]: () => disposables.dispose(),
+        };
+    }
+    catch (e_2) {
+        env_2.error = e_2;
+        env_2.hasError = true;
+    }
+    finally {
+        __disposeResources(env_2);
+    }
+};
 /**
  * Creates an Evolu {@link WorkerSelf} from a Web `DedicatedWorkerGlobalScope`
  * (`self` inside a dedicated worker).
@@ -62,6 +191,95 @@ export const createSharedWorkerSelf = (nativeSelf) => {
     };
     return self;
 };
+/**
+ * Creates a one-tab {@link SharedWorkerSelf} polyfill for browsers without
+ * native SharedWorker support.
+ *
+ * Delivers one synthetic `onConnect` port, queues startup messages until
+ * `onMessage` is set, and does not share state across tabs.
+ */
+export const createOneTabSharedWorkerSelfPolyfill = (nativeSelf) => {
+    const env_3 = { stack: [], error: void 0, hasError: false };
+    try {
+        const disposer = __addDisposableResource(env_3, new DisposableStack(), false);
+        let onConnectHandler = null;
+        let onMessageHandler = null;
+        const messages = [];
+        let connected = false;
+        disposer.defer(() => {
+            messages.length = 0;
+            onConnectHandler = null;
+            onMessageHandler = null;
+            nativeSelf.onmessage = null;
+            nativeSelf.close();
+        });
+        const disposables = disposer.move();
+        nativeSelf.onmessage = (event) => {
+            if (disposables.disposed)
+                return;
+            const handler = onMessageHandler;
+            if (handler)
+                handler(event.data);
+            else
+                messages.push(event.data);
+        };
+        const flushMessages = () => {
+            for (const message of messages.splice(0)) {
+                const handler = onMessageHandler;
+                if (!handler)
+                    return;
+                handler(message);
+            }
+        };
+        const port = {
+            postMessage: (message, transfer) => {
+                if (disposables.disposed)
+                    return;
+                if (transfer == null)
+                    nativeSelf.postMessage(message);
+                else
+                    nativeSelf.postMessage(message, [...transfer]);
+            },
+            get onMessage() {
+                return disposables.disposed ? null : onMessageHandler;
+            },
+            set onMessage(fn) {
+                if (disposables.disposed)
+                    return;
+                onMessageHandler = fn;
+                if (fn)
+                    flushMessages();
+            },
+            native: nativeSelf,
+            [Symbol.dispose]: () => disposables.dispose(),
+        };
+        const connect = () => {
+            if (connected || !onConnectHandler)
+                return;
+            connected = true;
+            onConnectHandler(port);
+        };
+        return {
+            get onConnect() {
+                return onConnectHandler;
+            },
+            set onConnect(fn) {
+                if (disposables.disposed)
+                    return;
+                onConnectHandler = fn;
+                connect();
+            },
+            [Symbol.dispose]: () => disposables.dispose(),
+        };
+    }
+    catch (e_3) {
+        env_3.error = e_3;
+        env_3.hasError = true;
+    }
+    finally {
+        __disposeResources(env_3);
+    }
+};
 /** Creates deps shared by web worker entry points. */
 export const createWorkerDeps = () => {
     const consoleStoreOutput = createConsoleStoreOutput();
@@ -69,6 +287,8 @@ export const createWorkerDeps = () => {
     return {
         console,
         consoleStoreOutputEntry: consoleStoreOutput.entry,
+        createBroadcastChannel,
+        createMessageChannel,
         createMessagePort,
     };
 };
@@ -99,7 +319,7 @@ const wrap = (native) => {
         native: native,
         [Symbol.dispose]: () => {
             native.onmessage = null;
-            if (native instanceof globalThis.Worker)
+            if ("terminate" in native)
                 native.terminate();
             else
                 native.close();