@react-native-firebase/app 26.3.3 → 27.0.0

package/ios/RNFBApp/RNFBRCTEventEmitterCore.swift

@@ -0,0 +1,161 @@
+/**
+ * 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
+
+/// Bridge-present check previously hard-wired to `self.bridge != nil`.
+public typealias RNFBRCTEventEmitterBridgePresent = () -> Bool
+
+/// Bridge emit previously hard-wired to `enqueueJSCall` (unprefixed event name + body).
+public typealias RNFBRCTEventEmitterEmitHandler = (String, Any?) -> Void
+
+/**
+ * Queue / listener state previously inline in `RNFBRCTEventEmitter.m`.
+ *
+ * Mirrors pre-port:
+ * - `isObserving` = `jsReady && jsListenerCount > 0`
+ * - emit when bridge present && observing && listener registered; else queue `{name,body}`
+ * - `notifyJsReady(true)` / `addListener` flush matching queued events via `sendEvent`
+ * - `@synchronized(jsListeners)` / `@synchronized(queuedEvents)` via `objc_sync_*`
+ */
+@objc(RNFBRCTEventEmitterCore)
+public final class RNFBRCTEventEmitterCore: NSObject {
+  @objc public static let eventNameKey = "name"
+  @objc public static let eventBodyKey = "body"
+
+  private var jsReady = false
+  private var jsListenerCount = 0
+  private var jsListeners = NSMutableDictionary()
+  private var queuedEvents = NSMutableArray()
+
+  private let isBridgePresent: RNFBRCTEventEmitterBridgePresent
+  private let emitHandler: RNFBRCTEventEmitterEmitHandler
+
+  @objc(initWithIsBridgePresent:emitHandler:)
+  public init(
+    isBridgePresent: @escaping RNFBRCTEventEmitterBridgePresent,
+    emitHandler: @escaping RNFBRCTEventEmitterEmitHandler
+  ) {
+    self.isBridgePresent = isBridgePresent
+    self.emitHandler = emitHandler
+    super.init()
+  }
+
+  @objc public func invalidate() {
+    jsReady = false
+    queuedEvents = NSMutableArray()
+    jsListeners = NSMutableDictionary()
+    jsListenerCount = 0
+  }
+
+  @objc(notifyJsReady:)
+  public func notifyJsReady(_ ready: Bool) {
+    objc_sync_enter(jsListeners)
+    defer { objc_sync_exit(jsListeners) }
+
+    jsReady = ready
+    if ready {
+      for case let event as NSDictionary in queuedEvents.copy() as! NSArray {
+        let name = event[Self.eventNameKey] as! String
+        let body = event[Self.eventBodyKey]
+        sendEvent(name: name, body: body)
+        objc_sync_enter(queuedEvents)
+        queuedEvents.remove(event)
+        objc_sync_exit(queuedEvents)
+      }
+    }
+  }
+
+  @objc(sendEventWithName:body:)
+  public func sendEvent(name eventName: String, body: Any?) {
+    objc_sync_enter(jsListeners)
+    defer { objc_sync_exit(jsListeners) }
+
+    if isBridgePresent(), isObserving, jsListeners[eventName] != nil {
+      emitHandler(eventName, body)
+    } else {
+      objc_sync_enter(queuedEvents)
+      let entry = NSMutableDictionary()
+      entry[Self.eventNameKey] = eventName
+      entry[Self.eventBodyKey] = body
+      queuedEvents.add(entry)
+      objc_sync_exit(queuedEvents)
+    }
+  }
+
+  @objc(addListener:)
+  public func addListener(_ eventName: String) {
+    objc_sync_enter(jsListeners)
+    defer { objc_sync_exit(jsListeners) }
+
+    jsListenerCount += 1
+
+    if jsListeners[eventName] == nil {
+      jsListeners[eventName] = NSNumber(value: 1)
+    } else {
+      let current = (jsListeners[eventName] as! NSNumber).intValue
+      jsListeners[eventName] = NSNumber(value: current + 1)
+    }
+
+    for case let event as NSDictionary in queuedEvents.copy() as! NSArray {
+      if (event[Self.eventNameKey] as? String) == eventName {
+        let body = event[Self.eventBodyKey]
+        sendEvent(name: eventName, body: body)
+        objc_sync_enter(queuedEvents)
+        queuedEvents.remove(event)
+        objc_sync_exit(queuedEvents)
+      }
+    }
+  }
+
+  @objc(removeListeners:all:)
+  public func removeListeners(_ eventName: String, all: Bool) {
+    objc_sync_enter(jsListeners)
+    defer { objc_sync_exit(jsListeners) }
+
+    if jsListeners[eventName] != nil {
+      let listenersForEvent = (jsListeners[eventName] as! NSNumber).intValue
+
+      if listenersForEvent <= 1 || all {
+        objc_sync_enter(jsListeners)
+        jsListeners.removeObject(forKey: eventName)
+        objc_sync_exit(jsListeners)
+      } else {
+        objc_sync_enter(jsListeners)
+        jsListeners[eventName] = NSNumber(value: listenersForEvent - 1)
+        objc_sync_exit(jsListeners)
+      }
+
+      if all {
+        jsListenerCount -= listenersForEvent
+      } else {
+        jsListenerCount -= 1
+      }
+    }
+  }
+
+  @objc public func getListenersDictionary() -> NSDictionary {
+    let listenersDictionary = NSMutableDictionary()
+    listenersDictionary["listeners"] = NSNumber(value: jsListenerCount)
+    listenersDictionary["queued"] = NSNumber(value: queuedEvents.count)
+    listenersDictionary["events"] = jsListeners.copy()
+    return listenersDictionary
+  }
+
+  private var isObserving: Bool {
+    jsReady && jsListenerCount > 0
+  }
+}

package/ios/RNFBApp/RNFBSharedUtils.h

@@ -18,13 +18,10 @@
 #ifndef RNFBSharedUtils_h
 #define RNFBSharedUtils_h
 
-#if __has_include(<FirebaseCore/FirebaseCore.h>)
-#import <FirebaseCore/FirebaseCore.h>
-#else
-@import FirebaseCore;
-#endif
 #import <React/RCTBridgeModule.h>
 
+@class FIRApp;
+
 #ifdef DEBUG
 #define DLog(fmt, ...) NSLog((@"%s [Line %d] " fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__);
 #else

package/ios/RNFBApp/RNFBSharedUtils.m

@@ -22,145 +22,154 @@
 #import "RNFBPreferences.h"
 #import "RNFBRCTEventEmitter.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
+
 #pragma mark -
 #pragma mark Constants
 
 NSString *const DEFAULT_APP_DISPLAY_NAME = @"[DEFAULT]";
 NSString *const DEFAULT_APP_NAME = @"__FIRAPP_DEFAULT";
 
+/**
+ * Adapts `RNFBMeta` class methods to the instance-based config source protocol used by
+ * `RNFBSharedUtilsConfig`.
+ */
+@interface RNFBConfigMetaSource : NSObject <RNFBConfigBooleanProviding>
+@end
+
+@implementation RNFBConfigMetaSource
+
+- (BOOL)contains:(NSString *)key {
+  return [RNFBMeta contains:key];
+}
+
+- (BOOL)getBooleanValue:(NSString *)key defaultValue:(BOOL)defaultValue {
+  return [RNFBMeta getBooleanValue:key defaultValue:defaultValue];
+}
+
+@end
+
+static id<RNFBConfigBooleanProviding> RNFBSharedUtilsMetaConfigSource(void) {
+  static RNFBConfigMetaSource *sharedSource;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    sharedSource = [[RNFBConfigMetaSource alloc] init];
+  });
+  return sharedSource;
+}
+
+/**
+ * Adapts `RNFBAppModule getCustomDomain:` for `RNFBSharedUtilsFIRApp`.
+ */
+@interface RNFBCustomDomainProvider : NSObject <RNFBCustomDomainProviding>
+@end
+
+@implementation RNFBCustomDomainProvider
+
+- (NSString *)getCustomDomain:(NSString *)appName {
+  return [RNFBAppModule getCustomDomain:appName];
+}
+
+@end
+
+/**
+ * Adapts `RNFBRCTEventEmitter.shared` for `RNFBSharedUtilsFIRApp`.
+ */
+@interface RNFBJSEventSender : NSObject <RNFBJSEventSending>
+@end
+
+@implementation RNFBJSEventSender
+
+- (void)sendEventWithName:(NSString *)name body:(id)body {
+  [[RNFBRCTEventEmitter shared] sendEventWithName:name body:body];
+}
+
+@end
+
+static id<RNFBCustomDomainProviding> RNFBSharedUtilsCustomDomainProvider(void) {
+  static RNFBCustomDomainProvider *sharedProvider;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    sharedProvider = [[RNFBCustomDomainProvider alloc] init];
+  });
+  return sharedProvider;
+}
+
+static id<RNFBJSEventSending> RNFBSharedUtilsJSEventSender(void) {
+  static RNFBJSEventSender *sharedSender;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    sharedSender = [[RNFBJSEventSender alloc] init];
+  });
+  return sharedSender;
+}
+
 @implementation RNFBSharedUtils
-static NSString *const RNFBErrorDomain = @"RNFBErrorDomain";
 
 #pragma mark -
 #pragma mark Methods
 
 + (NSString *)getAppJavaScriptName:(NSString *)appDisplayName {
-  if ([appDisplayName isEqualToString:DEFAULT_APP_NAME]) {
-    return DEFAULT_APP_DISPLAY_NAME;
-  }
-  return appDisplayName;
+  return [RNFBSharedUtilsFormatting getAppJavaScriptName:appDisplayName];
 }
 
 + (NSDictionary *)firAppToDictionary:(FIRApp *)firApp {
-  FIROptions *firOptions = [firApp options];
-  NSMutableDictionary *firAppDictionary = [NSMutableDictionary new];
-  NSMutableDictionary *firAppOptions = [NSMutableDictionary new];
-  NSMutableDictionary *firAppConfig = [NSMutableDictionary new];
-
-  NSString *name = [firApp name];
-  if ([name isEqualToString:DEFAULT_APP_NAME]) {
-    name = DEFAULT_APP_DISPLAY_NAME;
-  }
-
-  firAppConfig[@"name"] = name;
-  firAppConfig[@"automaticDataCollectionEnabled"] = @([firApp isDataCollectionDefaultEnabled]);
-
-  firAppOptions[@"apiKey"] = firOptions.APIKey;
-  firAppOptions[@"appId"] = firOptions.googleAppID;
-  firAppOptions[@"projectId"] = firOptions.projectID;
-  firAppOptions[@"databaseURL"] = firOptions.databaseURL;
-  firAppOptions[@"storageBucket"] = firOptions.storageBucket;
-  firAppOptions[@"messagingSenderId"] = firOptions.GCMSenderID;
-  // missing from android sdk - ios only:
-  firAppOptions[@"clientId"] = firOptions.clientID;
-  // not in FIROptions API but in JS SDK and project config JSON
-  if ([RNFBAppModule getCustomDomain:name] != nil) {
-    firAppOptions[@"authDomain"] = [RNFBAppModule getCustomDomain:name];
-  }
-
-  firAppDictionary[@"options"] = firAppOptions;
-  firAppDictionary[@"appConfig"] = firAppConfig;
-
-  return firAppDictionary;
+  return [RNFBSharedUtilsFIRApp firAppToDictionaryFromFIRApp:firApp
+                                        customDomainProvider:RNFBSharedUtilsCustomDomainProvider()];
 }
 
 + (void)rejectPromiseWithExceptionDict:(RCTPromiseRejectBlock)reject
                              exception:(NSException *)exception {
-  NSMutableDictionary *userInfo = [NSMutableDictionary dictionary];
-
-  [userInfo setValue:@(YES) forKey:@"fatal"];
-  [userInfo setValue:@"unknown" forKey:@"code"];
-  [userInfo setValue:exception.reason forKey:@"message"];
-  [userInfo setValue:exception.name forKey:@"nativeErrorCode"];
-  [userInfo setValue:exception.reason forKey:@"nativeErrorMessage"];
-
-  NSError *error = [NSError errorWithDomain:RNFBErrorDomain code:666 userInfo:userInfo];
-
-  reject(exception.name, exception.reason, error);
+  [RNFBSharedUtilsPromiseRejection rejectPromiseWithException:reject exception:exception];
 }
 
 + (void)rejectPromiseWithNSError:(RCTPromiseRejectBlock)reject error:(NSError *)error {
-  NSMutableDictionary *userInfo = [NSMutableDictionary dictionary];
-
-  [userInfo setValue:@(NO) forKey:@"fatal"];
-  [userInfo setValue:@"unknown" forKey:@"code"];
-  [userInfo setValue:error.localizedDescription forKey:@"message"];
-  [userInfo setValue:@(error.code) forKey:@"nativeErrorCode"];
-  [userInfo setValue:error.localizedDescription forKey:@"nativeErrorMessage"];
-
-  NSError *newErrorWithUserInfo = [NSError errorWithDomain:RNFBErrorDomain
-                                                      code:666
-                                                  userInfo:userInfo];
-  reject(@"unknown", error.localizedDescription, newErrorWithUserInfo);
+  [RNFBSharedUtilsPromiseRejection rejectPromiseWithNSError:reject error:error];
 }
 
 + (void)rejectPromiseWithUserInfo:(RCTPromiseRejectBlock)reject
                          userInfo:(NSMutableDictionary *)userInfo {
-  NSError *error = [NSError errorWithDomain:RNFBErrorDomain code:666 userInfo:userInfo];
-  reject(userInfo[@"code"], userInfo[@"message"], error);
+  [RNFBSharedUtilsPromiseRejection rejectPromiseWithUserInfo:reject userInfo:userInfo];
 }
 
 // for easier v5 migration
 + (void)sendJSEventForApp:(FIRApp *)app name:(NSString *)name body:(NSDictionary *)body {
-  NSMutableDictionary *newBody = [body mutableCopy];
-  newBody[@"appName"] = [self getAppJavaScriptName:app.name];
-  [[RNFBRCTEventEmitter shared] sendEventWithName:name body:newBody];
+  [RNFBSharedUtilsFIRApp sendJSEventForFIRApp:app
+                                         name:name
+                                         body:body
+                                  eventSender:RNFBSharedUtilsJSEventSender()];
 }
 
 + (NSString *)getISO8601String:(NSDate *)date {
-  static NSDateFormatter *formatter = nil;
-
-  if (!formatter) {
-    formatter = [[NSDateFormatter alloc] init];
-    [formatter setLocale:[NSLocale localeWithLocaleIdentifier:@"en_US_POSIX"]];
-    formatter.timeZone = [NSTimeZone timeZoneWithAbbreviation:@"UTC"];
-    [formatter setDateFormat:@"yyyy-MM-dd'T'HH:mm:ss"];
-  }
-
-  NSString *iso8601String = [formatter stringFromDate:date];
-
-  return [iso8601String stringByAppendingString:@"Z"];
+  return [RNFBSharedUtilsFormatting getISO8601String:date];
 }
 
 + (BOOL)configContains:(NSString *)key {
-  return [[RNFBPreferences shared] contains:key] || [[RNFBJSON shared] contains:key] ||
-         [RNFBMeta contains:key];
+  return [RNFBSharedUtilsConfig
+      configContainsKey:key
+            preferences:(id<RNFBConfigBooleanProviding>)[RNFBPreferences shared]
+                   json:(id<RNFBConfigBooleanProviding>)[RNFBJSON shared]
+                   meta:RNFBSharedUtilsMetaConfigSource()];
 }
 
 + (BOOL)getConfigBooleanValue:(NSString *)tag key:(NSString *)key defaultValue:(BOOL)defaultValue {
-  BOOL enabled;
-
-  if ([[RNFBPreferences shared] contains:key]) {
-    enabled = [[RNFBPreferences shared] getBooleanValue:key defaultValue:defaultValue];
-    DLog(@"%@ %@ via "
-         @"RNFBPreferences: %d",
-         tag, key, enabled);
-  } else if ([[RNFBJSON shared] contains:key]) {
-    enabled = [[RNFBJSON shared] getBooleanValue:key defaultValue:defaultValue];
-    DLog(@"%@ %@ via "
-         @"RNFBJSON: %d",
-         tag, key, enabled);
-  } else {
-    // Note that if we're here, and the key is not set on the app's bundle, our final default is the
-    // one passed in
-    enabled = [RNFBMeta getBooleanValue:key defaultValue:defaultValue];
-    DLog(@"%@ %@ via "
-         @"RNFBMeta: %d",
-         tag, key, enabled);
-  }
-
+  BOOL enabled = [RNFBSharedUtilsConfig
+      getConfigBooleanValueForKey:key
+                     defaultValue:defaultValue
+                      preferences:(id<RNFBConfigBooleanProviding>)[RNFBPreferences shared]
+                             json:(id<RNFBConfigBooleanProviding>)[RNFBJSON shared]
+                             meta:RNFBSharedUtilsMetaConfigSource()];
+  // Branch-specific "via Preferences/JSON/Meta" DLogs lived in the pre-port body; keep the
+  // final-value log on the ObjC façade (DLog is an ObjC macro; return value unchanged).
   DLog(@"%@ %@ final value: %d", tag, key, enabled);
-
   return enabled;
 }
 
@@ -182,104 +191,7 @@ static NSString *const RNFBErrorDomain = @"RNFBErrorDomain";
  * @return The decoded value with sentinels replaced by NSNull
  */
 + (id)decodeNullSentinels:(id)value {
-  // Non-container values are returned as-is
-  if (![value isKindOfClass:[NSDictionary class]] && ![value isKindOfClass:[NSArray class]]) {
-    return value;
-  }
-
-  // Helper to detect the sentinel
-  BOOL (^isNullSentinel)(NSDictionary *) = ^BOOL(NSDictionary *dict) {
-    id flag = dict[@"__rnfbNull"];
-    return (dict.count == 1 && flag != nil && [flag boolValue]);
-  };
-
-  // Helper to process a child element and add it to the parent container
-  void (^processChild)(id, id, id, BOOL, NSMutableArray *) =
-      ^void(id child, id parentMutable, id keyOrNil, BOOL isParentDict, NSMutableArray *stack) {
-        id processedValue = nil;
-
-        if ([child isKindOfClass:[NSDictionary class]]) {
-          NSDictionary *childDict = (NSDictionary *)child;
-
-          if (isNullSentinel(childDict)) {
-            // Replace sentinel with NSNull
-            processedValue = [NSNull null];
-          } else {
-            // Process nested dictionary
-            NSMutableDictionary *childMut =
-                [NSMutableDictionary dictionaryWithCapacity:childDict.count];
-            processedValue = childMut;
-            [stack addObject:@{@"original" : childDict, @"mutable" : childMut}];
-          }
-        } else if ([child isKindOfClass:[NSArray class]]) {
-          // Process nested array
-          NSArray *childArray = (NSArray *)child;
-          NSMutableArray *childMut = [NSMutableArray arrayWithCapacity:childArray.count];
-          processedValue = childMut;
-          [stack addObject:@{@"original" : childArray, @"mutable" : childMut}];
-        } else {
-          // Preserve primitive values
-          processedValue = child ?: [NSNull null];
-        }
-
-        // Add to parent container based on type
-        if (isParentDict) {
-          NSMutableDictionary *mutDict = (NSMutableDictionary *)parentMutable;
-          if (processedValue) {
-            mutDict[keyOrNil] = processedValue;
-          }
-          // NSDictionary can't store nil, and original code wouldn't see nil values either.
-        } else {
-          NSMutableArray *mutArray = (NSMutableArray *)parentMutable;
-          [mutArray addObject:processedValue];
-        }
-      };
-
-  // Root-level sentinel case
-  if ([value isKindOfClass:[NSDictionary class]] && isNullSentinel((NSDictionary *)value)) {
-    return [NSNull null];
-  }
-
-  id rootOriginal = value;
-  id rootMutable = nil;
-
-  if ([value isKindOfClass:[NSDictionary class]]) {
-    NSDictionary *dict = (NSDictionary *)value;
-    rootMutable = [NSMutableDictionary dictionaryWithCapacity:dict.count];
-  } else {
-    NSArray *array = (NSArray *)value;
-    rootMutable = [NSMutableArray arrayWithCapacity:array.count];
-  }
-
-  // Stack-based iteration to process nested structures without recursion
-  // Stack frames: { @"original": container, @"mutable": mutableContainer }
-  NSMutableArray<NSDictionary *> *stack = [NSMutableArray array];
-  [stack addObject:@{@"original" : rootOriginal, @"mutable" : rootMutable}];
-
-  while (stack.count > 0) {
-    NSDictionary *frame = [stack lastObject];
-    [stack removeLastObject];
-
-    id original = frame[@"original"];
-    id mutable = frame[@"mutable"];
-
-    if ([original isKindOfClass:[NSDictionary class]]) {
-      NSDictionary *origDict = (NSDictionary *)original;
-
-      for (id key in origDict) {
-        id child = origDict[key];
-        processChild(child, mutable, key, YES, stack);
-      }
-    } else if ([original isKindOfClass:[NSArray class]]) {
-      NSArray *origArray = (NSArray *)original;
-
-      for (id child in origArray) {
-        processChild(child, mutable, nil, NO, stack);
-      }
-    }
-  }
-
-  return rootMutable;
+  return [RNFBNullSentinelDecoder decodeNullSentinels:value];
 }
 
 @end

package/ios/RNFBApp/RNFBSharedUtilsConfig.swift

@@ -0,0 +1,72 @@
+/**
+ * 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
+
+/**
+ * Boolean config source used by the SharedUtils config waterfall.
+ *
+ * Production passes `RNFBPreferences` / `RNFBJSON` instances and a Meta adapter;
+ * unit tests inject recording stubs to assert precedence and `||` short-circuit.
+ */
+@objc public protocol RNFBConfigBooleanProviding: AnyObject {
+  @objc(contains:)
+  func contains(_ key: String) -> Bool
+
+  @objc(getBooleanValue:defaultValue:)
+  func getBooleanValue(_ key: String, defaultValue: Bool) -> Bool
+}
+
+/**
+ * Config waterfall previously inline in `RNFBSharedUtils.m`.
+ *
+ * Mirrors pre-port:
+ * - `configContains` is Preferences.contains || JSON.contains || Meta.contains
+ *   (left-to-right short-circuit, same as ObjC `||`)
+ * - `getConfigBooleanValue` prefers Preferences if contains, else JSON if contains,
+ *   else Meta (Meta path always used as final, with the passed-in `defaultValue`)
+ */
+@objc(RNFBSharedUtilsConfig)
+public final class RNFBSharedUtilsConfig: NSObject {
+  @objc(configContainsKey:preferences:json:meta:)
+  public static func configContains(
+    _ key: String,
+    preferences: RNFBConfigBooleanProviding,
+    json: RNFBConfigBooleanProviding,
+    meta: RNFBConfigBooleanProviding
+  ) -> Bool {
+    preferences.contains(key) || json.contains(key) || meta.contains(key)
+  }
+
+  @objc(getConfigBooleanValueForKey:defaultValue:preferences:json:meta:)
+  public static func getConfigBooleanValue(
+    forKey key: String,
+    defaultValue: Bool,
+    preferences: RNFBConfigBooleanProviding,
+    json: RNFBConfigBooleanProviding,
+    meta: RNFBConfigBooleanProviding
+  ) -> Bool {
+    if preferences.contains(key) {
+      return preferences.getBooleanValue(key, defaultValue: defaultValue)
+    }
+    if json.contains(key) {
+      return json.getBooleanValue(key, defaultValue: defaultValue)
+    }
+    // Note that if we're here, and the key is not set on the app's bundle, our final
+    // default is the one passed in (pre-port Meta path behaviour).
+    return meta.getBooleanValue(key, defaultValue: defaultValue)
+  }
+}