expo-updates-interface 55.1.1 → 55.1.2

package/CHANGELOG.md

@@ -10,15 +10,19 @@
 
 ### 💡 Others
 
+## 55.1.2 — 2026-02-16
+
+### 🎉 New features
+
+- Full native interface for updates. ([#42981](https://github.com/expo/expo/pull/42981) by [@douglowder](https://github.com/douglowder))
+
 ## 55.1.1 — 2026-01-22
 
 _This version does not introduce any user-facing changes._
 
 ## 55.1.0 — 2026-01-22
 
-### 🎉 New features
-
-- Full native interface for updates. ([#41527](https://github.com/expo/expo/pull/41527) by [@douglowder](https://github.com/douglowder))
+_This version does not introduce any user-facing changes._
 
 ## 55.0.0 — 2026-01-21
 

package/android/build.gradle

@@ -4,7 +4,7 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '55.1.1'
+version = '55.1.2'
 
 expoModule {
   canBePublished false
@@ -14,6 +14,6 @@ android {
   namespace "expo.modules.updatesinterface"
   defaultConfig {
     versionCode 1
-    versionName '55.1.1'
+    versionName '55.1.2'
   }
 }

package/android/src/main/java/expo/modules/updatesinterface/UpdatesControllerRegistry.kt

@@ -4,5 +4,4 @@ import java.lang.ref.WeakReference
 
 object UpdatesControllerRegistry {
   var controller: WeakReference<UpdatesInterface>? = null
-  var metricsController: WeakReference<UpdatesMetricsInterface>? = null
 }

package/android/src/main/java/expo/modules/updatesinterface/UpdatesInterface.kt

@@ -3,12 +3,44 @@ package expo.modules.updatesinterface
 import android.net.Uri
 import org.json.JSONObject
 import java.lang.ref.WeakReference
+import java.util.UUID
 
 /**
  * Interface for modules that depend on expo-updates for loading production updates but do not want
  * to depend on expo-updates or delegate control to the singleton UpdatesController.
+ *
+ * All updates controllers implement this protocol
  */
 interface UpdatesInterface {
+  /**
+   * Whether updates is enabled
+   */
+  val isEnabled: Boolean get() = false
+
+  /**
+   * These properties are set when updates is enabled, or the dev client is running
+   */
+  val runtimeVersion: String?
+  val updateUrl: Uri?
+
+  /**
+   * These properties are only set when updates is enabled
+   */
+  val launchedUpdateId: UUID? get() = null
+  val embeddedUpdateId: UUID? get() = null
+  val launchAssetPath: String? get() = null
+
+  /**
+   * User code or third party modules can add a listener that will be called
+   * on updates state machine transitions (only when updates is enabled)
+   */
+  fun subscribeToUpdatesStateChanges(listener: UpdatesStateChangeListener): UpdatesStateChangeSubscription
+}
+
+/**
+ * Implemented only by the dev client updates controller.
+ */
+interface UpdatesDevLauncherInterface : UpdatesInterface {
   interface UpdateCallback {
     fun onFailure(e: Exception?)
     fun onSuccess(update: Update?)
@@ -32,7 +64,19 @@ interface UpdatesInterface {
   fun reset()
   fun fetchUpdateWithConfiguration(configuration: HashMap<String, Any>, callback: UpdateCallback)
   fun isValidUpdatesConfiguration(configuration: HashMap<String, Any>): Boolean
+}
 
-  val runtimeVersion: String?
-  val updateUrl: Uri?
+interface UpdatesInterfaceCallbacks {
+  fun onRequestRelaunch()
+}
+
+interface UpdatesStateChangeListener {
+  fun updatesStateDidChange(event: Map<String, Any>)
+}
+
+interface UpdatesStateChangeSubscription {
+  /*
+   * Call this to remove the subscription and stop receiving state change events
+   */
+  fun remove()
 }

package/ios/EXUpdatesInterface/UpdatesControllerRegistry.swift

@@ -2,11 +2,8 @@
 
 import Foundation
 
-@objc(EXUpdatesControllerRegistry)
-@objcMembers
 public final class UpdatesControllerRegistry: NSObject {
-  public weak var controller: UpdatesExternalInterface?
-  public weak var metricsController: UpdatesExternalMetricsInterface?
+  public weak var controller: UpdatesInterface?
 
   public static let sharedInstance = UpdatesControllerRegistry()
 }

package/ios/EXUpdatesInterface/{UpdatesExternalInterface.swift → UpdatesInterface.swift}

@@ -15,11 +15,38 @@ public typealias UpdatesProgressBlock = (_ successfulAssetCount: UInt, _ failedA
 public typealias UpdatesManifestBlock = (_ manifest: [String: Any]) -> Bool
 
 /**
- * Protocol for modules that depend on expo-updates for loading production updates but do not want
- * to depend on expo-updates or delegate control to the singleton EXUpdatesAppController.
+ * All updates controllers implement this protocol, which provides information on the running
+ * updates system.
  */
-@objc(EXUpdatesExternalInterface)
-public protocol UpdatesExternalInterface {
+@objc(EXUpdatesInterface)
+public protocol UpdatesInterface {
+  /*
+   * Whether updates is enabled
+   */
+  @objc var isEnabled: Bool { get }
+  /*
+   * These properties are set when updates is enabled, or the dev client is running
+   */
+  @objc var runtimeVersion: String? { get }
+  @objc var updateURL: URL? { get }
+  /*
+   * These properties are only set when updates is enabled
+   */
+  @objc var launchedUpdateId: UUID? { get }
+  @objc var embeddedUpdateId: UUID? { get }
+  @objc var launchAssetPath: String? { get }
+  /*
+   * User code or third party modules can add a listener that will be called
+   * on updates state machine transitions (only when updates is enabled)
+   */
+  @objc func subscribeToUpdatesStateChanges(_ listener: any UpdatesStateChangeListener) -> UpdatesStateChangeSubscription
+}
+
+/**
+ * Implemented only by the dev client updates controller.
+ */
+@objc(EXUpdatesDevLauncherInterface)
+public protocol UpdatesDevLauncherInterface: UpdatesInterface {
   @objc weak var updatesExternalInterfaceDelegate: (any UpdatesExternalInterfaceDelegate)? { get set }
   @objc var launchAssetURL: URL? { get }
 
@@ -44,16 +71,18 @@ public protocol UpdatesExternalInterface {
  */
 @objc(EXUpdatesExternalInterfaceDelegate)
 public protocol UpdatesExternalInterfaceDelegate {
-  @objc func updatesExternalInterfaceDidRequestRelaunch(_ updatesExternalInterface: UpdatesExternalInterface)
+  @objc func updatesExternalInterfaceDidRequestRelaunch(_ updatesExternalInterface: UpdatesDevLauncherInterface)
 }
 
-/**
- * Protocol for use by the expo-app-metrics library
- */
-@objc(EXUpdatesExternalMetricsInterface)
-public protocol UpdatesExternalMetricsInterface {
-  @objc var runtimeVersion: String? { get }
-  @objc var updateURL: URL? { get }
-  @objc var launchedUpdateId: UUID? { get }
-  @objc var embeddedUpdateId: UUID? { get }
+@objc(EXUpdatesStateChangeListener)
+public protocol UpdatesStateChangeListener {
+  func updatesStateDidChange(_ event: [String: Any])
+}
+
+@objc(EXUpdatesStateChangeSubscription)
+public protocol UpdatesStateChangeSubscription {
+  /*
+   * Call this to remove the subscription and stop receiving state change events
+   */
+  func remove()
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-updates-interface",
-  "version": "55.1.1",
+  "version": "55.1.2",
   "description": "Native interface for modules that optionally depend on expo-updates, e.g. expo-dev-launcher.",
   "main": "index.js",
   "keywords": [
@@ -23,5 +23,5 @@
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "4728ba25fbd4d5835780306de78a83bd1628e271"
+  "gitHead": "928cc951854450f3c72e00e8e420e567fabd1f8c"
 }

package/android/src/main/java/expo/modules/updatesinterface/UpdatesInterfaceCallbacks.kt

@@ -1,5 +0,0 @@
-package expo.modules.updatesinterface
-
-interface UpdatesInterfaceCallbacks {
-  fun onRequestRelaunch()
-}

package/android/src/main/java/expo/modules/updatesinterface/UpdatesMetricsInterface.kt

@@ -1,16 +0,0 @@
-package expo.modules.updatesinterface
-
-import android.net.Uri
-import java.util.UUID
-
-/**
- * Interface for modules that depend on expo-updates for reading metrics information
- * about the currently running update, but do not want
- * to depend on expo-updates or delegate control to the singleton UpdatesController.
- */
-interface UpdatesMetricsInterface {
-  val runtimeVersion: String?
-  val updateUrl: Uri?
-  val launchedUpdateId: UUID?
-  val embeddedUpdateId: UUID?
-}