@react-native-firebase/app 26.3.3 → 27.0.0

package/lib/internal/nativeModuleDebug.ts

@@ -0,0 +1,97 @@
+/* eslint-disable no-console */
+
+function serializeDebugValue(value: unknown): string {
+  const seen = new WeakSet<object>();
+
+  try {
+    const serialized = JSON.stringify(value, (_key, currentValue: unknown) => {
+      if (typeof currentValue === 'bigint') {
+        return `${currentValue}n`;
+      }
+      if (currentValue instanceof Error) {
+        return { name: currentValue.name, message: currentValue.message };
+      }
+      if (currentValue && typeof currentValue === 'object') {
+        if (seen.has(currentValue)) {
+          return '[Circular]';
+        }
+        seen.add(currentValue);
+      }
+      return currentValue;
+    });
+    return serialized ?? String(value);
+  } catch (_error) {
+    return '[Unserializable]';
+  }
+}
+
+function logDebug(message: string): void {
+  try {
+    console.debug(message);
+  } catch (_error) {
+    // Debug logging must not change native module behavior.
+  }
+}
+
+export function createNativeModuleDebugProxy(
+  moduleName: string,
+  nativeModule: Record<string, unknown>,
+): Record<string, unknown> {
+  return new Proxy(nativeModule, {
+    ownKeys(target) {
+      const keys: string[] = [];
+      for (const key in target) {
+        keys.push(key);
+      }
+      return keys;
+    },
+    get: (_, name) => {
+      const prop = nativeModule[name as string];
+      if (typeof prop !== 'function') return prop;
+
+      return (...args: unknown[]) => {
+        logDebug(
+          `[RNFB->Native][🔵] ${moduleName}.${String(name)} -> ${serializeDebugValue(args)}`,
+        );
+
+        let result: unknown;
+        try {
+          result = Reflect.apply(prop, nativeModule, args);
+        } catch (error) {
+          logDebug(
+            `[RNFB<-Native][🔴] ${moduleName}.${String(name)} <- ${serializeDebugValue(error)}`,
+          );
+          throw error;
+        }
+
+        if (
+          result &&
+          typeof result === 'object' &&
+          typeof (result as Promise<unknown>).then === 'function'
+        ) {
+          return (result as Promise<unknown>).then(
+            resolvedValue => {
+              logDebug(
+                `[RNFB<-Native][🟢] ${moduleName}.${String(name)} <- ${serializeDebugValue(
+                  resolvedValue,
+                )}`,
+              );
+              return resolvedValue;
+            },
+            error => {
+              logDebug(
+                `[RNFB<-Native][🔴] ${moduleName}.${String(name)} <- ${serializeDebugValue(error)}`,
+              );
+              throw error;
+            },
+          );
+        }
+
+        logDebug(
+          `[RNFB<-Native][🟢] ${moduleName}.${String(name)} <- ${serializeDebugValue(result)}`,
+        );
+        return result;
+      };
+    },
+  });
+}

package/lib/internal/nativeModuleWeb.ts

@@ -1,12 +1,13 @@
-/* eslint-disable no-console */
 import RNFBAppModule from './web/RNFBAppModule';
 import { APP_NATIVE_MODULE } from './constants';
+import { createNativeModuleDebugProxy } from './nativeModuleDebug';
 
 // Register before exporting getters — RNFBNativeEventEmitter instantiates during circular imports.
 const nativeModuleRegistry: Record<string, Record<string, unknown>> = {
   RNFBAppModule: RNFBAppModule as unknown as Record<string, unknown>,
   [APP_NATIVE_MODULE]: RNFBAppModule as unknown as Record<string, unknown>,
 };
+const memoizedDebugProxies = new Map<string, Record<string, unknown>>();
 
 export function getReactNativeModule(moduleName: string): Record<string, unknown> | undefined {
   const nativeModule = nativeModuleRegistry[moduleName];
@@ -17,45 +18,13 @@ export function getReactNativeModule(moduleName: string): Record<string, unknown
   if (!globalThis.RNFBDebug) {
     return nativeModule;
   }
-  return new Proxy(nativeModule, {
-    ownKeys(target) {
-      const keys: string[] = [];
-      for (const key in target) {
-        keys.push(key);
-      }
-      return keys;
-    },
-    get: (_, name) => {
-      const prop = nativeModule[name as string];
-      if (typeof prop !== 'function') return prop;
-      return (...args: unknown[]) => {
-        console.debug(
-          `[RNFB->Native][🔵] ${moduleName}.${String(name)} -> ${JSON.stringify(args)}`,
-        );
-        const result: unknown = (prop as (...args: unknown[]) => unknown)(...args);
-        if (result && typeof result === 'object' && 'then' in result) {
-          return (result as Promise<unknown>).then(
-            (res: unknown) => {
-              console.debug(
-                `[RNFB<-Native][🟢] ${moduleName}.${String(name)} <- ${JSON.stringify(res)}`,
-              );
-              return res;
-            },
-            (err: unknown) => {
-              console.debug(
-                `[RNFB<-Native][🔴] ${moduleName}.${String(name)} <- ${JSON.stringify(err)}`,
-              );
-              throw err;
-            },
-          );
-        }
-        console.debug(
-          `[RNFB<-Native][🟢] ${moduleName}.${String(name)} <- ${JSON.stringify(result)}`,
-        );
-        return result;
-      };
-    },
-  });
+
+  let debugProxy = memoizedDebugProxies.get(moduleName);
+  if (!debugProxy) {
+    debugProxy = createNativeModuleDebugProxy(moduleName, nativeModule);
+    memoizedDebugProxies.set(moduleName, debugProxy);
+  }
+  return debugProxy;
 }
 
 export function setReactNativeModule(
@@ -63,4 +32,5 @@ export function setReactNativeModule(
   nativeModule: Record<string, unknown>,
 ): void {
   nativeModuleRegistry[moduleName] = nativeModule;
+  memoizedDebugProxies.delete(moduleName);
 }

package/lib/internal/react-native-vendor-emitter.d.ts

@@ -0,0 +1,11 @@
+declare module 'react-native/Libraries/vendor/emitter/EventEmitter' {
+  export default class EventEmitter {
+    addListener(
+      eventType: string,
+      listener: (...args: Array<unknown>) => unknown,
+      context?: unknown,
+    ): { remove(): void };
+    removeAllListeners(eventType?: string): void;
+    emit(eventType: string, ...args: Array<unknown>): void;
+  }
+}

package/lib/internal/registry/app.ts

@@ -27,7 +27,7 @@ type FirebaseAppConfig = ReactNativeFirebase.FirebaseAppConfig;
 type FirebaseAppOptions = ReactNativeFirebase.FirebaseAppOptions;
 type ReactNativeAsyncStorage = ReactNativeFirebase.ReactNativeAsyncStorage;
 
-const APP_REGISTRY: Record<string, FirebaseApp> = {};
+const APP_REGISTRY: Record<string, FirebaseApp> = Object.create(null);
 let onAppCreateFn: ((app: FirebaseApp) => void) | null = null;
 const onAppDestroyCallbacks: Array<(app: FirebaseApp) => void> = [];
 let initializedNativeApps = false;
@@ -191,7 +191,13 @@ export function initializeApp(
 
   return getAppModule()
     .initializeApp(options as FirebaseAppOptions, appConfig)
-    .then(() => {
+    .then(nativeResult => {
+      // Native resolves the real SDK flag, which differs from the input when the key was omitted
+      // (SDK / Info.plist default). Web echoes the input and Jest mocks resolve void; both keep `!!input`.
+      const nativeEnabled = nativeResult?.appConfig?.automaticDataCollectionEnabled;
+      if (typeof nativeEnabled === 'boolean') {
+        app._setAutomaticDataCollectionEnabledFromNative(nativeEnabled);
+      }
       app._initialized = true;
       return app as unknown as ReactNativeFirebase.FirebaseApp;
     })

package/lib/internal/registry/modular.ts

@@ -31,7 +31,7 @@ type ModularModuleClass<T extends FirebaseModule> = new (
 ) => T;
 
 // app.name -> instanceKey -> module instance
-const MODULAR_INSTANCES: Record<string, Record<string, FirebaseModule>> = {};
+const MODULAR_INSTANCES: Record<string, Record<string, FirebaseModule>> = Object.create(null);
 
 let destroyHookRegistered = false;
 function ensureDestroyHook(): void {
@@ -82,7 +82,7 @@ export function getOrCreateModularInstance<T extends FirebaseModule>(
   const key = customUrlOrRegion ? `${customUrlOrRegion}:${namespace}` : namespace;
 
   if (!MODULAR_INSTANCES[_app.name]) {
-    MODULAR_INSTANCES[_app.name] = {};
+    MODULAR_INSTANCES[_app.name] = Object.create(null);
   }
 
   if (!MODULAR_INSTANCES[_app.name]![key]) {

package/lib/internal/registry/nativeModule.ts

@@ -80,9 +80,9 @@ function createRoutingCompositeProxy(
   hosts: Array<{ module: Record<string, unknown> | undefined; argToPrepend: unknown[] }>,
   isTurboModule: boolean,
 ): WrappedNativeModule {
-  const routingMap: Record<string, RouteEntry> = {};
-  const memoizedMethods: Record<string, (...args: unknown[]) => unknown> = {};
-  const memoizedConstants: Record<string, unknown> = {};
+  const routingMap: Record<string, RouteEntry> = Object.create(null);
+  const memoizedMethods: Record<string, (...args: unknown[]) => unknown> = Object.create(null);
+  const memoizedConstants: Record<string, unknown> = Object.create(null);
 
   for (const { module, argToPrepend } of hosts) {
     if (!module) {

package/lib/internal/web/RNFBAppModule.ts

@@ -48,22 +48,22 @@ interface InitializeAppResult {
 let jsReady = false;
 let jsListenerCount = 0;
 let queuedEvents: QueuedEvent[] = [];
-let jsListeners: EventListeners = {};
+let jsListeners: EventListeners = Object.create(null);
 
 // For compatibility we have a fake preferences storage,
 // it does not persist across app restarts.
-let fakePreferencesStorage: PreferencesStorage = {};
+let fakePreferencesStorage: PreferencesStorage = Object.create(null);
 
 function eventsGetListenersMap(): ListenersMap {
   return {
     listeners: jsListenerCount,
     queued: queuedEvents.length,
-    events: jsListeners,
+    events: Object.assign(Object.create(null), jsListeners),
   };
 }
 
 function eventsSendEvent(eventName: string, eventBody: any): void {
-  if (!jsReady || !jsListeners.hasOwnProperty(eventName)) {
+  if (!jsReady || !Object.prototype.hasOwnProperty.call(jsListeners, eventName)) {
     const event: QueuedEvent = {
       eventName,
       eventBody,
@@ -174,7 +174,7 @@ export default {
    *
    * @returns The meta data
    */
-  metaGetAll(): Record<string, never> {
+  async metaGetAll(): Promise<Record<string, never>> {
     return {};
   },
 
@@ -184,7 +184,7 @@ export default {
    *
    * @returns The JSON data for the firebase.json file.
    */
-  jsonGetAll(): Record<string, never> {
+  async jsonGetAll(): Promise<Record<string, never>> {
     return {};
   },
 
@@ -206,7 +206,7 @@ export default {
    * @param key - The key of the preference.
    * @param value - The value to set.
    */
-  preferencesSetString(key: string, value: string): void {
+  async preferencesSetString(key: string, value: string): Promise<void> {
     fakePreferencesStorage[key] = value;
   },
 
@@ -216,16 +216,16 @@ export default {
    *
    * @returns The preferences.
    */
-  preferencesGetAll(): PreferencesStorage {
-    return Object.assign({}, fakePreferencesStorage);
+  async preferencesGetAll(): Promise<PreferencesStorage> {
+    return Object.assign(Object.create(null), fakePreferencesStorage);
   },
 
   /**
    * Clears all preferences.
    * Unsupported on web.
    */
-  preferencesClearAll(): void {
-    fakePreferencesStorage = {};
+  async preferencesClearAll(): Promise<void> {
+    fakePreferencesStorage = Object.create(null);
   },
 
   /**
@@ -269,7 +269,7 @@ export default {
    *
    * @returns The listeners for the event.
    */
-  eventsGetListeners(): ListenersMap {
+  async eventsGetListeners(): Promise<ListenersMap> {
     return eventsGetListenersMap();
   },
 
@@ -280,8 +280,9 @@ export default {
    * @param eventBody - The body of the event to send.
    * @returns void
    */
-  eventsPing(eventName: string, eventBody: any): void {
+  async eventsPing(eventName: string, eventBody: any): Promise<any> {
     eventsSendEvent(eventName, eventBody);
+    return eventBody;
   },
 
   /**
@@ -291,7 +292,7 @@ export default {
    */
   eventsAddListener(eventName: string): void {
     jsListenerCount++;
-    if (!jsListeners.hasOwnProperty(eventName)) {
+    if (!Object.prototype.hasOwnProperty.call(jsListeners, eventName)) {
       jsListeners[eventName] = 1;
     } else {
       if (jsListeners[eventName] !== undefined) {
@@ -312,7 +313,7 @@ export default {
    * @param all - Optional. Whether to remove all listeners for the event.
    */
   eventsRemoveListener(eventName: string, all?: boolean): void {
-    if (jsListeners.hasOwnProperty(eventName)) {
+    if (Object.prototype.hasOwnProperty.call(jsListeners, eventName)) {
       const count = jsListeners[eventName];
       if (count !== undefined) {
         if (count <= 1 || all) {

package/lib/internal/web/memidb/lib/FakeEventTarget.js

@@ -66,7 +66,9 @@ class FakeEventTarget {
         listener.type === type && listener.callback === callback && listener.capture === capture
       );
     });
-    this.listeners.splice(i, 1);
+    if (i >= 0) {
+      this.listeners.splice(i, 1);
+    }
   }
 
   // http://www.w3.org/TR/dom/#dispatching-events

package/lib/types/app.ts

@@ -119,9 +119,13 @@ export namespace ReactNativeFirebase {
 
     /**
      * Default setting for data collection on startup that affects all Firebase module startup data collection settings,
-     * in the absence of module-specific overrides. This will start as false if you set "app_data_collection_default_enabled"
-     * to false in firebase.json and may be used in opt-in flows, for example a GDPR-compliant app.
+     * in the absence of module-specific overrides. It may be used in opt-in flows, for example a GDPR-compliant app.
      * If configured false initially, set to true after obtaining consent, then enable module-specific settings as needed afterwards.
+     *
+     * On iOS this starts as false if you set "app_data_collection_default_enabled" to false in firebase.json
+     * (written to Info.plist "FirebaseDataCollectionDefaultEnabled"). On Android that firebase.json key does not change
+     * this flag, which defaults to true unless the host app sets the manifest meta-data "firebase_data_collection_default_enabled".
+     * When omitted from the config passed to `initializeApp`, the native default is left unchanged on both platforms.
      */
     automaticDataCollectionEnabled?: boolean;
 
@@ -148,7 +152,10 @@ export namespace ReactNativeFirebase {
     readonly options: FirebaseAppOptions;
 
     /**
-     * The settable config flag for GDPR opt-in/opt-out
+     * The settable config flag for GDPR opt-in/opt-out.
+     *
+     * After `initializeApp` resolves, this reflects the flag the native SDK is using, which can
+     * differ from the value passed in when the key was omitted.
      */
     automaticDataCollectionEnabled: boolean;
 

package/lib/types/internal.ts

@@ -20,6 +20,25 @@
  * These types are used internally across multiple files and should not be exported to consumers
  */
 
+import type { EventSubscription } from 'react-native';
+
+/**
+ * RN 0.88's generated `EventEmitter` class types require a `context` argument
+ * and `Object` payloads. The runtime still accepts the historical 2-argument
+ * `addListener` and nullable `emit` values used across modules.
+ */
+export interface ReactNativeFirebaseEventEmitter {
+  addListener(
+    eventType: string,
+    // RN 0.88 listener params are invariant; `any` keeps module-specific callbacks assignable.
+    listener: (...args: any[]) => any,
+    context?: unknown,
+  ): EventSubscription;
+  emit(eventType: string, ...args: any[]): void;
+  removeAllListeners(eventType?: string | null): void;
+  listenerCount(eventType: string): number;
+}
+
 /**
  * Firebase JSON configuration from firebase.json file
  * Structure: { "react-native": { [key: string]: boolean | string }, ... }

package/lib/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '26.3.3';
+export const version = '27.0.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/app",
-  "version": "26.3.3",
+  "version": "27.0.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "A well tested, feature rich Firebase implementation for React Native, supporting iOS & Android. Individual module support for Admob, Analytics, Auth, Crash Reporting, Cloud Firestore, Database, Dynamic Links, Functions, Messaging (FCM), Remote Config, Storage and more.",
   "main": "./dist/module/index.js",
@@ -32,6 +32,7 @@
     "compile": "bob build",
     "prepare": "npm run build && npm run build:plugin && npm run compile"
   },
+  "homepage": "https://rnfirebase.io",
   "repository": {
     "type": "git",
     "url": "https://github.com/invertase/react-native-firebase",
@@ -110,10 +111,10 @@
   "peerDependencies": {
     "expo": ">=47.0.0",
     "react": "*",
-    "react-native": "*"
+    "react-native": ">=0.60.0-0"
   },
   "dependencies": {
-    "firebase": "12.17.1"
+    "firebase": "13.0.0"
   },
   "devDependencies": {
     "expo": "^55.0.18",
@@ -130,17 +131,17 @@
   },
   "sdkVersions": {
     "ios": {
-      "firebase": "12.18.0",
+      "firebase": "13.0.0",
       "firebaseSpmUrl": "https://github.com/firebase/firebase-ios-sdk.git",
       "iosTarget": "15.0",
-      "macosTarget": "10.15",
+      "macosTarget": "11.0",
       "tvosTarget": "15.0"
     },
     "android": {
-      "minSdk": 23,
+      "minSdk": 24,
       "targetSdk": 34,
       "compileSdk": 34,
-      "firebase": "34.18.0",
+      "firebase": "35.0.0",
       "firebaseCrashlyticsGradle": "3.0.8",
       "firebasePerfGradle": "2.0.2",
       "gmsGoogleServicesGradle": "4.5.0",
@@ -184,5 +185,5 @@
       }
     }
   },
-  "gitHead": "04b90008385bf69be74f3a333d0dfea43ba32e64"
+  "gitHead": "0c7e942bca361f1765abaf233bf447d795718eff"
 }

package/plugin/build/ios/appDelegate.js

@@ -10,6 +10,22 @@ exports.modifyAppDelegateAsync = modifyAppDelegateAsync;
 const config_plugins_1 = require("@expo/config-plugins");
 const generateCode_1 = require("@expo/config-plugins/build/utils/generateCode");
 const fs_1 = __importDefault(require("fs"));
+function addImport(contents, importLine, existingImportMatcher, preferredAnchorMatcher, anyImportMatcher) {
+    if (existingImportMatcher.test(contents)) {
+        return contents;
+    }
+    const newline = contents.includes('\r\n') ? '\r\n' : '\n';
+    const preferredAnchor = preferredAnchorMatcher.exec(contents);
+    if (preferredAnchor?.index !== undefined) {
+        const insertionPoint = preferredAnchor.index + preferredAnchor[0].length;
+        return `${contents.slice(0, insertionPoint)}${newline}${importLine}${contents.slice(insertionPoint)}`;
+    }
+    const firstImport = anyImportMatcher.exec(contents);
+    if (firstImport?.index !== undefined) {
+        return `${contents.slice(0, firstImport.index)}${importLine}${newline}${contents.slice(firstImport.index)}`;
+    }
+    return `${importLine}${newline}${contents}`;
+}
 function modifyObjcAppDelegate(contents) {
     const methodInvocationBlock = `[FIRApp configure];`;
     // https://regex101.com/r/mPgaq6/1
@@ -18,10 +34,7 @@ function modifyObjcAppDelegate(contents) {
     // if the above regex fails, we can use this one as a fallback:
     const fallbackInvocationLineMatcher = /-\s*\(BOOL\)\s*application:\s*\(UIApplication\s*\*\s*\)\s*\w+\s+didFinishLaunchingWithOptions:/g;
     // Add import
-    if (!contents.includes('#import <Firebase/Firebase.h>')) {
-        contents = contents.replace(/#import "AppDelegate.h"/g, `#import "AppDelegate.h"
-#import <Firebase/Firebase.h>`);
-    }
+    contents = addImport(contents, '#import <Firebase/Firebase.h>', /^[ \t]*#import\s+<Firebase\/Firebase\.h>[ \t]*$/m, /^[ \t]*#import\s+"AppDelegate\.h"[ \t]*$/m, /^[ \t]*#import\b[^\r\n]*$/m);
     // To avoid potential issues with existing changes from older plugin versions
     if (contents.includes(methodInvocationBlock)) {
         return contents;
@@ -61,12 +74,9 @@ function modifyObjcAppDelegate(contents) {
 }
 function modifySwiftAppDelegate(contents) {
     const methodInvocationBlock = `FirebaseApp.configure()`;
-    const methodInvocationLineMatcher = /(?:self\.moduleName\s*=\s*"([^"]*)")|(?:factory\.startReactNative\()/;
+    const methodInvocationLineMatcher = /(?:self\.moduleName\s*=\s*"([^"]*)")|(?:factory\.startReactNative\()|(?:return\s+super\.application\(\s*application\s*,\s*didFinishLaunchingWithOptions:\s*launchOptions\s*\))/;
     // Add import
-    if (!contents.includes('import FirebaseCore')) {
-        contents = contents.replace(/import Expo/g, `import Expo
-import FirebaseCore`);
-    }
+    contents = addImport(contents, 'import FirebaseCore', /^[ \t]*import\s+FirebaseCore[ \t]*$/m, /^[ \t]*(?:internal\s+)?import\s+Expo[ \t]*$/m, /^[ \t]*import\b[^\r\n]*$/m);
     // To avoid potential issues with existing changes from older plugin versions
     if (contents.includes(methodInvocationBlock)) {
         return contents;

package/plugin/build/ios/podfile.js

@@ -5,27 +5,27 @@ exports.setAppPodfileDisableSPM = setAppPodfileDisableSPM;
 const config_plugins_1 = require("@expo/config-plugins");
 const generateCode_1 = require("@expo/config-plugins/build/utils/generateCode");
 const TAG = '@react-native-firebase/app-disableSPM';
-const ANCHOR = /prepare_react_native_project!/;
-const FLAG = '$RNFirebaseDisableSPM = true';
-// The flag must be defined before any target block so firebase_spm.rb sees it
-// when pods are declared - anchoring just after `prepare_react_native_project!`
-// guarantees that in the Podfile Expo generates.
+const DISABLE_SPM_UNSUPPORTED = '[react-native-firebase] ios.disableSPM is no longer supported. ' +
+    'Firebase Apple SDK 13+ is distributed only through Swift Package Manager. ' +
+    'Remove `disableSPM` from the `@react-native-firebase/app` config plugin and ' +
+    'use dynamic frameworks (`expo-build-properties` ios.useFrameworks: "dynamic"). ' +
+    'See https://rnfirebase.io/ios-spm';
+// Historically injected `$RNFirebaseDisableSPM = true` before target blocks.
+// Firebase 13+ is SPM-only: enabling this option must fail loudly, and any
+// leftover generated flag is stripped on prebuild.
 function setAppPodfileDisableSPM(src, enabled = false) {
-    if (!enabled) {
-        return (0, generateCode_1.removeGeneratedContents)(src, TAG) ?? src;
+    if (enabled) {
+        throw new Error(DISABLE_SPM_UNSUPPORTED);
     }
-    return (0, generateCode_1.mergeContents)({
-        src,
-        newSrc: FLAG,
-        tag: TAG,
-        anchor: ANCHOR,
-        offset: 1,
-        comment: '#',
-    }).contents;
+    return (0, generateCode_1.removeGeneratedContents)(src, TAG) ?? src;
 }
 const withIosDisableSPM = (config, props) => {
+    if (props?.ios?.disableSPM === true) {
+        throw new Error(DISABLE_SPM_UNSUPPORTED);
+    }
     return (0, config_plugins_1.withPodfile)(config, config => {
-        config.modResults.contents = setAppPodfileDisableSPM(config.modResults.contents, props?.ios?.disableSPM === true);
+        // Strip a leftover DisableSPM flag from older prebuilds; never re-add it.
+        config.modResults.contents = setAppPodfileDisableSPM(config.modResults.contents, false);
         return config;
     });
 };

package/plugin/build/pluginConfig.d.ts

@@ -3,8 +3,10 @@ export interface PluginConfigType {
 }
 export interface PluginConfigTypeIos {
     /**
-     * Sets `$RNFirebaseDisableSPM = true` in the Podfile, forcing Firebase
-     * dependencies to be installed with CocoaPods instead of Swift Package Manager.
+     * @deprecated Firebase Apple SDK 13+ is SPM-only. Setting this to `true`
+     * fails Expo prebuild / `pod install` — CocoaPods no longer distributes Firebase.
+     * Remove this option and use `use_frameworks! :linkage => :dynamic` (via
+     * `expo-build-properties` `ios.useFrameworks: "dynamic"`).
      *
      * @platform ios iOS
      */