@rn-org/react-native-thread 0.1.0

package/android/src/main/java/com/rnorg/reactnativethread/ReactNativeThreadModule.kt

@@ -0,0 +1,162 @@
+package com.rnorg.reactnativethread
+
+import android.util.Log
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import org.mozilla.javascript.BaseFunction
+import org.mozilla.javascript.Context as RhinoContext
+import org.mozilla.javascript.NativeObject
+import org.mozilla.javascript.ScriptRuntime
+import org.mozilla.javascript.Scriptable
+import org.mozilla.javascript.ScriptableObject
+import java.util.concurrent.CompletableFuture
+import java.util.concurrent.ConcurrentHashMap
+import java.util.concurrent.ExecutorService
+import java.util.concurrent.Executors
+import java.util.concurrent.atomic.AtomicLong
+
+class ReactNativeThreadModule(reactContext: ReactApplicationContext) :
+  NativeReactNativeThreadSpec(reactContext) {
+
+  private data class ThreadEntry(
+    val executor: ExecutorService,
+    val scope: Scriptable
+  )
+
+  private val threads = ConcurrentHashMap<Long, ThreadEntry>()
+  private val nextId = AtomicLong(1L)
+
+  // ─── NativeEventEmitter boilerplate ────────────────────────────────────────
+  override fun addListener(eventName: String?) { /* no-op: handled by JS */ }
+  override fun removeListeners(count: Double) { /* no-op */ }
+
+  // ─── Thread lifecycle ───────────────────────────────────────────────────────
+
+  override fun createThread(): Double {
+    val id = nextId.getAndIncrement()
+    val executor = Executors.newSingleThreadExecutor { r ->
+      Thread(r, "RNThread-$id")
+    }
+
+    val scopeFuture = CompletableFuture<Scriptable>()
+    executor.execute {
+      val cx = RhinoContext.enter()
+      try {
+        cx.optimizationLevel = -1
+        val scope = cx.initStandardObjects()
+        injectConsole(scope, id)
+        injectPostMessage(scope, id)
+        scopeFuture.complete(scope)
+      } catch (e: Exception) {
+        scopeFuture.completeExceptionally(e)
+      } finally {
+        RhinoContext.exit()
+      }
+    }
+
+    val scope = scopeFuture.get()
+    threads[id] = ThreadEntry(executor, scope)
+    return id.toDouble()
+  }
+
+  override fun runOnThread(threadId: Double, code: String) {
+    val entry = threads[threadId.toLong()]
+    if (entry == null) {
+      Log.w(NAME, "runOnThread: unknown threadId $threadId")
+      return
+    }
+    entry.executor.execute {
+      val cx = RhinoContext.enter()
+      try {
+        cx.optimizationLevel = -1
+        cx.evaluateString(entry.scope, code, "RNThread-${threadId.toLong()}", 1, null)
+      } catch (e: Exception) {
+        Log.e(NAME, "JS exception on thread $threadId: ${e.message}")
+      } finally {
+        RhinoContext.exit()
+      }
+    }
+  }
+
+  override fun destroyThread(threadId: Double) {
+    val entry = threads.remove(threadId.toLong()) ?: return
+    entry.executor.shutdown()
+  }
+
+  // ─── Scope injection ────────────────────────────────────────────────────────
+
+  private fun injectPostMessage(scope: Scriptable, threadId: Long) {
+    val ctx = reactApplicationContext
+    ScriptableObject.putProperty(
+      scope as ScriptableObject,
+      "postMessage",
+      object : BaseFunction() {
+        override fun call(
+          cx: RhinoContext,
+          callScope: Scriptable,
+          thisObj: Scriptable?,
+          args: Array<out Any?>
+        ): Any {
+          val raw = args.getOrNull(0)
+          val jsonString: String = try {
+            val jsonObj = ScriptableObject.getProperty(callScope, "JSON") as? Scriptable
+            val stringify = jsonObj?.let { ScriptableObject.getProperty(it, "stringify") }
+            if (stringify is org.mozilla.javascript.Function) {
+              ScriptRuntime.toString(stringify.call(cx, callScope, jsonObj, arrayOf(raw)))
+            } else {
+              raw?.toString() ?: "null"
+            }
+          } catch (e: Exception) {
+            raw?.toString() ?: "null"
+          }
+
+          val params = Arguments.createMap().apply {
+            putDouble("threadId", threadId.toDouble())
+            putString("data", jsonString)
+          }
+          ctx.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+            .emit("RNThreadMessage", params)
+
+          return RhinoContext.getUndefinedValue()
+        }
+      }
+    )
+  }
+
+  private fun injectConsole(scope: Scriptable, threadId: Long) {
+    val tag = "RNThread-$threadId"
+
+    fun makeLogFn(level: Int) = object : BaseFunction() {
+      override fun call(
+        cx: RhinoContext,
+        scope: Scriptable,
+        thisObj: Scriptable?,
+        args: Array<out Any?>
+      ): Any {
+        val msg = args.joinToString(" ") { it?.toString() ?: "null" }
+        when (level) {
+          Log.DEBUG -> Log.d(tag, msg)
+          Log.INFO  -> Log.i(tag, msg)
+          Log.WARN  -> Log.w(tag, msg)
+          Log.ERROR -> Log.e(tag, msg)
+          else      -> Log.v(tag, msg)
+        }
+        return RhinoContext.getUndefinedValue()
+      }
+    }
+
+    val console = NativeObject()
+    console.parentScope = scope
+    ScriptableObject.putProperty(console, "log",   makeLogFn(Log.INFO))
+    ScriptableObject.putProperty(console, "info",  makeLogFn(Log.INFO))
+    ScriptableObject.putProperty(console, "warn",  makeLogFn(Log.WARN))
+    ScriptableObject.putProperty(console, "error", makeLogFn(Log.ERROR))
+    ScriptableObject.putProperty(console, "debug", makeLogFn(Log.DEBUG))
+    ScriptableObject.putProperty(scope as ScriptableObject, "console", console)
+  }
+
+  companion object {
+    const val NAME = NativeReactNativeThreadSpec.NAME
+  }
+}

package/android/src/main/java/com/rnorg/reactnativethread/ReactNativeThreadPackage.kt

@@ -0,0 +1,31 @@
+package com.rnorg.reactnativethread
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class ReactNativeThreadPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == ReactNativeThreadModule.NAME) {
+      ReactNativeThreadModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
+    mapOf(
+      ReactNativeThreadModule.NAME to ReactModuleInfo(
+        name = ReactNativeThreadModule.NAME,
+        className = ReactNativeThreadModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+    )
+  }
+}

package/ios/ReactNativeThread.h

@@ -0,0 +1,6 @@
+#import <React/RCTEventEmitter.h>
+#import <ReactNativeThreadSpec/ReactNativeThreadSpec.h>
+
+@interface ReactNativeThread : RCTEventEmitter <NativeReactNativeThreadSpec>
+
+@end

package/ios/ReactNativeThread.mm

@@ -0,0 +1,180 @@
+#import "ReactNativeThread.h"
+#import <JavaScriptCore/JavaScriptCore.h>
+
+// One entry per thread: a JSContext running on a dedicated serial queue.
+// Each thread owns its own JSVirtualMachine so execution is fully concurrent
+// and never contends with the main thread's VM lock.
+@interface RNThread : NSObject
+@property (nonatomic, strong) JSVirtualMachine *vm;
+@property (nonatomic, strong) JSContext *context;
+@property (nonatomic, strong) dispatch_queue_t queue;
+// Signals when VM+context initialisation is complete so that runOnThread
+// can be enqueued immediately without blocking the JS thread during init.
+@property (nonatomic) dispatch_semaphore_t ready;
+@end
+
+@implementation RNThread
+@end
+
+// ─────────────────────────────────────────────────────────────────────────────
+
+@implementation ReactNativeThread {
+    NSMutableDictionary<NSNumber *, RNThread *> *_threads;
+    NSLock *_lock;
+    double _nextId;
+}
+
+- (instancetype)init {
+    if (self = [super init]) {
+        _threads = [NSMutableDictionary new];
+        _lock = [NSLock new];
+        _nextId = 1;
+    }
+    return self;
+}
+
+// Required by RCTEventEmitter
+- (NSArray<NSString *> *)supportedEvents {
+    return @[@"RNThreadMessage"];
+}
+
+- (void)addListener:(NSString *)eventName { [super addListener:eventName]; }
+- (void)removeListeners:(double)count { [super removeListeners:count]; }
+
+// ─── createThread ─────────────────────────────────────────────────────────────
+
+- (NSNumber *)createThread {
+    RNThread *t = [RNThread new];
+
+    NSString *label = [NSString stringWithFormat:@"com.rnorg.reactnativethread.%lu",
+                        (unsigned long)(NSUInteger)_nextId];
+
+    // QOS_CLASS_UTILITY keeps background JS work below the main/UI thread in
+    // the scheduler, preventing CPU starvation when a tight loop is running.
+    dispatch_queue_attr_t attr = dispatch_queue_attr_make_with_qos_class(
+        DISPATCH_QUEUE_SERIAL, QOS_CLASS_UTILITY, 0);
+    t.queue = dispatch_queue_create(label.UTF8String, attr);
+    t.ready = dispatch_semaphore_create(0);
+
+    NSUInteger tidForLog = (NSUInteger)_nextId;
+
+    // Async init: the JS thread is never blocked waiting for VM creation.
+    // runOnThread enqueues a semaphore-wait block first so it executes only
+    // after init is complete, all on the background queue.
+    dispatch_async(t.queue, ^{
+        t.vm = [[JSVirtualMachine alloc] init];
+        t.context = [[JSContext alloc] initWithVirtualMachine:t.vm];
+        t.context.exceptionHandler = ^(JSContext *ctx, JSValue *exception) {
+            NSLog(@"[RNThread-%lu] JS exception: %@", (unsigned long)tidForLog, exception);
+        };
+
+        // ── console ───────────────────────────────────────────────────────────
+        NSString *tag = [NSString stringWithFormat:@"RNThread-%lu", (unsigned long)tidForLog];
+        NSMutableDictionary *console = [NSMutableDictionary new];
+        console[@"log"] = ^{
+            NSArray *args = [JSContext currentArguments];
+            NSMutableArray *parts = [NSMutableArray new];
+            for (JSValue *v in args) [parts addObject:[v toString]];
+            NSLog(@"[%@] %@", tag, [parts componentsJoinedByString:@" "]);
+        };
+        console[@"info"]  = console[@"log"];
+        console[@"debug"] = console[@"log"];
+        console[@"warn"] = ^{
+            NSArray *args = [JSContext currentArguments];
+            NSMutableArray *parts = [NSMutableArray new];
+            for (JSValue *v in args) [parts addObject:[v toString]];
+            NSLog(@"[%@] WARN: %@", tag, [parts componentsJoinedByString:@" "]);
+        };
+        console[@"error"] = ^{
+            NSArray *args = [JSContext currentArguments];
+            NSMutableArray *parts = [NSMutableArray new];
+            for (JSValue *v in args) [parts addObject:[v toString]];
+            NSLog(@"[%@] ERROR: %@", tag, [parts componentsJoinedByString:@" "]);
+        };
+        t.context[@"console"] = console;
+
+        // ── postMessage ───────────────────────────────────────────────────────
+        NSUInteger capturedTid = tidForLog;
+        __weak ReactNativeThread *weakSelf = self;
+        t.context[@"postMessage"] = ^(JSValue *data) {  // evaluated on t.queue
+            JSValue *jsonStr = [data.context[@"JSON"] invokeMethod:@"stringify"
+                                                      withArguments:@[data]];
+            NSString *serialised = [jsonStr toString];
+            if (!serialised || [serialised isEqualToString:@"undefined"]) {
+                serialised = @"null";
+            }
+
+            ReactNativeThread *strongSelf = weakSelf;
+            if (!strongSelf) return;
+
+            [strongSelf sendEventWithName:@"RNThreadMessage"
+                                     body:@{
+                @"threadId": @(capturedTid),
+                @"data":     serialised
+            }];
+        };
+
+        // Signal that the thread is ready to accept work.
+        dispatch_semaphore_signal(t.ready);
+    });
+
+    double tid = _nextId;
+    [_lock lock];
+    _threads[@(tid)] = t;
+    _nextId += 1;
+    [_lock unlock];
+
+    return @(tid);
+}
+
+// ─── runOnThread ──────────────────────────────────────────────────────────────
+
+- (void)runOnThread:(double)threadId code:(NSString *)code {
+    [_lock lock];
+    RNThread *t = _threads[@(threadId)];
+    [_lock unlock];
+
+    if (!t) {
+        NSLog(@"[ReactNativeThread] runOnThread: unknown threadId %.0f", threadId);
+        return;
+    }
+
+    NSString *codeCopy = [code copy];
+    dispatch_semaphore_t ready = t.ready;
+    dispatch_async(t.queue, ^{
+        // Wait for init to finish (no-op after first runOnThread call).
+        dispatch_semaphore_wait(ready, DISPATCH_TIME_FOREVER);
+        dispatch_semaphore_signal(ready); // re-signal for subsequent calls
+        [t.context evaluateScript:codeCopy];
+    });
+}
+
+// ─── destroyThread ────────────────────────────────────────────────────────────
+
+- (void)destroyThread:(double)threadId {
+    [_lock lock];
+    RNThread *t = _threads[@(threadId)];
+    [_threads removeObjectForKey:@(threadId)];
+    [_lock unlock];
+
+    if (!t) return;
+
+    dispatch_async(t.queue, ^{
+        (void)t;
+    });
+}
+
+// ─── TurboModule boilerplate ──────────────────────────────────────────────────
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeReactNativeThreadSpecJSI>(params);
+}
+
++ (NSString *)moduleName
+{
+  return @"ReactNativeThread";
+}
+
+@end

package/lib/module/NativeReactNativeThread.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('ReactNativeThread');
+//# sourceMappingURL=NativeReactNativeThread.js.map

package/lib/module/NativeReactNativeThread.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactNativeThread.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAuBpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,mBAAmB,CAAC","ignoreList":[]}

package/lib/module/babel-plugin.js

@@ -0,0 +1,71 @@
+/**
+ * Babel plugin for @rn-org/react-native-thread
+ *
+ * Hermes compiles JS to bytecode at build time, so fn.toString() at runtime
+ * returns a placeholder ("bytecode") rather than the original source.
+ *
+ * This plugin runs at compile time and replaces arrow-function / function-
+ * expression arguments passed to the thread API with string literals that
+ * contain the source wrapped as an IIFE.  The background thread engine
+ * (JSC on iOS, Rhino on Android) can then simply eval() the string.
+ *
+ * Transforms:
+ *   runOnJS((args) => { ... })         → runOnJS("((args) => { ... })(__params__)")
+ *   runOnNewJS((args) => { ... })      → runOnNewJS("((args) => { ... })(__params__)")
+ *   thread.run((args) => { ... })      → thread.run("((args) => { ... })(__params__)")
+ *
+ * Add to your app's babel.config.js:
+ *   plugins: ['@rn-org/react-native-thread/babel-plugin']
+ */
+
+'use strict';
+
+// Top-level function names that take a fn-or-code as their first argument.
+const TOP_LEVEL_API = new Set(['runOnJS', 'runOnNewJS']);
+
+// Method names on a ThreadHandle that take a fn-or-code as their first arg.
+const METHOD_API = new Set(['run']);
+module.exports = function reactNativeThreadPlugin({
+  types: t
+}) {
+  /**
+   * If `argNode` is an arrow function or function expression, replace the
+   * argument at `index` with a string literal `"(<source>)()"`.
+   */
+  function maybeTransformArg(callPath, state, argNode, index) {
+    if (!t.isArrowFunctionExpression(argNode) && !t.isFunctionExpression(argNode)) {
+      return;
+    }
+    const originalCode = state.file.code;
+    const fnSource = originalCode.slice(argNode.start, argNode.end);
+    const iife = `(${fnSource})(__params__)`;
+    callPath.node.arguments[index] = t.stringLiteral(iife);
+  }
+  return {
+    name: 'react-native-thread',
+    visitor: {
+      CallExpression(path, state) {
+        const {
+          callee,
+          arguments: args
+        } = path.node;
+
+        // runOnJS(() => {}) / runOnNewJS(() => {})
+        if (t.isIdentifier(callee) && TOP_LEVEL_API.has(callee.name)) {
+          if (args.length >= 1) {
+            maybeTransformArg(path, state, args[0], 0);
+          }
+          return;
+        }
+
+        // someThread.run(() => {})
+        if (t.isMemberExpression(callee) && !callee.computed && t.isIdentifier(callee.property) && METHOD_API.has(callee.property.name)) {
+          if (args.length >= 1) {
+            maybeTransformArg(path, state, args[0], 0);
+          }
+        }
+      }
+    }
+  };
+};
+//# sourceMappingURL=babel-plugin.js.map

package/lib/module/babel-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TOP_LEVEL_API","Set","METHOD_API","module","exports","reactNativeThreadPlugin","types","t","maybeTransformArg","callPath","state","argNode","index","isArrowFunctionExpression","isFunctionExpression","originalCode","file","code","fnSource","slice","start","end","iife","node","arguments","stringLiteral","name","visitor","CallExpression","path","callee","args","isIdentifier","has","length","isMemberExpression","computed","property"],"sourceRoot":"../../src","sources":["babel-plugin.js"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,YAAY;;AAEZ;AACA,MAAMA,aAAa,GAAG,IAAIC,GAAG,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;;AAExD;AACA,MAAMC,UAAU,GAAG,IAAID,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAEnCE,MAAM,CAACC,OAAO,GAAG,SAASC,uBAAuBA,CAAC;EAAEC,KAAK,EAAEC;AAAE,CAAC,EAAE;EAC9D;AACF;AACA;AACA;EACE,SAASC,iBAAiBA,CAACC,QAAQ,EAAEC,KAAK,EAAEC,OAAO,EAAEC,KAAK,EAAE;IAC1D,IACE,CAACL,CAAC,CAACM,yBAAyB,CAACF,OAAO,CAAC,IACrC,CAACJ,CAAC,CAACO,oBAAoB,CAACH,OAAO,CAAC,EAChC;MACA;IACF;IAEA,MAAMI,YAAY,GAAGL,KAAK,CAACM,IAAI,CAACC,IAAI;IACpC,MAAMC,QAAQ,GAAGH,YAAY,CAACI,KAAK,CAACR,OAAO,CAACS,KAAK,EAAET,OAAO,CAACU,GAAG,CAAC;IAC/D,MAAMC,IAAI,GAAG,IAAIJ,QAAQ,eAAe;IAExCT,QAAQ,CAACc,IAAI,CAACC,SAAS,CAACZ,KAAK,CAAC,GAAGL,CAAC,CAACkB,aAAa,CAACH,IAAI,CAAC;EACxD;EAEA,OAAO;IACLI,IAAI,EAAE,qBAAqB;IAC3BC,OAAO,EAAE;MACPC,cAAcA,CAACC,IAAI,EAAEnB,KAAK,EAAE;QAC1B,MAAM;UAAEoB,MAAM;UAAEN,SAAS,EAAEO;QAAK,CAAC,GAAGF,IAAI,CAACN,IAAI;;QAE7C;QACA,IAAIhB,CAAC,CAACyB,YAAY,CAACF,MAAM,CAAC,IAAI9B,aAAa,CAACiC,GAAG,CAACH,MAAM,CAACJ,IAAI,CAAC,EAAE;UAC5D,IAAIK,IAAI,CAACG,MAAM,IAAI,CAAC,EAAE;YACpB1B,iBAAiB,CAACqB,IAAI,EAAEnB,KAAK,EAAEqB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;UAC5C;UACA;QACF;;QAEA;QACA,IACExB,CAAC,CAAC4B,kBAAkB,CAACL,MAAM,CAAC,IAC5B,CAACA,MAAM,CAACM,QAAQ,IAChB7B,CAAC,CAACyB,YAAY,CAACF,MAAM,CAACO,QAAQ,CAAC,IAC/BnC,UAAU,CAAC+B,GAAG,CAACH,MAAM,CAACO,QAAQ,CAACX,IAAI,CAAC,EACpC;UACA,IAAIK,IAAI,CAACG,MAAM,IAAI,CAAC,EAAE;YACpB1B,iBAAiB,CAACqB,IAAI,EAAEnB,KAAK,EAAEqB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;UAC5C;QACF;MACF;IACF;EACF,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/module/globals.d.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=globals.d.js.map

package/lib/module/globals.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["globals.d.ts"],"mappings":"","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,166 @@
+"use strict";
+
+import { NativeEventEmitter } from 'react-native';
+import ReactNativeThread from "./NativeReactNativeThread.js";
+
+/** Snapshot of a single live thread. */
+
+const _emitter = new NativeEventEmitter(ReactNativeThread);
+const RN_THREAD_MESSAGE_EVENT = 'RNThreadMessage';
+
+// ─── Thread registry (JS-layer; names are a JS concept) ──────────────────────
+const _registry = new Map();
+function _register(id, name) {
+  _registry.set(id, {
+    id,
+    name
+  });
+}
+function _unregister(id) {
+  _registry.delete(id);
+}
+function toCode(task, params) {
+  if (typeof task === 'string') {
+    // Always declare __params__ so Babel-transformed strings can pass it as
+    // an argument to the function, and raw code strings that reference
+    // __params__ directly continue to work.
+    const paramsJson = params !== undefined ? JSON.stringify(params) : 'undefined';
+    return `var __params__ = ${paramsJson};\n${task}`;
+  }
+  const src = task.toString();
+  if (src.includes('[bytecode]') || /^\s*function\s*\(\)\s*\{\s*bytecode\s*\}/.test(src)) {
+    if (__DEV__) {
+      console.warn('[react-native-thread] fn.toString() returned a Hermes bytecode placeholder. ' + "Add the Babel plugin: plugins: ['@rn-org/react-native-thread/babel-plugin']");
+    }
+    return '/* bytecode: no-op */';
+  }
+  const argsStr = params !== undefined ? JSON.stringify(params) : '';
+  return `(${src})(${argsStr})`;
+}
+
+// ─── Shared thread (runOnJS) ──────────────────────────────────────────────────
+
+const SHARED_THREAD_NAME = 'RNOrgThread';
+let _sharedThreadId = null;
+function getSharedThread() {
+  if (_sharedThreadId === null) {
+    _sharedThreadId = ReactNativeThread.createThread();
+    _register(_sharedThreadId, SHARED_THREAD_NAME);
+  }
+  return _sharedThreadId;
+}
+export function runOnJS(task, params) {
+  ReactNativeThread.runOnThread(getSharedThread(), toCode(task, params));
+}
+
+/**
+ * Runs a task on a brand-new isolated thread and returns a handle to it.
+ * @param name - Optional display name (default: `RNThread-<id>`).
+ */
+export function runOnNewJS(task, params, name) {
+  const id = ReactNativeThread.createThread();
+  const resolvedName = name ?? `RNThread-${id}`;
+  _register(id, resolvedName);
+  ReactNativeThread.runOnThread(id, toCode(task, params));
+  return createThreadHandle(id, resolvedName);
+}
+
+/**
+ * Creates a persistent thread. Optionally give it a name.
+ * @param name - Display name (default: `RNThread-<id>`).
+ */
+export function createThread(name) {
+  const id = ReactNativeThread.createThread();
+  const resolvedName = name ?? `RNThread-${id}`;
+  _register(id, resolvedName);
+  return createThreadHandle(id, resolvedName);
+}
+
+/**
+ * Returns info about every live thread currently managed by this library,
+ * including the shared `runOnJS` thread once it has been started.
+ */
+export function getThreads() {
+  return Array.from(_registry.values());
+}
+
+/**
+ * Destroy a thread by its numeric ID **or** by its name.
+ * When a name is given, the first matching thread is destroyed.
+ * This is also what `ThreadHandle.destroy()` calls internally.
+ */
+export function destroyThread(idOrName) {
+  let targetId;
+  if (typeof idOrName === 'number') {
+    if (_registry.has(idOrName)) targetId = idOrName;
+  } else {
+    for (const info of _registry.values()) {
+      if (info.name === idOrName) {
+        targetId = info.id;
+        break;
+      }
+    }
+  }
+  if (targetId === undefined) {
+    if (__DEV__) {
+      console.warn(`[react-native-thread] destroyThread: no thread found for "${idOrName}"`);
+    }
+    return;
+  }
+  _unregister(targetId);
+  if (targetId === _sharedThreadId) _sharedThreadId = null;
+  ReactNativeThread.destroyThread(targetId);
+}
+export function onMessage(handler) {
+  if (handler) {
+    const sub = _emitter.addListener(RN_THREAD_MESSAGE_EVENT, event => {
+      let parsed = event.data;
+      try {
+        parsed = JSON.parse(event.data);
+      } catch {}
+      handler(parsed, event.threadId);
+    });
+    return () => sub.remove();
+  }
+  return new Promise(resolve => {
+    const sub = _emitter.addListener(RN_THREAD_MESSAGE_EVENT, event => {
+      let parsed = event.data;
+      try {
+        parsed = JSON.parse(event.data);
+      } catch {}
+      sub.remove();
+      resolve({
+        data: parsed,
+        threadId: event.threadId
+      });
+    });
+  });
+}
+function createThreadHandle(id, name) {
+  return {
+    id,
+    name,
+    run(task, params) {
+      ReactNativeThread.runOnThread(id, toCode(task, params));
+    },
+    onMessage: function (handler) {
+      if (handler) {
+        return onMessage((data, threadId) => {
+          if (threadId === id) handler(data);
+        });
+      }
+      return new Promise(resolve => {
+        const unsub = onMessage((data, threadId) => {
+          if (threadId === id) {
+            unsub();
+            resolve(data);
+          }
+        });
+      });
+    },
+    destroy() {
+      destroyThread(id);
+    }
+  };
+}
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeEventEmitter","ReactNativeThread","_emitter","RN_THREAD_MESSAGE_EVENT","_registry","Map","_register","id","name","set","_unregister","delete","toCode","task","params","paramsJson","undefined","JSON","stringify","src","toString","includes","test","__DEV__","console","warn","argsStr","SHARED_THREAD_NAME","_sharedThreadId","getSharedThread","createThread","runOnJS","runOnThread","runOnNewJS","resolvedName","createThreadHandle","getThreads","Array","from","values","destroyThread","idOrName","targetId","has","info","onMessage","handler","sub","addListener","event","parsed","data","parse","threadId","remove","Promise","resolve","run","unsub","destroy"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}