@ledgerhq/device-management-kit 0.0.0-develop-20240925001059

package/lib/esm/src/api/command/os/GetOsVersionCommand.d.ts

@@ -0,0 +1,59 @@
+import { Apdu } from "../../apdu/model/Apdu";
+import { Command } from "../../command/Command";
+import { CommandResult } from "../../command/model/CommandResult";
+import { DeviceModelId } from "../../device/DeviceModel";
+import { ApduResponse } from "../../device-session/ApduResponse";
+/**
+ * Response of the GetOsVersionCommand.
+ */
+export type GetOsVersionResponse = {
+    /**
+     * Target identifier.
+     */
+    readonly targetId: string;
+    /**
+     * Version of BOLOS on the secure element (SE).
+     * {@link https://developers.ledger.com/docs/device-app/architecture/bolos/hardware-architecture | Hardware Architecture}
+     */
+    readonly seVersion: string;
+    /**
+     * Secure element flags.
+     * Used to represent the current state of the secure element.
+     */
+    readonly seFlags: number;
+    /**
+     * Version of the microcontroller unit (MCU) SEPH, which is the SE-MCU link protocol.
+     * {@link https://developers.ledger.com/docs/device-app/architecture/bolos/hardware-architecture | Hardware Architecture}
+     */
+    readonly mcuSephVersion: string;
+    /**
+     * Version of the MCU bootloader.
+     */
+    readonly mcuBootloaderVersion: string;
+    /**
+     * Hardware revision version.
+     * Only available for Ledger Nano X in which case it's "00" or "01".
+     */
+    readonly hwVersion: string;
+    /**
+     * Identifier of the installed language pack.
+     * Can be one of:
+     * - "00": English
+     * - "01": French
+     * - "02": Spanish
+     */
+    readonly langId: string;
+    /**
+     * State for Ledger Recover. // [SHOULD] Add more information about this field
+     */
+    readonly recoverState: string;
+};
+/**
+ * Command to get information about the device firmware.
+ */
+export declare class GetOsVersionCommand implements Command<GetOsVersionResponse> {
+    readonly args: undefined;
+    getApdu(): Apdu;
+    parseResponse(apduResponse: ApduResponse, deviceModelId: DeviceModelId): CommandResult<GetOsVersionResponse>;
+}
+//# sourceMappingURL=GetOsVersionCommand.d.ts.map

package/lib/esm/src/api/command/os/GetOsVersionCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetOsVersionCommand.d.ts","sourceRoot":"","sources":["../../../../../../src/api/command/os/GetOsVersionCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,aAAa,EAEd,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,qBAAa,mBAAoB,YAAW,OAAO,CAAC,oBAAoB,CAAC;IACvE,QAAQ,CAAC,IAAI,YAAa;IAE1B,OAAO,IAAI,IAAI;IAUf,aAAa,CACX,YAAY,EAAE,YAAY,EAC1B,aAAa,EAAE,aAAa,GAC3B,aAAa,CAAC,oBAAoB,CAAC;CA4CvC"}

package/lib/esm/src/api/command/os/GetOsVersionCommand.js

@@ -0,0 +1,53 @@
+import { ApduBuilder } from "../../apdu/utils/ApduBuilder";
+import { ApduParser } from "../../apdu/utils/ApduParser";
+import { CommandResultFactory, } from "../../command/model/CommandResult";
+import { CommandUtils } from "../../command/utils/CommandUtils";
+import { GlobalCommandErrorHandler } from "../../command/utils/GlobalCommandError";
+import { DeviceModelId } from "../../device/DeviceModel";
+/**
+ * Command to get information about the device firmware.
+ */
+export class GetOsVersionCommand {
+    args = undefined;
+    getApdu() {
+        const getOsVersionApduArgs = {
+            cla: 0xe0,
+            ins: 0x01,
+            p1: 0x00,
+            p2: 0x00,
+        };
+        return new ApduBuilder(getOsVersionApduArgs).build();
+    }
+    parseResponse(apduResponse, deviceModelId) {
+        if (!CommandUtils.isSuccessResponse(apduResponse)) {
+            return CommandResultFactory({
+                error: GlobalCommandErrorHandler.handle(apduResponse),
+            });
+        }
+        const parser = new ApduParser(apduResponse);
+        const targetId = parser.encodeToHexaString(parser.extractFieldByLength(4));
+        const seVersion = parser.encodeToString(parser.extractFieldLVEncoded());
+        const seFlags = parseInt(parser.encodeToHexaString(parser.extractFieldLVEncoded()).toString(), 16);
+        const mcuSephVersion = parser.encodeToString(parser.extractFieldLVEncoded());
+        const mcuBootloaderVersion = parser.encodeToString(parser.extractFieldLVEncoded());
+        let hwVersion = "00";
+        if (deviceModelId === DeviceModelId.NANO_X) {
+            hwVersion = parser.encodeToHexaString(parser.extractFieldLVEncoded());
+        }
+        const langId = parser.encodeToHexaString(parser.extractFieldLVEncoded());
+        const recoverState = parser.encodeToHexaString(parser.extractFieldLVEncoded());
+        return CommandResultFactory({
+            data: {
+                targetId,
+                seVersion,
+                seFlags,
+                mcuSephVersion,
+                mcuBootloaderVersion,
+                hwVersion,
+                langId,
+                recoverState: recoverState ? recoverState : "0",
+            },
+        });
+    }
+}
+//# sourceMappingURL=GetOsVersionCommand.js.map

package/lib/esm/src/api/command/os/GetOsVersionCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetOsVersionCommand.js","sourceRoot":"","sources":["../../../../../../src/api/command/os/GetOsVersionCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAmB,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAEL,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAwDxD;;GAEG;AACH,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,SAAS,CAAC;IAE1B,OAAO;QACL,MAAM,oBAAoB,GAAoB;YAC5C,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,IAAI;YACT,EAAE,EAAE,IAAI;YACR,EAAE,EAAE,IAAI;SACT,CAAC;QACF,OAAO,IAAI,WAAW,CAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;IAED,aAAa,CACX,YAA0B,EAC1B,aAA4B;QAE5B,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;YAClD,OAAO,oBAAoB,CAAC;gBAC1B,KAAK,EAAE,yBAAyB,CAAC,MAAM,CAAC,YAAY,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,QAAQ,CACtB,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC,QAAQ,EAAE,EACpE,EAAE,CACH,CAAC;QACF,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAC1C,MAAM,CAAC,qBAAqB,EAAE,CAC/B,CAAC;QACF,MAAM,oBAAoB,GAAG,MAAM,CAAC,cAAc,CAChD,MAAM,CAAC,qBAAqB,EAAE,CAC/B,CAAC;QAEF,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,IAAI,aAAa,KAAK,aAAa,CAAC,MAAM,EAAE,CAAC;YAC3C,SAAS,GAAG,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,MAAM,CAAC,kBAAkB,CAC5C,MAAM,CAAC,qBAAqB,EAAE,CAC/B,CAAC;QAEF,OAAO,oBAAoB,CAAC;YAC1B,IAAI,EAAE;gBACJ,QAAQ;gBACR,SAAS;gBACT,OAAO;gBACP,cAAc;gBACd,oBAAoB;gBACpB,SAAS;gBACT,MAAM;gBACN,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG;aAChD;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/esm/src/api/command/os/ListAppsCommand.d.ts

@@ -0,0 +1,30 @@
+import { Apdu } from "../../apdu/model/Apdu";
+import { Command } from "../../command/Command";
+import { CommandResult } from "../../command/model/CommandResult";
+import { ApduResponse } from "../../device-session/ApduResponse";
+import { CommandErrorArgs, DeviceExchangeError } from "../../Error";
+export type AppResponse = {
+    readonly appEntryLength: number;
+    readonly appSizeInBlocks: number;
+    readonly appCodeHash: string;
+    readonly appFullHash: string;
+    readonly appName: string;
+};
+export type ListAppsResponse = AppResponse[];
+export type ListAppsArgs = {
+    readonly isContinue: boolean;
+};
+export type ListAppsErrorCodes = "6624";
+export type ListAppsCommandResult = CommandResult<ListAppsResponse, ListAppsErrorCodes>;
+export declare class ListAppsCommandError extends DeviceExchangeError<ListAppsErrorCodes> {
+    constructor({ message, errorCode }: CommandErrorArgs<ListAppsErrorCodes>);
+}
+export declare class ListAppsCommand implements Command<ListAppsResponse, ListAppsArgs, ListAppsErrorCodes> {
+    readonly args: ListAppsArgs;
+    constructor(args?: {
+        isContinue: boolean;
+    });
+    getApdu(): Apdu;
+    parseResponse(apduResponse: ApduResponse): ListAppsCommandResult;
+}
+//# sourceMappingURL=ListAppsCommand.d.ts.map

package/lib/esm/src/api/command/os/ListAppsCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListAppsCommand.d.ts","sourceRoot":"","sources":["../../../../../../src/api/command/os/ListAppsCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,aAAa,EAEd,MAAM,kCAAkC,CAAC;AAO1C,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,WAAW,EAAE,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAMxC,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAC/C,gBAAgB,EAChB,kBAAkB,CACnB,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,mBAAmB,CAAC,kBAAkB,CAAC;gBACnE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,gBAAgB,CAAC,kBAAkB,CAAC;CAGzE;AAED,qBAAa,eACX,YAAW,OAAO,CAAC,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,CAAC;IAEtE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;gBAEhB,IAAI;;KAAwB;IAIxC,OAAO,IAAI,IAAI;IAUf,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB;CAsDjE"}

package/lib/esm/src/api/command/os/ListAppsCommand.js

@@ -0,0 +1,74 @@
+import { ApduBuilder } from "../../apdu/utils/ApduBuilder";
+import { ApduParser } from "../../apdu/utils/ApduParser";
+import { CommandResultFactory, } from "../../command/model/CommandResult";
+import { isCommandErrorCode, } from "../../command/utils/CommandErrors";
+import { CommandUtils } from "../../command/utils/CommandUtils";
+import { GlobalCommandErrorHandler } from "../../command/utils/GlobalCommandError";
+import { DeviceExchangeError } from "../../Error";
+const LIST_APP_ERRORS = {
+    "6624": { message: "Invalid state (List applications command must be sent)" },
+};
+export class ListAppsCommandError extends DeviceExchangeError {
+    constructor({ message, errorCode }) {
+        super({ message, errorCode, tag: "ListAppsCommandError" });
+    }
+}
+export class ListAppsCommand {
+    args;
+    constructor(args = { isContinue: false }) {
+        this.args = args;
+    }
+    getApdu() {
+        const listAppApduArgs = {
+            cla: 0xe0,
+            ins: this.args.isContinue ? 0xdf : 0xde,
+            p1: 0x00,
+            p2: 0x00,
+        };
+        return new ApduBuilder(listAppApduArgs).build();
+    }
+    parseResponse(apduResponse) {
+        const res = [];
+        const parser = new ApduParser(apduResponse);
+        if (!CommandUtils.isSuccessResponse(apduResponse)) {
+            const errorCode = parser.encodeToHexaString(apduResponse.statusCode);
+            if (isCommandErrorCode(errorCode, LIST_APP_ERRORS)) {
+                return CommandResultFactory({
+                    error: new ListAppsCommandError({
+                        ...LIST_APP_ERRORS[errorCode],
+                        errorCode,
+                    }),
+                });
+            }
+            return CommandResultFactory({
+                error: GlobalCommandErrorHandler.handle(apduResponse),
+            });
+        }
+        if (apduResponse.data.length <= 0) {
+            return CommandResultFactory({
+                data: [],
+            });
+        }
+        // [NOTE] version of parsing, not used for now, skipping 1 byte
+        parser.extract8BitUInt();
+        while (parser.getUnparsedRemainingLength() > 0) {
+            const appEntryLength = parser.extract8BitUInt();
+            const appSizeInBlocks = parser.extract16BitUInt();
+            parser.extract16BitUInt(); // Skip 2 bytes (flags, missing in doc for now)
+            const appCodeHash = parser.encodeToHexaString(parser.extractFieldByLength(0x20));
+            const appFullHash = parser.encodeToHexaString(parser.extractFieldByLength(0x20));
+            const appName = parser.encodeToString(parser.extractFieldLVEncoded());
+            res.push({
+                appEntryLength,
+                appSizeInBlocks,
+                appCodeHash,
+                appFullHash,
+                appName,
+            });
+        }
+        return CommandResultFactory({
+            data: res,
+        });
+    }
+}
+//# sourceMappingURL=ListAppsCommand.js.map

package/lib/esm/src/api/command/os/ListAppsCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListAppsCommand.js","sourceRoot":"","sources":["../../../../../../src/api/command/os/ListAppsCommand.ts"],"names":[],"mappings":"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"}

package/lib/esm/src/api/command/os/OpenAppCommand.d.ts

@@ -0,0 +1,24 @@
+import { Apdu } from "../../apdu/model/Apdu";
+import { Command } from "../../command/Command";
+import { CommandResult } from "../../command/model/CommandResult";
+import { ApduResponse } from "../../device-session/ApduResponse";
+import { CommandErrorArgs, DeviceExchangeError } from "../../Error";
+export type OpenAppArgs = {
+    readonly appName: string;
+};
+export type OpenAppErrorCodes = "670a" | "6807";
+export declare class OpenAppCommandError extends DeviceExchangeError<OpenAppErrorCodes> {
+    constructor({ message, errorCode }: CommandErrorArgs<OpenAppErrorCodes>);
+}
+export type OpenAppCommandResult = CommandResult<void, OpenAppErrorCodes>;
+/**
+ * The command to open an application on the device.
+ */
+export declare class OpenAppCommand implements Command<void, OpenAppArgs, OpenAppErrorCodes> {
+    readonly args: OpenAppArgs;
+    readonly triggersDisconnection = true;
+    constructor(args: OpenAppArgs);
+    getApdu(): Apdu;
+    parseResponse(apduResponse: ApduResponse): CommandResult<void, OpenAppErrorCodes>;
+}
+//# sourceMappingURL=OpenAppCommand.d.ts.map

package/lib/esm/src/api/command/os/OpenAppCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAppCommand.d.ts","sourceRoot":"","sources":["../../../../../../src/api/command/os/OpenAppCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAG5C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,aAAa,EAEd,MAAM,kCAAkC,CAAC;AAO1C,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAOhD,qBAAa,mBAAoB,SAAQ,mBAAmB,CAAC,iBAAiB,CAAC;gBACjE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,gBAAgB,CAAC,iBAAiB,CAAC;CAGxE;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;AAE1E;;GAEG;AACH,qBAAa,cACX,YAAW,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,iBAAiB,CAAC;IAExD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,QAAQ,CAAC,qBAAqB,QAAQ;gBAE1B,IAAI,EAAE,WAAW;IAI7B,OAAO,IAAI,IAAI;IAYf,aAAa,CACX,YAAY,EAAE,YAAY,GACzB,aAAa,CAAC,IAAI,EAAE,iBAAiB,CAAC;CAoB1C"}

package/lib/esm/src/api/command/os/OpenAppCommand.js

@@ -0,0 +1,58 @@
+import { ApduBuilder } from "../../apdu/utils/ApduBuilder";
+import { ApduParser } from "../../apdu/utils/ApduParser";
+import { CommandResultFactory, } from "../../command/model/CommandResult";
+import { isCommandErrorCode, } from "../../command/utils/CommandErrors";
+import { CommandUtils } from "../../command/utils/CommandUtils";
+import { GlobalCommandErrorHandler } from "../../command/utils/GlobalCommandError";
+import { DeviceExchangeError } from "../../Error";
+const OPEN_APP_ERRORS = {
+    "670a": { message: "No app name provided" },
+    "6807": { message: "Unknown application name" },
+};
+export class OpenAppCommandError extends DeviceExchangeError {
+    constructor({ message, errorCode }) {
+        super({ tag: "OpenAppCommandError", message, errorCode });
+    }
+}
+/**
+ * The command to open an application on the device.
+ */
+export class OpenAppCommand {
+    args;
+    triggersDisconnection = true;
+    constructor(args) {
+        this.args = args;
+    }
+    getApdu() {
+        const openAppApduArgs = {
+            cla: 0xe0,
+            ins: 0xd8,
+            p1: 0x00,
+            p2: 0x00,
+        };
+        return new ApduBuilder(openAppApduArgs)
+            .addAsciiStringToData(this.args.appName)
+            .build();
+    }
+    parseResponse(apduResponse) {
+        if (CommandUtils.isSuccessResponse(apduResponse)) {
+            return CommandResultFactory({
+                data: undefined,
+            });
+        }
+        const parser = new ApduParser(apduResponse);
+        const errorCode = parser.encodeToHexaString(apduResponse.statusCode);
+        if (isCommandErrorCode(errorCode, OPEN_APP_ERRORS)) {
+            return CommandResultFactory({
+                error: new OpenAppCommandError({
+                    ...OPEN_APP_ERRORS[errorCode],
+                    errorCode,
+                }),
+            });
+        }
+        return CommandResultFactory({
+            error: GlobalCommandErrorHandler.handle(apduResponse),
+        });
+    }
+}
+//# sourceMappingURL=OpenAppCommand.js.map

package/lib/esm/src/api/command/os/OpenAppCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAppCommand.js","sourceRoot":"","sources":["../../../../../../src/api/command/os/OpenAppCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAmB,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAEL,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,kBAAkB,GACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAElF,OAAO,EAAoB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQnE,MAAM,eAAe,GAAqC;IACxD,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE;IAC3C,MAAM,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE;CAChD,CAAC;AAEF,MAAM,OAAO,mBAAoB,SAAQ,mBAAsC;IAC7E,YAAY,EAAE,OAAO,EAAE,SAAS,EAAuC;QACrE,KAAK,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF;AAID;;GAEG;AACH,MAAM,OAAO,cAAc;IAGhB,IAAI,CAAc;IAElB,qBAAqB,GAAG,IAAI,CAAC;IAEtC,YAAY,IAAiB;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,OAAO;QACL,MAAM,eAAe,GAAoB;YACvC,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,IAAI;YACT,EAAE,EAAE,IAAI;YACR,EAAE,EAAE,IAAI;SACT,CAAC;QACF,OAAO,IAAI,WAAW,CAAC,eAAe,CAAC;aACpC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;aACvC,KAAK,EAAE,CAAC;IACb,CAAC;IAED,aAAa,CACX,YAA0B;QAE1B,IAAI,YAAY,CAAC,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;YACjD,OAAO,oBAAoB,CAAC;gBAC1B,IAAI,EAAE,SAAS;aAChB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,kBAAkB,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC;YACnD,OAAO,oBAAoB,CAAC;gBAC1B,KAAK,EAAE,IAAI,mBAAmB,CAAC;oBAC7B,GAAG,eAAe,CAAC,SAAS,CAAC;oBAC7B,SAAS;iBACV,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,oBAAoB,CAAC;YAC1B,KAAK,EAAE,yBAAyB,CAAC,MAAM,CAAC,YAAY,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/esm/src/api/command/use-case/SendCommandUseCase.d.ts

@@ -0,0 +1,31 @@
+import { Command } from "../../command/Command";
+import { CommandResult } from "../../command/model/CommandResult";
+import type { DeviceSessionService } from "../../../internal/device-session/service/DeviceSessionService";
+import { LoggerPublisherService } from "../../../internal/logger-publisher/service/LoggerPublisherService";
+export type SendCommandUseCaseArgs<Response, ErrorStatusCodes, Args = void> = {
+    /**
+     * The device session id.
+     */
+    readonly sessionId: string;
+    /**
+     * The command to send.
+     */
+    readonly command: Command<Response, ErrorStatusCodes, Args>;
+};
+/**
+ * Sends a command to a device through a device session.
+ */
+export declare class SendCommandUseCase {
+    private readonly _sessionService;
+    private readonly _logger;
+    constructor(sessionService: DeviceSessionService, loggerFactory: (tag: string) => LoggerPublisherService);
+    /**
+     * Sends a command to a device through a device session.
+     *
+     * @param sessionId - The device session id.
+     * @param command - The command to send.
+     * @returns The response from the command.
+     */
+    execute<Response, Args, ErrorStatusCodes>({ sessionId, command, }: SendCommandUseCaseArgs<Response, Args, ErrorStatusCodes>): Promise<CommandResult<Response, ErrorStatusCodes>>;
+}
+//# sourceMappingURL=SendCommandUseCase.d.ts.map

package/lib/esm/src/api/command/use-case/SendCommandUseCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendCommandUseCase.d.ts","sourceRoot":"","sources":["../../../../../../src/api/command/use-case/SendCommandUseCase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAC;AAElG,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AAEnG,MAAM,MAAM,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,GAAG,IAAI,IAAI;IAC5E;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;CAC7D,CAAC;AAEF;;GAEG;AACH,qBACa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAG/C,cAAc,EAAE,oBAAoB,EAEpC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,sBAAsB;IAMxD;;;;;;OAMG;IACG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAC9C,SAAS,EACT,OAAO,GACR,EAAE,sBAAsB,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,CAAC,GAAG,OAAO,CACnE,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAC1C;CAmBF"}

package/lib/esm/src/api/command/use-case/SendCommandUseCase.js

@@ -0,0 +1,55 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import { deviceSessionTypes } from "../../../internal/device-session/di/deviceSessionTypes";
+import { loggerTypes } from "../../../internal/logger-publisher/di/loggerTypes";
+/**
+ * Sends a command to a device through a device session.
+ */
+let SendCommandUseCase = class SendCommandUseCase {
+    _sessionService;
+    _logger;
+    constructor(sessionService, loggerFactory) {
+        this._sessionService = sessionService;
+        this._logger = loggerFactory("SendCommandUseCase");
+    }
+    /**
+     * Sends a command to a device through a device session.
+     *
+     * @param sessionId - The device session id.
+     * @param command - The command to send.
+     * @returns The response from the command.
+     */
+    async execute({ sessionId, command, }) {
+        const deviceSessionOrError = this._sessionService.getDeviceSessionById(sessionId);
+        return deviceSessionOrError.caseOf({
+            // Case device session found
+            Right: async (deviceSession) => await deviceSession.sendCommand(command),
+            // Case device session not found
+            Left: (error) => {
+                this._logger.error("Error getting session", {
+                    data: { error },
+                });
+                throw error;
+            },
+        });
+    }
+};
+SendCommandUseCase = __decorate([
+    injectable(),
+    __param(0, inject(deviceSessionTypes.DeviceSessionService)),
+    __param(1, inject(loggerTypes.LoggerPublisherServiceFactory)),
+    __metadata("design:paramtypes", [Object, Function])
+], SendCommandUseCase);
+export { SendCommandUseCase };
+//# sourceMappingURL=SendCommandUseCase.js.map

package/lib/esm/src/api/command/use-case/SendCommandUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendCommandUseCase.js","sourceRoot":"","sources":["../../../../../../src/api/command/use-case/SendCommandUseCase.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAI/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AAEpF,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAcxE;;GAEG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IACZ,eAAe,CAAuB;IACtC,OAAO,CAAyB;IACjD,YAEE,cAAoC,EAEpC,aAAsD;QAEtD,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAmC,EAC9C,SAAS,EACT,OAAO,GACkD;QAGzD,MAAM,oBAAoB,GACxB,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAEvD,OAAO,oBAAoB,CAAC,MAAM,CAAC;YACjC,4BAA4B;YAC5B,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAC7B,MAAM,aAAa,CAAC,WAAW,CAC7B,OAAO,CACR;YACH,gCAAgC;YAChC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;gBACd,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE;oBAC1C,IAAI,EAAE,EAAE,KAAK,EAAE;iBAChB,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;YACd,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA5CY,kBAAkB;IAD9B,UAAU,EAAE;IAKR,WAAA,MAAM,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAA;IAE/C,WAAA,MAAM,CAAC,WAAW,CAAC,6BAA6B,CAAC,CAAA;;GANzC,kBAAkB,CA4C9B"}

package/lib/esm/src/api/command/utils/CommandErrors.d.ts

@@ -0,0 +1,13 @@
+import { DeviceExchangeErrorArgs } from "../../Error";
+/**
+ * CommandErrors dictionary utility type
+ */
+export type CommandErrors<SpecificErrorCodes extends string> = Record<SpecificErrorCodes, Pick<DeviceExchangeErrorArgs<SpecificErrorCodes>, "message"> & Partial<Pick<DeviceExchangeErrorArgs<SpecificErrorCodes>, "tag">>>;
+/**
+ * Typeguard to check if an error status code is handled
+ *
+ * @param errorCode
+ * @param errors
+ */
+export declare const isCommandErrorCode: <SpecificErrorCodes extends string>(errorCode: string, errors: CommandErrors<SpecificErrorCodes>) => errorCode is SpecificErrorCodes;
+//# sourceMappingURL=CommandErrors.d.ts.map

package/lib/esm/src/api/command/utils/CommandErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandErrors.d.ts","sourceRoot":"","sources":["../../../../../../src/api/command/utils/CommandErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,kBAAkB,SAAS,MAAM,IAAI,MAAM,CACnE,kBAAkB,EAClB,IAAI,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,SAAS,CAAC,GAC1D,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,CAAC,CACpE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,kBAAkB,SAAS,MAAM,aACvD,MAAM,UACT,aAAa,CAAC,kBAAkB,CAAC,KACxC,SAAS,IAAI,kBAA6D,CAAC"}

package/lib/esm/src/api/command/utils/CommandErrors.js

@@ -0,0 +1,8 @@
+/**
+ * Typeguard to check if an error status code is handled
+ *
+ * @param errorCode
+ * @param errors
+ */
+export const isCommandErrorCode = (errorCode, errors) => Object.keys(errors).includes(errorCode);
+//# sourceMappingURL=CommandErrors.js.map

package/lib/esm/src/api/command/utils/CommandErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandErrors.js","sourceRoot":"","sources":["../../../../../../src/api/command/utils/CommandErrors.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,SAAiB,EACjB,MAAyC,EACR,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC"}

package/lib/esm/src/api/command/utils/CommandUtils.d.ts

@@ -0,0 +1,7 @@
+import { ApduResponse } from "../../device-session/ApduResponse";
+export declare class CommandUtils {
+    static isValidStatusCode(statusCode: Uint8Array): boolean;
+    static isSuccessResponse({ statusCode }: ApduResponse): boolean;
+    static isLockedDeviceResponse({ statusCode }: ApduResponse): boolean;
+}
+//# sourceMappingURL=CommandUtils.d.ts.map

package/lib/esm/src/api/command/utils/CommandUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/api/command/utils/CommandUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,qBAAa,YAAY;IACvB,MAAM,CAAC,iBAAiB,CAAC,UAAU,EAAE,UAAU;IAI/C,MAAM,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,EAAE,YAAY;IAQrD,MAAM,CAAC,sBAAsB,CAAC,EAAE,UAAU,EAAE,EAAE,YAAY;CAO3D"}

package/lib/esm/src/api/command/utils/CommandUtils.js

@@ -0,0 +1,18 @@
+export class CommandUtils {
+    static isValidStatusCode(statusCode) {
+        return statusCode.length === 2;
+    }
+    static isSuccessResponse({ statusCode }) {
+        if (!this.isValidStatusCode(statusCode)) {
+            return false;
+        }
+        return statusCode[0] === 0x90 && statusCode[1] === 0x00;
+    }
+    static isLockedDeviceResponse({ statusCode }) {
+        if (!this.isValidStatusCode(statusCode)) {
+            return false;
+        }
+        return statusCode[0] === 0x55 && statusCode[1] === 0x15;
+    }
+}
+//# sourceMappingURL=CommandUtils.js.map

package/lib/esm/src/api/command/utils/CommandUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandUtils.js","sourceRoot":"","sources":["../../../../../../src/api/command/utils/CommandUtils.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACvB,MAAM,CAAC,iBAAiB,CAAC,UAAsB;QAC7C,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAgB;QACnD,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,sBAAsB,CAAC,EAAE,UAAU,EAAgB;QACxD,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC1D,CAAC;CACF"}

package/lib/esm/src/api/command/utils/GlobalCommandError.d.ts

@@ -0,0 +1,28 @@
+import { ApduResponse } from "../../device-session/ApduResponse";
+import { CommandErrorArgs, DeviceExchangeError, UnknownDeviceExchangeError } from "../../Error";
+import { CommandErrors } from "./CommandErrors";
+/**
+ * Status word list of global errors that any command could result
+ */
+export type GlobalCommandErrorStatusCode = "5515" | "5501" | "5502" | "5223";
+/**
+ * Global command error class
+ */
+export declare class GlobalCommandError extends DeviceExchangeError<GlobalCommandErrorStatusCode> {
+    constructor(args: CommandErrorArgs<GlobalCommandErrorStatusCode>);
+}
+/**
+ * Global errors dictionary that links a global status code to an error message
+ */
+export declare const GLOBAL_ERRORS: CommandErrors<GlobalCommandErrorStatusCode>;
+/**
+ * Global error handler utility class
+ */
+export declare class GlobalCommandErrorHandler {
+    /**
+     * Static method to get a handled GlobalCommandError or an unhandled SdkError from an apdu response
+     * @param apduResponse
+     */
+    static handle(apduResponse: ApduResponse): GlobalCommandError | UnknownDeviceExchangeError;
+}
+//# sourceMappingURL=GlobalCommandError.d.ts.map

package/lib/esm/src/api/command/utils/GlobalCommandError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalCommandError.d.ts","sourceRoot":"","sources":["../../../../../../src/api/command/utils/GlobalCommandError.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAsB,MAAM,iBAAiB,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7E;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,mBAAmB,CAAC,4BAA4B,CAAC;gBAC3E,IAAI,EAAE,gBAAgB,CAAC,4BAA4B,CAAC;CAGjE;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,4BAA4B,CAKrE,CAAC;AAEF;;GAEG;AACH,qBAAa,yBAAyB;IACpC;;;OAGG;IACH,MAAM,CAAC,MAAM,CACX,YAAY,EAAE,YAAY,GACzB,kBAAkB,GAAG,0BAA0B;CAWnD"}

package/lib/esm/src/api/command/utils/GlobalCommandError.js

@@ -0,0 +1,41 @@
+import { ApduParser } from "../../apdu/utils/ApduParser";
+import { DeviceExchangeError, UnknownDeviceExchangeError, } from "../../Error";
+import { isCommandErrorCode } from "./CommandErrors";
+/**
+ * Global command error class
+ */
+export class GlobalCommandError extends DeviceExchangeError {
+    constructor(args) {
+        super({ tag: "GlobalCommandError", ...args });
+    }
+}
+/**
+ * Global errors dictionary that links a global status code to an error message
+ */
+export const GLOBAL_ERRORS = {
+    "5515": { message: "Device is locked.", tag: "DeviceLockedError" },
+    "5501": { message: "Action refused on device.", tag: "ActionRefusedError" },
+    "5502": { message: "Pin is not set", tag: "PinNotSetError" },
+    "5223": { message: "Device internal error", tag: "DeviceInternalError" },
+};
+/**
+ * Global error handler utility class
+ */
+export class GlobalCommandErrorHandler {
+    /**
+     * Static method to get a handled GlobalCommandError or an unhandled SdkError from an apdu response
+     * @param apduResponse
+     */
+    static handle(apduResponse) {
+        const parser = new ApduParser(apduResponse);
+        const errorCode = parser.encodeToHexaString(apduResponse.statusCode);
+        if (isCommandErrorCode(errorCode, GLOBAL_ERRORS)) {
+            return new GlobalCommandError({ ...GLOBAL_ERRORS[errorCode], errorCode });
+        }
+        return new UnknownDeviceExchangeError({
+            message: "UnknownError",
+            errorCode,
+        });
+    }
+}
+//# sourceMappingURL=GlobalCommandError.js.map

package/lib/esm/src/api/command/utils/GlobalCommandError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalCommandError.js","sourceRoot":"","sources":["../../../../../../src/api/command/utils/GlobalCommandError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAEL,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAiB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAOpE;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,mBAAiD;IACvF,YAAY,IAAoD;QAC9D,KAAK,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAgD;IACxE,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,mBAAmB,EAAE;IAClE,MAAM,EAAE,EAAE,OAAO,EAAE,2BAA2B,EAAE,GAAG,EAAE,oBAAoB,EAAE;IAC3E,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5D,MAAM,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,GAAG,EAAE,qBAAqB,EAAE;CACzE,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;OAGG;IACH,MAAM,CAAC,MAAM,CACX,YAA0B;QAE1B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,kBAAkB,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,kBAAkB,CAAC,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,IAAI,0BAA0B,CAAC;YACpC,OAAO,EAAE,cAAc;YACvB,SAAS;SACV,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/esm/src/api/device/DeviceModel.d.ts

@@ -0,0 +1,28 @@
+export declare enum DeviceModelId {
+    NANO_S = "nanoS",
+    NANO_SP = "nanoSP",
+    NANO_X = "nanoX",
+    STAX = "stax",
+    FLEX = "flex"
+}
+/**
+ * Unique identifier for a device.
+ *
+ * NB: This identifier is generated at runtime and is not persisted. It cannot
+ * be used to identify a device across sessions.
+ * There is in fact no way to identify a device across sessions, which is a
+ * privacy feature of Ledger devices.
+ */
+export type DeviceId = string;
+export type DeviceModelArgs = {
+    readonly id: DeviceId;
+    readonly model: DeviceModelId;
+    readonly name: string;
+};
+export declare class DeviceModel {
+    readonly id: DeviceId;
+    readonly model: DeviceModelId;
+    readonly name: string;
+    constructor({ id, model, name }: DeviceModelArgs);
+}
+//# sourceMappingURL=DeviceModel.d.ts.map

package/lib/esm/src/api/device/DeviceModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceModel.d.ts","sourceRoot":"","sources":["../../../../../src/api/device/DeviceModel.ts"],"names":[],"mappings":"AAAA,oBAAY,aAAa;IACvB,MAAM,UAAU;IAChB,OAAO,WAAW;IAClB,MAAM,UAAU;IAChB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,WAAW;IACtB,SAAgB,EAAE,EAAE,QAAQ,CAAC;IAC7B,SAAgB,KAAK,EAAE,aAAa,CAAC;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,eAAe;CAKjD"}

package/lib/esm/src/api/device/DeviceModel.js

@@ -0,0 +1,19 @@
+export var DeviceModelId;
+(function (DeviceModelId) {
+    DeviceModelId["NANO_S"] = "nanoS";
+    DeviceModelId["NANO_SP"] = "nanoSP";
+    DeviceModelId["NANO_X"] = "nanoX";
+    DeviceModelId["STAX"] = "stax";
+    DeviceModelId["FLEX"] = "flex";
+})(DeviceModelId || (DeviceModelId = {}));
+export class DeviceModel {
+    id;
+    model;
+    name;
+    constructor({ id, model, name }) {
+        this.id = id;
+        this.model = model;
+        this.name = name;
+    }
+}
+//# sourceMappingURL=DeviceModel.js.map