@evolu/common 8.0.0-next.4 → 8.0.0

package/dist/src/Console.js

@@ -62,14 +62,21 @@ export const createConsole = ({ name = "", level = "log", output = createNativeC
  * ### Example
  *
  * ```ts
+ * import {
+ *   createNativeConsoleOutput,
+ *   type ConsoleOutput,
+ * } from "@evolu/common";
+ *
  * const output = createNativeConsoleOutput();
+ *
+ * expectTypeOf(output).toEqualTypeOf<ConsoleOutput>();
+ * expect(output.write).toBeTypeOf("function");
  * ```
  */
 export const createNativeConsoleOutput = () => ({
     write: (entry, formatter) => {
         const args = formatter ? formatter(entry) : entry.args;
-        const fn = globalThis.console[entry.method];
-        fn(...args);
+        globalThis.console[entry.method](...args);
     },
 });
 /**
@@ -80,23 +87,52 @@ export const createNativeConsoleOutput = () => ({
  * ### Example
  *
  * ```ts
- * const root = createConsole({
- *   formatter: createConsoleFormatter()({
- *     timestampFormat: "relative",
- *   }),
- * });
+ * import {
+ *   createConsoleFormatter,
+ *   Millis,
+ *   testCreateTime,
+ *   type ConsoleEntry,
+ * } from "@evolu/common";
  *
- * // Relative — elapsed since start
- * const relay = root.child("relay");
- * relay.log("connected"); // +0.000s [relay] connected
- * relay.log("synced"); // +1.500s [relay] synced
+ * const time = testCreateTime({ startAt: Millis.orThrow(0) });
+ * const formatRelative = createConsoleFormatter({ time })({
+ *   timestampFormat: "relative",
+ * });
+ * const connected: ConsoleEntry = {
+ *   method: "log",
+ *   path: ["relay"],
+ *   args: ["connected"],
+ * };
  *
- * // Nested children
- * const db = relay.child("db");
- * db.log("opened"); // +1.500s [relay] [db] opened
+ * expect(formatRelative(connected)).toEqual([
+ *   "+0.000s [relay]",
+ *   "connected",
+ * ]);
+ * time.advance("1.5s");
+ * expect(
+ *   formatRelative({
+ *     ...connected,
+ *     path: ["relay", "db"],
+ *     args: ["opened"],
+ *   }),
+ * ).toEqual(["+1.500s [relay] [db]", "opened"]);
  *
- * // Absolute — local clock time (HH:MM:SS.mmm)
- * // relay.log("connected"); // 15:30:15.123 [relay] connected
+ * const localTimestamp = new globalThis.Date(
+ *   2026,
+ *   0,
+ *   28,
+ *   14,
+ *   30,
+ *   15,
+ *   123,
+ * ).getTime();
+ * const formatAbsolute = createConsoleFormatter({
+ *   time: testCreateTime({ startAt: Millis.orThrow(localTimestamp) }),
+ * })({ timestampFormat: "absolute" });
+ * expect(formatAbsolute(connected)).toEqual([
+ *   "14:30:15.123 [relay]",
+ *   "connected",
+ * ]);
  * ```
  */
 export const createConsoleFormatter = ({ time = createTime() } = {}) => (config = {}) => {
@@ -141,11 +177,20 @@ export const createConsoleStoreOutput = () => {
  * ### Example
  *
  * ```ts
- * const entries: Array<ConsoleEntry> = [];
- * const output = createConsoleArrayOutput(entries);
+ * import {
+ *   createConsole,
+ *   createConsoleArrayOutput,
+ *   type ConsoleEntry,
+ * } from "@evolu/common";
  *
- * // After logging...
- * expect(entries).toMatchInlineSnapshot();
+ * const entries: Array<ConsoleEntry> = [];
+ * const console = createConsole({
+ *   output: createConsoleArrayOutput(entries),
+ * });
+ * console.info("connected");
+ * expect(entries).toEqual([
+ *   { method: "info", path: [], args: ["connected"] },
+ * ]);
  * ```
  */
 export const createConsoleArrayOutput = (entries) => ({
@@ -162,10 +207,25 @@ export const createConsoleArrayOutput = (entries) => ({
  * ### Example
  *
  * ```ts
+ * import {
+ *   createConsole,
+ *   createConsoleArrayOutput,
+ *   createConsoleStoreOutput,
+ *   createMultiOutput,
+ *   type ConsoleEntry,
+ * } from "@evolu/common";
+ *
+ * const entries: Array<ConsoleEntry> = [];
  * const storeOutput = createConsoleStoreOutput();
  * const console = createConsole({
- *   output: createMultiOutput([createNativeConsoleOutput(), storeOutput]),
+ *   output: createMultiOutput([
+ *     createConsoleArrayOutput(entries),
+ *     storeOutput,
+ *   ]),
  * });
+ * console.error("disconnected");
+ *
+ * expect(storeOutput.entry.get()).toEqual(entries[0]);
  * ```
  */
 export const createMultiOutput = (outputs) => ({
@@ -177,33 +237,21 @@ export const createMultiOutput = (outputs) => ({
 /**
  * Creates a {@link TestConsole} that captures all output for testing.
  *
- * Unlike {@link createConsole}, this doesn't require dependencies and uses a
- * simple incrementing counter for timestamps (starting at 0).
+ * Unlike {@link createConsole}, this doesn't require dependencies and captures
+ * entries in memory.
  *
  * ### Example
  *
  * ```ts
- * test("logging", () => {
- *   const console = testCreateConsole();
- *   console.info("Hello");
- *
- *   expect(console.getEntriesSnapshot()).toMatchInlineSnapshot(`
- *     [
- *       {
- *         "method": "info",
- *         "path": [],
- *         "args": ["Hello"]
- *       }
- *     ]
- *   `);
- * });
+ * import { testCreateConsole } from "@evolu/common";
  *
- * test("level filtering", () => {
- *   const console = testCreateConsole({ level: "warn" });
- *   console.debug("ignored");
- *   console.warn("logged");
- *   expect(console.getEntriesSnapshot()).toHaveLength(1);
- * });
+ * const console = testCreateConsole({ level: "info" });
+ * console.debug("ignored");
+ * console.child("relay").info("connected");
+ *
+ * expect(console.getEntriesSnapshot()).toEqual([
+ *   { method: "info", path: ["relay"], args: ["connected"] },
+ * ]);
  * ```
  */
 export const testCreateConsole = ({ level = "trace", } = {}) => {

package/dist/src/Crypto.d.ts

@@ -7,9 +7,9 @@
  *
  * @module
  */
-import type { RandomLibDep } from "./Random.js";
-import type { Result } from "./Result.js";
-import { NonNegativeInt, type Typed } from "./Type.js";
+import type { RandomLibDep } from "./Random.ts";
+import type { Result } from "./Result.ts";
+import { NonNegativeInt, type Typed } from "./Type.ts";
 export interface RandomBytes {
     /**
      * Creates cryptographically secure random bytes with type-safe length
@@ -23,20 +23,35 @@ export interface RandomBytes {
      *
      * Returns specific branded types for common sizes:
      *
-     * - `Random16` for 16-byte values (128 bits)
-     * - `Random24` for 24-byte values (192 bits)
-     * - `Random32` for 32-byte values (256 bits)
-     * - `Random64` for 64-byte values (512 bits)
-     * - `Random` for any other size
+     * - `Entropy16` for 16-byte values (128 bits)
+     * - `Entropy24` for 24-byte values (192 bits)
+     * - `Entropy32` for 32-byte values (256 bits)
+     * - `Entropy64` for 64-byte values (512 bits)
+     * - `Entropy` for any other size
      *
      * ### Example
      *
      * ```ts
-     * const nonce = randomBytes.create(16); // Type: Random16
-     * const nonce24 = randomBytes.create(24); // Type: Random24
-     * const key = randomBytes.create(32); // Type: Random32
-     * const seed = randomBytes.create(64); // Type: Random64
-     * const custom = randomBytes.create(48); // Type: Random
+     * import {
+     *   createRandomBytes,
+     *   type Entropy16,
+     *   type Entropy24,
+     *   type Entropy32,
+     *   type Entropy64,
+     * } from "@evolu/common";
+     *
+     * const randomBytes = createRandomBytes();
+     * const nonce16 = randomBytes.create(16);
+     * const nonce24 = randomBytes.create(24);
+     * const key = randomBytes.create(32);
+     * const seed = randomBytes.create(64);
+     * const custom = randomBytes.create(48);
+     *
+     * expectTypeOf(nonce16).toEqualTypeOf<Entropy16>();
+     * expectTypeOf(nonce24).toEqualTypeOf<Entropy24>();
+     * expectTypeOf(key).toEqualTypeOf<Entropy32>();
+     * expectTypeOf(seed).toEqualTypeOf<Entropy64>();
+     * expect(custom).toHaveLength(48);
      * ```
      */
     create(bytesLength: 16): Entropy16;
@@ -48,16 +63,16 @@ export interface RandomBytes {
 export interface RandomBytesDep {
     readonly randomBytes: RandomBytes;
 }
-declare const Entropy: import("./Type.js").BrandType<import("./Type.js").Type<"Uint8Array", Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>, import("./Type.js").Uint8ArrayError, Uint8Array<ArrayBufferLike>, import("./Type.js").Uint8ArrayError>, "Entropy", import("./Type.js").BrandWithoutRefineError<"Entropy", import("./Type.js").Uint8ArrayError>, never>;
-type Entropy = typeof Entropy.Type;
-export declare const Entropy16: 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>>;
-export type Entropy16 = typeof Entropy16.Type;
-export declare const Entropy24: 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>, "Length24", import("./Type.js").LengthError<24>, import("./Type.js").BrandWithoutRefineError<"Entropy", import("./Type.js").Uint8ArrayError>>;
-export type Entropy24 = typeof Entropy24.Type;
-export declare const Entropy32: 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>>;
-export type Entropy32 = typeof Entropy32.Type;
-export declare const Entropy64: 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>, "Length64", import("./Type.js").LengthError<64>, import("./Type.js").BrandWithoutRefineError<"Entropy", import("./Type.js").Uint8ArrayError>>;
-export type Entropy64 = typeof Entropy64.Type;
+declare const Entropy: 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>;
+type Entropy = typeof Entropy.Output;
+export declare const Entropy16: 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>>;
+export type Entropy16 = typeof Entropy16.Output;
+export declare const Entropy24: 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>, "Length24", import("./Type.ts").LengthError<24>>;
+export type Entropy24 = typeof Entropy24.Output;
+export declare const Entropy32: 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>>;
+export type Entropy32 = typeof Entropy32.Output;
+export declare const Entropy64: 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>, "Length64", import("./Type.ts").LengthError<64>>;
+export type Entropy64 = typeof Entropy64.Output;
 export declare const createRandomBytes: () => RandomBytes;
 /** Creates seeded random bytes for deterministic tests. */
 export declare const testCreateRandomBytes: (deps: RandomLibDep) => RandomBytes;
@@ -74,8 +89,8 @@ export declare const createSlip21: (seed: Entropy16 | Entropy32 | Entropy64, pat
  */
 export declare const deriveSlip21Node: (label: string, parentNode: Entropy64) => Entropy64;
 /** The encryption key for symmetric encryption. */
-export declare const EncryptionKey: 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>;
-export type EncryptionKey = typeof EncryptionKey.Type;
+export declare const EncryptionKey: 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>;
+export type EncryptionKey = typeof EncryptionKey.Output;
 /** The nonce length for XChaCha20-Poly1305 encryption. */
 export declare const xChaCha20Poly1305NonceLength = 24;
 /**
@@ -83,8 +98,8 @@ export declare const xChaCha20Poly1305NonceLength = 24;
  *
  * @see {@link encryptWithXChaCha20Poly1305}
  */
-export declare const XChaCha20Poly1305Ciphertext: import("./Type.js").BrandType<import("./Type.js").Type<"Uint8Array", Uint8Array<ArrayBufferLike>, Uint8Array<ArrayBufferLike>, import("./Type.js").Uint8ArrayError, Uint8Array<ArrayBufferLike>, import("./Type.js").Uint8ArrayError>, "XChaCha20Poly1305Ciphertext", import("./Type.js").BrandWithoutRefineError<"XChaCha20Poly1305Ciphertext", import("./Type.js").Uint8ArrayError>, never>;
-export type XChaCha20Poly1305Ciphertext = typeof XChaCha20Poly1305Ciphertext.Type;
+export declare const XChaCha20Poly1305Ciphertext: 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>, "XChaCha20Poly1305Ciphertext", never>;
+export type XChaCha20Poly1305Ciphertext = typeof XChaCha20Poly1305Ciphertext.Output;
 /**
  * Encrypts plaintext with XChaCha20-Poly1305.
  *
@@ -94,11 +109,22 @@ export type XChaCha20Poly1305Ciphertext = typeof XChaCha20Poly1305Ciphertext.Typ
  * ### Example
  *
  * ```ts
- * const deps = { randomBytes: createRandomBytes() };
- * const [ciphertext, nonce] = encryptWithXChaCha20Poly1305(deps)(
- *   utf8ToBytes("secret message"),
- *   encryptionKey,
- * );
+ * import {
+ *   createRandomBytes,
+ *   EncryptionKey,
+ *   encryptWithXChaCha20Poly1305,
+ *   type XChaCha20Poly1305Ciphertext,
+ *   utf8ToBytes,
+ * } from "@evolu/common";
+ *
+ * const plaintext = utf8ToBytes("secret message");
+ * const encryptionKey = EncryptionKey.orThrow(new Uint8Array(32).fill(7));
+ * const [ciphertext, nonce] = encryptWithXChaCha20Poly1305({
+ *   randomBytes: createRandomBytes(),
+ * })(plaintext, encryptionKey);
+ *
+ * expectTypeOf(ciphertext).toEqualTypeOf<XChaCha20Poly1305Ciphertext>();
+ * expect(nonce).toHaveLength(24);
  * ```
  *
  * @see https://github.com/paulmillr/noble-ciphers
@@ -117,16 +143,33 @@ export interface DecryptWithXChaCha20Poly1305Error extends Typed<"DecryptWithXCh
  * ### Example
  *
  * ```ts
- * const result = decryptWithXChaCha20Poly1305(
- *   ciphertext,
- *   nonce,
- *   encryptionKey,
- * );
- * if (!result.ok) {
- *   // Handle decryption error
- *   return result;
- * }
- * const plaintext = result.value;
+ * import {
+ *   bytesToUtf8,
+ *   createRandomBytes,
+ *   decryptWithXChaCha20Poly1305,
+ *   EncryptionKey,
+ *   encryptWithXChaCha20Poly1305,
+ *   ok,
+ *   utf8ToBytes,
+ * } from "@evolu/common";
+ *
+ * const plaintext = utf8ToBytes("secret message");
+ * const encryptionKey = EncryptionKey.orThrow(new Uint8Array(32).fill(7));
+ * const [ciphertext, nonce] = encryptWithXChaCha20Poly1305({
+ *   randomBytes: createRandomBytes(),
+ * })(plaintext, encryptionKey);
+ *
+ * const decryptMessage = () => {
+ *   const result = decryptWithXChaCha20Poly1305(
+ *     ciphertext,
+ *     nonce,
+ *     encryptionKey,
+ *   );
+ *   if (!result.ok) return result;
+ *   return ok(bytesToUtf8(result.value));
+ * };
+ *
+ * expectOk(decryptMessage(), "secret message");
  * ```
  */
 export declare const decryptWithXChaCha20Poly1305: (ciphertext: XChaCha20Poly1305Ciphertext, nonce: Entropy24, encryptionKey: EncryptionKey) => Result<Uint8Array, DecryptWithXChaCha20Poly1305Error>;

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

@@ -1 +1 @@
-{"version":3,"file":"Crypto.d.ts","sourceRoot":"","sources":["../../src/Crypto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAGL,cAAc,EAEd,KAAK,KAAK,EAEX,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,QAAA,MAAM,OAAO,uVAA6C,CAAC;AAC3D,KAAK,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAEnC,eAAO,MAAM,SAAS,mbAAoC,CAAC;AAC3D,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,eAAO,MAAM,SAAS,mbAAoC,CAAC;AAC3D,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,eAAO,MAAM,SAAS,mbAAoC,CAAC;AAC3D,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,eAAO,MAAM,SAAS,mbAAoC,CAAC;AAC3D,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,eAAO,MAAM,iBAAiB,QAAO,WAEnC,CAAC;AAEH,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,GAAI,MAAM,YAAY,KAAG,WAMxC,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,EACvC,MAAM,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,KACnC,SAaF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,OAAO,MAAM,EACb,YAAY,SAAS,KACpB,SAMF,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,aAAa,2qBAAkD,CAAC;AAC7E,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;AAEtD,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,+XAGvC,CAAC;AACF,MAAM,MAAM,2BAA2B,GACrC,OAAO,2BAA2B,CAAC,IAAI,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,4BAA4B,GACtC,MAAM,cAAc,MAEnB,WAAW,UAAU,EACrB,eAAe,aAAa,KAC3B,CAAC,2BAA2B,EAAE,SAAS,CAMzC,CAAC;AAEJ,MAAM,WAAW,iCAAkC,SAAQ,KAAK,CAAC,mCAAmC,CAAC;IACnG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,4BAA4B,GACvC,YAAY,2BAA2B,EACvC,OAAO,SAAS,EAChB,eAAe,aAAa,KAC3B,MAAM,CAAC,UAAU,EAAE,iCAAiC,CAOpD,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,cAAc,KACrB,cAOF,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,GAAI,QAAQ,cAAc,KAAG,UAI3D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C"}
+{"version":3,"file":"Crypto.d.ts","sourceRoot":"","sources":["../../src/Crypto.ts"],"names":[],"mappings":"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"}

package/dist/src/Crypto.js

@@ -11,7 +11,6 @@ import { xchacha20poly1305 } from "@noble/ciphers/chacha.js";
 import { hmac } from "@noble/hashes/hmac.js";
 import { sha512 } from "@noble/hashes/sha2.js";
 import { randomBytes, utf8ToBytes } from "@noble/hashes/utils.js";
-import { arrayFrom } from "./Array.js";
 import { trySync } from "./Result.js";
 import { brand, length, NonNegativeInt, Uint8Array, zeroNonNegativeInt, } from "./Type.js";
 const Entropy = /*#__PURE__*/ brand("Entropy", Uint8Array);
@@ -24,10 +23,7 @@ export const createRandomBytes = () => ({
 });
 /** Creates seeded random bytes for deterministic tests. */
 export const testCreateRandomBytes = (deps) => ({
-    create: (bytesLength) => {
-        const array = arrayFrom(bytesLength, () => deps.randomLib.int(0, 255));
-        return new globalThis.Uint8Array(array);
-    },
+    create: (bytesLength) => globalThis.Uint8Array.from({ length: bytesLength }, () => deps.randomLib.int(0, 255)),
 });
 /**
  * SLIP21.
@@ -73,11 +69,22 @@ export const XChaCha20Poly1305Ciphertext = /*#__PURE__*/ brand("XChaCha20Poly130
  * ### Example
  *
  * ```ts
- * const deps = { randomBytes: createRandomBytes() };
- * const [ciphertext, nonce] = encryptWithXChaCha20Poly1305(deps)(
- *   utf8ToBytes("secret message"),
- *   encryptionKey,
- * );
+ * import {
+ *   createRandomBytes,
+ *   EncryptionKey,
+ *   encryptWithXChaCha20Poly1305,
+ *   type XChaCha20Poly1305Ciphertext,
+ *   utf8ToBytes,
+ * } from "@evolu/common";
+ *
+ * const plaintext = utf8ToBytes("secret message");
+ * const encryptionKey = EncryptionKey.orThrow(new Uint8Array(32).fill(7));
+ * const [ciphertext, nonce] = encryptWithXChaCha20Poly1305({
+ *   randomBytes: createRandomBytes(),
+ * })(plaintext, encryptionKey);
+ *
+ * expectTypeOf(ciphertext).toEqualTypeOf<XChaCha20Poly1305Ciphertext>();
+ * expect(nonce).toHaveLength(24);
  * ```
  *
  * @see https://github.com/paulmillr/noble-ciphers
@@ -97,16 +104,33 @@ export const encryptWithXChaCha20Poly1305 = (deps) => (plaintext, encryptionKey)
  * ### Example
  *
  * ```ts
- * const result = decryptWithXChaCha20Poly1305(
- *   ciphertext,
- *   nonce,
- *   encryptionKey,
- * );
- * if (!result.ok) {
- *   // Handle decryption error
- *   return result;
- * }
- * const plaintext = result.value;
+ * import {
+ *   bytesToUtf8,
+ *   createRandomBytes,
+ *   decryptWithXChaCha20Poly1305,
+ *   EncryptionKey,
+ *   encryptWithXChaCha20Poly1305,
+ *   ok,
+ *   utf8ToBytes,
+ * } from "@evolu/common";
+ *
+ * const plaintext = utf8ToBytes("secret message");
+ * const encryptionKey = EncryptionKey.orThrow(new Uint8Array(32).fill(7));
+ * const [ciphertext, nonce] = encryptWithXChaCha20Poly1305({
+ *   randomBytes: createRandomBytes(),
+ * })(plaintext, encryptionKey);
+ *
+ * const decryptMessage = () => {
+ *   const result = decryptWithXChaCha20Poly1305(
+ *     ciphertext,
+ *     nonce,
+ *     encryptionKey,
+ *   );
+ *   if (!result.ok) return result;
+ *   return ok(bytesToUtf8(result.value));
+ * };
+ *
+ * expectOk(decryptMessage(), "secret message");
  * ```
  */
 export const decryptWithXChaCha20Poly1305 = (ciphertext, nonce, encryptionKey) => trySync(() => xchacha20poly1305(encryptionKey, nonce).decrypt(ciphertext), (error) => ({