@ledgerhq/device-management-kit 0.0.0-develop-20241017000946 → 0.5.0

package/lib/esm/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ledgerhq/device-management-kit",
+  "version": "0.5.0",
+  "license": "Apache-2.0",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "import": "./lib/esm/index.js",
+      "require": "./lib/cjs/index.js"
+    },
+    "./*": {
+      "types": "./lib/types/*",
+      "import": "./lib/esm/*",
+      "require": "./lib/cjs/*"
+    }
+  },
+  "files": [
+    "./lib",
+    "package.json"
+  ],
+  "scripts": {
+    "prebuild": "rimraf lib",
+    "build": "pnpm lmdk-build --entryPoints index.ts,src/**/*.ts --tsconfig tsconfig.prod.json",
+    "dev": "concurrently \"pnpm watch:builds\" \"pnpm watch:types\"",
+    "watch:builds": "pnpm lmdk-watch --entryPoints index.ts,src/**/*.ts --tsconfig tsconfig.prod.json",
+    "watch:types": "concurrently \"tsc --watch -p tsconfig.prod.json\" \"tsc-alias --watch -p tsconfig.prod.json\"",
+    "lint": "eslint",
+    "lint:fix": "pnpm lint --fix",
+    "postpack": "find . -name '*.tgz' -exec cp {} ../../dist/ \\; ",
+    "prettier": "prettier . --check",
+    "prettier:fix": "prettier . --write",
+    "test": "jest",
+    "test:watch": "pnpm test -- --watch",
+    "test:coverage": "pnpm test -- --coverage",
+    "typecheck": "tsc --noEmit",
+    "module:create": "pnpm hygen core-module with-prompt"
+  },
+  "dependencies": {
+    "@ledgerhq/device-transport-kit-mock-client": "workspace:*",
+    "@sentry/minimal": "^6.19.7",
+    "@statelyai/inspect": "^0.4.0",
+    "axios": "^1.7.7",
+    "inversify": "^6.0.3",
+    "inversify-logger-middleware": "^3.1.0",
+    "purify-ts": "^2.1.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "semver": "^7.6.3",
+    "uuid": "^10.0.0",
+    "xstate": "^5.18.2"
+  },
+  "devDependencies": {
+    "@ledgerhq/esbuild-tools": "workspace:*",
+    "@ledgerhq/eslint-config-dsdk": "workspace:*",
+    "@ledgerhq/jest-config-dsdk": "workspace:*",
+    "@ledgerhq/prettier-config-dsdk": "workspace:*",
+    "@ledgerhq/tsconfig-dsdk": "workspace:*",
+    "@types/semver": "^7.5.8",
+    "@types/uuid": "^10.0.0",
+    "@types/w3c-web-hid": "^1.0.6",
+    "@types/web-bluetooth": "^0.0.20",
+    "ts-node": "^10.9.2"
+  }
+}

package/lib/esm/src/api/DeviceManagementKit.js

@@ -0,0 +1,2 @@
+import{commandTypes as c}from"./command/di/commandTypes";import{configTypes as a}from"../internal/config/di/configTypes";import{deviceSessionTypes as s}from"../internal/device-session/di/deviceSessionTypes";import{discoveryTypes as t}from"../internal/discovery/di/discoveryTypes";import{sendTypes as C}from"../internal/send/di/sendTypes";import{makeContainer as m}from"../../src/di";import{deviceActionTypes as p}from"./device-action/di/deviceActionTypes";class A{container;constructor({stub:e,transports:n,customTransports:o,loggers:i,config:r}={}){this.container=m({stub:e,transports:n,customTransports:o,loggers:i,config:r})}getVersion(){return this.container.get(a.GetDmkVersionUseCase).getDmkVersion()}startDiscovering(e){return this.container.get(t.StartDiscoveringUseCase).execute(e)}stopDiscovering(){return this.container.get(t.StopDiscoveringUseCase).execute()}listenToKnownDevices(){return this.container.get(t.ListenToKnownDevicesUseCase).execute()}connect(e){return this.container.get(t.ConnectUseCase).execute(e)}disconnect(e){return this.container.get(t.DisconnectUseCase).execute(e)}sendApdu(e){return this.container.get(C.SendApduUseCase).execute(e)}sendCommand(e){return this.container.get(c.SendCommandUseCase).execute(e)}executeDeviceAction(e){return this.container.get(p.ExecuteDeviceActionUseCase).execute(e)}getConnectedDevice(e){return this.container.get(t.GetConnectedDeviceUseCase).execute(e)}getDeviceSessionState(e){return this.container.get(s.GetDeviceSessionStateUseCase).execute(e)}close(){return this.container.get(s.CloseSessionsUseCase).execute()}listConnectedDevices(){return this.container.get(t.ListConnectedDevicesUseCase).execute()}listenToConnectedDevice(){return this.container.get(t.ListenToConnectedDeviceUseCase).execute()}}export{A as DeviceManagementKit};
+//# sourceMappingURL=DeviceManagementKit.js.map

package/lib/esm/src/api/DeviceManagementKit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/api/DeviceManagementKit.ts"],
+  "sourcesContent": ["import { type Container } from \"inversify\";\nimport { type Observable } from \"rxjs\";\n\nimport { commandTypes } from \"@api/command/di/commandTypes\";\nimport { type CommandResult } from \"@api/command/model/CommandResult\";\nimport {\n  type SendCommandUseCase,\n  type SendCommandUseCaseArgs,\n} from \"@api/command/use-case/SendCommandUseCase\";\nimport {\n  type ExecuteDeviceActionUseCase,\n  type ExecuteDeviceActionUseCaseArgs,\n} from \"@api/device-action/use-case/ExecuteDeviceActionUseCase\";\nimport { type ApduResponse } from \"@api/device-session/ApduResponse\";\nimport { type DeviceSessionState } from \"@api/device-session/DeviceSessionState\";\nimport { type DeviceSessionId } from \"@api/device-session/types\";\nimport { type ConnectedDevice } from \"@api/transport/model/ConnectedDevice\";\nimport {\n  type ConnectUseCaseArgs,\n  type DisconnectUseCaseArgs,\n  type DiscoveredDevice,\n  type GetConnectedDeviceUseCaseArgs,\n  type SendApduUseCaseArgs,\n  type StartDiscoveringUseCaseArgs,\n} from \"@api/types\";\nimport { configTypes } from \"@internal/config/di/configTypes\";\nimport { type GetDmkVersionUseCase } from \"@internal/config/use-case/GetDmkVersionUseCase\";\nimport { deviceSessionTypes } from \"@internal/device-session/di/deviceSessionTypes\";\nimport { type CloseSessionsUseCase } from \"@internal/device-session/use-case/CloseSessionsUseCase\";\nimport { type GetDeviceSessionStateUseCase } from \"@internal/device-session/use-case/GetDeviceSessionStateUseCase\";\nimport { discoveryTypes } from \"@internal/discovery/di/discoveryTypes\";\nimport { type ConnectUseCase } from \"@internal/discovery/use-case/ConnectUseCase\";\nimport { type DisconnectUseCase } from \"@internal/discovery/use-case/DisconnectUseCase\";\nimport { type GetConnectedDeviceUseCase } from \"@internal/discovery/use-case/GetConnectedDeviceUseCase\";\nimport { type ListConnectedDevicesUseCase } from \"@internal/discovery/use-case/ListConnectedDevicesUseCase\";\nimport { type ListenToConnectedDeviceUseCase } from \"@internal/discovery/use-case/ListenToConnectedDeviceUseCase\";\nimport { type ListenToKnownDevicesUseCase } from \"@internal/discovery/use-case/ListenToKnownDevicesUseCase\";\nimport type { StartDiscoveringUseCase } from \"@internal/discovery/use-case/StartDiscoveringUseCase\";\nimport type { StopDiscoveringUseCase } from \"@internal/discovery/use-case/StopDiscoveringUseCase\";\nimport { sendTypes } from \"@internal/send/di/sendTypes\";\nimport { type SendApduUseCase } from \"@internal/send/use-case/SendApduUseCase\";\nimport { makeContainer, type MakeContainerProps } from \"@root/src/di\";\n\nimport {\n  type DeviceActionIntermediateValue,\n  type ExecuteDeviceActionReturnType,\n} from \"./device-action/DeviceAction\";\nimport { deviceActionTypes } from \"./device-action/di/deviceActionTypes\";\nimport { type DmkError } from \"./Error\";\n\n/**\n * The main class to interact with the Device Management Kit.\n *\n * NB: do not instantiate this class directly, instead, use `LedgerDMKBuilder`.\n */\nexport class DeviceManagementKit {\n  readonly container: Container;\n  /** @internal */\n  constructor({\n    stub,\n    transports,\n    customTransports,\n    loggers,\n    config,\n  }: Partial<MakeContainerProps> = {}) {\n    // NOTE: MakeContainerProps might not be the exact type here\n    // For the init of the project this is sufficient, but we might need to\n    // update the constructor arguments as we go (we might have more than just the container config)\n    this.container = makeContainer({\n      stub,\n      transports,\n      customTransports,\n      loggers,\n      config,\n    });\n  }\n\n  /**\n   * Returns a promise resolving to the version of the SDK.\n   */\n  getVersion(): Promise<string> {\n    return this.container\n      .get<GetDmkVersionUseCase>(configTypes.GetDmkVersionUseCase)\n      .getDmkVersion();\n  }\n\n  /**\n   * Starts discovering devices connected.\n   *\n   * For the WeHID implementation, this use-case needs to be called as a result\n   * of an user interaction (button \"click\" event for ex).\n   *\n   * @param {StartDiscoveringUseCaseArgs} args - The transport to use for discover, or undefined to discover from all transports.\n   * @returns {Observable<DiscoveredDevice>} An observable of discovered devices.\n   */\n  startDiscovering(\n    args: StartDiscoveringUseCaseArgs,\n  ): Observable<DiscoveredDevice> {\n    return this.container\n      .get<StartDiscoveringUseCase>(discoveryTypes.StartDiscoveringUseCase)\n      .execute(args);\n  }\n\n  /**\n   * Stops discovering devices connected.\n   */\n  stopDiscovering() {\n    return this.container\n      .get<StopDiscoveringUseCase>(discoveryTypes.StopDiscoveringUseCase)\n      .execute();\n  }\n\n  /**\n   * Listen to list of known discovered devices (and later BLE).\n   *\n   * @returns {Observable<DiscoveredDevice[]>} An observable of known discovered devices.\n   */\n  listenToKnownDevices(): Observable<DiscoveredDevice[]> {\n    return this.container\n      .get<ListenToKnownDevicesUseCase>(\n        discoveryTypes.ListenToKnownDevicesUseCase,\n      )\n      .execute();\n  }\n\n  /**\n   * Connects to a device previously discovered with `DeviceManagementKit.startDiscovering`.\n   * Creates a new device session which:\n   * - Represents the connection to the device.\n   * - Is terminated upon disconnection of the device.\n   * - Exposes the device state through an observable (see `DeviceManagementKit.getDeviceSessionState`)\n   * - Should be used for all subsequent communication with the device.\n   *\n   * @param {ConnectUseCaseArgs} args - The device ID (obtained in discovery) to connect to.\n   * @returns The session ID to use for further communication with the device.\n   */\n  connect(args: ConnectUseCaseArgs): Promise<DeviceSessionId> {\n    return this.container\n      .get<ConnectUseCase>(discoveryTypes.ConnectUseCase)\n      .execute(args);\n  }\n\n  /**\n   * Disconnects to a discovered device.\n   *\n   * @param {DisconnectUseCaseArgs} args - The session ID to disconnect.\n   */\n  disconnect(args: DisconnectUseCaseArgs): Promise<void> {\n    return this.container\n      .get<DisconnectUseCase>(discoveryTypes.DisconnectUseCase)\n      .execute(args);\n  }\n\n  /**\n   * Sends an APDU command to a device through a device session.\n   *\n   * @param {SendApduUseCaseArgs} args - The device session ID and APDU command to send.\n   */\n  sendApdu(args: SendApduUseCaseArgs): Promise<ApduResponse> {\n    return this.container\n      .get<SendApduUseCase>(sendTypes.SendApduUseCase)\n      .execute(args);\n  }\n\n  /**\n   * Sends a command to a device through a device session.\n   *\n   * @param {SendCommandUseCaseArgs<Response, Args, ErrorCodes>} args - The device session ID, command, command error codes and command parameters to send.\n   * @returns A promise resolving with the response from the command.\n   */\n  sendCommand<Response, Args, ErrorCodes>(\n    args: SendCommandUseCaseArgs<Response, Args, ErrorCodes>,\n  ): Promise<CommandResult<Response, ErrorCodes>> {\n    return this.container\n      .get<SendCommandUseCase>(commandTypes.SendCommandUseCase)\n      .execute(args);\n  }\n\n  executeDeviceAction<\n    Output,\n    Input,\n    Error extends DmkError,\n    IntermediateValue extends DeviceActionIntermediateValue,\n  >(\n    args: ExecuteDeviceActionUseCaseArgs<\n      Output,\n      Input,\n      Error,\n      IntermediateValue\n    >,\n  ): ExecuteDeviceActionReturnType<Output, Error, IntermediateValue> {\n    return this.container\n      .get<ExecuteDeviceActionUseCase>(\n        deviceActionTypes.ExecuteDeviceActionUseCase,\n      )\n      .execute(args);\n  }\n\n  /**\n   * Gets the connected from its device session ID.\n   *\n   * @param {GetConnectedDeviceUseCaseArgs} args - The device session ID.\n   * @returns {ConnectedDevice} The connected device.\n   */\n  getConnectedDevice(args: GetConnectedDeviceUseCaseArgs): ConnectedDevice {\n    return this.container\n      .get<GetConnectedDeviceUseCase>(discoveryTypes.GetConnectedDeviceUseCase)\n      .execute(args);\n  }\n\n  /**\n   * Gets the device state of a session.\n   *\n   * @param {{DeviceSessionId}} args - The device session ID.\n   * @returns {Observable<DeviceSessionState>} An observable of the session device state.\n   */\n  getDeviceSessionState(args: {\n    sessionId: DeviceSessionId;\n  }): Observable<DeviceSessionState> {\n    return this.container\n      .get<GetDeviceSessionStateUseCase>(\n        deviceSessionTypes.GetDeviceSessionStateUseCase,\n      )\n      .execute(args);\n  }\n\n  /**\n   * Close the Device Management kit.\n   *\n   */\n  close() {\n    return this.container\n      .get<CloseSessionsUseCase>(deviceSessionTypes.CloseSessionsUseCase)\n      .execute();\n  }\n\n  /**\n   * Lists all connected devices.\n   *\n   * @returns {ConnectedDevice[]} The list of device sessions.\n   */\n  listConnectedDevices(): ConnectedDevice[] {\n    return this.container\n      .get<ListConnectedDevicesUseCase>(\n        discoveryTypes.ListConnectedDevicesUseCase,\n      )\n      .execute();\n  }\n\n  /**\n   * Listen to connected device.\n   *\n   * @returns {Observable<ConnectedDevice>} An observable of connected device.\n   */\n  listenToConnectedDevice(): Observable<ConnectedDevice> {\n    return this.container\n      .get<ListenToConnectedDeviceUseCase>(\n        discoveryTypes.ListenToConnectedDeviceUseCase,\n      )\n      .execute();\n  }\n}\n"],
+  "mappings": "AAGA,OAAS,gBAAAA,MAAoB,+BAsB7B,OAAS,eAAAC,MAAmB,kCAE5B,OAAS,sBAAAC,MAA0B,iDAGnC,OAAS,kBAAAC,MAAsB,wCAS/B,OAAS,aAAAC,MAAiB,8BAE1B,OAAS,iBAAAC,MAA8C,eAMvD,OAAS,qBAAAC,MAAyB,uCAQ3B,MAAMC,CAAoB,CACtB,UAET,YAAY,CACV,KAAAC,EACA,WAAAC,EACA,iBAAAC,EACA,QAAAC,EACA,OAAAC,CACF,EAAiC,CAAC,EAAG,CAInC,KAAK,UAAYP,EAAc,CAC7B,KAAAG,EACA,WAAAC,EACA,iBAAAC,EACA,QAAAC,EACA,OAAAC,CACF,CAAC,CACH,CAKA,YAA8B,CAC5B,OAAO,KAAK,UACT,IAA0BX,EAAY,oBAAoB,EAC1D,cAAc,CACnB,CAWA,iBACEY,EAC8B,CAC9B,OAAO,KAAK,UACT,IAA6BV,EAAe,uBAAuB,EACnE,QAAQU,CAAI,CACjB,CAKA,iBAAkB,CAChB,OAAO,KAAK,UACT,IAA4BV,EAAe,sBAAsB,EACjE,QAAQ,CACb,CAOA,sBAAuD,CACrD,OAAO,KAAK,UACT,IACCA,EAAe,2BACjB,EACC,QAAQ,CACb,CAaA,QAAQU,EAAoD,CAC1D,OAAO,KAAK,UACT,IAAoBV,EAAe,cAAc,EACjD,QAAQU,CAAI,CACjB,CAOA,WAAWA,EAA4C,CACrD,OAAO,KAAK,UACT,IAAuBV,EAAe,iBAAiB,EACvD,QAAQU,CAAI,CACjB,CAOA,SAASA,EAAkD,CACzD,OAAO,KAAK,UACT,IAAqBT,EAAU,eAAe,EAC9C,QAAQS,CAAI,CACjB,CAQA,YACEA,EAC8C,CAC9C,OAAO,KAAK,UACT,IAAwBb,EAAa,kBAAkB,EACvD,QAAQa,CAAI,CACjB,CAEA,oBAMEA,EAMiE,CACjE,OAAO,KAAK,UACT,IACCP,EAAkB,0BACpB,EACC,QAAQO,CAAI,CACjB,CAQA,mBAAmBA,EAAsD,CACvE,OAAO,KAAK,UACT,IAA+BV,EAAe,yBAAyB,EACvE,QAAQU,CAAI,CACjB,CAQA,sBAAsBA,EAEa,CACjC,OAAO,KAAK,UACT,IACCX,EAAmB,4BACrB,EACC,QAAQW,CAAI,CACjB,CAMA,OAAQ,CACN,OAAO,KAAK,UACT,IAA0BX,EAAmB,oBAAoB,EACjE,QAAQ,CACb,CAOA,sBAA0C,CACxC,OAAO,KAAK,UACT,IACCC,EAAe,2BACjB,EACC,QAAQ,CACb,CAOA,yBAAuD,CACrD,OAAO,KAAK,UACT,IACCA,EAAe,8BACjB,EACC,QAAQ,CACb,CACF",
+  "names": ["commandTypes", "configTypes", "deviceSessionTypes", "discoveryTypes", "sendTypes", "makeContainer", "deviceActionTypes", "DeviceManagementKit", "stub", "transports", "customTransports", "loggers", "config", "args"]
+}

package/lib/esm/src/api/DeviceManagementKit.test.js

@@ -0,0 +1,2 @@
+import{StubLocalConfigDataSource as c}from"../internal/config/data/LocalConfigDataSource.stub";import{configTypes as a}from"../internal/config/di/configTypes";import{deviceSessionTypes as r}from"../internal/device-session/di/deviceSessionTypes";import{discoveryTypes as t}from"../internal/discovery/di/discoveryTypes";import{sendTypes as d}from"../internal/send/di/sendTypes";import m from"../../package.json";import{StubUseCase as p}from"../../src/di.stub";import{commandTypes as u}from"./command/di/commandTypes";import{ConsoleLogger as f}from"./logger-subscriber/service/ConsoleLogger";import{DeviceManagementKit as o}from"./DeviceManagementKit";jest.mock("./logger-subscriber/service/ConsoleLogger");let e,n;describe("DeviceManagementKit",()=>{describe("clean",()=>{beforeEach(()=>{n=new f,e=new o({stub:!1,loggers:[n],config:{managerApiUrl:"http://fake.url",mockUrl:"http://fake-mock.url"}})}),it("should create an instance",()=>{expect(e).toBeDefined(),expect(e).toBeInstanceOf(o)}),it("should return a clean `version`",async()=>{expect(await e.getVersion()).toBe(m.version)}),it("should have startDiscovery method",()=>{expect(e.startDiscovering).toBeDefined()}),it("should have stopDiscovery method",()=>{expect(e.stopDiscovering).toBeDefined()}),it("should have connect method",()=>{expect(e.connect).toBeDefined()}),it("should have sendApdu method",()=>{expect(e.sendApdu).toBeDefined()}),it("should have getConnectedDevice method",()=>{expect(e.getConnectedDevice).toBeDefined()}),it("should have sendCommand method",()=>{expect(e.sendCommand).toBeDefined()}),it("should have listConnectedDevices method",()=>{expect(e.listConnectedDevices).toBeDefined()}),it("should have listenToConnectedDevice method",()=>{expect(e.listenToConnectedDevice).toBeDefined()})}),describe("stubbed",()=>{beforeEach(()=>{e=new o({stub:!0,loggers:[],config:{managerApiUrl:"http://fake.url",mockUrl:"http://fake-mock.url"}})}),it("should create a stubbed dmk",()=>{expect(e).toBeDefined(),expect(e).toBeInstanceOf(o)}),it("should return a stubbed config",()=>{expect(e.container.get(a.LocalConfigDataSource)).toBeInstanceOf(c)}),it("should return a stubbed version",async()=>{expect(await e.getVersion()).toBe("0.0.0-stub.1")}),it.each([[t.StartDiscoveringUseCase],[t.StopDiscoveringUseCase],[t.ConnectUseCase],[d.SendApduUseCase],[u.SendCommandUseCase],[t.GetConnectedDeviceUseCase],[t.DisconnectUseCase],[r.GetDeviceSessionStateUseCase],[t.ListConnectedDevicesUseCase],[t.ListenToConnectedDeviceUseCase]])("should have %p use case",i=>{const s=e.container.get(i);expect(s).toBeInstanceOf(p),expect(s.execute()).toBe("stub")})})});
+//# sourceMappingURL=DeviceManagementKit.test.js.map

package/lib/esm/src/api/DeviceManagementKit.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/api/DeviceManagementKit.test.ts"],
+  "sourcesContent": ["import { type interfaces } from \"inversify\";\n\nimport { type LocalConfigDataSource } from \"@internal/config/data/ConfigDataSource\";\nimport { StubLocalConfigDataSource } from \"@internal/config/data/LocalConfigDataSource.stub\";\nimport { configTypes } from \"@internal/config/di/configTypes\";\nimport { deviceSessionTypes } from \"@internal/device-session/di/deviceSessionTypes\";\nimport { discoveryTypes } from \"@internal/discovery/di/discoveryTypes\";\nimport { sendTypes } from \"@internal/send/di/sendTypes\";\nimport pkg from \"@root/package.json\";\nimport { StubUseCase } from \"@root/src/di.stub\";\n\nimport { commandTypes } from \"./command/di/commandTypes\";\nimport { ConsoleLogger } from \"./logger-subscriber/service/ConsoleLogger\";\nimport { DeviceManagementKit } from \"./DeviceManagementKit\";\n\njest.mock(\"./logger-subscriber/service/ConsoleLogger\");\n\nlet dmk: DeviceManagementKit;\nlet logger: ConsoleLogger;\ndescribe(\"DeviceManagementKit\", () => {\n  describe(\"clean\", () => {\n    beforeEach(() => {\n      logger = new ConsoleLogger();\n      dmk = new DeviceManagementKit({\n        stub: false,\n        loggers: [logger],\n        config: {\n          managerApiUrl: \"http://fake.url\",\n          mockUrl: \"http://fake-mock.url\",\n        },\n      });\n    });\n\n    it(\"should create an instance\", () => {\n      expect(dmk).toBeDefined();\n      expect(dmk).toBeInstanceOf(DeviceManagementKit);\n    });\n\n    it(\"should return a clean `version`\", async () => {\n      expect(await dmk.getVersion()).toBe(pkg.version);\n    });\n\n    it(\"should have startDiscovery method\", () => {\n      expect(dmk.startDiscovering).toBeDefined();\n    });\n\n    it(\"should have stopDiscovery method\", () => {\n      expect(dmk.stopDiscovering).toBeDefined();\n    });\n\n    it(\"should have connect method\", () => {\n      expect(dmk.connect).toBeDefined();\n    });\n\n    it(\"should have sendApdu method\", () => {\n      expect(dmk.sendApdu).toBeDefined();\n    });\n\n    it(\"should have getConnectedDevice method\", () => {\n      expect(dmk.getConnectedDevice).toBeDefined();\n    });\n\n    it(\"should have sendCommand method\", () => {\n      expect(dmk.sendCommand).toBeDefined();\n    });\n\n    it(\"should have listConnectedDevices method\", () => {\n      expect(dmk.listConnectedDevices).toBeDefined();\n    });\n\n    it(\"should have listenToConnectedDevice method\", () => {\n      expect(dmk.listenToConnectedDevice).toBeDefined();\n    });\n  });\n\n  describe(\"stubbed\", () => {\n    beforeEach(() => {\n      dmk = new DeviceManagementKit({\n        stub: true,\n        loggers: [],\n        config: {\n          managerApiUrl: \"http://fake.url\",\n          mockUrl: \"http://fake-mock.url\",\n        },\n      });\n    });\n\n    it(\"should create a stubbed dmk\", () => {\n      expect(dmk).toBeDefined();\n      expect(dmk).toBeInstanceOf(DeviceManagementKit);\n    });\n\n    it(\"should return a stubbed config\", () => {\n      expect(\n        dmk.container.get<LocalConfigDataSource>(\n          configTypes.LocalConfigDataSource,\n        ),\n      ).toBeInstanceOf(StubLocalConfigDataSource);\n    });\n\n    it(\"should return a stubbed version\", async () => {\n      expect(await dmk.getVersion()).toBe(\"0.0.0-stub.1\");\n    });\n\n    it.each([\n      [discoveryTypes.StartDiscoveringUseCase],\n      [discoveryTypes.StopDiscoveringUseCase],\n      [discoveryTypes.ConnectUseCase],\n      [sendTypes.SendApduUseCase],\n      [commandTypes.SendCommandUseCase],\n      [discoveryTypes.GetConnectedDeviceUseCase],\n      [discoveryTypes.DisconnectUseCase],\n      [deviceSessionTypes.GetDeviceSessionStateUseCase],\n      [discoveryTypes.ListConnectedDevicesUseCase],\n      [discoveryTypes.ListenToConnectedDeviceUseCase],\n    ])(\n      \"should have %p use case\",\n      (diSymbol: interfaces.ServiceIdentifier<StubUseCase>) => {\n        const uc = dmk.container.get<StubUseCase>(diSymbol);\n        expect(uc).toBeInstanceOf(StubUseCase);\n        expect(uc.execute()).toBe(\"stub\");\n      },\n    );\n  });\n});\n"],
+  "mappings": "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",
+  "names": ["StubLocalConfigDataSource", "configTypes", "deviceSessionTypes", "discoveryTypes", "sendTypes", "pkg", "StubUseCase", "commandTypes", "ConsoleLogger", "DeviceManagementKit", "dmk", "logger", "diSymbol", "uc"]
+}

package/lib/esm/src/api/DeviceManagementKitBuilder.js

@@ -0,0 +1,2 @@
+import{DEFAULT_MANAGER_API_BASE_URL as t,DEFAULT_MOCK_SERVER_BASE_URL as e}from"../internal/manager-api/model/Const";import{DeviceManagementKit as i}from"./DeviceManagementKit";class a{stub=!1;loggers=[];transports=[];customTransports=[];config={managerApiUrl:t,mockUrl:e};build(){return new i({stub:this.stub,transports:this.transports,customTransports:this.customTransports,loggers:this.loggers,config:this.config})}setStub(r){return this.stub=r,this}addTransport(r){return this.transports.push(r),this}addCustomTransport(r){return this.customTransports.push(r),this}addLogger(r){return this.loggers.push(r),this}addConfig(r){return this.config={...this.config,...r},this}}export{a as DeviceManagementKitBuilder};
+//# sourceMappingURL=DeviceManagementKitBuilder.js.map

package/lib/esm/src/api/DeviceManagementKitBuilder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/api/DeviceManagementKitBuilder.ts"],
+  "sourcesContent": ["import {\n  DEFAULT_MANAGER_API_BASE_URL,\n  DEFAULT_MOCK_SERVER_BASE_URL,\n} from \"@internal/manager-api/model/Const\";\n\nimport { type LoggerSubscriberService } from \"./logger-subscriber/service/LoggerSubscriberService\";\nimport { type Transport } from \"./transport/model/Transport\";\nimport { type BuiltinTransports } from \"./transport/model/TransportIdentifier\";\nimport { DeviceManagementKit } from \"./DeviceManagementKit\";\nimport { type DmkConfig } from \"./DmkConfig\";\n\n/**\n * Builder for the `DeviceManagementKit` class.\n *\n * @example\n * ```\n * const dmk = new LedgerDeviceManagementKitBuilder()\n *  .setStub(false)\n *  .addTransport(BuiltinTransports.USB)\n *  .addCustomTransport(new MyTransport())\n *  .addLogger(myLogger)\n *  .build();\n * ```\n */\nexport class DeviceManagementKitBuilder {\n  private stub = false;\n  private readonly loggers: LoggerSubscriberService[] = [];\n  private readonly transports: BuiltinTransports[] = [];\n  private readonly customTransports: Transport[] = [];\n  private config: DmkConfig = {\n    managerApiUrl: DEFAULT_MANAGER_API_BASE_URL,\n    mockUrl: DEFAULT_MOCK_SERVER_BASE_URL,\n  };\n\n  build(): DeviceManagementKit {\n    return new DeviceManagementKit({\n      stub: this.stub,\n      transports: this.transports,\n      customTransports: this.customTransports,\n      loggers: this.loggers,\n      config: this.config,\n    });\n  }\n\n  setStub(stubbed: boolean): DeviceManagementKitBuilder {\n    this.stub = stubbed;\n    return this;\n  }\n\n  addTransport(transport: BuiltinTransports): DeviceManagementKitBuilder {\n    this.transports.push(transport);\n    return this;\n  }\n\n  addCustomTransport(transport: Transport): DeviceManagementKitBuilder {\n    this.customTransports.push(transport);\n    return this;\n  }\n\n  /**\n   * Add a logger to the SDK that will receive its logs\n   */\n  addLogger(logger: LoggerSubscriberService): DeviceManagementKitBuilder {\n    this.loggers.push(logger);\n    return this;\n  }\n\n  addConfig(config: Partial<DmkConfig>): DeviceManagementKitBuilder {\n    this.config = {\n      ...this.config,\n      ...config,\n    };\n    return this;\n  }\n}\n"],
+  "mappings": "AAAA,OACE,gCAAAA,EACA,gCAAAC,MACK,oCAKP,OAAS,uBAAAC,MAA2B,wBAgB7B,MAAMC,CAA2B,CAC9B,KAAO,GACE,QAAqC,CAAC,EACtC,WAAkC,CAAC,EACnC,iBAAgC,CAAC,EAC1C,OAAoB,CAC1B,cAAeH,EACf,QAASC,CACX,EAEA,OAA6B,CAC3B,OAAO,IAAIC,EAAoB,CAC7B,KAAM,KAAK,KACX,WAAY,KAAK,WACjB,iBAAkB,KAAK,iBACvB,QAAS,KAAK,QACd,OAAQ,KAAK,MACf,CAAC,CACH,CAEA,QAAQE,EAA8C,CACpD,YAAK,KAAOA,EACL,IACT,CAEA,aAAaC,EAA0D,CACrE,YAAK,WAAW,KAAKA,CAAS,EACvB,IACT,CAEA,mBAAmBA,EAAkD,CACnE,YAAK,iBAAiB,KAAKA,CAAS,EAC7B,IACT,CAKA,UAAUC,EAA6D,CACrE,YAAK,QAAQ,KAAKA,CAAM,EACjB,IACT,CAEA,UAAUC,EAAwD,CAChE,YAAK,OAAS,CACZ,GAAG,KAAK,OACR,GAAGA,CACL,EACO,IACT,CACF",
+  "names": ["DEFAULT_MANAGER_API_BASE_URL", "DEFAULT_MOCK_SERVER_BASE_URL", "DeviceManagementKit", "DeviceManagementKitBuilder", "stubbed", "transport", "logger", "config"]
+}

package/lib/esm/src/api/DeviceManagementKitBuilder.test.js

@@ -0,0 +1,2 @@
+import{ConsoleLogger as i}from"./logger-subscriber/service/ConsoleLogger";import{DeviceManagementKit as r}from"./DeviceManagementKit";import{DeviceManagementKitBuilder as g}from"./DeviceManagementKitBuilder";jest.mock("./logger-subscriber/service/ConsoleLogger");let e,t;describe("LedgerDeviceManagementKitBuilder",()=>{beforeEach(()=>{e=new g}),it("should build a DeviceManagementKit instance",()=>{const o=e.build();expect(o).toBeInstanceOf(r)}),it("should set the stub flag",()=>{e.setStub(!0),expect(e.stub).toBe(!0)}),it("should add a logger",()=>{t=new i,e.addLogger(t),expect(e.loggers).toContain(t)})});
+//# sourceMappingURL=DeviceManagementKitBuilder.test.js.map

package/lib/esm/src/api/DeviceManagementKitBuilder.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/api/DeviceManagementKitBuilder.test.ts"],
+  "sourcesContent": ["import { ConsoleLogger } from \"./logger-subscriber/service/ConsoleLogger\";\nimport { DeviceManagementKit } from \"./DeviceManagementKit\";\nimport { DeviceManagementKitBuilder } from \"./DeviceManagementKitBuilder\";\n\njest.mock(\"./logger-subscriber/service/ConsoleLogger\");\n\nlet builder: DeviceManagementKitBuilder;\nlet logger: ConsoleLogger;\n\ndescribe(\"LedgerDeviceManagementKitBuilder\", () => {\n  beforeEach(() => {\n    builder = new DeviceManagementKitBuilder();\n  });\n\n  it(\"should build a DeviceManagementKit instance\", () => {\n    const dmk: DeviceManagementKit = builder.build();\n    expect(dmk).toBeInstanceOf(DeviceManagementKit);\n  });\n\n  it(\"should set the stub flag\", () => {\n    builder.setStub(true);\n    // @ts-expect-error Access private field stub\n    expect(builder.stub).toBe(true);\n  });\n\n  it(\"should add a logger\", () => {\n    logger = new ConsoleLogger();\n    builder.addLogger(logger);\n    // @ts-expect-error Access private field loggers\n    expect(builder.loggers).toContain(logger);\n  });\n});\n"],
+  "mappings": "AAAA,OAAS,iBAAAA,MAAqB,4CAC9B,OAAS,uBAAAC,MAA2B,wBACpC,OAAS,8BAAAC,MAAkC,+BAE3C,KAAK,KAAK,2CAA2C,EAErD,IAAIC,EACAC,EAEJ,SAAS,mCAAoC,IAAM,CACjD,WAAW,IAAM,CACfD,EAAU,IAAID,CAChB,CAAC,EAED,GAAG,8CAA+C,IAAM,CACtD,MAAMG,EAA2BF,EAAQ,MAAM,EAC/C,OAAOE,CAAG,EAAE,eAAeJ,CAAmB,CAChD,CAAC,EAED,GAAG,2BAA4B,IAAM,CACnCE,EAAQ,QAAQ,EAAI,EAEpB,OAAOA,EAAQ,IAAI,EAAE,KAAK,EAAI,CAChC,CAAC,EAED,GAAG,sBAAuB,IAAM,CAC9BC,EAAS,IAAIJ,EACbG,EAAQ,UAAUC,CAAM,EAExB,OAAOD,EAAQ,OAAO,EAAE,UAAUC,CAAM,CAC1C,CAAC,CACH,CAAC",
+  "names": ["ConsoleLogger", "DeviceManagementKit", "DeviceManagementKitBuilder", "builder", "logger", "dmk"]
+}

package/lib/esm/src/api/DmkConfig.js

@@ -0,0 +1 @@
+//# sourceMappingURL=DmkConfig.js.map

package/lib/esm/src/api/DmkConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/lib/esm/src/api/Error.js

@@ -0,0 +1,2 @@
+class s{_tag;originalError;errorCode;message;constructor({tag:r,errorCode:o,originalError:n,message:i}){this._tag=r,this.originalError=n,this.errorCode=o,this.message=i??"An error occured during device exchange."}}class a{_tag="UnknownDeviceExchangeError";originalError;message;constructor(r){this.originalError=r,this.message="Unexpected device exchange error happened."}}export{s as DeviceExchangeError,a as UnknownDeviceExchangeError};
+//# sourceMappingURL=Error.js.map

package/lib/esm/src/api/Error.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/api/Error.ts"],
+  "sourcesContent": ["export interface DmkError {\n  readonly _tag: string;\n  readonly originalError?: unknown;\n  message?: string;\n}\n\nexport type DeviceExchangeErrorArgs<SpecificErrorCodes> = {\n  tag: string;\n  originalError?: unknown;\n  errorCode: SpecificErrorCodes;\n  message: string;\n};\n\nexport type CommandErrorArgs<SpecificErrorCodes> = Omit<\n  DeviceExchangeErrorArgs<SpecificErrorCodes>,\n  \"tag\"\n>;\n\nexport abstract class DeviceExchangeError<SpecificErrorCodes = void> {\n  readonly _tag: string;\n  readonly originalError?: unknown;\n  readonly errorCode: SpecificErrorCodes;\n  readonly message: string;\n\n  protected constructor({\n    tag,\n    errorCode,\n    originalError,\n    message,\n  }: DeviceExchangeErrorArgs<SpecificErrorCodes>) {\n    this._tag = tag;\n    this.originalError = originalError;\n    this.errorCode = errorCode;\n    this.message = message ?? \"An error occured during device exchange.\";\n  }\n}\n\nexport class UnknownDeviceExchangeError implements DmkError {\n  readonly _tag = \"UnknownDeviceExchangeError\";\n  readonly originalError?: unknown;\n  readonly message: string;\n\n  constructor(originalError?: unknown) {\n    this.originalError = originalError;\n    this.message = \"Unexpected device exchange error happened.\";\n  }\n}\n"],
+  "mappings": "AAkBO,MAAeA,CAA+C,CAC1D,KACA,cACA,UACA,QAEC,YAAY,CACpB,IAAAC,EACA,UAAAC,EACA,cAAAC,EACA,QAAAC,CACF,EAAgD,CAC9C,KAAK,KAAOH,EACZ,KAAK,cAAgBE,EACrB,KAAK,UAAYD,EACjB,KAAK,QAAUE,GAAW,0CAC5B,CACF,CAEO,MAAMC,CAA+C,CACjD,KAAO,6BACP,cACA,QAET,YAAYF,EAAyB,CACnC,KAAK,cAAgBA,EACrB,KAAK,QAAU,4CACjB,CACF",
+  "names": ["DeviceExchangeError", "tag", "errorCode", "originalError", "message", "UnknownDeviceExchangeError"]
+}

package/lib/esm/src/api/apdu/model/Apdu.js

@@ -0,0 +1,2 @@
+class s{cla;ins;p1;p2;data;constructor(t,n,r,a,e){this.cla=t,this.ins=n,this.p1=r,this.p2=a,this.data=e??new Uint8Array}getRawApdu(){const t=Uint8Array.from([this.cla,this.ins,this.p1,this.p2,this.data.length]),n=new Uint8Array(t.length+this.data.length);return n.set(t,0),this.data.length>0&&n.set(this.data,t.length),n}}export{s as Apdu};
+//# sourceMappingURL=Apdu.js.map

package/lib/esm/src/api/apdu/model/Apdu.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/model/Apdu.ts"],
+  "sourcesContent": ["/**\n * An APDU command that can be sent to a device.\n * DO NOT USE THIS CLASS DIRECTLY, use ApduBuilder instead.\n */\nexport class Apdu {\n  /**\n   * Instruction class (1 byte)\n   */\n  readonly cla: number;\n\n  /**\n   * Instruction code (1 byte)\n   */\n  readonly ins: number;\n\n  /**\n   * Instruction parameter 1 (2 bytes)\n   */\n  readonly p1: number;\n\n  /**\n   * Instruction parameter 2 (2 bytes)\n   */\n  readonly p2: number;\n\n  /**\n   * Bytes of data\n   */\n  readonly data: Uint8Array;\n\n  constructor(\n    cla: number,\n    ins: number,\n    p1: number,\n    p2: number,\n    data?: Uint8Array,\n  ) {\n    this.cla = cla;\n    this.ins = ins;\n    this.p1 = p1;\n    this.p2 = p2;\n    this.data = data ?? new Uint8Array();\n  }\n\n  /**\n   * Get the raw binary data of the APDU command\n   * @returns {Uint8Array} - The raw APDU command\n   */\n  getRawApdu(): Uint8Array {\n    const header = Uint8Array.from([\n      this.cla,\n      this.ins,\n      this.p1,\n      this.p2,\n      this.data.length,\n    ]);\n\n    const apdu = new Uint8Array(header.length + this.data.length);\n    apdu.set(header, 0);\n\n    if (this.data.length > 0) {\n      apdu.set(this.data, header.length);\n    }\n\n    return apdu;\n  }\n}\n"],
+  "mappings": "AAIO,MAAMA,CAAK,CAIP,IAKA,IAKA,GAKA,GAKA,KAET,YACEC,EACAC,EACAC,EACAC,EACAC,EACA,CACA,KAAK,IAAMJ,EACX,KAAK,IAAMC,EACX,KAAK,GAAKC,EACV,KAAK,GAAKC,EACV,KAAK,KAAOC,GAAQ,IAAI,UAC1B,CAMA,YAAyB,CACvB,MAAMC,EAAS,WAAW,KAAK,CAC7B,KAAK,IACL,KAAK,IACL,KAAK,GACL,KAAK,GACL,KAAK,KAAK,MACZ,CAAC,EAEKC,EAAO,IAAI,WAAWD,EAAO,OAAS,KAAK,KAAK,MAAM,EAC5D,OAAAC,EAAK,IAAID,EAAQ,CAAC,EAEd,KAAK,KAAK,OAAS,GACrBC,EAAK,IAAI,KAAK,KAAMD,EAAO,MAAM,EAG5BC,CACT,CACF",
+  "names": ["Apdu", "cla", "ins", "p1", "p2", "data", "header", "apdu"]
+}

package/lib/esm/src/api/apdu/model/Apdu.test.js

@@ -0,0 +1,2 @@
+import{Apdu as t}from"./Apdu";describe("Apdu",()=>{it("should create an instance",()=>{const x=new t(0,0,0,0);expect(x).toBeInstanceOf(t)}),it("should return the raw APDU",()=>{const x=new t(0,0,0,0);expect(x.getRawApdu()).toEqual(new Uint8Array([0,0,0,0,0]))}),it("should return the raw APDU with data",()=>{const x=new t(0,0,0,0,new Uint8Array([1,2,3]));expect(x.getRawApdu()).toEqual(new Uint8Array([0,0,0,0,3,1,2,3]))})});
+//# sourceMappingURL=Apdu.test.js.map

package/lib/esm/src/api/apdu/model/Apdu.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/model/Apdu.test.ts"],
+  "sourcesContent": ["import { Apdu } from \"./Apdu\";\n\ndescribe(\"Apdu\", () => {\n  it(\"should create an instance\", () => {\n    const apdu = new Apdu(0x00, 0x00, 0x00, 0x00);\n    expect(apdu).toBeInstanceOf(Apdu);\n  });\n\n  it(\"should return the raw APDU\", () => {\n    const apdu = new Apdu(0x00, 0x00, 0x00, 0x00);\n    expect(apdu.getRawApdu()).toEqual(\n      new Uint8Array([0x00, 0x00, 0x00, 0x00, 0x00]),\n    );\n  });\n\n  it(\"should return the raw APDU with data\", () => {\n    const apdu = new Apdu(\n      0x00,\n      0x00,\n      0x00,\n      0x00,\n      new Uint8Array([0x01, 0x02, 0x03]),\n    );\n    expect(apdu.getRawApdu()).toEqual(\n      new Uint8Array([0x00, 0x00, 0x00, 0x00, 0x03, 0x01, 0x02, 0x03]),\n    );\n  });\n});\n"],
+  "mappings": "AAAA,OAAS,QAAAA,MAAY,SAErB,SAAS,OAAQ,IAAM,CACrB,GAAG,4BAA6B,IAAM,CACpC,MAAMC,EAAO,IAAID,EAAK,EAAM,EAAM,EAAM,CAAI,EAC5C,OAAOC,CAAI,EAAE,eAAeD,CAAI,CAClC,CAAC,EAED,GAAG,6BAA8B,IAAM,CACrC,MAAMC,EAAO,IAAID,EAAK,EAAM,EAAM,EAAM,CAAI,EAC5C,OAAOC,EAAK,WAAW,CAAC,EAAE,QACxB,IAAI,WAAW,CAAC,EAAM,EAAM,EAAM,EAAM,CAAI,CAAC,CAC/C,CACF,CAAC,EAED,GAAG,uCAAwC,IAAM,CAC/C,MAAMA,EAAO,IAAID,EACf,EACA,EACA,EACA,EACA,IAAI,WAAW,CAAC,EAAM,EAAM,CAAI,CAAC,CACnC,EACA,OAAOC,EAAK,WAAW,CAAC,EAAE,QACxB,IAAI,WAAW,CAAC,EAAM,EAAM,EAAM,EAAM,EAAM,EAAM,EAAM,CAAI,CAAC,CACjE,CACF,CAAC,CACH,CAAC",
+  "names": ["Apdu", "apdu"]
+}

package/lib/esm/src/api/apdu/utils/ApduBuilder.js

@@ -0,0 +1,2 @@
+import{Apdu as i}from"../../apdu/model/Apdu";import{ByteArrayBuilder as n}from"./ByteArrayBuilder";const p=5,r=255,l=r+5;class A{_ins;_cla;_p1;p2;data=new n(r);constructor({ins:t,cla:a,p1:e,p2:d}){this._cla=a&255,this._ins=t&255,this._p1=e&255,this.p2=d&255}build=()=>new i(this._cla,this._ins,this._p1,this.p2,this.data.build());add8BitUIntToData=t=>(this.data.add8BitUIntToData(t),this);add16BitUIntToData=t=>(this.data.add16BitUIntToData(t),this);add32BitUIntToData=t=>(this.data.add32BitUIntToData(t),this);addBufferToData=t=>(this.data.addBufferToData(t),this);addHexaStringToData=t=>(this.data.addHexaStringToData(t),this);addAsciiStringToData=t=>(this.data.addAsciiStringToData(t),this);encodeInLVFromHexa=t=>(this.data.encodeInLVFromHexa(t),this);encodeInLVFromBuffer=t=>(this.data.encodeInLVFromBuffer(t),this);encodeInLVFromAscii=t=>(this.data.encodeInLVFromAscii(t),this);getAvailablePayloadLength=()=>this.data.getAvailablePayloadLength();getErrors=()=>this.data.getErrors()}export{r as APDU_MAX_PAYLOAD,l as APDU_MAX_SIZE,A as ApduBuilder,p as HEADER_LENGTH};
+//# sourceMappingURL=ApduBuilder.js.map

package/lib/esm/src/api/apdu/utils/ApduBuilder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/ApduBuilder.ts"],
+  "sourcesContent": ["import { Apdu } from \"@api/apdu/model/Apdu\";\n\nimport { type AppBuilderError } from \"./AppBuilderError\";\nimport { ByteArrayBuilder } from \"./ByteArrayBuilder\";\n\nexport const HEADER_LENGTH = 5;\nexport const APDU_MAX_PAYLOAD = 255;\nexport const APDU_MAX_SIZE = APDU_MAX_PAYLOAD + 5;\n\nexport type ApduBuilderArgs = {\n  readonly ins: number;\n  readonly cla: number;\n  readonly p1: number;\n  readonly p2: number;\n};\n\n/**\n * ApduBuilder is a utility class to help build APDU commands.\n * It allows to easily add data to the data field of the APDU command\n * and to encode this data in different formats.\n *\n * @example\n * ```\n * const apduBuilder = new ApduBuilder({ ins: 0x01, cla: 0x02, p1: 0x03, p2: 0x04 })\n *  .add8BitUIntToData(0x05)\n *  .add16BitUIntToData(0x0607)\n *  .addHexaStringToData(\"0x0809\")\n *  .addAsciiStringToData(\"hello\")\n *\n * const apdu = apduBuilder.build();\n * const builderErrors = apduBuilder.getErrors();\n * ```\n */\nexport class ApduBuilder {\n  private readonly _ins: number;\n  private readonly _cla: number;\n  private readonly _p1: number;\n  private readonly p2: number;\n  private data: ByteArrayBuilder = new ByteArrayBuilder(APDU_MAX_PAYLOAD);\n\n  constructor({ ins, cla, p1, p2 }: ApduBuilderArgs) {\n    this._cla = cla & 0xff;\n    this._ins = ins & 0xff;\n    this._p1 = p1 & 0xff;\n    this.p2 = p2 & 0xff;\n  }\n\n  // ==========\n  // Public API\n  // ==========\n\n  /**\n   * Build a new Apdu instance with the current state of the builder\n   * @returns {Apdu} - Returns a new Apdu instance\n   */\n  build = (): Apdu =>\n    new Apdu(this._cla, this._ins, this._p1, this.p2, this.data.build());\n\n  /**\n   * Add a 8-bit unsigned integer to the data field (max value 0xff = 255)\n   * @param value?: number - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  add8BitUIntToData = (value: number): ApduBuilder => {\n    this.data.add8BitUIntToData(value);\n    return this;\n  };\n\n  /**\n   * Add a 16-bit unsigned integer to the data field (max value 0xffff = 65535)\n   * @param value: number - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  add16BitUIntToData = (value: number): ApduBuilder => {\n    this.data.add16BitUIntToData(value);\n    return this;\n  };\n\n  /**\n   * Add a 32-bit unsigned integer to the data field (max value 0xffffffff = 4294967295)\n   * @param value: number - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  add32BitUIntToData = (value: number): ApduBuilder => {\n    this.data.add32BitUIntToData(value);\n    return this;\n  };\n\n  /**\n   * Add a Uint8Array to the data field if it has enough remaining space\n   * @param value: Uint8Array - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  addBufferToData = (value: Uint8Array): ApduBuilder => {\n    this.data.addBufferToData(value);\n    return this;\n  };\n\n  /**\n   * Add a string to the data field if it has enough remaining space\n   * and it can be formatted as a hexadecimal string\n   * @param value: string - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  addHexaStringToData = (value: string): ApduBuilder => {\n    this.data.addHexaStringToData(value);\n    return this;\n  };\n\n  /**\n   * Add an ascii string to the data field if it has enough remaining space\n   * @param value: string - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  addAsciiStringToData = (value: string): ApduBuilder => {\n    this.data.addAsciiStringToData(value);\n    return this;\n  };\n\n  /**\n   * Add a Length-Value encoded hexadecimal string to the data field if it has enough remaining space\n   * Length-Value encoding is a way to encode data in a binary format with the first byte\n   * being the length of the data and the following bytes being the data itself\n   * @param value: string - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  encodeInLVFromHexa = (value: string): ApduBuilder => {\n    this.data.encodeInLVFromHexa(value);\n    return this;\n  };\n\n  /**\n   * Add a Length-Value encoded buffer to the data field if it has enough remaining space\n   * Length-Value encoding is a way to encode data in a binary format with the first byte\n   * being the length of the data and the following bytes being the data itself\n   * @param value: Uint8Array - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  encodeInLVFromBuffer = (value: Uint8Array): ApduBuilder => {\n    this.data.encodeInLVFromBuffer(value);\n    return this;\n  };\n\n  /**\n   * Add a Length-Value encoded ascii string to the data field if it has enough remaining space\n   * Length-Value encoding is a way to encode data in a binary format with the first byte\n   * being the length of the data and the following bytes being the data itself\n   * @param value: string - The value to add to the data\n   * @returns {ApduBuilder} - Returns the current instance of ApduBuilder\n   */\n  encodeInLVFromAscii = (value: string): ApduBuilder => {\n    this.data.encodeInLVFromAscii(value);\n    return this;\n  };\n\n  /**\n   * Returns the remaining payload length\n   * @returns {number}\n   */\n  getAvailablePayloadLength = (): number =>\n    this.data.getAvailablePayloadLength();\n\n  /**\n   * Returns the current errors\n   * @returns {AppBuilderError[]} - Returns an array of errors\n   */\n  getErrors = (): AppBuilderError[] => this.data.getErrors();\n}\n"],
+  "mappings": "AAAA,OAAS,QAAAA,MAAY,uBAGrB,OAAS,oBAAAC,MAAwB,qBAE1B,MAAMC,EAAgB,EAChBC,EAAmB,IACnBC,EAAgBD,EAAmB,EA0BzC,MAAME,CAAY,CACN,KACA,KACA,IACA,GACT,KAAyB,IAAIJ,EAAiBE,CAAgB,EAEtE,YAAY,CAAE,IAAAG,EAAK,IAAAC,EAAK,GAAAC,EAAI,GAAAC,CAAG,EAAoB,CACjD,KAAK,KAAOF,EAAM,IAClB,KAAK,KAAOD,EAAM,IAClB,KAAK,IAAME,EAAK,IAChB,KAAK,GAAKC,EAAK,GACjB,CAUA,MAAQ,IACN,IAAIT,EAAK,KAAK,KAAM,KAAK,KAAM,KAAK,IAAK,KAAK,GAAI,KAAK,KAAK,MAAM,CAAC,EAOrE,kBAAqBU,IACnB,KAAK,KAAK,kBAAkBA,CAAK,EAC1B,MAQT,mBAAsBA,IACpB,KAAK,KAAK,mBAAmBA,CAAK,EAC3B,MAQT,mBAAsBA,IACpB,KAAK,KAAK,mBAAmBA,CAAK,EAC3B,MAQT,gBAAmBA,IACjB,KAAK,KAAK,gBAAgBA,CAAK,EACxB,MAST,oBAAuBA,IACrB,KAAK,KAAK,oBAAoBA,CAAK,EAC5B,MAQT,qBAAwBA,IACtB,KAAK,KAAK,qBAAqBA,CAAK,EAC7B,MAUT,mBAAsBA,IACpB,KAAK,KAAK,mBAAmBA,CAAK,EAC3B,MAUT,qBAAwBA,IACtB,KAAK,KAAK,qBAAqBA,CAAK,EAC7B,MAUT,oBAAuBA,IACrB,KAAK,KAAK,oBAAoBA,CAAK,EAC5B,MAOT,0BAA4B,IAC1B,KAAK,KAAK,0BAA0B,EAMtC,UAAY,IAAyB,KAAK,KAAK,UAAU,CAC3D",
+  "names": ["Apdu", "ByteArrayBuilder", "HEADER_LENGTH", "APDU_MAX_PAYLOAD", "APDU_MAX_SIZE", "ApduBuilder", "ins", "cla", "p1", "p2", "value"]
+}

package/lib/esm/src/api/apdu/utils/ApduBuilder.test.js

@@ -0,0 +1,2 @@
+import{APDU_MAX_PAYLOAD as o,ApduBuilder as a}from"./ApduBuilder";import{ValueOverflowError as i}from"./AppBuilderError";const x=new Uint8Array([224,1,0,0,0]),n=new Uint8Array([224,1,0,0,1,1]),d=new Uint8Array([224,1,0,0,2,51,2]),l=new Uint8Array([224,1,0,0,4,1,35,69,103]),u=new Uint8Array([224,1,0,0,5,128,129,130,131,132]),c=new Uint8Array([224,1,0,0,4,133,134,135,136]),s=new Uint8Array([224,1,0,0,4,3,161,162,163]),A=new Uint8Array([224,1,0,0,6,5,109,97,109,97,110]),r=new Uint8Array([224,1,0,0,3,2,240,241]),p=new Uint8Array([224,1,0,0,255,...Array(255).fill(170)]);let e;describe("ApduBuilder",()=>{describe("clean",()=>{beforeEach(()=>{e=new a({cla:224,ins:1,p1:0,p2:0})}),it("should create an instance",()=>{expect(e).toBeDefined(),expect(e).toBeInstanceOf(a)})}),describe("simple",()=>{beforeEach(()=>{e=new a({cla:224,ins:1,p1:0,p2:0})}),it("should serialize with an empty body",()=>{expect(e.build().getRawApdu()).toEqual(x)}),it("should serialize with an single byte body",()=>{e.add8BitUIntToData(1),expect(e.build().getRawApdu()).toEqual(n),expect(e.getErrors()).toEqual([])}),it("should serialize with an 2 byte body",()=>{e.add16BitUIntToData(13058),expect(e.build().getRawApdu()).toEqual(d),expect(e.getErrors()).toEqual([])}),it("should serialize with an 8 byte body from an hexastring",()=>{e.add32BitUIntToData(19088743),expect(e.build().getRawApdu()).toEqual(l),expect(e.getErrors()).toEqual([])}),it("should serialize with an 5 byte body from an hexastring",()=>{e.addHexaStringToData("0x8081828384"),expect(e.build().getRawApdu()).toEqual(u),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body from an hexastring without '0x'",()=>{e.addHexaStringToData("85868788"),expect(e.build().getRawApdu()).toEqual(c),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from an hexastring",()=>{e.encodeInLVFromHexa("0xA1A2A3"),expect(e.build().getRawApdu()).toEqual(s),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from an ascci string",()=>{e.encodeInLVFromAscii("maman"),expect(e.build().getRawApdu()).toEqual(A),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from a buffer",()=>{const t=new Uint8Array([240,241]);e.encodeInLVFromBuffer(t),expect(e.build().getRawApdu()).toEqual(r),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from a buffer",()=>{const t=new Uint8Array([240,241]);e.encodeInLVFromBuffer(t),expect(e.build().getRawApdu()).toEqual(r),expect(e.getErrors()).toEqual([])}),it("should serialize with an complete body of 0xAA",()=>{const t=new Uint8Array(255).fill(170,0,255);e.addBufferToData(t),expect(e.build().getRawApdu()).toEqual(p),expect(e.getErrors()).toEqual([])})}),describe("error",()=>{beforeEach(()=>{e=new a({cla:224,ins:1,p1:0,p2:0})}),it("error due value greater than 8-bit integer",()=>{e.add8BitUIntToData(256),expect(e.build().getRawApdu()).toEqual(x),expect(e.getAvailablePayloadLength()).toBe(o),expect(e.getErrors()).toEqual([new i("256",255)])})})});
+//# sourceMappingURL=ApduBuilder.test.js.map

package/lib/esm/src/api/apdu/utils/ApduBuilder.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/ApduBuilder.test.ts"],
+  "sourcesContent": ["import { APDU_MAX_PAYLOAD, ApduBuilder } from \"./ApduBuilder\";\nimport { ValueOverflowError } from \"./AppBuilderError\";\n\nconst COMMAND_NO_BODY = new Uint8Array([0xe0, 0x01, 0x00, 0x00, 0x00]);\n\nconst COMMAND_BODY_SINGLE = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x01, 0x01,\n]);\n\nconst COMMAND_BODY_TWO = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x02, 0x33, 0x02,\n]);\n\nconst COMMAND_BODY_EIGHT = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x04, 0x01, 0x23, 0x45, 0x67,\n]);\n\nconst COMMAND_BODY_HEXA1 = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x05, 0x80, 0x81, 0x82, 0x83, 0x84,\n]);\n\nconst COMMAND_BODY_HEXA2 = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x04, 0x85, 0x86, 0x87, 0x88,\n]);\n\nconst COMMAND_BODY_LV_HEXA = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x04, 0x03, 0xa1, 0xa2, 0xa3,\n]);\n\nconst COMMAND_BODY_LV_ASCII = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x06, 0x05, 0x6d, 0x61, 0x6d, 0x61, 0x6e,\n]);\n\nconst COMMAND_BODY_LV_ARRAY = new Uint8Array([\n  0xe0, 0x01, 0x00, 0x00, 0x03, 0x02, 0xf0, 0xf1,\n]);\n\nconst COMMAND_BODY_MAX = new Uint8Array([\n  0xe0,\n  0x01,\n  0x00,\n  0x00,\n  0xff,\n  ...Array<number>(255).fill(0xaa),\n]);\n\nlet builder: ApduBuilder;\n\ndescribe(\"ApduBuilder\", () => {\n  describe(\"clean\", () => {\n    beforeEach(() => {\n      builder = new ApduBuilder({ cla: 0xe0, ins: 0x01, p1: 0x00, p2: 0x00 });\n    });\n\n    it(\"should create an instance\", () => {\n      expect(builder).toBeDefined();\n      expect(builder).toBeInstanceOf(ApduBuilder);\n    });\n  });\n\n  describe(\"simple\", () => {\n    beforeEach(() => {\n      builder = new ApduBuilder({ cla: 0xe0, ins: 0x01, p1: 0x00, p2: 0x00 });\n    });\n\n    it(\"should serialize with an empty body\", () => {\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_NO_BODY);\n    });\n\n    it(\"should serialize with an single byte body\", () => {\n      builder.add8BitUIntToData(0x01);\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_SINGLE);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 2 byte body\", () => {\n      builder.add16BitUIntToData(0x3302);\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_TWO);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 8 byte body from an hexastring\", () => {\n      builder.add32BitUIntToData(0x01234567);\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_EIGHT);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 5 byte body from an hexastring\", () => {\n      builder.addHexaStringToData(\"0x8081828384\");\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_HEXA1);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body from an hexastring without '0x'\", () => {\n      builder.addHexaStringToData(\"85868788\");\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_HEXA2);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from an hexastring\", () => {\n      builder.encodeInLVFromHexa(\"0xA1A2A3\");\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_LV_HEXA);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from an ascci string\", () => {\n      builder.encodeInLVFromAscii(\"maman\");\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_LV_ASCII);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from a buffer\", () => {\n      const myarray = new Uint8Array([0xf0, 0xf1]);\n      builder.encodeInLVFromBuffer(myarray);\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_LV_ARRAY);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from a buffer\", () => {\n      const myarray = new Uint8Array([0xf0, 0xf1]);\n      builder.encodeInLVFromBuffer(myarray);\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_LV_ARRAY);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an complete body of 0xAA\", () => {\n      const myarray = new Uint8Array(255).fill(0xaa, 0, 255);\n      builder.addBufferToData(myarray);\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getErrors()).toEqual([]);\n    });\n  });\n\n  describe(\"error\", () => {\n    beforeEach(() => {\n      builder = new ApduBuilder({ cla: 0xe0, ins: 0x01, p1: 0x00, p2: 0x00 });\n    });\n\n    it(\"error due value greater than 8-bit integer\", () => {\n      builder.add8BitUIntToData(0x100);\n      expect(builder.build().getRawApdu()).toEqual(COMMAND_NO_BODY);\n      expect(builder.getAvailablePayloadLength()).toBe(APDU_MAX_PAYLOAD);\n      expect(builder.getErrors()).toEqual([\n        new ValueOverflowError((0x100).toString(), 255),\n      ]);\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": ["APDU_MAX_PAYLOAD", "ApduBuilder", "ValueOverflowError", "COMMAND_NO_BODY", "COMMAND_BODY_SINGLE", "COMMAND_BODY_TWO", "COMMAND_BODY_EIGHT", "COMMAND_BODY_HEXA1", "COMMAND_BODY_HEXA2", "COMMAND_BODY_LV_HEXA", "COMMAND_BODY_LV_ASCII", "COMMAND_BODY_LV_ARRAY", "COMMAND_BODY_MAX", "builder", "myarray"]
+}

package/lib/esm/src/api/apdu/utils/ApduParser.js

@@ -0,0 +1,2 @@
+import{ByteArrayParser as t}from"./ByteArrayParser";class i{parser;constructor(e){this.parser=new t(e.data)}testMinimalLength=e=>this.parser.testMinimalLength(e);extract8BitUInt=()=>this.parser.extract8BitUInt();extract16BitUInt=()=>this.parser.extract16BitUInt();extract32BitUInt=()=>this.parser.extract32BitUInt();extractFieldByLength=e=>this.parser.extractFieldByLength(e);extractFieldLVEncoded=()=>this.parser.extractFieldLVEncoded();extractFieldTLVEncoded=()=>this.parser.extractFieldTLVEncoded();encodeToHexaString(e,r=!1){return r?this.parser.encodeToHexaString(e,!0):this.parser.encodeToHexaString(e,!1)}encodeToString=e=>this.parser.encodeToString(e);getUnparsedRemainingLength=()=>this.parser.getUnparsedRemainingLength()}export{i as ApduParser};
+//# sourceMappingURL=ApduParser.js.map

package/lib/esm/src/api/apdu/utils/ApduParser.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/ApduParser.ts"],
+  "sourcesContent": ["import { type ApduResponse } from \"@api/device-session/ApduResponse\";\nimport { type HexaString } from \"@api/utils/HexaString\";\n\nimport { ByteArrayParser } from \"./ByteArrayParser\";\n\nexport type TaggedField = {\n  readonly tag: number;\n  readonly value: Uint8Array;\n};\n\n/**\n * ApduParser is a utility class to help parse APDU responses.\n *\n * It provides methods to extract fields of different types from the response.\n *\n * @example\n * ```\n * const parser = new ApduParser(apduResponse);\n * const targetId = parser.encodeToHexaString(parser.extractFieldByLength(4));\n * const seVersion = parser.encodeToString(parser.extractFieldLVEncoded());\n * ```\n */\nexport class ApduParser {\n  private parser: ByteArrayParser;\n\n  constructor(response: ApduResponse) {\n    this.parser = new ByteArrayParser(response.data);\n  }\n\n  /**\n   * Test if the length is greater than the response length\n   * @param length: number\n   * @returns {boolean} - Returns false if the length is greater than the response length\n   */\n  testMinimalLength = (length: number): boolean =>\n    this.parser.testMinimalLength(length);\n\n  /**\n   * Extract a single byte from the response\n   * @returns {number | undefined} - Returns the byte extracted from the response\n   */\n  extract8BitUInt = (): number | undefined => this.parser.extract8BitUInt();\n\n  /**\n   * Extract a 16-bit unsigned integer (Big Endian coding) from the response\n   * @returns {number | undefined} - Returns the 16-bit unsigned integer extracted from the response\n   */\n  extract16BitUInt = (): number | undefined => this.parser.extract16BitUInt();\n\n  /**\n   * Extract a 32-bit unsigned integer (Big Endian coding) from the response\n   * @returns {number | undefined} - Returns the 32-bit unsigned integer extracted from the response\n   */\n  extract32BitUInt = (): number | undefined => this.parser.extract32BitUInt();\n\n  /**\n   * Extract a field of a specified length from the response\n   * @param length: number - The length of the field to extract\n   * @returns {Uint8Array | undefined} - Returns the field extracted from the response\n   */\n  extractFieldByLength = (length: number): Uint8Array | undefined =>\n    this.parser.extractFieldByLength(length);\n\n  /**\n   * Extract a field from the response that is length-value encoded\n   * @returns {Uint8Array | undefined} - Returns the field extracted from the response\n   */\n  extractFieldLVEncoded = (): Uint8Array | undefined =>\n    this.parser.extractFieldLVEncoded();\n\n  /**\n   * Extract a field from the response that is tag-length-value encoded\n   * @returns {TaggedField | undefined} - Returns the field extracted from the response\n   */\n  extractFieldTLVEncoded = (): TaggedField | undefined =>\n    this.parser.extractFieldTLVEncoded();\n\n  /**\n   * Encode a value to a hexadecimal string\n   * @param value {Uint8Array} - The value to encode\n   * @param prefix {boolean} - Whether to add a prefix to the encoded value\n   * @returns {string} - The encoded value as a hexadecimal string\n   */\n  encodeToHexaString(value?: Uint8Array, prefix?: false): string;\n  encodeToHexaString(value?: Uint8Array, prefix?: true): HexaString;\n  encodeToHexaString(\n    value?: Uint8Array,\n    prefix: boolean = false,\n  ): HexaString | string {\n    return prefix\n      ? this.parser.encodeToHexaString(value, true)\n      : this.parser.encodeToHexaString(value, false);\n  }\n\n  /**\n   * Encode a value to an ASCII string\n   * @param value {Uint8Array} - The value to encode\n   * @returns {string} - The encoded value as an ASCII string\n   */\n  encodeToString = (value?: Uint8Array): string =>\n    this.parser.encodeToString(value);\n\n  /**\n   * Get the remaining length of the response\n   * @returns {number} - The remaining length of the response\n   */\n  getUnparsedRemainingLength = (): number =>\n    this.parser.getUnparsedRemainingLength();\n}\n"],
+  "mappings": "AAGA,OAAS,mBAAAA,MAAuB,oBAmBzB,MAAMC,CAAW,CACd,OAER,YAAYC,EAAwB,CAClC,KAAK,OAAS,IAAIF,EAAgBE,EAAS,IAAI,CACjD,CAOA,kBAAqBC,GACnB,KAAK,OAAO,kBAAkBA,CAAM,EAMtC,gBAAkB,IAA0B,KAAK,OAAO,gBAAgB,EAMxE,iBAAmB,IAA0B,KAAK,OAAO,iBAAiB,EAM1E,iBAAmB,IAA0B,KAAK,OAAO,iBAAiB,EAO1E,qBAAwBA,GACtB,KAAK,OAAO,qBAAqBA,CAAM,EAMzC,sBAAwB,IACtB,KAAK,OAAO,sBAAsB,EAMpC,uBAAyB,IACvB,KAAK,OAAO,uBAAuB,EAUrC,mBACEC,EACAC,EAAkB,GACG,CACrB,OAAOA,EACH,KAAK,OAAO,mBAAmBD,EAAO,EAAI,EAC1C,KAAK,OAAO,mBAAmBA,EAAO,EAAK,CACjD,CAOA,eAAkBA,GAChB,KAAK,OAAO,eAAeA,CAAK,EAMlC,2BAA6B,IAC3B,KAAK,OAAO,2BAA2B,CAC3C",
+  "names": ["ByteArrayParser", "ApduParser", "response", "length", "value", "prefix"]
+}

package/lib/esm/src/api/apdu/utils/ApduParser.test.js

@@ -0,0 +1,2 @@
+import{ApduResponse as r}from"../../device-session/ApduResponse";import{ApduParser as t}from"./ApduParser";const a=new Uint8Array([144,0]),x=new Uint8Array([1]),c=new Uint8Array([0]),i=new Uint8Array([1,2,3,...Array(253).fill(170)]);let e,n=new r({statusCode:a,data:x});describe("ApduParser",()=>{it("should create an instance",()=>{e=new t(n),expect(e).toBeDefined(),expect(e).toBeInstanceOf(t)}),it("Extract a single byte",()=>{e=new t(n),expect(e.extract8BitUInt()).toBe(1)}),it("Extract 16-bit & 32-bit number",()=>{n=new r({statusCode:a,data:i}),e=new t(n),expect(e.extract16BitUInt()).toBe(258),expect(e.extract16BitUInt()).toBe(938)}),it("Test zero length",()=>{const s=new r({statusCode:a,data:c});e=new t(s);const o=e.extract8BitUInt();expect(o).toBe(0)})});
+//# sourceMappingURL=ApduParser.test.js.map

package/lib/esm/src/api/apdu/utils/ApduParser.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/ApduParser.test.ts"],
+  "sourcesContent": ["import { ApduResponse } from \"@api/device-session/ApduResponse\";\n\nimport { ApduParser } from \"./ApduParser\";\n\nconst STATUS_WORD_SUCCESS = new Uint8Array([0x90, 0x00]);\nconst RESPONSE_ONE_BYTE = new Uint8Array([0x01]);\nconst RESPONSE_LV_ZERO = new Uint8Array([0x00]);\nconst RESPONSE_ALL_BYTES = new Uint8Array([\n  0x01,\n  0x02,\n  0x03,\n  ...Array<number>(253).fill(0xaa),\n]);\n\nlet parser: ApduParser;\nlet response: ApduResponse = new ApduResponse({\n  statusCode: STATUS_WORD_SUCCESS,\n  data: RESPONSE_ONE_BYTE,\n});\n\ndescribe(\"ApduParser\", () => {\n  it(\"should create an instance\", () => {\n    parser = new ApduParser(response);\n    expect(parser).toBeDefined();\n    expect(parser).toBeInstanceOf(ApduParser);\n  });\n\n  it(\"Extract a single byte\", () => {\n    parser = new ApduParser(response);\n    expect(parser.extract8BitUInt()).toBe(0x01);\n  });\n\n  it(\"Extract 16-bit & 32-bit number\", () => {\n    response = new ApduResponse({\n      statusCode: STATUS_WORD_SUCCESS,\n      data: RESPONSE_ALL_BYTES,\n    });\n    parser = new ApduParser(response);\n    expect(parser.extract16BitUInt()).toBe(0x0102);\n    expect(parser.extract16BitUInt()).toBe(0x03aa);\n  });\n\n  it(\"Test zero length\", () => {\n    const response: ApduResponse = new ApduResponse({\n      statusCode: STATUS_WORD_SUCCESS,\n      data: RESPONSE_LV_ZERO,\n    });\n    parser = new ApduParser(response);\n    const value = parser.extract8BitUInt();\n    expect(value).toBe(0);\n  });\n});\n"],
+  "mappings": "AAAA,OAAS,gBAAAA,MAAoB,mCAE7B,OAAS,cAAAC,MAAkB,eAE3B,MAAMC,EAAsB,IAAI,WAAW,CAAC,IAAM,CAAI,CAAC,EACjDC,EAAoB,IAAI,WAAW,CAAC,CAAI,CAAC,EACzCC,EAAmB,IAAI,WAAW,CAAC,CAAI,CAAC,EACxCC,EAAqB,IAAI,WAAW,CACxC,EACA,EACA,EACA,GAAG,MAAc,GAAG,EAAE,KAAK,GAAI,CACjC,CAAC,EAED,IAAIC,EACAC,EAAyB,IAAIP,EAAa,CAC5C,WAAYE,EACZ,KAAMC,CACR,CAAC,EAED,SAAS,aAAc,IAAM,CAC3B,GAAG,4BAA6B,IAAM,CACpCG,EAAS,IAAIL,EAAWM,CAAQ,EAChC,OAAOD,CAAM,EAAE,YAAY,EAC3B,OAAOA,CAAM,EAAE,eAAeL,CAAU,CAC1C,CAAC,EAED,GAAG,wBAAyB,IAAM,CAChCK,EAAS,IAAIL,EAAWM,CAAQ,EAChC,OAAOD,EAAO,gBAAgB,CAAC,EAAE,KAAK,CAAI,CAC5C,CAAC,EAED,GAAG,iCAAkC,IAAM,CACzCC,EAAW,IAAIP,EAAa,CAC1B,WAAYE,EACZ,KAAMG,CACR,CAAC,EACDC,EAAS,IAAIL,EAAWM,CAAQ,EAChC,OAAOD,EAAO,iBAAiB,CAAC,EAAE,KAAK,GAAM,EAC7C,OAAOA,EAAO,iBAAiB,CAAC,EAAE,KAAK,GAAM,CAC/C,CAAC,EAED,GAAG,mBAAoB,IAAM,CAC3B,MAAMC,EAAyB,IAAIP,EAAa,CAC9C,WAAYE,EACZ,KAAME,CACR,CAAC,EACDE,EAAS,IAAIL,EAAWM,CAAQ,EAChC,MAAMC,EAAQF,EAAO,gBAAgB,EACrC,OAAOE,CAAK,EAAE,KAAK,CAAC,CACtB,CAAC,CACH,CAAC",
+  "names": ["ApduResponse", "ApduParser", "STATUS_WORD_SUCCESS", "RESPONSE_ONE_BYTE", "RESPONSE_LV_ZERO", "RESPONSE_ALL_BYTES", "parser", "response", "value"]
+}

package/lib/esm/src/api/apdu/utils/AppBuilderError.js

@@ -0,0 +1,2 @@
+import{APDU_MAX_PAYLOAD as a}from"./ApduBuilder";class l{_tag="ValueOverflow";originalError;message;constructor(r,e=a){this.message=`Value overflow for ${r}, max is ${e}`}}class s{_tag="DataOverflow";message;originalError;constructor(r,e=0){this.message=e===0?`this.data is already full (value: ${r})`:`this.data will overflow with "${r}", remaining bytes: ${e}`}}class i{_tag="HexaString";message;originalError;constructor(r){this.message=`Invalid encoded hexa string or length is null: ${r}`}}export{s as DataOverflowError,i as HexaStringEncodeError,l as ValueOverflowError};
+//# sourceMappingURL=AppBuilderError.js.map

package/lib/esm/src/api/apdu/utils/AppBuilderError.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/AppBuilderError.ts"],
+  "sourcesContent": ["import { type DmkError } from \"@api/Error\";\n\nimport { APDU_MAX_PAYLOAD } from \"./ApduBuilder\";\n\ninterface DmkAppBuilderError extends DmkError {\n  readonly message: string;\n}\n\nexport class ValueOverflowError implements DmkAppBuilderError {\n  readonly _tag = \"ValueOverflow\";\n  readonly originalError?: Error;\n  readonly message: string;\n  constructor(value: string, max: number | bigint = APDU_MAX_PAYLOAD) {\n    this.message = `Value overflow for ${value}, max is ${max}`;\n  }\n}\n\nexport class DataOverflowError implements DmkAppBuilderError {\n  readonly _tag = \"DataOverflow\";\n  readonly message: string;\n  readonly originalError?: Error;\n  constructor(value: string, remaining = 0) {\n    this.message =\n      remaining === 0\n        ? `this.data is already full (value: ${value})`\n        : `this.data will overflow with \"${value}\", remaining bytes: ${remaining}`;\n  }\n}\n\nexport class HexaStringEncodeError implements DmkAppBuilderError {\n  readonly _tag = \"HexaString\";\n  readonly message: string;\n  readonly originalError?: Error;\n  constructor(value: string) {\n    this.message = `Invalid encoded hexa string or length is null: ${value}`;\n  }\n}\n\n/**\n * Type for all possible errors that can be thrown by the AppBuilder.\n */\nexport type AppBuilderError =\n  | ValueOverflowError\n  | DataOverflowError\n  | HexaStringEncodeError;\n"],
+  "mappings": "AAEA,OAAS,oBAAAA,MAAwB,gBAM1B,MAAMC,CAAiD,CACnD,KAAO,gBACP,cACA,QACT,YAAYC,EAAeC,EAAuBH,EAAkB,CAClE,KAAK,QAAU,sBAAsBE,CAAK,YAAYC,CAAG,EAC3D,CACF,CAEO,MAAMC,CAAgD,CAClD,KAAO,eACP,QACA,cACT,YAAYF,EAAeG,EAAY,EAAG,CACxC,KAAK,QACHA,IAAc,EACV,qCAAqCH,CAAK,IAC1C,iCAAiCA,CAAK,uBAAuBG,CAAS,EAC9E,CACF,CAEO,MAAMC,CAAoD,CACtD,KAAO,aACP,QACA,cACT,YAAYJ,EAAe,CACzB,KAAK,QAAU,kDAAkDA,CAAK,EACxE,CACF",
+  "names": ["APDU_MAX_PAYLOAD", "ValueOverflowError", "value", "max", "DataOverflowError", "remaining", "HexaStringEncodeError"]
+}

package/lib/esm/src/api/apdu/utils/ByteArrayBuilder.js

@@ -0,0 +1,2 @@
+import{hexaStringToBuffer as u}from"../../utils/HexaString";import{DataOverflowError as a,HexaStringEncodeError as f,ValueOverflowError as h}from"./AppBuilderError";const g=4294967295;class m{constructor(r=g){this.maxPayloadSize=r}data=new Uint8Array;errors=[];build=()=>this.data;tryBuild=()=>this.hasErrors()?void 0:this.data;add8BitUIntToData=r=>this.addNumberToData(r,8n,!1,!1);add16BitUIntToData=(r,t=!0)=>this.addNumberToData(r,16n,!1,t);add32BitUIntToData=(r,t=!0)=>this.addNumberToData(r,32n,!1,t);add64BitUIntToData=(r,t=!0)=>this.addNumberToData(r,64n,!1,t);add16BitIntToData=(r,t=!0)=>this.addNumberToData(r,16n,!0,t);add32BitIntToData=(r,t=!0)=>this.addNumberToData(r,32n,!0,t);add64BitIntToData=(r,t=!0)=>this.addNumberToData(r,64n,!0,t);addBufferToData=r=>this.hasEnoughLengthRemaining(r)?(this.data=Uint8Array.from([...this.data,...r]),this):(this.errors.push(new a(r.toString())),this);addHexaStringToData=r=>{const t=u(r);return t===null||t.length===0?(this.errors.push(new f(r)),this):(this.addBufferToData(t),this)};addAsciiStringToData=r=>{const t=new TextEncoder().encode(r);return this.addBufferToData(t),this};encodeInLVFromHexa=r=>{const t=u(r);return t===null||t.length===0?(this.errors.push(new f(r)),this):this.hasEnoughLengthRemaining(t,!0)?(this.add8BitUIntToData(t.length),this.addBufferToData(t),this):(this.errors.push(new a(r)),this)};encodeInLVFromBuffer=r=>this.hasEnoughLengthRemaining(r,!0)?(this.add8BitUIntToData(r.length),this.addBufferToData(r),this):(this.errors.push(new a(r.toString())),this);encodeInLVFromAscii=r=>this.hasEnoughLengthRemaining(r,!0)?(this.add8BitUIntToData(r.length),this.addAsciiStringToData(r),this):(this.errors.push(new a(r)),this);getAvailablePayloadLength=()=>this.maxPayloadSize-this.data.length;getErrors=()=>this.errors;hasErrors=()=>this.errors.length!==0;hasEnoughLengthRemaining=(r,t=!1)=>this.data.length+r.length+(t?1:0)<=this.maxPayloadSize;addNumberToData(r,t,o,e){let n=this.checkBoundsAndConvert(r,t,o);if(n===void 0)return this;const s=Number(t)/8,d=new Uint8Array(s);if(e)for(let i=s-1;i>=0;i--)d[i]=Number(n&0xffn),n>>=8n;else for(let i=0;i<s;i++)d[i]=Number(n&0xffn),n>>=8n;return this.addBufferToData(d)}checkBoundsAndConvert(r,t,o){if(typeof r=="number"){if(!Number.isInteger(r)||r>Number.MAX_SAFE_INTEGER){this.errors.push(new h(r.toString()));return}r=BigInt(r)}if(o){const e=1n<<t-1n;if(r>=e||r<-e){this.errors.push(new h(r.toString(),e-1n));return}if(r<0n){const n=(1n<<t)-1n;r=-r,r=(~r&n)+1n}}else{const e=1n<<t;if(r<0||r>=e){this.errors.push(new h(r.toString(),e-1n));return}}return r}}export{m as ByteArrayBuilder};
+//# sourceMappingURL=ByteArrayBuilder.js.map

package/lib/esm/src/api/apdu/utils/ByteArrayBuilder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/ByteArrayBuilder.ts"],
+  "sourcesContent": ["import { hexaStringToBuffer } from \"@api/utils/HexaString\";\n\nimport {\n  type AppBuilderError,\n  DataOverflowError,\n  HexaStringEncodeError,\n  ValueOverflowError,\n} from \"./AppBuilderError\";\n\nconst MAX_32_BIT_UINT = 0xffffffff;\n\n/**\n * ByteArrayBuilder is a utility class to help build APDU payloads.\n * It allows to easily add data to the payload of an APDU command\n * and to encode this data in different formats.\n *\n * @example\n * ```\n * const builder = new ByteArrayBuilder(255)\n *  .add8BitUIntToData(0x05)\n *  .add16BitUIntToData(0x0607)\n *  .addHexaStringToData(\"0x0809\")\n *  .addAsciiStringToData(\"hello\")\n *\n * const payload = builder.build();\n * const builderErrors = builder.getErrors();\n * ```\n */\nexport class ByteArrayBuilder {\n  private data: Uint8Array = new Uint8Array();\n  private readonly errors: AppBuilderError[] = []; // Custom Error\n\n  constructor(private maxPayloadSize: number = MAX_32_BIT_UINT) {}\n\n  // ==========\n  // Public API\n  // ==========\n\n  /**\n   * Build a new payload instance with the current state of the builder\n   * @returns {payload} - Returns a new payload instance\n   */\n  build = (): Uint8Array => this.data;\n\n  /**\n   * Try to build a new payload instance with the current state of the builder\n   * if the builder don't contain any error.\n   * @returns {payload | undefined} - Returns a new payload instance or undefined\n   */\n  tryBuild = (): Uint8Array | undefined => {\n    return this.hasErrors() ? undefined : this.data;\n  };\n\n  /**\n   * Add a 8-bit unsigned integer to the payload (max value 0xff = 255)\n   * @param value: number | bigint - The value to add to the data\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  add8BitUIntToData = (value: number | bigint): ByteArrayBuilder => {\n    return this.addNumberToData(value, 8n, false, false);\n  };\n\n  /**\n   * Add a 16-bit unsigned integer to the payload (max value 0xffff = 65535)\n   * @param value: number | bigint - The value to add to the data\n   * @param bigEndian: boolean - True to encode in big endian, false for little endian\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  add16BitUIntToData = (\n    value: number | bigint,\n    bigEndian: boolean = true,\n  ): ByteArrayBuilder => {\n    return this.addNumberToData(value, 16n, false, bigEndian);\n  };\n\n  /**\n   * Add a 32-bit unsigned integer to the payload (max value 0xffffffff = 4294967295)\n   * @param value: number | bigint - The value to add to the data\n   * @param bigEndian: boolean - True to encode in big endian, false for little endian\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  add32BitUIntToData = (\n    value: number | bigint,\n    bigEndian: boolean = true,\n  ): ByteArrayBuilder => {\n    return this.addNumberToData(value, 32n, false, bigEndian);\n  };\n\n  /**\n   * Add a 64-bit unsigned integer to the payload (max value 0xffffffffffffffff = 18446744073709551615)\n   * @param value: number | bigint - The value to add to the data\n   * @param bigEndian: boolean - True to encode in big endian, false for little endian\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  add64BitUIntToData = (\n    value: number | bigint,\n    bigEndian: boolean = true,\n  ): ByteArrayBuilder => {\n    return this.addNumberToData(value, 64n, false, bigEndian);\n  };\n\n  /**\n   * Add a 16-bit signed integer to the payload (value between -0x8000 to 0x7fff)\n   * @param value: number | bigint - The value to add to the data\n   * @param bigEndian: boolean - True to encode in big endian, false for little endian\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  add16BitIntToData = (\n    value: number | bigint,\n    bigEndian: boolean = true,\n  ): ByteArrayBuilder => {\n    return this.addNumberToData(value, 16n, true, bigEndian);\n  };\n\n  /**\n   * Add a 32-bit signed integer to the payload (value between -0x80000000 to 0x7fffffff)\n   * @param value: number | bigint - The value to add to the data\n   * @param bigEndian: boolean - True to encode in big endian, false for little endian\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  add32BitIntToData = (\n    value: number | bigint,\n    bigEndian: boolean = true,\n  ): ByteArrayBuilder => {\n    return this.addNumberToData(value, 32n, true, bigEndian);\n  };\n\n  /**\n   * Add a 64-bit signed integer to the payload (value between -0x8000000000000000 to 0x7fffffffffffffff)\n   * @param value: number | bigint - The value to add to the data\n   * @param bigEndian: boolean - True to encode in big endian, false for little endian\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  add64BitIntToData = (\n    value: number | bigint,\n    bigEndian: boolean = true,\n  ): ByteArrayBuilder => {\n    return this.addNumberToData(value, 64n, true, bigEndian);\n  };\n\n  /**\n   * Add a Uint8Array to the payload if it has enough remaining space\n   * @param value: Uint8Array - The value to add to the data\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  addBufferToData = (value: Uint8Array): ByteArrayBuilder => {\n    if (!this.hasEnoughLengthRemaining(value)) {\n      this.errors.push(new DataOverflowError(value.toString()));\n      return this;\n    }\n\n    this.data = Uint8Array.from([...this.data, ...value]);\n    return this;\n  };\n\n  /**\n   * Add a string to the payload if it has enough remaining space\n   * and it can be formatted as a hexadecimal string\n   * @param value: string - The value to add to the data\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  addHexaStringToData = (value: string): ByteArrayBuilder => {\n    const result = hexaStringToBuffer(value);\n    if (result === null || result.length === 0) {\n      this.errors.push(new HexaStringEncodeError(value));\n      return this;\n    }\n    this.addBufferToData(result);\n    return this;\n  };\n\n  /**\n   * Add an ascii string to the data field if it has enough remaining space\n   * @param value: string - The value to add to the data\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  addAsciiStringToData = (value: string): ByteArrayBuilder => {\n    const bytes = new TextEncoder().encode(value);\n    this.addBufferToData(bytes);\n    return this;\n  };\n\n  /**\n   * Add a Length-Value encoded hexadecimal string to the data field if it has enough remaining space\n   * Length-Value encoding is a way to encode data in a binary format with the first byte\n   * being the length of the data and the following bytes being the data itself\n   * @param value: string - The value to add to the data\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  encodeInLVFromHexa = (value: string): ByteArrayBuilder => {\n    const result = hexaStringToBuffer(value);\n    if (result === null || result.length === 0) {\n      this.errors.push(new HexaStringEncodeError(value));\n      return this;\n    }\n\n    if (!this.hasEnoughLengthRemaining(result, true)) {\n      this.errors.push(new DataOverflowError(value));\n      return this;\n    }\n    // values are always being well formatted at this point\n    // therefore no status test is needed\n    this.add8BitUIntToData(result.length);\n    this.addBufferToData(result);\n    return this;\n  };\n\n  /**\n   * Add a Length-Value encoded buffer to the data field if it has enough remaining space\n   * Length-Value encoding is a way to encode data in a binary format with the first byte\n   * being the length of the data and the following bytes being the data itself\n   * @param value: Uint8Array - The value to add to the data\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  encodeInLVFromBuffer = (value: Uint8Array): ByteArrayBuilder => {\n    if (!this.hasEnoughLengthRemaining(value, true)) {\n      this.errors.push(new DataOverflowError(value.toString()));\n      return this;\n    }\n\n    this.add8BitUIntToData(value.length);\n    this.addBufferToData(value);\n    return this;\n  };\n\n  /**\n   * Add a Length-Value encoded ascii string to the data field if it has enough remaining space\n   * Length-Value encoding is a way to encode data in a binary format with the first byte\n   * being the length of the data and the following bytes being the data itself\n   * @param value: string - The value to add to the data\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  encodeInLVFromAscii = (value: string): ByteArrayBuilder => {\n    if (!this.hasEnoughLengthRemaining(value, true)) {\n      this.errors.push(new DataOverflowError(value));\n      return this;\n    }\n\n    this.add8BitUIntToData(value.length);\n    this.addAsciiStringToData(value);\n    return this;\n  };\n\n  /**\n   * Returns the remaining payload length\n   * @returns {number}\n   */\n  getAvailablePayloadLength = (): number => {\n    return this.maxPayloadSize - this.data.length;\n  };\n\n  /**\n   * Returns the current errors\n   * @returns {AppBuilderError[]} - Returns an array of errors\n   */\n  getErrors = (): AppBuilderError[] => this.errors;\n\n  /**\n   * Verifies if the builder contains errors\n   * @returns {boolean} - Returns wether the builder contains errors or not\n   */\n  hasErrors = (): boolean => this.errors.length !== 0;\n\n  // ===========\n  // Private API\n  // ===========\n\n  /**\n   * Check if there is enough space to add a value to the data field\n   * @param value {string | Uint8Array | number[]} - Value to add to the data\n   * @param hasLv {boolean} - Length-Value encoding flag\n   * @returns {boolean} - Returns true if there is enough space to add the value\n   */\n  private hasEnoughLengthRemaining = (\n    value: string | Uint8Array | number[],\n    hasLv: boolean = false,\n  ): boolean => {\n    return (\n      this.data.length + value.length + (hasLv ? 1 : 0) <= this.maxPayloadSize\n    );\n  };\n\n  /**\n   * Add a number to the payload\n   * @param value: number | bigint - The value to add to the data\n   * @param sizeInBits: bigint - The number size in bits, for example 16 for a uint16\n   * @param signed: boolean - Whether the value is signed or unsigned.\n   * @param bigEndian: boolean - True to encode in big endian, false for little endian\n   * @returns {ByteArrayBuilder} - Returns the current instance of ByteArrayBuilder\n   */\n  private addNumberToData(\n    value: number | bigint,\n    sizeInBits: bigint,\n    signed: boolean,\n    bigEndian: boolean,\n  ): ByteArrayBuilder {\n    // Convert the number to two's complement and check its bounds\n    let converted = this.checkBoundsAndConvert(value, sizeInBits, signed);\n    if (converted === undefined) {\n      return this;\n    }\n\n    // Compute the buffer\n    const sizeInBytes = Number(sizeInBits) / 8;\n    const buffer = new Uint8Array(sizeInBytes);\n    if (bigEndian) {\n      for (let i = sizeInBytes - 1; i >= 0; i--) {\n        buffer[i] = Number(converted & 0xffn);\n        converted >>= 8n;\n      }\n    } else {\n      for (let i = 0; i < sizeInBytes; i++) {\n        buffer[i] = Number(converted & 0xffn);\n        converted >>= 8n;\n      }\n    }\n    return this.addBufferToData(buffer);\n  }\n\n  /**\n   * Checks the bounds of a signed or unsigned integer value and converts it to two's complement if it is signed and negative.\n   * @param value The value to check and convert.\n   * @param sizeInBits The size of the value in bits.\n   * @param signed Whether the value is signed or unsigned.\n   * @returns The converted value, or null if the value is out of bounds.\n   */\n  private checkBoundsAndConvert(\n    value: number | bigint,\n    sizeInBits: bigint,\n    signed: boolean,\n  ): bigint | undefined {\n    // Normalize the value to a bigint\n    if (typeof value === \"number\") {\n      if (!Number.isInteger(value) || value > Number.MAX_SAFE_INTEGER) {\n        this.errors.push(new ValueOverflowError(value.toString()));\n        return;\n      }\n      value = BigInt(value);\n    }\n\n    if (!signed) {\n      // Check if the value is within the bounds of an unsigned integer\n      const limit = 1n << sizeInBits;\n      if (value < 0 || value >= limit) {\n        this.errors.push(new ValueOverflowError(value.toString(), limit - 1n));\n        return;\n      }\n    } else {\n      // Check if the value is within the bounds of a signed integer\n      const limit = 1n << (sizeInBits - 1n);\n      if (value >= limit || value < -limit) {\n        this.errors.push(new ValueOverflowError(value.toString(), limit - 1n));\n        return;\n      }\n\n      // Convert the value to two's complement if it is negative\n      // https://en.wikipedia.org/wiki/Two%27s_complement\n      if (value < 0n) {\n        const mask = (1n << sizeInBits) - 1n;\n        value = -value;\n        value = (~value & mask) + 1n;\n      }\n    }\n    return value;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["hexaStringToBuffer", "DataOverflowError", "HexaStringEncodeError", "ValueOverflowError", "MAX_32_BIT_UINT", "ByteArrayBuilder", "maxPayloadSize", "value", "bigEndian", "result", "bytes", "hasLv", "sizeInBits", "signed", "converted", "sizeInBytes", "buffer", "limit", "mask"]
+}

package/lib/esm/src/api/apdu/utils/ByteArrayBuilder.test.js

@@ -0,0 +1,2 @@
+import{hexaStringToBuffer as s}from"../../utils/HexaString";import{APDU_MAX_PAYLOAD as r}from"./ApduBuilder";import{DataOverflowError as f,HexaStringEncodeError as x}from"./AppBuilderError";import{ByteArrayBuilder as l}from"./ByteArrayBuilder";const u=new Uint8Array([]),y=new Uint8Array([1]),A=new Uint8Array([128,129,130,131,132]),p=new Uint8Array([133,134,135,136]),E=new Uint8Array([3,161,162,163]),w=new Uint8Array([5,109,97,109,97,110]),b=new Uint8Array([2,240,241]),h=new Uint8Array([1,51,2,1,35,69,103,128,129,130,131,132,133,134,135,136,3,161,162,163,5,109,97,109,97,110,2,240,241]),i=new Uint8Array([...Array(255).fill(170)]),g=new Uint8Array([...Array(254).fill(170)]);let e;describe("ByteArrayBuilder",()=>{const d=(t,a,o,n)=>{if(n)switch(o){case 2:e.add16BitIntToData(t,a);break;case 4:e.add32BitIntToData(t,a);break;case 8:e.add64BitIntToData(t,a);break}else switch(o){case 2:e.add16BitUIntToData(t,a);break;case 4:e.add32BitUIntToData(t,a);break;case 8:e.add64BitUIntToData(t,a);break}};describe("clean",()=>{beforeEach(()=>{e=new l(r)}),it("should create an instance",()=>{expect(e).toBeDefined(),expect(e).toBeInstanceOf(l)})}),describe("simple",()=>{beforeEach(()=>{e=new l(r)}),it("should serialize with an empty body",()=>{expect(e.build()).toEqual(u)}),it("should serialize with an single byte body",()=>{e=new l(1),e.add8BitUIntToData(1),expect(e.build()).toEqual(y),expect(e.getErrors()).toEqual([])}),it.each([[2,!1,!0,13058,"3302"],[2,!1,!1,0x3302n,"0233"],[2,!0,!0,4200n,"1068"],[2,!0,!0,-4200n,"ef98"],[2,!0,!1,4200,"6810"],[2,!0,!1,-4200,"98ef"],[4,!1,!0,0x01234567n,"01234567"],[4,!1,!1,0x01234567n,"67452301"],[4,!0,!0,123456789,"075bcd15"],[4,!0,!0,-123456789,"f8a432eb"],[4,!0,!1,123456789,"15cd5b07"],[4,!0,!1,-123456789,"eb32a4f8"],[8,!1,!0,14147778004927559n,"0032435442584447"],[8,!1,!1,14147778004927559n,"4744584254433200"],[8,!0,!0,14147778004927559n,"0032435442584447"],[8,!0,!0,-14147778004927559n,"ffcdbcabbda7bbb9"],[8,!0,!1,14147778004927559n,"4744584254433200"],[8,!0,!1,-14147778004927559n,"b9bba7bdabbccdff"]])("serialize the following number: size %i, signed %s, bigEndian %s, value %i, expected %s",(t,a,o,n,c)=>{e=new l(t),d(n,o,t,a),expect(e.build()).toEqual(s(c)),expect(e.getErrors()).toEqual([]),e=new l(t-1),d(n,o,t,a),expect(e.getErrors().length).toEqual(1),expect(e.build()).toEqual(Uint8Array.from([]))}),it.each([[2,!1,!0,0xffffn,"ffff"],[2,!0,!0,0x7fffn,"7fff"],[2,!0,!0,-0x8000n,"8000"],[4,!1,!0,0xffffffffn,"ffffffff"],[4,!0,!0,0x7fffffffn,"7fffffff"],[4,!0,!0,-0x80000000n,"80000000"],[8,!1,!0,0xffffffffffffffffn,"ffffffffffffffff"],[8,!0,!0,0x7fffffffffffffffn,"7fffffffffffffff"],[8,!0,!0,-0x8000000000000000n,"8000000000000000"]])("serialize the number to the limit: size %i, signed %s, bigEndian %s, value %i, expected %s",(t,a,o,n,c)=>{e=new l(t),d(n,o,t,a),expect(e.build()).toEqual(s(c)),expect(e.getErrors()).toEqual([])}),it("Serialize from float to bigint",()=>{e=new l(4),e.add32BitIntToData(1234567893e-1,!1),expect(e.getErrors().length).toEqual(1),expect(e.build()).toEqual(Uint8Array.from([]))}),it("should serialize with an 5 byte body from an hexastring",()=>{e.addHexaStringToData("0x8081828384"),expect(e.build()).toEqual(A),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body from an hexastring without '0x'",()=>{e.addHexaStringToData("85868788"),expect(e.build()).toEqual(p),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from an hexastring",()=>{e.encodeInLVFromHexa("0xA1A2A3"),expect(e.build()).toEqual(E),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from an ascci string",()=>{e.encodeInLVFromAscii("maman"),expect(e.build()).toEqual(w),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from a buffer",()=>{const t=new Uint8Array([240,241]);e.encodeInLVFromBuffer(t),expect(e.build()).toEqual(b),expect(e.getErrors()).toEqual([])}),it("should serialize with an 4 byte body LV encoded from a buffer",()=>{const t=new Uint8Array([240,241]);e.encodeInLVFromBuffer(t),expect(e.build()).toEqual(b),expect(e.getErrors()).toEqual([])}),it("should serialize with an complete body of 0xAA",()=>{const t=new Uint8Array(255).fill(170,0,255);e.addBufferToData(t),expect(e.build()).toEqual(i),expect(e.getErrors()).toEqual([])})}),describe("mixed",()=>{beforeEach(()=>{e=new l(r)}),it("should serialize with all previous field",()=>{let t=r;e.add8BitUIntToData(1),t--,expect(e.getAvailablePayloadLength()).toBe(t),e.add16BitUIntToData(13058),t-=2,expect(e.getAvailablePayloadLength()).toBe(t),e.add32BitUIntToData(19088743),t-=4,expect(e.getAvailablePayloadLength()).toBe(t),e.addHexaStringToData("0x8081828384"),t-=5,expect(e.getAvailablePayloadLength()).toBe(t),e.addHexaStringToData("85868788"),t-=4,expect(e.getAvailablePayloadLength()).toBe(t),e.encodeInLVFromHexa("0xA1A2A3"),t-=4,expect(e.getAvailablePayloadLength()).toBe(t),e.encodeInLVFromAscii("maman"),t-=6,expect(e.getAvailablePayloadLength()).toBe(t);const a=new Uint8Array([240,241]);e.encodeInLVFromBuffer(a),t-=3,expect(e.getAvailablePayloadLength()).toBe(t),expect(e.build()).toEqual(h)})}),describe("error",()=>{beforeEach(()=>{e=new l(r)}),it.each([[2,!1,!0,0x10000n],[2,!0,!0,0x8000n],[2,!0,!0,-0x8001n],[4,!1,!0,0x100000000n],[4,!0,!0,0x80000000n],[4,!0,!0,-0x80000001n],[8,!1,!0,0x10000000000000000n],[8,!0,!0,0x8000000000000000n],[8,!0,!0,-0x8000000000000001n]])("serialize the number overflowed: size %i, signed %s, bigEndian %s, value %i",(t,a,o,n)=>{e=new l(t),d(n,o,t,a),expect(e.getErrors().length).toEqual(1),expect(e.build()).toEqual(Uint8Array.from([]))}),it("error due to a string not well coded",()=>{e.addHexaStringToData(":08081828384").addHexaStringToData("80818n8384").addHexaStringToData("808182838z"),expect(e.build()).toEqual(u),expect(e.getAvailablePayloadLength()).toBe(r),expect(e.getErrors()).toEqual([new x(":08081828384"),new x("80818n8384"),new x("808182838z")])}),it("error due direct overflow",()=>{const t=new Uint8Array(256).fill(170,0,256);e.addBufferToData(t),expect(e.build()).toEqual(u),expect(e.getAvailablePayloadLength()).toBe(r),expect(e.getErrors()).toEqual([new f(t.toString())])}),it("error due to subsequent overflow with 1-byte array",()=>{const t=new Uint8Array(r).fill(170,0,r);e.addBufferToData(t),expect(e.build()).toEqual(i),expect(e.getAvailablePayloadLength()).toBe(0);const a=new Uint8Array(1);a.set([255],0),e.addBufferToData(a),expect(e.build()).toEqual(i),expect(e.getAvailablePayloadLength()).toBe(0),expect(e.getErrors()).toEqual([new f(a.toString())])}),it("error due to subsequent overflow with 1-char ascii",()=>{const t=new Uint8Array(r).fill(170,0,r);e.addBufferToData(t),expect(e.build()).toEqual(i),expect(e.getAvailablePayloadLength()).toBe(0);const a="a";e.addAsciiStringToData(a),expect(e.build()).toEqual(i),expect(e.getAvailablePayloadLength()).toBe(0),expect(e.getErrors()).toEqual([new f(new TextEncoder().encode(a).toString())])}),it("error due to subsequent overflow with 1-char hexastring",()=>{const t=new Uint8Array(r).fill(170,0,r);e.addBufferToData(t),expect(e.build()).toEqual(i),expect(e.getAvailablePayloadLength()).toBe(0),e.addHexaStringToData("0xB4").addHexaStringToData("e1"),expect(e.build()).toEqual(i),expect(e.getAvailablePayloadLength()).toBe(0),expect(e.getErrors()).toEqual([new f("180"),new f("225")])}),it("error due to empty values",()=>{const t="";e.addHexaStringToData(t).encodeInLVFromHexa(t),expect(e.build()).toEqual(u),expect(e.getAvailablePayloadLength()).toBe(r),expect(e.getErrors()).toEqual([new x(t),new x(t)])}),it("error due to subsequent overflow with 1-char LV",()=>{const t=new Uint8Array(r-1).fill(170,0,r-1);e.addBufferToData(t),expect(e.build()).toEqual(g),expect(e.getAvailablePayloadLength()).toBe(1);const a="n",o="e1",n=new Uint8Array(1);n.set([255],0),e.encodeInLVFromAscii(a).encodeInLVFromHexa(o).encodeInLVFromBuffer(n),expect(e.build()).toEqual(g),expect(e.getAvailablePayloadLength()).toBe(1),expect(e.getErrors()).toEqual([new f(a),new f(o),new f(n.toString())])})})});
+//# sourceMappingURL=ByteArrayBuilder.test.js.map

package/lib/esm/src/api/apdu/utils/ByteArrayBuilder.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/ByteArrayBuilder.test.ts"],
+  "sourcesContent": ["import { hexaStringToBuffer } from \"@api/utils/HexaString\";\n\nimport { APDU_MAX_PAYLOAD } from \"./ApduBuilder\";\nimport { DataOverflowError, HexaStringEncodeError } from \"./AppBuilderError\";\nimport { ByteArrayBuilder } from \"./ByteArrayBuilder\";\n\nconst COMMAND_NO_BODY = new Uint8Array([]);\n\nconst COMMAND_BODY_SINGLE = new Uint8Array([0x01]);\n\nconst COMMAND_BODY_HEXA1 = new Uint8Array([0x80, 0x81, 0x82, 0x83, 0x84]);\n\nconst COMMAND_BODY_HEXA2 = new Uint8Array([0x85, 0x86, 0x87, 0x88]);\n\nconst COMMAND_BODY_LV_HEXA = new Uint8Array([0x03, 0xa1, 0xa2, 0xa3]);\n\nconst COMMAND_BODY_LV_ASCII = new Uint8Array([\n  0x05, 0x6d, 0x61, 0x6d, 0x61, 0x6e,\n]);\n\nconst COMMAND_BODY_LV_ARRAY = new Uint8Array([0x02, 0xf0, 0xf1]);\n\nconst COMMAND_BODY_COMBINED = new Uint8Array([\n  0x01, 0x33, 0x02, 0x01, 0x23, 0x45, 0x67, 0x80, 0x81, 0x82, 0x83, 0x84, 0x85,\n  0x86, 0x87, 0x88, 0x03, 0xa1, 0xa2, 0xa3, 0x05, 0x6d, 0x61, 0x6d, 0x61, 0x6e,\n  0x02, 0xf0, 0xf1,\n]);\n\nconst COMMAND_BODY_MAX = new Uint8Array([...Array<number>(255).fill(0xaa)]);\n\nconst COMMAND_BODY_NEARLY = new Uint8Array([...Array<number>(254).fill(0xaa)]);\n\nlet builder: ByteArrayBuilder;\n\ndescribe(\"ByteArrayBuilder\", () => {\n  const builderAddNumber = (\n    num: number | bigint,\n    bigEndian: boolean,\n    sizeInBits: number,\n    signed: boolean,\n  ) => {\n    if (signed) {\n      switch (sizeInBits) {\n        case 2:\n          builder.add16BitIntToData(num, bigEndian);\n          break;\n        case 4:\n          builder.add32BitIntToData(num, bigEndian);\n          break;\n        case 8:\n          builder.add64BitIntToData(num, bigEndian);\n          break;\n      }\n    } else {\n      switch (sizeInBits) {\n        case 2:\n          builder.add16BitUIntToData(num, bigEndian);\n          break;\n        case 4:\n          builder.add32BitUIntToData(num, bigEndian);\n          break;\n        case 8:\n          builder.add64BitUIntToData(num, bigEndian);\n          break;\n      }\n    }\n  };\n\n  describe(\"clean\", () => {\n    beforeEach(() => {\n      builder = new ByteArrayBuilder(APDU_MAX_PAYLOAD);\n    });\n\n    it(\"should create an instance\", () => {\n      expect(builder).toBeDefined();\n      expect(builder).toBeInstanceOf(ByteArrayBuilder);\n    });\n  });\n\n  describe(\"simple\", () => {\n    beforeEach(() => {\n      builder = new ByteArrayBuilder(APDU_MAX_PAYLOAD);\n    });\n\n    it(\"should serialize with an empty body\", () => {\n      expect(builder.build()).toEqual(COMMAND_NO_BODY);\n    });\n\n    it(\"should serialize with an single byte body\", () => {\n      builder = new ByteArrayBuilder(1);\n      builder.add8BitUIntToData(0x01);\n      expect(builder.build()).toEqual(COMMAND_BODY_SINGLE);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it.each([\n      [2, false, true, 0x3302, \"3302\"],\n      [2, false, false, 0x3302n, \"0233\"],\n      [2, true, true, 4200n, \"1068\"],\n      [2, true, true, -4200n, \"ef98\"],\n      [2, true, false, 4200, \"6810\"],\n      [2, true, false, -4200, \"98ef\"],\n      [4, false, true, 0x01234567n, \"01234567\"],\n      [4, false, false, 0x01234567n, \"67452301\"],\n      [4, true, true, 123456789, \"075bcd15\"],\n      [4, true, true, -123456789, \"f8a432eb\"],\n      [4, true, false, 123456789, \"15cd5b07\"],\n      [4, true, false, -123456789, \"eb32a4f8\"],\n      [8, false, true, 14147778004927559n, \"0032435442584447\"],\n      [8, false, false, 14147778004927559n, \"4744584254433200\"],\n      [8, true, true, 14147778004927559n, \"0032435442584447\"],\n      [8, true, true, -14147778004927559n, \"ffcdbcabbda7bbb9\"],\n      [8, true, false, 14147778004927559n, \"4744584254433200\"],\n      [8, true, false, -14147778004927559n, \"b9bba7bdabbccdff\"],\n    ])(\n      \"serialize the following number: size %i, signed %s, bigEndian %s, value %i, expected %s\",\n      (sizeInBits, signed, bigEndian, input, output) => {\n        builder = new ByteArrayBuilder(sizeInBits);\n        builderAddNumber(input, bigEndian, sizeInBits, signed);\n        expect(builder.build()).toEqual(hexaStringToBuffer(output));\n        expect(builder.getErrors()).toEqual([]);\n\n        // Retry with a buffer too small\n        builder = new ByteArrayBuilder(sizeInBits - 1);\n        builderAddNumber(input, bigEndian, sizeInBits, signed);\n        expect(builder.getErrors().length).toEqual(1);\n        expect(builder.build()).toEqual(Uint8Array.from([]));\n      },\n    );\n\n    it.each([\n      [2, false, true, 0xffffn, \"ffff\"],\n      [2, true, true, 0x7fffn, \"7fff\"],\n      [2, true, true, -0x8000n, \"8000\"],\n      [4, false, true, 0xffffffffn, \"ffffffff\"],\n      [4, true, true, 0x7fffffffn, \"7fffffff\"],\n      [4, true, true, -0x80000000n, \"80000000\"],\n      [8, false, true, 0xffffffffffffffffn, \"ffffffffffffffff\"],\n      [8, true, true, 0x7fffffffffffffffn, \"7fffffffffffffff\"],\n      [8, true, true, -0x8000000000000000n, \"8000000000000000\"],\n    ])(\n      \"serialize the number to the limit: size %i, signed %s, bigEndian %s, value %i, expected %s\",\n      (sizeInBits, signed, bigEndian, input, output) => {\n        builder = new ByteArrayBuilder(sizeInBits);\n        builderAddNumber(input, bigEndian, sizeInBits, signed);\n        expect(builder.build()).toEqual(hexaStringToBuffer(output));\n        expect(builder.getErrors()).toEqual([]);\n      },\n    );\n\n    it(\"Serialize from float to bigint\", () => {\n      builder = new ByteArrayBuilder(4);\n      builder.add32BitIntToData(123456789.3, false);\n      expect(builder.getErrors().length).toEqual(1);\n      expect(builder.build()).toEqual(Uint8Array.from([]));\n    });\n\n    it(\"should serialize with an 5 byte body from an hexastring\", () => {\n      builder.addHexaStringToData(\"0x8081828384\");\n      expect(builder.build()).toEqual(COMMAND_BODY_HEXA1);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body from an hexastring without '0x'\", () => {\n      builder.addHexaStringToData(\"85868788\");\n      expect(builder.build()).toEqual(COMMAND_BODY_HEXA2);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from an hexastring\", () => {\n      builder.encodeInLVFromHexa(\"0xA1A2A3\");\n      expect(builder.build()).toEqual(COMMAND_BODY_LV_HEXA);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from an ascci string\", () => {\n      builder.encodeInLVFromAscii(\"maman\");\n      expect(builder.build()).toEqual(COMMAND_BODY_LV_ASCII);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from a buffer\", () => {\n      const myarray = new Uint8Array([0xf0, 0xf1]);\n      builder.encodeInLVFromBuffer(myarray);\n      expect(builder.build()).toEqual(COMMAND_BODY_LV_ARRAY);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an 4 byte body LV encoded from a buffer\", () => {\n      const myarray = new Uint8Array([0xf0, 0xf1]);\n      builder.encodeInLVFromBuffer(myarray);\n      expect(builder.build()).toEqual(COMMAND_BODY_LV_ARRAY);\n      expect(builder.getErrors()).toEqual([]);\n    });\n\n    it(\"should serialize with an complete body of 0xAA\", () => {\n      const myarray = new Uint8Array(255).fill(0xaa, 0, 255);\n      builder.addBufferToData(myarray);\n      expect(builder.build()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getErrors()).toEqual([]);\n    });\n  });\n\n  describe(\"mixed\", () => {\n    beforeEach(() => {\n      builder = new ByteArrayBuilder(APDU_MAX_PAYLOAD);\n    });\n\n    it(\"should serialize with all previous field\", () => {\n      let available = APDU_MAX_PAYLOAD;\n      builder.add8BitUIntToData(0x01);\n      available--;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      builder.add16BitUIntToData(0x3302);\n      available -= 2;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      builder.add32BitUIntToData(0x01234567);\n      available -= 4;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      builder.addHexaStringToData(\"0x8081828384\");\n      available -= 5;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      builder.addHexaStringToData(\"85868788\");\n      available -= 4;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      builder.encodeInLVFromHexa(\"0xA1A2A3\");\n      available -= 4;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      builder.encodeInLVFromAscii(\"maman\");\n      available -= 6;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      const myarray = new Uint8Array([0xf0, 0xf1]);\n      builder.encodeInLVFromBuffer(myarray);\n      available -= 3;\n      expect(builder.getAvailablePayloadLength()).toBe(available);\n\n      expect(builder.build()).toEqual(COMMAND_BODY_COMBINED);\n    });\n  });\n\n  describe(\"error\", () => {\n    beforeEach(() => {\n      builder = new ByteArrayBuilder(APDU_MAX_PAYLOAD);\n    });\n\n    it.each([\n      [2, false, true, 0x10000n],\n      [2, true, true, 0x8000n],\n      [2, true, true, -0x8001n],\n      [4, false, true, 0x100000000n],\n      [4, true, true, 0x80000000n],\n      [4, true, true, -0x80000001n],\n      [8, false, true, 0x10000000000000000n],\n      [8, true, true, 0x8000000000000000n],\n      [8, true, true, -0x8000000000000001n],\n    ])(\n      \"serialize the number overflowed: size %i, signed %s, bigEndian %s, value %i\",\n      (sizeInBits, signed, bigEndian, input) => {\n        builder = new ByteArrayBuilder(sizeInBits);\n        builderAddNumber(input, bigEndian, sizeInBits, signed);\n        expect(builder.getErrors().length).toEqual(1);\n        expect(builder.build()).toEqual(Uint8Array.from([]));\n      },\n    );\n\n    it(\"error due to a string not well coded\", () => {\n      builder\n        .addHexaStringToData(\":08081828384\")\n        .addHexaStringToData(\"80818n8384\")\n        .addHexaStringToData(\"808182838z\");\n\n      expect(builder.build()).toEqual(COMMAND_NO_BODY);\n      expect(builder.getAvailablePayloadLength()).toBe(APDU_MAX_PAYLOAD);\n      expect(builder.getErrors()).toEqual([\n        new HexaStringEncodeError(\":08081828384\"),\n        new HexaStringEncodeError(\"80818n8384\"),\n        new HexaStringEncodeError(\"808182838z\"),\n      ]);\n    });\n\n    it(\"error due direct overflow\", () => {\n      const myarray = new Uint8Array(256).fill(0xaa, 0, 256);\n      builder.addBufferToData(myarray);\n      expect(builder.build()).toEqual(COMMAND_NO_BODY);\n      expect(builder.getAvailablePayloadLength()).toBe(APDU_MAX_PAYLOAD);\n      expect(builder.getErrors()).toEqual([\n        new DataOverflowError(myarray.toString()),\n      ]);\n    });\n\n    it(\"error due to subsequent overflow with 1-byte array\", () => {\n      const myarray = new Uint8Array(APDU_MAX_PAYLOAD).fill(\n        0xaa,\n        0,\n        APDU_MAX_PAYLOAD,\n      );\n      builder.addBufferToData(myarray);\n      expect(builder.build()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getAvailablePayloadLength()).toBe(0);\n\n      const mybuffer = new Uint8Array(1);\n      mybuffer.set([0xff], 0);\n\n      builder.addBufferToData(mybuffer);\n      expect(builder.build()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getAvailablePayloadLength()).toBe(0);\n      expect(builder.getErrors()).toEqual([\n        new DataOverflowError(mybuffer.toString()),\n      ]);\n    });\n\n    it(\"error due to subsequent overflow with 1-char ascii\", () => {\n      const myarray = new Uint8Array(APDU_MAX_PAYLOAD).fill(\n        0xaa,\n        0,\n        APDU_MAX_PAYLOAD,\n      );\n      builder.addBufferToData(myarray);\n      expect(builder.build()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getAvailablePayloadLength()).toBe(0);\n\n      const mystring = \"a\";\n\n      builder.addAsciiStringToData(mystring);\n      expect(builder.build()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getAvailablePayloadLength()).toBe(0);\n      expect(builder.getErrors()).toEqual([\n        new DataOverflowError(new TextEncoder().encode(mystring).toString()),\n      ]);\n    });\n\n    it(\"error due to subsequent overflow with 1-char hexastring\", () => {\n      const myarray = new Uint8Array(APDU_MAX_PAYLOAD).fill(\n        0xaa,\n        0,\n        APDU_MAX_PAYLOAD,\n      );\n      builder.addBufferToData(myarray);\n      expect(builder.build()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getAvailablePayloadLength()).toBe(0);\n\n      const firstString = \"0xB4\";\n      const secondString = \"e1\";\n\n      builder\n        .addHexaStringToData(firstString)\n        .addHexaStringToData(secondString);\n\n      expect(builder.build()).toEqual(COMMAND_BODY_MAX);\n      expect(builder.getAvailablePayloadLength()).toBe(0);\n      expect(builder.getErrors()).toEqual([\n        new DataOverflowError((0xb4).toString()),\n        new DataOverflowError((0xe1).toString()),\n      ]);\n    });\n\n    it(\"error due to empty values\", () => {\n      const mystring = \"\";\n\n      builder.addHexaStringToData(mystring).encodeInLVFromHexa(mystring);\n\n      expect(builder.build()).toEqual(COMMAND_NO_BODY);\n      expect(builder.getAvailablePayloadLength()).toBe(APDU_MAX_PAYLOAD);\n      expect(builder.getErrors()).toEqual([\n        new HexaStringEncodeError(mystring),\n        new HexaStringEncodeError(mystring),\n      ]);\n    });\n\n    it(\"error due to subsequent overflow with 1-char LV\", () => {\n      const myarray = new Uint8Array(APDU_MAX_PAYLOAD - 1).fill(\n        0xaa,\n        0,\n        APDU_MAX_PAYLOAD - 1,\n      );\n      builder.addBufferToData(myarray);\n      expect(builder.build()).toEqual(COMMAND_BODY_NEARLY);\n      expect(builder.getAvailablePayloadLength()).toBe(1);\n\n      const firstString = \"n\";\n      const secondString = \"e1\";\n      const mybuffer = new Uint8Array(1);\n      mybuffer.set([0xff], 0);\n\n      builder\n        .encodeInLVFromAscii(firstString)\n        .encodeInLVFromHexa(secondString)\n        .encodeInLVFromBuffer(mybuffer);\n\n      expect(builder.build()).toEqual(COMMAND_BODY_NEARLY);\n      expect(builder.getAvailablePayloadLength()).toBe(1);\n      expect(builder.getErrors()).toEqual([\n        new DataOverflowError(firstString),\n        new DataOverflowError(secondString),\n        new DataOverflowError(mybuffer.toString()),\n      ]);\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": ["hexaStringToBuffer", "APDU_MAX_PAYLOAD", "DataOverflowError", "HexaStringEncodeError", "ByteArrayBuilder", "COMMAND_NO_BODY", "COMMAND_BODY_SINGLE", "COMMAND_BODY_HEXA1", "COMMAND_BODY_HEXA2", "COMMAND_BODY_LV_HEXA", "COMMAND_BODY_LV_ASCII", "COMMAND_BODY_LV_ARRAY", "COMMAND_BODY_COMBINED", "COMMAND_BODY_MAX", "COMMAND_BODY_NEARLY", "builder", "builderAddNumber", "num", "bigEndian", "sizeInBits", "signed", "input", "output", "myarray", "available", "mybuffer", "mystring", "firstString", "secondString"]
+}

package/lib/esm/src/api/apdu/utils/ByteArrayParser.js

@@ -0,0 +1,2 @@
+import{bufferToHexaString as d}from"../../utils/HexaString";class s{constructor(e){this.buffer=e}index=0;testMinimalLength(e){return e<=this.buffer.length-this.index}extract8BitUInt(){if(!this.outOfRange(1))return this.buffer[this.index++]}extract16BitUInt(e=!0){const t=this.extractNumber(16n,!1,e);return t===void 0?void 0:Number(t)}extract16BitInt(e=!0){const t=this.extractNumber(16n,!0,e);return t===void 0?void 0:Number(t)}extract32BitUInt(e=!0){const t=this.extractNumber(32n,!1,e);return t===void 0?void 0:Number(t)}extract32BitInt(e=!0){const t=this.extractNumber(32n,!0,e);return t===void 0?void 0:Number(t)}extract64BitUInt(e=!0){return this.extractNumber(64n,!1,e)}extract64BitInt(e=!0){return this.extractNumber(64n,!0,e)}extractFieldByLength(e){if(this.outOfRange(e))return;if(e===0)return new Uint8Array;const t=this.buffer.slice(this.index,this.index+e);return this.index+=e,t}extractFieldLVEncoded(){const e=this.extract8BitUInt();if(e===void 0)return;if(e===0)return new Uint8Array;const t=this.extractFieldByLength(e);return t===void 0&&this.index--,t}extractFieldTLVEncoded(){if(this.outOfRange(2))return;const e=this.extract8BitUInt(),t=this.extractFieldLVEncoded();if(e===void 0||t===void 0){this.index--;return}return{tag:e,value:t}}encodeToHexaString(e,t=!1){if(e===void 0||e.length===0)return"";const r=d(e);return t?r:r.slice(2)}encodeToString(e){let t="",r=0;if(!e)return t;for(;r<=e.length;){const i=e[r];i&&(t+=String.fromCharCode(i)),r++}return t}getCurrentIndex(){return this.index}resetIndex(){this.index=0}getUnparsedRemainingLength(){return this.buffer.length-this.index}outOfRange(e){return this.index+e>this.buffer.length}extractNumber(e,t,r){const i=Number(e)/8;if(this.outOfRange(i))return;let u=0n;if(r)for(let n=0;n<i;n++)u=u<<8n|BigInt(this.buffer[n+this.index]);else for(let n=i-1;n>=0;n--)u=u<<8n|BigInt(this.buffer[n+this.index]);if(t){const n=1n<<e-1n;u&n&&(u-=n<<1n)}return this.index+=i,u}}export{s as ByteArrayParser};
+//# sourceMappingURL=ByteArrayParser.js.map

package/lib/esm/src/api/apdu/utils/ByteArrayParser.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/api/apdu/utils/ByteArrayParser.ts"],
+  "sourcesContent": ["import { bufferToHexaString, type HexaString } from \"@api/utils/HexaString\";\n\nexport type TaggedField = {\n  readonly tag: number;\n  readonly value: Uint8Array;\n};\n\n/**\n * ByteArrayParser is a utility class to help parse a byte array.\n *\n * It provides methods to extract fields of different types from the buffer.\n *\n * @example\n * ```\n * const parser = new ByteArrayParser(buffer);\n * const targetId = parser.encodeToHexaString(parser.extractFieldByLength(4));\n * const seVersion = parser.encodeToString(parser.extractFieldLVEncoded());\n * ```\n */\nexport class ByteArrayParser {\n  private index: number = 0;\n\n  constructor(private readonly buffer: Uint8Array) {}\n\n  // ==========\n  // Public API\n  // ==========\n\n  /**\n   * Test if the length is greater than the response length\n   * @param length: number\n   * @returns {boolean} - Returns false if the length is greater than the response length\n   */\n  testMinimalLength(length: number): boolean {\n    return length <= this.buffer.length - this.index;\n  }\n\n  /**\n   * Extract a single byte from the response\n   * @returns {number | undefined} - Returns the byte extracted from the response\n   */\n  extract8BitUInt(): number | undefined {\n    if (this.outOfRange(1)) return;\n    return this.buffer[this.index++];\n  }\n\n  /**\n   * Extract a 16-bit unsigned integer from the response\n   * @param bigEndian: boolean - True to decode in big endian, false for little endian\n   * @returns {number | undefined} - Returns the 16-bit unsigned integer extracted from the response\n   */\n  extract16BitUInt(bigEndian: boolean = true): number | undefined {\n    const value = this.extractNumber(16n, false, bigEndian);\n    return value === undefined ? undefined : Number(value);\n  }\n\n  /**\n   * Extract a 16-bit signed integer from the response\n   * @param bigEndian: boolean - True to decode in big endian, false for little endian\n   * @returns {number | undefined} - Returns the 16-bit signed integer extracted from the response\n   */\n  extract16BitInt(bigEndian: boolean = true): number | undefined {\n    const value = this.extractNumber(16n, true, bigEndian);\n    return value === undefined ? undefined : Number(value);\n  }\n\n  /**\n   * Extract a 32-bit unsigned integer from the response\n   * @param bigEndian: boolean - True to decode in big endian, false for little endian\n   * @returns {number | undefined} - Returns the 32-bit unsigned integer extracted from the response\n   */\n  extract32BitUInt(bigEndian: boolean = true): number | undefined {\n    const value = this.extractNumber(32n, false, bigEndian);\n    return value === undefined ? undefined : Number(value);\n  }\n\n  /**\n   * Extract a 32-bit signed integer from the response\n   * @param bigEndian: boolean - True to decode in big endian, false for little endian\n   * @returns {number | undefined} - Returns the 32-bit signed integer extracted from the response\n   */\n  extract32BitInt(bigEndian: boolean = true): number | undefined {\n    const value = this.extractNumber(32n, true, bigEndian);\n    return value === undefined ? undefined : Number(value);\n  }\n\n  /**\n   * Extract a 64-bit unsigned integer from the response\n   * @param bigEndian: boolean - True to decode in big endian, false for little endian\n   * @returns {number | undefined} - Returns the 64-bit unsigned integer extracted from the response\n   */\n  extract64BitUInt(bigEndian: boolean = true): bigint | undefined {\n    return this.extractNumber(64n, false, bigEndian);\n  }\n\n  /**\n   * Extract a 64-bit signed integer from the response\n   * @param bigEndian: boolean - True to decode in big endian, false for little endian\n   * @returns {number | undefined} - Returns the 64-bit signed integer extracted from the response\n   */\n  extract64BitInt(bigEndian: boolean = true): bigint | undefined {\n    return this.extractNumber(64n, true, bigEndian);\n  }\n\n  /**\n   * Extract a field of a specified length from the response\n   * @param length: number - The length of the field to extract\n   * @returns {Uint8Array | undefined} - Returns the field extracted from the response\n   */\n  extractFieldByLength(length: number): Uint8Array | undefined {\n    if (this.outOfRange(length)) return;\n    if (length === 0) return new Uint8Array();\n    const field = this.buffer.slice(this.index, this.index + length);\n    this.index += length;\n    return field;\n  }\n\n  /**\n   * Extract a field from the response that is length-value encoded\n   * @returns {Uint8Array | undefined} - Returns the field extracted from the response\n   */\n  extractFieldLVEncoded(): Uint8Array | undefined {\n    // extract Length field\n    const length = this.extract8BitUInt();\n    if (length === undefined) return;\n    else if (length === 0) return new Uint8Array();\n    const field = this.extractFieldByLength(length);\n    // if the field is inconsistent then roll back to the initial point\n    if (field === undefined) this.index--;\n    return field;\n  }\n\n  /**\n   * Extract a field from the response that is tag-length-value encoded\n   * @returns {TaggedField | undefined} - Returns the field extracted from the response\n   */\n  extractFieldTLVEncoded(): TaggedField | undefined {\n    if (this.outOfRange(2)) return;\n\n    const tag = this.extract8BitUInt();\n    const value = this.extractFieldLVEncoded();\n\n    if (tag === undefined || value === undefined) {\n      this.index--;\n      return;\n    }\n    return { tag, value };\n  }\n\n  /**\n   * Encode a value to a hexadecimal string\n   * @param value {Uint8Array} - The value to encode\n   * @param prefix {boolean} - Whether to add a prefix to the encoded value\n   * @returns {string} - The encoded value as a hexadecimal string\n   */\n  encodeToHexaString(value?: Uint8Array, prefix?: false): string;\n  encodeToHexaString(value?: Uint8Array, prefix?: true): HexaString;\n  encodeToHexaString(\n    value?: Uint8Array,\n    prefix: boolean = false,\n  ): HexaString | string {\n    if (value === undefined || value.length === 0) return \"\";\n    const result = bufferToHexaString(value);\n    return prefix ? result : result.slice(2);\n  }\n\n  /**\n   * Encode a value to an ASCII string\n   * @param value {Uint8Array} - The value to encode\n   * @returns {string} - The encoded value as an ASCII string\n   */\n  encodeToString(value?: Uint8Array): string {\n    let result = \"\";\n    let index = 0;\n\n    if (!value) return result;\n\n    while (index <= value.length) {\n      const item = value[index];\n      if (item) result += String.fromCharCode(item);\n      index++;\n    }\n\n    return result;\n  }\n\n  /**\n   * Get the current index of the parser\n   * @returns {number} - The current index of the parser\n   */\n  getCurrentIndex(): number {\n    return this.index;\n  }\n\n  /**\n   * Reset the index of the parser to 0\n   */\n  resetIndex() {\n    this.index = 0;\n  }\n\n  /**\n   * Get the remaining length of the response\n   * @returns {number} - The remaining length of the response\n   */\n  getUnparsedRemainingLength(): number {\n    return this.buffer.length - this.index;\n  }\n\n  // ===========\n  // Private API\n  // ===========\n\n  /**\n   * Check whether the expected length is out of range\n   * @param length: number\n   * @returns {boolean} - Returns true if the expected length is out of range\n   */\n  private outOfRange(length: number): boolean {\n    return this.index + length > this.buffer.length;\n  }\n\n  /**\n   * Extract a number from the buffer\n   * @param sizeInBits: bigint - The number size in bits, for example 16 for a uint16\n   * @param signed: boolean - True is the number can be signed and converted to two's compliment\n   * @param bigEndian: boolean - True to decode in big endian, false for little endian\n   * @returns {bigint | undefined} - Returns the number extracted from the buffer\n   */\n  private extractNumber(\n    sizeInBits: bigint,\n    signed: boolean,\n    bigEndian: boolean,\n  ): bigint | undefined {\n    // Check the range\n    const sizeInBytes: number = Number(sizeInBits) / 8;\n    if (this.outOfRange(sizeInBytes)) return;\n\n    // Compute the number\n    let value: bigint = 0n;\n    if (bigEndian) {\n      for (let i = 0; i < sizeInBytes; i++) {\n        value = (value << 8n) | BigInt(this.buffer[i + this.index]!);\n      }\n    } else {\n      for (let i = sizeInBytes - 1; i >= 0; i--) {\n        value = (value << 8n) | BigInt(this.buffer[i + this.index]!);\n      }\n    }\n\n    // Convert the value to two's complement if it is negative\n    // https://en.wikipedia.org/wiki/Two%27s_complement\n    if (signed) {\n      const limit = 1n << (sizeInBits - 1n);\n      if (value & limit) {\n        value -= limit << 1n;\n      }\n    }\n\n    this.index += sizeInBytes;\n    return value;\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["bufferToHexaString", "ByteArrayParser", "buffer", "length", "bigEndian", "value", "field", "tag", "prefix", "result", "index", "item", "sizeInBits", "signed", "sizeInBytes", "i", "limit"]
+}