expo-updates 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -10,6 +10,31 @@
 
 ### 💡 Others
 
+## 0.20.0 — 2023-09-04
+
+### 🛠 Breaking changes
+
+- Change source of truth for constants types. ([#24049](https://github.com/expo/expo/pull/24049) by [@wschurman](https://github.com/wschurman))
+- Remove classic manifest types and classic updates. ([#24053](https://github.com/expo/expo/pull/24053), [#24066](https://github.com/expo/expo/pull/24066) by [@wschurman](https://github.com/wschurman))
+
+### 🎉 New features
+
+- Added support for React Native 0.73. ([#24018](https://github.com/expo/expo/pull/24018) by [@kudo](https://github.com/kudo))
+- Add rollback support to useUpdates(). ([#24071](https://github.com/expo/expo/pull/24071) by [@douglowder](https://github.com/douglowder))
+
+### 🐛 Bug fixes
+
+- [Android] completely fix `node` execution on Windows ([#24116](https://github.com/expo/expo/pull/24116) by [@weykon](https://github.com/weykon))
+- [Android] Fixed the `node` execution on Windows. ([#23983](https://github.com/expo/expo/pull/23983) by [@kudo](https://github.com/kudo))
+- Bare update manifest non-nullability parity. ([#23166](https://github.com/expo/expo/pull/23166) by [@wschurman](https://github.com/wschurman))
+- Support importing assets from out of the project root when working in monorepos. ([#24090](https://github.com/expo/expo/pull/24090) by [@EvanBacon](https://github.com/EvanBacon))
+
+## 0.19.1 — 2023-08-02
+
+### 💡 Others
+
+- Update API documentation to clarify `channel` behavior in Expo Go/ development builds. ([#23783](https://github.com/expo/expo/pull/23783) by [@keith-kurak](https://github.com/keith-kurak))
+
 ## 0.19.0 — 2023-07-28
 
 ### 🎉 New features
@@ -248,6 +273,7 @@ _This version does not introduce any user-facing changes._
 
 ### 🛠 Breaking changes
 
+- Drop support for `logUrl` which sent console logs to the legacy `expo-cli`. ([#18596](https://github.com/expo/expo/pull/18596) by [@EvanBacon](https://github.com/EvanBacon))
 - [plugin] Upgrade minimum runtime requirement to Node 14 (LTS). ([#18204](https://github.com/expo/expo/pull/18204) by [@EvanBacon](https://github.com/EvanBacon))
 - Bumped iOS deployment target to 13.0 and deprecated support for iOS 12. ([#18873](https://github.com/expo/expo/pull/18873) by [@tsapeta](https://github.com/tsapeta))
 

package/android/build.gradle

@@ -4,7 +4,7 @@ apply plugin: 'kotlin-kapt'
 apply plugin: 'maven-publish'
 
 group = 'host.exp.exponent'
-version = '0.19.0'
+version = '0.20.0'
 
 // Utility method to derive boolean values from the environment or from Java properties,
 // and return them as strings to be used in BuildConfig fields
@@ -81,13 +81,16 @@ afterEvaluate {
 android {
   compileSdkVersion safeExtGet("compileSdkVersion", 33)
 
-  compileOptions {
-    sourceCompatibility JavaVersion.VERSION_11
-    targetCompatibility JavaVersion.VERSION_11
-  }
+  def agpVersion = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION
+  if (agpVersion.tokenize('.')[0].toInteger() < 8) {
+    compileOptions {
+      sourceCompatibility JavaVersion.VERSION_11
+      targetCompatibility JavaVersion.VERSION_11
+    }
 
-  kotlinOptions {
-    jvmTarget = JavaVersion.VERSION_11.majorVersion
+    kotlinOptions {
+      jvmTarget = JavaVersion.VERSION_11.majorVersion
+    }
   }
 
   namespace "expo.modules.updates"
@@ -95,7 +98,7 @@ android {
     minSdkVersion safeExtGet("minSdkVersion", 21)
     targetSdkVersion safeExtGet("targetSdkVersion", 33)
     versionCode 31
-    versionName '0.19.0'
+    versionName '0.20.0'
     consumerProguardFiles("proguard-rules.pro")
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
 

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

@@ -289,7 +289,7 @@ class UpdatesController private constructor(
           val event = when (result) {
             is LoaderTask.RemoteCheckResult.NoUpdateAvailable -> UpdatesStateEvent.CheckCompleteUnavailable()
             is LoaderTask.RemoteCheckResult.UpdateAvailable -> UpdatesStateEvent.CheckCompleteWithUpdate(result.manifest)
-            is LoaderTask.RemoteCheckResult.RollBackToEmbedded -> UpdatesStateEvent.CheckCompleteWithRollback()
+            is LoaderTask.RemoteCheckResult.RollBackToEmbedded -> UpdatesStateEvent.CheckCompleteWithRollback(result.commitTime)
           }
           stateMachine.processEvent(event)
         }
@@ -375,7 +375,7 @@ class UpdatesController private constructor(
               params.putString("manifestString", update.manifest.toString())
               sendLegacyUpdateEventToJS(UPDATE_AVAILABLE_EVENT, params)
               stateMachine.processEvent(
-                UpdatesStateEvent.DownloadCompleteWithUpdate(update.manifest!!)
+                UpdatesStateEvent.DownloadCompleteWithUpdate(update.manifest)
               )
             }
             RemoteUpdateStatus.NO_UPDATE_AVAILABLE -> {

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

@@ -154,7 +154,7 @@ class UpdatesDevLauncherController : UpdatesInterface {
           controller.setLauncher(launcher)
           callback.onSuccess(object : UpdatesInterface.Update {
             override fun getManifest(): JSONObject {
-              return launcher.launchedUpdate!!.manifest!!
+              return launcher.launchedUpdate!!.manifest
             }
 
             override fun getLaunchAssetPath(): String {

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

@@ -80,8 +80,7 @@ class UpdatesModule(
         if (launchedUpdate != null) {
           constants["updateId"] = launchedUpdate.id.toString()
           constants["commitTime"] = launchedUpdate.commitTime.time
-          constants["manifestString"] =
-            if (launchedUpdate.manifest != null) launchedUpdate.manifest.toString() else "{}"
+          constants["manifestString"] = launchedUpdate.manifest.toString()
         }
         val localAssetFiles = updatesServiceLocal.localAssetFiles
         if (localAssetFiles != null) {
@@ -138,7 +137,7 @@ class UpdatesModule(
     }
   }
 
-  // Used internally by @expo/use-updates useUpdates() to get its initial state
+  // Used internally by useUpdates() to get its initial state
   @ExpoMethod
   fun getNativeStateMachineContextAsync(promise: Promise) {
     try {
@@ -221,7 +220,7 @@ class UpdatesModule(
                     return
                   }
 
-                  promise.resolveWithCheckForUpdateAsyncResult(CheckForUpdateAsyncResult.RollBackToEmbedded(), updatesServiceLocal)
+                  promise.resolveWithCheckForUpdateAsyncResult(CheckForUpdateAsyncResult.RollBackToEmbedded(updateDirective.commitTime), updatesServiceLocal)
                   return
                 }
               }
@@ -269,7 +268,7 @@ class UpdatesModule(
 
     class NoUpdateAvailable : CheckForUpdateAsyncResult(Status.NO_UPDATE_AVAILABLE)
     class UpdateAvailable(val updateManifest: UpdateManifest) : CheckForUpdateAsyncResult(Status.UPDATE_AVAILABLE)
-    class RollBackToEmbedded : CheckForUpdateAsyncResult(Status.ROLL_BACK_TO_EMBEDDED)
+    class RollBackToEmbedded(val commitTime: Date) : CheckForUpdateAsyncResult(Status.ROLL_BACK_TO_EMBEDDED)
   }
 
   private fun Promise.resolveWithCheckForUpdateAsyncResult(checkForUpdateAsyncResult: CheckForUpdateAsyncResult, updatesServiceLocal: UpdatesInterface) {
@@ -297,7 +296,7 @@ class UpdatesModule(
     updatesServiceLocal.stateMachine?.processEvent(
       when (checkForUpdateAsyncResult) {
         is CheckForUpdateAsyncResult.NoUpdateAvailable -> UpdatesStateEvent.CheckCompleteUnavailable()
-        is CheckForUpdateAsyncResult.RollBackToEmbedded -> UpdatesStateEvent.CheckCompleteWithRollback()
+        is CheckForUpdateAsyncResult.RollBackToEmbedded -> UpdatesStateEvent.CheckCompleteWithRollback(checkForUpdateAsyncResult.commitTime)
         is CheckForUpdateAsyncResult.UpdateAvailable -> UpdatesStateEvent.CheckCompleteWithUpdate(
           checkForUpdateAsyncResult.updateManifest.manifest.getRawJson()
         )
@@ -418,7 +417,7 @@ class UpdatesModule(
                         }
                       )
                       updatesServiceLocal.stateMachine?.processEvent(
-                        UpdatesStateEvent.DownloadCompleteWithUpdate(updateEntity.manifest!!)
+                        UpdatesStateEvent.DownloadCompleteWithUpdate(updateEntity.manifest)
                       )
                     }
                   }

package/android/src/main/java/expo/modules/updates/db/UpdatesDatabase.kt

@@ -44,7 +44,7 @@ import java.util.*
 @Database(
   entities = [UpdateEntity::class, UpdateAssetEntity::class, AssetEntity::class, JSONDataEntity::class],
   exportSchema = false,
-  version = 11
+  version = 12
 )
 @TypeConverters(Converters::class)
 abstract class UpdatesDatabase : RoomDatabase() {
@@ -69,6 +69,7 @@ abstract class UpdatesDatabase : RoomDatabase() {
           .addMigrations(MIGRATION_8_9)
           .addMigrations(MIGRATION_9_10)
           .addMigrations(MIGRATION_10_11)
+          .addMigrations(MIGRATION_11_12)
           .fallbackToDestructiveMigration()
           .allowMainThreadQueries()
           .build()
@@ -199,5 +200,25 @@ abstract class UpdatesDatabase : RoomDatabase() {
         }
       }
     }
+
+    /**
+     * Change the `updates.manifest` column to be non-null
+     */
+    val MIGRATION_11_12: Migration = object : Migration(11, 12) {
+      override fun migrate(database: SupportSQLiteDatabase) {
+        database.runInTransactionWithForeignKeysOff {
+          execSQL("CREATE TABLE `new_updates` (`id` BLOB NOT NULL, `scope_key` TEXT NOT NULL, `commit_time` INTEGER NOT NULL, `runtime_version` TEXT NOT NULL, `launch_asset_id` INTEGER, `manifest` TEXT NOT NULL, `status` INTEGER NOT NULL, `keep` INTEGER NOT NULL, `last_accessed` INTEGER NOT NULL, `successful_launch_count` INTEGER NOT NULL DEFAULT 0, `failed_launch_count` INTEGER NOT NULL DEFAULT 0, PRIMARY KEY(`id`), FOREIGN KEY(`launch_asset_id`) REFERENCES `assets`(`id`) ON UPDATE NO ACTION ON DELETE CASCADE )")
+
+          execSQL(
+            "INSERT INTO `new_updates` (`id`, `scope_key`, `commit_time`, `runtime_version`, `launch_asset_id`, `manifest`, `status`, `keep`, `last_accessed`, `successful_launch_count`, `failed_launch_count`)" +
+              " SELECT `id`, `scope_key`, `commit_time`, `runtime_version`, `launch_asset_id`, `manifest`, `status`, `keep`, `last_accessed`, `successful_launch_count`, `failed_launch_count` FROM `updates` WHERE `manifest` IS NOT NULL"
+          )
+          execSQL("DROP TABLE `updates`")
+          execSQL("ALTER TABLE `new_updates` RENAME TO `updates`")
+          execSQL("CREATE INDEX `index_updates_launch_asset_id` ON `updates` (`launch_asset_id`)")
+          execSQL("CREATE UNIQUE INDEX `index_updates_scope_key_commit_time` ON `updates` (`scope_key`, `commit_time`)")
+        }
+      }
+    }
   }
 }

package/android/src/main/java/expo/modules/updates/db/entity/UpdateEntity.kt

@@ -36,14 +36,12 @@ class UpdateEntity(
   @field:ColumnInfo(typeAffinity = ColumnInfo.BLOB) @field:PrimaryKey var id: UUID,
   @field:ColumnInfo(name = "commit_time") var commitTime: Date,
   @field:ColumnInfo(name = "runtime_version") var runtimeVersion: String,
-  @field:ColumnInfo(name = "scope_key") var scopeKey: String
+  @field:ColumnInfo(name = "scope_key") var scopeKey: String,
+  @field:ColumnInfo(name = "manifest") var manifest: JSONObject,
 ) {
   @ColumnInfo(name = "launch_asset_id")
   var launchAssetId: Long? = null
 
-  @ColumnInfo(name = "manifest")
-  var manifest: JSONObject? = null
-
   var status = UpdateStatus.PENDING
 
   var keep = false

package/android/src/main/java/expo/modules/updates/loader/LoaderTask.kt

@@ -21,6 +21,7 @@ import expo.modules.updates.manifest.UpdateManifest
 import expo.modules.updates.selectionpolicy.SelectionPolicy
 import org.json.JSONObject
 import java.io.File
+import java.util.Date
 
 /**
  * Controlling class that handles the complex logic that needs to happen each time the app is cold
@@ -62,7 +63,7 @@ class LoaderTask(
 
     class NoUpdateAvailable : RemoteCheckResult(Status.NO_UPDATE_AVAILABLE)
     class UpdateAvailable(val manifest: JSONObject) : RemoteCheckResult(Status.UPDATE_AVAILABLE)
-    class RollBackToEmbedded : RemoteCheckResult(Status.ROLL_BACK_TO_EMBEDDED)
+    class RollBackToEmbedded(val commitTime: Date) : RemoteCheckResult(Status.ROLL_BACK_TO_EMBEDDED)
   }
 
   interface LoaderTaskCallback {
@@ -335,7 +336,7 @@ class LoaderTask(
               return when (updateDirective) {
                 is UpdateDirective.RollBackToEmbeddedUpdateDirective -> {
                   isUpToDate = true
-                  callback.onRemoteCheckForUpdateFinished(RemoteCheckResult.RollBackToEmbedded())
+                  callback.onRemoteCheckForUpdateFinished(RemoteCheckResult.RollBackToEmbedded(updateDirective.commitTime))
                   Loader.OnUpdateResponseLoadedResult(shouldDownloadManifestIfPresentInResponse = false)
                 }
                 is UpdateDirective.NoUpdateAvailableUpdateDirective -> {

package/android/src/main/java/expo/modules/updates/manifest/BareUpdateManifest.kt

@@ -28,7 +28,7 @@ class BareUpdateManifest private constructor(
   private val mAssets: JSONArray?
 ) : UpdateManifest {
   override val updateEntity: UpdateEntity by lazy {
-    UpdateEntity(mId, mCommitTime, mRuntimeVersion, mScopeKey).apply {
+    UpdateEntity(mId, mCommitTime, mRuntimeVersion, mScopeKey, this@BareUpdateManifest.manifest.getRawJson()).apply {
       status = UpdateStatus.EMBEDDED
     }
   }

package/android/src/main/java/expo/modules/updates/manifest/LegacyUpdateManifest.kt

@@ -34,8 +34,7 @@ class LegacyUpdateManifest private constructor(
   private val mAssets: JSONArray?
 ) : UpdateManifest {
   override val updateEntity: UpdateEntity by lazy {
-    UpdateEntity(mId, mCommitTime, mRuntimeVersion, mScopeKey).apply {
-      manifest = this@LegacyUpdateManifest.manifest.getRawJson()
+    UpdateEntity(mId, mCommitTime, mRuntimeVersion, mScopeKey, this@LegacyUpdateManifest.manifest.getRawJson()).apply {
       if (isDevelopmentMode) {
         status = UpdateStatus.DEVELOPMENT
       }

package/android/src/main/java/expo/modules/updates/manifest/NewUpdateManifest.kt

@@ -31,9 +31,7 @@ class NewUpdateManifest private constructor(
   private val mExtensions: JSONObject?
 ) : UpdateManifest {
   override val updateEntity: UpdateEntity by lazy {
-    UpdateEntity(mId, mCommitTime, mRuntimeVersion, mScopeKey).apply {
-      manifest = this@NewUpdateManifest.manifest.getRawJson()
-    }
+    UpdateEntity(mId, mCommitTime, mRuntimeVersion, mScopeKey, this@NewUpdateManifest.manifest.getRawJson())
   }
 
   private val assetHeaders: Map<String, JSONObject> by lazy {

package/android/src/main/java/expo/modules/updates/selectionpolicy/SelectionPolicies.kt

@@ -13,13 +13,12 @@ object SelectionPolicies {
   val TAG = SelectionPolicies::class.java.simpleName
 
   fun matchesFilters(update: UpdateEntity, manifestFilters: JSONObject?): Boolean {
-    val rawManifest = update.manifest
-    if (manifestFilters == null || rawManifest == null) {
+    if (manifestFilters == null) {
       // empty matches all
       return true
     }
 
-    val manifest = Manifest.fromManifestJson(rawManifest)
+    val manifest = Manifest.fromManifestJson(update.manifest)
     val metadata = manifest.getMetadata() ?: return true // empty matches all
 
     try {

package/android/src/main/java/expo/modules/updates/statemachine/UpdatesStateContext.kt

@@ -14,12 +14,12 @@ The state machine context, with information intended to be consumed by applicati
 data class UpdatesStateContext(
   val isUpdateAvailable: Boolean = false,
   val isUpdatePending: Boolean = false,
-  val isRollback: Boolean = false,
   val isChecking: Boolean = false,
   val isDownloading: Boolean = false,
   val isRestarting: Boolean = false,
   val latestManifest: JSONObject? = null,
   val downloadedManifest: JSONObject? = null,
+  val rollback: UpdatesStateContextRollback? = null,
   val checkError: UpdatesStateError? = null,
   val downloadError: UpdatesStateError? = null,
   val lastCheckForUpdateTime: Date? = null,
@@ -30,7 +30,6 @@ data class UpdatesStateContext(
       val map: MutableMap<String, Any> = mutableMapOf(
         "isUpdateAvailable" to isUpdateAvailable,
         "isUpdatePending" to isUpdatePending,
-        "isRollback" to isRollback,
         "isChecking" to isChecking,
         "isDownloading" to isDownloading,
         "isRestarting" to isRestarting
@@ -41,6 +40,9 @@ data class UpdatesStateContext(
       if (downloadedManifest != null) {
         map["downloadedManifest"] = downloadedManifest
       }
+      if (rollback != null) {
+        map["rollback"] = rollback.json
+      }
       if (checkError != null) {
         map["checkError"] = checkError.json
       }
@@ -71,7 +73,6 @@ data class UpdatesStateContext(
       return Bundle().apply {
         putBoolean("isUpdateAvailable", isUpdateAvailable)
         putBoolean("isUpdatePending", isUpdatePending)
-        putBoolean("isRollback", isRollback)
         putBoolean("isChecking", isChecking)
         putBoolean("isDownloading", isDownloading)
         putBoolean("isRestarting", isRestarting)
@@ -81,6 +82,14 @@ data class UpdatesStateContext(
         if (downloadedManifest != null) {
           putString("downloadedManifestString", downloadedManifest.toString())
         }
+        if (rollback != null) {
+          putBundle(
+            "rollback",
+            Bundle().apply {
+              putString("commitTime", rollback.commitTimeString)
+            }
+          )
+        }
         if (checkError != null) {
           val errorMap = Bundle().apply {
             putString("message", checkError.message)

package/android/src/main/java/expo/modules/updates/statemachine/UpdatesStateContextRollback.kt

@@ -0,0 +1,14 @@
+package expo.modules.updates.statemachine
+
+import java.util.Date
+
+data class UpdatesStateContextRollback(
+  val commitTime: Date
+) {
+
+  val commitTimeString: String
+    get() = UpdatesStateContext.DATE_FORMATTER.format(commitTime)
+
+  val json: Map<String, Any>
+    get() = mapOf("commitTime" to commitTimeString)
+}

package/android/src/main/java/expo/modules/updates/statemachine/UpdatesStateEvent.kt

@@ -1,6 +1,7 @@
 package expo.modules.updates.statemachine
 
 import org.json.JSONObject
+import java.util.Date
 
 /**
 Structure representing an event that can be sent to the machine.
@@ -22,7 +23,7 @@ sealed class UpdatesStateEvent(val type: UpdatesStateEventType) {
   }
   class CheckCompleteUnavailable : UpdatesStateEvent(UpdatesStateEventType.CheckCompleteUnavailable)
   class CheckCompleteWithUpdate(val manifest: JSONObject) : UpdatesStateEvent(UpdatesStateEventType.CheckCompleteAvailable)
-  class CheckCompleteWithRollback : UpdatesStateEvent(UpdatesStateEventType.CheckCompleteAvailable)
+  class CheckCompleteWithRollback(val commitTime: Date) : UpdatesStateEvent(UpdatesStateEventType.CheckCompleteAvailable)
   class DownloadComplete : UpdatesStateEvent(UpdatesStateEventType.DownloadComplete)
   class DownloadCompleteWithUpdate(val manifest: JSONObject) : UpdatesStateEvent(UpdatesStateEventType.DownloadComplete)
   class DownloadCompleteWithRollback : UpdatesStateEvent(UpdatesStateEventType.DownloadComplete)

package/android/src/main/java/expo/modules/updates/statemachine/UpdatesStateMachine.kt

@@ -106,24 +106,24 @@ class UpdatesStateMachine(
           isChecking = false,
           checkError = null,
           latestManifest = null,
+          rollback = null,
           isUpdateAvailable = false,
-          isRollback = false,
           lastCheckForUpdateTime = Date(),
         )
         is UpdatesStateEvent.CheckCompleteWithRollback -> context.copy(
           isChecking = false,
           checkError = null,
           latestManifest = null,
+          rollback = UpdatesStateContextRollback(event.commitTime),
           isUpdateAvailable = true,
-          isRollback = true,
           lastCheckForUpdateTime = Date()
         )
         is UpdatesStateEvent.CheckCompleteWithUpdate -> context.copy(
           isChecking = false,
           checkError = null,
           latestManifest = event.manifest,
+          rollback = null,
           isUpdateAvailable = true,
-          isRollback = false,
           lastCheckForUpdateTime = Date()
         )
         is UpdatesStateEvent.CheckError -> context.copy(
@@ -140,13 +140,14 @@ class UpdatesStateMachine(
         is UpdatesStateEvent.DownloadCompleteWithRollback -> context.copy(
           isDownloading = false,
           downloadError = null,
-          isUpdatePending = true,
+          isUpdatePending = true
         )
         is UpdatesStateEvent.DownloadCompleteWithUpdate -> context.copy(
           isDownloading = false,
           downloadError = null,
           latestManifest = event.manifest,
           downloadedManifest = event.manifest,
+          rollback = null,
           isUpdatePending = true,
           isUpdateAvailable = true
         )

package/build/Updates.d.ts

@@ -1,9 +1,8 @@
 import { LocalAssets, Manifest, UpdateCheckResult, UpdateFetchResult, UpdatesCheckAutomaticallyValue, UpdatesLogEntry, UpdatesNativeStateMachineContext } from './Updates.types';
 /**
- * The UUID that uniquely identifies the currently running update if `expo-updates` is enabled. The
+ * The UUID that uniquely identifies the currently running update. The
  * UUID is represented in its canonical string form (`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`) and
- * will always use lowercase letters. In development mode, or any other environment in which
- * `expo-updates` is disabled, this value is `null`.
+ * will always use lowercase letters. This value is `null` when running in a local development environment or any other environment where `expo-updates` is disabled.
  */
 export declare const updateId: string | null;
 /**
@@ -12,7 +11,9 @@ export declare const updateId: string | null;
  */
 export declare const releaseChannel: string;
 /**
- * The channel name of the current build, if configured for use with EAS Update. Null otherwise.
+ * The channel name of the current build, if configured for use with EAS Update. `null` otherwise.
+ *
+ * Expo Go and development builds are not set to a specific channel and can run any updates compatible with their native runtime. Therefore, this value will always be `null` when running an update on Expo Go or a development build.
  */
 export declare const channel: string | null;
 /**
@@ -112,14 +113,8 @@ export declare function getExtraParamsAsync(): Promise<{
 }>;
 /**
  * Sets an extra param if value is non-null, otherwise unsets the param.
- * Extra params are sent in a header of update requests.
- * The update server may use these params when evaluating logic to determine which update to serve.
- * EAS Update merges these params into the fields used to evaluate channel–branch mapping logic.
- *
- * @example An app may want to add a feature where users can opt-in to beta updates. In this instance,
- * extra params could be set to `{userType: 'beta'}`, and then the server can use this information
- * when deciding which update to serve. If using EAS Update, the channel-branch mapping can be set to
- * discriminate branches based on the `userType`.
+ * Extra params are sent as an [Expo Structured Field Value Dictionary](https://docs.expo.dev/technical-specs/expo-sfv-0/)
+ * in the `Expo-Extra-Params` header of update requests. A compliant update server may use these params when selecting an update to serve.
  */
 export declare function setExtraParamAsync(key: string, value: string | null | undefined): Promise<void>;
 /**
@@ -149,6 +144,10 @@ export declare function clearLogEntriesAsync(): Promise<void>;
  * storage. This method cannot be used in development mode, and the returned promise will be
  * rejected if you try to do so.
  *
+ > **Note:** [`reloadAsync()`](#updatesreloadasync) can be called after promise resolution to
+ * reload the app using the most recently downloaded version. Otherwise, the update will be applied
+ * on the next app cold start.
+ *
  * @return A promise that fulfills with an [`UpdateFetchResult`](#updatefetchresult) object.
  *
  * The promise rejects if the app is in development mode, or if there is an unexpected error or
@@ -159,6 +158,10 @@ export declare function fetchUpdateAsync(): Promise<UpdateFetchResult>;
  * @hidden
  */
 export declare function clearUpdateCacheExperimentalAsync(_sdkVersion?: string): void;
+/**
+ * @hidden
+ */
+export declare function transformNativeStateMachineContext(originalNativeContext: any): any;
 /**
  * @hidden
  */

package/build/Updates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Updates.d.ts","sourceRoot":"","sources":["../src/Updates.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,8BAA8B,EAC9B,eAAe,EACf,gCAAgC,EACjC,MAAM,iBAAiB,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,GAAG,IAGtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAgD,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,GAAG,IAAkC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG,IAAyC,CAAC;AAShF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,8BAA8B,GAAG,IACQ,CAAC;AAG3E;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,WAA2C,CAAC;AAEtE;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAgD,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAA+C,CAAC;AAG/E;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAoD,CAAC;AAEzF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAEnC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,IAAI,GAAG,IAEvB,CAAC;AAUT;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAWjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAkBtE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC,CAM9E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAE,MAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAK9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1D;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAkBnE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,CAAC,EAAE,MAAM,QAIrE;AAED;;GAEG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,gCAAgC,CAAC,CAmBnG"}
+{"version":3,"file":"Updates.d.ts","sourceRoot":"","sources":["../src/Updates.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,iBAAiB,EACjB,8BAA8B,EAC9B,eAAe,EACf,gCAAgC,EACjC,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,GAAG,IAGtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAgD,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,GAAG,IAAkC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG,IAAyC,CAAC;AAShF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,8BAA8B,GAAG,IACQ,CAAC;AAG3E;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,WAA2C,CAAC;AAEtE;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAgD,CAAC;AAEjF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAA+C,CAAC;AAG/E;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAoD,CAAC;AAEzF;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAEnC,CAAC;AAEL;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,IAAI,GAAG,IAEvB,CAAC;AAUT;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAWjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAkBtE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC,CAM9E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAE,MAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAK9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAkBnE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,CAAC,EAAE,MAAM,QAIrE;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,qBAAqB,EAAE,GAAG,OAmB5E;AAED;;GAEG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,gCAAgC,CAAC,CAOnG"}

package/build/Updates.js

@@ -1,10 +1,9 @@
 import { CodedError, NativeModulesProxy, UnavailabilityError } from 'expo-modules-core';
 import ExpoUpdates from './ExpoUpdates';
 /**
- * The UUID that uniquely identifies the currently running update if `expo-updates` is enabled. The
+ * The UUID that uniquely identifies the currently running update. The
  * UUID is represented in its canonical string form (`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`) and
- * will always use lowercase letters. In development mode, or any other environment in which
- * `expo-updates` is disabled, this value is `null`.
+ * will always use lowercase letters. This value is `null` when running in a local development environment or any other environment where `expo-updates` is disabled.
  */
 export const updateId = ExpoUpdates.updateId && typeof ExpoUpdates.updateId === 'string'
     ? ExpoUpdates.updateId.toLowerCase()
@@ -15,7 +14,9 @@ export const updateId = ExpoUpdates.updateId && typeof ExpoUpdates.updateId ===
  */
 export const releaseChannel = ExpoUpdates.releaseChannel ?? 'default';
 /**
- * The channel name of the current build, if configured for use with EAS Update. Null otherwise.
+ * The channel name of the current build, if configured for use with EAS Update. `null` otherwise.
+ *
+ * Expo Go and development builds are not set to a specific channel and can run any updates compatible with their native runtime. Therefore, this value will always be `null` when running an update on Expo Go or a development build.
  */
 export const channel = ExpoUpdates.channel ?? null;
 /**
@@ -157,14 +158,8 @@ export async function getExtraParamsAsync() {
 }
 /**
  * Sets an extra param if value is non-null, otherwise unsets the param.
- * Extra params are sent in a header of update requests.
- * The update server may use these params when evaluating logic to determine which update to serve.
- * EAS Update merges these params into the fields used to evaluate channel–branch mapping logic.
- *
- * @example An app may want to add a feature where users can opt-in to beta updates. In this instance,
- * extra params could be set to `{userType: 'beta'}`, and then the server can use this information
- * when deciding which update to serve. If using EAS Update, the channel-branch mapping can be set to
- * discriminate branches based on the `userType`.
+ * Extra params are sent as an [Expo Structured Field Value Dictionary](https://docs.expo.dev/technical-specs/expo-sfv-0/)
+ * in the `Expo-Extra-Params` header of update requests. A compliant update server may use these params when selecting an update to serve.
  */
 export async function setExtraParamAsync(key, value) {
     if (!ExpoUpdates.setExtraParamAsync) {
@@ -209,6 +204,10 @@ export async function clearLogEntriesAsync() {
  * storage. This method cannot be used in development mode, and the returned promise will be
  * rejected if you try to do so.
  *
+ > **Note:** [`reloadAsync()`](#updatesreloadasync) can be called after promise resolution to
+ * reload the app using the most recently downloaded version. Otherwise, the update will be applied
+ * on the next app cold start.
+ *
  * @return A promise that fulfills with an [`UpdateFetchResult`](#updatefetchresult) object.
  *
  * The promise rejects if the app is in development mode, or if there is an unexpected error or
@@ -237,12 +236,8 @@ export function clearUpdateCacheExperimentalAsync(_sdkVersion) {
 /**
  * @hidden
  */
-export async function getNativeStateMachineContextAsync() {
-    // Return the current state machine context
-    if (!ExpoUpdates.getNativeStateMachineContextAsync) {
-        throw new UnavailabilityError('Updates', 'getNativeStateMachineContextAsync');
-    }
-    const nativeContext = await ExpoUpdates.getNativeStateMachineContextAsync();
+export function transformNativeStateMachineContext(originalNativeContext) {
+    const nativeContext = { ...originalNativeContext };
     if (nativeContext.latestManifestString) {
         nativeContext.latestManifest = JSON.parse(nativeContext.latestManifestString);
         delete nativeContext.latestManifestString;
@@ -255,6 +250,21 @@ export async function getNativeStateMachineContextAsync() {
         nativeContext.lastCheckForUpdateTime = new Date(nativeContext.lastCheckForUpdateTimeString);
         delete nativeContext.lastCheckForUpdateTimeString;
     }
+    if (nativeContext.rollbackString) {
+        nativeContext.rollback = JSON.parse(nativeContext.rollbackString);
+        delete nativeContext.rollbackString;
+    }
     return nativeContext;
 }
+/**
+ * @hidden
+ */
+export async function getNativeStateMachineContextAsync() {
+    // Return the current state machine context
+    if (!ExpoUpdates.getNativeStateMachineContextAsync) {
+        throw new UnavailabilityError('Updates', 'getNativeStateMachineContextAsync');
+    }
+    const nativeContext = await ExpoUpdates.getNativeStateMachineContextAsync();
+    return transformNativeStateMachineContext(nativeContext);
+}
 //# sourceMappingURL=Updates.js.map