@callstack/react-native-brownfield 3.0.0 → 3.1.0-rc.2

package/android/src/main/java/com/callstack/reactnativebrownfield/ReactNativeBrownfield.kt

@@ -17,12 +17,17 @@ import com.facebook.react.defaults.DefaultNewArchitectureEntryPoint.load
 import com.facebook.react.defaults.DefaultReactHost.getDefaultReactHost
 import com.facebook.react.soloader.OpenSourceMergedSoMapping
 import com.facebook.soloader.SoLoader
+import java.util.concurrent.CopyOnWriteArrayList
 import java.util.concurrent.atomic.AtomicBoolean
 
 fun interface OnJSBundleLoaded {
     operator fun invoke(initialized: Boolean)
 }
 
+fun interface OnMessageListener {
+    fun onMessage(message: String)
+}
+
 /**
  * The threshold RN version based on which we decide whether to
  * load JNI libs or not. We only load JNI libs on version less
@@ -31,9 +36,12 @@ fun interface OnJSBundleLoaded {
 private const val RN_THRESHOLD_VERSION = "0.80.0"
 
 class ReactNativeBrownfield private constructor(val reactHost: ReactHost) {
+    private val messageListeners = CopyOnWriteArrayList<OnMessageListener>()
+
     companion object {
         private lateinit var instance: ReactNativeBrownfield
         private val initialized = AtomicBoolean()
+        private const val LOG_TAG = "ReactNativeBrownfield"
 
         @JvmStatic
         val shared: ReactNativeBrownfield get() = instance
@@ -77,7 +85,8 @@ class ReactNativeBrownfield private constructor(val reactHost: ReactHost) {
                     packageList = (options["packages"] as? List<*> ?: emptyList<ReactPackage>())
                         .filterIsInstance<ReactPackage>(),
                     jsMainModulePath = options["mainModuleName"] as? String ?: "index",
-                    jsBundleAssetPath = options["bundleAssetPath"] as? String ?: "index.android.bundle",
+                    jsBundleAssetPath = options["bundleAssetPath"] as? String
+                        ?: "index.android.bundle",
                     jsBundleFilePath = options["bundleFilePath"] as? String,
                     useDevSupport = options["useDeveloperSupport"] as? Boolean
                         ?: ReactBuildConfig.DEBUG,
@@ -112,6 +121,42 @@ class ReactNativeBrownfield private constructor(val reactHost: ReactHost) {
         }
     }
 
+    /**
+     * Send a serialized JSON message to the React Native JS application. This resembles the web `window.postMessage` API.
+     * @note This method is available only on the New Architecture - on Old Architecture, it will be a no-op.
+     * @param message - The serialized JSON message to send to the React Native JS application.
+     * @example
+     * val json = JSONObject().put("text", text).toString()
+     * ReactNativeBrownfield.shared.postMessage(json)
+     */
+    fun postMessage(message: String) {
+        ReactNativeBrownfieldModule.emitMessageFromNative(message)
+    }
+
+    /**
+     * Register a listener for messages sent from the React Native JS application.
+     * @note This method is available only on the New Architecture - on Old Architecture, it will be a no-op.
+     * @param listener - The listener to register.
+     */
+    fun addMessageListener(listener: OnMessageListener) {
+        messageListeners.add(listener)
+    }
+
+    /**
+     * Remove a previously registered message listener.
+     * @note This method is available only on the New Architecture - on Old Architecture, it will be a no-op.
+     * @param listener - The listener to remove.
+     */
+    fun removeMessageListener(listener: OnMessageListener) {
+        messageListeners.remove(listener)
+    }
+
+    internal fun dispatchMessage(message: String) {
+        for (listener in messageListeners) {
+            listener.onMessage(message)
+        }
+    }
+
     fun createView(
         activity: FragmentActivity?,
         moduleName: String,

package/android/src/newarch/ReactNativeBrownfieldModule.kt

@@ -1,12 +1,33 @@
 package com.callstack.reactnativebrownfield
 
+import android.util.Log
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.buildReadableMap
 
-class ReactNativeBrownfieldModule(reactContext: ReactApplicationContext) :
+class ReactNativeBrownfieldModule(val reactContext: ReactApplicationContext) :
     NativeReactNativeBrownfieldModuleSpec(reactContext) {
     companion object {
         var shouldPopToNative: Boolean = false
+        private const val LOG_TAG = "ReactNativeBrownfieldModule"
+
+        private var sharedInstance: ReactNativeBrownfieldModule? = null
+
+        fun emitMessageFromNative(text: String) {
+            if (sharedInstance == null) {
+                Log.w(
+                    LOG_TAG,
+                    "No instance of ReactNativeBrownfieldModule found. Message will not be emitted."
+                )
+            }
+            sharedInstance?.emitOnBrownfieldMessage(buildReadableMap {
+                put("text", text)
+            })
+        }
+    }
+
+    init {
+        sharedInstance = this
     }
 
     @ReactMethod
@@ -25,6 +46,11 @@ class ReactNativeBrownfieldModule(reactContext: ReactApplicationContext) :
         shouldPopToNative = enabled
     }
 
+    override fun postMessage(message: String) {
+        ReactNativeBrownfield.shared.dispatchMessage(message)
+    }
+
+
     private fun onBackPressed() {
         reactApplicationContext.currentActivity?.runOnUiThread {
             reactApplicationContext.currentActivity?.onBackPressed()

package/android/src/oldarch/ReactNativeBrownfieldModule.kt

@@ -1,5 +1,6 @@
 package com.callstack.reactnativebrownfield
 
+import android.util.Log
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
@@ -8,6 +9,14 @@ class ReactNativeBrownfieldModule(reactContext: ReactApplicationContext) :
   ReactContextBaseJavaModule(reactContext) {
   companion object {
     var shouldPopToNative: Boolean = false
+    private const val LOG_TAG = "ReactNativeBrownfieldModule"
+
+    fun emitMessageFromNative(text: String) {
+      Log.w(
+          LOG_TAG,
+          "ReactNativeBrownfieldModule::emitMessageFromNative only supports the New Architecture. This call is ineffective and will not cause any messages to be emitted."
+      )
+    }
   }
 
   @ReactMethod
@@ -26,6 +35,17 @@ class ReactNativeBrownfieldModule(reactContext: ReactApplicationContext) :
     shouldPopToNative = isFirstRoute
   }
 
+  @ReactMethod
+  fun postMessage(message: String) {
+    ReactNativeBrownfield.shared.dispatchMessage(message)
+  }
+
+  @ReactMethod
+  fun addListener(eventName: String) {}
+
+  @ReactMethod
+  fun removeListeners(count: Double) {}
+
   private fun onBackPressed() {
     reactApplicationContext.currentActivity?.runOnUiThread {
       reactApplicationContext.currentActivity?.onBackPressed()

package/ios/Notification+Brownfield.swift

@@ -9,4 +9,12 @@ extension Notification.Name {
    * Notification sent to enable/disable the pop gesture recognizer.
    */
   public static let togglePopGestureRecognizer = Notification.Name("TogglePopGestureRecognizerNotification")
+  /**
+   * Notification sent when JS calls postMessage. UserInfo contains "message" key.
+   */
+  public static let brownfieldMessageFromJS = Notification.Name("BrownfieldMessageFromJSNotification")
+  /**
+   * Notification sent by native code to forward a message to JS. UserInfo contains "message" key.
+   */
+  public static let brownfieldMessageToJS = Notification.Name("BrownfieldMessageToJSNotification")
 }

package/ios/ReactNativeBrownfield.swift

@@ -134,4 +134,42 @@ internal import Expo
     ReactNativeHostRuntime.shared.startReactNative(onBundleLoaded: onBundleLoaded)
     #endif
   }
+
+  /**
+   * Send a serialized JSON message to the React Native JS application.
+   * The message is delivered as a `brownfieldMessage` DeviceEventEmitter event.
+   *
+   * @param message - The serialized JSON message to send to the React Native JS application.
+   * @example
+   * let json = "{\"text\":\"\(text)\"}"
+   * ReactNativeBrownfield.shared.postMessage(json)
+   */
+  @objc public func postMessage(_ message: String) {
+    let userInfo: [String: Any] = ["message": message]
+    DispatchQueue.main.async {
+      NotificationCenter.default.post(
+        name: Notification.Name.brownfieldMessageToJS,
+        object: nil,
+        userInfo: userInfo
+      )
+    }
+  }
+
+  /**
+   * Subscribe to messages sent from JavaScript via `ReactNativeBrownfield.postMessage()`.
+   *
+   * @param handler Called with the raw JSON string sent from JS.
+   * @return An observer token. Pass it to `NotificationCenter.default.removeObserver(_:)` to unsubscribe.
+   */
+  @objc public func onMessage(_ handler: @escaping (String) -> Void) -> NSObjectProtocol {
+    return NotificationCenter.default.addObserver(
+      forName: Notification.Name.brownfieldMessageFromJS,
+      object: nil,
+      queue: .main
+    ) { notification in
+      if let message = notification.userInfo?["message"] as? String {
+        handler(message)
+      }
+    }
+  }
 }

package/ios/ReactNativeBrownfieldModule.h

@@ -3,6 +3,10 @@
 #import <ReactNativeBrownfield/ReactNativeBrownfield.h>
 
 @interface ReactNativeBrownfieldModule : NativeReactNativeBrownfieldModuleSpecBase <NativeReactNativeBrownfieldModuleSpec>
+
+// Static helper for native code to emit events
++ (void)emitMessageFromNative:(NSString *)message;
+
 @end
 
 #endif

package/ios/ReactNativeBrownfieldModule.mm

@@ -10,6 +10,44 @@
 
 RCT_EXPORT_MODULE(ReactNativeBrownfield);
 
+static ReactNativeBrownfieldModule *_sharedInstance = nil;
+
+- (instancetype)init {
+  self = [super init];
+  if (self) {
+    _sharedInstance = self;
+
+    [[NSNotificationCenter defaultCenter] addObserver:self
+                                             selector:@selector(handleNativeToJSMessage:)
+                                                 name:@"BrownfieldMessageToJSNotification"
+                                               object:nil];
+  }
+  return self;
+}
+
+- (void)dealloc {
+  [[NSNotificationCenter defaultCenter] removeObserver:self];
+
+  if (_sharedInstance == self) {
+    _sharedInstance = nil;
+  }
+}
+
+- (void)handleNativeToJSMessage:(NSNotification *)notification {
+  NSString *message = notification.userInfo[@"message"];
+  if (message) {
+    [ReactNativeBrownfieldModule emitMessageFromNative:message];
+  }
+}
+
++ (void)emitMessageFromNative:(NSString *)message {
+  if (_sharedInstance) {
+    [_sharedInstance emitOnBrownfieldMessage:@{ @"text": message }];
+  } else {
+    NSLog(@"ReactNativeBrownfieldModule is not initialized, dropping message");
+  }
+}
+
 RCT_EXPORT_METHOD(setPopGestureRecognizerEnabled:(BOOL)enabled) {
   [ReactNativeBrownfieldModuleImpl setPopGestureRecognizerEnabled:enabled];
 }
@@ -18,6 +56,14 @@ RCT_EXPORT_METHOD(popToNative:(BOOL)animated) {
   [ReactNativeBrownfieldModuleImpl popToNativeWithAnimated:animated];
 }
 
+RCT_EXPORT_METHOD(postMessage:(NSString *)message) {
+  [ReactNativeBrownfieldModuleImpl postMessage:message];
+}
+
+RCT_EXPORT_METHOD(addListener:(NSString *)eventName) {}
+
+RCT_EXPORT_METHOD(removeListeners:(double)count) {}
+
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:(const facebook::react::ObjCTurboModule::InitParams &)params {
   return std::make_shared<facebook::react::NativeReactNativeBrownfieldModuleSpecJSI>(params);
 }

package/ios/ReactNativeBrownfieldModule.swift

@@ -15,4 +15,11 @@ public class ReactNativeBrownfieldModuleImpl: NSObject {
       NotificationCenter.default.post(name: Notification.Name.popToNative, object: nil, userInfo: userInfo)
     }
   }
+
+  static public func postMessage(_ message: String) {
+    let userInfo: [String: Any] = ["message": message]
+    DispatchQueue.main.async {
+      NotificationCenter.default.post(name: Notification.Name.brownfieldMessageFromJS, object: nil, userInfo: userInfo)
+    }
+  }
 }

package/lib/commonjs/NativeReactNativeBrownfieldModule.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactNativeBrownfieldModule.ts"],"mappings":"gFACA,IAAAA,YAAA,CAAAC,OAAA,iBAAmD,IAAAC,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAqBpCC,gCAAmB,CAACC,YAAY,CAAO,uBAAuB,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactNativeBrownfieldModule.ts"],"mappings":"gFACA,IAAAA,YAAA,CAAAC,OAAA,iBAAmD,IAAAC,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAiCpCC,gCAAmB,CAACC,YAAY,CAAO,uBAAuB,CAAC","ignoreList":[]}

package/lib/commonjs/index.js

@@ -1,2 +1,2 @@
-var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _reactNative=require("react-native");var _NativeReactNativeBrownfieldModule=_interopRequireDefault(require("./NativeReactNativeBrownfieldModule"));var ReactNativeBrownfield={popToNative:function popToNative(animated){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.popToNative(!!animated);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.popToNative(false);}else{console.warn('Not implemented: popToNative');}},setNativeBackGestureAndButtonEnabled:function setNativeBackGestureAndButtonEnabled(enabled){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.setPopGestureRecognizerEnabled(enabled);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.setHardwareBackButtonEnabled(enabled);}else{console.warn('Not implemented: setNativeGesturesAndButtonsEnabled');}}};var _default=exports.default=ReactNativeBrownfield;
+var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _reactNative=require("react-native");var _NativeReactNativeBrownfieldModule=_interopRequireDefault(require("./NativeReactNativeBrownfieldModule"));var ReactNativeBrownfield={popToNative:function popToNative(animated){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.popToNative(!!animated);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.popToNative(false);}else{console.warn('Not implemented: popToNative');}},setNativeBackGestureAndButtonEnabled:function setNativeBackGestureAndButtonEnabled(enabled){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.setPopGestureRecognizerEnabled(enabled);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.setHardwareBackButtonEnabled(enabled);}else{console.warn('Not implemented: setNativeGesturesAndButtonsEnabled');}},postMessage:function postMessage(data){var serialized=JSON.stringify(data);_NativeReactNativeBrownfieldModule.default.postMessage(serialized);},onMessage:function onMessage(callback){var subscription=_NativeReactNativeBrownfieldModule.default.onBrownfieldMessage(function(payload){try{callback({data:JSON.parse(payload.text)});}catch(_unused){callback({data:payload.text});}});return{remove:function remove(){return subscription.remove();}};}};var _default=exports.default=ReactNativeBrownfield;
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_NativeReactNativeBrownfieldModule","_interopRequireDefault","ReactNativeBrownfield","popToNative","animated","Platform","OS","ReactNativeBrownfieldModule","console","warn","setNativeBackGestureAndButtonEnabled","enabled","setPopGestureRecognizerEnabled","setHardwareBackButtonEnabled","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"mKAAA,IAAAA,YAAA,CAAAC,OAAA,iBACA,IAAAC,kCAAA,CAAAC,sBAAA,CAAAF,OAAA,yCAEA,GAAM,CAAAG,qBAAqB,CAAG,CAC5BC,WAAW,CAAE,QAAb,CAAAA,WAAWA,CAAGC,QAAkB,CAAW,CACzC,GAAIC,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACJ,WAAW,CAAC,CAAC,CAACC,QAAQ,CAAC,CACrD,CAAC,IAAM,IAAIC,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACJ,WAAW,CAAC,KAAK,CAAC,CAChD,CAAC,IAAM,CACLK,OAAO,CAACC,IAAI,CAAC,8BAA8B,CAAC,CAC9C,CACF,CAAC,CAEDC,oCAAoC,CAAE,QAAtC,CAAAA,oCAAoCA,CAAGC,OAAgB,CAAW,CAChE,GAAIN,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACK,8BAA8B,CAACD,OAAO,CAAC,CACrE,CAAC,IAAM,IAAIN,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACM,4BAA4B,CAACF,OAAO,CAAC,CACnE,CAAC,IAAM,CACLH,OAAO,CAACC,IAAI,CAAC,qDAAqD,CAAC,CACrE,CACF,CACF,CAAC,CAAC,IAAAK,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAEad,qBAAqB","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_NativeReactNativeBrownfieldModule","_interopRequireDefault","ReactNativeBrownfield","popToNative","animated","Platform","OS","ReactNativeBrownfieldModule","console","warn","setNativeBackGestureAndButtonEnabled","enabled","setPopGestureRecognizerEnabled","setHardwareBackButtonEnabled","postMessage","data","serialized","JSON","stringify","onMessage","callback","subscription","onBrownfieldMessage","payload","parse","text","_unused","remove","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"mKAAA,IAAAA,YAAA,CAAAC,OAAA,iBAEA,IAAAC,kCAAA,CAAAC,sBAAA,CAAAF,OAAA,yCAMA,GAAM,CAAAG,qBAAqB,CAAG,CAQ5BC,WAAW,CAAE,QAAb,CAAAA,WAAWA,CAAGC,QAAkB,CAAW,CACzC,GAAIC,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACJ,WAAW,CAAC,CAAC,CAACC,QAAQ,CAAC,CACrD,CAAC,IAAM,IAAIC,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACJ,WAAW,CAAC,KAAK,CAAC,CAChD,CAAC,IAAM,CACLK,OAAO,CAACC,IAAI,CAAC,8BAA8B,CAAC,CAC9C,CACF,CAAC,CAUDC,oCAAoC,CAAE,QAAtC,CAAAA,oCAAoCA,CAAGC,OAAgB,CAAW,CAChE,GAAIN,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACK,8BAA8B,CAACD,OAAO,CAAC,CACrE,CAAC,IAAM,IAAIN,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACM,4BAA4B,CAACF,OAAO,CAAC,CACnE,CAAC,IAAM,CACLH,OAAO,CAACC,IAAI,CAAC,qDAAqD,CAAC,CACrE,CACF,CAAC,CAYDK,WAAW,CAAE,QAAb,CAAAA,WAAWA,CAAGC,IAAa,CAAW,CACpC,GAAM,CAAAC,UAAU,CAAGC,IAAI,CAACC,SAAS,CAACH,IAAI,CAAC,CACvCR,0CAA2B,CAACO,WAAW,CAACE,UAAU,CAAC,CACrD,CAAC,CAeDG,SAAS,CAAE,QAAX,CAAAA,SAASA,CACPC,QAAuC,CACZ,CAC3B,GAAM,CAAAC,YAAY,CAAGd,0CAA2B,CAACe,mBAAmB,CAClE,SAACC,OAAO,CAAK,CACX,GAAI,CACFH,QAAQ,CAAC,CAAEL,IAAI,CAAEE,IAAI,CAACO,KAAK,CAACD,OAAO,CAACE,IAAI,CAAE,CAAC,CAAC,CAC9C,CAAE,MAAAC,OAAA,CAAM,CACNN,QAAQ,CAAC,CAAEL,IAAI,CAAEQ,OAAO,CAACE,IAAK,CAAC,CAAC,CAClC,CACF,CACF,CAAC,CACD,MAAO,CAAEE,MAAM,CAAE,QAAR,CAAAA,MAAMA,CAAA,QAAQ,CAAAN,YAAY,CAACM,MAAM,CAAC,CAAC,EAAC,CAAC,CAChD,CACF,CAAC,CAAC,IAAAC,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAEa5B,qBAAqB","ignoreList":[]}

package/lib/module/NativeReactNativeBrownfieldModule.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactNativeBrownfieldModule.ts"],"mappings":"gFACA,IAAAA,YAAA,CAAAC,OAAA,iBAAmD,IAAAC,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAqBpCC,gCAAmB,CAACC,YAAY,CAAO,uBAAuB,CAAC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_default","exports","default","TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeReactNativeBrownfieldModule.ts"],"mappings":"gFACA,IAAAA,YAAA,CAAAC,OAAA,iBAAmD,IAAAC,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAiCpCC,gCAAmB,CAACC,YAAY,CAAO,uBAAuB,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -1,2 +1,2 @@
-var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _reactNative=require("react-native");var _NativeReactNativeBrownfieldModule=_interopRequireDefault(require("./NativeReactNativeBrownfieldModule"));var ReactNativeBrownfield={popToNative:function popToNative(animated){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.popToNative(!!animated);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.popToNative(false);}else{console.warn('Not implemented: popToNative');}},setNativeBackGestureAndButtonEnabled:function setNativeBackGestureAndButtonEnabled(enabled){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.setPopGestureRecognizerEnabled(enabled);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.setHardwareBackButtonEnabled(enabled);}else{console.warn('Not implemented: setNativeGesturesAndButtonsEnabled');}}};var _default=exports.default=ReactNativeBrownfield;
+var _interopRequireDefault=require("@babel/runtime/helpers/interopRequireDefault");Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _reactNative=require("react-native");var _NativeReactNativeBrownfieldModule=_interopRequireDefault(require("./NativeReactNativeBrownfieldModule"));var ReactNativeBrownfield={popToNative:function popToNative(animated){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.popToNative(!!animated);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.popToNative(false);}else{console.warn('Not implemented: popToNative');}},setNativeBackGestureAndButtonEnabled:function setNativeBackGestureAndButtonEnabled(enabled){if(_reactNative.Platform.OS==='ios'){_NativeReactNativeBrownfieldModule.default.setPopGestureRecognizerEnabled(enabled);}else if(_reactNative.Platform.OS==='android'){_NativeReactNativeBrownfieldModule.default.setHardwareBackButtonEnabled(enabled);}else{console.warn('Not implemented: setNativeGesturesAndButtonsEnabled');}},postMessage:function postMessage(data){var serialized=JSON.stringify(data);_NativeReactNativeBrownfieldModule.default.postMessage(serialized);},onMessage:function onMessage(callback){var subscription=_NativeReactNativeBrownfieldModule.default.onBrownfieldMessage(function(payload){try{callback({data:JSON.parse(payload.text)});}catch(_unused){callback({data:payload.text});}});return{remove:function remove(){return subscription.remove();}};}};var _default=exports.default=ReactNativeBrownfield;
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_NativeReactNativeBrownfieldModule","_interopRequireDefault","ReactNativeBrownfield","popToNative","animated","Platform","OS","ReactNativeBrownfieldModule","console","warn","setNativeBackGestureAndButtonEnabled","enabled","setPopGestureRecognizerEnabled","setHardwareBackButtonEnabled","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"mKAAA,IAAAA,YAAA,CAAAC,OAAA,iBACA,IAAAC,kCAAA,CAAAC,sBAAA,CAAAF,OAAA,yCAEA,GAAM,CAAAG,qBAAqB,CAAG,CAC5BC,WAAW,CAAE,QAAb,CAAAA,WAAWA,CAAGC,QAAkB,CAAW,CACzC,GAAIC,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACJ,WAAW,CAAC,CAAC,CAACC,QAAQ,CAAC,CACrD,CAAC,IAAM,IAAIC,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACJ,WAAW,CAAC,KAAK,CAAC,CAChD,CAAC,IAAM,CACLK,OAAO,CAACC,IAAI,CAAC,8BAA8B,CAAC,CAC9C,CACF,CAAC,CAEDC,oCAAoC,CAAE,QAAtC,CAAAA,oCAAoCA,CAAGC,OAAgB,CAAW,CAChE,GAAIN,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACK,8BAA8B,CAACD,OAAO,CAAC,CACrE,CAAC,IAAM,IAAIN,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACM,4BAA4B,CAACF,OAAO,CAAC,CACnE,CAAC,IAAM,CACLH,OAAO,CAACC,IAAI,CAAC,qDAAqD,CAAC,CACrE,CACF,CACF,CAAC,CAAC,IAAAK,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAEad,qBAAqB","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_NativeReactNativeBrownfieldModule","_interopRequireDefault","ReactNativeBrownfield","popToNative","animated","Platform","OS","ReactNativeBrownfieldModule","console","warn","setNativeBackGestureAndButtonEnabled","enabled","setPopGestureRecognizerEnabled","setHardwareBackButtonEnabled","postMessage","data","serialized","JSON","stringify","onMessage","callback","subscription","onBrownfieldMessage","payload","parse","text","_unused","remove","_default","exports","default"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"mKAAA,IAAAA,YAAA,CAAAC,OAAA,iBAEA,IAAAC,kCAAA,CAAAC,sBAAA,CAAAF,OAAA,yCAMA,GAAM,CAAAG,qBAAqB,CAAG,CAQ5BC,WAAW,CAAE,QAAb,CAAAA,WAAWA,CAAGC,QAAkB,CAAW,CACzC,GAAIC,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACJ,WAAW,CAAC,CAAC,CAACC,QAAQ,CAAC,CACrD,CAAC,IAAM,IAAIC,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACJ,WAAW,CAAC,KAAK,CAAC,CAChD,CAAC,IAAM,CACLK,OAAO,CAACC,IAAI,CAAC,8BAA8B,CAAC,CAC9C,CACF,CAAC,CAUDC,oCAAoC,CAAE,QAAtC,CAAAA,oCAAoCA,CAAGC,OAAgB,CAAW,CAChE,GAAIN,qBAAQ,CAACC,EAAE,GAAK,KAAK,CAAE,CACzBC,0CAA2B,CAACK,8BAA8B,CAACD,OAAO,CAAC,CACrE,CAAC,IAAM,IAAIN,qBAAQ,CAACC,EAAE,GAAK,SAAS,CAAE,CACpCC,0CAA2B,CAACM,4BAA4B,CAACF,OAAO,CAAC,CACnE,CAAC,IAAM,CACLH,OAAO,CAACC,IAAI,CAAC,qDAAqD,CAAC,CACrE,CACF,CAAC,CAYDK,WAAW,CAAE,QAAb,CAAAA,WAAWA,CAAGC,IAAa,CAAW,CACpC,GAAM,CAAAC,UAAU,CAAGC,IAAI,CAACC,SAAS,CAACH,IAAI,CAAC,CACvCR,0CAA2B,CAACO,WAAW,CAACE,UAAU,CAAC,CACrD,CAAC,CAeDG,SAAS,CAAE,QAAX,CAAAA,SAASA,CACPC,QAAuC,CACZ,CAC3B,GAAM,CAAAC,YAAY,CAAGd,0CAA2B,CAACe,mBAAmB,CAClE,SAACC,OAAO,CAAK,CACX,GAAI,CACFH,QAAQ,CAAC,CAAEL,IAAI,CAAEE,IAAI,CAACO,KAAK,CAACD,OAAO,CAACE,IAAI,CAAE,CAAC,CAAC,CAC9C,CAAE,MAAAC,OAAA,CAAM,CACNN,QAAQ,CAAC,CAAEL,IAAI,CAAEQ,OAAO,CAACE,IAAK,CAAC,CAAC,CAClC,CACF,CACF,CAAC,CACD,MAAO,CAAEE,MAAM,CAAE,QAAR,CAAAA,MAAMA,CAAA,QAAQ,CAAAN,YAAY,CAACM,MAAM,CAAC,CAAC,EAAC,CAAC,CAChD,CACF,CAAC,CAAC,IAAAC,QAAA,CAAAC,OAAA,CAAAC,OAAA,CAEa5B,qBAAqB","ignoreList":[]}

package/lib/typescript/commonjs/src/NativeReactNativeBrownfieldModule.d.ts

@@ -1,4 +1,7 @@
-import type { TurboModule } from 'react-native';
+import type { CodegenTypes, TurboModule } from 'react-native';
+export type BrownfieldMessagePayload = {
+    text: string;
+};
 export interface Spec extends TurboModule {
     /**
      * Navigate back to the native part of the application.
@@ -14,6 +17,11 @@ export interface Spec extends TurboModule {
      * @platform android
      */
     setHardwareBackButtonEnabled(enabled: boolean): void;
+    /**
+     * Send a serialized JSON message to the native host application.
+     */
+    postMessage(message: string): void;
+    readonly onBrownfieldMessage: CodegenTypes.EventEmitter<BrownfieldMessagePayload>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/commonjs/src/NativeReactNativeBrownfieldModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeReactNativeBrownfieldModule.d.ts","sourceRoot":"","sources":["../../../../src/NativeReactNativeBrownfieldModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEvD;;;OAGG;IACH,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACtD;;AAED,wBAA+E"}
+{"version":3,"file":"NativeReactNativeBrownfieldModule.d.ts","sourceRoot":"","sources":["../../../../src/NativeReactNativeBrownfieldModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEvD;;;OAGG;IACH,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGnC,QAAQ,CAAC,mBAAmB,EAAE,YAAY,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;CACnF;;AAED,wBAA+E"}

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

@@ -1,6 +1,51 @@
+export interface MessageEvent {
+    data: unknown;
+}
 declare const ReactNativeBrownfield: {
+    /**
+     * Pop to the native screen.
+     * @param animated - Whether to animate the transition (iOS only).
+     * @platform android, ios
+     * @example
+     * ReactNativeBrownfield.popToNative(true);
+     */
     popToNative: (animated?: boolean) => void;
+    /**
+     * Enable or disable the iOS native back gesture and Android hardware back button.
+     * @note This method is available both on the New Architecture and the Old Architecture.
+     * @param enabled - Whether to enable native back gesture and button.
+     * @platform android, ios
+     * @example
+     * ReactNativeBrownfield.setNativeBackGestureAndButtonEnabled(true);
+     */
     setNativeBackGestureAndButtonEnabled: (enabled: boolean) => void;
+    /**
+     * Send a JSON-serializable message to the native host application. This resembles the web `window.postMessage` API.
+     * @note This method is available both on the New Architecture and the Old Architecture.
+     * @note This method requires the `data` to be JSON-serializable. The method does not catch any serialization errors thrown
+     * by the `JSON.stringify` function, this is the responsibility of the caller.
+     * @param data - The data to send to the native host application.
+     * @platform android, ios
+     * @example
+     * ReactNativeBrownfield.postMessage({ text: 'Hello from React Native!', id: 2 });
+     */
+    postMessage: (data: unknown) => void;
+    /**
+     * Subscribe to messages sent from the native host application. Returns a subscription object with a `remove()` method for cleanup.
+     * @param callback - The callback to invoke when a message is received from the native host application.
+     * @returns A subscription object with a `remove` method for cleanup.
+     * @platform android, ios
+     * @example
+     * const subscription = ReactNativeBrownfield.onMessage((event: MessageEvent) => {
+     *   console.log('Received from native:', event.data);
+     * });
+     *
+     * // Later, to unsubscribe:
+     * subscription.remove();
+     */
+    onMessage: (callback: (event: MessageEvent) => void) => {
+        remove: () => void;
+    };
 };
 export default ReactNativeBrownfield;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,qBAAqB;6BACA,OAAO,KAAG,IAAI;oDAUS,OAAO,KAAG,IAAI;CAS/D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,QAAA,MAAM,qBAAqB;IACzB;;;;;;OAMG;6BACsB,OAAO,KAAG,IAAI;IAUvC;;;;;;;OAOG;oDAC6C,OAAO,KAAG,IAAI;IAU9D;;;;;;;;;OASG;wBACiB,OAAO,KAAG,IAAI;IAKlC;;;;;;;;;;;;OAYG;0BAES,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,KACtC;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;CAY1B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/lib/typescript/module/src/NativeReactNativeBrownfieldModule.d.ts

@@ -1,4 +1,7 @@
-import type { TurboModule } from 'react-native';
+import type { CodegenTypes, TurboModule } from 'react-native';
+export type BrownfieldMessagePayload = {
+    text: string;
+};
 export interface Spec extends TurboModule {
     /**
      * Navigate back to the native part of the application.
@@ -14,6 +17,11 @@ export interface Spec extends TurboModule {
      * @platform android
      */
     setHardwareBackButtonEnabled(enabled: boolean): void;
+    /**
+     * Send a serialized JSON message to the native host application.
+     */
+    postMessage(message: string): void;
+    readonly onBrownfieldMessage: CodegenTypes.EventEmitter<BrownfieldMessagePayload>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/module/src/NativeReactNativeBrownfieldModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeReactNativeBrownfieldModule.d.ts","sourceRoot":"","sources":["../../../../src/NativeReactNativeBrownfieldModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEvD;;;OAGG;IACH,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACtD;;AAED,wBAA+E"}
+{"version":3,"file":"NativeReactNativeBrownfieldModule.d.ts","sourceRoot":"","sources":["../../../../src/NativeReactNativeBrownfieldModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEvD;;;OAGG;IACH,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGnC,QAAQ,CAAC,mBAAmB,EAAE,YAAY,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;CACnF;;AAED,wBAA+E"}

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

@@ -1,6 +1,51 @@
+export interface MessageEvent {
+    data: unknown;
+}
 declare const ReactNativeBrownfield: {
+    /**
+     * Pop to the native screen.
+     * @param animated - Whether to animate the transition (iOS only).
+     * @platform android, ios
+     * @example
+     * ReactNativeBrownfield.popToNative(true);
+     */
     popToNative: (animated?: boolean) => void;
+    /**
+     * Enable or disable the iOS native back gesture and Android hardware back button.
+     * @note This method is available both on the New Architecture and the Old Architecture.
+     * @param enabled - Whether to enable native back gesture and button.
+     * @platform android, ios
+     * @example
+     * ReactNativeBrownfield.setNativeBackGestureAndButtonEnabled(true);
+     */
     setNativeBackGestureAndButtonEnabled: (enabled: boolean) => void;
+    /**
+     * Send a JSON-serializable message to the native host application. This resembles the web `window.postMessage` API.
+     * @note This method is available both on the New Architecture and the Old Architecture.
+     * @note This method requires the `data` to be JSON-serializable. The method does not catch any serialization errors thrown
+     * by the `JSON.stringify` function, this is the responsibility of the caller.
+     * @param data - The data to send to the native host application.
+     * @platform android, ios
+     * @example
+     * ReactNativeBrownfield.postMessage({ text: 'Hello from React Native!', id: 2 });
+     */
+    postMessage: (data: unknown) => void;
+    /**
+     * Subscribe to messages sent from the native host application. Returns a subscription object with a `remove()` method for cleanup.
+     * @param callback - The callback to invoke when a message is received from the native host application.
+     * @returns A subscription object with a `remove` method for cleanup.
+     * @platform android, ios
+     * @example
+     * const subscription = ReactNativeBrownfield.onMessage((event: MessageEvent) => {
+     *   console.log('Received from native:', event.data);
+     * });
+     *
+     * // Later, to unsubscribe:
+     * subscription.remove();
+     */
+    onMessage: (callback: (event: MessageEvent) => void) => {
+        remove: () => void;
+    };
 };
 export default ReactNativeBrownfield;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,qBAAqB;6BACA,OAAO,KAAG,IAAI;oDAUS,OAAO,KAAG,IAAI;CAS/D,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,QAAA,MAAM,qBAAqB;IACzB;;;;;;OAMG;6BACsB,OAAO,KAAG,IAAI;IAUvC;;;;;;;OAOG;oDAC6C,OAAO,KAAG,IAAI;IAU9D;;;;;;;;;OASG;wBACiB,OAAO,KAAG,IAAI;IAKlC;;;;;;;;;;;;OAYG;0BAES,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,KACtC;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE;CAY1B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@callstack/react-native-brownfield",
-  "version": "3.0.0",
+  "version": "3.1.0-rc.2",
   "license": "MIT",
   "author": "Michal Chudziak <mike.chudziak@callstack.com>",
   "bin": {

package/src/NativeReactNativeBrownfieldModule.ts

@@ -1,6 +1,10 @@
-import type { TurboModule } from 'react-native';
+import type { CodegenTypes, TurboModule } from 'react-native';
 import { TurboModuleRegistry } from 'react-native';
 
+export type BrownfieldMessagePayload = {
+  text: string;
+};
+
 export interface Spec extends TurboModule {
   /**
    * Navigate back to the native part of the application.
@@ -18,6 +22,14 @@ export interface Spec extends TurboModule {
    * @platform android
    */
   setHardwareBackButtonEnabled(enabled: boolean): void;
+
+  /**
+   * Send a serialized JSON message to the native host application.
+   */
+  postMessage(message: string): void;
+
+  // Event emitter - must be readonly
+  readonly onBrownfieldMessage: CodegenTypes.EventEmitter<BrownfieldMessagePayload>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('ReactNativeBrownfield');

package/src/index.ts

@@ -1,7 +1,19 @@
 import { Platform } from 'react-native';
+
 import ReactNativeBrownfieldModule from './NativeReactNativeBrownfieldModule';
 
+export interface MessageEvent {
+  data: unknown;
+}
+
 const ReactNativeBrownfield = {
+  /**
+   * Pop to the native screen.
+   * @param animated - Whether to animate the transition (iOS only).
+   * @platform android, ios
+   * @example
+   * ReactNativeBrownfield.popToNative(true);
+   */
   popToNative: (animated?: boolean): void => {
     if (Platform.OS === 'ios') {
       ReactNativeBrownfieldModule.popToNative(!!animated);
@@ -12,6 +24,14 @@ const ReactNativeBrownfield = {
     }
   },
 
+  /**
+   * Enable or disable the iOS native back gesture and Android hardware back button.
+   * @note This method is available both on the New Architecture and the Old Architecture.
+   * @param enabled - Whether to enable native back gesture and button.
+   * @platform android, ios
+   * @example
+   * ReactNativeBrownfield.setNativeBackGestureAndButtonEnabled(true);
+   */
   setNativeBackGestureAndButtonEnabled: (enabled: boolean): void => {
     if (Platform.OS === 'ios') {
       ReactNativeBrownfieldModule.setPopGestureRecognizerEnabled(enabled);
@@ -21,6 +41,49 @@ const ReactNativeBrownfield = {
       console.warn('Not implemented: setNativeGesturesAndButtonsEnabled');
     }
   },
+
+  /**
+   * Send a JSON-serializable message to the native host application. This resembles the web `window.postMessage` API.
+   * @note This method is available both on the New Architecture and the Old Architecture.
+   * @note This method requires the `data` to be JSON-serializable. The method does not catch any serialization errors thrown
+   * by the `JSON.stringify` function, this is the responsibility of the caller.
+   * @param data - The data to send to the native host application.
+   * @platform android, ios
+   * @example
+   * ReactNativeBrownfield.postMessage({ text: 'Hello from React Native!', id: 2 });
+   */
+  postMessage: (data: unknown): void => {
+    const serialized = JSON.stringify(data);
+    ReactNativeBrownfieldModule.postMessage(serialized);
+  },
+
+  /**
+   * Subscribe to messages sent from the native host application. Returns a subscription object with a `remove()` method for cleanup.
+   * @param callback - The callback to invoke when a message is received from the native host application.
+   * @returns A subscription object with a `remove` method for cleanup.
+   * @platform android, ios
+   * @example
+   * const subscription = ReactNativeBrownfield.onMessage((event: MessageEvent) => {
+   *   console.log('Received from native:', event.data);
+   * });
+   *
+   * // Later, to unsubscribe:
+   * subscription.remove();
+   */
+  onMessage: (
+    callback: (event: MessageEvent) => void
+  ): { remove: () => void } => {
+    const subscription = ReactNativeBrownfieldModule.onBrownfieldMessage(
+      (payload) => {
+        try {
+          callback({ data: JSON.parse(payload.text) });
+        } catch {
+          callback({ data: payload.text });
+        }
+      }
+    );
+    return { remove: () => subscription.remove() };
+  },
 };
 
 export default ReactNativeBrownfield;