@metamask/hw-wallet-sdk 0.1.0

package/dist/hardware-error-mappings.mjs

@@ -0,0 +1,160 @@
+import { ErrorCode, Severity, Category } from "./hardware-errors-enums.mjs";
+export const LEDGER_ERROR_MAPPINGS = {
+    '0x9000': {
+        code: ErrorCode.Success,
+        message: 'Operation successful',
+        severity: Severity.Info,
+        category: Category.Success,
+    },
+    '0x6300': {
+        code: ErrorCode.AuthenticationFailed,
+        message: 'Authentication failed',
+        severity: Severity.Err,
+        category: Category.Authentication,
+        userMessage: 'Authentication failed. Please verify your credentials.',
+    },
+    '0x63c0': {
+        code: ErrorCode.AuthenticationPinAttemptsRemaining,
+        message: 'PIN attempts remaining',
+        severity: Severity.Warning,
+        category: Category.Authentication,
+        userMessage: 'Incorrect PIN. Please try again.',
+    },
+    '0x6982': {
+        code: ErrorCode.AuthenticationSecurityCondition,
+        message: 'Security conditions not satisfied',
+        severity: Severity.Err,
+        category: Category.Authentication,
+        userMessage: 'Device is locked or access rights are insufficient. Please unlock your device.',
+    },
+    '0x6985': {
+        code: ErrorCode.UserRejected,
+        message: 'User rejected action on device',
+        severity: Severity.Warning,
+        category: Category.UserAction,
+        userMessage: 'Transaction was rejected. Please approve on your device to continue.',
+    },
+    '0x9804': {
+        code: ErrorCode.AuthenticationSecurityCondition,
+        message: 'App update required',
+        severity: Severity.Err,
+        category: Category.Authentication,
+        userMessage: 'Please update your Ledger app to continue.',
+    },
+    '0x9808': {
+        code: ErrorCode.AuthenticationFailed,
+        message: 'Contradiction in secret code status',
+        severity: Severity.Err,
+        category: Category.Authentication,
+    },
+    '0x9840': {
+        code: ErrorCode.AuthenticationDeviceBlocked,
+        message: 'Code blocked',
+        severity: Severity.Critical,
+        category: Category.Authentication,
+        userMessage: 'Your device is blocked due to too many failed attempts. Please follow device recovery procedures.',
+    },
+    '0x650f': {
+        code: ErrorCode.ConnectionClosed,
+        message: 'App closed or connection issue',
+        severity: Severity.Err,
+        category: Category.Connection,
+        userMessage: 'Connection lost or app closed. Please open the corresponding app on your Ledger device.',
+    },
+    '0x5515': {
+        code: ErrorCode.AuthenticationDeviceLocked,
+        message: 'Device is locked',
+        severity: Severity.Err,
+        category: Category.Authentication,
+        userMessage: 'Please unlock your Ledger device to continue.',
+    },
+    '0x5501': {
+        code: ErrorCode.UserRejected,
+        message: 'User refused on device',
+        severity: Severity.Warning,
+        category: Category.UserAction,
+        userMessage: 'Operation was rejected. Please approve on your device to continue.',
+    },
+    '0x6a80': {
+        code: ErrorCode.DeviceStateBlindSignNotSupported,
+        message: 'Blind signing not supported',
+        severity: Severity.Err,
+        category: Category.DeviceState,
+        userMessage: 'Blind signing is not supported on this device.',
+    },
+    '0x6d00': {
+        code: ErrorCode.DeviceStateOnlyV4Supported,
+        message: 'Ledger Only V4 supported',
+        severity: Severity.Err,
+        category: Category.DeviceState,
+        userMessage: 'Only V4 is supported on this device.',
+    },
+    '0x6e00': {
+        code: ErrorCode.DeviceStateEthAppClosed,
+        message: 'Ethereum app closed',
+        severity: Severity.Err,
+        category: Category.DeviceState,
+        userMessage: 'Ethereum app is closed. Please open it to continue.',
+    },
+    '0x6501': {
+        code: ErrorCode.DeviceStateEthAppOutOfDate,
+        message: 'Ethereum app out of date',
+        severity: Severity.Err,
+        category: Category.DeviceState,
+        userMessage: 'Ethereum app is out of date. Please update it to continue.',
+    },
+};
+export const BLE_ERROR_MAPPINGS = {
+    BLUETOOTH_PERMISSION_DENIED: {
+        code: ErrorCode.PermissionBluetoothDenied,
+        message: 'Bluetooth permission denied',
+        severity: Severity.Err,
+        category: Category.Configuration,
+        userMessage: 'Bluetooth permission is required to connect to your hardware wallet. Please enable it in your device settings.',
+    },
+    LOCATION_PERMISSION_DENIED: {
+        code: ErrorCode.PermissionLocationDenied,
+        message: 'Location permission denied',
+        severity: Severity.Err,
+        category: Category.Configuration,
+        userMessage: 'Location permission is required for Bluetooth scanning on Android. Please enable it in your device settings.',
+    },
+    NEARBY_DEVICES_PERMISSION_DENIED: {
+        code: ErrorCode.PermissionNearbyDevicesDenied,
+        message: 'Nearby devices permission denied',
+        severity: Severity.Err,
+        category: Category.Configuration,
+        userMessage: 'Nearby devices permission is required to scan for your hardware wallet. Please enable it in your device settings.',
+    },
+    BLUETOOTH_DISABLED: {
+        code: ErrorCode.BluetoothDisabled,
+        message: 'Bluetooth is turned off',
+        severity: Severity.Warning,
+        category: Category.Connection,
+        userMessage: 'Bluetooth is turned off. Please enable Bluetooth to connect to your hardware wallet.',
+    },
+    BLUETOOTH_SCAN_FAILED: {
+        code: ErrorCode.BluetoothScanFailed,
+        message: 'Bluetooth scanning failed',
+        severity: Severity.Err,
+        category: Category.Connection,
+        userMessage: 'Unable to scan for Bluetooth devices. Please try again.',
+    },
+    BLUETOOTH_CONNECTION_FAILED: {
+        code: ErrorCode.BluetoothConnectionFailed,
+        message: 'Bluetooth connection failed',
+        severity: Severity.Err,
+        category: Category.Connection,
+        userMessage: 'Failed to connect via Bluetooth. Please make sure your device is nearby and try again.',
+    },
+};
+export const MOBILE_ERROR_MAPPINGS = {
+    NOT_SUPPORTED: {
+        code: ErrorCode.MobileNotSupported,
+        message: 'Operation not supported on mobile',
+        severity: Severity.Err,
+        category: Category.DeviceState,
+        userMessage: 'This operation is not supported on mobile devices.',
+    },
+};
+//# sourceMappingURL=hardware-error-mappings.mjs.map

package/dist/hardware-error-mappings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-error-mappings.mjs","sourceRoot":"","sources":["../src/hardware-error-mappings.ts"],"names":[],"mappings":"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","sourcesContent":["import { ErrorCode, Severity, Category } from './hardware-errors-enums';\n\nexport const LEDGER_ERROR_MAPPINGS = {\n  '0x9000': {\n    code: ErrorCode.Success,\n    message: 'Operation successful',\n    severity: Severity.Info,\n    category: Category.Success,\n  },\n  '0x6300': {\n    code: ErrorCode.AuthenticationFailed,\n    message: 'Authentication failed',\n    severity: Severity.Err,\n    category: Category.Authentication,\n    userMessage: 'Authentication failed. Please verify your credentials.',\n  },\n  '0x63c0': {\n    code: ErrorCode.AuthenticationPinAttemptsRemaining,\n    message: 'PIN attempts remaining',\n    severity: Severity.Warning,\n    category: Category.Authentication,\n    userMessage: 'Incorrect PIN. Please try again.',\n  },\n  '0x6982': {\n    code: ErrorCode.AuthenticationSecurityCondition,\n    message: 'Security conditions not satisfied',\n    severity: Severity.Err,\n    category: Category.Authentication,\n\n    userMessage:\n      'Device is locked or access rights are insufficient. Please unlock your device.',\n  },\n  '0x6985': {\n    code: ErrorCode.UserRejected,\n    message: 'User rejected action on device',\n    severity: Severity.Warning,\n    category: Category.UserAction,\n\n    userMessage:\n      'Transaction was rejected. Please approve on your device to continue.',\n  },\n  '0x9804': {\n    code: ErrorCode.AuthenticationSecurityCondition,\n    message: 'App update required',\n    severity: Severity.Err,\n    category: Category.Authentication,\n\n    userMessage: 'Please update your Ledger app to continue.',\n  },\n  '0x9808': {\n    code: ErrorCode.AuthenticationFailed,\n    message: 'Contradiction in secret code status',\n    severity: Severity.Err,\n    category: Category.Authentication,\n  },\n  '0x9840': {\n    code: ErrorCode.AuthenticationDeviceBlocked,\n    message: 'Code blocked',\n    severity: Severity.Critical,\n    category: Category.Authentication,\n\n    userMessage:\n      'Your device is blocked due to too many failed attempts. Please follow device recovery procedures.',\n  },\n  '0x650f': {\n    code: ErrorCode.ConnectionClosed,\n    message: 'App closed or connection issue',\n    severity: Severity.Err,\n    category: Category.Connection,\n    userMessage:\n      'Connection lost or app closed. Please open the corresponding app on your Ledger device.',\n  },\n  '0x5515': {\n    code: ErrorCode.AuthenticationDeviceLocked,\n    message: 'Device is locked',\n    severity: Severity.Err,\n    category: Category.Authentication,\n    userMessage: 'Please unlock your Ledger device to continue.',\n  },\n  '0x5501': {\n    code: ErrorCode.UserRejected,\n    message: 'User refused on device',\n    severity: Severity.Warning,\n    category: Category.UserAction,\n    userMessage:\n      'Operation was rejected. Please approve on your device to continue.',\n  },\n  '0x6a80': {\n    code: ErrorCode.DeviceStateBlindSignNotSupported,\n    message: 'Blind signing not supported',\n    severity: Severity.Err,\n    category: Category.DeviceState,\n    userMessage: 'Blind signing is not supported on this device.',\n  },\n  '0x6d00': {\n    code: ErrorCode.DeviceStateOnlyV4Supported,\n    message: 'Ledger Only V4 supported',\n    severity: Severity.Err,\n    category: Category.DeviceState,\n    userMessage: 'Only V4 is supported on this device.',\n  },\n  '0x6e00': {\n    code: ErrorCode.DeviceStateEthAppClosed,\n    message: 'Ethereum app closed',\n    severity: Severity.Err,\n    category: Category.DeviceState,\n    userMessage: 'Ethereum app is closed. Please open it to continue.',\n  },\n  '0x6501': {\n    code: ErrorCode.DeviceStateEthAppOutOfDate,\n    message: 'Ethereum app out of date',\n    severity: Severity.Err,\n    category: Category.DeviceState,\n    userMessage: 'Ethereum app is out of date. Please update it to continue.',\n  },\n};\n\nexport const BLE_ERROR_MAPPINGS = {\n  BLUETOOTH_PERMISSION_DENIED: {\n    code: ErrorCode.PermissionBluetoothDenied,\n    message: 'Bluetooth permission denied',\n    severity: Severity.Err,\n    category: Category.Configuration,\n    userMessage:\n      'Bluetooth permission is required to connect to your hardware wallet. Please enable it in your device settings.',\n  },\n  LOCATION_PERMISSION_DENIED: {\n    code: ErrorCode.PermissionLocationDenied,\n    message: 'Location permission denied',\n    severity: Severity.Err,\n    category: Category.Configuration,\n    userMessage:\n      'Location permission is required for Bluetooth scanning on Android. Please enable it in your device settings.',\n  },\n  NEARBY_DEVICES_PERMISSION_DENIED: {\n    code: ErrorCode.PermissionNearbyDevicesDenied,\n    message: 'Nearby devices permission denied',\n    severity: Severity.Err,\n    category: Category.Configuration,\n    userMessage:\n      'Nearby devices permission is required to scan for your hardware wallet. Please enable it in your device settings.',\n  },\n  BLUETOOTH_DISABLED: {\n    code: ErrorCode.BluetoothDisabled,\n    message: 'Bluetooth is turned off',\n    severity: Severity.Warning,\n    category: Category.Connection,\n    userMessage:\n      'Bluetooth is turned off. Please enable Bluetooth to connect to your hardware wallet.',\n  },\n  BLUETOOTH_SCAN_FAILED: {\n    code: ErrorCode.BluetoothScanFailed,\n    message: 'Bluetooth scanning failed',\n    severity: Severity.Err,\n    category: Category.Connection,\n    userMessage: 'Unable to scan for Bluetooth devices. Please try again.',\n  },\n  BLUETOOTH_CONNECTION_FAILED: {\n    code: ErrorCode.BluetoothConnectionFailed,\n    message: 'Bluetooth connection failed',\n    severity: Severity.Err,\n    category: Category.Connection,\n    userMessage:\n      'Failed to connect via Bluetooth. Please make sure your device is nearby and try again.',\n  },\n};\n\nexport const MOBILE_ERROR_MAPPINGS = {\n  NOT_SUPPORTED: {\n    code: ErrorCode.MobileNotSupported,\n    message: 'Operation not supported on mobile',\n    severity: Severity.Err,\n    category: Category.DeviceState,\n    userMessage: 'This operation is not supported on mobile devices.',\n  },\n};\n"]}

package/dist/hardware-error.cjs

@@ -0,0 +1,142 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _HardwareWalletError_instances, _HardwareWalletError_getErrorPrefix;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HardwareWalletError = void 0;
+const hardware_errors_enums_1 = require("./hardware-errors-enums.cjs");
+/**
+ * Generates a unique error ID using timestamp and random values.
+ *
+ * @returns A unique error ID string.
+ */
+function generateErrorId() {
+    const timestamp = Date.now().toString(36);
+    // Random string will be formatted as: 0.fa4dmg7flr8, so we skip 0. part.
+    const randomPart = Math.random().toString(36).substring(2, 9);
+    return `err_${timestamp}_${randomPart}`;
+}
+/**
+ * Gets the human-readable name for an error code using enum reverse mapping.
+ *
+ * @param code - The error code enum value.
+ * @returns The string name of the error code, or 'Unknown' if not found.
+ */
+function getErrorCodeName(code) {
+    // Numeric enums have a reverse mapping at runtime: ErrorCode[1000] => "AuthFailed"
+    return hardware_errors_enums_1.ErrorCode[code] ?? hardware_errors_enums_1.ErrorCode[hardware_errors_enums_1.ErrorCode.Unknown];
+}
+class HardwareWalletError extends Error {
+    constructor(message, options) {
+        super(message);
+        _HardwareWalletError_instances.add(this);
+        this.name = 'HardwareWalletError';
+        this.id = generateErrorId();
+        this.code = options.code;
+        this.severity = options.severity;
+        this.category = options.category;
+        this.userMessage = options.userMessage;
+        this.timestamp = new Date();
+        this.metadata = options.metadata;
+        this.cause = options.cause;
+    }
+    /**
+     * Checks if this error is critical.
+     *
+     * @returns True if the error is critical, false otherwise.
+     */
+    isCritical() {
+        return this.severity === hardware_errors_enums_1.Severity.Critical;
+    }
+    /**
+     * Checks if this error is a warning.
+     *
+     * @returns True if the error is a warning, false otherwise.
+     */
+    isWarning() {
+        return this.severity === hardware_errors_enums_1.Severity.Warning;
+    }
+    /**
+     * Creates a new error instance with additional metadata.
+     *
+     * @param additionalMetadata - Additional metadata to merge with existing metadata.
+     * @returns A new HardwareWalletError instance with merged metadata.
+     */
+    withMetadata(additionalMetadata) {
+        const options = {
+            code: this.code,
+            severity: this.severity,
+            category: this.category,
+            userMessage: this.userMessage,
+            metadata: { ...(this.metadata ?? {}), ...additionalMetadata },
+        };
+        if (this.cause !== undefined) {
+            options.cause = this.cause;
+        }
+        return new HardwareWalletError(this.message, options);
+    }
+    /**
+     * Serializes the error to a JSON-compatible object.
+     * Note: The cause property is serialized if it exists.
+     *
+     * @returns A JSON-compatible object representation of the error.
+     */
+    toJSON() {
+        const json = {
+            id: this.id,
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            severity: this.severity,
+            category: this.category,
+            userMessage: this.userMessage,
+            timestamp: this.timestamp.toISOString(),
+            metadata: this.metadata,
+        };
+        if (this.cause !== undefined) {
+            json.cause = {
+                name: this.cause.name,
+                message: this.cause.message,
+            };
+        }
+        return json;
+    }
+    /**
+     * Returns a user-friendly string representation of the error.
+     *
+     * @returns A user-friendly string representation of the error.
+     */
+    toString() {
+        return `${__classPrivateFieldGet(this, _HardwareWalletError_instances, "m", _HardwareWalletError_getErrorPrefix).call(this)}: ${this.message}`;
+    }
+    /**
+     * Returns a detailed string representation for debugging.
+     *
+     * @returns A detailed string representation of the error for debugging.
+     */
+    toDetailedString() {
+        const details = [
+            this.toString(),
+            `User Message: ${this.userMessage}`,
+            `Severity: ${this.severity}`,
+            `Category: ${this.category}`,
+            `Timestamp: ${this.timestamp.toISOString()}`,
+        ];
+        if (this.metadata && Object.keys(this.metadata).length > 0) {
+            details.push(`Metadata: ${JSON.stringify(this.metadata, null, 2)}`);
+        }
+        if (this.cause !== undefined) {
+            details.push(`Caused by: ${this.cause.message}`);
+        }
+        return details.join('\n');
+    }
+}
+exports.HardwareWalletError = HardwareWalletError;
+_HardwareWalletError_instances = new WeakSet(), _HardwareWalletError_getErrorPrefix = function _HardwareWalletError_getErrorPrefix() {
+    const codeName = getErrorCodeName(this.code);
+    return `${this.name} [${codeName}:${this.code}]`;
+};
+//# sourceMappingURL=hardware-error.cjs.map

package/dist/hardware-error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-error.cjs","sourceRoot":"","sources":["../src/hardware-error.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Category } from './hardware-errors-enums';\nimport { ErrorCode, Severity } from './hardware-errors-enums';\n\n/**\n * Generates a unique error ID using timestamp and random values.\n *\n * @returns A unique error ID string.\n */\nfunction generateErrorId(): string {\n  const timestamp = Date.now().toString(36);\n  // Random string will be formatted as: 0.fa4dmg7flr8, so we skip 0. part.\n  const randomPart = Math.random().toString(36).substring(2, 9);\n  return `err_${timestamp}_${randomPart}`;\n}\n\n/**\n * Gets the human-readable name for an error code using enum reverse mapping.\n *\n * @param code - The error code enum value.\n * @returns The string name of the error code, or 'Unknown' if not found.\n */\nfunction getErrorCodeName(code: ErrorCode): string {\n  // Numeric enums have a reverse mapping at runtime: ErrorCode[1000] => \"AuthFailed\"\n  return ErrorCode[code] ?? ErrorCode[ErrorCode.Unknown];\n}\n\nexport type HardwareWalletErrorOptions = {\n  code: ErrorCode;\n  severity: Severity;\n  category: Category;\n  userMessage: string;\n  cause?: Error;\n  metadata?: Record<string, unknown>;\n};\n\nexport class HardwareWalletError extends Error {\n  public readonly id: string;\n\n  public readonly code: ErrorCode;\n\n  public readonly severity: Severity;\n\n  public readonly category: Category;\n\n  public readonly userMessage: string;\n\n  public readonly timestamp: Date;\n\n  public readonly metadata: Record<string, unknown> | undefined;\n\n  public readonly cause: Error | undefined;\n\n  constructor(message: string, options: HardwareWalletErrorOptions) {\n    super(message);\n    this.name = 'HardwareWalletError';\n    this.id = generateErrorId();\n    this.code = options.code;\n    this.severity = options.severity;\n    this.category = options.category;\n    this.userMessage = options.userMessage;\n    this.timestamp = new Date();\n    this.metadata = options.metadata;\n    this.cause = options.cause;\n  }\n\n  /**\n   * Checks if this error is critical.\n   *\n   * @returns True if the error is critical, false otherwise.\n   */\n  isCritical(): boolean {\n    return this.severity === Severity.Critical;\n  }\n\n  /**\n   * Checks if this error is a warning.\n   *\n   * @returns True if the error is a warning, false otherwise.\n   */\n  isWarning(): boolean {\n    return this.severity === Severity.Warning;\n  }\n\n  /**\n   * Creates a new error instance with additional metadata.\n   *\n   * @param additionalMetadata - Additional metadata to merge with existing metadata.\n   * @returns A new HardwareWalletError instance with merged metadata.\n   */\n  withMetadata(\n    additionalMetadata: Record<string, unknown>,\n  ): HardwareWalletError {\n    const options: HardwareWalletErrorOptions = {\n      code: this.code,\n      severity: this.severity,\n      category: this.category,\n      userMessage: this.userMessage,\n      metadata: { ...(this.metadata ?? {}), ...additionalMetadata },\n    };\n\n    if (this.cause !== undefined) {\n      options.cause = this.cause;\n    }\n\n    return new HardwareWalletError(this.message, options);\n  }\n\n  /**\n   * Serializes the error to a JSON-compatible object.\n   * Note: The cause property is serialized if it exists.\n   *\n   * @returns A JSON-compatible object representation of the error.\n   */\n  toJSON(): Record<string, unknown> {\n    const json: Record<string, unknown> = {\n      id: this.id,\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      severity: this.severity,\n      category: this.category,\n      userMessage: this.userMessage,\n      timestamp: this.timestamp.toISOString(),\n      metadata: this.metadata,\n    };\n\n    if (this.cause !== undefined) {\n      json.cause = {\n        name: this.cause.name,\n        message: this.cause.message,\n      };\n    }\n\n    return json;\n  }\n\n  /**\n   * Returns a user-friendly string representation of the error.\n   *\n   * @returns A user-friendly string representation of the error.\n   */\n  toString(): string {\n    return `${this.#getErrorPrefix()}: ${this.message}`;\n  }\n\n  /**\n   * Returns a detailed string representation for debugging.\n   *\n   * @returns A detailed string representation of the error for debugging.\n   */\n  toDetailedString(): string {\n    const details = [\n      this.toString(),\n      `User Message: ${this.userMessage}`,\n      `Severity: ${this.severity}`,\n      `Category: ${this.category}`,\n      `Timestamp: ${this.timestamp.toISOString()}`,\n    ];\n\n    if (this.metadata && Object.keys(this.metadata).length > 0) {\n      details.push(`Metadata: ${JSON.stringify(this.metadata, null, 2)}`);\n    }\n\n    if (this.cause !== undefined) {\n      details.push(`Caused by: ${this.cause.message}`);\n    }\n\n    return details.join('\\n');\n  }\n\n  #getErrorPrefix(): string {\n    const codeName = getErrorCodeName(this.code);\n    return `${this.name} [${codeName}:${this.code}]`;\n  }\n}\n"]}

package/dist/hardware-error.d.cts

@@ -0,0 +1,61 @@
+import type { Category } from "./hardware-errors-enums.cjs";
+import { ErrorCode, Severity } from "./hardware-errors-enums.cjs";
+export type HardwareWalletErrorOptions = {
+    code: ErrorCode;
+    severity: Severity;
+    category: Category;
+    userMessage: string;
+    cause?: Error;
+    metadata?: Record<string, unknown>;
+};
+export declare class HardwareWalletError extends Error {
+    #private;
+    readonly id: string;
+    readonly code: ErrorCode;
+    readonly severity: Severity;
+    readonly category: Category;
+    readonly userMessage: string;
+    readonly timestamp: Date;
+    readonly metadata: Record<string, unknown> | undefined;
+    readonly cause: Error | undefined;
+    constructor(message: string, options: HardwareWalletErrorOptions);
+    /**
+     * Checks if this error is critical.
+     *
+     * @returns True if the error is critical, false otherwise.
+     */
+    isCritical(): boolean;
+    /**
+     * Checks if this error is a warning.
+     *
+     * @returns True if the error is a warning, false otherwise.
+     */
+    isWarning(): boolean;
+    /**
+     * Creates a new error instance with additional metadata.
+     *
+     * @param additionalMetadata - Additional metadata to merge with existing metadata.
+     * @returns A new HardwareWalletError instance with merged metadata.
+     */
+    withMetadata(additionalMetadata: Record<string, unknown>): HardwareWalletError;
+    /**
+     * Serializes the error to a JSON-compatible object.
+     * Note: The cause property is serialized if it exists.
+     *
+     * @returns A JSON-compatible object representation of the error.
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Returns a user-friendly string representation of the error.
+     *
+     * @returns A user-friendly string representation of the error.
+     */
+    toString(): string;
+    /**
+     * Returns a detailed string representation for debugging.
+     *
+     * @returns A detailed string representation of the error for debugging.
+     */
+    toDetailedString(): string;
+}
+//# sourceMappingURL=hardware-error.d.cts.map

package/dist/hardware-error.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-error.d.cts","sourceRoot":"","sources":["../src/hardware-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,oCAAgC;AACxD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,oCAAgC;AAyB9D,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,KAAK;;IAC5C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,SAAgB,SAAS,EAAE,IAAI,CAAC;IAEhC,SAAgB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAE9D,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B;IAahE;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;OAKG;IACH,YAAY,CACV,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IAgBtB;;;;;OAKG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuBjC;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;CAwB3B"}

package/dist/hardware-error.d.mts

@@ -0,0 +1,61 @@
+import type { Category } from "./hardware-errors-enums.mjs";
+import { ErrorCode, Severity } from "./hardware-errors-enums.mjs";
+export type HardwareWalletErrorOptions = {
+    code: ErrorCode;
+    severity: Severity;
+    category: Category;
+    userMessage: string;
+    cause?: Error;
+    metadata?: Record<string, unknown>;
+};
+export declare class HardwareWalletError extends Error {
+    #private;
+    readonly id: string;
+    readonly code: ErrorCode;
+    readonly severity: Severity;
+    readonly category: Category;
+    readonly userMessage: string;
+    readonly timestamp: Date;
+    readonly metadata: Record<string, unknown> | undefined;
+    readonly cause: Error | undefined;
+    constructor(message: string, options: HardwareWalletErrorOptions);
+    /**
+     * Checks if this error is critical.
+     *
+     * @returns True if the error is critical, false otherwise.
+     */
+    isCritical(): boolean;
+    /**
+     * Checks if this error is a warning.
+     *
+     * @returns True if the error is a warning, false otherwise.
+     */
+    isWarning(): boolean;
+    /**
+     * Creates a new error instance with additional metadata.
+     *
+     * @param additionalMetadata - Additional metadata to merge with existing metadata.
+     * @returns A new HardwareWalletError instance with merged metadata.
+     */
+    withMetadata(additionalMetadata: Record<string, unknown>): HardwareWalletError;
+    /**
+     * Serializes the error to a JSON-compatible object.
+     * Note: The cause property is serialized if it exists.
+     *
+     * @returns A JSON-compatible object representation of the error.
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Returns a user-friendly string representation of the error.
+     *
+     * @returns A user-friendly string representation of the error.
+     */
+    toString(): string;
+    /**
+     * Returns a detailed string representation for debugging.
+     *
+     * @returns A detailed string representation of the error for debugging.
+     */
+    toDetailedString(): string;
+}
+//# sourceMappingURL=hardware-error.d.mts.map

package/dist/hardware-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-error.d.mts","sourceRoot":"","sources":["../src/hardware-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,oCAAgC;AACxD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,oCAAgC;AAyB9D,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,KAAK;;IAC5C,SAAgB,EAAE,EAAE,MAAM,CAAC;IAE3B,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,SAAgB,SAAS,EAAE,IAAI,CAAC;IAEhC,SAAgB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAE9D,SAAgB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B;IAahE;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;OAKG;IACH,YAAY,CACV,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,mBAAmB;IAgBtB;;;;;OAKG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuBjC;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;CAwB3B"}

package/dist/hardware-error.mjs

@@ -0,0 +1,138 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _HardwareWalletError_instances, _HardwareWalletError_getErrorPrefix;
+import { ErrorCode, Severity } from "./hardware-errors-enums.mjs";
+/**
+ * Generates a unique error ID using timestamp and random values.
+ *
+ * @returns A unique error ID string.
+ */
+function generateErrorId() {
+    const timestamp = Date.now().toString(36);
+    // Random string will be formatted as: 0.fa4dmg7flr8, so we skip 0. part.
+    const randomPart = Math.random().toString(36).substring(2, 9);
+    return `err_${timestamp}_${randomPart}`;
+}
+/**
+ * Gets the human-readable name for an error code using enum reverse mapping.
+ *
+ * @param code - The error code enum value.
+ * @returns The string name of the error code, or 'Unknown' if not found.
+ */
+function getErrorCodeName(code) {
+    // Numeric enums have a reverse mapping at runtime: ErrorCode[1000] => "AuthFailed"
+    return ErrorCode[code] ?? ErrorCode[ErrorCode.Unknown];
+}
+export class HardwareWalletError extends Error {
+    constructor(message, options) {
+        super(message);
+        _HardwareWalletError_instances.add(this);
+        this.name = 'HardwareWalletError';
+        this.id = generateErrorId();
+        this.code = options.code;
+        this.severity = options.severity;
+        this.category = options.category;
+        this.userMessage = options.userMessage;
+        this.timestamp = new Date();
+        this.metadata = options.metadata;
+        this.cause = options.cause;
+    }
+    /**
+     * Checks if this error is critical.
+     *
+     * @returns True if the error is critical, false otherwise.
+     */
+    isCritical() {
+        return this.severity === Severity.Critical;
+    }
+    /**
+     * Checks if this error is a warning.
+     *
+     * @returns True if the error is a warning, false otherwise.
+     */
+    isWarning() {
+        return this.severity === Severity.Warning;
+    }
+    /**
+     * Creates a new error instance with additional metadata.
+     *
+     * @param additionalMetadata - Additional metadata to merge with existing metadata.
+     * @returns A new HardwareWalletError instance with merged metadata.
+     */
+    withMetadata(additionalMetadata) {
+        const options = {
+            code: this.code,
+            severity: this.severity,
+            category: this.category,
+            userMessage: this.userMessage,
+            metadata: { ...(this.metadata ?? {}), ...additionalMetadata },
+        };
+        if (this.cause !== undefined) {
+            options.cause = this.cause;
+        }
+        return new HardwareWalletError(this.message, options);
+    }
+    /**
+     * Serializes the error to a JSON-compatible object.
+     * Note: The cause property is serialized if it exists.
+     *
+     * @returns A JSON-compatible object representation of the error.
+     */
+    toJSON() {
+        const json = {
+            id: this.id,
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            severity: this.severity,
+            category: this.category,
+            userMessage: this.userMessage,
+            timestamp: this.timestamp.toISOString(),
+            metadata: this.metadata,
+        };
+        if (this.cause !== undefined) {
+            json.cause = {
+                name: this.cause.name,
+                message: this.cause.message,
+            };
+        }
+        return json;
+    }
+    /**
+     * Returns a user-friendly string representation of the error.
+     *
+     * @returns A user-friendly string representation of the error.
+     */
+    toString() {
+        return `${__classPrivateFieldGet(this, _HardwareWalletError_instances, "m", _HardwareWalletError_getErrorPrefix).call(this)}: ${this.message}`;
+    }
+    /**
+     * Returns a detailed string representation for debugging.
+     *
+     * @returns A detailed string representation of the error for debugging.
+     */
+    toDetailedString() {
+        const details = [
+            this.toString(),
+            `User Message: ${this.userMessage}`,
+            `Severity: ${this.severity}`,
+            `Category: ${this.category}`,
+            `Timestamp: ${this.timestamp.toISOString()}`,
+        ];
+        if (this.metadata && Object.keys(this.metadata).length > 0) {
+            details.push(`Metadata: ${JSON.stringify(this.metadata, null, 2)}`);
+        }
+        if (this.cause !== undefined) {
+            details.push(`Caused by: ${this.cause.message}`);
+        }
+        return details.join('\n');
+    }
+}
+_HardwareWalletError_instances = new WeakSet(), _HardwareWalletError_getErrorPrefix = function _HardwareWalletError_getErrorPrefix() {
+    const codeName = getErrorCodeName(this.code);
+    return `${this.name} [${codeName}:${this.code}]`;
+};
+//# sourceMappingURL=hardware-error.mjs.map

package/dist/hardware-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware-error.mjs","sourceRoot":"","sources":["../src/hardware-error.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Category } from './hardware-errors-enums';\nimport { ErrorCode, Severity } from './hardware-errors-enums';\n\n/**\n * Generates a unique error ID using timestamp and random values.\n *\n * @returns A unique error ID string.\n */\nfunction generateErrorId(): string {\n  const timestamp = Date.now().toString(36);\n  // Random string will be formatted as: 0.fa4dmg7flr8, so we skip 0. part.\n  const randomPart = Math.random().toString(36).substring(2, 9);\n  return `err_${timestamp}_${randomPart}`;\n}\n\n/**\n * Gets the human-readable name for an error code using enum reverse mapping.\n *\n * @param code - The error code enum value.\n * @returns The string name of the error code, or 'Unknown' if not found.\n */\nfunction getErrorCodeName(code: ErrorCode): string {\n  // Numeric enums have a reverse mapping at runtime: ErrorCode[1000] => \"AuthFailed\"\n  return ErrorCode[code] ?? ErrorCode[ErrorCode.Unknown];\n}\n\nexport type HardwareWalletErrorOptions = {\n  code: ErrorCode;\n  severity: Severity;\n  category: Category;\n  userMessage: string;\n  cause?: Error;\n  metadata?: Record<string, unknown>;\n};\n\nexport class HardwareWalletError extends Error {\n  public readonly id: string;\n\n  public readonly code: ErrorCode;\n\n  public readonly severity: Severity;\n\n  public readonly category: Category;\n\n  public readonly userMessage: string;\n\n  public readonly timestamp: Date;\n\n  public readonly metadata: Record<string, unknown> | undefined;\n\n  public readonly cause: Error | undefined;\n\n  constructor(message: string, options: HardwareWalletErrorOptions) {\n    super(message);\n    this.name = 'HardwareWalletError';\n    this.id = generateErrorId();\n    this.code = options.code;\n    this.severity = options.severity;\n    this.category = options.category;\n    this.userMessage = options.userMessage;\n    this.timestamp = new Date();\n    this.metadata = options.metadata;\n    this.cause = options.cause;\n  }\n\n  /**\n   * Checks if this error is critical.\n   *\n   * @returns True if the error is critical, false otherwise.\n   */\n  isCritical(): boolean {\n    return this.severity === Severity.Critical;\n  }\n\n  /**\n   * Checks if this error is a warning.\n   *\n   * @returns True if the error is a warning, false otherwise.\n   */\n  isWarning(): boolean {\n    return this.severity === Severity.Warning;\n  }\n\n  /**\n   * Creates a new error instance with additional metadata.\n   *\n   * @param additionalMetadata - Additional metadata to merge with existing metadata.\n   * @returns A new HardwareWalletError instance with merged metadata.\n   */\n  withMetadata(\n    additionalMetadata: Record<string, unknown>,\n  ): HardwareWalletError {\n    const options: HardwareWalletErrorOptions = {\n      code: this.code,\n      severity: this.severity,\n      category: this.category,\n      userMessage: this.userMessage,\n      metadata: { ...(this.metadata ?? {}), ...additionalMetadata },\n    };\n\n    if (this.cause !== undefined) {\n      options.cause = this.cause;\n    }\n\n    return new HardwareWalletError(this.message, options);\n  }\n\n  /**\n   * Serializes the error to a JSON-compatible object.\n   * Note: The cause property is serialized if it exists.\n   *\n   * @returns A JSON-compatible object representation of the error.\n   */\n  toJSON(): Record<string, unknown> {\n    const json: Record<string, unknown> = {\n      id: this.id,\n      name: this.name,\n      message: this.message,\n      code: this.code,\n      severity: this.severity,\n      category: this.category,\n      userMessage: this.userMessage,\n      timestamp: this.timestamp.toISOString(),\n      metadata: this.metadata,\n    };\n\n    if (this.cause !== undefined) {\n      json.cause = {\n        name: this.cause.name,\n        message: this.cause.message,\n      };\n    }\n\n    return json;\n  }\n\n  /**\n   * Returns a user-friendly string representation of the error.\n   *\n   * @returns A user-friendly string representation of the error.\n   */\n  toString(): string {\n    return `${this.#getErrorPrefix()}: ${this.message}`;\n  }\n\n  /**\n   * Returns a detailed string representation for debugging.\n   *\n   * @returns A detailed string representation of the error for debugging.\n   */\n  toDetailedString(): string {\n    const details = [\n      this.toString(),\n      `User Message: ${this.userMessage}`,\n      `Severity: ${this.severity}`,\n      `Category: ${this.category}`,\n      `Timestamp: ${this.timestamp.toISOString()}`,\n    ];\n\n    if (this.metadata && Object.keys(this.metadata).length > 0) {\n      details.push(`Metadata: ${JSON.stringify(this.metadata, null, 2)}`);\n    }\n\n    if (this.cause !== undefined) {\n      details.push(`Caused by: ${this.cause.message}`);\n    }\n\n    return details.join('\\n');\n  }\n\n  #getErrorPrefix(): string {\n    const codeName = getErrorCodeName(this.code);\n    return `${this.name} [${codeName}:${this.code}]`;\n  }\n}\n"]}