@react-native-firebase/app 20.2.0 → 20.3.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [20.3.0](https://github.com/invertase/react-native-firebase/compare/v20.2.1...v20.3.0) (2024-07-19)
+
+### Bug Fixes
+
+- **other:** add api for persistence via Async Storage ([030eea9](https://github.com/invertase/react-native-firebase/commit/030eea91f297a4014ab86cfb141ae938f200c5e5))
+
+## [20.2.1](https://github.com/invertase/react-native-firebase/compare/v20.2.0...v20.2.1) (2024-07-17)
+
+**Note:** Version bump only for package @react-native-firebase/app
+
 ## [20.2.0](https://github.com/invertase/react-native-firebase/compare/v20.1.0...v20.2.0) (2024-07-15)
 
 ### Features

package/android/src/reactnative/java/io/invertase/firebase/app/ReactNativeFirebaseVersion.java

@@ -18,5 +18,5 @@ package io.invertase.firebase.app;
  */
 // generated file - do not modify or commit
 public class ReactNativeFirebaseVersion {
-  public static String VERSION = "20.2.0";
+  public static String VERSION = "20.3.0";
 }

package/ios/RNFBApp/RNFBVersion.m

@@ -18,4 +18,4 @@
 #import <React/RCTVersion.h>
 
 // generated file - do not modify or commit
-NSString* const RNFBVersionString = @"20.2.0";
+NSString* const RNFBVersionString = @"20.3.0";

package/lib/index.d.ts

@@ -158,6 +158,36 @@ export namespace ReactNativeFirebase {
     utils(): Utils.Module;
   }
 
+  /**
+   * Interface for a supplied `AsyncStorage`.
+   */
+  export interface ReactNativeAsyncStorage {
+    /**
+     * Persist an item in storage.
+     *
+     * @param key - storage key.
+     * @param value - storage value.
+     */
+    // eslint-disable-next-line @typescript-eslint/ban-types
+    setItem: Function;
+    /**
+     * Retrieve an item from storage.
+     *
+     * @param key - storage key.
+     */
+    // eslint-disable-next-line @typescript-eslint/ban-types
+    getItem: Function;
+    /**
+     * Remove an item from storage.
+     *
+     * @param key - storage key.
+     */
+    // eslint-disable-next-line @typescript-eslint/ban-types
+    removeItem: Function;
+
+    [key: string]: any;
+  }
+
   export interface Module {
     /**
      * Create (and initialize) a FirebaseApp.
@@ -201,6 +231,14 @@ export namespace ReactNativeFirebase {
      */
     setLogLevel(logLevel: LogLevelString): void;
 
+    /**
+     * The `AsyncStorage` implementation to use for persisting data on 'Other' platforms.
+     * If not specified, in memory persistence is used.
+     *
+     * This is required if you want to persist things like Auth sessions, Analytics device IDs, etc.
+     */
+    setReactNativeAsyncStorage(asyncStorage: ReactNativeAsyncStorage): void;
+
     /**
      * A (read-only) array of all the initialized Apps.
      */

package/lib/internal/asyncStorage.js

@@ -0,0 +1,47 @@
+export const memoryStorage = new Map();
+
+export const prefix = '@react-native-firebase:';
+
+const asyncStorageMemory = {
+  setItem(key, value) {
+    memoryStorage.set(key, value);
+    return Promise.resolve();
+  },
+  getItem(key) {
+    const hasValue = memoryStorage.has(key);
+    if (hasValue) {
+      return Promise.resolve(memoryStorage.get(key));
+    }
+    return Promise.resolve(null);
+  },
+  removeItem: function (key) {
+    memoryStorage.delete(key);
+    return Promise.resolve();
+  },
+};
+
+let asyncStorage = asyncStorageMemory;
+
+export async function getReactNativeAsyncStorageInternal() {
+  return asyncStorage;
+}
+
+export function setReactNativeAsyncStorageInternal(asyncStorageInstance) {
+  asyncStorage = asyncStorageInstance || asyncStorageMemory;
+}
+
+export function isMemoryStorage() {
+  return asyncStorage === asyncStorageMemory;
+}
+
+export async function setItem(key, value) {
+  return await asyncStorage.setItem(prefix + key, value);
+}
+
+export async function getItem(key) {
+  return await asyncStorage.getItem(prefix + key);
+}
+
+export async function removeItem(key) {
+  return await asyncStorage.removeItem(prefix + key);
+}

package/lib/internal/registry/app.js

@@ -20,11 +20,13 @@ import {
   isOther,
   isNull,
   isObject,
+  isFunction,
   isString,
   isUndefined,
 } from '@react-native-firebase/app/lib/common';
 import FirebaseApp from '../../FirebaseApp';
 import { DEFAULT_APP_NAME } from '../constants';
+import { setReactNativeAsyncStorageInternal } from '../asyncStorage';
 import { getAppModule } from './nativeModule';
 
 const APP_REGISTRY = {};
@@ -172,7 +174,7 @@ export function initializeApp(options = {}, configOrName) {
     );
   }
 
-  const app = new FirebaseApp(options, { name }, false, deleteApp.bind(null, name, true));
+  const app = new FirebaseApp(options, appConfig, false, deleteApp.bind(null, name, true));
 
   // Note these initialization actions with side effects are performed prior to knowledge of
   // successful initialization in the native code. Native code *may* throw an error.
@@ -180,7 +182,7 @@ export function initializeApp(options = {}, configOrName) {
   onAppCreateFn(APP_REGISTRY[name]);
 
   return getAppModule()
-    .initializeApp(options, { name })
+    .initializeApp(options, appConfig)
     .then(() => {
       app._initialized = true;
       return app;
@@ -207,6 +209,32 @@ export function setLogLevel(logLevel) {
   }
 }
 
+export function setReactNativeAsyncStorage(asyncStorage) {
+  if (!isObject(asyncStorage)) {
+    throw new Error("firebase.setReactNativeAsyncStorage(*) 'asyncStorage' must be an object.");
+  }
+
+  if (!isFunction(asyncStorage.setItem)) {
+    throw new Error(
+      "firebase.setReactNativeAsyncStorage(*) 'asyncStorage.setItem' must be a function.",
+    );
+  }
+
+  if (!isFunction(asyncStorage.getItem)) {
+    throw new Error(
+      "firebase.setReactNativeAsyncStorage(*) 'asyncStorage.getItem' must be a function.",
+    );
+  }
+
+  if (!isFunction(asyncStorage.removeItem)) {
+    throw new Error(
+      "firebase.setReactNativeAsyncStorage(*) 'asyncStorage.removeItem' must be a function.",
+    );
+  }
+
+  setReactNativeAsyncStorageInternal(asyncStorage);
+}
+
 /**
  *
  */

package/lib/internal/registry/namespace.js

@@ -25,6 +25,7 @@ import {
   getApps,
   initializeApp,
   setLogLevel,
+  setReactNativeAsyncStorage,
   setOnAppCreate,
   setOnAppDestroy,
 } from './app';
@@ -241,6 +242,7 @@ export function firebaseAppModuleProxy(app, moduleNamespace) {
 export function createFirebaseRoot() {
   FIREBASE_ROOT = {
     initializeApp,
+    setReactNativeAsyncStorage,
     get app() {
       return getApp;
     },

package/lib/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-native-firebase/app",
-  "version": "20.2.0",
+  "version": "20.3.0",
   "author": "Invertase <oss@invertase.io> (http://invertase.io)",
   "description": "A well tested, feature rich Firebase implementation for React Native, supporting iOS & Android. Individual module support for Admob, Analytics, Auth, Crash Reporting, Cloud Firestore, Database, Dynamic Links, Functions, Messaging (FCM), Remote Config, Storage and more.",
   "main": "lib/index.js",
@@ -58,10 +58,10 @@
   },
   "dependencies": {
     "firebase": "10.12.2",
-    "opencollective-postinstall": "^2.0.3",
     "superstruct": "^0.6.2"
   },
   "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.24.0",
     "expo": "^50.0.19"
   },
   "peerDependenciesMeta": {
@@ -89,5 +89,5 @@
       "playServicesAuth": "21.2.0"
     }
   },
-  "gitHead": "82c50138d07e673213cd8dee5ce9a2f9b5656649"
+  "gitHead": "a916b37b022cf40588fa0fd915b7ab901e2458d0"
 }