@react-native-firebase/app 23.7.0 → 23.8.1

package/lib/types/internal.ts

@@ -0,0 +1,142 @@
+/*
+ * 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 type { ReactNativeFirebase, Utils } from './app';
+
+/**
+ * Internal types for React Native Firebase
+ * These types are used internally across multiple files and should not be exported to consumers
+ */
+
+/**
+ * Firebase JSON configuration from firebase.json file
+ * Structure: { "react-native": { [key: string]: boolean | string }, ... }
+ */
+export type FirebaseJsonConfig = Record<string, unknown>;
+
+/**
+ * Configuration for module namespace registration
+ */
+export interface ModuleConfig {
+  namespace: string;
+  nativeModuleName?: string | string[];
+  hasMultiAppSupport?: boolean;
+  hasCustomUrlOrRegionSupport?: boolean;
+  nativeEvents?: boolean | string[];
+  disablePrependCustomUrlOrRegion?: boolean;
+  turboModule?: boolean;
+}
+
+/**
+ * Extended configuration for namespace registration including native module details
+ */
+export interface NamespaceConfig extends ModuleConfig {
+  nativeModuleName: string | string[];
+  nativeEvents: boolean | string[];
+  // ModuleClass can be FirebaseModule or any subclass of it
+  // Uses FirebaseAppBase (the concrete class type) rather than FirebaseApp (the augmented interface)
+  ModuleClass: new (
+    app: ReactNativeFirebase.FirebaseAppBase,
+    config: ModuleConfig,
+    customUrlOrRegion?: string | null,
+  ) => ReactNativeFirebase.FirebaseModule;
+  statics?: object;
+  version?: string;
+}
+
+/**
+ * Type for a Firebase module getter function that can optionally accept
+ * a custom URL/region/databaseId parameter
+ */
+export type ModuleGetter = {
+  (customUrlOrRegionOrDatabaseId?: string): ReactNativeFirebase.FirebaseModule;
+  [key: string]: unknown;
+};
+
+/**
+ * Type for Firebase root object with module getters
+ */
+export interface FirebaseRoot {
+  initializeApp: (
+    options: ReactNativeFirebase.FirebaseAppOptions,
+    configOrName?: string | ReactNativeFirebase.FirebaseAppConfig,
+  ) => Promise<ReactNativeFirebase.FirebaseApp>;
+  setReactNativeAsyncStorage: (asyncStorage: ReactNativeFirebase.ReactNativeAsyncStorage) => void;
+  app: (name?: string) => ReactNativeFirebase.FirebaseApp;
+  apps: ReactNativeFirebase.FirebaseApp[];
+  SDK_VERSION: string;
+  setLogLevel: (logLevel: ReactNativeFirebase.LogLevelString) => void;
+  utils: Utils.Statics & (() => Utils.Module);
+  [key: string]: unknown;
+}
+
+/**
+ * Native error types
+ */
+export interface NativeErrorUserInfo {
+  code?: string;
+  message?: string;
+  nativeErrorCode?: string | number;
+  nativeErrorMessage?: string;
+  [key: string]: any;
+}
+
+export interface NativeError {
+  userInfo: NativeErrorUserInfo;
+  message?: string;
+  customData?: any;
+  operationType?: string;
+}
+
+/**
+ * AsyncStorage interface compatible with React Native AsyncStorage
+ * Internal version used by the library
+ */
+export interface AsyncStorageStatic {
+  setItem: (key: string, value: string) => Promise<void>;
+  getItem: (key: string) => Promise<string | null>;
+  removeItem: (key: string) => Promise<void>;
+}
+
+/**
+ * Common utility types
+ */
+export interface DataUrlParts {
+  base64String: string | undefined;
+  mediaType: string | undefined;
+}
+
+export interface Observer<T> {
+  next: (value: T) => void;
+  error?: (error: Error) => void;
+  complete?: () => void;
+}
+
+export interface SerializedValue {
+  type: string;
+  value: any;
+}
+
+export interface Deferred<T> {
+  promise: Promise<T>;
+  resolve: ((value: T) => void) | null;
+  reject: ((reason?: any) => void) | null;
+}
+
+export type Callback<T> =
+  | ((error: Error | null, result?: T) => void)
+  | ((error: Error | null) => void);

package/lib/utils/{UtilsStatics.js → UtilsStatics.ts}

@@ -16,7 +16,9 @@
  */
 
 import { NativeModules } from 'react-native';
-import { stripTrailingSlash, isOther } from '../../lib/common';
+import { stripTrailingSlash, isOther } from '../common';
+import { Utils } from '../types/app';
+import { version } from '../version';
 
 const PATH_NAMES = [
   'MAIN_BUNDLE',
@@ -28,38 +30,44 @@ const PATH_NAMES = [
   'LIBRARY_DIRECTORY',
   'PICTURES_DIRECTORY',
   'MOVIES_DIRECTORY',
-];
+] as const;
 
-const PATH_FILE_TYPES = ['FILE_TYPE_REGULAR', 'FILE_TYPE_DIRECTORY'];
+const PATH_FILE_TYPES = ['FILE_TYPE_REGULAR', 'FILE_TYPE_DIRECTORY'] as const;
 
-const paths = {};
+const paths: Partial<Utils.FilePath> = {};
 let processedPathConstants = false;
 
-function processPathConstants(nativeModule) {
+function processPathConstants(nativeModule: any): Utils.FilePath {
   if (processedPathConstants || !nativeModule) {
-    return paths;
+    return paths as Utils.FilePath;
   }
   processedPathConstants = true;
 
   for (let i = 0; i < PATH_NAMES.length; i++) {
     const path = PATH_NAMES[i];
-    paths[path] = nativeModule[path] ? stripTrailingSlash(nativeModule[path]) : null;
+    if (path) {
+      (paths as any)[path] = nativeModule[path] ? stripTrailingSlash(nativeModule[path]) : null;
+    }
   }
 
   for (let i = 0; i < PATH_FILE_TYPES.length; i++) {
     const pathFileType = PATH_FILE_TYPES[i];
-    paths[pathFileType] = stripTrailingSlash(nativeModule[pathFileType]);
+    if (pathFileType) {
+      (paths as any)[pathFileType] = stripTrailingSlash(nativeModule[pathFileType]);
+    }
   }
 
   Object.freeze(paths);
 
-  return paths;
+  return paths as Utils.FilePath;
 }
 
-export default {
-  SDK_VERSION: require('./../version'),
-  get FilePath() {
+const statics: Utils.Statics = {
+  SDK_VERSION: version,
+  get FilePath(): Utils.FilePath {
     // We don't support path constants on non-native platforms.
     return processPathConstants(isOther ? {} : NativeModules.RNFBUtilsModule);
   },
 };
+
+export default statics;

package/lib/utils/index.ts

@@ -0,0 +1,94 @@
+/*
+ * 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 { isIOS } from '../common';
+import { createModuleNamespace, FirebaseModule } from '../internal';
+import UtilsStatics from './UtilsStatics';
+import { Utils } from '../types/app';
+
+const namespace = 'utils';
+const statics = UtilsStatics;
+const nativeModuleName = 'RNFBUtilsModule';
+
+class FirebaseUtilsModule extends FirebaseModule<'RNFBUtilsModule'> {
+  get isRunningInTestLab(): boolean {
+    if (isIOS) {
+      return false;
+    }
+    return this.native.isRunningInTestLab;
+  }
+
+  get playServicesAvailability(): Utils.PlayServicesAvailability {
+    if (isIOS) {
+      return {
+        isAvailable: true,
+        status: 0,
+        hasResolution: false,
+        isUserResolvableError: false,
+        error: undefined,
+      };
+    }
+    return this.native.androidPlayServices;
+  }
+
+  getPlayServicesStatus(): Promise<Utils.PlayServicesAvailability> {
+    if (isIOS) {
+      return Promise.resolve({
+        isAvailable: true,
+        status: 0,
+        hasResolution: false,
+        isUserResolvableError: false,
+        error: undefined,
+      });
+    }
+    return this.native.androidGetPlayServicesStatus();
+  }
+
+  promptForPlayServices(): Promise<void> {
+    if (isIOS) {
+      return Promise.resolve();
+    }
+    return this.native.androidPromptForPlayServices();
+  }
+
+  makePlayServicesAvailable(): Promise<void> {
+    if (isIOS) {
+      return Promise.resolve();
+    }
+    return this.native.androidMakePlayServicesAvailable();
+  }
+
+  resolutionForPlayServices(): Promise<void> {
+    if (isIOS) {
+      return Promise.resolve();
+    }
+    return this.native.androidResolutionForPlayServices();
+  }
+}
+
+// import { utils } from '@react-native-firebase/app';
+// utils().X(...);
+export default createModuleNamespace({
+  statics,
+  version: UtilsStatics.SDK_VERSION,
+  namespace,
+  nativeModuleName,
+  nativeEvents: false,
+  hasMultiAppSupport: false,
+  hasCustomUrlOrRegionSupport: false,
+  ModuleClass: FirebaseUtilsModule,
+}) as unknown as Utils.Statics & (() => Utils.Module);

package/lib/version.ts

@@ -0,0 +1,2 @@
+// Generated by genversion.
+export const version = '23.8.1';

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "@react-native-firebase/app",
-  "version": "23.7.0",
+  "version": "23.8.1",
   "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",
-  "types": "lib/index.d.ts",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/module/index.js",
+  "types": "./dist/typescript/commonjs/lib/index.d.ts",
   "scripts": {
-    "build": "genversion --semi lib/version.js && npm run build:version",
+    "build": "genversion --esm --semi lib/version.ts && npm run build:version",
     "build:version": "node ./scripts/genversion-ios && node ./scripts/genversion-android",
     "build:clean": "rimraf android/build && rimraf ios/build",
     "build:plugin": "rimraf plugin/build && tsc --build plugin",
     "lint:plugin": "eslint plugin/src/*",
-    "prepare": "npm run build && npm run build:plugin"
+    "compile": "bob build",
+    "prepare": "npm run build && npm run build:plugin && npm run compile"
   },
   "repository": {
     "type": "git",
@@ -51,17 +53,76 @@
     "dynamic-links",
     "crashlytics"
   ],
+  "exports": {
+    ".": {
+      "source": "./lib/index.ts",
+      "import": {
+        "types": "./dist/typescript/module/lib/index.d.ts",
+        "default": "./dist/module/index.js"
+      },
+      "require": {
+        "types": "./dist/typescript/commonjs/lib/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./lib/internal": {
+      "source": "./lib/internal/index.ts",
+      "import": {
+        "types": "./dist/typescript/module/lib/internal/index.d.ts",
+        "default": "./dist/module/internal/index.js"
+      },
+      "require": {
+        "types": "./dist/typescript/commonjs/lib/internal/index.d.ts",
+        "default": "./dist/commonjs/internal/index.js"
+      }
+    },
+    "./lib/internal/*": {
+      "source": "./lib/internal/*.ts",
+      "import": {
+        "types": "./dist/typescript/module/lib/internal/*.d.ts",
+        "default": "./dist/module/internal/*"
+      },
+      "require": {
+        "types": "./dist/typescript/commonjs/lib/internal/*.d.ts",
+        "default": "./dist/commonjs/internal/*"
+      }
+    },
+    "./lib/common": {
+      "source": "./lib/common/index.ts",
+      "import": {
+        "types": "./dist/typescript/module/lib/common/index.d.ts",
+        "default": "./dist/module/common/index.js"
+      },
+      "require": {
+        "types": "./dist/typescript/commonjs/lib/common/index.d.ts",
+        "default": "./dist/commonjs/common/index.js"
+      }
+    },
+    "./lib/common/*": {
+      "source": "./lib/common/*.ts",
+      "import": {
+        "types": "./dist/typescript/module/lib/common/*.d.ts",
+        "default": "./dist/module/common/*"
+      },
+      "require": {
+        "types": "./dist/typescript/commonjs/lib/common/*.d.ts",
+        "default": "./dist/commonjs/common/*"
+      }
+    },
+    "./package.json": "./package.json"
+  },
   "peerDependencies": {
     "expo": ">=47.0.0",
     "react": "*",
     "react-native": "*"
   },
   "dependencies": {
-    "firebase": "12.6.0"
+    "firebase": "12.7.0"
   },
   "devDependencies": {
     "@react-native-async-storage/async-storage": "^2.2.0",
-    "expo": "^54.0.27"
+    "expo": "^54.0.27",
+    "react-native-builder-bob": "^0.40.17"
   },
   "peerDependenciesMeta": {
     "expo": {
@@ -74,7 +135,7 @@
   },
   "sdkVersions": {
     "ios": {
-      "firebase": "12.6.0",
+      "firebase": "12.7.0",
       "iosTarget": "15.0",
       "macosTarget": "10.15",
       "tvosTarget": "15.0"
@@ -91,5 +152,34 @@
       "firebaseAppDistributionGradle": "5.2.0"
     }
   },
-  "gitHead": "2a30c0b1e41a2b239172afd167f98a03fd422f2c"
+  "react-native-builder-bob": {
+    "source": "lib",
+    "output": "dist",
+    "exclude": "**/*.d.ts",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "commonjs",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "tsc": "../../node_modules/.bin/tsc"
+        }
+      ]
+    ]
+  },
+  "eslintIgnore": [
+    "node_modules/",
+    "dist/"
+  ],
+  "gitHead": "46b06d2b1100ec03c7807b4ff34b583b773a19d7"
 }

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.packages.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "rootDir": ".",
+    "lib": ["ESNext", "DOM"]
+  },
+  "include": ["lib/**/*"],
+  "exclude": ["node_modules", "dist", "__tests__", "**/*.test.ts"]
+}

package/lib/internal/asyncStorage.js

@@ -1,47 +0,0 @@
-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/logger.d.ts

@@ -1,85 +0,0 @@
-export type LogLevelString = 'debug' | 'verbose' | 'info' | 'warn' | 'error' | 'silent';
-
-export interface LogOptions {
-  level: LogLevelString;
-}
-
-export type LogCallback = (callbackParams: LogCallbackParams) => void;
-
-export interface LogCallbackParams {
-  level: LogLevelString;
-  message: string;
-  args: unknown[];
-  type: string;
-}
-
-/**
- * A container for all of the Logger instances
- */
-export const instances: Logger[] = [];
-
-/**
- * The JS SDK supports 5 log levels and also allows a user the ability to
- * silence the logs altogether.
- *
- * The order is a follows:
- * DEBUG < VERBOSE < INFO < WARN < ERROR
- *
- * All of the log types above the current log level will be captured (i.e. if
- * you set the log level to `INFO`, errors will still be logged, but `DEBUG` and
- * `VERBOSE` logs will not)
- */
-export enum LogLevel {
-  DEBUG,
-  VERBOSE,
-  INFO,
-  WARN,
-  ERROR,
-  SILENT,
-}
-
-type LevelStringToEnum = {
-  debug: LogLevel.DEBUG;
-  verbose: LogLevel.VERBOSE;
-  info: LogLevel.INFO;
-  warn: LogLevel.WARN;
-  error: LogLevel.ERROR;
-  silent: LogLevel.SILENT;
-};
-
-/**
- * The default log level
- */
-type DefaultLogLevel = LogLevel.INFO;
-
-/**
- * We allow users the ability to pass their own log handler. We will pass the
- * type of log, the current log level, and any other arguments passed (i.e. the
- * messages that the user wants to log) to this function.
- */
-export type LogHandler = (loggerInstance: Logger, logType: LogLevel, ...args: unknown[]) => void;
-
-export class Logger {
-  constructor(name: string);
-
-  get logLevel(): LogLevel;
-  set logLevel(val: LogLevel);
-
-  setLogLevel(val: LogLevel | LogLevelString): void;
-
-  get logHandler(): LogHandler;
-  set logHandler(val: LogHandler);
-
-  get userLogHandler(): LogHandler | null;
-  set userLogHandler(val: LogHandler | null);
-
-  debug(...args: unknown[]): void;
-  log(...args: unknown[]): void;
-  info(...args: unknown[]): void;
-  warn(...args: unknown[]): void;
-  error(...args: unknown[]): void;
-}
-
-export const setLogLevel: (level: LogLevelString | LogLevel) => void;
-
-export const setUserLogHandler: (logCallback: LogCallback | null, options?: LogOptions) => void;

package/lib/internal/nativeModuleAndroidIos.js

@@ -1,45 +0,0 @@
-/* eslint-disable no-console */
-import { NativeModules } from 'react-native';
-
-/**
- * This is used by Android and iOS to get a native module.
- * We additionally add a Proxy to the module to intercept calls
- * and log them to the console for debugging purposes, if enabled.
- * @param moduleName
- */
-export function getReactNativeModule(moduleName) {
-  const nativeModule = NativeModules[moduleName];
-  if (!globalThis.RNFBDebug) {
-    return nativeModule;
-  }
-  return new Proxy(nativeModule, {
-    ownKeys(target) {
-      return Object.keys(target);
-    },
-    get: (_, name) => {
-      if (typeof nativeModule[name] !== 'function') return nativeModule[name];
-      return (...args) => {
-        console.debug(`[RNFB->Native][🔵] ${moduleName}.${name} -> ${JSON.stringify(args)}`);
-        const result = nativeModule[name](...args);
-        if (result && result.then) {
-          return result.then(
-            res => {
-              console.debug(`[RNFB<-Native][🟢] ${moduleName}.${name} <- ${JSON.stringify(res)}`);
-              return res;
-            },
-            err => {
-              console.debug(`[RNFB<-Native][🔴] ${moduleName}.${name} <- ${JSON.stringify(err)}`);
-              throw err;
-            },
-          );
-        }
-        console.debug(`[RNFB<-Native][🟢] ${moduleName}.${name} <- ${JSON.stringify(result)}`);
-        return result;
-      };
-    },
-  });
-}
-
-export function setReactNativeModule() {
-  // No-op
-}

package/lib/internal/nativeModuleWeb.js

@@ -1,49 +0,0 @@
-/* eslint-disable no-console */
-
-import RNFBAppModule from './web/RNFBAppModule';
-
-const nativeModuleRegistry = {};
-
-export function getReactNativeModule(moduleName) {
-  const nativeModule = nativeModuleRegistry[moduleName];
-  // Throw an error if the module is not registered.
-  if (!nativeModule) {
-    throw new Error(`Native module ${moduleName} is not registered.`);
-  }
-  if (!globalThis.RNFBDebug) {
-    return nativeModule;
-  }
-  return new Proxy(nativeModule, {
-    ownKeys(target) {
-      // FIXME - test in new arch context - I don't think Object.keys works
-      return Object.keys(target);
-    },
-    get: (_, name) => {
-      if (typeof nativeModule[name] !== 'function') return nativeModule[name];
-      return (...args) => {
-        console.debug(`[RNFB->Native][🔵] ${moduleName}.${name} -> ${JSON.stringify(args)}`);
-        const result = nativeModule[name](...args);
-        if (result && result.then) {
-          return result.then(
-            res => {
-              console.debug(`[RNFB<-Native][🟢] ${moduleName}.${name} <- ${JSON.stringify(res)}`);
-              return res;
-            },
-            err => {
-              console.debug(`[RNFB<-Native][🔴] ${moduleName}.${name} <- ${JSON.stringify(err)}`);
-              throw err;
-            },
-          );
-        }
-        console.debug(`[RNFB<-Native][🟢] ${moduleName}.${name} <- ${JSON.stringify(result)}`);
-        return result;
-      };
-    },
-  });
-}
-
-export function setReactNativeModule(moduleName, nativeModule) {
-  nativeModuleRegistry[moduleName] = nativeModule;
-}
-
-setReactNativeModule('RNFBAppModule', RNFBAppModule);