feat(background-thread): add SharedBridge JSI HostObject

.gitignore

@@ -78,3 +78,7 @@ test-report.html
 # Ignore tamagui config file 
 .tamagui
 scripts/nitro-view/template/android/.gradle
+
+# generated by react-native-builder-bob
+native-modules/*/lib/
+native-views/*/lib/

.yarn/patches/react-native-npm-0.83.0-577d0f2d83.patch

@@ -0,0 +1,34 @@
+diff --git a/third-party-podspecs/RCT-Folly.podspec b/third-party-podspecs/RCT-Folly.podspec
+index 8852179b6ce2ef6ae64e0239edb2594925ff8bc1..040c4f0ca82e6a7342d5b3ed54e556431e5853d2 100644
+--- a/third-party-podspecs/RCT-Folly.podspec
++++ b/third-party-podspecs/RCT-Folly.podspec
+@@ -25,7 +25,7 @@ Pod::Spec.new do |spec|
+   spec.dependency "DoubleConversion"
+   spec.dependency "glog"
+   spec.dependency "fast_float", "8.0.0"
+-  spec.dependency "fmt", "11.0.2"
++  spec.dependency "fmt", "12.1.0"
+   spec.compiler_flags = '-Wno-documentation -faligned-new'
+   spec.source_files = 'folly/String.cpp',
+                       'folly/Conv.cpp',
+diff --git a/third-party-podspecs/fmt.podspec b/third-party-podspecs/fmt.podspec
+index 2f38990e226c13f483aaf1b986302d4094243814..a40c5755e049974e98a4038c177661d2bdc5681f 100644
+--- a/third-party-podspecs/fmt.podspec
++++ b/third-party-podspecs/fmt.podspec
+@@ -8,14 +8,14 @@ fmt_git_url = fmt_config[:git]
+
+ Pod::Spec.new do |spec|
+   spec.name = "fmt"
+-  spec.version = "11.0.2"
++  spec.version = "12.1.0"
+   spec.license = { :type => "MIT" }
+   spec.homepage = "https://github.com/fmtlib/fmt"
+   spec.summary = "{fmt} is an open-source formatting library for C++. It can be used as a safe and fast alternative to (s)printf and iostreams."
+   spec.authors = "The fmt contributors"
+   spec.source = {
+     :git => fmt_git_url,
+-    :tag => "11.0.2"
++    :tag => "12.1.0"
+   }
+   spec.pod_target_xcconfig = {
+     "CLANG_CXX_LANGUAGE_STANDARD" => rct_cxx_language_standard(),

CHANGELOG.md

@@ -2,6 +2,132 @@
 
 All notable changes to this project will be documented in this file.
 
+## [3.0.4] - 2026-04-03
+
+### Bug Fixes
+- **split-bundle-loader**: Fix stale reflection class name for `BundleUpdateStore` in Android `getOtaBundlePath()` — updated from `expo.modules.onekeybundleupdate.BundleUpdateStore` to `com.margelo.nitro.reactnativebundleupdate.BundleUpdateStoreAndroid`
+- **native-logger**: Fix dedup logic suppressing error logs — comparison now includes level, tag, and message instead of message-only
+- **background-thread**: Fix JNI GlobalRef leak on each `nativeInstallSharedBridge` call — wrap in `shared_ptr` with custom deleter
+- **background-thread**: Fix `SharedRPC::reset()` crash from destroying `jsi::Function` on wrong thread — use intentional leak pattern
+- **background-thread**: Fix `nativeDestroy` not resetting `SharedStore`, leaving stale data across restarts
+- Correct codegen class names to match TS spec file names
+
+### Chores
+- Align all package versions to 3.x line (cloud-fs cannot use 1.x since npm already has 2.6.5)
+- Bump all packages to 3.0.4
+
+## [1.1.59] - 2026-04-03
+
+### Bug Fixes
+- **tcp-socket**: Correct header import to match codegenConfig name
+
+### Chores
+- Bump all packages to 1.1.59
+
+## [1.1.58] - 2026-04-03
+
+### Bug Fixes
+- **cloud-fs**: Set version to 3.0.0 (npm already has 2.6.5, cannot publish lower)
+
+### Chores
+- Bump all packages to 1.1.58
+
+## [1.1.57] - 2026-04-03
+
+### Bug Fixes
+- Add missing release scripts for cloud-fs, ping, zip-archive
+
+### Chores
+- Bump all packages to 1.1.57
+
+## [1.1.56] - 2026-04-03
+
+### Features
+- **aes-crypto / async-storage / cloud-fs / dns-lookup / network-info / ping / tcp-socket / zip-archive**: Add Android TurboModule implementations for legacy bridge module replacements
+- **tcp-socket**: Fix type definitions
+
+### Chores
+- Bump all packages to 1.1.56
+
+## [1.1.55] - 2026-04-03
+
+### Features
+- **aes-crypto / async-storage / cloud-fs / dns-lookup / network-info / ping / tcp-socket / zip-archive**: Add TurboModule replacements for legacy React Native bridge modules (iOS + JS)
+
+### Chores
+- Bump all packages to 1.1.55
+
+## [1.1.54] - 2026-04-02
+
+### Chores
+- Bump all packages to 1.1.54
+
+## [1.1.53] - 2026-04-02
+
+### Features
+- **split-bundle-loader**: Add split-bundle timing instrumentation and update PGP public key
+- **split-bundle-loader**: Add comprehensive timing logs for three-bundle split verification
+
+### Chores
+- Bump all packages to 1.1.53
+
+## [1.1.52] - 2026-04-02
+
+### Features
+- **background-thread**: Add split-bundle common+entry loading strategy for background runtime
+
+### Chores
+- Bump all packages to 1.1.52
+
+## [1.1.51] - 2026-04-01
+
+### Features
+- **split-bundle-loader**: Add `resolveSegmentPath` API and path traversal protection
+
+### Bug Fixes
+- **split-bundle-loader**: Resolve Android `registerSegmentInBackground` race condition
+- **split-bundle-loader**: Enhance bridgeless support and robustness improvements
+
+### Chores
+- Bump all packages to 1.1.51
+
+## [1.1.49] - 2026-04-01
+
+### Features
+- **split-bundle-loader**: Add `react-native-split-bundle-loader` TurboModule with `getRuntimeBundleContext` and `loadSegment` APIs
+- **split-bundle-loader**: Expose `loadSegmentInBackground` from TurboModule API
+- **bundle-update**: Add `registerSegmentInBackground` for late HBC segment loading
+
+### Chores
+- Bump all packages to 1.1.49
+
+## [1.1.48] - 2026-03-31
+
+### Features
+- **bundle-update**: Support background bundle pair bootstrap — add `getBackgroundJsBundlePath`, metadata validation for `requiresBackgroundBundle` and `backgroundProtocolVersion`, and bundle pair compatibility checks
+
+### Chores
+- Bump all packages to 1.1.48
+
+## [1.1.47] - 2026-03-31
+
+### Features
+- **background-thread**: Add SharedBridge JSI HostObject for cross-runtime data transfer between main and background JS runtimes
+- **background-thread**: Implement Android background runtime with second ReactHost and SharedBridge
+- **background-thread**: Replace SharedBridge with SharedStore + SharedRPC architecture
+- **background-thread**: Add onWrite cross-runtime notification, remove legacy messaging
+- **native-logger**: Add dedup for identical consecutive log messages
+
+### Bug Fixes
+- **background-thread**: Stabilize background thread runtime initialization
+- **background-thread**: Initialize Android shared bridge at app startup
+- **shared-rpc**: Rename `RuntimeExecutor` to `RPCRuntimeExecutor` to avoid React Native conflict
+- **shared-rpc**: Prevent crash on JS reload by deduplicating listeners with runtimeId
+- **shared-rpc**: Leak stale `jsi::Function` callback on reload to prevent crash
+
+### Chores
+- Bump all packages to 1.1.47
+
 ## [1.1.46] - 2026-03-19
 
 ### Bug Fixes

example/react-native/.ruby-version

@@ -0,0 +1 @@
+3.4.4

example/react-native/Gemfile.lock

@@ -0,0 +1,141 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    CFPropertyList (3.0.8)
+    activesupport (7.2.3.1)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1, < 6)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+    addressable (2.8.9)
+      public_suffix (>= 2.0.2, < 8.0)
+    algoliasearch (1.27.5)
+      httpclient (~> 2.8, >= 2.8.3)
+      json (>= 1.5.1)
+    atomos (0.1.3)
+    base64 (0.3.0)
+    benchmark (0.5.0)
+    bigdecimal (4.1.0)
+    claide (1.1.0)
+    cocoapods (1.15.2)
+      addressable (~> 2.8)
+      claide (>= 1.0.2, < 2.0)
+      cocoapods-core (= 1.15.2)
+      cocoapods-deintegrate (>= 1.0.3, < 2.0)
+      cocoapods-downloader (>= 2.1, < 3.0)
+      cocoapods-plugins (>= 1.0.0, < 2.0)
+      cocoapods-search (>= 1.0.0, < 2.0)
+      cocoapods-trunk (>= 1.6.0, < 2.0)
+      cocoapods-try (>= 1.1.0, < 2.0)
+      colored2 (~> 3.1)
+      escape (~> 0.0.4)
+      fourflusher (>= 2.3.0, < 3.0)
+      gh_inspector (~> 1.0)
+      molinillo (~> 0.8.0)
+      nap (~> 1.0)
+      ruby-macho (>= 2.3.0, < 3.0)
+      xcodeproj (>= 1.23.0, < 2.0)
+    cocoapods-core (1.15.2)
+      activesupport (>= 5.0, < 8)
+      addressable (~> 2.8)
+      algoliasearch (~> 1.0)
+      concurrent-ruby (~> 1.1)
+      fuzzy_match (~> 2.0.4)
+      nap (~> 1.0)
+      netrc (~> 0.11)
+      public_suffix (~> 4.0)
+      typhoeus (~> 1.0)
+    cocoapods-deintegrate (1.0.5)
+    cocoapods-downloader (2.1)
+    cocoapods-plugins (1.0.0)
+      nap
+    cocoapods-search (1.0.1)
+    cocoapods-trunk (1.6.0)
+      nap (>= 0.8, < 2.0)
+      netrc (~> 0.11)
+    cocoapods-try (1.2.0)
+    colored2 (3.1.2)
+    concurrent-ruby (1.3.3)
+    connection_pool (3.0.2)
+    drb (2.2.3)
+    escape (0.0.4)
+    ethon (0.18.0)
+      ffi (>= 1.15.0)
+      logger
+    ffi (1.17.4)
+    ffi (1.17.4-aarch64-linux-gnu)
+    ffi (1.17.4-aarch64-linux-musl)
+    ffi (1.17.4-arm-linux-gnu)
+    ffi (1.17.4-arm-linux-musl)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86-linux-gnu)
+    ffi (1.17.4-x86-linux-musl)
+    ffi (1.17.4-x86_64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
+    ffi (1.17.4-x86_64-linux-musl)
+    fourflusher (2.3.1)
+    fuzzy_match (2.0.4)
+    gh_inspector (1.1.3)
+    httpclient (2.9.0)
+      mutex_m
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    json (2.19.3)
+    logger (1.7.0)
+    minitest (5.27.0)
+    molinillo (0.8.0)
+    mutex_m (0.3.0)
+    nanaimo (0.3.0)
+    nap (1.1.0)
+    netrc (0.11.0)
+    public_suffix (4.0.7)
+    rexml (3.4.4)
+    ruby-macho (2.5.1)
+    securerandom (0.4.1)
+    typhoeus (1.6.0)
+      ethon (>= 0.18.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    xcodeproj (1.25.1)
+      CFPropertyList (>= 2.3.3, < 4.0)
+      atomos (~> 0.1.3)
+      claide (>= 1.0.2, < 2.0)
+      colored2 (~> 3.1)
+      nanaimo (~> 0.3.0)
+      rexml (>= 3.3.6, < 4.0)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  ruby
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  activesupport (>= 6.1.7.5, != 7.1.0)
+  benchmark
+  bigdecimal
+  cocoapods (>= 1.13, != 1.15.1, != 1.15.0)
+  concurrent-ruby (< 1.3.4)
+  logger
+  mutex_m
+  xcodeproj (< 1.26.0)
+
+RUBY VERSION
+   ruby 3.4.4p34
+
+BUNDLED WITH
+   2.6.9

example/react-native/android/app/src/main/java/com/example/MainApplication.kt

@@ -4,8 +4,11 @@ import android.app.Application
 import com.facebook.react.PackageList
 import com.facebook.react.ReactApplication
 import com.facebook.react.ReactHost
+import com.facebook.react.ReactInstanceEventListener
 import com.facebook.react.ReactNativeApplicationEntryPoint.loadReactNative
+import com.facebook.react.bridge.ReactContext
 import com.facebook.react.defaults.DefaultReactHost.getDefaultReactHost
+import com.backgroundthread.BackgroundThreadManager
 import com.margelo.nitro.nativelogger.OneKeyLog
 
 class MainApplication : Application(), ReactApplication {
@@ -25,5 +28,25 @@ class MainApplication : Application(), ReactApplication {
     super.onCreate()
     OneKeyLog.info("App", "Application started")
     loadReactNative(this)
+
+    // Mirror iOS AppDelegate's hostDidStart: — install SharedBridge and start
+    // background runner as soon as the main React context is ready.
+    reactHost.addReactInstanceEventListener(object : ReactInstanceEventListener {
+      override fun onReactContextInitialized(context: ReactContext) {
+        val manager = BackgroundThreadManager.getInstance()
+        val reactAppContext = context as com.facebook.react.bridge.ReactApplicationContext
+        manager.setReactPackages(PackageList(this@MainApplication).packages)
+        manager.installSharedBridgeInMainRuntime(reactAppContext)
+
+        val bgURL = if (BuildConfig.DEBUG) {
+          // Use the same host detection as React Native (emulator vs device)
+          val host = com.facebook.react.modules.systeminfo.AndroidInfoHelpers.getServerHost(this@MainApplication, 8082)
+          "http://$host/background.bundle?platform=android&dev=true&lazy=false&minify=false&inlineSourceMap=false&modulesOnly=false&runModule=true"
+        } else {
+          "background.bundle"
+        }
+        manager.startBackgroundRunnerWithEntryURL(reactAppContext, bgURL)
+      }
+    })
   }
 }