@react-native-firebase/app 23.8.0 → 23.8.2

package/ios/RNFBApp/RNFBPreferences.m

@@ -0,0 +1,94 @@
+/**
+ * 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 "RNFBPreferences.h"
+
+@interface RNFBPreferences ()
+@property(nonatomic, strong) NSUserDefaults *userDefaults;
+@end
+
+static NSString *const RNFBDomainIdentifier = @"io.invertase.firebase";
+
+@implementation RNFBPreferences
+
+static RNFBPreferences *sharedInstance;
+
++ (void)load {
+  sharedInstance = [[RNFBPreferences alloc] init];
+}
+
+- (instancetype)init {
+  self = [super init];
+
+  if (self) {
+    _userDefaults = [[NSUserDefaults alloc] initWithSuiteName:RNFBDomainIdentifier];
+  }
+
+  return self;
+}
+
+- (BOOL)contains:(NSString *)key {
+  return [_userDefaults objectForKey:key] != nil;
+}
+
+- (BOOL)getBooleanValue:(NSString *)key defaultValue:(BOOL)defaultValue {
+  if ([_userDefaults objectForKey:key] == nil) return defaultValue;
+  return [_userDefaults boolForKey:key];
+}
+
+- (void)setBooleanValue:(NSString *)key boolValue:(BOOL)boolValue {
+  [_userDefaults setBool:boolValue forKey:key];
+  [_userDefaults synchronize];
+}
+
+- (void)setIntegerValue:(NSString *)key integerValue:(NSInteger)integerValue {
+  [_userDefaults setInteger:(NSInteger)integerValue forKey:key];
+  [_userDefaults synchronize];
+}
+
+- (NSInteger)getIntegerValue:(NSString *)key defaultValue:(NSInteger)defaultValue {
+  if ([_userDefaults objectForKey:key] == nil) return defaultValue;
+  return [_userDefaults integerForKey:key];
+}
+
+- (NSString *)getStringValue:(NSString *)key defaultValue:(NSString *)defaultValue {
+  if ([_userDefaults objectForKey:key] == nil) return defaultValue;
+  return [_userDefaults stringForKey:key];
+}
+
+- (void)setStringValue:(NSString *)key stringValue:(NSString *)stringValue {
+  [_userDefaults setValue:stringValue forKey:key];
+  [_userDefaults synchronize];
+}
+
+- (NSDictionary *)getAll {
+  return [_userDefaults dictionaryRepresentation];
+}
+
+- (void)clearAll {
+  [_userDefaults removePersistentDomainForName:RNFBDomainIdentifier];
+}
+
+- (void)remove:(NSString *)key {
+  [_userDefaults removeObjectForKey:key];
+}
+
++ (RNFBPreferences *)shared {
+  return sharedInstance;
+}
+
+@end

package/ios/RNFBApp/RNFBRCTEventEmitter.h

@@ -0,0 +1,73 @@
+/**
+ * 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/Foundation.h>
+#import <React/RCTEventEmitter.h>
+
+/**
+ * Listeners for Firebase events and emits them to the JS layer
+ */
+@interface RNFBRCTEventEmitter : NSObject
+
+/**
+ * The RCTBridge. Assigned by `RNFBAppModule`
+ */
+@property(nonatomic, weak) RCTBridge *bridge;
+
+/**
+ * Returns the shared instance
+ *
+ * @returns RNFBRCTEventEmitter.
+ */
++ (RNFBRCTEventEmitter *)shared;
+
+/**
+ * Invalidate
+ */
+- (void)invalidate;
+
+/**
+ * Add an event listener
+ *
+ * @param eventName NSString event name.
+ */
+- (void)addListener:(NSString *)eventName;
+
+/**
+ * Removes event listeners
+ */
+- (void)removeListeners:(NSString *)eventName all:(BOOL)all;
+
+/**
+ * Send an event to JS with the specified name and body
+ *
+ */
+- (void)sendEventWithName:(NSString *)eventName body:(id)body;
+
+/**
+ * Notify the event emitter that JS has loaded and is ready to receive events.
+ *
+ */
+- (void)notifyJsReady:(BOOL)ready;
+
+/**
+ * Returns a dictionary of all registered events & counts. Mainly for testing.
+ *
+ * @return NSDictionary
+ */
+- (NSDictionary *)getListenersDictionary;
+@end

package/ios/RNFBApp/RNFBRCTEventEmitter.m

@@ -0,0 +1,151 @@
+/**
+ * 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 "RNFBRCTEventEmitter.h"
+
+@interface RNFBRCTEventEmitter ()
+@property(atomic, assign) BOOL jsReady;
+@property(atomic, assign) NSInteger jsListenerCount;
+@property(nonatomic, strong) NSMutableDictionary *jsListeners;
+@property(nonatomic, strong) NSMutableArray *queuedEvents;
+@property(readonly) BOOL isObserving;
+@end
+
+NSString *const RNFBRCTEventNameKey = @"name";
+NSString *const RNFBRCTEventBodyKey = @"body";
+
+@implementation RNFBRCTEventEmitter
+
+- (void)invalidate {
+  self.jsReady = FALSE;
+  self.queuedEvents = [NSMutableArray array];
+  self.jsListeners = [NSMutableDictionary dictionary];
+  self.jsListenerCount = 0;
+}
+
++ (instancetype)shared {
+  static dispatch_once_t once;
+  static RNFBRCTEventEmitter *sharedInstance;
+  dispatch_once(&once, ^{
+    sharedInstance = [[RNFBRCTEventEmitter alloc] init];
+  });
+  return sharedInstance;
+}
+
+- (instancetype)init {
+  self = [super init];
+
+  if (self) {
+    self.jsReady = FALSE;
+    self.queuedEvents = [NSMutableArray array];
+    self.jsListeners = [NSMutableDictionary dictionary];
+  }
+
+  return self;
+}
+
+- (void)notifyJsReady:(BOOL)jsReady {
+  @synchronized(self.jsListeners) {
+    self.jsReady = jsReady;
+    if (jsReady) {
+      for (id event in [self.queuedEvents copy]) {
+        [self sendEventWithName:event[RNFBRCTEventNameKey] body:event[RNFBRCTEventBodyKey]];
+        @synchronized(self.queuedEvents) {
+          [self.queuedEvents removeObject:event];
+        }
+      }
+    }
+  }
+}
+
+- (void)sendEventWithName:(NSString *)eventName body:(id)body {
+  @synchronized(self.jsListeners) {
+    if (self.bridge && self.isObserving && self.jsListeners[eventName] != nil) {
+      NSString *prefixedEventName = [@"rnfb_" stringByAppendingString:eventName];
+      [self.bridge enqueueJSCall:@"RCTDeviceEventEmitter"
+                          method:@"emit"
+                            args:body ? @[ prefixedEventName, body ] : @[ prefixedEventName ]
+                      completion:NULL];
+    } else {
+      @synchronized(self.queuedEvents) {
+        [self.queuedEvents
+            addObject:@{RNFBRCTEventNameKey : eventName, RNFBRCTEventBodyKey : body}];
+      }
+    }
+  }
+}
+
+- (void)addListener:(NSString *)eventName {
+  @synchronized(self.jsListeners) {
+    self.jsListenerCount++;
+
+    if (self.jsListeners[eventName] == nil) {
+      self.jsListeners[eventName] = @([@1 integerValue]);
+    } else {
+      self.jsListeners[eventName] =
+          @([self.jsListeners[eventName] integerValue] + [@1 integerValue]);
+    }
+
+    for (id event in [self.queuedEvents copy]) {
+      if ([event[RNFBRCTEventNameKey] isEqualToString:eventName]) {
+        [self sendEventWithName:event[RNFBRCTEventNameKey] body:event[RNFBRCTEventBodyKey]];
+        @synchronized(self.queuedEvents) {
+          [self.queuedEvents removeObject:event];
+        }
+      }
+    }
+  }
+}
+
+- (void)removeListeners:(NSString *)eventName all:(BOOL)all {
+  @synchronized(self.jsListeners) {
+    if (self.jsListeners[eventName] != nil) {
+      NSInteger listenersForEvent = [self.jsListeners[eventName] integerValue];
+
+      if (listenersForEvent <= 1 || all) {
+        @synchronized(self.jsListeners) {
+          [self.jsListeners removeObjectForKey:eventName];
+        }
+      } else {
+        @synchronized(self.jsListeners) {
+          self.jsListeners[eventName] =
+              @([self.jsListeners[eventName] integerValue] - [@1 integerValue]);
+        }
+      }
+
+      if (all) {
+        self.jsListenerCount = self.jsListenerCount - listenersForEvent;
+      } else {
+        self.jsListenerCount = self.jsListenerCount - [@1 integerValue];
+      }
+    }
+  }
+}
+
+- (NSDictionary *)getListenersDictionary {
+  NSMutableDictionary *listenersDictionary = [NSMutableDictionary new];
+  listenersDictionary[@"listeners"] = @(self.jsListenerCount);
+  listenersDictionary[@"queued"] = @([self.queuedEvents count]);
+  listenersDictionary[@"events"] = [self.jsListeners copy];
+  return listenersDictionary;
+}
+
+- (BOOL)isObserving {
+  return self.jsReady && self.jsListenerCount > 0;
+}
+
+@end

package/ios/RNFBApp/RNFBSharedUtils.h

@@ -0,0 +1,67 @@
+/**
+ * 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.
+ *
+ */
+
+#ifndef RNFBSharedUtils_h
+#define RNFBSharedUtils_h
+
+#import <FirebaseCore/FirebaseCore.h>
+#import <React/RCTBridgeModule.h>
+
+#ifdef DEBUG
+#define DLog(fmt, ...) NSLog((@"%s [Line %d] " fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__);
+#else
+#define DLog(...)
+#endif
+
+#define ELog(fmt, ...) NSLog((@"%s [Line %d] " fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__);
+
+#pragma mark -
+#pragma mark Constants
+
+extern NSString *const DEFAULT_APP_DISPLAY_NAME;
+extern NSString *const DEFAULT_APP_NAME;
+
+@interface RNFBSharedUtils : NSObject
+
+#pragma mark -
+#pragma mark Methods
+
++ (NSString *)getAppJavaScriptName:(NSString *)appDisplayName;
+
++ (NSDictionary *)firAppToDictionary:(FIRApp *)firApp;
+
++ (void)sendJSEventForApp:(FIRApp *)app name:(NSString *)name body:(NSDictionary *)body;
+
++ (void)rejectPromiseWithExceptionDict:(RCTPromiseRejectBlock)reject
+                             exception:(NSException *)exception;
+
++ (void)rejectPromiseWithNSError:(RCTPromiseRejectBlock)reject error:(NSError *)error;
+
++ (void)rejectPromiseWithUserInfo:(RCTPromiseRejectBlock)reject
+                         userInfo:(NSMutableDictionary *)userInfo;
+
++ (NSString *)getISO8601String:(NSDate *)date;
+
++ (BOOL)configContains:(NSString *)key;
+
++ (BOOL)getConfigBooleanValue:(NSString *)tag key:(NSString *)key defaultValue:(BOOL)defaultValue;
+
++ (id)decodeNullSentinels:(id)value;
+
+@end
+
+#endif

package/ios/RNFBApp/RNFBSharedUtils.m

@@ -0,0 +1,285 @@
+/**
+ * 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 "RNFBSharedUtils.h"
+#import "RNFBAppModule.h"
+#import "RNFBJSON.h"
+#import "RNFBMeta.h"
+#import "RNFBPreferences.h"
+#import "RNFBRCTEventEmitter.h"
+
+#pragma mark -
+#pragma mark Constants
+
+NSString *const DEFAULT_APP_DISPLAY_NAME = @"[DEFAULT]";
+NSString *const DEFAULT_APP_NAME = @"__FIRAPP_DEFAULT";
+
+@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;
+}
+
++ (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;
+}
+
++ (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);
+}
+
++ (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);
+}
+
++ (void)rejectPromiseWithUserInfo:(RCTPromiseRejectBlock)reject
+                         userInfo:(NSMutableDictionary *)userInfo {
+  NSError *error = [NSError errorWithDomain:RNFBErrorDomain code:666 userInfo:userInfo];
+  reject(userInfo[@"code"], userInfo[@"message"], error);
+}
+
+// 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];
+}
+
++ (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"];
+}
+
++ (BOOL)configContains:(NSString *)key {
+  return [[RNFBPreferences shared] contains:key] || [[RNFBJSON shared] contains:key] ||
+         [RNFBMeta contains:key];
+}
+
++ (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);
+  }
+
+  DLog(@"%@ %@ final value: %d", tag, key, enabled);
+
+  return enabled;
+}
+
+/**
+ * Decodes null sentinel objects back to NSNull values.
+ * Uses iterative stack-based traversal to avoid stack overflow on deeply nested structures.
+ *
+ * This reverses the encoding done on the JavaScript side where null values in object
+ * properties are replaced with {__rnfbNull: true} sentinel objects to survive iOS
+ * TurboModule serialization.
+ *
+ * Process:
+ * 1. Detects sentinel objects: dictionaries with single key "__rnfbNull" set to true
+ * 2. Replaces sentinels with NSNull in object properties and arrays
+ * 3. Preserves regular NSNull values that were in arrays (never encoded as sentinels)
+ * 4. Deep processes all nested objects and arrays using a stack-based iteration
+ *
+ * @param value - The value to decode (dictionary, array, or primitive)
+ * @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;
+}
+
+@end

package/ios/RNFBApp/RNFBUtilsModule.h

@@ -0,0 +1,30 @@
+/**
+ * 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/Foundation.h>
+#import <Photos/Photos.h>
+
+#import <React/RCTBridgeModule.h>
+
+@interface RNFBUtilsModule : NSObject <RCTBridgeModule>
+
++ (BOOL)isRemoteAsset:(NSString *)localFilePath;
++ (BOOL)unused_isHeic:(NSString *)localFilePath;
++ (NSString *)valueForKey:(NSString *)key fromQueryItems:(NSArray *)queryItems;
++ (PHAsset *)fetchAssetForPath:(NSString *)localFilePath;
+
+@end