@react-native-firebase/database 22.4.0 → 23.0.0

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [23.0.0](https://github.com/invertase/react-native-firebase/compare/v22.4.0...v23.0.0) (2025-08-07)
+
+**Note:** Version bump only for package @react-native-firebase/database
+
 ## [22.4.0](https://github.com/invertase/react-native-firebase/compare/v22.3.0...v22.4.0) (2025-07-10)
 
 **Note:** Version bump only for package @react-native-firebase/database

package/lib/DatabaseDataSnapshot.js

@@ -24,13 +24,14 @@ import {
 } from '@react-native-firebase/app/lib/common';
 import { deepGet } from '@react-native-firebase/app/lib/common/deeps';
 
+import { MODULAR_DEPRECATION_ARG } from '@react-native-firebase/app/lib/common';
 export default class DatabaseDataSnapshot {
   constructor(reference, snapshot) {
     this._snapshot = snapshot;
 
     if (reference.key !== snapshot.key) {
       // reference is a query?
-      this._ref = reference.ref.child(snapshot.key);
+      this._ref = reference.ref.child.call(reference.ref, snapshot.key, MODULAR_DEPRECATION_ARG);
     } else {
       this._ref = reference;
     }
@@ -65,7 +66,7 @@ export default class DatabaseDataSnapshot {
       value = null;
     }
 
-    const childRef = this._ref.child(path);
+    const childRef = this._ref.child.call(this._ref, path, MODULAR_DEPRECATION_ARG);
 
     let childPriority = null;
     if (this._snapshot.childPriorities) {
@@ -137,7 +138,7 @@ export default class DatabaseDataSnapshot {
 
     for (let i = 0; i < this._snapshot.childKeys.length; i++) {
       const key = this._snapshot.childKeys[i];
-      const snapshot = this.child(key);
+      const snapshot = this.child.call(this, key, MODULAR_DEPRECATION_ARG);
       const actionReturn = action(snapshot, i);
 
       if (actionReturn === true) {

package/lib/DatabaseQuery.js

@@ -26,6 +26,8 @@ import {
   pathIsEmpty,
   pathToUrlEncodedString,
   ReferenceBase,
+  createDeprecationProxy,
+  MODULAR_DEPRECATION_ARG,
 } from '@react-native-firebase/app/lib/common';
 import DatabaseDataSnapshot from './DatabaseDataSnapshot';
 import DatabaseSyncTree from './DatabaseSyncTree';
@@ -52,7 +54,7 @@ export default class DatabaseQuery extends ReferenceBase {
    * @url https://firebase.google.com/docs/reference/js/firebase.database.Query.html#endat
    */
   get ref() {
-    return new DatabaseReference(this._database, this.path);
+    return createDeprecationProxy(new DatabaseReference(this._database, this.path));
   }
 
   /**
@@ -83,7 +85,7 @@ export default class DatabaseQuery extends ReferenceBase {
     const modifiers = this._modifiers._copy().endAt(value, key);
     modifiers.validateModifiers('firebase.database().ref().endAt()');
 
-    return new DatabaseQuery(this._database, this.path, modifiers);
+    return createDeprecationProxy(new DatabaseQuery(this._database, this.path, modifiers));
   }
 
   /**
@@ -117,7 +119,10 @@ export default class DatabaseQuery extends ReferenceBase {
       );
     }
 
-    return this.startAt(value, key).endAt(value, key);
+    // Internal method calls should always use MODULAR_DEPRECATION_ARG to avoid false deprecation warnings
+    return this.startAt
+      .call(this, value, key, MODULAR_DEPRECATION_ARG)
+      .endAt.call(this, value, MODULAR_DEPRECATION_ARG);
   }
 
   /**
@@ -155,10 +160,8 @@ export default class DatabaseQuery extends ReferenceBase {
       );
     }
 
-    return new DatabaseQuery(
-      this._database,
-      this.path,
-      this._modifiers._copy().limitToFirst(limit),
+    return createDeprecationProxy(
+      new DatabaseQuery(this._database, this.path, this._modifiers._copy().limitToFirst(limit)),
     );
   }
 
@@ -180,7 +183,9 @@ export default class DatabaseQuery extends ReferenceBase {
       );
     }
 
-    return new DatabaseQuery(this._database, this.path, this._modifiers._copy().limitToLast(limit));
+    return createDeprecationProxy(
+      new DatabaseQuery(this._database, this.path, this._modifiers._copy().limitToLast(limit)),
+    );
   }
 
   /**
@@ -210,7 +215,7 @@ export default class DatabaseQuery extends ReferenceBase {
       throw new Error("firebase.database().ref().off(_, *) 'callback' must be a function.");
     }
 
-    if (!isUndefined(context) && !isObject(context)) {
+    if (!isUndefined(context) && !isNull(context) && !isObject(context)) {
       throw new Error("firebase.database().ref().off(_, _, *) 'context' must be an object.");
     }
 
@@ -279,7 +284,7 @@ export default class DatabaseQuery extends ReferenceBase {
       );
     }
 
-    if (!isUndefined(context) && !isObject(context)) {
+    if (!isUndefined(context) && !isNull(context) && !isObject(context)) {
       throw new Error("firebase.database().ref().on(_, _, _, *) 'context' must be an object.");
     }
 
@@ -434,7 +439,7 @@ export default class DatabaseQuery extends ReferenceBase {
     const modifiers = this._modifiers._copy().orderByChild(path);
     modifiers.validateModifiers('firebase.database().ref().orderByChild()');
 
-    return new DatabaseQuery(this._database, this.path, modifiers);
+    return createDeprecationProxy(new DatabaseQuery(this._database, this.path, modifiers));
   }
 
   /**
@@ -450,7 +455,7 @@ export default class DatabaseQuery extends ReferenceBase {
     const modifiers = this._modifiers._copy().orderByKey();
     modifiers.validateModifiers('firebase.database().ref().orderByKey()');
 
-    return new DatabaseQuery(this._database, this.path, modifiers);
+    return createDeprecationProxy(new DatabaseQuery(this._database, this.path, modifiers));
   }
 
   /**
@@ -466,7 +471,7 @@ export default class DatabaseQuery extends ReferenceBase {
     const modifiers = this._modifiers._copy().orderByPriority();
     modifiers.validateModifiers('firebase.database().ref().orderByPriority()');
 
-    return new DatabaseQuery(this._database, this.path, modifiers);
+    return createDeprecationProxy(new DatabaseQuery(this._database, this.path, modifiers));
   }
 
   /**
@@ -482,7 +487,7 @@ export default class DatabaseQuery extends ReferenceBase {
     const modifiers = this._modifiers._copy().orderByValue();
     modifiers.validateModifiers('firebase.database().ref().orderByValue()');
 
-    return new DatabaseQuery(this._database, this.path, modifiers);
+    return createDeprecationProxy(new DatabaseQuery(this._database, this.path, modifiers));
   }
 
   startAt(value, key) {
@@ -507,7 +512,7 @@ export default class DatabaseQuery extends ReferenceBase {
     const modifiers = this._modifiers._copy().startAt(value, key);
     modifiers.validateModifiers('firebase.database().ref().startAt()');
 
-    return new DatabaseQuery(this._database, this.path, modifiers);
+    return createDeprecationProxy(new DatabaseQuery(this._database, this.path, modifiers));
   }
 
   toJSON() {

package/lib/DatabaseReference.js

@@ -28,6 +28,7 @@ import {
   pathChild,
   pathParent,
   promiseWithOptionalCallback,
+  createDeprecationProxy,
 } from '@react-native-firebase/app/lib/common';
 import DatabaseDataSnapshot from './DatabaseDataSnapshot';
 import DatabaseOnDisconnect from './DatabaseOnDisconnect';
@@ -210,7 +211,11 @@ export default class DatabaseReference extends DatabaseQuery {
           if (error) {
             onComplete(error, committed, null);
           } else {
-            onComplete(null, committed, new DatabaseDataSnapshot(this, snapshotData));
+            onComplete(
+              null,
+              committed,
+              createDeprecationProxy(new DatabaseDataSnapshot(this, snapshotData)),
+            );
           }
         }
 
@@ -219,7 +224,7 @@ export default class DatabaseReference extends DatabaseQuery {
         }
         return resolve({
           committed,
-          snapshot: new DatabaseDataSnapshot(this, snapshotData),
+          snapshot: createDeprecationProxy(new DatabaseDataSnapshot(this, snapshotData)),
         });
       };
 

package/lib/index.js

@@ -15,7 +15,13 @@
  *
  */
 
-import { isAndroid, isBoolean, isNumber, isString } from '@react-native-firebase/app/lib/common';
+import {
+  isAndroid,
+  isBoolean,
+  isNumber,
+  isString,
+  MODULAR_DEPRECATION_ARG,
+} from '@react-native-firebase/app/lib/common';
 import {
   createModuleNamespace,
   FirebaseModule,
@@ -28,6 +34,8 @@ import DatabaseTransaction from './DatabaseTransaction';
 import version from './version';
 import fallBackModule from './web/RNFBDatabaseModule';
 
+import { createDeprecationProxy } from '@react-native-firebase/app/lib/common';
+
 const namespace = 'database';
 
 const nativeModuleName = [
@@ -54,9 +62,13 @@ class FirebaseDatabaseModule extends FirebaseModule {
    * @private
    */
   _syncServerTimeOffset() {
-    this.ref('.info/serverTimeOffset').on('value', snapshot => {
-      this._serverTimeOffset = snapshot.val();
-    });
+    this.ref('.info/serverTimeOffset').on(
+      'value',
+      snapshot => {
+        this._serverTimeOffset = snapshot.val();
+      },
+      MODULAR_DEPRECATION_ARG,
+    );
   }
 
   /**
@@ -84,7 +96,7 @@ class FirebaseDatabaseModule extends FirebaseModule {
       );
     }
 
-    return new DatabaseReference(this, path);
+    return createDeprecationProxy(new DatabaseReference(this, path));
   }
 
   /**
@@ -112,7 +124,7 @@ class FirebaseDatabaseModule extends FirebaseModule {
       path = path.slice(0, path.indexOf('?'));
     }
 
-    return new DatabaseReference(this, path || '/');
+    return createDeprecationProxy(new DatabaseReference(this, path || '/'));
   }
 
   /**

package/lib/modular/index.d.ts

@@ -220,6 +220,20 @@ export function getServerTime(db: Database): Promise<number>;
  */
 export function increment(delta: number): object;
 
+/**
+ * Server specific values.
+ */
+export const ServerValue: {
+  /**
+   * A placeholder value for auto-populating the current timestamp.
+   */
+  TIMESTAMP: object;
+  /**
+   * Returns a placeholder value that can be used to atomically increment the current database value.
+   */
+  increment(delta: number): object;
+};
+
 /**
  * Logs debugging information to the console. Not implemented on native.
  *

package/lib/modular/index.js

@@ -2,6 +2,7 @@ import { getApp } from '@react-native-firebase/app';
 import DatabaseStatics from '../DatabaseStatics';
 
 const { ServerValue } = DatabaseStatics;
+import { MODULAR_DEPRECATION_ARG } from '@react-native-firebase/app/lib/common';
 
 /**
  * @typedef {import("..").FirebaseApp} FirebaseApp
@@ -28,7 +29,7 @@ export function getDatabase(app, url) {
  * @returns {void}
  */
 export function connectDatabaseEmulator(db, host, port) {
-  db.useEmulator(host, port);
+  db.useEmulator.call(db, host, port, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -36,7 +37,7 @@ export function connectDatabaseEmulator(db, host, port) {
  * @returns {Promise<void>}
  */
 export function goOffline(db) {
-  return db.goOffline();
+  return db.goOffline.call(db, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -44,7 +45,7 @@ export function goOffline(db) {
  * @returns {Promise<void>}
  */
 export function goOnline(db) {
-  return db.goOnline();
+  return db.goOnline.call(db, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -53,7 +54,7 @@ export function goOnline(db) {
  * @returns {DatabaseReference}
  */
 export function ref(db, path) {
-  return db.ref(path);
+  return db.ref.call(db, path, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -62,7 +63,7 @@ export function ref(db, path) {
  * @returns {DatabaseReference}
  */
 export function refFromURL(db, url) {
-  return db.refFromURL(url);
+  return db.refFromURL.call(db, url, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -71,7 +72,7 @@ export function refFromURL(db, url) {
  * @returns {void}
  */
 export function setPersistenceEnabled(db, enabled) {
-  return db.setPersistenceEnabled(enabled);
+  return db.setPersistenceEnabled.call(db, enabled, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -80,7 +81,7 @@ export function setPersistenceEnabled(db, enabled) {
  * @returns {void}
  */
 export function setLoggingEnabled(db, enabled) {
-  return db.setLoggingEnabled(enabled);
+  return db.setLoggingEnabled.call(db, enabled, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -89,7 +90,7 @@ export function setLoggingEnabled(db, enabled) {
  * @returns {void}
  */
 export function setPersistenceCacheSizeBytes(db, bytes) {
-  return db.setPersistenceCacheSizeBytes(bytes);
+  return db.setPersistenceCacheSizeBytes.call(db, bytes, MODULAR_DEPRECATION_ARG);
 }
 
 export function forceLongPolling() {
@@ -105,7 +106,7 @@ export function forceWebSockets() {
  * @returns {Date}
  */
 export function getServerTime(db) {
-  return db.getServerTime();
+  return db.getServerTime.call(db, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -120,9 +121,11 @@ export function serverTimestamp() {
  * @returns {object}
  */
 export function increment(delta) {
-  return ServerValue.increment(delta);
+  return ServerValue.increment.call(ServerValue, delta, MODULAR_DEPRECATION_ARG);
 }
 
+export { ServerValue };
+
 export function enableLogging(_enabled, _persistent) {
   throw new Error('enableLogging() is not implemented');
 }

package/lib/modular/query.js

@@ -13,6 +13,9 @@
 /**
  * @implements {IQueryConstraint}
  */
+
+import { MODULAR_DEPRECATION_ARG } from '@react-native-firebase/app/lib/common';
+
 class QueryConstraint {
   constructor(type, ...args) {
     this._type = type;
@@ -20,8 +23,7 @@ class QueryConstraint {
   }
 
   _apply(query) {
-    // eslint-disable-next-line prefer-spread
-    return query[this._type].apply(query, this._args);
+    return query[this._type].apply(query, [...this._args, MODULAR_DEPRECATION_ARG]);
   }
 }
 
@@ -138,14 +140,14 @@ function addEventListener(query, eventType, callback, cancelCallbackOrListenOpti
   if (options && options.onlyOnce) {
     const userCallback = callback;
     callback = snapshot => {
-      query.off(eventType, callback);
+      query.off.call(query, eventType, callback, null, MODULAR_DEPRECATION_ARG);
       return userCallback(snapshot);
     };
   }
 
-  query.on(eventType, callback, cancelCallback);
+  query.on.call(query, eventType, callback, cancelCallback, null, MODULAR_DEPRECATION_ARG);
 
-  return () => query.off(eventType, callback);
+  return () => query.off.call(query, eventType, callback, null, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -209,7 +211,7 @@ export function onChildRemoved(query, callback, cancelCallbackOrListenOptions, o
  * @returns {Promise<void>}
  */
 export function set(ref, value) {
-  return ref.set(value);
+  return ref.set.call(ref, value, () => {}, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -218,7 +220,7 @@ export function set(ref, value) {
  * @returns {Promise<void>}
  */
 export function setPriority(ref, priority) {
-  return ref.setPriority(priority);
+  return ref.setPriority.call(ref, priority, () => {}, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -228,7 +230,7 @@ export function setPriority(ref, priority) {
  * @returns {Promise<void>}
  */
 export function setWithPriority(ref, value, priority) {
-  return ref.setWithPriority(value, priority);
+  return ref.setWithPriority.call(ref, value, priority, () => {}, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -236,7 +238,14 @@ export function setWithPriority(ref, value, priority) {
  * @returns {DataSnapshot}
  */
 export function get(query) {
-  return query.once('value');
+  return query.once.call(
+    query,
+    'value',
+    () => {},
+    () => {},
+    {},
+    MODULAR_DEPRECATION_ARG,
+  );
 }
 
 export function off(_query, _eventType, _callback) {
@@ -249,7 +258,7 @@ export function off(_query, _eventType, _callback) {
  * @returns {DatabaseReference}
  */
 export function child(parent, path) {
-  return parent.child(path);
+  return parent.child.call(parent, path, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -257,7 +266,7 @@ export function child(parent, path) {
  * @returns {OnDisconnect}
  */
 export function onDisconnect(ref) {
-  return ref.onDisconnect();
+  return ref.onDisconnect.call(ref, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -266,7 +275,7 @@ export function onDisconnect(ref) {
  * @returns {Promise<void>}
  */
 export function keepSynced(ref, value) {
-  return ref.keepSynced(value);
+  return ref.keepSynced.call(ref, value, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -275,7 +284,7 @@ export function keepSynced(ref, value) {
  * @returns {ThenableReference}
  */
 export function push(parent, value) {
-  return parent.push(value);
+  return parent.push.call(parent, value, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -283,7 +292,7 @@ export function push(parent, value) {
  * @returns {Promise<void>}
  */
 export function remove(ref) {
-  return ref.remove();
+  return ref.remove.call(ref, MODULAR_DEPRECATION_ARG);
 }
 
 /**
@@ -292,5 +301,5 @@ export function remove(ref) {
  * @returns {Promise<void>}
  */
 export function update(ref, values) {
-  return ref.update(values);
+  return ref.update.call(ref, values, MODULAR_DEPRECATION_ARG);
 }

package/lib/modular/transaction.js

@@ -10,6 +10,15 @@
  * @param {TransactionOptions?} options
  * @returns {Promise<TransactionResult>}
  */
+
+import { MODULAR_DEPRECATION_ARG } from '@react-native-firebase/app/lib/common';
+
 export function runTransaction(ref, transactionUpdate, options) {
-  return ref.transaction(transactionUpdate, undefined, options && options.applyLocally);
+  return ref.transaction.call(
+    ref,
+    transactionUpdate,
+    undefined,
+    options && options.applyLocally,
+    MODULAR_DEPRECATION_ARG,
+  );
 }

package/lib/version.js

@@ -1,2 +1,2 @@
 // Generated by genversion.
-module.exports = '22.4.0';
+module.exports = '23.0.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/database",
-  "version": "22.4.0",
+  "version": "23.0.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Firebase - The Firebase Realtime Database is a cloud-hosted database. Data is stored as JSON and synchronized in realtime to every connected client. React Native Firebase provides native integration with the Android & iOS Firebase SDKs, supporting both realtime data sync and offline capabilities.",
   "main": "lib/index.js",
@@ -25,11 +25,11 @@
     "realtome database"
   ],
   "peerDependencies": {
-    "@react-native-firebase/app": "22.4.0"
+    "@react-native-firebase/app": "23.0.0"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "gitHead": "7eaaf185aab15c7e4fc3c218af9be609fe7e0030"
+  "gitHead": "14c35416e62f3626d6c2aee2ffd000bd2337884b"
 }