@did-btcr2/common 2.2.1 → 3.0.0

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

@@ -61,17 +61,24 @@ export declare enum BitcoinNetworkNames {
     testnet4 = 4,
     mutinynet = 5
 }
-export type KeyIdentifier = string;
+export type DecentralizedIdentifier = string;
+export type Did = DecentralizedIdentifier;
 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}`;
@@ -85,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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAGrC,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC;AAC/B,MAAM,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC;AACjC,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC;AAC/B,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAE1B,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC;AACnC,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC;AAC/B,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC;AAC9B,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC;AACjC,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAErC,MAAM,MAAM,6BAA6B,GAAG,IAAI,GAAG,IAAI,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAElC,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC;AAC7B,MAAM,MAAM,KAAK,GAAG;IAClB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAA;AACD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,eAAe,CAAC;CAC5B,CAAC;AACF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,GAAG,CAAC;CACX,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC;CACrB,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,eAAe,CAAC;CAC5B,CAAC;AACF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAA;CACf,CAAC;AACF,oBAAY,eAAe;IACvB,GAAG,QAAQ;IACX,QAAQ,aAAa;CACxB;AACD,oBAAY,aAAa;IACrB,CAAC,MAAM;IACP,CAAC,MAAM;CACV;AACD,oBAAY,mBAAmB;IAC3B,OAAO,IAAI;IACX,MAAM,IAAI;IACV,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,SAAS,IAAI;CAChB;AACD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AACnC,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAC/B,MAAM,MAAM,cAAc,GAAG,wEAAwE,CAAC;AACtG,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;AAClE,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,aAAa,GAAG,aAAa,EAAE,CAAA;AAGzE,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AAC/B,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;AAC/D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC;AACpC,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AACtC,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAC7C,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AACxD,MAAM,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,EAAE,CAAC;AAC5C,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC;AAC9B,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC;AAC5B,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC;AAC9B,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC;AAChC,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC;AAChC,MAAM,MAAM,YAAY,GAAG,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;AACpF,MAAM,MAAM,QAAQ,GAAG,GAAG,KAAK,IAAI,OAAO,EAAE,CAAC;AAC7C,MAAM,MAAM,aAAa,GAAG,GAAG,YAAY,GAAG,GAAG,GAAG,YAAY,IAAI,QAAQ,EAAE,CAAC;AAC/E,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACxD,MAAM,MAAM,yBAAyB,GAAG,KAAK,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC"}
+{"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"}

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

@@ -0,0 +1,39 @@
+/**
+ * Utility class string-related operations.
+ * @name StringUtils
+ * @class StringUtils
+ */
+export declare 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: string): string;
+    /**
+     * 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: string): string;
+    /**
+     * 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: string): string;
+    /**
+     * Remove the last character from a string.
+     * @param {string} value - The string to chop.
+     * @returns {string} The chopped string.
+     */
+    static chop(value: string): string;
+    /**
+     * 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: string, pattern: string | RegExp, replacement?: string): string;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/utils/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,WAAW;IACtB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI1C;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMrC;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI3C;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlC;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,GAAE,MAAW,GAAG,MAAM;CAO7F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@did-btcr2/common",
-  "version": "2.2.1",
+  "version": "3.0.0",
   "type": "module",
   "description": "Common utilities, types, interfaces, etc. shared across the did-btcr2-js monorepo packages.",
   "main": "./dist/cjs/index.js",
@@ -46,11 +46,10 @@
   "dependencies": {
     "@noble/hashes": "^1.7.1",
     "@scure/bip32": "^1.5.0",
-    "canonicalize": "^2.1.0",
     "chalk": "^5.4.1",
+    "fast-json-patch": "^3.1.1",
     "json-canonicalize": "^1.0.6",
-    "multiformats": "^13.3.2",
-    "rdf-canonize": "^4.0.1"
+    "multiformats": "^13.3.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.21.0",

package/src/canonicalization.ts

@@ -2,9 +2,8 @@ import { sha256 } from '@noble/hashes/sha2';
 import { bytesToHex } from '@noble/hashes/utils';
 import { canonicalize as jcsa } from 'json-canonicalize';
 import { base58btc } from 'multiformats/bases/base58';
-import rdf from 'rdf-canonize';
-import { CanonicalizationAlgorithm, HashBytes, JSONObject } from './types.js';
 import { CanonicalizationError } from './errors.js';
+import { CanonicalizationAlgorithm, CanonicalizationEncoding, HashBytes } from './types.js';
 
 /**
  * Canonicalization class provides methods for canonicalizing JSON objects
@@ -14,39 +13,50 @@ import { CanonicalizationError } from './errors.js';
  * @type {Canonicalization}
  */
 export class Canonicalization {
-  private _algorithm: CanonicalizationAlgorithm;
+  private readonly _defaultAlgorithm: CanonicalizationAlgorithm;
 
   /**
    * 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').
    */
-  // TODO: Need to move to using RDFC by default
   constructor(algorithm: CanonicalizationAlgorithm = 'jcs') {
-    this._algorithm = algorithm;
+    this._defaultAlgorithm = Canonicalization.normalizeAlgorithm(algorithm);
   }
 
   /**
-   * Sets the canonicalization algorithm.
-   * @param {'jcs' | 'rdfc'} algorithm Either 'jcs' or 'rdfc'.
+   * Gets the canonicalization algorithm.
+   * @returns {CanonicalizationAlgorithm} The current canonicalization algorithm.
    */
-  set algorithm(algorithm: 'jcs' | 'rdfc') {
-    // Normalize the passed algorithm to lowercase
-    algorithm = algorithm.toLowerCase() as CanonicalizationAlgorithm;
+  get algorithm(): CanonicalizationAlgorithm {
+    return this._defaultAlgorithm;
+  }
 
-    // Validate the algorithm is either 'jcs' or 'rdfc'
-    if(!['jcs', 'rdfc'].includes(algorithm)){
+  /**
+   * 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 {
+    const normalized = algorithm.toLowerCase() as CanonicalizationAlgorithm;
+    if (normalized !== 'jcs') {
       throw new CanonicalizationError(`Unsupported algorithm: ${algorithm}`, 'ALGORITHM_ERROR');
     }
-    // Set the algorithm
-    this._algorithm = algorithm;
+    return normalized;
   }
 
   /**
-   * Gets the canonicalization algorithm.
-   * @returns {CanonicalizationAlgorithm} The current canonicalization algorithm.
+   * Normalizes the canonicalization encoding.
+   * @param {CanonicalizationEncoding} encoding - The encoding to normalize.
+   * @returns {CanonicalizationEncoding} The normalized encoding.
+   * @throws {CanonicalizationError} If the encoding is not supported.
    */
-  get algorithm(): CanonicalizationAlgorithm {
-    return this._algorithm;
+  static normalizeEncoding(encoding: CanonicalizationEncoding): CanonicalizationEncoding {
+    const normalized = encoding.toLowerCase() as CanonicalizationEncoding;
+    if (normalized !== 'hex' && normalized !== 'base58') {
+      throw new CanonicalizationError(`Unsupported encoding: ${encoding}`, 'ENCODING_ERROR');
+    }
+    return normalized;
   }
 
   /**
@@ -56,50 +66,56 @@ export 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.
    */
-  public async process(object: JSONObject, encoding: string = 'hex'): Promise<string> {
+  async process(object: Record<any, any>, options: {
+    encoding?: CanonicalizationEncoding;
+    algorithm?: CanonicalizationAlgorithm;
+    multibase?: boolean;
+  } = {}): Promise<string> {
+    const algorithm = Canonicalization.normalizeAlgorithm(options.algorithm ?? this._defaultAlgorithm);
+    const encoding = Canonicalization.normalizeEncoding(options.encoding ?? 'hex');
+
     // Step 1: Canonicalize
-    const canonicalized = await this.canonicalize(object);
+    const canonicalized = await this.canonicalize(object, algorithm);
     // Step 2: Hash
     const hashed = this.hash(canonicalized);
     // Step 3: Encode
-    const encoded = this.encode(hashed, encoding);
+    const encoded = this.encode(hashed, encoding, options.multibase ?? false);
     // Return the encoded string
     return encoded;
   }
 
   /**
-   * 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.
    */
-  public async canonicalize(object: JSONObject): Promise<string> {
-    return await (this[this.algorithm] as (object: JSONObject) => any)(object);
+  async canonicalize(object: Record<any, any>, algorithm: CanonicalizationAlgorithm = this._defaultAlgorithm): Promise<string> {
+    switch (Canonicalization.normalizeAlgorithm(algorithm)) {
+      case 'jcs':
+        return this.jcs(object);
+      default:
+        throw new CanonicalizationError(`Unsupported algorithm: ${algorithm}`, 'ALGORITHM_ERROR');
+    }
   }
 
   /**
    * 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.
    */
-  public jcs(object: JSONObject): any {
+  jcs(object: Record<any, any>): string {
     return jcsa(object);
   }
 
-  /**
-   * Step 1: Canonicalizes an object using RDF Canonicalization (RDFC).
-   * @param {JSONObject} object The object to canonicalize.
-   * @returns {Promise<string>} The canonicalized object.
-   */
-  public rdfc(object: JSONObject): Promise<string> {
-    return rdf.canonize([object], { algorithm: 'RDFC-1.0' });
-  }
-
   /**
    * Step 2: SHA-256 hashes a canonicalized object.
    * @param {string} canonicalized The canonicalized object.
@@ -112,19 +128,18 @@ export 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.
    */
-  public encode(canonicalizedhash: HashBytes, encoding: string = 'hex'): string {
-    switch(encoding) {
-      case 'hex':
-        return this.hex(canonicalizedhash);
-      case 'base58':
-        return this.base58(canonicalizedhash);
-      default:
-        throw new CanonicalizationError(`Unsupported encoding: ${encoding}`, 'ENCODING_ERROR');
+  public encode(canonicalizedhash: HashBytes, encoding: CanonicalizationEncoding = 'hex', multibase: boolean = false): string {
+    const normalized = Canonicalization.normalizeEncoding(encoding);
+    if (normalized === 'hex') return this.hex(canonicalizedhash);
+    if (normalized === 'base58') {
+      const encoded = this.base58(canonicalizedhash);
+      return multibase ? `z${encoded}` : encoded;
     }
+    throw new CanonicalizationError(`Unsupported encoding: ${encoding}`, 'ENCODING_ERROR');
   }
 
   /**
@@ -142,17 +157,21 @@ export class Canonicalization {
    * @returns {string} The hash as a hex string.
    */
   public base58(hashBytes: HashBytes): string {
-    return base58btc.encode(hashBytes);
+    const encoded = base58btc.encode(hashBytes);
+    return encoded.startsWith('z') ? encoded.slice(1) : encoded;
   }
 
   /**
    * 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.
    */
-  public async canonicalhash(object: JSONObject): Promise<HashBytes> {
-    const canonicalized = await this.canonicalize(object);
+  public async canonicalhash(
+    object: Record<any, any>,
+    algorithm: CanonicalizationAlgorithm = this._defaultAlgorithm
+  ): Promise<HashBytes> {
+    const canonicalized = await this.canonicalize(object, algorithm);
     return this.hash(canonicalized);
   }
 
@@ -163,7 +182,7 @@ export class Canonicalization {
    * @returns {string} The SHA-256 hash as a hex string.
    */
   public hashhex(canonicalized: string): string {
-    return this.encode(this.hash(canonicalized));
+    return this.encode(this.hash(canonicalized), 'hex');
   }
 
   /**
@@ -172,9 +191,7 @@ export class Canonicalization {
    * @param {string} canonicalized The canonicalized object to hash.
    * @returns {string} The SHA-256 hash as a base58 string.
    */
-  public hashb58(canonicalized: string): string {
-    return this.encode(this.hash(canonicalized), 'base58');
+  public hashbase58(canonicalized: string): string {
+    return this.encode(this.hash(canonicalized), 'base58', false);
   }
 }
-
-export const canonicalization = new Canonicalization();