@metamask-previews/keyring-controller 25.0.0-preview-cd6eae6b → 25.0.0-preview-6bed60a6

package/dist/errors.cjs

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyringControllerError = void 0;
+/**
+ * Error class for KeyringController-related errors.
+ *
+ * This error class extends the standard Error class and supports:
+ * - Error chaining via the `cause` property (ES2022 standard)
+ * - Optional error codes for programmatic error handling
+ * - Additional context data for debugging
+ * - Backward compatibility with the legacy `originalError` property
+ */
+class KeyringControllerError extends Error {
+    /**
+     * Creates a new KeyringControllerError.
+     *
+     * @param message - The error message.
+     * @param options - Error options or an Error object for backward compatibility.
+     */
+    constructor(message, options) {
+        super(message);
+        this.name = 'KeyringControllerError';
+        // Support both new signature (options object) and legacy signature (Error as second param)
+        const cause = options instanceof Error ? options : options?.cause;
+        const code = options instanceof Error ? undefined : options?.code;
+        const data = options instanceof Error ? undefined : options?.data;
+        // Set cause property for error chaining (ES2022 standard)
+        if (cause) {
+            this.cause = cause;
+            // Maintain backward compatibility with originalError
+            this.originalError = cause;
+        }
+        // Set code and data if provided
+        if (code) {
+            this.code = code;
+        }
+        if (data) {
+            this.data = data;
+        }
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, KeyringControllerError.prototype);
+    }
+    /**
+     * Returns a JSON representation of the error.
+     * Useful for logging and error reporting.
+     *
+     * @returns JSON representation of the error.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            data: this.data,
+            stack: this.stack,
+            cause: this.cause
+                ? {
+                    name: this.cause.name,
+                    message: this.cause.message,
+                    stack: this.cause.stack,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Returns a string representation of the error chain.
+     * Includes all chained errors for better debugging.
+     *
+     * @returns String representation of the error chain.
+     */
+    toString() {
+        let result = `${this.name}: ${this.message}`;
+        if (this.code) {
+            result += ` [${this.code}]`;
+        }
+        if (this.cause) {
+            result += `\n  Caused by: ${this.cause}`;
+        }
+        return result;
+    }
+}
+exports.KeyringControllerError = KeyringControllerError;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAqBA;;;;;;;;GAQG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAsB/C;;;;;OAKG;IACH,YACE,OAAe,EACf,OAA+C;QAE/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QAErC,2FAA2F;QAC3F,MAAM,KAAK,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;QAElE,0DAA0D;QAC1D,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,qDAAqD;YACrD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC7B,CAAC;QAED,gCAAgC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACf,CAAC,CAAC;oBACE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;oBACrB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;oBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;iBACxB;gBACH,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAE7C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;QAC9B,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AArGD,wDAqGC","sourcesContent":["/**\n * Options for creating a KeyringControllerError.\n */\nexport type KeyringControllerErrorOptions = {\n  /**\n   * The underlying error that caused this error (for error chaining).\n   * Uses the standard Error.cause property (ES2022).\n   */\n  cause?: Error;\n  /**\n   * Optional error code for programmatic error handling.\n   * This can be used to identify specific error types without string matching.\n   */\n  code?: string;\n  /**\n   * Additional context data associated with the error.\n   * Useful for debugging and error reporting.\n   */\n  data?: Record<string, unknown>;\n};\n\n/**\n * Error class for KeyringController-related errors.\n *\n * This error class extends the standard Error class and supports:\n * - Error chaining via the `cause` property (ES2022 standard)\n * - Optional error codes for programmatic error handling\n * - Additional context data for debugging\n * - Backward compatibility with the legacy `originalError` property\n */\nexport class KeyringControllerError extends Error {\n  /**\n   * Optional error code for programmatic error handling.\n   */\n  code?: string;\n\n  /**\n   * Additional context data associated with the error.\n   */\n  data?: Record<string, unknown>;\n\n  /**\n   * The underlying error that caused this error (ES2022 standard).\n   * This is set manually for compatibility with older TypeScript versions.\n   */\n  cause?: Error;\n\n  /**\n   * @deprecated Use `cause` instead. This property is maintained for backward compatibility.\n   */\n  originalError?: Error;\n\n  /**\n   * Creates a new KeyringControllerError.\n   *\n   * @param message - The error message.\n   * @param options - Error options or an Error object for backward compatibility.\n   */\n  constructor(\n    message: string,\n    options?: KeyringControllerErrorOptions | Error,\n  ) {\n    super(message);\n    this.name = 'KeyringControllerError';\n\n    // Support both new signature (options object) and legacy signature (Error as second param)\n    const cause = options instanceof Error ? options : options?.cause;\n    const code = options instanceof Error ? undefined : options?.code;\n    const data = options instanceof Error ? undefined : options?.data;\n\n    // Set cause property for error chaining (ES2022 standard)\n    if (cause) {\n      this.cause = cause;\n      // Maintain backward compatibility with originalError\n      this.originalError = cause;\n    }\n\n    // Set code and data if provided\n    if (code) {\n      this.code = code;\n    }\n    if (data) {\n      this.data = data;\n    }\n\n    // Ensure proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, KeyringControllerError.prototype);\n  }\n\n  /**\n   * Returns a JSON representation of the error.\n   * Useful for logging and error reporting.\n   *\n   * @returns JSON representation of the error.\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      data: this.data,\n      stack: this.stack,\n      cause: this.cause\n        ? {\n            name: this.cause.name,\n            message: this.cause.message,\n            stack: this.cause.stack,\n          }\n        : undefined,\n    };\n  }\n\n  /**\n   * Returns a string representation of the error chain.\n   * Includes all chained errors for better debugging.\n   *\n   * @returns String representation of the error chain.\n   */\n  toString(): string {\n    let result = `${this.name}: ${this.message}`;\n\n    if (this.code) {\n      result += ` [${this.code}]`;\n    }\n\n    if (this.cause) {\n      result += `\\n  Caused by: ${this.cause}`;\n    }\n\n    return result;\n  }\n}\n"]}

package/dist/errors.d.cts

@@ -0,0 +1,70 @@
+/**
+ * Options for creating a KeyringControllerError.
+ */
+export type KeyringControllerErrorOptions = {
+    /**
+     * The underlying error that caused this error (for error chaining).
+     * Uses the standard Error.cause property (ES2022).
+     */
+    cause?: Error;
+    /**
+     * Optional error code for programmatic error handling.
+     * This can be used to identify specific error types without string matching.
+     */
+    code?: string;
+    /**
+     * Additional context data associated with the error.
+     * Useful for debugging and error reporting.
+     */
+    data?: Record<string, unknown>;
+};
+/**
+ * Error class for KeyringController-related errors.
+ *
+ * This error class extends the standard Error class and supports:
+ * - Error chaining via the `cause` property (ES2022 standard)
+ * - Optional error codes for programmatic error handling
+ * - Additional context data for debugging
+ * - Backward compatibility with the legacy `originalError` property
+ */
+export declare class KeyringControllerError extends Error {
+    /**
+     * Optional error code for programmatic error handling.
+     */
+    code?: string;
+    /**
+     * Additional context data associated with the error.
+     */
+    data?: Record<string, unknown>;
+    /**
+     * The underlying error that caused this error (ES2022 standard).
+     * This is set manually for compatibility with older TypeScript versions.
+     */
+    cause?: Error;
+    /**
+     * @deprecated Use `cause` instead. This property is maintained for backward compatibility.
+     */
+    originalError?: Error;
+    /**
+     * Creates a new KeyringControllerError.
+     *
+     * @param message - The error message.
+     * @param options - Error options or an Error object for backward compatibility.
+     */
+    constructor(message: string, options?: KeyringControllerErrorOptions | Error);
+    /**
+     * Returns a JSON representation of the error.
+     * Useful for logging and error reporting.
+     *
+     * @returns JSON representation of the error.
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Returns a string representation of the error chain.
+     * Includes all chained errors for better debugging.
+     *
+     * @returns String representation of the error chain.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=errors.d.cts.map

package/dist/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;IAEtB;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,6BAA6B,GAAG,KAAK;IA6BjD;;;;;OAKG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBjC;;;;;OAKG;IACH,QAAQ,IAAI,MAAM;CAanB"}

package/dist/errors.d.mts

@@ -0,0 +1,70 @@
+/**
+ * Options for creating a KeyringControllerError.
+ */
+export type KeyringControllerErrorOptions = {
+    /**
+     * The underlying error that caused this error (for error chaining).
+     * Uses the standard Error.cause property (ES2022).
+     */
+    cause?: Error;
+    /**
+     * Optional error code for programmatic error handling.
+     * This can be used to identify specific error types without string matching.
+     */
+    code?: string;
+    /**
+     * Additional context data associated with the error.
+     * Useful for debugging and error reporting.
+     */
+    data?: Record<string, unknown>;
+};
+/**
+ * Error class for KeyringController-related errors.
+ *
+ * This error class extends the standard Error class and supports:
+ * - Error chaining via the `cause` property (ES2022 standard)
+ * - Optional error codes for programmatic error handling
+ * - Additional context data for debugging
+ * - Backward compatibility with the legacy `originalError` property
+ */
+export declare class KeyringControllerError extends Error {
+    /**
+     * Optional error code for programmatic error handling.
+     */
+    code?: string;
+    /**
+     * Additional context data associated with the error.
+     */
+    data?: Record<string, unknown>;
+    /**
+     * The underlying error that caused this error (ES2022 standard).
+     * This is set manually for compatibility with older TypeScript versions.
+     */
+    cause?: Error;
+    /**
+     * @deprecated Use `cause` instead. This property is maintained for backward compatibility.
+     */
+    originalError?: Error;
+    /**
+     * Creates a new KeyringControllerError.
+     *
+     * @param message - The error message.
+     * @param options - Error options or an Error object for backward compatibility.
+     */
+    constructor(message: string, options?: KeyringControllerErrorOptions | Error);
+    /**
+     * Returns a JSON representation of the error.
+     * Useful for logging and error reporting.
+     *
+     * @returns JSON representation of the error.
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Returns a string representation of the error chain.
+     * Includes all chained errors for better debugging.
+     *
+     * @returns String representation of the error chain.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;IAEtB;;;;;OAKG;gBAED,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,6BAA6B,GAAG,KAAK;IA6BjD;;;;;OAKG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiBjC;;;;;OAKG;IACH,QAAQ,IAAI,MAAM;CAanB"}

package/dist/errors.mjs

@@ -0,0 +1,79 @@
+/**
+ * Error class for KeyringController-related errors.
+ *
+ * This error class extends the standard Error class and supports:
+ * - Error chaining via the `cause` property (ES2022 standard)
+ * - Optional error codes for programmatic error handling
+ * - Additional context data for debugging
+ * - Backward compatibility with the legacy `originalError` property
+ */
+export class KeyringControllerError extends Error {
+    /**
+     * Creates a new KeyringControllerError.
+     *
+     * @param message - The error message.
+     * @param options - Error options or an Error object for backward compatibility.
+     */
+    constructor(message, options) {
+        super(message);
+        this.name = 'KeyringControllerError';
+        // Support both new signature (options object) and legacy signature (Error as second param)
+        const cause = options instanceof Error ? options : options?.cause;
+        const code = options instanceof Error ? undefined : options?.code;
+        const data = options instanceof Error ? undefined : options?.data;
+        // Set cause property for error chaining (ES2022 standard)
+        if (cause) {
+            this.cause = cause;
+            // Maintain backward compatibility with originalError
+            this.originalError = cause;
+        }
+        // Set code and data if provided
+        if (code) {
+            this.code = code;
+        }
+        if (data) {
+            this.data = data;
+        }
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, KeyringControllerError.prototype);
+    }
+    /**
+     * Returns a JSON representation of the error.
+     * Useful for logging and error reporting.
+     *
+     * @returns JSON representation of the error.
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            data: this.data,
+            stack: this.stack,
+            cause: this.cause
+                ? {
+                    name: this.cause.name,
+                    message: this.cause.message,
+                    stack: this.cause.stack,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Returns a string representation of the error chain.
+     * Includes all chained errors for better debugging.
+     *
+     * @returns String representation of the error chain.
+     */
+    toString() {
+        let result = `${this.name}: ${this.message}`;
+        if (this.code) {
+            result += ` [${this.code}]`;
+        }
+        if (this.cause) {
+            result += `\n  Caused by: ${this.cause}`;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAqBA;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAsB/C;;;;;OAKG;IACH,YACE,OAAe,EACf,OAA+C;QAE/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QAErC,2FAA2F;QAC3F,MAAM,KAAK,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;QAClE,MAAM,IAAI,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;QAElE,0DAA0D;QAC1D,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,qDAAqD;YACrD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC7B,CAAC;QAED,gCAAgC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACf,CAAC,CAAC;oBACE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;oBACrB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;oBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;iBACxB;gBACH,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAE7C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC;QAC9B,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF","sourcesContent":["/**\n * Options for creating a KeyringControllerError.\n */\nexport type KeyringControllerErrorOptions = {\n  /**\n   * The underlying error that caused this error (for error chaining).\n   * Uses the standard Error.cause property (ES2022).\n   */\n  cause?: Error;\n  /**\n   * Optional error code for programmatic error handling.\n   * This can be used to identify specific error types without string matching.\n   */\n  code?: string;\n  /**\n   * Additional context data associated with the error.\n   * Useful for debugging and error reporting.\n   */\n  data?: Record<string, unknown>;\n};\n\n/**\n * Error class for KeyringController-related errors.\n *\n * This error class extends the standard Error class and supports:\n * - Error chaining via the `cause` property (ES2022 standard)\n * - Optional error codes for programmatic error handling\n * - Additional context data for debugging\n * - Backward compatibility with the legacy `originalError` property\n */\nexport class KeyringControllerError extends Error {\n  /**\n   * Optional error code for programmatic error handling.\n   */\n  code?: string;\n\n  /**\n   * Additional context data associated with the error.\n   */\n  data?: Record<string, unknown>;\n\n  /**\n   * The underlying error that caused this error (ES2022 standard).\n   * This is set manually for compatibility with older TypeScript versions.\n   */\n  cause?: Error;\n\n  /**\n   * @deprecated Use `cause` instead. This property is maintained for backward compatibility.\n   */\n  originalError?: Error;\n\n  /**\n   * Creates a new KeyringControllerError.\n   *\n   * @param message - The error message.\n   * @param options - Error options or an Error object for backward compatibility.\n   */\n  constructor(\n    message: string,\n    options?: KeyringControllerErrorOptions | Error,\n  ) {\n    super(message);\n    this.name = 'KeyringControllerError';\n\n    // Support both new signature (options object) and legacy signature (Error as second param)\n    const cause = options instanceof Error ? options : options?.cause;\n    const code = options instanceof Error ? undefined : options?.code;\n    const data = options instanceof Error ? undefined : options?.data;\n\n    // Set cause property for error chaining (ES2022 standard)\n    if (cause) {\n      this.cause = cause;\n      // Maintain backward compatibility with originalError\n      this.originalError = cause;\n    }\n\n    // Set code and data if provided\n    if (code) {\n      this.code = code;\n    }\n    if (data) {\n      this.data = data;\n    }\n\n    // Ensure proper prototype chain for instanceof checks\n    Object.setPrototypeOf(this, KeyringControllerError.prototype);\n  }\n\n  /**\n   * Returns a JSON representation of the error.\n   * Useful for logging and error reporting.\n   *\n   * @returns JSON representation of the error.\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      data: this.data,\n      stack: this.stack,\n      cause: this.cause\n        ? {\n            name: this.cause.name,\n            message: this.cause.message,\n            stack: this.cause.stack,\n          }\n        : undefined,\n    };\n  }\n\n  /**\n   * Returns a string representation of the error chain.\n   * Includes all chained errors for better debugging.\n   *\n   * @returns String representation of the error chain.\n   */\n  toString(): string {\n    let result = `${this.name}: ${this.message}`;\n\n    if (this.code) {\n      result += ` [${this.code}]`;\n    }\n\n    if (this.cause) {\n      result += `\\n  Caused by: ${this.cause}`;\n    }\n\n    return result;\n  }\n}\n"]}

package/dist/index.cjs

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./KeyringController.cjs"), exports);
+__exportStar(require("./errors.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAoC","sourcesContent":["export * from './KeyringController';\nexport type * from './types';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAoC;AAEpC,+CAAyB","sourcesContent":["export * from './KeyringController';\nexport type * from './types';\nexport * from './errors';\n"]}

package/dist/index.d.cts

@@ -1,3 +1,4 @@
 export * from "./KeyringController.cjs";
 export type * from "./types.cjs";
+export * from "./errors.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAoC;AACpC,iCAA6B"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAoC;AACpC,iCAA6B;AAC7B,6BAAyB"}

package/dist/index.d.mts

@@ -1,3 +1,4 @@
 export * from "./KeyringController.mjs";
 export type * from "./types.mjs";
+export * from "./errors.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAoC;AACpC,iCAA6B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAoC;AACpC,iCAA6B;AAC7B,6BAAyB"}

package/dist/index.mjs

@@ -1,2 +1,3 @@
 export * from "./KeyringController.mjs";
+export * from "./errors.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAoC","sourcesContent":["export * from './KeyringController';\nexport type * from './types';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAoC;AAEpC,6BAAyB","sourcesContent":["export * from './KeyringController';\nexport type * from './types';\nexport * from './errors';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/keyring-controller",
-  "version": "25.0.0-preview-cd6eae6b",
+  "version": "25.0.0-preview-6bed60a6",
   "description": "Stores identities seen in the wallet and manages interactions such as signing",
   "keywords": [
     "MetaMask",
@@ -57,7 +57,7 @@
     "@metamask/keyring-api": "^21.0.0",
     "@metamask/keyring-internal-api": "^9.0.0",
     "@metamask/messenger": "^0.3.0",
-    "@metamask/utils": "^11.9.0",
+    "@metamask/utils": "^11.8.1",
     "async-mutex": "^0.5.0",
     "ethereumjs-wallet": "^1.0.1",
     "immer": "^9.0.6",