expo 56.0.18 → 56.0.20

package/android/build.gradle

@@ -10,7 +10,7 @@ buildscript {
 }
 
 group = 'host.exp.exponent'
-version = '56.0.18'
+version = '56.0.20'
 
 expoModule {
   // We can't prebuild the module because it depends on the generated files.
@@ -21,7 +21,7 @@ android {
   namespace "expo.core"
   defaultConfig {
     versionCode 1
-    versionName "56.0.18"
+    versionName "56.0.20"
     consumerProguardFiles("proguard-rules.pro")
   }
   testOptions {

package/build/winter/TextDecoder.d.ts

@@ -1,10 +1,5 @@
 export declare class TextDecoder {
-    private _encoding;
-    private _ignoreBOM;
-    private _errorMode;
-    private _BOMseen;
-    private _doNotFlush;
-    private _decoder;
+    private readonly _state;
     constructor(label?: string, options?: {
         fatal?: boolean;
         ignoreBOM?: boolean;
@@ -12,9 +7,8 @@ export declare class TextDecoder {
     get encoding(): string;
     get fatal(): boolean;
     get ignoreBOM(): boolean;
-    decode(input?: ArrayBuffer | DataView, options?: {
+    decode(input?: ArrayBuffer | ArrayBufferView, options?: {
         stream?: boolean;
     }): string;
-    private serializeStream;
 }
 //# sourceMappingURL=TextDecoder.d.ts.map

package/build/winter/TextDecoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextDecoder.d.ts","sourceRoot":"","sources":["../../src/winter/TextDecoder.ts"],"names":[],"mappings":"AAwTA,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAA4B;gBAG1C,KAAK,GAAE,MAAgB,EACvB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB;IAwBR,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,QAAQ,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM;IAmDlF,OAAO,CAAC,eAAe;CAcxB"}
+{"version":3,"file":"TextDecoder.d.ts","sourceRoot":"","sources":["../../src/winter/TextDecoder.ts"],"names":[],"mappings":"AAqXA,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,KAAK,GAAE,MAAgB,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO;IAgB3F,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,eAAe,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,MAAM;CAsB1F"}

package/bundledNativeModules.json

@@ -1,9 +1,9 @@
 {
   "@expo/dom-webview": "~56.0.6",
   "@expo/fingerprint": "~0.19.9",
-  "@expo/metro-runtime": "~56.0.18",
+  "@expo/metro-runtime": "~56.0.20",
   "@expo/vector-icons": "^15.0.2",
-  "@expo/ui": "~56.0.24",
+  "@expo/ui": "~56.0.26",
   "@react-native-async-storage/async-storage": "2.2.0",
   "@react-native-community/datetimepicker": "9.1.0",
   "@react-native-masked-view/masked-view": "0.3.2",
@@ -17,84 +17,84 @@
   "expo-analytics-amplitude": "~11.3.0",
   "expo-app-auth": "~11.1.0",
   "expo-app-loader-provider": "~8.0.0",
-  "expo-app-metrics": "~56.0.23",
+  "expo-app-metrics": "~56.0.25",
   "expo-apple-authentication": "~56.0.4",
   "expo-application": "~56.0.3",
-  "expo-asset": "~56.0.21",
+  "expo-asset": "~56.0.23",
   "expo-audio": "~56.0.13",
-  "expo-auth-session": "~56.0.16",
-  "expo-background-fetch": "~56.0.24",
-  "expo-background-task": "~56.0.24",
+  "expo-auth-session": "~56.0.17",
+  "expo-background-fetch": "~56.0.26",
+  "expo-background-task": "~56.0.26",
   "expo-battery": "~56.0.4",
   "expo-blur": "~56.0.4",
   "expo-brightness": "~56.0.5",
-  "expo-brownfield": "~56.0.26",
-  "expo-build-properties": "~56.0.24",
-  "expo-calendar": "~56.0.9",
+  "expo-brownfield": "~56.0.28",
+  "expo-build-properties": "~56.0.26",
+  "expo-calendar": "~56.0.10",
   "expo-camera": "~56.0.8",
   "expo-cellular": "~56.0.5",
   "expo-checkbox": "~56.0.1",
   "expo-clipboard": "~56.0.4",
-  "expo-constants": "~56.0.22",
-  "expo-contacts": "~56.0.12",
+  "expo-constants": "~56.0.24",
+  "expo-contacts": "~56.0.13",
   "expo-crypto": "~56.0.4",
-  "expo-dev-client": "~56.0.24",
+  "expo-dev-client": "~56.0.25",
   "expo-device": "~56.0.4",
   "expo-document-picker": "~56.0.4",
-  "expo-file-system": "~56.0.8",
+  "expo-file-system": "~56.0.10",
   "expo-font": "~56.0.7",
   "expo-gl": "~56.0.6",
   "expo-glass-effect": "~56.0.4",
   "expo-google-app-auth": "~8.3.0",
   "expo-haptics": "~56.0.3",
-  "expo-image": "~56.0.11",
+  "expo-image": "~56.0.12",
   "expo-image-loader": "~56.0.3",
-  "expo-image-manipulator": "~56.0.23",
-  "expo-image-picker": "~56.0.22",
+  "expo-image-manipulator": "~56.0.25",
+  "expo-image-picker": "~56.0.24",
   "expo-intent-launcher": "~56.0.4",
-  "expo-insights": "~56.0.22",
+  "expo-insights": "~56.0.24",
   "expo-keep-awake": "~56.0.3",
   "expo-linear-gradient": "~56.0.4",
-  "expo-linking": "~56.0.16",
+  "expo-linking": "~56.0.17",
   "expo-local-authentication": "~56.0.5",
   "expo-localization": "~56.0.6",
-  "expo-location": "~56.0.22",
+  "expo-location": "~56.0.24",
   "expo-mail-composer": "~56.0.4",
   "expo-manifests": "~56.0.4",
   "expo-maps": "~56.0.7",
   "expo-mcp": "~0.2.1",
-  "expo-media-library": "~56.0.10",
+  "expo-media-library": "~56.0.11",
   "expo-mesh-gradient": "~56.0.3",
-  "expo-module-template": "~56.0.17",
-  "expo-modules-core": "~56.0.22",
+  "expo-module-template": "~56.0.18",
+  "expo-modules-core": "~56.0.24",
   "expo-navigation-bar": "~56.0.3",
   "expo-network": "~56.0.5",
-  "expo-notifications": "~56.0.22",
-  "expo-observe": "~56.0.26",
+  "expo-notifications": "~56.0.24",
+  "expo-observe": "~56.0.28",
   "expo-print": "~56.0.4",
   "expo-live-photo": "~56.0.4",
-  "expo-router": "~56.2.17",
-  "expo-screen-capture": "~56.0.4",
+  "expo-router": "~56.2.19",
+  "expo-screen-capture": "~56.0.5",
   "expo-screen-orientation": "~56.0.5",
   "expo-secure-store": "~56.0.4",
   "expo-sensors": "~56.0.6",
-  "expo-server": "~56.0.5",
-  "expo-sharing": "~56.0.23",
+  "expo-server": "~56.0.6",
+  "expo-sharing": "~56.0.25",
   "expo-sms": "~56.0.3",
   "expo-speech": "~56.0.3",
   "expo-splash-screen": "~56.0.14",
   "expo-sqlite": "~56.0.5",
   "expo-status-bar": "~56.0.4",
-  "expo-store-review": "~56.0.3",
-  "expo-symbols": "~56.0.6",
+  "expo-store-review": "~56.0.4",
+  "expo-symbols": "~56.0.7",
   "expo-system-ui": "~56.0.5",
-  "expo-task-manager": "~56.0.24",
+  "expo-task-manager": "~56.0.26",
   "expo-tracking-transparency": "~56.0.5",
-  "expo-updates": "~56.0.23",
+  "expo-updates": "~56.0.25",
   "expo-video-thumbnails": "~56.0.3",
   "expo-video": "~56.1.4",
   "expo-web-browser": "~56.0.6",
-  "expo-widgets": "~56.0.25",
+  "expo-widgets": "~56.0.27",
   "jest-expo": "~56.0.5",
   "lottie-react-native": "~7.3.4",
   "react": "19.2.3",

package/ios/AppDelegates/EXBundleConfiguration.h

@@ -0,0 +1,23 @@
+// Copyright 2026-present 650 Industries. All rights reserved.
+
+#pragma once
+
+#import <ExpoModulesCore/Platform.h>
+#import <Expo/RCTAppDelegateUmbrella.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+#if TARGET_OS_IOS || TARGET_OS_TV
+
+NS_SWIFT_NAME(ExpoBundleConfiguration)
+@interface EXBundleConfiguration : RCTBundleConfiguration
+
+- (instancetype)initWithBundleURL:(NSURL *)bundleURL NS_DESIGNATED_INITIALIZER;
+
++ (RCTBundleConfiguration *)configurationWithBundleURL:(nullable NSURL *)bundleURL NS_SWIFT_NAME(configuration(bundleURL:));
+
+@end
+
+#endif
+
+NS_ASSUME_NONNULL_END

package/ios/AppDelegates/EXBundleConfiguration.mm

@@ -0,0 +1,85 @@
+// Copyright 2026-present 650 Industries. All rights reserved.
+
+#import <Expo/EXBundleConfiguration.h>
+
+#if TARGET_OS_IOS || TARGET_OS_TV
+
+@implementation EXBundleConfiguration {
+  NSURL *_bundleURL;
+}
+
+- (instancetype)initWithBundleURL:(NSURL *)bundleURL
+{
+  if (bundleURL.fileURL) {
+    self = [super initWithBundleFilePath:bundleURL];
+  } else {
+    self = [super init];
+  }
+  if (self) {
+    _bundleURL = bundleURL;
+  }
+  return self;
+}
+
+- (NSURL *)getBundleURL
+{
+  // A file URL is a snapshot of whichever bundle was current when this configuration was built,
+  // and `RCTBundleManager` prefers it over the live getter that `RCTHost` installs. Returning it
+  // would pin every reload to that bundle, so `Updates.reloadAsync` could never start a newly
+  // downloaded update.
+  if (_bundleURL.fileURL) {
+    return nil;
+  }
+
+  return _bundleURL;
+}
+
+- (NSString *)getPackagerServerScheme
+{
+  if (_bundleURL.fileURL) {
+    return [super getPackagerServerScheme];
+  }
+
+  NSString *scheme = _bundleURL.scheme;
+  if ([scheme isEqualToString:@"https"] || [scheme isEqualToString:@"exps"]) {
+    return @"https";
+  } else if ([scheme isEqualToString:@"http"] || [scheme isEqualToString:@"exp"]) {
+    return @"http";
+  } else {
+    return [super getPackagerServerScheme];
+  }
+}
+
+- (NSString *)getPackagerServerHost
+{
+  if (_bundleURL.fileURL) {
+    return [super getPackagerServerHost];
+  }
+
+  NSString *host = _bundleURL.host;
+  if (host == nil) {
+    return [super getPackagerServerHost];
+  }
+
+  NSNumber *port = _bundleURL.port;
+  if (port == nil) {
+    return host;
+  } else if ([host containsString:@":"] && ![host hasPrefix:@"["]) {
+    return [NSString stringWithFormat:@"[%@]:%@", host, port];
+  } else {
+    return [NSString stringWithFormat:@"%@:%@", host, port];
+  }
+}
+
++ (RCTBundleConfiguration *)configurationWithBundleURL:(nullable NSURL *)bundleURL
+{
+  if (bundleURL == nil) {
+    return [RCTBundleConfiguration defaultConfiguration];
+  } else {
+    return [[EXBundleConfiguration alloc] initWithBundleURL:bundleURL];
+  }
+}
+
+@end
+
+#endif

package/ios/AppDelegates/ExpoReactNativeFactory.swift

@@ -26,6 +26,47 @@ public class ExpoReactNativeFactory: ExpoReactNativeFactoryObjC, ExpoReactNative
     super.init(delegate: delegate, releaseLevel: releaseLevel)
   }
 
+  // `RCTBundleConfiguration` is only available in react-native 0.84+, so it doesn't exist yet on react-native-macos.
+#if os(iOS) || os(tvOS)
+  private var _bundleConfiguration: RCTBundleConfiguration?
+
+  public override var bundleConfiguration: RCTBundleConfiguration {
+    get {
+      if let _bundleConfiguration {
+        return _bundleConfiguration
+      }
+      adoptInfoPlistMetroPort()
+      return ExpoBundleConfiguration.configuration(bundleURL: self.delegate?.bundleURL())
+    }
+    set {
+      _bundleConfiguration = newValue
+    }
+  }
+
+  private func adoptInfoPlistMetroPort() {
+#if DEBUG
+    if NSClassFromString("EXDevLauncherController") != nil {
+      return
+    }
+    guard let port = Bundle.main.object(forInfoDictionaryKey: "RCTMetroPort") as? String,
+      !port.isEmpty else {
+      return
+    }
+    var host = "localhost"
+    if let ipPath = Bundle.main.path(forResource: "ip", ofType: "txt"),
+      let ip = try? String(contentsOfFile: ipPath, encoding: .utf8).trimmingCharacters(in: .whitespacesAndNewlines),
+      !ip.isEmpty {
+      host = ip
+    }
+    let settings = RCTBundleURLProvider.sharedSettings()
+    let target = "\(host):\(port)"
+    if settings.jsLocation != target {
+      settings.jsLocation = target
+    }
+#endif
+  }
+#endif
+
   @MainActor
   @objc func createRCTRootViewFactory() -> RCTRootViewFactory {
     // Alan: This is temporary. We need to cast to ExpoReactNativeFactoryDelegate here because currently, if you extend RCTReactNativeFactory
@@ -108,17 +149,25 @@ public class ExpoReactNativeFactory: ExpoReactNativeFactoryObjC, ExpoReactNative
       }
     }
 
+#if os(iOS) || os(tvOS)
+    adoptInfoPlistMetroPort()
+#endif
+
     let rootView: UIView
     if let factory = self.rootViewFactory as? ExpoReactRootViewFactory {
       // RCTDevMenuConfiguration is only available in react-native 0.83+
+      // bundleConfiguration is only accepted in react-native 0.84+
 #if os(iOS) || os(tvOS)
+      let bundleConfiguration = ExpoBundleConfiguration.configuration(
+        bundleURL: withBundleURL ?? configuration?.bundleURLBlock()
+      )
       // When calling `recreateRootViewWithBundleURL:` from `EXReactRootViewFactory`,
       // we don't want to loop the ReactDelegate again. Otherwise, it will be an infinite loop.
       rootView = factory.superView(
         withModuleName: moduleName ?? defaultModuleName,
         initialProperties: initialProps,
         launchOptions: launchOptions ?? [:],
-        bundleConfiguration: RCTBundleConfiguration.default(),
+        bundleConfiguration: bundleConfiguration,
         devMenuConfiguration: self.devMenuConfiguration
       )
 #else
@@ -130,11 +179,14 @@ public class ExpoReactNativeFactory: ExpoReactNativeFactoryObjC, ExpoReactNative
 #endif
     } else {
 #if os(iOS) || os(tvOS)
+      let bundleConfiguration = ExpoBundleConfiguration.configuration(
+        bundleURL: withBundleURL ?? configuration?.bundleURLBlock()
+      )
       rootView = rootViewFactory.view(
         withModuleName: moduleName ?? defaultModuleName,
         initialProperties: initialProps,
         launchOptions: launchOptions,
-        bundleConfiguration: RCTBundleConfiguration.default(),
+        bundleConfiguration: bundleConfiguration,
         devMenuConfiguration: self.devMenuConfiguration ?? RCTDevMenuConfiguration.default()
       )
 #else

package/ios/Expo.h

@@ -1,4 +1,5 @@
 #import <ExpoModulesCore/ExpoModulesCore.h>
 #import <Expo/EXAppDefinesLoader.h>
 #import <Expo/ExpoReactNativeFactory.h>
+#import <Expo/EXBundleConfiguration.h>
 #import <Expo/RCTAppDelegateUmbrella.h>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo",
-  "version": "56.0.18",
+  "version": "56.0.20",
   "description": "The Expo SDK",
   "main": "src/Expo.ts",
   "module": "src/Expo.ts",
@@ -68,9 +68,9 @@
   "homepage": "https://github.com/expo/expo/tree/main/packages/expo",
   "dependencies": {
     "@babel/runtime": "^7.20.0",
-    "@expo/cli": "^56.1.22",
+    "@expo/cli": "^56.1.24",
     "@expo/config": "~56.0.13",
-    "@expo/config-plugins": "~56.0.14",
+    "@expo/config-plugins": "~56.0.15",
     "@expo/devtools": "~56.0.2",
     "@expo/dom-webview": "~56.0.6",
     "@expo/fingerprint": "^0.19.9",
@@ -79,14 +79,14 @@
     "@expo/metro": "~56.0.0",
     "@expo/metro-config": "~56.0.18",
     "@ungap/structured-clone": "^1.3.0",
-    "babel-preset-expo": "~56.0.18",
-    "expo-asset": "~56.0.21",
-    "expo-constants": "~56.0.22",
-    "expo-file-system": "~56.0.8",
+    "babel-preset-expo": "~56.0.19",
+    "expo-asset": "~56.0.23",
+    "expo-constants": "~56.0.24",
+    "expo-file-system": "~56.0.10",
     "expo-font": "~56.0.7",
     "expo-keep-awake": "~56.0.3",
-    "expo-modules-autolinking": "~56.0.21",
-    "expo-modules-core": "~56.0.22",
+    "expo-modules-autolinking": "~56.0.22",
+    "expo-modules-core": "~56.0.24",
     "pretty-format": "^29.7.0",
     "react-refresh": "^0.14.2",
     "whatwg-url-minimum": "^0.1.2"
@@ -100,9 +100,9 @@
     "react-native": "0.85.3",
     "rimraf": "^6.1.2",
     "web-streams-polyfill": "^3.3.2",
+    "expo-updates": "56.0.25",
     "@expo/dom-webview": "56.0.6",
-    "expo-updates": "56.0.23",
-    "@expo/metro-runtime": "56.0.18"
+    "@expo/metro-runtime": "56.0.20"
   },
   "peerDependencies": {
     "@expo/dom-webview": "*",
@@ -139,7 +139,7 @@
       "scripts/resolveAppEntry.js"
     ]
   },
-  "gitHead": "006eb2b47c82febc52fc87d61a1e235bf804dd79",
+  "gitHead": "39f9dc47fb5ddd099a2533dd0ff24be7126a1ed0",
   "scripts": {
     "build": "tsc",
     "clean": "rimraf build",

package/src/async-require/__tests__/asyncRequireModule.test.ts

@@ -90,20 +90,9 @@ describe('asyncRequireModule', () => {
 
       function asyncRequire(moduleID, paths, moduleName) {
         var ret = asyncRequireImpl(moduleID, paths, moduleName);
-        if (!(ret instanceof Promise)) {
-          return {
-            _result: ret,
-            then: function(resolve, reject) {
-              return Promise.resolve(ret).then(resolve, reject);
-            },
-          };
-        }
-        return {
-          _result: ret,
-          then: function(resolve, reject) {
-            return ret.then(resolve, reject);
-          },
-        };
+        var promise = Promise.resolve(ret);
+        promise._result = ret;
+        return promise;
       }
 
       asyncRequire.unstable_importMaybeSync = function(moduleID, paths) {
@@ -225,14 +214,20 @@ describe('asyncRequireModule', () => {
   });
 
   describe('thenable return value', () => {
-    it('exposes a synchronous _result when no bundle load was needed', () => {
+    it('returns a Promise with a synchronous _result when no bundle load was needed', async () => {
       const ret = asyncRequire(42, null, 'my-module');
 
-      expect(typeof ret.then).toBe('function');
+      const onFinally = jest.fn();
+
+      expect(ret).toBeInstanceOf(Promise);
+      expect(typeof ret.catch).toBe('function');
+      expect(typeof ret.finally).toBe('function');
       expect(ret._result).toEqual({ default: 'module-42' });
+      await expect(ret.finally(onFinally)).resolves.toEqual({ default: 'module-42' });
+      expect(onFinally).toHaveBeenCalledTimes(1);
     });
 
-    it('exposes a Promise _result when a bundle load was needed', async () => {
+    it('returns a Promise with a Promise _result when a bundle load was needed', async () => {
       process.env.EXPO_OS = 'web';
       mockImportAll
         .mockImplementationOnce(() => {
@@ -244,10 +239,22 @@ describe('asyncRequireModule', () => {
 
       const ret = asyncRequire(42, { '42': '/bundles/my-module.bundle' }, 'my-module');
 
-      expect(typeof ret.then).toBe('function');
+      expect(ret).toBeInstanceOf(Promise);
+      expect(typeof ret.catch).toBe('function');
+      expect(typeof ret.finally).toBe('function');
       expect(ret._result).toBeInstanceOf(Promise);
       await expect(ret._result).resolves.toEqual({ default: 'module-42' });
     });
+
+    it('supports catching a rejected bundle load', async () => {
+      process.env.EXPO_OS = 'ios';
+      const error = new Error('Bundle load failed');
+      (globalThis as any).__loadBundleAsync = jest.fn(() => Promise.reject(error));
+
+      const ret = asyncRequire(42, { '42': '/bundles/my-module.bundle' }, 'my-module');
+
+      await expect(ret.catch((caughtError: Error) => caughtError)).resolves.toBe(error);
+    });
   });
 
   describe('unstable_importMaybeSync', () => {

package/src/async-require/asyncRequireModule.ts

@@ -94,30 +94,22 @@ function asyncRequireImpl<T>(
   return importAll();
 }
 
+type PromiseWithResult<T> = Promise<T> & {
+  _result?: T | Promise<T>;
+};
+
 function asyncRequire<T>(
   moduleID: number,
   paths: DependencyMapPaths,
   moduleName?: string
-): PromiseLike<T> & { _result?: T | Promise<T> } {
+): PromiseWithResult<T> {
   const ret = asyncRequireImpl<T>(moduleID, paths, moduleName);
-  if (!(ret instanceof Promise)) {
-    // We return a thenable with an added `unstable_importMaybeSync`-like
-    // `_result` property to bypass this being force-converted to a promise
-    // for rehydration
-    return {
-      _result: ret,
-      then(resolve, reject) {
-        return Promise.resolve(ret).then(resolve, reject);
-      },
-    };
-  } else {
-    return {
-      _result: ret,
-      then(resolve, reject) {
-        return ret.then(resolve, reject);
-      },
-    };
-  }
+  // We return a Promise with an added `unstable_importMaybeSync`-like
+  // `_result` property to bypass this being force-converted to a promise
+  // for rehydration
+  const promise: PromiseWithResult<T> = Promise.resolve(ret);
+  promise._result = ret;
+  return promise;
 }
 
 // Synchronous version of asyncRequire, which can still return a promise