@onekeyfe/hwk-adapter-core 1.1.29 → 1.1.31-alpha.0

package/dist/chunk-BAGEFFFY.js

@@ -0,0 +1,151 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/events/ui-request.ts
+var UI_EVENT = "UI_EVENT";
+var UI_REQUEST = {
+  REQUEST_PIN: "ui-request-pin",
+  REQUEST_PASSPHRASE: "ui-request-passphrase",
+  // One-way UI notification: device is waiting for passphrase entry on-device.
+  // The prompt response path remains RECEIVE_PASSPHRASE with passphraseOnDevice=true.
+  REQUEST_PASSPHRASE_ON_DEVICE: "ui-request-passphrase-on-device",
+  REQUEST_BUTTON: "ui-request-button",
+  REQUEST_QR_DISPLAY: "ui-request-qr-display",
+  REQUEST_QR_SCAN: "ui-request-qr-scan",
+  REQUEST_DEVICE_PERMISSION: "ui-request-device-permission",
+  REQUEST_SELECT_DEVICE: "ui-request-select-device",
+  REQUEST_DEVICE_CONNECT: "ui-request-device-connect",
+  // Ledger BTC App: account index >= 100 requires display=true. Adapter asks
+  // the user once per session before promoting the call.
+  REQUEST_BTC_HIGH_INDEX_CONFIRM: "ui-request-btc-high-index-confirm",
+  // Required app is not installed; with autoInstallApp on, ask the user
+  // whether to install it before retrying the operation.
+  REQUEST_INSTALL_APP: "ui-request-install-app",
+  REQUEST_PREEMPTION: "ui-request-preemption",
+  REQUEST_TREZOR_THP_PAIRING: "ui-request-trezor-thp-pairing",
+  CLOSE_UI_WINDOW: "ui-close",
+  DEVICE_PROGRESS: "ui-device_progress",
+  FIRMWARE_PROGRESS: "ui-firmware-progress",
+  FIRMWARE_TIP: "ui-firmware-tip"
+};
+var UI_RESPONSE = {
+  RECEIVE_PIN: "receive-pin",
+  RECEIVE_PASSPHRASE: "receive-passphrase",
+  RECEIVE_QR_RESPONSE: "receive-qr-response",
+  RECEIVE_SELECT_DEVICE: "receive-select-device",
+  RECEIVE_DEVICE_CONNECT: "receive-device-connect",
+  RECEIVE_DEVICE_PERMISSION: "receive-device-permission",
+  RECEIVE_BTC_HIGH_INDEX_CONFIRM: "receive-btc-high-index-confirm",
+  RECEIVE_INSTALL_APP: "receive-install-app",
+  RECEIVE_PREEMPTION: "receive-preemption",
+  RECEIVE_TREZOR_THP_PAIRING: "receive-trezor-thp-pairing",
+  CANCEL: "cancel"
+};
+
+// src/utils/UiRequestRegistry.ts
+var UI_REQUEST_DEFAULT_TIMEOUT_MS = 6e5;
+var RESPONSE_TO_REQUEST = {
+  [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,
+  [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,
+  [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,
+  [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,
+  [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,
+  [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,
+  [UI_RESPONSE.RECEIVE_INSTALL_APP]: UI_REQUEST.REQUEST_INSTALL_APP,
+  [UI_RESPONSE.RECEIVE_PREEMPTION]: UI_REQUEST.REQUEST_PREEMPTION,
+  [UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING]: UI_REQUEST.REQUEST_TREZOR_THP_PAIRING
+  // RECEIVE_QR_RESPONSE maps to QR_DISPLAY or QR_SCAN — resolved dynamically below.
+};
+var UI_REQUEST_PREEMPTED_TAG = "UiRequestPreempted";
+var UI_REQUEST_CANCELLED_TAG = "UiRequestCancelled";
+var UI_REQUEST_TIMEOUT_TAG = "UiRequestTimeout";
+var UiRequestRegistry = class {
+  constructor() {
+    this.pending = /* @__PURE__ */ new Map();
+  }
+  wait(requestType, options) {
+    const existing = this.pending.get(requestType);
+    if (existing) {
+      clearTimeout(existing.timer);
+      this.pending.delete(requestType);
+      existing.reject(
+        Object.assign(new Error(`UI request '${requestType}' was superseded by a new request`), {
+          _tag: UI_REQUEST_PREEMPTED_TAG
+        })
+      );
+    }
+    const timeoutMs = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.timeoutMs]), () => ( UI_REQUEST_DEFAULT_TIMEOUT_MS));
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        if (_optionalChain([this, 'access', _2 => _2.pending, 'access', _3 => _3.get, 'call', _4 => _4(requestType), 'optionalAccess', _5 => _5.timer]) === timer) {
+          this.pending.delete(requestType);
+          reject(
+            Object.assign(new Error(`UI request '${requestType}' timed out after ${timeoutMs}ms`), {
+              _tag: UI_REQUEST_TIMEOUT_TAG
+            })
+          );
+        }
+      }, timeoutMs);
+      this.pending.set(requestType, {
+        resolve,
+        reject,
+        timer
+      });
+    });
+  }
+  resolve(responseType, payload) {
+    let requestType = RESPONSE_TO_REQUEST[responseType];
+    if (responseType === UI_RESPONSE.RECEIVE_QR_RESPONSE) {
+      if (this.pending.has(UI_REQUEST.REQUEST_QR_DISPLAY)) {
+        requestType = UI_REQUEST.REQUEST_QR_DISPLAY;
+      } else if (this.pending.has(UI_REQUEST.REQUEST_QR_SCAN)) {
+        requestType = UI_REQUEST.REQUEST_QR_SCAN;
+      }
+    }
+    if (!requestType) return;
+    const entry = this.pending.get(requestType);
+    if (!entry) return;
+    clearTimeout(entry.timer);
+    this.pending.delete(requestType);
+    entry.resolve(payload);
+  }
+  cancel(requestType) {
+    if (requestType) {
+      const entry = this.pending.get(requestType);
+      if (!entry) return;
+      clearTimeout(entry.timer);
+      this.pending.delete(requestType);
+      entry.reject(
+        Object.assign(new Error(`UI request '${requestType}' was cancelled`), {
+          _tag: UI_REQUEST_CANCELLED_TAG
+        })
+      );
+      return;
+    }
+    for (const [type, entry] of this.pending) {
+      clearTimeout(entry.timer);
+      entry.reject(
+        Object.assign(new Error(`UI request '${type}' was cancelled`), {
+          _tag: UI_REQUEST_CANCELLED_TAG
+        })
+      );
+    }
+    this.pending.clear();
+  }
+  reset() {
+    this.cancel();
+  }
+  hasPending(requestType) {
+    if (requestType) return this.pending.has(requestType);
+    return this.pending.size > 0;
+  }
+};
+
+
+
+
+
+
+
+
+
+
+exports.UI_EVENT = UI_EVENT; exports.UI_REQUEST = UI_REQUEST; exports.UI_RESPONSE = UI_RESPONSE; exports.UI_REQUEST_DEFAULT_TIMEOUT_MS = UI_REQUEST_DEFAULT_TIMEOUT_MS; exports.UI_REQUEST_PREEMPTED_TAG = UI_REQUEST_PREEMPTED_TAG; exports.UI_REQUEST_CANCELLED_TAG = UI_REQUEST_CANCELLED_TAG; exports.UI_REQUEST_TIMEOUT_TAG = UI_REQUEST_TIMEOUT_TAG; exports.UiRequestRegistry = UiRequestRegistry;
+//# sourceMappingURL=chunk-BAGEFFFY.js.map

package/dist/chunk-BAGEFFFY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-BAGEFFFY.js","../src/events/ui-request.ts","../src/utils/UiRequestRegistry.ts"],"names":[],"mappings":"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","file":"/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-BAGEFFFY.js","sourcesContent":[null,"import type { QrResponseData } from '../types/qr';\n\nexport const UI_EVENT = 'UI_EVENT';\n\nexport const UI_REQUEST = {\n  REQUEST_PIN: 'ui-request-pin',\n  REQUEST_PASSPHRASE: 'ui-request-passphrase',\n  // One-way UI notification: device is waiting for passphrase entry on-device.\n  // The prompt response path remains RECEIVE_PASSPHRASE with passphraseOnDevice=true.\n  REQUEST_PASSPHRASE_ON_DEVICE: 'ui-request-passphrase-on-device',\n  REQUEST_BUTTON: 'ui-request-button',\n  REQUEST_QR_DISPLAY: 'ui-request-qr-display',\n  REQUEST_QR_SCAN: 'ui-request-qr-scan',\n  REQUEST_DEVICE_PERMISSION: 'ui-request-device-permission',\n  REQUEST_SELECT_DEVICE: 'ui-request-select-device',\n  REQUEST_DEVICE_CONNECT: 'ui-request-device-connect',\n  // Ledger BTC App: account index >= 100 requires display=true. Adapter asks\n  // the user once per session before promoting the call.\n  REQUEST_BTC_HIGH_INDEX_CONFIRM: 'ui-request-btc-high-index-confirm',\n  // Required app is not installed; with autoInstallApp on, ask the user\n  // whether to install it before retrying the operation.\n  REQUEST_INSTALL_APP: 'ui-request-install-app',\n  REQUEST_PREEMPTION: 'ui-request-preemption',\n  REQUEST_TREZOR_THP_PAIRING: 'ui-request-trezor-thp-pairing',\n  CLOSE_UI_WINDOW: 'ui-close',\n  DEVICE_PROGRESS: 'ui-device_progress',\n  FIRMWARE_PROGRESS: 'ui-firmware-progress',\n  FIRMWARE_TIP: 'ui-firmware-tip',\n} as const;\n\nexport const UI_RESPONSE = {\n  RECEIVE_PIN: 'receive-pin',\n  RECEIVE_PASSPHRASE: 'receive-passphrase',\n  RECEIVE_QR_RESPONSE: 'receive-qr-response',\n  RECEIVE_SELECT_DEVICE: 'receive-select-device',\n  RECEIVE_DEVICE_CONNECT: 'receive-device-connect',\n  RECEIVE_DEVICE_PERMISSION: 'receive-device-permission',\n  RECEIVE_BTC_HIGH_INDEX_CONFIRM: 'receive-btc-high-index-confirm',\n  RECEIVE_INSTALL_APP: 'receive-install-app',\n  RECEIVE_PREEMPTION: 'receive-preemption',\n  RECEIVE_TREZOR_THP_PAIRING: 'receive-trezor-thp-pairing',\n  CANCEL: 'cancel',\n} as const;\n\nexport type DevicePermissionDeniedReason =\n  | 'bluetoothTurnedOff'\n  | 'permissionDenied'\n  | (string & Record<never, never>);\n\nexport type DevicePermissionResponse = {\n  granted: boolean;\n  reason?: DevicePermissionDeniedReason;\n  message?: string;\n};\n\nexport type UiResponseEvent =\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PIN;\n      payload: string;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PASSPHRASE;\n      payload: {\n        value: string;\n        passphraseOnDevice?: boolean;\n        save?: boolean;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_QR_RESPONSE;\n      payload: QrResponseData;\n    }\n  | {\n      // sdkConnectId echoes one of the DeviceInfo.connectId values emitted in\n      // the REQUEST_SELECT_DEVICE event's `devices` list. Scope is the current\n      // search session; may be ephemeral (e.g. Ledger USB DMK UUID).\n      type: typeof UI_RESPONSE.RECEIVE_SELECT_DEVICE;\n      payload: { sdkConnectId: string };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_CONNECT;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_PERMISSION;\n      payload: DevicePermissionResponse;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_INSTALL_APP;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PREEMPTION;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING;\n      payload: {\n        selectedMethod?: number | string;\n        tag?: string;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.CANCEL;\n      payload?: undefined;\n    };\n","import { UI_REQUEST, UI_RESPONSE } from '../events/ui-request';\n\n/** 10 min — every UI request is human-in-the-loop; bias toward \"wait long\". */\nexport const UI_REQUEST_DEFAULT_TIMEOUT_MS = 600_000;\n\nconst RESPONSE_TO_REQUEST: Record<string, string> = {\n  [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,\n  [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,\n  [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,\n  [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,\n  [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,\n  [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,\n  [UI_RESPONSE.RECEIVE_INSTALL_APP]: UI_REQUEST.REQUEST_INSTALL_APP,\n  [UI_RESPONSE.RECEIVE_PREEMPTION]: UI_REQUEST.REQUEST_PREEMPTION,\n  [UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING]: UI_REQUEST.REQUEST_TREZOR_THP_PAIRING,\n  // RECEIVE_QR_RESPONSE maps to QR_DISPLAY or QR_SCAN — resolved dynamically below.\n};\n\nexport const UI_REQUEST_PREEMPTED_TAG = 'UiRequestPreempted';\nexport const UI_REQUEST_CANCELLED_TAG = 'UiRequestCancelled';\nexport const UI_REQUEST_TIMEOUT_TAG = 'UiRequestTimeout';\n\ntype PendingEntry = {\n  resolve: (payload: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n};\n\n/**\n * Per-type single-slot registry for adapter-level UI requests. A new `wait`\n * of the same type supersedes (rejects) the prior pending entry. With the\n * job queue running globally serially, cross-type collisions don't occur in\n * normal flow — same-type preemption is a defensive measure for callers\n * that fire the same request twice without waiting on the first.\n *\n * Unknown response types are dropped silently so the public `uiResponse`\n * entry never throws.\n */\nexport class UiRequestRegistry {\n  private pending = new Map<string, PendingEntry>();\n\n  wait<T = unknown>(requestType: string, options?: { timeoutMs?: number }): Promise<T> {\n    const existing = this.pending.get(requestType);\n    if (existing) {\n      clearTimeout(existing.timer);\n      this.pending.delete(requestType);\n      existing.reject(\n        Object.assign(new Error(`UI request '${requestType}' was superseded by a new request`), {\n          _tag: UI_REQUEST_PREEMPTED_TAG,\n        })\n      );\n    }\n\n    const timeoutMs = options?.timeoutMs ?? UI_REQUEST_DEFAULT_TIMEOUT_MS;\n\n    return new Promise<T>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        if (this.pending.get(requestType)?.timer === timer) {\n          this.pending.delete(requestType);\n          reject(\n            Object.assign(new Error(`UI request '${requestType}' timed out after ${timeoutMs}ms`), {\n              _tag: UI_REQUEST_TIMEOUT_TAG,\n            })\n          );\n        }\n      }, timeoutMs);\n\n      this.pending.set(requestType, {\n        resolve: resolve as (payload: unknown) => void,\n        reject,\n        timer,\n      });\n    });\n  }\n\n  resolve(responseType: string, payload: unknown): void {\n    let requestType = RESPONSE_TO_REQUEST[responseType];\n    if (responseType === UI_RESPONSE.RECEIVE_QR_RESPONSE) {\n      if (this.pending.has(UI_REQUEST.REQUEST_QR_DISPLAY)) {\n        requestType = UI_REQUEST.REQUEST_QR_DISPLAY;\n      } else if (this.pending.has(UI_REQUEST.REQUEST_QR_SCAN)) {\n        requestType = UI_REQUEST.REQUEST_QR_SCAN;\n      }\n    }\n    if (!requestType) return;\n\n    const entry = this.pending.get(requestType);\n    if (!entry) return;\n\n    clearTimeout(entry.timer);\n    this.pending.delete(requestType);\n    entry.resolve(payload);\n  }\n\n  cancel(requestType?: string): void {\n    if (requestType) {\n      const entry = this.pending.get(requestType);\n      if (!entry) return;\n      clearTimeout(entry.timer);\n      this.pending.delete(requestType);\n      entry.reject(\n        Object.assign(new Error(`UI request '${requestType}' was cancelled`), {\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n      return;\n    }\n\n    for (const [type, entry] of this.pending) {\n      clearTimeout(entry.timer);\n      entry.reject(\n        Object.assign(new Error(`UI request '${type}' was cancelled`), {\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n    }\n    this.pending.clear();\n  }\n\n  reset(): void {\n    this.cancel();\n  }\n\n  hasPending(requestType?: string): boolean {\n    if (requestType) return this.pending.has(requestType);\n    return this.pending.size > 0;\n  }\n}\n"]}

package/dist/chunk-FT3SZP2W.js

@@ -0,0 +1,149 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/types/errors.ts
+var HardwareErrorCode = /* @__PURE__ */ ((HardwareErrorCode2) => {
+  HardwareErrorCode2[HardwareErrorCode2["UnknownError"] = 1e4] = "UnknownError";
+  HardwareErrorCode2[HardwareErrorCode2["UserRejected"] = 10001] = "UserRejected";
+  HardwareErrorCode2[HardwareErrorCode2["InvalidParams"] = 10002] = "InvalidParams";
+  HardwareErrorCode2[HardwareErrorCode2["OperationTimeout"] = 10003] = "OperationTimeout";
+  HardwareErrorCode2[HardwareErrorCode2["MethodNotSupported"] = 10004] = "MethodNotSupported";
+  HardwareErrorCode2[HardwareErrorCode2["UserAborted"] = 10005] = "UserAborted";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceNotFound"] = 10100] = "DeviceNotFound";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceDisconnected"] = 10101] = "DeviceDisconnected";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceBusy"] = 10102] = "DeviceBusy";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceLocked"] = 10103] = "DeviceLocked";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceNotInitialized"] = 10104] = "DeviceNotInitialized";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceInBootloader"] = 10105] = "DeviceInBootloader";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceMismatch"] = 10106] = "DeviceMismatch";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceAppStuck"] = 10107] = "DeviceAppStuck";
+  HardwareErrorCode2[HardwareErrorCode2["ChainNotSupported"] = 10108] = "ChainNotSupported";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceOneDeviceOnly"] = 10109] = "DeviceOneDeviceOnly";
+  HardwareErrorCode2[HardwareErrorCode2["DevicePathForbidden"] = 10110] = "DevicePathForbidden";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceBusyInternal"] = 10111] = "DeviceBusyInternal";
+  HardwareErrorCode2[HardwareErrorCode2["FirmwareTooOld"] = 10200] = "FirmwareTooOld";
+  HardwareErrorCode2[HardwareErrorCode2["FirmwareUpdateRequired"] = 10201] = "FirmwareUpdateRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TransportError"] = 10300] = "TransportError";
+  HardwareErrorCode2[HardwareErrorCode2["BridgeNotFound"] = 10301] = "BridgeNotFound";
+  HardwareErrorCode2[HardwareErrorCode2["TransportNotAvailable"] = 10302] = "TransportNotAvailable";
+  HardwareErrorCode2[HardwareErrorCode2["DevicePermissionDenied"] = 10303] = "DevicePermissionDenied";
+  HardwareErrorCode2[HardwareErrorCode2["BlePairingTimeout"] = 10304] = "BlePairingTimeout";
+  HardwareErrorCode2[HardwareErrorCode2["NetworkError"] = 10305] = "NetworkError";
+  HardwareErrorCode2[HardwareErrorCode2["ThpPairingFailed"] = 10306] = "ThpPairingFailed";
+  HardwareErrorCode2[HardwareErrorCode2["BleBondInvalid"] = 10307] = "BleBondInvalid";
+  HardwareErrorCode2[HardwareErrorCode2["ThpPairingRequired"] = 10308] = "ThpPairingRequired";
+  HardwareErrorCode2[HardwareErrorCode2["BleConnectFailed"] = 10309] = "BleConnectFailed";
+  HardwareErrorCode2[HardwareErrorCode2["PinInvalid"] = 10400] = "PinInvalid";
+  HardwareErrorCode2[HardwareErrorCode2["PinCancelled"] = 10401] = "PinCancelled";
+  HardwareErrorCode2[HardwareErrorCode2["PassphraseRejected"] = 10402] = "PassphraseRejected";
+  HardwareErrorCode2[HardwareErrorCode2["PassphraseStateMismatch"] = 10403] = "PassphraseStateMismatch";
+  HardwareErrorCode2[HardwareErrorCode2["PinMismatch"] = 10404] = "PinMismatch";
+  HardwareErrorCode2[HardwareErrorCode2["AppNotInstalled"] = 10500] = "AppNotInstalled";
+  HardwareErrorCode2[HardwareErrorCode2["WrongApp"] = 10501] = "WrongApp";
+  HardwareErrorCode2[HardwareErrorCode2["AppTooOld"] = 10502] = "AppTooOld";
+  HardwareErrorCode2[HardwareErrorCode2["DeviceOutOfMemory"] = 10503] = "DeviceOutOfMemory";
+  HardwareErrorCode2[HardwareErrorCode2["EvmBlindSigningRequired"] = 11e3] = "EvmBlindSigningRequired";
+  HardwareErrorCode2[HardwareErrorCode2["EvmClearSignPluginMissing"] = 11001] = "EvmClearSignPluginMissing";
+  HardwareErrorCode2[HardwareErrorCode2["EvmDataTooLarge"] = 11002] = "EvmDataTooLarge";
+  HardwareErrorCode2[HardwareErrorCode2["EvmTxTypeNotSupported"] = 11003] = "EvmTxTypeNotSupported";
+  HardwareErrorCode2[HardwareErrorCode2["SolanaBlindSigningRequired"] = 11100] = "SolanaBlindSigningRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TronCustomContractRequired"] = 11200] = "TronCustomContractRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TronDataSigningRequired"] = 11201] = "TronDataSigningRequired";
+  HardwareErrorCode2[HardwareErrorCode2["TronSignByHashRequired"] = 11202] = "TronSignByHashRequired";
+  HardwareErrorCode2[HardwareErrorCode2["BtcWalletPolicyHmacMismatch"] = 11300] = "BtcWalletPolicyHmacMismatch";
+  HardwareErrorCode2[HardwareErrorCode2["BtcUnexpectedState"] = 11301] = "BtcUnexpectedState";
+  return HardwareErrorCode2;
+})(HardwareErrorCode || {});
+var ORPHAN_ELIGIBLE_ERROR_CODES = [
+  10005 /* UserAborted */,
+  10001 /* UserRejected */,
+  10100 /* DeviceNotFound */,
+  10101 /* DeviceDisconnected */,
+  10106 /* DeviceMismatch */,
+  10107 /* DeviceAppStuck */,
+  10109 /* DeviceOneDeviceOnly */,
+  10300 /* TransportError */,
+  10303 /* DevicePermissionDenied */,
+  10304 /* BlePairingTimeout */,
+  10306 /* ThpPairingFailed */,
+  10308 /* ThpPairingRequired */,
+  10307 /* BleBondInvalid */,
+  10309 /* BleConnectFailed */
+];
+function createHwkError(payload) {
+  return Object.assign(new Error(payload.message), {
+    code: payload.code,
+    ...payload._tag !== void 0 && { _tag: payload._tag },
+    ...payload.appName !== void 0 && { appName: payload.appName },
+    ...payload.params !== void 0 && { params: payload.params }
+  });
+}
+
+// src/utils/errorMessages.ts
+function enrichErrorMessage(code, originalMessage) {
+  switch (code) {
+    case 10400 /* PinInvalid */:
+      return `${originalMessage}. Please re-enter your PIN.`;
+    case 10401 /* PinCancelled */:
+      return `${originalMessage}. PIN entry was cancelled.`;
+    case 10404 /* PinMismatch */:
+      return `${originalMessage}. The entered PINs do not match. Please try again.`;
+    case 10102 /* DeviceBusy */:
+      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;
+    case 10111 /* DeviceBusyInternal */:
+      return `${originalMessage}. The device is busy. Please try again in a moment.`;
+    case 10101 /* DeviceDisconnected */:
+      return `${originalMessage}. Please reconnect the device and try again.`;
+    case 10103 /* DeviceLocked */:
+      return `${originalMessage}. Please unlock your device and try again.`;
+    case 10109 /* DeviceOneDeviceOnly */:
+      return `${originalMessage}. Disconnect the extra device and try again.`;
+    case 10001 /* UserRejected */:
+      return `${originalMessage}. The request was rejected on the device.`;
+    case 10501 /* WrongApp */:
+      return `${originalMessage}. Please open the correct app on your device.`;
+    case 10500 /* AppNotInstalled */:
+      return `${originalMessage}. The required app is not installed on the device.`;
+    case 10503 /* DeviceOutOfMemory */:
+      return `${originalMessage}. Not enough free space on the device. Please uninstall some apps and try again.`;
+    case 10302 /* TransportNotAvailable */:
+      return `${originalMessage}. Ensure the device bridge/transport is available and running.`;
+    case 10305 /* NetworkError */:
+      return `${originalMessage}. Network error \u2014 check your internet connection and try again.`;
+    case 10200 /* FirmwareTooOld */:
+      return `${originalMessage}. Please update your device firmware.`;
+    case 10104 /* DeviceNotInitialized */:
+      return `${originalMessage}. The device may need to be set up first.`;
+    case 10003 /* OperationTimeout */:
+      return `${originalMessage}. The operation timed out. Please try again.`;
+    case 11e3 /* EvmBlindSigningRequired */:
+      return "Ledger: Blind signing not enabled in Ethereum app.";
+    case 11001 /* EvmClearSignPluginMissing */:
+      return "Ledger: Required plugin not installed (install via Ledger Live).";
+    case 11002 /* EvmDataTooLarge */:
+      return "Ledger: Transaction data too large for device memory.";
+    case 11003 /* EvmTxTypeNotSupported */:
+      return "Ledger: Transaction type not supported by current Ethereum app.";
+    case 10502 /* AppTooOld */:
+      return "Ledger: App out of date (update via Ledger Live).";
+    case 11100 /* SolanaBlindSigningRequired */:
+      return "Blind signing disabled in the Solana app.";
+    case 11200 /* TronCustomContractRequired */:
+      return "Custom Contracts setting disabled in the Tron app.";
+    case 11201 /* TronDataSigningRequired */:
+      return "Transactions Data setting disabled in the Tron app.";
+    case 11202 /* TronSignByHashRequired */:
+      return "Sign by Hash setting disabled in the Tron app.";
+    case 11300 /* BtcWalletPolicyHmacMismatch */:
+      return "Wallet policy not registered or HMAC mismatch.";
+    case 11301 /* BtcUnexpectedState */:
+      return "Signing aborted due to unexpected device state.";
+    default:
+      return originalMessage;
+  }
+}
+
+
+
+
+
+
+exports.HardwareErrorCode = HardwareErrorCode; exports.ORPHAN_ELIGIBLE_ERROR_CODES = ORPHAN_ELIGIBLE_ERROR_CODES; exports.createHwkError = createHwkError; exports.enrichErrorMessage = enrichErrorMessage;
+//# sourceMappingURL=chunk-FT3SZP2W.js.map

package/dist/chunk-FT3SZP2W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-FT3SZP2W.js","../src/types/errors.ts","../src/utils/errorMessages.ts"],"names":["HardwareErrorCode"],"mappings":"AAAA;ACuBO,IAAK,kBAAA,kBAAL,CAAA,CAAKA,kBAAAA,EAAAA,GAAL;AAEL,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,GAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,eAAA,EAAA,EAAgB,KAAA,EAAA,EAAhB,eAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,kBAAA,EAAA,EAAmB,KAAA,EAAA,EAAnB,kBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,aAAA,EAAA,EAAc,KAAA,EAAA,EAAd,aAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,YAAA,EAAA,EAAa,KAAA,EAAA,EAAb,YAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,sBAAA,EAAA,EAAuB,KAAA,EAAA,EAAvB,sBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,mBAAA,EAAA,EAAoB,KAAA,EAAA,EAApB,mBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,qBAAA,EAAA,EAAsB,KAAA,EAAA,EAAtB,qBAAA;AAOA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,qBAAA,EAAA,EAAsB,KAAA,EAAA,EAAtB,qBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,wBAAA,EAAA,EAAyB,KAAA,EAAA,EAAzB,wBAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,uBAAA,EAAA,EAAwB,KAAA,EAAA,EAAxB,uBAAA;AAMA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,wBAAA,EAAA,EAAyB,KAAA,EAAA,EAAzB,wBAAA;AAQA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,mBAAA,EAAA,EAAoB,KAAA,EAAA,EAApB,mBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AASA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,kBAAA,EAAA,EAAmB,KAAA,EAAA,EAAnB,kBAAA;AAUA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,gBAAA,EAAA,EAAiB,KAAA,EAAA,EAAjB,gBAAA;AAQA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAUA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,kBAAA,EAAA,EAAmB,KAAA,EAAA,EAAnB,kBAAA;AAGA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,YAAA,EAAA,EAAa,KAAA,EAAA,EAAb,YAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,cAAA,EAAA,EAAe,KAAA,EAAA,EAAf,cAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAOA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,yBAAA,EAAA,EAA0B,KAAA,EAAA,EAA1B,yBAAA;AAMA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,aAAA,EAAA,EAAc,KAAA,EAAA,EAAd,aAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,iBAAA,EAAA,EAAkB,KAAA,EAAA,EAAlB,iBAAA;AACA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,UAAA,EAAA,EAAW,KAAA,EAAA,EAAX,UAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,WAAA,EAAA,EAAY,KAAA,EAAA,EAAZ,WAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,mBAAA,EAAA,EAAoB,KAAA,EAAA,EAApB,mBAAA;AAKA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,yBAAA,EAAA,EAA0B,IAAA,EAAA,EAA1B,yBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,2BAAA,EAAA,EAA4B,KAAA,EAAA,EAA5B,2BAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,iBAAA,EAAA,EAAkB,KAAA,EAAA,EAAlB,iBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,uBAAA,EAAA,EAAwB,KAAA,EAAA,EAAxB,uBAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,4BAAA,EAAA,EAA6B,KAAA,EAAA,EAA7B,4BAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,4BAAA,EAAA,EAA6B,KAAA,EAAA,EAA7B,4BAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,yBAAA,EAAA,EAA0B,KAAA,EAAA,EAA1B,yBAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,wBAAA,EAAA,EAAyB,KAAA,EAAA,EAAzB,wBAAA;AAIA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,6BAAA,EAAA,EAA8B,KAAA,EAAA,EAA9B,6BAAA;AAEA,EAAAA,kBAAAA,CAAAA,kBAAAA,CAAA,oBAAA,EAAA,EAAqB,KAAA,EAAA,EAArB,oBAAA;AAtJU,EAAA,OAAAA,kBAAAA;AAAA,CAAA,CAAA,CAAA,kBAAA,GAAA,CAAA,CAAA,CAAA;AAoKL,IAAM,4BAAA,EAAwC;AAAA,EACnD,uBAAA;AAAA,EACA,wBAAA;AAAA,EACA,0BAAA;AAAA,EACA,8BAAA;AAAA,EACA,0BAAA;AAAA,EACA,0BAAA;AAAA,EACA,+BAAA;AAAA,EACA,0BAAA;AAAA,EACA,kCAAA;AAAA,EACA,6BAAA;AAAA,EACA,4BAAA;AAAA,EACA,8BAAA;AAAA,EACA,0BAAA;AAAA,EACA;AACF,CAAA;AA4BO,SAAS,cAAA,CAAe,OAAA,EAAqC;AAClE,EAAA,OAAO,MAAA,CAAO,MAAA,CAAO,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AAAA,IAC/C,IAAA,EAAM,OAAA,CAAQ,IAAA;AAAA,IACd,GAAI,OAAA,CAAQ,KAAA,IAAS,KAAA,EAAA,GAAa,EAAE,IAAA,EAAM,OAAA,CAAQ,KAAK,CAAA;AAAA,IACvD,GAAI,OAAA,CAAQ,QAAA,IAAY,KAAA,EAAA,GAAa,EAAE,OAAA,EAAS,OAAA,CAAQ,QAAQ,CAAA;AAAA,IAChE,GAAI,OAAA,CAAQ,OAAA,IAAW,KAAA,EAAA,GAAa,EAAE,MAAA,EAAQ,OAAA,CAAQ,OAAO;AAAA,EAC/D,CAAC,CAAA;AACH;ADhKA;AACA;AExEO,SAAS,kBAAA,CAAmB,IAAA,EAAyB,eAAA,EAAiC;AAC3F,EAAA,OAAA,CAAQ,IAAA,EAAM;AAAA,IACZ,KAAA,sBAAA;AACE,MAAA,OAAO,CAAA,EAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACT,IAAA;AACS,MAAA;AACX,EAAA;AACF;AF0Ec;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/hardware-js-sdk/hardware-js-sdk/packages/hwk-adapter-core/dist/chunk-FT3SZP2W.js","sourcesContent":[null,"/**\n * HWK HardwareErrorCode — independent namespace from the legacy\n * `@onekeyfe/shared` HardwareErrorCode (which occupies 0-902).\n *\n * All HWK codes are 5-digit (>= 10000) so the two tables never collide\n * even if either side grows. Each sub-category gets a 100-slot block.\n *\n *   10000-10099  Generic / cross-cutting primitives\n *   10100-10199  Device state\n *   10200-10299  Firmware\n *   10300-10399  Transport + OS-level permission\n *   10400-10499  PIN / Passphrase\n *   10500-10599  App lifecycle (wrong app, not open, too old)\n *   10600-10999  RESERVED — future adapter-level categories\n *\n *   11000-11099  EVM APDU (reactive mapping)\n *   11100-11199  Solana APDU\n *   11200-11299  Tron APDU\n *   11300-11399  BTC APDU\n *   11400-11999  RESERVED — future chain APDU blocks (100 per chain)\n *\n *   12000-99999  RESERVED — future major categories\n */\nexport enum HardwareErrorCode {\n  // --- 10000s Generic ---\n  UnknownError = 10000,\n  UserRejected = 10001,\n  InvalidParams = 10002,\n  OperationTimeout = 10003,\n  MethodNotSupported = 10004,\n  /** User dismissed in-app cancel UI. Distinct from UserRejected (on-device). */\n  UserAborted = 10005,\n\n  // --- 10100s Device state ---\n  DeviceNotFound = 10100,\n  DeviceDisconnected = 10101,\n  DeviceBusy = 10102,\n  DeviceLocked = 10103,\n  DeviceNotInitialized = 10104,\n  DeviceInBootloader = 10105,\n  DeviceMismatch = 10106,\n  /** Chain app wedged (e.g. Ledger BTC 0x6901). User must exit app on device. */\n  DeviceAppStuck = 10107,\n  /** Vendor (Ledger / Trezor) doesn't support the chain at all. */\n  ChainNotSupported = 10108,\n  /** Current operation supports only one connected device. */\n  DeviceOneDeviceOnly = 10109,\n  /**\n   * The device rejected the requested derivation path (Trezor Failure_DataError\n   * \"Forbidden key path\") — the path is non-standard or its index is outside the\n   * range the device's safety checks allow. Distinct from ChainNotSupported\n   * (whole chain) and MethodNotSupported (the operation/method itself).\n   */\n  DevicePathForbidden = 10110,\n  /** Busy with our own in-flight request (queue guard / firmware Failure_Busy), not another app — wait and retry, don't close other apps. */\n  DeviceBusyInternal = 10111,\n\n  // --- 10200s Firmware ---\n  FirmwareTooOld = 10200,\n  FirmwareUpdateRequired = 10201,\n\n  // --- 10300s Transport + permission ---\n  TransportError = 10300,\n  BridgeNotFound = 10301,\n  TransportNotAvailable = 10302,\n  /**\n   * OS-level permission (Bluetooth / USB / etc.) — denied, blocked,\n   * unavailable, or dismissed. Consumers surface a single \"please grant\n   * permission\" toast and let the user retry manually.\n   */\n  DevicePermissionDenied = 10303,\n  /**\n   * BLE SMP pairing did not complete within the GATT bonding window.\n   * GATT connected but the device didn't acknowledge SMP — typically\n   * because the user didn't confirm the passkey on the device, or the\n   * device went out of range mid-pairing. Distinct from OperationTimeout\n   * (generic) and from DeviceLocked (Secure Element actually locked).\n   */\n  BlePairingTimeout = 10304,\n  /** Remote network failure reaching a vendor's servers (HTTP/WS). Distinct from TransportError (local USB/BLE link). */\n  NetworkError = 10305,\n  /**\n   * Host-managed pairing handshake failed (Trezor THP). The device rejected the\n   * pairing exchange — e.g. CodeEntry: the user mistyped the code shown on the\n   * device, so the CPace tag didn't match (\"Unexpected Code Entry Tag\").\n   * Recoverable: the user re-pairs and re-enters the code. Distinct from\n   * BlePairingTimeout (BLE SMP bonding window) and UserRejected (on-device\n   * reject button).\n   */\n  ThpPairingFailed = 10306,\n  /**\n   * The OS-level BLE bond is stale/invalid, so the device rejected link\n   * encryption: Android GATT_INSUF_AUTHENTICATION (status 5) or iOS \"Peer\n   * removed pairing information\". Happens after the device is wiped/re-flashed\n   * or unpaired elsewhere while the host still holds an old bond. The SDK cannot\n   * remove an OS bond — the user must forget the device in system Bluetooth\n   * settings and re-pair. Distinct from BlePairingTimeout (SMP window) and\n   * ThpPairingFailed (THP code mismatch).\n   */\n  BleBondInvalid = 10307,\n  /**\n   * A stored THP pairing credential was rejected by the device during the\n   * handshake (device returned completion `state=0`), so the autoconnect session\n   * could not be established. The SDK discards the stale credential; recovery is\n   * a fresh pairing. Distinct from ThpPairingFailed (user mistyped the code\n   * during an *active* pairing) and BleBondInvalid (OS-level BLE bond).\n   */\n  ThpPairingRequired = 10308,\n  /**\n   * Generic BLE connect failure where the OS dropped the specific reason. On\n   * macOS the noble native binding hardcodes \"connection failed\" (and a connect\n   * timeout) and discards the CoreBluetooth NSError, so the SDK cannot tell a\n   * stale bond from an out-of-range / unresponsive device. Surfaced as a\n   * generic \"couldn't connect — check the device, re-pair if paired before\".\n   * Distinct from BleBondInvalid (a *known* stale-bond signal, iOS/Android only)\n   * and BlePairingTimeout (the SMP bonding window).\n   */\n  BleConnectFailed = 10309,\n\n  // --- 10400s PIN / Passphrase ---\n  PinInvalid = 10400,\n  PinCancelled = 10401,\n  PassphraseRejected = 10402,\n  /**\n   * The passphrase entered produced a different wallet (`passphraseState`) than\n   * the one the caller asked to operate on. Trezor-only: the host pins a wallet\n   * by its derived state and the SDK refuses to sign with a mismatched\n   * passphrase session. Surfaced by TrezorAdapter.getPassphraseState.\n   */\n  PassphraseStateMismatch = 10403,\n  /**\n   * The two new-PIN entries did not match during set/change PIN. Only host-input\n   * models (Trezor Model One matrix) surface this; on-device-input models show\n   * the mismatch on the device and never return it.\n   */\n  PinMismatch = 10404,\n\n  // --- 10500s App lifecycle ---\n  /** Chain app NOT INSTALLED on device. User must install via Ledger Live. */\n  AppNotInstalled = 10500,\n  WrongApp = 10501,\n  /** 0x911c Command code not supported — app predates current SDK. */\n  AppTooOld = 10502,\n  /** Not enough free storage for install/update; user must uninstall apps first. */\n  DeviceOutOfMemory = 10503,\n\n  // --- 11000s EVM (Ledger Ethereum App) APDU-specific ---\n  /** 0x6a80 Invalid data — observed on blindSignTransactionFallback when the\n   *  user has not enabled Blind signing on the device. */\n  EvmBlindSigningRequired = 11000,\n  /** 0x6984 Plugin not installed */\n  EvmClearSignPluginMissing = 11001,\n  /** 0x6a84 Insufficient memory (typical on Nano S with large calldata) */\n  EvmDataTooLarge = 11002,\n  /** 0x6501 TransactionType not supported (app too old for EIP-1559 / blob / 7702) */\n  EvmTxTypeNotSupported = 11003,\n\n  // --- 11100s Solana ---\n  /** 0x6808 Blind signing disabled for this instruction. */\n  SolanaBlindSigningRequired = 11100,\n\n  // --- 11200s Tron ---\n  /** 0x6a8d Custom Contracts setting disabled (blocks TRC-20 etc.). */\n  TronCustomContractRequired = 11200,\n  /** 0x6a8b Transactions Data setting disabled. */\n  TronDataSigningRequired = 11201,\n  /** 0x6a8c Sign by Hash setting disabled (hash-signing fallback). */\n  TronSignByHashRequired = 11202,\n\n  // --- 11300s BTC ---\n  /** 0xb008 Wallet policy HMAC mismatch or not registered. */\n  BtcWalletPolicyHmacMismatch = 11300,\n  /** 0xb007 Aborted due to unexpected state (malformed PSBT / missing UTXO). */\n  BtcUnexpectedState = 11301,\n}\n\n/**\n * Device-level failures the SDK cannot self-recover from — affect the entire\n * batch (vs per-chain failures like AppNotInstalled / WrongApp which soft-\n * skip in onboarding). Combined with `accounts.length === 0`, signals\n * genuine orphan. Also reused as the batch-abort whitelist for HWK.\n * Single source of truth.\n *\n * UserRejected (device-side reject) is included: pressing reject is an\n * explicit \"I don't consent\" — continuing the batch to ask again on the\n * next chain is harassment, not helpful.\n */\nexport const ORPHAN_ELIGIBLE_ERROR_CODES: number[] = [\n  HardwareErrorCode.UserAborted,\n  HardwareErrorCode.UserRejected,\n  HardwareErrorCode.DeviceNotFound,\n  HardwareErrorCode.DeviceDisconnected,\n  HardwareErrorCode.DeviceMismatch,\n  HardwareErrorCode.DeviceAppStuck,\n  HardwareErrorCode.DeviceOneDeviceOnly,\n  HardwareErrorCode.TransportError,\n  HardwareErrorCode.DevicePermissionDenied,\n  HardwareErrorCode.BlePairingTimeout,\n  HardwareErrorCode.ThpPairingFailed,\n  HardwareErrorCode.ThpPairingRequired,\n  HardwareErrorCode.BleBondInvalid,\n  HardwareErrorCode.BleConnectFailed,\n];\n\n// ---------------------------------------------------------------------------\n// Standard throwable for HWK adapters\n// ---------------------------------------------------------------------------\n\nexport interface IHwkErrorPayload {\n  code: HardwareErrorCode;\n  message: string;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n}\n\nexport type HwkError = Error & {\n  code: HardwareErrorCode;\n  appName?: string;\n  _tag?: string;\n  params?: Record<string, unknown>;\n};\n\n/**\n * Canonical throwable for HWK adapters. Plain Error + canonical extra fields,\n * shape-compatible with `rehydrateConnectorError` so locally-thrown and\n * cross-boundary errors are indistinguishable to downstream classifiers\n * (`err.code` / `err._tag` / `err.appName`). Do NOT mutate caught errors\n * with `Object.assign` — construct a fresh one via this factory.\n */\nexport function createHwkError(payload: IHwkErrorPayload): HwkError {\n  return Object.assign(new Error(payload.message), {\n    code: payload.code,\n    ...(payload._tag !== undefined && { _tag: payload._tag }),\n    ...(payload.appName !== undefined && { appName: payload.appName }),\n    ...(payload.params !== undefined && { params: payload.params }),\n  });\n}\n","import { HardwareErrorCode } from '../types/errors';\n\n/**\n * Enrich a hardware error message with actionable recovery hints.\n * Shared across adapters (Ledger, Trezor, etc.).\n */\nexport function enrichErrorMessage(code: HardwareErrorCode, originalMessage: string): string {\n  switch (code) {\n    case HardwareErrorCode.PinInvalid:\n      return `${originalMessage}. Please re-enter your PIN.`;\n    case HardwareErrorCode.PinCancelled:\n      return `${originalMessage}. PIN entry was cancelled.`;\n    case HardwareErrorCode.PinMismatch:\n      return `${originalMessage}. The entered PINs do not match. Please try again.`;\n    case HardwareErrorCode.DeviceBusy:\n      return `${originalMessage}. The device is in use by another application. Close other wallet apps and try again.`;\n    case HardwareErrorCode.DeviceBusyInternal:\n      return `${originalMessage}. The device is busy. Please try again in a moment.`;\n    case HardwareErrorCode.DeviceDisconnected:\n      return `${originalMessage}. Please reconnect the device and try again.`;\n    case HardwareErrorCode.DeviceLocked:\n      return `${originalMessage}. Please unlock your device and try again.`;\n    case HardwareErrorCode.DeviceOneDeviceOnly:\n      return `${originalMessage}. Disconnect the extra device and try again.`;\n    case HardwareErrorCode.UserRejected:\n      return `${originalMessage}. The request was rejected on the device.`;\n    case HardwareErrorCode.WrongApp:\n      return `${originalMessage}. Please open the correct app on your device.`;\n    case HardwareErrorCode.AppNotInstalled:\n      return `${originalMessage}. The required app is not installed on the device.`;\n    case HardwareErrorCode.DeviceOutOfMemory:\n      return `${originalMessage}. Not enough free space on the device. Please uninstall some apps and try again.`;\n    case HardwareErrorCode.TransportNotAvailable:\n      return `${originalMessage}. Ensure the device bridge/transport is available and running.`;\n    case HardwareErrorCode.NetworkError:\n      return `${originalMessage}. Network error — check your internet connection and try again.`;\n    case HardwareErrorCode.FirmwareTooOld:\n      return `${originalMessage}. Please update your device firmware.`;\n    case HardwareErrorCode.DeviceNotInitialized:\n      return `${originalMessage}. The device may need to be set up first.`;\n    case HardwareErrorCode.OperationTimeout:\n      return `${originalMessage}. The operation timed out. Please try again.`;\n    case HardwareErrorCode.EvmBlindSigningRequired:\n      return 'Ledger: Blind signing not enabled in Ethereum app.';\n    case HardwareErrorCode.EvmClearSignPluginMissing:\n      return 'Ledger: Required plugin not installed (install via Ledger Live).';\n    case HardwareErrorCode.EvmDataTooLarge:\n      return 'Ledger: Transaction data too large for device memory.';\n    case HardwareErrorCode.EvmTxTypeNotSupported:\n      return 'Ledger: Transaction type not supported by current Ethereum app.';\n    case HardwareErrorCode.AppTooOld:\n      return 'Ledger: App out of date (update via Ledger Live).';\n    case HardwareErrorCode.SolanaBlindSigningRequired:\n      return 'Blind signing disabled in the Solana app.';\n    case HardwareErrorCode.TronCustomContractRequired:\n      return 'Custom Contracts setting disabled in the Tron app.';\n    case HardwareErrorCode.TronDataSigningRequired:\n      return 'Transactions Data setting disabled in the Tron app.';\n    case HardwareErrorCode.TronSignByHashRequired:\n      return 'Sign by Hash setting disabled in the Tron app.';\n    case HardwareErrorCode.BtcWalletPolicyHmacMismatch:\n      return 'Wallet policy not registered or HMAC mismatch.';\n    case HardwareErrorCode.BtcUnexpectedState:\n      return 'Signing aborted due to unexpected device state.';\n    default:\n      return originalMessage;\n  }\n}\n"]}

package/dist/chunk-U63HTLGJ.mjs

@@ -0,0 +1,151 @@
+// src/events/ui-request.ts
+var UI_EVENT = "UI_EVENT";
+var UI_REQUEST = {
+  REQUEST_PIN: "ui-request-pin",
+  REQUEST_PASSPHRASE: "ui-request-passphrase",
+  // One-way UI notification: device is waiting for passphrase entry on-device.
+  // The prompt response path remains RECEIVE_PASSPHRASE with passphraseOnDevice=true.
+  REQUEST_PASSPHRASE_ON_DEVICE: "ui-request-passphrase-on-device",
+  REQUEST_BUTTON: "ui-request-button",
+  REQUEST_QR_DISPLAY: "ui-request-qr-display",
+  REQUEST_QR_SCAN: "ui-request-qr-scan",
+  REQUEST_DEVICE_PERMISSION: "ui-request-device-permission",
+  REQUEST_SELECT_DEVICE: "ui-request-select-device",
+  REQUEST_DEVICE_CONNECT: "ui-request-device-connect",
+  // Ledger BTC App: account index >= 100 requires display=true. Adapter asks
+  // the user once per session before promoting the call.
+  REQUEST_BTC_HIGH_INDEX_CONFIRM: "ui-request-btc-high-index-confirm",
+  // Required app is not installed; with autoInstallApp on, ask the user
+  // whether to install it before retrying the operation.
+  REQUEST_INSTALL_APP: "ui-request-install-app",
+  REQUEST_PREEMPTION: "ui-request-preemption",
+  REQUEST_TREZOR_THP_PAIRING: "ui-request-trezor-thp-pairing",
+  CLOSE_UI_WINDOW: "ui-close",
+  DEVICE_PROGRESS: "ui-device_progress",
+  FIRMWARE_PROGRESS: "ui-firmware-progress",
+  FIRMWARE_TIP: "ui-firmware-tip"
+};
+var UI_RESPONSE = {
+  RECEIVE_PIN: "receive-pin",
+  RECEIVE_PASSPHRASE: "receive-passphrase",
+  RECEIVE_QR_RESPONSE: "receive-qr-response",
+  RECEIVE_SELECT_DEVICE: "receive-select-device",
+  RECEIVE_DEVICE_CONNECT: "receive-device-connect",
+  RECEIVE_DEVICE_PERMISSION: "receive-device-permission",
+  RECEIVE_BTC_HIGH_INDEX_CONFIRM: "receive-btc-high-index-confirm",
+  RECEIVE_INSTALL_APP: "receive-install-app",
+  RECEIVE_PREEMPTION: "receive-preemption",
+  RECEIVE_TREZOR_THP_PAIRING: "receive-trezor-thp-pairing",
+  CANCEL: "cancel"
+};
+
+// src/utils/UiRequestRegistry.ts
+var UI_REQUEST_DEFAULT_TIMEOUT_MS = 6e5;
+var RESPONSE_TO_REQUEST = {
+  [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,
+  [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,
+  [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,
+  [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,
+  [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,
+  [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,
+  [UI_RESPONSE.RECEIVE_INSTALL_APP]: UI_REQUEST.REQUEST_INSTALL_APP,
+  [UI_RESPONSE.RECEIVE_PREEMPTION]: UI_REQUEST.REQUEST_PREEMPTION,
+  [UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING]: UI_REQUEST.REQUEST_TREZOR_THP_PAIRING
+  // RECEIVE_QR_RESPONSE maps to QR_DISPLAY or QR_SCAN — resolved dynamically below.
+};
+var UI_REQUEST_PREEMPTED_TAG = "UiRequestPreempted";
+var UI_REQUEST_CANCELLED_TAG = "UiRequestCancelled";
+var UI_REQUEST_TIMEOUT_TAG = "UiRequestTimeout";
+var UiRequestRegistry = class {
+  constructor() {
+    this.pending = /* @__PURE__ */ new Map();
+  }
+  wait(requestType, options) {
+    const existing = this.pending.get(requestType);
+    if (existing) {
+      clearTimeout(existing.timer);
+      this.pending.delete(requestType);
+      existing.reject(
+        Object.assign(new Error(`UI request '${requestType}' was superseded by a new request`), {
+          _tag: UI_REQUEST_PREEMPTED_TAG
+        })
+      );
+    }
+    const timeoutMs = options?.timeoutMs ?? UI_REQUEST_DEFAULT_TIMEOUT_MS;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        if (this.pending.get(requestType)?.timer === timer) {
+          this.pending.delete(requestType);
+          reject(
+            Object.assign(new Error(`UI request '${requestType}' timed out after ${timeoutMs}ms`), {
+              _tag: UI_REQUEST_TIMEOUT_TAG
+            })
+          );
+        }
+      }, timeoutMs);
+      this.pending.set(requestType, {
+        resolve,
+        reject,
+        timer
+      });
+    });
+  }
+  resolve(responseType, payload) {
+    let requestType = RESPONSE_TO_REQUEST[responseType];
+    if (responseType === UI_RESPONSE.RECEIVE_QR_RESPONSE) {
+      if (this.pending.has(UI_REQUEST.REQUEST_QR_DISPLAY)) {
+        requestType = UI_REQUEST.REQUEST_QR_DISPLAY;
+      } else if (this.pending.has(UI_REQUEST.REQUEST_QR_SCAN)) {
+        requestType = UI_REQUEST.REQUEST_QR_SCAN;
+      }
+    }
+    if (!requestType) return;
+    const entry = this.pending.get(requestType);
+    if (!entry) return;
+    clearTimeout(entry.timer);
+    this.pending.delete(requestType);
+    entry.resolve(payload);
+  }
+  cancel(requestType) {
+    if (requestType) {
+      const entry = this.pending.get(requestType);
+      if (!entry) return;
+      clearTimeout(entry.timer);
+      this.pending.delete(requestType);
+      entry.reject(
+        Object.assign(new Error(`UI request '${requestType}' was cancelled`), {
+          _tag: UI_REQUEST_CANCELLED_TAG
+        })
+      );
+      return;
+    }
+    for (const [type, entry] of this.pending) {
+      clearTimeout(entry.timer);
+      entry.reject(
+        Object.assign(new Error(`UI request '${type}' was cancelled`), {
+          _tag: UI_REQUEST_CANCELLED_TAG
+        })
+      );
+    }
+    this.pending.clear();
+  }
+  reset() {
+    this.cancel();
+  }
+  hasPending(requestType) {
+    if (requestType) return this.pending.has(requestType);
+    return this.pending.size > 0;
+  }
+};
+
+export {
+  UI_EVENT,
+  UI_REQUEST,
+  UI_RESPONSE,
+  UI_REQUEST_DEFAULT_TIMEOUT_MS,
+  UI_REQUEST_PREEMPTED_TAG,
+  UI_REQUEST_CANCELLED_TAG,
+  UI_REQUEST_TIMEOUT_TAG,
+  UiRequestRegistry
+};
+//# sourceMappingURL=chunk-U63HTLGJ.mjs.map

package/dist/chunk-U63HTLGJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/events/ui-request.ts","../src/utils/UiRequestRegistry.ts"],"sourcesContent":["import type { QrResponseData } from '../types/qr';\n\nexport const UI_EVENT = 'UI_EVENT';\n\nexport const UI_REQUEST = {\n  REQUEST_PIN: 'ui-request-pin',\n  REQUEST_PASSPHRASE: 'ui-request-passphrase',\n  // One-way UI notification: device is waiting for passphrase entry on-device.\n  // The prompt response path remains RECEIVE_PASSPHRASE with passphraseOnDevice=true.\n  REQUEST_PASSPHRASE_ON_DEVICE: 'ui-request-passphrase-on-device',\n  REQUEST_BUTTON: 'ui-request-button',\n  REQUEST_QR_DISPLAY: 'ui-request-qr-display',\n  REQUEST_QR_SCAN: 'ui-request-qr-scan',\n  REQUEST_DEVICE_PERMISSION: 'ui-request-device-permission',\n  REQUEST_SELECT_DEVICE: 'ui-request-select-device',\n  REQUEST_DEVICE_CONNECT: 'ui-request-device-connect',\n  // Ledger BTC App: account index >= 100 requires display=true. Adapter asks\n  // the user once per session before promoting the call.\n  REQUEST_BTC_HIGH_INDEX_CONFIRM: 'ui-request-btc-high-index-confirm',\n  // Required app is not installed; with autoInstallApp on, ask the user\n  // whether to install it before retrying the operation.\n  REQUEST_INSTALL_APP: 'ui-request-install-app',\n  REQUEST_PREEMPTION: 'ui-request-preemption',\n  REQUEST_TREZOR_THP_PAIRING: 'ui-request-trezor-thp-pairing',\n  CLOSE_UI_WINDOW: 'ui-close',\n  DEVICE_PROGRESS: 'ui-device_progress',\n  FIRMWARE_PROGRESS: 'ui-firmware-progress',\n  FIRMWARE_TIP: 'ui-firmware-tip',\n} as const;\n\nexport const UI_RESPONSE = {\n  RECEIVE_PIN: 'receive-pin',\n  RECEIVE_PASSPHRASE: 'receive-passphrase',\n  RECEIVE_QR_RESPONSE: 'receive-qr-response',\n  RECEIVE_SELECT_DEVICE: 'receive-select-device',\n  RECEIVE_DEVICE_CONNECT: 'receive-device-connect',\n  RECEIVE_DEVICE_PERMISSION: 'receive-device-permission',\n  RECEIVE_BTC_HIGH_INDEX_CONFIRM: 'receive-btc-high-index-confirm',\n  RECEIVE_INSTALL_APP: 'receive-install-app',\n  RECEIVE_PREEMPTION: 'receive-preemption',\n  RECEIVE_TREZOR_THP_PAIRING: 'receive-trezor-thp-pairing',\n  CANCEL: 'cancel',\n} as const;\n\nexport type DevicePermissionDeniedReason =\n  | 'bluetoothTurnedOff'\n  | 'permissionDenied'\n  | (string & Record<never, never>);\n\nexport type DevicePermissionResponse = {\n  granted: boolean;\n  reason?: DevicePermissionDeniedReason;\n  message?: string;\n};\n\nexport type UiResponseEvent =\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PIN;\n      payload: string;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PASSPHRASE;\n      payload: {\n        value: string;\n        passphraseOnDevice?: boolean;\n        save?: boolean;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_QR_RESPONSE;\n      payload: QrResponseData;\n    }\n  | {\n      // sdkConnectId echoes one of the DeviceInfo.connectId values emitted in\n      // the REQUEST_SELECT_DEVICE event's `devices` list. Scope is the current\n      // search session; may be ephemeral (e.g. Ledger USB DMK UUID).\n      type: typeof UI_RESPONSE.RECEIVE_SELECT_DEVICE;\n      payload: { sdkConnectId: string };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_CONNECT;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_DEVICE_PERMISSION;\n      payload: DevicePermissionResponse;\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_INSTALL_APP;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_PREEMPTION;\n      payload: { confirmed: boolean };\n    }\n  | {\n      type: typeof UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING;\n      payload: {\n        selectedMethod?: number | string;\n        tag?: string;\n      };\n    }\n  | {\n      type: typeof UI_RESPONSE.CANCEL;\n      payload?: undefined;\n    };\n","import { UI_REQUEST, UI_RESPONSE } from '../events/ui-request';\n\n/** 10 min — every UI request is human-in-the-loop; bias toward \"wait long\". */\nexport const UI_REQUEST_DEFAULT_TIMEOUT_MS = 600_000;\n\nconst RESPONSE_TO_REQUEST: Record<string, string> = {\n  [UI_RESPONSE.RECEIVE_PIN]: UI_REQUEST.REQUEST_PIN,\n  [UI_RESPONSE.RECEIVE_PASSPHRASE]: UI_REQUEST.REQUEST_PASSPHRASE,\n  [UI_RESPONSE.RECEIVE_SELECT_DEVICE]: UI_REQUEST.REQUEST_SELECT_DEVICE,\n  [UI_RESPONSE.RECEIVE_DEVICE_CONNECT]: UI_REQUEST.REQUEST_DEVICE_CONNECT,\n  [UI_RESPONSE.RECEIVE_DEVICE_PERMISSION]: UI_REQUEST.REQUEST_DEVICE_PERMISSION,\n  [UI_RESPONSE.RECEIVE_BTC_HIGH_INDEX_CONFIRM]: UI_REQUEST.REQUEST_BTC_HIGH_INDEX_CONFIRM,\n  [UI_RESPONSE.RECEIVE_INSTALL_APP]: UI_REQUEST.REQUEST_INSTALL_APP,\n  [UI_RESPONSE.RECEIVE_PREEMPTION]: UI_REQUEST.REQUEST_PREEMPTION,\n  [UI_RESPONSE.RECEIVE_TREZOR_THP_PAIRING]: UI_REQUEST.REQUEST_TREZOR_THP_PAIRING,\n  // RECEIVE_QR_RESPONSE maps to QR_DISPLAY or QR_SCAN — resolved dynamically below.\n};\n\nexport const UI_REQUEST_PREEMPTED_TAG = 'UiRequestPreempted';\nexport const UI_REQUEST_CANCELLED_TAG = 'UiRequestCancelled';\nexport const UI_REQUEST_TIMEOUT_TAG = 'UiRequestTimeout';\n\ntype PendingEntry = {\n  resolve: (payload: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n};\n\n/**\n * Per-type single-slot registry for adapter-level UI requests. A new `wait`\n * of the same type supersedes (rejects) the prior pending entry. With the\n * job queue running globally serially, cross-type collisions don't occur in\n * normal flow — same-type preemption is a defensive measure for callers\n * that fire the same request twice without waiting on the first.\n *\n * Unknown response types are dropped silently so the public `uiResponse`\n * entry never throws.\n */\nexport class UiRequestRegistry {\n  private pending = new Map<string, PendingEntry>();\n\n  wait<T = unknown>(requestType: string, options?: { timeoutMs?: number }): Promise<T> {\n    const existing = this.pending.get(requestType);\n    if (existing) {\n      clearTimeout(existing.timer);\n      this.pending.delete(requestType);\n      existing.reject(\n        Object.assign(new Error(`UI request '${requestType}' was superseded by a new request`), {\n          _tag: UI_REQUEST_PREEMPTED_TAG,\n        })\n      );\n    }\n\n    const timeoutMs = options?.timeoutMs ?? UI_REQUEST_DEFAULT_TIMEOUT_MS;\n\n    return new Promise<T>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        if (this.pending.get(requestType)?.timer === timer) {\n          this.pending.delete(requestType);\n          reject(\n            Object.assign(new Error(`UI request '${requestType}' timed out after ${timeoutMs}ms`), {\n              _tag: UI_REQUEST_TIMEOUT_TAG,\n            })\n          );\n        }\n      }, timeoutMs);\n\n      this.pending.set(requestType, {\n        resolve: resolve as (payload: unknown) => void,\n        reject,\n        timer,\n      });\n    });\n  }\n\n  resolve(responseType: string, payload: unknown): void {\n    let requestType = RESPONSE_TO_REQUEST[responseType];\n    if (responseType === UI_RESPONSE.RECEIVE_QR_RESPONSE) {\n      if (this.pending.has(UI_REQUEST.REQUEST_QR_DISPLAY)) {\n        requestType = UI_REQUEST.REQUEST_QR_DISPLAY;\n      } else if (this.pending.has(UI_REQUEST.REQUEST_QR_SCAN)) {\n        requestType = UI_REQUEST.REQUEST_QR_SCAN;\n      }\n    }\n    if (!requestType) return;\n\n    const entry = this.pending.get(requestType);\n    if (!entry) return;\n\n    clearTimeout(entry.timer);\n    this.pending.delete(requestType);\n    entry.resolve(payload);\n  }\n\n  cancel(requestType?: string): void {\n    if (requestType) {\n      const entry = this.pending.get(requestType);\n      if (!entry) return;\n      clearTimeout(entry.timer);\n      this.pending.delete(requestType);\n      entry.reject(\n        Object.assign(new Error(`UI request '${requestType}' was cancelled`), {\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n      return;\n    }\n\n    for (const [type, entry] of this.pending) {\n      clearTimeout(entry.timer);\n      entry.reject(\n        Object.assign(new Error(`UI request '${type}' was cancelled`), {\n          _tag: UI_REQUEST_CANCELLED_TAG,\n        })\n      );\n    }\n    this.pending.clear();\n  }\n\n  reset(): void {\n    this.cancel();\n  }\n\n  hasPending(requestType?: string): boolean {\n    if (requestType) return this.pending.has(requestType);\n    return this.pending.size > 0;\n  }\n}\n"],"mappings":"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","names":[]}