@evolu/common 8.4.0 → 8.6.0

package/src/intl/te.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -335,10 +336,6 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet") {
     return `విలువ ${safelyStringifyUnknownValue(error.reason.value)} Set కాదు.`;
   }
-  if (error.reason.kind === "UnexpectedPrototype") {
-    return "విలువ Set subclass యొక్క instance, కానీ Set Output నేరుగా Set instance అయి ఉండాలి.";
-  }
-
   const issue = error.reason.issues[0];
 
   switch (issue.kind) {
@@ -349,6 +346,24 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   }
 };
 
+/** MapErrorను తెలుగులో ఫార్మాట్ చేస్తుంది. */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap") {
+    return `విలువ ${safelyStringifyUnknownValue(error.reason.value)} Map కాదు.`;
+  }
+  const issue = error.reason.issues[0];
+
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `అదనపు Map property ${safelyStringifyUnknownValue(issue.key)} అనుమతించబడదు.`;
+    case "Key":
+    case "Value":
+      return `సూచిక ${issue.index} వద్ద Map element చెల్లదు.`;
+    case "Collision":
+      return `Map keys ${safelyStringifyUnknownValue(issue.previousKey)} మరియు ${safelyStringifyUnknownValue(issue.key)} ఒకే key ${safelyStringifyUnknownValue(issue.outputKey)} కు decode అవుతాయి.`;
+  }
+};
+
 /** TupleErrorను తెలుగులో ఫార్మాట్ చేస్తుంది. */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/intl/th.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -332,10 +333,6 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet") {
     return `ค่า ${safelyStringifyUnknownValue(error.reason.value)} ไม่ใช่ Set`;
   }
-  if (error.reason.kind === "UnexpectedPrototype") {
-    return "ค่านี้เป็นอินสแตนซ์ของคลาสย่อย Set แต่ Set Output ต้องเป็นอินสแตนซ์ของ Set โดยตรง";
-  }
-
   const issue = error.reason.issues[0];
 
   switch (issue.kind) {
@@ -346,6 +343,24 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   }
 };
 
+/** จัดรูปแบบ MapError เป็นภาษาไทย */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap") {
+    return `ค่า ${safelyStringifyUnknownValue(error.reason.value)} ไม่ใช่ Map`;
+  }
+  const issue = error.reason.issues[0];
+
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `ไม่อนุญาตให้มี Map property ส่วนเกิน ${safelyStringifyUnknownValue(issue.key)}`;
+    case "Key":
+    case "Value":
+      return `องค์ประกอบ Map ที่ดัชนี ${issue.index} ไม่ถูกต้อง`;
+    case "Collision":
+      return `คีย์ Map ${safelyStringifyUnknownValue(issue.previousKey)} และ ${safelyStringifyUnknownValue(issue.key)} ถอดรหัสเป็นคีย์เดียวกัน ${safelyStringifyUnknownValue(issue.outputKey)}`;
+  }
+};
+
 /** จัดรูปแบบ TupleError เป็นภาษาไทย */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/intl/tr.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -335,10 +336,6 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet") {
     return `Değer ${safelyStringifyUnknownValue(error.reason.value)} bir Set değildir.`;
   }
-  if (error.reason.kind === "UnexpectedPrototype") {
-    return "Değer bir Set alt sınıfının örneğidir, ancak bir Set Output doğrudan bir Set örneği olmalıdır.";
-  }
-
   const issue = error.reason.issues[0];
 
   switch (issue.kind) {
@@ -349,6 +346,24 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   }
 };
 
+/** Formats a MapError in Turkish. */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap") {
+    return `Değer ${safelyStringifyUnknownValue(error.reason.value)} bir Map değildir.`;
+  }
+  const issue = error.reason.issues[0];
+
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `Fazladan Map özelliğine ${safelyStringifyUnknownValue(issue.key)} izin verilmez.`;
+    case "Key":
+    case "Value":
+      return `${issue.index} dizinindeki Map öğesi geçersiz.`;
+    case "Collision":
+      return `Map anahtarları ${safelyStringifyUnknownValue(issue.previousKey)} ve ${safelyStringifyUnknownValue(issue.key)}, aynı ${safelyStringifyUnknownValue(issue.outputKey)} anahtarına çözümleniyor.`;
+  }
+};
+
 /** Formats a TupleError in Turkish. */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/intl/uk.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -336,10 +337,6 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet") {
     return `A value ${safelyStringifyUnknownValue(error.reason.value)} is not a Set.`;
   }
-  if (error.reason.kind === "UnexpectedPrototype") {
-    return "The value is an instance of a Set subclass, but a Set Output must be a direct Set instance.";
-  }
-
   const issue = error.reason.issues[0];
 
   switch (issue.kind) {
@@ -350,6 +347,24 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   }
 };
 
+/** Formats a MapError in English. */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap") {
+    return `A value ${safelyStringifyUnknownValue(error.reason.value)} is not a Map.`;
+  }
+  const issue = error.reason.issues[0];
+
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `An excess Map property ${safelyStringifyUnknownValue(issue.key)} is not allowed.`;
+    case "Key":
+    case "Value":
+      return `A Map element at index ${issue.index} is invalid.`;
+    case "Collision":
+      return `Map keys ${safelyStringifyUnknownValue(issue.previousKey)} and ${safelyStringifyUnknownValue(issue.key)} decode to the same key ${safelyStringifyUnknownValue(issue.outputKey)}.`;
+  }
+};
+
 /** Formats a TupleError in English. */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/intl/ur.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -284,8 +285,6 @@ export const formatArrayError: TypeErrorFormatter<ArrayError> = (error) => {
 export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet")
     return `قدر ${safelyStringifyUnknownValue(error.reason.value)} Set نہیں ہے۔`;
-  if (error.reason.kind === "UnexpectedPrototype")
-    return "قدر Set subclass کی instance ہے، لیکن Set Output براہ راست Set instance ہونا چاہیے۔";
   const issue = error.reason.issues[0];
   switch (issue.kind) {
     case "ExcessProperty":
@@ -294,6 +293,22 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
       return `index ${issue.index} پر Set element درست نہیں ہے۔`;
   }
 };
+
+/** MapError کو اردو میں فارمیٹ کرتا ہے۔ */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap")
+    return `قدر ${safelyStringifyUnknownValue(error.reason.value)} Map نہیں ہے۔`;
+  const issue = error.reason.issues[0];
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `اضافی Map property ${safelyStringifyUnknownValue(issue.key)} کی اجازت نہیں ہے۔`;
+    case "Key":
+    case "Value":
+      return `index ${issue.index} پر Map element درست نہیں ہے۔`;
+    case "Collision":
+      return `Map keys ${safelyStringifyUnknownValue(issue.previousKey)} اور ${safelyStringifyUnknownValue(issue.key)} decode ہونے کے بعد ایک ہی key ${safelyStringifyUnknownValue(issue.outputKey)} بن جاتے ہیں۔`;
+  }
+};
 /** TupleError کو اردو میں فارمیٹ کرتا ہے۔ */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/intl/vi.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -289,9 +290,6 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet") {
     return `Giá trị ${safelyStringifyUnknownValue(error.reason.value)} không phải là Set.`;
   }
-  if (error.reason.kind === "UnexpectedPrototype") {
-    return "Giá trị là một thể hiện của lớp con Set, nhưng Set Output phải là một thể hiện Set trực tiếp.";
-  }
   const issue = error.reason.issues[0];
 
   switch (issue.kind) {
@@ -302,6 +300,24 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   }
 };
 
+/** Định dạng MapError bằng tiếng Việt. */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap") {
+    return `Giá trị ${safelyStringifyUnknownValue(error.reason.value)} không phải là Map.`;
+  }
+  const issue = error.reason.issues[0];
+
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `Không cho phép thuộc tính Map dư thừa ${safelyStringifyUnknownValue(issue.key)}.`;
+    case "Key":
+    case "Value":
+      return `Phần tử Map tại chỉ mục ${issue.index} không hợp lệ.`;
+    case "Collision":
+      return `Các khóa Map ${safelyStringifyUnknownValue(issue.previousKey)} và ${safelyStringifyUnknownValue(issue.key)} giải mã thành cùng một khóa ${safelyStringifyUnknownValue(issue.outputKey)}.`;
+  }
+};
+
 /** Định dạng TupleError bằng tiếng Việt. */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/intl/zh-CN.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -330,10 +331,6 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet") {
     return `值 ${safelyStringifyUnknownValue(error.reason.value)} 不是 Set。`;
   }
-  if (error.reason.kind === "UnexpectedPrototype") {
-    return "该值是 Set 子类的实例，但 Set Output 必须是直接的 Set 实例。";
-  }
-
   const issue = error.reason.issues[0];
 
   switch (issue.kind) {
@@ -344,6 +341,24 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   }
 };
 
+/** 以简体中文格式化 MapError。 */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap") {
+    return `值 ${safelyStringifyUnknownValue(error.reason.value)} 不是 Map。`;
+  }
+  const issue = error.reason.issues[0];
+
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `不允许多余的 Map 属性 ${safelyStringifyUnknownValue(issue.key)}。`;
+    case "Key":
+    case "Value":
+      return `索引 ${issue.index} 处的 Map 元素无效。`;
+    case "Collision":
+      return `Map 键 ${safelyStringifyUnknownValue(issue.previousKey)} 和 ${safelyStringifyUnknownValue(issue.key)} 解码后得到相同的键 ${safelyStringifyUnknownValue(issue.outputKey)}。`;
+  }
+};
+
 /** 以简体中文格式化 TupleError。 */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/intl/zh-TW.ts

@@ -30,6 +30,7 @@ import type {
   LessThanError,
   LessThanOrEqualToError,
   LiteralError,
+  MapError,
   MaxLengthError,
   MinLengthError,
   MnemonicError,
@@ -330,10 +331,6 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   if (error.reason.kind === "NotSet") {
     return `值 ${safelyStringifyUnknownValue(error.reason.value)} 不是 Set。`;
   }
-  if (error.reason.kind === "UnexpectedPrototype") {
-    return "此值是 Set 子類別的執行個體，但 Set Output 必須是直接的 Set 執行個體。";
-  }
-
   const issue = error.reason.issues[0];
 
   switch (issue.kind) {
@@ -344,6 +341,24 @@ export const formatSetError: TypeErrorFormatter<SetError> = (error) => {
   }
 };
 
+/** 以繁體中文格式化 MapError。 */
+export const formatMapError: TypeErrorFormatter<MapError> = (error) => {
+  if (error.reason.kind === "NotMap") {
+    return `值 ${safelyStringifyUnknownValue(error.reason.value)} 不是 Map。`;
+  }
+  const issue = error.reason.issues[0];
+
+  switch (issue.kind) {
+    case "ExcessProperty":
+      return `不允許多餘的 Map 屬性 ${safelyStringifyUnknownValue(issue.key)}。`;
+    case "Key":
+    case "Value":
+      return `索引 ${issue.index} 的 Map 元素無效。`;
+    case "Collision":
+      return `Map 鍵 ${safelyStringifyUnknownValue(issue.previousKey)} 和 ${safelyStringifyUnknownValue(issue.key)} 解碼為相同的鍵 ${safelyStringifyUnknownValue(issue.outputKey)}。`;
+  }
+};
+
 /** 以繁體中文格式化 TupleError。 */
 export const formatTupleError: TypeErrorFormatter<
   TupleError | TupleElementsError<TypeError>

package/src/local-first/Db.ts

@@ -924,7 +924,8 @@ const applyMessages =
      */
     updateOwnerUsage(deps)(
       ownerIdBytes,
-      onePositiveInt, // Placeholder until proper tracking implemented
+      // Placeholder until proper tracking implemented
+      onePositiveInt,
       firstTimestamp,
       lastTimestamp,
     );

package/src/local-first/Evolu.ts

@@ -97,10 +97,10 @@ export interface EvoluConfig {
    * ### Example
    *
    * ```ts
-   * import { AppName } from "@evolu/common";
+   * import { AppName, assertEqual } from "@evolu/common";
    *
    * const appName = AppName.orThrow("MyApp");
-   * expect(appName).toBe("MyApp");
+   * assertEqual(appName, "MyApp");
    * ```
    */
   readonly appName: AppName;
@@ -164,6 +164,7 @@ export interface EvoluConfig {
    *
    * ```ts
    * import {
+   *   assertEqual,
    *   createAppOwner,
    *   createOwnerWebSocketTransport,
    *   createOwnerSecret,
@@ -177,19 +178,19 @@ export interface EvoluConfig {
    * );
    *
    * // Use one relay.
-   * const singleRelay = [
+   * const _singleRelay = [
    *   { type: "WebSocket", url: "wss://relay1.example.com" },
    * ] satisfies ReadonlyArray<OwnerTransport>;
    *
    * // Use independent relays for redundancy.
-   * const redundantRelays = [
+   * const _redundantRelays = [
    *   { type: "WebSocket", url: "wss://relay1.example.com" },
    *   { type: "WebSocket", url: "wss://relay2.example.com" },
    * ] satisfies ReadonlyArray<OwnerTransport>;
    *
    * // Start local-only before authentication. After authentication, pass an
    * // owner-scoped transport to evolu.useOwner.
-   * const localOnlyBeforeAuthentication =
+   * const _localOnlyBeforeAuthentication =
    *   [] satisfies ReadonlyArray<OwnerTransport>;
    *
    * // Include the OwnerId when the relay authenticates owners.
@@ -200,7 +201,8 @@ export interface EvoluConfig {
    *   }),
    * ];
    *
-   * expect(authenticatedRelay[0]?.url).toBe(
+   * assertEqual(
+   *   authenticatedRelay[0]?.url,
    *   `wss://relay.example.com?ownerId=${appOwner.id}`,
    * );
    * ```
@@ -231,6 +233,7 @@ export interface EvoluConfig {
    * ```ts
    * import {
    *   AppName,
+   *   assertTrue,
    *   createAppOwner,
    *   createEvolu,
    *   createOwnerSecret,
@@ -259,7 +262,7 @@ export interface EvoluConfig {
    *   ],
    * });
    *
-   * expect(createTodoEvolu).toBeTypeOf("function");
+   * assertTrue(typeof createTodoEvolu === "function");
    * ```
    */
   readonly indexes?: IndexesConfig;
@@ -340,6 +343,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertType,
    *   id,
    *   NonEmptyTrimmedString100,
    *   type Evolu,
@@ -366,12 +370,13 @@ export interface Evolu<
    *     { onComplete },
    *   ).id;
    *
-   * expectTypeOf<
+   * assertType<
+   *   [TodoId, TodoId],
    *   [
    *     ReturnType<typeof insertTodo>,
    *     ReturnType<typeof insertTodoAndNotify>,
    *   ]
-   * >().toEqualTypeOf<[TodoId, TodoId]>();
+   * >();
    * ```
    *
    * @see {@link Mutation}
@@ -387,6 +392,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertType,
    *   id,
    *   NonEmptyTrimmedString100,
    *   sqliteTrue,
@@ -408,9 +414,10 @@ export interface Evolu<
    * const softDeleteTodo = (evolu: Evolu<typeof Schema>, todoId: TodoId) =>
    *   evolu.update("todo", { id: todoId, isDeleted: sqliteTrue }).id;
    *
-   * expectTypeOf<
+   * assertType<
+   *   [TodoId, TodoId],
    *   [ReturnType<typeof renameTodo>, ReturnType<typeof softDeleteTodo>]
-   * >().toEqualTypeOf<[TodoId, TodoId]>();
+   * >();
    * ```
    *
    * @see {@link Mutation}
@@ -433,6 +440,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertType,
    *   createIdFromString,
    *   id,
    *   NonEmptyTrimmedString100,
@@ -451,7 +459,7 @@ export interface Evolu<
    *     title: NonEmptyTrimmedString100.orThrow("Learn Evolu"),
    *   }).id;
    *
-   * expectTypeOf(upsertTodo).returns.toEqualTypeOf<TodoId>();
+   * assertType<TodoId, ReturnType<typeof upsertTodo>>();
    * ```
    *
    * @see {@link Mutation}
@@ -477,6 +485,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertType,
    *   createQueryBuilder,
    *   id,
    *   NonEmptyTrimmedString100,
@@ -496,8 +505,9 @@ export interface Evolu<
    *   return rows;
    * };
    *
-   * expectTypeOf(loadTodos).returns.toEqualTypeOf<
-   *   Promise<QueryRows<typeof allTodos.Row>>
+   * assertType<
+   *   Promise<QueryRows<typeof allTodos.Row>>,
+   *   ReturnType<typeof loadTodos>
    * >();
    * ```
    */
@@ -514,6 +524,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertType,
    *   createIdFromString,
    *   createQueryBuilder,
    *   id,
@@ -541,11 +552,12 @@ export interface Evolu<
    * const loadTodoQueries = (evolu: Evolu<typeof Schema>) =>
    *   evolu.loadQueries([allTodos, firstTodo]);
    *
-   * expectTypeOf(loadTodoQueries).returns.toEqualTypeOf<
+   * assertType<
    *   [
    *     Promise<QueryRows<typeof allTodos.Row>>,
    *     Promise<QueryRows<typeof firstTodo.Row>>,
-   *   ]
+   *   ],
+   *   ReturnType<typeof loadTodoQueries>
    * >();
    * ```
    */
@@ -560,6 +572,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertType,
    *   createQueryBuilder,
    *   id,
    *   NonEmptyTrimmedString100,
@@ -583,7 +596,7 @@ export interface Evolu<
    *     onRows(evolu.getQueryRows(allTodos));
    *   });
    *
-   * expectTypeOf(subscribeToTodos).returns.toEqualTypeOf<Unsubscribe>();
+   * assertType<Unsubscribe, ReturnType<typeof subscribeToTodos>>();
    * ```
    */
   readonly subscribeQuery: (
@@ -597,6 +610,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertType,
    *   createQueryBuilder,
    *   id,
    *   NonEmptyTrimmedString100,
@@ -614,8 +628,9 @@ export interface Evolu<
    * const getTodos = (evolu: Evolu<typeof Schema>) =>
    *   evolu.getQueryRows(allTodos);
    *
-   * expectTypeOf(getTodos).returns.toEqualTypeOf<
-   *   QueryRows<typeof allTodos.Row>
+   * assertType<
+   *   QueryRows<typeof allTodos.Row>,
+   *   ReturnType<typeof getTodos>
    * >();
    * ```
    */
@@ -683,6 +698,7 @@ export interface Evolu<
    *
    * ```ts
    * import {
+   *   assertEqual,
    *   createAppOwner,
    *   createOwnerWebSocketTransport,
    *   createOwnerSecret,
@@ -702,10 +718,10 @@ export interface Evolu<
    *   url: "wss://relay.example.com",
    *   ownerId: shardOwner.id,
    * });
-   * const useShardOwner = (evolu: Evolu): UnuseOwner =>
+   * const _useShardOwner = (evolu: Evolu): UnuseOwner =>
    *   evolu.useOwner(shardOwner, [shardTransport]);
    *
-   * const useOwners = (
+   * const _useOwners = (
    *   evolu: Evolu,
    *   owners: ReadonlyArray<ReadonlyOwner>,
    * ): UnuseOwner => {
@@ -723,7 +739,7 @@ export interface Evolu<
    * };
    *
    * // Call each returned UnuseOwner once to stop syncing.
-   * expect(shardTransport).toEqual({
+   * assertEqual(shardTransport, {
    *   type: "WebSocket",
    *   url: `wss://relay.example.com?ownerId=${shardOwner.id}`,
    * });
@@ -748,7 +764,12 @@ export interface EvoluErrorDep {
    * ### Example
    *
    * ```ts
-   * import { createStore, Millis, type EvoluError } from "@evolu/common";
+   * import {
+   *   assertEqual,
+   *   createStore,
+   *   Millis,
+   *   type EvoluError,
+   * } from "@evolu/common";
    * import type { EvoluErrorDep } from "@evolu/common/local-first";
    *
    * // Stand-in for run.deps.evoluError from createEvoluDeps.
@@ -763,6 +784,7 @@ export interface EvoluErrorDep {
    *   const error = deps.evoluError.get();
    *   if (!error) return;
    *
+   *   // oxlint-disable-next-line typescript/switch-exhaustiveness-check -- The default intentionally handles every other EvoluError.
    *   switch (error.type) {
    *     case "TimestampDriftError":
    *       // Show guidance specific to the detected error.
@@ -781,7 +803,8 @@ export interface EvoluErrorDep {
    *   next: Millis.orThrow(360000),
    *   now: Millis.orThrow(0),
    * });
-   * expect(displayedMessage).toBe(
+   * assertEqual(
+   *   displayedMessage,
    *   "Your system clock appears incorrect. Please fix it.",
    * );
    * ```
@@ -1248,6 +1271,7 @@ export const createEvolu =
       console.info("disposeEvolu");
     });
 
+    // oxlint-disable-next-line react/rules-of-hooks -- useOwner manages sync ownership and is not a React Hook.
     if (isNonEmptyArray(transports)) useOwner(appOwner);
 
     run.signal.throwIfAborted();