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

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

@@ -242,6 +242,45 @@ class BackgroundThreadManager private constructor() {
         }
     }
 
+    // ── Segment Registration (Phase 2.5 spike) ─────────────────────────────
+
+    /**
+     * Register a HBC segment in the background runtime.
+     * Uses CatalystInstance.registerSegment() on the background ReactContext.
+     *
+     * @param segmentId The segment ID to register
+     * @param path Absolute file path to the .seg.hbc file
+     * @throws IllegalStateException if background runtime is not started
+     * @throws IllegalArgumentException if segment file does not exist
+     */
+    fun registerSegmentInBackground(segmentId: Int, path: String) {
+        if (!isStarted) {
+            throw IllegalStateException("Background runtime not started")
+        }
+
+        val file = File(path)
+        if (!file.exists()) {
+            throw IllegalArgumentException("Segment file not found: $path")
+        }
+
+        val context = bgReactHost?.currentReactContext
+            ?: throw IllegalStateException("Background ReactContext not available")
+
+        context.runOnJSQueueThread {
+            try {
+                if (context.hasCatalystInstance()) {
+                    context.catalystInstance.registerSegment(segmentId, path)
+                    BTLogger.info("Segment registered in background runtime: id=$segmentId, path=$path")
+                } else {
+                    BTLogger.error("Background CatalystInstance not available for segment registration")
+                }
+            } catch (e: Exception) {
+                BTLogger.error("Failed to register segment in background runtime: ${e.message}")
+                throw e
+            }
+        }
+    }
+
     // ── Lifecycle ───────────────────────────────────────────────────────────
 
     val isBackgroundStarted: Boolean get() = isStarted

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

@@ -1,5 +1,6 @@
 package com.backgroundthread
 
+import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.module.annotations.ReactModule
 
@@ -26,4 +27,14 @@ class BackgroundThreadModule(reactContext: ReactApplicationContext) :
     override fun startBackgroundRunnerWithEntryURL(entryURL: String) {
         BackgroundThreadManager.getInstance().startBackgroundRunnerWithEntryURL(reactApplicationContext, entryURL)
     }
+
+    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)
+        }
+    }
 }

package/ios/BackgroundRunnerReactNativeDelegate.h

@@ -31,6 +31,13 @@ NS_ASSUME_NONNULL_BEGIN
  */
 - (instancetype)init;
 
+/**
+ * Register a HBC segment in the background runtime (Phase 2.5 spike).
+ * Uses RCTInstance's registerSegmentWithId:path: API.
+ * Must be called after hostDidStart: has completed.
+ */
+- (BOOL)registerSegmentWithId:(NSNumber *)segmentId path:(NSString *)path;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/ios/BackgroundRunnerReactNativeDelegate.mm

@@ -222,6 +222,34 @@ static NSURL *resolveBundleSourceURL(NSString *jsBundleSourceNS)
   }];
 }
 
+#pragma mark - Segment Registration (Phase 2.5 spike)
+
+- (BOOL)registerSegmentWithId:(NSNumber *)segmentId path:(NSString *)path
+{
+  if (!_rctInstance) {
+    [BTLogger error:@"Cannot register segment: background RCTInstance not available"];
+    return NO;
+  }
+
+  @try {
+    SEL sel = NSSelectorFromString(@"registerSegmentWithId:path:");
+    if ([_rctInstance respondsToSelector:sel]) {
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
+      [_rctInstance performSelector:sel withObject:segmentId withObject:path];
+#pragma clang diagnostic pop
+      [BTLogger info:[NSString stringWithFormat:@"Segment registered in background runtime: id=%@, path=%@", segmentId, path]];
+      return YES;
+    } else {
+      [BTLogger error:@"RCTInstance does not respond to registerSegmentWithId:path:"];
+      return NO;
+    }
+  } @catch (NSException *exception) {
+    [BTLogger error:[NSString stringWithFormat:@"Failed to register segment: %@", exception.reason]];
+    return NO;
+  }
+}
+
 #pragma mark - RCTTurboModuleManagerDelegate
 
 - (id<RCTModuleProvider>)getModuleProvider:(const char *)name

package/ios/BackgroundThread.h

@@ -5,5 +5,9 @@
 - (void)startBackgroundRunner;
 - (void)startBackgroundRunnerWithEntryURL:(NSString *)entryURL;
 - (void)installSharedBridge;
+- (void)loadSegmentInBackground:(double)segmentId
+                           path:(NSString *)path
+                        resolve:(RCTPromiseResolveBlock)resolve
+                         reject:(RCTPromiseRejectBlock)reject;
 
 @end

package/ios/BackgroundThread.mm

@@ -29,6 +29,22 @@
     [BTLogger info:@"installSharedBridge called (no-op on iOS, installed from AppDelegate)"];
 }
 
+- (void)loadSegmentInBackground:(double)segmentId
+                           path:(NSString *)path
+                        resolve:(RCTPromiseResolveBlock)resolve
+                         reject:(RCTPromiseRejectBlock)reject {
+    BackgroundThreadManager *manager = [BackgroundThreadManager sharedInstance];
+    [manager registerSegmentInBackground:@((int)segmentId)
+                                    path:path
+                              completion:^(NSError * _Nullable error) {
+        if (error) {
+            reject(@"BG_SEGMENT_LOAD_ERROR", error.localizedDescription, error);
+        } else {
+            resolve(nil);
+        }
+    }];
+}
+
 + (NSString *)moduleName
 {
   return @"BackgroundThread";

package/ios/BackgroundThreadManager.h

@@ -26,6 +26,14 @@ NS_ASSUME_NONNULL_BEGIN
 /// Check if background runner is started
 @property (nonatomic, readonly) BOOL isStarted;
 
+/// Register a HBC segment in the background runtime (Phase 2.5 spike)
+/// @param segmentId The segment ID to register
+/// @param path Absolute file path to the .seg.hbc file
+/// @param completion Callback with nil error on success, or NSError on failure
+- (void)registerSegmentInBackground:(NSNumber *)segmentId
+                               path:(NSString *)path
+                         completion:(void (^)(NSError * _Nullable error))completion;
+
 @end
 
 NS_ASSUME_NONNULL_END

package/ios/BackgroundThreadManager.mm

@@ -115,4 +115,40 @@ static NSString *const MODULE_DEBUG_URL = @"http://localhost:8082/apps/mobile/ba
     });
 }
 
+#pragma mark - Segment Registration (Phase 2.5 spike)
+
+- (void)registerSegmentInBackground:(NSNumber *)segmentId
+                               path:(NSString *)path
+                         completion:(void (^)(NSError * _Nullable error))completion
+{
+    if (!self.isStarted || !self.reactNativeFactoryDelegate) {
+        NSError *error = [NSError errorWithDomain:@"BackgroundThread"
+                                             code:1
+                                         userInfo:@{NSLocalizedDescriptionKey: @"Background runtime not started"}];
+        if (completion) completion(error);
+        return;
+    }
+
+    // Verify the file exists
+    if (![[NSFileManager defaultManager] fileExistsAtPath:path]) {
+        NSError *error = [NSError errorWithDomain:@"BackgroundThread"
+                                             code:2
+                                         userInfo:@{NSLocalizedDescriptionKey:
+                                                        [NSString stringWithFormat:@"Segment file not found: %@", path]}];
+        if (completion) completion(error);
+        return;
+    }
+
+    BOOL success = [self.reactNativeFactoryDelegate registerSegmentWithId:segmentId path:path];
+    if (success) {
+        if (completion) completion(nil);
+    } else {
+        NSError *error = [NSError errorWithDomain:@"BackgroundThread"
+                                             code:3
+                                         userInfo:@{NSLocalizedDescriptionKey:
+                                                        @"Failed to register segment in background runtime"}];
+        if (completion) completion(error);
+    }
+}
+
 @end

package/lib/module/NativeBackgroundThread.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBackgroundThread.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAAQ,cAAc;AAQlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,kBAAkB,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBackgroundThread.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAAQ,cAAc;AAYlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,kBAAkB,CAAC","ignoreList":[]}

package/lib/typescript/src/NativeBackgroundThread.d.ts

@@ -2,6 +2,7 @@ import type { TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
     startBackgroundRunnerWithEntryURL(entryURL: string): void;
     installSharedBridge(): void;
+    loadSegmentInBackground(segmentId: number, path: string): Promise<void>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/src/NativeBackgroundThread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeBackgroundThread.d.ts","sourceRoot":"","sources":["../../../src/NativeBackgroundThread.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,iCAAiC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,mBAAmB,IAAI,IAAI,CAAC;CAC7B;;AAED,wBAA0E"}
+{"version":3,"file":"NativeBackgroundThread.d.ts","sourceRoot":"","sources":["../../../src/NativeBackgroundThread.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,iCAAiC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,mBAAmB,IAAI,IAAI,CAAC;IAC5B,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;;AAED,wBAA0E"}

package/package.json

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

package/src/NativeBackgroundThread.ts

@@ -4,6 +4,10 @@ import type { TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
   startBackgroundRunnerWithEntryURL(entryURL: string): void;
   installSharedBridge(): void;
+  loadSegmentInBackground(
+    segmentId: number,
+    path: string,
+  ): Promise<void>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('BackgroundThread');