@evolu/web 3.1.2 → 3.3.0

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

@@ -1 +1 @@
-{"version":3,"file":"Platform.d.ts","sourceRoot":"","sources":["../../src/Platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5D,+DAA+D;AAC/D,eAAO,MAAM,eAAe,QAAO,OAIlC,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,QAAO,WACY,CAAC;AAErD,eAAO,MAAM,SAAS,EAAE,SAMvB,CAAC"}
+{"version":3,"file":"Platform.d.ts","sourceRoot":"","sources":["../../src/Platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE5D,+DAA+D;AAC/D,eAAO,MAAM,eAAe,QAAO,OAIlC,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,QAAO,WACY,CAAC;AAErD,eAAO,MAAM,SAAS,EAAE,SAOvB,CAAC"}

package/dist/src/Platform.js

@@ -10,5 +10,8 @@ export const reloadApp = (url) => {
     if (typeof document === "undefined") {
         return;
     }
-    location.replace(url ?? "/");
+    if (url === undefined)
+        location.reload();
+    else
+        location.replace(url);
 };

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;AAiCnE,eAAO,MAAM,sBAAsB,EAAE,kBAoHlC,CAAC"}
+{"version":3,"file":"Sqlite.d.ts","sourceRoot":"","sources":["../../src/Sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAa,MAAM,eAAe,CAAC;AAqCnE,eAAO,MAAM,sBAAsB,EAAE,kBAyLlC,CAAC"}

package/dist/src/Sqlite.js

@@ -50,7 +50,7 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 });
-import { bytesToHex, createPreparedStatementsCache, exhaustiveCheck, ok, } from "@evolu/common";
+import { bytesToHex, createPreparedStatementsCache, exhaustiveCheck, ok, performanceDurationBetween, PositiveMillis, sleep, tryAsync, } from "@evolu/common";
 import sqlite3InitModule, {} from "@evolu/sqlite-wasm";
 // @ts-expect-error Missing types.
 globalThis.sqlite3ApiConfig = {
@@ -67,7 +67,7 @@ globalThis.sqlite3ApiConfig = {
 // Init ASAP.
 const sqlite3Promise = sqlite3InitModule();
 const fileName = "evolu1.db";
-export const createWasmSqliteDriver = (name, options) => async () => {
+export const createWasmSqliteDriver = (name, options) => async (run) => {
     const env_1 = { stack: [], error: void 0, hasError: false };
     try {
         const sqlite3 = await sqlite3Promise;
@@ -77,6 +77,57 @@ export const createWasmSqliteDriver = (name, options) => async () => {
         });
         let deleteDatabaseFile = false;
         const createOpfsSAHPoolVfs = async (options) => {
+            // Evolu opens a database only while it holds the database lock, but a
+            // DbWorker that ended without closing it, because its tab closed,
+            // crashed or navigated away, can hold pool files after the lock has
+            // passed on: WebKit releases a terminated worker's locks and its files
+            // separately, in no set order. sqlite-wasm cannot set up a pool with a
+            // held file, and it then deletes the pool directory, which the held file
+            // usually but not always prevents. Only a worker that has ended can hold
+            // the files, and it can only release them, so the pool is set up once
+            // every file opens.
+            const canOpenPoolFiles = async () => {
+                const root = await navigator.storage.getDirectory();
+                // sqlite-wasm keeps the pool in `.${name}/.opaque` in both OPFS modes.
+                const poolDirectory = await tryAsync(() => root.getDirectoryHandle(`.${name}`));
+                if (!poolDirectory.ok)
+                    return true;
+                const opaqueDirectory = await tryAsync(() => poolDirectory.value.getDirectoryHandle(".opaque"));
+                if (!opaqueDirectory.ok)
+                    return true;
+                for await (const handle of opaqueDirectory.value.values()) {
+                    if (handle.kind !== "file")
+                        continue;
+                    const accessHandle = await tryAsync(() => handle.createSyncAccessHandle());
+                    if (!accessHandle.ok) {
+                        // WebKit rejects a held file with InvalidStateError, other
+                        // engines with NoModificationAllowedError, as the spec says.
+                        // WebKit also uses InvalidStateError for a closed or invalid
+                        // handle and a stopped context. A retry opens fresh handles from
+                        // a new listing, and a stopped context ends the loop with its
+                        // worker, so retrying those is harmless.
+                        if (accessHandle.error instanceof DOMException &&
+                            (accessHandle.error.name === "InvalidStateError" ||
+                                accessHandle.error.name === "NoModificationAllowedError"))
+                            return false;
+                        throw accessHandle.error;
+                    }
+                    accessHandle.value.close();
+                }
+                return true;
+            };
+            const waitStart = run.deps.time.performance.now();
+            let retryDelay = 50;
+            let isWaitReported = false;
+            while (!(await canOpenPoolFiles())) {
+                const waited = performanceDurationBetween(waitStart, run.deps.time.performance.now());
+                if (!isWaitReported && waited >= 5000) {
+                    isWaitReported = true;
+                    run.deps.console.warn(`Waiting for an ended DbWorker to release the files of database ${name}.`);
+                }
+                await run.ok(sleep(PositiveMillis.orThrow(retryDelay)));
+                retryDelay = Math.min(retryDelay * 2, 1000);
+            }
             const pool = await sqlite3.installOpfsSAHPoolVfs(options);
             if (pool.isPaused())
                 await pool.unpauseVfs();
@@ -128,17 +179,24 @@ export const createWasmSqliteDriver = (name, options) => async () => {
             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({}));
+                    try {
+                        if (query.parameters.length > 0)
+                            prepared.bind(query.parameters);
+                        const rows = [];
+                        while (prepared.step()) {
+                            rows.push(prepared.get({}));
+                        }
+                        return {
+                            rows: rows,
+                            changes: db.changes(),
+                        };
+                    }
+                    finally {
+                        // SQLite refuses to bind a statement whose step failed until it is
+                        // reset. That reset returns the step's error again, which
+                        // PreparedStatement.reset would throw over the original one.
+                        sqlite3.capi.sqlite3_reset(prepared);
                     }
-                    prepared.reset();
-                    return {
-                        rows: rows,
-                        changes: db.changes(),
-                    };
                 }
                 const rows = db.exec(query.sql, {
                     returnValue: "resultRows",

package/dist/src/Task.d.ts

@@ -7,13 +7,16 @@ import { type DisposableRun, type RunCustomDeps } from "@evolu/common";
 /**
  * Creates a root {@link Run} for the browser.
  *
- * Defects are reported with the browser's global `reportError`. A custom
- * `reportDefect` dependency overrides the browser default.
+ * Defects are reported with the browser's global `reportError` as an `Error`
+ * from {@link defectToError}, because browsers show any other value only as
+ * unhelpful text. A custom `reportDefect` dependency overrides the browser
+ * default.
  *
  * ### Example
  *
  * ```ts
  * import {
+ *   assertEqual,
  *   createConsole,
  *   createConsoleFormatter,
  *   ok,
@@ -29,7 +32,7 @@ import { type DisposableRun, type RunCustomDeps } from "@evolu/common";
  * await using run = createRun({ console });
  * const appPromise = run.ok(() => ok("started"));
  *
- * expect(await appPromise).toBe("started");
+ * assertEqual(await appPromise, "started");
  * ```
  */
 export declare function createRun(): DisposableRun;

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,EAEL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAAC;AAE3C,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACrB,aAAa,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../src/Task.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAAC;AAE3C,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACrB,aAAa,CAAC,CAAC,CAAC,CAAC"}

package/dist/src/Task.js

@@ -3,10 +3,10 @@
  *
  * @module
  */
-import { createRun as createCommonRun, } from "@evolu/common";
+import { createRun as createCommonRun, defectToError, } from "@evolu/common";
 export function createRun(deps) {
     const reportDefect = (reported) => {
-        reportError(reported);
+        reportError(defectToError(reported));
     };
     return deps === undefined
         ? createCommonRun({ reportDefect })

package/dist/src/Worker.d.ts

@@ -44,7 +44,9 @@ export declare const createWorkerSelf: <Input, Output = never>(nativeSelf: Dedic
  * Creates an Evolu {@link SharedWorkerSelf} from a Web `SharedWorkerGlobalScope`
  * (`self` inside a shared worker).
  *
- * Disposing closes the shared worker scope for all connected clients.
+ * Disposing closes the shared worker scope for all connected clients. Browsers
+ * never pass a shared worker's uncaught errors to its pages; see
+ * {@link addUncaughtErrorListener}.
  */
 export declare const createSharedWorkerSelf: <Input, Output = never>(nativeSelf: SharedWorkerGlobalScope) => SharedWorkerSelf<Input, Output>;
 /**
@@ -55,6 +57,41 @@ export declare const createSharedWorkerSelf: <Input, Output = never>(nativeSelf:
  * `onMessage` is set, and does not share state across tabs.
  */
 export declare const createOneTabSharedWorkerSelfPolyfill: <Input, Output = never>(nativeSelf: DedicatedWorkerGlobalScope) => SharedWorkerSelf<Input, Output>;
+/**
+ * Passes each uncaught error and unhandled rejection of a worker global scope
+ * to `listener` as an `Error` from {@link defectToError}.
+ *
+ * Browsers never pass a shared worker's uncaught errors to a page's error
+ * handlers, and no worker passes its unhandled rejections to its page. A shared
+ * worker calls this with its global scope, `self`, to send them to its pages,
+ * for example over a BroadcastChannel. Defects of a Run from {@link createRun}
+ * arrive too, because it reports them with `reportError`, which dispatches
+ * "error" on the global scope.
+ *
+ * The events stay uncanceled, so the browser still logs them, and a dedicated
+ * worker still passes its uncaught errors to its page. The listeners stay until
+ * disposal, so they also receive errors after a Run's panic.
+ *
+ * ### Example
+ *
+ * ```ts
+ * import { assertEqual } from "@evolu/common";
+ * import { addUncaughtErrorListener } from "@evolu/web";
+ *
+ * const messages: Array<string> = [];
+ * // A worker passes its global scope, `self`.
+ * const scope = new EventTarget();
+ * using _listener = addUncaughtErrorListener(scope, (error) => {
+ *   messages.push(error.message);
+ * });
+ *
+ * scope.dispatchEvent(
+ *   Object.assign(new Event("error"), { error: new Error("unexpected") }),
+ * );
+ * assertEqual(messages, ["unexpected"]);
+ * ```
+ */
+export declare const addUncaughtErrorListener: (scope: EventTarget, listener: (error: Error) => void) => Disposable;
 /** Creates deps shared by web worker entry points. */
 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,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,gBAC1B,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,sBAClC,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,sBAwCpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cACxC,0BAA0B,KACrC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAoC,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cAC9C,uBAAuB,KAClC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAoBhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cAC5D,0BAA0B,KACrC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CA2EhC,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAO,UAAU,GAC5C,yBAAyB,GACzB,uBAWD,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;AAUvB,kDAAkD;AAClD,eAAO,MAAM,YAAY,GAAI,KAAK,EAAE,MAAM,gBAC1B,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,sBAClC,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,sBAwCpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cACxC,0BAA0B,KACrC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAoC,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cAC9C,uBAAuB,KAClC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAoBhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cAC5D,0BAA0B,KACrC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CA2EhC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,wBAAwB,UAC5B,WAAW,YACR,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAC/B,UAsBF,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,QAAO,UAAU,GAC5C,yBAAyB,GACzB,uBAWD,CAAC"}

package/dist/src/Worker.js

@@ -50,7 +50,7 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 });
-import { assertNonNullable, createConsole, createConsoleStoreOutput, disposable, } from "@evolu/common";
+import { assertNonNullable, createConsole, createConsoleStoreOutput, defectToError, disposable, } from "@evolu/common";
 /** Creates a {@link Worker} from a Web Worker. */
 export const createWorker = (nativeWorker) => wrap(nativeWorker);
 /**
@@ -176,7 +176,9 @@ export const createWorkerSelf = (nativeSelf) => wrap(nativeSelf);
  * Creates an Evolu {@link SharedWorkerSelf} from a Web `SharedWorkerGlobalScope`
  * (`self` inside a shared worker).
  *
- * Disposing closes the shared worker scope for all connected clients.
+ * Disposing closes the shared worker scope for all connected clients. Browsers
+ * never pass a shared worker's uncaught errors to its pages; see
+ * {@link addUncaughtErrorListener}.
  */
 export const createSharedWorkerSelf = (nativeSelf) => {
     const self = {
@@ -285,6 +287,63 @@ export const createOneTabSharedWorkerSelfPolyfill = (nativeSelf) => {
         __disposeResources(env_3);
     }
 };
+/**
+ * Passes each uncaught error and unhandled rejection of a worker global scope
+ * to `listener` as an `Error` from {@link defectToError}.
+ *
+ * Browsers never pass a shared worker's uncaught errors to a page's error
+ * handlers, and no worker passes its unhandled rejections to its page. A shared
+ * worker calls this with its global scope, `self`, to send them to its pages,
+ * for example over a BroadcastChannel. Defects of a Run from {@link createRun}
+ * arrive too, because it reports them with `reportError`, which dispatches
+ * "error" on the global scope.
+ *
+ * The events stay uncanceled, so the browser still logs them, and a dedicated
+ * worker still passes its uncaught errors to its page. The listeners stay until
+ * disposal, so they also receive errors after a Run's panic.
+ *
+ * ### Example
+ *
+ * ```ts
+ * import { assertEqual } from "@evolu/common";
+ * import { addUncaughtErrorListener } from "@evolu/web";
+ *
+ * const messages: Array<string> = [];
+ * // A worker passes its global scope, `self`.
+ * const scope = new EventTarget();
+ * using _listener = addUncaughtErrorListener(scope, (error) => {
+ *   messages.push(error.message);
+ * });
+ *
+ * scope.dispatchEvent(
+ *   Object.assign(new Event("error"), { error: new Error("unexpected") }),
+ * );
+ * assertEqual(messages, ["unexpected"]);
+ * ```
+ */
+export const addUncaughtErrorListener = (scope, listener) => {
+    const env_4 = { stack: [], error: void 0, hasError: false };
+    try {
+        const disposer = __addDisposableResource(env_4, new DisposableStack(), false);
+        const { signal } = disposer.adopt(new AbortController(), (controller) => {
+            controller.abort();
+        });
+        scope.addEventListener("error", (event) => {
+            listener(defectToError(event.error));
+        }, { signal });
+        scope.addEventListener("unhandledrejection", (event) => {
+            listener(defectToError(event.reason));
+        }, { signal });
+        return disposable({}, disposer);
+    }
+    catch (e_4) {
+        env_4.error = e_4;
+        env_4.hasError = true;
+    }
+    finally {
+        __disposeResources(env_4);
+    }
+};
 /** Creates deps shared by web worker entry points. */
 export const createWorkerDeps = () => {
     const consoleStoreOutput = createConsoleStoreOutput();

package/dist/src/local-first/Evolu.d.ts

@@ -1,4 +1,4 @@
-import { type ConsoleDep } from "@evolu/common";
+import { type ConsoleDep, type ReloadAppDep } from "@evolu/common";
 import type { EvoluDeps } from "@evolu/common/local-first";
 export interface SharedWorkerUnsupported {
     readonly type: "SharedWorkerUnsupported";
@@ -6,6 +6,50 @@ export interface SharedWorkerUnsupported {
 export interface SharedWorkerUnsupportedDep {
     readonly onSharedWorkerUnsupported: () => void;
 }
-/** Creates Evolu dependencies for the web platform. */
-export declare const createEvoluDeps: (deps?: Partial<ConsoleDep> & Partial<SharedWorkerUnsupportedDep>) => EvoluDeps;
+export interface StorageUnavailableDep {
+    /**
+     * Called when the browser offers no persistent storage, as in Safari's
+     * Private Browsing, so every database is kept in memory. See Storage in the
+     * Shared module of `@evolu/common`.
+     *
+     * The app keeps working. Data synced with a relay comes back, as on a new
+     * device, and nothing stays on the device once the tabs close. That suits
+     * someone checking their app on a borrowed phone, so a message such as
+     * "Nothing from this session is kept on this device." tells the user what to
+     * expect. Data that exists only locally, or has not synced yet, is lost when
+     * the tab hosting the database closes or navigates away, even while other
+     * tabs stay open.
+     */
+    readonly onStorageUnavailable: () => void;
+}
+/**
+ * Creates Evolu dependencies for the web platform.
+ *
+ * When another build of the app waits for this one, this tab reloads to load
+ * the build the server now serves: at once if the user is not in the tab,
+ * otherwise once they leave it. See Builds in the Shared module of
+ * `@evolu/common`. A tab whose database refuses to start with
+ * {@link UnsupportedDbVersionError} reloads once for each stored version, even
+ * while the user is in it, because the server may now serve a build that
+ * supports the database. The error is reported when the reloaded build refuses
+ * it too, or when the tab has no session storage. A tab whose worker was
+ * relaunched without its state, as WebKit does when the process hosting it
+ * ends, also reloads at once.
+ *
+ * When the page enters the browser's back-forward cache, as Safari does on
+ * every navigation away, this tab ends its part as if it closed: it stops the
+ * database workers it hosts, so another tab takes them over, and it reloads if
+ * the user comes back to it.
+ *
+ * Where the browser offers no persistent storage, as in Safari's Private
+ * Browsing, the database is kept in memory, and
+ * {@link StorageUnavailableDep.onStorageUnavailable} lets the app tell the
+ * user.
+ *
+ * A custom {@link ReloadApp} replaces the default page reload, for example to
+ * save state first. It should end by reloading the page, because the other
+ * build waits until this tab reloads or closes, and a page restored from the
+ * back-forward cache cannot work until it reloads.
+ */
+export declare const createEvoluDeps: (deps?: Partial<ConsoleDep> & Partial<ReloadAppDep> & Partial<SharedWorkerUnsupportedDep> & Partial<StorageUnavailableDep>) => EvoluDeps;
 //# sourceMappingURL=Evolu.d.ts.map

package/dist/src/local-first/Evolu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Evolu.d.ts","sourceRoot":"","sources":["../../../src/local-first/Evolu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAIV,SAAS,EAGV,MAAM,2BAA2B,CAAC;AAiBnC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,IAAI,CAAC;CAChD;AAED,uDAAuD;AACvD,eAAO,MAAM,eAAe,UACpB,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,KAC9D,SAkEF,CAAC"}
+{"version":3,"file":"Evolu.d.ts","sourceRoot":"","sources":["../../../src/local-first/Evolu.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAEf,KAAK,YAAY,EAElB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAIV,SAAS,EAIV,MAAM,2BAA2B,CAAC;AAgBnC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,eAAe,UACpB,OAAO,CAAC,UAAU,CAAC,GACvB,OAAO,CAAC,YAAY,CAAC,GACrB,OAAO,CAAC,0BAA0B,CAAC,GACnC,OAAO,CAAC,qBAAqB,CAAC,KAC/B,SAiPF,CAAC"}