@ledgerhq/device-core 0.1.1-nightly.1 → 0.1.1-nightly.3

package/.turbo/turbo-build.log

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

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @ledgerhq/device-core
 
+## 0.1.1-nightly.3
+
+### Patch Changes
+
+- [#6662](https://github.com/LedgerHQ/ledger-live/pull/6662) [`1bc09ce`](https://github.com/LedgerHQ/ledger-live/commit/1bc09ce84d1d579a253d0239747ad969e9613b52) Thanks [@ofreyssinet-ledger](https://github.com/ofreyssinet-ledger)! - feat(earlysecuritychecks): make stax update from <=1.3.0 unskippable
+
+## 0.1.1-nightly.2
+
+### Patch Changes
+
+- Updated dependencies [[`33c4239`](https://github.com/LedgerHQ/ledger-live/commit/33c42392386e5e8ebf9f3251ccf1ade3af11644d)]:
+  - @ledgerhq/types-live@6.46.0-nightly.1
+
 ## 0.1.1-nightly.1
 
 ### Patch Changes

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.d.ts

@@ -0,0 +1,15 @@
+import { DeviceModelId } from "@ledgerhq/devices";
+/**
+ * Returns whether we should enforce a firmware update if there is one available.
+ *
+ * For example this is used for the Stax device as some of the first devices
+ * shipped have a firmware version that is deprecated (1.3.0).
+ *
+ * @param currentVersion - The current firmware version.
+ * @param deviceModelId - The device model id.
+ */
+export declare function shouldForceFirmwareUpdate({ currentVersion, deviceModelId, }: {
+    currentVersion: string;
+    deviceModelId: DeviceModelId;
+}): boolean;
+//# sourceMappingURL=shouldForceFirmwareUpdate.d.ts.map

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldForceFirmwareUpdate.d.ts","sourceRoot":"","sources":["../../src/firmwareUpdate/shouldForceFirmwareUpdate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAYlD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,cAAc,EACd,aAAa,GACd,EAAE;IACD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,OAAO,CAKV"}

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldForceFirmwareUpdate = void 0;
+const semver_1 = __importDefault(require("semver"));
+const noVersionCondition = "<0.0.0"; // this version is never satisfied
+const forceUpdateConditions = {
+    nanoX: noVersionCondition,
+    nanoS: noVersionCondition,
+    nanoSP: noVersionCondition,
+    blue: noVersionCondition,
+    europa: noVersionCondition,
+    stax: "<=1.3.0",
+};
+/**
+ * Returns whether we should enforce a firmware update if there is one available.
+ *
+ * For example this is used for the Stax device as some of the first devices
+ * shipped have a firmware version that is deprecated (1.3.0).
+ *
+ * @param currentVersion - The current firmware version.
+ * @param deviceModelId - The device model id.
+ */
+function shouldForceFirmwareUpdate({ currentVersion, deviceModelId, }) {
+    var _a;
+    return semver_1.default.satisfies((_a = semver_1.default.coerce(currentVersion)) !== null && _a !== void 0 ? _a : "", forceUpdateConditions[deviceModelId]);
+}
+exports.shouldForceFirmwareUpdate = shouldForceFirmwareUpdate;
+//# sourceMappingURL=shouldForceFirmwareUpdate.js.map

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldForceFirmwareUpdate.js","sourceRoot":"","sources":["../../src/firmwareUpdate/shouldForceFirmwareUpdate.ts"],"names":[],"mappings":";;;;;;AAAA,oDAA4B;AAG5B,MAAM,kBAAkB,GAAG,QAAQ,CAAC,CAAC,kCAAkC;AACvE,MAAM,qBAAqB,GAAkC;IAC3D,KAAK,EAAE,kBAAkB;IACzB,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,yBAAyB,CAAC,EACxC,cAAc,EACd,aAAa,GAId;;IACC,OAAO,gBAAM,CAAC,SAAS,CACrB,MAAA,gBAAM,CAAC,MAAM,CAAC,cAAc,CAAC,mCAAI,EAAE,EACnC,qBAAqB,CAAC,aAAa,CAAC,CACrC,CAAC;AACJ,CAAC;AAXD,8DAWC"}

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.test.d.ts

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

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.test.d.ts.map

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

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.test.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const devices_1 = require("@ledgerhq/devices");
+const shouldForceFirmwareUpdate_1 = require("./shouldForceFirmwareUpdate");
+describe("shouldForceFirmwareUpdate", () => {
+    it("should force firmware update for stax <=1.3.0 and not other versions", () => {
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({ currentVersion: "1.2.0", deviceModelId: devices_1.DeviceModelId.stax })).toBe(true);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({
+            currentVersion: "1.2.0-whatever",
+            deviceModelId: devices_1.DeviceModelId.stax,
+        })).toBe(true);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({ currentVersion: "1.3.0", deviceModelId: devices_1.DeviceModelId.stax })).toBe(true);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({
+            currentVersion: "1.3.0-whatever",
+            deviceModelId: devices_1.DeviceModelId.stax,
+        })).toBe(true);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({ currentVersion: "1.3.1", deviceModelId: devices_1.DeviceModelId.stax })).toBe(false);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({
+            currentVersion: "1.3.1-whatever",
+            deviceModelId: devices_1.DeviceModelId.stax,
+        })).toBe(false);
+    });
+    it("should not force firmware update for other models", () => {
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({ currentVersion: "1.2.0", deviceModelId: devices_1.DeviceModelId.nanoX })).toBe(false);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({
+            currentVersion: "1.2.0-whatever",
+            deviceModelId: devices_1.DeviceModelId.nanoX,
+        })).toBe(false);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({ currentVersion: "1.3.0", deviceModelId: devices_1.DeviceModelId.nanoX })).toBe(false);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({
+            currentVersion: "1.3.0-whatever",
+            deviceModelId: devices_1.DeviceModelId.nanoX,
+        })).toBe(false);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({ currentVersion: "1.3.1", deviceModelId: devices_1.DeviceModelId.nanoX })).toBe(false);
+        expect((0, shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate)({
+            currentVersion: "1.3.1-whatever",
+            deviceModelId: devices_1.DeviceModelId.nanoX,
+        })).toBe(false);
+    });
+});
+//# sourceMappingURL=shouldForceFirmwareUpdate.test.js.map

package/lib/firmwareUpdate/shouldForceFirmwareUpdate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldForceFirmwareUpdate.test.js","sourceRoot":"","sources":["../../src/firmwareUpdate/shouldForceFirmwareUpdate.test.ts"],"names":[],"mappings":";;AAAA,+CAAkD;AAClD,2EAAwE;AAExE,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,CACJ,IAAA,qDAAyB,EAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,uBAAa,CAAC,IAAI,EAAE,CAAC,CAC1F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,IAAA,qDAAyB,EAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,uBAAa,CAAC,IAAI;SAClC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,IAAA,qDAAyB,EAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,uBAAa,CAAC,IAAI,EAAE,CAAC,CAC1F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,IAAA,qDAAyB,EAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,uBAAa,CAAC,IAAI;SAClC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,IAAA,qDAAyB,EAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,uBAAa,CAAC,IAAI,EAAE,CAAC,CAC1F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,IAAA,qDAAyB,EAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,uBAAa,CAAC,IAAI;SAClC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CACJ,IAAA,qDAAyB,EAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,uBAAa,CAAC,KAAK,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,IAAA,qDAAyB,EAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,uBAAa,CAAC,KAAK;SACnC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,IAAA,qDAAyB,EAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,uBAAa,CAAC,KAAK,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,IAAA,qDAAyB,EAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,uBAAa,CAAC,KAAK;SACnC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,IAAA,qDAAyB,EAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,uBAAa,CAAC,KAAK,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,IAAA,qDAAyB,EAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,uBAAa,CAAC,KAAK;SACnC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/index.d.ts

@@ -20,4 +20,5 @@ export { isEditDeviceNameSupported } from "./capabilities/isEditDeviceNameSuppor
 export { isSyncOnboardingSupported } from "./capabilities/isSyncOnboardingSupported";
 export { supportedDeviceModelIds } from "./capabilities/isCustomLockScreenSupported";
 export * from "./customLockScreen/screenSpecs";
+export { shouldForceFirmwareUpdate } from "./firmwareUpdate/shouldForceFirmwareUpdate";
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,WAAW,EACX,2BAA2B,GAC5B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,KAAK,yBAAyB,EAC9B,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,WAAW,EACX,2BAA2B,GAC5B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,KAAK,yBAAyB,EAC9B,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}

package/lib/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.supportedDeviceModelIds = exports.isSyncOnboardingSupported = exports.isEditDeviceNameSupported = exports.isCustomLockScreenSupported = exports.getVersion = exports.isBootloaderVersionSupported = exports.isHardwareVersionSupported = exports.getDeviceName = exports.parseGetVersionResponse = exports.GET_VERSION_APDU = exports.aDeviceInfoBuilder = exports.fetchMcus = exports.getProviderIdUseCase = exports.PROVIDERS = exports.isDeviceLocalizationSupported = exports.getLatestFirmwareForDevice = exports.StubManagerApiRepository = exports.HttpManagerApiRepository = void 0;
+exports.shouldForceFirmwareUpdate = exports.supportedDeviceModelIds = exports.isSyncOnboardingSupported = exports.isEditDeviceNameSupported = exports.isCustomLockScreenSupported = exports.getVersion = exports.isBootloaderVersionSupported = exports.isHardwareVersionSupported = exports.getDeviceName = exports.parseGetVersionResponse = exports.GET_VERSION_APDU = exports.aDeviceInfoBuilder = exports.fetchMcus = exports.getProviderIdUseCase = exports.PROVIDERS = exports.isDeviceLocalizationSupported = exports.getLatestFirmwareForDevice = exports.StubManagerApiRepository = exports.HttpManagerApiRepository = void 0;
 var HttpManagerApiRepository_1 = require("./managerApi/repositories/HttpManagerApiRepository");
 Object.defineProperty(exports, "HttpManagerApiRepository", { enumerable: true, get: function () { return HttpManagerApiRepository_1.HttpManagerApiRepository; } });
 var StubManagerApiRepository_1 = require("./managerApi/repositories/StubManagerApiRepository");
@@ -53,4 +53,7 @@ var isCustomLockScreenSupported_2 = require("./capabilities/isCustomLockScreenSu
 Object.defineProperty(exports, "supportedDeviceModelIds", { enumerable: true, get: function () { return isCustomLockScreenSupported_2.supportedDeviceModelIds; } });
 // src/customLockScreen/
 __exportStar(require("./customLockScreen/screenSpecs"), exports);
+// src/firmwareUpdate/
+var shouldForceFirmwareUpdate_1 = require("./firmwareUpdate/shouldForceFirmwareUpdate");
+Object.defineProperty(exports, "shouldForceFirmwareUpdate", { enumerable: true, get: function () { return shouldForceFirmwareUpdate_1.shouldForceFirmwareUpdate; } });
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAQA,+FAA8F;AAArF,oIAAA,wBAAwB,OAAA;AACjC,+FAA8F;AAArF,oIAAA,wBAAwB,OAAA;AACjC,gGAA+F;AAAtF,wIAAA,0BAA0B,OAAA;AACnC,oGAAmG;AAA1F,8IAAA,6BAA6B,OAAA;AACtC,oFAA8F;AAArF,iHAAA,SAAS,OAAA;AAAE,4HAAA,oBAAoB,OAAA;AACxC,8DAA6D;AAApD,sGAAA,SAAS,OAAA;AAClB,uEAA6E;AAApE,iHAAA,kBAAkB,OAAA;AAG3B,8DAAmE;AAA1D,8GAAA,gBAAgB,OAAA;AACzB,wFAAuF;AAA9E,kIAAA,uBAAuB,OAAA;AAChC,oEAAmE;AAA1D,8GAAA,aAAa,OAAA;AACtB,8FAA6F;AAApF,wIAAA,0BAA0B,OAAA;AACnC,kGAAiG;AAAxF,4IAAA,4BAA4B,OAAA;AACrC,8DAA6D;AAApD,wGAAA,UAAU,OAAA;AACnB,oBAAoB;AACpB,0FAGoD;AADlD,0IAAA,2BAA2B,OAAA;AAE7B,sFAAqF;AAA5E,sIAAA,yBAAyB,OAAA;AAClC,sFAAqF;AAA5E,sIAAA,yBAAyB,OAAA;AAClC,0FAAqF;AAA5E,sIAAA,uBAAuB,OAAA;AAChC,wBAAwB;AACxB,iEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAQA,+FAA8F;AAArF,oIAAA,wBAAwB,OAAA;AACjC,+FAA8F;AAArF,oIAAA,wBAAwB,OAAA;AACjC,gGAA+F;AAAtF,wIAAA,0BAA0B,OAAA;AACnC,oGAAmG;AAA1F,8IAAA,6BAA6B,OAAA;AACtC,oFAA8F;AAArF,iHAAA,SAAS,OAAA;AAAE,4HAAA,oBAAoB,OAAA;AACxC,8DAA6D;AAApD,sGAAA,SAAS,OAAA;AAClB,uEAA6E;AAApE,iHAAA,kBAAkB,OAAA;AAG3B,8DAAmE;AAA1D,8GAAA,gBAAgB,OAAA;AACzB,wFAAuF;AAA9E,kIAAA,uBAAuB,OAAA;AAChC,oEAAmE;AAA1D,8GAAA,aAAa,OAAA;AACtB,8FAA6F;AAApF,wIAAA,0BAA0B,OAAA;AACnC,kGAAiG;AAAxF,4IAAA,4BAA4B,OAAA;AACrC,8DAA6D;AAApD,wGAAA,UAAU,OAAA;AACnB,oBAAoB;AACpB,0FAGoD;AADlD,0IAAA,2BAA2B,OAAA;AAE7B,sFAAqF;AAA5E,sIAAA,yBAAyB,OAAA;AAClC,sFAAqF;AAA5E,sIAAA,yBAAyB,OAAA;AAClC,0FAAqF;AAA5E,sIAAA,uBAAuB,OAAA;AAChC,wBAAwB;AACxB,iEAA+C;AAC/C,sBAAsB;AACtB,wFAAuF;AAA9E,sIAAA,yBAAyB,OAAA"}

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.d.ts

@@ -0,0 +1,15 @@
+import { DeviceModelId } from "@ledgerhq/devices";
+/**
+ * Returns whether we should enforce a firmware update if there is one available.
+ *
+ * For example this is used for the Stax device as some of the first devices
+ * shipped have a firmware version that is deprecated (1.3.0).
+ *
+ * @param currentVersion - The current firmware version.
+ * @param deviceModelId - The device model id.
+ */
+export declare function shouldForceFirmwareUpdate({ currentVersion, deviceModelId, }: {
+    currentVersion: string;
+    deviceModelId: DeviceModelId;
+}): boolean;
+//# sourceMappingURL=shouldForceFirmwareUpdate.d.ts.map

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldForceFirmwareUpdate.d.ts","sourceRoot":"","sources":["../../src/firmwareUpdate/shouldForceFirmwareUpdate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAYlD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,EACxC,cAAc,EACd,aAAa,GACd,EAAE;IACD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,OAAO,CAKV"}

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.js

@@ -0,0 +1,24 @@
+import semver from "semver";
+const noVersionCondition = "<0.0.0"; // this version is never satisfied
+const forceUpdateConditions = {
+    nanoX: noVersionCondition,
+    nanoS: noVersionCondition,
+    nanoSP: noVersionCondition,
+    blue: noVersionCondition,
+    europa: noVersionCondition,
+    stax: "<=1.3.0",
+};
+/**
+ * Returns whether we should enforce a firmware update if there is one available.
+ *
+ * For example this is used for the Stax device as some of the first devices
+ * shipped have a firmware version that is deprecated (1.3.0).
+ *
+ * @param currentVersion - The current firmware version.
+ * @param deviceModelId - The device model id.
+ */
+export function shouldForceFirmwareUpdate({ currentVersion, deviceModelId, }) {
+    var _a;
+    return semver.satisfies((_a = semver.coerce(currentVersion)) !== null && _a !== void 0 ? _a : "", forceUpdateConditions[deviceModelId]);
+}
+//# sourceMappingURL=shouldForceFirmwareUpdate.js.map

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldForceFirmwareUpdate.js","sourceRoot":"","sources":["../../src/firmwareUpdate/shouldForceFirmwareUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,kBAAkB,GAAG,QAAQ,CAAC,CAAC,kCAAkC;AACvE,MAAM,qBAAqB,GAAkC;IAC3D,KAAK,EAAE,kBAAkB;IACzB,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,kBAAkB;IAC1B,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,EACxC,cAAc,EACd,aAAa,GAId;;IACC,OAAO,MAAM,CAAC,SAAS,CACrB,MAAA,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,mCAAI,EAAE,EACnC,qBAAqB,CAAC,aAAa,CAAC,CACrC,CAAC;AACJ,CAAC"}

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.test.d.ts

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

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.test.d.ts.map

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

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.test.js

@@ -0,0 +1,39 @@
+import { DeviceModelId } from "@ledgerhq/devices";
+import { shouldForceFirmwareUpdate } from "./shouldForceFirmwareUpdate";
+describe("shouldForceFirmwareUpdate", () => {
+    it("should force firmware update for stax <=1.3.0 and not other versions", () => {
+        expect(shouldForceFirmwareUpdate({ currentVersion: "1.2.0", deviceModelId: DeviceModelId.stax })).toBe(true);
+        expect(shouldForceFirmwareUpdate({
+            currentVersion: "1.2.0-whatever",
+            deviceModelId: DeviceModelId.stax,
+        })).toBe(true);
+        expect(shouldForceFirmwareUpdate({ currentVersion: "1.3.0", deviceModelId: DeviceModelId.stax })).toBe(true);
+        expect(shouldForceFirmwareUpdate({
+            currentVersion: "1.3.0-whatever",
+            deviceModelId: DeviceModelId.stax,
+        })).toBe(true);
+        expect(shouldForceFirmwareUpdate({ currentVersion: "1.3.1", deviceModelId: DeviceModelId.stax })).toBe(false);
+        expect(shouldForceFirmwareUpdate({
+            currentVersion: "1.3.1-whatever",
+            deviceModelId: DeviceModelId.stax,
+        })).toBe(false);
+    });
+    it("should not force firmware update for other models", () => {
+        expect(shouldForceFirmwareUpdate({ currentVersion: "1.2.0", deviceModelId: DeviceModelId.nanoX })).toBe(false);
+        expect(shouldForceFirmwareUpdate({
+            currentVersion: "1.2.0-whatever",
+            deviceModelId: DeviceModelId.nanoX,
+        })).toBe(false);
+        expect(shouldForceFirmwareUpdate({ currentVersion: "1.3.0", deviceModelId: DeviceModelId.nanoX })).toBe(false);
+        expect(shouldForceFirmwareUpdate({
+            currentVersion: "1.3.0-whatever",
+            deviceModelId: DeviceModelId.nanoX,
+        })).toBe(false);
+        expect(shouldForceFirmwareUpdate({ currentVersion: "1.3.1", deviceModelId: DeviceModelId.nanoX })).toBe(false);
+        expect(shouldForceFirmwareUpdate({
+            currentVersion: "1.3.1-whatever",
+            deviceModelId: DeviceModelId.nanoX,
+        })).toBe(false);
+    });
+});
+//# sourceMappingURL=shouldForceFirmwareUpdate.test.js.map

package/lib-es/firmwareUpdate/shouldForceFirmwareUpdate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldForceFirmwareUpdate.test.js","sourceRoot":"","sources":["../../src/firmwareUpdate/shouldForceFirmwareUpdate.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,CACJ,yBAAyB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAC1F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,yBAAyB,CAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,aAAa,CAAC,IAAI;SAClC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,yBAAyB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAC1F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,yBAAyB,CAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,aAAa,CAAC,IAAI;SAClC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CACJ,yBAAyB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAC1F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,yBAAyB,CAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,aAAa,CAAC,IAAI;SAClC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CACJ,yBAAyB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,yBAAyB,CAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,aAAa,CAAC,KAAK;SACnC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,yBAAyB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,yBAAyB,CAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,aAAa,CAAC,KAAK;SACnC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,yBAAyB,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAC3F,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEd,MAAM,CACJ,yBAAyB,CAAC;YACxB,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE,aAAa,CAAC,KAAK;SACnC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib-es/index.d.ts

@@ -20,4 +20,5 @@ export { isEditDeviceNameSupported } from "./capabilities/isEditDeviceNameSuppor
 export { isSyncOnboardingSupported } from "./capabilities/isSyncOnboardingSupported";
 export { supportedDeviceModelIds } from "./capabilities/isCustomLockScreenSupported";
 export * from "./customLockScreen/screenSpecs";
+export { shouldForceFirmwareUpdate } from "./firmwareUpdate/shouldForceFirmwareUpdate";
 //# sourceMappingURL=index.d.ts.map

package/lib-es/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,WAAW,EACX,2BAA2B,GAC5B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,KAAK,yBAAyB,EAC9B,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,YAAY,EACV,aAAa,EACb,WAAW,EACX,2BAA2B,GAC5B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,KAAK,yBAAyB,EAC9B,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}

package/lib-es/index.js

@@ -18,4 +18,6 @@ export { isSyncOnboardingSupported } from "./capabilities/isSyncOnboardingSuppor
 export { supportedDeviceModelIds } from "./capabilities/isCustomLockScreenSupported";
 // src/customLockScreen/
 export * from "./customLockScreen/screenSpecs";
+// src/firmwareUpdate/
+export { shouldForceFirmwareUpdate } from "./firmwareUpdate/shouldForceFirmwareUpdate";
 //# sourceMappingURL=index.js.map

package/lib-es/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,oBAAoB;AACpB,OAAO,EAEL,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,wBAAwB;AACxB,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,oBAAoB;AACpB,OAAO,EAEL,2BAA2B,GAC5B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,wBAAwB;AACxB,cAAc,gCAAgC,CAAC;AAC/C,sBAAsB;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ledgerhq/device-core",
-  "version": "0.1.1-nightly.1",
+  "version": "0.1.1-nightly.3",
   "description": "Ledger Live device core module",
   "license": "Apache-2.0",
   "keywords": [
@@ -25,7 +25,7 @@
     "@ledgerhq/hw-transport": "^6.30.6-nightly.0",
     "@ledgerhq/logs": "^6.12.0",
     "@ledgerhq/devices": "^8.2.3-nightly.0",
-    "@ledgerhq/types-live": "^6.46.0-nightly.0"
+    "@ledgerhq/types-live": "^6.46.0-nightly.1"
   },
   "devDependencies": {
     "@testing-library/react": "14",

package/src/firmwareUpdate/shouldForceFirmwareUpdate.test.ts

@@ -0,0 +1,74 @@
+import { DeviceModelId } from "@ledgerhq/devices";
+import { shouldForceFirmwareUpdate } from "./shouldForceFirmwareUpdate";
+
+describe("shouldForceFirmwareUpdate", () => {
+  it("should force firmware update for stax <=1.3.0 and not other versions", () => {
+    expect(
+      shouldForceFirmwareUpdate({ currentVersion: "1.2.0", deviceModelId: DeviceModelId.stax }),
+    ).toBe(true);
+
+    expect(
+      shouldForceFirmwareUpdate({
+        currentVersion: "1.2.0-whatever",
+        deviceModelId: DeviceModelId.stax,
+      }),
+    ).toBe(true);
+
+    expect(
+      shouldForceFirmwareUpdate({ currentVersion: "1.3.0", deviceModelId: DeviceModelId.stax }),
+    ).toBe(true);
+
+    expect(
+      shouldForceFirmwareUpdate({
+        currentVersion: "1.3.0-whatever",
+        deviceModelId: DeviceModelId.stax,
+      }),
+    ).toBe(true);
+
+    expect(
+      shouldForceFirmwareUpdate({ currentVersion: "1.3.1", deviceModelId: DeviceModelId.stax }),
+    ).toBe(false);
+
+    expect(
+      shouldForceFirmwareUpdate({
+        currentVersion: "1.3.1-whatever",
+        deviceModelId: DeviceModelId.stax,
+      }),
+    ).toBe(false);
+  });
+
+  it("should not force firmware update for other models", () => {
+    expect(
+      shouldForceFirmwareUpdate({ currentVersion: "1.2.0", deviceModelId: DeviceModelId.nanoX }),
+    ).toBe(false);
+
+    expect(
+      shouldForceFirmwareUpdate({
+        currentVersion: "1.2.0-whatever",
+        deviceModelId: DeviceModelId.nanoX,
+      }),
+    ).toBe(false);
+
+    expect(
+      shouldForceFirmwareUpdate({ currentVersion: "1.3.0", deviceModelId: DeviceModelId.nanoX }),
+    ).toBe(false);
+
+    expect(
+      shouldForceFirmwareUpdate({
+        currentVersion: "1.3.0-whatever",
+        deviceModelId: DeviceModelId.nanoX,
+      }),
+    ).toBe(false);
+
+    expect(
+      shouldForceFirmwareUpdate({ currentVersion: "1.3.1", deviceModelId: DeviceModelId.nanoX }),
+    ).toBe(false);
+
+    expect(
+      shouldForceFirmwareUpdate({
+        currentVersion: "1.3.1-whatever",
+        deviceModelId: DeviceModelId.nanoX,
+      }),
+    ).toBe(false);
+  });
+});

package/src/firmwareUpdate/shouldForceFirmwareUpdate.ts

@@ -0,0 +1,34 @@
+import semver from "semver";
+import { DeviceModelId } from "@ledgerhq/devices";
+
+const noVersionCondition = "<0.0.0"; // this version is never satisfied
+const forceUpdateConditions: Record<DeviceModelId, string> = {
+  nanoX: noVersionCondition,
+  nanoS: noVersionCondition,
+  nanoSP: noVersionCondition,
+  blue: noVersionCondition,
+  europa: noVersionCondition,
+  stax: "<=1.3.0",
+};
+
+/**
+ * Returns whether we should enforce a firmware update if there is one available.
+ *
+ * For example this is used for the Stax device as some of the first devices
+ * shipped have a firmware version that is deprecated (1.3.0).
+ *
+ * @param currentVersion - The current firmware version.
+ * @param deviceModelId - The device model id.
+ */
+export function shouldForceFirmwareUpdate({
+  currentVersion,
+  deviceModelId,
+}: {
+  currentVersion: string;
+  deviceModelId: DeviceModelId;
+}): boolean {
+  return semver.satisfies(
+    semver.coerce(currentVersion) ?? "",
+    forceUpdateConditions[deviceModelId],
+  );
+}

package/src/index.ts

@@ -31,3 +31,5 @@ export { isSyncOnboardingSupported } from "./capabilities/isSyncOnboardingSuppor
 export { supportedDeviceModelIds } from "./capabilities/isCustomLockScreenSupported";
 // src/customLockScreen/
 export * from "./customLockScreen/screenSpecs";
+// src/firmwareUpdate/
+export { shouldForceFirmwareUpdate } from "./firmwareUpdate/shouldForceFirmwareUpdate";