@onekeyfe/react-native-background-thread 1.1.49 → 1.1.51

package/android/src/main/java/com/backgroundthread/BackgroundThreadManager.kt

@@ -253,30 +253,45 @@ class BackgroundThreadManager private constructor() {
      * @throws IllegalStateException if background runtime is not started
      * @throws IllegalArgumentException if segment file does not exist
      */
-    fun registerSegmentInBackground(segmentId: Int, path: String) {
+    /**
+     * Register a HBC segment in the background runtime with completion callback.
+     * Dispatches to the background JS queue thread and invokes the callback
+     * only after registerSegment has actually executed.
+     *
+     * @param segmentId The segment ID to register
+     * @param path Absolute file path to the .seg.hbc file
+     * @param onComplete Called with null on success, or an Exception on failure
+     */
+    fun registerSegmentInBackground(segmentId: Int, path: String, onComplete: (Exception?) -> Unit) {
         if (!isStarted) {
-            throw IllegalStateException("Background runtime not started")
+            onComplete(IllegalStateException("Background runtime not started"))
+            return
         }
 
         val file = File(path)
         if (!file.exists()) {
-            throw IllegalArgumentException("Segment file not found: $path")
+            onComplete(IllegalArgumentException("Segment file not found: $path"))
+            return
         }
 
         val context = bgReactHost?.currentReactContext
-            ?: throw IllegalStateException("Background ReactContext not available")
+        if (context == null) {
+            onComplete(IllegalStateException("Background ReactContext not available"))
+            return
+        }
 
         context.runOnJSQueueThread {
             try {
                 if (context.hasCatalystInstance()) {
                     context.catalystInstance.registerSegment(segmentId, path)
                     BTLogger.info("Segment registered in background runtime: id=$segmentId, path=$path")
+                    onComplete(null)
                 } else {
-                    BTLogger.error("Background CatalystInstance not available for segment registration")
+                    onComplete(IllegalStateException("Background CatalystInstance not available for segment registration"))
                 }
             } catch (e: Exception) {
                 BTLogger.error("Failed to register segment in background runtime: ${e.message}")
-                throw e
+                onComplete(e)
             }
         }
     }

package/android/src/main/java/com/backgroundthread/BackgroundThreadModule.kt

@@ -29,12 +29,13 @@ class BackgroundThreadModule(reactContext: ReactApplicationContext) :
     }
 
     override fun loadSegmentInBackground(segmentId: Double, path: String, promise: Promise) {
-        try {
-            BackgroundThreadManager.getInstance()
-                .registerSegmentInBackground(segmentId.toInt(), path)
-            promise.resolve(null)
-        } catch (e: Exception) {
-            promise.reject("BG_SEGMENT_LOAD_ERROR", e.message, e)
-        }
+        BackgroundThreadManager.getInstance()
+            .registerSegmentInBackground(segmentId.toInt(), path) { error ->
+                if (error != null) {
+                    promise.reject("BG_SEGMENT_LOAD_ERROR", error.message, error)
+                } else {
+                    promise.resolve(null)
+                }
+            }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-background-thread",
-  "version": "1.1.49",
+  "version": "1.1.51",
   "description": "react-native-background-thread",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",