@ledgerhq/device-contacts-kit 0.2.0 → 0.3.1

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressScope/EditExternalAddressScopeDeviceAction.test.ts"],
+  "sourcesContent": ["import {\n  CommandResultFactory,\n  type DeviceActionState,\n  DeviceActionStatus,\n  DeviceModelId,\n  DeviceSessionStateType,\n  DeviceStatus,\n  UnknownDAError,\n  UserInteractionRequired,\n} from \"@ledgerhq/device-management-kit\";\nimport { beforeEach, describe, it, vi } from \"vitest\";\n\nimport {\n  type EditExternalAddressScopeDAError,\n  type EditExternalAddressScopeDAInput,\n  type EditExternalAddressScopeDAIntermediateValue,\n  type EditExternalAddressScopeDAOutput,\n} from \"@api/app-binder/EditExternalAddressScopeDeviceActionTypes\";\nimport { makeDeviceActionInternalApiMock } from \"@internal/app-binder/device-action/__test-utils__/makeInternalApi\";\nimport { setupOpenAppDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupOpenAppDAMock\";\nimport { setupWaitForAppAndVersionDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupWaitForAppAndVersionDAMock\";\nimport { testDeviceActionStates } from \"@internal/app-binder/device-action/__test-utils__/testDeviceActionStates\";\nimport {\n  ContactsCommandError,\n  ContactsVersionRequirementError,\n} from \"@internal/app-binder/model/contactsErrors\";\n\nimport { EditExternalAddressScopeDeviceAction } from \"./EditExternalAddressScopeDeviceAction\";\nimport { validateEditExternalAddressScopeInput } from \"./validateEditExternalAddressScopeInput\";\n\nvi.mock(\"@ledgerhq/device-management-kit\", async (importOriginal) => {\n  const original =\n    // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n    await importOriginal<typeof import(\"@ledgerhq/device-management-kit\")>();\n  return {\n    ...original,\n    OpenAppDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n    WaitForAppAndVersionDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n  };\n});\n\nconst FRESH_APP = { name: \"Ethereum\", version: \"1.15.0\" };\n\nconst GROUP_HANDLE = new Uint8Array(64).fill(0xcc);\nconst HMAC_PROOF = new Uint8Array(32).fill(0xdd);\nconst HMAC_REST_OLD = new Uint8Array(32).fill(0xaa);\nconst HMAC_REST_NEW = new Uint8Array(32).fill(0x88);\nconst IDENTIFIER = new Uint8Array(20).fill(0x11);\n\nconst OK_PROOF = { hmacRest: HMAC_REST_NEW };\n\nconst BASE_INPUT = {\n  contactName: \"Alice\",\n  previousScope: \"Eth main\",\n  newScope: \"Eth cold\",\n  identifier: IDENTIFIER,\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: GROUP_HANDLE,\n  hmacProof: HMAC_PROOF,\n  hmacRest: HMAC_REST_OLD,\n  appName: \"Ethereum\",\n};\n\nconst EXPECTED_OUTPUT = {\n  contactName: \"Alice\",\n  previousScope: \"Eth main\",\n  scope: \"Eth cold\",\n  identifier: IDENTIFIER,\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: GROUP_HANDLE,\n  // Preserved: the group-level name proof is unchanged by a scope edit.\n  hmacProof: HMAC_PROOF,\n  // Rotated: only the address-level proof changes.\n  hmacRest: HMAC_REST_NEW,\n};\n\ndescribe(\"EditExternalAddressScopeDeviceAction\", () => {\n  let apiMock: ReturnType<typeof makeDeviceActionInternalApiMock>;\n  let isSupportedMock: ReturnType<typeof vi.fn>;\n  let editScopeMock: ReturnType<typeof vi.fn>;\n\n  function extractDeps() {\n    return {\n      isSupported: isSupportedMock,\n      editScope: editScopeMock,\n    };\n  }\n\n  beforeEach(() => {\n    apiMock = makeDeviceActionInternalApiMock();\n    setupWaitForAppAndVersionDAMock(FRESH_APP);\n    isSupportedMock = vi.fn().mockReturnValue(true);\n    editScopeMock = vi\n      .fn()\n      .mockResolvedValue(CommandResultFactory({ data: OK_PROOF }));\n    apiMock.getDeviceSessionState.mockReturnValue({\n      sessionStateType: DeviceSessionStateType.ReadyWithoutSecureChannel,\n      deviceStatus: DeviceStatus.CONNECTED,\n      installedApps: [],\n      currentApp: { name: \"Ethereum\", version: \"1.15.0\" },\n      deviceModelId: DeviceModelId.FLEX,\n      isSecureConnectionAllowed: true,\n    });\n  });\n\n  function makeAction(input: EditExternalAddressScopeDAInput) {\n    const action = new EditExternalAddressScopeDeviceAction({ input });\n    vi.spyOn(action, \"extractDependencies\").mockReturnValue(extractDeps());\n    return action;\n  }\n\n  it(\"open-app path: OpenApp -> VersionGuard -> EditScope -> Completed\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: false });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.ConfirmOpenApp,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n\n  it(\"skip-open-app path: VersionGuard -> EditScope -> Completed, preserving the group proof and identifier\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          try {\n            // The device rotates only the address-level hmac_rest; the contact\n            // group's name proof and the entry's identifier pass through\n            // unchanged.\n            expect(EXPECTED_OUTPUT.hmacProof).toBe(HMAC_PROOF);\n            expect(EXPECTED_OUTPUT.identifier).toBe(IDENTIFIER);\n            expect(EXPECTED_OUTPUT.hmacRest).toBe(HMAC_REST_NEW);\n            expect(EXPECTED_OUTPUT.hmacRest).not.toBe(HMAC_REST_OLD);\n            resolve();\n          } catch (e) {\n            reject(e as Error);\n          }\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"version guard rejects on skip-open-app path without running EDIT SCOPE\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      isSupportedMock.mockReturnValue(false);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: new ContactsVersionRequirementError(),\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"surfaces an open-app failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      const openAppError = new UnknownDAError(\"open app failed\");\n      setupOpenAppDAMock(openAppError);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: false });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.ConfirmOpenApp,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: openAppError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"surfaces an Edit Scope command error\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const commandError = new ContactsCommandError({\n        errorCode: \"6982\",\n        message: \"seed mismatch\",\n      });\n      editScopeMock.mockResolvedValue(\n        CommandResultFactory({ error: commandError }),\n      );\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: commandError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces invalid input as a typed error state on the skip-open-app path\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const invalidInput = {\n        ...BASE_INPUT,\n        skipOpenApp: true,\n        contactName: \"\",\n      };\n      const validationError =\n        validateEditExternalAddressScopeInput(invalidInput);\n      const action = makeAction(invalidInput);\n\n      const expected = [\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"validates only after opening the app on the default path\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const invalidInput = {\n        ...BASE_INPUT,\n        skipOpenApp: false,\n        contactName: \"\",\n      };\n      const validationError =\n        validateEditExternalAddressScopeInput(invalidInput);\n      const action = makeAction(invalidInput);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.ConfirmOpenApp,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"evaluates support from the fresh WaitForAppAndVersion result, not stale session state\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const freshApp = { name: \"Ethereum\", version: \"9.9.9\" };\n      setupWaitForAppAndVersionDAMock(freshApp);\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          try {\n            expect(isSupportedMock).toHaveBeenCalledWith(freshApp);\n            resolve();\n          } catch (e) {\n            reject(e as Error);\n          }\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a WaitForAppAndVersion failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      const waitError = new UnknownDAError(\"could not read app and version\");\n      setupWaitForAppAndVersionDAMock({ error: waitError });\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: waitError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n      expect(isSupportedMock).not.toHaveBeenCalled();\n      expect(editScopeMock).not.toHaveBeenCalled();\n    }));\n\n  it(\"propagates the UnlockDevice interaction emitted by WaitForAppAndVersion\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupOpenAppDAMock();\n      setupWaitForAppAndVersionDAMock(\n        FRESH_APP,\n        UserInteractionRequired.UnlockDevice,\n      );\n      const action = makeAction({ ...BASE_INPUT, skipOpenApp: true });\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        EditExternalAddressScopeDAOutput,\n        EditExternalAddressScopeDAError,\n        EditExternalAddressScopeDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n});\n"],
+  "mappings": "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",
+  "names": ["CommandResultFactory", "DeviceActionStatus", "DeviceModelId", "DeviceSessionStateType", "DeviceStatus", "UnknownDAError", "UserInteractionRequired", "beforeEach", "describe", "it", "vi", "makeDeviceActionInternalApiMock", "setupOpenAppDAMock", "setupWaitForAppAndVersionDAMock", "testDeviceActionStates", "ContactsCommandError", "ContactsVersionRequirementError", "EditExternalAddressScopeDeviceAction", "validateEditExternalAddressScopeInput", "importOriginal", "FRESH_APP", "GROUP_HANDLE", "HMAC_PROOF", "HMAC_REST_OLD", "HMAC_REST_NEW", "IDENTIFIER", "OK_PROOF", "BASE_INPUT", "EXPECTED_OUTPUT", "apiMock", "isSupportedMock", "editScopeMock", "extractDeps", "makeAction", "input", "action", "resolve", "reject", "expected", "e", "openAppError", "commandError", "invalidInput", "validationError", "freshApp", "waitError"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.js

@@ -0,0 +1,2 @@
+import{BLOCKCHAIN_FAMILY_BY_NAME as n}from"../../../app-binder/model/contactsConstants";import{CONTACT_NAME_BUFFER_LENGTH as c,ContactsValidationError as r,ETH_ADDRESS_BYTES as f,GROUP_HANDLE_SIZE as l,HMAC_PROOF_LENGTH as d,SCOPE_BUFFER_LENGTH as a,validateByteLength as i,validateChainId as h,validatePrintableLabel as o}from"../../../app-binder/model/contactsValidation";const s=d;function _(e){try{o(e.contactName,{field:"contactName",bufferLength:c}),o(e.previousScope,{field:"previousScope",bufferLength:a}),o(e.newScope,{field:"newScope",bufferLength:a});const t=e.blockchainFamily.toLowerCase();if(!(t in n))throw new r(`Unsupported blockchain family: ${e.blockchainFamily}`);if(t==="ethereum"){if(i(e.identifier,{field:"identifier",expectedBytes:f}),e.chainId===void 0)throw new r("chainId is required for the Ethereum blockchain family.")}else if(e.identifier.length===0)throw new r("identifier must not be empty.");return e.chainId!==void 0&&h(e.chainId),i(e.groupHandle,{field:"groupHandle",expectedBytes:l}),i(e.hmacProof,{field:"hmacProof",expectedBytes:d}),i(e.hmacRest,{field:"hmacRest",expectedBytes:s}),null}catch(t){if(t instanceof r)return t;throw t}}export{_ as validateEditExternalAddressScopeInput};
+//# sourceMappingURL=validateEditExternalAddressScopeInput.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.ts"],
+  "sourcesContent": ["import { type EditExternalAddressScopeInput } from \"@api/model/EditExternalAddressScope\";\nimport { BLOCKCHAIN_FAMILY_BY_NAME } from \"@internal/app-binder/model/contactsConstants\";\nimport {\n  CONTACT_NAME_BUFFER_LENGTH,\n  ContactsValidationError,\n  ETH_ADDRESS_BYTES,\n  GROUP_HANDLE_SIZE,\n  HMAC_PROOF_LENGTH,\n  SCOPE_BUFFER_LENGTH,\n  validateByteLength,\n  validateChainId,\n  validatePrintableLabel,\n} from \"@internal/app-binder/model/contactsValidation\";\n\n// The address-level proof (`hmac_rest`) shares the 32-byte HMAC width.\nconst HMAC_REST_LENGTH = HMAC_PROOF_LENGTH;\n\n/**\n * Validate the caller input for Edit External Address Scope. Returns the first\n * `ContactsValidationError`, or `null` when valid. Non-throwing so the device\n * action can surface it as a typed terminal error state.\n */\nexport function validateEditExternalAddressScopeInput(\n  input: EditExternalAddressScopeInput,\n): ContactsValidationError | null {\n  try {\n    validatePrintableLabel(input.contactName, {\n      field: \"contactName\",\n      bufferLength: CONTACT_NAME_BUFFER_LENGTH,\n    });\n    validatePrintableLabel(input.previousScope, {\n      field: \"previousScope\",\n      bufferLength: SCOPE_BUFFER_LENGTH,\n    });\n    validatePrintableLabel(input.newScope, {\n      field: \"newScope\",\n      bufferLength: SCOPE_BUFFER_LENGTH,\n    });\n\n    const family = input.blockchainFamily.toLowerCase();\n    if (!(family in BLOCKCHAIN_FAMILY_BY_NAME)) {\n      throw new ContactsValidationError(\n        `Unsupported blockchain family: ${input.blockchainFamily}`,\n      );\n    }\n    if (family === \"ethereum\") {\n      validateByteLength(input.identifier, {\n        field: \"identifier\",\n        expectedBytes: ETH_ADDRESS_BYTES,\n      });\n      // CHAIN_ID is mandatory for the Ethereum family (multiple networks share\n      // the same address format).\n      if (input.chainId === undefined) {\n        throw new ContactsValidationError(\n          \"chainId is required for the Ethereum blockchain family.\",\n        );\n      }\n    } else {\n      if (input.identifier.length === 0) {\n        throw new ContactsValidationError(\"identifier must not be empty.\");\n      }\n    }\n\n    if (input.chainId !== undefined) {\n      validateChainId(input.chainId);\n    }\n\n    validateByteLength(input.groupHandle, {\n      field: \"groupHandle\",\n      expectedBytes: GROUP_HANDLE_SIZE,\n    });\n    validateByteLength(input.hmacProof, {\n      field: \"hmacProof\",\n      expectedBytes: HMAC_PROOF_LENGTH,\n    });\n    validateByteLength(input.hmacRest, {\n      field: \"hmacRest\",\n      expectedBytes: HMAC_REST_LENGTH,\n    });\n\n    return null;\n  } catch (error) {\n    if (error instanceof ContactsValidationError) {\n      return error;\n    }\n    throw error;\n  }\n}\n"],
+  "mappings": "AACA,OAAS,6BAAAA,MAAiC,+CAC1C,OACE,8BAAAC,EACA,2BAAAC,EACA,qBAAAC,EACA,qBAAAC,EACA,qBAAAC,EACA,uBAAAC,EACA,sBAAAC,EACA,mBAAAC,EACA,0BAAAC,MACK,gDAGP,MAAMC,EAAmBL,EAOlB,SAASM,EACdC,EACgC,CAChC,GAAI,CACFH,EAAuBG,EAAM,YAAa,CACxC,MAAO,cACP,aAAcX,CAChB,CAAC,EACDQ,EAAuBG,EAAM,cAAe,CAC1C,MAAO,gBACP,aAAcN,CAChB,CAAC,EACDG,EAAuBG,EAAM,SAAU,CACrC,MAAO,WACP,aAAcN,CAChB,CAAC,EAED,MAAMO,EAASD,EAAM,iBAAiB,YAAY,EAClD,GAAI,EAAEC,KAAUb,GACd,MAAM,IAAIE,EACR,kCAAkCU,EAAM,gBAAgB,EAC1D,EAEF,GAAIC,IAAW,YAOb,GANAN,EAAmBK,EAAM,WAAY,CACnC,MAAO,aACP,cAAeT,CACjB,CAAC,EAGGS,EAAM,UAAY,OACpB,MAAM,IAAIV,EACR,yDACF,UAGEU,EAAM,WAAW,SAAW,EAC9B,MAAM,IAAIV,EAAwB,+BAA+B,EAIrE,OAAIU,EAAM,UAAY,QACpBJ,EAAgBI,EAAM,OAAO,EAG/BL,EAAmBK,EAAM,YAAa,CACpC,MAAO,cACP,cAAeR,CACjB,CAAC,EACDG,EAAmBK,EAAM,UAAW,CAClC,MAAO,YACP,cAAeP,CACjB,CAAC,EACDE,EAAmBK,EAAM,SAAU,CACjC,MAAO,WACP,cAAeF,CACjB,CAAC,EAEM,IACT,OAASI,EAAO,CACd,GAAIA,aAAiBZ,EACnB,OAAOY,EAET,MAAMA,CACR,CACF",
+  "names": ["BLOCKCHAIN_FAMILY_BY_NAME", "CONTACT_NAME_BUFFER_LENGTH", "ContactsValidationError", "ETH_ADDRESS_BYTES", "GROUP_HANDLE_SIZE", "HMAC_PROOF_LENGTH", "SCOPE_BUFFER_LENGTH", "validateByteLength", "validateChainId", "validatePrintableLabel", "HMAC_REST_LENGTH", "validateEditExternalAddressScopeInput", "input", "family", "error"]
+}

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.test.js

@@ -0,0 +1,2 @@
+import{ContactsValidationError as r}from"../../../app-binder/model/contactsValidation";import{validateEditExternalAddressScopeInput as t}from"./validateEditExternalAddressScopeInput";const n={contactName:"Alice",previousScope:"Eth main",newScope:"Eth cold",identifier:new Uint8Array(20).fill(17),blockchainFamily:"ethereum",chainId:1n,groupHandle:new Uint8Array(64).fill(204),hmacProof:new Uint8Array(32).fill(221),hmacRest:new Uint8Array(32).fill(170)};describe("validateEditExternalAddressScopeInput",()=>{it("returns null for a valid input",()=>{expect(t(n)).toBeNull()}),it("rejects an empty contactName",()=>{const e=t({...n,contactName:""});expect(e).toBeInstanceOf(r)}),it("rejects a non-printable previousScope",()=>{const e=t({...n,previousScope:"caf\xE9"});expect(e).toBeInstanceOf(r)}),it("rejects a non-printable newScope",()=>{const e=t({...n,newScope:"caf\xE9"});expect(e).toBeInstanceOf(r)}),it("rejects an unsupported blockchain family",()=>{const e=t({...n,blockchainFamily:"dogecoin"});expect(e).toBeInstanceOf(r)}),it("rejects an identifier of the wrong length for Ethereum",()=>{const e=t({...n,identifier:new Uint8Array(19).fill(17)});expect(e).toBeInstanceOf(r)}),it("requires chainId for the Ethereum family",()=>{const e=t({...n,chainId:void 0});expect(e).toBeInstanceOf(r)}),it("rejects a groupHandle of the wrong length",()=>{const e=t({...n,groupHandle:new Uint8Array(63).fill(204)});expect(e).toBeInstanceOf(r)}),it("rejects an hmacProof of the wrong length",()=>{const e=t({...n,hmacProof:new Uint8Array(31).fill(221)});expect(e).toBeInstanceOf(r)}),it("rejects an hmacRest of the wrong length",()=>{const e=t({...n,hmacRest:new Uint8Array(33).fill(170)});expect(e).toBeInstanceOf(r)})});
+//# sourceMappingURL=validateEditExternalAddressScopeInput.test.js.map

package/lib/esm/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/EditExternalAddressScope/validateEditExternalAddressScopeInput.test.ts"],
+  "sourcesContent": ["import { type EditExternalAddressScopeInput } from \"@api/model/EditExternalAddressScope\";\nimport { ContactsValidationError } from \"@internal/app-binder/model/contactsValidation\";\n\nimport { validateEditExternalAddressScopeInput } from \"./validateEditExternalAddressScopeInput\";\n\nconst VALID_INPUT: EditExternalAddressScopeInput = {\n  contactName: \"Alice\",\n  previousScope: \"Eth main\",\n  newScope: \"Eth cold\",\n  identifier: new Uint8Array(20).fill(0x11),\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: new Uint8Array(64).fill(0xcc),\n  hmacProof: new Uint8Array(32).fill(0xdd),\n  hmacRest: new Uint8Array(32).fill(0xaa),\n};\n\ndescribe(\"validateEditExternalAddressScopeInput\", () => {\n  it(\"returns null for a valid input\", () => {\n    expect(validateEditExternalAddressScopeInput(VALID_INPUT)).toBeNull();\n  });\n\n  it(\"rejects an empty contactName\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      contactName: \"\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a non-printable previousScope\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      previousScope: \"caf\u00E9\", // 0xC3 0xA9 is non-ASCII\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a non-printable newScope\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      newScope: \"caf\u00E9\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an unsupported blockchain family\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      blockchainFamily: \"dogecoin\",\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an identifier of the wrong length for Ethereum\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      identifier: new Uint8Array(19).fill(0x11),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"requires chainId for the Ethereum family\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      chainId: undefined,\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects a groupHandle of the wrong length\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      groupHandle: new Uint8Array(63).fill(0xcc),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an hmacProof of the wrong length\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      hmacProof: new Uint8Array(31).fill(0xdd),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"rejects an hmacRest of the wrong length\", () => {\n    const error = validateEditExternalAddressScopeInput({\n      ...VALID_INPUT,\n      hmacRest: new Uint8Array(33).fill(0xaa),\n    });\n    expect(error).toBeInstanceOf(ContactsValidationError);\n  });\n});\n"],
+  "mappings": "AACA,OAAS,2BAAAA,MAA+B,gDAExC,OAAS,yCAAAC,MAA6C,0CAEtD,MAAMC,EAA6C,CACjD,YAAa,QACb,cAAe,WACf,SAAU,WACV,WAAY,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,EACxC,iBAAkB,WAClB,QAAS,GACT,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACzC,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACvC,SAAU,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACxC,EAEA,SAAS,wCAAyC,IAAM,CACtD,GAAG,iCAAkC,IAAM,CACzC,OAAOD,EAAsCC,CAAW,CAAC,EAAE,SAAS,CACtE,CAAC,EAED,GAAG,+BAAgC,IAAM,CACvC,MAAMC,EAAQF,EAAsC,CAClD,GAAGC,EACH,YAAa,EACf,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,wCAAyC,IAAM,CAChD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,cAAe,SACjB,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,mCAAoC,IAAM,CAC3C,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,SAAU,SACZ,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,iBAAkB,UACpB,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,yDAA0D,IAAM,CACjE,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,WAAY,IAAI,WAAW,EAAE,EAAE,KAAK,EAAI,CAC1C,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,QAAS,MACX,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,4CAA6C,IAAM,CACpD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CAC3C,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,2CAA4C,IAAM,CACnD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACzC,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,EAED,GAAG,0CAA2C,IAAM,CAClD,MAAMG,EAAQF,EAAsC,CAClD,GAAGC,EACH,SAAU,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACxC,CAAC,EACD,OAAOC,CAAK,EAAE,eAAeH,CAAuB,CACtD,CAAC,CACH,CAAC",
+  "names": ["ContactsValidationError", "validateEditExternalAddressScopeInput", "VALID_INPUT", "error"]
+}

package/lib/esm/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.js

@@ -1,2 +1,2 @@
-import{isSuccessCommandResult as c,OpenAppDeviceAction as u,UnknownDAError as l,UserInteractionRequired as o,WaitForAppAndVersionDeviceAction as A,XStateDeviceAction as g}from"@ledgerhq/device-management-kit";import{Left as m,Right as E}from"purify-ts";import{assign as n,fromPromise as S,setup as R}from"xstate";import{isContactsSupportedForSession as I}from"../../../app-binder/isContactsSupportedForSession";import{ContactsVersionRequirementError as y}from"../../../app-binder/model/contactsErrors";import{SendRegisterIdentityTask as h}from"../../../app-binder/task/SendRegisterIdentityTask";import{validateRegisterExternalAddressInput as D}from"./validateRegisterExternalAddressInput";class O extends g{makeStateMachine(i){const{isSupported:p,registerIdentity:d}=this.extractDependencies(i),r=this.input.appName;return R({types:{input:{},context:{},output:{}},actors:{openAppStateMachine:new u({input:{appName:r}}).makeStateMachine(i),waitForAppAndVersionStateMachine:new A({input:{}}).makeStateMachine(i),registerIdentity:S(({input:e})=>d(e))},guards:{skipOpenApp:({context:e})=>e.input.skipOpenApp===!0,noInternalError:({context:e})=>e._internalState.error===null,contactsSupported:({context:e})=>{const{appAndVersion:t}=e._internalState;return t!==null&&p(t)}},actions:{assignValidationError:n({_internalState:({context:e})=>{const t=D(e.input);return t?{...e._internalState,error:t}:e._internalState}}),assignVersionError:n({_internalState:({context:e})=>({...e._internalState,error:new y})}),assignErrorFromEvent:n({_internalState:({context:e,event:t})=>({...e._internalState,error:new l(t.error instanceof Error?t.error.message:String(t.error))})})}}).createMachine({id:"RegisterExternalAddressDeviceAction",initial:"InitialState",context:({input:e})=>({input:e,intermediateValue:{requiredUserInteraction:o.None},_internalState:{error:null,appAndVersion:null,proofs:null}}),states:{InitialState:{always:[{target:"ValidateInput",guard:"skipOpenApp"},{target:"OpenAppDeviceAction"}]},OpenAppDeviceAction:{invoke:{id:"openAppStateMachine",src:"openAppStateMachine",input:()=>({appName:r}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckOpenAppResult",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:()=>t._internalState,Left:a=>({...t._internalState,error:a})})})}}},CheckOpenAppResult:{always:[{target:"ValidateInput",guard:"noInternalError"},{target:"Error"}]},ValidateInput:{entry:"assignValidationError",always:[{target:"WaitForAppAndVersion",guard:"noInternalError"},{target:"Error"}]},WaitForAppAndVersion:{entry:n({intermediateValue:{requiredUserInteraction:o.None}}),invoke:{id:"waitForAppAndVersion",src:"waitForAppAndVersionStateMachine",input:()=>({}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckAppAndVersion",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:a=>({...t._internalState,appAndVersion:{name:a.name,version:a.version}}),Left:a=>({...t._internalState,error:a})})})}}},CheckAppAndVersion:{always:[{target:"VersionGuard",guard:"noInternalError"},{target:"Error"}]},VersionGuard:{always:[{target:"RegisterIdentity",guard:"contactsSupported"},{target:"Error",actions:"assignVersionError"}]},RegisterIdentity:{entry:n({intermediateValue:{requiredUserInteraction:o.RegisterWallet}}),exit:n({intermediateValue:{requiredUserInteraction:o.None}}),invoke:{id:"registerIdentity",src:"registerIdentity",input:({context:e})=>e.input,onDone:{target:"RegisterIdentityResultCheck",actions:n({_internalState:({event:e,context:t})=>c(e.output)?{...t._internalState,proofs:e.output.data}:{...t._internalState,error:e.output.error}})},onError:{target:"Error",actions:"assignErrorFromEvent"}}},RegisterIdentityResultCheck:{always:[{target:"Success",guard:"noInternalError"},{target:"Error"}]},Success:{type:"final"},Error:{type:"final"}},output:({context:e})=>{const{proofs:t,error:a}=e._internalState;if(t){const{input:s}=e;return E({mode:s.existingContactGroup?"existingContactGroup":"newContactGroup",contactName:s.contactName,scope:s.scope,identifier:s.identifier,blockchainFamily:s.blockchainFamily,chainId:s.chainId,groupHandle:t.groupHandle,hmacProof:t.hmacProof,hmacRest:t.hmacRest})}return m(a??new l("No error in final state"))}})}extractDependencies(i){return{isSupported:r=>I(i,r),registerIdentity:r=>new h(i,{contactName:r.contactName,scope:r.scope,identifier:r.identifier,blockchainFamily:r.blockchainFamily,chainId:r.chainId,existingContactGroup:r.existingContactGroup}).run()}}}export{O as RegisterExternalAddressDeviceAction};
+import{isSuccessCommandResult as c,OpenAppDeviceAction as u,UnknownDAError as l,UserInteractionRequired as o,WaitForAppAndVersionDeviceAction as A,XStateDeviceAction as g}from"@ledgerhq/device-management-kit";import{Left as m,Right as E}from"purify-ts";import{assign as n,fromPromise as S,setup as R}from"xstate";import{isContactsAppVersionSupportedForSession as I}from"../../../app-binder/contactsVersionGuards";import{ContactsVersionRequirementError as y}from"../../../app-binder/model/contactsErrors";import{SendRegisterIdentityTask as h}from"../../../app-binder/task/SendRegisterIdentityTask";import{validateRegisterExternalAddressInput as D}from"./validateRegisterExternalAddressInput";class O extends g{makeStateMachine(i){const{isSupported:p,registerIdentity:d}=this.extractDependencies(i),r=this.input.appName;return R({types:{input:{},context:{},output:{}},actors:{openAppStateMachine:new u({input:{appName:r}}).makeStateMachine(i),waitForAppAndVersionStateMachine:new A({input:{}}).makeStateMachine(i),registerIdentity:S(({input:e})=>d(e))},guards:{skipOpenApp:({context:e})=>e.input.skipOpenApp===!0,noInternalError:({context:e})=>e._internalState.error===null,contactsSupported:({context:e})=>{const{appAndVersion:t}=e._internalState;return t!==null&&p(t)}},actions:{assignValidationError:n({_internalState:({context:e})=>{const t=D(e.input);return t?{...e._internalState,error:t}:e._internalState}}),assignVersionError:n({_internalState:({context:e})=>({...e._internalState,error:new y})}),assignErrorFromEvent:n({_internalState:({context:e,event:t})=>({...e._internalState,error:new l(t.error instanceof Error?t.error.message:String(t.error))})})}}).createMachine({id:"RegisterExternalAddressDeviceAction",initial:"InitialState",context:({input:e})=>({input:e,intermediateValue:{requiredUserInteraction:o.None},_internalState:{error:null,appAndVersion:null,proofs:null}}),states:{InitialState:{always:[{target:"ValidateInput",guard:"skipOpenApp"},{target:"OpenAppDeviceAction"}]},OpenAppDeviceAction:{invoke:{id:"openAppStateMachine",src:"openAppStateMachine",input:()=>({appName:r}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckOpenAppResult",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:()=>t._internalState,Left:a=>({...t._internalState,error:a})})})}}},CheckOpenAppResult:{always:[{target:"ValidateInput",guard:"noInternalError"},{target:"Error"}]},ValidateInput:{entry:"assignValidationError",always:[{target:"WaitForAppAndVersion",guard:"noInternalError"},{target:"Error"}]},WaitForAppAndVersion:{entry:n({intermediateValue:{requiredUserInteraction:o.None}}),invoke:{id:"waitForAppAndVersion",src:"waitForAppAndVersionStateMachine",input:()=>({}),onSnapshot:{actions:n({intermediateValue:({event:e})=>e.snapshot.context.intermediateValue})},onDone:{target:"CheckAppAndVersion",actions:n({_internalState:({event:e,context:t})=>e.output.caseOf({Right:a=>({...t._internalState,appAndVersion:{name:a.name,version:a.version}}),Left:a=>({...t._internalState,error:a})})})}}},CheckAppAndVersion:{always:[{target:"VersionGuard",guard:"noInternalError"},{target:"Error"}]},VersionGuard:{always:[{target:"RegisterIdentity",guard:"contactsSupported"},{target:"Error",actions:"assignVersionError"}]},RegisterIdentity:{entry:n({intermediateValue:{requiredUserInteraction:o.RegisterWallet}}),exit:n({intermediateValue:{requiredUserInteraction:o.None}}),invoke:{id:"registerIdentity",src:"registerIdentity",input:({context:e})=>e.input,onDone:{target:"RegisterIdentityResultCheck",actions:n({_internalState:({event:e,context:t})=>c(e.output)?{...t._internalState,proofs:e.output.data}:{...t._internalState,error:e.output.error}})},onError:{target:"Error",actions:"assignErrorFromEvent"}}},RegisterIdentityResultCheck:{always:[{target:"Success",guard:"noInternalError"},{target:"Error"}]},Success:{type:"final"},Error:{type:"final"}},output:({context:e})=>{const{proofs:t,error:a}=e._internalState;if(t){const{input:s}=e;return E({mode:s.existingContactGroup?"existingContactGroup":"newContactGroup",contactName:s.contactName,scope:s.scope,identifier:s.identifier,blockchainFamily:s.blockchainFamily,chainId:s.chainId,groupHandle:t.groupHandle,hmacProof:t.hmacProof,hmacRest:t.hmacRest})}return m(a??new l("No error in final state"))}})}extractDependencies(i){return{isSupported:r=>I(i,r),registerIdentity:r=>new h(i,{contactName:r.contactName,scope:r.scope,identifier:r.identifier,blockchainFamily:r.blockchainFamily,chainId:r.chainId,existingContactGroup:r.existingContactGroup}).run()}}}export{O as RegisterExternalAddressDeviceAction};
 //# sourceMappingURL=RegisterExternalAddressDeviceAction.js.map

package/lib/esm/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../src/internal/app-binder/device-action/RegisterExternalAddress/RegisterExternalAddressDeviceAction.ts"],
-  "sourcesContent": ["import {\n  type DeviceActionStateMachine,\n  type InternalApi,\n  isSuccessCommandResult,\n  OpenAppDeviceAction,\n  type StateMachineTypes,\n  UnknownDAError,\n  UserInteractionRequired,\n  WaitForAppAndVersionDeviceAction,\n  XStateDeviceAction,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport {\n  type RegisterExternalAddressDAError,\n  type RegisterExternalAddressDAInput,\n  type RegisterExternalAddressDAIntermediateValue,\n  type RegisterExternalAddressDAInternalState,\n  type RegisterExternalAddressDAOutput,\n} from \"@api/app-binder/RegisterExternalAddressDeviceActionTypes\";\nimport {\n  isContactsSupportedForSession,\n  type RunningApp,\n} from \"@internal/app-binder/isContactsSupportedForSession\";\nimport { ContactsVersionRequirementError } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  type RegisterIdentityProofs,\n  SendRegisterIdentityTask,\n} from \"@internal/app-binder/task/SendRegisterIdentityTask\";\n\nimport { validateRegisterExternalAddressInput } from \"./validateRegisterExternalAddressInput\";\n\nexport type RegisterExternalAddressMachineDependencies = {\n  readonly isSupported: (app: RunningApp) => boolean;\n  readonly registerIdentity: (\n    input: RegisterExternalAddressDAInput,\n  ) => Promise<Awaited<ReturnType<SendRegisterIdentityTask[\"run\"]>>>;\n};\n\nexport class RegisterExternalAddressDeviceAction extends XStateDeviceAction<\n  RegisterExternalAddressDAOutput,\n  RegisterExternalAddressDAInput,\n  RegisterExternalAddressDAError,\n  RegisterExternalAddressDAIntermediateValue,\n  RegisterExternalAddressDAInternalState\n> {\n  makeStateMachine(\n    internalApi: InternalApi,\n  ): DeviceActionStateMachine<\n    RegisterExternalAddressDAOutput,\n    RegisterExternalAddressDAInput,\n    RegisterExternalAddressDAError,\n    RegisterExternalAddressDAIntermediateValue,\n    RegisterExternalAddressDAInternalState\n  > {\n    type types = StateMachineTypes<\n      RegisterExternalAddressDAOutput,\n      RegisterExternalAddressDAInput,\n      RegisterExternalAddressDAError,\n      RegisterExternalAddressDAIntermediateValue,\n      RegisterExternalAddressDAInternalState\n    >;\n\n    const { isSupported, registerIdentity } =\n      this.extractDependencies(internalApi);\n    const appName = this.input.appName;\n\n    return setup({\n      types: {\n        input: {} as types[\"input\"],\n        context: {} as types[\"context\"],\n        output: {} as types[\"output\"],\n      },\n      actors: {\n        openAppStateMachine: new OpenAppDeviceAction({\n          input: { appName },\n        }).makeStateMachine(internalApi),\n        waitForAppAndVersionStateMachine: new WaitForAppAndVersionDeviceAction({\n          input: {},\n        }).makeStateMachine(internalApi),\n        registerIdentity: fromPromise(\n          ({ input }: { input: RegisterExternalAddressDAInput }) =>\n            registerIdentity(input),\n        ),\n      },\n      guards: {\n        skipOpenApp: ({ context }) => context.input.skipOpenApp === true,\n        noInternalError: ({ context }) => context._internalState.error === null,\n        contactsSupported: ({ context }) => {\n          const { appAndVersion } = context._internalState;\n          return appAndVersion !== null && isSupported(appAndVersion);\n        },\n      },\n      actions: {\n        assignValidationError: assign({\n          _internalState: ({ context }) => {\n            const error = validateRegisterExternalAddressInput(context.input);\n            return error\n              ? { ...context._internalState, error }\n              : context._internalState;\n          },\n        }),\n        assignVersionError: assign({\n          _internalState: ({ context }) => ({\n            ...context._internalState,\n            error: new ContactsVersionRequirementError(),\n          }),\n        }),\n        assignErrorFromEvent: assign({\n          _internalState: ({ context, event }) => ({\n            ...context._internalState,\n            error: new UnknownDAError(\n              event[\"error\"] instanceof Error\n                ? event[\"error\"].message\n                : String(event[\"error\"]),\n            ),\n          }),\n        }),\n      },\n    }).createMachine({\n      id: \"RegisterExternalAddressDeviceAction\",\n      initial: \"InitialState\",\n      context: ({ input }) => ({\n        input,\n        intermediateValue: {\n          requiredUserInteraction: UserInteractionRequired.None,\n        },\n        _internalState: {\n          error: null,\n          appAndVersion: null,\n          proofs: null,\n        },\n      }),\n      states: {\n        InitialState: {\n          always: [\n            { target: \"ValidateInput\", guard: \"skipOpenApp\" },\n            { target: \"OpenAppDeviceAction\" },\n          ],\n        },\n        OpenAppDeviceAction: {\n          invoke: {\n            id: \"openAppStateMachine\",\n            src: \"openAppStateMachine\",\n            input: () => ({ appName }),\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckOpenAppResult\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<RegisterExternalAddressDAInternalState>({\n                    Right: () => context._internalState,\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n          },\n        },\n        CheckOpenAppResult: {\n          always: [\n            { target: \"ValidateInput\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Input validation runs inside the device action (after the app is\n        // opened) so invalid caller input surfaces as a typed terminal error\n        // state on the observable instead of a synchronous throw. Runs on both\n        // the open-app and skip-open-app paths.\n        ValidateInput: {\n          entry: \"assignValidationError\",\n          always: [\n            { target: \"WaitForAppAndVersion\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Read the running app + version freshly from the device (rather than\n        // the possibly-stale session state) so the version guard evaluates the\n        // app that is actually running \u2014 e.g. when open-app is skipped and the\n        // app was changed outside DMK. Runs on both paths.\n        WaitForAppAndVersion: {\n          // Start the phase from a clean value, clearing any interaction left\n          // over from the OpenApp phase (e.g. ConfirmOpenApp).\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"waitForAppAndVersion\",\n            src: \"waitForAppAndVersionStateMachine\",\n            input: () => ({}),\n            // Propagate the child DA's intermediate value so a consuming client\n            // can render, e.g., a \"please unlock your device\" prompt when the\n            // device is locked. Mirrors the OpenAppDeviceAction invoke above.\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckAppAndVersion\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<RegisterExternalAddressDAInternalState>({\n                    Right: (appAndVersion) => ({\n                      ...context._internalState,\n                      appAndVersion: {\n                        name: appAndVersion.name,\n                        version: appAndVersion.version,\n                      },\n                    }),\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n          },\n        },\n        CheckAppAndVersion: {\n          always: [\n            { target: \"VersionGuard\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Version guard evaluates support from the fresh WaitForAppAndVersion\n        // result. Runs on both the open-app and skip-open-app paths.\n        VersionGuard: {\n          always: [\n            { target: \"RegisterIdentity\", guard: \"contactsSupported\" },\n            { target: \"Error\", actions: \"assignVersionError\" },\n          ],\n        },\n        RegisterIdentity: {\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n            },\n          }),\n          exit: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"registerIdentity\",\n            src: \"registerIdentity\",\n            input: ({ context }) => context.input,\n            onDone: {\n              target: \"RegisterIdentityResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? { ...context._internalState, proofs: event.output.data }\n                    : {\n                        ...context._internalState,\n                        error: event.output.error,\n                      },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        RegisterIdentityResultCheck: {\n          always: [\n            { target: \"Success\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        Success: { type: \"final\" },\n        Error: { type: \"final\" },\n      },\n      output: ({ context }) => {\n        const { proofs, error } = context._internalState;\n        if (proofs) {\n          const { input } = context;\n          return Right({\n            mode: input.existingContactGroup\n              ? (\"existingContactGroup\" as const)\n              : (\"newContactGroup\" as const),\n            contactName: input.contactName,\n            scope: input.scope,\n            identifier: input.identifier,\n            blockchainFamily: input.blockchainFamily,\n            chainId: input.chainId,\n            groupHandle: proofs.groupHandle,\n            hmacProof: proofs.hmacProof,\n            hmacRest: proofs.hmacRest,\n          });\n        }\n        return Left(error ?? new UnknownDAError(\"No error in final state\"));\n      },\n    });\n  }\n\n  extractDependencies(\n    internalApi: InternalApi,\n  ): RegisterExternalAddressMachineDependencies {\n    const isSupported = (app: RunningApp) =>\n      isContactsSupportedForSession(internalApi, app);\n\n    const registerIdentity = (\n      input: RegisterExternalAddressDAInput,\n    ): Promise<Awaited<ReturnType<SendRegisterIdentityTask[\"run\"]>>> =>\n      new SendRegisterIdentityTask(internalApi, {\n        contactName: input.contactName,\n        scope: input.scope,\n        identifier: input.identifier,\n        blockchainFamily: input.blockchainFamily,\n        chainId: input.chainId,\n        existingContactGroup: input.existingContactGroup,\n      }).run();\n\n    return { isSupported, registerIdentity };\n  }\n}\n\nexport type { RegisterIdentityProofs };\n"],
-  "mappings": "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",
-  "names": ["isSuccessCommandResult", "OpenAppDeviceAction", "UnknownDAError", "UserInteractionRequired", "WaitForAppAndVersionDeviceAction", "XStateDeviceAction", "Left", "Right", "assign", "fromPromise", "setup", "isContactsSupportedForSession", "ContactsVersionRequirementError", "SendRegisterIdentityTask", "validateRegisterExternalAddressInput", "RegisterExternalAddressDeviceAction", "internalApi", "isSupported", "registerIdentity", "appName", "input", "context", "appAndVersion", "error", "event", "proofs", "app"]
+  "sourcesContent": ["import {\n  type DeviceActionStateMachine,\n  type InternalApi,\n  isSuccessCommandResult,\n  OpenAppDeviceAction,\n  type StateMachineTypes,\n  UnknownDAError,\n  UserInteractionRequired,\n  WaitForAppAndVersionDeviceAction,\n  XStateDeviceAction,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport {\n  type RegisterExternalAddressDAError,\n  type RegisterExternalAddressDAInput,\n  type RegisterExternalAddressDAIntermediateValue,\n  type RegisterExternalAddressDAInternalState,\n  type RegisterExternalAddressDAOutput,\n} from \"@api/app-binder/RegisterExternalAddressDeviceActionTypes\";\nimport {\n  isContactsAppVersionSupportedForSession,\n  type RunningApp,\n} from \"@internal/app-binder/contactsVersionGuards\";\nimport { ContactsVersionRequirementError } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  type RegisterIdentityProofs,\n  SendRegisterIdentityTask,\n} from \"@internal/app-binder/task/SendRegisterIdentityTask\";\n\nimport { validateRegisterExternalAddressInput } from \"./validateRegisterExternalAddressInput\";\n\nexport type RegisterExternalAddressMachineDependencies = {\n  readonly isSupported: (app: RunningApp) => boolean;\n  readonly registerIdentity: (\n    input: RegisterExternalAddressDAInput,\n  ) => Promise<Awaited<ReturnType<SendRegisterIdentityTask[\"run\"]>>>;\n};\n\nexport class RegisterExternalAddressDeviceAction extends XStateDeviceAction<\n  RegisterExternalAddressDAOutput,\n  RegisterExternalAddressDAInput,\n  RegisterExternalAddressDAError,\n  RegisterExternalAddressDAIntermediateValue,\n  RegisterExternalAddressDAInternalState\n> {\n  makeStateMachine(\n    internalApi: InternalApi,\n  ): DeviceActionStateMachine<\n    RegisterExternalAddressDAOutput,\n    RegisterExternalAddressDAInput,\n    RegisterExternalAddressDAError,\n    RegisterExternalAddressDAIntermediateValue,\n    RegisterExternalAddressDAInternalState\n  > {\n    type types = StateMachineTypes<\n      RegisterExternalAddressDAOutput,\n      RegisterExternalAddressDAInput,\n      RegisterExternalAddressDAError,\n      RegisterExternalAddressDAIntermediateValue,\n      RegisterExternalAddressDAInternalState\n    >;\n\n    const { isSupported, registerIdentity } =\n      this.extractDependencies(internalApi);\n    const appName = this.input.appName;\n\n    return setup({\n      types: {\n        input: {} as types[\"input\"],\n        context: {} as types[\"context\"],\n        output: {} as types[\"output\"],\n      },\n      actors: {\n        openAppStateMachine: new OpenAppDeviceAction({\n          input: { appName },\n        }).makeStateMachine(internalApi),\n        waitForAppAndVersionStateMachine: new WaitForAppAndVersionDeviceAction({\n          input: {},\n        }).makeStateMachine(internalApi),\n        registerIdentity: fromPromise(\n          ({ input }: { input: RegisterExternalAddressDAInput }) =>\n            registerIdentity(input),\n        ),\n      },\n      guards: {\n        skipOpenApp: ({ context }) => context.input.skipOpenApp === true,\n        noInternalError: ({ context }) => context._internalState.error === null,\n        contactsSupported: ({ context }) => {\n          const { appAndVersion } = context._internalState;\n          return appAndVersion !== null && isSupported(appAndVersion);\n        },\n      },\n      actions: {\n        assignValidationError: assign({\n          _internalState: ({ context }) => {\n            const error = validateRegisterExternalAddressInput(context.input);\n            return error\n              ? { ...context._internalState, error }\n              : context._internalState;\n          },\n        }),\n        assignVersionError: assign({\n          _internalState: ({ context }) => ({\n            ...context._internalState,\n            error: new ContactsVersionRequirementError(),\n          }),\n        }),\n        assignErrorFromEvent: assign({\n          _internalState: ({ context, event }) => ({\n            ...context._internalState,\n            error: new UnknownDAError(\n              event[\"error\"] instanceof Error\n                ? event[\"error\"].message\n                : String(event[\"error\"]),\n            ),\n          }),\n        }),\n      },\n    }).createMachine({\n      id: \"RegisterExternalAddressDeviceAction\",\n      initial: \"InitialState\",\n      context: ({ input }) => ({\n        input,\n        intermediateValue: {\n          requiredUserInteraction: UserInteractionRequired.None,\n        },\n        _internalState: {\n          error: null,\n          appAndVersion: null,\n          proofs: null,\n        },\n      }),\n      states: {\n        InitialState: {\n          always: [\n            { target: \"ValidateInput\", guard: \"skipOpenApp\" },\n            { target: \"OpenAppDeviceAction\" },\n          ],\n        },\n        OpenAppDeviceAction: {\n          invoke: {\n            id: \"openAppStateMachine\",\n            src: \"openAppStateMachine\",\n            input: () => ({ appName }),\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckOpenAppResult\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<RegisterExternalAddressDAInternalState>({\n                    Right: () => context._internalState,\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n          },\n        },\n        CheckOpenAppResult: {\n          always: [\n            { target: \"ValidateInput\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Input validation runs inside the device action (after the app is\n        // opened) so invalid caller input surfaces as a typed terminal error\n        // state on the observable instead of a synchronous throw. Runs on both\n        // the open-app and skip-open-app paths.\n        ValidateInput: {\n          entry: \"assignValidationError\",\n          always: [\n            { target: \"WaitForAppAndVersion\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Read the running app + version freshly from the device (rather than\n        // the possibly-stale session state) so the version guard evaluates the\n        // app that is actually running \u2014 e.g. when open-app is skipped and the\n        // app was changed outside DMK. Runs on both paths.\n        WaitForAppAndVersion: {\n          // Start the phase from a clean value, clearing any interaction left\n          // over from the OpenApp phase (e.g. ConfirmOpenApp).\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"waitForAppAndVersion\",\n            src: \"waitForAppAndVersionStateMachine\",\n            input: () => ({}),\n            // Propagate the child DA's intermediate value so a consuming client\n            // can render, e.g., a \"please unlock your device\" prompt when the\n            // device is locked. Mirrors the OpenAppDeviceAction invoke above.\n            onSnapshot: {\n              actions: assign({\n                intermediateValue: ({ event }) =>\n                  event.snapshot.context.intermediateValue,\n              }),\n            },\n            onDone: {\n              target: \"CheckAppAndVersion\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<RegisterExternalAddressDAInternalState>({\n                    Right: (appAndVersion) => ({\n                      ...context._internalState,\n                      appAndVersion: {\n                        name: appAndVersion.name,\n                        version: appAndVersion.version,\n                      },\n                    }),\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n          },\n        },\n        CheckAppAndVersion: {\n          always: [\n            { target: \"VersionGuard\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Version guard evaluates support from the fresh WaitForAppAndVersion\n        // result. Runs on both the open-app and skip-open-app paths.\n        VersionGuard: {\n          always: [\n            { target: \"RegisterIdentity\", guard: \"contactsSupported\" },\n            { target: \"Error\", actions: \"assignVersionError\" },\n          ],\n        },\n        RegisterIdentity: {\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n            },\n          }),\n          exit: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"registerIdentity\",\n            src: \"registerIdentity\",\n            input: ({ context }) => context.input,\n            onDone: {\n              target: \"RegisterIdentityResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? { ...context._internalState, proofs: event.output.data }\n                    : {\n                        ...context._internalState,\n                        error: event.output.error,\n                      },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        RegisterIdentityResultCheck: {\n          always: [\n            { target: \"Success\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        Success: { type: \"final\" },\n        Error: { type: \"final\" },\n      },\n      output: ({ context }) => {\n        const { proofs, error } = context._internalState;\n        if (proofs) {\n          const { input } = context;\n          return Right({\n            mode: input.existingContactGroup\n              ? (\"existingContactGroup\" as const)\n              : (\"newContactGroup\" as const),\n            contactName: input.contactName,\n            scope: input.scope,\n            identifier: input.identifier,\n            blockchainFamily: input.blockchainFamily,\n            chainId: input.chainId,\n            groupHandle: proofs.groupHandle,\n            hmacProof: proofs.hmacProof,\n            hmacRest: proofs.hmacRest,\n          });\n        }\n        return Left(error ?? new UnknownDAError(\"No error in final state\"));\n      },\n    });\n  }\n\n  extractDependencies(\n    internalApi: InternalApi,\n  ): RegisterExternalAddressMachineDependencies {\n    const isSupported = (app: RunningApp) =>\n      isContactsAppVersionSupportedForSession(internalApi, app);\n\n    const registerIdentity = (\n      input: RegisterExternalAddressDAInput,\n    ): Promise<Awaited<ReturnType<SendRegisterIdentityTask[\"run\"]>>> =>\n      new SendRegisterIdentityTask(internalApi, {\n        contactName: input.contactName,\n        scope: input.scope,\n        identifier: input.identifier,\n        blockchainFamily: input.blockchainFamily,\n        chainId: input.chainId,\n        existingContactGroup: input.existingContactGroup,\n      }).run();\n\n    return { isSupported, registerIdentity };\n  }\n}\n\nexport type { RegisterIdentityProofs };\n"],
+  "mappings": "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",
+  "names": ["isSuccessCommandResult", "OpenAppDeviceAction", "UnknownDAError", "UserInteractionRequired", "WaitForAppAndVersionDeviceAction", "XStateDeviceAction", "Left", "Right", "assign", "fromPromise", "setup", "isContactsAppVersionSupportedForSession", "ContactsVersionRequirementError", "SendRegisterIdentityTask", "validateRegisterExternalAddressInput", "RegisterExternalAddressDeviceAction", "internalApi", "isSupported", "registerIdentity", "appName", "input", "context", "appAndVersion", "error", "event", "proofs", "app"]
 }

package/lib/esm/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.js

@@ -0,0 +1,2 @@
+import{GoToDashboardDeviceAction as m,isSuccessCommandResult as p,UnknownDAError as u,UserInteractionRequired as i,XStateDeviceAction as l}from"@ledgerhq/device-management-kit";import{Left as d,Right as C}from"purify-ts";import{assign as a,fromPromise as R,setup as S}from"xstate";import{isContactsOsSupportedForSession as D}from"../../../app-binder/contactsVersionGuards";import{ContactsVersionRequirementError as g}from"../../../app-binder/model/contactsErrors";import{SendRenameContactTask as A}from"../../../app-binder/task/SendRenameContactTask";import{validateRenameContactInput as I}from"./validateRenameContactInput";class k extends l{makeStateMachine(n){const{isOsSupported:c,renameContact:s}=this.extractDependencies(n);return S({types:{input:{},context:{},output:{}},actors:{goToDashboardStateMachine:new m({input:{}}).makeStateMachine(n),renameContact:R(({input:t})=>s(t))},guards:{noInternalError:({context:t})=>t._internalState.error===null,contactsOsSupported:()=>c()},actions:{assignValidationError:a({_internalState:({context:t})=>{const e=I(t.input);return e?{...t._internalState,error:e}:t._internalState}}),assignVersionError:a({_internalState:({context:t})=>({...t._internalState,error:new g})}),assignErrorFromEvent:a({_internalState:({context:t,event:e})=>({...t._internalState,error:new u(e.error instanceof Error?e.error.message:String(e.error))})})}}).createMachine({id:"RenameContactDeviceAction",initial:"InitialState",context:({input:t})=>({input:t,intermediateValue:{requiredUserInteraction:i.None},_internalState:{error:null,proof:null}}),states:{InitialState:{always:{target:"GoToDashboard"}},GoToDashboard:{invoke:{id:"goToDashboard",src:"goToDashboardStateMachine",input:()=>({}),onSnapshot:{actions:a({intermediateValue:({event:t})=>({requiredUserInteraction:t.snapshot.context.intermediateValue.requiredUserInteraction})})},onDone:{target:"GoToDashboardCheck",actions:a({_internalState:({event:t,context:e})=>t.output.caseOf({Right:()=>e._internalState,Left:r=>({...e._internalState,error:r})})})},onError:{target:"Error",actions:"assignErrorFromEvent"}}},GoToDashboardCheck:{always:[{target:"ValidateInput",guard:"noInternalError"},{target:"Error"}]},ValidateInput:{entry:"assignValidationError",always:[{target:"VersionGuard",guard:"noInternalError"},{target:"Error"}]},VersionGuard:{always:[{target:"RenameContact",guard:"contactsOsSupported"},{target:"Error",actions:"assignVersionError"}]},RenameContact:{entry:a({intermediateValue:{requiredUserInteraction:i.RegisterWallet}}),exit:a({intermediateValue:{requiredUserInteraction:i.None}}),invoke:{id:"renameContact",src:"renameContact",input:({context:t})=>t.input,onDone:{target:"RenameContactResultCheck",actions:a({_internalState:({event:t,context:e})=>p(t.output)?{...e._internalState,proof:t.output.data}:{...e._internalState,error:t.output.error}})},onError:{target:"Error",actions:"assignErrorFromEvent"}}},RenameContactResultCheck:{always:[{target:"Success",guard:"noInternalError"},{target:"Error"}]},Success:{type:"final"},Error:{type:"final"}},output:({context:t})=>{const{proof:e,error:r}=t._internalState;if(e){const{input:o}=t;return C({previousContactName:o.previousContactName,contactName:o.newContactName,groupHandle:o.groupHandle,hmacProof:e.hmacProof})}return d(r??new u("No error in final state"))}})}extractDependencies(n){return{isOsSupported:()=>D(n),renameContact:t=>new A(n,{previousContactName:t.previousContactName,newContactName:t.newContactName,groupHandle:t.groupHandle,hmacProof:t.hmacProof}).run()}}}export{k as RenameContactDeviceAction};
+//# sourceMappingURL=RenameContactDeviceAction.js.map

package/lib/esm/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.ts"],
+  "sourcesContent": ["import {\n  type DeviceActionStateMachine,\n  GoToDashboardDeviceAction,\n  type InternalApi,\n  isSuccessCommandResult,\n  type StateMachineTypes,\n  UnknownDAError,\n  UserInteractionRequired,\n  XStateDeviceAction,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { assign, fromPromise, setup } from \"xstate\";\n\nimport {\n  type RenameContactDAError,\n  type RenameContactDAInput,\n  type RenameContactDAIntermediateValue,\n  type RenameContactDAInternalState,\n  type RenameContactDAOutput,\n} from \"@api/app-binder/RenameContactDeviceActionTypes\";\nimport { isContactsOsSupportedForSession } from \"@internal/app-binder/contactsVersionGuards\";\nimport { ContactsVersionRequirementError } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  type RenameContactProof,\n  SendRenameContactTask,\n} from \"@internal/app-binder/task/SendRenameContactTask\";\n\nimport { validateRenameContactInput } from \"./validateRenameContactInput\";\n\nexport type RenameContactMachineDependencies = {\n  readonly isOsSupported: () => boolean;\n  readonly renameContact: (\n    input: RenameContactDAInput,\n  ) => Promise<Awaited<ReturnType<SendRenameContactTask[\"run\"]>>>;\n};\n\nexport class RenameContactDeviceAction extends XStateDeviceAction<\n  RenameContactDAOutput,\n  RenameContactDAInput,\n  RenameContactDAError,\n  RenameContactDAIntermediateValue,\n  RenameContactDAInternalState\n> {\n  makeStateMachine(\n    internalApi: InternalApi,\n  ): DeviceActionStateMachine<\n    RenameContactDAOutput,\n    RenameContactDAInput,\n    RenameContactDAError,\n    RenameContactDAIntermediateValue,\n    RenameContactDAInternalState\n  > {\n    type types = StateMachineTypes<\n      RenameContactDAOutput,\n      RenameContactDAInput,\n      RenameContactDAError,\n      RenameContactDAIntermediateValue,\n      RenameContactDAInternalState\n    >;\n\n    const { isOsSupported, renameContact } =\n      this.extractDependencies(internalApi);\n\n    return setup({\n      types: {\n        input: {} as types[\"input\"],\n        context: {} as types[\"context\"],\n        output: {} as types[\"output\"],\n      },\n      actors: {\n        // Rename is an OS/dashboard command: navigate to the dashboard (which\n        // closes any running app) instead of opening an embedded app. There is\n        // no OpenAppDeviceAction here by design.\n        goToDashboardStateMachine: new GoToDashboardDeviceAction({\n          input: {},\n        }).makeStateMachine(internalApi),\n        renameContact: fromPromise(\n          ({ input }: { input: RenameContactDAInput }) => renameContact(input),\n        ),\n      },\n      guards: {\n        noInternalError: ({ context }) => context._internalState.error === null,\n        contactsOsSupported: () => isOsSupported(),\n      },\n      actions: {\n        assignValidationError: assign({\n          _internalState: ({ context }) => {\n            const error = validateRenameContactInput(context.input);\n            return error\n              ? { ...context._internalState, error }\n              : context._internalState;\n          },\n        }),\n        assignVersionError: assign({\n          _internalState: ({ context }) => ({\n            ...context._internalState,\n            error: new ContactsVersionRequirementError(),\n          }),\n        }),\n        assignErrorFromEvent: assign({\n          _internalState: ({ context, event }) => ({\n            ...context._internalState,\n            error: new UnknownDAError(\n              event[\"error\"] instanceof Error\n                ? event[\"error\"].message\n                : String(event[\"error\"]),\n            ),\n          }),\n        }),\n      },\n    }).createMachine({\n      id: \"RenameContactDeviceAction\",\n      initial: \"InitialState\",\n      context: ({ input }) => ({\n        input,\n        intermediateValue: {\n          requiredUserInteraction: UserInteractionRequired.None,\n        },\n        _internalState: {\n          error: null,\n          proof: null,\n        },\n      }),\n      states: {\n        InitialState: {\n          always: { target: \"GoToDashboard\" },\n        },\n        // Always navigate to the dashboard first \u2014 rename is an OS command and\n        // must not run inside an app. Closing any running app happens here.\n        GoToDashboard: {\n          invoke: {\n            id: \"goToDashboard\",\n            src: \"goToDashboardStateMachine\",\n            input: () => ({}),\n            onSnapshot: {\n              actions: assign({\n                // The child surfaces both requiredUserInteraction and a step;\n                // only the interaction is part of this action's contract.\n                intermediateValue: ({ event }) => ({\n                  requiredUserInteraction:\n                    event.snapshot.context.intermediateValue\n                      .requiredUserInteraction,\n                }),\n              }),\n            },\n            onDone: {\n              target: \"GoToDashboardCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  event.output.caseOf<RenameContactDAInternalState>({\n                    Right: () => context._internalState,\n                    Left: (error) => ({ ...context._internalState, error }),\n                  }),\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        GoToDashboardCheck: {\n          always: [\n            { target: \"ValidateInput\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // Input validation runs inside the device action so invalid caller input\n        // surfaces as a typed terminal error state on the observable instead of\n        // a synchronous throw.\n        ValidateInput: {\n          entry: \"assignValidationError\",\n          always: [\n            { target: \"VersionGuard\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        // OS-only version guard: rename is served by the device OS, so only the\n        // device model and OS version are checked (no embedded-app version).\n        VersionGuard: {\n          always: [\n            { target: \"RenameContact\", guard: \"contactsOsSupported\" },\n            { target: \"Error\", actions: \"assignVersionError\" },\n          ],\n        },\n        RenameContact: {\n          entry: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n            },\n          }),\n          exit: assign({\n            intermediateValue: {\n              requiredUserInteraction: UserInteractionRequired.None,\n            },\n          }),\n          invoke: {\n            id: \"renameContact\",\n            src: \"renameContact\",\n            input: ({ context }) => context.input,\n            onDone: {\n              target: \"RenameContactResultCheck\",\n              actions: assign({\n                _internalState: ({ event, context }) =>\n                  isSuccessCommandResult(event.output)\n                    ? { ...context._internalState, proof: event.output.data }\n                    : {\n                        ...context._internalState,\n                        error: event.output.error,\n                      },\n              }),\n            },\n            onError: {\n              target: \"Error\",\n              actions: \"assignErrorFromEvent\",\n            },\n          },\n        },\n        RenameContactResultCheck: {\n          always: [\n            { target: \"Success\", guard: \"noInternalError\" },\n            { target: \"Error\" },\n          ],\n        },\n        Success: { type: \"final\" },\n        Error: { type: \"final\" },\n      },\n      output: ({ context }) => {\n        const { proof, error } = context._internalState;\n        if (proof) {\n          const { input } = context;\n          return Right({\n            previousContactName: input.previousContactName,\n            contactName: input.newContactName,\n            groupHandle: input.groupHandle,\n            hmacProof: proof.hmacProof,\n          });\n        }\n        return Left(error ?? new UnknownDAError(\"No error in final state\"));\n      },\n    });\n  }\n\n  extractDependencies(\n    internalApi: InternalApi,\n  ): RenameContactMachineDependencies {\n    const isOsSupported = () => isContactsOsSupportedForSession(internalApi);\n\n    const renameContact = (\n      input: RenameContactDAInput,\n    ): Promise<Awaited<ReturnType<SendRenameContactTask[\"run\"]>>> =>\n      new SendRenameContactTask(internalApi, {\n        previousContactName: input.previousContactName,\n        newContactName: input.newContactName,\n        groupHandle: input.groupHandle,\n        hmacProof: input.hmacProof,\n      }).run();\n\n    return { isOsSupported, renameContact };\n  }\n}\n\nexport type { RenameContactProof };\n"],
+  "mappings": "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",
+  "names": ["GoToDashboardDeviceAction", "isSuccessCommandResult", "UnknownDAError", "UserInteractionRequired", "XStateDeviceAction", "Left", "Right", "assign", "fromPromise", "setup", "isContactsOsSupportedForSession", "ContactsVersionRequirementError", "SendRenameContactTask", "validateRenameContactInput", "RenameContactDeviceAction", "internalApi", "isOsSupported", "renameContact", "input", "context", "error", "event", "proof"]
+}

package/lib/esm/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.test.js

@@ -0,0 +1,2 @@
+import{CommandResultFactory as C,DeviceActionStatus as e,DeviceModelId as k,DeviceSessionStateType as g,DeviceStatus as E,GoToDashboardDeviceAction as h,OpenAppDeviceAction as R,UnknownDAError as P,UserInteractionRequired as t}from"@ledgerhq/device-management-kit";import{beforeEach as S,describe as V,expect as s,it as D,vi as c}from"vitest";import{makeDeviceActionInternalApiMock as y}from"../../../app-binder/device-action/__test-utils__/makeInternalApi";import{setupGoToDashboardDAMock as v}from"../../../app-binder/device-action/__test-utils__/setupGoToDashboardDAMock";import{testDeviceActionStates as A}from"../../../app-binder/device-action/__test-utils__/testDeviceActionStates";import{ContactsCommandError as q,ContactsVersionRequirementError as O}from"../../../app-binder/model/contactsErrors";import{RenameContactDeviceAction as w}from"./RenameContactDeviceAction";import{validateRenameContactInput as N}from"./validateRenameContactInput";c.mock("@ledgerhq/device-management-kit",async a=>({...await a(),GoToDashboardDeviceAction:c.fn(()=>({makeStateMachine:c.fn()})),OpenAppDeviceAction:c.fn(()=>({makeStateMachine:c.fn()}))}));const f={hmacProof:new Uint8Array(32).fill(238)},m={previousContactName:"Alice",newContactName:"Bob",groupHandle:new Uint8Array(64).fill(204),hmacProof:new Uint8Array(32).fill(221)},T={previousContactName:"Alice",contactName:"Bob",groupHandle:m.groupHandle,hmacProof:f.hmacProof};V("RenameContactDeviceAction",()=>{let a,d,u;function U(){return{isOsSupported:d,renameContact:u}}S(()=>{c.clearAllMocks(),a=y(),d=c.fn().mockReturnValue(!0),u=c.fn().mockResolvedValue(C({data:f})),a.getDeviceSessionState.mockReturnValue({sessionStateType:g.ReadyWithoutSecureChannel,deviceStatus:E.CONNECTED,installedApps:[],currentApp:{name:"BOLOS",version:"1.7.0"},deviceModelId:k.FLEX,isSecureConnectionAllowed:!0})});function l(r){const n=new w({input:r});return c.spyOn(n,"extractDependencies").mockReturnValue(U()),n}D("navigates to the dashboard, checks the OS, renames, and completes",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice});const o=l(m),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{output:T,status:e.Completed}];A(o,i,a,{onDone:()=>{s(h).toHaveBeenCalled(),s(R).not.toHaveBeenCalled(),r()},onError:n})})),D("rejects on an unsupported OS version without sending the APDU",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice}),d.mockReturnValue(!1);const o=l(m),i=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{error:new O,status:e.Error}];A(o,i,a,{onDone:()=>{s(u).not.toHaveBeenCalled(),s(R).not.toHaveBeenCalled(),r()},onError:n})})),D("surfaces a go-to-dashboard failure as the device action error",()=>new Promise((r,n)=>{const o=new P("go to dashboard failed");v({error:o,requiredUserInteraction:t.UnlockDevice});const i=l(m),p=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{error:o,status:e.Error}];A(i,p,a,{onDone:()=>{s(d).not.toHaveBeenCalled(),s(u).not.toHaveBeenCalled(),r()},onError:n})})),D("surfaces a rename command error (e.g. seed mismatch)",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice});const o=new q({errorCode:"6982",message:"wrong seed"});u.mockResolvedValue(C({error:o}));const i=l(m),p=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.RegisterWallet},status:e.Pending},{error:o,status:e.Error}];A(i,p,a,{onDone:r,onError:n})})),D("surfaces invalid input as a typed error after reaching the dashboard",()=>new Promise((r,n)=>{v({requiredUserInteraction:t.UnlockDevice});const o={...m,newContactName:""},i=N(o),p=l(o),I=[{intermediateValue:{requiredUserInteraction:t.None},status:e.Pending},{intermediateValue:{requiredUserInteraction:t.UnlockDevice},status:e.Pending},{error:i,status:e.Error}];A(p,I,a,{onDone:()=>{s(d).not.toHaveBeenCalled(),s(u).not.toHaveBeenCalled(),r()},onError:n})}))});
+//# sourceMappingURL=RenameContactDeviceAction.test.js.map

package/lib/esm/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/RenameContact/RenameContactDeviceAction.test.ts"],
+  "sourcesContent": ["import {\n  CommandResultFactory,\n  type DeviceActionState,\n  DeviceActionStatus,\n  DeviceModelId,\n  DeviceSessionStateType,\n  DeviceStatus,\n  GoToDashboardDeviceAction,\n  OpenAppDeviceAction,\n  UnknownDAError,\n  UserInteractionRequired,\n} from \"@ledgerhq/device-management-kit\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\n\nimport {\n  type RenameContactDAError,\n  type RenameContactDAInput,\n  type RenameContactDAIntermediateValue,\n  type RenameContactDAOutput,\n} from \"@api/app-binder/RenameContactDeviceActionTypes\";\nimport { makeDeviceActionInternalApiMock } from \"@internal/app-binder/device-action/__test-utils__/makeInternalApi\";\nimport { setupGoToDashboardDAMock } from \"@internal/app-binder/device-action/__test-utils__/setupGoToDashboardDAMock\";\nimport { testDeviceActionStates } from \"@internal/app-binder/device-action/__test-utils__/testDeviceActionStates\";\nimport {\n  ContactsCommandError,\n  ContactsVersionRequirementError,\n} from \"@internal/app-binder/model/contactsErrors\";\n\nimport { RenameContactDeviceAction } from \"./RenameContactDeviceAction\";\nimport { validateRenameContactInput } from \"./validateRenameContactInput\";\n\nvi.mock(\"@ledgerhq/device-management-kit\", async (importOriginal) => {\n  const original =\n    // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n    await importOriginal<typeof import(\"@ledgerhq/device-management-kit\")>();\n  return {\n    ...original,\n    GoToDashboardDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n    OpenAppDeviceAction: vi.fn(() => ({\n      makeStateMachine: vi.fn(),\n    })),\n  };\n});\n\nconst OK_PROOF = { hmacProof: new Uint8Array(32).fill(0xee) };\n\nconst BASE_INPUT: RenameContactDAInput = {\n  previousContactName: \"Alice\",\n  newContactName: \"Bob\",\n  groupHandle: new Uint8Array(64).fill(0xcc),\n  hmacProof: new Uint8Array(32).fill(0xdd),\n};\n\nconst EXPECTED_OUTPUT: RenameContactDAOutput = {\n  previousContactName: \"Alice\",\n  contactName: \"Bob\",\n  groupHandle: BASE_INPUT.groupHandle,\n  hmacProof: OK_PROOF.hmacProof,\n};\n\ndescribe(\"RenameContactDeviceAction\", () => {\n  let apiMock: ReturnType<typeof makeDeviceActionInternalApiMock>;\n  let isOsSupportedMock: ReturnType<typeof vi.fn>;\n  let renameContactMock: ReturnType<typeof vi.fn>;\n\n  function extractDeps() {\n    return {\n      isOsSupported: isOsSupportedMock,\n      renameContact: renameContactMock,\n    };\n  }\n\n  beforeEach(() => {\n    vi.clearAllMocks();\n    apiMock = makeDeviceActionInternalApiMock();\n    isOsSupportedMock = vi.fn().mockReturnValue(true);\n    renameContactMock = vi\n      .fn()\n      .mockResolvedValue(CommandResultFactory({ data: OK_PROOF }));\n    apiMock.getDeviceSessionState.mockReturnValue({\n      sessionStateType: DeviceSessionStateType.ReadyWithoutSecureChannel,\n      deviceStatus: DeviceStatus.CONNECTED,\n      installedApps: [],\n      currentApp: { name: \"BOLOS\", version: \"1.7.0\" },\n      deviceModelId: DeviceModelId.FLEX,\n      isSecureConnectionAllowed: true,\n    });\n  });\n\n  function makeAction(input: RenameContactDAInput) {\n    const action = new RenameContactDeviceAction({ input });\n    vi.spyOn(action, \"extractDependencies\").mockReturnValue(extractDeps());\n    return action;\n  }\n\n  it(\"navigates to the dashboard, checks the OS, renames, and completes\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          output: EXPECTED_OUTPUT,\n          status: DeviceActionStatus.Completed,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // Rename is a dashboard op: it navigates to the dashboard and never\n          // opens an app.\n          expect(GoToDashboardDeviceAction).toHaveBeenCalled();\n          expect(OpenAppDeviceAction).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"rejects on an unsupported OS version without sending the APDU\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      isOsSupportedMock.mockReturnValue(false);\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: new ContactsVersionRequirementError(),\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          expect(renameContactMock).not.toHaveBeenCalled();\n          expect(OpenAppDeviceAction).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a go-to-dashboard failure as the device action error\", () =>\n    new Promise<void>((resolve, reject) => {\n      const dashboardError = new UnknownDAError(\"go to dashboard failed\");\n      setupGoToDashboardDAMock({\n        error: dashboardError,\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: dashboardError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          expect(isOsSupportedMock).not.toHaveBeenCalled();\n          expect(renameContactMock).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces a rename command error (e.g. seed mismatch)\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const commandError = new ContactsCommandError({\n        errorCode: \"6982\",\n        message: \"wrong seed\",\n      });\n      renameContactMock.mockResolvedValue(\n        CommandResultFactory({ error: commandError }),\n      );\n      const action = makeAction(BASE_INPUT);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.RegisterWallet,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: commandError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: resolve,\n        onError: reject,\n      });\n    }));\n\n  it(\"surfaces invalid input as a typed error after reaching the dashboard\", () =>\n    new Promise<void>((resolve, reject) => {\n      setupGoToDashboardDAMock({\n        requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n      });\n      const invalidInput = { ...BASE_INPUT, newContactName: \"\" };\n      const validationError = validateRenameContactInput(invalidInput);\n      const action = makeAction(invalidInput);\n\n      const expected = [\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.None,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          intermediateValue: {\n            requiredUserInteraction: UserInteractionRequired.UnlockDevice,\n          },\n          status: DeviceActionStatus.Pending,\n        },\n        {\n          error: validationError,\n          status: DeviceActionStatus.Error,\n        },\n      ] as DeviceActionState<\n        RenameContactDAOutput,\n        RenameContactDAError,\n        RenameContactDAIntermediateValue\n      >[];\n\n      testDeviceActionStates(action, expected, apiMock, {\n        onDone: () => {\n          // Validation fails before the version guard and before any APDU.\n          expect(isOsSupportedMock).not.toHaveBeenCalled();\n          expect(renameContactMock).not.toHaveBeenCalled();\n          resolve();\n        },\n        onError: reject,\n      });\n    }));\n});\n"],
+  "mappings": "AAAA,OACE,wBAAAA,EAEA,sBAAAC,EACA,iBAAAC,EACA,0BAAAC,EACA,gBAAAC,EACA,6BAAAC,EACA,uBAAAC,EACA,kBAAAC,EACA,2BAAAC,MACK,kCACP,OAAS,cAAAC,EAAY,YAAAC,EAAU,UAAAC,EAAQ,MAAAC,EAAI,MAAAC,MAAU,SAQrD,OAAS,mCAAAC,MAAuC,oEAChD,OAAS,4BAAAC,MAAgC,6EACzC,OAAS,0BAAAC,MAA8B,2EACvC,OACE,wBAAAC,EACA,mCAAAC,MACK,4CAEP,OAAS,6BAAAC,MAAiC,8BAC1C,OAAS,8BAAAC,MAAkC,+BAE3CP,EAAG,KAAK,kCAAmC,MAAOQ,IAIzC,CACL,GAFA,MAAMA,EAAiE,EAGvE,0BAA2BR,EAAG,GAAG,KAAO,CACtC,iBAAkBA,EAAG,GAAG,CAC1B,EAAE,EACF,oBAAqBA,EAAG,GAAG,KAAO,CAChC,iBAAkBA,EAAG,GAAG,CAC1B,EAAE,CACJ,EACD,EAED,MAAMS,EAAW,CAAE,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CAAE,EAEtDC,EAAmC,CACvC,oBAAqB,QACrB,eAAgB,MAChB,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACzC,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACzC,EAEMC,EAAyC,CAC7C,oBAAqB,QACrB,YAAa,MACb,YAAaD,EAAW,YACxB,UAAWD,EAAS,SACtB,EAEAZ,EAAS,4BAA6B,IAAM,CAC1C,IAAIe,EACAC,EACAC,EAEJ,SAASC,GAAc,CACrB,MAAO,CACL,cAAeF,EACf,cAAeC,CACjB,CACF,CAEAlB,EAAW,IAAM,CACfI,EAAG,cAAc,EACjBY,EAAUX,EAAgC,EAC1CY,EAAoBb,EAAG,GAAG,EAAE,gBAAgB,EAAI,EAChDc,EAAoBd,EACjB,GAAG,EACH,kBAAkBb,EAAqB,CAAE,KAAMsB,CAAS,CAAC,CAAC,EAC7DG,EAAQ,sBAAsB,gBAAgB,CAC5C,iBAAkBtB,EAAuB,0BACzC,aAAcC,EAAa,UAC3B,cAAe,CAAC,EAChB,WAAY,CAAE,KAAM,QAAS,QAAS,OAAQ,EAC9C,cAAeF,EAAc,KAC7B,0BAA2B,EAC7B,CAAC,CACH,CAAC,EAED,SAAS2B,EAAWC,EAA6B,CAC/C,MAAMC,EAAS,IAAIZ,EAA0B,CAAE,MAAAW,CAAM,CAAC,EACtD,OAAAjB,EAAG,MAAMkB,EAAQ,qBAAqB,EAAE,gBAAgBH,EAAY,CAAC,EAC9DG,CACT,CAEAnB,EAAG,oEAAqE,IACtE,IAAI,QAAc,CAACoB,EAASC,IAAW,CACrClB,EAAyB,CACvB,wBAAyBP,EAAwB,YACnD,CAAC,EACD,MAAMuB,EAASF,EAAWN,CAAU,EAE9BW,EAAW,CACf,CACE,kBAAmB,CACjB,wBAAyB1B,EAAwB,IACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,kBAAmB,CACjB,wBAAyBO,EAAwB,YACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,kBAAmB,CACjB,wBAAyBO,EAAwB,cACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,OAAQuB,EACR,OAAQvB,EAAmB,SAC7B,CACF,EAMAe,EAAuBe,EAAQG,EAAUT,EAAS,CAChD,OAAQ,IAAM,CAGZd,EAAON,CAAyB,EAAE,iBAAiB,EACnDM,EAAOL,CAAmB,EAAE,IAAI,iBAAiB,EACjD0B,EAAQ,CACV,EACA,QAASC,CACX,CAAC,CACH,CAAC,CAAC,EAEJrB,EAAG,gEAAiE,IAClE,IAAI,QAAc,CAACoB,EAASC,IAAW,CACrClB,EAAyB,CACvB,wBAAyBP,EAAwB,YACnD,CAAC,EACDkB,EAAkB,gBAAgB,EAAK,EACvC,MAAMK,EAASF,EAAWN,CAAU,EAE9BW,EAAW,CACf,CACE,kBAAmB,CACjB,wBAAyB1B,EAAwB,IACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,kBAAmB,CACjB,wBAAyBO,EAAwB,YACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,MAAO,IAAIiB,EACX,OAAQjB,EAAmB,KAC7B,CACF,EAMAe,EAAuBe,EAAQG,EAAUT,EAAS,CAChD,OAAQ,IAAM,CACZd,EAAOgB,CAAiB,EAAE,IAAI,iBAAiB,EAC/ChB,EAAOL,CAAmB,EAAE,IAAI,iBAAiB,EACjD0B,EAAQ,CACV,EACA,QAASC,CACX,CAAC,CACH,CAAC,CAAC,EAEJrB,EAAG,gEAAiE,IAClE,IAAI,QAAc,CAACoB,EAASC,IAAW,CACrC,MAAME,EAAiB,IAAI5B,EAAe,wBAAwB,EAClEQ,EAAyB,CACvB,MAAOoB,EACP,wBAAyB3B,EAAwB,YACnD,CAAC,EACD,MAAMuB,EAASF,EAAWN,CAAU,EAE9BW,EAAW,CACf,CACE,kBAAmB,CACjB,wBAAyB1B,EAAwB,IACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,kBAAmB,CACjB,wBAAyBO,EAAwB,YACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,MAAOkC,EACP,OAAQlC,EAAmB,KAC7B,CACF,EAMAe,EAAuBe,EAAQG,EAAUT,EAAS,CAChD,OAAQ,IAAM,CACZd,EAAOe,CAAiB,EAAE,IAAI,iBAAiB,EAC/Cf,EAAOgB,CAAiB,EAAE,IAAI,iBAAiB,EAC/CK,EAAQ,CACV,EACA,QAASC,CACX,CAAC,CACH,CAAC,CAAC,EAEJrB,EAAG,uDAAwD,IACzD,IAAI,QAAc,CAACoB,EAASC,IAAW,CACrClB,EAAyB,CACvB,wBAAyBP,EAAwB,YACnD,CAAC,EACD,MAAM4B,EAAe,IAAInB,EAAqB,CAC5C,UAAW,OACX,QAAS,YACX,CAAC,EACDU,EAAkB,kBAChB3B,EAAqB,CAAE,MAAOoC,CAAa,CAAC,CAC9C,EACA,MAAML,EAASF,EAAWN,CAAU,EAE9BW,EAAW,CACf,CACE,kBAAmB,CACjB,wBAAyB1B,EAAwB,IACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,kBAAmB,CACjB,wBAAyBO,EAAwB,YACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,kBAAmB,CACjB,wBAAyBO,EAAwB,cACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,MAAOmC,EACP,OAAQnC,EAAmB,KAC7B,CACF,EAMAe,EAAuBe,EAAQG,EAAUT,EAAS,CAChD,OAAQO,EACR,QAASC,CACX,CAAC,CACH,CAAC,CAAC,EAEJrB,EAAG,uEAAwE,IACzE,IAAI,QAAc,CAACoB,EAASC,IAAW,CACrClB,EAAyB,CACvB,wBAAyBP,EAAwB,YACnD,CAAC,EACD,MAAM6B,EAAe,CAAE,GAAGd,EAAY,eAAgB,EAAG,EACnDe,EAAkBlB,EAA2BiB,CAAY,EACzDN,EAASF,EAAWQ,CAAY,EAEhCH,EAAW,CACf,CACE,kBAAmB,CACjB,wBAAyB1B,EAAwB,IACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,kBAAmB,CACjB,wBAAyBO,EAAwB,YACnD,EACA,OAAQP,EAAmB,OAC7B,EACA,CACE,MAAOqC,EACP,OAAQrC,EAAmB,KAC7B,CACF,EAMAe,EAAuBe,EAAQG,EAAUT,EAAS,CAChD,OAAQ,IAAM,CAEZd,EAAOe,CAAiB,EAAE,IAAI,iBAAiB,EAC/Cf,EAAOgB,CAAiB,EAAE,IAAI,iBAAiB,EAC/CK,EAAQ,CACV,EACA,QAASC,CACX,CAAC,CACH,CAAC,CAAC,CACN,CAAC",
+  "names": ["CommandResultFactory", "DeviceActionStatus", "DeviceModelId", "DeviceSessionStateType", "DeviceStatus", "GoToDashboardDeviceAction", "OpenAppDeviceAction", "UnknownDAError", "UserInteractionRequired", "beforeEach", "describe", "expect", "it", "vi", "makeDeviceActionInternalApiMock", "setupGoToDashboardDAMock", "testDeviceActionStates", "ContactsCommandError", "ContactsVersionRequirementError", "RenameContactDeviceAction", "validateRenameContactInput", "importOriginal", "OK_PROOF", "BASE_INPUT", "EXPECTED_OUTPUT", "apiMock", "isOsSupportedMock", "renameContactMock", "extractDeps", "makeAction", "input", "action", "resolve", "reject", "expected", "dashboardError", "commandError", "invalidInput", "validationError"]
+}

package/lib/esm/internal/app-binder/device-action/RenameContact/validateRenameContactInput.js

@@ -0,0 +1,2 @@
+import{CONTACT_NAME_BUFFER_LENGTH as a,ContactsValidationError as r,GROUP_HANDLE_SIZE as c,HMAC_PROOF_LENGTH as l,validateByteLength as n,validatePrintableLabel as o}from"../../../app-binder/model/contactsValidation";function f(e){try{return o(e.newContactName,{field:"newContactName",bufferLength:a}),o(e.previousContactName,{field:"previousContactName",bufferLength:a}),n(e.groupHandle,{field:"groupHandle",expectedBytes:c}),n(e.hmacProof,{field:"hmacProof",expectedBytes:l}),null}catch(t){if(t instanceof r)return t;throw t}}export{f as validateRenameContactInput};
+//# sourceMappingURL=validateRenameContactInput.js.map

package/lib/esm/internal/app-binder/device-action/RenameContact/validateRenameContactInput.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/RenameContact/validateRenameContactInput.ts"],
+  "sourcesContent": ["import { type RenameContactInput } from \"@api/model/RenameContact\";\nimport {\n  CONTACT_NAME_BUFFER_LENGTH,\n  ContactsValidationError,\n  GROUP_HANDLE_SIZE,\n  HMAC_PROOF_LENGTH,\n  validateByteLength,\n  validatePrintableLabel,\n} from \"@internal/app-binder/model/contactsValidation\";\n\n/**\n * Validate the caller input for Rename Contact. Returns the first\n * `ContactsValidationError` found, or `null` when the input is valid.\n *\n * Non-throwing by design: the device action calls this so an invalid input is\n * surfaced as a typed terminal error state on the observable, keeping the public\n * `ContactsManager.renameContact` free of synchronous throws.\n */\nexport function validateRenameContactInput(\n  input: RenameContactInput,\n): ContactsValidationError | null {\n  try {\n    validatePrintableLabel(input.newContactName, {\n      field: \"newContactName\",\n      bufferLength: CONTACT_NAME_BUFFER_LENGTH,\n    });\n    validatePrintableLabel(input.previousContactName, {\n      field: \"previousContactName\",\n      bufferLength: CONTACT_NAME_BUFFER_LENGTH,\n    });\n    validateByteLength(input.groupHandle, {\n      field: \"groupHandle\",\n      expectedBytes: GROUP_HANDLE_SIZE,\n    });\n    validateByteLength(input.hmacProof, {\n      field: \"hmacProof\",\n      expectedBytes: HMAC_PROOF_LENGTH,\n    });\n\n    return null;\n  } catch (error) {\n    if (error instanceof ContactsValidationError) {\n      return error;\n    }\n    throw error;\n  }\n}\n"],
+  "mappings": "AACA,OACE,8BAAAA,EACA,2BAAAC,EACA,qBAAAC,EACA,qBAAAC,EACA,sBAAAC,EACA,0BAAAC,MACK,gDAUA,SAASC,EACdC,EACgC,CAChC,GAAI,CACF,OAAAF,EAAuBE,EAAM,eAAgB,CAC3C,MAAO,iBACP,aAAcP,CAChB,CAAC,EACDK,EAAuBE,EAAM,oBAAqB,CAChD,MAAO,sBACP,aAAcP,CAChB,CAAC,EACDI,EAAmBG,EAAM,YAAa,CACpC,MAAO,cACP,cAAeL,CACjB,CAAC,EACDE,EAAmBG,EAAM,UAAW,CAClC,MAAO,YACP,cAAeJ,CACjB,CAAC,EAEM,IACT,OAASK,EAAO,CACd,GAAIA,aAAiBP,EACnB,OAAOO,EAET,MAAMA,CACR,CACF",
+  "names": ["CONTACT_NAME_BUFFER_LENGTH", "ContactsValidationError", "GROUP_HANDLE_SIZE", "HMAC_PROOF_LENGTH", "validateByteLength", "validatePrintableLabel", "validateRenameContactInput", "input", "error"]
+}

package/lib/esm/internal/app-binder/device-action/RenameContact/validateRenameContactInput.test.js

@@ -0,0 +1,2 @@
+import{ContactsValidationError as n}from"../../../app-binder/model/contactsValidation";import{validateRenameContactInput as t}from"./validateRenameContactInput";const e={previousContactName:"Alice",newContactName:"Bob",groupHandle:new Uint8Array(64).fill(204),hmacProof:new Uint8Array(32).fill(221)};describe("validateRenameContactInput",()=>{it("returns null for valid input",()=>{expect(t(e)).toBeNull()}),it("returns a ContactsValidationError for a non-printable new name",()=>{expect(t({...e,newContactName:"Am\xE9lie"})).toBeInstanceOf(n)}),it("returns a ContactsValidationError for a non-printable previous name",()=>{expect(t({...e,previousContactName:"Am\xE9lie"})).toBeInstanceOf(n)}),it("returns an error for an empty new name",()=>{expect(t({...e,newContactName:""})).toBeInstanceOf(n)}),it("returns an error for a group handle of the wrong length",()=>{expect(t({...e,groupHandle:new Uint8Array(63)})).toBeInstanceOf(n)}),it("returns an error for an hmac proof of the wrong length",()=>{expect(t({...e,hmacProof:new Uint8Array(31)})).toBeInstanceOf(n)})});
+//# sourceMappingURL=validateRenameContactInput.test.js.map

package/lib/esm/internal/app-binder/device-action/RenameContact/validateRenameContactInput.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/RenameContact/validateRenameContactInput.test.ts"],
+  "sourcesContent": ["import { type RenameContactInput } from \"@api/model/RenameContact\";\nimport { ContactsValidationError } from \"@internal/app-binder/model/contactsValidation\";\n\nimport { validateRenameContactInput } from \"./validateRenameContactInput\";\n\nconst VALID_INPUT: RenameContactInput = {\n  previousContactName: \"Alice\",\n  newContactName: \"Bob\",\n  groupHandle: new Uint8Array(64).fill(0xcc),\n  hmacProof: new Uint8Array(32).fill(0xdd),\n};\n\ndescribe(\"validateRenameContactInput\", () => {\n  it(\"returns null for valid input\", () => {\n    expect(validateRenameContactInput(VALID_INPUT)).toBeNull();\n  });\n\n  it(\"returns a ContactsValidationError for a non-printable new name\", () => {\n    expect(\n      validateRenameContactInput({ ...VALID_INPUT, newContactName: \"Am\u00E9lie\" }),\n    ).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"returns a ContactsValidationError for a non-printable previous name\", () => {\n    expect(\n      validateRenameContactInput({\n        ...VALID_INPUT,\n        previousContactName: \"Am\u00E9lie\",\n      }),\n    ).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"returns an error for an empty new name\", () => {\n    expect(\n      validateRenameContactInput({ ...VALID_INPUT, newContactName: \"\" }),\n    ).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"returns an error for a group handle of the wrong length\", () => {\n    expect(\n      validateRenameContactInput({\n        ...VALID_INPUT,\n        groupHandle: new Uint8Array(63),\n      }),\n    ).toBeInstanceOf(ContactsValidationError);\n  });\n\n  it(\"returns an error for an hmac proof of the wrong length\", () => {\n    expect(\n      validateRenameContactInput({\n        ...VALID_INPUT,\n        hmacProof: new Uint8Array(31),\n      }),\n    ).toBeInstanceOf(ContactsValidationError);\n  });\n});\n"],
+  "mappings": "AACA,OAAS,2BAAAA,MAA+B,gDAExC,OAAS,8BAAAC,MAAkC,+BAE3C,MAAMC,EAAkC,CACtC,oBAAqB,QACrB,eAAgB,MAChB,YAAa,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,EACzC,UAAW,IAAI,WAAW,EAAE,EAAE,KAAK,GAAI,CACzC,EAEA,SAAS,6BAA8B,IAAM,CAC3C,GAAG,+BAAgC,IAAM,CACvC,OAAOD,EAA2BC,CAAW,CAAC,EAAE,SAAS,CAC3D,CAAC,EAED,GAAG,iEAAkE,IAAM,CACzE,OACED,EAA2B,CAAE,GAAGC,EAAa,eAAgB,WAAS,CAAC,CACzE,EAAE,eAAeF,CAAuB,CAC1C,CAAC,EAED,GAAG,sEAAuE,IAAM,CAC9E,OACEC,EAA2B,CACzB,GAAGC,EACH,oBAAqB,WACvB,CAAC,CACH,EAAE,eAAeF,CAAuB,CAC1C,CAAC,EAED,GAAG,yCAA0C,IAAM,CACjD,OACEC,EAA2B,CAAE,GAAGC,EAAa,eAAgB,EAAG,CAAC,CACnE,EAAE,eAAeF,CAAuB,CAC1C,CAAC,EAED,GAAG,0DAA2D,IAAM,CAClE,OACEC,EAA2B,CACzB,GAAGC,EACH,YAAa,IAAI,WAAW,EAAE,CAChC,CAAC,CACH,EAAE,eAAeF,CAAuB,CAC1C,CAAC,EAED,GAAG,yDAA0D,IAAM,CACjE,OACEC,EAA2B,CACzB,GAAGC,EACH,UAAW,IAAI,WAAW,EAAE,CAC9B,CAAC,CACH,EAAE,eAAeF,CAAuB,CAC1C,CAAC,CACH,CAAC",
+  "names": ["ContactsValidationError", "validateRenameContactInput", "VALID_INPUT"]
+}

package/lib/esm/internal/app-binder/device-action/__test-utils__/setupGoToDashboardDAMock.js

@@ -0,0 +1,2 @@
+import{GoToDashboardDeviceAction as t,UserInteractionRequired as n}from"@ledgerhq/device-management-kit";import{Left as o,Right as i}from"purify-ts";import{assign as a,createMachine as c}from"xstate";const p=(e={})=>{const r=e.requiredUserInteraction??n.None;t.mockImplementation(()=>({makeStateMachine:vi.fn().mockImplementation(()=>c({initial:"pending",states:{pending:{entry:a({intermediateValue:{requiredUserInteraction:r}}),after:{0:"done"}},done:{type:"final"}},output:()=>e.error?o(e.error):i(void 0)}))}))};export{p as setupGoToDashboardDAMock};
+//# sourceMappingURL=setupGoToDashboardDAMock.js.map

package/lib/esm/internal/app-binder/device-action/__test-utils__/setupGoToDashboardDAMock.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/internal/app-binder/device-action/__test-utils__/setupGoToDashboardDAMock.ts"],
+  "sourcesContent": ["import {\n  GoToDashboardDeviceAction,\n  UserInteractionRequired,\n} from \"@ledgerhq/device-management-kit\";\nimport { Left, Right } from \"purify-ts\";\nimport { type Mock } from \"vitest\";\nimport { assign, createMachine } from \"xstate\";\n\n/**\n * Mock GoToDashboardDeviceAction to resolve immediately with either success\n * (default) or an error. Emits a single `requiredUserInteraction` snapshot\n * (default `None` \u2014 device assumed unlocked and already ready) so the parent\n * action can surface it, mirroring the real nested device action.\n */\nexport const setupGoToDashboardDAMock = (\n  options: {\n    error?: unknown;\n    requiredUserInteraction?: UserInteractionRequired;\n  } = {},\n) => {\n  const interaction =\n    options.requiredUserInteraction ?? UserInteractionRequired.None;\n  (GoToDashboardDeviceAction as Mock).mockImplementation(() => ({\n    makeStateMachine: vi.fn().mockImplementation(() =>\n      createMachine({\n        initial: \"pending\",\n        states: {\n          pending: {\n            entry: assign({\n              intermediateValue: {\n                requiredUserInteraction: interaction,\n              },\n            }),\n            after: {\n              0: \"done\",\n            },\n          },\n          done: {\n            type: \"final\",\n          },\n        },\n        output: () => (options.error ? Left(options.error) : Right(undefined)),\n      }),\n    ),\n  }));\n};\n"],
+  "mappings": "AAAA,OACE,6BAAAA,EACA,2BAAAC,MACK,kCACP,OAAS,QAAAC,EAAM,SAAAC,MAAa,YAE5B,OAAS,UAAAC,EAAQ,iBAAAC,MAAqB,SAQ/B,MAAMC,EAA2B,CACtCC,EAGI,CAAC,IACF,CACH,MAAMC,EACJD,EAAQ,yBAA2BN,EAAwB,KAC5DD,EAAmC,mBAAmB,KAAO,CAC5D,iBAAkB,GAAG,GAAG,EAAE,mBAAmB,IAC3CK,EAAc,CACZ,QAAS,UACT,OAAQ,CACN,QAAS,CACP,MAAOD,EAAO,CACZ,kBAAmB,CACjB,wBAAyBI,CAC3B,CACF,CAAC,EACD,MAAO,CACL,EAAG,MACL,CACF,EACA,KAAM,CACJ,KAAM,OACR,CACF,EACA,OAAQ,IAAOD,EAAQ,MAAQL,EAAKK,EAAQ,KAAK,EAAIJ,EAAM,MAAS,CACtE,CAAC,CACH,CACF,EAAE,CACJ",
+  "names": ["GoToDashboardDeviceAction", "UserInteractionRequired", "Left", "Right", "assign", "createMachine", "setupGoToDashboardDAMock", "options", "interaction"]
+}

package/lib/esm/internal/app-binder/model/contactsConstants.js

@@ -1,2 +1,2 @@
-const o=176,t=16,x=1,_=64,e=32,n=32,r={bitcoin:0,ethereum:1,solana:2,polkadot:3,cosmos:4,cardano:5};export{r as BLOCKCHAIN_FAMILY_BY_NAME,o as CONTACTS_APDU_CLA,t as CONTACTS_APDU_INS,_ as GROUP_HANDLE_BYTES,e as HMAC_PROOF_BYTES,n as HMAC_REST_BYTES,x as SUB_CMD_REGISTER_IDENTITY};
+const o=176,_=16,t=1,x=3,A=4,E=224,e=46,C=0,T=64,n=32,r=32,c=32,s={bitcoin:0,ethereum:1,solana:2,polkadot:3,cosmos:4,cardano:5};export{s as BLOCKCHAIN_FAMILY_BY_NAME,o as CONTACTS_APDU_CLA,_ as CONTACTS_APDU_INS,T as GROUP_HANDLE_BYTES,c as HMAC_NAME_BYTES,n as HMAC_PROOF_BYTES,r as HMAC_REST_BYTES,E as RENAME_CONTACT_APDU_CLA,e as RENAME_CONTACT_APDU_INS,C as RENAME_CONTACT_P1,x as SUB_CMD_EDIT_IDENTIFIER,A as SUB_CMD_EDIT_SCOPE,t as SUB_CMD_REGISTER_IDENTITY};
 //# sourceMappingURL=contactsConstants.js.map

package/lib/esm/internal/app-binder/model/contactsConstants.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/internal/app-binder/model/contactsConstants.ts"],
-  "sourcesContent": ["/**\n * Protocol constants shared by the Contacts (Address Book) operations.\n *\n * Wire format and values follow the BOLOS SDK Address Book specification\n * (ledger-secure-sdk/app_features/address_book). Op-specific sub-command bytes\n * and response field sizes live here; TLV tags and struct-type bytes live in\n * {@link ./../services/contactsTlvSerializer}.\n */\n\n/** APDU class/instruction shared by every Address Book sub-command. */\nexport const CONTACTS_APDU_CLA = 0xb0;\nexport const CONTACTS_APDU_INS = 0x10;\n\n/** P1 sub-command selector for REGISTER IDENTITY (register external address). */\nexport const SUB_CMD_REGISTER_IDENTITY = 0x01;\n\n/** Sizes (bytes) of the fields in the REGISTER IDENTITY final-chunk response. */\nexport const GROUP_HANDLE_BYTES = 64;\nexport const HMAC_PROOF_BYTES = 32;\nexport const HMAC_REST_BYTES = 32;\n\n/**\n * Blockchain-family byte encoded in the `BLOCKCHAIN_FAMILY` TLV, keyed by a\n * lowercase family name. v1 ships Ethereum only; the remaining families are\n * listed for completeness and will be enabled as their chains are supported.\n */\nexport const BLOCKCHAIN_FAMILY_BY_NAME: Readonly<Record<string, number>> = {\n  bitcoin: 0x00,\n  ethereum: 0x01,\n  solana: 0x02,\n  polkadot: 0x03,\n  cosmos: 0x04,\n  cardano: 0x05,\n};\n"],
-  "mappings": "AAUO,MAAMA,EAAoB,IACpBC,EAAoB,GAGpBC,EAA4B,EAG5BC,EAAqB,GACrBC,EAAmB,GACnBC,EAAkB,GAOlBC,EAA8D,CACzE,QAAS,EACT,SAAU,EACV,OAAQ,EACR,SAAU,EACV,OAAQ,EACR,QAAS,CACX",
-  "names": ["CONTACTS_APDU_CLA", "CONTACTS_APDU_INS", "SUB_CMD_REGISTER_IDENTITY", "GROUP_HANDLE_BYTES", "HMAC_PROOF_BYTES", "HMAC_REST_BYTES", "BLOCKCHAIN_FAMILY_BY_NAME"]
+  "sourcesContent": ["/**\n * Protocol constants shared by the Contacts (Address Book) operations.\n *\n * Wire format and values follow the BOLOS SDK Address Book specification\n * (ledger-secure-sdk/app_features/address_book). Op-specific sub-command bytes\n * and response field sizes live here; TLV tags and struct-type bytes live in\n * {@link ./../services/contactsTlvSerializer}.\n */\n\n/** APDU class/instruction shared by every Address Book sub-command. */\nexport const CONTACTS_APDU_CLA = 0xb0;\nexport const CONTACTS_APDU_INS = 0x10;\n\n/** P1 sub-command selector for REGISTER IDENTITY (register external address). */\nexport const SUB_CMD_REGISTER_IDENTITY = 0x01;\n\n/**\n * P1 sub-command selector for EDIT IDENTIFIER \u2014 an address-book app sub-command\n * (CLA 0xB0 / INS 0x10) served by the coin app, never OS-dispatched.\n */\nexport const SUB_CMD_EDIT_IDENTIFIER = 0x03;\n\n/**\n * P1 sub-command selector for EDIT SCOPE \u2014 an address-book app sub-command\n * (CLA 0xB0 / INS 0x10) served by the coin app, never OS-dispatched. Changes an\n * entry's scope while keeping its contact name and identifier.\n */\nexport const SUB_CMD_EDIT_SCOPE = 0x04;\n\n/**\n * EDIT CONTACT NAME (rename) is a blockchain-agnostic OS/dashboard command with\n * its own CLA/INS \u2014 NOT a sub-command of the address-book app APDU (0xB0/0x10).\n * The OS serves it directly, so it must run on the dashboard. P1 is a fixed\n * 0x00 (there is no sub-command selector for this command); P2 still carries the\n * chunk-continuation flag handled by {@link ./../services/sendFramedContactsPayload}.\n */\nexport const RENAME_CONTACT_APDU_CLA = 0xe0;\nexport const RENAME_CONTACT_APDU_INS = 0x2e;\nexport const RENAME_CONTACT_P1 = 0x00;\n\n/** Sizes (bytes) of the fields in the REGISTER IDENTITY final-chunk response. */\nexport const GROUP_HANDLE_BYTES = 64;\nexport const HMAC_PROOF_BYTES = 32;\nexport const HMAC_REST_BYTES = 32;\n\n/**\n * Size (bytes) of the rotated `hmac_name` returned on the EDIT CONTACT NAME\n * final-chunk response \u2014 the replacement group-level name proof.\n */\nexport const HMAC_NAME_BYTES = 32;\n\n/**\n * Blockchain-family byte encoded in the `BLOCKCHAIN_FAMILY` TLV, keyed by a\n * lowercase family name. v1 ships Ethereum only; the remaining families are\n * listed for completeness and will be enabled as their chains are supported.\n */\nexport const BLOCKCHAIN_FAMILY_BY_NAME: Readonly<Record<string, number>> = {\n  bitcoin: 0x00,\n  ethereum: 0x01,\n  solana: 0x02,\n  polkadot: 0x03,\n  cosmos: 0x04,\n  cardano: 0x05,\n};\n"],
+  "mappings": "AAUO,MAAMA,EAAoB,IACpBC,EAAoB,GAGpBC,EAA4B,EAM5BC,EAA0B,EAO1BC,EAAqB,EASrBC,EAA0B,IAC1BC,EAA0B,GAC1BC,EAAoB,EAGpBC,EAAqB,GACrBC,EAAmB,GACnBC,EAAkB,GAMlBC,EAAkB,GAOlBC,EAA8D,CACzE,QAAS,EACT,SAAU,EACV,OAAQ,EACR,SAAU,EACV,OAAQ,EACR,QAAS,CACX",
+  "names": ["CONTACTS_APDU_CLA", "CONTACTS_APDU_INS", "SUB_CMD_REGISTER_IDENTITY", "SUB_CMD_EDIT_IDENTIFIER", "SUB_CMD_EDIT_SCOPE", "RENAME_CONTACT_APDU_CLA", "RENAME_CONTACT_APDU_INS", "RENAME_CONTACT_P1", "GROUP_HANDLE_BYTES", "HMAC_PROOF_BYTES", "HMAC_REST_BYTES", "HMAC_NAME_BYTES", "BLOCKCHAIN_FAMILY_BY_NAME"]
 }

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.js

@@ -0,0 +1,2 @@
+import{ByteArrayBuilder as c,DmkResultFactory as o,InvalidStatusWordError as m,isSuccessCommandResult as I}from"@ledgerhq/device-management-kit";import{EditExternalAddressIdentifierCommand as y}from"../../app-binder/command/EditExternalAddressIdentifierCommand";import{BLOCKCHAIN_FAMILY_BY_NAME as E,SUB_CMD_EDIT_IDENTIFIER as A}from"../../app-binder/model/contactsConstants";import{CONTACTS_TLV_TAG as t,encodeTlvAscii as d,encodeTlvBuffer as i,encodeTlvChainId as f,encodeTlvUInt8 as a,STRUCT_TYPE_EDIT_IDENTIFIER as C,STRUCT_VERSION_VALUE as T}from"../../app-binder/services/contactsTlvSerializer";import{sendFramedContactsPayload as p}from"../../app-binder/services/sendFramedContactsPayload";class N{constructor(r,n){this.api=r;this.args=n}async run(){const r=this.buildPayload(this.args),n=await p(this.api,{payload:r,p1:A,makeCommand:(s,l)=>new y({data:s,p2:l}),logger:this.args.logger,commandTag:"SendEditExternalAddressIdentifierTask"});if(!I(n))return n;const{hmacRest:e}=n.data;return e?o({data:{hmacRest:e}}):o({error:new m("EditIdentifier final-chunk response did not carry hmac_rest")})}buildPayload(r){const n=E[r.blockchainFamily.toLowerCase()];if(n===void 0)throw new Error(`Unsupported blockchain family: ${r.blockchainFamily}`);const e=new c;return a(e,t.STRUCT_TYPE,C),a(e,t.STRUCT_VERSION,T),d(e,t.CONTACT_NAME,r.contactName),d(e,t.SCOPE,r.scope),i(e,t.ACCOUNT_IDENTIFIER,r.newIdentifier),i(e,t.PREVIOUS_IDENTIFIER,r.previousIdentifier),i(e,t.GROUP_HANDLE,r.groupHandle),r.chainId!==void 0&&f(e,t.CHAIN_ID,r.chainId),i(e,t.HMAC_PROOF,r.hmacProof),i(e,t.HMAC_REST,r.hmacRest),a(e,t.BLOCKCHAIN_FAMILY,n),e.build()}}export{N as SendEditExternalAddressIdentifierTask};
+//# sourceMappingURL=SendEditExternalAddressIdentifierTask.js.map

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/task/SendEditExternalAddressIdentifierTask.ts"],
+  "sourcesContent": ["// Builds the op-3 (Edit Identifier) TLV and dispatches it via the shared\n// chunked framing; the device returns struct_type + hmac_rest on the final\n// chunk. Tag order: STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE,\n// ACCOUNT_IDENTIFIER (new), PREVIOUS_IDENTIFIER (old), GROUP_HANDLE,\n// CHAIN_ID (Ethereum only), HMAC_PROOF, HMAC_REST (old), BLOCKCHAIN_FAMILY.\n// No DERIVATION_PATH: external-address ops carry no path \u2014 the current Ethereum\n// app rejects the tag (0x6a80); it is Ledger-Account only (DSDK-1465).\n// Reference: Address Book Final Specifications \u2014 Edit Identifier.\nimport {\n  ByteArrayBuilder,\n  type CommandResult,\n  DmkResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n  isSuccessCommandResult,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { EditExternalAddressIdentifierCommand } from \"@internal/app-binder/command/EditExternalAddressIdentifierCommand\";\nimport {\n  BLOCKCHAIN_FAMILY_BY_NAME,\n  SUB_CMD_EDIT_IDENTIFIER,\n} from \"@internal/app-binder/model/contactsConstants\";\nimport { type ContactsErrorCodes } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  CONTACTS_TLV_TAG,\n  encodeTlvAscii,\n  encodeTlvBuffer,\n  encodeTlvChainId,\n  encodeTlvUInt8,\n  STRUCT_TYPE_EDIT_IDENTIFIER,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\nexport type EditIdentifierProof = {\n  readonly hmacRest: Uint8Array;\n};\n\nexport type SendEditExternalAddressIdentifierTaskArgs = {\n  readonly contactName: string;\n  readonly scope: string;\n  readonly previousIdentifier: Uint8Array;\n  readonly newIdentifier: Uint8Array;\n  readonly blockchainFamily: string;\n  readonly chainId?: bigint;\n  readonly groupHandle: Uint8Array;\n  readonly hmacProof: Uint8Array;\n  readonly hmacRest: Uint8Array;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport class SendEditExternalAddressIdentifierTask {\n  constructor(\n    private readonly api: InternalApi,\n    private readonly args: SendEditExternalAddressIdentifierTaskArgs,\n  ) {}\n\n  async run(): Promise<CommandResult<EditIdentifierProof, ContactsErrorCodes>> {\n    const payload = this.buildPayload(this.args);\n\n    const result = (await sendFramedContactsPayload(this.api, {\n      payload,\n      p1: SUB_CMD_EDIT_IDENTIFIER,\n      makeCommand: (chunk, p2) =>\n        new EditExternalAddressIdentifierCommand({ data: chunk, p2 }),\n      logger: this.args.logger,\n      commandTag: \"SendEditExternalAddressIdentifierTask\",\n    })) as CommandResult<\n      { readonly hmacRest?: Uint8Array },\n      ContactsErrorCodes\n    >;\n\n    if (!isSuccessCommandResult(result)) {\n      return result;\n    }\n\n    const { hmacRest } = result.data;\n    if (!hmacRest) {\n      return DmkResultFactory({\n        error: new InvalidStatusWordError(\n          \"EditIdentifier final-chunk response did not carry hmac_rest\",\n        ),\n      });\n    }\n    return DmkResultFactory({ data: { hmacRest } });\n  }\n\n  private buildPayload(\n    args: SendEditExternalAddressIdentifierTaskArgs,\n  ): Uint8Array {\n    const family =\n      BLOCKCHAIN_FAMILY_BY_NAME[args.blockchainFamily.toLowerCase()];\n    if (family === undefined) {\n      throw new Error(\n        `Unsupported blockchain family: ${args.blockchainFamily}`,\n      );\n    }\n\n    const builder = new ByteArrayBuilder();\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_TYPE,\n      STRUCT_TYPE_EDIT_IDENTIFIER,\n    );\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_VERSION,\n      STRUCT_VERSION_VALUE,\n    );\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.CONTACT_NAME, args.contactName);\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.SCOPE, args.scope);\n    encodeTlvBuffer(\n      builder,\n      CONTACTS_TLV_TAG.ACCOUNT_IDENTIFIER,\n      args.newIdentifier,\n    );\n    encodeTlvBuffer(\n      builder,\n      CONTACTS_TLV_TAG.PREVIOUS_IDENTIFIER,\n      args.previousIdentifier,\n    );\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.GROUP_HANDLE, args.groupHandle);\n    if (args.chainId !== undefined) {\n      encodeTlvChainId(builder, CONTACTS_TLV_TAG.CHAIN_ID, args.chainId);\n    }\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_PROOF, args.hmacProof);\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_REST, args.hmacRest);\n    encodeTlvUInt8(builder, CONTACTS_TLV_TAG.BLOCKCHAIN_FAMILY, family);\n\n    return builder.build();\n  }\n}\n"],
+  "mappings": "AAQA,OACE,oBAAAA,EAEA,oBAAAC,EAEA,0BAAAC,EACA,0BAAAC,MAEK,kCAEP,OAAS,wCAAAC,MAA4C,oEACrD,OACE,6BAAAC,EACA,2BAAAC,MACK,+CAEP,OACE,oBAAAC,EACA,kBAAAC,EACA,mBAAAC,EACA,oBAAAC,EACA,kBAAAC,EACA,+BAAAC,EACA,wBAAAC,MACK,sDACP,OAAS,6BAAAC,MAAiC,0DAmBnC,MAAMC,CAAsC,CACjD,YACmBC,EACAC,EACjB,CAFiB,SAAAD,EACA,UAAAC,CAChB,CAEH,MAAM,KAAuE,CAC3E,MAAMC,EAAU,KAAK,aAAa,KAAK,IAAI,EAErCC,EAAU,MAAML,EAA0B,KAAK,IAAK,CACxD,QAAAI,EACA,GAAIZ,EACJ,YAAa,CAACc,EAAOC,IACnB,IAAIjB,EAAqC,CAAE,KAAMgB,EAAO,GAAAC,CAAG,CAAC,EAC9D,OAAQ,KAAK,KAAK,OAClB,WAAY,uCACd,CAAC,EAKD,GAAI,CAAClB,EAAuBgB,CAAM,EAChC,OAAOA,EAGT,KAAM,CAAE,SAAAG,CAAS,EAAIH,EAAO,KAC5B,OAAKG,EAOErB,EAAiB,CAAE,KAAM,CAAE,SAAAqB,CAAS,CAAE,CAAC,EANrCrB,EAAiB,CACtB,MAAO,IAAIC,EACT,6DACF,CACF,CAAC,CAGL,CAEQ,aACNe,EACY,CACZ,MAAMM,EACJlB,EAA0BY,EAAK,iBAAiB,YAAY,CAAC,EAC/D,GAAIM,IAAW,OACb,MAAM,IAAI,MACR,kCAAkCN,EAAK,gBAAgB,EACzD,EAGF,MAAMO,EAAU,IAAIxB,EACpB,OAAAW,EACEa,EACAjB,EAAiB,YACjBK,CACF,EACAD,EACEa,EACAjB,EAAiB,eACjBM,CACF,EACAL,EAAegB,EAASjB,EAAiB,aAAcU,EAAK,WAAW,EACvET,EAAegB,EAASjB,EAAiB,MAAOU,EAAK,KAAK,EAC1DR,EACEe,EACAjB,EAAiB,mBACjBU,EAAK,aACP,EACAR,EACEe,EACAjB,EAAiB,oBACjBU,EAAK,kBACP,EACAR,EAAgBe,EAASjB,EAAiB,aAAcU,EAAK,WAAW,EACpEA,EAAK,UAAY,QACnBP,EAAiBc,EAASjB,EAAiB,SAAUU,EAAK,OAAO,EAEnER,EAAgBe,EAASjB,EAAiB,WAAYU,EAAK,SAAS,EACpER,EAAgBe,EAASjB,EAAiB,UAAWU,EAAK,QAAQ,EAClEN,EAAea,EAASjB,EAAiB,kBAAmBgB,CAAM,EAE3DC,EAAQ,MAAM,CACvB,CACF",
+  "names": ["ByteArrayBuilder", "DmkResultFactory", "InvalidStatusWordError", "isSuccessCommandResult", "EditExternalAddressIdentifierCommand", "BLOCKCHAIN_FAMILY_BY_NAME", "SUB_CMD_EDIT_IDENTIFIER", "CONTACTS_TLV_TAG", "encodeTlvAscii", "encodeTlvBuffer", "encodeTlvChainId", "encodeTlvUInt8", "STRUCT_TYPE_EDIT_IDENTIFIER", "STRUCT_VERSION_VALUE", "sendFramedContactsPayload", "SendEditExternalAddressIdentifierTask", "api", "args", "payload", "result", "chunk", "p2", "hmacRest", "family", "builder"]
+}

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.test.js

@@ -0,0 +1,2 @@
+import{CommandResultFactory as a,InvalidStatusWordError as s}from"@ledgerhq/device-management-kit";import{EditExternalAddressIdentifierCommand as m}from"../../app-binder/command/EditExternalAddressIdentifierCommand";import{SendEditExternalAddressIdentifierTask as o}from"./SendEditExternalAddressIdentifierTask";function r(e){const n=new Uint8Array(e.length/2);for(let t=0;t<e.length;t+=2)n[t/2]=parseInt(e.slice(t,t+2),16);return n}const l=r("00d501013102010181f005416c69636581f108457468206d61696e81f214555555555555555555555555555555555555555581f41400000000000000000000000000000000deadbeef81f640"+"cc".repeat(64)+"2301012920"+"dd".repeat(32)+"81f720"+"aa".repeat(32)+"510101"),i={hmacRest:r("88".repeat(32))},d={contactName:"Alice",scope:"Eth main",newIdentifier:r("55".repeat(20)),previousIdentifier:r("00000000000000000000000000000000deadbeef"),blockchainFamily:"ethereum",chainId:1n,groupHandle:r("cc".repeat(64)),hmacProof:r("dd".repeat(32)),hmacRest:r("aa".repeat(32))};function c(){return{sendCommand:vi.fn()}}describe("SendEditExternalAddressIdentifierTask",()=>{it("assembles the framed chunk byte-equal to the fixture and dispatches EditExternalAddressIdentifierCommand",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({data:i}));const n=await new o(e,d).run();expect(e.sendCommand.mock.calls).toHaveLength(1),expect(e.sendCommand.mock.calls[0][0]).toStrictEqual(new m({data:l,p2:0})),expect(n).toStrictEqual(a({data:i}))}),it("omits the CHAIN_ID TLV when chainId is not provided",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({data:i})),await new o(e,{...d,chainId:void 0}).run();const n=e.sendCommand.mock.calls[0][0],t=Buffer.from(n.args.data).toString("hex");expect(t).not.toContain("230101"),expect(t.endsWith("510101")).toBe(!0)}),it("propagates command-level errors",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({error:new s("user cancelled")}));const n=await new o(e,d).run();expect(n).toStrictEqual(a({error:new s("user cancelled")}))}),it("errors when the final-chunk response does not carry hmac_rest",async()=>{const e=c();e.sendCommand.mockResolvedValueOnce(a({data:{}}));const n=await new o(e,d).run();expect(n).toStrictEqual(a({error:new s("EditIdentifier final-chunk response did not carry hmac_rest")}))}),it("throws on an unsupported blockchain family",async()=>{const e=c();await expect(new o(e,{...d,blockchainFamily:"dogecoin"}).run()).rejects.toThrow(/Unsupported blockchain family/),expect(e.sendCommand).not.toHaveBeenCalled()})});
+//# sourceMappingURL=SendEditExternalAddressIdentifierTask.test.js.map

package/lib/esm/internal/app-binder/task/SendEditExternalAddressIdentifierTask.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/task/SendEditExternalAddressIdentifierTask.test.ts"],
+  "sourcesContent": ["// Asserts the op-3 (Edit Identifier) framed chunk (2-byte BE length + TLV) is\n// byte-for-byte parity with the signer-eth `edit_external_address` fixture.\nimport {\n  CommandResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { EditExternalAddressIdentifierCommand } from \"@internal/app-binder/command/EditExternalAddressIdentifierCommand\";\n\nimport { SendEditExternalAddressIdentifierTask } from \"./SendEditExternalAddressIdentifierTask\";\n\nfunction hexToBytes(hex: string): Uint8Array {\n  const out = new Uint8Array(hex.length / 2);\n  for (let i = 0; i < hex.length; i += 2) {\n    out[i / 2] = parseInt(hex.slice(i, i + 2), 16);\n  }\n  return out;\n}\n\n// Framed chunk = \"00 d5\" (2-byte BE total TLV length = 213) + TLV. No\n// DERIVATION_PATH TLV (external-address ops carry no path).\nconst FRAMED_CHUNK = hexToBytes(\n  \"00d5\" +\n    \"010131\" +\n    \"020101\" +\n    \"81f005416c696365\" +\n    \"81f108457468206d61696e\" +\n    \"81f2145555555555555555555555555555555555555555\" +\n    \"81f41400000000000000000000000000000000deadbeef\" +\n    \"81f640\" +\n    \"cc\".repeat(64) +\n    \"230101\" +\n    \"2920\" +\n    \"dd\".repeat(32) +\n    \"81f720\" +\n    \"aa\".repeat(32) +\n    \"510101\",\n);\n\nconst OK_PROOF = { hmacRest: hexToBytes(\"88\".repeat(32)) };\n\nconst BASE_ARGS = {\n  contactName: \"Alice\",\n  scope: \"Eth main\",\n  newIdentifier: hexToBytes(\"55\".repeat(20)),\n  previousIdentifier: hexToBytes(\"00000000000000000000000000000000deadbeef\"),\n  blockchainFamily: \"ethereum\",\n  chainId: 1n,\n  groupHandle: hexToBytes(\"cc\".repeat(64)),\n  hmacProof: hexToBytes(\"dd\".repeat(32)),\n  hmacRest: hexToBytes(\"aa\".repeat(32)),\n};\n\nfunction makeApiMock(): InternalApi & {\n  sendCommand: ReturnType<typeof vi.fn>;\n} {\n  return { sendCommand: vi.fn() } as unknown as InternalApi & {\n    sendCommand: ReturnType<typeof vi.fn>;\n  };\n}\n\ndescribe(\"SendEditExternalAddressIdentifierTask\", () => {\n  it(\"assembles the framed chunk byte-equal to the fixture and dispatches EditExternalAddressIdentifierCommand\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOF }),\n    );\n\n    const result = await new SendEditExternalAddressIdentifierTask(\n      api,\n      BASE_ARGS,\n    ).run();\n\n    expect(api.sendCommand.mock.calls).toHaveLength(1);\n    expect(api.sendCommand.mock.calls[0]![0]).toStrictEqual(\n      new EditExternalAddressIdentifierCommand({\n        data: FRAMED_CHUNK,\n        p2: 0x00,\n      }),\n    );\n    expect(result).toStrictEqual(CommandResultFactory({ data: OK_PROOF }));\n  });\n\n  it(\"omits the CHAIN_ID TLV when chainId is not provided\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({ data: OK_PROOF }),\n    );\n\n    await new SendEditExternalAddressIdentifierTask(api, {\n      ...BASE_ARGS,\n      chainId: undefined,\n    }).run();\n\n    const command = api.sendCommand.mock\n      .calls[0]![0] as EditExternalAddressIdentifierCommand;\n    const framedHex = Buffer.from(command.args.data).toString(\"hex\");\n    // No `23 01 ..` CHAIN_ID TLV; HMAC_PROOF (29 20 ..) follows the path directly.\n    expect(framedHex).not.toContain(\"230101\");\n    expect(framedHex.endsWith(\"510101\")).toBe(true);\n  });\n\n  it(\"propagates command-level errors\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\"user cancelled\"),\n      }),\n    );\n\n    const result = await new SendEditExternalAddressIdentifierTask(\n      api,\n      BASE_ARGS,\n    ).run();\n\n    expect(result).toStrictEqual(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\"user cancelled\"),\n      }),\n    );\n  });\n\n  it(\"errors when the final-chunk response does not carry hmac_rest\", async () => {\n    const api = makeApiMock();\n    api.sendCommand.mockResolvedValueOnce(CommandResultFactory({ data: {} }));\n\n    const result = await new SendEditExternalAddressIdentifierTask(\n      api,\n      BASE_ARGS,\n    ).run();\n\n    expect(result).toStrictEqual(\n      CommandResultFactory({\n        error: new InvalidStatusWordError(\n          \"EditIdentifier final-chunk response did not carry hmac_rest\",\n        ),\n      }),\n    );\n  });\n\n  it(\"throws on an unsupported blockchain family\", async () => {\n    const api = makeApiMock();\n\n    await expect(\n      new SendEditExternalAddressIdentifierTask(api, {\n        ...BASE_ARGS,\n        blockchainFamily: \"dogecoin\",\n      }).run(),\n    ).rejects.toThrow(/Unsupported blockchain family/);\n    expect(api.sendCommand).not.toHaveBeenCalled();\n  });\n});\n"],
+  "mappings": "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",
+  "names": ["CommandResultFactory", "InvalidStatusWordError", "EditExternalAddressIdentifierCommand", "SendEditExternalAddressIdentifierTask", "hexToBytes", "hex", "out", "i", "FRAMED_CHUNK", "OK_PROOF", "BASE_ARGS", "makeApiMock", "api", "result", "command", "framedHex"]
+}

package/lib/esm/internal/app-binder/task/SendEditExternalAddressScopeTask.js

@@ -0,0 +1,2 @@
+import{ByteArrayBuilder as l,DmkResultFactory as i,InvalidStatusWordError as m,isSuccessCommandResult as p}from"@ledgerhq/device-management-kit";import{EditExternalAddressScopeCommand as y}from"../../app-binder/command/EditExternalAddressScopeCommand";import{BLOCKCHAIN_FAMILY_BY_NAME as E,SUB_CMD_EDIT_SCOPE as C}from"../../app-binder/model/contactsConstants";import{CONTACTS_TLV_TAG as o,encodeTlvAscii as a,encodeTlvBuffer as n,encodeTlvChainId as S,encodeTlvUInt8 as d,STRUCT_TYPE_EDIT_SCOPE as A,STRUCT_VERSION_VALUE as T}from"../../app-binder/services/contactsTlvSerializer";import{sendFramedContactsPayload as u}from"../../app-binder/services/sendFramedContactsPayload";class U{constructor(r,t){this.api=r;this.args=t}async run(){const r=this.buildPayload(this.args),t=await u(this.api,{payload:r,p1:C,makeCommand:(s,c)=>new y({data:s,p2:c}),logger:this.args.logger,commandTag:"SendEditExternalAddressScopeTask"});if(!p(t))return t;const{hmacRest:e}=t.data;return e?i({data:{hmacRest:e}}):i({error:new m("EditScope final-chunk response did not carry hmac_rest")})}buildPayload(r){const t=E[r.blockchainFamily.toLowerCase()];if(t===void 0)throw new Error(`Unsupported blockchain family: ${r.blockchainFamily}`);const e=new l;return d(e,o.STRUCT_TYPE,A),d(e,o.STRUCT_VERSION,T),a(e,o.CONTACT_NAME,r.contactName),a(e,o.SCOPE,r.newScope),n(e,o.ACCOUNT_IDENTIFIER,r.identifier),a(e,o.PREVIOUS_SCOPE,r.previousScope),n(e,o.GROUP_HANDLE,r.groupHandle),r.chainId!==void 0&&S(e,o.CHAIN_ID,r.chainId),n(e,o.HMAC_PROOF,r.hmacProof),n(e,o.HMAC_REST,r.hmacRest),d(e,o.BLOCKCHAIN_FAMILY,t),e.build()}}export{U as SendEditExternalAddressScopeTask};
+//# sourceMappingURL=SendEditExternalAddressScopeTask.js.map

package/lib/esm/internal/app-binder/task/SendEditExternalAddressScopeTask.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/internal/app-binder/task/SendEditExternalAddressScopeTask.ts"],
+  "sourcesContent": ["// Builds the op-4 (Edit Scope) TLV and dispatches it via the shared chunked\n// framing; the device returns struct_type + hmac_rest on the final chunk. Tag\n// order: STRUCT_TYPE, STRUCT_VERSION, CONTACT_NAME, SCOPE (new), ACCOUNT_IDENTIFIER\n// (unchanged), PREVIOUS_SCOPE (old), GROUP_HANDLE, CHAIN_ID (Ethereum only),\n// HMAC_PROOF, HMAC_REST (old), BLOCKCHAIN_FAMILY.\n// No DERIVATION_PATH: external-address ops carry no path \u2014 the current Ethereum\n// app rejects the tag (0x6a80); it is Ledger-Account only (DSDK-1465).\n// Reference: Address Book Final Specifications \u2014 Edit Scope.\nimport {\n  ByteArrayBuilder,\n  type CommandResult,\n  DmkResultFactory,\n  type InternalApi,\n  InvalidStatusWordError,\n  isSuccessCommandResult,\n  type LoggerPublisherService,\n} from \"@ledgerhq/device-management-kit\";\n\nimport { EditExternalAddressScopeCommand } from \"@internal/app-binder/command/EditExternalAddressScopeCommand\";\nimport {\n  BLOCKCHAIN_FAMILY_BY_NAME,\n  SUB_CMD_EDIT_SCOPE,\n} from \"@internal/app-binder/model/contactsConstants\";\nimport { type ContactsErrorCodes } from \"@internal/app-binder/model/contactsErrors\";\nimport {\n  CONTACTS_TLV_TAG,\n  encodeTlvAscii,\n  encodeTlvBuffer,\n  encodeTlvChainId,\n  encodeTlvUInt8,\n  STRUCT_TYPE_EDIT_SCOPE,\n  STRUCT_VERSION_VALUE,\n} from \"@internal/app-binder/services/contactsTlvSerializer\";\nimport { sendFramedContactsPayload } from \"@internal/app-binder/services/sendFramedContactsPayload\";\n\nexport type EditScopeProof = {\n  readonly hmacRest: Uint8Array;\n};\n\nexport type SendEditExternalAddressScopeTaskArgs = {\n  readonly contactName: string;\n  readonly previousScope: string;\n  readonly newScope: string;\n  readonly identifier: Uint8Array;\n  readonly blockchainFamily: string;\n  readonly chainId?: bigint;\n  readonly groupHandle: Uint8Array;\n  readonly hmacProof: Uint8Array;\n  readonly hmacRest: Uint8Array;\n  readonly logger?: LoggerPublisherService;\n};\n\nexport class SendEditExternalAddressScopeTask {\n  constructor(\n    private readonly api: InternalApi,\n    private readonly args: SendEditExternalAddressScopeTaskArgs,\n  ) {}\n\n  async run(): Promise<CommandResult<EditScopeProof, ContactsErrorCodes>> {\n    const payload = this.buildPayload(this.args);\n\n    const result = (await sendFramedContactsPayload(this.api, {\n      payload,\n      p1: SUB_CMD_EDIT_SCOPE,\n      makeCommand: (chunk, p2) =>\n        new EditExternalAddressScopeCommand({ data: chunk, p2 }),\n      logger: this.args.logger,\n      commandTag: \"SendEditExternalAddressScopeTask\",\n    })) as CommandResult<\n      { readonly hmacRest?: Uint8Array },\n      ContactsErrorCodes\n    >;\n\n    if (!isSuccessCommandResult(result)) {\n      return result;\n    }\n\n    const { hmacRest } = result.data;\n    if (!hmacRest) {\n      return DmkResultFactory({\n        error: new InvalidStatusWordError(\n          \"EditScope final-chunk response did not carry hmac_rest\",\n        ),\n      });\n    }\n    return DmkResultFactory({ data: { hmacRest } });\n  }\n\n  private buildPayload(args: SendEditExternalAddressScopeTaskArgs): Uint8Array {\n    const family =\n      BLOCKCHAIN_FAMILY_BY_NAME[args.blockchainFamily.toLowerCase()];\n    if (family === undefined) {\n      throw new Error(\n        `Unsupported blockchain family: ${args.blockchainFamily}`,\n      );\n    }\n\n    const builder = new ByteArrayBuilder();\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_TYPE,\n      STRUCT_TYPE_EDIT_SCOPE,\n    );\n    encodeTlvUInt8(\n      builder,\n      CONTACTS_TLV_TAG.STRUCT_VERSION,\n      STRUCT_VERSION_VALUE,\n    );\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.CONTACT_NAME, args.contactName);\n    encodeTlvAscii(builder, CONTACTS_TLV_TAG.SCOPE, args.newScope);\n    encodeTlvBuffer(\n      builder,\n      CONTACTS_TLV_TAG.ACCOUNT_IDENTIFIER,\n      args.identifier,\n    );\n    encodeTlvAscii(\n      builder,\n      CONTACTS_TLV_TAG.PREVIOUS_SCOPE,\n      args.previousScope,\n    );\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.GROUP_HANDLE, args.groupHandle);\n    if (args.chainId !== undefined) {\n      encodeTlvChainId(builder, CONTACTS_TLV_TAG.CHAIN_ID, args.chainId);\n    }\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_PROOF, args.hmacProof);\n    encodeTlvBuffer(builder, CONTACTS_TLV_TAG.HMAC_REST, args.hmacRest);\n    encodeTlvUInt8(builder, CONTACTS_TLV_TAG.BLOCKCHAIN_FAMILY, family);\n\n    return builder.build();\n  }\n}\n"],
+  "mappings": "AAQA,OACE,oBAAAA,EAEA,oBAAAC,EAEA,0BAAAC,EACA,0BAAAC,MAEK,kCAEP,OAAS,mCAAAC,MAAuC,+DAChD,OACE,6BAAAC,EACA,sBAAAC,MACK,+CAEP,OACE,oBAAAC,EACA,kBAAAC,EACA,mBAAAC,EACA,oBAAAC,EACA,kBAAAC,EACA,0BAAAC,EACA,wBAAAC,MACK,sDACP,OAAS,6BAAAC,MAAiC,0DAmBnC,MAAMC,CAAiC,CAC5C,YACmBC,EACAC,EACjB,CAFiB,SAAAD,EACA,UAAAC,CAChB,CAEH,MAAM,KAAkE,CACtE,MAAMC,EAAU,KAAK,aAAa,KAAK,IAAI,EAErCC,EAAU,MAAML,EAA0B,KAAK,IAAK,CACxD,QAAAI,EACA,GAAIZ,EACJ,YAAa,CAACc,EAAOC,IACnB,IAAIjB,EAAgC,CAAE,KAAMgB,EAAO,GAAAC,CAAG,CAAC,EACzD,OAAQ,KAAK,KAAK,OAClB,WAAY,kCACd,CAAC,EAKD,GAAI,CAAClB,EAAuBgB,CAAM,EAChC,OAAOA,EAGT,KAAM,CAAE,SAAAG,CAAS,EAAIH,EAAO,KAC5B,OAAKG,EAOErB,EAAiB,CAAE,KAAM,CAAE,SAAAqB,CAAS,CAAE,CAAC,EANrCrB,EAAiB,CACtB,MAAO,IAAIC,EACT,wDACF,CACF,CAAC,CAGL,CAEQ,aAAae,EAAwD,CAC3E,MAAMM,EACJlB,EAA0BY,EAAK,iBAAiB,YAAY,CAAC,EAC/D,GAAIM,IAAW,OACb,MAAM,IAAI,MACR,kCAAkCN,EAAK,gBAAgB,EACzD,EAGF,MAAMO,EAAU,IAAIxB,EACpB,OAAAW,EACEa,EACAjB,EAAiB,YACjBK,CACF,EACAD,EACEa,EACAjB,EAAiB,eACjBM,CACF,EACAL,EAAegB,EAASjB,EAAiB,aAAcU,EAAK,WAAW,EACvET,EAAegB,EAASjB,EAAiB,MAAOU,EAAK,QAAQ,EAC7DR,EACEe,EACAjB,EAAiB,mBACjBU,EAAK,UACP,EACAT,EACEgB,EACAjB,EAAiB,eACjBU,EAAK,aACP,EACAR,EAAgBe,EAASjB,EAAiB,aAAcU,EAAK,WAAW,EACpEA,EAAK,UAAY,QACnBP,EAAiBc,EAASjB,EAAiB,SAAUU,EAAK,OAAO,EAEnER,EAAgBe,EAASjB,EAAiB,WAAYU,EAAK,SAAS,EACpER,EAAgBe,EAASjB,EAAiB,UAAWU,EAAK,QAAQ,EAClEN,EAAea,EAASjB,EAAiB,kBAAmBgB,CAAM,EAE3DC,EAAQ,MAAM,CACvB,CACF",
+  "names": ["ByteArrayBuilder", "DmkResultFactory", "InvalidStatusWordError", "isSuccessCommandResult", "EditExternalAddressScopeCommand", "BLOCKCHAIN_FAMILY_BY_NAME", "SUB_CMD_EDIT_SCOPE", "CONTACTS_TLV_TAG", "encodeTlvAscii", "encodeTlvBuffer", "encodeTlvChainId", "encodeTlvUInt8", "STRUCT_TYPE_EDIT_SCOPE", "STRUCT_VERSION_VALUE", "sendFramedContactsPayload", "SendEditExternalAddressScopeTask", "api", "args", "payload", "result", "chunk", "p2", "hmacRest", "family", "builder"]
+}

package/lib/esm/internal/app-binder/task/SendEditExternalAddressScopeTask.test.js

@@ -0,0 +1,2 @@
+import{CommandResultFactory as a,InvalidStatusWordError as d}from"@ledgerhq/device-management-kit";import{EditExternalAddressScopeCommand as m}from"../../app-binder/command/EditExternalAddressScopeCommand";import{SendEditExternalAddressScopeTask as r}from"./SendEditExternalAddressScopeTask";function o(e){const n=new Uint8Array(e.length/2);for(let t=0;t<e.length;t+=2)n[t/2]=parseInt(e.slice(t,t+2),16);return n}const l=o("00c901013202010181f005416c69636581f10845746820636f6c6481f214"+"55".repeat(20)+"81f508457468206d61696e81f640"+"cc".repeat(64)+"2301012920"+"dd".repeat(32)+"81f720"+"aa".repeat(32)+"510101"),i={hmacRest:o("88".repeat(32))},c={contactName:"Alice",previousScope:"Eth main",newScope:"Eth cold",identifier:o("55".repeat(20)),blockchainFamily:"ethereum",chainId:1n,groupHandle:o("cc".repeat(64)),hmacProof:o("dd".repeat(32)),hmacRest:o("aa".repeat(32))};function s(){return{sendCommand:vi.fn()}}describe("SendEditExternalAddressScopeTask",()=>{it("assembles the framed chunk byte-equal to the fixture and dispatches EditExternalAddressScopeCommand",async()=>{const e=s();e.sendCommand.mockResolvedValueOnce(a({data:i}));const n=await new r(e,c).run();expect(e.sendCommand.mock.calls).toHaveLength(1),expect(e.sendCommand.mock.calls[0][0]).toStrictEqual(new m({data:l,p2:0})),expect(n).toStrictEqual(a({data:i}))}),it("omits the CHAIN_ID TLV when chainId is not provided",async()=>{const e=s();e.sendCommand.mockResolvedValueOnce(a({data:i})),await new r(e,{...c,chainId:void 0}).run();const n=e.sendCommand.mock.calls[0][0],t=Buffer.from(n.args.data).toString("hex");expect(t).not.toContain("230101"),expect(t.endsWith("510101")).toBe(!0)}),it("propagates command-level errors",async()=>{const e=s();e.sendCommand.mockResolvedValueOnce(a({error:new d("user cancelled")}));const n=await new r(e,c).run();expect(n).toStrictEqual(a({error:new d("user cancelled")}))}),it("errors when the final-chunk response does not carry hmac_rest",async()=>{const e=s();e.sendCommand.mockResolvedValueOnce(a({data:{}}));const n=await new r(e,c).run();expect(n).toStrictEqual(a({error:new d("EditScope final-chunk response did not carry hmac_rest")}))}),it("throws on an unsupported blockchain family",async()=>{const e=s();await expect(new r(e,{...c,blockchainFamily:"dogecoin"}).run()).rejects.toThrow(/Unsupported blockchain family/),expect(e.sendCommand).not.toHaveBeenCalled()})});
+//# sourceMappingURL=SendEditExternalAddressScopeTask.test.js.map