expo-updates 0.25.4 → 0.25.6

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 0.25.6 — 2024-05-01
+
+### 🐛 Bug fixes
+
+- Android: Fix hard crash due to missing asset edge row. ([#28264](https://github.com/expo/expo/pull/28264) by [@douglowder](https://github.com/douglowder))
+
+## 0.25.5 — 2024-04-24
+
+_This version does not introduce any user-facing changes._
+
 ## 0.25.4 — 2024-04-24
 
 ### 🐛 Bug fixes

package/android/build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'com.android.library'
 apply plugin: 'kotlin-kapt'
 
 group = 'host.exp.exponent'
-version = '0.25.4'
+version = '0.25.6'
 
 def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
 apply from: expoModulesCorePlugin
@@ -48,7 +48,7 @@ android {
   namespace "expo.modules.updates"
   defaultConfig {
     versionCode 31
-    versionName '0.25.4'
+    versionName '0.25.6'
     consumerProguardFiles("proguard-rules.pro")
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
 

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

@@ -37,6 +37,14 @@ abstract class AssetDao {
   )
   abstract fun _unmarkUsedAssetsFromDeletion()
 
+  @Query(
+    "UPDATE assets SET marked_for_deletion = 0 WHERE id IN (" +
+      " SELECT launch_asset_id" +
+      " FROM updates" +
+      " WHERE updates.keep);"
+  )
+  abstract fun _unmarkUsedLaunchAssetsFromDeletion()
+
   @Query(
     "UPDATE assets SET marked_for_deletion = 0 WHERE relative_path IN (" +
       " SELECT relative_path" +
@@ -145,6 +153,7 @@ abstract class AssetDao {
     // this is safe since this is a transaction and will be rolled back upon failure
     _markAllAssetsForDeletion()
     _unmarkUsedAssetsFromDeletion()
+    _unmarkUsedLaunchAssetsFromDeletion()
     // check for duplicate rows representing a single file on disk
     _unmarkDuplicateUsedAssetsFromDeletion()
     val deletedAssets = _loadAssetsMarkedForDeletion()

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

@@ -25,8 +25,8 @@ abstract class UpdateDao {
   @Query("SELECT * FROM updates WHERE id = :id;")
   abstract fun _loadUpdatesWithId(id: UUID): List<UpdateEntity>
 
-  @Query("SELECT assets.* FROM assets INNER JOIN updates ON updates.launch_asset_id = assets.id WHERE updates.id = :id;")
-  abstract fun _loadLaunchAsset(id: UUID): AssetEntity
+  @Query("SELECT assets.* FROM assets INNER JOIN updates ON updates.launch_asset_id = assets.id WHERE updates.id = :updateId;")
+  abstract fun _loadLaunchAssetForUpdate(updateId: UUID): AssetEntity?
 
   @Query("UPDATE updates SET keep = 1 WHERE id = :id;")
   abstract fun _keepUpdate(id: UUID)
@@ -67,10 +67,10 @@ abstract class UpdateDao {
     return if (updateEntities.isNotEmpty()) updateEntities[0] else null
   }
 
-  fun loadLaunchAsset(id: UUID): AssetEntity {
-    val assetEntity = _loadLaunchAsset(id)
-    assetEntity.isLaunchAsset = true
-    return assetEntity
+  fun loadLaunchAssetForUpdate(updateId: UUID): AssetEntity? {
+    return _loadLaunchAssetForUpdate(updateId)?.apply {
+      isLaunchAsset = true
+    }
   }
 
   @Insert

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

@@ -59,4 +59,6 @@ class UpdateEntity(
 
   @ColumnInfo(name = "failed_launch_count", defaultValue = "0")
   var failedLaunchCount = 0
+
+  fun debugInfo(): String = JSONObject(mapOf("id" to id.toString(), "status" to status.name)).toString()
 }

package/android/src/main/java/expo/modules/updates/launcher/DatabaseLauncher.kt

@@ -71,7 +71,7 @@ class DatabaseLauncher(
 
     launchedUpdate = getLaunchableUpdate(database, context)
     if (launchedUpdate == null) {
-      this.callback!!.onFailure(Exception("No launchable update was found. If this is a bare workflow app, make sure you have configured expo-updates correctly in android/app/build.gradle."))
+      this.callback!!.onFailure(Exception("No launchable update was found. If this is a generic app, ensure expo-updates is configured correctly."))
       return
     }
 
@@ -83,9 +83,14 @@ class DatabaseLauncher(
 
     // verify that we have all assets on disk
     // according to the database, we should, but something could have gone wrong on disk
-    val launchAsset = database.updateDao().loadLaunchAsset(launchedUpdate!!.id)
+    val launchAsset = database.updateDao().loadLaunchAssetForUpdate(launchedUpdate!!.id)
+    if (launchAsset == null) {
+      this.callback!!.onFailure(Exception("Launch asset not found for update; this should never happen. Debug info: ${launchedUpdate!!.debugInfo()}"))
+      return
+    }
+
     if (launchAsset.relativePath == null) {
-      throw AssertionError("Launch Asset relativePath should not be null")
+      this.callback!!.onFailure(Exception("Launch asset relative path should not be null. Debug info: ${launchedUpdate!!.debugInfo()}"))
     }
 
     val launchAssetFile = ensureAssetExists(launchAsset, database, context)
@@ -113,7 +118,7 @@ class DatabaseLauncher(
 
     if (assetsToDownload == 0) {
       if (this.launchAssetFile == null) {
-        this.callback!!.onFailure(Exception("mLaunchAssetFile was immediately null; this should never happen"))
+        this.callback!!.onFailure(Exception("Launch asset file was null with no assets to download reported; this should never happen. Debug info: ${launchedUpdate!!.debugInfo()}"))
       } else {
         this.callback!!.onSuccess()
       }

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

@@ -1,6 +1,7 @@
 package expo.modules.updates.selectionpolicy
 
 import expo.modules.updates.db.entity.UpdateEntity
+import expo.modules.updates.db.enums.UpdateStatus
 import org.json.JSONObject
 
 /**
@@ -50,6 +51,8 @@ class ReaperSelectionPolicyFilterAware : ReaperSelectionPolicy {
     } else if (nextNewestUpdate != null) {
       updatesToDelete.remove(nextNewestUpdate)
     }
-    return updatesToDelete
+
+    // don't delete embedded update
+    return updatesToDelete.filter { it.status != UpdateStatus.EMBEDDED }
   }
 }

package/build/ExpoUpdatesModule.types.d.ts

@@ -45,6 +45,9 @@ export interface ExpoUpdatesModule extends Pick<ProxyNativeModule, 'addListener'
     } | {
         manifest: Manifest;
     })) | UpdateFetchResultFailure | UpdateFetchResultRollBackToEmbedded>;
+    /**
+     * @hidden
+     */
     getNativeStateMachineContextAsync: () => Promise<UpdatesNativeStateMachineContext & {
         latestManifestString?: string;
         downloadedManifestString?: string;

package/build/ExpoUpdatesModule.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoUpdatesModule.types.d.ts","sourceRoot":"","sources":["../src/ExpoUpdatesModule.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,mCAAmC,EACnC,wBAAwB,EACxB,wBAAwB,EACxB,eAAe,EACf,gCAAgC,EACjC,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAClE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD,EAAE,OAAO,CAAC;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,mBAAmB,EAAE,MAAM,OAAO,CAC9B,yBAAyB,GACzB,CAAC,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAC3C,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,GACxD,6BAA6B,CAChC,CAAC;IACF,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACpE,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,gBAAgB,EAAE,MAAM,OAAO,CAC3B,CAAC,IAAI,CAAC,wBAAwB,EAAE,UAAU,CAAC,GACzC,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,GACxD,wBAAwB,GACxB,mCAAmC,CACtC,CAAC;IACF,iCAAiC,EAAE,MAAM,OAAO,CAC9C,gCAAgC,GAAG;QACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,4BAA4B,CAAC,EAAE,MAAM,CAAC;QACtC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CACF,CAAC;CACH"}
+{"version":3,"file":"ExpoUpdatesModule.types.d.ts","sourceRoot":"","sources":["../src/ExpoUpdatesModule.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,QAAQ,EACR,0BAA0B,EAC1B,6BAA6B,EAC7B,yBAAyB,EACzB,mCAAmC,EACnC,wBAAwB,EACxB,wBAAwB,EACxB,eAAe,EACf,gCAAgC,EACjC,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,iBAAiB,CAAC;IAClE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD,EAAE,OAAO,CAAC;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,mBAAmB,EAAE,MAAM,OAAO,CAC9B,yBAAyB,GACzB,CAAC,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAC3C,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,GACxD,6BAA6B,CAChC,CAAC;IACF,mBAAmB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACpE,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,gBAAgB,EAAE,MAAM,OAAO,CAC3B,CAAC,IAAI,CAAC,wBAAwB,EAAE,UAAU,CAAC,GACzC,CAAC;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,GACxD,wBAAwB,GACxB,mCAAmC,CACtC,CAAC;IACF;;OAEG;IACH,iCAAiC,EAAE,MAAM,OAAO,CAC9C,gCAAgC,GAAG;QACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,4BAA4B,CAAC,EAAE,MAAM,CAAC;QACtC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CACF,CAAC;CACH"}

package/build/ExpoUpdatesModule.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoUpdatesModule.types.js","sourceRoot":"","sources":["../src/ExpoUpdatesModule.types.ts"],"names":[],"mappings":"","sourcesContent":["import { ProxyNativeModule } from 'expo-modules-core';\n\nimport {\n  Manifest,\n  UpdateCheckResultAvailable,\n  UpdateCheckResultNotAvailable,\n  UpdateCheckResultRollBack,\n  UpdateFetchResultRollBackToEmbedded,\n  UpdateFetchResultFailure,\n  UpdateFetchResultSuccess,\n  UpdatesLogEntry,\n  UpdatesNativeStateMachineContext,\n} from './Updates.types';\n\n/**\n * @internal\n */\nexport interface ExpoUpdatesModule\n  extends Pick<ProxyNativeModule, 'addListener' | 'removeListeners'> {\n  isEmergencyLaunch: boolean;\n  emergencyLaunchReason: string | null;\n  isEmbeddedLaunch: boolean;\n  isEnabled: boolean;\n  isUsingEmbeddedAssets?: boolean;\n  /**\n   * Can be empty string\n   */\n  runtimeVersion: string;\n  checkAutomatically: string;\n  /**\n   * Can be empty string\n   */\n  channel: string;\n  shouldDeferToNativeForAPIMethodAvailabilityInDevelopment: boolean;\n  updateId?: string;\n  commitTime?: string;\n  /**\n   * @platform android\n   */\n  manifestString?: string;\n  /**\n   * @platform ios\n   */\n  manifest?: Manifest;\n  localAssets?: Record<string, string>;\n\n  reload: () => Promise<void>;\n  checkForUpdateAsync: () => Promise<\n    | UpdateCheckResultRollBack\n    | (Omit<UpdateCheckResultAvailable, 'manifest'> &\n        ({ manifestString: string } | { manifest: Manifest }))\n    | UpdateCheckResultNotAvailable\n  >;\n  getExtraParamsAsync: () => Promise<Record<string, string>>;\n  setExtraParamAsync: (key: string, value: string | null) => Promise<void>;\n  readLogEntriesAsync: (maxAge: number) => Promise<UpdatesLogEntry[]>;\n  clearLogEntriesAsync: () => Promise<void>;\n  fetchUpdateAsync: () => Promise<\n    | (Omit<UpdateFetchResultSuccess, 'manifest'> &\n        ({ manifestString: string } | { manifest: Manifest }))\n    | UpdateFetchResultFailure\n    | UpdateFetchResultRollBackToEmbedded\n  >;\n  getNativeStateMachineContextAsync: () => Promise<\n    UpdatesNativeStateMachineContext & {\n      latestManifestString?: string;\n      downloadedManifestString?: string;\n      lastCheckForUpdateTimeString?: string;\n      rollbackString?: string;\n    }\n  >;\n}\n"]}
+{"version":3,"file":"ExpoUpdatesModule.types.js","sourceRoot":"","sources":["../src/ExpoUpdatesModule.types.ts"],"names":[],"mappings":"","sourcesContent":["import { ProxyNativeModule } from 'expo-modules-core';\n\nimport {\n  Manifest,\n  UpdateCheckResultAvailable,\n  UpdateCheckResultNotAvailable,\n  UpdateCheckResultRollBack,\n  UpdateFetchResultRollBackToEmbedded,\n  UpdateFetchResultFailure,\n  UpdateFetchResultSuccess,\n  UpdatesLogEntry,\n  UpdatesNativeStateMachineContext,\n} from './Updates.types';\n\n/**\n * @internal\n */\nexport interface ExpoUpdatesModule\n  extends Pick<ProxyNativeModule, 'addListener' | 'removeListeners'> {\n  isEmergencyLaunch: boolean;\n  emergencyLaunchReason: string | null;\n  isEmbeddedLaunch: boolean;\n  isEnabled: boolean;\n  isUsingEmbeddedAssets?: boolean;\n  /**\n   * Can be empty string\n   */\n  runtimeVersion: string;\n  checkAutomatically: string;\n  /**\n   * Can be empty string\n   */\n  channel: string;\n  shouldDeferToNativeForAPIMethodAvailabilityInDevelopment: boolean;\n  updateId?: string;\n  commitTime?: string;\n  /**\n   * @platform android\n   */\n  manifestString?: string;\n  /**\n   * @platform ios\n   */\n  manifest?: Manifest;\n  localAssets?: Record<string, string>;\n\n  reload: () => Promise<void>;\n  checkForUpdateAsync: () => Promise<\n    | UpdateCheckResultRollBack\n    | (Omit<UpdateCheckResultAvailable, 'manifest'> &\n        ({ manifestString: string } | { manifest: Manifest }))\n    | UpdateCheckResultNotAvailable\n  >;\n  getExtraParamsAsync: () => Promise<Record<string, string>>;\n  setExtraParamAsync: (key: string, value: string | null) => Promise<void>;\n  readLogEntriesAsync: (maxAge: number) => Promise<UpdatesLogEntry[]>;\n  clearLogEntriesAsync: () => Promise<void>;\n  fetchUpdateAsync: () => Promise<\n    | (Omit<UpdateFetchResultSuccess, 'manifest'> &\n        ({ manifestString: string } | { manifest: Manifest }))\n    | UpdateFetchResultFailure\n    | UpdateFetchResultRollBackToEmbedded\n  >;\n  /**\n   * @hidden\n   */\n  getNativeStateMachineContextAsync: () => Promise<\n    UpdatesNativeStateMachineContext & {\n      latestManifestString?: string;\n      downloadedManifestString?: string;\n      lastCheckForUpdateTimeString?: string;\n      rollbackString?: string;\n    }\n  >;\n}\n"]}

package/build/Updates.d.ts

@@ -1,6 +1,6 @@
 import { LocalAssets, Manifest, UpdateCheckResult, UpdateFetchResult, UpdatesCheckAutomaticallyValue, UpdatesLogEntry, UpdatesNativeStateMachineContext } from './Updates.types';
 /**
- * Whether expo-updates is enabled. This may be false in a variety of cases including:
+ * Whether `expo-updates` is enabled. This may be false in a variety of cases including:
  * - enabled set to false in configuration
  * - missing or invalid URL in configuration
  * - missing runtime version or SDK version in configuration
@@ -13,7 +13,8 @@ export declare const isEnabled: boolean;
  * The UUID that uniquely identifies the currently running update. The
  * UUID is represented in its canonical string form and 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.
- * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+ * @example
+ * `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
  */
 export declare const updateId: string | null;
 /**
@@ -27,7 +28,7 @@ export declare const channel: string | null;
  */
 export declare const runtimeVersion: string | null;
 /**
- * Determines if and when expo-updates checks for and downloads updates automatically on startup.
+ * Determines if and when `expo-updates` checks for and downloads updates automatically on startup.
  */
 export declare const checkAutomatically: UpdatesCheckAutomaticallyValue | null;
 /**
@@ -88,7 +89,7 @@ export declare const createdAt: Date | null;
  * the state of the native module and main threads.
  *
  * This method cannot be used in Expo Go or development mode, and the returned promise will be rejected if you
- * try to do so. It also rejects when expo-updates is not enabled.
+ * try to do so. It also rejects when `expo-updates` is not enabled.
  *
  * @return A promise that fulfills right before the reload instruction is sent to the JS runtime, or
  * rejects if it cannot find a reference to the JS runtime. If the promise is rejected in production
@@ -113,27 +114,27 @@ export declare function reloadAsync(): Promise<void>;
  * @return A promise that fulfills with an [`UpdateCheckResult`](#updatecheckresult) object.
  *
  * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or
- * timeout communicating with the server. It also rejects when expo-updates is not enabled.
+ * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.
  */
 export declare function checkForUpdateAsync(): Promise<UpdateCheckResult>;
 /**
  * Retrieves the current extra params.
  *
- * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.
+ * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.
  */
 export declare function getExtraParamsAsync(): Promise<Record<string, string>>;
 /**
  * Sets an extra param if value is non-null, otherwise unsets the param.
- * Extra params are sent as an [Expo Structured Field Value Dictionary](https://docs.expo.dev/technical-specs/expo-sfv-0/)
+ * Extra params are sent as an [Expo Structured Field Value Dictionary](/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.
  *
- * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.
+ * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.
  */
 export declare function setExtraParamAsync(key: string, value: string | null | undefined): Promise<void>;
 /**
- * Retrieves the most recent expo-updates log entries.
+ * Retrieves the most recent `expo-updates` log entries.
  *
- * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to 3600000 ms (1 hour).
+ * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to `3600000` ms (1 hour).
  *
  * @return A promise that fulfills with an array of [`UpdatesLogEntry`](#updateslogentry) objects;
  *
@@ -141,7 +142,7 @@ export declare function setExtraParamAsync(key: string, value: string | null | u
  */
 export declare function readLogEntriesAsync(maxAge?: number): Promise<UpdatesLogEntry[]>;
 /**
- * Clears existing expo-updates log entries.
+ * Clears existing `expo-updates` log entries.
  *
  * > For now, this operation does nothing on the client.  Once log persistence has been
  * > implemented, this operation will actually remove existing logs.
@@ -164,7 +165,7 @@ export declare function clearLogEntriesAsync(): Promise<void>;
  * @return A promise that fulfills with an [`UpdateFetchResult`](#updatefetchresult) object.
  *
  * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or
- * timeout communicating with the server. It also rejects when expo-updates is not enabled.
+ * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.
  */
 export declare function fetchUpdateAsync(): Promise<UpdateFetchResult>;
 /**

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;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE,OAAiC,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,GAAG,IAGtB,CAAC;AAEX;;;;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,SAAgC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAAoC,CAAC;AAEvE;;;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;AAoBT;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAWjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAoBtE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE3E;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAE,MAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAE9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAoBnE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,CAAC,EAAE,MAAM,QAIrE;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,qBAAqB,EAAE,gCAAgC,GAAG;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,gCAAgC,CAmBlC;AAED;;GAEG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,gCAAgC,CAAC,CAGnG"}
+{"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;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE,OAAiC,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,GAAG,IAGtB,CAAC;AAEX;;;;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,SAAgC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAAoC,CAAC;AAEvE;;;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;AAoBT;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAWjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAoBtE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE3E;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,GAAE,MAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAE9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAoBnE;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,CAAC,EAAE,MAAM,QAIrE;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,qBAAqB,EAAE,gCAAgC,GAAG;IACxD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,gCAAgC,CAmBlC;AAED;;GAEG;AACH,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,gCAAgC,CAAC,CAGnG"}

package/build/Updates.js

@@ -1,7 +1,7 @@
 import { CodedError } from 'expo-modules-core';
 import ExpoUpdates from './ExpoUpdates';
 /**
- * Whether expo-updates is enabled. This may be false in a variety of cases including:
+ * Whether `expo-updates` is enabled. This may be false in a variety of cases including:
  * - enabled set to false in configuration
  * - missing or invalid URL in configuration
  * - missing runtime version or SDK version in configuration
@@ -14,7 +14,8 @@ export const isEnabled = !!ExpoUpdates.isEnabled;
  * The UUID that uniquely identifies the currently running update. The
  * UUID is represented in its canonical string form and 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.
- * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+ * @example
+ * `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
  */
 export const updateId = ExpoUpdates.updateId && typeof ExpoUpdates.updateId === 'string'
     ? ExpoUpdates.updateId.toLowerCase()
@@ -36,7 +37,7 @@ const _checkAutomaticallyMapNativeToJS = {
     WIFI_ONLY: 'WIFI_ONLY',
 };
 /**
- * Determines if and when expo-updates checks for and downloads updates automatically on startup.
+ * Determines if and when `expo-updates` checks for and downloads updates automatically on startup.
  */
 export const checkAutomatically = _checkAutomaticallyMapNativeToJS[ExpoUpdates.checkAutomatically] ?? null;
 // @docsMissing
@@ -114,7 +115,7 @@ const manualUpdatesInstructions = 'To test usage of the expo-updates JS API in y
  * the state of the native module and main threads.
  *
  * This method cannot be used in Expo Go or development mode, and the returned promise will be rejected if you
- * try to do so. It also rejects when expo-updates is not enabled.
+ * try to do so. It also rejects when `expo-updates` is not enabled.
  *
  * @return A promise that fulfills right before the reload instruction is sent to the JS runtime, or
  * rejects if it cannot find a reference to the JS runtime. If the promise is rejected in production
@@ -145,7 +146,7 @@ export async function reloadAsync() {
  * @return A promise that fulfills with an [`UpdateCheckResult`](#updatecheckresult) object.
  *
  * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or
- * timeout communicating with the server. It also rejects when expo-updates is not enabled.
+ * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.
  */
 export async function checkForUpdateAsync() {
     if ((__DEV__ || isUsingDeveloperTool) &&
@@ -165,25 +166,25 @@ export async function checkForUpdateAsync() {
 /**
  * Retrieves the current extra params.
  *
- * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.
+ * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.
  */
 export async function getExtraParamsAsync() {
     return await ExpoUpdates.getExtraParamsAsync();
 }
 /**
  * Sets an extra param if value is non-null, otherwise unsets the param.
- * Extra params are sent as an [Expo Structured Field Value Dictionary](https://docs.expo.dev/technical-specs/expo-sfv-0/)
+ * Extra params are sent as an [Expo Structured Field Value Dictionary](/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.
  *
- * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.
+ * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.
  */
 export async function setExtraParamAsync(key, value) {
     return await ExpoUpdates.setExtraParamAsync(key, value ?? null);
 }
 /**
- * Retrieves the most recent expo-updates log entries.
+ * Retrieves the most recent `expo-updates` log entries.
  *
- * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to 3600000 ms (1 hour).
+ * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to `3600000` ms (1 hour).
  *
  * @return A promise that fulfills with an array of [`UpdatesLogEntry`](#updateslogentry) objects;
  *
@@ -193,7 +194,7 @@ export async function readLogEntriesAsync(maxAge = 3600000) {
     return await ExpoUpdates.readLogEntriesAsync(maxAge);
 }
 /**
- * Clears existing expo-updates log entries.
+ * Clears existing `expo-updates` log entries.
  *
  * > For now, this operation does nothing on the client.  Once log persistence has been
  * > implemented, this operation will actually remove existing logs.
@@ -218,7 +219,7 @@ export async function clearLogEntriesAsync() {
  * @return A promise that fulfills with an [`UpdateFetchResult`](#updatefetchresult) object.
  *
  * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or
- * timeout communicating with the server. It also rejects when expo-updates is not enabled.
+ * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.
  */
 export async function fetchUpdateAsync() {
     if ((__DEV__ || isUsingDeveloperTool) &&

package/build/Updates.js.map

@@ -1 +1 @@
-{"version":3,"file":"Updates.js","sourceRoot":"","sources":["../src/Updates.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodedError } from 'expo-modules-core';\n\nimport ExpoUpdates from './ExpoUpdates';\nimport {\n  LocalAssets,\n  Manifest,\n  UpdateCheckResult,\n  UpdateFetchResult,\n  UpdatesCheckAutomaticallyValue,\n  UpdatesLogEntry,\n  UpdatesNativeStateMachineContext,\n} from './Updates.types';\n\n/**\n * Whether expo-updates is enabled. This may be false in a variety of cases including:\n * - enabled set to false in configuration\n * - missing or invalid URL in configuration\n * - missing runtime version or SDK version in configuration\n * - error accessing storage on device during initialization\n *\n * When false, the embedded update is loaded.\n */\nexport const isEnabled: boolean = !!ExpoUpdates.isEnabled;\n\n/**\n * The UUID that uniquely identifies the currently running update. The\n * UUID is represented in its canonical string form and will always use lowercase letters.\n * This value is `null` when running in a local development environment or any other environment where `expo-updates` is disabled.\n * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\n */\nexport const updateId: string | null =\n  ExpoUpdates.updateId && typeof ExpoUpdates.updateId === 'string'\n    ? ExpoUpdates.updateId.toLowerCase()\n    : null;\n\n/**\n * The channel name of the current build, if configured for use with EAS Update. `null` otherwise.\n *\n * 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.\n */\nexport const channel: string | null = ExpoUpdates.channel ?? null;\n\n/**\n * The runtime version of the current build.\n */\nexport const runtimeVersion: string | null = ExpoUpdates.runtimeVersion ?? null;\n\nconst _checkAutomaticallyMapNativeToJS = {\n  ALWAYS: 'ON_LOAD',\n  ERROR_RECOVERY_ONLY: 'ON_ERROR_RECOVERY',\n  NEVER: 'NEVER',\n  WIFI_ONLY: 'WIFI_ONLY',\n};\n\n/**\n * Determines if and when expo-updates checks for and downloads updates automatically on startup.\n */\nexport const checkAutomatically: UpdatesCheckAutomaticallyValue | null =\n  _checkAutomaticallyMapNativeToJS[ExpoUpdates.checkAutomatically] ?? null;\n\n// @docsMissing\n/**\n * @hidden\n */\nexport const localAssets: LocalAssets = ExpoUpdates.localAssets ?? {};\n\n/**\n * `expo-updates` does its very best to always launch monotonically newer versions of your app so\n * you don't need to worry about backwards compatibility when you put out an update. In very rare\n * cases, it's possible that `expo-updates` may need to fall back to the update that's embedded in\n * the app binary, even after newer updates have been downloaded and run (an \"emergency launch\").\n * This boolean will be `true` if the app is launching under this fallback mechanism and `false`\n * otherwise. If you are concerned about backwards compatibility of future updates to your app, you\n * can use this constant to provide special behavior for this rare case.\n */\nexport const isEmergencyLaunch = ExpoUpdates.isEmergencyLaunch;\n\n/**\n * If `isEmergencyLaunch` is set to true, this will contain a string error message describing\n * what failed during initialization.\n */\nexport const emergencyLaunchReason = ExpoUpdates.emergencyLaunchReason;\n\n/**\n * This will be true if the currently running update is the one embedded in the build,\n * and not one downloaded from the updates server.\n */\nexport const isEmbeddedLaunch: boolean = ExpoUpdates.isEmbeddedLaunch || false;\n\n// @docsMissing\n/**\n * @hidden\n */\nexport const isUsingEmbeddedAssets: boolean = ExpoUpdates.isUsingEmbeddedAssets || false;\n\n/**\n * If `expo-updates` is enabled, this is the\n * [manifest](/versions/latest/sdk/constants/#manifest) (or\n * [classic manifest](/versions/latest/sdk/constants/#appmanifest))\n * object for the update that's currently running.\n *\n * In development mode, or any other environment in which `expo-updates` is disabled, this object is\n * empty.\n */\nexport const manifest: Partial<Manifest> =\n  (ExpoUpdates.manifestString ? JSON.parse(ExpoUpdates.manifestString) : ExpoUpdates.manifest) ??\n  {};\n\n/**\n * If `expo-updates` is enabled, this is a `Date` object representing the creation time of the update that's currently running (whether it was embedded or downloaded at runtime).\n *\n * In development mode, or any other environment in which `expo-updates` is disabled, this value is\n * null.\n */\nexport const createdAt: Date | null = ExpoUpdates.commitTime\n  ? new Date(ExpoUpdates.commitTime)\n  : null;\n\n/**\n * During non-expo development we block accessing the updates API methods on the JS side, but when developing in\n * Expo Go or a development client build, the controllers should have control over which API methods should\n * be allowed.\n */\nconst shouldDeferToNativeForAPIMethodAvailabilityInDevelopment =\n  !!ExpoUpdates.shouldDeferToNativeForAPIMethodAvailabilityInDevelopment;\n\n/**\n * Developer tool is set when a project is served by `expo start`.\n */\nconst isUsingDeveloperTool =\n  'extra' in manifest ? !!manifest.extra?.expoGo?.developer?.tool : false;\n\nconst manualUpdatesInstructions =\n  'To test usage of the expo-updates JS API in your app, make a release build with `npx expo run:ios --configuration Release` or ' +\n  '`npx expo run:android --variant Release`.';\n\n/**\n * Instructs the app to reload using the most recently downloaded version. This is useful for\n * triggering a newly downloaded update to launch without the user needing to manually restart the\n * app.\n *\n * It is not recommended to place any meaningful logic after a call to `await\n * Updates.reloadAsync()`. This is because the promise is resolved after verifying that the app can\n * be reloaded, and immediately before posting an asynchronous task to the main thread to actually\n * reload the app. It is unsafe to make any assumptions about whether any more JS code will be\n * executed after the `Updates.reloadAsync` method call resolves, since that depends on the OS and\n * the state of the native module and main threads.\n *\n * This method cannot be used in Expo Go or development mode, and the returned promise will be rejected if you\n * try to do so. It also rejects when expo-updates is not enabled.\n *\n * @return A promise that fulfills right before the reload instruction is sent to the JS runtime, or\n * rejects if it cannot find a reference to the JS runtime. If the promise is rejected in production\n * mode, it most likely means you have installed the module incorrectly. Double check you've\n * followed the installation instructions. In particular, on iOS ensure that you set the `bridge`\n * property on `EXUpdatesAppController` with a pointer to the `RCTBridge` you want to reload, and on\n * Android ensure you either call `UpdatesController.initialize` with the instance of\n * `ReactApplication` you want to reload, or call `UpdatesController.setReactNativeHost` with the\n * proper instance of `ReactNativeHost`.\n */\nexport async function reloadAsync(): Promise<void> {\n  if (\n    (__DEV__ || isUsingDeveloperTool) &&\n    !shouldDeferToNativeForAPIMethodAvailabilityInDevelopment\n  ) {\n    throw new CodedError(\n      'ERR_UPDATES_DISABLED',\n      `You cannot use the Updates module in development mode in a production app. ${manualUpdatesInstructions}`\n    );\n  }\n  await ExpoUpdates.reload();\n}\n\n/**\n * Checks the server to see if a newly deployed update to your project is available. Does not\n * actually download the update. This method cannot be used in development mode, and the returned\n * promise will be rejected if you try to do so.\n *\n * Checking for an update uses a device's bandwidth and battery life like any network call.\n * Additionally, updates served by Expo may be rate limited. A good rule of thumb to check for\n * updates judiciously is to check when the user launches or foregrounds the app. Avoid polling for\n * updates in a frequent loop.\n *\n * @return A promise that fulfills with an [`UpdateCheckResult`](#updatecheckresult) object.\n *\n * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or\n * timeout communicating with the server. It also rejects when expo-updates is not enabled.\n */\nexport async function checkForUpdateAsync(): Promise<UpdateCheckResult> {\n  if (\n    (__DEV__ || isUsingDeveloperTool) &&\n    !shouldDeferToNativeForAPIMethodAvailabilityInDevelopment\n  ) {\n    throw new CodedError(\n      'ERR_UPDATES_DISABLED',\n      `You cannot check for updates in development mode. ${manualUpdatesInstructions}`\n    );\n  }\n\n  const result = await ExpoUpdates.checkForUpdateAsync();\n  if ('manifestString' in result) {\n    const { manifestString, ...rest } = result;\n    return {\n      ...rest,\n      manifest: JSON.parse(manifestString),\n    };\n  }\n  return result;\n}\n\n/**\n * Retrieves the current extra params.\n *\n * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.\n */\nexport async function getExtraParamsAsync(): Promise<Record<string, string>> {\n  return await ExpoUpdates.getExtraParamsAsync();\n}\n\n/**\n * Sets an extra param if value is non-null, otherwise unsets the param.\n * Extra params are sent as an [Expo Structured Field Value Dictionary](https://docs.expo.dev/technical-specs/expo-sfv-0/)\n * in the `Expo-Extra-Params` header of update requests. A compliant update server may use these params when selecting an update to serve.\n *\n * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.\n */\nexport async function setExtraParamAsync(\n  key: string,\n  value: string | null | undefined\n): Promise<void> {\n  return await ExpoUpdates.setExtraParamAsync(key, value ?? null);\n}\n\n/**\n * Retrieves the most recent expo-updates log entries.\n *\n * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to 3600000 ms (1 hour).\n *\n * @return A promise that fulfills with an array of [`UpdatesLogEntry`](#updateslogentry) objects;\n *\n * The promise rejects if there is an unexpected error in retrieving the logs.\n */\nexport async function readLogEntriesAsync(maxAge: number = 3600000): Promise<UpdatesLogEntry[]> {\n  return await ExpoUpdates.readLogEntriesAsync(maxAge);\n}\n\n/**\n * Clears existing expo-updates log entries.\n *\n * > For now, this operation does nothing on the client.  Once log persistence has been\n * > implemented, this operation will actually remove existing logs.\n *\n * @return A promise that fulfills if the clear operation was successful.\n *\n * The promise rejects if there is an unexpected error in clearing the logs.\n *\n */\nexport async function clearLogEntriesAsync(): Promise<void> {\n  await ExpoUpdates.clearLogEntriesAsync();\n}\n\n/**\n * Downloads the most recently deployed update to your project from server to the device's local\n * storage. This method cannot be used in development mode, and the returned promise will be\n * rejected if you try to do so.\n *\n > **Note:** [`reloadAsync()`](#updatesreloadasync) can be called after promise resolution to\n * reload the app using the most recently downloaded version. Otherwise, the update will be applied\n * on the next app cold start.\n *\n * @return A promise that fulfills with an [`UpdateFetchResult`](#updatefetchresult) object.\n *\n * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or\n * timeout communicating with the server. It also rejects when expo-updates is not enabled.\n */\nexport async function fetchUpdateAsync(): Promise<UpdateFetchResult> {\n  if (\n    (__DEV__ || isUsingDeveloperTool) &&\n    !shouldDeferToNativeForAPIMethodAvailabilityInDevelopment\n  ) {\n    throw new CodedError(\n      'ERR_UPDATES_DISABLED',\n      `You cannot fetch updates in development mode. ${manualUpdatesInstructions}`\n    );\n  }\n\n  const result = await ExpoUpdates.fetchUpdateAsync();\n  if ('manifestString' in result) {\n    const { manifestString, ...rest } = result;\n    return {\n      ...rest,\n      manifest: JSON.parse(manifestString),\n    };\n  }\n  return result;\n}\n\n/**\n * @hidden\n */\nexport function clearUpdateCacheExperimentalAsync(_sdkVersion?: string) {\n  console.warn(\n    \"This method is no longer necessary. `expo-updates` now automatically deletes your app's old bundle files!\"\n  );\n}\n\n/**\n * @hidden\n */\nexport function transformNativeStateMachineContext(\n  originalNativeContext: UpdatesNativeStateMachineContext & {\n    latestManifestString?: string;\n    downloadedManifestString?: string;\n    lastCheckForUpdateTimeString?: string;\n    rollbackString?: string;\n  }\n): UpdatesNativeStateMachineContext {\n  const nativeContext = { ...originalNativeContext };\n  if (nativeContext.latestManifestString) {\n    nativeContext.latestManifest = JSON.parse(nativeContext.latestManifestString);\n    delete nativeContext.latestManifestString;\n  }\n  if (nativeContext.downloadedManifestString) {\n    nativeContext.downloadedManifest = JSON.parse(nativeContext.downloadedManifestString);\n    delete nativeContext.downloadedManifestString;\n  }\n  if (nativeContext.lastCheckForUpdateTimeString) {\n    nativeContext.lastCheckForUpdateTime = new Date(nativeContext.lastCheckForUpdateTimeString);\n    delete nativeContext.lastCheckForUpdateTimeString;\n  }\n  if (nativeContext.rollbackString) {\n    nativeContext.rollback = JSON.parse(nativeContext.rollbackString);\n    delete nativeContext.rollbackString;\n  }\n  return nativeContext;\n}\n\n/**\n * @hidden\n */\nexport async function getNativeStateMachineContextAsync(): Promise<UpdatesNativeStateMachineContext> {\n  const nativeContext = await ExpoUpdates.getNativeStateMachineContextAsync();\n  return transformNativeStateMachineContext(nativeContext);\n}\n"]}
+{"version":3,"file":"Updates.js","sourceRoot":"","sources":["../src/Updates.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodedError } from 'expo-modules-core';\n\nimport ExpoUpdates from './ExpoUpdates';\nimport {\n  LocalAssets,\n  Manifest,\n  UpdateCheckResult,\n  UpdateFetchResult,\n  UpdatesCheckAutomaticallyValue,\n  UpdatesLogEntry,\n  UpdatesNativeStateMachineContext,\n} from './Updates.types';\n\n/**\n * Whether `expo-updates` is enabled. This may be false in a variety of cases including:\n * - enabled set to false in configuration\n * - missing or invalid URL in configuration\n * - missing runtime version or SDK version in configuration\n * - error accessing storage on device during initialization\n *\n * When false, the embedded update is loaded.\n */\nexport const isEnabled: boolean = !!ExpoUpdates.isEnabled;\n\n/**\n * The UUID that uniquely identifies the currently running update. The\n * UUID is represented in its canonical string form and will always use lowercase letters.\n * This value is `null` when running in a local development environment or any other environment where `expo-updates` is disabled.\n * @example\n * `\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"`\n */\nexport const updateId: string | null =\n  ExpoUpdates.updateId && typeof ExpoUpdates.updateId === 'string'\n    ? ExpoUpdates.updateId.toLowerCase()\n    : null;\n\n/**\n * The channel name of the current build, if configured for use with EAS Update. `null` otherwise.\n *\n * 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.\n */\nexport const channel: string | null = ExpoUpdates.channel ?? null;\n\n/**\n * The runtime version of the current build.\n */\nexport const runtimeVersion: string | null = ExpoUpdates.runtimeVersion ?? null;\n\nconst _checkAutomaticallyMapNativeToJS = {\n  ALWAYS: 'ON_LOAD',\n  ERROR_RECOVERY_ONLY: 'ON_ERROR_RECOVERY',\n  NEVER: 'NEVER',\n  WIFI_ONLY: 'WIFI_ONLY',\n};\n\n/**\n * Determines if and when `expo-updates` checks for and downloads updates automatically on startup.\n */\nexport const checkAutomatically: UpdatesCheckAutomaticallyValue | null =\n  _checkAutomaticallyMapNativeToJS[ExpoUpdates.checkAutomatically] ?? null;\n\n// @docsMissing\n/**\n * @hidden\n */\nexport const localAssets: LocalAssets = ExpoUpdates.localAssets ?? {};\n\n/**\n * `expo-updates` does its very best to always launch monotonically newer versions of your app so\n * you don't need to worry about backwards compatibility when you put out an update. In very rare\n * cases, it's possible that `expo-updates` may need to fall back to the update that's embedded in\n * the app binary, even after newer updates have been downloaded and run (an \"emergency launch\").\n * This boolean will be `true` if the app is launching under this fallback mechanism and `false`\n * otherwise. If you are concerned about backwards compatibility of future updates to your app, you\n * can use this constant to provide special behavior for this rare case.\n */\nexport const isEmergencyLaunch = ExpoUpdates.isEmergencyLaunch;\n\n/**\n * If `isEmergencyLaunch` is set to true, this will contain a string error message describing\n * what failed during initialization.\n */\nexport const emergencyLaunchReason = ExpoUpdates.emergencyLaunchReason;\n\n/**\n * This will be true if the currently running update is the one embedded in the build,\n * and not one downloaded from the updates server.\n */\nexport const isEmbeddedLaunch: boolean = ExpoUpdates.isEmbeddedLaunch || false;\n\n// @docsMissing\n/**\n * @hidden\n */\nexport const isUsingEmbeddedAssets: boolean = ExpoUpdates.isUsingEmbeddedAssets || false;\n\n/**\n * If `expo-updates` is enabled, this is the\n * [manifest](/versions/latest/sdk/constants/#manifest) (or\n * [classic manifest](/versions/latest/sdk/constants/#appmanifest))\n * object for the update that's currently running.\n *\n * In development mode, or any other environment in which `expo-updates` is disabled, this object is\n * empty.\n */\nexport const manifest: Partial<Manifest> =\n  (ExpoUpdates.manifestString ? JSON.parse(ExpoUpdates.manifestString) : ExpoUpdates.manifest) ??\n  {};\n\n/**\n * If `expo-updates` is enabled, this is a `Date` object representing the creation time of the update that's currently running (whether it was embedded or downloaded at runtime).\n *\n * In development mode, or any other environment in which `expo-updates` is disabled, this value is\n * null.\n */\nexport const createdAt: Date | null = ExpoUpdates.commitTime\n  ? new Date(ExpoUpdates.commitTime)\n  : null;\n\n/**\n * During non-expo development we block accessing the updates API methods on the JS side, but when developing in\n * Expo Go or a development client build, the controllers should have control over which API methods should\n * be allowed.\n */\nconst shouldDeferToNativeForAPIMethodAvailabilityInDevelopment =\n  !!ExpoUpdates.shouldDeferToNativeForAPIMethodAvailabilityInDevelopment;\n\n/**\n * Developer tool is set when a project is served by `expo start`.\n */\nconst isUsingDeveloperTool =\n  'extra' in manifest ? !!manifest.extra?.expoGo?.developer?.tool : false;\n\nconst manualUpdatesInstructions =\n  'To test usage of the expo-updates JS API in your app, make a release build with `npx expo run:ios --configuration Release` or ' +\n  '`npx expo run:android --variant Release`.';\n\n/**\n * Instructs the app to reload using the most recently downloaded version. This is useful for\n * triggering a newly downloaded update to launch without the user needing to manually restart the\n * app.\n *\n * It is not recommended to place any meaningful logic after a call to `await\n * Updates.reloadAsync()`. This is because the promise is resolved after verifying that the app can\n * be reloaded, and immediately before posting an asynchronous task to the main thread to actually\n * reload the app. It is unsafe to make any assumptions about whether any more JS code will be\n * executed after the `Updates.reloadAsync` method call resolves, since that depends on the OS and\n * the state of the native module and main threads.\n *\n * This method cannot be used in Expo Go or development mode, and the returned promise will be rejected if you\n * try to do so. It also rejects when `expo-updates` is not enabled.\n *\n * @return A promise that fulfills right before the reload instruction is sent to the JS runtime, or\n * rejects if it cannot find a reference to the JS runtime. If the promise is rejected in production\n * mode, it most likely means you have installed the module incorrectly. Double check you've\n * followed the installation instructions. In particular, on iOS ensure that you set the `bridge`\n * property on `EXUpdatesAppController` with a pointer to the `RCTBridge` you want to reload, and on\n * Android ensure you either call `UpdatesController.initialize` with the instance of\n * `ReactApplication` you want to reload, or call `UpdatesController.setReactNativeHost` with the\n * proper instance of `ReactNativeHost`.\n */\nexport async function reloadAsync(): Promise<void> {\n  if (\n    (__DEV__ || isUsingDeveloperTool) &&\n    !shouldDeferToNativeForAPIMethodAvailabilityInDevelopment\n  ) {\n    throw new CodedError(\n      'ERR_UPDATES_DISABLED',\n      `You cannot use the Updates module in development mode in a production app. ${manualUpdatesInstructions}`\n    );\n  }\n  await ExpoUpdates.reload();\n}\n\n/**\n * Checks the server to see if a newly deployed update to your project is available. Does not\n * actually download the update. This method cannot be used in development mode, and the returned\n * promise will be rejected if you try to do so.\n *\n * Checking for an update uses a device's bandwidth and battery life like any network call.\n * Additionally, updates served by Expo may be rate limited. A good rule of thumb to check for\n * updates judiciously is to check when the user launches or foregrounds the app. Avoid polling for\n * updates in a frequent loop.\n *\n * @return A promise that fulfills with an [`UpdateCheckResult`](#updatecheckresult) object.\n *\n * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or\n * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.\n */\nexport async function checkForUpdateAsync(): Promise<UpdateCheckResult> {\n  if (\n    (__DEV__ || isUsingDeveloperTool) &&\n    !shouldDeferToNativeForAPIMethodAvailabilityInDevelopment\n  ) {\n    throw new CodedError(\n      'ERR_UPDATES_DISABLED',\n      `You cannot check for updates in development mode. ${manualUpdatesInstructions}`\n    );\n  }\n\n  const result = await ExpoUpdates.checkForUpdateAsync();\n  if ('manifestString' in result) {\n    const { manifestString, ...rest } = result;\n    return {\n      ...rest,\n      manifest: JSON.parse(manifestString),\n    };\n  }\n  return result;\n}\n\n/**\n * Retrieves the current extra params.\n *\n * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.\n */\nexport async function getExtraParamsAsync(): Promise<Record<string, string>> {\n  return await ExpoUpdates.getExtraParamsAsync();\n}\n\n/**\n * Sets an extra param if value is non-null, otherwise unsets the param.\n * Extra params are sent as an [Expo Structured Field Value Dictionary](/technical-specs/expo-sfv-0/)\n * in the `Expo-Extra-Params` header of update requests. A compliant update server may use these params when selecting an update to serve.\n *\n * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.\n */\nexport async function setExtraParamAsync(\n  key: string,\n  value: string | null | undefined\n): Promise<void> {\n  return await ExpoUpdates.setExtraParamAsync(key, value ?? null);\n}\n\n/**\n * Retrieves the most recent `expo-updates` log entries.\n *\n * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to `3600000` ms (1 hour).\n *\n * @return A promise that fulfills with an array of [`UpdatesLogEntry`](#updateslogentry) objects;\n *\n * The promise rejects if there is an unexpected error in retrieving the logs.\n */\nexport async function readLogEntriesAsync(maxAge: number = 3600000): Promise<UpdatesLogEntry[]> {\n  return await ExpoUpdates.readLogEntriesAsync(maxAge);\n}\n\n/**\n * Clears existing `expo-updates` log entries.\n *\n * > For now, this operation does nothing on the client.  Once log persistence has been\n * > implemented, this operation will actually remove existing logs.\n *\n * @return A promise that fulfills if the clear operation was successful.\n *\n * The promise rejects if there is an unexpected error in clearing the logs.\n *\n */\nexport async function clearLogEntriesAsync(): Promise<void> {\n  await ExpoUpdates.clearLogEntriesAsync();\n}\n\n/**\n * Downloads the most recently deployed update to your project from server to the device's local\n * storage. This method cannot be used in development mode, and the returned promise will be\n * rejected if you try to do so.\n *\n > **Note:** [`reloadAsync()`](#updatesreloadasync) can be called after promise resolution to\n * reload the app using the most recently downloaded version. Otherwise, the update will be applied\n * on the next app cold start.\n *\n * @return A promise that fulfills with an [`UpdateFetchResult`](#updatefetchresult) object.\n *\n * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or\n * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.\n */\nexport async function fetchUpdateAsync(): Promise<UpdateFetchResult> {\n  if (\n    (__DEV__ || isUsingDeveloperTool) &&\n    !shouldDeferToNativeForAPIMethodAvailabilityInDevelopment\n  ) {\n    throw new CodedError(\n      'ERR_UPDATES_DISABLED',\n      `You cannot fetch updates in development mode. ${manualUpdatesInstructions}`\n    );\n  }\n\n  const result = await ExpoUpdates.fetchUpdateAsync();\n  if ('manifestString' in result) {\n    const { manifestString, ...rest } = result;\n    return {\n      ...rest,\n      manifest: JSON.parse(manifestString),\n    };\n  }\n  return result;\n}\n\n/**\n * @hidden\n */\nexport function clearUpdateCacheExperimentalAsync(_sdkVersion?: string) {\n  console.warn(\n    \"This method is no longer necessary. `expo-updates` now automatically deletes your app's old bundle files!\"\n  );\n}\n\n/**\n * @hidden\n */\nexport function transformNativeStateMachineContext(\n  originalNativeContext: UpdatesNativeStateMachineContext & {\n    latestManifestString?: string;\n    downloadedManifestString?: string;\n    lastCheckForUpdateTimeString?: string;\n    rollbackString?: string;\n  }\n): UpdatesNativeStateMachineContext {\n  const nativeContext = { ...originalNativeContext };\n  if (nativeContext.latestManifestString) {\n    nativeContext.latestManifest = JSON.parse(nativeContext.latestManifestString);\n    delete nativeContext.latestManifestString;\n  }\n  if (nativeContext.downloadedManifestString) {\n    nativeContext.downloadedManifest = JSON.parse(nativeContext.downloadedManifestString);\n    delete nativeContext.downloadedManifestString;\n  }\n  if (nativeContext.lastCheckForUpdateTimeString) {\n    nativeContext.lastCheckForUpdateTime = new Date(nativeContext.lastCheckForUpdateTimeString);\n    delete nativeContext.lastCheckForUpdateTimeString;\n  }\n  if (nativeContext.rollbackString) {\n    nativeContext.rollback = JSON.parse(nativeContext.rollbackString);\n    delete nativeContext.rollbackString;\n  }\n  return nativeContext;\n}\n\n/**\n * @hidden\n */\nexport async function getNativeStateMachineContextAsync(): Promise<UpdatesNativeStateMachineContext> {\n  const nativeContext = await ExpoUpdates.getNativeStateMachineContextAsync();\n  return transformNativeStateMachineContext(nativeContext);\n}\n"]}

package/build/Updates.types.d.ts

@@ -159,7 +159,7 @@ export type UpdateFetchResultRollBackToEmbedded = {
  */
 export type UpdateFetchResult = UpdateFetchResultSuccess | UpdateFetchResultFailure | UpdateFetchResultRollBackToEmbedded;
 /**
- * An object representing a single log entry from expo-updates logging on the client.
+ * An object representing a single log entry from `expo-updates` logging on the client.
  */
 export type UpdatesLogEntry = {
     /**
@@ -192,7 +192,7 @@ export type UpdatesLogEntry = {
     stacktrace?: string[];
 };
 /**
- * The possible code values for expo-updates log entries
+ * The possible code values for `expo-updates` log entries
  */
 export declare enum UpdatesLogEntryCode {
     NONE = "None",
@@ -208,7 +208,7 @@ export declare enum UpdatesLogEntryCode {
     UNKNOWN = "Unknown"
 }
 /**
- * The possible log levels for expo-updates log entries
+ * The possible log levels for `expo-updates` log entries
  */
 export declare enum UpdatesLogEntryLevel {
     TRACE = "trace",
@@ -219,7 +219,7 @@ export declare enum UpdatesLogEntryLevel {
     FATAL = "fatal"
 }
 /**
- * The possible settings that determine if expo-updates will check for updates on app startup.
+ * The possible settings that determine if `expo-updates` will check for updates on app startup.
  * By default, Expo will check for updates every time the app is loaded.
  * Set this to `ON_ERROR_RECOVERY` to disable automatic checking unless recovering from an error.
  * Set this to `NEVER` to completely disable automatic checking.
@@ -253,6 +253,8 @@ export type UpdatesNativeStateRollback = {
     commitTime: string;
 };
 /**
+ * The native state machine context, either read directly from a native module method,
+ * or received in a state change event. Used internally by this module and not exported publicly.
  * @hidden
  */
 export type UpdatesNativeStateMachineContext = {

package/build/Updates.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Updates.types.d.ts","sourceRoot":"","sources":["../src/Updates.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Updates.types.d.ts","sourceRoot":"","sources":["../src/Updates.types.ts"],"names":[],"mappings":"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"}

package/build/Updates.types.js

@@ -25,7 +25,7 @@ export var UpdateCheckResultNotAvailableReason;
     UpdateCheckResultNotAvailableReason["ROLLBACK_NO_EMBEDDED"] = "rollbackNoEmbeddedConfiguration";
 })(UpdateCheckResultNotAvailableReason || (UpdateCheckResultNotAvailableReason = {}));
 /**
- * The possible code values for expo-updates log entries
+ * The possible code values for `expo-updates` log entries
  */
 export var UpdatesLogEntryCode;
 (function (UpdatesLogEntryCode) {
@@ -42,7 +42,7 @@ export var UpdatesLogEntryCode;
     UpdatesLogEntryCode["UNKNOWN"] = "Unknown";
 })(UpdatesLogEntryCode || (UpdatesLogEntryCode = {}));
 /**
- * The possible log levels for expo-updates log entries
+ * The possible log levels for `expo-updates` log entries
  */
 export var UpdatesLogEntryLevel;
 (function (UpdatesLogEntryLevel) {
@@ -54,7 +54,7 @@ export var UpdatesLogEntryLevel;
     UpdatesLogEntryLevel["FATAL"] = "fatal";
 })(UpdatesLogEntryLevel || (UpdatesLogEntryLevel = {}));
 /**
- * The possible settings that determine if expo-updates will check for updates on app startup.
+ * The possible settings that determine if `expo-updates` will check for updates on app startup.
  * By default, Expo will check for updates every time the app is loaded.
  * Set this to `ON_ERROR_RECOVERY` to disable automatic checking unless recovering from an error.
  * Set this to `NEVER` to completely disable automatic checking.

package/build/Updates.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Updates.types.js","sourceRoot":"","sources":["../src/Updates.types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,mCAwBX;AAxBD,WAAY,mCAAmC;IAC7C;;OAEG;IACH,kGAA2D,CAAA;IAC3D;;;OAGG;IACH,8GAAuE,CAAA;IACvE;;;OAGG;IACH,0FAAmD,CAAA;IACnD;;;OAGG;IACH,kHAA2E,CAAA;IAC3E;;OAEG;IACH,+FAAwD,CAAA;AAC1D,CAAC,EAxBW,mCAAmC,KAAnC,mCAAmC,QAwB9C;AAyLD;;GAEG;AACH,MAAM,CAAN,IAAY,mBAYX;AAZD,WAAY,mBAAmB;IAC7B,oCAAa,CAAA;IACb,kEAA2C,CAAA;IAC3C,+EAAwD,CAAA;IACxD,4EAAqD,CAAA;IACrD,iFAA0D,CAAA;IAC1D,2EAAoD,CAAA;IACpD,mEAA4C,CAAA;IAC5C,mEAA4C,CAAA;IAC5C,0DAAmC,CAAA;IACnC,mEAA4C,CAAA;IAC5C,0CAAmB,CAAA;AACrB,CAAC,EAZW,mBAAmB,KAAnB,mBAAmB,QAY9B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,uCAAe,CAAA;IACf,uCAAe,CAAA;IACf,qCAAa,CAAA;IACb,qCAAa,CAAA;IACb,uCAAe,CAAA;IACf,uCAAe,CAAA;AACjB,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,8BAiBX;AAjBD,WAAY,8BAA8B;IACxC;;OAEG;IACH,qDAAmB,CAAA;IACnB;;OAEG;IACH,yEAAuC,CAAA;IACvC;;OAEG;IACH,yDAAuB,CAAA;IACvB;;OAEG;IACH,iDAAe,CAAA;AACjB,CAAC,EAjBW,8BAA8B,KAA9B,8BAA8B,QAiBzC","sourcesContent":["import { ExpoUpdatesManifest, EmbeddedManifest } from 'expo-manifests';\n\nexport type Manifest = ExpoUpdatesManifest | EmbeddedManifest;\n\nexport enum UpdateCheckResultNotAvailableReason {\n  /**\n   * No update manifest or rollback directive received from the update server.\n   */\n  NO_UPDATE_AVAILABLE_ON_SERVER = 'noUpdateAvailableOnServer',\n  /**\n   * An update manifest was received from the update server, but the update is not launchable,\n   * or does not pass the configured selection policy.\n   */\n  UPDATE_REJECTED_BY_SELECTION_POLICY = 'updateRejectedBySelectionPolicy',\n  /**\n   * An update manifest was received from the update server, but the update has been previously\n   * launched on this device and never successfully launched.\n   */\n  UPDATE_PREVIOUSLY_FAILED = 'updatePreviouslyFailed',\n  /**\n   * A rollback directive was received from the update server, but the directive does not pass\n   * the configured selection policy.\n   */\n  ROLLBACK_REJECTED_BY_SELECTION_POLICY = 'rollbackRejectedBySelectionPolicy',\n  /**\n   * A rollback directive was received from the update server, but this app has no embedded update.\n   */\n  ROLLBACK_NO_EMBEDDED = 'rollbackNoEmbeddedConfiguration',\n}\n\n/**\n * The update check result when a rollback directive is received.\n */\nexport type UpdateCheckResultRollBack = {\n  /**\n   * Whether an update is available. This property is false for a roll back update.\n   */\n  isAvailable: false;\n  /**\n   * The manifest of the update when available.\n   */\n  manifest: undefined;\n  /**\n   * Whether a roll back to embedded update is available.\n   */\n  isRollBackToEmbedded: true;\n  /**\n   * If no new update is found, this contains one of several enum values indicating the reason.\n   */\n  reason: undefined;\n};\n\n/**\n * The update check result when a new update is found on the server.\n */\nexport type UpdateCheckResultAvailable = {\n  /**\n   * Whether an update is available. This property is false for a roll back update.\n   */\n  isAvailable: true;\n  /**\n   * The manifest of the update when available.\n   */\n  manifest: Manifest;\n  /**\n   * Whether a roll back to embedded update is available.\n   */\n  isRollBackToEmbedded: false;\n  /**\n   * If no new update is found, this contains one of several enum values indicating the reason.\n   */\n  reason: undefined;\n};\n\n/**\n * The update check result if no new update was found.\n */\nexport type UpdateCheckResultNotAvailable = {\n  /**\n   * Whether an update is available. This property is false for a roll back update.\n   */\n  isAvailable: false;\n  /**\n   * The manifest of the update when available.\n   */\n  manifest: undefined;\n  /**\n   * Whether a roll back to embedded update is available.\n   */\n  isRollBackToEmbedded: false;\n  /**\n   * If no new update is found, this contains one of several enum values indicating the reason.\n   */\n  reason: UpdateCheckResultNotAvailableReason;\n};\n\n/**\n * The result of checking for a new update.\n */\nexport type UpdateCheckResult =\n  | UpdateCheckResultRollBack\n  | UpdateCheckResultAvailable\n  | UpdateCheckResultNotAvailable;\n\n/**\n * @deprecated\n */\nexport type UpdateCheckResultSuccess = UpdateCheckResultAvailable;\n\n/**\n * @deprecated\n */\nexport type UpdateCheckResultFailure = UpdateCheckResultNotAvailable;\n\n/**\n * The successful result of fetching a new update.\n */\nexport type UpdateFetchResultSuccess = {\n  /**\n   * Whether the fetched update is new (that is, a different version than what's currently running).\n   * Always `true` when `isRollBackToEmbedded` is `false`.\n   */\n  isNew: true;\n  /**\n   * The manifest of the fetched update.\n   */\n  manifest: Manifest;\n  /**\n   * Whether the fetched update is a roll back to the embedded update.\n   */\n  isRollBackToEmbedded: false;\n};\n\n/**\n * The failed result of fetching a new update.\n */\nexport type UpdateFetchResultFailure = {\n  /**\n   * Whether the fetched update is new (that is, a different version than what's currently running).\n   * Always `false` when `isRollBackToEmbedded` is `true`.\n   */\n  isNew: false;\n  /**\n   * The manifest of the fetched update.\n   */\n  manifest: undefined;\n  /**\n   * Whether the fetched update is a roll back to the embedded update.\n   */\n  isRollBackToEmbedded: false;\n};\n\n/**\n * The roll back to embedded result of fetching a new update.\n */\nexport type UpdateFetchResultRollBackToEmbedded = {\n  /**\n   * Whether the fetched update is new (that is, a different version than what's currently running).\n   * Always `false` when `isRollBackToEmbedded` is `true`.\n   */\n  isNew: false;\n  /**\n   * The manifest of the fetched update.\n   */\n  manifest: undefined;\n  /**\n   * Whether the fetched update is a roll back to the embedded update.\n   */\n  isRollBackToEmbedded: true;\n};\n\n/**\n * The result of fetching a new update.\n */\nexport type UpdateFetchResult =\n  | UpdateFetchResultSuccess\n  | UpdateFetchResultFailure\n  | UpdateFetchResultRollBackToEmbedded;\n\n/**\n * An object representing a single log entry from expo-updates logging on the client.\n */\nexport type UpdatesLogEntry = {\n  /**\n   * The time the log was written, in milliseconds since Jan 1 1970 UTC.\n   */\n  timestamp: number;\n  /**\n   * The log entry message.\n   */\n  message: string;\n  /**\n   * One of the defined code values for `expo-updates` log entries.\n   */\n  code: UpdatesLogEntryCode;\n  /**\n   * One of the defined log level or severity values.\n   */\n  level: UpdatesLogEntryLevel;\n  /**\n   * If present, the unique ID of an update associated with this log entry.\n   */\n  updateId?: string;\n  /**\n   * If present, the unique ID or hash of an asset associated with this log entry.\n   */\n  assetId?: string;\n  /**\n   * If present, an Android or iOS native stack trace associated with this log entry.\n   */\n  stacktrace?: string[];\n};\n\n/**\n * The possible code values for expo-updates log entries\n */\nexport enum UpdatesLogEntryCode {\n  NONE = 'None',\n  NO_UPDATES_AVAILABLE = 'NoUpdatesAvailable',\n  UPDATE_ASSETS_NOT_AVAILABLE = 'UpdateAssetsNotAvailable',\n  UPDATE_SERVER_UNREACHABLE = 'UpdateServerUnreachable',\n  UPDATE_HAS_INVALID_SIGNATURE = 'UpdateHasInvalidSignature',\n  UPDATE_CODE_SIGNING_ERROR = 'UpdateCodeSigningError',\n  UPDATE_FAILED_TO_LOAD = 'UpdateFailedToLoad',\n  ASSETS_FAILED_TO_LOAD = 'AssetsFailedToLoad',\n  JS_RUNTIME_ERROR = 'JSRuntimeError',\n  INITIALIZATION_ERROR = 'InitializationError',\n  UNKNOWN = 'Unknown',\n}\n\n/**\n * The possible log levels for expo-updates log entries\n */\nexport enum UpdatesLogEntryLevel {\n  TRACE = 'trace',\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n  FATAL = 'fatal',\n}\n\n/**\n * The possible settings that determine if expo-updates will check for updates on app startup.\n * By default, Expo will check for updates every time the app is loaded.\n * Set this to `ON_ERROR_RECOVERY` to disable automatic checking unless recovering from an error.\n * Set this to `NEVER` to completely disable automatic checking.\n */\nexport enum UpdatesCheckAutomaticallyValue {\n  /**\n   * Checks for updates whenever the app is loaded. This is the default setting.\n   */\n  ON_LOAD = 'ON_LOAD',\n  /**\n   * Only checks for updates when the app starts up after an error recovery.\n   */\n  ON_ERROR_RECOVERY = 'ON_ERROR_RECOVERY',\n  /**\n   * Only checks for updates when the app starts and has a Wi-Fi connection.\n   */\n  WIFI_ONLY = 'WIFI_ONLY',\n  /**\n   * Automatic update checks are off, and update checks must be done through the JS API.\n   */\n  NEVER = 'NEVER',\n}\n\n/**\n * @hidden\n */\nexport type LocalAssets = Record<string, string>;\n\n/**\n * @hidden\n */\nexport type UpdatesNativeStateRollback = {\n  // ISO date string with the rollback commit time\n  commitTime: string;\n};\n\n/**\n * @hidden\n */\nexport type UpdatesNativeStateMachineContext = {\n  // The native state machine context, either read directly from a native module method,\n  // or received in a state change event. Used internally by this module and not exported publicly.\n  isUpdateAvailable: boolean;\n  isUpdatePending: boolean;\n  isChecking: boolean;\n  isDownloading: boolean;\n  isRestarting: boolean;\n  latestManifest?: Manifest;\n  downloadedManifest?: Manifest;\n  rollback?: UpdatesNativeStateRollback;\n  checkError?: Error;\n  downloadError?: Error;\n  lastCheckForUpdateTime?: Date;\n};\n\n/**\n * @hidden\n */\nexport type UpdatesNativeStateChangeEvent = {\n  // Change event emitted by native\n  context: UpdatesNativeStateMachineContext;\n};\n"]}
+{"version":3,"file":"Updates.types.js","sourceRoot":"","sources":["../src/Updates.types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,mCAwBX;AAxBD,WAAY,mCAAmC;IAC7C;;OAEG;IACH,kGAA2D,CAAA;IAC3D;;;OAGG;IACH,8GAAuE,CAAA;IACvE;;;OAGG;IACH,0FAAmD,CAAA;IACnD;;;OAGG;IACH,kHAA2E,CAAA;IAC3E;;OAEG;IACH,+FAAwD,CAAA;AAC1D,CAAC,EAxBW,mCAAmC,KAAnC,mCAAmC,QAwB9C;AAyLD;;GAEG;AACH,MAAM,CAAN,IAAY,mBAYX;AAZD,WAAY,mBAAmB;IAC7B,oCAAa,CAAA;IACb,kEAA2C,CAAA;IAC3C,+EAAwD,CAAA;IACxD,4EAAqD,CAAA;IACrD,iFAA0D,CAAA;IAC1D,2EAAoD,CAAA;IACpD,mEAA4C,CAAA;IAC5C,mEAA4C,CAAA;IAC5C,0DAAmC,CAAA;IACnC,mEAA4C,CAAA;IAC5C,0CAAmB,CAAA;AACrB,CAAC,EAZW,mBAAmB,KAAnB,mBAAmB,QAY9B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,uCAAe,CAAA;IACf,uCAAe,CAAA;IACf,qCAAa,CAAA;IACb,qCAAa,CAAA;IACb,uCAAe,CAAA;IACf,uCAAe,CAAA;AACjB,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,8BAiBX;AAjBD,WAAY,8BAA8B;IACxC;;OAEG;IACH,qDAAmB,CAAA;IACnB;;OAEG;IACH,yEAAuC,CAAA;IACvC;;OAEG;IACH,yDAAuB,CAAA;IACvB;;OAEG;IACH,iDAAe,CAAA;AACjB,CAAC,EAjBW,8BAA8B,KAA9B,8BAA8B,QAiBzC","sourcesContent":["import { ExpoUpdatesManifest, EmbeddedManifest } from 'expo-manifests';\n\nexport type Manifest = ExpoUpdatesManifest | EmbeddedManifest;\n\nexport enum UpdateCheckResultNotAvailableReason {\n  /**\n   * No update manifest or rollback directive received from the update server.\n   */\n  NO_UPDATE_AVAILABLE_ON_SERVER = 'noUpdateAvailableOnServer',\n  /**\n   * An update manifest was received from the update server, but the update is not launchable,\n   * or does not pass the configured selection policy.\n   */\n  UPDATE_REJECTED_BY_SELECTION_POLICY = 'updateRejectedBySelectionPolicy',\n  /**\n   * An update manifest was received from the update server, but the update has been previously\n   * launched on this device and never successfully launched.\n   */\n  UPDATE_PREVIOUSLY_FAILED = 'updatePreviouslyFailed',\n  /**\n   * A rollback directive was received from the update server, but the directive does not pass\n   * the configured selection policy.\n   */\n  ROLLBACK_REJECTED_BY_SELECTION_POLICY = 'rollbackRejectedBySelectionPolicy',\n  /**\n   * A rollback directive was received from the update server, but this app has no embedded update.\n   */\n  ROLLBACK_NO_EMBEDDED = 'rollbackNoEmbeddedConfiguration',\n}\n\n/**\n * The update check result when a rollback directive is received.\n */\nexport type UpdateCheckResultRollBack = {\n  /**\n   * Whether an update is available. This property is false for a roll back update.\n   */\n  isAvailable: false;\n  /**\n   * The manifest of the update when available.\n   */\n  manifest: undefined;\n  /**\n   * Whether a roll back to embedded update is available.\n   */\n  isRollBackToEmbedded: true;\n  /**\n   * If no new update is found, this contains one of several enum values indicating the reason.\n   */\n  reason: undefined;\n};\n\n/**\n * The update check result when a new update is found on the server.\n */\nexport type UpdateCheckResultAvailable = {\n  /**\n   * Whether an update is available. This property is false for a roll back update.\n   */\n  isAvailable: true;\n  /**\n   * The manifest of the update when available.\n   */\n  manifest: Manifest;\n  /**\n   * Whether a roll back to embedded update is available.\n   */\n  isRollBackToEmbedded: false;\n  /**\n   * If no new update is found, this contains one of several enum values indicating the reason.\n   */\n  reason: undefined;\n};\n\n/**\n * The update check result if no new update was found.\n */\nexport type UpdateCheckResultNotAvailable = {\n  /**\n   * Whether an update is available. This property is false for a roll back update.\n   */\n  isAvailable: false;\n  /**\n   * The manifest of the update when available.\n   */\n  manifest: undefined;\n  /**\n   * Whether a roll back to embedded update is available.\n   */\n  isRollBackToEmbedded: false;\n  /**\n   * If no new update is found, this contains one of several enum values indicating the reason.\n   */\n  reason: UpdateCheckResultNotAvailableReason;\n};\n\n/**\n * The result of checking for a new update.\n */\nexport type UpdateCheckResult =\n  | UpdateCheckResultRollBack\n  | UpdateCheckResultAvailable\n  | UpdateCheckResultNotAvailable;\n\n/**\n * @deprecated\n */\nexport type UpdateCheckResultSuccess = UpdateCheckResultAvailable;\n\n/**\n * @deprecated\n */\nexport type UpdateCheckResultFailure = UpdateCheckResultNotAvailable;\n\n/**\n * The successful result of fetching a new update.\n */\nexport type UpdateFetchResultSuccess = {\n  /**\n   * Whether the fetched update is new (that is, a different version than what's currently running).\n   * Always `true` when `isRollBackToEmbedded` is `false`.\n   */\n  isNew: true;\n  /**\n   * The manifest of the fetched update.\n   */\n  manifest: Manifest;\n  /**\n   * Whether the fetched update is a roll back to the embedded update.\n   */\n  isRollBackToEmbedded: false;\n};\n\n/**\n * The failed result of fetching a new update.\n */\nexport type UpdateFetchResultFailure = {\n  /**\n   * Whether the fetched update is new (that is, a different version than what's currently running).\n   * Always `false` when `isRollBackToEmbedded` is `true`.\n   */\n  isNew: false;\n  /**\n   * The manifest of the fetched update.\n   */\n  manifest: undefined;\n  /**\n   * Whether the fetched update is a roll back to the embedded update.\n   */\n  isRollBackToEmbedded: false;\n};\n\n/**\n * The roll back to embedded result of fetching a new update.\n */\nexport type UpdateFetchResultRollBackToEmbedded = {\n  /**\n   * Whether the fetched update is new (that is, a different version than what's currently running).\n   * Always `false` when `isRollBackToEmbedded` is `true`.\n   */\n  isNew: false;\n  /**\n   * The manifest of the fetched update.\n   */\n  manifest: undefined;\n  /**\n   * Whether the fetched update is a roll back to the embedded update.\n   */\n  isRollBackToEmbedded: true;\n};\n\n/**\n * The result of fetching a new update.\n */\nexport type UpdateFetchResult =\n  | UpdateFetchResultSuccess\n  | UpdateFetchResultFailure\n  | UpdateFetchResultRollBackToEmbedded;\n\n/**\n * An object representing a single log entry from `expo-updates` logging on the client.\n */\nexport type UpdatesLogEntry = {\n  /**\n   * The time the log was written, in milliseconds since Jan 1 1970 UTC.\n   */\n  timestamp: number;\n  /**\n   * The log entry message.\n   */\n  message: string;\n  /**\n   * One of the defined code values for `expo-updates` log entries.\n   */\n  code: UpdatesLogEntryCode;\n  /**\n   * One of the defined log level or severity values.\n   */\n  level: UpdatesLogEntryLevel;\n  /**\n   * If present, the unique ID of an update associated with this log entry.\n   */\n  updateId?: string;\n  /**\n   * If present, the unique ID or hash of an asset associated with this log entry.\n   */\n  assetId?: string;\n  /**\n   * If present, an Android or iOS native stack trace associated with this log entry.\n   */\n  stacktrace?: string[];\n};\n\n/**\n * The possible code values for `expo-updates` log entries\n */\nexport enum UpdatesLogEntryCode {\n  NONE = 'None',\n  NO_UPDATES_AVAILABLE = 'NoUpdatesAvailable',\n  UPDATE_ASSETS_NOT_AVAILABLE = 'UpdateAssetsNotAvailable',\n  UPDATE_SERVER_UNREACHABLE = 'UpdateServerUnreachable',\n  UPDATE_HAS_INVALID_SIGNATURE = 'UpdateHasInvalidSignature',\n  UPDATE_CODE_SIGNING_ERROR = 'UpdateCodeSigningError',\n  UPDATE_FAILED_TO_LOAD = 'UpdateFailedToLoad',\n  ASSETS_FAILED_TO_LOAD = 'AssetsFailedToLoad',\n  JS_RUNTIME_ERROR = 'JSRuntimeError',\n  INITIALIZATION_ERROR = 'InitializationError',\n  UNKNOWN = 'Unknown',\n}\n\n/**\n * The possible log levels for `expo-updates` log entries\n */\nexport enum UpdatesLogEntryLevel {\n  TRACE = 'trace',\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n  FATAL = 'fatal',\n}\n\n/**\n * The possible settings that determine if `expo-updates` will check for updates on app startup.\n * By default, Expo will check for updates every time the app is loaded.\n * Set this to `ON_ERROR_RECOVERY` to disable automatic checking unless recovering from an error.\n * Set this to `NEVER` to completely disable automatic checking.\n */\nexport enum UpdatesCheckAutomaticallyValue {\n  /**\n   * Checks for updates whenever the app is loaded. This is the default setting.\n   */\n  ON_LOAD = 'ON_LOAD',\n  /**\n   * Only checks for updates when the app starts up after an error recovery.\n   */\n  ON_ERROR_RECOVERY = 'ON_ERROR_RECOVERY',\n  /**\n   * Only checks for updates when the app starts and has a Wi-Fi connection.\n   */\n  WIFI_ONLY = 'WIFI_ONLY',\n  /**\n   * Automatic update checks are off, and update checks must be done through the JS API.\n   */\n  NEVER = 'NEVER',\n}\n\n/**\n * @hidden\n */\nexport type LocalAssets = Record<string, string>;\n\n/**\n * @hidden\n */\nexport type UpdatesNativeStateRollback = {\n  // ISO date string with the rollback commit time\n  commitTime: string;\n};\n\n/**\n * The native state machine context, either read directly from a native module method,\n * or received in a state change event. Used internally by this module and not exported publicly.\n * @hidden\n */\nexport type UpdatesNativeStateMachineContext = {\n  isUpdateAvailable: boolean;\n  isUpdatePending: boolean;\n  isChecking: boolean;\n  isDownloading: boolean;\n  isRestarting: boolean;\n  latestManifest?: Manifest;\n  downloadedManifest?: Manifest;\n  rollback?: UpdatesNativeStateRollback;\n  checkError?: Error;\n  downloadError?: Error;\n  lastCheckForUpdateTime?: Date;\n};\n\n/**\n * @hidden\n */\nexport type UpdatesNativeStateChangeEvent = {\n  // Change event emitted by native\n  context: UpdatesNativeStateMachineContext;\n};\n"]}

package/build/UseUpdates.types.d.ts

@@ -8,11 +8,12 @@ export type CurrentlyRunningInfo = {
      * The UUID that uniquely identifies the currently running update if `expo-updates` is enabled. The
      * UUID is represented in its canonical string form and will always use lowercase letters.
      * In development mode, or any other environment in which `expo-updates` is disabled, this value is undefined.
-     * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+     * @example
+     * `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
      */
     updateId?: string;
     /**
-     * The channel name of the current build, if configured for use with EAS Update; undefined otherwise.
+     * The channel name of the current build, if configured for use with EAS Update, `undefined` otherwise.
      */
     channel?: string;
     /**
@@ -76,7 +77,7 @@ export declare enum UpdateInfoType {
 /**
  * Structure representing a new update.
  */
-type UpdateInfoNew = {
+export type UpdateInfoNew = {
     /**
      * The type of update.
      */
@@ -85,7 +86,8 @@ type UpdateInfoNew = {
      * For updates of type `UpdateInfoType.NEW`, this is
      * a string that uniquely identifies the update. For the manifests used in the current Expo Updates protocol (including
      * EAS Update), this represents the update's UUID in its canonical string form and will always use lowercase letters.
-     * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+     * @example
+     * `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
      */
     updateId: string;
     /**
@@ -102,13 +104,13 @@ type UpdateInfoNew = {
 /**
  * Structure representing a rollback directive.
  */
-type UpdateInfoRollback = {
+export type UpdateInfoRollback = {
     /**
      * The type of update.
      */
     type: UpdateInfoType.ROLLBACK;
     /**
-     * For updates of type `UpdateInfoType.ROLLBACK`, this is undefined.
+     * For updates of type `UpdateInfoType.ROLLBACK`, this is always set to `undefined`.
      */
     updateId: undefined;
     /**
@@ -117,7 +119,7 @@ type UpdateInfoRollback = {
      */
     createdAt: Date;
     /**
-     * For updates of type `UpdateInfoType.ROLLBACK`, this is undefined.
+     * For updates of type `UpdateInfoType.ROLLBACK`, this is always set to `undefined`.
      */
     manifest: undefined;
 };
@@ -126,7 +128,7 @@ type UpdateInfoRollback = {
  */
 export type UpdateInfo = UpdateInfoNew | UpdateInfoRollback;
 /**
- * The structures and methods returned by `useUpdates()`.
+ * The structures and methods returned by [`useUpdates()`](#useupdates).
  */
 export type UseUpdatesReturnType = {
     /**
@@ -134,9 +136,8 @@ export type UseUpdatesReturnType = {
      */
     currentlyRunning: CurrentlyRunningInfo;
     /**
-     * If a new available update has been found, either by using checkForUpdate(),
-     * or by the `UpdateEvent` listener in `useUpdates()`,
-     * this will contain the information for that update.
+     * If a new available update has been found, either by using [`checkForUpdateAsync()`](#updatescheckforupdateasync),
+     * or by the `UpdateEvent` listener in `useUpdates()`, this will contain the information for that update.
      */
     availableUpdate?: UpdateInfo;
     /**
@@ -161,17 +162,17 @@ export type UseUpdatesReturnType = {
      */
     isDownloading: boolean;
     /**
-     * If an error is returned from either the startup check for updates, or a call to `checkForUpdateAsync()`,
+     * If an error is returned from either the startup check for updates, or a call to [`checkForUpdateAsync()`](#updatescheckforupdateasync),
      * the error description will appear here.
      */
     checkError?: Error;
     /**
-     * If an error is returned from either a startup update download, or a call to `fetchUpdateAsync()`,
+     * If an error is returned from either a startup update download, or a call to [`fetchUpdateAsync()`](#updatesfetchupdateasync),
      * the error description will appear here.
      */
     downloadError?: Error;
     /**
-     * If an error occurs during initialization of `useUpdates()`, the error description will appear here.
+     * If an error occurs during initialization of [`useUpdates()`](#useupdates), the error description will appear here.
      */
     initializationError?: Error;
     /**
@@ -181,5 +182,4 @@ export type UseUpdatesReturnType = {
      */
     lastCheckForUpdateTimeSinceRestart?: Date;
 };
-export {};
 //# sourceMappingURL=UseUpdates.types.d.ts.map

package/build/UseUpdates.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UseUpdates.types.d.ts","sourceRoot":"","sources":["../src/UseUpdates.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;;;;OAQG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,GAAG,QAAQ;IACX;;OAEG;IACH,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,KAAK,aAAa,GAAG;IACnB;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,KAAK,kBAAkB,GAAG;IACxB;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC;IAC9B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,gBAAgB,EAAE,oBAAoB,CAAC;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB;;OAEG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B;;;;OAIG;IACH,kCAAkC,CAAC,EAAE,IAAI,CAAC;CAC3C,CAAC"}
+{"version":3,"file":"UseUpdates.types.d.ts","sourceRoot":"","sources":["../src/UseUpdates.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;;;;OAQG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,GAAG,QAAQ;IACX;;OAEG;IACH,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC;IAChB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC;IAC9B;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,gBAAgB,EAAE,oBAAoB,CAAC;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B;;OAEG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB;;OAEG;IACH,mBAAmB,CAAC,EAAE,KAAK,CAAC;IAC5B;;;;OAIG;IACH,kCAAkC,CAAC,EAAE,IAAI,CAAC;CAC3C,CAAC"}

package/build/UseUpdates.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"UseUpdates.types.js","sourceRoot":"","sources":["../src/UseUpdates.types.ts"],"names":[],"mappings":"AA6DA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,cASX;AATD,WAAY,cAAc;IACxB;;OAEG;IACH,6BAAW,CAAA;IACX;;OAEG;IACH,uCAAqB,CAAA;AACvB,CAAC,EATW,cAAc,KAAd,cAAc,QASzB","sourcesContent":["import type { Manifest } from './Updates.types';\n\n/**\n * Structure encapsulating information on the currently running app\n * (either the embedded bundle or a downloaded update).\n */\nexport type CurrentlyRunningInfo = {\n  /**\n   * The UUID that uniquely identifies the currently running update if `expo-updates` is enabled. The\n   * UUID is represented in its canonical string form and will always use lowercase letters.\n   * In development mode, or any other environment in which `expo-updates` is disabled, this value is undefined.\n   * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\n   */\n  updateId?: string;\n  /**\n   * The channel name of the current build, if configured for use with EAS Update; undefined otherwise.\n   */\n  channel?: string;\n  /**\n   * If `expo-updates` is enabled, this is a `Date` object representing the creation time of the update\n   * that's currently running (whether it was embedded or downloaded at runtime).\n   *\n   * In development mode, or any other environment in which `expo-updates` is disabled, this value is\n   * undefined.\n   */\n  createdAt?: Date;\n  /**\n   * This will be true if the currently running update is the one embedded in the build,\n   * and not one downloaded from the updates server.\n   */\n  isEmbeddedLaunch: boolean;\n  /**\n   * `expo-updates` does its very best to always launch monotonically newer versions of your app so\n   * you don't need to worry about backwards compatibility when you put out an update. In very rare\n   * cases, it's possible that `expo-updates` may need to fall back to the update that's embedded in\n   * the app binary, even after newer updates have been downloaded and run (an \"emergency launch\").\n   * This boolean will be `true` if the app is launching under this fallback mechanism and `false`\n   * otherwise. If you are concerned about backwards compatibility of future updates to your app, you\n   * can use this constant to provide special behavior for this rare case.\n   */\n  isEmergencyLaunch: boolean;\n  /**\n   * If `isEmergencyLaunch` is set to true, this will contain a string error message describing\n   * what failed during initialization.\n   */\n  emergencyLaunchReason: string | null;\n  /**\n   * If `expo-updates` is enabled, this is the\n   * [manifest](https://docs.expo.dev/versions/latest/sdk/updates/#updatesmanifest) object for the update that's currently\n   * running.\n   *\n   * In development mode, or any other environment in which `expo-updates` is disabled, this object is\n   * empty.\n   */\n  manifest?: Partial<Manifest>;\n  /**\n   * The runtime version of the current build.\n   */\n  runtimeVersion?: string;\n};\n\n/**\n * The different possible types of updates.\n * Currently, the only supported type is `UpdateInfoType.NEW`, indicating a new update that can be downloaded and launched\n * on the device.\n * In the future, other types of updates may be added to this list.\n */\nexport enum UpdateInfoType {\n  /**\n   * This is the type for new updates found on or downloaded from the update server, that are launchable on the device.\n   */\n  NEW = 'new',\n  /**\n   * This type is used when an update is a directive to roll back to the embedded bundle.\n   */\n  ROLLBACK = 'rollback',\n}\n\n/**\n * Structure representing a new update.\n */\ntype UpdateInfoNew = {\n  /**\n   * The type of update.\n   */\n  type: UpdateInfoType.NEW;\n  /**\n   * For updates of type `UpdateInfoType.NEW`, this is\n   * a string that uniquely identifies the update. For the manifests used in the current Expo Updates protocol (including\n   * EAS Update), this represents the update's UUID in its canonical string form and will always use lowercase letters.\n   * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\n   */\n  updateId: string;\n  /**\n   * For all types of updates, this is\n   * a `Date` object representing the creation time or commit time of the update.\n   */\n  createdAt: Date;\n  /**\n   * For updates of type `UpdateInfoType.NEW`, this is\n   * the [manifest](https://docs.expo.dev/versions/latest/sdk/constants/#manifest) for the update.\n   */\n  manifest: Manifest;\n};\n\n/**\n * Structure representing a rollback directive.\n */\ntype UpdateInfoRollback = {\n  /**\n   * The type of update.\n   */\n  type: UpdateInfoType.ROLLBACK;\n  /**\n   * For updates of type `UpdateInfoType.ROLLBACK`, this is undefined.\n   */\n  updateId: undefined;\n  /**\n   * For all types of updates, this is\n   * a `Date` object representing the creation time or commit time of the update.\n   */\n  createdAt: Date;\n  /**\n   * For updates of type `UpdateInfoType.ROLLBACK`, this is undefined.\n   */\n  manifest: undefined;\n};\n\n/**\n * Combined structure representing any type of update.\n */\nexport type UpdateInfo = UpdateInfoNew | UpdateInfoRollback;\n\n/**\n * The structures and methods returned by `useUpdates()`.\n */\nexport type UseUpdatesReturnType = {\n  /**\n   * Information on the currently running app.\n   */\n  currentlyRunning: CurrentlyRunningInfo;\n  /**\n   * If a new available update has been found, either by using checkForUpdate(),\n   * or by the `UpdateEvent` listener in `useUpdates()`,\n   * this will contain the information for that update.\n   */\n  availableUpdate?: UpdateInfo;\n  /**\n   * If an available update has been downloaded, this will contain the information\n   * for that update.\n   */\n  downloadedUpdate?: UpdateInfo;\n  /**\n   * True if a new available update has been found, false otherwise.\n   */\n  isUpdateAvailable: boolean;\n  /**\n   * True if a new available update is available and has been downloaded.\n   */\n  isUpdatePending: boolean;\n  /**\n   * True if the app is currently checking for a new available update from the server.\n   */\n  isChecking: boolean;\n  /**\n   * True if the app is currently downloading an update from the server.\n   */\n  isDownloading: boolean;\n  /**\n   * If an error is returned from either the startup check for updates, or a call to `checkForUpdateAsync()`,\n   * the error description will appear here.\n   */\n  checkError?: Error;\n  /**\n   * If an error is returned from either a startup update download, or a call to `fetchUpdateAsync()`,\n   * the error description will appear here.\n   */\n  downloadError?: Error;\n  /**\n   * If an error occurs during initialization of `useUpdates()`, the error description will appear here.\n   */\n  initializationError?: Error;\n  /**\n   * A `Date` object representing the last time this client checked for an available update,\n   * or `undefined` if no check has yet occurred since the app started. Does not persist across\n   * app reloads or restarts.\n   */\n  lastCheckForUpdateTimeSinceRestart?: Date;\n};\n"]}
+{"version":3,"file":"UseUpdates.types.js","sourceRoot":"","sources":["../src/UseUpdates.types.ts"],"names":[],"mappings":"AA8DA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,cASX;AATD,WAAY,cAAc;IACxB;;OAEG;IACH,6BAAW,CAAA;IACX;;OAEG;IACH,uCAAqB,CAAA;AACvB,CAAC,EATW,cAAc,KAAd,cAAc,QASzB","sourcesContent":["import type { Manifest } from './Updates.types';\n\n/**\n * Structure encapsulating information on the currently running app\n * (either the embedded bundle or a downloaded update).\n */\nexport type CurrentlyRunningInfo = {\n  /**\n   * The UUID that uniquely identifies the currently running update if `expo-updates` is enabled. The\n   * UUID is represented in its canonical string form and will always use lowercase letters.\n   * In development mode, or any other environment in which `expo-updates` is disabled, this value is undefined.\n   * @example\n   * `\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"`\n   */\n  updateId?: string;\n  /**\n   * The channel name of the current build, if configured for use with EAS Update, `undefined` otherwise.\n   */\n  channel?: string;\n  /**\n   * If `expo-updates` is enabled, this is a `Date` object representing the creation time of the update\n   * that's currently running (whether it was embedded or downloaded at runtime).\n   *\n   * In development mode, or any other environment in which `expo-updates` is disabled, this value is\n   * undefined.\n   */\n  createdAt?: Date;\n  /**\n   * This will be true if the currently running update is the one embedded in the build,\n   * and not one downloaded from the updates server.\n   */\n  isEmbeddedLaunch: boolean;\n  /**\n   * `expo-updates` does its very best to always launch monotonically newer versions of your app so\n   * you don't need to worry about backwards compatibility when you put out an update. In very rare\n   * cases, it's possible that `expo-updates` may need to fall back to the update that's embedded in\n   * the app binary, even after newer updates have been downloaded and run (an \"emergency launch\").\n   * This boolean will be `true` if the app is launching under this fallback mechanism and `false`\n   * otherwise. If you are concerned about backwards compatibility of future updates to your app, you\n   * can use this constant to provide special behavior for this rare case.\n   */\n  isEmergencyLaunch: boolean;\n  /**\n   * If `isEmergencyLaunch` is set to true, this will contain a string error message describing\n   * what failed during initialization.\n   */\n  emergencyLaunchReason: string | null;\n  /**\n   * If `expo-updates` is enabled, this is the\n   * [manifest](https://docs.expo.dev/versions/latest/sdk/updates/#updatesmanifest) object for the update that's currently\n   * running.\n   *\n   * In development mode, or any other environment in which `expo-updates` is disabled, this object is\n   * empty.\n   */\n  manifest?: Partial<Manifest>;\n  /**\n   * The runtime version of the current build.\n   */\n  runtimeVersion?: string;\n};\n\n/**\n * The different possible types of updates.\n * Currently, the only supported type is `UpdateInfoType.NEW`, indicating a new update that can be downloaded and launched\n * on the device.\n * In the future, other types of updates may be added to this list.\n */\nexport enum UpdateInfoType {\n  /**\n   * This is the type for new updates found on or downloaded from the update server, that are launchable on the device.\n   */\n  NEW = 'new',\n  /**\n   * This type is used when an update is a directive to roll back to the embedded bundle.\n   */\n  ROLLBACK = 'rollback',\n}\n\n/**\n * Structure representing a new update.\n */\nexport type UpdateInfoNew = {\n  /**\n   * The type of update.\n   */\n  type: UpdateInfoType.NEW;\n  /**\n   * For updates of type `UpdateInfoType.NEW`, this is\n   * a string that uniquely identifies the update. For the manifests used in the current Expo Updates protocol (including\n   * EAS Update), this represents the update's UUID in its canonical string form and will always use lowercase letters.\n   * @example\n   * `\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"`\n   */\n  updateId: string;\n  /**\n   * For all types of updates, this is\n   * a `Date` object representing the creation time or commit time of the update.\n   */\n  createdAt: Date;\n  /**\n   * For updates of type `UpdateInfoType.NEW`, this is\n   * the [manifest](https://docs.expo.dev/versions/latest/sdk/constants/#manifest) for the update.\n   */\n  manifest: Manifest;\n};\n\n/**\n * Structure representing a rollback directive.\n */\nexport type UpdateInfoRollback = {\n  /**\n   * The type of update.\n   */\n  type: UpdateInfoType.ROLLBACK;\n  /**\n   * For updates of type `UpdateInfoType.ROLLBACK`, this is always set to `undefined`.\n   */\n  updateId: undefined;\n  /**\n   * For all types of updates, this is\n   * a `Date` object representing the creation time or commit time of the update.\n   */\n  createdAt: Date;\n  /**\n   * For updates of type `UpdateInfoType.ROLLBACK`, this is always set to `undefined`.\n   */\n  manifest: undefined;\n};\n\n/**\n * Combined structure representing any type of update.\n */\nexport type UpdateInfo = UpdateInfoNew | UpdateInfoRollback;\n\n/**\n * The structures and methods returned by [`useUpdates()`](#useupdates).\n */\nexport type UseUpdatesReturnType = {\n  /**\n   * Information on the currently running app.\n   */\n  currentlyRunning: CurrentlyRunningInfo;\n  /**\n   * If a new available update has been found, either by using [`checkForUpdateAsync()`](#updatescheckforupdateasync),\n   * or by the `UpdateEvent` listener in `useUpdates()`, this will contain the information for that update.\n   */\n  availableUpdate?: UpdateInfo;\n  /**\n   * If an available update has been downloaded, this will contain the information\n   * for that update.\n   */\n  downloadedUpdate?: UpdateInfo;\n  /**\n   * True if a new available update has been found, false otherwise.\n   */\n  isUpdateAvailable: boolean;\n  /**\n   * True if a new available update is available and has been downloaded.\n   */\n  isUpdatePending: boolean;\n  /**\n   * True if the app is currently checking for a new available update from the server.\n   */\n  isChecking: boolean;\n  /**\n   * True if the app is currently downloading an update from the server.\n   */\n  isDownloading: boolean;\n  /**\n   * If an error is returned from either the startup check for updates, or a call to [`checkForUpdateAsync()`](#updatescheckforupdateasync),\n   * the error description will appear here.\n   */\n  checkError?: Error;\n  /**\n   * If an error is returned from either a startup update download, or a call to [`fetchUpdateAsync()`](#updatesfetchupdateasync),\n   * the error description will appear here.\n   */\n  downloadError?: Error;\n  /**\n   * If an error occurs during initialization of [`useUpdates()`](#useupdates), the error description will appear here.\n   */\n  initializationError?: Error;\n  /**\n   * A `Date` object representing the last time this client checked for an available update,\n   * or `undefined` if no check has yet occurred since the app started. Does not persist across\n   * app reloads or restarts.\n   */\n  lastCheckForUpdateTimeSinceRestart?: Date;\n};\n"]}

package/build/statemachine/UpdatesStateMachine.d.ts

@@ -40,8 +40,8 @@ export interface UpdatesStateMachineContext {
     downloadError?: Error;
 }
 /**
- * Model of the expo-updates state machine, written in Typescript.
- * The actual implementations of this state machine will be in Swift on iOS and Kotlin on Android.
+ * Model of the `expo-updates` state machine, written in Typescript.
+ * The actual implementations of this state machine will be in Kotlin on Android and Swift on iOS.
  */
 export declare const UpdatesStateMachine: import("xstate").StateMachine<UpdatesStateMachineContext, any, import("xstate").AnyEventObject, {
     value: any;

package/build/statemachine/UpdatesStateMachine.js

@@ -50,8 +50,8 @@ const download = assign({
     isDownloading: (context) => true,
 });
 /**
- * Model of the expo-updates state machine, written in Typescript.
- * The actual implementations of this state machine will be in Swift on iOS and Kotlin on Android.
+ * Model of the `expo-updates` state machine, written in Typescript.
+ * The actual implementations of this state machine will be in Kotlin on Android and Swift on iOS.
  */
 export const UpdatesStateMachine = createMachine({
     id: 'Updates',

package/build/statemachine/UpdatesStateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"UpdatesStateMachine.js","sourceRoot":"","sources":["../../src/statemachine/UpdatesStateMachine.ts"],"names":[],"mappings":"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","sourcesContent":["import { createMachine, assign } from 'xstate';\n\nexport enum UpdatesStateMachineEventTypes {\n  CHECK = 'check',\n  CHECK_COMPLETE_AVAILABLE = 'checkCompleteAvailable',\n  CHECK_COMPLETE_UNAVAILABLE = 'checkCompleteUnavailable',\n  CHECK_ERROR = 'checkError',\n  DOWNLOAD = 'download',\n  DOWNLOAD_COMPLETE = 'downloadComplete',\n  DOWNLOAD_ERROR = 'downloadError',\n  RESTART = 'restart',\n}\n\n/**\n * Simplified model for an update manifest\n */\nexport type Manifest = {\n  updateId: string;\n};\n\n/**\n * Model for an update event\n */\nexport type UpdatesStateMachineEvent = {\n  type: UpdatesStateMachineEventTypes;\n  body: {\n    message?: string;\n    manifest?: Manifest;\n    isRollBackToEmbedded?: boolean;\n  };\n};\n\n/**\n * The context structure\n */\nexport interface UpdatesStateMachineContext {\n  isUpdateAvailable: boolean;\n  isUpdatePending: boolean;\n  latestManifest?: Manifest;\n  isChecking: boolean;\n  isDownloading: boolean;\n  isRollback: boolean;\n  downloadedManifest?: Manifest;\n  checkError?: Error;\n  downloadError?: Error;\n}\n\n/**\n * Actions that modify the context\n */\nconst checkCompleteAvailableAction = assign({\n  latestManifest: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest || undefined,\n  checkError: () => undefined,\n  isChecking: () => false,\n  isUpdateAvailable: () => true,\n  isRollback: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    Boolean(event.body?.isRollBackToEmbedded),\n});\n\nconst checkCompleteUnavailableAction = assign({\n  latestManifest: () => undefined,\n  checkError: () => undefined,\n  isChecking: () => false,\n  isUpdateAvailable: () => false,\n  isRollback: () => false,\n});\n\nconst checkErrorAction = assign({\n  isChecking: () => false,\n  checkError: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    new Error(event.body?.message || 'checkError'),\n});\n\nconst downloadCompleteAction = assign({\n  downloadedManifest: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest || context.downloadedManifest,\n  latestManifest: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest || context.latestManifest,\n  downloadError: () => undefined,\n  isDownloading: () => false,\n  isUpdatePending: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    !!(event.body?.manifest || context.downloadedManifest),\n  isUpdateAvailable: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest !== undefined || context.isUpdateAvailable,\n});\n\nconst downloadErrorAction = assign({\n  downloadError: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    new Error(event.body?.message || 'downloadError'),\n  isDownloading: () => false,\n});\n\nconst check = assign({\n  isChecking: (context: UpdatesStateMachineContext) => true,\n});\n\nconst download = assign({\n  isDownloading: (context: UpdatesStateMachineContext) => true,\n});\n\n/**\n * Model of the expo-updates state machine, written in Typescript.\n * The actual implementations of this state machine will be in Swift on iOS and Kotlin on Android.\n */\nexport const UpdatesStateMachine = createMachine<UpdatesStateMachineContext>({\n  id: 'Updates',\n  initial: 'idle',\n  context: {\n    isChecking: false,\n    isDownloading: false,\n    isUpdateAvailable: false,\n    isUpdatePending: false,\n    isRollback: false,\n  },\n  predictableActionArguments: true,\n  states: {\n    idle: {\n      on: {\n        check: {\n          target: 'checking',\n          actions: check,\n        },\n        download: {\n          target: 'downloading',\n          actions: download,\n        },\n        restart: {\n          target: 'restarting',\n        },\n      },\n    },\n    checking: {\n      on: {\n        checkCompleteAvailable: {\n          target: 'idle',\n          actions: [checkCompleteAvailableAction],\n        },\n        checkCompleteUnavailable: {\n          target: 'idle',\n          actions: [checkCompleteUnavailableAction],\n        },\n        checkError: {\n          target: 'idle',\n          actions: [checkErrorAction],\n        },\n      },\n    },\n    downloading: {\n      on: {\n        downloadComplete: {\n          target: 'idle',\n          actions: [downloadCompleteAction],\n        },\n        downloadError: {\n          target: 'idle',\n          actions: [downloadErrorAction],\n        },\n      },\n    },\n    restarting: {\n      type: 'final',\n    },\n  },\n});\n"]}
+{"version":3,"file":"UpdatesStateMachine.js","sourceRoot":"","sources":["../../src/statemachine/UpdatesStateMachine.ts"],"names":[],"mappings":"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","sourcesContent":["import { createMachine, assign } from 'xstate';\n\nexport enum UpdatesStateMachineEventTypes {\n  CHECK = 'check',\n  CHECK_COMPLETE_AVAILABLE = 'checkCompleteAvailable',\n  CHECK_COMPLETE_UNAVAILABLE = 'checkCompleteUnavailable',\n  CHECK_ERROR = 'checkError',\n  DOWNLOAD = 'download',\n  DOWNLOAD_COMPLETE = 'downloadComplete',\n  DOWNLOAD_ERROR = 'downloadError',\n  RESTART = 'restart',\n}\n\n/**\n * Simplified model for an update manifest\n */\nexport type Manifest = {\n  updateId: string;\n};\n\n/**\n * Model for an update event\n */\nexport type UpdatesStateMachineEvent = {\n  type: UpdatesStateMachineEventTypes;\n  body: {\n    message?: string;\n    manifest?: Manifest;\n    isRollBackToEmbedded?: boolean;\n  };\n};\n\n/**\n * The context structure\n */\nexport interface UpdatesStateMachineContext {\n  isUpdateAvailable: boolean;\n  isUpdatePending: boolean;\n  latestManifest?: Manifest;\n  isChecking: boolean;\n  isDownloading: boolean;\n  isRollback: boolean;\n  downloadedManifest?: Manifest;\n  checkError?: Error;\n  downloadError?: Error;\n}\n\n/**\n * Actions that modify the context\n */\nconst checkCompleteAvailableAction = assign({\n  latestManifest: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest || undefined,\n  checkError: () => undefined,\n  isChecking: () => false,\n  isUpdateAvailable: () => true,\n  isRollback: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    Boolean(event.body?.isRollBackToEmbedded),\n});\n\nconst checkCompleteUnavailableAction = assign({\n  latestManifest: () => undefined,\n  checkError: () => undefined,\n  isChecking: () => false,\n  isUpdateAvailable: () => false,\n  isRollback: () => false,\n});\n\nconst checkErrorAction = assign({\n  isChecking: () => false,\n  checkError: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    new Error(event.body?.message || 'checkError'),\n});\n\nconst downloadCompleteAction = assign({\n  downloadedManifest: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest || context.downloadedManifest,\n  latestManifest: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest || context.latestManifest,\n  downloadError: () => undefined,\n  isDownloading: () => false,\n  isUpdatePending: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    !!(event.body?.manifest || context.downloadedManifest),\n  isUpdateAvailable: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    event.body?.manifest !== undefined || context.isUpdateAvailable,\n});\n\nconst downloadErrorAction = assign({\n  downloadError: (context: UpdatesStateMachineContext, event: UpdatesStateMachineEvent) =>\n    new Error(event.body?.message || 'downloadError'),\n  isDownloading: () => false,\n});\n\nconst check = assign({\n  isChecking: (context: UpdatesStateMachineContext) => true,\n});\n\nconst download = assign({\n  isDownloading: (context: UpdatesStateMachineContext) => true,\n});\n\n/**\n * Model of the `expo-updates` state machine, written in Typescript.\n * The actual implementations of this state machine will be in Kotlin on Android and Swift on iOS.\n */\nexport const UpdatesStateMachine = createMachine<UpdatesStateMachineContext>({\n  id: 'Updates',\n  initial: 'idle',\n  context: {\n    isChecking: false,\n    isDownloading: false,\n    isUpdateAvailable: false,\n    isUpdatePending: false,\n    isRollback: false,\n  },\n  predictableActionArguments: true,\n  states: {\n    idle: {\n      on: {\n        check: {\n          target: 'checking',\n          actions: check,\n        },\n        download: {\n          target: 'downloading',\n          actions: download,\n        },\n        restart: {\n          target: 'restarting',\n        },\n      },\n    },\n    checking: {\n      on: {\n        checkCompleteAvailable: {\n          target: 'idle',\n          actions: [checkCompleteAvailableAction],\n        },\n        checkCompleteUnavailable: {\n          target: 'idle',\n          actions: [checkCompleteUnavailableAction],\n        },\n        checkError: {\n          target: 'idle',\n          actions: [checkErrorAction],\n        },\n      },\n    },\n    downloading: {\n      on: {\n        downloadComplete: {\n          target: 'idle',\n          actions: [downloadCompleteAction],\n        },\n        downloadError: {\n          target: 'idle',\n          actions: [downloadErrorAction],\n        },\n      },\n    },\n    restarting: {\n      type: 'final',\n    },\n  },\n});\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-updates",
-  "version": "0.25.4",
+  "version": "0.25.6",
   "description": "Fetches and manages remotely-hosted assets and updates to your app's JS bundle.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -67,5 +67,5 @@
   "peerDependencies": {
     "expo": "*"
   },
-  "gitHead": "915a89deafdbb85ce8f6120e499c8c1386c43824"
+  "gitHead": "470464ab5c25ae8bd45eb2a94d221ce51a8b2560"
 }

package/src/ExpoUpdatesModule.types.ts

@@ -61,6 +61,9 @@ export interface ExpoUpdatesModule
     | UpdateFetchResultFailure
     | UpdateFetchResultRollBackToEmbedded
   >;
+  /**
+   * @hidden
+   */
   getNativeStateMachineContextAsync: () => Promise<
     UpdatesNativeStateMachineContext & {
       latestManifestString?: string;

package/src/Updates.ts

@@ -12,7 +12,7 @@ import {
 } from './Updates.types';
 
 /**
- * Whether expo-updates is enabled. This may be false in a variety of cases including:
+ * Whether `expo-updates` is enabled. This may be false in a variety of cases including:
  * - enabled set to false in configuration
  * - missing or invalid URL in configuration
  * - missing runtime version or SDK version in configuration
@@ -26,7 +26,8 @@ export const isEnabled: boolean = !!ExpoUpdates.isEnabled;
  * The UUID that uniquely identifies the currently running update. The
  * UUID is represented in its canonical string form and 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.
- * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+ * @example
+ * `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
  */
 export const updateId: string | null =
   ExpoUpdates.updateId && typeof ExpoUpdates.updateId === 'string'
@@ -53,7 +54,7 @@ const _checkAutomaticallyMapNativeToJS = {
 };
 
 /**
- * Determines if and when expo-updates checks for and downloads updates automatically on startup.
+ * Determines if and when `expo-updates` checks for and downloads updates automatically on startup.
  */
 export const checkAutomatically: UpdatesCheckAutomaticallyValue | null =
   _checkAutomaticallyMapNativeToJS[ExpoUpdates.checkAutomatically] ?? null;
@@ -147,7 +148,7 @@ const manualUpdatesInstructions =
  * the state of the native module and main threads.
  *
  * This method cannot be used in Expo Go or development mode, and the returned promise will be rejected if you
- * try to do so. It also rejects when expo-updates is not enabled.
+ * try to do so. It also rejects when `expo-updates` is not enabled.
  *
  * @return A promise that fulfills right before the reload instruction is sent to the JS runtime, or
  * rejects if it cannot find a reference to the JS runtime. If the promise is rejected in production
@@ -184,7 +185,7 @@ export async function reloadAsync(): Promise<void> {
  * @return A promise that fulfills with an [`UpdateCheckResult`](#updatecheckresult) object.
  *
  * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or
- * timeout communicating with the server. It also rejects when expo-updates is not enabled.
+ * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.
  */
 export async function checkForUpdateAsync(): Promise<UpdateCheckResult> {
   if (
@@ -211,7 +212,7 @@ export async function checkForUpdateAsync(): Promise<UpdateCheckResult> {
 /**
  * Retrieves the current extra params.
  *
- * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.
+ * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.
  */
 export async function getExtraParamsAsync(): Promise<Record<string, string>> {
   return await ExpoUpdates.getExtraParamsAsync();
@@ -219,10 +220,10 @@ export async function getExtraParamsAsync(): Promise<Record<string, string>> {
 
 /**
  * Sets an extra param if value is non-null, otherwise unsets the param.
- * Extra params are sent as an [Expo Structured Field Value Dictionary](https://docs.expo.dev/technical-specs/expo-sfv-0/)
+ * Extra params are sent as an [Expo Structured Field Value Dictionary](/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.
  *
- * This method cannot be used in Expo Go or development mode. It also rejects when expo-updates is not enabled.
+ * This method cannot be used in Expo Go or development mode. It also rejects when `expo-updates` is not enabled.
  */
 export async function setExtraParamAsync(
   key: string,
@@ -232,9 +233,9 @@ export async function setExtraParamAsync(
 }
 
 /**
- * Retrieves the most recent expo-updates log entries.
+ * Retrieves the most recent `expo-updates` log entries.
  *
- * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to 3600000 ms (1 hour).
+ * @param maxAge Sets the max age of retrieved log entries in milliseconds. Default to `3600000` ms (1 hour).
  *
  * @return A promise that fulfills with an array of [`UpdatesLogEntry`](#updateslogentry) objects;
  *
@@ -245,7 +246,7 @@ export async function readLogEntriesAsync(maxAge: number = 3600000): Promise<Upd
 }
 
 /**
- * Clears existing expo-updates log entries.
+ * Clears existing `expo-updates` log entries.
  *
  * > For now, this operation does nothing on the client.  Once log persistence has been
  * > implemented, this operation will actually remove existing logs.
@@ -271,7 +272,7 @@ export async function clearLogEntriesAsync(): Promise<void> {
  * @return A promise that fulfills with an [`UpdateFetchResult`](#updatefetchresult) object.
  *
  * The promise rejects in Expo Go or if the app is in development mode, or if there is an unexpected error or
- * timeout communicating with the server. It also rejects when expo-updates is not enabled.
+ * timeout communicating with the server. It also rejects when `expo-updates` is not enabled.
  */
 export async function fetchUpdateAsync(): Promise<UpdateFetchResult> {
   if (

package/src/Updates.types.ts

@@ -178,7 +178,7 @@ export type UpdateFetchResult =
   | UpdateFetchResultRollBackToEmbedded;
 
 /**
- * An object representing a single log entry from expo-updates logging on the client.
+ * An object representing a single log entry from `expo-updates` logging on the client.
  */
 export type UpdatesLogEntry = {
   /**
@@ -212,7 +212,7 @@ export type UpdatesLogEntry = {
 };
 
 /**
- * The possible code values for expo-updates log entries
+ * The possible code values for `expo-updates` log entries
  */
 export enum UpdatesLogEntryCode {
   NONE = 'None',
@@ -229,7 +229,7 @@ export enum UpdatesLogEntryCode {
 }
 
 /**
- * The possible log levels for expo-updates log entries
+ * The possible log levels for `expo-updates` log entries
  */
 export enum UpdatesLogEntryLevel {
   TRACE = 'trace',
@@ -241,7 +241,7 @@ export enum UpdatesLogEntryLevel {
 }
 
 /**
- * The possible settings that determine if expo-updates will check for updates on app startup.
+ * The possible settings that determine if `expo-updates` will check for updates on app startup.
  * By default, Expo will check for updates every time the app is loaded.
  * Set this to `ON_ERROR_RECOVERY` to disable automatic checking unless recovering from an error.
  * Set this to `NEVER` to completely disable automatic checking.
@@ -279,11 +279,11 @@ export type UpdatesNativeStateRollback = {
 };
 
 /**
+ * The native state machine context, either read directly from a native module method,
+ * or received in a state change event. Used internally by this module and not exported publicly.
  * @hidden
  */
 export type UpdatesNativeStateMachineContext = {
-  // The native state machine context, either read directly from a native module method,
-  // or received in a state change event. Used internally by this module and not exported publicly.
   isUpdateAvailable: boolean;
   isUpdatePending: boolean;
   isChecking: boolean;

package/src/UseUpdates.types.ts

@@ -9,11 +9,12 @@ export type CurrentlyRunningInfo = {
    * The UUID that uniquely identifies the currently running update if `expo-updates` is enabled. The
    * UUID is represented in its canonical string form and will always use lowercase letters.
    * In development mode, or any other environment in which `expo-updates` is disabled, this value is undefined.
-   * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+   * @example
+   * `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
    */
   updateId?: string;
   /**
-   * The channel name of the current build, if configured for use with EAS Update; undefined otherwise.
+   * The channel name of the current build, if configured for use with EAS Update, `undefined` otherwise.
    */
   channel?: string;
   /**
@@ -79,7 +80,7 @@ export enum UpdateInfoType {
 /**
  * Structure representing a new update.
  */
-type UpdateInfoNew = {
+export type UpdateInfoNew = {
   /**
    * The type of update.
    */
@@ -88,7 +89,8 @@ type UpdateInfoNew = {
    * For updates of type `UpdateInfoType.NEW`, this is
    * a string that uniquely identifies the update. For the manifests used in the current Expo Updates protocol (including
    * EAS Update), this represents the update's UUID in its canonical string form and will always use lowercase letters.
-   * @example xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+   * @example
+   * `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"`
    */
   updateId: string;
   /**
@@ -106,13 +108,13 @@ type UpdateInfoNew = {
 /**
  * Structure representing a rollback directive.
  */
-type UpdateInfoRollback = {
+export type UpdateInfoRollback = {
   /**
    * The type of update.
    */
   type: UpdateInfoType.ROLLBACK;
   /**
-   * For updates of type `UpdateInfoType.ROLLBACK`, this is undefined.
+   * For updates of type `UpdateInfoType.ROLLBACK`, this is always set to `undefined`.
    */
   updateId: undefined;
   /**
@@ -121,7 +123,7 @@ type UpdateInfoRollback = {
    */
   createdAt: Date;
   /**
-   * For updates of type `UpdateInfoType.ROLLBACK`, this is undefined.
+   * For updates of type `UpdateInfoType.ROLLBACK`, this is always set to `undefined`.
    */
   manifest: undefined;
 };
@@ -132,7 +134,7 @@ type UpdateInfoRollback = {
 export type UpdateInfo = UpdateInfoNew | UpdateInfoRollback;
 
 /**
- * The structures and methods returned by `useUpdates()`.
+ * The structures and methods returned by [`useUpdates()`](#useupdates).
  */
 export type UseUpdatesReturnType = {
   /**
@@ -140,9 +142,8 @@ export type UseUpdatesReturnType = {
    */
   currentlyRunning: CurrentlyRunningInfo;
   /**
-   * If a new available update has been found, either by using checkForUpdate(),
-   * or by the `UpdateEvent` listener in `useUpdates()`,
-   * this will contain the information for that update.
+   * If a new available update has been found, either by using [`checkForUpdateAsync()`](#updatescheckforupdateasync),
+   * or by the `UpdateEvent` listener in `useUpdates()`, this will contain the information for that update.
    */
   availableUpdate?: UpdateInfo;
   /**
@@ -167,17 +168,17 @@ export type UseUpdatesReturnType = {
    */
   isDownloading: boolean;
   /**
-   * If an error is returned from either the startup check for updates, or a call to `checkForUpdateAsync()`,
+   * If an error is returned from either the startup check for updates, or a call to [`checkForUpdateAsync()`](#updatescheckforupdateasync),
    * the error description will appear here.
    */
   checkError?: Error;
   /**
-   * If an error is returned from either a startup update download, or a call to `fetchUpdateAsync()`,
+   * If an error is returned from either a startup update download, or a call to [`fetchUpdateAsync()`](#updatesfetchupdateasync),
    * the error description will appear here.
    */
   downloadError?: Error;
   /**
-   * If an error occurs during initialization of `useUpdates()`, the error description will appear here.
+   * If an error occurs during initialization of [`useUpdates()`](#useupdates), the error description will appear here.
    */
   initializationError?: Error;
   /**

package/src/statemachine/UpdatesStateMachine.ts

@@ -100,8 +100,8 @@ const download = assign({
 });
 
 /**
- * Model of the expo-updates state machine, written in Typescript.
- * The actual implementations of this state machine will be in Swift on iOS and Kotlin on Android.
+ * Model of the `expo-updates` state machine, written in Typescript.
+ * The actual implementations of this state machine will be in Kotlin on Android and Swift on iOS.
  */
 export const UpdatesStateMachine = createMachine<UpdatesStateMachineContext>({
   id: 'Updates',