@evolu/common 8.5.0 → 8.6.0

package/dist/src/Lookup.js

@@ -126,6 +126,8 @@ export const createLookupSet = ({ lookup, values, }) => {
  *
  * ```ts
  * import {
+ *   assertEqual,
+ *   assertSame,
  *   createLookupMap,
  *   structuralLookup,
  *   type StructuralLookupKey,
@@ -150,8 +152,8 @@ export const createLookupSet = ({ lookup, values, }) => {
  * };
  * byFilter.set(cachedFilter, "cached");
  *
- * expect(byFilter.get(equivalentFilter)).toBe("cached");
- * expect(byFilter.getKey(equivalentFilter)).toBe(cachedFilter);
+ * assertEqual(byFilter.get(equivalentFilter), "cached");
+ * assertSame(byFilter.getKey(equivalentFilter), cachedFilter);
  * ```
  *
  * @see {@link StructuralKey}

package/dist/src/Number.d.ts

@@ -22,6 +22,7 @@ export type Int1To100 = Int1To99 | 100;
  *
  * ```ts
  * import {
+ *   assertEqual,
  *   NonNegativeInt,
  *   type Int0To100OrNonNegativeInt,
  * } from "@evolu/common";
@@ -29,8 +30,8 @@ export type Int1To100 = Int1To99 | 100;
  * const literal: Int0To100OrNonNegativeInt = 10;
  * const validated: Int0To100OrNonNegativeInt = NonNegativeInt.orThrow(101);
  *
- * assert(literal === 10);
- * assert(validated === 101);
+ * assertEqual(literal, 10);
+ * assertEqual(validated, 101);
  * ```
  */
 export type Int0To100OrNonNegativeInt = 0 | Int1To100 | NonNegativeInt;
@@ -43,13 +44,17 @@ export type Int0To100OrNonNegativeInt = 0 | Int1To100 | NonNegativeInt;
  * ### Example
  *
  * ```ts
- * import { PositiveInt, type Int1To100OrPositiveInt } from "@evolu/common";
+ * import {
+ *   assertEqual,
+ *   PositiveInt,
+ *   type Int1To100OrPositiveInt,
+ * } from "@evolu/common";
  *
  * const literal: Int1To100OrPositiveInt = 10;
  * const validated: Int1To100OrPositiveInt = PositiveInt.orThrow(101);
  *
- * assert(literal === 10);
- * assert(validated === 101);
+ * assertEqual(literal, 10);
+ * assertEqual(validated, 101);
  * ```
  */
 export type Int1To100OrPositiveInt = Int1To100 | PositiveInt;
@@ -62,12 +67,12 @@ export type Int1To100OrPositiveInt = Int1To100 | PositiveInt;
  * ### Example
  *
  * ```ts
- * import { Ratio, jitter } from "@evolu/common";
+ * import { Ratio, assertType, jitter } from "@evolu/common";
  *
  * const readableJitter = jitter("50%");
  * const computedJitter = jitter(Ratio.orThrow(0.5));
  *
- * expectTypeOf(readableJitter).toEqualTypeOf(computedJitter);
+ * assertType<typeof computedJitter, typeof readableJitter>();
  * ```
  */
 export type Percentage = PercentageLiteral | Ratio;
@@ -91,12 +96,12 @@ export declare const clamp: (min: number, max: number) => (n: number) => number;
  * ### Example
  *
  * ```ts
- * import { isBetween } from "@evolu/common";
+ * import { assertFalse, assertTrue, isBetween } from "@evolu/common";
  *
  * const isBetween10And20 = isBetween(10, 20);
  *
- * expect(isBetween10And20(20)).toBe(true);
- * expect(isBetween10And20(25)).toBe(false);
+ * assertTrue(isBetween10And20(20));
+ * assertFalse(isBetween10And20(25));
  * ```
  */
 export declare const isBetween: (min: number, max: number) => Predicate<number>;
@@ -113,27 +118,26 @@ export declare const max: <T extends number>(...values: [T, ...ReadonlyArray<T>]
  *
  * ```ts
  * import {
+ *   assertErr,
+ *   assertOk,
  *   computeBalancedBuckets,
  *   NonNegativeInt,
  *   PositiveInt,
  * } from "@evolu/common";
  *
- * expectOk(
- *   computeBalancedBuckets(
- *     NonNegativeInt.orThrow(10),
- *     PositiveInt.orThrow(3),
- *     PositiveInt.orThrow(2),
- *   ),
- *   [4, 7, 10],
+ * const balanced = computeBalancedBuckets(
+ *   NonNegativeInt.orThrow(10),
+ *   PositiveInt.orThrow(3),
+ *   PositiveInt.orThrow(2),
  * );
- * expectErr(
- *   computeBalancedBuckets(
- *     NonNegativeInt.orThrow(5),
- *     PositiveInt.orThrow(3),
- *     PositiveInt.orThrow(2),
- *   ),
- *   6,
+ * assertOk(balanced, [4, 7, 10]);
+ *
+ * const insufficient = computeBalancedBuckets(
+ *   NonNegativeInt.orThrow(5),
+ *   PositiveInt.orThrow(3),
+ *   PositiveInt.orThrow(2),
  * );
+ * assertErr(insufficient, 6);
  * ```
  */
 export declare const computeBalancedBuckets: (numberOfItems: NonNegativeInt, 

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

@@ -1 +1 @@
-{"version":3,"file":"Number.d.ts","sourceRoot":"","sources":["../../src/Number.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAGL,UAAU,EAGV,cAAc,EACd,WAAW,EACX,KAAK,EAGN,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,wCAAwC;AACxC,MAAM,MAAM,QAAQ,GAAG,UAAU,SAAS,GAAG,MAAM,KAAK,SAAS,MAAM,EAAE,GACrE,KAAK,GACL,KAAK,CAAC;AAEV,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,GAAG,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,GAAG,SAAS,GAAG,cAAc,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,KAAK,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,ysGAU7B,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC;AAEhE,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,eAAgB,UAAU,KAAG,KAGQ,CAAC;AAEpE,eAAO,MAAM,SAAS,MAAO,MAAM,KAAG,MAAe,CAAC;AAEtD,eAAO,MAAM,SAAS,MAAO,MAAM,KAAG,MAAe,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,KAAK,QACV,MAAM,OAAO,MAAM,SACrB,MAAM,KAAG,MACoB,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,QACd,MAAM,OAAO,MAAM,KAAG,SAAS,CAAC,MAAM,CAEd,CAAC;AAEjC,wEAAwE;AACxE,eAAO,MAAM,GAAG,GAAI,CAAC,SAAS,MAAM,aACvB,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,KAClC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CACE,CAAC;AAEpD,wEAAwE;AACxE,eAAO,MAAM,GAAG,GAAI,CAAC,SAAS,MAAM,aACvB,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,KAClC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CACE,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,sBAAsB,kBAClB,cAAc;AAE7B,kBAAkB;;AAGlB,iBAAiB;8OAEhB,MAAM,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,WAAW,CAoBxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,6rBAG1B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC;AAE1D,oFAAoF;AACpF,eAAO,MAAM,WAAW,UAAW,cAAc,KAAG,WAMnD,CAAC"}
+{"version":3,"file":"Number.d.ts","sourceRoot":"","sources":["../../src/Number.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAGL,UAAU,EAGV,cAAc,EACd,WAAW,EACX,KAAK,EAGN,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,wCAAwC;AACxC,MAAM,MAAM,QAAQ,GAAG,UAAU,SAAS,GAAG,MAAM,KAAK,SAAS,MAAM,EAAE,GACrE,KAAK,GACL,KAAK,CAAC;AAEV,yCAAyC;AACzC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,GAAG,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,GAAG,SAAS,GAAG,cAAc,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,KAAK,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,ysGAU7B,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC;AAEhE,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,eAAgB,UAAU,KAAG,KAGQ,CAAC;AAEpE,eAAO,MAAM,SAAS,MAAO,MAAM,KAAG,MAAe,CAAC;AAEtD,eAAO,MAAM,SAAS,MAAO,MAAM,KAAG,MAAe,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,KAAK,QACV,MAAM,OAAO,MAAM,SACrB,MAAM,KAAG,MACoB,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,QACd,MAAM,OAAO,MAAM,KAAG,SAAS,CAAC,MAAM,CAEd,CAAC;AAEjC,wEAAwE;AACxE,eAAO,MAAM,GAAG,GAAI,CAAC,SAAS,MAAM,aACvB,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,KAClC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CACE,CAAC;AAEpD,wEAAwE;AACxE,eAAO,MAAM,GAAG,GAAI,CAAC,SAAS,MAAM,aACvB,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,KAClC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,CACE,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,sBAAsB,kBAClB,cAAc;AAE7B,kBAAkB;;AAGlB,iBAAiB;8OAEhB,MAAM,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,WAAW,CAoBxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,6rBAG1B,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC;AAE1D,oFAAoF;AACpF,eAAO,MAAM,WAAW,UAAW,cAAc,KAAG,WAMnD,CAAC"}

package/dist/src/Number.js

@@ -30,12 +30,12 @@ export const clamp = (min, max) => (n) => Math.min(Math.max(n, min), max);
  * ### Example
  *
  * ```ts
- * import { isBetween } from "@evolu/common";
+ * import { assertFalse, assertTrue, isBetween } from "@evolu/common";
  *
  * const isBetween10And20 = isBetween(10, 20);
  *
- * expect(isBetween10And20(20)).toBe(true);
- * expect(isBetween10And20(25)).toBe(false);
+ * assertTrue(isBetween10And20(20));
+ * assertFalse(isBetween10And20(25));
  * ```
  */
 export const isBetween = (min, max) => (value) => value >= min && value <= max;
@@ -52,27 +52,26 @@ export const max = (...values) => values.reduce((a, b) => (a > b ? a : b));
  *
  * ```ts
  * import {
+ *   assertErr,
+ *   assertOk,
  *   computeBalancedBuckets,
  *   NonNegativeInt,
  *   PositiveInt,
  * } from "@evolu/common";
  *
- * expectOk(
- *   computeBalancedBuckets(
- *     NonNegativeInt.orThrow(10),
- *     PositiveInt.orThrow(3),
- *     PositiveInt.orThrow(2),
- *   ),
- *   [4, 7, 10],
+ * const balanced = computeBalancedBuckets(
+ *   NonNegativeInt.orThrow(10),
+ *   PositiveInt.orThrow(3),
+ *   PositiveInt.orThrow(2),
  * );
- * expectErr(
- *   computeBalancedBuckets(
- *     NonNegativeInt.orThrow(5),
- *     PositiveInt.orThrow(3),
- *     PositiveInt.orThrow(2),
- *   ),
- *   6,
+ * assertOk(balanced, [4, 7, 10]);
+ *
+ * const insufficient = computeBalancedBuckets(
+ *   NonNegativeInt.orThrow(5),
+ *   PositiveInt.orThrow(3),
+ *   PositiveInt.orThrow(2),
  * );
+ * assertErr(insufficient, 6);
  * ```
  */
 export const computeBalancedBuckets = (numberOfItems, 

package/dist/src/Object.d.ts

@@ -8,32 +8,53 @@
  * types (e.g., in {@link mapObject}).
  */
 export type ReadonlyRecord<K extends keyof any, V> = Readonly<Record<K, V>>;
+/** An Object representation recognized by {@link getObjectKind}. */
+export type ObjectKind = "Array" | "Date" | "Map" | "Object" | "Set" | "Uint8Array" | "Unsupported";
 /**
- * Checks if a value is a plain object (e.g., created with `{}` or `Object`).
+ * Classifies Object representations supported by Evolu's structural data APIs.
+ *
+ * Plain Objects are classified from their prototype without reading their
+ * properties, including `Symbol.toStringTag`.
+ *
+ * ### Example
+ *
+ * ```ts
+ * import { assertEqual, getObjectKind } from "@evolu/common";
  *
- * Accepts objects with `Object.prototype` and objects with a `null` prototype
- * created via `Object.create(null)`. Rejects class instances and other built-in
- * objects because their prototype chain includes an application-specific or
- * built-in prototype before `Object.prototype`.
+ * assertEqual(getObjectKind({}), "Object");
+ * assertEqual(getObjectKind(new Map()), "Map");
+ * assertEqual(getObjectKind(/value/u), "Unsupported");
+ * ```
+ */
+export declare const getObjectKind: (value: object) => ObjectKind;
+/**
+ * Checks if a value is a plain object (e.g., created with `{}` or `Object`).
  *
- * The prototype-chain check uses structure instead of `prototype ===
- * Object.prototype` so it also works for plain objects coming from another
- * JavaScript realm.
+ * Accepts objects with a `null` prototype. Otherwise, it uses a realm-neutral
+ * structural heuristic: the immediate prototype must be a root object with own
+ * `hasOwnProperty` and `isPrototypeOf` properties. This recognizes ordinary
+ * Objects from another JavaScript realm without relying on prototype identity.
  *
- * TODO: deprecated Use `Object.is` from Type. Define a dedicated Type when
- * another object domain is required.
+ * A custom root prototype with the same shape can therefore be classified as
+ * plain. This function assumes trusted JavaScript and is not a prototype
+ * authentication or security boundary. Other custom prototypes, class
+ * instances, and built-in objects are rejected.
  *
  * ### Example
  *
  * ```ts
- * import { isPlainObject } from "@evolu/common";
- *
- * expect(isPlainObject({})).toBe(true);
- * expect(isPlainObject(Object.create(null))).toBe(true);
- * expect(isPlainObject(new Date())).toBe(false);
- * expect(isPlainObject(new (class Example {})())).toBe(false);
- * expect(isPlainObject([])).toBe(false);
- * expect(isPlainObject(null)).toBe(false);
+ * import { assertFalse, assertTrue, isPlainObject } from "@evolu/common";
+ *
+ * class Example {
+ *   readonly value = "example";
+ * }
+ *
+ * assertTrue(isPlainObject({}));
+ * assertTrue(isPlainObject(Object.create(null)));
+ * assertFalse(isPlainObject(new Date()));
+ * assertFalse(isPlainObject(new Example()));
+ * assertFalse(isPlainObject([]));
+ * assertFalse(isPlainObject(null));
  * ```
  */
 export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
@@ -43,11 +64,11 @@ export declare const isPlainObject: (value: unknown) => value is Record<string,
  * ### Example
  *
  * ```ts
- * import { isFunction } from "@evolu/common";
+ * import { assertFalse, assertTrue, isFunction } from "@evolu/common";
  *
- * expect(isFunction(() => {})).toBe(true);
- * expect(isFunction(function () {})).toBe(true);
- * expect(isFunction({})).toBe(false);
+ * assertTrue(isFunction(() => {}));
+ * assertTrue(isFunction(function () {}));
+ * assertFalse(isFunction({}));
  * ```
  */
 export declare const isFunction: (value: unknown) => value is globalThis.Function;
@@ -57,11 +78,11 @@ export declare const isFunction: (value: unknown) => value is globalThis.Functio
  * ### Example
  *
  * ```ts
- * import { isIterable } from "@evolu/common";
+ * import { assertFalse, assertTrue, isIterable } from "@evolu/common";
  *
- * expect(isIterable([1, 2, 3])).toBe(true);
- * expect(isIterable("abc")).toBe(true);
- * expect(isIterable({})).toBe(false);
+ * assertTrue(isIterable([1, 2, 3]));
+ * assertTrue(isIterable("abc"));
+ * assertFalse(isIterable({}));
  * ```
  */
 export declare const isIterable: (value: unknown) => value is Iterable<unknown>;
@@ -72,6 +93,8 @@ export declare const isIterable: (value: unknown) => value is Iterable<unknown>;
  *
  * ```ts
  * import {
+ *   assertEqual,
+ *   assertType,
  *   objectToEntries,
  *   type Brand,
  *   type ReadonlyRecord,
@@ -83,8 +106,8 @@ export declare const isIterable: (value: unknown) => value is Iterable<unknown>;
  * const users: ReadonlyRecord<UserId, string> = { [userId]: "Alice" };
  * const entries = objectToEntries(users);
  *
- * expectTypeOf(entries).toEqualTypeOf<ReadonlyArray<[UserId, string]>>();
- * expect(entries).toEqual([[userId, "Alice"]]);
+ * assertType<ReadonlyArray<[UserId, string]>, typeof entries>();
+ * assertEqual(entries, [[userId, "Alice"]]);
  * ```
  */
 export declare const objectToEntries: <T extends Record<string, any>>(record: T) => ReadonlyArray<[StringKeyOf<T>, T[StringKeyOf<T>]]>;
@@ -99,6 +122,8 @@ type StringKeyOf<T> = Extract<keyof T, string>;
  *
  * ```ts
  * import {
+ *   assertEqual,
+ *   assertType,
  *   objectFromEntries,
  *   type Brand,
  *   type ReadonlyRecord,
@@ -110,8 +135,8 @@ type StringKeyOf<T> = Extract<keyof T, string>;
  * ];
  * const users = objectFromEntries(entries);
  *
- * expectTypeOf(users).toEqualTypeOf<ReadonlyRecord<UserId, string>>();
- * expect(users).toEqual({ u1: "Alice" });
+ * assertType<ReadonlyRecord<UserId, string>, typeof users>();
+ * assertEqual(users, { u1: "Alice" });
  * ```
  */
 export declare const objectFromEntries: <K extends string, V>(entries: Iterable<readonly [K, V]>) => ReadonlyRecord<K, V>;
@@ -124,17 +149,20 @@ export declare const objectFromEntries: <K extends string, V>(entries: Iterable<
  * ### Example
  *
  * ```ts
- * import { objectFrom, type ReadonlyRecord } from "@evolu/common";
+ * import {
+ *   assertEqual,
+ *   assertType,
+ *   objectFrom,
+ *   type ReadonlyRecord,
+ * } from "@evolu/common";
  *
  * const translations = objectFrom(
  *   ["en", "fr"] as const,
  *   (locale): string => `Hello in ${locale}`,
  * );
  *
- * expectTypeOf(translations).toEqualTypeOf<
- *   ReadonlyRecord<"en" | "fr", string>
- * >();
- * expect(translations).toEqual({
+ * assertType<ReadonlyRecord<"en" | "fr", string>, typeof translations>();
+ * assertEqual(translations, {
  *   en: "Hello in en",
  *   fr: "Hello in fr",
  * });
@@ -174,7 +202,7 @@ export declare const excludeProp: <T extends object, K extends keyof T>(obj: T,
  * ### Example
  *
  * ```ts
- * import { createMutableRecord } from "@evolu/common";
+ * import { assertEqual, createMutableRecord } from "@evolu/common";
  *
  * const createValuesByKey = (
  *   entries: ReadonlyArray<readonly [string, number]>,
@@ -188,12 +216,13 @@ export declare const excludeProp: <T extends object, K extends keyof T>(obj: T,
  *   return valuesByKey;
  * };
  *
- * expect(
+ * assertEqual(
  *   createValuesByKey([
  *     ["a", 1],
  *     ["b", 2],
  *   ]),
- * ).toEqual({ a: 1, b: 2 });
+ *   { a: 1, b: 2 },
+ * );
  * ```
  *
  * Note that TypeScript does not model an object's runtime prototype. A plain
@@ -201,21 +230,34 @@ export declare const excludeProp: <T extends object, K extends keyof T>(obj: T,
  * object has a `null` prototype:
  *
  * ```ts
+ * import { assertErr, assertTrue, trySync } from "@evolu/common";
+ *
  * const values = Object.create(null) as Record<string, number>;
  *
  * // TypeScript accepts the call, but `toString` is undefined at runtime.
- * expect(() => values.toString()).toThrow(TypeError);
+ * // oxlint-disable-next-line typescript/no-base-to-string -- Intentionally calls a method missing from the null-prototype value.
+ * const result = trySync(() => values.toString());
+ * assertErr(result);
+ * assertTrue(result.error instanceof TypeError);
  * ```
  *
  * `createMutableRecord` uses the same TypeScript Record representation.
  *
  * ```ts
- * import { createMutableRecord } from "@evolu/common";
+ * import {
+ *   assertErr,
+ *   assertTrue,
+ *   createMutableRecord,
+ *   trySync,
+ * } from "@evolu/common";
  *
  * const values = createMutableRecord<string, number>();
  *
  * // TypeScript accepts the call, but `toString` is undefined at runtime.
- * expect(() => values.toString()).toThrow(TypeError);
+ * // oxlint-disable-next-line typescript/no-base-to-string -- Intentionally calls a method missing from the null-prototype value.
+ * const result = trySync(() => values.toString());
+ * assertErr(result);
+ * assertTrue(result.error instanceof TypeError);
  * ```
  *
  * In other words, treat the returned object as string-keyed data rather than
@@ -251,7 +293,7 @@ export declare const emptyRecord: Readonly<Record<string, never>>;
  * ### Example
  *
  * ```ts
- * import { getOwnProp } from "@evolu/common";
+ * import { assertEqual, assertType, getOwnProp } from "@evolu/common";
  *
  * interface User {
  *   readonly name: string;
@@ -262,9 +304,9 @@ export declare const emptyRecord: Readonly<Record<string, never>>;
  * };
  * const user = getOwnProp(users, "bob");
  *
- * expectTypeOf(user).toEqualTypeOf<User | undefined>();
- * expect(user).toBeUndefined();
- * expect(getOwnProp(users, "toString")).toBeUndefined();
+ * assertType<User | undefined, typeof user>();
+ * assertEqual(user, undefined);
+ * assertEqual(getOwnProp(users, "toString"), undefined);
  * ```
  */
 export declare const getOwnProp: <K extends string, V>(record: ReadonlyRecord<K, V>, key: NoInfer<K>) => V | undefined;
@@ -276,12 +318,12 @@ export declare const getOwnProp: <K extends string, V>(record: ReadonlyRecord<K,
  * ### Example
  *
  * ```ts
- * import { createObjectURL } from "@evolu/common";
+ * import { assertTrue, createObjectURL } from "@evolu/common";
  *
  * const blob = new Blob(["hello"], { type: "text/plain" });
  * using objectUrl = createObjectURL(blob);
  *
- * expect(objectUrl.url).toMatch(/^blob:/);
+ * assertTrue(objectUrl.url.startsWith("blob:"));
  * // URL.revokeObjectURL is automatically called when the scope ends.
  * ```
  *

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

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