@evolu/web 3.0.2 → 3.1.1

package/README.md

@@ -1,6 +1,12 @@
 # Evolu for Web
 
-This package provides Evolu for the web platform (browsers). We use "web" rather than "browser" because "web platform" is the standard W3C terminology for browser APIs and aligns with ecosystem conventions.
+This package provides browser-specific Evolu implementations, including
+OPFS-backed SQLite, Web Workers, Shared Workers, and browser platform
+dependencies.
+
+As runtimes increasingly implement the same Web Platform APIs, Evolu's portable
+abstractions for `WebSocket`, `MessagePort`, and Web Locks live in
+`@evolu/common`. Their concrete implementations are supplied by the runtime.
 
 ## Documentation
 

package/dist/src/Platform.d.ts

@@ -1,4 +1,6 @@
 import { PositiveInt, type ReloadApp } from "@evolu/common";
+/** Returns true when the browser runs on an Apple platform. */
+export declare const isApplePlatform: () => boolean;
 /** Returns the amount of logical processors available to the browser. */
 export declare const availableParallelism: () => PositiveInt;
 export declare const reloadApp: ReloadApp;

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,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,QAAO,WACuB,CAAC;AAEhE,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,SAMvB,CAAC"}

package/dist/src/Platform.js

@@ -1,6 +1,11 @@
 import { PositiveInt } from "@evolu/common";
+/** Returns true when the browser runs on an Apple platform. */
+export const isApplePlatform = () => {
+    const platform = navigator.userAgentData?.platform ?? navigator.platform;
+    return /^(?:Mac|iPhone|iPad|iPod)/iu.test(platform);
+};
 /** Returns the amount of logical processors available to the browser. */
-export const availableParallelism = () => PositiveInt.orThrow(globalThis.navigator.hardwareConcurrency);
+export const availableParallelism = () => PositiveInt.orThrow(navigator.hardwareConcurrency);
 export const reloadApp = (url) => {
     if (typeof document === "undefined") {
         return;

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;AA4BnE,eAAO,MAAM,sBAAsB,EAAE,kBA6GlC,CAAC"}
+{"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"}

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, ok } from "@evolu/common";
+import { bytesToHex, createPreparedStatementsCache, exhaustiveCheck, ok, } from "@evolu/common";
 import sqlite3InitModule, {} from "@evolu/sqlite-wasm";
 // @ts-expect-error Missing types.
 globalThis.sqlite3ApiConfig = {
@@ -60,7 +60,7 @@ globalThis.sqlite3ApiConfig = {
         if (typeof arg === "string" &&
             arg.startsWith("Ignoring inability to install OPFS sqlite3_vfs"))
             return;
-        // eslint-disable-next-line no-console
+        // oxlint-disable-next-line eslint/no-console
         console.warn(arg);
     },
 };
@@ -90,16 +90,18 @@ export const createWasmSqliteDriver = (name, options) => async () => {
         let db;
         switch (options?.mode) {
             case "memory":
+                // oxlint-disable-next-line react/rules-of-hooks -- useDatabase registers disposal and is not a React Hook.
                 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
+                // oxlint-disable-next-line typescript/no-unsafe-call
                 sqlite3.capi.sqlite3mc_vfs_create("opfs", 1);
                 const pool = await createOpfsSAHPoolVfs({
                     directory: `.${name}`,
                 });
+                // oxlint-disable-next-line react/rules-of-hooks -- useDatabase registers disposal and is not a React Hook.
                 db = useDatabase(new pool.OpfsSAHPoolDb(
                 // SQLite normalizes this URI filename to SAH-pool path "/evolu1.db".
                 `file:${fileName}?vfs=multipleciphers-opfs-sahpool`));
@@ -109,10 +111,14 @@ export const createWasmSqliteDriver = (name, options) => async () => {
         `);
                 break;
             }
-            default: {
+            case undefined: {
                 const pool = await createOpfsSAHPoolVfs({ name });
+                // oxlint-disable-next-line react/rules-of-hooks -- useDatabase registers disposal and is not a React Hook.
                 db = useDatabase(new pool.OpfsSAHPoolDb(`file:${fileName}`));
+                break;
             }
+            default:
+                exhaustiveCheck(options);
         }
         const cache = disposer.use(createPreparedStatementsCache((sql) => db.prepare(sql), (statement) => {
             statement.finalize();

package/dist/src/Task.js

@@ -6,7 +6,7 @@
 import { createRun as createCommonRun, } from "@evolu/common";
 export function createRun(deps) {
     const reportDefect = (reported) => {
-        globalThis.reportError(reported);
+        reportError(reported);
     };
     return deps === undefined
         ? createCommonRun({ reportDefect })

package/dist/src/Worker.d.ts

@@ -39,14 +39,14 @@ export declare const createBroadcastChannel: CreateBroadcastChannel;
  * Creates an Evolu {@link WorkerSelf} from a Web `DedicatedWorkerGlobalScope`
  * (`self` inside a dedicated worker).
  */
-export declare const createWorkerSelf: <Input, Output = never>(nativeSelf: globalThis.DedicatedWorkerGlobalScope) => WorkerSelf<Input, Output>;
+export declare const createWorkerSelf: <Input, Output = never>(nativeSelf: DedicatedWorkerGlobalScope) => WorkerSelf<Input, Output>;
 /**
  * Creates an Evolu {@link SharedWorkerSelf} from a Web `SharedWorkerGlobalScope`
  * (`self` inside a shared worker).
  *
  * Disposing closes the shared worker scope for all connected clients.
  */
-export declare const createSharedWorkerSelf: <Input, Output = never>(nativeSelf: globalThis.SharedWorkerGlobalScope) => SharedWorkerSelf<Input, Output>;
+export declare const createSharedWorkerSelf: <Input, Output = never>(nativeSelf: SharedWorkerGlobalScope) => SharedWorkerSelf<Input, Output>;
 /**
  * Creates a one-tab {@link SharedWorkerSelf} polyfill for browsers without
  * native SharedWorker support.
@@ -54,7 +54,7 @@ export declare const createSharedWorkerSelf: <Input, Output = never>(nativeSelf:
  * 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>;
+export declare const createOneTabSharedWorkerSelfPolyfill: <Input, Output = never>(nativeSelf: DedicatedWorkerGlobalScope) => SharedWorkerSelf<Input, Output>;
 /** 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,sBAsCpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cACxC,UAAU,CAAC,0BAA0B,KAChD,UAAU,CAAC,KAAK,EAAE,MAAM,CAAoC,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cAC9C,UAAU,CAAC,uBAAuB,KAC7C,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAkBhC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,KAAK,EAAE,MAAM,GAAG,KAAK,cAC5D,UAAU,CAAC,0BAA0B,KAChD,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAyEhC,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;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"}

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 { assert, createConsole, createConsoleStoreOutput, disposable, } from "@evolu/common";
+import { assertNonNullable, createConsole, createConsoleStoreOutput, disposable, } from "@evolu/common";
 /** Creates a {@link Worker} from a Web Worker. */
 export const createWorker = (nativeWorker) => wrap(nativeWorker);
 /**
@@ -134,6 +134,7 @@ export const createBroadcastChannel = (name) => {
         let disposed = false;
         disposer.defer(() => {
             disposed = true;
+            // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
             nativeBroadcastChannel.onmessage = null;
             nativeBroadcastChannel.close();
         });
@@ -149,6 +150,7 @@ export const createBroadcastChannel = (name) => {
                 if (disposed)
                     return;
                 onMessageHandler = fn;
+                // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
                 nativeBroadcastChannel.onmessage = fn
                     ? (event) => {
                         fn(event.data);
@@ -180,12 +182,14 @@ export const createSharedWorkerSelf = (nativeSelf) => {
     const self = {
         onConnect: null,
         [Symbol.dispose]: () => {
+            // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
             nativeSelf.onconnect = null;
             nativeSelf.close();
         },
     };
+    // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
     nativeSelf.onconnect = (e) => {
-        assert(self.onConnect != null, "onConnect must be set before receiving connections");
+        assertNonNullable(self.onConnect, "onConnect must be set before receiving connections");
         self.onConnect(wrap(e.ports[0]));
     };
     return self;
@@ -209,10 +213,12 @@ export const createOneTabSharedWorkerSelfPolyfill = (nativeSelf) => {
             messages.length = 0;
             onConnectHandler = null;
             onMessageHandler = null;
+            // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
             nativeSelf.onmessage = null;
             nativeSelf.close();
         });
         const disposables = disposer.move();
+        // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
         nativeSelf.onmessage = (event) => {
             if (disposables.disposed)
                 return;
@@ -307,16 +313,19 @@ const wrap = (native) => {
             onMessageHandler = fn;
             if (fn) {
                 // Messages are queued until onMessage is assigned.
+                // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
                 native.onmessage = (event) => {
                     fn(event.data);
                 };
             }
             else {
+                // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
                 native.onmessage = null;
             }
         },
         native: native,
         [Symbol.dispose]: () => {
+            // oxlint-disable-next-line unicorn/prefer-add-event-listener -- This adapter owns and clears one handler.
             native.onmessage = null;
             if ("terminate" in native)
                 native.terminate();

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 export * from "./local-first/index.ts";
-export { availableParallelism } from "./Platform.ts";
+export { availableParallelism, isApplePlatform } from "./Platform.ts";
 export * from "./Sqlite.ts";
 export * from "./Task.ts";
 export * from "./Worker.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/src/index.js

@@ -1,5 +1,5 @@
 export * from "./local-first/index.js";
-export { availableParallelism } from "./Platform.js";
+export { availableParallelism, isApplePlatform } from "./Platform.js";
 export * from "./Sqlite.js";
 export * from "./Task.js";
 export * from "./Worker.js";

package/dist/src/local-first/Db.worker.js

@@ -9,7 +9,7 @@ import { createWorkerDeps, createWorkerSelf } from "../Worker.js";
 const run = createRun({
     ...createWorkerDeps(),
     createSqliteDriver: createWasmSqliteDriver,
-    lockManager: globalThis.navigator.locks,
+    lockManager: navigator.locks,
     randomBytes: createRandomBytes(),
 });
 void run(startDbWorker(createWorkerSelf(self)));

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;AAkBnC,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,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"}

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

@@ -33,7 +33,7 @@ export const createEvoluDeps = (deps = {}) => {
                                     deps.onSharedWorkerUnsupported();
                                 }
                                 else {
-                                    globalThis.alert("This browser supports Evolu in one tab only. Close this tab and use the already open tab.");
+                                    alert("This browser supports Evolu in one tab only. Close this tab and use the already open tab.");
                                 }
                                 break;
                             }
@@ -50,7 +50,7 @@ export const createEvoluDeps = (deps = {}) => {
         createDbWorker,
         createBroadcastChannel,
         createMessageChannel,
-        lockManager: globalThis.navigator.locks,
+        lockManager: navigator.locks,
         reloadApp,
         sharedWorker,
     });

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

@@ -124,9 +124,12 @@ const createCredentialCreationOptions = (deps) => (username, seed, relyingPartyI
             displayName: username,
         },
         pubKeyCredParams: [
-            { type: "public-key", alg: -8 }, // Ed25519
-            { type: "public-key", alg: -7 }, // ES256
-            { type: "public-key", alg: -257 }, // RS256
+            // Ed25519
+            { type: "public-key", alg: -8 },
+            // ES256
+            { type: "public-key", alg: -7 },
+            // RS256
+            { type: "public-key", alg: -257 },
         ],
         attestation: "none",
         authenticatorSelection: {

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

@@ -60,7 +60,7 @@ import { createOneTabSharedWorkerSelfPolyfill, createSharedWorkerSelf, createWor
 const run = createRun({
     ...createWorkerDeps(),
     createWebSocket,
-    lockManager: globalThis.navigator.locks,
+    lockManager: navigator.locks,
 });
 void run(async (run) => {
     const env_1 = { stack: [], error: void 0, hasError: false };
@@ -82,7 +82,7 @@ void run(async (run) => {
             }
         }
         const workerSelf = __addDisposableResource(env_1, createOneTabSharedWorkerSelfPolyfill(self), false);
-        await globalThis.navigator.locks.request("evolu-one-tab-sharedworker-polyfill", { ifAvailable: true, mode: "exclusive" }, async (lock) => {
+        await navigator.locks.request("evolu-one-tab-sharedworker-polyfill", { ifAvailable: true, mode: "exclusive" }, async (lock) => {
             const env_3 = { stack: [], error: void 0, hasError: false };
             try {
                 if (!lock) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/web",
-  "version": "3.0.2",
+  "version": "3.1.1",
   "description": "Evolu for web",
   "keywords": [
     "evolu",
@@ -27,6 +27,7 @@
   },
   "files": [
     "dist/src/**",
+    "!dist/**/*.test.*",
     "src/**",
     "README.md"
   ],
@@ -35,13 +36,13 @@
     "idb-keyval": "^6.2.2"
   },
   "devDependencies": {
+    "@evolu/common": "8.8.0",
+    "@evolu/typescript-config": "0.1.1",
     "@types/node": "^24.10.9",
     "@types/sharedworker": "^0.0.229",
     "@types/web-locks-api": "^0.0.5",
     "@typescript/native": "npm:typescript@^7.0.2",
-    "user-agent-data-types": "^0.4.2",
-    "@evolu/common": "8.3.0",
-    "@evolu/typescript-config": "0.0.2"
+    "user-agent-data-types": "^0.4.2"
   },
   "peerDependencies": {
     "@evolu/common": "^8.0.0"
@@ -50,7 +51,7 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=24.0.0"
+    "node": ">=24.20.0"
   },
   "sideEffects": false,
   "scripts": {

package/src/Platform.test.ts

@@ -0,0 +1,45 @@
+import {
+  assertEqual,
+  assertFalse,
+  assertTrue,
+  assertType,
+  PositiveInt,
+  testStubGlobal,
+} from "@evolu/common";
+import { test } from "node:test";
+import { availableParallelism, isApplePlatform } from "./index.ts";
+
+for (const platform of ["macOS", "MacIntel", "iPhone", "iPad", "iPod"]) {
+  test(`isApplePlatform recognizes ${platform}`, () => {
+    using _navigator = testStubGlobal("navigator", {
+      platform: "Win32",
+      userAgentData: { platform },
+    });
+
+    assertTrue(isApplePlatform());
+  });
+}
+
+test("isApplePlatform recognizes a non-Apple platform", () => {
+  using _navigator = testStubGlobal("navigator", {
+    platform: "MacIntel",
+    userAgentData: { platform: "Windows" },
+  });
+
+  assertFalse(isApplePlatform());
+});
+
+test("isApplePlatform falls back to navigator.platform", () => {
+  using _navigator = testStubGlobal("navigator", { platform: "MacIntel" });
+
+  assertTrue(isApplePlatform());
+});
+
+test("availableParallelism returns the validated browser value", () => {
+  using _navigator = testStubGlobal("navigator", { hardwareConcurrency: 128 });
+
+  const parallelism = availableParallelism();
+
+  assertType<typeof parallelism, PositiveInt>();
+  assertEqual(parallelism, 128);
+});

package/src/Platform.ts

@@ -1,8 +1,15 @@
 import { PositiveInt, type ReloadApp } from "@evolu/common";
 
+/** Returns true when the browser runs on an Apple platform. */
+export const isApplePlatform = (): boolean => {
+  const platform = navigator.userAgentData?.platform ?? navigator.platform;
+
+  return /^(?:Mac|iPhone|iPad|iPod)/iu.test(platform);
+};
+
 /** Returns the amount of logical processors available to the browser. */
 export const availableParallelism = (): PositiveInt =>
-  PositiveInt.orThrow(globalThis.navigator.hardwareConcurrency);
+  PositiveInt.orThrow(navigator.hardwareConcurrency);
 
 export const reloadApp: ReloadApp = (url) => {
   if (typeof document === "undefined") {