@ledgerhq/device-core 0.2.1-next.2 → 0.3.0-nightly.1

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @ledgerhq/device-core@0.2.1-next.1 build /home/runner/work/ledger-live/ledger-live/libs/device-core
+> @ledgerhq/device-core@0.3.0-nightly.0 build /home/runner/work/ledger-live/ledger-live/libs/device-core
 > tsc && tsc -m ES6 --outDir lib-es
 

package/CHANGELOG.md

@@ -1,25 +1,26 @@
 # @ledgerhq/device-core
 
-## 0.2.1-next.2
+## 0.3.0-nightly.1
 
 ### Patch Changes
 
-- [#7173](https://github.com/LedgerHQ/ledger-live/pull/7173) [`19c02ce`](https://github.com/LedgerHQ/ledger-live/commit/19c02cead22422b4a2e94aef74ebc67e992ab54d) Thanks [@jdabbech-ledger](https://github.com/jdabbech-ledger)! - Revert deletion get name fix apdu
+- Updated dependencies [[`ef2d53d`](https://github.com/LedgerHQ/ledger-live/commit/ef2d53d514f1f4e6f18fc79fa3423bd9b0208a04)]:
+  - @ledgerhq/types-live@6.49.0-nightly.1
 
-## 0.2.1-next.1
+## 0.3.0-nightly.0
 
-### Patch Changes
-
-- [#7157](https://github.com/LedgerHQ/ledger-live/pull/7157) [`38a18fd`](https://github.com/LedgerHQ/ledger-live/commit/38a18fdb7233b77dfd631d10d9eec3cd4aeefe9f) Thanks [@jdabbech-ledger](https://github.com/jdabbech-ledger)! - Reload app restauration if device disconnected after firmware update with language pack
+### Minor Changes
 
-## 0.2.1-next.0
+- [#7124](https://github.com/LedgerHQ/ledger-live/pull/7124) [`e78f3b7`](https://github.com/LedgerHQ/ledger-live/commit/e78f3b75296c7a063f6cddbeae44c36d236055f3) Thanks [@jiyuzhuang](https://github.com/jiyuzhuang)! - Implement App data backup relative commands
 
 ### Patch Changes
 
-- [#7019](https://github.com/LedgerHQ/ledger-live/pull/7019) [`2e56708`](https://github.com/LedgerHQ/ledger-live/commit/2e567080b07abb8540907c0cb89457c746362917) Thanks [@ofreyssinet-ledger](https://github.com/ofreyssinet-ledger)! - Create getAppsCatalogForDevice use case
-
-- Updated dependencies [[`9551536`](https://github.com/LedgerHQ/ledger-live/commit/955153681ebc19344ed5becfbf7b131224b2ebd0), [`785c618`](https://github.com/LedgerHQ/ledger-live/commit/785c6180c2212ca879c2fddb8302f0bab5686761)]:
-  - @ledgerhq/types-live@6.48.1-next.0
+- Updated dependencies [[`1cbf767`](https://github.com/LedgerHQ/ledger-live/commit/1cbf767465d9e1f7bed5de79c5b5a0a5ca06e1b5), [`e78f3b7`](https://github.com/LedgerHQ/ledger-live/commit/e78f3b75296c7a063f6cddbeae44c36d236055f3)]:
+  - @ledgerhq/types-live@6.48.1-nightly.0
+  - @ledgerhq/errors@6.18.0-nightly.0
+  - @ledgerhq/devices@8.4.1-nightly.0
+  - @ledgerhq/hw-transport@6.31.1-nightly.0
+  - @ledgerhq/live-network@1.3.1-nightly.0
 
 ## 0.2.0
 

package/lib/commands/entities/AppStorageInfo.d.ts

@@ -0,0 +1,8 @@
+export type AppStorageInfo = {
+    size: number;
+    dataVersion: string;
+    hasSettings: boolean;
+    hasData: boolean;
+    hash: string;
+};
+//# sourceMappingURL=AppStorageInfo.d.ts.map

package/lib/commands/entities/AppStorageInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppStorageInfo.d.ts","sourceRoot":"","sources":["../../../src/commands/entities/AppStorageInfo.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/lib/commands/entities/AppStorageInfo.js

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

package/lib/commands/entities/AppStorageInfo.js.map

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

package/lib/commands/use-cases/app-backup/backupAppStorage.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+import Transport from "@ledgerhq/hw-transport";
+/**
+ * Retrieves the app storage information (chunk) from the device and returns it
+ * as a buffer.
+ *
+ * @param transport - The transport object used to communicate with the device.
+ * @returns A promise that resolves to the app storage information as a buffer.
+ */
+export declare function backupAppStorage(transport: Transport): Promise<Buffer>;
+/**
+ * Parses the response data buffer, check the status code and return the data.
+ *
+ * @param data - The response data buffer w/ status code.
+ * @returns The response data as a buffer w/o status code.
+ */
+export declare function parseResponse(data: Buffer): Buffer;
+//# sourceMappingURL=backupAppStorage.d.ts.map

package/lib/commands/use-cases/app-backup/backupAppStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupAppStorage.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/backupAppStorage.ts"],"names":[],"mappings":";AAAA,OAAO,SAAgD,MAAM,wBAAwB,CAAC;AA0CtF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAY5E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BlD"}

package/lib/commands/use-cases/app-backup/backupAppStorage.js

@@ -0,0 +1,98 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseResponse = exports.backupAppStorage = void 0;
+const hw_transport_1 = require("@ledgerhq/hw-transport");
+const logs_1 = require("@ledgerhq/logs");
+const errors_1 = require("../../../errors");
+/**
+ * Name in documentation: INS_APP_STORAGE_BACKUP
+ * cla: 0xe0
+ * ins: 0x6b
+ * p1: 0x00
+ * p2: 0x00
+ * lc: 0x00
+ */
+const BACKUP_APP_STORAGE = [0xe0, 0x6b, 0x00, 0x00];
+/**
+ * 0x9000: Success.
+ * 0x5123: Invalid context, Get Info must be called.
+ * 0x5419: Failed to generate AES key.
+ * 0x541A: Internal error, crypto operation failed.
+ * 0x541B: Internal error, failed to compute AES CMAC.
+ * 0x541C: Failed to encrypt the app storage backup.
+ * 0x662F: Invalid device state, recovery mode.
+ * 0x6642: Invalid backup state, backup already performed.
+ */
+const RESPONSE_STATUS_SET = [
+    hw_transport_1.StatusCodes.OK,
+    hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+    hw_transport_1.StatusCodes.GEN_AES_KEY_FAILED,
+    hw_transport_1.StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED,
+    hw_transport_1.StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED,
+    hw_transport_1.StatusCodes.ENCRYPT_APP_STORAGE_FAILED,
+    hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE,
+    hw_transport_1.StatusCodes.INVALID_BACKUP_STATE,
+];
+/**
+ * Retrieves the app storage information (chunk) from the device and returns it
+ * as a buffer.
+ *
+ * @param transport - The transport object used to communicate with the device.
+ * @returns A promise that resolves to the app storage information as a buffer.
+ */
+function backupAppStorage(transport) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const tracer = new logs_1.LocalTracer("hw", {
+            transport: transport.getTraceContext(),
+            function: "backupAppStorage",
+        });
+        tracer.trace("Start");
+        const apdu = [...BACKUP_APP_STORAGE, Buffer.from([0x00])];
+        const response = yield transport.send(...apdu, RESPONSE_STATUS_SET);
+        return parseResponse(response);
+    });
+}
+exports.backupAppStorage = backupAppStorage;
+/**
+ * Parses the response data buffer, check the status code and return the data.
+ *
+ * @param data - The response data buffer w/ status code.
+ * @returns The response data as a buffer w/o status code.
+ */
+function parseResponse(data) {
+    const tracer = new logs_1.LocalTracer("hw", {
+        function: "parseResponse@backupAppStorage",
+    });
+    const status = data.readUInt16BE(data.length - 2);
+    tracer.trace("Result status from 0xe06b0000", { status });
+    switch (status) {
+        case hw_transport_1.StatusCodes.OK:
+            return data.subarray(0, data.length - 2);
+        case hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT:
+            throw new errors_1.InvalidContext("Invalid context, getAppStorageInfo must be called.");
+        case hw_transport_1.StatusCodes.GEN_AES_KEY_FAILED:
+            throw new errors_1.GenerateAesKeyFailed("Failed to generate AES key.");
+        case hw_transport_1.StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED:
+            throw new errors_1.InternalCryptoOperationFailed("Internal error, crypto operation failed.");
+        case hw_transport_1.StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED:
+            throw new errors_1.InternalComputeAesCmacFailed("Internal error, failed to compute AES CMAC.");
+        case hw_transport_1.StatusCodes.ENCRYPT_APP_STORAGE_FAILED:
+            throw new errors_1.GenerateAesKeyFailed("Failed to encrypt the app storage backup.");
+        case hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE:
+            break;
+        case hw_transport_1.StatusCodes.INVALID_BACKUP_STATE:
+            throw new errors_1.InvalidBackupState("Invalid backup state, backup already performed.");
+    }
+    throw new hw_transport_1.TransportStatusError(status);
+}
+exports.parseResponse = parseResponse;
+//# sourceMappingURL=backupAppStorage.js.map

package/lib/commands/use-cases/app-backup/backupAppStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupAppStorage.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/backupAppStorage.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAsF;AACtF,yCAA6C;AAE7C,4CAMyB;AAEzB;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAa;IACpC,0BAAW,CAAC,EAAE;IACd,0BAAW,CAAC,gCAAgC;IAC5C,0BAAW,CAAC,kBAAkB;IAC9B,0BAAW,CAAC,gCAAgC;IAC5C,0BAAW,CAAC,gCAAgC;IAC5C,0BAAW,CAAC,0BAA0B;IACtC,0BAAW,CAAC,uBAAuB;IACnC,0BAAW,CAAC,oBAAoB;CACjC,CAAC;AAEF;;;;;;GAMG;AACH,SAAsB,gBAAgB,CAAC,SAAoB;;QACzD,MAAM,MAAM,GAAG,IAAI,kBAAW,CAAC,IAAI,EAAE;YACnC,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE;YACtC,QAAQ,EAAE,kBAAkB;SAC7B,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,IAAI,GAAmB,CAAC,GAAG,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE1E,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAEpE,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;CAAA;AAZD,4CAYC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,IAAI,kBAAW,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,gCAAgC;KAC3C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,0BAAW,CAAC,EAAE;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3C,KAAK,0BAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,uBAAc,CAAC,oDAAoD,CAAC,CAAC;QACjF,KAAK,0BAAW,CAAC,kBAAkB;YACjC,MAAM,IAAI,6BAAoB,CAAC,6BAA6B,CAAC,CAAC;QAChE,KAAK,0BAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,sCAA6B,CAAC,0CAA0C,CAAC,CAAC;QACtF,KAAK,0BAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,qCAA4B,CAAC,6CAA6C,CAAC,CAAC;QACxF,KAAK,0BAAW,CAAC,0BAA0B;YACzC,MAAM,IAAI,6BAAoB,CAAC,2CAA2C,CAAC,CAAC;QAC9E,KAAK,0BAAW,CAAC,uBAAuB;YACtC,MAAM;QACR,KAAK,0BAAW,CAAC,oBAAoB;YACnC,MAAM,IAAI,2BAAkB,CAAC,iDAAiD,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,IAAI,mCAAoB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AA3BD,sCA2BC"}

package/lib/commands/use-cases/app-backup/backupAppStorage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backupAppStorage.test.d.ts.map

package/lib/commands/use-cases/app-backup/backupAppStorage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupAppStorage.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/backupAppStorage.test.ts"],"names":[],"mappings":""}

package/lib/commands/use-cases/app-backup/backupAppStorage.test.js

@@ -0,0 +1,56 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const hw_transport_1 = require("@ledgerhq/hw-transport");
+const backupAppStorage_1 = require("./backupAppStorage");
+const errors_1 = require("../../../errors");
+jest.mock("@ledgerhq/hw-transport");
+describe("backupAppStorage", () => {
+    let transport;
+    const response = Buffer.from([
+        0x31, 0x30, 0x36, 0x52, 0x75, 0x65, 0x64, 0x75, 0x54, 0x65, 0x6d, 0x70, 0x6c, 0x65, 0x90, 0x00,
+    ]);
+    beforeEach(() => {
+        transport = {
+            send: jest.fn().mockResolvedValue(response),
+            getTraceContext: jest.fn().mockResolvedValue(undefined),
+        };
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    it("should call the send function with correct parameters", () => __awaiter(void 0, void 0, void 0, function* () {
+        yield (0, backupAppStorage_1.backupAppStorage)(transport);
+        expect(transport.send).toHaveBeenCalledWith(0xe0, 0x6b, 0x00, 0x00, Buffer.from([0x00]), [
+            hw_transport_1.StatusCodes.OK,
+            hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+            hw_transport_1.StatusCodes.GEN_AES_KEY_FAILED,
+            hw_transport_1.StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED,
+            hw_transport_1.StatusCodes.INTERNAL_COMPUTE_AES_CMAC_FAILED,
+            hw_transport_1.StatusCodes.ENCRYPT_APP_STORAGE_FAILED,
+            hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE,
+            hw_transport_1.StatusCodes.INVALID_BACKUP_STATE,
+        ]);
+    }));
+    describe("parseResponse", () => {
+        it("should parse the response data correctly", () => {
+            const expected = Buffer.from([
+                0x31, 0x30, 0x36, 0x52, 0x75, 0x65, 0x64, 0x75, 0x54, 0x65, 0x6d, 0x70, 0x6c, 0x65,
+            ]);
+            expect((0, backupAppStorage_1.parseResponse)(response)).toStrictEqual(expected);
+        });
+        it("should throw TransportStatusError if the response status is invalid", () => {
+            const data = Buffer.from([0x54, 0x1b]);
+            expect(() => (0, backupAppStorage_1.parseResponse)(data)).toThrow(new errors_1.InternalComputeAesCmacFailed("Internal error, failed to compute AES CMAC."));
+        });
+    });
+});
+//# sourceMappingURL=backupAppStorage.test.js.map

package/lib/commands/use-cases/app-backup/backupAppStorage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupAppStorage.test.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/backupAppStorage.test.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,yDAAgE;AAChE,yDAAqE;AACrE,4CAA+D;AAE/D,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAEpC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,SAAoB,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAC3B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;KAC/F,CAAC,CAAC;IAEH,UAAU,CAAC,GAAG,EAAE;QACd,SAAS,GAAG;YACV,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YAC3C,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SAChC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAS,EAAE;QACrE,MAAM,IAAA,mCAAgB,EAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE;YACvF,0BAAW,CAAC,EAAE;YACd,0BAAW,CAAC,gCAAgC;YAC5C,0BAAW,CAAC,kBAAkB;YAC9B,0BAAW,CAAC,gCAAgC;YAC5C,0BAAW,CAAC,gCAAgC;YAC5C,0BAAW,CAAC,0BAA0B;YACtC,0BAAW,CAAC,uBAAuB;YACnC,0BAAW,CAAC,oBAAoB;SACjC,CAAC,CAAC;IACL,CAAC,CAAA,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;gBAC3B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;aACnF,CAAC,CAAC;YACH,MAAM,CAAC,IAAA,gCAAa,EAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;YAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,gCAAa,EAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CACvC,IAAI,qCAA4B,CAAC,6CAA6C,CAAC,CAChF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/commands/use-cases/app-backup/getAppStorageInfo.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" />
+import Transport from "@ledgerhq/hw-transport";
+import type { AppStorageInfo } from "../../entities/AppStorageInfo";
+/**
+ * Retrieves the application storage information from the device.
+ *
+ * @param transport - The transport object used to communicate with the device.
+ * @param appName - The name of the application to retrieve the storage information for.
+ * @returns A promise that resolves to the application storage information object.
+ * @throws {TransportStatusError} If the response status is invalid.
+ */
+export declare function getAppStorageInfo(transport: Transport, appName: string): Promise<AppStorageInfo>;
+/**
+ * Parses the response data from the device into a string.
+ *
+ * @param data - The response data received from the device.
+ * @returns A string representing the parsed response.
+ */
+export declare function parseResponse(data: Buffer): AppStorageInfo;
+//# sourceMappingURL=getAppStorageInfo.d.ts.map

package/lib/commands/use-cases/app-backup/getAppStorageInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppStorageInfo.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/getAppStorageInfo.ts"],"names":[],"mappings":";AAAA,OAAO,SAAgD,MAAM,wBAAwB,CAAC;AAEtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AA2BpE;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAqC1D"}

package/lib/commands/use-cases/app-backup/getAppStorageInfo.js

@@ -0,0 +1,104 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseResponse = exports.getAppStorageInfo = void 0;
+const hw_transport_1 = require("@ledgerhq/hw-transport");
+const logs_1 = require("@ledgerhq/logs");
+const errors_1 = require("../../../errors");
+/**
+ * Name in documentation: INS_APP_STORAGE_GET_INFO
+ * cla: 0xe0
+ * ins: 0x6a
+ * p1: 0x00
+ * p2: 0x00
+ * data: APP_NAME_LEN (1 byte) + APP_NAME (variable) to configure at runtime
+ */
+const GET_APP_STORAGE_INFO = [0xe0, 0x6a, 0x00, 0x00];
+/**
+ * 0x9000: Success.
+ * 0x5123: Application not found.
+ * 0x662F: If the device is in recovery mode.
+ * 0x670A: Invalid application name length, two chars minimum.
+ */
+const RESPONSE_STATUS_SET = [
+    hw_transport_1.StatusCodes.OK,
+    hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+    hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE,
+    hw_transport_1.StatusCodes.INVALID_APP_NAME_LENGTH,
+];
+/**
+ * Retrieves the application storage information from the device.
+ *
+ * @param transport - The transport object used to communicate with the device.
+ * @param appName - The name of the application to retrieve the storage information for.
+ * @returns A promise that resolves to the application storage information object.
+ * @throws {TransportStatusError} If the response status is invalid.
+ */
+function getAppStorageInfo(transport, appName) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const tracer = new logs_1.LocalTracer("hw", {
+            transport: transport.getTraceContext(),
+            function: "getAppStorageInfo",
+        });
+        tracer.trace("Start");
+        const params = Buffer.concat([
+            Buffer.from([appName.length]),
+            Buffer.from(appName, "ascii"),
+        ]);
+        const apdu = [...GET_APP_STORAGE_INFO, params];
+        const response = yield transport.send(...apdu, RESPONSE_STATUS_SET);
+        return parseResponse(response);
+    });
+}
+exports.getAppStorageInfo = getAppStorageInfo;
+/**
+ * Parses the response data from the device into a string.
+ *
+ * @param data - The response data received from the device.
+ * @returns A string representing the parsed response.
+ */
+function parseResponse(data) {
+    const tracer = new logs_1.LocalTracer("hw", {
+        function: "parseResponse@getAppStorageInfo",
+    });
+    const status = data.readUInt16BE(data.length - 2);
+    tracer.trace("Result status from 0xe06a0000", { status });
+    switch (status) {
+        case hw_transport_1.StatusCodes.OK: {
+            /**
+             * The backup size is a 4-byte unsigned integer.
+             * The data version is a 4-byte string.
+             * The hasSettings and hasData flags are 1-byte booleans.
+             * The hash is a 32-byte string.
+             */
+            let offset = 0;
+            const size = data.readUInt32BE(offset); // Len = 4
+            offset += 4;
+            const dataVersion = data.subarray(offset, offset + 4).toString(); // Len = 4
+            offset += 4;
+            const hasSettings = data.readUIntBE(offset, 1) === 1; // Len = 1
+            offset += 1;
+            const hasData = data.readUIntBE(offset, 1) === 1; // Len = 1
+            offset += 1;
+            const hash = data.subarray(offset, offset + 32).toString(); // Len = 32
+            return { size, dataVersion, hasSettings, hasData, hash };
+        }
+        case hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT:
+            throw new errors_1.AppNotFound("Application not found.");
+        case hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE:
+            break;
+        case hw_transport_1.StatusCodes.INVALID_APP_NAME_LENGTH:
+            throw new errors_1.InvalidAppNameLength("Invalid application name length, two chars minimum.");
+    }
+    throw new hw_transport_1.TransportStatusError(status);
+}
+exports.parseResponse = parseResponse;
+//# sourceMappingURL=getAppStorageInfo.js.map

package/lib/commands/use-cases/app-backup/getAppStorageInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppStorageInfo.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/getAppStorageInfo.ts"],"names":[],"mappings":"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"}

package/lib/commands/use-cases/app-backup/getAppStorageInfo.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getAppStorageInfo.test.d.ts.map

package/lib/commands/use-cases/app-backup/getAppStorageInfo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppStorageInfo.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/getAppStorageInfo.test.ts"],"names":[],"mappings":""}

package/lib/commands/use-cases/app-backup/getAppStorageInfo.test.js

@@ -0,0 +1,59 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const hw_transport_1 = require("@ledgerhq/hw-transport");
+const getAppStorageInfo_1 = require("./getAppStorageInfo");
+const errors_1 = require("../../../errors");
+jest.mock("@ledgerhq/hw-transport");
+describe("getAppStorageInfo", () => {
+    let transport;
+    const response = Buffer.from([
+        0x00, 0x00, 0x04, 0xd2, 0x31, 0x2e, 0x30, 0x31, 0x01, 0x01, 0x68, 0x61, 0x73, 0x68, 0x68, 0x61,
+        0x73, 0x68, 0x31, 0x32, 0x33, 0x34, 0x68, 0x61, 0x73, 0x68, 0x68, 0x61, 0x73, 0x68, 0x68, 0x61,
+        0x73, 0x68, 0x68, 0x61, 0x73, 0x68, 0x68, 0x61, 0x73, 0x68, 0x90, 0x00,
+    ]);
+    beforeEach(() => {
+        transport = {
+            send: jest.fn().mockResolvedValue(response),
+            getTraceContext: jest.fn().mockResolvedValue(undefined),
+        };
+    });
+    afterEach(() => {
+        jest.clearAllMocks();
+    });
+    it("should call the send function with correct parameters", () => __awaiter(void 0, void 0, void 0, function* () {
+        const appName = "MyApp";
+        yield (0, getAppStorageInfo_1.getAppStorageInfo)(transport, appName);
+        expect(transport.send).toHaveBeenCalledWith(0xe0, 0x6a, 0x00, 0x00, Buffer.from([0x05, 0x4d, 0x79, 0x41, 0x70, 0x70]), [
+            hw_transport_1.StatusCodes.OK,
+            hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+            hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE,
+            hw_transport_1.StatusCodes.INVALID_APP_NAME_LENGTH,
+        ]);
+    }));
+    describe("parseResponse", () => {
+        it("should parse the response data correctly", () => {
+            const expected = {
+                size: 1234,
+                dataVersion: "1.01",
+                hasSettings: true,
+                hasData: true,
+                hash: "hashhash1234hashhashhashhashhash",
+            };
+            expect((0, getAppStorageInfo_1.parseResponse)(response)).toStrictEqual(expected);
+        });
+        it("should throw TransportStatusError if the response status is invalid", () => {
+            const data = Buffer.from([0x67, 0x0a]);
+            expect(() => (0, getAppStorageInfo_1.parseResponse)(data)).toThrow(new errors_1.InvalidAppNameLength("Invalid application name length, two chars minimum."));
+        });
+    });
+});
+//# sourceMappingURL=getAppStorageInfo.test.js.map

package/lib/commands/use-cases/app-backup/getAppStorageInfo.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAppStorageInfo.test.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/getAppStorageInfo.test.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,yDAAgE;AAChE,2DAAuE;AAEvE,4CAAuD;AAEvD,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAEpC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,SAAoB,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;QAC3B,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;QAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;QAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;KACvE,CAAC,CAAC;IAEH,UAAU,CAAC,GAAG,EAAE;QACd,SAAS,GAAG;YACV,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YAC3C,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;SAChC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAS,EAAE;QACrE,MAAM,OAAO,GAAG,OAAO,CAAC;QACxB,MAAM,IAAA,qCAAiB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACzC,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EACjD;YACE,0BAAW,CAAC,EAAE;YACd,0BAAW,CAAC,gCAAgC;YAC5C,0BAAW,CAAC,uBAAuB;YACnC,0BAAW,CAAC,uBAAuB;SACpC,CACF,CAAC;IACJ,CAAC,CAAA,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,QAAQ,GAAmB;gBAC/B,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,MAAM;gBACnB,WAAW,EAAE,IAAI;gBACjB,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,kCAAkC;aACzC,CAAC;YACF,MAAM,CAAC,IAAA,iCAAa,EAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;YAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,iCAAa,EAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CACvC,IAAI,6BAAoB,CAAC,qDAAqD,CAAC,CAChF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/commands/use-cases/app-backup/restoreAppStorage.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+import Transport from "@ledgerhq/hw-transport";
+/**
+ * Restores the application storage.
+ *
+ * @param transport - The transport object used for communication with the device.
+ * @param chunk - The chunk of data to restore.
+ * @returns A promise that resolves to void.
+ */
+export declare function restoreAppStorage(transport: Transport, chunk: Buffer): Promise<void>;
+export declare function parseResponse(data: Buffer): void;
+//# sourceMappingURL=restoreAppStorage.d.ts.map

package/lib/commands/use-cases/app-backup/restoreAppStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorage.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorage.ts"],"names":[],"mappings":";AAAA,OAAO,SAAgD,MAAM,wBAAwB,CAAC;AA2CtF;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2BhD"}

package/lib/commands/use-cases/app-backup/restoreAppStorage.js

@@ -0,0 +1,93 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseResponse = exports.restoreAppStorage = void 0;
+const hw_transport_1 = require("@ledgerhq/hw-transport");
+const logs_1 = require("@ledgerhq/logs");
+const errors_1 = require("../../../errors");
+/**
+ * Name in documentation: INS_APP_STORAGE_GET_INFO
+ * cla: 0xe0
+ * ins: 0x6d
+ * p1: 0x00
+ * p2: 0x00
+ * data: CHUNK_LEN + CHUNK to configure at runtime
+ */
+const RESTORE_APP_STORAGE = [0xe0, 0x6d, 0x00, 0x00];
+/**
+ * 0x9000: Success.
+ * 0x5123: Invalid context, Restore Init must be called first.
+ * 0x5419: Failed to generate AES key.
+ * 0x541A: Failed to decrypt the app storage backup.
+ * 0x662F: Invalid device state, recovery mode.
+ * 0x6643: Invalid restore state, restore already performed.
+ * 0x6734: Invalid CHUNK_LEN.
+ * 0x684A: Invalid backup, app storage header is not valid.
+ */
+const RESPONSE_STATUS_SET = [
+    hw_transport_1.StatusCodes.OK,
+    hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT,
+    hw_transport_1.StatusCodes.GEN_AES_KEY_FAILED,
+    hw_transport_1.StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED,
+    hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE,
+    hw_transport_1.StatusCodes.INVALID_RESTORE_STATE,
+    hw_transport_1.StatusCodes.INVALID_CHUNK_LENGTH,
+    hw_transport_1.StatusCodes.INVALID_BACKUP_HEADER,
+];
+/**
+ * Restores the application storage.
+ *
+ * @param transport - The transport object used for communication with the device.
+ * @param chunk - The chunk of data to restore.
+ * @returns A promise that resolves to void.
+ */
+function restoreAppStorage(transport, chunk) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const tracer = new logs_1.LocalTracer("hw", {
+            transport: transport.getTraceContext(),
+            function: "restoreAppStorage",
+        });
+        tracer.trace("Start");
+        const params = Buffer.concat([Buffer.from([chunk.length]), chunk]);
+        const apdu = [...RESTORE_APP_STORAGE, params];
+        const response = yield transport.send(...apdu, RESPONSE_STATUS_SET);
+        parseResponse(response);
+    });
+}
+exports.restoreAppStorage = restoreAppStorage;
+function parseResponse(data) {
+    const tracer = new logs_1.LocalTracer("hw", {
+        function: "parseResponse@restoreAppStorage",
+    });
+    const status = data.readUInt16BE(data.length - 2);
+    tracer.trace("Result status from 0xe06d0000", { status });
+    switch (status) {
+        case hw_transport_1.StatusCodes.OK:
+            return;
+        case hw_transport_1.StatusCodes.APP_NOT_FOUND_OR_INVALID_CONTEXT:
+            throw new errors_1.InvalidContext("Invalid context, restoreAppStorageInit must be called first.");
+        case hw_transport_1.StatusCodes.GEN_AES_KEY_FAILED:
+            throw new errors_1.GenerateAesKeyFailed("Failed to generate AES key.");
+        case hw_transport_1.StatusCodes.INTERNAL_CRYPTO_OPERATION_FAILED:
+            throw new errors_1.InternalCryptoOperationFailed("Failed to decrypt the app storage backup.");
+        case hw_transport_1.StatusCodes.DEVICE_IN_RECOVERY_MODE:
+            break;
+        case hw_transport_1.StatusCodes.INVALID_RESTORE_STATE:
+            throw new errors_1.InvalidRestoreState("Invalid restore state, restore already performed.");
+        case hw_transport_1.StatusCodes.INVALID_CHUNK_LENGTH:
+            throw new errors_1.InvalidChunkLength("Invalid chunk length.");
+        case hw_transport_1.StatusCodes.INVALID_BACKUP_HEADER:
+            throw new errors_1.InvalidBackupHeader("Invalid backup, app storage header is not valid.");
+    }
+    throw new hw_transport_1.TransportStatusError(status);
+}
+exports.parseResponse = parseResponse;
+//# sourceMappingURL=restoreAppStorage.js.map

package/lib/commands/use-cases/app-backup/restoreAppStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorage.js","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorage.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAsF;AACtF,yCAA6C;AAE7C,4CAOyB;AAEzB;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAa;IACpC,0BAAW,CAAC,EAAE;IACd,0BAAW,CAAC,gCAAgC;IAC5C,0BAAW,CAAC,kBAAkB;IAC9B,0BAAW,CAAC,gCAAgC;IAC5C,0BAAW,CAAC,uBAAuB;IACnC,0BAAW,CAAC,qBAAqB;IACjC,0BAAW,CAAC,oBAAoB;IAChC,0BAAW,CAAC,qBAAqB;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,SAAsB,iBAAiB,CAAC,SAAoB,EAAE,KAAa;;QACzE,MAAM,MAAM,GAAG,IAAI,kBAAW,CAAC,IAAI,EAAE;YACnC,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE;YACtC,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACnE,MAAM,IAAI,GAAmB,CAAC,GAAG,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAE9D,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAEpE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;CAAA;AAbD,8CAaC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,IAAI,kBAAW,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,iCAAiC;KAC5C,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,0BAAW,CAAC,EAAE;YACjB,OAAO;QACT,KAAK,0BAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,uBAAc,CAAC,8DAA8D,CAAC,CAAC;QAC3F,KAAK,0BAAW,CAAC,kBAAkB;YACjC,MAAM,IAAI,6BAAoB,CAAC,6BAA6B,CAAC,CAAC;QAChE,KAAK,0BAAW,CAAC,gCAAgC;YAC/C,MAAM,IAAI,sCAA6B,CAAC,2CAA2C,CAAC,CAAC;QACvF,KAAK,0BAAW,CAAC,uBAAuB;YACtC,MAAM;QACR,KAAK,0BAAW,CAAC,qBAAqB;YACpC,MAAM,IAAI,4BAAmB,CAAC,mDAAmD,CAAC,CAAC;QACrF,KAAK,0BAAW,CAAC,oBAAoB;YACnC,MAAM,IAAI,2BAAkB,CAAC,uBAAuB,CAAC,CAAC;QACxD,KAAK,0BAAW,CAAC,qBAAqB;YACpC,MAAM,IAAI,4BAAmB,CAAC,kDAAkD,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,IAAI,mCAAoB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AA3BD,sCA2BC"}

package/lib/commands/use-cases/app-backup/restoreAppStorage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=restoreAppStorage.test.d.ts.map

package/lib/commands/use-cases/app-backup/restoreAppStorage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreAppStorage.test.d.ts","sourceRoot":"","sources":["../../../../src/commands/use-cases/app-backup/restoreAppStorage.test.ts"],"names":[],"mappings":""}