@ledgerhq/live-common 27.0.0 → 27.0.1-next.0

package/lib/hw/hooks/useGenuineCheck.d.ts

@@ -0,0 +1,34 @@
+import type { DeviceId } from "@ledgerhq/types-live";
+import type { GetGenuineCheckFromDeviceIdArgs, GetGenuineCheckFromDeviceIdOutput } from "../getGenuineCheckFromDeviceId";
+export declare type GenuineState = "unchecked" | "genuine" | "non-genuine";
+export declare type DevicePermissionState = "unrequested" | "unlock-needed" | "unlocked" | "requested" | "granted" | "refused";
+export declare type UseGenuineCheckArgs = {
+    isHookEnabled?: boolean;
+    deviceId: DeviceId;
+    lockedDeviceTimeoutMs?: number;
+};
+export declare type UseGenuineCheckDependencies = {
+    getGenuineCheckFromDeviceId?: (args: GetGenuineCheckFromDeviceIdArgs) => GetGenuineCheckFromDeviceIdOutput;
+};
+export declare type UseGenuineCheckResult = {
+    genuineState: GenuineState;
+    devicePermissionState: DevicePermissionState;
+    error: Error | null;
+    resetGenuineCheckState: () => void;
+};
+/**
+ * Hook to check that a device is genuine
+ * It replaces a DeviceAction if we're only interested in getting the genuine check
+ * @param getGenuineCheckFromDeviceId An optional function to get a genuine check for a given device id,
+ * by default set to live-common/hw/getGenuineCheckFromDeviceId.
+ * This dependency injection is needed for LLD to have the hook working on the internal thread
+ * @param isHookEnabled A boolean to enable (true, default value) or disable (false) the hook
+ * @param deviceId A device id, or an empty string if device is usb plugged
+ * @param lockedDeviceTimeoutMs Time of no response from device after which the device is considered locked, in ms. Default 1000ms.
+ * @returns An object containing:
+ * - genuineState: the current GenuineState
+ * - devicePermissionState: the current DevicePermissionState
+ * - error: any error that occurred during the genuine check, or null
+ */
+export declare const useGenuineCheck: ({ getGenuineCheckFromDeviceId, isHookEnabled, deviceId, lockedDeviceTimeoutMs, }: UseGenuineCheckArgs & UseGenuineCheckDependencies) => UseGenuineCheckResult;
+//# sourceMappingURL=useGenuineCheck.d.ts.map

package/lib/hw/hooks/useGenuineCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenuineCheck.d.ts","sourceRoot":"","sources":["../../../src/hw/hooks/useGenuineCheck.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EACV,+BAA+B,EAE/B,iCAAiC,EAClC,MAAM,gCAAgC,CAAC;AAExC,oBAAY,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AACnE,oBAAY,qBAAqB,GAC7B,aAAa,GACb,eAAe,GACf,UAAU,GACV,WAAW,GACX,SAAS,GACT,SAAS,CAAC;AAEd,oBAAY,mBAAmB,GAAG;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,oBAAY,2BAA2B,GAAG;IACxC,2BAA2B,CAAC,EAAE,CAC5B,IAAI,EAAE,+BAA+B,KAClC,iCAAiC,CAAC;CACxC,CAAC;AAEF,oBAAY,qBAAqB,GAAG;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC,CAAC;AAIF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,qFAKzB,mBAAmB,GACpB,2BAA2B,KAAG,qBA6E/B,CAAC"}

package/lib/hw/hooks/useGenuineCheck.js

@@ -0,0 +1,115 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+exports.__esModule = true;
+exports.useGenuineCheck = void 0;
+var react_1 = require("react");
+var errors_1 = require("@ledgerhq/errors");
+var getGenuineCheckFromDeviceId_1 = require("../getGenuineCheckFromDeviceId");
+var SOCKET_EVENT_PAYLOAD_GENUINE = "0000";
+/**
+ * Hook to check that a device is genuine
+ * It replaces a DeviceAction if we're only interested in getting the genuine check
+ * @param getGenuineCheckFromDeviceId An optional function to get a genuine check for a given device id,
+ * by default set to live-common/hw/getGenuineCheckFromDeviceId.
+ * This dependency injection is needed for LLD to have the hook working on the internal thread
+ * @param isHookEnabled A boolean to enable (true, default value) or disable (false) the hook
+ * @param deviceId A device id, or an empty string if device is usb plugged
+ * @param lockedDeviceTimeoutMs Time of no response from device after which the device is considered locked, in ms. Default 1000ms.
+ * @returns An object containing:
+ * - genuineState: the current GenuineState
+ * - devicePermissionState: the current DevicePermissionState
+ * - error: any error that occurred during the genuine check, or null
+ */
+var useGenuineCheck = function (_a) {
+    var _b = _a.getGenuineCheckFromDeviceId, getGenuineCheckFromDeviceId = _b === void 0 ? getGenuineCheckFromDeviceId_1.getGenuineCheckFromDeviceId : _b, _c = _a.isHookEnabled, isHookEnabled = _c === void 0 ? true : _c, deviceId = _a.deviceId, _d = _a.lockedDeviceTimeoutMs, lockedDeviceTimeoutMs = _d === void 0 ? 1000 : _d;
+    var _e = __read((0, react_1.useState)("unchecked"), 2), genuineState = _e[0], setGenuineState = _e[1];
+    var _f = __read((0, react_1.useState)("unrequested"), 2), devicePermissionState = _f[0], setDevicePermissionState = _f[1];
+    var _g = __read((0, react_1.useState)(null), 2), error = _g[0], setError = _g[1];
+    var resetGenuineCheckState = (0, react_1.useCallback)(function () {
+        setDevicePermissionState("unrequested");
+        setGenuineState("unchecked");
+    }, []);
+    (0, react_1.useEffect)(function () {
+        if (!isHookEnabled) {
+            return;
+        }
+        var sub = getGenuineCheckFromDeviceId({
+            deviceId: deviceId,
+            lockedDeviceTimeoutMs: lockedDeviceTimeoutMs
+        }).subscribe({
+            next: function (_a) {
+                var socketEvent = _a.socketEvent, deviceIsLocked = _a.deviceIsLocked;
+                if (socketEvent) {
+                    switch (socketEvent.type) {
+                        case "device-permission-requested":
+                            setDevicePermissionState("requested");
+                            break;
+                        case "device-permission-granted":
+                            setDevicePermissionState("granted");
+                            break;
+                        case "result":
+                            if (socketEvent.payload === SOCKET_EVENT_PAYLOAD_GENUINE) {
+                                setGenuineState("genuine");
+                            }
+                            else {
+                                setGenuineState("non-genuine");
+                            }
+                            break;
+                    }
+                }
+                else {
+                    // If no socketEvent, the device is locked or has been unlocked
+                    if (deviceIsLocked) {
+                        setDevicePermissionState("unlock-needed");
+                    }
+                    else {
+                        setDevicePermissionState("unlocked");
+                    }
+                }
+            },
+            error: function (e) {
+                if (e instanceof errors_1.UserRefusedAllowManager) {
+                    setDevicePermissionState("refused");
+                }
+                else if (e instanceof Error) {
+                    // Probably an error of type DisconnectedDeviceDuringOperation or something else
+                    setError(e);
+                }
+                else {
+                    setError(new Error("Unknown error: ".concat(e)));
+                }
+            }
+        });
+        return function () {
+            sub.unsubscribe();
+        };
+    }, [
+        isHookEnabled,
+        deviceId,
+        lockedDeviceTimeoutMs,
+        getGenuineCheckFromDeviceId,
+    ]);
+    return {
+        genuineState: genuineState,
+        devicePermissionState: devicePermissionState,
+        error: error,
+        resetGenuineCheckState: resetGenuineCheckState
+    };
+};
+exports.useGenuineCheck = useGenuineCheck;
+//# sourceMappingURL=useGenuineCheck.js.map

package/lib/hw/hooks/useGenuineCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenuineCheck.js","sourceRoot":"","sources":["../../../src/hw/hooks/useGenuineCheck.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,+BAAyD;AACzD,2CAA2D;AAE3D,8EAAmH;AAmCnH,IAAM,4BAA4B,GAAG,MAAM,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACI,IAAM,eAAe,GAAG,UAAC,EAMH;QAL3B,mCAAgE,EAAhE,2BAA2B,mBAAG,yDAAkC,KAAA,EAChE,qBAAoB,EAApB,aAAa,mBAAG,IAAI,KAAA,EACpB,QAAQ,cAAA,EACR,6BAA4B,EAA5B,qBAAqB,mBAAG,IAAI,KAAA;IAGtB,IAAA,KAAA,OAAkC,IAAA,gBAAQ,EAAe,WAAW,CAAC,IAAA,EAApE,YAAY,QAAA,EAAE,eAAe,QAAuC,CAAC;IACtE,IAAA,KAAA,OACJ,IAAA,gBAAQ,EAAwB,aAAa,CAAC,IAAA,EADzC,qBAAqB,QAAA,EAAE,wBAAwB,QACN,CAAC;IAC3C,IAAA,KAAA,OAAoB,IAAA,gBAAQ,EAAe,IAAI,CAAC,IAAA,EAA/C,KAAK,QAAA,EAAE,QAAQ,QAAgC,CAAC;IAEvD,IAAM,sBAAsB,GAAG,IAAA,mBAAW,EAAC;QACzC,wBAAwB,CAAC,aAAa,CAAC,CAAC;QACxC,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAA,iBAAS,EAAC;QACR,IAAI,CAAC,aAAa,EAAE;YAClB,OAAO;SACR;QAED,IAAM,GAAG,GAAG,2BAA2B,CAAC;YACtC,QAAQ,UAAA;YACR,qBAAqB,uBAAA;SACtB,CAAC,CAAC,SAAS,CAAC;YACX,IAAI,EAAE,UAAC,EAG6B;oBAFlC,WAAW,iBAAA,EACX,cAAc,oBAAA;gBAEd,IAAI,WAAW,EAAE;oBACf,QAAQ,WAAW,CAAC,IAAI,EAAE;wBACxB,KAAK,6BAA6B;4BAChC,wBAAwB,CAAC,WAAW,CAAC,CAAC;4BACtC,MAAM;wBACR,KAAK,2BAA2B;4BAC9B,wBAAwB,CAAC,SAAS,CAAC,CAAC;4BACpC,MAAM;wBACR,KAAK,QAAQ;4BACX,IAAI,WAAW,CAAC,OAAO,KAAK,4BAA4B,EAAE;gCACxD,eAAe,CAAC,SAAS,CAAC,CAAC;6BAC5B;iCAAM;gCACL,eAAe,CAAC,aAAa,CAAC,CAAC;6BAChC;4BACD,MAAM;qBACT;iBACF;qBAAM;oBACL,+DAA+D;oBAC/D,IAAI,cAAc,EAAE;wBAClB,wBAAwB,CAAC,eAAe,CAAC,CAAC;qBAC3C;yBAAM;wBACL,wBAAwB,CAAC,UAAU,CAAC,CAAC;qBACtC;iBACF;YACH,CAAC;YACD,KAAK,EAAE,UAAC,CAAM;gBACZ,IAAI,CAAC,YAAY,gCAAuB,EAAE;oBACxC,wBAAwB,CAAC,SAAS,CAAC,CAAC;iBACrC;qBAAM,IAAI,CAAC,YAAY,KAAK,EAAE;oBAC7B,gFAAgF;oBAChF,QAAQ,CAAC,CAAC,CAAC,CAAC;iBACb;qBAAM;oBACL,QAAQ,CAAC,IAAI,KAAK,CAAC,yBAAkB,CAAC,CAAE,CAAC,CAAC,CAAC;iBAC5C;YACH,CAAC;SACF,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,aAAa;QACb,QAAQ;QACR,qBAAqB;QACrB,2BAA2B;KAC5B,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,cAAA;QACZ,qBAAqB,uBAAA;QACrB,KAAK,OAAA;QACL,sBAAsB,wBAAA;KACvB,CAAC;AACJ,CAAC,CAAC;AAnFW,QAAA,eAAe,mBAmF1B"}

package/lib/hw/hooks/useGenuineCheck.test.d.ts

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

package/lib/hw/hooks/useGenuineCheck.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenuineCheck.test.d.ts","sourceRoot":"","sources":["../../../src/hw/hooks/useGenuineCheck.test.ts"],"names":[],"mappings":""}

package/lib/hw/hooks/useGenuineCheck.test.js

@@ -0,0 +1,316 @@
+"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());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+exports.__esModule = true;
+var react_hooks_1 = require("@testing-library/react-hooks");
+var rxjs_1 = require("rxjs");
+var errors_1 = require("@ledgerhq/errors");
+var useGenuineCheck_1 = require("./useGenuineCheck");
+var getGenuineCheckFromDeviceId_1 = require("../getGenuineCheckFromDeviceId");
+jest.mock("../getGenuineCheckFromDeviceId");
+jest.useFakeTimers();
+var mockedGetGenuineCheckFromDeviceId = jest.mocked(getGenuineCheckFromDeviceId_1.getGenuineCheckFromDeviceId);
+describe("useGenuineCheck", function () {
+    afterEach(function () {
+        mockedGetGenuineCheckFromDeviceId.mockClear();
+        jest.clearAllTimers();
+    });
+    describe("When the genuine check requests for a device permission", function () {
+        it("should notify the hook consumer of the request", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.of)({
+                            socketEvent: { type: "device-permission-requested", wording: "" },
+                            deviceIsLocked: false
+                        }));
+                        result = (0, react_hooks_1.renderHook)(function () {
+                            return (0, useGenuineCheck_1.useGenuineCheck)({
+                                getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                deviceId: "A_DEVICE_ID"
+                            });
+                        }).result;
+                        return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    jest.advanceTimersByTime(1);
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 1:
+                        _a.sent();
+                        expect(result.current.devicePermissionState).toEqual("requested");
+                        expect(result.current.genuineState).toEqual("unchecked");
+                        expect(result.current.error).toBeNull();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        it("should notify the hook consumer if the device permission is granted", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.of)({
+                            socketEvent: { type: "device-permission-granted" },
+                            deviceIsLocked: false
+                        }));
+                        result = (0, react_hooks_1.renderHook)(function () {
+                            return (0, useGenuineCheck_1.useGenuineCheck)({
+                                getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                deviceId: "A_DEVICE_ID"
+                            });
+                        }).result;
+                        return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    jest.advanceTimersByTime(1);
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 1:
+                        _a.sent();
+                        expect(result.current.devicePermissionState).toEqual("granted");
+                        expect(result.current.genuineState).toEqual("unchecked");
+                        expect(result.current.error).toBeNull();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        it("should notify the hook consumer if the device permission is refused", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.throwError)(new errors_1.UserRefusedAllowManager()));
+                        result = (0, react_hooks_1.renderHook)(function () {
+                            return (0, useGenuineCheck_1.useGenuineCheck)({
+                                getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                deviceId: "A_DEVICE_ID"
+                            });
+                        }).result;
+                        return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    jest.advanceTimersByTime(1);
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 1:
+                        _a.sent();
+                        expect(result.current.devicePermissionState).toEqual("refused");
+                        expect(result.current.genuineState).toEqual("unchecked");
+                        expect(result.current.error).toBeNull();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+    });
+    describe("When an error occurred during the genuine check", function () {
+        it("should notify the hook consumer that an error occurred", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.throwError)(new errors_1.DisconnectedDeviceDuringOperation()));
+                        result = (0, react_hooks_1.renderHook)(function () {
+                            return (0, useGenuineCheck_1.useGenuineCheck)({
+                                getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                deviceId: "A_DEVICE_ID"
+                            });
+                        }).result;
+                        return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    jest.advanceTimersByTime(1);
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 1:
+                        _a.sent();
+                        expect(result.current.genuineState).toEqual("unchecked");
+                        expect(result.current.error).toBeInstanceOf(errors_1.DisconnectedDeviceDuringOperation);
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+    });
+    describe("When the genuine check is completed", function () {
+        describe("and it is a success", function () {
+            it("should notify the hook consumer of the success", function () { return __awaiter(void 0, void 0, void 0, function () {
+                var result;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.of)({
+                                socketEvent: { type: "result", payload: "0000" },
+                                deviceIsLocked: false
+                            }));
+                            result = (0, react_hooks_1.renderHook)(function () {
+                                return (0, useGenuineCheck_1.useGenuineCheck)({
+                                    getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                    deviceId: "A_DEVICE_ID"
+                                });
+                            }).result;
+                            return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                    return __generator(this, function (_a) {
+                                        jest.advanceTimersByTime(1);
+                                        return [2 /*return*/];
+                                    });
+                                }); })];
+                        case 1:
+                            _a.sent();
+                            expect(result.current.genuineState).toEqual("genuine");
+                            expect(result.current.error).toBeNull();
+                            return [2 /*return*/];
+                    }
+                });
+            }); });
+        });
+        describe("and the device is not genuine", function () {
+            it("should notify the hook consumer that the device is not genuine", function () { return __awaiter(void 0, void 0, void 0, function () {
+                var result;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.of)({
+                                socketEvent: { type: "result", payload: "1111" },
+                                deviceIsLocked: false
+                            }));
+                            result = (0, react_hooks_1.renderHook)(function () {
+                                return (0, useGenuineCheck_1.useGenuineCheck)({
+                                    getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                    deviceId: "A_DEVICE_ID"
+                                });
+                            }).result;
+                            return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                    return __generator(this, function (_a) {
+                                        jest.advanceTimersByTime(1);
+                                        return [2 /*return*/];
+                                    });
+                                }); })];
+                        case 1:
+                            _a.sent();
+                            expect(result.current.genuineState).toEqual("non-genuine");
+                            expect(result.current.error).toBeNull();
+                            return [2 /*return*/];
+                    }
+                });
+            }); });
+        });
+    });
+    describe("When the hook consumer requests to reset the genuine check state", function () {
+        it("should reset the device permission and genuine states", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        // In the case of an unsuccessful genuine check
+                        mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.of)({
+                            socketEvent: { type: "device-permission-granted" },
+                            deviceIsLocked: false
+                        }, {
+                            socketEvent: { type: "result", payload: "1111" },
+                            deviceIsLocked: false
+                        }));
+                        result = (0, react_hooks_1.renderHook)(function () {
+                            return (0, useGenuineCheck_1.useGenuineCheck)({
+                                getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                isHookEnabled: true,
+                                deviceId: "A_DEVICE_ID"
+                            });
+                        }).result;
+                        return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    jest.advanceTimersByTime(1);
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 1:
+                        _a.sent();
+                        expect(result.current.devicePermissionState).toEqual("granted");
+                        expect(result.current.genuineState).toEqual("non-genuine");
+                        expect(result.current.error).toBeNull();
+                        // We ask to reset the genuine check state
+                        return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    result.current.resetGenuineCheckState();
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 2:
+                        // We ask to reset the genuine check state
+                        _a.sent();
+                        expect(result.current.devicePermissionState).toEqual("unrequested");
+                        expect(result.current.genuineState).toEqual("unchecked");
+                        expect(result.current.error).toBeNull();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+    });
+    describe("When the device is locked before doing a genuine check, and it timed out", function () {
+        it("should notify the hook consumer of the need to unlock the device", function () { return __awaiter(void 0, void 0, void 0, function () {
+            var result;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        mockedGetGenuineCheckFromDeviceId.mockReturnValue((0, rxjs_1.of)({
+                            socketEvent: null,
+                            deviceIsLocked: true
+                        }));
+                        result = (0, react_hooks_1.renderHook)(function () {
+                            return (0, useGenuineCheck_1.useGenuineCheck)({
+                                getGenuineCheckFromDeviceId: mockedGetGenuineCheckFromDeviceId,
+                                deviceId: "A_DEVICE_ID"
+                            });
+                        }).result;
+                        return [4 /*yield*/, (0, react_hooks_1.act)(function () { return __awaiter(void 0, void 0, void 0, function () {
+                                return __generator(this, function (_a) {
+                                    jest.advanceTimersByTime(1);
+                                    return [2 /*return*/];
+                                });
+                            }); })];
+                    case 1:
+                        _a.sent();
+                        expect(result.current.devicePermissionState).toEqual("unlock-needed");
+                        expect(result.current.genuineState).toEqual("unchecked");
+                        expect(result.current.error).toBeNull();
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+    });
+});
+//# sourceMappingURL=useGenuineCheck.test.js.map

package/lib/hw/hooks/useGenuineCheck.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenuineCheck.test.js","sourceRoot":"","sources":["../../../src/hw/hooks/useGenuineCheck.test.ts"],"names":[],"mappings":"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"}

package/lib/hw/hooks/useGetLatestAvailableFirmware.d.ts

@@ -0,0 +1,29 @@
+import type { FirmwareUpdateContext, DeviceId } from "@ledgerhq/types-live";
+import type { GetLatestAvailableFirmwareFromDeviceIdArgs, GetLatestAvailableFirmwareFromDeviceIdOutput } from "../getLatestAvailableFirmwareFromDeviceId";
+export declare type FirmwareUpdateGettingStatus = "unchecked" | "checking" | "no-available-firmware" | "available-firmware";
+export declare type useGetLatestAvailableFirmwareDependencies = {
+    getLatestAvailableFirmwareFromDeviceId?: (args: GetLatestAvailableFirmwareFromDeviceIdArgs) => GetLatestAvailableFirmwareFromDeviceIdOutput;
+};
+export declare type useGetLatestAvailableFirmwareArgs = {
+    isHookEnabled?: boolean;
+    deviceId: DeviceId;
+};
+export declare type useGetLatestAvailableFirmwareResult = {
+    latestFirmware: FirmwareUpdateContext | null;
+    status: FirmwareUpdateGettingStatus;
+    error: Error | null;
+};
+/**
+ * Hook to get the latest available firmware for a device
+ * @param getLatestAvailableFirmwareFromDeviceId An optional function to get the latest available firmware
+ * for a given device id, by default set to live-common/hw/getLatestAvailableFirmwareFromDeviceId.
+ * This dependency injection is needed for LLD to have the hook working on the internal thread
+ * @param isHookEnabled A boolean to enable (true, default value) or disable (false) the hook
+ * @param deviceId A device id, or an empty string if device is usb plugged
+ * @returns An object containing:
+ * - latestFirmware A FirmwareUpdateContext if found, or null if still processing or no available firmware update
+ * - status A FirmwareUpdateGettingStatus to notify consumer on the hook state
+ * - error: any error that occurred during the process, or null
+ */
+export declare const useGetLatestAvailableFirmware: ({ getLatestAvailableFirmwareFromDeviceId, isHookEnabled, deviceId, }: useGetLatestAvailableFirmwareArgs & useGetLatestAvailableFirmwareDependencies) => useGetLatestAvailableFirmwareResult;
+//# sourceMappingURL=useGetLatestAvailableFirmware.d.ts.map

package/lib/hw/hooks/useGetLatestAvailableFirmware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetLatestAvailableFirmware.d.ts","sourceRoot":"","sources":["../../../src/hw/hooks/useGetLatestAvailableFirmware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,KAAK,EACV,0CAA0C,EAE1C,4CAA4C,EAC7C,MAAM,2CAA2C,CAAC;AAGnD,oBAAY,2BAA2B,GACnC,WAAW,GACX,UAAU,GACV,uBAAuB,GACvB,oBAAoB,CAAC;AAEzB,oBAAY,yCAAyC,GAAG;IACtD,sCAAsC,CAAC,EAAE,CACvC,IAAI,EAAE,0CAA0C,KAC7C,4CAA4C,CAAC;CACnD,CAAC;AAEF,oBAAY,iCAAiC,GAAG;IAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,oBAAY,mCAAmC,GAAG;IAChD,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,MAAM,EAAE,2BAA2B,CAAC;IACpC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,6BAA6B,yEAIvC,iCAAiC,GAClC,yCAAyC,KAAG,mCAwC7C,CAAC"}

package/lib/hw/hooks/useGetLatestAvailableFirmware.js

@@ -0,0 +1,72 @@
+"use strict";
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+exports.__esModule = true;
+exports.useGetLatestAvailableFirmware = void 0;
+var react_1 = require("react");
+var getLatestAvailableFirmwareFromDeviceId_1 = require("../getLatestAvailableFirmwareFromDeviceId");
+/**
+ * Hook to get the latest available firmware for a device
+ * @param getLatestAvailableFirmwareFromDeviceId An optional function to get the latest available firmware
+ * for a given device id, by default set to live-common/hw/getLatestAvailableFirmwareFromDeviceId.
+ * This dependency injection is needed for LLD to have the hook working on the internal thread
+ * @param isHookEnabled A boolean to enable (true, default value) or disable (false) the hook
+ * @param deviceId A device id, or an empty string if device is usb plugged
+ * @returns An object containing:
+ * - latestFirmware A FirmwareUpdateContext if found, or null if still processing or no available firmware update
+ * - status A FirmwareUpdateGettingStatus to notify consumer on the hook state
+ * - error: any error that occurred during the process, or null
+ */
+var useGetLatestAvailableFirmware = function (_a) {
+    var _b = _a.getLatestAvailableFirmwareFromDeviceId, getLatestAvailableFirmwareFromDeviceId = _b === void 0 ? getLatestAvailableFirmwareFromDeviceId_1.getLatestAvailableFirmwareFromDeviceId : _b, _c = _a.isHookEnabled, isHookEnabled = _c === void 0 ? true : _c, deviceId = _a.deviceId;
+    var _d = __read((0, react_1.useState)(null), 2), latestFirmware = _d[0], setLatestFirmware = _d[1];
+    var _e = __read((0, react_1.useState)(null), 2), error = _e[0], setError = _e[1];
+    var _f = __read((0, react_1.useState)("unchecked"), 2), status = _f[0], setStatus = _f[1];
+    (0, react_1.useEffect)(function () {
+        if (!isHookEnabled) {
+            return;
+        }
+        setStatus("checking");
+        var sub = getLatestAvailableFirmwareFromDeviceId({ deviceId: deviceId }).subscribe({
+            next: function (_a) {
+                var firmwareUpdateContext = _a.firmwareUpdateContext;
+                if (!firmwareUpdateContext) {
+                    setLatestFirmware(null);
+                    setStatus("no-available-firmware");
+                }
+                else {
+                    setLatestFirmware(firmwareUpdateContext);
+                    setStatus("available-firmware");
+                }
+            },
+            error: function (e) {
+                if (e instanceof Error) {
+                    setError(e);
+                }
+                else {
+                    setError(new Error("Unknown error: ".concat(e)));
+                }
+            }
+        });
+        return function () {
+            sub.unsubscribe();
+        };
+    }, [deviceId, getLatestAvailableFirmwareFromDeviceId, isHookEnabled]);
+    return { latestFirmware: latestFirmware, error: error, status: status };
+};
+exports.useGetLatestAvailableFirmware = useGetLatestAvailableFirmware;
+//# sourceMappingURL=useGetLatestAvailableFirmware.js.map

package/lib/hw/hooks/useGetLatestAvailableFirmware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetLatestAvailableFirmware.js","sourceRoot":"","sources":["../../../src/hw/hooks/useGetLatestAvailableFirmware.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,+BAA4C;AAO5C,oGAAoJ;AAyBpJ;;;;;;;;;;;GAWG;AACI,IAAM,6BAA6B,GAAG,UAAC,EAKH;QAJzC,8CAAsF,EAAtF,sCAAsC,mBAAG,+EAA6C,KAAA,EACtF,qBAAoB,EAApB,aAAa,mBAAG,IAAI,KAAA,EACpB,QAAQ,cAAA;IAGF,IAAA,KAAA,OACJ,IAAA,gBAAQ,EAA+B,IAAI,CAAC,IAAA,EADvC,cAAc,QAAA,EAAE,iBAAiB,QACM,CAAC;IACzC,IAAA,KAAA,OAAoB,IAAA,gBAAQ,EAAe,IAAI,CAAC,IAAA,EAA/C,KAAK,QAAA,EAAE,QAAQ,QAAgC,CAAC;IACjD,IAAA,KAAA,OACJ,IAAA,gBAAQ,EAA8B,WAAW,CAAC,IAAA,EAD7C,MAAM,QAAA,EAAE,SAAS,QAC4B,CAAC;IAErD,IAAA,iBAAS,EAAC;QACR,IAAI,CAAC,aAAa,EAAE;YAClB,OAAO;SACR;QACD,SAAS,CAAC,UAAU,CAAC,CAAC;QAEtB,IAAM,GAAG,GAAG,sCAAsC,CAAC,EAAE,QAAQ,UAAA,EAAE,CAAC,CAAC,SAAS,CAAC;YACzE,IAAI,EAAE,UAAC,EAEwC;oBAD7C,qBAAqB,2BAAA;gBAErB,IAAI,CAAC,qBAAqB,EAAE;oBAC1B,iBAAiB,CAAC,IAAI,CAAC,CAAC;oBACxB,SAAS,CAAC,uBAAuB,CAAC,CAAC;iBACpC;qBAAM;oBACL,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;oBACzC,SAAS,CAAC,oBAAoB,CAAC,CAAC;iBACjC;YACH,CAAC;YACD,KAAK,EAAE,UAAC,CAAM;gBACZ,IAAI,CAAC,YAAY,KAAK,EAAE;oBACtB,QAAQ,CAAC,CAAC,CAAC,CAAC;iBACb;qBAAM;oBACL,QAAQ,CAAC,IAAI,KAAK,CAAC,yBAAkB,CAAC,CAAE,CAAC,CAAC,CAAC;iBAC5C;YACH,CAAC;SACF,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,sCAAsC,EAAE,aAAa,CAAC,CAAC,CAAC;IAEtE,OAAO,EAAE,cAAc,gBAAA,EAAE,KAAK,OAAA,EAAE,MAAM,QAAA,EAAE,CAAC;AAC3C,CAAC,CAAC;AA7CW,QAAA,6BAA6B,iCA6CxC"}

package/lib/hw/hooks/useGetLatestAvailableFirmware.test.d.ts

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

package/lib/hw/hooks/useGetLatestAvailableFirmware.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGetLatestAvailableFirmware.test.d.ts","sourceRoot":"","sources":["../../../src/hw/hooks/useGetLatestAvailableFirmware.test.ts"],"names":[],"mappings":""}