@react-native-firebase/app 26.4.0 → 27.0.0

package/ios/RNFBApp/RCTConvert+FIRApp.h

@@ -15,13 +15,10 @@
  *
  */
 
-#if __has_include(<FirebaseCore/FirebaseCore.h>)
-#import <FirebaseCore/FirebaseCore.h>
-#else
-@import FirebaseCore;
-#endif
 #import <React/RCTConvert.h>
 
+@class FIRApp;
+
 @interface RCTConvert (FIRApp)
 + (FIRApp *)firAppFromString:(NSString *)appName;
 @end

package/ios/RNFBApp/RCTConvert+FIRApp.m

@@ -16,15 +16,20 @@
  */
 
 #import "RCTConvert+FIRApp.h"
-#import "RNFBSharedUtils.h"
+
+#if __has_include(<RNFBApp/RNFBApp-Swift.h>)
+#import <RNFBApp/RNFBApp-Swift.h>
+#elif __has_include("RNFBApp-Swift.h")
+#import "RNFBApp-Swift.h"
+#elif __has_include("RNFBHandleMapStorage-Swift.inc")
+#import "RNFBHandleMapStorage-Swift.inc"
+#else
+#error "RNFBApp Swift interface not found"
+#endif
 
 @implementation RCTConvert (FIRApp)
 + (FIRApp *)firAppFromString:(NSString *)appName {
-  if ([appName isEqualToString:DEFAULT_APP_DISPLAY_NAME]) {
-    return [FIRApp defaultApp];
-  }
-
-  return [FIRApp appNamed:appName];
+  return (FIRApp *)[RCTConvertFIRApp firAppFromString:appName];
 }
 
 RCT_CUSTOM_CONVERTER(FIRApp *, FIRApp, [self firAppFromString:[self NSString:json]]);

package/ios/RNFBApp/RCTConvert+FIROptions.h

@@ -15,13 +15,10 @@
  *
  */
 
-#if __has_include(<FirebaseCore/FirebaseCore.h>)
-#import <FirebaseCore/FirebaseCore.h>
-#else
-@import FirebaseCore;
-#endif
 #import <React/RCTConvert.h>
 
+@class FIROptions;
+
 @interface RCTConvert (FIROptions)
 + (FIROptions *)convertRawOptions:(NSDictionary *)rawOptions;
 @end

package/ios/RNFBApp/RCTConvert+FIROptions.m

@@ -17,19 +17,20 @@
 
 #import "RCTConvert+FIROptions.h"
 
+#if __has_include(<RNFBApp/RNFBApp-Swift.h>)
+#import <RNFBApp/RNFBApp-Swift.h>
+#elif __has_include("RNFBApp-Swift.h")
+#import "RNFBApp-Swift.h"
+#elif __has_include("RNFBHandleMapStorage-Swift.inc")
+#import "RNFBHandleMapStorage-Swift.inc"
+#else
+#error "RNFBApp Swift interface not found"
+#endif
+
 @implementation RCTConvert (FIROptions)
 
 + (FIROptions *)convertRawOptions:(NSDictionary *)rawOptions {
-  FIROptions *firOptions =
-      [[FIROptions alloc] initWithGoogleAppID:[rawOptions valueForKey:@"appId"]
-                                  GCMSenderID:[rawOptions valueForKey:@"messagingSenderId"]];
-  firOptions.APIKey = [rawOptions valueForKey:@"apiKey"];
-  firOptions.projectID = [rawOptions valueForKey:@"projectId"];
-  firOptions.clientID = [rawOptions valueForKey:@"clientId"];
-  firOptions.databaseURL = [rawOptions valueForKey:@"databaseURL"];
-  firOptions.storageBucket = [rawOptions valueForKey:@"storageBucket"];
-  firOptions.bundleID = [[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleIdentifier"];
-  return firOptions;
+  return (FIROptions *)[RCTConvertFIROptions convertRawOptions:rawOptions];
 }
 
 RCT_CUSTOM_CONVERTER(FIROptions *, FIROptions, [self convertRawOptions:[self NSDictionary:json]]);

package/ios/RNFBApp/RCTConvertFIRApp.swift

@@ -0,0 +1,86 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+import RNFBFirebase
+#else
+import FirebaseCore
+#endif
+import Foundation
+
+/**
+ * FIRApp registry previously hard-wired to `[FIRApp defaultApp]` / `[FIRApp appNamed:]`.
+ *
+ * Production adapts live `FIRApp` class methods; unit tests inject a registry double.
+ */
+@objc public protocol RNFBFIRAppLookingUp: AnyObject {
+  @objc(defaultApp)
+  func defaultApp() -> AnyObject?
+
+  @objc(appNamed:)
+  func appNamed(_ name: String) -> AnyObject?
+}
+
+/**
+ * Adapts `FirebaseApp.app()` / `FirebaseApp.app(name:)` (`+[FIRApp defaultApp]` /
+ * `+[FIRApp appNamed:]`) for `RCTConvertFIRApp`.
+ */
+@objc(RNFBFIRAppRegistryAdapter)
+final class RNFBFIRAppRegistryAdapter: NSObject, RNFBFIRAppLookingUp {
+  @objc static let shared = RNFBFIRAppRegistryAdapter()
+
+  func defaultApp() -> AnyObject? {
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+    RNFBFirebaseAppClient.defaultApp()
+#else
+    FirebaseApp.app()
+#endif
+  }
+
+  func appNamed(_ name: String) -> AnyObject? {
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+    RNFBFirebaseAppClient.app(named: name)
+#else
+    FirebaseApp.app(name: name)
+#endif
+  }
+}
+
+/**
+ * FIRApp name → instance lookup previously inline in `RCTConvert+FIRApp.m`.
+ *
+ * Mirrors pre-port:
+ * - `DEFAULT_APP_DISPLAY_NAME` (`[DEFAULT]`) → `defaultApp`
+ * - any other name → `appNamed:`
+ */
+@objc(RCTConvertFIRApp)
+public final class RCTConvertFIRApp: NSObject {
+  /// Matches `DEFAULT_APP_DISPLAY_NAME` in `RNFBSharedUtils.m`.
+  private static let defaultAppDisplayName = "[DEFAULT]"
+
+  @objc(firAppFromString:)
+  public static func firApp(fromString appName: String) -> AnyObject? {
+    firApp(fromString: appName, registry: RNFBFIRAppRegistryAdapter.shared)
+  }
+
+  @objc(firAppFromString:registry:)
+  public static func firApp(fromString appName: String, registry: RNFBFIRAppLookingUp) -> AnyObject? {
+    if appName == defaultAppDisplayName {
+      return registry.defaultApp()
+    }
+    return registry.appNamed(appName)
+  }
+}

package/ios/RNFBApp/RCTConvertFIROptions.swift

@@ -0,0 +1,259 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+import RNFBFirebase
+#else
+import FirebaseCore
+#endif
+
+/**
+ * Mutable FIROptions fields set by `convertRawOptions`.
+ *
+ * Production adapts live `FIROptions`; unit tests inject doubles.
+ */
+@objc public protocol RNFBFIROptionsConfiguring: AnyObject {
+  var APIKey: String? { get set }
+  var projectID: String? { get set }
+  var clientID: String? { get set }
+  var databaseURL: String? { get set }
+  var storageBucket: String? { get set }
+  var bundleID: String? { get set }
+  /// Set by `initializeApp` options mapping (`appGroupId`); unused by `convertRawOptions`.
+  var appGroupID: String? { get set }
+}
+
+/**
+ * Creates a FIROptions-like object from Google App ID + GCM sender ID.
+ *
+ * Production wraps `[[FIROptions alloc] initWithGoogleAppID:GCMSenderID:]`.
+ */
+@objc public protocol RNFBFIROptionsCreating: AnyObject {
+  @objc(createWithGoogleAppID:gcmSenderID:)
+  func create(googleAppID: String?, gcmSenderID: String?) -> RNFBFIROptionsConfiguring
+}
+
+/**
+ * Bundle identifier source previously hard-wired to
+ * `[[NSBundle mainBundle] objectForInfoDictionaryKey:@"CFBundleIdentifier"]`.
+ */
+@objc public protocol RNFBBundleIdentifierProviding: AnyObject {
+  @objc(bundleIdentifier)
+  var bundleIdentifier: String? { get }
+}
+
+/**
+ * Single FIROptions construction path. Dynamic mode asks the opaque facade. Shipped mode
+ * builds `FirebaseOptions` through the Swift overlay initializer.
+ */
+enum RNFBFIROptionsAllocation {
+  static func create(googleAppID: String?, gcmSenderID: String?) -> NSObject {
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+    RNFBFirebaseOptionsClient.create(googleAppID: googleAppID, gcmSenderID: gcmSenderID)
+#else
+    // Pre-port forwarded nil into `initWithGoogleAppID:GCMSenderID:`, which leaves the key
+    // unset. The Swift overlay initializer takes non-optional strings, so build with empty
+    // placeholders and clear the keys for nil input. KVC forwards nil to the ObjC setters,
+    // which remove the same dictionary entries the nil-initializer would never have added.
+    let options = FirebaseOptions(googleAppID: googleAppID ?? "", gcmSenderID: gcmSenderID ?? "")
+    if googleAppID == nil {
+      options.setValue(nil, forKey: "googleAppID")
+    }
+    if gcmSenderID == nil {
+      options.setValue(nil, forKey: "GCMSenderID")
+    }
+    return options
+#endif
+  }
+}
+
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+/**
+ * Wraps a live options object from `RNFBFirebaseOptionsClient` without naming Firebase types.
+ */
+@objc(RNFBFIROptionsConfiguringAdapter)
+final class RNFBFIROptionsConfiguringAdapter: NSObject, RNFBFIROptionsConfiguring {
+  @objc let options: NSObject
+
+  init(_ options: NSObject) {
+    self.options = options
+  }
+
+  var APIKey: String? {
+    get { RNFBFirebaseOptionsClient.apiKey(options) }
+    set { RNFBFirebaseOptionsClient.setAPIKey(newValue, on: options) }
+  }
+
+  var projectID: String? {
+    get { RNFBFirebaseOptionsClient.projectID(options) }
+    set { RNFBFirebaseOptionsClient.setProjectID(newValue, on: options) }
+  }
+
+  var clientID: String? {
+    get { RNFBFirebaseOptionsClient.clientID(options) }
+    set { RNFBFirebaseOptionsClient.setClientID(newValue, on: options) }
+  }
+
+  var databaseURL: String? {
+    get { RNFBFirebaseOptionsClient.databaseURL(options) }
+    set { RNFBFirebaseOptionsClient.setDatabaseURL(newValue, on: options) }
+  }
+
+  var storageBucket: String? {
+    get { RNFBFirebaseOptionsClient.storageBucket(options) }
+    set { RNFBFirebaseOptionsClient.setStorageBucket(newValue, on: options) }
+  }
+
+  var bundleID: String? {
+    get { RNFBFirebaseOptionsClient.bundleID(options) }
+    set { RNFBFirebaseOptionsClient.setBundleID(newValue, on: options) }
+  }
+
+  var appGroupID: String? {
+    get { RNFBFirebaseOptionsClient.appGroupID(options) }
+    set { RNFBFirebaseOptionsClient.setAppGroupID(newValue, on: options) }
+  }
+}
+#else
+/**
+ * Wraps live `FirebaseOptions` for `RNFBFIROptionsConfiguring`.
+ *
+ * Swift overlays rename / tighten optionality (`apiKey`, non-optional `bundleID`),
+ * so a direct `extension FirebaseOptions: RNFBFIROptionsConfiguring` does not compile.
+ */
+@objc(RNFBFIROptionsConfiguringAdapter)
+final class RNFBFIROptionsConfiguringAdapter: NSObject, RNFBFIROptionsConfiguring {
+  @objc let options: FirebaseOptions
+
+  init(_ options: NSObject) {
+    self.options = options as! FirebaseOptions
+  }
+
+  var APIKey: String? {
+    get { options.apiKey }
+    set { options.apiKey = newValue }
+  }
+
+  var projectID: String? {
+    get { options.projectID }
+    set { options.projectID = newValue }
+  }
+
+  var clientID: String? {
+    get { options.clientID }
+    set { options.clientID = newValue }
+  }
+
+  var databaseURL: String? {
+    get { options.databaseURL }
+    set { options.databaseURL = newValue }
+  }
+
+  var storageBucket: String? {
+    get { options.storageBucket }
+    set { options.storageBucket = newValue }
+  }
+
+  var bundleID: String? {
+    get { options.bundleID }
+    // The Swift overlay types `bundleID` as non-optional. KVC forwards nil to the ObjC
+    // setter like pre-port `options.bundleID = nil` did.
+    set { options.setValue(newValue, forKey: "bundleID") }
+  }
+
+  var appGroupID: String? {
+    get { options.appGroupID }
+    set { options.appGroupID = newValue }
+  }
+}
+#endif
+
+/**
+ * Adapts `FirebaseOptions` / `FIROptions` for `RCTConvertFIROptions`.
+ */
+@objc(RNFBFIROptionsFactoryAdapter)
+final class RNFBFIROptionsFactoryAdapter: NSObject, RNFBFIROptionsCreating {
+  @objc static let shared = RNFBFIROptionsFactoryAdapter()
+
+  @objc(createWithGoogleAppID:gcmSenderID:)
+  func create(googleAppID: String?, gcmSenderID: String?) -> RNFBFIROptionsConfiguring {
+    RNFBFIROptionsConfiguringAdapter(
+      RNFBFIROptionsAllocation.create(googleAppID: googleAppID, gcmSenderID: gcmSenderID)
+    )
+  }
+}
+
+/**
+ * Adapts mainBundle CFBundleIdentifier for `RCTConvertFIROptions`.
+ */
+@objc(RNFBMainBundleIdentifierProvider)
+final class RNFBMainBundleIdentifierProvider: NSObject, RNFBBundleIdentifierProviding {
+  @objc static let shared = RNFBMainBundleIdentifierProvider()
+
+  @objc var bundleIdentifier: String? {
+    Bundle.main.object(forInfoDictionaryKey: "CFBundleIdentifier") as? String
+  }
+}
+
+/**
+ * Raw JS options dict → FIROptions mapping previously inline in `RCTConvert+FIROptions.m`.
+ *
+ * Mirrors pre-port:
+ * - init with `appId` / `messagingSenderId`
+ * - set APIKey / projectID / clientID / databaseURL / storageBucket from dict keys
+ * - bundleID from the injected bundle-identifier provider
+ */
+@objc(RCTConvertFIROptions)
+public final class RCTConvertFIROptions: NSObject {
+  /// Unwraps a configuring adapter to the live `FIROptions` object.
+  static func liveFIROptions(from configured: RNFBFIROptionsConfiguring) -> AnyObject {
+    if let adapter = configured as? RNFBFIROptionsConfiguringAdapter {
+      return adapter.options
+    }
+    return configured
+  }
+
+  /// Production entry used by `RCTConvert+FIROptions.m` — returns live `FIROptions`.
+  @objc(convertRawOptions:)
+  public static func convertRawOptions(_ rawOptions: NSDictionary) -> AnyObject {
+    let configured = convertRawOptions(
+      rawOptions,
+      optionsFactory: RNFBFIROptionsFactoryAdapter.shared,
+      bundleIDProvider: RNFBMainBundleIdentifierProvider.shared
+    )
+    return liveFIROptions(from: configured)
+  }
+
+  @objc(convertRawOptions:optionsFactory:bundleIDProvider:)
+  public static func convertRawOptions(
+    _ rawOptions: NSDictionary,
+    optionsFactory: RNFBFIROptionsCreating,
+    bundleIDProvider: RNFBBundleIdentifierProviding
+  ) -> RNFBFIROptionsConfiguring {
+    let options = optionsFactory.create(
+      googleAppID: rawOptions.value(forKey: "appId") as? String,
+      gcmSenderID: rawOptions.value(forKey: "messagingSenderId") as? String
+    )
+    options.APIKey = rawOptions.value(forKey: "apiKey") as? String
+    options.projectID = rawOptions.value(forKey: "projectId") as? String
+    options.clientID = rawOptions.value(forKey: "clientId") as? String
+    options.databaseURL = rawOptions.value(forKey: "databaseURL") as? String
+    options.storageBucket = rawOptions.value(forKey: "storageBucket") as? String
+    options.bundleID = bundleIDProvider.bundleIdentifier
+    return options
+  }
+}

package/ios/RNFBApp/RNFBAppCustomAuthDomains.swift

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/**
+ * Process-wide custom auth-domain store previously owned by `RNFBAppModule.mm`
+ * (`static NSMutableDictionary *customAuthDomains`).
+ *
+ * Mirrors pre-port:
+ * - set non-nil → store under `appName` (lazy-init dictionary on first non-nil set)
+ * - set nil → `removeObject(forKey:)` (no-op when dictionary is still nil)
+ * - get → dictionary lookup (nil if missing / dictionary unset)
+ * - synchronized on a dedicated lock (pre-port `@synchronized(self)` on class methods)
+ */
+@objc(RNFBAppCustomAuthDomains)
+public final class RNFBAppCustomAuthDomains: NSObject {
+  private static let lock = NSObject()
+  private static var customAuthDomains: NSMutableDictionary?
+
+  @objc(getCustomDomain:)
+  public static func getCustomDomain(_ appName: String) -> String? {
+    objc_sync_enter(lock)
+    defer { objc_sync_exit(lock) }
+    return customAuthDomains?[appName] as? String
+  }
+
+  @objc(setCustomDomain:forAppName:)
+  public static func setCustomDomain(_ authDomain: String?, forAppName appName: String) {
+    objc_sync_enter(lock)
+    defer { objc_sync_exit(lock) }
+    if let authDomain {
+      if customAuthDomains == nil {
+        customAuthDomains = NSMutableDictionary()
+      }
+      customAuthDomains![appName] = authDomain
+    } else {
+      // Pre-port: messaging nil dictionary is a no-op.
+      customAuthDomains?.removeObject(forKey: appName)
+    }
+  }
+
+  /// Clears all stored domains. Unit-test / HostStub seam only.
+  @objc(resetCustomDomainsForTesting)
+  public static func resetCustomDomainsForTesting() {
+    objc_sync_enter(lock)
+    defer { objc_sync_exit(lock) }
+    customAuthDomains?.removeAllObjects()
+  }
+}

package/ios/RNFBApp/RNFBAppInitializeOptionsMapper.swift

@@ -0,0 +1,113 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/**
+ * Name resolution for `-[RNFBAppModule initializeApp:appConfig:resolve:reject:]`.
+ *
+ * Mirrors pre-port:
+ * - `jsAppName` = `name` when `name.length > 0`, else `DEFAULT_APP_DISPLAY_NAME` (`[DEFAULT]`)
+ * - `isDefaultApp` when `!name` or name equals `[DEFAULT]`
+ *   (empty string → `jsAppName` `[DEFAULT]` but `isDefaultApp` == false)
+ */
+@objc(RNFBAppInitializeNameResolution)
+public final class RNFBAppInitializeNameResolution: NSObject {
+  @objc public let appName: String?
+  @objc public let jsAppName: String
+  @objc public let isDefaultApp: Bool
+
+  @objc public init(appName: String?, jsAppName: String, isDefaultApp: Bool) {
+    self.appName = appName
+    self.jsAppName = jsAppName
+    self.isDefaultApp = isDefaultApp
+    super.init()
+  }
+}
+
+/**
+ * Name / FIROptions / authDomain mapping previously inline in
+ * `-[RNFBAppModule initializeApp:appConfig:resolve:reject:]`.
+ *
+ * Distinct from `RCTConvertFIROptions.convertRawOptions`:
+ * - optional fields skip assignment when value `isEqual:[NSNull null]`
+ * - uses JS keys `iosBundleId` / `iosClientId` / `appGroupId` (not `clientId` + bundle provider)
+ */
+@objc(RNFBAppInitializeOptionsMapper)
+public final class RNFBAppInitializeOptionsMapper: NSObject {
+  /// Matches `DEFAULT_APP_DISPLAY_NAME` in `RNFBSharedUtils.m`.
+  private static let defaultAppDisplayName = "[DEFAULT]"
+
+  @objc(resolveNameFromAppConfig:)
+  public static func resolveName(from appConfig: NSDictionary) -> RNFBAppInitializeNameResolution {
+    let appName = appConfig.value(forKey: "name") as? String
+    let jsAppName: String
+    if let appName, appName.count > 0 {
+      jsAppName = appName
+    } else {
+      jsAppName = defaultAppDisplayName
+    }
+    let isDefaultApp = appName == nil || appName == defaultAppDisplayName
+    return RNFBAppInitializeNameResolution(
+      appName: appName,
+      jsAppName: jsAppName,
+      isDefaultApp: isDefaultApp
+    )
+  }
+
+  @objc(buildOptionsFrom:optionsFactory:)
+  public static func buildOptions(
+    from options: NSDictionary,
+    optionsFactory: RNFBFIROptionsCreating
+  ) -> RNFBFIROptionsConfiguring {
+    let firOptions = optionsFactory.create(
+      googleAppID: options.value(forKey: "appId") as? String,
+      gcmSenderID: options.value(forKey: "messagingSenderId") as? String
+    )
+    firOptions.APIKey = options.value(forKey: "apiKey") as? String
+    firOptions.projectID = options.value(forKey: "projectId") as? String
+    if shouldAssignOptionalField(options.value(forKey: "databaseURL")) {
+      firOptions.databaseURL = options.value(forKey: "databaseURL") as? String
+    }
+    if shouldAssignOptionalField(options.value(forKey: "storageBucket")) {
+      firOptions.storageBucket = options.value(forKey: "storageBucket") as? String
+    }
+    if shouldAssignOptionalField(options.value(forKey: "iosBundleId")) {
+      firOptions.bundleID = options.value(forKey: "iosBundleId") as? String
+    }
+    if shouldAssignOptionalField(options.value(forKey: "iosClientId")) {
+      firOptions.clientID = options.value(forKey: "iosClientId") as? String
+    }
+    if shouldAssignOptionalField(options.value(forKey: "appGroupId")) {
+      firOptions.appGroupID = options.value(forKey: "appGroupId") as? String
+    }
+    return firOptions
+  }
+
+  @objc(authDomainFromOptions:)
+  public static func authDomain(from options: NSDictionary) -> String? {
+    options.value(forKey: "authDomain") as? String
+  }
+
+  /// Pre-port: `![[options valueForKey:key] isEqual:[NSNull null]]`
+  /// (missing/nil → assign; `NSNull` → skip).
+  private static func shouldAssignOptionalField(_ value: Any?) -> Bool {
+    guard let value else {
+      return true
+    }
+    return !(value as AnyObject).isEqual(NSNull())
+  }
+}

package/ios/RNFBApp/RNFBAppLogLevelMapper.swift

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/**
+ * Log-level string → `FIRLoggerLevel` raw-value mapping previously inline in
+ * `-[RNFBAppModule setLogLevel:]`.
+ *
+ * Mirrors pre-port (`FIRLoggerLevel` raw values from FirebaseCore):
+ * - `"verbose"` / `"debug"` → `FIRLoggerLevelDebug` (7)
+ * - `"info"` → `FIRLoggerLevelInfo` (6)
+ * - `"warn"` → `FIRLoggerLevelWarning` (4)
+ * - else (including nil / unknown) → `FIRLoggerLevelError` (3)
+ */
+@objc(RNFBAppLogLevelMapper)
+public final class RNFBAppLogLevelMapper: NSObject {
+  /// `FIRLoggerLevelError`
+  private static let errorLevel = 3
+  /// `FIRLoggerLevelWarning`
+  private static let warningLevel = 4
+  /// `FIRLoggerLevelInfo`
+  private static let infoLevel = 6
+  /// `FIRLoggerLevelDebug`
+  private static let debugLevel = 7
+
+  @objc(loggerLevelForString:)
+  public static func loggerLevel(forString logLevel: String?) -> Int {
+    switch logLevel {
+    case "verbose", "debug":
+      return debugLevel
+    case "info":
+      return infoLevel
+    case "warn":
+      return warningLevel
+    default:
+      return errorLevel
+    }
+  }
+}