feat: native to JS bridge

Author: PalmDevs

api/build.gradle.kts

@@ -20,4 +20,8 @@ android {
 repositories {
     google()
     mavenCentral()
+}
+
+dependencies {
+    compileOnly("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2")
 }

api/src/main/kotlin/io/github/revenge/bridge/JavaScriptBridge.kt

@@ -0,0 +1,27 @@
+package io.github.revenge.bridge
+
+import InternalApi
+import io.github.revenge.bridge.impl.BridgeHost
+import io.github.revenge.plugins.MethodArgs
+
+@Suppress("UNUSED")
+@OptIn(InternalApi::class)
+/**
+ * Bridge for plugins to communicate with the JavaScript side of the application.
+ *
+ * In order for a method to be exposed, you must register the method using the `modules` API.
+ * Return values must be serializable by React Native, otherwise may result in unexpected behavior.
+ *
+ * ```js
+ * import { registerJSMethod } from '@revenge-mod/modules/native'
+ *
+ * registerJSMethod('meaningOfLife', (arg1, arg2) => {
+ *    console.log(arg1 + arg2)
+ *    return 42
+ * })
+ * ```
+ */
+object JavaScriptBridge {
+    fun callJSMethod(methodName: String, args: MethodArgs) =
+        BridgeHost.callJSMethod!!.invoke(methodName, args)
+}

api/src/main/kotlin/io/github/revenge/bridge/impl/BridgeHost.kt

@@ -0,0 +1,17 @@
+package io.github.revenge.bridge.impl
+
+import InternalApi
+import io.github.revenge.plugins.MethodArgs
+import kotlinx.coroutines.CompletableDeferred
+
+@Suppress("UNUSED")
+@InternalApi
+/**
+ * Host for the bridge system to communicate with the application. For example, a Xposed module.
+ */
+object BridgeHost {
+    /**
+     * Callback for when a plugin calls a JS method.
+     */
+    var callJSMethod: ((methodName: String, args: MethodArgs) -> CompletableDeferred<Any?>)? = null
+}

api/src/main/kotlin/io/github/revenge/plugins/MethodCallback.kt

@@ -1,11 +1,17 @@
 package io.github.revenge.plugins
 
 /**
- * See for possible return types:
- * https://github.com/facebook/react-native/blob/c23e84ae9/packages/react-native/ReactAndroid/src/main/java/com/facebook/react/bridge/Arguments.kt#L19
+ * You may return a [Unit] and it will be converted to `null`.
  *
- * You may return a [Unit] and the resulting value will be `null`.
+ * See [NativeObject] for more information.
  */
-typealias MethodCallback = (args: MethodArgs) -> Any?
+typealias MethodCallback = (args: MethodArgs) -> NativeObject
 
-typealias MethodArgs = ArrayList<Any?>
+typealias MethodArgs = ArrayList<NativeObject>
+
+/**
+ * Represents a React Native JNI serializable object. These objects can be passed to JavaScript as values.
+ *
+ * See: https://github.com/facebook/react-native/blob/7dcedf1/packages/react-native/ReactAndroid/src/main/java/com/facebook/react/bridge/Arguments.kt#L19
+ */
+typealias NativeObject = Any?