@onekeyfe/hd-core 0.1.0 → 0.1.1

package/dist/api/CheckBLEFirmwareRelease.d.ts

@@ -1,6 +1,13 @@
 import { BaseMethod } from './BaseMethod';
 export default class CheckBLEFirmwareRelease extends BaseMethod {
     init(): void;
-    run(): Promise<"valid" | "outdated" | "required" | "unknown" | "none"> | Promise<null>;
+    run(): Promise<null> | Promise<{
+        status: import("..").IDeviceBLEFirmwareStatus;
+        changelog: {
+            "zh-CN": string;
+            "en-US": string;
+        }[];
+        release: import("..").IBLEFirmwareReleaseInfo;
+    }>;
 }
 //# sourceMappingURL=CheckBLEFirmwareRelease.d.ts.map

package/dist/api/CheckBLEFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckBLEFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,UAAU;IAC7D,IAAI;IAIJ,GAAG;CAOJ"}
+{"version":3,"file":"CheckBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckBLEFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,UAAU;IAC7D,IAAI;IAIJ,GAAG;;;;;;;;CAaJ"}

package/dist/api/CheckFirmwareRelease.d.ts

@@ -1,6 +1,13 @@
 import { BaseMethod } from './BaseMethod';
 export default class CheckFirmwareRelease extends BaseMethod {
     init(): void;
-    run(): Promise<"valid" | "outdated" | "required" | "unknown" | "none"> | Promise<null>;
+    run(): Promise<{
+        status: import("..").IDeviceFirmwareStatus;
+        changelog: {
+            "zh-CN": string;
+            "en-US": string;
+        }[];
+        release: import("..").IFirmwareReleaseInfo;
+    }> | Promise<null>;
 }
 //# sourceMappingURL=CheckFirmwareRelease.d.ts.map

package/dist/api/CheckFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,UAAU;IAC1D,IAAI;IAEJ,GAAG;CAOJ"}
+{"version":3,"file":"CheckFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,UAAU;IAC1D,IAAI;IAEJ,GAAG;;;;;;;;CAaJ"}

package/dist/data-manager/DataManager.d.ts

@@ -7,7 +7,17 @@ export default class DataManager {
         default: JSON;
     };
     static getFirmwareStatus: (features: Features) => IDeviceFirmwareStatus;
+    static getFirmwareChangelog: (features: Features) => {
+        "zh-CN": string;
+        "en-US": string;
+    }[];
+    static getFirmwareLeatestRelease: (features: Features) => import("../types").IFirmwareReleaseInfo;
     static getBLEFirmwareStatus: (features: Features) => IDeviceBLEFirmwareStatus;
+    static getBleFirmwareChangelog: (features: Features) => {
+        "zh-CN": string;
+        "en-US": string;
+    }[];
+    static getBleFirmwareLeatestRelease: (features: Features) => import("../types").IBLEFirmwareReleaseInfo;
     static getTransportStatus: (localVersion: string) => ITransportStatus;
     static load(settings: ConnectSettings): Promise<void>;
     static getProtobufMessages(): JSON;

package/dist/data-manager/DataManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataManager.d.ts","sourceRoot":"","sources":["../../src/data-manager/DataManager.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,SAAS,EAET,QAAQ,EACR,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,MAAM,CAAC,SAAS,EAAE,aAAa,CAiB7B;IAEF,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEvC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC;IAEjC,MAAM,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAEhC;IAEF,MAAM,CAAC,iBAAiB,aAAc,QAAQ,KAAG,qBAAqB,CA2BpE;IAEF,MAAM,CAAC,oBAAoB,aAAc,QAAQ,KAAG,wBAAwB,CAyB1E;IAEF,MAAM,CAAC,kBAAkB,iBAAkB,MAAM,KAAG,gBAAgB,CAKlE;WAEW,IAAI,CAAC,QAAQ,EAAE,eAAe;IAoB3C,MAAM,CAAC,mBAAmB;IAI1B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,eAAe;IAEpD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;CAShF"}
+{"version":3,"file":"DataManager.d.ts","sourceRoot":"","sources":["../../src/data-manager/DataManager.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,SAAS,EAET,QAAQ,EACR,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,MAAM,CAAC,OAAO,OAAO,WAAW;IAC9B,MAAM,CAAC,SAAS,EAAE,aAAa,CAiB7B;IAEF,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAEvC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC;IAEjC,MAAM,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAEhC;IAEF,MAAM,CAAC,iBAAiB,aAAc,QAAQ,KAAG,qBAAqB,CAcpE;IAEF,MAAM,CAAC,oBAAoB,aAAc,QAAQ;;;QAc/C;IAEF,MAAM,CAAC,yBAAyB,aAAc,QAAQ,6CAIpD;IAEF,MAAM,CAAC,oBAAoB,aAAc,QAAQ,KAAG,wBAAwB,CAY1E;IAEF,MAAM,CAAC,uBAAuB,aAAc,QAAQ;;;QAWlD;IAEF,MAAM,CAAC,4BAA4B,aAAc,QAAQ,gDAIvD;IAEF,MAAM,CAAC,kBAAkB,iBAAkB,MAAM,KAAG,gBAAgB,CAKlE;WAEW,IAAI,CAAC,QAAQ,EAAE,eAAe;IAoB3C,MAAM,CAAC,mBAAmB;IAI1B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,eAAe;IAEpD,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;CAShF"}

package/dist/index.d.ts

@@ -213,11 +213,27 @@ declare function searchDevices(): Response<SearchDevice[]>;
 
 declare function getFeatures(connectId?: string): Response<Features>;
 
-declare function checkFirmwareRelease(connectId?: string): Response<IDeviceFirmwareStatus>;
+declare type FirmwareRelease$1 = {
+    status: IDeviceFirmwareStatus;
+    changelog: {
+        'en-US': string;
+        'zh-CN': string;
+    }[];
+    release: IFirmwareReleaseInfo;
+};
+declare function checkFirmwareRelease(connectId?: string): Response<FirmwareRelease$1>;
 
 declare function init$1(settings: Partial<ConnectSettings>): Promise<boolean>;
 
-declare function checkBLEFirmwareRelease(connectId?: string): Response<IDeviceFirmwareStatus>;
+declare type BleFirmwareRelease = {
+    status: IDeviceBLEFirmwareStatus;
+    changelog: {
+        'zh-CN': string;
+        'en-US': string;
+    }[];
+    release: IBLEFirmwareReleaseInfo;
+};
+declare function checkBLEFirmwareRelease(connectId?: string): Response<BleFirmwareRelease>;
 
 interface FirmwareRange {
     '1': {
@@ -1350,7 +1366,17 @@ declare class DataManager {
         default: JSON;
     };
     static getFirmwareStatus: (features: Features) => IDeviceFirmwareStatus;
+    static getFirmwareChangelog: (features: Features) => {
+        "zh-CN": string;
+        "en-US": string;
+    }[];
+    static getFirmwareLeatestRelease: (features: Features) => IFirmwareReleaseInfo;
     static getBLEFirmwareStatus: (features: Features) => IDeviceBLEFirmwareStatus;
+    static getBleFirmwareChangelog: (features: Features) => {
+        "zh-CN": string;
+        "en-US": string;
+    }[];
+    static getBleFirmwareLeatestRelease: (features: Features) => IBLEFirmwareReleaseInfo;
     static getTransportStatus: (localVersion: string) => ITransportStatus;
     static load(settings: ConnectSettings): Promise<void>;
     static getProtobufMessages(): JSON;

package/dist/index.js

@@ -9754,6 +9754,21 @@ var MessagesJSON = {
 	nested: nested
 };
 
+const getReleaseStatus = (releases, currentVersion) => {
+    const newVersions = releases.filter(r => semver__default["default"].gt(r.version.join('.'), currentVersion));
+    if (newVersions.length === 0) {
+        return 'valid';
+    }
+    if (newVersions.some(r => r.required)) {
+        return 'required';
+    }
+    return 'outdated';
+};
+const getReleaseChangelog = (releases, currentVersion) => {
+    const newVersions = releases.filter(r => semver__default["default"].gt(r.version.join('.'), currentVersion));
+    return newVersions.map(r => r.changelog);
+};
+
 var _a;
 class DataManager {
     static load(settings) {
@@ -9821,17 +9836,26 @@ DataManager.getFirmwareStatus = (features) => {
         return 'unknown';
     }
     const targetDeviceConfigList = (_c = (_b = _a.deviceMap[deviceType]) === null || _b === void 0 ? void 0 : _b.firmware) !== null && _c !== void 0 ? _c : [];
-    const latestFirmware = targetDeviceConfigList[targetDeviceConfigList.length - 1];
-    if (!latestFirmware)
-        return 'valid';
-    const latestVersion = latestFirmware.version.join('.');
     const currentVersion = deviceFirmwareVersion.join('.');
-    if (semver__default["default"].gt(latestVersion, currentVersion)) {
-        if (latestFirmware.required)
-            return 'required';
-        return 'outdated';
+    return getReleaseStatus(targetDeviceConfigList, currentVersion);
+};
+DataManager.getFirmwareChangelog = (features) => {
+    var _b, _c;
+    const deviceType = getDeviceType(features);
+    const deviceFirmwareVersion = getDeviceFirmwareVersion(features);
+    if (features.firmware_present === false ||
+        (deviceType === 'classic' && features.bootloader_mode)) {
+        return [];
     }
-    return 'valid';
+    const targetDeviceConfigList = (_c = (_b = _a.deviceMap[deviceType]) === null || _b === void 0 ? void 0 : _b.firmware) !== null && _c !== void 0 ? _c : [];
+    const currentVersion = deviceFirmwareVersion.join('.');
+    return getReleaseChangelog(targetDeviceConfigList, currentVersion);
+};
+DataManager.getFirmwareLeatestRelease = (features) => {
+    var _b, _c;
+    const deviceType = getDeviceType(features);
+    const targetDeviceConfigList = (_c = (_b = _a.deviceMap[deviceType]) === null || _b === void 0 ? void 0 : _b.firmware) !== null && _c !== void 0 ? _c : [];
+    return targetDeviceConfigList[targetDeviceConfigList.length - 1];
 };
 DataManager.getBLEFirmwareStatus = (features) => {
     var _b, _c;
@@ -9841,17 +9865,25 @@ DataManager.getBLEFirmwareStatus = (features) => {
         return 'none';
     }
     const targetDeviceConfigList = (_c = (_b = _a.deviceMap[deviceType]) === null || _b === void 0 ? void 0 : _b.ble) !== null && _c !== void 0 ? _c : [];
-    const latestBLEFirmware = targetDeviceConfigList[targetDeviceConfigList.length - 1];
-    if (!latestBLEFirmware)
-        return 'valid';
-    const latestVersion = latestBLEFirmware.version.join('.');
     const currentVersion = deviceBLEFirmwareVersion.join('.');
-    if (semver__default["default"].gt(latestVersion, currentVersion)) {
-        if (latestBLEFirmware.required)
-            return 'required';
-        return 'outdated';
+    return getReleaseStatus(targetDeviceConfigList, currentVersion);
+};
+DataManager.getBleFirmwareChangelog = (features) => {
+    var _b, _c;
+    const deviceType = getDeviceType(features);
+    const deviceBLEFirmwareVersion = getDeviceBLEFirmwareVersion(features);
+    if (!deviceBLEFirmwareVersion) {
+        return [];
     }
-    return 'valid';
+    const targetDeviceConfigList = (_c = (_b = _a.deviceMap[deviceType]) === null || _b === void 0 ? void 0 : _b.ble) !== null && _c !== void 0 ? _c : [];
+    const currentVersion = deviceBLEFirmwareVersion.join('.');
+    return getReleaseChangelog(targetDeviceConfigList, currentVersion);
+};
+DataManager.getBleFirmwareLeatestRelease = (features) => {
+    var _b, _c;
+    const deviceType = getDeviceType(features);
+    const targetDeviceConfigList = (_c = (_b = _a.deviceMap[deviceType]) === null || _b === void 0 ? void 0 : _b.ble) !== null && _c !== void 0 ? _c : [];
+    return targetDeviceConfigList[targetDeviceConfigList.length - 1];
 };
 DataManager.getTransportStatus = (localVersion) => {
     var _b, _c;
@@ -11562,7 +11594,13 @@ class CheckFirmwareRelease extends BaseMethod {
     run() {
         if (this.device.features) {
             const firmwareStatus = DataManager.getFirmwareStatus(this.device.features);
-            return Promise.resolve(firmwareStatus);
+            const changelog = DataManager.getFirmwareChangelog(this.device.features);
+            const release = DataManager.getFirmwareLeatestRelease(this.device.features);
+            return Promise.resolve({
+                status: firmwareStatus,
+                changelog,
+                release,
+            });
         }
         return Promise.resolve(null);
     }
@@ -11575,7 +11613,13 @@ class CheckBLEFirmwareRelease extends BaseMethod {
     run() {
         if (this.device.features) {
             const firmwareStatus = DataManager.getBLEFirmwareStatus(this.device.features);
-            return Promise.resolve(firmwareStatus);
+            const changelog = DataManager.getBleFirmwareChangelog(this.device.features);
+            const release = DataManager.getBleFirmwareLeatestRelease(this.device.features);
+            return Promise.resolve({
+                status: firmwareStatus,
+                changelog,
+                release,
+            });
         }
         return Promise.resolve(null);
     }

package/dist/types/api/checkBLEFirmwareRelease.d.ts

@@ -1,4 +1,14 @@
 import type { Response } from '../params';
-import type { IDeviceFirmwareStatus } from '../device';
-export declare function checkBLEFirmwareRelease(connectId?: string): Response<IDeviceFirmwareStatus>;
+import type { IDeviceBLEFirmwareStatus } from '../device';
+import { IBLEFirmwareReleaseInfo } from '../settings';
+declare type BleFirmwareRelease = {
+    status: IDeviceBLEFirmwareStatus;
+    changelog: {
+        'zh-CN': string;
+        'en-US': string;
+    }[];
+    release: IBLEFirmwareReleaseInfo;
+};
+export declare function checkBLEFirmwareRelease(connectId?: string): Response<BleFirmwareRelease>;
+export {};
 //# sourceMappingURL=checkBLEFirmwareRelease.d.ts.map

package/dist/types/api/checkBLEFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkBLEFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAAC,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"checkBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkBLEFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,aAAK,kBAAkB,GAAG;IACxB,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IACJ,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/types/api/checkFirmwareRelease.d.ts

@@ -1,4 +1,14 @@
 import type { Response } from '../params';
 import type { IDeviceFirmwareStatus } from '../device';
-export declare function checkFirmwareRelease(connectId?: string): Response<IDeviceFirmwareStatus>;
+import { IFirmwareReleaseInfo } from '../settings';
+declare type FirmwareRelease = {
+    status: IDeviceFirmwareStatus;
+    changelog: {
+        'en-US': string;
+        'zh-CN': string;
+    }[];
+    release: IFirmwareReleaseInfo;
+};
+export declare function checkFirmwareRelease(connectId?: string): Response<FirmwareRelease>;
+export {};
 //# sourceMappingURL=checkFirmwareRelease.d.ts.map

package/dist/types/api/checkFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"checkFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,aAAK,eAAe,GAAG;IACrB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,EAAE,CAAC;IACJ,OAAO,EAAE,oBAAoB,CAAC;CAC/B,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC"}

package/dist/utils/release.d.ts

@@ -0,0 +1,4 @@
+import { IBLEFirmwareReleaseInfo, IDeviceFirmwareStatus, IFirmwareReleaseInfo } from '../types';
+export declare const getReleaseStatus: (releases: (IFirmwareReleaseInfo | IBLEFirmwareReleaseInfo)[], currentVersion: string) => IDeviceFirmwareStatus;
+export declare const getReleaseChangelog: (releases: (IFirmwareReleaseInfo | IBLEFirmwareReleaseInfo)[], currentVersion: string) => IFirmwareReleaseInfo['changelog'][];
+//# sourceMappingURL=release.d.ts.map

package/dist/utils/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/utils/release.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhG,eAAO,MAAM,gBAAgB,aACjB,CAAC,oBAAoB,GAAG,uBAAuB,CAAC,EAAE,kBAC5C,MAAM,KACrB,qBASF,CAAC;AAEF,eAAO,MAAM,mBAAmB,aACpB,CAAC,oBAAoB,GAAG,uBAAuB,CAAC,EAAE,kBAC5C,MAAM,KACrB,oBAAoB,CAAC,WAAW,CAAC,EAGnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "> TODO: description",
   "author": "OneKey",
   "homepage": "https://github.com/OneKeyHQ/hardware-js-sdk#readme",
@@ -25,7 +25,7 @@
     "url": "https://github.com/OneKeyHQ/hardware-js-sdk/issues"
   },
   "dependencies": {
-    "@onekeyfe/hd-transport": "^0.1.0",
+    "@onekeyfe/hd-transport": "^0.1.1",
     "axios": "^0.27.2",
     "bignumber.js": "^9.0.2",
     "parse-uri": "^1.0.7",
@@ -35,5 +35,5 @@
     "@types/parse-uri": "^1.0.0",
     "@types/semver": "^7.3.9"
   },
-  "gitHead": "d50dc424865150391b7249d1010ee75dc2074a7e"
+  "gitHead": "006c48af97498aad26719d9839979ecc2c55aea6"
 }

package/src/api/CheckBLEFirmwareRelease.ts

@@ -11,7 +11,13 @@ export default class CheckBLEFirmwareRelease extends BaseMethod {
   run() {
     if (this.device.features) {
       const firmwareStatus = DataManager.getBLEFirmwareStatus(this.device.features);
-      return Promise.resolve(firmwareStatus);
+      const changelog = DataManager.getBleFirmwareChangelog(this.device.features);
+      const release = DataManager.getBleFirmwareLeatestRelease(this.device.features);
+      return Promise.resolve({
+        status: firmwareStatus,
+        changelog,
+        release,
+      });
     }
     return Promise.resolve(null);
   }

package/src/api/CheckFirmwareRelease.ts

@@ -8,7 +8,13 @@ export default class CheckFirmwareRelease extends BaseMethod {
   run() {
     if (this.device.features) {
       const firmwareStatus = DataManager.getFirmwareStatus(this.device.features);
-      return Promise.resolve(firmwareStatus);
+      const changelog = DataManager.getFirmwareChangelog(this.device.features);
+      const release = DataManager.getFirmwareLeatestRelease(this.device.features);
+      return Promise.resolve({
+        status: firmwareStatus,
+        changelog,
+        release,
+      });
     }
     return Promise.resolve(null);
   }

package/src/data-manager/DataManager.ts

@@ -18,6 +18,7 @@ import type {
   IDeviceBLEFirmwareStatus,
   ITransportStatus,
 } from '../types';
+import { getReleaseChangelog, getReleaseStatus } from '../utils/release';
 
 export default class DataManager {
   static deviceMap: DeviceTypeMap = {
@@ -59,21 +60,30 @@ export default class DataManager {
     }
 
     const targetDeviceConfigList = this.deviceMap[deviceType]?.firmware ?? [];
-    const latestFirmware = targetDeviceConfigList[targetDeviceConfigList.length - 1];
-
-    if (!latestFirmware) return 'valid';
-
-    const latestVersion = latestFirmware.version.join('.');
     const currentVersion = deviceFirmwareVersion.join('.');
+    return getReleaseStatus(targetDeviceConfigList, currentVersion);
+  };
 
-    /** latest is greater or equal current */
-    if (semver.gt(latestVersion, currentVersion)) {
-      if (latestFirmware.required) return 'required';
+  static getFirmwareChangelog = (features: Features) => {
+    const deviceType = getDeviceType(features);
+    const deviceFirmwareVersion = getDeviceFirmwareVersion(features);
 
-      return 'outdated';
+    if (
+      features.firmware_present === false ||
+      (deviceType === 'classic' && features.bootloader_mode)
+    ) {
+      return [];
     }
 
-    return 'valid';
+    const targetDeviceConfigList = this.deviceMap[deviceType]?.firmware ?? [];
+    const currentVersion = deviceFirmwareVersion.join('.');
+    return getReleaseChangelog(targetDeviceConfigList, currentVersion);
+  };
+
+  static getFirmwareLeatestRelease = (features: Features) => {
+    const deviceType = getDeviceType(features);
+    const targetDeviceConfigList = this.deviceMap[deviceType]?.firmware ?? [];
+    return targetDeviceConfigList[targetDeviceConfigList.length - 1];
   };
 
   static getBLEFirmwareStatus = (features: Features): IDeviceBLEFirmwareStatus => {
@@ -86,21 +96,27 @@ export default class DataManager {
     }
 
     const targetDeviceConfigList = this.deviceMap[deviceType]?.ble ?? [];
-    const latestBLEFirmware = targetDeviceConfigList[targetDeviceConfigList.length - 1];
-
-    if (!latestBLEFirmware) return 'valid';
-
-    const latestVersion = latestBLEFirmware.version.join('.');
     const currentVersion = deviceBLEFirmwareVersion.join('.');
+    return getReleaseStatus(targetDeviceConfigList, currentVersion);
+  };
 
-    /** latest is greater or equal current */
-    if (semver.gt(latestVersion, currentVersion)) {
-      if (latestBLEFirmware.required) return 'required';
+  static getBleFirmwareChangelog = (features: Features) => {
+    const deviceType = getDeviceType(features);
+    const deviceBLEFirmwareVersion = getDeviceBLEFirmwareVersion(features);
 
-      return 'outdated';
+    if (!deviceBLEFirmwareVersion) {
+      return [];
     }
 
-    return 'valid';
+    const targetDeviceConfigList = this.deviceMap[deviceType]?.ble ?? [];
+    const currentVersion = deviceBLEFirmwareVersion.join('.');
+    return getReleaseChangelog(targetDeviceConfigList, currentVersion);
+  };
+
+  static getBleFirmwareLeatestRelease = (features: Features) => {
+    const deviceType = getDeviceType(features);
+    const targetDeviceConfigList = this.deviceMap[deviceType]?.ble ?? [];
+    return targetDeviceConfigList[targetDeviceConfigList.length - 1];
   };
 
   static getTransportStatus = (localVersion: string): ITransportStatus => {

package/src/types/api/checkBLEFirmwareRelease.ts

@@ -1,6 +1,14 @@
 import type { Response } from '../params';
-import type { IDeviceFirmwareStatus } from '../device';
+import type { IDeviceBLEFirmwareStatus } from '../device';
+import { IBLEFirmwareReleaseInfo } from '../settings';
 
-export declare function checkBLEFirmwareRelease(
-  connectId?: string
-): Response<IDeviceFirmwareStatus>;
+type BleFirmwareRelease = {
+  status: IDeviceBLEFirmwareStatus;
+  changelog: {
+    'zh-CN': string;
+    'en-US': string;
+  }[];
+  release: IBLEFirmwareReleaseInfo;
+};
+
+export declare function checkBLEFirmwareRelease(connectId?: string): Response<BleFirmwareRelease>;

package/src/types/api/checkFirmwareRelease.ts

@@ -1,4 +1,14 @@
 import type { Response } from '../params';
 import type { IDeviceFirmwareStatus } from '../device';
+import { IFirmwareReleaseInfo } from '../settings';
 
-export declare function checkFirmwareRelease(connectId?: string): Response<IDeviceFirmwareStatus>;
+type FirmwareRelease = {
+  status: IDeviceFirmwareStatus;
+  changelog: {
+    'en-US': string;
+    'zh-CN': string;
+  }[];
+  release: IFirmwareReleaseInfo;
+};
+
+export declare function checkFirmwareRelease(connectId?: string): Response<FirmwareRelease>;

package/src/utils/release.ts

@@ -0,0 +1,24 @@
+import semver from 'semver';
+import { IBLEFirmwareReleaseInfo, IDeviceFirmwareStatus, IFirmwareReleaseInfo } from '../types';
+
+export const getReleaseStatus = (
+  releases: (IFirmwareReleaseInfo | IBLEFirmwareReleaseInfo)[],
+  currentVersion: string
+): IDeviceFirmwareStatus => {
+  const newVersions = releases.filter(r => semver.gt(r.version.join('.'), currentVersion));
+  if (newVersions.length === 0) {
+    return 'valid';
+  }
+  if (newVersions.some(r => r.required)) {
+    return 'required';
+  }
+  return 'outdated';
+};
+
+export const getReleaseChangelog = (
+  releases: (IFirmwareReleaseInfo | IBLEFirmwareReleaseInfo)[],
+  currentVersion: string
+): IFirmwareReleaseInfo['changelog'][] => {
+  const newVersions = releases.filter(r => semver.gt(r.version.join('.'), currentVersion));
+  return newVersions.map(r => r.changelog);
+};