@evolu/common 7.4.1 → 8.0.0-next.0

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

@@ -1 +1 @@
-{"version":3,"file":"Console.d.ts","sourceRoot":"","sources":["../../src/Console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,OAAO;IACtB,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,uCAAuC;IACvC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAEnC,2DAA2D;IAC3D,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAEpC,gCAAgC;IAChC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAEpC,+BAA+B;IAC/B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAErC,8BAA8B;IAC9B,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAErC,4CAA4C;IAC5C,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/B,0DAA0D;IAC1D,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAEvD,6CAA6C;IAC7C,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC,2DAA2D;IAC3D,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAE1C,uCAAuC;IACvC,KAAK,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAE9D,yEAAyE;IACzE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,6CAA6C;IAC7C,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC,qEAAqE;IACrE,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IAE9E,oDAAoD;IACpD,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;CAC/D;AAED,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,sEAAsE;AACtE,eAAO,MAAM,aAAa,GAAI,SAAQ,aAAkB,KAAG,OAgE1D,CAAC;AAEF,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,UAAU,GAAG,UAAU,CAAC;CACjD;AAED,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,GAChC,SAAQ,qBAAqD,KAC5D,OAmDF,CAAC"}
+{"version":3,"file":"Console.d.ts","sourceRoot":"","sources":["../../src/Console.ts"],"names":[],"mappings":"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"}

package/dist/src/Console.js

@@ -1,126 +1,226 @@
-/** Creates a {@link Console} for logging with configurable output. */
-export const createConsole = (config = {}) => {
-    const instance = {
-        enabled: config.enableLogging ?? false,
-        log: (...args) => {
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            if (instance.enabled)
-                console.log(...args);
-        },
-        info: (...args) => {
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            if (instance.enabled)
-                console.info(...args);
-        },
-        warn: (...args) => {
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            if (instance.enabled)
-                console.warn(...args);
-        },
-        error: (...args) => {
-            // Always log errors, even if disabled
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            console.error(...args);
-        },
-        debug: (...args) => {
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            if (instance.enabled)
-                console.debug(...args);
-        },
-        time: (label) => {
-            // eslint-disable-next-line no-console
-            if (instance.enabled)
-                console.time(label);
-        },
-        timeLog: (label, ...data) => {
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            if (instance.enabled)
-                console.timeLog(label, ...data);
-        },
-        timeEnd: (label) => {
-            // eslint-disable-next-line no-console
-            if (instance.enabled)
-                console.timeEnd(label);
-        },
-        dir: (object, options) => {
-            // eslint-disable-next-line no-console
-            if (instance.enabled)
-                console.dir(object, options);
-        },
-        table: (tabularData, properties) => {
-            // eslint-disable-next-line no-console
-            if (instance.enabled)
-                console.table(tabularData, properties);
-        },
-        count: (label) => {
-            // eslint-disable-next-line no-console
-            if (instance.enabled)
-                console.count(label);
-        },
-        countReset: (label) => {
-            // eslint-disable-next-line no-console
-            if (instance.enabled)
-                console.countReset(label);
+/**
+ * Platform-agnostic console with structured logging.
+ *
+ * @module
+ */
+import { objectFrom } from "./Object.js";
+import { createStore } from "./Store.js";
+import { createTime, formatMillisAsClockTime, formatMillisAsDuration, } from "./Time.js";
+const levelOrder = {
+    trace: 0,
+    debug: 1,
+    log: 2,
+    info: 3,
+    warn: 4,
+    error: 5,
+    silent: 6,
+};
+/** Creates a {@link Console}. */
+export const createConsole = ({ name = "", level = "log", output = createNativeConsoleOutput(), path = [], formatter, } = {}) => {
+    const childrenSet = new Set();
+    let ownLevel = null;
+    const getLevel = () => ownLevel ?? level;
+    const createMethod = (method, methodLevel, formatter) => (...args) => {
+        if (levelOrder[methodLevel] >= levelOrder[getLevel()])
+            output.write({ method, path, args }, formatter);
+    };
+    const levelMethod = (method) => createMethod(method, method, formatter);
+    const debugMethod = (method) => createMethod(method, "debug");
+    return {
+        name,
+        children: childrenSet,
+        getLevel,
+        setLevel: (level) => {
+            ownLevel = level;
         },
-        assert: (value, message, ...optionalParams) => {
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            if (instance.enabled)
-                console.assert(value, message, ...optionalParams);
+        hasOwnLevel: () => ownLevel !== null,
+        child: (name) => {
+            const childConsole = createConsole({
+                name,
+                level,
+                output,
+                path: [...path, name],
+                ...(formatter && { formatter }),
+            });
+            childrenSet.add(childConsole);
+            return childConsole;
         },
-        trace: (message, ...optionalParams) => {
-            // eslint-disable-next-line no-console, @typescript-eslint/no-unsafe-argument
-            if (instance.enabled)
-                console.trace(message, ...optionalParams);
+        ...objectFrom(["trace", "debug", "log", "info", "warn", "error"], levelMethod),
+        ...objectFrom(["dir", "table", "time", "timeLog", "timeEnd", "count", "countReset"], debugMethod),
+        write: (entry) => {
+            output.write(entry, formatter);
         },
     };
-    return instance;
 };
-/** Creates a console instance with timestamp prefixes. */
-export const createConsoleWithTime = (config = { timestampType: "relative" }) => {
-    const console = createConsole(config);
-    const startTime = performance.now();
-    const getTimestamp = () => {
-        if (config.timestampType === "relative") {
-            const elapsed = (performance.now() - startTime) / 1000;
-            // Format for better readability at different time scales
-            if (elapsed < 60) {
-                // Under 1 minute: show seconds with millisecond precision
-                return `+${elapsed.toFixed(3)}s`;
-            }
-            else if (elapsed < 3600) {
-                // 1 minute to 1 hour: show minutes and seconds with millisecond precision
-                const minutes = Math.floor(elapsed / 60);
-                const seconds = (elapsed % 60).toFixed(3);
-                return `+${minutes}m${seconds}s`;
-            }
-            else {
-                // Over 1 hour: show hours, minutes, and seconds with millisecond precision
-                const hours = Math.floor(elapsed / 3600);
-                const minutes = Math.floor((elapsed % 3600) / 60);
-                const seconds = ((elapsed % 3600) % 60).toFixed(3);
-                return `+${hours}h${minutes}m${seconds}s`;
-            }
-        }
-        else {
-            // Absolute time - format as HH:MM:SS.mmm
-            const now = new Date();
-            const hours = now.getHours().toString().padStart(2, "0");
-            const minutes = now.getMinutes().toString().padStart(2, "0");
-            const seconds = now.getSeconds().toString().padStart(2, "0");
-            const milliseconds = now.getMilliseconds().toString().padStart(3, "0");
-            return `${hours}:${minutes}:${seconds}.${milliseconds}`;
+/**
+ * Creates a {@link ConsoleOutput} that writes to `globalThis.console`.
+ *
+ * Pure transport - just calls the native console method with the entry args.
+ * Use {@link createConsoleFormatter} with {@link ConsoleConfig.formatter} for
+ * timestamps and path prefixes.
+ *
+ * ### Example
+ *
+ * ```ts
+ * const output = createNativeConsoleOutput();
+ * ```
+ */
+export const createNativeConsoleOutput = () => ({
+    write: (entry, formatter) => {
+        const args = formatter ? formatter(entry) : entry.args;
+        const fn = globalThis.console[entry.method];
+        fn(...args);
+    },
+});
+/**
+ * Creates a {@link ConsoleFormatter} for {@link ConsoleConfig.formatter}.
+ *
+ * Prepends timestamps and path prefixes to entry args.
+ *
+ * ### Example
+ *
+ * ```ts
+ * const root = createConsole({
+ *   formatter: createConsoleFormatter()({
+ *     timestampFormat: "relative",
+ *   }),
+ * });
+ *
+ * // Relative — elapsed since start
+ * const relay = root.child("relay");
+ * relay.log("connected"); // +0.000s [relay] connected
+ * relay.log("synced"); // +1.500s [relay] synced
+ *
+ * // Nested children
+ * const db = relay.child("db");
+ * db.log("opened"); // +1.500s [relay] [db] opened
+ *
+ * // Absolute — local clock time (HH:MM:SS.mmm)
+ * // relay.log("connected"); // 15:30:15.123 [relay] connected
+ * ```
+ */
+export const createConsoleFormatter = ({ time = createTime() } = {}) => (config = {}) => {
+    const format = config.timestampFormat ?? "none";
+    let startTime = config.startTime;
+    return (entry) => {
+        const now = time.now();
+        startTime ??= now;
+        let timestamp;
+        switch (format) {
+            case "none":
+                timestamp = "";
+                break;
+            case "relative":
+                timestamp = `+${formatMillisAsDuration((now - startTime))}`;
+                break;
+            case "absolute":
+                timestamp = formatMillisAsClockTime(now);
+                break;
+            case "iso":
+                timestamp = new globalThis.Date(now).toISOString();
+                break;
         }
+        const path = entry.path.length > 0 ? entry.path.map((p) => `[${p}]`).join(" ") : "";
+        const prefix = timestamp && path ? `${timestamp} ${path}` : timestamp || path;
+        return prefix ? [prefix, ...entry.args] : entry.args;
     };
-    const withTimestamp = (fn) => (...args) => {
-        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
-        fn(`[${getTimestamp()}]`, ...args);
+};
+/** Creates a {@link ConsoleStoreOutput}. */
+export const createConsoleStoreOutput = () => {
+    const entry = createStore(null);
+    return {
+        write: entry.set,
+        entry,
+    };
+};
+/**
+ * Creates a {@link ConsoleOutput} that captures entries to an array.
+ *
+ * Useful for testing. Pass your own array to inspect captured entries.
+ *
+ * ### Example
+ *
+ * ```ts
+ * const entries: Array<ConsoleEntry> = [];
+ * const output = createConsoleArrayOutput(entries);
+ *
+ * // After logging...
+ * expect(entries).toMatchInlineSnapshot();
+ * ```
+ */
+export const createConsoleArrayOutput = (entries) => ({
+    write: (entry) => {
+        entries.push(entry);
+    },
+});
+/**
+ * Creates a {@link ConsoleOutput} that fans out to multiple outputs.
+ *
+ * Each entry is written to all outputs in order. Useful for combining a native
+ * console output with a store output for forwarding.
+ *
+ * ### Example
+ *
+ * ```ts
+ * const storeOutput = createConsoleStoreOutput();
+ * const console = createConsole({
+ *   output: createMultiOutput([createNativeConsoleOutput(), storeOutput]),
+ * });
+ * ```
+ */
+export const createMultiOutput = (outputs) => ({
+    write: (entry, formatter) => {
+        for (const output of outputs)
+            output.write(entry, formatter);
+    },
+});
+/**
+ * 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).
+ *
+ * ### Example
+ *
+ * ```ts
+ * test("logging", () => {
+ *   const console = testCreateConsole();
+ *   console.info("Hello");
+ *
+ *   expect(console.getEntriesSnapshot()).toMatchInlineSnapshot(`
+ *     [
+ *       {
+ *         "method": "info",
+ *         "path": [],
+ *         "args": ["Hello"]
+ *       }
+ *     ]
+ *   `);
+ * });
+ *
+ * test("level filtering", () => {
+ *   const console = testCreateConsole({ level: "warn" });
+ *   console.debug("ignored");
+ *   console.warn("logged");
+ *   expect(console.getEntriesSnapshot()).toHaveLength(1);
+ * });
+ * ```
+ */
+export const testCreateConsole = ({ level = "trace", } = {}) => {
+    const entries = [];
+    const console = createConsole({
+        level,
+        output: createConsoleArrayOutput(entries),
+    });
+    return {
+        ...console,
+        getEntriesSnapshot: () => {
+            const snapshot = [...entries];
+            entries.length = 0;
+            return snapshot;
+        },
+        clearEntries: () => {
+            entries.length = 0;
+        },
     };
-    // Override methods that should have timestamps
-    console.log = withTimestamp(console.log);
-    console.info = withTimestamp(console.info);
-    console.warn = withTimestamp(console.warn);
-    console.error = withTimestamp(console.error);
-    console.debug = withTimestamp(console.debug);
-    console.trace = withTimestamp(console.trace);
-    return console;
 };

package/dist/src/Crypto.d.ts

@@ -1,5 +1,15 @@
-import { Result } from "./Result.js";
-import { NonNegativeInt } from "./Type.js";
+/**
+ * Cryptographic utilities.
+ *
+ * Type-safe cryptographic operations including random bytes generation, SLIP21
+ * key derivation, XChaCha20-Poly1305 symmetric encryption, PADMÉ padding, and
+ * timing-safe comparisons.
+ *
+ * @module
+ */
+import type { RandomLibDep } from "./Random.js";
+import type { Result } from "./Result.js";
+import { NonNegativeInt, type Typed } from "./Type.js";
 export interface RandomBytes {
     /**
      * Creates cryptographically secure random bytes with type-safe length
@@ -9,11 +19,12 @@ export interface RandomBytes {
      * generator (crypto.getRandomValues) to generate high-quality entropy
      * suitable for cryptographic operations.
      *
-     * ### Type Safety
+     * ## Type Safety
      *
      * 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
@@ -22,12 +33,14 @@ export interface RandomBytes {
      *
      * ```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
      * ```
      */
     create(bytesLength: 16): Entropy16;
+    create(bytesLength: 24): Entropy24;
     create(bytesLength: 32): Entropy32;
     create(bytesLength: 64): Entropy64;
     create(bytesLength: number): Entropy;
@@ -39,11 +52,15 @@ declare const Entropy: import("./Type.js").BrandType<import("./Type.js").Type<"U
 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;
 export declare const createRandomBytes: () => RandomBytes;
+/** Creates seeded random bytes for deterministic tests. */
+export declare const testCreateRandomBytes: (deps: RandomLibDep) => RandomBytes;
 /**
  * SLIP21.
  *
@@ -56,31 +73,63 @@ export declare const createSlip21: (seed: Entropy16 | Entropy32 | Entropy64, pat
  * @see {@link createSlip21}
  */
 export declare const deriveSlip21Node: (label: string, parentNode: Entropy64) => Entropy64;
-/** The encryption key for {@link SymmetricCrypto}. */
+/** 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;
-/** Symmetric cryptography. */
-export interface SymmetricCrypto {
-    readonly nonceLength: NonNegativeInt;
-    readonly encrypt: (plaintext: Uint8Array, encryptionKey: EncryptionKey) => {
-        readonly nonce: Uint8Array;
-        readonly ciphertext: Uint8Array;
-    };
-    readonly decrypt: (ciphertext: Uint8Array, encryptionKey: EncryptionKey, nonce: Uint8Array) => Result<Uint8Array, SymmetricCryptoDecryptError>;
-}
-export interface SymmetricCryptoDep {
-    readonly symmetricCrypto: SymmetricCrypto;
-}
-export interface SymmetricCryptoDecryptError {
-    readonly type: "SymmetricCryptoDecryptError";
+/** The nonce length for XChaCha20-Poly1305 encryption. */
+export declare const xChaCha20Poly1305NonceLength = 24;
+/**
+ * Branded Uint8Array for XChaCha20-Poly1305 encryption.
+ *
+ * @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;
+/**
+ * Encrypts plaintext with XChaCha20-Poly1305.
+ *
+ * Generates a random nonce internally and returns both the ciphertext and
+ * nonce. The nonce must be stored alongside the ciphertext for decryption.
+ *
+ * ### Example
+ *
+ * ```ts
+ * const deps = { randomBytes: createRandomBytes() };
+ * const [ciphertext, nonce] = encryptWithXChaCha20Poly1305(deps)(
+ *   utf8ToBytes("secret message"),
+ *   encryptionKey,
+ * );
+ * ```
+ *
+ * @see https://github.com/paulmillr/noble-ciphers
+ */
+export declare const encryptWithXChaCha20Poly1305: (deps: RandomBytesDep) => (plaintext: Uint8Array, encryptionKey: EncryptionKey) => [XChaCha20Poly1305Ciphertext, Entropy24];
+export interface DecryptWithXChaCha20Poly1305Error extends Typed<"DecryptWithXChaCha20Poly1305Error"> {
     readonly error: unknown;
 }
 /**
- * XChaCha20-Poly1305 encryption
+ * Decrypts ciphertext with XChaCha20-Poly1305.
+ *
+ * Requires the same nonce that was used during encryption. Returns a
+ * {@link Result} that may contain a decryption error if the ciphertext was
+ * tampered with or the wrong key/nonce was used.
+ *
+ * ### Example
  *
- * https://github.com/paulmillr/noble-ciphers?tab=readme-ov-file#which-cipher-should-i-pick
+ * ```ts
+ * const result = decryptWithXChaCha20Poly1305(
+ *   ciphertext,
+ *   nonce,
+ *   encryptionKey,
+ * );
+ * if (!result.ok) {
+ *   // Handle decryption error
+ *   return result;
+ * }
+ * const plaintext = result.value;
+ * ```
  */
-export declare const createSymmetricCrypto: (deps: RandomBytesDep) => SymmetricCrypto;
+export declare const decryptWithXChaCha20Poly1305: (ciphertext: XChaCha20Poly1305Ciphertext, nonce: Entropy24, encryptionKey: EncryptionKey) => Result<Uint8Array, DecryptWithXChaCha20Poly1305Error>;
 /**
  * Returns the PADMÉ padded length for a given input length.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"Crypto.d.ts","sourceRoot":"","sources":["../../src/Crypto.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAW,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAiB,cAAc,EAAc,MAAM,WAAW,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;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,MAAM,GAAG,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,QAAA,MAAM,OAAO,uVAA+B,CAAC;AAC7C,KAAK,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAEnC,eAAO,MAAM,SAAS,mbAAsB,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,eAAO,MAAM,SAAS,mbAAsB,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,eAAO,MAAM,SAAS,mbAAsB,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,eAAO,MAAM,iBAAiB,QAAO,WAEnC,CAAC;AAEH;;;;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,sDAAsD;AACtD,eAAO,MAAM,aAAa,2qBAAoC,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;AAEtD,8BAA8B;AAC9B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IAErC,QAAQ,CAAC,OAAO,EAAE,CAChB,SAAS,EAAE,UAAU,EACrB,aAAa,EAAE,aAAa,KACzB;QACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;KACjC,CAAC;IAEF,QAAQ,CAAC,OAAO,EAAE,CAChB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,UAAU,KACd,MAAM,CAAC,UAAU,EAAE,2BAA2B,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,cAAc,KACnB,eAyBF,CAAC;AAEF;;;;;;;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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"}