@evolu/common 8.0.0-next.4 → 8.0.0

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

@@ -56,11 +56,11 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 });
 import { emptyArray, isNonEmptyArray, mapArray, } from "../Array.js";
-import { assert, assertNonEmptyReadonlyArray, assertNotDisposed, } from "../Assert.js";
+import { assert, assertNonEmptyReadonlyArray } from "../Assert.js";
 import { createCallbacks } from "../Callbacks.js";
 import { createConsole } from "../Console.js";
 import { createUnknownError } from "../Error.js";
-import { exhaustiveCheck, todo } from "../Function.js";
+import { disposable, exhaustiveCheck, todo } from "../Function.js";
 import { acquireLeaderLock, acquireLeaderLockCallback, } from "../LockManager.js";
 import { createMicrotaskBatch } from "../Microtask.js";
 import { createRefCountByKey } from "../RefCount.js";
@@ -68,7 +68,6 @@ import { err, ok } from "../Result.js";
 import { isNonEmptySet } from "../Set.js";
 import { SqliteBoolean, sqliteBooleanToBoolean } from "../Sqlite.js";
 import { createStore } from "../Store.js";
-import {} from "../Task.js";
 import { brand, createId, createIdFromString, Name, UrlSafeString, } from "../Type.js";
 import { createOwnerWebSocketTransport } from "./Owner.js";
 import { applyPatches } from "./Query.js";
@@ -86,8 +85,8 @@ import { DbChange } from "./Storage.js";
  * `_`) and must be between 1 and 41 characters.
  */
 export const AppName = /*#__PURE__*/ brand("AppName", UrlSafeString, (value) => value.length >= 1 && value.length <= 41
-    ? ok(value)
-    : err({ type: "AppName", value }));
+    ? ok()
+    : err({ type: "AppName", value }), (error) => `The value ${JSON.stringify(error.value)} is not between 1 and 41 characters.`);
 export const testAppName = /*#__PURE__*/ AppName.orThrow("AppName");
 /**
  * Creates shared dependencies used by all {@link createEvolu} instances on a
@@ -136,12 +135,11 @@ export const createEvoluDeps = (deps) => {
                 consoleLevel: console.getLevel(),
             });
         }));
-        const disposables = disposer.move();
-        return {
+        return disposable({
             ...deps,
+            console,
             evoluError,
-            [Symbol.dispose]: () => disposables.dispose(),
-        };
+        }, disposer);
     }
     catch (e_1) {
         env_1.error = e_1;
@@ -221,31 +219,12 @@ export const createEvolu = (schema, config) => async (run) => {
             exportDatabasePending?.reject({ type: "EvoluDisposedError" });
             exportDatabasePending = null;
         });
-        const mutateBatch = disposer.use(createMicrotaskBatch((items) => {
-            console.debug("mutateBatch", { changeCount: items.length });
-            releaseUnsubscribedLoadingPromises();
-            postMessage({
-                type: "Mutate",
-                changes: mapArray(items, (item) => item.change),
-                onCompleteIds: items.flatMap((item) => item.onComplete
-                    ? [onMutateCompleteCallbacks.register(item.onComplete)]
-                    : []),
-                subscribedQueries: subscribedQueriesRefCount.keys(),
-            });
-        }));
-        const queryBatch = disposer.use(createMicrotaskBatch((queries) => {
-            const dedupedQueries = new Set(queries);
-            assert(isNonEmptySet(dedupedQueries), "Expected non-empty query batch.");
-            console.debug("queryBatch", { queryCount: dedupedQueries.size });
-            postMessage({ type: "Query", queries: dedupedQueries });
-        }));
-        const useOwnerBatch = disposer.use(createMicrotaskBatch((actions) => postMessage({ type: "UseOwner", actions })));
         let postMessage;
         // Scope worker/channel wiring and keep only postMessage outside.
         {
             const id = createId(run.deps);
             const { createMessageChannel, sharedWorker } = run.deps;
-            disposer.use(await run.orThrow(acquireLeaderLock(id)));
+            disposer.use(await run.ok(acquireLeaderLock(id)));
             const evoluChannel = disposer.use(createMessageChannel());
             evoluChannel.port1.onMessage = (message) => {
                 switch (message.type) {
@@ -320,8 +299,34 @@ export const createEvolu = (schema, config) => async (run) => {
             }, [evoluChannel.port2.native]);
             postMessage = evoluChannel.port1.postMessage;
         }
+        const mutateBatch = disposer.use(createMicrotaskBatch((items) => {
+            if (disposed)
+                return;
+            console.debug("mutateBatch", { changeCount: items.length });
+            releaseUnsubscribedLoadingPromises();
+            postMessage({
+                type: "Mutate",
+                changes: mapArray(items, (item) => item.change),
+                onCompleteIds: items.flatMap((item) => item.onComplete
+                    ? [onMutateCompleteCallbacks.register(item.onComplete)]
+                    : []),
+                subscribedQueries: subscribedQueriesRefCount.keys(),
+            });
+        }));
+        const queryBatch = disposer.use(createMicrotaskBatch((queries) => {
+            if (disposed)
+                return;
+            const dedupedQueries = new Set(queries);
+            assert(isNonEmptySet(dedupedQueries), "Expected non-empty query batch.");
+            console.debug("queryBatch", { queryCount: dedupedQueries.size });
+            postMessage({ type: "Query", queries: dedupedQueries });
+        }));
+        const useOwnerBatch = disposer.use(createMicrotaskBatch((actions) => {
+            if (disposed)
+                return;
+            postMessage({ type: "UseOwner", actions });
+        }));
         const createMutation = (kind) => (table, values, options) => {
-            assertNotDisposed(disposables);
             const { id = createId(run.deps), isDeleted, ...changeValues } = values;
             const dbChange = {
                 table,
@@ -340,7 +345,6 @@ export const createEvolu = (schema, config) => async (run) => {
             return { id };
         };
         const loadQuery = (query) => {
-            assertNotDisposed(disposables);
             const loadingPromise = loadingPromisesByQuery.get(query);
             if (loadingPromise) {
                 return loadingPromise.promise;
@@ -356,13 +360,8 @@ export const createEvolu = (schema, config) => async (run) => {
             queryBatch.push(query);
             return typedPromise;
         };
-        const getQueryRows = (query) => {
-            assertNotDisposed(disposables);
-            return (rowsByQueryMapStore.get().get(query) ??
-                emptyArray);
-        };
+        const getQueryRows = (query) => (rowsByQueryMapStore.get().get(query) ?? emptyArray);
         const useOwner = (owner, ownerTransports) => {
-            assertNotDisposed(disposables);
             const effectiveTransports = ownerTransports ?? transports;
             assertNonEmptyReadonlyArray(effectiveTransports, "useOwner requires explicit non-empty transports when config.transports is empty.");
             const syncOwner = {
@@ -375,7 +374,7 @@ export const createEvolu = (schema, config) => async (run) => {
             });
             let isUsed = true;
             return () => {
-                if (disposables.disposed)
+                if (disposed)
                     return;
                 assert(isUsed, "UnuseOwner can be called only once.");
                 isUsed = false;
@@ -385,13 +384,15 @@ export const createEvolu = (schema, config) => async (run) => {
                 });
             };
         };
-        const disposables = disposer.move();
+        let disposed = false;
+        disposer.defer(() => {
+            disposed = true;
+            console.info("disposeEvolu");
+        });
         if (isNonEmptyArray(transports))
             useOwner(appOwner);
-        if (run.signal.aborted) {
-            await disposables.disposeAsync();
-        }
-        return ok({
+        run.signal.throwIfAborted();
+        return ok(disposable({
             name,
             appOwner,
             insert: createMutation("insert"),
@@ -400,7 +401,6 @@ export const createEvolu = (schema, config) => async (run) => {
             loadQuery,
             loadQueries: (queries) => queries.map((query) => loadQuery(query)),
             subscribeQuery: (query) => (listener) => {
-                assertNotDisposed(disposables);
                 subscribedQueriesRefCount.increment(query);
                 let isSubscribed = true;
                 let previousRows = null;
@@ -415,15 +415,14 @@ export const createEvolu = (schema, config) => async (run) => {
                     assert(isSubscribed, "subscribeQuery unsubscribe can be called only once.");
                     isSubscribed = false;
                     previousRows = null;
-                    unsubscribe();
-                    if (disposables.disposed)
+                    if (disposed)
                         return;
+                    unsubscribe();
                     subscribedQueriesRefCount.decrement(query);
                 };
             },
             getQueryRows,
             exportDatabase: () => {
-                assertNotDisposed(disposables);
                 if (!exportDatabasePending) {
                     exportDatabasePending =
                         Promise.withResolvers();
@@ -432,21 +431,14 @@ export const createEvolu = (schema, config) => async (run) => {
                 return exportDatabasePending.promise;
             },
             deleteDatabase: () => {
-                assertNotDisposed(disposables);
                 todo();
             },
             deleteOwner: (owner) => {
-                assertNotDisposed(disposables);
                 void owner;
                 todo();
             },
             useOwner,
-            [Symbol.asyncDispose]: () => {
-                if (!disposables.disposed)
-                    console.info("disposeEvolu");
-                return disposables.disposeAsync();
-            },
-        });
+        }, disposer));
     }
     catch (e_2) {
         env_2.error = e_2;

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

@@ -3,10 +3,10 @@
  *
  * @module
  */
-import type { RandomBytesDep } from "../Crypto.js";
-import type { Mnemonic } from "../Type.js";
-import type { AppOwner } from "./Owner.js";
-import { OwnerId } from "./Owner.js";
+import type { RandomBytesDep } from "../Crypto.ts";
+import type { Mnemonic } from "../Type.ts";
+import type { AppOwner } from "./Owner.ts";
+import { OwnerId } from "./Owner.ts";
 /**
  * Local authentication and authorization system for Evolu. This is API is
  * subject to change and not recommended for production use.

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

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

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

@@ -3,10 +3,10 @@
  *
  * @module
  */
-import type { NonEmptyReadonlyArray } from "../Array.js";
-import type { RandomBytesDep } from "../Crypto.js";
-import { Mnemonic, NonNegativeInt, type Typed } from "../Type.js";
-import { TimestampBytes } from "./Timestamp.js";
+import type { NonEmptyReadonlyArray } from "../Array.ts";
+import type { RandomBytesDep } from "../Crypto.ts";
+import { Mnemonic, NonNegativeInt, type Typed } from "../Type.ts";
+import { TimestampBytes } from "./Timestamp.ts";
 /**
  * {@link Owner} without a {@link OwnerWriteKey}.
  *
@@ -61,25 +61,25 @@ export interface SyncOwner {
     readonly transports: NonEmptyReadonlyArray<OwnerTransport>;
 }
 /** OwnerId is a branded {@link Id} that uniquely identifies an {@link Owner}. */
-export declare const OwnerId: import("../Type.js").BrandType<import("../Type.js").BrandType<import("../Type.js").Type<"String", string, string, import("../Type.js").StringError, string, import("../Type.js").StringError>, "Id", import("../Type.js").IdError, import("../Type.js").StringError>, "OwnerId", import("../Type.js").BrandWithoutRefineError<"OwnerId", import("../Type.js").StringError | import("../Type.js").IdError>, never>;
-export type OwnerId = typeof OwnerId.Type;
+export declare const OwnerId: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"String", string, string, import("../Type.ts").TypeOfError<"String">, null, import("../Type.ts").TypeOfError<"String">, never, string, true>, "Id", import("../Type.ts").IdError>, "OwnerId", never>;
+export type OwnerId = typeof OwnerId.Output;
 /** Bytes representation of {@link OwnerId}. */
-export declare const OwnerIdBytes: import("../Type.js").BrandType<import("../Type.js").BrandType<import("../Type.js").BrandType<import("../Type.js").Type<"Uint8Array", Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>, import("../Type.js").Uint8ArrayError, Uint8Array<ArrayBufferLike>, import("../Type.js").Uint8ArrayError>, "Length16", import("../Type.js").LengthError<16>, import("../Type.js").Uint8ArrayError>, "IdBytes", import("../Type.js").BrandWithoutRefineError<"IdBytes", import("../Type.js").Uint8ArrayError | import("../Type.js").LengthError<16>>, never>, "OwnerIdBytes", import("../Type.js").BrandWithoutRefineError<"OwnerIdBytes", import("../Type.js").BrandWithoutRefineError<"IdBytes", import("../Type.js").Uint8ArrayError | import("../Type.js").LengthError<16>>>, never>;
-export type OwnerIdBytes = typeof OwnerIdBytes.Type;
+export declare const OwnerIdBytes: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Uint8Array", Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>, import("../Type.ts").ObjectTagError<"Uint8Array">, null, import("../Type.ts").ObjectTagError<"Uint8Array">, never, Uint8Array<ArrayBufferLike>, true>, "Length16", import("../Type.ts").LengthError<16>>, "IdBytes", never>, "OwnerIdBytes", never>;
+export type OwnerIdBytes = typeof OwnerIdBytes.Output;
 /** Converts {@link OwnerId} to {@link OwnerIdBytes}. */
 export declare const ownerIdToOwnerIdBytes: (ownerId: OwnerId) => OwnerIdBytes;
 /** Converts {@link OwnerIdBytes} to {@link OwnerId}. */
 export declare const ownerIdBytesToOwnerId: (ownerIdBytes: OwnerIdBytes) => OwnerId;
-export declare const ownerWriteKeyLength: number & import("../Brand.js").Brand<"Int"> & import("../Brand.js").Brand<"NonNegative">;
+export declare const ownerWriteKeyLength: number & import("../Brand.ts").Brand<"NonNaN"> & import("../Brand.ts").Brand<"Finite"> & import("../Brand.ts").Brand<"Int"> & import("../Brand.ts").Brand<"NonNegative">;
 /** Symmetric encryption key for {@link Owner} data protection. */
-export declare const OwnerEncryptionKey: import("../Type.js").BrandType<import("../Type.js").BrandType<import("../Type.js").BrandType<import("../Type.js").Type<"Brand", Uint8Array<ArrayBufferLike> & import("../Brand.js").Brand<"Entropy">, Uint8Array<ArrayBufferLike>, import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError>, Uint8Array<ArrayBufferLike>, never>, "Length32", import("../Type.js").LengthError<32>, import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError>>, "EncryptionKey", import("../Type.js").BrandWithoutRefineError<"EncryptionKey", import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError> | import("../Type.js").LengthError<32>>, never>, "OwnerEncryptionKey", import("../Type.js").BrandWithoutRefineError<"OwnerEncryptionKey", import("../Type.js").BrandWithoutRefineError<"EncryptionKey", import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError> | import("../Type.js").LengthError<32>>>, never>;
-export type OwnerEncryptionKey = typeof OwnerEncryptionKey.Type;
+export declare const OwnerEncryptionKey: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Uint8Array", Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>, import("../Type.ts").ObjectTagError<"Uint8Array">, null, import("../Type.ts").ObjectTagError<"Uint8Array">, never, Uint8Array<ArrayBufferLike>, true>, "Entropy", never>, "Length32", import("../Type.ts").LengthError<32>>, "EncryptionKey", never>, "OwnerEncryptionKey", never>;
+export type OwnerEncryptionKey = typeof OwnerEncryptionKey.Output;
 /**
  * A secure token for write operations. It's derived from {@link OwnerSecret} by
  * default and can be rotated via {@link createOwnerWriteKey}.
  */
-export declare const OwnerWriteKey: import("../Type.js").BrandType<import("../Type.js").BrandType<import("../Type.js").Type<"Brand", Uint8Array<ArrayBufferLike> & import("../Brand.js").Brand<"Entropy">, Uint8Array<ArrayBufferLike>, import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError>, Uint8Array<ArrayBufferLike>, never>, "Length16", import("../Type.js").LengthError<16>, import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError>>, "OwnerWriteKey", import("../Type.js").BrandWithoutRefineError<"OwnerWriteKey", import("../Type.js").LengthError<16> | import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError>>, never>;
-export type OwnerWriteKey = typeof OwnerWriteKey.Type;
+export declare const OwnerWriteKey: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Uint8Array", Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>, import("../Type.ts").ObjectTagError<"Uint8Array">, null, import("../Type.ts").ObjectTagError<"Uint8Array">, never, Uint8Array<ArrayBufferLike>, true>, "Entropy", never>, "Length16", import("../Type.ts").LengthError<16>>, "OwnerWriteKey", never>;
+export type OwnerWriteKey = typeof OwnerWriteKey.Output;
 /**
  * Creates a new random {@link OwnerWriteKey} for rotation.
  *
@@ -94,12 +94,12 @@ export declare const createOwnerWriteKey: (deps: RandomBytesDep) => OwnerWriteKe
  * Can be created using {@link createOwnerSecret} or converted from a
  * {@link Mnemonic} using {@link mnemonicToOwnerSecret}.
  */
-export declare const OwnerSecret: import("../Type.js").BrandType<import("../Type.js").BrandType<import("../Type.js").Type<"Brand", Uint8Array<ArrayBufferLike> & import("../Brand.js").Brand<"Entropy">, Uint8Array<ArrayBufferLike>, import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError>, Uint8Array<ArrayBufferLike>, never>, "Length32", import("../Type.js").LengthError<32>, import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError>>, "OwnerSecret", import("../Type.js").BrandWithoutRefineError<"OwnerSecret", import("../Type.js").BrandWithoutRefineError<"Entropy", import("../Type.js").Uint8ArrayError> | import("../Type.js").LengthError<32>>, never>;
-export type OwnerSecret = typeof OwnerSecret.Type;
+export declare const OwnerSecret: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Uint8Array", Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>, import("../Type.ts").ObjectTagError<"Uint8Array">, null, import("../Type.ts").ObjectTagError<"Uint8Array">, never, Uint8Array<ArrayBufferLike>, true>, "Entropy", never>, "Length32", import("../Type.ts").LengthError<32>>, "OwnerSecret", never>;
+export type OwnerSecret = typeof OwnerSecret.Output;
 /** Creates a {@link OwnerSecret}. */
 export declare const createOwnerSecret: (deps: RandomBytesDep) => OwnerSecret;
 /** Deterministic {@link OwnerSecret} for tests. */
-export declare const testOwnerSecret: Uint8Array<ArrayBufferLike> & import("../Brand.js").Brand<"Entropy"> & import("../Brand.js").Brand<"Length32"> & import("../Brand.js").Brand<"OwnerSecret">;
+export declare const testOwnerSecret: Uint8Array<ArrayBufferLike> & import("../Brand.ts").Brand<"Entropy"> & import("../Brand.ts").Brand<"Length32"> & import("../Brand.ts").Brand<"OwnerSecret">;
 /** Converts an {@link OwnerSecret} to a {@link Mnemonic}. */
 export declare const ownerSecretToMnemonic: (secret: OwnerSecret) => Mnemonic;
 /** Converts a {@link Mnemonic} to an {@link OwnerSecret}. */
@@ -251,15 +251,37 @@ export interface OwnerWebSocketTransport extends Typed<"WebSocket"> {
  * ### Example
  *
  * ```ts
- * // Create transport "wss://relay.evolu.dev?ownerId=..."
+ * import {
+ *   AppName,
+ *   createAppOwner,
+ *   createEvolu,
+ *   createOwnerWebSocketTransport,
+ *   createOwnerSecret,
+ *   createRandomBytes,
+ *   id,
+ * } from "@evolu/common";
+ *
+ * // Create once, persist the mnemonic securely, and restore it on later runs.
+ * const appOwner = createAppOwner(
+ *   createOwnerSecret({ randomBytes: createRandomBytes() }),
+ * );
  * const transport = createOwnerWebSocketTransport({
  *   url: "wss://relay.evolu.dev",
- *   ownerId: owner.id,
+ *   ownerId: appOwner.id,
  * });
+ * const createTodoEvolu = createEvolu(
+ *   { todo: { id: id("Todo") } },
+ *   {
+ *     appName: AppName.orThrow("OwnerTransportExample"),
+ *     appOwner,
+ *     transports: [transport],
+ *   },
+ * );
  *
- * // Use with createEvolu
- * const evolu = createEvolu(deps)(Schema, {
- *   transports: [transport],
+ * expect(createTodoEvolu).toBeTypeOf("function");
+ * expect(transport).toEqual({
+ *   type: "WebSocket",
+ *   url: `wss://relay.evolu.dev?ownerId=${appOwner.id}`,
  * });
  * ```
  */
@@ -277,10 +299,25 @@ export declare const createOwnerWebSocketTransport: (config: {
  * ### Example
  *
  * ```ts
- * parseOwnerIdFromOwnerWebSocketTransportUrl(
- *   "/sync?ownerId=_12345678abcdefgh",
+ * import {
+ *   createAppOwner,
+ *   createOwnerSecret,
+ *   createRandomBytes,
+ *   parseOwnerIdFromOwnerWebSocketTransportUrl,
+ * } from "@evolu/common";
+ *
+ * // Create once, persist the mnemonic securely, and restore it on later runs.
+ * const appOwner = createAppOwner(
+ *   createOwnerSecret({ randomBytes: createRandomBytes() }),
+ * );
+ * const url = `/sync?ownerId=${appOwner.id}`;
+ *
+ * expect(parseOwnerIdFromOwnerWebSocketTransportUrl(url)).toBe(
+ *   appOwner.id,
  * );
- * // Returns: OwnerId or null
+ * expect(
+ *   parseOwnerIdFromOwnerWebSocketTransportUrl("/sync?ownerId=invalid"),
+ * ).toBeNull();
  * ```
  */
 export declare const parseOwnerIdFromOwnerWebSocketTransportUrl: (url: string) => OwnerId | null;

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

@@ -1 +1 @@
-{"version":3,"file":"Owner.d.ts","sourceRoot":"","sources":["../../../src/local-first/Owner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAUnD,OAAO,EAML,QAAQ,EACR,cAAc,EACd,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC1C,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAC;CAC5D;AAED,iFAAiF;AACjF,eAAO,MAAM,OAAO,mZAAqC,CAAC;AAC1D,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C,+CAA+C;AAC/C,eAAO,MAAM,YAAY,uvBAA+C,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAC;AAEpD,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,GAAI,SAAS,OAAO,KAAG,YACnB,CAAC;AAEvC,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,GAAI,cAAc,YAAY,KAAG,OAC7B,CAAC;AAEvC,eAAO,MAAM,mBAAmB,0FAA2C,CAAC;AAE5E,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,8/BAG9B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAC;AAEhE;;;GAGG;AACH,eAAO,MAAM,aAAa,wrBAAkD,CAAC;AAC7E,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,cAAc,KAAG,aACb,CAAC;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,WAAW,orBAAgD,CAAC;AACzE,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAC;AAElD,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,GAAI,MAAM,cAAc,KAAG,WACb,CAAC;AAE7C,mDAAmD;AACnD,eAAO,MAAM,eAAe,6JAI1B,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,GAAI,QAAQ,WAAW,KAAG,QACL,CAAC;AAExD,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,GAAI,UAAU,QAAQ,KAAG,WACC,CAAC;AAsB7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,QAAS,SAAQ,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC;IACxD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,+DAA+D;AAC/D,eAAO,MAAM,cAAc,GAAI,QAAQ,WAAW,KAAG,QAInD,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,YAAY,UAAgD,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAW,SAAQ,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;CAAG;AAEjE,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,GAAI,QAAQ,WAAW,KAAG,UAGrD,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,QAAQ,EACf,MAAM,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,KAC3C,UAOF,CAAC;AAEF,iEAAiE;AACjE,MAAM,WAAW,WAAY,SAAQ,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC;CAAG;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,WAAW,KAAG,WAGtD,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,mBACf,SAAQ,aAAa,EAAE,KAAK,CAAC,qBAAqB,CAAC;CAAG;AAExD,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,GACpC,aAAa,WAAW,KACvB,mBAID,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,uBAAwB,SAAQ,KAAK,CAAC,WAAW,CAAC;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,6BAA6B,GAAI,QAAQ;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,KAAG,uBAGF,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,0CAA0C,GACrD,KAAK,MAAM,KACV,OAAO,GAAG,IAAyD,CAAC;AAEvE,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAE/B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IAErC,wEAAwE;IACxE,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAE/C;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,cAAe,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,GAAG,qBAAqB,CAAC;CAC5E"}
+{"version":3,"file":"Owner.d.ts","sourceRoot":"","sources":["../../../src/local-first/Owner.ts"],"names":[],"mappings":"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"}

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

@@ -128,15 +128,37 @@ export const createSharedReadonlyOwner = (sharedOwner) => ({
  * ### Example
  *
  * ```ts
- * // Create transport "wss://relay.evolu.dev?ownerId=..."
+ * import {
+ *   AppName,
+ *   createAppOwner,
+ *   createEvolu,
+ *   createOwnerWebSocketTransport,
+ *   createOwnerSecret,
+ *   createRandomBytes,
+ *   id,
+ * } from "@evolu/common";
+ *
+ * // Create once, persist the mnemonic securely, and restore it on later runs.
+ * const appOwner = createAppOwner(
+ *   createOwnerSecret({ randomBytes: createRandomBytes() }),
+ * );
  * const transport = createOwnerWebSocketTransport({
  *   url: "wss://relay.evolu.dev",
- *   ownerId: owner.id,
+ *   ownerId: appOwner.id,
  * });
+ * const createTodoEvolu = createEvolu(
+ *   { todo: { id: id("Todo") } },
+ *   {
+ *     appName: AppName.orThrow("OwnerTransportExample"),
+ *     appOwner,
+ *     transports: [transport],
+ *   },
+ * );
  *
- * // Use with createEvolu
- * const evolu = createEvolu(deps)(Schema, {
- *   transports: [transport],
+ * expect(createTodoEvolu).toBeTypeOf("function");
+ * expect(transport).toEqual({
+ *   type: "WebSocket",
+ *   url: `wss://relay.evolu.dev?ownerId=${appOwner.id}`,
  * });
  * ```
  */
@@ -154,10 +176,25 @@ export const createOwnerWebSocketTransport = (config) => ({
  * ### Example
  *
  * ```ts
- * parseOwnerIdFromOwnerWebSocketTransportUrl(
- *   "/sync?ownerId=_12345678abcdefgh",
+ * import {
+ *   createAppOwner,
+ *   createOwnerSecret,
+ *   createRandomBytes,
+ *   parseOwnerIdFromOwnerWebSocketTransportUrl,
+ * } from "@evolu/common";
+ *
+ * // Create once, persist the mnemonic securely, and restore it on later runs.
+ * const appOwner = createAppOwner(
+ *   createOwnerSecret({ randomBytes: createRandomBytes() }),
+ * );
+ * const url = `/sync?ownerId=${appOwner.id}`;
+ *
+ * expect(parseOwnerIdFromOwnerWebSocketTransportUrl(url)).toBe(
+ *   appOwner.id,
  * );
- * // Returns: OwnerId or null
+ * expect(
+ *   parseOwnerIdFromOwnerWebSocketTransportUrl("/sync?ownerId=invalid"),
+ * ).toBeNull();
  * ```
  */
 export const parseOwnerIdFromOwnerWebSocketTransportUrl = (url) => getOrNull(OwnerId.fromUnknown(url.split("=")[1]));

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

@@ -159,18 +159,18 @@
  *
  * @module
  */
-import { type NonEmptyReadonlyArray } from "../Array.js";
-import type { Brand } from "../Brand.js";
-import { type Buffer } from "../Buffer.js";
-import type { ConsoleDep } from "../Console.js";
-import { type DecryptWithXChaCha20Poly1305Error, EncryptionKey, type RandomBytesDep } from "../Crypto.js";
-import { type Result } from "../Result.js";
-import { SqliteValue } from "../Sqlite.js";
-import type { Task } from "../Task.js";
-import { NonNegativeInt, PositiveInt, type Typed } from "../Type.js";
-import { type Owner, type OwnerError, OwnerId, OwnerWriteKey } from "./Owner.js";
-import { type BaseRange, type CrdtMessage, DbChange, type EncryptedCrdtMessage, type EncryptedDbChange, type FingerprintRange, RangeType, type SkipRange, type StorageDep } from "./Storage.js";
-import { NodeId, Timestamp } from "./Timestamp.js";
+import { type NonEmptyReadonlyArray } from "../Array.ts";
+import type { Brand } from "../Brand.ts";
+import { type Buffer } from "../Buffer.ts";
+import type { ConsoleDep } from "../Console.ts";
+import { type DecryptWithXChaCha20Poly1305Error, EncryptionKey, type RandomBytesDep } from "../Crypto.ts";
+import { type Result } from "../Result.ts";
+import { SqliteValue } from "../Sqlite.ts";
+import { type Task } from "../Task.ts";
+import { NonNegativeInt, PositiveInt, type Typed } from "../Type.ts";
+import { type Owner, type OwnerError, OwnerId, OwnerWriteKey } from "./Owner.ts";
+import { type BaseRange, type CrdtMessage, DbChange, type EncryptedCrdtMessage, type EncryptedDbChange, type FingerprintRange, RangeType, type SkipRange, type StorageDep } from "./Storage.ts";
+import { NodeId, Timestamp } from "./Timestamp.ts";
 /**
  * Protocol message maximum size.
  *
@@ -187,8 +187,8 @@ import { NodeId, Timestamp } from "./Timestamp.js";
  * Increasing this value on the client side would break compatibility with
  * relays that enforce smaller limits.
  */
-export declare const ProtocolMessageMaxSize: import("../Type.js").BrandType<import("../Type.js").Type<"Brand", number & Brand<"Int">, number, import("../Type.js").IntError, number, import("../Type.js").NumberError>, "Between1000000-100000000", import("../Type.js").BetweenError<1000000, 100000000>, import("../Type.js").NumberError | import("../Type.js").IntError>;
-export type ProtocolMessageMaxSize = typeof ProtocolMessageMaxSize.Type;
+export declare const ProtocolMessageMaxSize: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Number", number, number, import("../Type.ts").TypeOfError<"Number">, null, import("../Type.ts").TypeOfError<"Number">, never, number, true>, "NonNaN", import("../Type.ts").NonNaNError>, "Finite", import("../Type.ts").FiniteError>, "Int", import("../Type.ts").IntError>, "Between1000000-100000000", import("../Type.ts").BetweenError<1000000, 100000000>>;
+export type ProtocolMessageMaxSize = typeof ProtocolMessageMaxSize.Output;
 /**
  * Default {@link ProtocolMessageMaxSize} (1MB).
  *
@@ -207,8 +207,8 @@ export declare const defaultProtocolMessageMaxSize: ProtocolMessageMaxSize;
  * {@link defaultProtocolMessageMaxSize}, maintaining compatibility between all
  * clients and relays.
  */
-export declare const ProtocolMessageRangesMaxSize: import("../Type.js").BrandType<import("../Type.js").Type<"Brand", number & Brand<"Int">, number, import("../Type.js").IntError, number, import("../Type.js").NumberError>, "Between3000-100000", import("../Type.js").BetweenError<3000, 100000>, import("../Type.js").NumberError | import("../Type.js").IntError>;
-export type ProtocolMessageRangesMaxSize = typeof ProtocolMessageRangesMaxSize.Type;
+export declare const ProtocolMessageRangesMaxSize: import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").BrandType<import("../Type.ts").Type<"Number", number, number, import("../Type.ts").TypeOfError<"Number">, null, import("../Type.ts").TypeOfError<"Number">, never, number, true>, "NonNaN", import("../Type.ts").NonNaNError>, "Finite", import("../Type.ts").FiniteError>, "Int", import("../Type.ts").IntError>, "Between3000-100000", import("../Type.ts").BetweenError<3000, 100000>>;
+export type ProtocolMessageRangesMaxSize = typeof ProtocolMessageRangesMaxSize.Output;
 /**
  * Default {@link ProtocolMessageRangesMaxSize} (30KB).
  *
@@ -219,7 +219,7 @@ export declare const defaultProtocolMessageRangesMaxSize: ProtocolMessageRangesM
 /** Evolu Protocol Message. */
 export type ProtocolMessage = Uint8Array & Brand<"ProtocolMessage">;
 /** Evolu Protocol version. */
-export declare const protocolVersion: number & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">;
+export declare const protocolVersion: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative"> & Brand<"Positive">;
 export declare const MessageType: {
     /** Request message from initiator (client) to non-initiator (relay). */
     readonly Request: 0;
@@ -427,7 +427,13 @@ export declare const decodeNumber: (buffer: Buffer) => number;
  * ### Example
  *
  * ```ts
- * encodeFlags(buffer, [true, false, true]); // Encodes bits 0, 1, 2
+ * import { createBuffer } from "@evolu/common";
+ * import { encodeFlags } from "@evolu/common/local-first";
+ *
+ * const buffer = createBuffer();
+ * encodeFlags(buffer, [true, false, true]);
+ *
+ * expect(buffer.unwrap()).toEqual(new Uint8Array([0b101]));
  * ```
  */
 export declare const encodeFlags: (buffer: Buffer, flags: ReadonlyArray<boolean>) => void;
@@ -437,7 +443,14 @@ export declare const encodeFlags: (buffer: Buffer, flags: ReadonlyArray<boolean>
  * ### Example
  *
  * ```ts
- * const flags = decodeFlags(buffer, 3); // Decode 3 flags
+ * import { createBuffer, PositiveInt } from "@evolu/common";
+ * import { decodeFlags } from "@evolu/common/local-first";
+ *
+ * const buffer = createBuffer([0b101]);
+ * const flags = decodeFlags(buffer, PositiveInt.orThrow(3));
+ *
+ * expect(flags).toEqual([true, false, true]);
+ * expect(buffer.getLength()).toBe(0);
  * ```
  */
 export declare const decodeFlags: (buffer: Buffer, count: PositiveInt) => ReadonlyArray<boolean>;
@@ -470,23 +483,23 @@ export declare const encodeNonNegativeInt: (buffer: Buffer, int: NonNegativeInt)
  */
 export declare const decodeNonNegativeInt: (buffer: Buffer) => NonNegativeInt;
 export declare const encodeLength: (buffer: Buffer, value: ArrayLike<any>) => void;
-export declare const decodeLength: (buffer: Buffer) => NonNegativeInt;
+export declare const decodeLength: typeof decodeNonNegativeInt;
 export declare const encodeString: (buffer: Buffer, value: string) => void;
 export declare const decodeString: (buffer: Buffer) => string;
 export declare const encodeNodeId: (buffer: Buffer, nodeId: NodeId) => void;
 export declare const decodeNodeId: (buffer: Buffer) => NodeId;
 export declare const ProtocolValueType: {
-    readonly String: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly Number: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly Null: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly Bytes: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly NonNegativeInt: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly EmptyString: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly Base64Url: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly Id: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly Json: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly DateIsoWithNonNegativeTime: number & Brand<"Int"> & Brand<"NonNegative">;
-    readonly DateIsoWithNegativeTime: number & Brand<"Int"> & Brand<"NonNegative">;
+    readonly String: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly Number: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly Null: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly Bytes: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly NonNegativeInt: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly EmptyString: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly Base64Url: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly Id: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly Json: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly DateIsoWithNonNegativeTime: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
+    readonly DateIsoWithNegativeTime: number & Brand<"NonNaN"> & Brand<"Finite"> & Brand<"Int"> & Brand<"NonNegative">;
 };
 export declare const encodeSqliteValue: (buffer: Buffer, value: SqliteValue) => void;
 export declare const decodeSqliteValue: (buffer: Buffer) => SqliteValue;