@onekeyfe/react-native-range-downloader 3.0.81 → 3.0.82

package/nitrogen/generated/shared/c++/RangeDownloadParams.hpp

@@ -2,7 +2,7 @@
 /// RangeDownloadParams.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2026 Marc Rousavy @ Margelo
+/// Copyright © Marc Rousavy @ Margelo
 ///
 
 #pragma once
@@ -22,6 +22,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `DownloadChannel` to properly resolve imports.
 namespace margelo::nitro::reactnativerangedownloader { enum class DownloadChannel; }
@@ -35,7 +40,7 @@ namespace margelo::nitro::reactnativerangedownloader {
   /**
    * A struct which can be represented as a JavaScript object (RangeDownloadParams).
    */
-  struct RangeDownloadParams {
+  struct RangeDownloadParams final {
   public:
     DownloadChannel channel     SWIFT_PRIVATE;
     std::string taskId     SWIFT_PRIVATE;
@@ -52,6 +57,9 @@ namespace margelo::nitro::reactnativerangedownloader {
   public:
     RangeDownloadParams() = default;
     explicit RangeDownloadParams(DownloadChannel channel, std::string taskId, std::string url, std::string destFilePath, std::optional<std::string> expectedSha256, std::optional<double> segmentCount, std::optional<double> minConcurrentBytes, std::optional<double> maxSegmentAttempts, std::optional<double> requestTimeoutSeconds, std::optional<double> stallTimeoutSeconds, std::optional<double> overallDeadlineSeconds): channel(channel), taskId(taskId), url(url), destFilePath(destFilePath), expectedSha256(expectedSha256), segmentCount(segmentCount), minConcurrentBytes(minConcurrentBytes), maxSegmentAttempts(maxSegmentAttempts), requestTimeoutSeconds(requestTimeoutSeconds), stallTimeoutSeconds(stallTimeoutSeconds), overallDeadlineSeconds(overallDeadlineSeconds) {}
+
+  public:
+    friend bool operator==(const RangeDownloadParams& lhs, const RangeDownloadParams& rhs) = default;
   };
 
 } // namespace margelo::nitro::reactnativerangedownloader
@@ -64,32 +72,32 @@ namespace margelo::nitro {
     static inline margelo::nitro::reactnativerangedownloader::RangeDownloadParams fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::reactnativerangedownloader::RangeDownloadParams(
-        JSIConverter<margelo::nitro::reactnativerangedownloader::DownloadChannel>::fromJSI(runtime, obj.getProperty(runtime, "channel")),
-        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "taskId")),
-        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "url")),
-        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "destFilePath")),
-        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "expectedSha256")),
-        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "segmentCount")),
-        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "minConcurrentBytes")),
-        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "maxSegmentAttempts")),
-        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "requestTimeoutSeconds")),
-        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "stallTimeoutSeconds")),
-        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, "overallDeadlineSeconds"))
+        JSIConverter<margelo::nitro::reactnativerangedownloader::DownloadChannel>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "channel"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "taskId"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "url"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "destFilePath"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "expectedSha256"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "segmentCount"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "minConcurrentBytes"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "maxSegmentAttempts"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "requestTimeoutSeconds"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "stallTimeoutSeconds"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "overallDeadlineSeconds")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::reactnativerangedownloader::RangeDownloadParams& arg) {
       jsi::Object obj(runtime);
-      obj.setProperty(runtime, "channel", JSIConverter<margelo::nitro::reactnativerangedownloader::DownloadChannel>::toJSI(runtime, arg.channel));
-      obj.setProperty(runtime, "taskId", JSIConverter<std::string>::toJSI(runtime, arg.taskId));
-      obj.setProperty(runtime, "url", JSIConverter<std::string>::toJSI(runtime, arg.url));
-      obj.setProperty(runtime, "destFilePath", JSIConverter<std::string>::toJSI(runtime, arg.destFilePath));
-      obj.setProperty(runtime, "expectedSha256", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.expectedSha256));
-      obj.setProperty(runtime, "segmentCount", JSIConverter<std::optional<double>>::toJSI(runtime, arg.segmentCount));
-      obj.setProperty(runtime, "minConcurrentBytes", JSIConverter<std::optional<double>>::toJSI(runtime, arg.minConcurrentBytes));
-      obj.setProperty(runtime, "maxSegmentAttempts", JSIConverter<std::optional<double>>::toJSI(runtime, arg.maxSegmentAttempts));
-      obj.setProperty(runtime, "requestTimeoutSeconds", JSIConverter<std::optional<double>>::toJSI(runtime, arg.requestTimeoutSeconds));
-      obj.setProperty(runtime, "stallTimeoutSeconds", JSIConverter<std::optional<double>>::toJSI(runtime, arg.stallTimeoutSeconds));
-      obj.setProperty(runtime, "overallDeadlineSeconds", JSIConverter<std::optional<double>>::toJSI(runtime, arg.overallDeadlineSeconds));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "channel"), JSIConverter<margelo::nitro::reactnativerangedownloader::DownloadChannel>::toJSI(runtime, arg.channel));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "taskId"), JSIConverter<std::string>::toJSI(runtime, arg.taskId));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "url"), JSIConverter<std::string>::toJSI(runtime, arg.url));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "destFilePath"), JSIConverter<std::string>::toJSI(runtime, arg.destFilePath));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "expectedSha256"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.expectedSha256));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "segmentCount"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.segmentCount));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "minConcurrentBytes"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.minConcurrentBytes));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "maxSegmentAttempts"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.maxSegmentAttempts));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "requestTimeoutSeconds"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.requestTimeoutSeconds));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "stallTimeoutSeconds"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.stallTimeoutSeconds));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "overallDeadlineSeconds"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.overallDeadlineSeconds));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -100,17 +108,17 @@ namespace margelo::nitro {
       if (!nitro::isPlainObject(runtime, obj)) {
         return false;
       }
-      if (!JSIConverter<margelo::nitro::reactnativerangedownloader::DownloadChannel>::canConvert(runtime, obj.getProperty(runtime, "channel"))) return false;
-      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "taskId"))) return false;
-      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "url"))) return false;
-      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "destFilePath"))) return false;
-      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "expectedSha256"))) return false;
-      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "segmentCount"))) return false;
-      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "minConcurrentBytes"))) return false;
-      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "maxSegmentAttempts"))) return false;
-      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "requestTimeoutSeconds"))) return false;
-      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "stallTimeoutSeconds"))) return false;
-      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, "overallDeadlineSeconds"))) return false;
+      if (!JSIConverter<margelo::nitro::reactnativerangedownloader::DownloadChannel>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "channel")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "taskId")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "url")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "destFilePath")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "expectedSha256")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "segmentCount")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "minConcurrentBytes")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "maxSegmentAttempts")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "requestTimeoutSeconds")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "stallTimeoutSeconds")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "overallDeadlineSeconds")))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/RangeDownloadResult.hpp

@@ -2,7 +2,7 @@
 /// RangeDownloadResult.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2026 Marc Rousavy @ Margelo
+/// Copyright © Marc Rousavy @ Margelo
 ///
 
 #pragma once
@@ -22,6 +22,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `RangeDownloadOutcome` to properly resolve imports.
 namespace margelo::nitro::reactnativerangedownloader { enum class RangeDownloadOutcome; }
@@ -38,7 +43,7 @@ namespace margelo::nitro::reactnativerangedownloader {
   /**
    * A struct which can be represented as a JavaScript object (RangeDownloadResult).
    */
-  struct RangeDownloadResult {
+  struct RangeDownloadResult final {
   public:
     RangeDownloadOutcome outcome     SWIFT_PRIVATE;
     std::string filePath     SWIFT_PRIVATE;
@@ -48,6 +53,9 @@ namespace margelo::nitro::reactnativerangedownloader {
   public:
     RangeDownloadResult() = default;
     explicit RangeDownloadResult(RangeDownloadOutcome outcome, std::string filePath, std::optional<std::string> fallbackReason, std::optional<RangeFallbackKind> fallbackKind): outcome(outcome), filePath(filePath), fallbackReason(fallbackReason), fallbackKind(fallbackKind) {}
+
+  public:
+    friend bool operator==(const RangeDownloadResult& lhs, const RangeDownloadResult& rhs) = default;
   };
 
 } // namespace margelo::nitro::reactnativerangedownloader
@@ -60,18 +68,18 @@ namespace margelo::nitro {
     static inline margelo::nitro::reactnativerangedownloader::RangeDownloadResult fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
       return margelo::nitro::reactnativerangedownloader::RangeDownloadResult(
-        JSIConverter<margelo::nitro::reactnativerangedownloader::RangeDownloadOutcome>::fromJSI(runtime, obj.getProperty(runtime, "outcome")),
-        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, "filePath")),
-        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, "fallbackReason")),
-        JSIConverter<std::optional<margelo::nitro::reactnativerangedownloader::RangeFallbackKind>>::fromJSI(runtime, obj.getProperty(runtime, "fallbackKind"))
+        JSIConverter<margelo::nitro::reactnativerangedownloader::RangeDownloadOutcome>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "outcome"))),
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "filePath"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "fallbackReason"))),
+        JSIConverter<std::optional<margelo::nitro::reactnativerangedownloader::RangeFallbackKind>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "fallbackKind")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::reactnativerangedownloader::RangeDownloadResult& arg) {
       jsi::Object obj(runtime);
-      obj.setProperty(runtime, "outcome", JSIConverter<margelo::nitro::reactnativerangedownloader::RangeDownloadOutcome>::toJSI(runtime, arg.outcome));
-      obj.setProperty(runtime, "filePath", JSIConverter<std::string>::toJSI(runtime, arg.filePath));
-      obj.setProperty(runtime, "fallbackReason", JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.fallbackReason));
-      obj.setProperty(runtime, "fallbackKind", JSIConverter<std::optional<margelo::nitro::reactnativerangedownloader::RangeFallbackKind>>::toJSI(runtime, arg.fallbackKind));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "outcome"), JSIConverter<margelo::nitro::reactnativerangedownloader::RangeDownloadOutcome>::toJSI(runtime, arg.outcome));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "filePath"), JSIConverter<std::string>::toJSI(runtime, arg.filePath));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "fallbackReason"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.fallbackReason));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "fallbackKind"), JSIConverter<std::optional<margelo::nitro::reactnativerangedownloader::RangeFallbackKind>>::toJSI(runtime, arg.fallbackKind));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -82,10 +90,10 @@ namespace margelo::nitro {
       if (!nitro::isPlainObject(runtime, obj)) {
         return false;
       }
-      if (!JSIConverter<margelo::nitro::reactnativerangedownloader::RangeDownloadOutcome>::canConvert(runtime, obj.getProperty(runtime, "outcome"))) return false;
-      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "filePath"))) return false;
-      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "fallbackReason"))) return false;
-      if (!JSIConverter<std::optional<margelo::nitro::reactnativerangedownloader::RangeFallbackKind>>::canConvert(runtime, obj.getProperty(runtime, "fallbackKind"))) return false;
+      if (!JSIConverter<margelo::nitro::reactnativerangedownloader::RangeDownloadOutcome>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "outcome")))) return false;
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "filePath")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "fallbackReason")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::reactnativerangedownloader::RangeFallbackKind>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "fallbackKind")))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/RangeFallbackKind.hpp

@@ -2,7 +2,7 @@
 /// RangeFallbackKind.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
-/// Copyright © 2026 Marc Rousavy @ Margelo
+/// Copyright © Marc Rousavy @ Margelo
 ///
 
 #pragma once

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-range-downloader",
-  "version": "3.0.81",
+  "version": "3.0.82",
   "description": "react-native-range-downloader",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -77,12 +77,12 @@
     "eslint-plugin-prettier": "^5.5.4",
     "jest": "^29.7.0",
     "lefthook": "^2.0.3",
-    "nitrogen": "0.31.10",
+    "nitrogen": "0.35.2",
     "prettier": "^2.8.8",
     "react": "19.2.0",
     "react-native": "patch:react-native@npm%3A0.83.0#~/.yarn/patches/react-native-npm-0.83.0-577d0f2d83.patch",
     "react-native-builder-bob": "^0.40.13",
-    "react-native-nitro-modules": "0.33.2",
+    "react-native-nitro-modules": "0.35.2",
     "release-it": "^19.0.4",
     "turbo": "^2.5.6",
     "typescript": "^5.9.2"
@@ -90,7 +90,7 @@
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "0.33.2"
+    "react-native-nitro-modules": "0.35.2"
   },
   "react-native-builder-bob": {
     "source": "src",

package/src/ReactNativeRangeDownloader.nitro.ts

@@ -4,7 +4,7 @@ import type { HybridObject } from 'react-native-nitro-modules';
 // The channel decides the iOS background URLSession identifier suffix and the
 // event-routing key, so different consumers never cross-talk. Closed set per
 // design decision 10.1 (constant enum, not a bare string).
-export type DownloadChannel = 'bundle' | 'apk' | 'chart';
+export type DownloadChannel = 'bundle' | 'apk' | 'chart' | 'firmware';
 
 export interface RangeDownloadParams {
   channel: DownloadChannel;
@@ -68,6 +68,104 @@ export interface RangeDownloadEvent {
   message: string;
 }
 
+export interface FirmwareArtifactDownloadParams {
+  taskId: string;
+  transactionId: string;
+  leaseRef: string;
+  artifactId: string;
+  url: string;
+  routeType: string;
+  resolvedIp?: string;
+  expectedSize?: number;
+  expectedSha256?: string;
+  maxBytes: number;
+  overallDeadlineSeconds?: number; // defaults to 180; must be > 0 and <= 24 hours
+}
+
+export interface FirmwareArtifactReceipt {
+  artifactRef: string;
+  size: number;
+  sha256: string;
+  // True only when sha256 was compared with expectedSha256 supplied by the caller.
+  // A locally computed content-address digest without that expectation is not trusted integrity.
+  expectedSha256Verified: boolean;
+}
+
+export interface FirmwareArtifactCapabilities {
+  firmwareArtifactProtocolVersion: number;
+  supportedRouteTypes: string[];
+  supportsArchiveMaterialization: boolean;
+  maxReadBytes: number;
+}
+
+export interface FirmwareArtifactRefParams {
+  artifactRef: string;
+}
+
+export interface FirmwareArtifactCancelParams {
+  transactionId: string;
+}
+
+export interface FirmwareArtifactReaderInfo {
+  readerId: string;
+  size: number;
+}
+
+export interface FirmwareArtifactReaderReadParams {
+  readerId: string;
+  offset: number;
+  length: number;
+}
+
+export interface FirmwareArtifactReaderCloseParams {
+  readerId: string;
+}
+
+export interface FirmwareArchiveMaterializeParams {
+  leaseRef: string;
+  archiveArtifactRef: string;
+  expectedEntries?: FirmwareArchiveExpectedEntry[];
+}
+
+export interface FirmwareArchiveExpectedEntry {
+  artifactId: string;
+  entryName: string;
+  expectedSize: number;
+  expectedSha256: string;
+}
+
+export interface FirmwareArchiveMaterializedArtifact {
+  entryName: string;
+  receipt: FirmwareArtifactReceipt;
+}
+
+export interface FirmwareArchiveMaterializeResult {
+  artifacts: FirmwareArchiveMaterializedArtifact[];
+}
+
+export interface FirmwareArtifactLeaseCreateParams {
+  transactionId: string;
+}
+
+export interface FirmwareArtifactLease {
+  leaseRef: string;
+}
+
+export interface FirmwareArtifactLeaseRetainParams {
+  leaseRef: string;
+  artifactRef: string;
+}
+
+export interface FirmwareArtifactLeaseReleaseParams {
+  leaseRef: string;
+  disposition: string;
+}
+
+export interface FirmwareArtifactSweepResult {
+  deletedFiles: number;
+  deletedBytes: number;
+}
+
 export interface ReactNativeRangeDownloader
   extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
   // Main entry: concurrent ranged download (iOS background session / Android thread pool).
@@ -102,4 +200,35 @@ export interface ReactNativeRangeDownloader
   // not own directory layout for real consumers, but exposes this so demos/simple
   // callers have a valid absolute destination without hardcoding sandbox paths.
   getDownloadsDir(): string;
+
+  getFirmwareArtifactCapabilities(): FirmwareArtifactCapabilities;
+  downloadFirmwareArtifact(
+    params: FirmwareArtifactDownloadParams
+  ): Promise<FirmwareArtifactReceipt>;
+  cancelFirmwareArtifactDownloads(
+    params: FirmwareArtifactCancelParams
+  ): Promise<void>;
+  discardFirmwareArtifact(params: FirmwareArtifactRefParams): Promise<void>;
+  openFirmwareArtifact(
+    params: FirmwareArtifactRefParams
+  ): Promise<FirmwareArtifactReaderInfo>;
+  readFirmwareArtifact(
+    params: FirmwareArtifactReaderReadParams
+  ): Promise<ArrayBuffer>;
+  closeFirmwareArtifact(
+    params: FirmwareArtifactReaderCloseParams
+  ): Promise<void>;
+  materializeFirmwareArchive(
+    params: FirmwareArchiveMaterializeParams
+  ): Promise<FirmwareArchiveMaterializeResult>;
+  createFirmwareArtifactLease(
+    params: FirmwareArtifactLeaseCreateParams
+  ): Promise<FirmwareArtifactLease>;
+  retainFirmwareArtifact(
+    params: FirmwareArtifactLeaseRetainParams
+  ): Promise<void>;
+  releaseFirmwareArtifactLease(
+    params: FirmwareArtifactLeaseReleaseParams
+  ): Promise<void>;
+  sweepFirmwareArtifactOrphans(): Promise<FirmwareArtifactSweepResult>;
 }

package/src/index.tsx

@@ -6,7 +6,8 @@ const ReactNativeRangeDownloaderHybridObject =
     'ReactNativeRangeDownloader'
   );
 
-export const ReactNativeRangeDownloader = ReactNativeRangeDownloaderHybridObject;
+export const ReactNativeRangeDownloader =
+  ReactNativeRangeDownloaderHybridObject;
 
 // Closed set of download channels (design decision 10.1). The native side builds the
 // background session identifier as `so.onekey.rangedownloader.bg.<channel>`. New channels
@@ -15,6 +16,7 @@ export const RangeDownloadChannel = {
   Bundle: 'bundle',
   Apk: 'apk',
   Chart: 'chart',
+  Firmware: 'firmware',
 } as const;
 
 export type * from './ReactNativeRangeDownloader.nitro';