expo-modules-core 3.0.12 → 3.0.14

package/CHANGELOG.md

@@ -10,6 +10,22 @@
 
 ### 💡 Others
 
+## 3.0.14 — 2025-09-08
+
+### 🐛 Bug fixes
+
+- [Android] Fix type check in the `SharedRef` converter. ([#39446](https://github.com/expo/expo/pull/39446) by [@lukmccall](https://github.com/lukmccall))
+
+### 💡 Others
+
+- improve startup performance by not relying on kotlin reflection. ([#39389](https://github.com/expo/expo/pull/39389) by [@ACHP](https://github.com/ACHP))
+
+## 3.0.13 — 2025-09-04
+
+### 💡 Others
+
+- [Android] Remove some usage of `kotlin.reflect.full.*`. ([#39385](https://github.com/expo/expo/pull/39385) by [@lukmccall](https://github.com/lukmccall))
+
 ## 3.0.12 — 2025-09-03
 
 ### 💡 Others

package/android/build.gradle

@@ -25,7 +25,7 @@ if (shouldIncludeCompose) {
 }
 
 group = 'host.exp.exponent'
-version = '3.0.12'
+version = '3.0.14'
 
 def isExpoModulesCoreTests = {
   Gradle gradle = getGradle()
@@ -75,7 +75,7 @@ android {
   defaultConfig {
     consumerProguardFiles 'proguard-rules.pro'
     versionCode 1
-    versionName "3.0.12"
+    versionName "3.0.14"
     buildConfigField "String", "EXPO_MODULES_CORE_VERSION", "\"${versionName}\""
     buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled.toString()
 

package/android/src/main/java/expo/modules/kotlin/{modules/ModuleUtils.kt → EnumExtensions.kt}

@@ -1,13 +1,12 @@
-package expo.modules.kotlin.modules
+package expo.modules.kotlin
 
 import expo.modules.kotlin.types.Enumerable
 import kotlin.reflect.KProperty1
 import kotlin.reflect.full.declaredMemberProperties
-import kotlin.reflect.full.primaryConstructor
 
-internal fun <T> convertEnumToString(enumValue: T): String where T : Enumerable, T : Enum<T> {
-  val enumClass = enumValue::class
-  val primaryConstructor = enumClass.primaryConstructor
+fun <T> T.convertToString(): String where T : Enum<T>, T : Enumerable {
+  val enumClass = this::class
+  val primaryConstructor = enumClass.fastPrimaryConstructor
   if (primaryConstructor?.parameters?.size == 1) {
     val parameterName = primaryConstructor.parameters.first().name
     val parameterProperty = enumClass
@@ -18,8 +17,8 @@ internal fun <T> convertEnumToString(enumValue: T): String where T : Enumerable,
     require(parameterProperty.returnType.classifier == String::class) { "The enum parameter has to be a string." }
 
     @Suppress("UNCHECKED_CAST")
-    return (parameterProperty as KProperty1<T, String>).get(enumValue)
+    return (parameterProperty as KProperty1<T, String>).get(this)
   }
 
-  return enumValue.name
+  return this.name
 }

package/android/src/main/java/expo/modules/kotlin/KClassExtensions.kt

@@ -0,0 +1,13 @@
+package expo.modules.kotlin
+
+import kotlin.reflect.KClass
+import kotlin.reflect.KFunction
+import kotlin.reflect.full.primaryConstructor
+
+val <T : Any> KClass<T>.fastPrimaryConstructor: KFunction<T>?
+  // If class only has one constructor, use it as a primary constructor.
+  // Otherwise, try to find the primary constructor using kotlin reflection.
+  get() = constructors.singleOrNull() ?: primaryConstructor
+
+fun KClass<*>.fastIsSupperClassOf(jClass: Class<*>) =
+  this.javaObjectType.isAssignableFrom(jClass) || this.java.isAssignableFrom(jClass)

package/android/src/main/java/expo/modules/kotlin/ReadableTypeExtensions.kt

@@ -3,16 +3,15 @@ package expo.modules.kotlin
 import com.facebook.react.bridge.ReadableArray
 import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.ReadableType
-import kotlin.reflect.KType
-import kotlin.reflect.full.createType
+import kotlin.reflect.KClass
 
-fun ReadableType.toKType(): KType {
+fun ReadableType.toKClass(): KClass<*> {
   return when (this) {
-    ReadableType.Null -> Any::class.createType(nullable = true)
-    ReadableType.Boolean -> Boolean::class.createType()
-    ReadableType.Number -> Number::class.createType()
-    ReadableType.String -> String::class.createType()
-    ReadableType.Map -> ReadableMap::class.createType()
-    ReadableType.Array -> ReadableArray::class.createType()
+    ReadableType.Null -> Any::class
+    ReadableType.Boolean -> Boolean::class
+    ReadableType.Number -> Number::class
+    ReadableType.String -> String::class
+    ReadableType.Map -> ReadableMap::class
+    ReadableType.Array -> ReadableArray::class
   }
 }

package/android/src/main/java/expo/modules/kotlin/classcomponent/ClassComponentBuilder.kt

@@ -10,7 +10,8 @@ import expo.modules.kotlin.functions.SyncFunctionComponent
 import expo.modules.kotlin.objects.ObjectDefinitionBuilder
 import expo.modules.kotlin.objects.PropertyComponentBuilderWithThis
 import expo.modules.kotlin.sharedobjects.SharedObject
-import expo.modules.kotlin.sharedobjects.SharedRef
+import expo.modules.kotlin.sharedobjects.isSharedObjectClass
+import expo.modules.kotlin.sharedobjects.isSharedRefClass
 import expo.modules.kotlin.traits.Trait
 import expo.modules.kotlin.types.AnyType
 import expo.modules.kotlin.types.TypeConverterProvider
@@ -19,7 +20,6 @@ import expo.modules.kotlin.types.toAnyType
 import expo.modules.kotlin.types.toArgsArray
 import expo.modules.kotlin.types.toReturnType
 import kotlin.reflect.KClass
-import kotlin.reflect.full.isSubclassOf
 
 class ClassComponentBuilder<SharedObjectType : Any>(
   private val appContext: AppContext,
@@ -33,8 +33,8 @@ class ClassComponentBuilder<SharedObjectType : Any>(
 
   fun buildClass(): ClassDefinitionData {
     val hasOwnerType = ownerClass != Unit::class
-    val isSharedObject = hasOwnerType && ownerClass.isSubclassOf(SharedObject::class)
-    val isSharedRef = hasOwnerType && ownerClass.isSubclassOf(SharedRef::class)
+    val isSharedObject = hasOwnerType && ownerClass.isSharedObjectClass()
+    val isSharedRef = hasOwnerType && ownerClass.isSharedRefClass()
 
     if (eventsDefinition != null && isSharedObject) {
       listOf("__expo_onStartListeningToEvent" to SharedObject::onStartListeningToEvent, "__expo_onStopListeningToEvent" to SharedObject::onStopListeningToEvent)

package/android/src/main/java/expo/modules/kotlin/exception/CodedException.kt

@@ -71,8 +71,8 @@ inline fun <reified T : CodedException> errorCodeOf(): String =
   CodedException.inferCode(T::class.java)
 
 internal class IncompatibleArgTypeException(
-  argumentType: KType,
-  desiredType: KType,
+  argumentType: KClass<*>,
+  desiredType: KClass<*>,
   cause: Throwable? = null
 ) : CodedException(
   message = "Argument type '$argumentType' is not compatible with expected type '$desiredType'.",

package/android/src/main/java/expo/modules/kotlin/modules/Module.kt

@@ -3,6 +3,7 @@ package expo.modules.kotlin.modules
 import android.os.Bundle
 import expo.modules.kotlin.AppContext
 import expo.modules.kotlin.RuntimeContext
+import expo.modules.kotlin.convertToString
 import expo.modules.kotlin.providers.AppContextProvider
 import expo.modules.kotlin.tracing.trace
 import expo.modules.kotlin.types.Enumerable
@@ -44,11 +45,11 @@ abstract class Module : AppContextProvider {
   }
 
   fun <T> sendEvent(enum: T, body: Bundle? = Bundle.EMPTY) where T : Enumerable, T : Enum<T> {
-    moduleEventEmitter?.emit(convertEnumToString(enum), body)
+    moduleEventEmitter?.emit(enum.convertToString(), body)
   }
 
   fun <T> sendEvent(enum: T, body: Map<String, Any?>? = null) where T : Enumerable, T : Enum<T> {
-    moduleEventEmitter?.emit(convertEnumToString(enum), body)
+    moduleEventEmitter?.emit(enum.convertToString(), body)
   }
 
   open fun converters(): TypeConverterProvider? = null

package/android/src/main/java/expo/modules/kotlin/objects/ObjectDefinitionBuilder.kt

@@ -7,7 +7,9 @@ import expo.modules.kotlin.Promise
 import expo.modules.kotlin.component6
 import expo.modules.kotlin.component7
 import expo.modules.kotlin.component8
+import expo.modules.kotlin.convertToString
 import expo.modules.kotlin.events.EventsDefinition
+import expo.modules.kotlin.fastPrimaryConstructor
 import expo.modules.kotlin.functions.AsyncFunctionComponent
 import expo.modules.kotlin.functions.AsyncFunctionBuilder
 import expo.modules.kotlin.functions.AsyncFunctionWithPromiseComponent
@@ -18,14 +20,12 @@ import expo.modules.kotlin.jni.JavaScriptModuleObject
 import expo.modules.kotlin.jni.decorators.JSDecoratorsBridgingObject
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinitionBuilder
-import expo.modules.kotlin.modules.convertEnumToString
 import expo.modules.kotlin.types.Enumerable
 import expo.modules.kotlin.types.TypeConverterProvider
 import expo.modules.kotlin.types.enforceType
 import expo.modules.kotlin.types.toArgsArray
 import expo.modules.kotlin.types.toReturnType
 import kotlin.reflect.full.declaredMemberProperties
-import kotlin.reflect.full.primaryConstructor
 
 /**
  * Base class for other definitions representing an object, such as `ModuleDefinition`.
@@ -449,7 +449,7 @@ open class ObjectDefinitionBuilder(
   }
 
   inline fun <reified T> Events() where T : Enumerable, T : Enum<T> {
-    val primaryConstructor = T::class.primaryConstructor
+    val primaryConstructor = T::class.fastPrimaryConstructor
     val events = if (primaryConstructor?.parameters?.size == 1) {
       val parameterName = primaryConstructor.parameters.first().name
 
@@ -487,7 +487,7 @@ open class ObjectDefinitionBuilder(
    * Creates module's lifecycle listener that is called right after the first event listener is added for given event.
    */
   fun <T> OnStartObserving(enum: T, body: () -> Unit) where T : Enumerable, T : Enum<T> {
-    OnStartObserving(convertEnumToString(enum), body)
+    OnStartObserving(enum.convertToString(), body)
   }
 
   /**
@@ -520,7 +520,7 @@ open class ObjectDefinitionBuilder(
    * Creates module's lifecycle listener that is called right after all event listeners are removed for given event.
    */
   fun <T> OnStopObserving(enum: T, body: () -> Unit) where T : Enumerable, T : Enum<T> {
-    OnStopObserving(convertEnumToString(enum), body)
+    OnStopObserving(enum.convertToString(), body)
   }
 
   /**

package/android/src/main/java/expo/modules/kotlin/sharedobjects/SharedObject.kt

@@ -8,6 +8,7 @@ import expo.modules.kotlin.jni.JavaScriptWeakObject
 import expo.modules.kotlin.logger
 import expo.modules.kotlin.types.JSTypeConverter
 import expo.modules.kotlin.weak
+import kotlin.reflect.KClass
 
 @DoNotStrip
 open class SharedObject(runtimeContext: RuntimeContext? = null) {
@@ -83,3 +84,6 @@ open class SharedObject(runtimeContext: RuntimeContext? = null) {
     return 0
   }
 }
+
+fun KClass<*>.isSharedObjectClass() =
+  SharedObject::class.java.isAssignableFrom(this.java)

package/android/src/main/java/expo/modules/kotlin/sharedobjects/SharedObjectTypeConverter.kt

@@ -3,6 +3,7 @@ package expo.modules.kotlin.sharedobjects
 import com.facebook.react.bridge.Dynamic
 import expo.modules.kotlin.AppContext
 import expo.modules.kotlin.exception.IncorrectRefTypeException
+import expo.modules.kotlin.fastIsSupperClassOf
 import expo.modules.kotlin.jni.CppType
 import expo.modules.kotlin.jni.ExpectedType
 import expo.modules.kotlin.toStrongReference
@@ -10,7 +11,6 @@ import expo.modules.kotlin.types.NonNullableTypeConverter
 import kotlin.reflect.KClass
 import kotlin.reflect.KType
 import kotlin.reflect.KTypeProjection
-import kotlin.reflect.full.isSuperclassOf
 
 class SharedObjectTypeConverter<T : SharedObject>(
   val type: KType
@@ -74,7 +74,8 @@ class SharedRefTypeConverter<T : SharedRef<*>>(
     val ref = sharedRef.ref ?: return sharedRef
     val sharedRefClass = sharedRefType?.classifier as? KClass<*>
       ?: return sharedRef
-    if (sharedRefClass.isSuperclassOf(ref.javaClass.kotlin)) {
+
+    if (sharedRefClass.fastIsSupperClassOf(ref.javaClass)) {
       return sharedRef
     }
 

package/android/src/main/java/expo/modules/kotlin/sharedobjects/SharedRef.kt

@@ -3,6 +3,7 @@ package expo.modules.kotlin.sharedobjects
 import expo.modules.core.interfaces.DoNotStrip
 import expo.modules.kotlin.AppContext
 import expo.modules.kotlin.RuntimeContext
+import kotlin.reflect.KClass
 
 /**
  * Shared object (ref) that holds a strong reference to any native object. Allows passing references
@@ -29,3 +30,6 @@ inline fun <reified RefType> SharedRef<*>.cast(): SharedRef<RefType>? {
 
   return null
 }
+
+fun KClass<*>.isSharedRefClass() =
+  SharedRef::class.java.isAssignableFrom(this.java)

package/android/src/main/java/expo/modules/kotlin/types/EnumTypeConverter.kt

@@ -5,12 +5,11 @@ import expo.modules.kotlin.AppContext
 import expo.modules.kotlin.exception.DynamicCastException
 import expo.modules.kotlin.exception.EnumNoSuchValueException
 import expo.modules.kotlin.exception.IncompatibleArgTypeException
+import expo.modules.kotlin.fastPrimaryConstructor
 import expo.modules.kotlin.jni.ExpectedType
 import expo.modules.kotlin.logger
-import expo.modules.kotlin.toKType
+import expo.modules.kotlin.toKClass
 import kotlin.reflect.KClass
-import kotlin.reflect.full.createType
-import kotlin.reflect.full.primaryConstructor
 
 class EnumTypeConverter(
   private val enumClass: KClass<Enum<*>>
@@ -23,7 +22,9 @@ class EnumTypeConverter(
     }
   }
 
-  private val primaryConstructor = requireNotNull(enumClass.primaryConstructor) {
+  private val primaryConstructor = requireNotNull(
+    enumClass.fastPrimaryConstructor
+  ) {
     "Cannot convert js value to enum without the primary constructor"
   }
 
@@ -48,7 +49,7 @@ class EnumTypeConverter(
       )
     }
 
-    throw IncompatibleArgTypeException(value.type.toKType(), enumClass.createType())
+    throw IncompatibleArgTypeException(value.type.toKClass(), enumClass)
   }
 
   override fun convertFromAny(value: Any, context: AppContext?, forceConversion: Boolean): Enum<*> {
@@ -62,7 +63,7 @@ class EnumTypeConverter(
       )
     }
 
-    throw IncompatibleArgTypeException(value::class.createType(), enumClass.createType())
+    throw IncompatibleArgTypeException(value::class, enumClass)
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-modules-core",
-  "version": "3.0.12",
+  "version": "3.0.14",
   "description": "The core of Expo Modules architecture",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -65,5 +65,5 @@
     "@testing-library/react-native": "^13.2.0",
     "expo-module-scripts": "^5.0.6"
   },
-  "gitHead": "f97e6d1cae0cb14d5eed1b08fad6d12a7144af3a"
+  "gitHead": "d087a2182086089f23bcee65e27434f21db50128"
 }