expo-updates 0.22.0 → 0.24.0

package/CHANGELOG.md

@@ -10,6 +10,71 @@
 
 ### 💡 Others
 
+## 0.24.0 — 2023-12-12
+
+### 🛠 Breaking changes
+
+- Add state machine procedure serial runner. ([#25386](https://github.com/expo/expo/pull/25386), [#25431](https://github.com/expo/expo/pull/25431) by [@wschurman](https://github.com/wschurman))
+
+### 🎉 New features
+
+- [Android] Asset exclusion on Android part 2. ([#25504](https://github.com/expo/expo/pull/25504) by [@douglowder](https://github.com/douglowder))
+- Added support for React Native 0.73.0. ([#24971](https://github.com/expo/expo/pull/24971), [#25453](https://github.com/expo/expo/pull/25453) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+
+### 🐛 Bug fixes
+
+- [Android] Fix interaction between reload JS API and ErrorRecovery. ([#25651](https://github.com/expo/expo/pull/25651) by [@wschurman](https://github.com/wschurman))
+- [Android] Fix wait notify bug in launch asset when enabled. ([#25676](https://github.com/expo/expo/pull/25676) by [@wschurman](https://github.com/wschurman))
+
+### 💡 Others
+
+- Update E2E tests to use local copies of `@expo/metro-config`, `@expo/env`, `@expo/config`. ([#25430](https://github.com/expo/expo/pull/25430) by [@EvanBacon](https://github.com/EvanBacon))
+- Add e2e tests for disabled mode. ([#25301](https://github.com/expo/expo/pull/25301) by [@wschurman](https://github.com/wschurman))
+- Modify E2E manual test for asset exclusion. ([#25406](https://github.com/expo/expo/pull/25406) by [@douglowder](https://github.com/douglowder))
+- Move tvOS compile test out of updates E2E test matrix. ([#25438](https://github.com/expo/expo/pull/25438) by [@douglowder](https://github.com/douglowder))
+- Assert valid state transitions in debug. ([#25474](https://github.com/expo/expo/pull/25474) by [@wschurman](https://github.com/wschurman))
+- Improve JS API error messages and documentation for Expo Go and Dev Client. ([#25751](https://github.com/expo/expo/pull/25751) by [@wschurman](https://github.com/wschurman))
+
+## 0.23.0 — 2023-11-14
+
+### 🛠 Breaking changes
+
+- Bumped iOS deployment target to 13.4. ([#25063](https://github.com/expo/expo/pull/25063) by [@gabrieldonadel](https://github.com/gabrieldonadel))
+- Split updates controllers depending on configuration, changing native public API. ([#25085](https://github.com/expo/expo/pull/25085), [#25192](https://github.com/expo/expo/pull/25192) by [@wschurman](https://github.com/wschurman))
+- On `Android` bump `compileSdkVersion` and `targetSdkVersion` to `34`. ([#24708](https://github.com/expo/expo/pull/24708) by [@alanjhughes](https://github.com/alanjhughes))
+
+### 🎉 New features
+
+- [iOS] Make asset exclusion work. ([#25216](https://github.com/expo/expo/pull/25216) by [@douglowder](https://github.com/douglowder))
+- [Android] Asset exclusion on Android part 1. ([#25277](https://github.com/expo/expo/pull/25277) by [@douglowder](https://github.com/douglowder))
+
+### 🐛 Bug fixes
+
+- [iOS] Fix the E2E tests. ([#24865](https://github.com/expo/expo/pull/24865) by [@douglowder](https://github.com/douglowder))
+- [Android] Simplify UpdatesUtils.parseDateString, fix UpdatesLoggingTest. ([#24951](https://github.com/expo/expo/pull/24951) by [@douglowder](https://github.com/douglowder))
+- [iOS] Fix expo-localization tvOS compile, add CI. ([#25082](https://github.com/expo/expo/pull/25082) by [@douglowder](https://github.com/douglowder))
+- Fix instrumentation tests. ([#25367](https://github.com/expo/expo/pull/25367) by [@wschurman](https://github.com/wschurman))
+
+### 💡 Others
+
+- Android: Stub expo-updates in Expo Go and remove service pattern. ([#24890](https://github.com/expo/expo/pull/24890) by [@wschurman](https://github.com/wschurman))
+- iOS: Refactor responsibility of app controller. ([#24934](https://github.com/expo/expo/pull/24934), [#24949](https://github.com/expo/expo/pull/24949) by [@wschurman](https://github.com/wschurman))
+- Android: Refactor responsibility of app controller. ([#24954](https://github.com/expo/expo/pull/24954), [#24975](https://github.com/expo/expo/pull/24975), [#25043](https://github.com/expo/expo/pull/25043) by [@wschurman](https://github.com/wschurman))
+- Android: Backport ExpoGoUpdatesModule to SDK 49. ([#24974](https://github.com/expo/expo/pull/24974) by [@wschurman](https://github.com/wschurman))
+- Remove unused `storedUpdateIdsWithConfiguration` method. ([#25194](https://github.com/expo/expo/pull/25194) by [@wschurman](https://github.com/wschurman))
+- Remove ability for embedded manifests to be legacy manifests. ([#25195](https://github.com/expo/expo/pull/25195) by [@wschurman](https://github.com/wschurman))
+- Convert e2e setup scripts to typescript. ([#25271](https://github.com/expo/expo/pull/25271) by [@wschurman](https://github.com/wschurman))
+
+### ⚠️ Notices
+
+- Deprecated `useUpdateEvents()` and `addListener()` in favor of the new `useUpdates()` API. ([#25345](https://github.com/expo/expo/pull/25345) by [@douglowder](https://github.com/douglowder))
+
+## 0.18.17 — 2023-10-25
+
+### 🐛 Bug fixes
+
+- [Android] Simplify UpdatesUtils.parseDateString, fix UpdatesLoggingTest. ([#24951](https://github.com/expo/expo/pull/24951) by [@douglowder](https://github.com/douglowder))
+
 ## 0.22.0 — 2023-10-17
 
 ### 🐛 Bug fixes
@@ -20,6 +85,7 @@
 ### 💡 Others
 
 - Transpile for Node 18 (LTS). ([#24471](https://github.com/expo/expo/pull/24471) by [@EvanBacon](https://github.com/EvanBacon))
+- iOS: Stub expo-updates in Expo Go and remove service pattern. ([#24860](https://github.com/expo/expo/pull/24860) by [@wschurman](https://github.com/wschurman))
 
 ## 0.18.16 — 2023-10-05
 

package/android/build.gradle

@@ -4,7 +4,7 @@ apply plugin: 'kotlin-kapt'
 apply plugin: 'maven-publish'
 
 group = 'host.exp.exponent'
-version = '0.22.0'
+version = '0.24.0'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 if (expoModulesCorePlugin.exists()) {
@@ -89,11 +89,11 @@ if (!safeExtGet("expoProvidesDefaultConfig", false)) {
 android {
   // Remove this if and it's contents, when support for SDK49 is dropped
   if (!safeExtGet("expoProvidesDefaultConfig", false)) {
-    compileSdkVersion safeExtGet("compileSdkVersion", 33)
+    compileSdkVersion safeExtGet("compileSdkVersion", 34)
 
     defaultConfig {
       minSdkVersion safeExtGet("minSdkVersion", 23)
-      targetSdkVersion safeExtGet("targetSdkVersion", 33)
+      targetSdkVersion safeExtGet("targetSdkVersion", 34)
     }
 
     publishing {
@@ -122,7 +122,7 @@ android {
   namespace "expo.modules.updates"
   defaultConfig {
     versionCode 31
-    versionName '0.22.0'
+    versionName '0.24.0'
     consumerProguardFiles("proguard-rules.pro")
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
 
@@ -174,6 +174,8 @@ dependencies {
   implementation("commons-codec:commons-codec:1.10")
   implementation("commons-io:commons-io:2.6")
   implementation("commons-fileupload:commons-fileupload:1.4")
+  implementation("javax.portlet:portlet-api:3.0.1")
+  implementation("javax.servlet:javax.servlet-api:4.0.1")
   implementation("org.apache.commons:commons-lang3:3.9")
   implementation("org.bouncycastle:bcutil-jdk15to18:1.70")
 

package/android/src/main/java/expo/modules/updates/DisabledUpdatesController.kt

@@ -0,0 +1,132 @@
+package expo.modules.updates
+
+import android.content.Context
+import android.os.Bundle
+import android.util.Log
+import com.facebook.react.ReactInstanceManager
+import expo.modules.kotlin.exception.CodedException
+import expo.modules.updates.UpdatesConfiguration.Companion.UPDATES_CONFIGURATION_RELEASE_CHANNEL_DEFAULT_VALUE
+import expo.modules.updates.launcher.Launcher
+import expo.modules.updates.launcher.NoDatabaseLauncher
+import expo.modules.updates.statemachine.UpdatesStateContext
+import java.io.File
+
+// this needs to stay for versioning to work
+/* ktlint-disable no-unused-imports */
+import expo.modules.updates.UpdatesConfiguration
+/* ktlint-enable no-unused-imports */
+
+/**
+ * Updates controller for applications that either disable updates explicitly or have an error
+ * during initialization. Errors that may occur include but are not limited to:
+ * - Disk access errors
+ * - Internal database initialization errors
+ * - Configuration errors (missing required configuration)
+ */
+class DisabledUpdatesController(
+  private val context: Context,
+  private val fatalException: Exception?,
+  private val isMissingRuntimeVersion: Boolean
+) : IUpdatesController {
+  private var isStarted = false
+  private var launcher: Launcher? = null
+  private var isLoaderTaskFinished = false
+  override var updatesDirectory: File? = null
+
+  override var isEmergencyLaunch = false
+    private set
+
+  @get:Synchronized
+  override val launchAssetFile: String?
+    get() {
+      while (!isLoaderTaskFinished) {
+        try {
+          (this as java.lang.Object).wait()
+        } catch (e: InterruptedException) {
+          Log.e(TAG, "Interrupted while waiting for launch asset file", e)
+        }
+      }
+      return launcher?.launchAssetFile
+    }
+
+  override val bundleAssetName: String?
+    get() = launcher?.bundleAssetName
+
+  override fun onDidCreateReactInstanceManager(reactInstanceManager: ReactInstanceManager) {}
+
+  @Synchronized
+  override fun start() {
+    if (isStarted) {
+      return
+    }
+    isStarted = true
+
+    launcher = NoDatabaseLauncher(context, fatalException)
+    isEmergencyLaunch = fatalException != null
+    notifyController()
+    return
+  }
+
+  class UpdatesDisabledException(message: String) : CodedException(message)
+
+  override fun getConstantsForModule(): IUpdatesController.UpdatesModuleConstants {
+    return IUpdatesController.UpdatesModuleConstants(
+      launchedUpdate = launcher?.launchedUpdate,
+      embeddedUpdate = null,
+      isEmergencyLaunch = isEmergencyLaunch,
+      isEnabled = false,
+      releaseChannel = UPDATES_CONFIGURATION_RELEASE_CHANNEL_DEFAULT_VALUE,
+      isUsingEmbeddedAssets = launcher?.isUsingEmbeddedAssets ?: false,
+      runtimeVersion = null,
+      checkOnLaunch = UpdatesConfiguration.CheckAutomaticallyConfiguration.NEVER,
+      requestHeaders = mapOf(),
+      localAssetFiles = launcher?.localAssetFiles,
+      isMissingRuntimeVersion = isMissingRuntimeVersion,
+    )
+  }
+
+  override fun relaunchReactApplicationForModule(callback: IUpdatesController.ModuleCallback<Unit>) {
+    callback.onFailure(UpdatesDisabledException("You cannot reload when expo-updates is not enabled."))
+  }
+
+  override fun getNativeStateMachineContext(callback: IUpdatesController.ModuleCallback<UpdatesStateContext>) {
+    callback.onFailure(UpdatesDisabledException("You cannot check for updates when expo-updates is not enabled."))
+  }
+
+  override fun checkForUpdate(
+    callback: IUpdatesController.ModuleCallback<IUpdatesController.CheckForUpdateResult>
+  ) {
+    callback.onFailure(UpdatesDisabledException("You cannot check for updates when expo-updates is not enabled."))
+  }
+
+  override fun fetchUpdate(
+    callback: IUpdatesController.ModuleCallback<IUpdatesController.FetchUpdateResult>
+  ) {
+    callback.onFailure(UpdatesDisabledException("You cannot fetch update when expo-updates is not enabled."))
+  }
+
+  override fun getExtraParams(callback: IUpdatesController.ModuleCallback<Bundle>) {
+    callback.onFailure(UpdatesDisabledException("You cannot use extra params when expo-updates is not enabled."))
+  }
+
+  override fun setExtraParam(
+    key: String,
+    value: String?,
+    callback: IUpdatesController.ModuleCallback<Unit>
+  ) {
+    callback.onFailure(UpdatesDisabledException("You cannot use extra params when expo-updates is not enabled."))
+  }
+
+  @Synchronized
+  private fun notifyController() {
+    if (launcher == null) {
+      throw AssertionError("UpdatesController.notifyController was called with a null launcher, which is an error. This method should only be called when an update is ready to launch.")
+    }
+    isLoaderTaskFinished = true
+    (this as java.lang.Object).notify()
+  }
+
+  companion object {
+    private val TAG = DisabledUpdatesController::class.java.simpleName
+  }
+}

package/android/src/main/java/expo/modules/updates/EnabledUpdatesController.kt

@@ -0,0 +1,296 @@
+package expo.modules.updates
+
+import android.content.Context
+import android.os.AsyncTask
+import android.os.Bundle
+import android.util.Log
+import com.facebook.react.ReactApplication
+import com.facebook.react.ReactInstanceManager
+import com.facebook.react.ReactNativeHost
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import expo.modules.kotlin.exception.CodedException
+import expo.modules.kotlin.exception.toCodedException
+import expo.modules.updates.db.BuildData
+import expo.modules.updates.db.DatabaseHolder
+import expo.modules.updates.db.UpdatesDatabase
+import expo.modules.updates.launcher.Launcher.LauncherCallback
+import expo.modules.updates.loader.FileDownloader
+import expo.modules.updates.logging.UpdatesLogReader
+import expo.modules.updates.logging.UpdatesLogger
+import expo.modules.updates.manifest.EmbeddedManifest
+import expo.modules.updates.manifest.ManifestMetadata
+import expo.modules.updates.procedures.CheckForUpdateProcedure
+import expo.modules.updates.procedures.FetchUpdateProcedure
+import expo.modules.updates.procedures.RelaunchProcedure
+import expo.modules.updates.selectionpolicy.SelectionPolicyFactory
+import expo.modules.updates.procedures.StartupProcedure
+import expo.modules.updates.statemachine.UpdatesStateChangeEventSender
+import expo.modules.updates.statemachine.UpdatesStateContext
+import expo.modules.updates.statemachine.UpdatesStateEventType
+import expo.modules.updates.statemachine.UpdatesStateMachine
+import java.io.File
+import java.lang.ref.WeakReference
+
+// this needs to stay for versioning to work
+/* ktlint-disable no-unused-imports */
+import expo.modules.updates.UpdatesConfiguration
+/* ktlint-enable no-unused-imports */
+
+/**
+ * Updates controller for applications that have updates enabled and properly-configured.
+ */
+class EnabledUpdatesController(
+  private val context: Context,
+  private val updatesConfiguration: UpdatesConfiguration,
+  override val updatesDirectory: File
+) : IUpdatesController, UpdatesStateChangeEventSender {
+  private var reactNativeHost: WeakReference<ReactNativeHost>? = if (context is ReactApplication) {
+    WeakReference(context.reactNativeHost)
+  } else {
+    null
+  }
+  private val logger = UpdatesLogger(context)
+  private val fileDownloader = FileDownloader(context)
+  private val selectionPolicy = SelectionPolicyFactory.createFilterAwarePolicy(
+    updatesConfiguration.getRuntimeVersion()
+  )
+  private val stateMachine = UpdatesStateMachine(context, this)
+  private val databaseHolder = DatabaseHolder(UpdatesDatabase.getInstance(context))
+
+  private fun purgeUpdatesLogsOlderThanOneDay() {
+    UpdatesLogReader(context).purgeLogEntries {
+      if (it != null) {
+        Log.e(TAG, "UpdatesLogReader: error in purgeLogEntries", it)
+      }
+    }
+  }
+
+  private var isStarted = false
+
+  private var isStartupFinished = false
+
+  @Synchronized
+  private fun onStartupProcedureFinished() {
+    isStartupFinished = true
+    (this@EnabledUpdatesController as java.lang.Object).notify()
+  }
+
+  private val startupProcedure = StartupProcedure(
+    context,
+    updatesConfiguration,
+    databaseHolder,
+    updatesDirectory,
+    fileDownloader,
+    selectionPolicy,
+    logger,
+    object : StartupProcedure.StartupProcedureCallback {
+      override fun onFinished() {
+        onStartupProcedureFinished()
+      }
+
+      override fun onLegacyJSEvent(event: StartupProcedure.StartupProcedureCallback.LegacyJSEvent) {
+        when (event) {
+          is StartupProcedure.StartupProcedureCallback.LegacyJSEvent.Error -> sendLegacyUpdateEventToJS(
+            UPDATE_ERROR_EVENT,
+            Arguments.createMap().apply {
+              putString("message", event.exception.message)
+            }
+          )
+          is StartupProcedure.StartupProcedureCallback.LegacyJSEvent.NoUpdateAvailable -> sendLegacyUpdateEventToJS(UPDATE_NO_UPDATE_AVAILABLE_EVENT, null)
+          is StartupProcedure.StartupProcedureCallback.LegacyJSEvent.UpdateAvailable -> sendLegacyUpdateEventToJS(
+            UPDATE_AVAILABLE_EVENT,
+            Arguments.createMap().apply {
+              putString("manifestString", event.manifest.toString())
+            }
+          )
+        }
+      }
+
+      override fun onRequestRelaunch(shouldRunReaper: Boolean, callback: LauncherCallback) {
+        relaunchReactApplication(shouldRunReaper, callback)
+      }
+    }
+  )
+
+  private val launchedUpdate
+    get() = startupProcedure.launchedUpdate
+  private val isUsingEmbeddedAssets
+    get() = startupProcedure.isUsingEmbeddedAssets
+  private val localAssetFiles
+    get() = startupProcedure.localAssetFiles
+  override val isEmergencyLaunch: Boolean
+    get() = startupProcedure.isEmergencyLaunch
+
+  @get:Synchronized
+  override val launchAssetFile: String?
+    get() {
+      while (!isStartupFinished) {
+        try {
+          (this as java.lang.Object).wait()
+        } catch (e: InterruptedException) {
+          Log.e(TAG, "Interrupted while waiting for launch asset file", e)
+        }
+      }
+      return startupProcedure.launchAssetFile
+    }
+  override val bundleAssetName: String?
+    get() = startupProcedure.bundleAssetName
+
+  override fun onDidCreateReactInstanceManager(reactInstanceManager: ReactInstanceManager) {
+    startupProcedure.onDidCreateReactInstanceManager(reactInstanceManager)
+  }
+
+  @Synchronized
+  override fun start() {
+    if (isStarted) {
+      return
+    }
+    isStarted = true
+
+    purgeUpdatesLogsOlderThanOneDay()
+
+    BuildData.ensureBuildDataIsConsistent(updatesConfiguration, databaseHolder.database)
+    databaseHolder.releaseDatabase()
+
+    stateMachine.queueExecution(startupProcedure)
+  }
+
+  private fun relaunchReactApplication(shouldRunReaper: Boolean, callback: LauncherCallback) {
+    val procedure = RelaunchProcedure(
+      context,
+      updatesConfiguration,
+      databaseHolder,
+      updatesDirectory,
+      fileDownloader,
+      selectionPolicy,
+      reactNativeHost,
+      getCurrentLauncher = { startupProcedure.launcher!! },
+      setCurrentLauncher = { currentLauncher -> startupProcedure.setLauncher(currentLauncher) },
+      shouldRunReaper = shouldRunReaper,
+      callback
+    )
+    stateMachine.queueExecution(procedure)
+  }
+
+  override fun sendUpdateStateChangeEventToBridge(eventType: UpdatesStateEventType, context: UpdatesStateContext) {
+    sendEventToJS(UPDATES_STATE_CHANGE_EVENT_NAME, eventType.type, context.writableMap)
+  }
+
+  private fun sendLegacyUpdateEventToJS(eventType: String, params: WritableMap?) {
+    sendEventToJS(UPDATES_EVENT_NAME, eventType, params)
+  }
+
+  private fun sendEventToJS(eventName: String, eventType: String, params: WritableMap?) {
+    UpdatesUtils.sendEventToReactNative(reactNativeHost, logger, eventName, eventType, params)
+  }
+
+  override fun getConstantsForModule(): IUpdatesController.UpdatesModuleConstants {
+    return IUpdatesController.UpdatesModuleConstants(
+      launchedUpdate = launchedUpdate,
+      embeddedUpdate = EmbeddedManifest.get(context, updatesConfiguration)?.updateEntity,
+      isEmergencyLaunch = isEmergencyLaunch,
+      isEnabled = true,
+      releaseChannel = updatesConfiguration.releaseChannel,
+      isUsingEmbeddedAssets = isUsingEmbeddedAssets,
+      runtimeVersion = updatesConfiguration.runtimeVersionRaw,
+      checkOnLaunch = updatesConfiguration.checkOnLaunch,
+      requestHeaders = updatesConfiguration.requestHeaders,
+      localAssetFiles = localAssetFiles,
+      isMissingRuntimeVersion = false,
+    )
+  }
+
+  override fun relaunchReactApplicationForModule(callback: IUpdatesController.ModuleCallback<Unit>) {
+    val canRelaunch = launchedUpdate != null
+    if (!canRelaunch) {
+      callback.onFailure(object : CodedException("ERR_UPDATES_RELOAD", "Cannot relaunch without a launched update.", null) {})
+    } else {
+      relaunchReactApplication(
+        shouldRunReaper = true,
+        object : LauncherCallback {
+          override fun onFailure(e: Exception) {
+            callback.onFailure(e.toCodedException())
+          }
+
+          override fun onSuccess() {
+            callback.onSuccess(Unit)
+          }
+        }
+      )
+    }
+  }
+
+  override fun getNativeStateMachineContext(callback: IUpdatesController.ModuleCallback<UpdatesStateContext>) {
+    callback.onSuccess(stateMachine.context)
+  }
+
+  override fun checkForUpdate(callback: IUpdatesController.ModuleCallback<IUpdatesController.CheckForUpdateResult>) {
+    val procedure = CheckForUpdateProcedure(context, updatesConfiguration, databaseHolder, logger, fileDownloader, selectionPolicy, launchedUpdate) {
+      callback.onSuccess(it)
+    }
+    stateMachine.queueExecution(procedure)
+  }
+
+  override fun fetchUpdate(callback: IUpdatesController.ModuleCallback<IUpdatesController.FetchUpdateResult>) {
+    val procedure = FetchUpdateProcedure(context, updatesConfiguration, databaseHolder, updatesDirectory, fileDownloader, selectionPolicy, launchedUpdate) {
+      callback.onSuccess(it)
+    }
+    stateMachine.queueExecution(procedure)
+  }
+
+  override fun getExtraParams(callback: IUpdatesController.ModuleCallback<Bundle>) {
+    AsyncTask.execute {
+      try {
+        val result = ManifestMetadata.getExtraParams(
+          databaseHolder.database,
+          updatesConfiguration,
+        )
+        databaseHolder.releaseDatabase()
+        val resultMap = when (result) {
+          null -> Bundle()
+          else -> {
+            Bundle().apply {
+              result.forEach {
+                putString(it.key, it.value)
+              }
+            }
+          }
+        }
+        callback.onSuccess(resultMap)
+      } catch (e: Exception) {
+        databaseHolder.releaseDatabase()
+        callback.onFailure(e.toCodedException())
+      }
+    }
+  }
+
+  override fun setExtraParam(key: String, value: String?, callback: IUpdatesController.ModuleCallback<Unit>) {
+    AsyncTask.execute {
+      try {
+        ManifestMetadata.setExtraParam(
+          databaseHolder.database,
+          updatesConfiguration,
+          key,
+          value
+        )
+        databaseHolder.releaseDatabase()
+        callback.onSuccess(Unit)
+      } catch (e: Exception) {
+        databaseHolder.releaseDatabase()
+        callback.onFailure(e.toCodedException())
+      }
+    }
+  }
+
+  companion object {
+    private val TAG = EnabledUpdatesController::class.java.simpleName
+
+    private const val UPDATE_AVAILABLE_EVENT = "updateAvailable"
+    private const val UPDATE_NO_UPDATE_AVAILABLE_EVENT = "noUpdateAvailable"
+    private const val UPDATE_ERROR_EVENT = "error"
+
+    private const val UPDATES_EVENT_NAME = "Expo.nativeUpdatesEvent"
+    private const val UPDATES_STATE_CHANGE_EVENT_NAME = "Expo.nativeUpdatesStateChangeEvent"
+  }
+}

package/android/src/main/java/expo/modules/updates/IUpdatesController.kt

@@ -0,0 +1,121 @@
+package expo.modules.updates
+
+import android.os.Bundle
+import com.facebook.react.ReactApplication
+import com.facebook.react.ReactInstanceManager
+import expo.modules.kotlin.exception.CodedException
+import expo.modules.updates.db.entity.AssetEntity
+import expo.modules.updates.db.entity.UpdateEntity
+import expo.modules.updates.loader.LoaderTask
+import expo.modules.updates.manifest.UpdateManifest
+import expo.modules.updates.statemachine.UpdatesStateContext
+import java.io.File
+import java.util.Date
+
+interface IUpdatesController {
+  val isEmergencyLaunch: Boolean
+
+  /**
+   * The path on disk to the launch asset (JS bundle) file for the React Native host to use.
+   * Blocks until the configured timeout runs out, or a new update has been downloaded and is ready
+   * to use (whichever comes sooner). ReactNativeHost.getJSBundleFile() should call into this.
+   *
+   * If this returns null, something has gone wrong and expo-updates has not been able to launch or
+   * find an update to use. In (and only in) this case, `getBundleAssetName()` will return a nonnull
+   * fallback value to use.
+   */
+  val launchAssetFile: String?
+
+  /**
+   * Returns the filename of the launch asset (JS bundle) file embedded in the APK bundle, which can
+   * be read using `context.getAssets()`. This is only nonnull if `getLaunchAssetFile` is null and
+   * should only be used in such a situation. ReactNativeHost.getBundleAssetName() should call into
+   * this.
+   */
+  val bundleAssetName: String?
+
+  /**
+   * Public for E2E tests.
+   */
+  val updatesDirectory: File?
+
+  fun onDidCreateReactInstanceManager(reactInstanceManager: ReactInstanceManager)
+
+  /**
+   * Starts the update process to launch a previously-loaded update and (if configured to do so)
+   * check for a new update from the server. This method should be called as early as possible in
+   * the application's lifecycle.
+   * @param context the base context of the application, ideally a [ReactApplication]
+   */
+  fun start()
+
+  interface ModuleCallback<T> {
+    fun onSuccess(result: T)
+    fun onFailure(exception: CodedException)
+  }
+
+  data class UpdatesModuleConstants(
+    val launchedUpdate: UpdateEntity?,
+    val embeddedUpdate: UpdateEntity?,
+    val isEmergencyLaunch: Boolean,
+    val isEnabled: Boolean,
+    val releaseChannel: String,
+    val isUsingEmbeddedAssets: Boolean,
+    val runtimeVersion: String?,
+    val checkOnLaunch: UpdatesConfiguration.CheckAutomaticallyConfiguration,
+    val requestHeaders: Map<String, String>,
+
+    /**
+     * Returns a map of the locally downloaded assets for the current update. Keys are the remote URLs
+     * of the assets and values are local paths. This should be exported by the Updates JS module and
+     * can be used by `expo-asset` or a similar module to override React Native's asset resolution and
+     * use the locally downloaded assets.
+     */
+    val localAssetFiles: Map<AssetEntity, String>?,
+
+    /**
+     * Whether there is no runtime version (or sdkVersion) provided in configuration. If it is missing,
+     * updates will be disabled and a warning will be logged.
+     */
+    val isMissingRuntimeVersion: Boolean,
+  )
+  fun getConstantsForModule(): UpdatesModuleConstants
+
+  fun relaunchReactApplicationForModule(callback: ModuleCallback<Unit>)
+
+  fun getNativeStateMachineContext(callback: ModuleCallback<UpdatesStateContext>)
+
+  sealed class CheckForUpdateResult(private val status: Status) {
+    private enum class Status {
+      NO_UPDATE_AVAILABLE,
+      UPDATE_AVAILABLE,
+      ROLL_BACK_TO_EMBEDDED,
+      ERROR
+    }
+
+    class NoUpdateAvailable(val reason: LoaderTask.RemoteCheckResultNotAvailableReason) : CheckForUpdateResult(Status.NO_UPDATE_AVAILABLE)
+    class UpdateAvailable(val updateManifest: UpdateManifest) : CheckForUpdateResult(Status.UPDATE_AVAILABLE)
+    class RollBackToEmbedded(val commitTime: Date) : CheckForUpdateResult(Status.ROLL_BACK_TO_EMBEDDED)
+    class ErrorResult(val error: Exception, val message: String) : CheckForUpdateResult(Status.ERROR)
+  }
+  fun checkForUpdate(callback: ModuleCallback<CheckForUpdateResult>)
+
+  sealed class FetchUpdateResult(private val status: Status) {
+    private enum class Status {
+      SUCCESS,
+      FAILURE,
+      ROLL_BACK_TO_EMBEDDED,
+      ERROR
+    }
+
+    class Success(val update: UpdateEntity) : FetchUpdateResult(Status.SUCCESS)
+    class Failure : FetchUpdateResult(Status.FAILURE)
+    class RollBackToEmbedded : FetchUpdateResult(Status.ROLL_BACK_TO_EMBEDDED)
+    class ErrorResult(val error: Exception) : FetchUpdateResult(Status.ERROR)
+  }
+  fun fetchUpdate(callback: ModuleCallback<FetchUpdateResult>)
+
+  fun getExtraParams(callback: ModuleCallback<Bundle>)
+
+  fun setExtraParam(key: String, value: String?, callback: ModuleCallback<Unit>)
+}