@react-native-firebase/database 25.1.0 → 26.1.0

package/ios/RNFBDatabase/RNFBDatabaseQueryModule.mm

@@ -0,0 +1,105 @@
+/**
+ * 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 <React/RCTUtils.h>
+
+#import "RNFBDatabaseQueryHelper.h"
+#import "RNFBDatabaseQueryModule.h"
+#import "RNFBDatabaseQueue.h"
+#import "RNFBDatabaseTurboModules.h"
+
+// NOTE: This module deliberately never imports Firebase Database headers.
+// See RNFBDatabaseModule.mm for rationale. All Firebase Database calls and
+// query/listener bookkeeping live in the plain Objective-C
+// `RNFBDatabaseQueryHelper`.
+
+@interface RNFBDatabaseQueryModule () <NativeRNFBTurboDatabaseQuerySpec, RCTBridgeModule>
+@end
+
+@implementation RNFBDatabaseQueryModule
+#pragma mark -
+#pragma mark Module Setup
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params {
+  return std::make_shared<facebook::react::NativeRNFBTurboDatabaseQuerySpecJSI>(params);
+}
+
+RCT_EXPORT_MODULE(NativeRNFBTurboDatabaseQuery);
+
++ (BOOL)requiresMainQueueSetup {
+  return NO;
+}
+
+- (dispatch_queue_t)methodQueue {
+  return [RNFBDatabaseQueue getDispatchQueue];
+}
+
+- (void)dealloc {
+  [self invalidate];
+}
+
+- (void)invalidate {
+  [RNFBDatabaseQueryHelper invalidate];
+}
+
+#pragma mark -
+#pragma mark Firebase Database
+
+- (void)once:(NSString *)app
+        dbURL:(NSString *)dbURL
+         path:(NSString *)path
+    modifiers:(NSArray *)modifiers
+    eventType:(NSString *)eventType
+      resolve:(RCTPromiseResolveBlock)resolve
+       reject:(RCTPromiseRejectBlock)reject {
+  [RNFBDatabaseQueryHelper once:app
+                          dbURL:dbURL
+                           path:path
+                      modifiers:modifiers
+                      eventType:eventType
+                        resolve:resolve
+                         reject:reject];
+}
+
+- (void)on:(NSString *)app dbURL:(NSString *)dbURL props:(NSDictionary *)props {
+  [RNFBDatabaseQueryHelper on:app dbURL:dbURL props:props];
+}
+
+- (void)off:(NSString *)queryKey eventRegistrationKey:(NSString *)eventRegistrationKey {
+  [RNFBDatabaseQueryHelper off:queryKey eventRegistrationKey:eventRegistrationKey];
+}
+
+- (void)keepSynced:(NSString *)app
+             dbURL:(NSString *)dbURL
+               key:(NSString *)key
+              path:(NSString *)path
+         modifiers:(NSArray *)modifiers
+           enabled:(BOOL)value
+           resolve:(RCTPromiseResolveBlock)resolve
+            reject:(RCTPromiseRejectBlock)reject {
+  [RNFBDatabaseQueryHelper keepSynced:app
+                                dbURL:dbURL
+                                  key:key
+                                 path:path
+                            modifiers:modifiers
+                              enabled:value
+                              resolve:resolve
+                               reject:reject];
+}
+
+@end

package/ios/RNFBDatabase/RNFBDatabaseQueue.h

@@ -0,0 +1,29 @@
+/**
+ * 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>
+
+// Deliberately Firebase-free: this header is imported by Objective-C++ (.mm)
+// modules that must not pull in any Firebase Database headers directly (see
+// RNFBDatabaseCommon.h for why). Keeping it isolated means the shared serial
+// queue used as `methodQueue` can be obtained without ever importing
+// Firebase from a .mm translation unit.
+@interface RNFBDatabaseQueue : NSObject
+
++ (dispatch_queue_t)getDispatchQueue;
+
+@end

package/ios/RNFBDatabase/RNFBDatabaseQueue.m

@@ -0,0 +1,31 @@
+/**
+ * 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 "RNFBDatabaseQueue.h"
+
+@implementation RNFBDatabaseQueue
+
++ (dispatch_queue_t)getDispatchQueue {
+  static dispatch_once_t once;
+  static dispatch_queue_t sharedInstance;
+  dispatch_once(&once, ^{
+    sharedInstance = dispatch_queue_create("io.invertase.firebase.database", DISPATCH_QUEUE_SERIAL);
+  });
+  return sharedInstance;
+}
+
+@end

package/ios/RNFBDatabase/RNFBDatabaseReferenceHelper.h

@@ -0,0 +1,59 @@
+/**
+ * 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/RCTBridgeModule.h>
+
+// See RNFBDatabaseModuleHelper.h for rationale: plain Objective-C helper
+// that owns all `FIRDatabaseReference` calls for RNFBDatabaseReferenceModule.
+@interface RNFBDatabaseReferenceHelper : NSObject
+
++ (void)set:(NSString *)app
+      dbURL:(NSString *)dbURL
+       path:(NSString *)path
+      props:(NSDictionary *)props
+    resolve:(RCTPromiseResolveBlock)resolve
+     reject:(RCTPromiseRejectBlock)reject;
+
++ (void)update:(NSString *)app
+         dbURL:(NSString *)dbURL
+          path:(NSString *)path
+         props:(NSDictionary *)props
+       resolve:(RCTPromiseResolveBlock)resolve
+        reject:(RCTPromiseRejectBlock)reject;
+
++ (void)setWithPriority:(NSString *)app
+                  dbURL:(NSString *)dbURL
+                   path:(NSString *)path
+                  props:(NSDictionary *)props
+                resolve:(RCTPromiseResolveBlock)resolve
+                 reject:(RCTPromiseRejectBlock)reject;
+
++ (void)remove:(NSString *)app
+         dbURL:(NSString *)dbURL
+          path:(NSString *)path
+       resolve:(RCTPromiseResolveBlock)resolve
+        reject:(RCTPromiseRejectBlock)reject;
+
++ (void)setPriority:(NSString *)app
+              dbURL:(NSString *)dbURL
+               path:(NSString *)path
+              props:(NSDictionary *)props
+            resolve:(RCTPromiseResolveBlock)resolve
+             reject:(RCTPromiseRejectBlock)reject;
+
+@end

package/ios/RNFBDatabase/{RNFBDatabaseReferenceModule.m → RNFBDatabaseReferenceHelper.m}

@@ -15,32 +15,26 @@
  *
  */
 
+#if __has_include(<Firebase/Firebase.h>)
 #import <Firebase/Firebase.h>
-#import <React/RCTUtils.h>
+#else
+@import FirebaseCore;
+@import FirebaseDatabaseInternal;
+#endif
 
+#import "RNFBApp/RCTConvert+FIRApp.h"
 #import "RNFBDatabaseCommon.h"
-#import "RNFBDatabaseReferenceModule.h"
+#import "RNFBDatabaseReferenceHelper.h"
 
-@implementation RNFBDatabaseReferenceModule
-#pragma mark -
-#pragma mark Module Setup
+@implementation RNFBDatabaseReferenceHelper
 
-RCT_EXPORT_MODULE();
-
-- (dispatch_queue_t)methodQueue {
-  return [RNFBDatabaseCommon getDispatchQueue];
-}
-
-#pragma mark -
-#pragma mark Firebase Database
-
-RCT_EXPORT_METHOD(set
-                  : (FIRApp *)firebaseApp
-                  : (NSString *)dbURL
-                  : (NSString *)path
-                  : (NSDictionary *)props
-                  : (RCTPromiseResolveBlock)resolve
-                  : (RCTPromiseRejectBlock)reject) {
++ (void)set:(NSString *)app
+      dbURL:(NSString *)dbURL
+       path:(NSString *)path
+      props:(NSDictionary *)props
+    resolve:(RCTPromiseResolveBlock)resolve
+     reject:(RCTPromiseRejectBlock)reject {
+  FIRApp *firebaseApp = [RCTConvert firAppFromString:app];
   FIRDatabase *firDatabase = [RNFBDatabaseCommon getDatabaseForApp:firebaseApp dbURL:dbURL];
   FIRDatabaseReference *firDatabaseReference =
       [RNFBDatabaseCommon getReferenceForDatabase:firDatabase path:path];
@@ -55,13 +49,13 @@ RCT_EXPORT_METHOD(set
              }];
 }
 
-RCT_EXPORT_METHOD(update
-                  : (FIRApp *)firebaseApp
-                  : (NSString *)dbURL
-                  : (NSString *)path
-                  : (NSDictionary *)props
-                  : (RCTPromiseResolveBlock)resolve
-                  : (RCTPromiseRejectBlock)reject) {
++ (void)update:(NSString *)app
+         dbURL:(NSString *)dbURL
+          path:(NSString *)path
+         props:(NSDictionary *)props
+       resolve:(RCTPromiseResolveBlock)resolve
+        reject:(RCTPromiseRejectBlock)reject {
+  FIRApp *firebaseApp = [RCTConvert firAppFromString:app];
   FIRDatabase *firDatabase = [RNFBDatabaseCommon getDatabaseForApp:firebaseApp dbURL:dbURL];
   FIRDatabaseReference *firDatabaseReference =
       [RNFBDatabaseCommon getReferenceForDatabase:firDatabase path:path];
@@ -76,13 +70,13 @@ RCT_EXPORT_METHOD(update
                       }];
 }
 
-RCT_EXPORT_METHOD(setWithPriority
-                  : (FIRApp *)firebaseApp
-                  : (NSString *)dbURL
-                  : (NSString *)path
-                  : (NSDictionary *)props
-                  : (RCTPromiseResolveBlock)resolve
-                  : (RCTPromiseRejectBlock)reject) {
++ (void)setWithPriority:(NSString *)app
+                  dbURL:(NSString *)dbURL
+                   path:(NSString *)path
+                  props:(NSDictionary *)props
+                resolve:(RCTPromiseResolveBlock)resolve
+                 reject:(RCTPromiseRejectBlock)reject {
+  FIRApp *firebaseApp = [RCTConvert firAppFromString:app];
   FIRDatabase *firDatabase = [RNFBDatabaseCommon getDatabaseForApp:firebaseApp dbURL:dbURL];
   FIRDatabaseReference *firDatabaseReference =
       [RNFBDatabaseCommon getReferenceForDatabase:firDatabase path:path];
@@ -98,12 +92,12 @@ RCT_EXPORT_METHOD(setWithPriority
              }];
 }
 
-RCT_EXPORT_METHOD(remove
-                  : (FIRApp *)firebaseApp
-                  : (NSString *)dbURL
-                  : (NSString *)path
-                  : (RCTPromiseResolveBlock)resolve
-                  : (RCTPromiseRejectBlock)reject) {
++ (void)remove:(NSString *)app
+         dbURL:(NSString *)dbURL
+          path:(NSString *)path
+       resolve:(RCTPromiseResolveBlock)resolve
+        reject:(RCTPromiseRejectBlock)reject {
+  FIRApp *firebaseApp = [RCTConvert firAppFromString:app];
   FIRDatabase *firDatabase = [RNFBDatabaseCommon getDatabaseForApp:firebaseApp dbURL:dbURL];
   FIRDatabaseReference *firDatabaseReference =
       [RNFBDatabaseCommon getReferenceForDatabase:firDatabase path:path];
@@ -118,13 +112,13 @@ RCT_EXPORT_METHOD(remove
       }];
 }
 
-RCT_EXPORT_METHOD(setPriority
-                  : (FIRApp *)firebaseApp
-                  : (NSString *)dbURL
-                  : (NSString *)path
-                  : (NSDictionary *)props
-                  : (RCTPromiseResolveBlock)resolve
-                  : (RCTPromiseRejectBlock)reject) {
++ (void)setPriority:(NSString *)app
+              dbURL:(NSString *)dbURL
+               path:(NSString *)path
+              props:(NSDictionary *)props
+            resolve:(RCTPromiseResolveBlock)resolve
+             reject:(RCTPromiseRejectBlock)reject {
+  FIRApp *firebaseApp = [RCTConvert firAppFromString:app];
   FIRDatabase *firDatabase = [RNFBDatabaseCommon getDatabaseForApp:firebaseApp dbURL:dbURL];
   FIRDatabaseReference *firDatabaseReference =
       [RNFBDatabaseCommon getReferenceForDatabase:firDatabase path:path];

package/ios/RNFBDatabase/RNFBDatabaseReferenceModule.mm

@@ -0,0 +1,125 @@
+/**
+ * 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 <React/RCTUtils.h>
+
+#import "RNFBDatabaseQueue.h"
+#import "RNFBDatabaseReferenceHelper.h"
+#import "RNFBDatabaseReferenceModule.h"
+#import "RNFBDatabaseTurboModules.h"
+
+// NOTE: This module deliberately never imports Firebase Database headers.
+// See RNFBDatabaseModule.mm for rationale. All Firebase Database calls are
+// delegated to the plain Objective-C `RNFBDatabaseReferenceHelper`.
+
+@interface RNFBDatabaseReferenceModule () <NativeRNFBTurboDatabaseReferenceSpec, RCTBridgeModule>
+@end
+
+@implementation RNFBDatabaseReferenceModule
+#pragma mark -
+#pragma mark Module Setup
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params {
+  return std::make_shared<facebook::react::NativeRNFBTurboDatabaseReferenceSpecJSI>(params);
+}
+
+RCT_EXPORT_MODULE(NativeRNFBTurboDatabaseReference);
+
++ (BOOL)requiresMainQueueSetup {
+  return NO;
+}
+
+- (dispatch_queue_t)methodQueue {
+  return [RNFBDatabaseQueue getDispatchQueue];
+}
+
+- (void)dealloc {
+  [self invalidate];
+}
+
+- (void)invalidate {
+}
+
+#pragma mark -
+#pragma mark Firebase Database
+
+- (void)set:(NSString *)app
+      dbURL:(NSString *)dbURL
+       path:(NSString *)path
+      props:(NSDictionary *)props
+    resolve:(RCTPromiseResolveBlock)resolve
+     reject:(RCTPromiseRejectBlock)reject {
+  [RNFBDatabaseReferenceHelper set:app
+                             dbURL:dbURL
+                              path:path
+                             props:props
+                           resolve:resolve
+                            reject:reject];
+}
+
+- (void)update:(NSString *)app
+         dbURL:(NSString *)dbURL
+          path:(NSString *)path
+         props:(NSDictionary *)props
+       resolve:(RCTPromiseResolveBlock)resolve
+        reject:(RCTPromiseRejectBlock)reject {
+  [RNFBDatabaseReferenceHelper update:app
+                                dbURL:dbURL
+                                 path:path
+                                props:props
+                              resolve:resolve
+                               reject:reject];
+}
+
+- (void)setWithPriority:(NSString *)app
+                  dbURL:(NSString *)dbURL
+                   path:(NSString *)path
+                  props:(NSDictionary *)props
+                resolve:(RCTPromiseResolveBlock)resolve
+                 reject:(RCTPromiseRejectBlock)reject {
+  [RNFBDatabaseReferenceHelper setWithPriority:app
+                                         dbURL:dbURL
+                                          path:path
+                                         props:props
+                                       resolve:resolve
+                                        reject:reject];
+}
+
+- (void)remove:(NSString *)app
+         dbURL:(NSString *)dbURL
+          path:(NSString *)path
+       resolve:(RCTPromiseResolveBlock)resolve
+        reject:(RCTPromiseRejectBlock)reject {
+  [RNFBDatabaseReferenceHelper remove:app dbURL:dbURL path:path resolve:resolve reject:reject];
+}
+
+- (void)setPriority:(NSString *)app
+              dbURL:(NSString *)dbURL
+               path:(NSString *)path
+              props:(NSDictionary *)props
+            resolve:(RCTPromiseResolveBlock)resolve
+             reject:(RCTPromiseRejectBlock)reject {
+  [RNFBDatabaseReferenceHelper setPriority:app
+                                     dbURL:dbURL
+                                      path:path
+                                     props:props
+                                   resolve:resolve
+                                    reject:reject];
+}
+
+@end

package/ios/RNFBDatabase/RNFBDatabaseTransactionHelper.h

@@ -0,0 +1,38 @@
+/**
+ * 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>
+
+// See RNFBDatabaseModuleHelper.h for rationale: plain Objective-C helper
+// that owns all `FIRDatabaseReference`/`FIRTransactionResult` calls and the
+// pending-transaction bookkeeping for RNFBDatabaseTransactionModule.
+@interface RNFBDatabaseTransactionHelper : NSObject
+
++ (void)transactionStart:(NSString *)app
+                   dbURL:(NSString *)dbURL
+                    path:(NSString *)path
+           transactionId:(double)transactionId
+            applyLocally:(BOOL)applyLocally;
+
++ (void)transactionTryCommit:(NSString *)app
+                       dbURL:(NSString *)dbURL
+               transactionId:(double)transactionId
+                     updates:(NSDictionary *)updates;
+
++ (void)invalidate;
+
+@end