@react-native-firebase/app 23.8.0 → 23.8.1

package/ios/RNFBApp/RNFBAppModule.m

@@ -0,0 +1,305 @@
+/**
+ * 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 <Firebase/Firebase.h>
+#import <React/RCTUtils.h>
+
+#import "RNFBAppModule.h"
+#import "RNFBJSON.h"
+#import "RNFBMeta.h"
+#import "RNFBPreferences.h"
+#import "RNFBRCTEventEmitter.h"
+#import "RNFBSharedUtils.h"
+#import "RNFBVersion.h"
+
+#if __has_include(<FirebaseCore/FIRAppInternal.h>)
+#import <FirebaseCore/FIRAppInternal.h>
+#define REGISTER_LIB
+#endif
+
+@implementation RNFBAppModule
+
+#pragma mark -
+#pragma mark Module Setup
+
+RCT_EXPORT_MODULE();
+
+- (dispatch_queue_t)methodQueue {
+  return dispatch_get_main_queue();
+}
+
+- (void)setBridge:(RCTBridge *)bridge {
+  [RNFBRCTEventEmitter shared].bridge = bridge;
+}
+
+- (RCTBridge *)bridge {
+  return [RNFBRCTEventEmitter shared].bridge;
+}
+
+- (id)init {
+  if (self = [super init]) {
+#ifdef REGISTER_LIB
+    static dispatch_once_t once;
+    dispatch_once(&once, ^{
+      [FIRApp registerLibrary:@"react-native-firebase" withVersion:[RNFBVersionString copy]];
+    });
+#endif
+    if ([[RNFBJSON shared] contains:@"app_log_level"]) {
+      NSString *logLevel = [[RNFBJSON shared] getStringValue:@"app_log_level" defaultValue:@"info"];
+      [self setLogLevel:logLevel];
+    }
+  }
+
+  return self;
+}
+
+- (void)invalidate {
+  [[RNFBRCTEventEmitter shared] invalidate];
+}
+
+#pragma mark -
+#pragma mark META Methods
+
+RCT_EXPORT_METHOD(metaGetAll
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  resolve([RNFBMeta getAll]);
+}
+
+#pragma mark -
+#pragma mark JSON Methods
+
+RCT_EXPORT_METHOD(jsonGetAll
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  resolve([[RNFBJSON shared] getAll]);
+}
+
+#pragma mark -
+#pragma mark Preference Methods
+
+RCT_EXPORT_METHOD(preferencesSetBool
+                  : (NSString *)key boolValue
+                  : (BOOL)boolValue resolver
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  [[RNFBPreferences shared] setBooleanValue:key boolValue:boolValue];
+  resolve([NSNull null]);
+}
+
+RCT_EXPORT_METHOD(preferencesSetString
+                  : (NSString *)key stringValue
+                  : (NSString *)stringValue resolver
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  [[RNFBPreferences shared] setStringValue:key stringValue:stringValue];
+  resolve([NSNull null]);
+}
+
+RCT_EXPORT_METHOD(preferencesGetAll
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  resolve([[RNFBPreferences shared] getAll]);
+}
+
+RCT_EXPORT_METHOD(preferencesClearAll
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  [[RNFBPreferences shared] clearAll];
+  resolve([NSNull null]);
+}
+
+#pragma mark -
+#pragma mark Event Methods
+
+RCT_EXPORT_METHOD(eventsNotifyReady : (BOOL)ready) {
+  [[RNFBRCTEventEmitter shared] notifyJsReady:ready];
+}
+
+RCT_EXPORT_METHOD(eventsGetListeners
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  resolve([[RNFBRCTEventEmitter shared] getListenersDictionary]);
+}
+
+RCT_EXPORT_METHOD(eventsPing
+                  : (NSString *)eventName eventBody
+                  : (NSDictionary *)eventBody resolver
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  [[RNFBRCTEventEmitter shared] sendEventWithName:eventName body:eventBody];
+  resolve(eventBody);
+}
+
+RCT_EXPORT_METHOD(eventsAddListener : (NSString *)eventName) {
+  [[RNFBRCTEventEmitter shared] addListener:eventName];
+}
+
+RCT_EXPORT_METHOD(eventsRemoveListener : (NSString *)eventName all : (BOOL)all) {
+  [[RNFBRCTEventEmitter shared] removeListeners:eventName all:all];
+}
+
+#pragma mark -
+#pragma mark Events Unused
+
+RCT_EXPORT_METHOD(addListener : (NSString *)eventName) {
+  // Keep: Required for RN built in Event Emitter Calls.
+}
+
+RCT_EXPORT_METHOD(removeListeners : (NSInteger)count) {
+  // Keep: Required for RN built in Event Emitter Calls.
+}
+
+#pragma mark -
+#pragma mark Firebase App Methods
+
+RCT_EXPORT_METHOD(initializeApp
+                  : (NSDictionary *)options appConfig
+                  : (NSDictionary *)appConfig resolver
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  RCTUnsafeExecuteOnMainQueueSync(^{
+    FIRApp *firApp;
+    NSString *appName = [appConfig valueForKey:@"name"];
+
+    NSString *appId = [options valueForKey:@"appId"];
+    NSString *messagingSenderId = [options valueForKey:@"messagingSenderId"];
+    FIROptions *firOptions = [[FIROptions alloc] initWithGoogleAppID:appId
+                                                         GCMSenderID:messagingSenderId];
+    firOptions.APIKey = [options valueForKey:@"apiKey"];
+    firOptions.projectID = [options valueForKey:@"projectId"];
+    // kFirebaseOptionsDatabaseUrl
+    if (![[options valueForKey:@"databaseURL"] isEqual:[NSNull null]]) {
+      firOptions.databaseURL = [options valueForKey:@"databaseURL"];
+    }
+    // kFirebaseOptionsStorageBucket
+    if (![[options valueForKey:@"storageBucket"] isEqual:[NSNull null]]) {
+      firOptions.storageBucket = [options valueForKey:@"storageBucket"];
+    }
+
+    // kFirebaseOptionsIosBundleId
+    if (![[options valueForKey:@"iosBundleId"] isEqual:[NSNull null]]) {
+      firOptions.bundleID = [options valueForKey:@"iosBundleId"];
+    }
+    // kFirebaseOptionsIosClientId
+    if (![[options valueForKey:@"iosClientId"] isEqual:[NSNull null]]) {
+      firOptions.clientID = [options valueForKey:@"iosClientId"];
+    }
+    // kFirebaseOptionsAppGroupId
+    if (![[options valueForKey:@"appGroupId"] isEqual:[NSNull null]]) {
+      firOptions.appGroupID = [options valueForKey:@"appGroupId"];
+    }
+
+    if ([options valueForKey:@"authDomain"] != nil) {
+      DLog(@"RNFBAuth app: %@ customAuthDomain: %@", appName, [options valueForKey:@"authDomain"]);
+      if (customAuthDomains == nil) {
+        customAuthDomains = [[NSMutableDictionary alloc] init];
+      }
+      customAuthDomains[appName] = [options valueForKey:@"authDomain"];
+    }
+    @try {
+      if (!appName || [appName isEqualToString:DEFAULT_APP_DISPLAY_NAME]) {
+        [FIRApp configureWithOptions:firOptions];
+        firApp = [FIRApp defaultApp];
+      } else {
+        [FIRApp configureWithName:appName options:firOptions];
+        firApp = [FIRApp appNamed:appName];
+      }
+    } @catch (NSException *exception) {
+      return [RNFBSharedUtils rejectPromiseWithExceptionDict:reject exception:exception];
+    }
+
+    firApp.dataCollectionDefaultEnabled =
+        (BOOL)[appConfig valueForKey:@"automaticDataCollectionEnabled"];
+
+    resolve([RNFBSharedUtils firAppToDictionary:firApp]);
+  });
+}
+
+static NSMutableDictionary<NSString *, NSString *> *customAuthDomains;
+
++ (NSString *)getCustomDomain:(NSString *)appName {
+  DLog(@"authDomains: %@", customAuthDomains);
+  return customAuthDomains[appName];
+}
+
+RCT_EXPORT_METHOD(setLogLevel : (NSString *)logLevel) {
+  int level = FIRLoggerLevelError;
+  if ([logLevel isEqualToString:@"verbose"]) {
+    level = FIRLoggerLevelDebug;
+  } else if ([logLevel isEqualToString:@"debug"]) {
+    level = FIRLoggerLevelDebug;
+  } else if ([logLevel isEqualToString:@"info"]) {
+    level = FIRLoggerLevelInfo;
+  } else if ([logLevel isEqualToString:@"warn"]) {
+    level = FIRLoggerLevelWarning;
+  }
+  DLog(@"RNFBSetLogLevel: setting level to %d from %@.", level, logLevel);
+  [[FIRConfiguration sharedInstance] setLoggerLevel:level];
+}
+
+RCT_EXPORT_METHOD(setAutomaticDataCollectionEnabled : (FIRApp *)firApp enabled : (BOOL)enabled) {
+  if (firApp) {
+    firApp.dataCollectionDefaultEnabled = enabled;
+  }
+}
+
+RCT_EXPORT_METHOD(deleteApp
+                  : (FIRApp *)firApp resolver
+                  : (RCTPromiseResolveBlock)resolve rejecter
+                  : (RCTPromiseRejectBlock)reject) {
+  if (!firApp) {
+    return resolve([NSNull null]);
+  }
+
+  [firApp deleteApp:^(BOOL success) {
+    if (success) {
+      resolve([NSNull null]);
+    } else {
+      // try again once more
+      [firApp deleteApp:^(BOOL success2) {
+        if (success2) {
+          resolve([NSNull null]);
+        } else {
+          // TODO js error builder
+          reject(@"app/delete-app-failed", @"Failed to delete the specified app.", nil);
+        }
+      }];
+    }
+  }];
+}
+
+- (NSDictionary *)constantsToExport {
+  NSDictionary *firApps = [FIRApp allApps];
+  NSMutableArray *appsArray = [NSMutableArray new];
+  NSMutableDictionary *constants = [NSMutableDictionary new];
+
+  for (id key in firApps) {
+    [appsArray addObject:[RNFBSharedUtils firAppToDictionary:firApps[key]]];
+  }
+
+  constants[@"NATIVE_FIREBASE_APPS"] = appsArray;
+
+  constants[@"FIREBASE_RAW_JSON"] = [[RNFBJSON shared] getRawJSON];
+
+  return constants;
+}
+
++ (BOOL)requiresMainQueueSetup {
+  return YES;
+}
+@end

package/ios/RNFBApp/RNFBJSON.h

@@ -0,0 +1,36 @@
+/**
+ * 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>
+
+@interface RNFBJSON : NSObject
+
+- (BOOL)contains:(NSString *)key;
+
+- (BOOL)getBooleanValue:(NSString *)key defaultValue:(BOOL)defaultValue;
+
+- (NSString *)getStringValue:(NSString *)key defaultValue:(NSString *)defaultValue;
+
+- (NSArray *)getArrayValue:(NSString *)key defaultValue:(NSArray *)defaultValue;
+
+- (NSDictionary *)getAll;
+
+- (NSString *)getRawJSON;
+
++ (RNFBJSON *)shared;
+
+@end

package/ios/RNFBApp/RNFBJSON.m

@@ -0,0 +1,99 @@
+/**
+ * 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 "RNFBJSON.h"
+
+@interface RNFBJSON ()
+@property(nonatomic, strong) NSDictionary *firebaseJson;
+@end
+
+@implementation RNFBJSON
+
++ (instancetype)shared {
+  static dispatch_once_t once;
+  static RNFBJSON *sharedInstance;
+
+  dispatch_once(&once, ^{
+    sharedInstance = [[RNFBJSON alloc] init];
+    NSString *__nullable firebaseJsonRaw =
+        [[NSBundle mainBundle].infoDictionary valueForKey:@"firebase_json_raw"];
+
+    if (firebaseJsonRaw == nil) {
+      sharedInstance.firebaseJson = [NSDictionary dictionary];
+      return;
+    }
+
+    NSData *data = [[NSData alloc] initWithBase64EncodedString:firebaseJsonRaw options:0];
+
+    if (data == nil) {
+      sharedInstance.firebaseJson = [NSDictionary dictionary];
+      return;
+    }
+
+    NSError *jsonError = nil;
+    NSDictionary *dictionary = [NSJSONSerialization JSONObjectWithData:data
+                                                               options:0
+                                                                 error:&jsonError];
+    if (jsonError != nil) {
+      sharedInstance.firebaseJson = [NSDictionary dictionary];
+      return;
+    }
+
+    sharedInstance.firebaseJson = dictionary;
+  });
+
+  return sharedInstance;
+}
+
+- (BOOL)contains:(NSString *)key {
+  return [_firebaseJson valueForKey:key] != nil;
+}
+
+- (BOOL)getBooleanValue:(NSString *)key defaultValue:(BOOL)defaultValue {
+  if ([_firebaseJson valueForKey:key] == nil) return defaultValue;
+  NSNumber *boolean = [_firebaseJson valueForKey:key];
+  return [boolean boolValue];
+}
+
+- (NSString *)getStringValue:(NSString *)key defaultValue:(NSString *)defaultValue {
+  if ([_firebaseJson valueForKey:key] == nil) return defaultValue;
+  NSString *string = [_firebaseJson valueForKey:key];
+  return string;
+}
+
+- (NSArray *)getArrayValue:(NSString *)key defaultValue:(NSArray *)defaultValue {
+  if ([_firebaseJson valueForKey:key] == nil) return defaultValue;
+  NSArray *array = [_firebaseJson valueForKey:key];
+  return array;
+}
+
+- (NSDictionary *)getAll {
+  return [[NSDictionary alloc] initWithDictionary:_firebaseJson copyItems:YES];
+}
+
+- (NSString *)getRawJSON {
+  NSString *__nullable firebaseJsonRaw =
+      [[NSBundle mainBundle].infoDictionary valueForKey:@"firebase_json_raw"];
+  if (firebaseJsonRaw == nil) {
+    return @"{}";
+  }
+
+  NSData *data = [[NSData alloc] initWithBase64EncodedString:firebaseJsonRaw options:0];
+  return [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
+  ;
+}
+@end

package/ios/RNFBApp/RNFBMeta.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>
+
+@interface RNFBMeta : NSObject
+
++ (BOOL)contains:(NSString *)key;
+
++ (BOOL)getBooleanValue:(NSString *)key defaultValue:(BOOL)defaultValue;
+
++ (NSString *)getStringValue:(NSString *)key defaultValue:(NSString *)defaultValue;
+
++ (NSDictionary *)getAll;
+
+@end

package/ios/RNFBApp/RNFBMeta.m

@@ -0,0 +1,61 @@
+/**
+ * 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 "RNFBMeta.h"
+
+@interface RNFBMeta ()
+@property(nonatomic, strong) NSDictionary *firebaseJson;
+@end
+
+NSString *const RNFBMetaPrefix = @"rnfirebase_";
+
+@implementation RNFBMeta
+
++ (BOOL)contains:(NSString *)key {
+  id keyValue = [[NSBundle mainBundle].infoDictionary
+      valueForKey:[RNFBMetaPrefix stringByAppendingString:key]];
+  return keyValue != nil;
+}
+
++ (BOOL)getBooleanValue:(NSString *)key defaultValue:(BOOL)defaultValue {
+  NSNumber *keyValue = [[NSBundle mainBundle].infoDictionary
+      valueForKey:[RNFBMetaPrefix stringByAppendingString:key]];
+  if (keyValue == nil) return defaultValue;
+  return [keyValue boolValue];
+}
+
++ (NSString *)getStringValue:(NSString *)key defaultValue:(NSString *)defaultValue {
+  NSString *keyValue = [[NSBundle mainBundle].infoDictionary
+      valueForKey:[RNFBMetaPrefix stringByAppendingString:key]];
+  if (keyValue == nil) return defaultValue;
+  return keyValue;
+}
+
++ (NSDictionary *)getAll {
+  NSMutableDictionary *allMetaValues = [NSMutableDictionary dictionary];
+
+  NSArray *keys = [[NSBundle mainBundle].infoDictionary allKeys];
+  for (NSString *key in keys) {
+    if ([key hasPrefix:RNFBMetaPrefix]) {
+      allMetaValues[key] = [NSBundle mainBundle].infoDictionary[key];
+    }
+  }
+
+  return allMetaValues;
+}
+
+@end

package/ios/RNFBApp/RNFBNullSentinelInterceptor.h

@@ -0,0 +1,47 @@
+/**
+ * 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 RNFBNullSentinelInterceptor_h
+#define RNFBNullSentinelInterceptor_h
+
+#import <Foundation/Foundation.h>
+
+/**
+ * Intercepts TurboModule conversions to automatically decode null sentinels.
+ *
+ * iOS TurboModules strip null values from object properties during serialization.
+ * See: https://github.com/facebook/react-native/issues/52802
+ * The JavaScript side encodes nulls as sentinel objects,
+ * and this interceptor automatically converts them back to NSNull before they
+ * reach module implementation methods.
+ *
+ * This class uses method swizzling on RCTCxxConvert to intercept all TurboModule
+ * data conversion methods (JS_*Module_Spec*Data:), decoding sentinels before the
+ * data reaches the C++ bridging layer and ultimately your module methods.
+ */
+@interface RNFBNullSentinelInterceptor : NSObject
+
+/**
+ * Initializes the null sentinel interceptor.
+ * This swizzles RCTCxxConvert (TurboModule converter) to automatically decode null sentinels.
+ * Called automatically when the class is loaded via +load.
+ */
++ (void)initialize;
+
+@end
+
+#endif

package/ios/RNFBApp/RNFBNullSentinelInterceptor.m

@@ -0,0 +1,74 @@
+/**
+ * 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 "RNFBNullSentinelInterceptor.h"
+#import <objc/runtime.h>
+#import "RNFBSharedUtils.h"
+
+@implementation RNFBNullSentinelInterceptor
+
++ (void)load {
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    [self swizzleRCTConvertMethods];
+  });
+}
+
++ (void)swizzleRCTConvertMethods {
+  // For TurboModules: Swizzle RCTCxxConvert to intercept all conversion methods
+  Class cxxConvertClass = NSClassFromString(@"RCTCxxConvert");
+  if (cxxConvertClass) {
+    [self swizzleTurboModuleConversions:cxxConvertClass];
+  }
+}
+
++ (void)swizzleTurboModuleConversions:(Class)cxxConvertClass {
+  // Get all methods from RCTCxxConvert
+  unsigned int methodCount = 0;
+  Method *methods = class_copyMethodList(object_getClass(cxxConvertClass), &methodCount);
+
+  for (unsigned int i = 0; i < methodCount; i++) {
+    Method method = methods[i];
+    SEL selector = method_getName(method);
+    NSString *selectorName = NSStringFromSelector(selector);
+
+    // Intercept TurboModule data conversion methods (they follow pattern:
+    // JS_NativeRNFBTurbo*_Spec*)
+    if ([selectorName hasPrefix:@"JS_NativeRNFBTurbo"] && [selectorName containsString:@"_Spec"]) {
+      // Create a swizzled version using IMP
+      IMP originalIMP = method_getImplementation(method);
+      const char *typeEncoding = method_getTypeEncoding(method);
+
+      // Replace with our wrapper that decodes nulls
+      IMP newIMP = imp_implementationWithBlock(^id(id self, id json) {
+        // Decode null sentinels before passing to original conversion
+        id decoded = [RNFBSharedUtils decodeNullSentinels:json];
+
+        // Call original implementation with decoded data
+        typedef id (*OriginalFunc)(id, SEL, id);
+        OriginalFunc originalFunc = (OriginalFunc)originalIMP;
+        return originalFunc(self, selector, decoded);
+      });
+
+      method_setImplementation(method, newIMP);
+    }
+  }
+
+  free(methods);
+}
+
+@end

package/ios/RNFBApp/RNFBPreferences.h

@@ -0,0 +1,44 @@
+/**
+ * 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>
+
+@interface RNFBPreferences : NSObject
+
+- (BOOL)contains:(NSString *)key;
+
+- (BOOL)getBooleanValue:(NSString *)key defaultValue:(BOOL)defaultValue;
+
+- (void)setBooleanValue:(NSString *)key boolValue:(BOOL)boolValue;
+
+- (void)setIntegerValue:(NSString *)key integerValue:(NSInteger)integerValue;
+
+- (void)setStringValue:(NSString *)key stringValue:(NSString *)stringValue;
+
+- (NSString *)getStringValue:(NSString *)key defaultValue:(NSString *)defaultValue;
+
+- (NSInteger)getIntegerValue:(NSString *)key defaultValue:(NSInteger)defaultValue;
+
+- (NSDictionary *)getAll;
+
+- (void)clearAll;
+
+- (void)remove:(NSString *)key;
+
++ (RNFBPreferences *)shared;
+
+@end