Kotlinify react.bridge.CatalystInstance interface (facebook#44545)

Summary:
Pull Request resolved: facebook#44545

# Changelog:
[Internal] -

As in the title.

Differential Revision: D57253633

packages/react-native/ReactAndroid/api/ReactAndroid.api

@@ -792,6 +792,10 @@ public abstract interface class com/facebook/react/bridge/JSExceptionHandler {
 	public abstract fun handleException (Ljava/lang/Exception;)V
 }
 
+public abstract interface class com/facebook/react/bridge/JSInstance {
+	public abstract fun invokeCallback (ILcom/facebook/react/bridge/NativeArrayInterface;)V
+}
+
 public class com/facebook/react/bridge/JSONArguments {
 	public fun <init> ()V
 	public static fun fromJSONArray (Lorg/json/JSONArray;)Lcom/facebook/react/bridge/ReadableArray;

packages/react-native/ReactAndroid/src/main/java/com/facebook/react/bridge/CatalystInstance.kt

@@ -0,0 +1,120 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+package com.facebook.react.bridge
+
+import com.facebook.proguard.annotations.DoNotStrip
+import com.facebook.react.bridge.queue.ReactQueueConfiguration
+import com.facebook.react.common.annotations.DeprecatedInNewArchitecture
+import com.facebook.react.common.annotations.VisibleForTesting
+import com.facebook.react.internal.turbomodule.core.interfaces.TurboModuleRegistry
+import com.facebook.react.turbomodule.core.interfaces.CallInvokerHolder
+import com.facebook.react.turbomodule.core.interfaces.NativeMethodCallInvokerHolder
+
+/**
+ * A higher level API on top of the asynchronous JSC bridge. This provides an environment allowing
+ * the invocation of JavaScript methods and lets a set of Java APIs be invocable from JavaScript as
+ * well.
+ */
+@DoNotStrip
+public interface CatalystInstance : MemoryPressureListener, JSInstance, JSBundleLoaderDelegate {
+  public fun runJSBundle()
+
+  // Returns the status of running the JS bundle; waits for an answer if runJSBundle is running
+  public fun hasRunJSBundle(): Boolean
+
+  /**
+   * Return the source URL of the JS Bundle that was run, or `null` if no JS bundle has been run
+   * yet.
+   */
+  public val sourceURL: String?
+
+  // This is called from java code, so it won't be stripped anyway, but proguard will rename it,
+  // which this prevents.
+  @DoNotStrip public override fun invokeCallback(callbackID: Int, arguments: NativeArrayInterface)
+
+  @DoNotStrip public fun callFunction(module: String, method: String, arguments: NativeArray?)
+
+  /**
+   * Destroys this catalyst instance, waiting for any other threads in ReactQueueConfiguration
+   * (besides the UI thread) to finish running. Must be called from the UI thread so that we can
+   * fully shut down other threads.
+   */
+  public fun destroy()
+
+  public val isDestroyed: Boolean
+
+  /** Initialize all the native modules */
+  @VisibleForTesting public fun initialize()
+
+  public val reactQueueConfiguration: ReactQueueConfiguration?
+
+  public fun <T : JavaScriptModule> getJSModule(jsInterface: Class<T>): T?
+
+  public fun <T : NativeModule> hasNativeModule(nativeModuleInterface: Class<T>): Boolean
+
+  public fun <T : NativeModule> getNativeModule(nativeModuleInterface: Class<T>): T?
+
+  public fun getNativeModule(moduleName: String): NativeModule?
+
+  public val nativeModules: Collection<NativeModule>
+
+  /**
+   * This method permits a CatalystInstance to extend the known Native modules. This provided
+   * registry contains only the new modules to load.
+   */
+  public fun extendNativeModules(modules: NativeModuleRegistry)
+
+  /**
+   * Adds a idle listener for this Catalyst instance. The listener will receive notifications
+   * whenever the bridge transitions from idle to busy and vice-versa, where the busy state is
+   * defined as there being some non-zero number of calls to JS that haven't resolved via a
+   * onBatchCompleted call. The listener should be purely passive and not affect application logic.
+   */
+  public fun addBridgeIdleDebugListener(listener: NotThreadSafeBridgeIdleDebugListener)
+
+  /**
+   * Removes a NotThreadSafeBridgeIdleDebugListener previously added with
+   * [ ][.addBridgeIdleDebugListener]
+   */
+  public fun removeBridgeIdleDebugListener(listener: NotThreadSafeBridgeIdleDebugListener)
+
+  /** This method registers the file path of an additional JS segment by its ID. */
+  public fun registerSegment(segmentId: Int, path: String)
+
+  @VisibleForTesting public fun setGlobalVariable(propName: String, jsonValue: String)
+
+  @get:Deprecated("") public val javaScriptContextHolder: JavaScriptContextHolder?
+  public val runtimeExecutor: RuntimeExecutor?
+  public val runtimeScheduler: RuntimeScheduler?
+
+  @get:Deprecated("") public val jSCallInvokerHolder: CallInvokerHolder?
+
+  /**
+   * Returns a hybrid object that contains a pointer to a NativeMethodCallInvoker, which is used to
+   * schedule work on the NativeModules thread. Required for TurboModuleManager initialization.
+   */
+  public val nativeMethodCallInvokerHolder: NativeMethodCallInvokerHolder?
+
+  @DeprecatedInNewArchitecture(
+      message =
+          "This method will be deprecated later as part of Stable APIs with bridge removal and not" +
+              " encouraged usage.")
+  public fun setTurboModuleRegistry(turboModuleRegistry: TurboModuleRegistry)
+
+  @DeprecatedInNewArchitecture(
+      message =
+          "This method will be deprecated later as part of Stable APIs with bridge removal and not" +
+              " encouraged usage.")
+  public fun setFabricUIManager(fabricUIManager: UIManager)
+
+  @DeprecatedInNewArchitecture(
+      message =
+          "This method will be deprecated later as part of Stable APIs with bridge removal and not" +
+              " encouraged usage.")
+  public fun getFabricUIManager(): UIManager?
+}

packages/react-native/ReactAndroid/src/main/java/com/facebook/react/bridge/JSInstance.kt

@@ -11,7 +11,7 @@ package com.facebook.react.bridge
  * This interface includes the methods needed to use a running JS instance, without specifying any
  * of the bridge-specific initialization or lifecycle management.
  */
-internal interface JSInstance {
+public interface JSInstance {
   public fun invokeCallback(callbackID: Int, arguments: NativeArrayInterface)
 
   // TODO if this interface survives refactoring, think about adding

packages/react-native/ReactAndroid/src/main/java/com/facebook/react/runtime/BridgelessCatalystInstance.kt

@@ -63,37 +63,40 @@ public class BridgelessCatalystInstance(private val reactHost: ReactHostImpl) :
     throw UnsupportedOperationException("Unimplemented method 'hasRunJSBundle'")
   }
 
-  override fun getSourceURL(): String? {
-    throw UnsupportedOperationException("Unimplemented method 'getSourceURL'")
-  }
-
   @DoNotStrip
   override fun invokeCallback(callbackID: Int, arguments: NativeArrayInterface) {
     throw UnsupportedOperationException("Unimplemented method 'invokeCallback'")
   }
 
-  override fun callFunction(module: String, method: String, arguments: NativeArray) {
+  override fun callFunction(module: String, method: String, arguments: NativeArray?) {
     throw UnsupportedOperationException("Unimplemented method 'callFunction'")
   }
 
   override fun destroy() {
     throw UnsupportedOperationException("Unimplemented method 'destroy'")
   }
 
-  override fun isDestroyed(): Boolean {
-    throw UnsupportedOperationException("Unimplemented method 'isDestroyed'")
-  }
+  override public val isDestroyed: Boolean
+    get() = throw UnsupportedOperationException("Unimplemented method 'isDestroyed'")
 
   @VisibleForTesting
   override fun initialize() {
     throw UnsupportedOperationException("Unimplemented method 'initialize'")
   }
 
-  override fun getReactQueueConfiguration(): ReactQueueConfiguration =
-      reactHost.reactQueueConfiguration!!
+  override fun <T : JavaScriptModule> getJSModule(jsInterface: Class<T>): T? =
+      reactHost.currentReactContext?.getJSModule(jsInterface)
+
+  override public val javaScriptContextHolder: JavaScriptContextHolder?
+    get() = reactHost.getJavaScriptContextHolder()
+
+  override public val jSCallInvokerHolder: CallInvokerHolder?
+    get() = reactHost.getJSCallInvokerHolder()
 
-  override fun <T : JavaScriptModule> getJSModule(jsInterface: Class<T>): T =
-      reactHost.currentReactContext?.getJSModule(jsInterface)!!
+  override public val nativeMethodCallInvokerHolder: NativeMethodCallInvokerHolder?
+    get() =
+        throw UnsupportedOperationException(
+            "Unimplemented method 'getNativeMethodCallInvokerHolder'")
 
   override fun <T : NativeModule> hasNativeModule(nativeModuleInterface: Class<T>): Boolean =
       reactHost.hasNativeModule(nativeModuleInterface)
@@ -104,12 +107,25 @@ public class BridgelessCatalystInstance(private val reactHost: ReactHostImpl) :
   override fun getNativeModule(moduleName: String): NativeModule? =
       reactHost.getNativeModule(moduleName)
 
-  override fun getNativeModules(): Collection<NativeModule> = reactHost.getNativeModules()
+  override public val nativeModules: Collection<NativeModule>
+    get() = reactHost.getNativeModules()
 
-  override fun extendNativeModules(modules: NativeModuleRegistry) {
+  override public val reactQueueConfiguration: ReactQueueConfiguration?
+    get() = reactHost.reactQueueConfiguration
+
+  override public val runtimeExecutor: RuntimeExecutor?
+    get() = reactHost.getRuntimeExecutor()
+
+  override public val runtimeScheduler: RuntimeScheduler?
+    get() = throw UnsupportedOperationException("Unimplemented method 'getRuntimeScheduler'")
+
+  override public fun extendNativeModules(modules: NativeModuleRegistry) {
     throw UnsupportedOperationException("Unimplemented method 'extendNativeModules'")
   }
 
+  override public val sourceURL: String?
+    get() = throw UnsupportedOperationException("Unimplemented method 'getSourceURL'")
+
   override fun addBridgeIdleDebugListener(listener: NotThreadSafeBridgeIdleDebugListener) {
     throw UnsupportedOperationException("Unimplemented method 'addBridgeIdleDebugListener'")
   }
@@ -127,27 +143,6 @@ public class BridgelessCatalystInstance(private val reactHost: ReactHostImpl) :
     throw UnsupportedOperationException("Unimplemented method 'setGlobalVariable'")
   }
 
-  @Deprecated(message = "This API is unsupported in the New Architecture.")
-  override fun getJavaScriptContextHolder(): JavaScriptContextHolder? {
-    return reactHost.getJavaScriptContextHolder()
-  }
-
-  override fun getRuntimeExecutor(): RuntimeExecutor? {
-    return reactHost.getRuntimeExecutor()
-  }
-
-  override fun getRuntimeScheduler(): RuntimeScheduler {
-    throw UnsupportedOperationException("Unimplemented method 'getRuntimeScheduler'")
-  }
-
-  override fun getJSCallInvokerHolder(): CallInvokerHolder? {
-    return reactHost.getJSCallInvokerHolder()
-  }
-
-  override fun getNativeMethodCallInvokerHolder(): NativeMethodCallInvokerHolder {
-    throw UnsupportedOperationException("Unimplemented method 'getNativeMethodCallInvokerHolder'")
-  }
-
   @DeprecatedInNewArchitecture(
       message =
           "This method will be deprecated later as part of Stable APIs with bridge removal and not encouraged usage.")