@did-btcr2/common 2.2.2 → 3.0.0

package/dist/esm/utils/set.js

@@ -0,0 +1,23 @@
+/**
+ * Utility class for set operations.
+ * @name SetUtils
+ * @class SetUtils
+ */
+export class SetUtils {
+    /**
+     * Compute the set difference without mutating the inputs.
+     * @param {Set<T>} left - The left set.
+     * @param {Set<T>} right - The right set.
+     * @returns {Set<T>} A new set containing elements in `left` that are not in `right`.
+     */
+    static difference(left, right) {
+        const result = new Set();
+        for (const value of left) {
+            if (!right.has(value)) {
+                result.add(value);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=set.js.map

package/dist/esm/utils/set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/utils/set.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACnB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAI,IAAY,EAAE,KAAa;QAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAK,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CAEF"}

package/dist/esm/utils/string.js

@@ -0,0 +1,55 @@
+/**
+ * Utility class string-related operations.
+ * @name StringUtils
+ * @class StringUtils
+ */
+export class StringUtils {
+    /**
+     * Escape special characters in a string for use in a regular expression.
+     * @param {string} value - The string to escape.
+     * @returns {string} The escaped string.
+     */
+    static escapeRegExp(value) {
+        return value.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&');
+    }
+    /**
+     * Convert a camelCase string to snake_case.
+     * @param {string} value - The camelCase string to convert.
+     * @returns {string} The converted snake_case string.
+     */
+    static toSnake(value) {
+        return value
+            .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+            .toLowerCase();
+    }
+    /**
+     * Convert a string to SNAKE_SCREAMING_CASE.
+     * @param {string} value - The string to convert.
+     * @returns {string} The converted SNAKE_SCREAMING_CASE string.
+     */
+    static toSnakeScream(value) {
+        return this.toSnake(value).toUpperCase();
+    }
+    /**
+     * Remove the last character from a string.
+     * @param {string} value - The string to chop.
+     * @returns {string} The chopped string.
+     */
+    static chop(value) {
+        return value.length > 0 ? value.slice(0, -1) : '';
+    }
+    /**
+     * Replace the end of a string if it matches a given pattern.
+     * @param {string} value - The string to modify.
+     * @param {string | RegExp} pattern - The pattern to match at the end of the string.
+     * @param {string} [replacement=''] - The replacement string.
+     * @returns {string} The modified string.
+     */
+    static replaceEnd(value, pattern, replacement = '') {
+        const regex = pattern instanceof RegExp
+            ? new RegExp(pattern.source.endsWith('$') ? pattern.source : `${pattern.source}$`, pattern.flags.replace(/g/g, ''))
+            : new RegExp(`${this.escapeRegExp(pattern)}$`);
+        return value.replace(regex, replacement);
+    }
+}
+//# sourceMappingURL=string.js.map

package/dist/esm/utils/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../src/utils/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,KAAa;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,KAAK;aACT,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;aACtC,WAAW,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,KAAa;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAa;QACvB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAa,EAAE,OAAwB,EAAE,cAAsB,EAAE;QACjF,MAAM,KAAK,GAAG,OAAO,YAAY,MAAM;YACrC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnH,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEjD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/types/canonicalization.d.ts

@@ -1,4 +1,4 @@
-import { CanonicalizationAlgorithm, HashBytes, JSONObject } from './types.js';
+import { CanonicalizationAlgorithm, CanonicalizationEncoding, HashBytes } from './types.js';
 /**
  * Canonicalization class provides methods for canonicalizing JSON objects
  * and hashing them using SHA-256. It supports different canonicalization
@@ -7,22 +7,31 @@ import { CanonicalizationAlgorithm, HashBytes, JSONObject } from './types.js';
  * @type {Canonicalization}
  */
 export declare class Canonicalization {
-    private _algorithm;
+    private readonly _defaultAlgorithm;
     /**
      * Initializes the Canonicalization class with the specified algorithm.
-     * @param {CanonicalizationAlgorithm} algorithm The canonicalization algorithm to use ('jcs' or 'rdfc').
+     * @param {CanonicalizationAlgorithm} algorithm The canonicalization algorithm to use ('jcs').
      */
     constructor(algorithm?: CanonicalizationAlgorithm);
-    /**
-     * Sets the canonicalization algorithm.
-     * @param {'jcs' | 'rdfc'} algorithm Either 'jcs' or 'rdfc'.
-     */
-    set algorithm(algorithm: 'jcs' | 'rdfc');
     /**
      * Gets the canonicalization algorithm.
      * @returns {CanonicalizationAlgorithm} The current canonicalization algorithm.
      */
     get algorithm(): CanonicalizationAlgorithm;
+    /**
+     * Normalizes the canonicalization algorithm.
+     * @param {CanonicalizationAlgorithm} algorithm
+     * @returns {CanonicalizationAlgorithm} The normalized algorithm.
+     * @throws {CanonicalizationError} If the algorithm is not supported.
+     */
+    static normalizeAlgorithm(algorithm: CanonicalizationAlgorithm): CanonicalizationAlgorithm;
+    /**
+     * Normalizes the canonicalization encoding.
+     * @param {CanonicalizationEncoding} encoding - The encoding to normalize.
+     * @returns {CanonicalizationEncoding} The normalized encoding.
+     * @throws {CanonicalizationError} If the encoding is not supported.
+     */
+    static normalizeEncoding(encoding: CanonicalizationEncoding): CanonicalizationEncoding;
     /**
      * Implements {@link http://dcdpr.github.io/did-btcr2/#json-canonicalization-and-hash | 9.2 JSON Canonicalization and Hash}.
      *
@@ -30,31 +39,32 @@ export declare class Canonicalization {
      * Scheme. The function returns the canonicalizedBytes.
      *
      * Optionally encodes a sha256 hashed canonicalized JSON object.
-     * Step 1 Canonicalize (JCS/RDFC) → Step 2 Hash (SHA256) → Step 3 Encode (Hex/Base58).
+     * Step 1 Canonicalize (JCS) → Step 2 Hash (SHA256) → Step 3 Encode (Hex/Base58).
      *
-     * @param {JSONObject} object The object to process.
-     * @param {string} encoding The encoding format ('hex' or 'base58').
+     * @param {Record<any, any>} object The object to process.
+     * @param {Object} [options] Options for processing.
+     * @param {CanonicalizationEncoding} [options.encoding='hex'] The encoding format ('hex' or 'base58').
+     * @param {CanonicalizationAlgorithm} [options.algorithm] The canonicalization algorithm to use.
      * @returns {Promise<string>} The final SHA-256 hash bytes as a hex string.
      */
-    process(object: JSONObject, encoding?: string): Promise<string>;
+    process(object: Record<any, any>, options?: {
+        encoding?: CanonicalizationEncoding;
+        algorithm?: CanonicalizationAlgorithm;
+        multibase?: boolean;
+    }): Promise<string>;
     /**
-     * Step 1: Uses this.algorithm to determine the method (JCS/RDFC).
-     * @param {JSONObject} object The object to canonicalize.
+     * Step 1: Uses this.algorithm to determine the method (JCS).
+     * @param {Record<any, any>} object The object to canonicalize.
+     * @param {CanonicalizationAlgorithm} [algorithm] The algorithm to use.
      * @returns {Promise<string>} The canonicalized object.
      */
-    canonicalize(object: JSONObject): Promise<string>;
+    canonicalize(object: Record<any, any>, algorithm?: CanonicalizationAlgorithm): Promise<string>;
     /**
      * Step 1: Canonicalizes an object using JCS (JSON Canonicalization Scheme).
-     * @param {JSONObject} object The object to canonicalize.
+     * @param {Record<any, any>} object The object to canonicalize.
      * @returns {string} The canonicalized object.
      */
-    jcs(object: JSONObject): any;
-    /**
-     * Step 1: Canonicalizes an object using RDF Canonicalization (RDFC).
-     * @param {JSONObject} object The object to canonicalize.
-     * @returns {Promise<string>} The canonicalized object.
-     */
-    rdfc(object: JSONObject): Promise<string>;
+    jcs(object: Record<any, any>): string;
     /**
      * Step 2: SHA-256 hashes a canonicalized object.
      * @param {string} canonicalized The canonicalized object.
@@ -64,11 +74,11 @@ export declare class Canonicalization {
     /**
      * Step 3: Encodes SHA-256 hashed, canonicalized object as a hex or base58 string.
      * @param {string} canonicalizedhash The canonicalized object to encode.
-     * @param {string} encoding The encoding format ('hex' or 'base58').
+     * @param {CanonicalizationEncoding} encoding The encoding format ('hex' or 'base58').
      * @throws {CanonicalizationError} If the encoding format is not supported.
      * @returns {string} The encoded string.
      */
-    encode(canonicalizedhash: HashBytes, encoding?: string): string;
+    encode(canonicalizedhash: HashBytes, encoding?: CanonicalizationEncoding, multibase?: boolean): string;
     /**
      * Step 3.1: Encodes HashBytes (Uint8Array) to a hex string.
      * @param {HashBytes} hashBytes The hash as a Uint8Array.
@@ -84,10 +94,10 @@ export declare class Canonicalization {
     /**
      * Canonicalizes an object, hashes it and returns it as hash bytes.
      * Step 1-2: Canonicalize → Hash.
-     * @param {JSONObject} object The object to process.
+     * @param {Record<any, any>} object The object to process.
      * @returns {Promise<HashBytes>} The final SHA-256 hash bytes.
      */
-    canonicalhash(object: JSONObject): Promise<HashBytes>;
+    canonicalhash(object: Record<any, any>, algorithm?: CanonicalizationAlgorithm): Promise<HashBytes>;
     /**
      * Computes the SHA-256 hash of a canonicalized object and encodes it as a hex string.
      * Step 2-3: Hash → Encode(Hex).
@@ -101,6 +111,5 @@ export declare class Canonicalization {
      * @param {string} canonicalized The canonicalized object to hash.
      * @returns {string} The SHA-256 hash as a base58 string.
      */
-    hashb58(canonicalized: string): string;
+    hashbase58(canonicalized: string): string;
 }
-export declare const canonicalization: Canonicalization;

package/dist/types/canonicalization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonicalization.d.ts","sourceRoot":"","sources":["../../src/canonicalization.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,yBAAyB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9E;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAA4B;IAE9C;;;OAGG;gBAES,SAAS,GAAE,yBAAiC;IAIxD;;;OAGG;IACH,IAAI,SAAS,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,EAUtC;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,yBAAyB,CAEzC;IAED;;;;;;;;;;;;OAYG;IACU,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAWnF;;;;OAIG;IACU,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D;;;;OAIG;IACI,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,GAAG;IAInC;;;;OAIG;IACI,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD;;;;OAIG;IACI,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS;IAI7C;;;;;;OAMG;IACI,MAAM,CAAC,iBAAiB,EAAE,SAAS,EAAE,QAAQ,GAAE,MAAc,GAAG,MAAM;IAW7E;;;;OAIG;IACI,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIxC;;;;OAIG;IACI,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAI3C;;;;;OAKG;IACU,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IAKlE;;;;;OAKG;IACI,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI7C;;;;;OAKG;IACI,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAG9C;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}
+{"version":3,"file":"canonicalization.d.ts","sourceRoot":"","sources":["../../src/canonicalization.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5F;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAE9D;;;OAGG;gBACS,SAAS,GAAE,yBAAiC;IAIxD;;;OAGG;IACH,IAAI,SAAS,IAAI,yBAAyB,CAEzC;IAED;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,yBAAyB,GAAG,yBAAyB;IAQ1F;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,wBAAwB;IAQtF;;;;;;;;;;;;;;OAcG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,GAAE;QAC/C,QAAQ,CAAC,EAAE,wBAAwB,CAAC;QACpC,SAAS,CAAC,EAAE,yBAAyB,CAAC;QACtC,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcxB;;;;;OAKG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,GAAE,yBAAkD,GAAG,OAAO,CAAC,MAAM,CAAC;IAS5H;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM;IAIrC;;;;OAIG;IACI,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS;IAI7C;;;;;;OAMG;IACI,MAAM,CAAC,iBAAiB,EAAE,SAAS,EAAE,QAAQ,GAAE,wBAAgC,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM;IAU3H;;;;OAIG;IACI,GAAG,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAIxC;;;;OAIG;IACI,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;IAK3C;;;;;OAKG;IACU,aAAa,CACxB,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EACxB,SAAS,GAAE,yBAAkD,GAC5D,OAAO,CAAC,SAAS,CAAC;IAKrB;;;;;OAKG;IACI,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI7C;;;;;OAKG;IACI,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAGjD"}

package/dist/types/constants.d.ts

@@ -7,14 +7,7 @@ export declare const MULTIBASE_URI_PREFIX = "urn:mb:";
 export declare const INITIAL_BLOCK_REWARD = 50;
 export declare const HALVING_INTERVAL = 150;
 export declare const COINBASE_MATURITY_DELAY = 100;
-export declare const POLAR_BOB_CLIENT_CONFIG: {
-    username: string;
-    password: string;
-    host: string;
-    allowDefaultWallet: boolean;
-    version: string;
-};
-export declare const POLAR_ALICE_CLIENT_CONFIG: {
+export declare const DEFAULT_POLAR_CONFIG: {
     username: string;
     password: string;
     host: string;
@@ -32,6 +25,11 @@ export declare const DEFAULT_RPC_CONFIG: {
     version: string;
 };
 export declare const DEFAULT_BLOCK_CONFIRMATIONS = 7;
+/**
+ * Load a default RPC config, allowing environment overrides to avoid hard-coding credentials/hosts in bundles.
+ * @returns {typeof DEFAULT_POLAR_CONFIG} The RPC config.
+ */
+export declare function getDefaultRpcConfig(): typeof DEFAULT_POLAR_CONFIG;
 export declare const BIP340_PUBLIC_KEY_MULTIBASE_PREFIX: Bytes;
 export declare const BIP340_PUBLIC_KEY_MULTIBASE_PREFIX_HASH: HashHex;
 export declare const BIP340_SECRET_KEY_MULTIBASE_PREFIX: Bytes;

package/dist/types/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,oBAAoB,2EAA2E,CAAC;AAC7G,eAAO,MAAM,SAAS,MAAO,CAAC;AAC9B,eAAO,MAAM,SAAS,KAAO,CAAC;AAC9B,eAAO,MAAM,SAAS,UAAa,CAAC;AACpC,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB;;;;;;CAMnC,CAAC;AACF,eAAO,MAAM,yBAAyB;;;;;;CAMrC,CAAC;AACF,eAAO,MAAM,mBAAmB;;CAAoC,CAAC;AACrE,eAAO,MAAM,kBAAkB;;;;;;CAA0B,CAAC;AAC1D,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAG7C,eAAO,MAAM,kCAAkC,EAAE,KAAoC,CAAC;AAEtF,eAAO,MAAM,uCAAuC,EAAE,OAAiF,CAAC;AAExI,eAAO,MAAM,kCAAkC,EAAE,KAAoC,CAAC;AAEtF,eAAO,MAAM,uCAAuC,EAAE,OAAiF,CAAC;AAExI,eAAO,MAAM,IAAI,QAAa,CAAC;AAE/B,eAAO,MAAM,CAAC,QAAsB,CAAC;AAErC,eAAO,MAAM,CAAC,QAA8C,CAAC;AAE7D,eAAO,MAAM,EAAE,iFAAsE,CAAC;AAEtF,eAAO,MAAM,EAAE,iFAAsE,CAAC;AAEtF,eAAO,MAAM,CAAC,KAAK,CAAC;AACpB,eAAO,MAAM,CAAC,KAAK,CAAC;AACpB,eAAO,MAAM,CAAC,QAAI,CAAC;AACnB,eAAO,MAAM,CAAC,QAAI,CAAC;AACnB,eAAO,MAAM,KAAK;;;;;;;CAOjB,CAAC;AAEF,eAAO,MAAM,UAAU,iCAAiC,CAAC;AACzD,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAC7D,eAAO,MAAM,qBAAqB,gDAAgD,CAAC;AACnF,eAAO,MAAM,qBAAqB,gDAAgD,CAAC;AACnF,eAAO,MAAM,eAAe,iCAAiC,CAAC;AAC9D,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AACnE,eAAO,MAAM,WAAW,6BAA6B,CAAC;AACtD,eAAO,MAAM,mBAAmB,sCAAsC,CAAC;AACvE,eAAO,MAAM,eAAe,0CAA0C,CAAC;AACvE,eAAO,MAAM,qBAAqB,uCAAuC,CAAC;AAC1E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3B,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAGtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,UAGlC,CAAC;AAEF,eAAO,MAAM,gCAAgC,UAK5C,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,oBAAoB,2EAA2E,CAAC;AAC7G,eAAO,MAAM,SAAS,MAAO,CAAC;AAC9B,eAAO,MAAM,SAAS,KAAO,CAAC;AAC9B,eAAO,MAAM,SAAS,UAAa,CAAC;AACpC,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAC9C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,oBAAoB;;;;;;CAMhC,CAAC;AACF,eAAO,MAAM,mBAAmB;;CAAoC,CAAC;AACrE,eAAO,MAAM,kBAAkB;;;;;;CAAuB,CAAC;AACvD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,oBAAoB,CAOjE;AAGD,eAAO,MAAM,kCAAkC,EAAE,KAAoC,CAAC;AAEtF,eAAO,MAAM,uCAAuC,EAAE,OAAgE,CAAC;AAEvH,eAAO,MAAM,kCAAkC,EAAE,KAAoC,CAAC;AAEtF,eAAO,MAAM,uCAAuC,EAAE,OAAgE,CAAC;AAEvH,eAAO,MAAM,IAAI,QAAa,CAAC;AAE/B,eAAO,MAAM,CAAC,QAAsB,CAAC;AAErC,eAAO,MAAM,CAAC,QAA8C,CAAC;AAE7D,eAAO,MAAM,EAAE,iFAAsE,CAAC;AAEtF,eAAO,MAAM,EAAE,iFAAsE,CAAC;AAEtF,eAAO,MAAM,CAAC,KAAK,CAAC;AACpB,eAAO,MAAM,CAAC,KAAK,CAAC;AACpB,eAAO,MAAM,CAAC,QAAI,CAAC;AACnB,eAAO,MAAM,CAAC,QAAI,CAAC;AACnB,eAAO,MAAM,KAAK;;;;;;;CAOjB,CAAC;AAEF,eAAO,MAAM,UAAU,iCAAiC,CAAC;AACzD,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAC7D,eAAO,MAAM,qBAAqB,gDAAgD,CAAC;AACnF,eAAO,MAAM,qBAAqB,gDAAgD,CAAC;AACnF,eAAO,MAAM,eAAe,iCAAiC,CAAC;AAC9D,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AACnE,eAAO,MAAM,WAAW,6BAA6B,CAAC;AACtD,eAAO,MAAM,mBAAmB,sCAAsC,CAAC;AACvE,eAAO,MAAM,eAAe,0CAA0C,CAAC;AACvE,eAAO,MAAM,qBAAqB,uCAAuC,CAAC;AAC1E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgC3B,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAGtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,UAGlC,CAAC;AAEF,eAAO,MAAM,gCAAgC,UAK5C,CAAC"}

package/dist/types/index.d.ts

@@ -1,9 +1,11 @@
-import './exts.js';
 export * from './canonicalization.js';
 export * from './constants.js';
 export * from './errors.js';
 export * from './interfaces.js';
+export * from './json-patch.js';
 export * from './logger.js';
-export * from './patch.js';
 export * from './types.js';
-export * from './exts.js';
+export * from './utils/date.js';
+export * from './utils/json.js';
+export * from './utils/set.js';
+export * from './utils/string.js';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAC;AAEnB,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/types/interfaces.d.ts

@@ -1,12 +1,12 @@
 export type JsonPatch = Array<PatchOperation>;
-export type PatchOpCode = 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test' | string;
+export type PatchOpCode = 'add' | 'remove' | 'replace' | 'move' | 'copy' | 'test' | (string & {});
 /**
  * A JSON Patch operation, as defined in {@link https://datatracker.ietf.org/doc/html/rfc6902 | RFC 6902}.
  */
 export interface PatchOperation {
     op: PatchOpCode;
     path: string;
-    value?: any;
+    value?: unknown;
     from?: string;
 }
 /**

package/dist/types/interfaces.d.ts.map

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

package/dist/types/json-patch.d.ts

@@ -0,0 +1,47 @@
+import { PatchOperation } from './interfaces.js';
+import { JSONObject } from './types.js';
+/**
+ * Thin wrapper around fast-json-patch to keep a stable API within this package.
+ * @class JSONPatch
+ * @type {JSONPatch}
+ */
+export declare class JSONPatch {
+    /**
+     * Applies a JSON Patch to a source document and returns the patched document.
+     * Does not mutate the input document.
+     * @param {JSONObject} sourceDocument - The source JSON document to apply the patch to.
+     * @param {PatchOperation[]} operations - The JSON Patch operations to apply.
+     * @returns {JSONObject} The patched JSON document.
+     */
+    static apply(sourceDocument: Record<any, any>, operations: PatchOperation[], options?: {
+        mutate?: boolean;
+        clone?: (value: any) => any;
+    }): Record<any, any>;
+    /**
+     * Compute a JSON Patch diff from source => target.
+     * @param {JSONObject} sourceDocument - The source JSON document.
+     * @param {JSONObject} targetDocument - The target JSON document.
+     * @param {string} [path] - An optional base path to prefix to each operation.
+     * @returns {PatchOperation[]} The computed JSON Patch operations.
+     */
+    static diff(sourceDocument: JSONObject, targetDocument: JSONObject, path?: string): PatchOperation[];
+    /**
+   * Join a base pointer prefix with an operation path ensuring correct escaping.
+   * @param {string} prefix - The base pointer prefix.
+   * @param {string} opPath - The operation path.
+   * @returns {string} The joined pointer.
+   */
+    static joinPointer(prefix: string, opPath: string): string;
+    /**
+   * Escape a JSON Pointer segment according to RFC 6901.
+   * @param {string} pointer - The JSON Pointer to escape.
+   * @returns {string} The escaped JSON Pointer.
+   */
+    static escapeSegmentPath(pointer: string): string;
+    /**
+   * Validate JSON Patch operations.
+   * @param {PatchOperation[]} operations - The operations to validate.
+   * @returns {Error | null} An Error if validation fails, otherwise null.
+   */
+    static validateOperations(operations: PatchOperation[]): Error | null;
+}

package/dist/types/json-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-patch.d.ts","sourceRoot":"","sources":["../../src/json-patch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIxC;;;;GAIG;AACH,qBAAa,SAAS;IACpB;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CACV,cAAc,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAChC,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAA;KAAO,GAC9D,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC;IAmBnB;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,GAAE,MAAW,GAAG,cAAc,EAAE;IAWxG;;;;;KAKC;IACD,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAM1D;;;;KAIC;IACD,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAOjD;;;;KAIC;IACD,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,KAAK,GAAG,IAAI;CAYtE"}

package/dist/types/logger.d.ts

@@ -12,24 +12,46 @@ export declare const NODE_ENV: Env;
  * - File/line tracing
  * - Timestamps
  * - Colorized output
+ * @class Logger
+ * @type {Logger}
  */
 export declare class Logger {
     private levels;
     private namespace?;
-    constructor(namespace?: string);
+    private useColors;
+    private static shared;
+    /**
+     * Creates a new Logger instance.
+     * @param {string} namespace - Optional namespace for log messages.
+     * @param {Object} options - Configuration options.
+     * @param {Level[]} options.levels - Log levels to enable.
+     * @param {boolean} options.useColors - Whether to use colored output.
+     */
+    constructor(namespace?: string, options?: {
+        levels?: Level[];
+        useColors?: boolean;
+    });
     /**
      * Logs a message with the specified level.
+     * @param {Level} level - The log level.
+     * @param {unknown} message - The message to log.
+     * @param {...unknown[]} args - Additional arguments to log.
+     * @returns {void}
      */
     private _log;
-    debug(message?: unknown, ...args: unknown[]): this;
-    error(message?: unknown, ...args: unknown[]): this;
-    info(message?: unknown, ...args: unknown[]): this;
-    warn(message?: unknown, ...args: unknown[]): this;
-    security(message?: unknown, ...args: unknown[]): this;
-    log(message?: unknown, ...args: unknown[]): this;
-    newline(): this;
+    debug(message?: unknown, ...args: unknown[]): Logger;
+    error(message?: unknown, ...args: unknown[]): Logger;
+    info(message?: unknown, ...args: unknown[]): Logger;
+    warn(message?: unknown, ...args: unknown[]): Logger;
+    security(message?: unknown, ...args: unknown[]): Logger;
+    log(message?: unknown, ...args: unknown[]): Logger;
+    newline(): Logger;
     /**
      * Static methods for convenience (auto-instantiate).
+     * These use a shared singleton instance.
+     * @param {unknown} message - The message to log.
+     * @param {...unknown[]} args - Additional arguments to log.
+     * @returns {void}
      */
     static debug(message?: unknown, ...args: unknown[]): void;
     static error(message?: unknown, ...args: unknown[]): void;
@@ -38,4 +60,5 @@ export declare class Logger {
     static security(message?: unknown, ...args: unknown[]): void;
     static log(message?: unknown, ...args: unknown[]): void;
     static newline(): void;
+    private static instance;
 }

package/dist/types/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAEA,oBAAY,GAAG;IACb,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,IAAI,SAAS;CACd;AAED,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7E,eAAO,MAAM,QAAQ,KAAmD,CAAC;AAoCzE;;;;;;;GAOG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,SAAS,CAAC,EAAE,MAAM;IAK9B;;OAEG;IACH,OAAO,CAAC,IAAI;IAgBL,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAI3C,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAI3C,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAI1C,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAI1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAI9C,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAIzC,OAAO;IAId;;OAEG;WACW,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;WAI3C,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;WAI3C,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;WAI1C,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;WAI1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;WAI9C,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;WAIzC,OAAO;CAGtB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAEA,oBAAY,GAAG;IACb,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,IAAI,SAAS;CACd;AAED,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7E,eAAO,MAAM,QAAQ,KAAmD,CAAC;AAoCzE;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAS;IAE9B;;;;;;OAMG;gBACS,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;IAOvF;;;;;;OAMG;IACH,OAAO,CAAC,IAAI;IAiBZ,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM;IAIpD,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM;IAIpD,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM;IAInD,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM;IAInD,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM;IAIvD,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM;IAIlD,OAAO,IAAI,MAAM;IAIjB;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIzD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIzD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIxD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIxD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI5D,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIvD,MAAM,CAAC,OAAO;IAId,OAAO,CAAC,MAAM,CAAC,QAAQ;CASxB"}

package/dist/types/types.d.ts

@@ -67,12 +67,18 @@ export type BeaconUri = string;
 export type DidPlaceholder = 'did:btcr2:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
 export type CanonicalizedProofConfig = string;
 export type CryptosuiteName = 'bip340-jcs-2025' | 'bip340-rdfc-2025';
-export type ContextObject = Record<string | number | symbol, any>;
-export type Context = string | string[] | ContextObject | ContextObject[];
-export type Maybe<T> = T | any;
-export type JSONObject = Record<string | number | symbol, any>;
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonArray = JsonValue[];
+export type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type JSONObject = JsonObject;
 export type Prototyped = JSONObject;
 export type Unprototyped = JSONObject;
+export type ContextObject = Record<string, JsonValue>;
+export type Context = string | string[] | ContextObject | ContextObject[];
+export type Maybe<T> = T | unknown;
 export type TwoDigits = `${number}${number}`;
 export type ThreeDigits = `${number}${number}${number}`;
 export type Year = `${1 | 2}${ThreeDigits}`;
@@ -86,4 +92,5 @@ export type TzOffset = `${Hours}:${Minutes}`;
 export type DateTimestamp = `${UtcTimestamp}Z` | `${UtcTimestamp}-${TzOffset}`;
 export type CanonicalizableObject = Record<string, any>;
 export type CanonicalizationAlgorithm = 'jcs' | 'rdfc';
+export type CanonicalizationEncoding = 'hex' | 'base58';
 export type UnixTimestamp = number;

package/dist/types/types.d.ts.map

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

package/dist/types/utils/date.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Utility class for date-related operations.
+ * @name DateUtils
+ * @class DateUtils
+ */
+export declare class DateUtils {
+    /**
+     * Render an ISO 8601 UTC timestamp without fractional seconds.
+     * @param {Date} [date=new Date()] - The date to format.
+     * @returns {string} The formatted date string.
+     */
+    static getUTCDateTime(date?: Date): string;
+    /**
+     * Unix timestamp in seconds (integer).
+     * @param {Date} [date=new Date()] - The date to convert.
+     * @returns {number} The Unix timestamp in seconds.
+     */
+    static toUnixSeconds(date?: Date): number;
+}

package/dist/types/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../src/utils/date.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,SAAS;IACpB;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM;IAQtD;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM;CAOtD"}

package/dist/types/utils/json.d.ts

@@ -0,0 +1,89 @@
+import { JSONObject, Prototyped, Unprototyped } from '../types.js';
+/**
+ * Options for cloning JSON values.
+ */
+type CloneOptions = {
+    stripPrototypes?: boolean;
+    transform?: (value: any) => any;
+};
+/**
+ * Utilities for working with JSON data.
+ * @name JSONUtils
+ * @class JSONUtils
+ */
+export declare class JSONUtils {
+    /**
+     * Check if a value is a JSON object (not an array, not null, and has Object prototype).
+     * @param {unknown} value - The value to check.
+     * @returns {boolean} True if the value is a JSON object.
+     */
+    static isObject(value: unknown): value is JSONObject;
+    /**
+     * Check if a value is a parsable JSON string.
+     * @param {unknown} value - The value to check.
+     * @returns {boolean} True if the value is a parsable JSON string.
+     */
+    static isParsable(value: unknown): value is string;
+    /**
+     * Check if a value is an unprototyped object (i.e., Object.create(null)).
+     * @param {unknown} value - The value to check.
+     * @returns {boolean} True if the value is an unprototyped object.
+     */
+    static isUnprototyped(value: unknown): value is Unprototyped;
+    /**
+     * Normalize a JSON value by stripping prototypes from all objects within it.
+     * @param {T} value - The JSON value to normalize.
+     * @returns {Prototyped} The normalized JSON value.
+     */
+    static normalize<T extends JSONObject | Array<any>>(value: T): Prototyped;
+    /**
+     * Shallow copy of a JSON object.
+     * @param {T extends JSONObject} value - The JSON object to copy.
+     * @returns {T} The copied JSON object.
+     */
+    static copy<T extends JSONObject>(value: T): T;
+    /**
+     * Deep clone a JSON value.
+     * @param {T} value - The JSON value to clone.
+     * @returns {T} The cloned JSON value.
+     */
+    static clone<T>(value: T): T;
+    /**
+     * Deep clone a JSON value, replacing strings that match a pattern.
+     * @param {T} value - The JSON value to clone.
+     * @param {RegExp} pattern - The regex pattern to match strings.
+     * @param {string} replacement - The replacement string.
+     * @returns {T} The cloned JSON value with replacements.
+     */
+    static cloneReplace<T>(value: T, pattern: RegExp, replacement: string): T;
+    /**
+     * Deep equality check between two values.
+     * @param {unknown} a - The first value to compare.
+     * @param {unknown} b - The second value to compare.
+     * @param {WeakMap<object, object>} seen - A WeakMap to track seen object pairs for circular reference detection.
+     * @returns {boolean} True if the values are deeply equal.
+     */
+    static deepEqual(a: unknown, b: unknown, seen?: WeakMap<object, object>, depth?: number): boolean;
+    /**
+     * Delete specified keys from a JSON value.
+     * @param {T} value - The JSON value to process.
+     * @param {Array<string | number | symbol>} keys - The keys to delete.
+     * @returns {T} The JSON value with specified keys deleted.
+     */
+    static deleteKeys<T>(value: T, keys: Array<string | number | symbol>): T;
+    /**
+     * Sanitize a JSON value by removing undefined values from objects and arrays.
+     * @param {T} value - The JSON value to sanitize.
+     * @returns {T} The sanitized JSON value.
+     */
+    static sanitize<T>(value: T): T;
+    /**
+     * Internal function to clone JSON values with options.
+     * @param {T} value - The value to clone.
+     * @param {CloneOptions} options - The cloning options.
+     * @param {WeakMap<object, any>} seen - A WeakMap to track seen objects for circular reference detection.
+     * @returns {any} The cloned value.
+     */
+    static cloneInternal<T>(value: T, options?: CloneOptions, seen?: WeakMap<object, any>, depth?: number): any;
+}
+export {};

package/dist/types/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/utils/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnE;;GAEG;AACH,KAAK,YAAY,GAAG;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;CACjC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,SAAS;IACpB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU;IAOpD;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM;IAUlD;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY;IAK5D;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU;IAIzE;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAI9C;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAO5B;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC;IAQzE;;;;;;OAMG;IACH,MAAM,CAAC,SAAS,CACd,CAAC,EAAE,OAAO,EACV,CAAC,EAAE,OAAO,EACV,IAAI,GAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAiC,EAC7D,KAAK,GAAE,MAAU,GAChB,OAAO;IAoFV;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;IAuBxE;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC;IAuB/B;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EACpB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,YAAiB,EAC1B,IAAI,GAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAA8B,EACvD,KAAK,GAAE,MAAU,GAChB,GAAG;CAmDP"}

package/dist/types/utils/set.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility class for set operations.
+ * @name SetUtils
+ * @class SetUtils
+ */
+export declare class SetUtils {
+    /**
+     * Compute the set difference without mutating the inputs.
+     * @param {Set<T>} left - The left set.
+     * @param {Set<T>} right - The right set.
+     * @returns {Set<T>} A new set containing elements in `left` that are not in `right`.
+     */
+    static difference<T>(left: Set<T>, right: Set<T>): Set<T>;
+}

package/dist/types/utils/set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../src/utils/set.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,QAAQ;IACnB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;CAU1D"}