@react-native-firebase/remote-config 23.4.1 → 23.5.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [23.5.0](https://github.com/invertase/react-native-firebase/compare/v23.4.1...v23.5.0) (2025-10-30)
+
+### Features
+
+- **remote-config, other:** official onConfigUpdate API, w/Other platform support ([0fcc983](https://github.com/invertase/react-native-firebase/commit/0fcc983f3531bde799020e16a23e1ecb551c0896))
+
 ## [23.4.1](https://github.com/invertase/react-native-firebase/compare/v23.4.0...v23.4.1) (2025-10-14)
 
 ### Bug Fixes

package/lib/index.d.ts

@@ -291,6 +291,45 @@ export namespace FirebaseRemoteConfigTypes {
    */
   type LastFetchStatusType = 'success' | 'failure' | 'no_fetch_yet' | 'throttled';
 
+  /**
+   * Contains information about which keys have been updated.
+   */
+  export interface ConfigUpdate {
+    /**
+     * Parameter keys whose values have been updated from the currently activated values.
+     * Includes keys that are added, deleted, or whose value, value source, or metadata has changed.
+     */
+    getUpdatedKeys(): Set<string>;
+  }
+
+  /**
+   * Observer interface for receiving real-time Remote Config update notifications.
+   *
+   * NOTE: Although an `complete` callback can be provided, it will
+   * never be called because the ConfigUpdate stream is never-ending.
+   */
+  export interface ConfigUpdateObserver {
+    /**
+     * Called when a new ConfigUpdate is available.
+     */
+    next: (configUpdate: ConfigUpdate) => void;
+
+    /**
+     * Called if an error occurs during the stream.
+     */
+    error: (error: FirebaseError) => void;
+
+    /**
+     * Called when the stream is gracefully terminated.
+     */
+    complete: () => void;
+  }
+
+  /**
+   * A function that unsubscribes from a real-time event stream.
+   */
+  export type Unsubscribe = () => void;
+
   /**
    * The Firebase Remote RemoteConfig service interface.
    *
@@ -376,14 +415,33 @@ export namespace FirebaseRemoteConfigTypes {
      */
     setDefaultsFromResource(resourceName: string): Promise<null>;
 
+    /**
+     * Starts listening for real-time config updates from the Remote Config backend and automatically
+     * fetches updates from the Remote Config backend when they are available.
+     *
+     * @remarks
+     * If a connection to the Remote Config backend is not already open, calling this method will
+     * open it. Multiple listeners can be added by calling this method again, but subsequent calls
+     * re-use the same connection to the backend.
+     *
+     * The list of updated keys passed to the callback will include all keys not currently active,
+     * and the config update process fetches the new config but does not automatically activate
+     * it for you. Typically you will activate the config in your callback to use the new values.
+     *
+     * @param remoteConfig - The {@link RemoteConfig} instance.
+     * @param observer - The {@link ConfigUpdateObserver} to be notified of config updates.
+     * @returns An {@link Unsubscribe} function to remove the listener.
+     */
+    onConfigUpdate(remoteConfig: RemoteConfig, observer: ConfigUpdateObserver): Unsubscribe;
+
     /**
      * Start listening for real-time config updates from the Remote Config backend and
      * automatically fetch updates when they’re available. Note that the list of updated keys
      * passed to the callback will include all keys not currently active, and the config update
      * process fetches the new config but does not automatically activate for you. Typically
      * you will want to activate the config in your callback so the new values are in force.
-     *
      * @param listener called with either array of updated keys or error arg when config changes
+     * @deprecated use official firebase-js-sdk onConfigUpdate now that web supports realtime
      */
     onConfigUpdated(listener: CallbackOrObserver<OnConfigUpdatedListenerCallback>): () => void;
 
@@ -541,8 +599,10 @@ export namespace FirebaseRemoteConfigTypes {
     reset(): Promise<void>;
   }
 
+  // deprecated: from pre-Web realtime remote-config support - remove with onConfigUpdated
   export type CallbackOrObserver<T extends (...args: any[]) => any> = T | { next: T };
 
+  // deprecated: from pre-Web realtime remote-config support - remove with onConfigUpdated
   export type OnConfigUpdatedListenerCallback = (
     event?: { updatedKeys: string[] },
     error?: {

package/lib/index.js

@@ -22,6 +22,7 @@ import {
   isString,
   isUndefined,
   isIOS,
+  isFunction,
   parseListenerOrObserver,
 } from '@react-native-firebase/app/lib/common';
 import Value from './RemoteConfigValue';
@@ -241,11 +242,69 @@ class FirebaseConfigModule extends FirebaseModule {
     return this._promiseWithConstants(this.native.setDefaultsFromResource(resourceName));
   }
 
+  /**
+   * Registers an observer to changes in the configuration.
+   *
+   * @param observer - The {@link ConfigUpdateObserver} to be notified of config updates.
+   * @returns An {@link Unsubscribe} function to remove the listener.
+   */
+  onConfigUpdate(observer) {
+    if (!isObject(observer) || !isFunction(observer.next) || !isFunction(observer.error)) {
+      throw new Error("'observer' expected an object with 'next' and 'error' functions.");
+    }
+
+    // We maintaine our pre-web-support native interface but bend it to match
+    // the official JS SDK API by assuming the callback is an Observer, and sending it a ConfigUpdate
+    // compatible parameter that implements the `getUpdatedKeys` method
+    let unsubscribed = false;
+    const subscription = this.emitter.addListener(
+      this.eventNameForApp('on_config_updated'),
+      event => {
+        const { resultType } = event;
+        if (resultType === 'success') {
+          observer.next({
+            getUpdatedKeys: () => {
+              return new Set(event.updatedKeys);
+            },
+          });
+          return;
+        }
+
+        observer.error({
+          code: event.code,
+          message: event.message,
+          nativeErrorMessage: event.nativeErrorMessage,
+        });
+      },
+    );
+    if (this._configUpdateListenerCount === 0) {
+      this.native.onConfigUpdated();
+    }
+
+    this._configUpdateListenerCount++;
+
+    return () => {
+      if (unsubscribed) {
+        // there is no harm in calling this multiple times to unsubscribe,
+        // but anything after the first call is a no-op
+        return;
+      } else {
+        unsubscribed = true;
+      }
+      subscription.remove();
+      this._configUpdateListenerCount--;
+      if (this._configUpdateListenerCount === 0) {
+        this.native.removeConfigUpdateRegistration();
+      }
+    };
+  }
+
   /**
    * Registers a listener to changes in the configuration.
    *
    * @param listenerOrObserver - function called on config change
    * @returns {function} unsubscribe listener
+   * @deprecated use official firebase-js-sdk onConfigUpdate now that web supports realtime
    */
   onConfigUpdated(listenerOrObserver) {
     const listener = parseListenerOrObserver(listenerOrObserver);

package/lib/modular/index.d.ts

@@ -27,7 +27,11 @@ import RemoteConfigLogLevel = FirebaseRemoteConfigTypes.RemoteConfigLogLevel;
 import FirebaseApp = ReactNativeFirebase.FirebaseApp;
 import LastFetchStatusInterface = FirebaseRemoteConfigTypes.LastFetchStatus;
 import ValueSourceInterface = FirebaseRemoteConfigTypes.ValueSource;
+import ConfigUpdateObserver = FirebaseRemoteConfigTypes.ConfigUpdateObserver;
+import Unsubscribe = FirebaseRemoteConfigTypes.Unsubscribe;
+// deprecated: from pre-Web realtime remote-config support - remove with onConfigUpdated
 import CallbackOrObserver = FirebaseRemoteConfigTypes.CallbackOrObserver;
+// deprecated: from pre-Web realtime remote-config support - remove with onConfigUpdated
 import OnConfigUpdatedListenerCallback = FirebaseRemoteConfigTypes.OnConfigUpdatedListenerCallback;
 
 export const LastFetchStatus: LastFetchStatusInterface;
@@ -203,12 +207,35 @@ export function setDefaultsFromResource(
   resourceName: string,
 ): Promise<null>;
 
+/**
+ * Starts listening for real-time config updates from the Remote Config backend and automatically
+ * fetches updates from the Remote Config backend when they are available.
+ *
+ * @remarks
+ * If a connection to the Remote Config backend is not already open, calling this method will
+ * open it. Multiple listeners can be added by calling this method again, but subsequent calls
+ * re-use the same connection to the backend.
+ *
+ * The list of updated keys passed to the callback will include all keys not currently active,
+ * and the config update process fetches the new config but does not automatically activate
+ * it for you. Typically you will activate the config in your callback to use the new values.
+ *
+ * @param remoteConfig - The {@link RemoteConfig} instance.
+ * @param observer - The {@link ConfigUpdateObserver} to be notified of config updates.
+ * @returns An {@link Unsubscribe} function to remove the listener.
+ */
+export function onConfigUpdate(
+  remoteConfig: RemoteConfig,
+  observer: ConfigUpdateObserver,
+): Unsubscribe;
+
 /**
  * Registers a listener to changes in the configuration.
  *
  * @param remoteConfig - RemoteConfig instance
  * @param callback - function called on config change
  * @returns {function} unsubscribe listener
+ * @deprecated use official firebase-js-sdk onConfigUpdate now that web supports realtime
  */
 export function onConfigUpdated(
   remoteConfig: RemoteConfig,

package/lib/modular/index.js

@@ -28,6 +28,8 @@ import { MODULAR_DEPRECATION_ARG } from '@react-native-firebase/app/lib/common';
  * @typedef {import('..').FirebaseRemoteConfigTypes.ConfigValues} ConfigValues
  * @typedef {import('..').FirebaseRemoteConfigTypes.LastFetchStatusType} LastFetchStatusType
  * @typedef {import('..').FirebaseRemoteConfigTypes.RemoteConfigLogLevel} RemoteConfigLogLevel
+ * @typedef {import('..').FirebaseRemoteConfigTypes.ConfigUpdateObserver} ConfigUpdateObserver
+ * @typedef {import('..').FirebaseRemoteConfigTypes.Unsubscribe} Unsubscribe
  * @typedef {import('.').CustomSignals} CustomSignals
  */
 
@@ -239,12 +241,25 @@ export function setDefaultsFromResource(remoteConfig, resourceName) {
   );
 }
 
+/**
+ * Registers a listener to changes in the configuration.
+ *
+ * @param {RemoteConfig} remoteConfig - RemoteConfig instance
+ * @param {ConfigUpdateObserver} observer - to be notified of config updates.
+ * @returns {Unsubscribe} function to remove the listener.
+ * @deprecated use official firebase-js-sdk onConfigUpdate now that web supports realtime
+ */
+export function onConfigUpdate(remoteConfig, observer) {
+  return remoteConfig.onConfigUpdate.call(remoteConfig, observer, MODULAR_DEPRECATION_ARG);
+}
+
 /**
  * Registers a listener to changes in the configuration.
  *
  * @param {RemoteConfig} remoteConfig - RemoteConfig instance
  * @param {CallbackOrObserver<OnConfigUpdatedListenerCallback>} callback - function called on config change
  * @returns {function} unsubscribe listener
+ * @deprecated use official firebase-js-sdk onConfigUpdate now that web supports realtime
  */
 export function onConfigUpdated(remoteConfig, callback) {
   return remoteConfig.onConfigUpdated.call(remoteConfig, callback, MODULAR_DEPRECATION_ARG);

package/lib/polyfills.js

@@ -1,8 +1,9 @@
-/*
- * Copyright (c) 2016-present Invertase Limited & Contributors
+/**
+ * @license
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this library except in compliance with the License.
+ * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *   http://www.apache.org/licenses/LICENSE-2.0
@@ -12,17 +13,20 @@
  * 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 { polyfillGlobal } from 'react-native/Libraries/Utilities/PolyfillFunctions';
+import { ReadableStream } from 'web-streams-polyfill/dist/ponyfill';
+import { fetch, Headers, Request, Response } from 'react-native-fetch-api';
 
-// maybe this could be remote-config local install of text-encoding (similar to ai package)
-import { TextEncoder, TextDecoder } from 'text-encoding';
+polyfillGlobal(
+  'fetch',
+  () =>
+    (...args) =>
+      fetch(args[0], { ...args[1], reactNative: { textStreaming: true } }),
+);
+polyfillGlobal('Headers', () => Headers);
+polyfillGlobal('Request', () => Request);
+polyfillGlobal('Response', () => Response);
+polyfillGlobal('ReadableStream', () => ReadableStream);
 
-polyfillGlobal('TextEncoder', () => TextEncoder);
-polyfillGlobal('TextDecoder', () => TextDecoder);
-// Object.assign(global, {
-//   TextEncoder: TextEncoder,
-//   TextDecoder: TextDecoder,
-// });
+import 'text-encoding';

package/lib/version.js

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

package/lib/web/RNFBConfigModule.js

@@ -8,9 +8,10 @@ import {
   fetchConfig,
   getAll,
   makeIDBAvailable,
+  onConfigUpdate,
   setCustomSignals,
 } from '@react-native-firebase/app/lib/internal/web/firebaseRemoteConfig';
-import { guard, getWebError } from '@react-native-firebase/app/lib/internal/web/utils';
+import { guard, getWebError, emitEvent } from '@react-native-firebase/app/lib/internal/web/utils';
 
 let configSettingsForInstance = {
   // [APP_NAME]: RemoteConfigSettings
@@ -24,6 +25,8 @@ function makeGlobalsAvailable() {
   makeIDBAvailable();
 }
 
+const onConfigUpdateListeners = {};
+
 function getRemoteConfigInstanceForApp(appName, overrides /*: RemoteConfigSettings */) {
   makeGlobalsAvailable();
   const configSettings = configSettingsForInstance[appName] ?? {
@@ -122,10 +125,37 @@ export default {
       return resultAndConstants(remoteConfig, null);
     });
   },
-  onConfigUpdated() {
-    throw getWebError({
-      code: 'unsupported',
-      message: 'Not supported by the Firebase Javascript SDK.',
-    });
+  onConfigUpdated(appName) {
+    if (onConfigUpdateListeners[appName]) {
+      return;
+    }
+
+    const remoteConfig = getRemoteConfigInstanceForApp(appName);
+
+    const nativeObserver = {
+      next: configUpdate => {
+        emitEvent('on_config_updated', {
+          appName,
+          resultType: 'success',
+          updatedKeys: Array.from(configUpdate.getUpdatedKeys()),
+        });
+      },
+      error: firebaseError => {
+        emitEvent('on_config_updated', {
+          appName,
+          event: getWebError(firebaseError),
+        });
+      },
+      complete: () => {},
+    };
+
+    onConfigUpdateListeners[appName] = onConfigUpdate(remoteConfig, nativeObserver);
+  },
+  removeConfigUpdateRegistration(appName) {
+    if (!onConfigUpdateListeners[appName]) {
+      return;
+    }
+    onConfigUpdateListeners[appName]();
+    delete onConfigUpdateListeners[appName];
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/remote-config",
-  "version": "23.4.1",
+  "version": "23.5.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "React Native Firebase - React Native Firebase provides native integration with Remote Config, allowing you to change the appearance and/or functionality of your app without requiring an app update.",
   "main": "lib/index.js",
@@ -24,18 +24,20 @@
     "remote-config"
   ],
   "peerDependencies": {
-    "@react-native-firebase/analytics": "23.4.1",
-    "@react-native-firebase/app": "23.4.1"
+    "@react-native-firebase/analytics": "23.5.0",
+    "@react-native-firebase/app": "23.5.0"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "text-encoding": "^0.7.0"
+    "react-native-fetch-api": "^3.0.0",
+    "text-encoding": "^0.7.0",
+    "web-streams-polyfill": "^4.2.0"
   },
   "devDependencies": {
     "@types/text-encoding": "^0.0.40"
   },
-  "gitHead": "15a0d8ddaedcaeedf9ee322ff31810f8873c400a"
+  "gitHead": "5d27948f349d4d6c977c55036e2afd13df8d622f"
 }