@rn-org/react-native-thread 0.2.0 → 0.4.0

package/README.md

@@ -22,7 +22,7 @@ Run JavaScript on real background threads in React Native — no Workers, no Wor
   - [ThreadInfo](#threadinfo)
   - [ThreadTask](#threadtask)
 - [Thread globals](#thread-globals)
-  - [postMessage](#postmessage)
+  - [resolveThreadMessage](#resolvethreadmessage)
   - [console](#console)
   - [`__params__`](#__params__)
 - [Hermes & Babel plugin](#hermes--babel-plugin-deep-dive)
@@ -37,7 +37,7 @@ Run JavaScript on real background threads in React Native — no Workers, no Wor
 - **True background threads** — each thread runs its own JS engine on an OS-level thread; the main Hermes/JSC runtime is never blocked.
 - **Unlimited threads** — create as many threads as you need; each is isolated.
 - **Shared thread** (`runOnJS`) — fire-and-forget tasks on a single persistent background thread; no teardown required.
-- **Per-thread message passing** — call `postMessage(data)` from any thread, receive it on the main thread with `onMessage` (callback or `await`).
+- **Per-thread message passing** — call `resolveThreadMessage(data)` from any thread, receive it on the main thread with `onMessage` (callback or `await`).
 - **Parameter injection** — pass a JSON-serialisable value from the main thread into the background function as a typed argument `(args) => { ... }`.
 - **Named threads** — give threads friendly names; list or destroy them by name.
 - **Full `console` support** — `console.log/info/warn/error/debug` work inside threads and appear in Logcat / Xcode logs.
@@ -114,7 +114,7 @@ thread.run(
   (args) => {
     var result = 0;
     for (var i = 0; i < args.limit; i++) result += i;
-    postMessage({ sum: result });
+    resolveThreadMessage({ sum: result });
   },
   { limit: 1_000_000 }
 );
@@ -237,7 +237,7 @@ function onMessage(
 function onMessage(): Promise<{ data: unknown; threadId: number }>
 ```
 
-Global listener that fires whenever **any** thread calls `postMessage(data)`. Prefer `ThreadHandle.onMessage` if you want messages scoped to a single thread.
+Global listener that fires whenever **any** thread calls `resolveThreadMessage(data)`. Prefer `ThreadHandle.onMessage` if you want messages scoped to a single thread.
 
 ```ts
 // Callback variant
@@ -275,7 +275,7 @@ type ThreadHandle = {
 | `id` | Numeric ID assigned by the native layer. |
 | `name` | Display name provided at creation (or the default `RNThread-<id>`). |
 | `run(task, params?)` | Execute `task` on this thread. `params` is passed as the first argument to the function. Can be called multiple times. |
-| `onMessage(handler)` | Subscribe to `postMessage` output from **this thread only**. Returns an unsubscribe function. |
+| `onMessage(handler)` | Subscribe to `resolveThreadMessage` output from **this thread only**. Returns an unsubscribe function. |
 | `onMessage()` | Returns a `Promise` that resolves with the next message from **this thread only**, then auto-unsubscribes. |
 | `destroy()` | Shut down the thread and remove it from the registry. Equivalent to calling `destroyThread(handle.id)`. |
 
@@ -308,17 +308,17 @@ Either an arrow function / function expression (transformed by the Babel plugin)
 
 These globals are available inside every thread function:
 
-### `postMessage`
+### `resolveThreadMessage`
 
 ```ts
-declare function postMessage(data: unknown): void
+declare function resolveThreadMessage(data: unknown): void
 ```
 
 Sends `data` back to the main JS thread. The value is JSON-serialised in the background thread and JSON-parsed before reaching the `onMessage` handler. Must be JSON-serialisable (`object`, `array`, `string`, `number`, `boolean`, or `null`).
 
 ```ts
 thread.run((args) => {
-  postMessage({ status: 'done', value: args.multiply * 2 });
+  resolveThreadMessage({ status: 'done', value: args.multiply * 2 });
 }, { multiply: 21 });
 
 // Callback
@@ -359,7 +359,7 @@ thread.run(
     for (var i = 0; i < args.iterations; i++) {
       // ...
     }
-    postMessage('done');
+    resolveThreadMessage('done');
   },
   { iterations: 50_000 }
 );
@@ -370,14 +370,14 @@ thread.run(
     for (var i = 0; i < __params__.iterations; i++) {
       // ...
     }
-    postMessage('done');
+    resolveThreadMessage('done');
   },
   { iterations: 50_000 }
 );
 
 // Option C — raw code string (only __params__ is available)
 thread.run(
-  'for (var i = 0; i < __params__.iterations; i++) {} postMessage("done")',
+  'for (var i = 0; i < __params__.iterations; i++) {} resolveThreadMessage("done")',
   { iterations: 50_000 }
 );
 ```
@@ -403,11 +403,11 @@ The included Babel plugin runs at **compile time** — before Hermes touches the
 ```js
 // Input (your source)
 thread.run((args) => {
-  postMessage(args.greeting);
+  resolveThreadMessage(args.greeting);
 }, { greeting: 'hello' });
 
 // Output (what Hermes compiles)
-thread.run("((args) => {\n  postMessage(args.greeting);\n})(__params__)", { greeting: 'hello' });
+thread.run("((args) => {\n  resolveThreadMessage(args.greeting);\n})(__params__)", { greeting: 'hello' });
 ```
 
 The second `params` argument is left untouched; only the first (function) argument is transformed.
@@ -424,7 +424,7 @@ The second `params` argument is left untouched; only the first (function) argume
 ### Limitations
 
 - Thread functions are **self-contained**: they run in an isolated JS engine with no access to the outer closure, imported modules, or the React tree.
-- All values must be passed explicitly via the `args` parameter, `__params__`, or `postMessage`.
+- All values must be passed explicitly via the `args` parameter, `__params__`, or `resolveThreadMessage`.
 - Thread function bodies must be **ASCII-safe**: Rhino (Android) does not support non-ASCII identifier characters in source mode.
 - The `params` value must be **JSON-serialisable**: functions, `undefined`, `Map`, `Set`, etc. are not supported.
 
@@ -436,7 +436,7 @@ The second `params` argument is left untouched; only the first (function) argume
 |---|---|
 | Functions are closure-isolated | They run in a completely separate JS engine |
 | `params` must be JSON-serialisable | Serialised and passed as a function argument |
-| `postMessage` payload must be JSON-serialisable | Transported as a JSON string over the bridge |
+| `resolveThreadMessage` payload must be JSON-serialisable | Transported as a JSON string over the bridge |
 | Function body must be ASCII-safe | Rhino parser limitation |
 | New Architecture required | TurboModule / Codegen only; no bridge fallback |
 

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

@@ -27,11 +27,8 @@ class ReactNativeThreadModule(reactContext: ReactApplicationContext) :
   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 addListener(eventName: String?) {}
+  override fun removeListeners(count: Double) {}
 
   override fun createThread(): Double {
     val id = nextId.getAndIncrement()
@@ -46,7 +43,7 @@ class ReactNativeThreadModule(reactContext: ReactApplicationContext) :
         cx.optimizationLevel = -1
         val scope = cx.initStandardObjects()
         injectConsole(scope, id)
-        injectPostMessage(scope, id)
+        injectResolveThreadMessage(scope, id)
         scopeFuture.complete(scope)
       } catch (e: Exception) {
         scopeFuture.completeExceptionally(e)
@@ -84,13 +81,11 @@ class ReactNativeThreadModule(reactContext: ReactApplicationContext) :
     entry.executor.shutdown()
   }
 
-  // ─── Scope injection ────────────────────────────────────────────────────────
-
-  private fun injectPostMessage(scope: Scriptable, threadId: Long) {
+  private fun injectResolveThreadMessage(scope: Scriptable, threadId: Long) {
     val ctx = reactApplicationContext
     ScriptableObject.putProperty(
       scope as ScriptableObject,
-      "postMessage",
+      "resolveThreadMessage",
       object : BaseFunction() {
         override fun call(
           cx: RhinoContext,

package/ios/ReactNativeThread.mm

@@ -1,23 +1,16 @@
 #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;
@@ -33,7 +26,6 @@
     return self;
 }
 
-// Required by RCTEventEmitter
 - (NSArray<NSString *> *)supportedEvents {
     return @[@"RNThreadMessage"];
 }
@@ -41,16 +33,12 @@
 - (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);
@@ -58,9 +46,6 @@
 
     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];
@@ -68,7 +53,6 @@
             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"] = ^{
@@ -93,10 +77,9 @@
         };
         t.context[@"console"] = console;
 
-        // ── postMessage ───────────────────────────────────────────────────────
         NSUInteger capturedTid = tidForLog;
         __weak ReactNativeThread *weakSelf = self;
-        t.context[@"postMessage"] = ^(JSValue *data) {  // evaluated on t.queue
+        t.context[@"resolveThreadMessage"] = ^(JSValue *data) {
             JSValue *jsonStr = [data.context[@"JSON"] invokeMethod:@"stringify"
                                                       withArguments:@[data]];
             NSString *serialised = [jsonStr toString];
@@ -114,7 +97,6 @@
             }];
         };
 
-        // Signal that the thread is ready to accept work.
         dispatch_semaphore_signal(t.ready);
     });
 
@@ -127,8 +109,6 @@
     return @(tid);
 }
 
-// ─── runOnThread ──────────────────────────────────────────────────────────────
-
 - (void)runOnThread:(double)threadId code:(NSString *)code {
     [_lock lock];
     RNThread *t = _threads[@(threadId)];
@@ -142,15 +122,12 @@
     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
+        dispatch_semaphore_signal(ready);
         [t.context evaluateScript:codeCopy];
     });
 }
 
-// ─── destroyThread ────────────────────────────────────────────────────────────
-
 - (void)destroyThread:(double)threadId {
     [_lock lock];
     RNThread *t = _threads[@(threadId)];
@@ -164,8 +141,6 @@
     });
 }
 
-// ─── TurboModule boilerplate ──────────────────────────────────────────────────
-
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
     (const facebook::react::ObjCTurboModule::InitParams &)params
 {

package/lib/module/babel-plugin.js

@@ -1,37 +1,10 @@
-/**
- * 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;
@@ -49,16 +22,12 @@ module.exports = function reactNativeThreadPlugin({
           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);

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

@@ -1 +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":[]}
+{"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,YAAY;;AAEZ,MAAMA,aAAa,GAAG,IAAIC,GAAG,CAAC,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAExD,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,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,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,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/index.js

@@ -2,13 +2,8 @@
 
 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, {
@@ -21,9 +16,6 @@ function _unregister(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}`;
   }
@@ -37,9 +29,6 @@ function toCode(task, params) {
   const argsStr = params !== undefined ? JSON.stringify(params) : '';
   return `(${src})(${argsStr})`;
 }
-
-// ─── Shared thread (runOnJS) ──────────────────────────────────────────────────
-
 const SHARED_THREAD_NAME = 'RNOrgThread';
 let _sharedThreadId = null;
 function getSharedThread() {
@@ -52,11 +41,6 @@ function getSharedThread() {
 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}`;
@@ -64,31 +48,15 @@ export function runOnNewJS(task, params, name) {
   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') {

package/lib/module/index.js.map

@@ -1 +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":[]}
+{"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/typescript/src/index.d.ts

@@ -1,5 +1,4 @@
 export type ThreadTask = ((args?: any) => void) | string;
-/** Snapshot of a single live thread. */
 export type ThreadInfo = {
     readonly id: number;
     readonly name: string;
@@ -7,39 +6,15 @@ export type ThreadInfo = {
 export type ThreadHandle = {
     readonly id: number;
     readonly name: string;
-    /**
-     * Run a task on this thread.
-     * @param params - Optional JSON-serialisable value passed as the first
-     *                 argument to the thread function.
-     */
     run(task: ThreadTask, params?: unknown): void;
-    /** Subscribe to messages from this thread. Returns an unsubscribe function. */
     onMessage(handler: (data: unknown) => void): () => void;
-    /** Returns a Promise that resolves with the next message from this thread. */
     onMessage(): Promise<unknown>;
     destroy(): void;
 };
 export declare function runOnJS(task: ThreadTask, params?: unknown): void;
-/**
- * Runs a task on a brand-new isolated thread and returns a handle to it.
- * @param name - Optional display name (default: `RNThread-<id>`).
- */
 export declare function runOnNewJS(task: ThreadTask, params?: unknown, name?: string): ThreadHandle;
-/**
- * Creates a persistent thread. Optionally give it a name.
- * @param name - Display name (default: `RNThread-<id>`).
- */
 export declare function createThread(name?: string): ThreadHandle;
-/**
- * Returns info about every live thread currently managed by this library,
- * including the shared `runOnJS` thread once it has been started.
- */
 export declare function getThreads(): ThreadInfo[];
-/**
- * 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 declare function destroyThread(idOrName: number | string): void;
 export declare function onMessage(handler: (data: unknown, threadId: number) => void): () => void;
 export declare function onMessage(): Promise<{

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC;AAEzD,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,+EAA+E;IAC/E,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxD,8EAA8E;IAC9E,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAyDF,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAEhE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY,CAMd;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAKxD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B7D;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GACjD,MAAM,IAAI,CAAC;AACd,wBAAgB,SAAS,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9C,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAmDF,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAEhE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY,CAMd;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAKxD;AAED,wBAAgB,UAAU,IAAI,UAAU,EAAE,CAEzC;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B7D;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GACjD,MAAM,IAAI,CAAC;AACd,wBAAgB,SAAS,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rn-org/react-native-thread",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Run JavaScript on real background threads in React Native — no Workers, no Worklets. Uses JavaScriptCore on iOS and Mozilla Rhino on Android. Built as a New Architecture TurboModule.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -53,7 +53,7 @@
     "turbo-module",
     "new-architecture",
     "worker",
-    "postmessage"
+    "resolveThreadMessage"
   ],
   "repository": {
     "type": "git",

package/src/babel-plugin.js

@@ -1,36 +1,10 @@
-/**
- * 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) &&
@@ -52,7 +26,6 @@ module.exports = function reactNativeThreadPlugin({ types: t }) {
       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);
@@ -60,7 +33,6 @@ module.exports = function reactNativeThreadPlugin({ types: t }) {
           return;
         }
 
-        // someThread.run(() => {})
         if (
           t.isMemberExpression(callee) &&
           !callee.computed &&

package/src/globals.d.ts

@@ -9,10 +9,10 @@
  * @example
  * thread.run(() => {
  *   const result = heavyWork();
- *   postMessage({ result });
+ *   resolveThreadMessage({ result });
  * });
  */
-declare function postMessage(data: unknown): void;
+declare function resolveThreadMessage(data: unknown): void;
 
 /**
  * Parameters passed by the caller via the optional second argument of

package/src/index.tsx

@@ -3,7 +3,6 @@ import ReactNativeThread from './NativeReactNativeThread';
 
 export type ThreadTask = ((args?: any) => void) | string;
 
-/** Snapshot of a single live thread. */
 export type ThreadInfo = {
   readonly id: number;
   readonly name: string;
@@ -12,15 +11,8 @@ export type ThreadInfo = {
 export type ThreadHandle = {
   readonly id: number;
   readonly name: string;
-  /**
-   * Run a task on this thread.
-   * @param params - Optional JSON-serialisable value passed as the first
-   *                 argument to the thread function.
-   */
   run(task: ThreadTask, params?: unknown): void;
-  /** Subscribe to messages from this thread. Returns an unsubscribe function. */
   onMessage(handler: (data: unknown) => void): () => void;
-  /** Returns a Promise that resolves with the next message from this thread. */
   onMessage(): Promise<unknown>;
   destroy(): void;
 };
@@ -28,7 +20,6 @@ export type ThreadHandle = {
 const _emitter = new NativeEventEmitter(ReactNativeThread);
 const RN_THREAD_MESSAGE_EVENT = 'RNThreadMessage';
 
-// ─── Thread registry (JS-layer; names are a JS concept) ──────────────────────
 const _registry = new Map<number, ThreadInfo>();
 
 function _register(id: number, name: string): void {
@@ -41,9 +32,6 @@ function _unregister(id: number): void {
 
 function toCode(task: ThreadTask, params?: unknown): string {
   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}`;
@@ -67,8 +55,6 @@ function toCode(task: ThreadTask, params?: unknown): string {
   return `(${src})(${argsStr})`;
 }
 
-// ─── Shared thread (runOnJS) ──────────────────────────────────────────────────
-
 const SHARED_THREAD_NAME = 'RNOrgThread';
 let _sharedThreadId: number | null = null;
 
@@ -84,10 +70,6 @@ export function runOnJS(task: ThreadTask, params?: unknown): void {
   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: ThreadTask,
   params?: unknown,
@@ -100,10 +82,6 @@ export function runOnNewJS(
   return createThreadHandle(id, resolvedName);
 }
 
-/**
- * Creates a persistent thread. Optionally give it a name.
- * @param name - Display name (default: `RNThread-<id>`).
- */
 export function createThread(name?: string): ThreadHandle {
   const id = ReactNativeThread.createThread();
   const resolvedName = name ?? `RNThread-${id}`;
@@ -111,19 +89,10 @@ export function createThread(name?: string): ThreadHandle {
   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(): ThreadInfo[] {
   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: number | string): void {
   let targetId: number | undefined;