@metamask-previews/hw-wallet-sdk 0.8.0-e5bc458 → 0.9.0-e51c895

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- Add shared user-rejection detection helpers so hardware wallet libraries can classify cancellation-like errors consistently ([#576](https://github.com/MetaMask/accounts/pull/576))
+  - Provider-style `4001` codes are distinguished from this SDK's `ConnectionClosed` error code.
+
 ## [0.8.0]
 
 ### Added

package/dist/index.cjs

@@ -18,4 +18,5 @@ __exportStar(require("./hardware-errors-enums.cjs"), exports);
 __exportStar(require("./hardware-error-mappings.cjs"), exports);
 __exportStar(require("./hardware-error.cjs"), exports);
 __exportStar(require("./types.cjs"), exports);
+__exportStar(require("./user-rejection.cjs"), exports);
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAAwC;AACxC,gEAA0C;AAC1C,uDAAiC;AACjC,8CAAwB","sourcesContent":["export * from './hardware-errors-enums';\nexport * from './hardware-error-mappings';\nexport * from './hardware-error';\nexport * from './types';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAAwC;AACxC,gEAA0C;AAC1C,uDAAiC;AACjC,8CAAwB;AACxB,uDAAiC","sourcesContent":["export * from './hardware-errors-enums';\nexport * from './hardware-error-mappings';\nexport * from './hardware-error';\nexport * from './types';\nexport * from './user-rejection';\n"]}

package/dist/index.d.cts

@@ -2,4 +2,5 @@ export * from "./hardware-errors-enums.cjs";
 export * from "./hardware-error-mappings.cjs";
 export * from "./hardware-error.cjs";
 export * from "./types.cjs";
+export * from "./user-rejection.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAAwC;AACxC,8CAA0C;AAC1C,qCAAiC;AACjC,4BAAwB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAAwC;AACxC,8CAA0C;AAC1C,qCAAiC;AACjC,4BAAwB;AACxB,qCAAiC"}

package/dist/index.d.mts

@@ -2,4 +2,5 @@ export * from "./hardware-errors-enums.mjs";
 export * from "./hardware-error-mappings.mjs";
 export * from "./hardware-error.mjs";
 export * from "./types.mjs";
+export * from "./user-rejection.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAAwC;AACxC,8CAA0C;AAC1C,qCAAiC;AACjC,4BAAwB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAAwC;AACxC,8CAA0C;AAC1C,qCAAiC;AACjC,4BAAwB;AACxB,qCAAiC"}

package/dist/index.mjs

@@ -2,4 +2,5 @@ export * from "./hardware-errors-enums.mjs";
 export * from "./hardware-error-mappings.mjs";
 export * from "./hardware-error.mjs";
 export * from "./types.mjs";
+export * from "./user-rejection.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAAwC;AACxC,8CAA0C;AAC1C,qCAAiC;AACjC,4BAAwB","sourcesContent":["export * from './hardware-errors-enums';\nexport * from './hardware-error-mappings';\nexport * from './hardware-error';\nexport * from './types';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAAwC;AACxC,8CAA0C;AAC1C,qCAAiC;AACjC,4BAAwB;AACxB,qCAAiC","sourcesContent":["export * from './hardware-errors-enums';\nexport * from './hardware-error-mappings';\nexport * from './hardware-error';\nexport * from './types';\nexport * from './user-rejection';\n"]}

package/dist/user-rejection.cjs

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveUserRejectionErrorCode = exports.isUserRejectionLikeError = void 0;
+const hardware_error_1 = require("./hardware-error.cjs");
+const hardware_errors_enums_1 = require("./hardware-errors-enums.cjs");
+const PROVIDER_USER_REJECTED_CODE = 4001;
+const USER_REJECTION_PATTERN = /(?:\buser rejected\b|\baction cancelled\b|\bcancelled\b|\bcanceled\b|failure_actioncancelled)/iu;
+const USER_REJECTED_PATTERN = /\buser rejected\b/iu;
+const PERMISSIONS_NOT_GRANTED_PATTERN = /\bpermissions? not granted\b/iu;
+const USER_REJECTION_CODES = new Set([
+    'Method_PermissionsNotGranted',
+    'Method_Cancel',
+    'Failure_ActionCancelled',
+]);
+function isUserRejectionString(value) {
+    return (USER_REJECTION_PATTERN.test(value) ||
+        PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||
+        USER_REJECTION_CODES.has(value));
+}
+function isUserRejectedString(value) {
+    return (USER_REJECTED_PATTERN.test(value) ||
+        PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||
+        value === 'Method_PermissionsNotGranted');
+}
+function isHardwareWalletConnectionClosedError(error) {
+    if (error instanceof hardware_error_1.HardwareWalletError) {
+        return error.code === hardware_errors_enums_1.ErrorCode.ConnectionClosed;
+    }
+    const errorObject = error;
+    return (errorObject.name === 'HardwareWalletError' &&
+        errorObject.code === hardware_errors_enums_1.ErrorCode.ConnectionClosed);
+}
+function isProviderUserRejectedCode(code) {
+    return code === PROVIDER_USER_REJECTED_CODE;
+}
+/**
+ * Recursively checks whether an error value represents a user rejection or
+ * cancellation, mirroring detection used in MetaMask core signing flows.
+ *
+ * @param error - The error value to inspect.
+ * @param visited - Set of already-visited objects to avoid infinite recursion.
+ * @returns True when the error looks like a user rejection or cancellation.
+ */
+function isUserRejectionLikeError(error, visited = new Set()) {
+    if (!error || visited.has(error)) {
+        return false;
+    }
+    visited.add(error);
+    if (typeof error === 'string') {
+        return isUserRejectionString(error);
+    }
+    if (typeof error !== 'object') {
+        return false;
+    }
+    const errorObject = error;
+    if (isHardwareWalletConnectionClosedError(error)) {
+        return false;
+    }
+    if (isProviderUserRejectedCode(errorObject.code)) {
+        return true;
+    }
+    return (isUserRejectionLikeError(errorObject.code, visited) ||
+        isUserRejectionLikeError(errorObject.message, visited) ||
+        isUserRejectionLikeError(errorObject.stack, visited) ||
+        isUserRejectionLikeError(errorObject.cause, visited) ||
+        isUserRejectionLikeError(errorObject.originalError, visited));
+}
+exports.isUserRejectionLikeError = isUserRejectionLikeError;
+/**
+ * Resolves a hardware-wallet error code for user rejection-like errors.
+ *
+ * @param error - The error value to inspect.
+ * @returns `UserRejected` or `UserCancelled` when detected, otherwise `undefined`.
+ */
+function resolveUserRejectionErrorCode(error) {
+    if (!isUserRejectionLikeError(error)) {
+        return undefined;
+    }
+    if (typeof error === 'string') {
+        return isUserRejectedString(error)
+            ? hardware_errors_enums_1.ErrorCode.UserRejected
+            : hardware_errors_enums_1.ErrorCode.UserCancelled;
+    }
+    const errorObject = error;
+    if (typeof errorObject.message === 'string') {
+        if (isUserRejectedString(errorObject.message)) {
+            return hardware_errors_enums_1.ErrorCode.UserRejected;
+        }
+        if (isUserRejectionString(errorObject.message)) {
+            return hardware_errors_enums_1.ErrorCode.UserCancelled;
+        }
+    }
+    if (typeof errorObject.code === 'string') {
+        if (isUserRejectedString(errorObject.code)) {
+            return hardware_errors_enums_1.ErrorCode.UserRejected;
+        }
+        if (isUserRejectionString(errorObject.code)) {
+            return hardware_errors_enums_1.ErrorCode.UserCancelled;
+        }
+    }
+    if (errorObject.cause !== undefined) {
+        const causeCode = resolveUserRejectionErrorCode(errorObject.cause);
+        if (causeCode !== undefined) {
+            return causeCode;
+        }
+    }
+    if (errorObject.originalError !== undefined) {
+        const originalCode = resolveUserRejectionErrorCode(errorObject.originalError);
+        if (originalCode !== undefined) {
+            return originalCode;
+        }
+    }
+    return hardware_errors_enums_1.ErrorCode.UserCancelled;
+}
+exports.resolveUserRejectionErrorCode = resolveUserRejectionErrorCode;
+//# sourceMappingURL=user-rejection.cjs.map

package/dist/user-rejection.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rejection.cjs","sourceRoot":"","sources":["../src/user-rejection.ts"],"names":[],"mappings":"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","sourcesContent":["import { HardwareWalletError } from './hardware-error';\nimport { ErrorCode } from './hardware-errors-enums';\n\nconst PROVIDER_USER_REJECTED_CODE = 4001;\n\nconst USER_REJECTION_PATTERN =\n  /(?:\\buser rejected\\b|\\baction cancelled\\b|\\bcancelled\\b|\\bcanceled\\b|failure_actioncancelled)/iu;\n\nconst USER_REJECTED_PATTERN = /\\buser rejected\\b/iu;\nconst PERMISSIONS_NOT_GRANTED_PATTERN = /\\bpermissions? not granted\\b/iu;\n\nconst USER_REJECTION_CODES = new Set<string>([\n  'Method_PermissionsNotGranted',\n  'Method_Cancel',\n  'Failure_ActionCancelled',\n]);\n\nfunction isUserRejectionString(value: string): boolean {\n  return (\n    USER_REJECTION_PATTERN.test(value) ||\n    PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||\n    USER_REJECTION_CODES.has(value)\n  );\n}\n\nfunction isUserRejectedString(value: string): boolean {\n  return (\n    USER_REJECTED_PATTERN.test(value) ||\n    PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||\n    value === 'Method_PermissionsNotGranted'\n  );\n}\n\ntype ErrorLikeObject = {\n  code?: unknown;\n  message?: unknown;\n  name?: unknown;\n  stack?: unknown;\n  cause?: unknown;\n  originalError?: unknown;\n};\n\nfunction isHardwareWalletConnectionClosedError(error: object): boolean {\n  if (error instanceof HardwareWalletError) {\n    return error.code === ErrorCode.ConnectionClosed;\n  }\n\n  const errorObject = error as ErrorLikeObject;\n  return (\n    errorObject.name === 'HardwareWalletError' &&\n    errorObject.code === ErrorCode.ConnectionClosed\n  );\n}\n\nfunction isProviderUserRejectedCode(code: unknown): boolean {\n  return code === PROVIDER_USER_REJECTED_CODE;\n}\n\n/**\n * Recursively checks whether an error value represents a user rejection or\n * cancellation, mirroring detection used in MetaMask core signing flows.\n *\n * @param error - The error value to inspect.\n * @param visited - Set of already-visited objects to avoid infinite recursion.\n * @returns True when the error looks like a user rejection or cancellation.\n */\nexport function isUserRejectionLikeError(\n  error: unknown,\n  visited = new Set<unknown>(),\n): boolean {\n  if (!error || visited.has(error)) {\n    return false;\n  }\n  visited.add(error);\n\n  if (typeof error === 'string') {\n    return isUserRejectionString(error);\n  }\n\n  if (typeof error !== 'object') {\n    return false;\n  }\n\n  const errorObject = error as ErrorLikeObject;\n\n  if (isHardwareWalletConnectionClosedError(error)) {\n    return false;\n  }\n\n  if (isProviderUserRejectedCode(errorObject.code)) {\n    return true;\n  }\n\n  return (\n    isUserRejectionLikeError(errorObject.code, visited) ||\n    isUserRejectionLikeError(errorObject.message, visited) ||\n    isUserRejectionLikeError(errorObject.stack, visited) ||\n    isUserRejectionLikeError(errorObject.cause, visited) ||\n    isUserRejectionLikeError(errorObject.originalError, visited)\n  );\n}\n\n/**\n * Resolves a hardware-wallet error code for user rejection-like errors.\n *\n * @param error - The error value to inspect.\n * @returns `UserRejected` or `UserCancelled` when detected, otherwise `undefined`.\n */\nexport function resolveUserRejectionErrorCode(\n  error: unknown,\n): ErrorCode.UserCancelled | ErrorCode.UserRejected | undefined {\n  if (!isUserRejectionLikeError(error)) {\n    return undefined;\n  }\n\n  if (typeof error === 'string') {\n    return isUserRejectedString(error)\n      ? ErrorCode.UserRejected\n      : ErrorCode.UserCancelled;\n  }\n\n  const errorObject = error as ErrorLikeObject;\n\n  if (typeof errorObject.message === 'string') {\n    if (isUserRejectedString(errorObject.message)) {\n      return ErrorCode.UserRejected;\n    }\n    if (isUserRejectionString(errorObject.message)) {\n      return ErrorCode.UserCancelled;\n    }\n  }\n\n  if (typeof errorObject.code === 'string') {\n    if (isUserRejectedString(errorObject.code)) {\n      return ErrorCode.UserRejected;\n    }\n    if (isUserRejectionString(errorObject.code)) {\n      return ErrorCode.UserCancelled;\n    }\n  }\n\n  if (errorObject.cause !== undefined) {\n    const causeCode = resolveUserRejectionErrorCode(errorObject.cause);\n    if (causeCode !== undefined) {\n      return causeCode;\n    }\n  }\n\n  if (errorObject.originalError !== undefined) {\n    const originalCode = resolveUserRejectionErrorCode(\n      errorObject.originalError,\n    );\n    if (originalCode !== undefined) {\n      return originalCode;\n    }\n  }\n\n  return ErrorCode.UserCancelled;\n}\n"]}

package/dist/user-rejection.d.cts

@@ -0,0 +1,18 @@
+import { ErrorCode } from "./hardware-errors-enums.cjs";
+/**
+ * Recursively checks whether an error value represents a user rejection or
+ * cancellation, mirroring detection used in MetaMask core signing flows.
+ *
+ * @param error - The error value to inspect.
+ * @param visited - Set of already-visited objects to avoid infinite recursion.
+ * @returns True when the error looks like a user rejection or cancellation.
+ */
+export declare function isUserRejectionLikeError(error: unknown, visited?: Set<unknown>): boolean;
+/**
+ * Resolves a hardware-wallet error code for user rejection-like errors.
+ *
+ * @param error - The error value to inspect.
+ * @returns `UserRejected` or `UserCancelled` when detected, otherwise `undefined`.
+ */
+export declare function resolveUserRejectionErrorCode(error: unknown): ErrorCode.UserCancelled | ErrorCode.UserRejected | undefined;
+//# sourceMappingURL=user-rejection.d.cts.map

package/dist/user-rejection.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rejection.d.cts","sourceRoot":"","sources":["../src/user-rejection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,oCAAgC;AAyDpD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,eAAqB,GAC3B,OAAO,CA+BT;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAgD9D"}

package/dist/user-rejection.d.mts

@@ -0,0 +1,18 @@
+import { ErrorCode } from "./hardware-errors-enums.mjs";
+/**
+ * Recursively checks whether an error value represents a user rejection or
+ * cancellation, mirroring detection used in MetaMask core signing flows.
+ *
+ * @param error - The error value to inspect.
+ * @param visited - Set of already-visited objects to avoid infinite recursion.
+ * @returns True when the error looks like a user rejection or cancellation.
+ */
+export declare function isUserRejectionLikeError(error: unknown, visited?: Set<unknown>): boolean;
+/**
+ * Resolves a hardware-wallet error code for user rejection-like errors.
+ *
+ * @param error - The error value to inspect.
+ * @returns `UserRejected` or `UserCancelled` when detected, otherwise `undefined`.
+ */
+export declare function resolveUserRejectionErrorCode(error: unknown): ErrorCode.UserCancelled | ErrorCode.UserRejected | undefined;
+//# sourceMappingURL=user-rejection.d.mts.map

package/dist/user-rejection.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rejection.d.mts","sourceRoot":"","sources":["../src/user-rejection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,oCAAgC;AAyDpD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,eAAqB,GAC3B,OAAO,CA+BT;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAgD9D"}

package/dist/user-rejection.mjs

@@ -0,0 +1,111 @@
+import { HardwareWalletError } from "./hardware-error.mjs";
+import { ErrorCode } from "./hardware-errors-enums.mjs";
+const PROVIDER_USER_REJECTED_CODE = 4001;
+const USER_REJECTION_PATTERN = /(?:\buser rejected\b|\baction cancelled\b|\bcancelled\b|\bcanceled\b|failure_actioncancelled)/iu;
+const USER_REJECTED_PATTERN = /\buser rejected\b/iu;
+const PERMISSIONS_NOT_GRANTED_PATTERN = /\bpermissions? not granted\b/iu;
+const USER_REJECTION_CODES = new Set([
+    'Method_PermissionsNotGranted',
+    'Method_Cancel',
+    'Failure_ActionCancelled',
+]);
+function isUserRejectionString(value) {
+    return (USER_REJECTION_PATTERN.test(value) ||
+        PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||
+        USER_REJECTION_CODES.has(value));
+}
+function isUserRejectedString(value) {
+    return (USER_REJECTED_PATTERN.test(value) ||
+        PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||
+        value === 'Method_PermissionsNotGranted');
+}
+function isHardwareWalletConnectionClosedError(error) {
+    if (error instanceof HardwareWalletError) {
+        return error.code === ErrorCode.ConnectionClosed;
+    }
+    const errorObject = error;
+    return (errorObject.name === 'HardwareWalletError' &&
+        errorObject.code === ErrorCode.ConnectionClosed);
+}
+function isProviderUserRejectedCode(code) {
+    return code === PROVIDER_USER_REJECTED_CODE;
+}
+/**
+ * Recursively checks whether an error value represents a user rejection or
+ * cancellation, mirroring detection used in MetaMask core signing flows.
+ *
+ * @param error - The error value to inspect.
+ * @param visited - Set of already-visited objects to avoid infinite recursion.
+ * @returns True when the error looks like a user rejection or cancellation.
+ */
+export function isUserRejectionLikeError(error, visited = new Set()) {
+    if (!error || visited.has(error)) {
+        return false;
+    }
+    visited.add(error);
+    if (typeof error === 'string') {
+        return isUserRejectionString(error);
+    }
+    if (typeof error !== 'object') {
+        return false;
+    }
+    const errorObject = error;
+    if (isHardwareWalletConnectionClosedError(error)) {
+        return false;
+    }
+    if (isProviderUserRejectedCode(errorObject.code)) {
+        return true;
+    }
+    return (isUserRejectionLikeError(errorObject.code, visited) ||
+        isUserRejectionLikeError(errorObject.message, visited) ||
+        isUserRejectionLikeError(errorObject.stack, visited) ||
+        isUserRejectionLikeError(errorObject.cause, visited) ||
+        isUserRejectionLikeError(errorObject.originalError, visited));
+}
+/**
+ * Resolves a hardware-wallet error code for user rejection-like errors.
+ *
+ * @param error - The error value to inspect.
+ * @returns `UserRejected` or `UserCancelled` when detected, otherwise `undefined`.
+ */
+export function resolveUserRejectionErrorCode(error) {
+    if (!isUserRejectionLikeError(error)) {
+        return undefined;
+    }
+    if (typeof error === 'string') {
+        return isUserRejectedString(error)
+            ? ErrorCode.UserRejected
+            : ErrorCode.UserCancelled;
+    }
+    const errorObject = error;
+    if (typeof errorObject.message === 'string') {
+        if (isUserRejectedString(errorObject.message)) {
+            return ErrorCode.UserRejected;
+        }
+        if (isUserRejectionString(errorObject.message)) {
+            return ErrorCode.UserCancelled;
+        }
+    }
+    if (typeof errorObject.code === 'string') {
+        if (isUserRejectedString(errorObject.code)) {
+            return ErrorCode.UserRejected;
+        }
+        if (isUserRejectionString(errorObject.code)) {
+            return ErrorCode.UserCancelled;
+        }
+    }
+    if (errorObject.cause !== undefined) {
+        const causeCode = resolveUserRejectionErrorCode(errorObject.cause);
+        if (causeCode !== undefined) {
+            return causeCode;
+        }
+    }
+    if (errorObject.originalError !== undefined) {
+        const originalCode = resolveUserRejectionErrorCode(errorObject.originalError);
+        if (originalCode !== undefined) {
+            return originalCode;
+        }
+    }
+    return ErrorCode.UserCancelled;
+}
+//# sourceMappingURL=user-rejection.mjs.map

package/dist/user-rejection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-rejection.mjs","sourceRoot":"","sources":["../src/user-rejection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,6BAAyB;AACvD,OAAO,EAAE,SAAS,EAAE,oCAAgC;AAEpD,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,MAAM,sBAAsB,GAC1B,iGAAiG,CAAC;AAEpG,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AACpD,MAAM,+BAA+B,GAAG,gCAAgC,CAAC;AAEzE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS;IAC3C,8BAA8B;IAC9B,eAAe;IACf,yBAAyB;CAC1B,CAAC,CAAC;AAEH,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,CACL,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAClC,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3C,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,CACL,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QACjC,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC;QAC3C,KAAK,KAAK,8BAA8B,CACzC,CAAC;AACJ,CAAC;AAWD,SAAS,qCAAqC,CAAC,KAAa;IAC1D,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,KAAwB,CAAC;IAC7C,OAAO,CACL,WAAW,CAAC,IAAI,KAAK,qBAAqB;QAC1C,WAAW,CAAC,IAAI,KAAK,SAAS,CAAC,gBAAgB,CAChD,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,IAAa;IAC/C,OAAO,IAAI,KAAK,2BAA2B,CAAC;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAc,EACd,UAAU,IAAI,GAAG,EAAW;IAE5B,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEnB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,KAAwB,CAAC;IAE7C,IAAI,qCAAqC,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,0BAA0B,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,wBAAwB,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;QACnD,wBAAwB,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC;QACtD,wBAAwB,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC;QACpD,wBAAwB,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC;QACpD,wBAAwB,CAAC,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,oBAAoB,CAAC,KAAK,CAAC;YAChC,CAAC,CAAC,SAAS,CAAC,YAAY;YACxB,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,MAAM,WAAW,GAAG,KAAwB,CAAC;IAE7C,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,IAAI,oBAAoB,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC,YAAY,CAAC;QAChC,CAAC;QACD,IAAI,qBAAqB,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,OAAO,SAAS,CAAC,aAAa,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,oBAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,OAAO,SAAS,CAAC,YAAY,CAAC;QAChC,CAAC;QACD,IAAI,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC,aAAa,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,6BAA6B,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,6BAA6B,CAChD,WAAW,CAAC,aAAa,CAC1B,CAAC;QACF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,aAAa,CAAC;AACjC,CAAC","sourcesContent":["import { HardwareWalletError } from './hardware-error';\nimport { ErrorCode } from './hardware-errors-enums';\n\nconst PROVIDER_USER_REJECTED_CODE = 4001;\n\nconst USER_REJECTION_PATTERN =\n  /(?:\\buser rejected\\b|\\baction cancelled\\b|\\bcancelled\\b|\\bcanceled\\b|failure_actioncancelled)/iu;\n\nconst USER_REJECTED_PATTERN = /\\buser rejected\\b/iu;\nconst PERMISSIONS_NOT_GRANTED_PATTERN = /\\bpermissions? not granted\\b/iu;\n\nconst USER_REJECTION_CODES = new Set<string>([\n  'Method_PermissionsNotGranted',\n  'Method_Cancel',\n  'Failure_ActionCancelled',\n]);\n\nfunction isUserRejectionString(value: string): boolean {\n  return (\n    USER_REJECTION_PATTERN.test(value) ||\n    PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||\n    USER_REJECTION_CODES.has(value)\n  );\n}\n\nfunction isUserRejectedString(value: string): boolean {\n  return (\n    USER_REJECTED_PATTERN.test(value) ||\n    PERMISSIONS_NOT_GRANTED_PATTERN.test(value) ||\n    value === 'Method_PermissionsNotGranted'\n  );\n}\n\ntype ErrorLikeObject = {\n  code?: unknown;\n  message?: unknown;\n  name?: unknown;\n  stack?: unknown;\n  cause?: unknown;\n  originalError?: unknown;\n};\n\nfunction isHardwareWalletConnectionClosedError(error: object): boolean {\n  if (error instanceof HardwareWalletError) {\n    return error.code === ErrorCode.ConnectionClosed;\n  }\n\n  const errorObject = error as ErrorLikeObject;\n  return (\n    errorObject.name === 'HardwareWalletError' &&\n    errorObject.code === ErrorCode.ConnectionClosed\n  );\n}\n\nfunction isProviderUserRejectedCode(code: unknown): boolean {\n  return code === PROVIDER_USER_REJECTED_CODE;\n}\n\n/**\n * Recursively checks whether an error value represents a user rejection or\n * cancellation, mirroring detection used in MetaMask core signing flows.\n *\n * @param error - The error value to inspect.\n * @param visited - Set of already-visited objects to avoid infinite recursion.\n * @returns True when the error looks like a user rejection or cancellation.\n */\nexport function isUserRejectionLikeError(\n  error: unknown,\n  visited = new Set<unknown>(),\n): boolean {\n  if (!error || visited.has(error)) {\n    return false;\n  }\n  visited.add(error);\n\n  if (typeof error === 'string') {\n    return isUserRejectionString(error);\n  }\n\n  if (typeof error !== 'object') {\n    return false;\n  }\n\n  const errorObject = error as ErrorLikeObject;\n\n  if (isHardwareWalletConnectionClosedError(error)) {\n    return false;\n  }\n\n  if (isProviderUserRejectedCode(errorObject.code)) {\n    return true;\n  }\n\n  return (\n    isUserRejectionLikeError(errorObject.code, visited) ||\n    isUserRejectionLikeError(errorObject.message, visited) ||\n    isUserRejectionLikeError(errorObject.stack, visited) ||\n    isUserRejectionLikeError(errorObject.cause, visited) ||\n    isUserRejectionLikeError(errorObject.originalError, visited)\n  );\n}\n\n/**\n * Resolves a hardware-wallet error code for user rejection-like errors.\n *\n * @param error - The error value to inspect.\n * @returns `UserRejected` or `UserCancelled` when detected, otherwise `undefined`.\n */\nexport function resolveUserRejectionErrorCode(\n  error: unknown,\n): ErrorCode.UserCancelled | ErrorCode.UserRejected | undefined {\n  if (!isUserRejectionLikeError(error)) {\n    return undefined;\n  }\n\n  if (typeof error === 'string') {\n    return isUserRejectedString(error)\n      ? ErrorCode.UserRejected\n      : ErrorCode.UserCancelled;\n  }\n\n  const errorObject = error as ErrorLikeObject;\n\n  if (typeof errorObject.message === 'string') {\n    if (isUserRejectedString(errorObject.message)) {\n      return ErrorCode.UserRejected;\n    }\n    if (isUserRejectionString(errorObject.message)) {\n      return ErrorCode.UserCancelled;\n    }\n  }\n\n  if (typeof errorObject.code === 'string') {\n    if (isUserRejectedString(errorObject.code)) {\n      return ErrorCode.UserRejected;\n    }\n    if (isUserRejectionString(errorObject.code)) {\n      return ErrorCode.UserCancelled;\n    }\n  }\n\n  if (errorObject.cause !== undefined) {\n    const causeCode = resolveUserRejectionErrorCode(errorObject.cause);\n    if (causeCode !== undefined) {\n      return causeCode;\n    }\n  }\n\n  if (errorObject.originalError !== undefined) {\n    const originalCode = resolveUserRejectionErrorCode(\n      errorObject.originalError,\n    );\n    if (originalCode !== undefined) {\n      return originalCode;\n    }\n  }\n\n  return ErrorCode.UserCancelled;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/hw-wallet-sdk",
-  "version": "0.8.0-e5bc458",
+  "version": "0.9.0-e51c895",
   "description": "MetaMask Hardware Device SDK",
   "keywords": [
     "hardware-wallet",