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

package/lib/cjs/src/api/DeviceSdkBuilder.d.ts

@@ -0,0 +1,27 @@
+import { LoggerSubscriberService } from "./logger-subscriber/service/LoggerSubscriberService";
+import { DeviceSdk } from "./DeviceSdk";
+import { SdkConfig } from "./SdkConfig";
+/**
+ * Builder for the `DeviceSdk` class.
+ *
+ * @example
+ * ```
+ * const sdk = new LedgerDeviceSdkBuilder()
+ *  .setStub(false)
+ *  .addLogger(myLogger)
+ *  .build();
+ * ```
+ */
+export declare class LedgerDeviceSdkBuilder {
+    private stub;
+    private readonly loggers;
+    private config;
+    build(): DeviceSdk;
+    setStub(stubbed: boolean): LedgerDeviceSdkBuilder;
+    /**
+     * Add a logger to the SDK that will receive its logs
+     */
+    addLogger(logger: LoggerSubscriberService): LedgerDeviceSdkBuilder;
+    addConfig(config: SdkConfig): LedgerDeviceSdkBuilder;
+}
+//# sourceMappingURL=DeviceSdkBuilder.d.ts.map

package/lib/cjs/src/api/DeviceSdkBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceSdkBuilder.d.ts","sourceRoot":"","sources":["../../../../src/api/DeviceSdkBuilder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qDAAqD,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,MAAM,CAEZ;IAEF,KAAK,IAAI,SAAS;IAQlB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB;IAKjD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,uBAAuB,GAAG,sBAAsB;IAKlE,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,sBAAsB;CAOrD"}

package/lib/cjs/src/api/DeviceSdkBuilder.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerDeviceSdkBuilder = void 0;
+const Const_1 = require("../internal/manager-api/model/Const");
+const DeviceSdk_1 = require("./DeviceSdk");
+/**
+ * Builder for the `DeviceSdk` class.
+ *
+ * @example
+ * ```
+ * const sdk = new LedgerDeviceSdkBuilder()
+ *  .setStub(false)
+ *  .addLogger(myLogger)
+ *  .build();
+ * ```
+ */
+class LedgerDeviceSdkBuilder {
+    stub = false;
+    loggers = [];
+    config = {
+        managerApiUrl: Const_1.DEFAULT_MANAGER_API_BASE_URL,
+    };
+    build() {
+        return new DeviceSdk_1.DeviceSdk({
+            stub: this.stub,
+            loggers: this.loggers,
+            config: this.config,
+        });
+    }
+    setStub(stubbed) {
+        this.stub = stubbed;
+        return this;
+    }
+    /**
+     * Add a logger to the SDK that will receive its logs
+     */
+    addLogger(logger) {
+        this.loggers.push(logger);
+        return this;
+    }
+    addConfig(config) {
+        this.config = {
+            ...this.config,
+            ...config,
+        };
+        return this;
+    }
+}
+exports.LedgerDeviceSdkBuilder = LedgerDeviceSdkBuilder;
+//# sourceMappingURL=DeviceSdkBuilder.js.map

package/lib/cjs/src/api/DeviceSdkBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceSdkBuilder.js","sourceRoot":"","sources":["../../../../src/api/DeviceSdkBuilder.ts"],"names":[],"mappings":";;;AAAA,6DAAiF;AAGjF,2CAAwC;AAGxC;;;;;;;;;;GAUG;AACH,MAAa,sBAAsB;IACzB,IAAI,GAAG,KAAK,CAAC;IACJ,OAAO,GAA8B,EAAE,CAAC;IACjD,MAAM,GAAc;QAC1B,aAAa,EAAE,oCAA4B;KAC5C,CAAC;IAEF,KAAK;QACH,OAAO,IAAI,qBAAS,CAAC;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,OAAgB;QACtB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAA+B;QACvC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,MAAM;SACV,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAnCD,wDAmCC"}

package/lib/cjs/src/api/Error.d.ts

@@ -0,0 +1,26 @@
+export interface SdkError {
+    readonly _tag: string;
+    readonly originalError?: unknown;
+    message?: string;
+}
+export type DeviceExchangeErrorArgs<SpecificErrorCodes> = {
+    tag: string;
+    originalError?: unknown;
+    errorCode: SpecificErrorCodes;
+    message: string;
+};
+export type CommandErrorArgs<SpecificErrorCodes> = Omit<DeviceExchangeErrorArgs<SpecificErrorCodes>, "tag">;
+export declare abstract class DeviceExchangeError<SpecificErrorCodes = void> {
+    readonly _tag: string;
+    readonly originalError?: unknown;
+    readonly errorCode: SpecificErrorCodes;
+    readonly message: string;
+    protected constructor({ tag, errorCode, originalError, message, }: DeviceExchangeErrorArgs<SpecificErrorCodes>);
+}
+export declare class UnknownDeviceExchangeError implements SdkError {
+    readonly _tag = "UnknownDeviceExchangeError";
+    readonly originalError?: unknown;
+    readonly message: string;
+    constructor(originalError?: unknown);
+}
+//# sourceMappingURL=Error.d.ts.map

package/lib/cjs/src/api/Error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Error.d.ts","sourceRoot":"","sources":["../../../../src/api/Error.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,uBAAuB,CAAC,kBAAkB,IAAI;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,kBAAkB,IAAI,IAAI,CACrD,uBAAuB,CAAC,kBAAkB,CAAC,EAC3C,KAAK,CACN,CAAC;AAEF,8BAAsB,mBAAmB,CAAC,kBAAkB,GAAG,IAAI;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,SAAS,aAAa,EACpB,GAAG,EACH,SAAS,EACT,aAAa,EACb,OAAO,GACR,EAAE,uBAAuB,CAAC,kBAAkB,CAAC;CAM/C;AAED,qBAAa,0BAA2B,YAAW,QAAQ;IACzD,QAAQ,CAAC,IAAI,gCAAgC;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,aAAa,CAAC,EAAE,OAAO;CAIpC"}

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownDeviceExchangeError = exports.DeviceExchangeError = void 0;
+class DeviceExchangeError {
+    _tag;
+    originalError;
+    errorCode;
+    message;
+    constructor({ tag, errorCode, originalError, message, }) {
+        this._tag = tag;
+        this.originalError = originalError;
+        this.errorCode = errorCode;
+        this.message = message;
+    }
+}
+exports.DeviceExchangeError = DeviceExchangeError;
+class UnknownDeviceExchangeError {
+    _tag = "UnknownDeviceExchangeError";
+    originalError;
+    message;
+    constructor(originalError) {
+        this.originalError = originalError;
+        this.message = "Unexpected device exchange error happened.";
+    }
+}
+exports.UnknownDeviceExchangeError = UnknownDeviceExchangeError;
+//# sourceMappingURL=Error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Error.js","sourceRoot":"","sources":["../../../../src/api/Error.ts"],"names":[],"mappings":";;;AAkBA,MAAsB,mBAAmB;IAC9B,IAAI,CAAS;IACb,aAAa,CAAW;IACxB,SAAS,CAAqB;IAC9B,OAAO,CAAS;IAEzB,YAAsB,EACpB,GAAG,EACH,SAAS,EACT,aAAa,EACb,OAAO,GACqC;QAC5C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAjBD,kDAiBC;AAED,MAAa,0BAA0B;IAC5B,IAAI,GAAG,4BAA4B,CAAC;IACpC,aAAa,CAAW;IACxB,OAAO,CAAS;IAEzB,YAAY,aAAuB;QACjC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,4CAA4C,CAAC;IAC9D,CAAC;CACF;AATD,gEASC"}

package/lib/cjs/src/api/SdkConfig.d.ts

@@ -0,0 +1,4 @@
+export type SdkConfig = {
+    managerApiUrl: string;
+};
+//# sourceMappingURL=SdkConfig.d.ts.map

package/lib/cjs/src/api/SdkConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkConfig.d.ts","sourceRoot":"","sources":["../../../../src/api/SdkConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC"}

package/lib/cjs/src/api/SdkConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SdkConfig.js.map

package/lib/cjs/src/api/SdkConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SdkConfig.js","sourceRoot":"","sources":["../../../../src/api/SdkConfig.ts"],"names":[],"mappings":""}

package/lib/cjs/src/api/apdu/model/Apdu.d.ts

@@ -0,0 +1,33 @@
+/**
+ * An APDU command that can be sent to a device.
+ * DO NOT USE THIS CLASS DIRECTLY, use ApduBuilder instead.
+ */
+export declare class Apdu {
+    /**
+     * Instruction class (1 byte)
+     */
+    readonly cla: number;
+    /**
+     * Instruction code (1 byte)
+     */
+    readonly ins: number;
+    /**
+     * Instruction parameter 1 (2 bytes)
+     */
+    readonly p1: number;
+    /**
+     * Instruction parameter 2 (2 bytes)
+     */
+    readonly p2: number;
+    /**
+     * Bytes of data
+     */
+    readonly data: Uint8Array;
+    constructor(cla: number, ins: number, p1: number, p2: number, data?: Uint8Array);
+    /**
+     * Get the raw binary data of the APDU command
+     * @returns {Uint8Array} - The raw APDU command
+     */
+    getRawApdu(): Uint8Array;
+}
+//# sourceMappingURL=Apdu.d.ts.map

package/lib/cjs/src/api/apdu/model/Apdu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Apdu.d.ts","sourceRoot":"","sources":["../../../../../../src/api/apdu/model/Apdu.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,IAAI;IACf;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;gBAGxB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,UAAU;IASnB;;;OAGG;IACH,UAAU,IAAI,UAAU;CAkBzB"}

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Apdu = void 0;
+/**
+ * An APDU command that can be sent to a device.
+ * DO NOT USE THIS CLASS DIRECTLY, use ApduBuilder instead.
+ */
+class Apdu {
+    /**
+     * Instruction class (1 byte)
+     */
+    cla;
+    /**
+     * Instruction code (1 byte)
+     */
+    ins;
+    /**
+     * Instruction parameter 1 (2 bytes)
+     */
+    p1;
+    /**
+     * Instruction parameter 2 (2 bytes)
+     */
+    p2;
+    /**
+     * Bytes of data
+     */
+    data;
+    constructor(cla, ins, p1, p2, data) {
+        this.cla = cla;
+        this.ins = ins;
+        this.p1 = p1;
+        this.p2 = p2;
+        this.data = data ?? new Uint8Array();
+    }
+    /**
+     * Get the raw binary data of the APDU command
+     * @returns {Uint8Array} - The raw APDU command
+     */
+    getRawApdu() {
+        const header = Uint8Array.from([
+            this.cla,
+            this.ins,
+            this.p1,
+            this.p2,
+            this.data.length,
+        ]);
+        const apdu = new Uint8Array(header.length + this.data.length);
+        apdu.set(header, 0);
+        if (this.data.length > 0) {
+            apdu.set(this.data, header.length);
+        }
+        return apdu;
+    }
+}
+exports.Apdu = Apdu;
+//# sourceMappingURL=Apdu.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Apdu.js","sourceRoot":"","sources":["../../../../../../src/api/apdu/model/Apdu.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,IAAI;IACf;;OAEG;IACM,GAAG,CAAS;IAErB;;OAEG;IACM,GAAG,CAAS;IAErB;;OAEG;IACM,EAAE,CAAS;IAEpB;;OAEG;IACM,EAAE,CAAS;IAEpB;;OAEG;IACM,IAAI,CAAa;IAE1B,YACE,GAAW,EACX,GAAW,EACX,EAAU,EACV,EAAU,EACV,IAAiB;QAEjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,UAAU,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,IAAI,CAAC,GAAG;YACR,IAAI,CAAC,GAAG;YACR,IAAI,CAAC,EAAE;YACP,IAAI,CAAC,EAAE;YACP,IAAI,CAAC,IAAI,CAAC,MAAM;SACjB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEpB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA9DD,oBA8DC"}

package/lib/cjs/src/api/apdu/utils/ApduBuilder.d.ts

@@ -0,0 +1,113 @@
+import { Apdu } from "../../apdu/model/Apdu";
+import { AppBuilderError } from "./AppBuilderError";
+export declare const HEADER_LENGTH = 5;
+export declare const APDU_MAX_PAYLOAD = 255;
+export declare const APDU_MAX_SIZE: number;
+export type ApduBuilderArgs = {
+    readonly ins: number;
+    readonly cla: number;
+    readonly p1: number;
+    readonly p2: number;
+};
+/**
+ * ApduBuilder is a utility class to help build APDU commands.
+ * It allows to easily add data to the data field of the APDU command
+ * and to encode this data in different formats.
+ *
+ * @example
+ * ```
+ * const apduBuilder = new ApduBuilder({ ins: 0x01, cla: 0x02, p1: 0x03, p2: 0x04 })
+ *  .add8BitUIntToData(0x05)
+ *  .add16BitUIntToData(0x0607)
+ *  .addHexaStringToData("0x0809")
+ *  .addAsciiStringToData("hello")
+ *
+ * const apdu = apduBuilder.build();
+ * const builderErrors = apduBuilder.getErrors();
+ * ```
+ */
+export declare class ApduBuilder {
+    private readonly _ins;
+    private readonly _cla;
+    private readonly _p1;
+    private readonly p2;
+    private data;
+    constructor({ ins, cla, p1, p2 }: ApduBuilderArgs);
+    /**
+     * Build a new Apdu instance with the current state of the builder
+     * @returns {Apdu} - Returns a new Apdu instance
+     */
+    build: () => Apdu;
+    /**
+     * Add a 8-bit unsigned integer to the data field (max value 0xff = 255)
+     * @param value?: number - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    add8BitUIntToData: (value: number) => ApduBuilder;
+    /**
+     * Add a 16-bit unsigned integer to the data field (max value 0xffff = 65535)
+     * @param value: number - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    add16BitUIntToData: (value: number) => ApduBuilder;
+    /**
+     * Add a 32-bit unsigned integer to the data field (max value 0xffffffff = 4294967295)
+     * @param value: number - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    add32BitUIntToData: (value: number) => ApduBuilder;
+    /**
+     * Add a Uint8Array to the data field if it has enough remaining space
+     * @param value: Uint8Array - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    addBufferToData: (value: Uint8Array) => ApduBuilder;
+    /**
+     * Add a string to the data field if it has enough remaining space
+     * and it can be formatted as a hexadecimal string
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    addHexaStringToData: (value: string) => ApduBuilder;
+    /**
+     * Add an ascii string to the data field if it has enough remaining space
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    addAsciiStringToData: (value: string) => ApduBuilder;
+    /**
+     * Add a Length-Value encoded hexadecimal string to the data field if it has enough remaining space
+     * Length-Value encoding is a way to encode data in a binary format with the first byte
+     * being the length of the data and the following bytes being the data itself
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    encodeInLVFromHexa: (value: string) => ApduBuilder;
+    /**
+     * Add a Length-Value encoded buffer to the data field if it has enough remaining space
+     * Length-Value encoding is a way to encode data in a binary format with the first byte
+     * being the length of the data and the following bytes being the data itself
+     * @param value: Uint8Array - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    encodeInLVFromBuffer: (value: Uint8Array) => ApduBuilder;
+    /**
+     * Add a Length-Value encoded ascii string to the data field if it has enough remaining space
+     * Length-Value encoding is a way to encode data in a binary format with the first byte
+     * being the length of the data and the following bytes being the data itself
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    encodeInLVFromAscii: (value: string) => ApduBuilder;
+    /**
+     * Returns the remaining payload length
+     * @returns {number}
+     */
+    getAvailablePayloadLength: () => number;
+    /**
+     * Returns the current errors
+     * @returns {AppBuilderError[]} - Returns an array of errors
+     */
+    getErrors: () => AppBuilderError[];
+}
+//# sourceMappingURL=ApduBuilder.d.ts.map

package/lib/cjs/src/api/apdu/utils/ApduBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApduBuilder.d.ts","sourceRoot":"","sources":["../../../../../../src/api/apdu/utils/ApduBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,aAAa,QAAuB,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAS;IAC5B,OAAO,CAAC,IAAI,CAA4D;gBAE5D,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,eAAe;IAWjD;;;OAGG;IACH,KAAK,QAAO,IAAI,CACuD;IAEvE;;;;OAIG;IACH,iBAAiB,UAAW,MAAM,KAAG,WAAW,CAG9C;IAEF;;;;OAIG;IACH,kBAAkB,UAAW,MAAM,KAAG,WAAW,CAG/C;IAEF;;;;OAIG;IACH,kBAAkB,UAAW,MAAM,KAAG,WAAW,CAG/C;IAEF;;;;OAIG;IACH,eAAe,UAAW,UAAU,KAAG,WAAW,CAGhD;IAEF;;;;;OAKG;IACH,mBAAmB,UAAW,MAAM,KAAG,WAAW,CAGhD;IAEF;;;;OAIG;IACH,oBAAoB,UAAW,MAAM,KAAG,WAAW,CAGjD;IAEF;;;;;;OAMG;IACH,kBAAkB,UAAW,MAAM,KAAG,WAAW,CAG/C;IAEF;;;;;;OAMG;IACH,oBAAoB,UAAW,UAAU,KAAG,WAAW,CAGrD;IAEF;;;;;;OAMG;IACH,mBAAmB,UAAW,MAAM,KAAG,WAAW,CAGhD;IAEF;;;OAGG;IACH,yBAAyB,QAAO,MAAM,CACE;IAExC;;;OAGG;IACH,SAAS,QAAO,eAAe,EAAE,CAA0B;CAC5D"}

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

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApduBuilder = exports.APDU_MAX_SIZE = exports.APDU_MAX_PAYLOAD = exports.HEADER_LENGTH = void 0;
+const Apdu_1 = require("../../apdu/model/Apdu");
+const ByteArrayBuilder_1 = require("./ByteArrayBuilder");
+exports.HEADER_LENGTH = 5;
+exports.APDU_MAX_PAYLOAD = 255;
+exports.APDU_MAX_SIZE = exports.APDU_MAX_PAYLOAD + 5;
+/**
+ * ApduBuilder is a utility class to help build APDU commands.
+ * It allows to easily add data to the data field of the APDU command
+ * and to encode this data in different formats.
+ *
+ * @example
+ * ```
+ * const apduBuilder = new ApduBuilder({ ins: 0x01, cla: 0x02, p1: 0x03, p2: 0x04 })
+ *  .add8BitUIntToData(0x05)
+ *  .add16BitUIntToData(0x0607)
+ *  .addHexaStringToData("0x0809")
+ *  .addAsciiStringToData("hello")
+ *
+ * const apdu = apduBuilder.build();
+ * const builderErrors = apduBuilder.getErrors();
+ * ```
+ */
+class ApduBuilder {
+    _ins;
+    _cla;
+    _p1;
+    p2;
+    data = new ByteArrayBuilder_1.ByteArrayBuilder(exports.APDU_MAX_PAYLOAD);
+    constructor({ ins, cla, p1, p2 }) {
+        this._cla = cla & 0xff;
+        this._ins = ins & 0xff;
+        this._p1 = p1 & 0xff;
+        this.p2 = p2 & 0xff;
+    }
+    // ==========
+    // Public API
+    // ==========
+    /**
+     * Build a new Apdu instance with the current state of the builder
+     * @returns {Apdu} - Returns a new Apdu instance
+     */
+    build = () => new Apdu_1.Apdu(this._cla, this._ins, this._p1, this.p2, this.data.build());
+    /**
+     * Add a 8-bit unsigned integer to the data field (max value 0xff = 255)
+     * @param value?: number - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    add8BitUIntToData = (value) => {
+        this.data.add8BitUIntToData(value);
+        return this;
+    };
+    /**
+     * Add a 16-bit unsigned integer to the data field (max value 0xffff = 65535)
+     * @param value: number - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    add16BitUIntToData = (value) => {
+        this.data.add16BitUIntToData(value);
+        return this;
+    };
+    /**
+     * Add a 32-bit unsigned integer to the data field (max value 0xffffffff = 4294967295)
+     * @param value: number - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    add32BitUIntToData = (value) => {
+        this.data.add32BitUIntToData(value);
+        return this;
+    };
+    /**
+     * Add a Uint8Array to the data field if it has enough remaining space
+     * @param value: Uint8Array - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    addBufferToData = (value) => {
+        this.data.addBufferToData(value);
+        return this;
+    };
+    /**
+     * Add a string to the data field if it has enough remaining space
+     * and it can be formatted as a hexadecimal string
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    addHexaStringToData = (value) => {
+        this.data.addHexaStringToData(value);
+        return this;
+    };
+    /**
+     * Add an ascii string to the data field if it has enough remaining space
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    addAsciiStringToData = (value) => {
+        this.data.addAsciiStringToData(value);
+        return this;
+    };
+    /**
+     * Add a Length-Value encoded hexadecimal string to the data field if it has enough remaining space
+     * Length-Value encoding is a way to encode data in a binary format with the first byte
+     * being the length of the data and the following bytes being the data itself
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    encodeInLVFromHexa = (value) => {
+        this.data.encodeInLVFromHexa(value);
+        return this;
+    };
+    /**
+     * Add a Length-Value encoded buffer to the data field if it has enough remaining space
+     * Length-Value encoding is a way to encode data in a binary format with the first byte
+     * being the length of the data and the following bytes being the data itself
+     * @param value: Uint8Array - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    encodeInLVFromBuffer = (value) => {
+        this.data.encodeInLVFromBuffer(value);
+        return this;
+    };
+    /**
+     * Add a Length-Value encoded ascii string to the data field if it has enough remaining space
+     * Length-Value encoding is a way to encode data in a binary format with the first byte
+     * being the length of the data and the following bytes being the data itself
+     * @param value: string - The value to add to the data
+     * @returns {ApduBuilder} - Returns the current instance of ApduBuilder
+     */
+    encodeInLVFromAscii = (value) => {
+        this.data.encodeInLVFromAscii(value);
+        return this;
+    };
+    /**
+     * Returns the remaining payload length
+     * @returns {number}
+     */
+    getAvailablePayloadLength = () => this.data.getAvailablePayloadLength();
+    /**
+     * Returns the current errors
+     * @returns {AppBuilderError[]} - Returns an array of errors
+     */
+    getErrors = () => this.data.getErrors();
+}
+exports.ApduBuilder = ApduBuilder;
+//# sourceMappingURL=ApduBuilder.js.map

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

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

package/lib/cjs/src/api/apdu/utils/ApduParser.d.ts

@@ -0,0 +1,79 @@
+import { ApduResponse } from "../../device-session/ApduResponse";
+import { HexaString } from "../../utils/HexaString";
+export type TaggedField = {
+    readonly tag: number;
+    readonly value: Uint8Array;
+};
+/**
+ * ApduParser is a utility class to help parse APDU responses.
+ *
+ * It provides methods to extract fields of different types from the response.
+ *
+ * @example
+ * ```
+ * const parser = new ApduParser(apduResponse);
+ * const targetId = parser.encodeToHexaString(parser.extractFieldByLength(4));
+ * const seVersion = parser.encodeToString(parser.extractFieldLVEncoded());
+ * ```
+ */
+export declare class ApduParser {
+    private parser;
+    constructor(response: ApduResponse);
+    /**
+     * Test if the length is greater than the response length
+     * @param length: number
+     * @returns {boolean} - Returns false if the length is greater than the response length
+     */
+    testMinimalLength: (length: number) => boolean;
+    /**
+     * Extract a single byte from the response
+     * @returns {number | undefined} - Returns the byte extracted from the response
+     */
+    extract8BitUInt: () => number | undefined;
+    /**
+     * Extract a 16-bit unsigned integer (Big Endian coding) from the response
+     * @returns {number | undefined} - Returns the 16-bit unsigned integer extracted from the response
+     */
+    extract16BitUInt: () => number | undefined;
+    /**
+     * Extract a 32-bit unsigned integer (Big Endian coding) from the response
+     * @returns {number | undefined} - Returns the 32-bit unsigned integer extracted from the response
+     */
+    extract32BitUInt: () => number | undefined;
+    /**
+     * Extract a field of a specified length from the response
+     * @param length: number - The length of the field to extract
+     * @returns {Uint8Array | undefined} - Returns the field extracted from the response
+     */
+    extractFieldByLength: (length: number) => Uint8Array | undefined;
+    /**
+     * Extract a field from the response that is length-value encoded
+     * @returns {Uint8Array | undefined} - Returns the field extracted from the response
+     */
+    extractFieldLVEncoded: () => Uint8Array | undefined;
+    /**
+     * Extract a field from the response that is tag-length-value encoded
+     * @returns {TaggedField | undefined} - Returns the field extracted from the response
+     */
+    extractFieldTLVEncoded: () => TaggedField | undefined;
+    /**
+     * Encode a value to a hexadecimal string
+     * @param value {Uint8Array} - The value to encode
+     * @param prefix {boolean} - Whether to add a prefix to the encoded value
+     * @returns {string} - The encoded value as a hexadecimal string
+     */
+    encodeToHexaString(value?: Uint8Array, prefix?: false): string;
+    encodeToHexaString(value?: Uint8Array, prefix?: true): HexaString;
+    /**
+     * Encode a value to an ASCII string
+     * @param value {Uint8Array} - The value to encode
+     * @returns {string} - The encoded value as an ASCII string
+     */
+    encodeToString: (value?: Uint8Array) => string;
+    /**
+     * Get the remaining length of the response
+     * @returns {number} - The remaining length of the response
+     */
+    getUnparsedRemainingLength: () => number;
+}
+//# sourceMappingURL=ApduParser.d.ts.map

package/lib/cjs/src/api/apdu/utils/ApduParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApduParser.d.ts","sourceRoot":"","sources":["../../../../../../src/api/apdu/utils/ApduParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,QAAQ,EAAE,YAAY;IAIlC;;;;OAIG;IACH,iBAAiB,WAAY,MAAM,KAAG,OAAO,CACL;IAExC;;;OAGG;IACH,eAAe,QAAO,MAAM,GAAG,SAAS,CAAkC;IAE1E;;;OAGG;IACH,gBAAgB,QAAO,MAAM,GAAG,SAAS,CAAmC;IAE5E;;;OAGG;IACH,gBAAgB,QAAO,MAAM,GAAG,SAAS,CAAmC;IAE5E;;;;OAIG;IACH,oBAAoB,WAAY,MAAM,KAAG,UAAU,GAAG,SAAS,CACpB;IAE3C;;;OAGG;IACH,qBAAqB,QAAO,UAAU,GAAG,SAAS,CACZ;IAEtC;;;OAGG;IACH,sBAAsB,QAAO,WAAW,GAAG,SAAS,CACb;IAEvC;;;;;OAKG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM;IAC9D,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,UAAU;IAUjE;;;;OAIG;IACH,cAAc,WAAY,UAAU,KAAG,MAAM,CACT;IAEpC;;;OAGG;IACH,0BAA0B,QAAO,MAAM,CACI;CAC5C"}