@evolu/common 8.13.0 → 8.14.0

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

@@ -263,6 +263,36 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> extends AsyncDisposa
     readonly name: Name;
     /** {@link AppOwner}. */
     readonly appOwner: AppOwner;
+    /**
+     * Whether this device keeps the database, resolved once the shared worker
+     * serves it, or `Unknown` if this instance is disposed first.
+     *
+     * Apps tell the user when it is `NotPersisted`, because then data that has
+     * not synced is lost when the database closes. Apps must not tell the user
+     * that data is saved on the device when it is `Unknown`.
+     *
+     * ### Example
+     *
+     * ```ts
+     * import { assertEqual } from "@evolu/common";
+     * import type { DevicePersistence } from "@evolu/common/local-first";
+     *
+     * // The notice for `await evolu.devicePersistence`, or null for none.
+     * const persistenceNotice = (
+     *   devicePersistence: DevicePersistence,
+     * ): string | null =>
+     *   devicePersistence === "NotPersisted"
+     *     ? "Your data isn't kept on this device. Changes that haven't synced are lost when you close this tab."
+     *     : null;
+     *
+     * assertEqual(persistenceNotice("Unknown"), null);
+     * assertEqual(
+     *   persistenceNotice("NotPersisted"),
+     *   "Your data isn't kept on this device. Changes that haven't synced are lost when you close this tab.",
+     * );
+     * ```
+     */
+    readonly devicePersistence: Promise<DevicePersistence>;
     /**
      * Inserts a row and returns the generated {@link Id}.
      *
@@ -723,6 +753,27 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> extends AsyncDisposa
  * @group Core
  */
 export type UnuseOwner = () => void;
+/**
+ * Whether this device keeps an {@link Evolu} database, stating only what Evolu
+ * knows for sure.
+ *
+ * - `Persisted`: the platform stores it in the app's own file, as React Native
+ *   does.
+ * - `NotPersisted`: it is kept in memory, because {@link EvoluConfig.memoryOnly}
+ *   asks for that or the platform offers no persistent storage, as a browser
+ *   does in Safari's Private Browsing or a Firefox private window. Data that
+ *   has not synced is lost when the database closes.
+ * - `Unknown`: it is stored, but the platform may delete it. A browser can keep
+ *   storage only for a private session, as Chrome's incognito does without
+ *   telling the app, delete it after a while or when disk space runs low, and
+ *   let the user clear it.
+ *
+ * See [Will my data stay on the
+ * device?](https://www.evolu.dev/docs/faq#will-my-data-stay-on-the-device).
+ *
+ * @group Core
+ */
+export type DevicePersistence = "Persisted" | "NotPersisted" | "Unknown";
 /**
  * Represents app-level errors that can occur in {@link Evolu}.
  *
@@ -936,6 +987,19 @@ export interface SyncStateDep {
      */
     readonly syncState: ReadonlyStore<SyncState | null>;
 }
+/**
+ * Asks the platform to keep stored databases until the user deletes them.
+ *
+ * Only unsynced local changes exist nowhere else, so each {@link Evolu} instance
+ * calls it after its first local mutation, when its
+ * {@link Evolu.devicePersistence} is `Unknown`. A platform provides it when its
+ * storage can be deleted without the user, as a browser's can.
+ *
+ * @group Construction
+ */
+export interface RequestPersistentStorageDep {
+    readonly requestPersistentStorage: () => void;
+}
 /**
  * Shared platform dependencies for creating {@link Evolu} instances.
  *
@@ -949,11 +1013,11 @@ export type EvoluDeps = EvoluPlatformDeps & ConsoleDep & EvoluErrorDep & SyncSta
  * Platform-specific dependencies required to create {@link EvoluDeps}.
  *
  * Provides worker and channel adapters plus optional platform integrations for
- * logging and synchronous UI flush.
+ * logging, synchronous UI flush, and persistent storage requests.
  *
  * @group Construction
  */
-export type EvoluPlatformDeps = CreateDbWorkerDep & CreateBroadcastChannelDep & CreateMessageChannelDep & LockManagerDep & ReloadAppDep & SharedWorkerDep & Partial<ConsoleDep> & Partial<FlushSyncDep>;
+export type EvoluPlatformDeps = CreateDbWorkerDep & CreateBroadcastChannelDep & CreateMessageChannelDep & LockManagerDep & ReloadAppDep & SharedWorkerDep & Partial<ConsoleDep> & Partial<FlushSyncDep> & Partial<RequestPersistentStorageDep>;
 /**
  * Creates shared dependencies used by all {@link createEvolu} instances on a
  * platform.

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":"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"}
+{"version":3,"file":"Evolu.d.ts","sourceRoot":"","sources":["../../../src/local-first/Evolu.ts"],"names":[],"mappings":"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"}

package/dist/src/local-first/Evolu.js

@@ -210,9 +210,7 @@ export const createEvoluDeps = (deps) => {
                     console.error(message.error);
                     break;
                 case "Waiting":
-                case "StorageUnavailable":
-                    // Platform adapters act on these; see Builds and Storage in the Shared
-                    // module.
+                    // Platform adapters act on it; see Builds in the Shared module.
                     break;
                 case "Connected": {
                     assert(!syncStateBroadcastChannel, "The shared worker connects once.");
@@ -344,6 +342,12 @@ export const createEvolu = (schema, config) => async (run) => {
             exportDatabasePending?.reject({ type: "EvoluDisposedError" });
             exportDatabasePending = null;
         });
+        const devicePersistence = Promise.withResolvers();
+        // A disposed instance never hears from its tenant, so awaiters settle.
+        disposer.defer(() => {
+            devicePersistence.resolve("Unknown");
+        });
+        let isPersistentStorageRequested = false;
         let postMessage;
         // Scope worker/channel wiring and keep only postMessage outside.
         {
@@ -412,6 +416,9 @@ export const createEvolu = (schema, config) => async (run) => {
                         }
                         break;
                     }
+                    case "OnDevicePersistence":
+                        devicePersistence.resolve(message.devicePersistence);
+                        break;
                     default:
                         exhaustiveCheck(message);
                 }
@@ -497,6 +504,17 @@ export const createEvolu = (schema, config) => async (run) => {
                 const size = measureMutation(dbChange.table, dbChange.values);
                 assert(size <= maxMutationSize, `The mutation of table '${dbChange.table}' is ${size} bytes, over maxMutationSize (${maxMutationSize}). Bound the Types of its columns or check it with evolu.getMutationSize.`);
             }
+            // Only unsynced local changes exist nowhere else, so the first one is
+            // when asking the platform to keep them starts to matter. Asking on
+            // load would show Firefox's permission prompt to every visitor.
+            if (!isPersistentStorageRequested) {
+                isPersistentStorageRequested = true;
+                void devicePersistence.promise.then((persistence) => {
+                    if (persistence === "Unknown" && !disposed) {
+                        run.deps.requestPersistentStorage?.();
+                    }
+                });
+            }
             mutateBatch.push({
                 change: { ...dbChange, ownerId: options?.ownerId ?? appOwner.id },
                 onComplete: options?.onComplete,
@@ -555,6 +573,7 @@ export const createEvolu = (schema, config) => async (run) => {
         return ok(disposable({
             name,
             appOwner,
+            devicePersistence: devicePersistence.promise,
             insert: createMutation("insert"),
             update: createMutation("update"),
             upsert: createMutation("upsert"),

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

@@ -69,13 +69,20 @@
  *
  * ## Storage
  *
- * A platform that can lack persistent storage, as a browser does in Safari's
- * Private Browsing, provides {@link PersistentStorageDep}. The worker checks it
- * once, after it takes the build lock and before any DbWorker starts. Without
- * persistent storage, every DbWorker it starts keeps its database in memory,
- * replacements included, and each tab that connects is told with
- * `StorageUnavailable`. The decision holds for the worker's lifetime, so all
- * its tabs see one mode, and the next worker checks again.
+ * The platform tells the worker with {@link DevicePersistenceDep} what it can
+ * promise about stored databases. The worker asks once, after it takes the
+ * build lock and before any DbWorker starts. A browser checks whether it can
+ * open the origin private file system, which Safari's Private Browsing and
+ * Firefox's private windows refuse. Without persistent storage, every DbWorker
+ * the worker starts keeps its database in memory, replacements included. The
+ * decision holds for the worker's lifetime, so all its tabs see one mode, and
+ * the next worker checks again.
+ *
+ * A tenant tells each instance it adds its {@link Evolu.devicePersistence}:
+ * `NotPersisted` when its database is kept in memory, because of the platform
+ * or {@link EvoluConfig.memoryOnly}, otherwise what the platform promised.
+ * Instances of one name share the tenant, so a later instance gets the mode the
+ * first one chose.
  *
  * The check cannot tell a private session from a storage failure, but memory
  * loses nothing that refusing to start would have kept, and the persistent
@@ -262,6 +269,7 @@ import { type ExtractTyped, type Id, type InferType, type LiteralType, type Name
 import type { CreateWebSocketDep, WebSocketError } from "../WebSocket.ts";
 import type { SharedWorker as CommonSharedWorker, CreateBroadcastChannelDep, CreateMessageChannelDep, NativeMessagePort, SharedWorkerSelf, WorkerDeps } from "../Worker.ts";
 import type { DbWorkerInit, UnsupportedDbVersionError } from "./Db.ts";
+import type { DevicePersistence } from "./Evolu.ts";
 import type { Owner, OwnerId, SyncOwner } from "./Owner.ts";
 import { type ApplyProtocolMessageAsClientResult, type ProtocolError, type ProtocolInvalidDataError, type ProtocolMessage, type ProtocolTimestampMismatchError } from "./Protocol.ts";
 import { type Patch, type Query, type RowsByQueryMap } from "./Query.ts";
@@ -315,13 +323,6 @@ export type SharedWorkerOutput = DbWorkerInit | {
     readonly type: "Connected";
     readonly workerId: SharedWorkerId;
     readonly syncStateChannelName: string;
-} | {
-    /**
-     * Sent to a connecting tab after `Connected` when the platform offers no
-     * persistent storage, so the worker keeps every database in memory; see
-     * Storage in this module's documentation.
-     */
-    readonly type: "StorageUnavailable";
 };
 export type ConsoleEntryOrError = {
     readonly type: "ConsoleEntry";
@@ -593,22 +594,23 @@ export interface RelaySyncState {
  *   stops syncing through its relay, while a skipped change leaves out only
  *   that change.
  *
- * Evolu saves changes on the device before they sync, so sync needs no UI while
- * it works: show nothing for `NoRelays`, `Syncing`, and `Synced`. An indicator
- * that changes with every edit distracts, and screen readers announce each
- * change.
+ * Evolu stores changes in the local database before they sync, so sync needs no
+ * UI while it works: show nothing for `NoRelays`, `Syncing`, and `Synced`. An
+ * indicator that changes with every edit distracts, and screen readers announce
+ * each change.
  *
  * For `Offline` and `Error`, show one quiet line that lasts as long as the
  * status, not a dialog, which interrupts, or a toast, which disappears while
- * the problem lasts. Say that changes are saved on this device. Evolu reports
- * `Offline` at once; an app may wait a few seconds before showing it, because
- * brief disconnections, such as waking from sleep, reconnect quickly. For
- * `Error`, write actionable text for the error types the app can act on, such
- * as a {@link ProtocolQuotaError}: the relay stores no more data for the owner,
- * so offer more quota, such as a plan upgrade, then call
- * {@link Evolu.requestSync} with the owner's ID. For any other error, show
- * generic text that names the error type, which helps when the user reports
- * it.
+ * the problem lasts. Do not say that changes are saved on this device unless
+ * {@link Evolu.devicePersistence} is `Persisted`: a browser may keep them only
+ * for a private session or delete them later. Evolu reports `Offline` at once;
+ * an app may wait a few seconds before showing it, because brief
+ * disconnections, such as waking from sleep, reconnect quickly. For `Error`,
+ * write actionable text for the error types the app can act on, such as a
+ * {@link ProtocolQuotaError}: the relay stores no more data for the owner, so
+ * offer more quota, such as a plan upgrade, then call {@link Evolu.requestSync}
+ * with the owner's ID. For any other error, show generic text that names the
+ * error type, which helps when the user reports it.
  *
  * Render the line inside one element with `role="status"` that stays mounted:
  * screen readers announce changes only in a live region that already exists,
@@ -637,18 +639,18 @@ export interface RelaySyncState {
  *     case "Synced":
  *       return null;
  *     case "Offline":
- *       return "Offline. Your changes are saved on this device.";
+ *       return "Offline. Changes will sync when you're back online.";
  *     case "Error":
  *       return status.error.type === "ProtocolQuotaError"
- *         ? "Sync is paused because the sync server is full. Your changes are saved on this device."
- *         : `Sync error: ${status.error.type}. Your changes are saved on this device.`;
+ *         ? "Sync is paused because the sync server is full."
+ *         : `Sync error: ${status.error.type}.`;
  *   }
  * };
  *
  * assertEqual(syncStatusToMessage({ type: "Synced" }), null);
  * assertEqual(
  *   syncStatusToMessage({ type: "Offline" }),
- *   "Offline. Your changes are saved on this device.",
+ *   "Offline. Changes will sync when you're back online.",
  * );
  * assertEqual(
  *   syncStatusToMessage({
@@ -659,14 +661,14 @@ export interface RelaySyncState {
  *       at: Millis.orThrow(1000),
  *     },
  *   }),
- *   "Sync is paused because the sync server is full. Your changes are saved on this device.",
+ *   "Sync is paused because the sync server is full.",
  * );
  * assertEqual(
  *   syncStatusToMessage({
  *     type: "Error",
  *     error: { type: "SyncFailed", at: Millis.orThrow(1000) },
  *   }),
- *   "Sync error: SyncFailed. Your changes are saved on this device.",
+ *   "Sync error: SyncFailed.",
  * );
  * ```
  */
@@ -934,6 +936,10 @@ export type EvoluOutput = {
     /** The mutation with these onComplete callbacks could not be stored. */
     readonly type: "OnMutateFailed";
     readonly onCompleteIds: ReadonlyArray<Id>;
+} | {
+    /** Sent once, when the tenant adds the instance; see Storage. */
+    readonly type: "OnDevicePersistence";
+    readonly devicePersistence: DevicePersistence;
 };
 export type DbWorkerInput = (Typed<"Request"> & {
     readonly attemptId: Id;
@@ -1022,15 +1028,16 @@ export type DbWorkerQueuedResponse = {
     };
 };
 /**
- * Tells whether the platform can store databases persistently.
+ * Tells what the platform can promise about the databases it stores.
  *
- * Only a platform that can lack persistent storage provides it, as a browser
- * does in Safari's Private Browsing; see Storage in the Shared module.
+ * `NotPersisted` means the platform offers no persistent storage now, as a
+ * browser does in Safari's Private Browsing or a Firefox private window, so the
+ * worker keeps every database in memory; see Storage in the Shared module.
  */
-export interface PersistentStorageDep {
-    readonly isPersistentStorageAvailable: () => Promise<boolean>;
+export interface DevicePersistenceDep {
+    readonly getDevicePersistence: () => Promise<DevicePersistence>;
 }
-export type SharedWorkerDeps = WorkerDeps & CreateBroadcastChannelDep & CreateMessageChannelDep & CreateWebSocketDep & LockManagerDep & Partial<PersistentStorageDep>;
+export type SharedWorkerDeps = WorkerDeps & CreateBroadcastChannelDep & CreateMessageChannelDep & CreateWebSocketDep & DevicePersistenceDep & LockManagerDep;
 export type EvoluInstanceId = Id & Brand<"EvoluInstance">;
 /**
  * Initializes the platform-agnostic Evolu SharedWorker.

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

@@ -1 +1 @@
-{"version":3,"file":"Shared.d.ts","sourceRoot":"","sources":["../../../src/local-first/Shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Shared.d.ts","sourceRoot":"","sources":["../../../src/local-first/Shared.ts"],"names":[],"mappings":"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"}

package/dist/src/local-first/Shared.js

@@ -69,13 +69,20 @@
  *
  * ## Storage
  *
- * A platform that can lack persistent storage, as a browser does in Safari's
- * Private Browsing, provides {@link PersistentStorageDep}. The worker checks it
- * once, after it takes the build lock and before any DbWorker starts. Without
- * persistent storage, every DbWorker it starts keeps its database in memory,
- * replacements included, and each tab that connects is told with
- * `StorageUnavailable`. The decision holds for the worker's lifetime, so all
- * its tabs see one mode, and the next worker checks again.
+ * The platform tells the worker with {@link DevicePersistenceDep} what it can
+ * promise about stored databases. The worker asks once, after it takes the
+ * build lock and before any DbWorker starts. A browser checks whether it can
+ * open the origin private file system, which Safari's Private Browsing and
+ * Firefox's private windows refuse. Without persistent storage, every DbWorker
+ * the worker starts keeps its database in memory, replacements included. The
+ * decision holds for the worker's lifetime, so all its tabs see one mode, and
+ * the next worker checks again.
+ *
+ * A tenant tells each instance it adds its {@link Evolu.devicePersistence}:
+ * `NotPersisted` when its database is kept in memory, because of the platform
+ * or {@link EvoluConfig.memoryOnly}, otherwise what the platform promised.
+ * Instances of one name share the tenant, so a later instance gets the mode the
+ * first one chose.
  *
  * The check cannot tell a private session from a storage failure, but memory
  * loses nothing that refusing to start would have kept, and the persistent
@@ -806,9 +813,6 @@ export const initSharedWorker = (self) => async (run) => {
                     workerId,
                     syncStateChannelName,
                 });
-                if (isPersistentStorageUnavailable) {
-                    port.postMessage({ type: "StorageUnavailable" });
-                }
             });
         };
         // Held while this worker runs. Its DbWorkers stop once they can take it,
@@ -821,11 +825,10 @@ export const initSharedWorker = (self) => async (run) => {
         // Builds.
         disposer.use(await run.ok(acquireLeaderLock("tab")));
         starting.dispose();
-        // Checked once, before any DbWorker starts, so every DbWorker of this
-        // worker, replacements included, keeps its database in memory; see
-        // Storage.
-        const isPersistentStorageUnavailable = deps.isPersistentStorageAvailable !== undefined &&
-            !(await deps.isPersistentStorageAvailable());
+        // Checked once, before any DbWorker starts, so without persistent
+        // storage every DbWorker of this worker, replacements included, keeps its
+        // database in memory; see Storage.
+        const platformDevicePersistence = await deps.getDevicePersistence();
         disposer.defer(deps.consoleStoreOutputEntry.subscribe(() => {
             const entry = deps.consoleStoreOutputEntry.get();
             if (entry)
@@ -1193,9 +1196,11 @@ export const initSharedWorker = (self) => async (run) => {
             tabLeaderPortStore,
             transports,
         }));
-        const tenantsByName = disposer.use(await sharedWorkerRun.ok(createSharedResourceByKey((message) => createEvoluTenant(isPersistentStorageUnavailable
-            ? { ...message, memoryOnly: true }
-            : message, currentTenantsByName, workerId), {
+        const tenantsByName = disposer.use(await sharedWorkerRun.ok(createSharedResourceByKey((message) => {
+            const memoryOnly = message.memoryOnly ||
+                platformDevicePersistence === "NotPersisted";
+            return createEvoluTenant({ ...message, memoryOnly }, memoryOnly ? "NotPersisted" : platformDevicePersistence, currentTenantsByName, workerId);
+        }, {
             idleDisposeAfter: "3s",
             lookup: (message) => message.name,
         })));
@@ -1216,7 +1221,7 @@ export const initSharedWorker = (self) => async (run) => {
             await result_1;
     }
 };
-const createEvoluTenant = ({ name, consoleLevel, sqliteSchema, encryptionKey, memoryOnly, }, currentTenantsByName, workerId) => async (run) => {
+const createEvoluTenant = ({ name, consoleLevel, sqliteSchema, encryptionKey, memoryOnly, }, devicePersistence, currentTenantsByName, workerId) => async (run) => {
     const env_3 = { stack: [], error: void 0, hasError: false };
     try {
         const disposer = __addDisposableResource(env_3, new AsyncDisposableStack(), true);
@@ -2107,6 +2112,12 @@ const createEvoluTenant = ({ name, consoleLevel, sqliteSchema, encryptionKey, me
                 disposer.defer(() => {
                     instance.port.onMessage = null;
                 });
+                // Instances of one name share the tenant, so each learns the mode
+                // the first one chose.
+                instance.port.postMessage({
+                    type: "OnDevicePersistence",
+                    devicePersistence,
+                });
                 // The main-thread Evolu instance holds this per-instance leader lock
                 // while it is alive. Acquiring the same lock here means the main
                 // thread instance was disposed or its tab closed, so the tenant-side

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/common",
-  "version": "8.13.0",
+  "version": "8.14.0",
   "description": "TypeScript library and local-first platform",
   "keywords": [
     "evolu",

package/src/local-first/Evolu.test.ts

@@ -372,16 +372,6 @@ describe("Evolu", () => {
       assertSame(setup.deps.evoluError.get(), null);
     });
 
-    it("says nothing to a worker that reports it keeps databases in memory", async () => {
-      using setup = await setupCreateEvoluDeps();
-
-      setup.sharedWorkerPort.postMessage({ type: "StorageUnavailable" });
-      await testWaitForWorkerMessage();
-
-      assertEqual(setup.messages, []);
-      assertSame(setup.deps.evoluError.get(), null);
-    });
-
     it("announces itself as tab leader with its console level once its worker connects", async () => {
       const testConsole = testCreateConsole();
       using setup = await setupCreateEvoluDeps(testConsole);
@@ -1502,6 +1492,106 @@ describe("Evolu", () => {
     });
   });
 
+  describe("device persistence", () => {
+    const setupPersistenceRequests = async () => {
+      let requestCount = 0;
+      const setup = await setupRunWithEvoluDeps({
+        requestPersistentStorage: () => {
+          requestCount += 1;
+        },
+      });
+      return Object.assign(setup, { getRequestCount: () => requestCount });
+    };
+
+    it("resolves devicePersistence to what its tenant sends", async () => {
+      await using setup = await setupRunWithEvoluDeps();
+      const evolu = await setup.run.ok(testCreateEvolu);
+
+      setup.postEvoluOutput({
+        type: "OnDevicePersistence",
+        devicePersistence: "NotPersisted",
+      });
+
+      assertSame(await evolu.devicePersistence, "NotPersisted");
+    });
+
+    it("resolves devicePersistence to Unknown when disposed before its tenant sends it", async () => {
+      await using setup = await setupRunWithEvoluDeps();
+      const evolu = await setup.run.ok(testCreateEvolu);
+
+      await evolu[Symbol.asyncDispose]();
+
+      assertSame(await evolu.devicePersistence, "Unknown");
+    });
+
+    it("requests persistent storage once, after the first mutation, when devicePersistence is Unknown", async () => {
+      await using setup = await setupPersistenceRequests();
+      const evolu = await setup.run.ok(testCreateEvolu);
+      setup.postEvoluOutput({
+        type: "OnDevicePersistence",
+        devicePersistence: "Unknown",
+      });
+      await evolu.devicePersistence;
+      await testWaitForWorkerMessage();
+      assertSame(setup.getRequestCount(), 0);
+
+      evolu.insert("todo", { title: NonEmptyTrimmedString100.orThrow("A") });
+      evolu.insert("todo", { title: NonEmptyTrimmedString100.orThrow("B") });
+      await testWaitForWorkerMessage();
+      evolu.insert("todo", { title: NonEmptyTrimmedString100.orThrow("C") });
+      await testWaitForWorkerMessage();
+
+      assertSame(setup.getRequestCount(), 1);
+    });
+
+    it("requests persistent storage once devicePersistence resolves after the first mutation", async () => {
+      await using setup = await setupPersistenceRequests();
+      const evolu = await setup.run.ok(testCreateEvolu);
+
+      evolu.insert("todo", { title: NonEmptyTrimmedString100.orThrow("A") });
+      await testWaitForWorkerMessage();
+      assertSame(setup.getRequestCount(), 0);
+
+      setup.postEvoluOutput({
+        type: "OnDevicePersistence",
+        devicePersistence: "Unknown",
+      });
+      await evolu.devicePersistence;
+      await testWaitForWorkerMessage();
+
+      assertSame(setup.getRequestCount(), 1);
+    });
+
+    for (const devicePersistence of ["Persisted", "NotPersisted"] as const) {
+      it(`does not request persistent storage when devicePersistence is ${devicePersistence}`, async () => {
+        await using setup = await setupPersistenceRequests();
+        const evolu = await setup.run.ok(testCreateEvolu);
+        setup.postEvoluOutput({
+          type: "OnDevicePersistence",
+          devicePersistence,
+        });
+
+        evolu.insert("todo", { title: NonEmptyTrimmedString100.orThrow("A") });
+        await evolu.devicePersistence;
+        await testWaitForWorkerMessage();
+
+        assertSame(setup.getRequestCount(), 0);
+      });
+    }
+
+    it("does not request persistent storage after disposal", async () => {
+      await using setup = await setupPersistenceRequests();
+      const evolu = await setup.run.ok(testCreateEvolu);
+
+      evolu.insert("todo", { title: NonEmptyTrimmedString100.orThrow("A") });
+      await evolu[Symbol.asyncDispose]();
+      await evolu.devicePersistence;
+      await testWaitForWorkerMessage();
+
+      assertSame(setup.getRequestCount(), 0);
+    });
+  });
+
   describe("dispose evolu", () => {
     it("logs disposeEvolu once", async () => {
       const testConsole = testCreateConsole();

package/src/local-first/Evolu.ts

@@ -385,6 +385,37 @@ export interface Evolu<
   /** {@link AppOwner}. */
   readonly appOwner: AppOwner;
 
+  /**
+   * Whether this device keeps the database, resolved once the shared worker
+   * serves it, or `Unknown` if this instance is disposed first.
+   *
+   * Apps tell the user when it is `NotPersisted`, because then data that has
+   * not synced is lost when the database closes. Apps must not tell the user
+   * that data is saved on the device when it is `Unknown`.
+   *
+   * ### Example
+   *
+   * ```ts
+   * import { assertEqual } from "@evolu/common";
+   * import type { DevicePersistence } from "@evolu/common/local-first";
+   *
+   * // The notice for `await evolu.devicePersistence`, or null for none.
+   * const persistenceNotice = (
+   *   devicePersistence: DevicePersistence,
+   * ): string | null =>
+   *   devicePersistence === "NotPersisted"
+   *     ? "Your data isn't kept on this device. Changes that haven't synced are lost when you close this tab."
+   *     : null;
+   *
+   * assertEqual(persistenceNotice("Unknown"), null);
+   * assertEqual(
+   *   persistenceNotice("NotPersisted"),
+   *   "Your data isn't kept on this device. Changes that haven't synced are lost when you close this tab.",
+   * );
+   * ```
+   */
+  readonly devicePersistence: Promise<DevicePersistence>;
+
   /**
    * Inserts a row and returns the generated {@link Id}.
    *
@@ -873,6 +904,28 @@ export interface Evolu<
  */
 export type UnuseOwner = () => void;
 
+/**
+ * Whether this device keeps an {@link Evolu} database, stating only what Evolu
+ * knows for sure.
+ *
+ * - `Persisted`: the platform stores it in the app's own file, as React Native
+ *   does.
+ * - `NotPersisted`: it is kept in memory, because {@link EvoluConfig.memoryOnly}
+ *   asks for that or the platform offers no persistent storage, as a browser
+ *   does in Safari's Private Browsing or a Firefox private window. Data that
+ *   has not synced is lost when the database closes.
+ * - `Unknown`: it is stored, but the platform may delete it. A browser can keep
+ *   storage only for a private session, as Chrome's incognito does without
+ *   telling the app, delete it after a while or when disk space runs low, and
+ *   let the user clear it.
+ *
+ * See [Will my data stay on the
+ * device?](https://www.evolu.dev/docs/faq#will-my-data-stay-on-the-device).
+ *
+ * @group Core
+ */
+export type DevicePersistence = "Persisted" | "NotPersisted" | "Unknown";
+
 /**
  * Represents app-level errors that can occur in {@link Evolu}.
  *
@@ -1125,6 +1178,20 @@ export interface SyncStateDep {
   readonly syncState: ReadonlyStore<SyncState | null>;
 }
 
+/**
+ * Asks the platform to keep stored databases until the user deletes them.
+ *
+ * Only unsynced local changes exist nowhere else, so each {@link Evolu} instance
+ * calls it after its first local mutation, when its
+ * {@link Evolu.devicePersistence} is `Unknown`. A platform provides it when its
+ * storage can be deleted without the user, as a browser's can.
+ *
+ * @group Construction
+ */
+export interface RequestPersistentStorageDep {
+  readonly requestPersistentStorage: () => void;
+}
+
 /**
  * Shared platform dependencies for creating {@link Evolu} instances.
  *
@@ -1143,7 +1210,7 @@ export type EvoluDeps = EvoluPlatformDeps &
  * Platform-specific dependencies required to create {@link EvoluDeps}.
  *
  * Provides worker and channel adapters plus optional platform integrations for
- * logging and synchronous UI flush.
+ * logging, synchronous UI flush, and persistent storage requests.
  *
  * @group Construction
  */
@@ -1154,7 +1221,8 @@ export type EvoluPlatformDeps = CreateDbWorkerDep &
   ReloadAppDep &
   SharedWorkerDep &
   Partial<ConsoleDep> &
-  Partial<FlushSyncDep>;
+  Partial<FlushSyncDep> &
+  Partial<RequestPersistentStorageDep>;
 
 /**
  * Creates shared dependencies used by all {@link createEvolu} instances on a
@@ -1234,9 +1302,7 @@ export const createEvoluDeps = (deps: EvoluPlatformDeps): EvoluDeps => {
         break;
 
       case "Waiting":
-      case "StorageUnavailable":
-        // Platform adapters act on these; see Builds and Storage in the Shared
-        // module.
+        // Platform adapters act on it; see Builds in the Shared module.
         break;
 
       case "Connected": {
@@ -1423,6 +1489,13 @@ export const createEvolu =
       exportDatabasePending = null;
     });
 
+    const devicePersistence = Promise.withResolvers<DevicePersistence>();
+    // A disposed instance never hears from its tenant, so awaiters settle.
+    disposer.defer(() => {
+      devicePersistence.resolve("Unknown");
+    });
+    let isPersistentStorageRequested = false;
+
     let postMessage: (input: EvoluInput) => void;
 
     // Scope worker/channel wiring and keep only postMessage outside.
@@ -1512,6 +1585,10 @@ export const createEvolu =
             break;
           }
 
+          case "OnDevicePersistence":
+            devicePersistence.resolve(message.devicePersistence);
+            break;
+
           default:
             exhaustiveCheck(message);
         }
@@ -1639,6 +1716,18 @@ export const createEvolu =
           );
         }
 
+        // Only unsynced local changes exist nowhere else, so the first one is
+        // when asking the platform to keep them starts to matter. Asking on
+        // load would show Firefox's permission prompt to every visitor.
+        if (!isPersistentStorageRequested) {
+          isPersistentStorageRequested = true;
+          void devicePersistence.promise.then((persistence) => {
+            if (persistence === "Unknown" && !disposed) {
+              run.deps.requestPersistentStorage?.();
+            }
+          });
+        }
+
         mutateBatch.push({
           change: { ...dbChange, ownerId: options?.ownerId ?? appOwner.id },
           onComplete: options?.onComplete,
@@ -1722,6 +1811,7 @@ export const createEvolu =
         {
           name,
           appOwner,
+          devicePersistence: devicePersistence.promise,
 
           insert: createMutation("insert"),
           update: createMutation("update"),

package/src/local-first/Shared.test.ts

@@ -42,6 +42,7 @@ import {
   type ProtocolTimestampMismatchError,
   SubscriptionFlags,
 } from "./Protocol.ts";
+import type { DevicePersistence } from "./Evolu.ts";
 import {
   createQueryBuilder,
   type EvoluSchema,
@@ -170,11 +171,11 @@ const setupSharedWorker = async ({
   createWebSocket = testCreateWebSocket({ throwOnCreate: true }),
   time,
   seed,
-  isPersistentStorageAvailable,
+  getDevicePersistence = () => Promise.resolve("Unknown"),
 }: {
   createWebSocket?: CreateWebSocket;
   time?: TestTime;
-  isPersistentStorageAvailable?: () => Promise<boolean>;
+  getDevicePersistence?: () => Promise<DevicePersistence>;
   /**
    * Seeds the worker's random bytes, which are otherwise the same for every
    * worker.
@@ -214,7 +215,7 @@ const setupSharedWorker = async ({
       createWebSocket,
       ...(time && { time }),
       ...(seed && { randomBytes: testCreateDeps({ seed }).randomBytes }),
-      ...(isPersistentStorageAvailable && { isPersistentStorageAvailable }),
+      getDevicePersistence,
     }),
   );
 
@@ -239,8 +240,10 @@ const setupSharedWorker = async ({
     releaseDbWorkerLeaderOnDispose = true,
     autoDispose = true,
     initialClock = createTimestamp(),
+    memoryOnly = false,
   }: {
     tenantName?: Name;
+    memoryOnly?: boolean;
     evoluChannel?: TestMessageChannel<EvoluOutput, EvoluInput>;
     releaseDbWorkerLeaderOnDispose?: boolean;
     autoDispose?: boolean;
@@ -289,7 +292,7 @@ const setupSharedWorker = async ({
       consoleLevel: "debug",
       sqliteSchema: testSqliteSchema,
       encryptionKey: testAppOwner.encryptionKey,
-      memoryOnly: false,
+      memoryOnly,
       evoluPort: evoluChannel.port1.native,
     };
 
@@ -339,7 +342,25 @@ const setupSharedWorker = async ({
   ) => {
     const instance = await createEvoluBeforeDbWorkerLeader(options);
     await instance.acquireDbWorkerLeader();
-    return instance;
+
+    // Once the DbWorker starts, the tenant adds the instance and tells it its
+    // device persistence first, so tests see only the outputs that follow.
+    const firstOutputs: Array<EvoluOutput> = [];
+    instance.evoluChannel.port2.onMessage = (output) => {
+      firstOutputs.push(output);
+    };
+    await testWaitForWorkerMessage();
+    instance.evoluChannel.port2.onMessage = null;
+    assertLength(firstOutputs, 1);
+    const [devicePersistenceOutput] = firstOutputs;
+    assert(
+      devicePersistenceOutput.type === "OnDevicePersistence",
+      "Expected the device persistence first.",
+    );
+
+    return Object.assign(instance, {
+      devicePersistence: devicePersistenceOutput.devicePersistence,
+    });
   };
 
   return {
@@ -607,17 +628,30 @@ describe("storage", () => {
   const isMemoryOnly = (output: SharedWorkerOutput | undefined): boolean =>
     getDbWorkerInit(output).memoryOnly;
 
+  /** Every device persistence the tenant sent to the instance so far. */
+  const receiveDevicePersistences = async (
+    evoluChannel: TestMessageChannel<EvoluOutput, EvoluInput>,
+  ): Promise<ReadonlyArray<DevicePersistence>> => {
+    const devicePersistences: Array<DevicePersistence> = [];
+    evoluChannel.port2.onMessage = (output) => {
+      if (output.type === "OnDevicePersistence") {
+        devicePersistences.push(output.devicePersistence);
+      }
+    };
+    await testWaitForWorkerMessage();
+    return devicePersistences;
+  };
+
   it("keeps every database in memory, replacements included, without persistent storage", async () => {
-    const isPersistentStorageAvailable = mock.fn(() => Promise.resolve(false));
-    await using setup = await setupSharedWorker({
-      isPersistentStorageAvailable,
-    });
+    const getDevicePersistence = mock.fn(() =>
+      Promise.resolve<DevicePersistence>("NotPersisted"),
+    );
+    await using setup = await setupSharedWorker({ getDevicePersistence });
     using disposer = new DisposableStack();
 
-    // The first tab heard it right after Connected.
-    assertEqual(setup.sharedWorkerOutputs, [{ type: "StorageUnavailable" }]);
     const first = await setup.createEvolu();
-    assertTrue(isMemoryOnly(setup.sharedWorkerOutputs.at(1)));
+    assertTrue(isMemoryOnly(setup.sharedWorkerOutputs.at(0)));
+    assertSame(first.devicePersistence, "NotPersisted");
 
     // A replacement DbWorker, as after its tab closed, keeps it in memory too.
     await first.releaseDbWorkerLeader();
@@ -625,8 +659,7 @@ describe("storage", () => {
     tab.port.postMessage({ type: "AnnounceTabLeader", consoleLevel: "debug" });
     await testWaitForWorkerMessage();
     await testWaitForWorkerMessage();
-    assertSame(tab.outputs.at(0)?.type, "StorageUnavailable");
-    const replacement = getDbWorkerInit(tab.outputs.at(1));
+    const replacement = getDbWorkerInit(tab.outputs.at(0));
     assertTrue(replacement.memoryOnly);
     using leaderPort = testCreateMessagePort<DbWorkerOutput, DbWorkerInput>(
       replacement.port,
@@ -638,29 +671,62 @@ describe("storage", () => {
     });
     await testWaitForWorkerMessage();
 
-    assertSame(isPersistentStorageAvailable.mock.callCount(), 1);
+    assertSame(getDevicePersistence.mock.callCount(), 1);
   });
 
-  it("keeps databases where the app configured them with persistent storage", async () => {
+  for (const devicePersistence of ["Persisted", "Unknown"] as const) {
+    it(`stores databases and tells instances ${devicePersistence} where the platform promises it`, async () => {
+      await using setup = await setupSharedWorker({
+        getDevicePersistence: () => Promise.resolve(devicePersistence),
+      });
+
+      const instance = await setup.createEvolu();
+
+      assertEqual(
+        setup.sharedWorkerOutputs.map(({ type }) => type),
+        ["DbWorkerInit"],
+      );
+      assertFalse(isMemoryOnly(setup.sharedWorkerOutputs.at(0)));
+      assertSame(instance.devicePersistence, devicePersistence);
+    });
+  }
+
+  it("tells an instance configured memoryOnly that its database is not persisted", async () => {
     await using setup = await setupSharedWorker({
-      isPersistentStorageAvailable: () => Promise.resolve(true),
+      getDevicePersistence: () => Promise.resolve("Persisted"),
     });
 
-    await setup.createEvolu();
+    const instance = await setup.createEvolu({ memoryOnly: true });
 
-    assertEqual(
-      setup.sharedWorkerOutputs.map(({ type }) => type),
-      ["DbWorkerInit"],
-    );
-    assertFalse(isMemoryOnly(setup.sharedWorkerOutputs.at(0)));
+    assertTrue(isMemoryOnly(setup.sharedWorkerOutputs.at(0)));
+    assertSame(instance.devicePersistence, "NotPersisted");
   });
 
-  it("keeps databases where the app configured them on platforms without the check", async () => {
-    await using setup = await setupSharedWorker();
+  it("tells a later instance of the same name the mode the first one chose", async () => {
+    await using setup = await setupSharedWorker({
+      getDevicePersistence: () => Promise.resolve("Persisted"),
+    });
+    const { run, worker } = setup;
+    await setup.createEvolu({ memoryOnly: true });
 
-    await setup.createEvolu();
+    const secondId: EvoluInstanceId = createId(run.deps);
+    await using _secondInstanceLock = await run.ok(acquireLeaderLock(secondId));
+    using secondChannel = testCreateMessageChannel<EvoluOutput, EvoluInput>();
+    worker.port.postMessage({
+      type: "CreateEvolu",
+      name: testName,
+      id: secondId,
+      consoleLevel: "debug",
+      sqliteSchema: testSqliteSchema,
+      encryptionKey: testAppOwner.encryptionKey,
+      memoryOnly: false,
+      evoluPort: secondChannel.port1.native,
+    });
+    await testWaitForWorkerMessage();
 
-    assertFalse(isMemoryOnly(setup.sharedWorkerOutputs.at(0)));
+    assertEqual(await receiveDevicePersistences(secondChannel), [
+      "NotPersisted",
+    ]);
   });
 });
 
@@ -681,6 +747,7 @@ describe("builds", () => {
         lockManager,
         createMessagePort: testCreateMessagePort,
         createWebSocket: testCreateWebSocket({ throwOnCreate: true }),
+        getDevicePersistence: () => Promise.resolve("Unknown" as const),
       }),
     );
     const outputs: Array<SharedWorkerOutput> = [];
@@ -7265,7 +7332,14 @@ describe("with one evolu instance", () => {
         memoryOnly: false,
         evoluPort: siblingChannel.port1.native,
       });
+      const siblingOutputs: Array<EvoluOutput> = [];
+      siblingChannel.port2.onMessage = (output) => {
+        siblingOutputs.push(output);
+      };
       await testWaitForWorkerMessage();
+      assertEqual(siblingOutputs, [
+        { type: "OnDevicePersistence", devicePersistence: "Unknown" },
+      ]);
       siblingChannel.port2.postMessage({
         type: "Mutate",
         changes: [
@@ -9644,6 +9718,10 @@ describe("with one evolu instance", () => {
         [siblingChannel.port1.native],
       );
       await testWaitForWorkerMessage();
+      // The tenant keeps the first instance's persistent database.
+      assertEqual(siblingOutputs.splice(0), [
+        { type: "OnDevicePersistence", devicePersistence: "Unknown" },
+      ]);
 
       const bytes = new Uint8Array([1, 2, 3]);
       const mutation: ExtractTyped<EvoluInput, "Mutate"> = {
@@ -10811,10 +10889,13 @@ describe("startup refusal", () => {
     });
     await testWaitForWorkerMessage();
     // The tab is told through its own connection, not the broadcast channel,
-    // and its instance is not answered: pending work stays pending.
+    // and its instance learns only its device persistence: pending work stays
+    // pending.
     assertEqual(firstTabOutputs(), [{ type: "Error", error: refusal }]);
     assertEqual(broadcasts, []);
-    assertEqual(evoluOutputs, []);
+    assertEqual(evoluOutputs.splice(0), [
+      { type: "OnDevicePersistence", devicePersistence: "Unknown" },
+    ]);
 
     // Later requests are dropped without a response.
     instance.evoluChannel.port2.postMessage({
@@ -10852,7 +10933,9 @@ describe("startup refusal", () => {
     );
     await testWaitForWorkerMessage();
     assertEqual(firstTabOutputs(), [{ type: "Error", error: refusal }]);
-    assertEqual(secondOutputs, []);
+    assertEqual(secondOutputs, [
+      { type: "OnDevicePersistence", devicePersistence: "Unknown" },
+    ]);
 
     // A tab that connects later is told once, through its own connection.
     const laterTab = setupTab(setup, disposer);

package/src/local-first/Shared.ts

@@ -69,13 +69,20 @@
  *
  * ## Storage
  *
- * A platform that can lack persistent storage, as a browser does in Safari's
- * Private Browsing, provides {@link PersistentStorageDep}. The worker checks it
- * once, after it takes the build lock and before any DbWorker starts. Without
- * persistent storage, every DbWorker it starts keeps its database in memory,
- * replacements included, and each tab that connects is told with
- * `StorageUnavailable`. The decision holds for the worker's lifetime, so all
- * its tabs see one mode, and the next worker checks again.
+ * The platform tells the worker with {@link DevicePersistenceDep} what it can
+ * promise about stored databases. The worker asks once, after it takes the
+ * build lock and before any DbWorker starts. A browser checks whether it can
+ * open the origin private file system, which Safari's Private Browsing and
+ * Firefox's private windows refuse. Without persistent storage, every DbWorker
+ * the worker starts keeps its database in memory, replacements included. The
+ * decision holds for the worker's lifetime, so all its tabs see one mode, and
+ * the next worker checks again.
+ *
+ * A tenant tells each instance it adds its {@link Evolu.devicePersistence}:
+ * `NotPersisted` when its database is kept in memory, because of the platform
+ * or {@link EvoluConfig.memoryOnly}, otherwise what the platform promised.
+ * Instances of one name share the tenant, so a later instance gets the mode the
+ * first one chose.
  *
  * The check cannot tell a private session from a storage failure, but memory
  * loses nothing that refusing to start would have kept, and the persistent
@@ -333,7 +340,12 @@ import type {
   WorkerDeps,
 } from "../Worker.ts";
 import type { DbWorkerInit, UnsupportedDbVersionError } from "./Db.ts";
-import type { Evolu, SyncStateDep } from "./Evolu.ts";
+import type {
+  DevicePersistence,
+  Evolu,
+  EvoluConfig,
+  SyncStateDep,
+} from "./Evolu.ts";
 import type { Owner, OwnerId, OwnerTransport, SyncOwner } from "./Owner.ts";
 import {
   createProtocolBroadcastMessagesFromCrdtMessages,
@@ -420,14 +432,6 @@ export type SharedWorkerOutput =
       readonly type: "Connected";
       readonly workerId: SharedWorkerId;
       readonly syncStateChannelName: string;
-    }
-  | {
-      /**
-       * Sent to a connecting tab after `Connected` when the platform offers no
-       * persistent storage, so the worker keeps every database in memory; see
-       * Storage in this module's documentation.
-       */
-      readonly type: "StorageUnavailable";
     };
 
 export type ConsoleEntryOrError =
@@ -741,22 +745,23 @@ export interface RelaySyncState {
  *   stops syncing through its relay, while a skipped change leaves out only
  *   that change.
  *
- * Evolu saves changes on the device before they sync, so sync needs no UI while
- * it works: show nothing for `NoRelays`, `Syncing`, and `Synced`. An indicator
- * that changes with every edit distracts, and screen readers announce each
- * change.
+ * Evolu stores changes in the local database before they sync, so sync needs no
+ * UI while it works: show nothing for `NoRelays`, `Syncing`, and `Synced`. An
+ * indicator that changes with every edit distracts, and screen readers announce
+ * each change.
  *
  * For `Offline` and `Error`, show one quiet line that lasts as long as the
  * status, not a dialog, which interrupts, or a toast, which disappears while
- * the problem lasts. Say that changes are saved on this device. Evolu reports
- * `Offline` at once; an app may wait a few seconds before showing it, because
- * brief disconnections, such as waking from sleep, reconnect quickly. For
- * `Error`, write actionable text for the error types the app can act on, such
- * as a {@link ProtocolQuotaError}: the relay stores no more data for the owner,
- * so offer more quota, such as a plan upgrade, then call
- * {@link Evolu.requestSync} with the owner's ID. For any other error, show
- * generic text that names the error type, which helps when the user reports
- * it.
+ * the problem lasts. Do not say that changes are saved on this device unless
+ * {@link Evolu.devicePersistence} is `Persisted`: a browser may keep them only
+ * for a private session or delete them later. Evolu reports `Offline` at once;
+ * an app may wait a few seconds before showing it, because brief
+ * disconnections, such as waking from sleep, reconnect quickly. For `Error`,
+ * write actionable text for the error types the app can act on, such as a
+ * {@link ProtocolQuotaError}: the relay stores no more data for the owner, so
+ * offer more quota, such as a plan upgrade, then call {@link Evolu.requestSync}
+ * with the owner's ID. For any other error, show generic text that names the
+ * error type, which helps when the user reports it.
  *
  * Render the line inside one element with `role="status"` that stays mounted:
  * screen readers announce changes only in a live region that already exists,
@@ -785,18 +790,18 @@ export interface RelaySyncState {
  *     case "Synced":
  *       return null;
  *     case "Offline":
- *       return "Offline. Your changes are saved on this device.";
+ *       return "Offline. Changes will sync when you're back online.";
  *     case "Error":
  *       return status.error.type === "ProtocolQuotaError"
- *         ? "Sync is paused because the sync server is full. Your changes are saved on this device."
- *         : `Sync error: ${status.error.type}. Your changes are saved on this device.`;
+ *         ? "Sync is paused because the sync server is full."
+ *         : `Sync error: ${status.error.type}.`;
  *   }
  * };
  *
  * assertEqual(syncStatusToMessage({ type: "Synced" }), null);
  * assertEqual(
  *   syncStatusToMessage({ type: "Offline" }),
- *   "Offline. Your changes are saved on this device.",
+ *   "Offline. Changes will sync when you're back online.",
  * );
  * assertEqual(
  *   syncStatusToMessage({
@@ -807,14 +812,14 @@ export interface RelaySyncState {
  *       at: Millis.orThrow(1000),
  *     },
  *   }),
- *   "Sync is paused because the sync server is full. Your changes are saved on this device.",
+ *   "Sync is paused because the sync server is full.",
  * );
  * assertEqual(
  *   syncStatusToMessage({
  *     type: "Error",
  *     error: { type: "SyncFailed", at: Millis.orThrow(1000) },
  *   }),
- *   "Sync error: SyncFailed. Your changes are saved on this device.",
+ *   "Sync error: SyncFailed.",
  * );
  * ```
  */
@@ -1210,6 +1215,11 @@ export type EvoluOutput =
       /** The mutation with these onComplete callbacks could not be stored. */
       readonly type: "OnMutateFailed";
       readonly onCompleteIds: ReadonlyArray<Id>;
+    }
+  | {
+      /** Sent once, when the tenant adds the instance; see Storage. */
+      readonly type: "OnDevicePersistence";
+      readonly devicePersistence: DevicePersistence;
     };
 
 export type DbWorkerInput =
@@ -1334,21 +1344,22 @@ export type DbWorkerQueuedResponse =
     };
 
 /**
- * Tells whether the platform can store databases persistently.
+ * Tells what the platform can promise about the databases it stores.
  *
- * Only a platform that can lack persistent storage provides it, as a browser
- * does in Safari's Private Browsing; see Storage in the Shared module.
+ * `NotPersisted` means the platform offers no persistent storage now, as a
+ * browser does in Safari's Private Browsing or a Firefox private window, so the
+ * worker keeps every database in memory; see Storage in the Shared module.
  */
-export interface PersistentStorageDep {
-  readonly isPersistentStorageAvailable: () => Promise<boolean>;
+export interface DevicePersistenceDep {
+  readonly getDevicePersistence: () => Promise<DevicePersistence>;
 }
 
 export type SharedWorkerDeps = WorkerDeps &
   CreateBroadcastChannelDep &
   CreateMessageChannelDep &
   CreateWebSocketDep &
-  LockManagerDep &
-  Partial<PersistentStorageDep>;
+  DevicePersistenceDep &
+  LockManagerDep;
 
 /**
  * Coordinates all instances of one named local database within a SharedWorker.
@@ -1748,9 +1759,6 @@ export const initSharedWorker =
           workerId,
           syncStateChannelName,
         });
-        if (isPersistentStorageUnavailable) {
-          port.postMessage({ type: "StorageUnavailable" });
-        }
       });
     };
 
@@ -1766,12 +1774,10 @@ export const initSharedWorker =
     disposer.use(await run.ok(acquireLeaderLock("tab")));
     starting.dispose();
 
-    // Checked once, before any DbWorker starts, so every DbWorker of this
-    // worker, replacements included, keeps its database in memory; see
-    // Storage.
-    const isPersistentStorageUnavailable =
-      deps.isPersistentStorageAvailable !== undefined &&
-      !(await deps.isPersistentStorageAvailable());
+    // Checked once, before any DbWorker starts, so without persistent
+    // storage every DbWorker of this worker, replacements included, keeps its
+    // database in memory; see Storage.
+    const platformDevicePersistence = await deps.getDevicePersistence();
 
     disposer.defer(
       deps.consoleStoreOutputEntry.subscribe(() => {
@@ -2233,14 +2239,17 @@ export const initSharedWorker =
     const tenantsByName = disposer.use(
       await sharedWorkerRun.ok(
         createSharedResourceByKey(
-          (message: ExtractTyped<SharedWorkerInput, "CreateEvolu">) =>
-            createEvoluTenant(
-              isPersistentStorageUnavailable
-                ? { ...message, memoryOnly: true }
-                : message,
+          (message: ExtractTyped<SharedWorkerInput, "CreateEvolu">) => {
+            const memoryOnly =
+              message.memoryOnly ||
+              platformDevicePersistence === "NotPersisted";
+            return createEvoluTenant(
+              { ...message, memoryOnly },
+              memoryOnly ? "NotPersisted" : platformDevicePersistence,
               currentTenantsByName,
               workerId,
-            ),
+            );
+          },
           {
             idleDisposeAfter: "3s",
             lookup: (message) => message.name,
@@ -2269,6 +2278,7 @@ const createEvoluTenant =
       encryptionKey,
       memoryOnly,
     }: ExtractTyped<SharedWorkerInput, "CreateEvolu">,
+    devicePersistence: DevicePersistence,
     currentTenantsByName: Map<Name, BorrowedResource<EvoluTenant>>,
     workerId: SharedWorkerId,
   ): Task<EvoluTenant, never, EvoluTenantDeps> =>
@@ -3404,6 +3414,12 @@ const createEvoluTenant =
           disposer.defer(() => {
             instance.port.onMessage = null;
           });
+          // Instances of one name share the tenant, so each learns the mode
+          // the first one chose.
+          instance.port.postMessage({
+            type: "OnDevicePersistence",
+            devicePersistence,
+          });
 
           // The main-thread Evolu instance holds this per-instance leader lock
           // while it is alive. Acquiring the same lock here means the main