@react-native-firebase/app 26.3.3 → 27.0.0

package/ios_config.sh

@@ -32,7 +32,7 @@ _MAX_LOOKUPS=2;
 _SEARCH_RESULT=''
 _RN_ROOT_EXISTS=''
 _CURRENT_LOOKUPS=1
-_JSON_ROOT="'react-native'"
+_JSON_ROOT='react-native'
 _JSON_FILE_NAME='firebase.json'
 _JSON_OUTPUT_BASE64='e30=' # { }
 _CURRENT_SEARCH_DIR=${PROJECT_DIR}
@@ -47,12 +47,33 @@ _PLIST_ENTRY_VALUES=()
 
 function setPlistValue {
   echo "note:      setting plist entry '$1' of type '$2' in file '$4'"
-  ${_PLIST_BUDDY} -c "Add :$1 $2 '$3'" $4 || echo "note:      '$1' already exists"
+  # PlistBuddy is macOS-only (Xcode builds). Fall back to python3 plistlib so
+  # unit tests can exercise this script on Linux CI (ubuntu-latest).
+  if [[ -x "${_PLIST_BUDDY}" ]]; then
+    ${_PLIST_BUDDY} -c "Add :$1 $2 '$3'" $4 || echo "note:      '$1' already exists"
+  else
+    python3 - "$1" "$2" "$3" "$4" <<'PY' || echo "note:      failed to set '$1'"
+import plistlib
+import sys
+
+key, typ, value, path = sys.argv[1:5]
+with open(path, "rb") as handle:
+    data = plistlib.load(handle)
+if key in data:
+    sys.exit(0)
+if typ == "bool":
+    data[key] = value in ("YES", "true", "1")
+else:
+    data[key] = value
+with open(path, "wb") as handle:
+    plistlib.dump(data, handle)
+PY
+  fi
 }
 
 function getFirebaseJsonKeyValue () {
   if [[ ${_RN_ROOT_EXISTS} ]]; then
-    ruby -Ku -e "require 'rubygems';require 'json'; output=JSON.parse('$1'); puts output[$_JSON_ROOT]['$2']"
+    ruby -rjson -e 'output=JSON.parse(File.read(ARGV.fetch(0))); puts output[ARGV.fetch(1)][ARGV.fetch(2)]' "$_SEARCH_RESULT" "$_JSON_ROOT" "$1"
   else
     echo ""
   fi;
@@ -87,15 +108,14 @@ while true; do
 done
 
 if [[ ${_SEARCH_RESULT} ]]; then
-  _JSON_OUTPUT_RAW=$(cat "${_SEARCH_RESULT}")
-  if ! _RN_ROOT_EXISTS=$(ruby -Ku -e "require 'json'; output=JSON.parse('$_JSON_OUTPUT_RAW'); puts output[$_JSON_ROOT]"); then
+  if ! _RN_ROOT_EXISTS=$(ruby -rjson -e 'output=JSON.parse(File.read(ARGV.fetch(0))); puts output[ARGV.fetch(1)]' "$_SEARCH_RESULT" "$_JSON_ROOT"); then
     echo "error: Failed to parse firebase.json, check for syntax errors."
     exit 1
   fi
 
   if [[ ${_RN_ROOT_EXISTS} ]]; then
     if ! python3 --version >/dev/null 2>&1; then echo "error: python3 not found, firebase.json file processing error." && exit 1; fi
-    _JSON_OUTPUT_BASE64=$(python3 -c 'import json,sys,base64;print(base64.b64encode(bytes(json.dumps(json.loads(open('"'${_SEARCH_RESULT}'"', '"'rb'"').read())['${_JSON_ROOT}']), '"'utf-8'"')).decode())' || echo "e30=")
+    _JSON_OUTPUT_BASE64=$(python3 -c 'import base64,json,sys; print(base64.b64encode(json.dumps(json.load(open(sys.argv[1], "rb"))["react-native"]).encode()).decode())' "$_SEARCH_RESULT" || echo "e30=")
   fi
 
   _PLIST_ENTRY_KEYS+=("firebase_json_raw")
@@ -103,7 +123,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   _PLIST_ENTRY_VALUES+=("$_JSON_OUTPUT_BASE64")
 
   # config.app_data_collection_default_enabled
-  _APP_DATA_COLLECTION_ENABLED=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "app_data_collection_default_enabled")
+  _APP_DATA_COLLECTION_ENABLED=$(getFirebaseJsonKeyValue "app_data_collection_default_enabled")
   if [[ $_APP_DATA_COLLECTION_ENABLED ]]; then
     _PLIST_ENTRY_KEYS+=("FirebaseDataCollectionDefaultEnabled")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -111,7 +131,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_auto_collection_enabled
-  _ANALYTICS_AUTO_COLLECTION=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "analytics_auto_collection_enabled")
+  _ANALYTICS_AUTO_COLLECTION=$(getFirebaseJsonKeyValue "analytics_auto_collection_enabled")
   if [[ $_ANALYTICS_AUTO_COLLECTION ]]; then
     _PLIST_ENTRY_KEYS+=("FIREBASE_ANALYTICS_COLLECTION_ENABLED")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -119,7 +139,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_collection_deactivated
-  _ANALYTICS_DEACTIVATED=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "analytics_collection_deactivated")
+  _ANALYTICS_DEACTIVATED=$(getFirebaseJsonKeyValue "analytics_collection_deactivated")
   if [[ $_ANALYTICS_DEACTIVATED ]]; then
     _PLIST_ENTRY_KEYS+=("FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -127,7 +147,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_idfv_collection_enabled
-  _ANALYTICS_IDFV_COLLECTION=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "analytics_idfv_collection_enabled")
+  _ANALYTICS_IDFV_COLLECTION=$(getFirebaseJsonKeyValue "analytics_idfv_collection_enabled")
   if [[ $_ANALYTICS_IDFV_COLLECTION ]]; then
     _PLIST_ENTRY_KEYS+=("GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -135,7 +155,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_default_allow_analytics_storage
-  _ANALYTICS_STORAGE=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "analytics_default_allow_analytics_storage")
+  _ANALYTICS_STORAGE=$(getFirebaseJsonKeyValue "analytics_default_allow_analytics_storage")
   if [[ $_ANALYTICS_STORAGE ]]; then
     _PLIST_ENTRY_KEYS+=("GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -143,7 +163,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_default_allow_ad_storage
-  _ANALYTICS_AD_STORAGE=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "analytics_default_allow_ad_storage")
+  _ANALYTICS_AD_STORAGE=$(getFirebaseJsonKeyValue "analytics_default_allow_ad_storage")
   if [[ $_ANALYTICS_AD_STORAGE ]]; then
     _PLIST_ENTRY_KEYS+=("GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -151,7 +171,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_default_allow_ad_user_data
-  _ANALYTICS_AD_USER_DATA=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "analytics_default_allow_ad_user_data")
+  _ANALYTICS_AD_USER_DATA=$(getFirebaseJsonKeyValue "analytics_default_allow_ad_user_data")
   if [[ $_ANALYTICS_AD_USER_DATA ]]; then
     _PLIST_ENTRY_KEYS+=("GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_USER_DATA")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -159,7 +179,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_default_allow_ad_personalization_signals
-  _ANALYTICS_PERSONALIZATION=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "analytics_default_allow_ad_personalization_signals")
+  _ANALYTICS_PERSONALIZATION=$(getFirebaseJsonKeyValue "analytics_default_allow_ad_personalization_signals")
   if [[ $_ANALYTICS_PERSONALIZATION ]]; then
     _PLIST_ENTRY_KEYS+=("GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -167,7 +187,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.analytics_registration_with_ad_network_enabled
-  _ANALYTICS_REGISTRATION_WITH_AD_NETWORK=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "google_analytics_registration_with_ad_network_enabled")
+  _ANALYTICS_REGISTRATION_WITH_AD_NETWORK=$(getFirebaseJsonKeyValue "google_analytics_registration_with_ad_network_enabled")
   if [[ $_ANALYTICS_REGISTRATION_WITH_AD_NETWORK ]]; then
     _PLIST_ENTRY_KEYS+=("GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -175,7 +195,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.google_analytics_automatic_screen_reporting_enabled
-  _ANALYTICS_AUTO_SCREEN_REPORTING=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "google_analytics_automatic_screen_reporting_enabled")
+  _ANALYTICS_AUTO_SCREEN_REPORTING=$(getFirebaseJsonKeyValue "google_analytics_automatic_screen_reporting_enabled")
   if [[ $_ANALYTICS_AUTO_SCREEN_REPORTING ]]; then
     _PLIST_ENTRY_KEYS+=("FirebaseAutomaticScreenReportingEnabled")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -183,7 +203,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.perf_auto_collection_enabled
-  _PERF_AUTO_COLLECTION=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "perf_auto_collection_enabled")
+  _PERF_AUTO_COLLECTION=$(getFirebaseJsonKeyValue "perf_auto_collection_enabled")
   if [[ $_PERF_AUTO_COLLECTION ]]; then
     _PLIST_ENTRY_KEYS+=("firebase_performance_collection_enabled")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -191,7 +211,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.perf_collection_deactivated
-  _PERF_DEACTIVATED=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "perf_collection_deactivated")
+  _PERF_DEACTIVATED=$(getFirebaseJsonKeyValue "perf_collection_deactivated")
   if [[ $_PERF_DEACTIVATED ]]; then
     _PLIST_ENTRY_KEYS+=("firebase_performance_collection_deactivated")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -199,15 +219,23 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.messaging_auto_init_enabled
-  _MESSAGING_AUTO_INIT=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "messaging_auto_init_enabled")
+  _MESSAGING_AUTO_INIT=$(getFirebaseJsonKeyValue "messaging_auto_init_enabled")
   if [[ $_MESSAGING_AUTO_INIT ]]; then
     _PLIST_ENTRY_KEYS+=("FirebaseMessagingAutoInitEnabled")
     _PLIST_ENTRY_TYPES+=("bool")
     _PLIST_ENTRY_VALUES+=("$(jsonBoolToYesNo "$_MESSAGING_AUTO_INIT")")
   fi
 
+  # config.messaging_installation_id_enabled
+  _MESSAGING_INSTALLATION_ID=$(getFirebaseJsonKeyValue "messaging_installation_id_enabled")
+  if [[ $_MESSAGING_INSTALLATION_ID ]]; then
+    _PLIST_ENTRY_KEYS+=("FirebaseMessagingInstallationIdEnabled")
+    _PLIST_ENTRY_TYPES+=("bool")
+    _PLIST_ENTRY_VALUES+=("$(jsonBoolToYesNo "$_MESSAGING_INSTALLATION_ID")")
+  fi
+
   # config.in_app_messaging_auto_colllection_enabled
-  _FIAM_AUTO_INIT=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "in_app_messaging_auto_collection_enabled")
+  _FIAM_AUTO_INIT=$(getFirebaseJsonKeyValue "in_app_messaging_auto_collection_enabled")
   if [[ $_FIAM_AUTO_INIT ]]; then
     _PLIST_ENTRY_KEYS+=("FirebaseInAppMessagingAutomaticDataCollectionEnabled")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -215,7 +243,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.app_check_token_auto_refresh
-  _APP_CHECK_TOKEN_AUTO_REFRESH=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "app_check_token_auto_refresh")
+  _APP_CHECK_TOKEN_AUTO_REFRESH=$(getFirebaseJsonKeyValue "app_check_token_auto_refresh")
   if [[ $_APP_CHECK_TOKEN_AUTO_REFRESH ]]; then
     _PLIST_ENTRY_KEYS+=("FirebaseAppCheckTokenAutoRefreshEnabled")
     _PLIST_ENTRY_TYPES+=("bool")
@@ -223,7 +251,7 @@ if [[ ${_SEARCH_RESULT} ]]; then
   fi
 
   # config.crashlytics_disable_auto_disabler - undocumented for now - mainly for debugging, document if becomes useful
-  _CRASHLYTICS_AUTO_DISABLE_ENABLED=$(getFirebaseJsonKeyValue "$_JSON_OUTPUT_RAW" "crashlytics_disable_auto_disabler")
+  _CRASHLYTICS_AUTO_DISABLE_ENABLED=$(getFirebaseJsonKeyValue "crashlytics_disable_auto_disabler")
   if [[ $_CRASHLYTICS_AUTO_DISABLE_ENABLED == "true" ]]; then
     echo "Disabled Crashlytics auto disabler." # do nothing
   else

package/lib/FirebaseApp.ts

@@ -67,6 +67,16 @@ export default class FirebaseApp implements ReactNativeFirebase.FirebaseAppBase
     this._automaticDataCollectionEnabled = enabled;
   }
 
+  /**
+   * Package-internal: seeds the cached flag from the value the native SDK resolved at
+   * initialization, without calling back into native (unlike the public setter).
+   *
+   * @internal
+   */
+  _setAutomaticDataCollectionEnabledFromNative(enabled: boolean): void {
+    this._automaticDataCollectionEnabled = enabled;
+  }
+
   private _checkDestroyed(): void {
     if (this._deleted) {
       throw new Error(`Firebase App named '${this._name}' already deleted`);

package/lib/common/Base64.ts

@@ -17,7 +17,6 @@
 
 // @ts-expect-error - No type declarations available
 import binaryToBase64 from 'react-native/Libraries/Utilities/binaryToBase64';
-import { promiseDefer } from './promise';
 
 const CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
 
@@ -90,23 +89,18 @@ export interface Base64Result {
  */
 function fromData(data: Blob | ArrayBuffer | Uint8Array): Promise<Base64Result> {
   if (data instanceof Blob) {
-    const fileReader = new FileReader();
-    const { resolve, reject, promise } = promiseDefer<Base64Result>();
+    return new Promise<Base64Result>((resolve, reject) => {
+      const fileReader = new FileReader();
 
-    fileReader.readAsDataURL(data);
+      fileReader.onloadend = () => {
+        if (fileReader.result) {
+          resolve({ string: fileReader.result, format: 'data_url' });
+        }
+      };
 
-    fileReader.onloadend = () => {
-      if (fileReader?.result) {
-        resolve?.({ string: fileReader.result, format: 'data_url' });
-      }
-    };
-
-    fileReader.onerror = event => {
-      fileReader?.abort();
-      reject?.(event);
-    };
-
-    return promise;
+      fileReader.onerror = event => reject(event);
+      fileReader.readAsDataURL(data);
+    });
   }
 
   if (data instanceof ArrayBuffer || data instanceof Uint8Array) {

package/lib/common/deeps.ts

@@ -69,6 +69,9 @@ export function deepSet(
     return false;
   }
   const keys = path.split(joiner);
+  if (keys.some(key => ['__proto__', 'prototype', 'constructor'].includes(key))) {
+    return false;
+  }
 
   let i = 0;
   let _object: unknown = object;

package/lib/common/index.ts

@@ -30,18 +30,29 @@ export { default as ReferenceBase } from './ReferenceBase';
 export type { DataUrlParts, Observer };
 
 export function getDataUrlParts(dataUrlString: string): DataUrlParts {
-  const isBase64 = dataUrlString.includes(';base64');
-  let [mediaType, base64String] = dataUrlString.split(',');
-  if (!mediaType || !base64String) {
+  const match = /^data:([^,]*?)(;base64)?,([\s\S]*)$/.exec(dataUrlString);
+  if (!match) {
     return { base64String: undefined, mediaType: undefined };
   }
-  mediaType = mediaType.replace('data:', '').replace(';base64', '');
-  if (base64String && base64String.includes('%')) {
-    base64String = decodeURIComponent(base64String);
-  }
-  if (!isBase64) {
-    base64String = Base64.btoa(base64String);
+
+  const mediaType = match[1] || undefined;
+  let base64String = match[3] ?? '';
+
+  try {
+    if (base64String.includes('%')) {
+      base64String = decodeURIComponent(base64String);
+    }
+    if (!match[2]) {
+      const binaryString = encodeURIComponent(base64String).replace(
+        /%([0-9A-F]{2})/g,
+        (_, hex: string) => String.fromCharCode(Number.parseInt(hex, 16)),
+      );
+      base64String = Base64.btoa(binaryString);
+    }
+  } catch (_) {
+    return { base64String: undefined, mediaType: undefined };
   }
+
   return { base64String, mediaType };
 }
 

package/lib/internal/FirebaseModule.ts

@@ -18,9 +18,12 @@
 import { getAppModule, getNativeModule } from './registry/nativeModule';
 import SharedEventEmitter from './SharedEventEmitter';
 import type { ReactNativeFirebase } from '../types/app';
-import type { FirebaseJsonConfig, ModuleConfig } from '../types/internal';
+import type {
+  FirebaseJsonConfig,
+  ModuleConfig,
+  ReactNativeFirebaseEventEmitter,
+} from '../types/internal';
 import type { ReactNativeFirebaseNativeModules } from './NativeModules';
-import type EventEmitter from 'react-native/Libraries/vendor/emitter/EventEmitter';
 
 let firebaseJson: FirebaseJsonConfig | null = null;
 
@@ -55,7 +58,7 @@ export default class FirebaseModule<
     return firebaseJson as FirebaseJsonConfig;
   }
 
-  get emitter(): EventEmitter {
+  get emitter(): ReactNativeFirebaseEventEmitter {
     return SharedEventEmitter;
   }
 

package/lib/internal/NativeModules.ts

@@ -48,7 +48,10 @@ export interface RNFBAppModuleInterface {
   initializeApp(
     options: ReactNativeFirebase.FirebaseAppOptions,
     appConfig: ReactNativeFirebase.FirebaseAppConfig,
-  ): Promise<void>;
+  ): Promise<{
+    options?: ReactNativeFirebase.FirebaseAppOptions;
+    appConfig?: ReactNativeFirebase.FirebaseAppConfig;
+  } | void>;
   deleteApp(name: string): Promise<void>;
   setLogLevel(logLevel: string): void;
   metaGetAll(): Promise<{ [key: string]: string | boolean }>;

package/lib/internal/RNFBNativeEventEmitter.ts

@@ -53,8 +53,10 @@ class RNFBNativeEventEmitter extends NativeEventEmitter {
 
   addListener(
     eventType: string,
-    listener: (...args: unknown[]) => unknown,
-    context?: object,
+    // RN 0.88 NativeEventEmitter types the payload as `Object`, not `object`.
+    // eslint-disable-next-line @typescript-eslint/no-wrapper-object-types
+    listener: (...args: readonly Object[]) => unknown,
+    context?: unknown,
   ): EmitterSubscription {
     // NewArch-AD-18 E1: event bridge identity requires raw app-module host for listener registration.
     const RNFBAppModule = getReactNativeModule(
@@ -69,7 +71,8 @@ class RNFBNativeEventEmitter extends NativeEventEmitter {
       // eslint-disable-next-line no-console
       console.debug(`[RNFB-->Event][👂] ${eventType} -> listening`);
     }
-    const listenerDebugger = (...args: unknown[]) => {
+    // eslint-disable-next-line @typescript-eslint/no-wrapper-object-types
+    const listenerDebugger = (...args: readonly Object[]) => {
       if (globalThis.RNFBDebug) {
         // eslint-disable-next-line no-console
         console.debug(`[RNFB<--Event][📣] ${eventType} <-`, JSON.stringify(args[0]));
@@ -89,7 +92,8 @@ class RNFBNativeEventEmitter extends NativeEventEmitter {
       return listener(...args);
     };
 
-    let subscription = super.addListener(`rnfb_${eventType}`, listenerDebugger, context);
+    // Installed RN types disagree across 0.86 (`Object`) and 0.88 (wider emitter args).
+    let subscription = super.addListener(`rnfb_${eventType}`, listenerDebugger, context as any);
 
     // React Native 0.65+ altered EventEmitter:
     // - removeSubscription is gone
@@ -118,7 +122,12 @@ class RNFBNativeEventEmitter extends NativeEventEmitter {
     return subscription;
   }
 
-  removeAllListeners(eventType: string): void {
+  removeAllListeners(eventType?: string | null): void {
+    if (eventType == null) {
+      // 0.86 types require `string`; 0.88 accepts a missing event type. The value is unchanged.
+      super.removeAllListeners(eventType as any);
+      return;
+    }
     // NewArch-AD-18 E1: raw host for eventsRemoveListener.
     const RNFBAppModule = getReactNativeModule(
       APP_NATIVE_MODULE,

package/lib/internal/SharedEventEmitter.ts

@@ -15,6 +15,10 @@
  *
  */
 
+// RN macOS 0.78 does not export EventEmitter from the public API; vendor path works on 0.78–0.88.
 import EventEmitter from 'react-native/Libraries/vendor/emitter/EventEmitter';
+import type { ReactNativeFirebaseEventEmitter } from '../types/internal';
 
-export default new EventEmitter();
+const emitter = new EventEmitter() as ReactNativeFirebaseEventEmitter;
+
+export default emitter;

package/lib/internal/asyncStorage.ts

@@ -29,11 +29,7 @@ const asyncStorageMemory: AsyncStorageStatic = {
     return Promise.resolve();
   },
   getItem(key: string): Promise<string | null> {
-    const hasValue = memoryStorage.has(key);
-    if (hasValue) {
-      return Promise.resolve(memoryStorage.get(key) || null);
-    }
-    return Promise.resolve(null);
+    return Promise.resolve(memoryStorage.get(key) ?? null);
   },
   removeItem(key: string): Promise<void> {
     memoryStorage.delete(key);
@@ -61,16 +57,16 @@ export function isMemoryStorage(): boolean {
 }
 
 // Set an item in storage with the React Native Firebase prefix
-export async function setItem(key: string, value: string): Promise<void> {
-  return await asyncStorage.setItem(prefix + key, value);
+export function setItem(key: string, value: string): Promise<void> {
+  return asyncStorage.setItem(prefix + key, value);
 }
 
 // Get an item from storage with the React Native Firebase prefix
-export async function getItem(key: string): Promise<string | null> {
-  return await asyncStorage.getItem(prefix + key);
+export function getItem(key: string): Promise<string | null> {
+  return asyncStorage.getItem(prefix + key);
 }
 
 // Remove an item from storage with the React Native Firebase prefix
-export async function removeItem(key: string): Promise<void> {
-  return await asyncStorage.removeItem(prefix + key);
+export function removeItem(key: string): Promise<void> {
+  return asyncStorage.removeItem(prefix + key);
 }

package/lib/internal/index.ts

@@ -23,6 +23,7 @@ export * from './NativeModules';
 export * from './registry/app';
 export * from './registry/modular';
 export * from './registry/nativeModule';
+export { getReactNativeModule, setReactNativeModule } from './nativeModule';
 export { default as SharedEventEmitter } from './SharedEventEmitter';
 export { Logger } from './logger';
 export type { ModuleConfig } from '../types/internal';

package/lib/internal/logger.ts

@@ -108,6 +108,50 @@ const defaultLogHandler: LogHandler = (instance, logType, ...args) => {
 
 const defaultLogLevel = LogLevel.INFO;
 
+let currentLogLevel = defaultLogLevel;
+let currentUserLogHandler: LogHandler | null = null;
+
+function createUserLogHandler(
+  logCallback: LogCallback | null,
+  options?: LogOptions,
+): LogHandler | null {
+  if (logCallback === null) {
+    return null;
+  }
+
+  const customLogLevel = options?.level ? levelStringToEnum[options.level] : null;
+  return (instance, level, ...args) => {
+    const message = args
+      .map(arg => {
+        if (arg == null) {
+          return null;
+        } else if (typeof arg === 'string') {
+          return arg;
+        } else if (typeof arg === 'number' || typeof arg === 'boolean') {
+          return arg.toString();
+        } else if (arg instanceof Error) {
+          return arg.message;
+        } else {
+          try {
+            return JSON.stringify(arg);
+          } catch (_ignored) {
+            return null;
+          }
+        }
+      })
+      .filter(arg => arg)
+      .join(' ');
+    if (level >= (customLogLevel ?? instance.logLevel)) {
+      logCallback({
+        level: LogLevelReversed[level]!.toLowerCase() as LogLevelString,
+        message,
+        args,
+        type: instance.name,
+      });
+    }
+  };
+}
+
 /**
  * A container for all of the Logger instances
  */
@@ -118,9 +162,9 @@ export const instances: Logger[] = [];
  */
 export class Logger {
   name: string;
-  private _logLevel: LogLevel = defaultLogLevel;
+  private _logLevel: LogLevel = currentLogLevel;
   private _logHandler: LogHandler = defaultLogHandler;
-  private _userLogHandler: LogHandler | null = null;
+  private _userLogHandler: LogHandler | null = currentUserLogHandler;
 
   /**
    * Gives you an instance of a Logger to capture messages according to
@@ -215,9 +259,11 @@ export class Logger {
  * Sets the log level for all Logger instances
  */
 export function setLogLevel(level: LogLevelString | LogLevel): void {
-  instances.forEach(inst => {
-    inst.setLogLevel(level);
-  });
+  const normalizedLevel = typeof level === 'string' ? levelStringToEnum[level] : level;
+  currentLogLevel = normalizedLevel;
+  for (const instance of instances) {
+    instance.setLogLevel(normalizedLevel);
+  }
 }
 
 // Alias for compatibility
@@ -227,44 +273,8 @@ export const setLogLevelInternal = setLogLevel;
  * Sets a custom user log handler for all Logger instances
  */
 export function setUserLogHandler(logCallback: LogCallback | null, options?: LogOptions): void {
+  currentUserLogHandler = createUserLogHandler(logCallback, options);
   for (const instance of instances) {
-    let customLogLevel: LogLevel | null = null;
-    if (options?.level) {
-      customLogLevel = levelStringToEnum[options.level];
-    }
-    if (logCallback === null) {
-      instance.userLogHandler = null;
-    } else {
-      instance.userLogHandler = (_instance, level, ...args) => {
-        const message = args
-          .map(arg => {
-            if (arg == null) {
-              return null;
-            } else if (typeof arg === 'string') {
-              return arg;
-            } else if (typeof arg === 'number' || typeof arg === 'boolean') {
-              return arg.toString();
-            } else if (arg instanceof Error) {
-              return arg.message;
-            } else {
-              try {
-                return JSON.stringify(arg);
-              } catch (_ignored) {
-                return null;
-              }
-            }
-          })
-          .filter(arg => arg)
-          .join(' ');
-        if (level >= (customLogLevel ?? _instance.logLevel)) {
-          logCallback({
-            level: LogLevelReversed[level]!.toLowerCase() as LogLevelString,
-            message,
-            args,
-            type: _instance.name,
-          });
-        }
-      };
-    }
+    instance.userLogHandler = currentUserLogHandler;
   }
 }

package/lib/internal/nativeModuleAndroidIos.ts

@@ -1,5 +1,5 @@
-/* eslint-disable no-console */
 import { TurboModuleRegistry } from 'react-native';
+import { createNativeModuleDebugProxy } from './nativeModuleDebug';
 
 const DYNAMIC_CONSTANT_KEYS = new Set(['androidPlayServices']);
 
@@ -64,45 +64,7 @@ export function getReactNativeModule(moduleName: string): Record<string, unknown
     return debugProxy;
   }
 
-  debugProxy = new Proxy(nativeModule as Record<string, unknown>, {
-    ownKeys(target) {
-      const keys: string[] = [];
-      for (const key in target) {
-        keys.push(key);
-      }
-      return keys;
-    },
-    get: (_, name) => {
-      const prop = (nativeModule as Record<string, unknown>)[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).apply(nativeModule, 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;
-      };
-    },
-  });
+  debugProxy = createNativeModuleDebugProxy(moduleName, nativeModule);
   memoizedDebugProxies.set(moduleName, debugProxy);
   return debugProxy;
 }