refactor(app): migrate to TypeScript

packages/ai/tsconfig.json

@@ -6,9 +6,7 @@
     "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
     "jsx": "react-jsx",
-    "lib": [
-      "ESNext"
-    ],
+    "lib": ["ESNext"],
     "module": "ESNext",
     "target": "ESNext",
     "moduleResolution": "Bundler",
@@ -24,9 +22,11 @@
     "strict": true,
     "baseUrl": ".",
     "paths": {
-      "@react-native-firebase/app": ["../app/lib"],
+      "@react-native-firebase/app": ["../app/dist/typescript/commonjs/lib"],
       "@react-native-firebase/auth": ["../auth/lib"],
-      "@react-native-firebase/app-check": ["../app-check/lib"],
+      "@react-native-firebase/app-check": ["../app-check/lib"]
     }
-  }
+  },
+  "include": ["lib/**/*"],
+  "exclude": ["node_modules", "dist", "__tests__", "**/*.test.ts"]
 }

packages/analytics/lib/internal-types/native-modules.d.ts

@@ -0,0 +1,61 @@
+/*
+ * 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.
+ *
+ */
+
+/**
+ * Internal type definitions for the Analytics native module.
+ * This file augments the base ReactNativeFirebaseNativeModules interface
+ * to add analytics-specific native methods.
+ *
+ * @internal - This file is not exposed to package consumers
+ */
+
+import type { ConsentSettings } from './types/analytics';
+
+/**
+ * Interface for the Analytics native module methods
+ */
+export interface RNFBAnalyticsModuleInterface {
+  logEvent(name: string, params: { [key: string]: any }): Promise<void>;
+  setAnalyticsCollectionEnabled(enabled: boolean): Promise<void>;
+  setSessionTimeoutDuration(milliseconds: number): Promise<void>;
+  getAppInstanceId(): Promise<string | null>;
+  getSessionId(): Promise<number | null>;
+  setUserId(id: string | null): Promise<void>;
+  setUserProperty(name: string, value: string | null): Promise<void>;
+  setUserProperties(properties: { [key: string]: string | null }): Promise<void>;
+  resetAnalyticsData(): Promise<void>;
+  setConsent(consentSettings: ConsentSettings): Promise<void>;
+  setDefaultEventParameters(params: { [key: string]: any } | null | undefined): Promise<void>;
+  initiateOnDeviceConversionMeasurementWithEmailAddress(emailAddress: string): Promise<void>;
+  initiateOnDeviceConversionMeasurementWithHashedEmailAddress(
+    hashedEmailAddress: string,
+  ): Promise<void>;
+  initiateOnDeviceConversionMeasurementWithPhoneNumber(phoneNumber: string): Promise<void>;
+  initiateOnDeviceConversionMeasurementWithHashedPhoneNumber(
+    hashedPhoneNumber: string,
+  ): Promise<void>;
+}
+
+/**
+ * Augment the base ReactNativeFirebaseNativeModules interface
+ * from the app package to include our analytics module
+ */
+declare module '@react-native-firebase/app/lib/internal/NativeModules' {
+  interface ReactNativeFirebaseNativeModules {
+    RNFBAnalyticsModule: RNFBAnalyticsModuleInterface;
+  }
+}

packages/analytics/lib/internal-types/web-modules.d.ts

@@ -0,0 +1,52 @@
+/*
+ * 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.
+ *
+ */
+
+/**
+ * Type declarations for web-only modules from the app package.
+ * These modules are JavaScript files with separate .d.ts declarations.
+ *
+ * @internal - This file is not exposed to package consumers
+ */
+
+declare module '@react-native-firebase/app/lib/internal/web/firebaseApp' {
+  import type { ReactNativeFirebase } from '@react-native-firebase/app';
+
+  export function getApp(appName?: string): ReactNativeFirebase.FirebaseApp;
+}
+
+declare module '@react-native-firebase/app/lib/internal/web/utils' {
+  export function guard<T>(fn: () => T | Promise<T>): Promise<T>;
+}
+
+declare module '@react-native-firebase/app/lib/internal/web/firebaseInstallations' {
+  import type { ReactNativeFirebase } from '@react-native-firebase/app';
+
+  export interface Installations {
+    app: ReactNativeFirebase.FirebaseApp;
+  }
+
+  export type Unsubscribe = () => void;
+
+  export function getApp(appName?: string): ReactNativeFirebase.FirebaseApp;
+  export function getInstallations(app?: ReactNativeFirebase.FirebaseApp): Installations;
+  export function getId(installations: Installations): Promise<string>;
+  export function onIdChange(
+    installations: Installations,
+    callback: (installationId: string) => void,
+  ): Unsubscribe;
+  export function makeIDBAvailable(): void;
+}

packages/analytics/lib/namespaced.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  *
  */
-import { ReactNativeFirebase } from '@react-native-firebase/app';
+import type { ReactNativeFirebase } from '@react-native-firebase/app';
 import {
   isAlphaNumericUnderscore,
   isE164PhoneNumber,
@@ -37,6 +37,10 @@ import {
 import { setReactNativeModule } from '@react-native-firebase/app/lib/internal/nativeModule';
 import { isBoolean } from '@react-native-firebase/app/lib/common';
 
+// Import internal types to register native module augmentation
+import './internal-types/native-modules';
+import './internal-types/web-modules';
+
 import { validateStruct, validateCompound } from './struct';
 import { RNFBAnalyticsModule } from './web/RNFBAnalyticsModule';
 import { version } from './version';
@@ -120,7 +124,7 @@ const namespace = 'analytics';
 
 const nativeModuleName = 'RNFBAnalyticsModule';
 
-class FirebaseAnalyticsModule extends FirebaseModule {
+class FirebaseAnalyticsModule extends FirebaseModule<'RNFBAnalyticsModule'> {
   logEvent(
     name: string,
     params: { [key: string]: any } = {},
@@ -879,13 +883,13 @@ export default createModuleNamespace({
   hasMultiAppSupport: false,
   hasCustomUrlOrRegionSupport: false,
   ModuleClass: FirebaseAnalyticsModule,
-}) as typeof defaultExport;
+}) as unknown as typeof defaultExport;
 
 // Register the interop module for non-native platforms.
-setReactNativeModule(nativeModuleName, RNFBAnalyticsModule);
+setReactNativeModule(nativeModuleName, RNFBAnalyticsModule as unknown as Record<string, unknown>);
 
-export const firebase: FirebaseAnalyticsModule & {
+export const firebase = getFirebaseRoot() as unknown as typeof defaultExport & {
   analytics: typeof defaultExport;
   SDK_VERSION: string;
   app(name?: string): ReactNativeFirebase.FirebaseApp & { analytics(): FirebaseAnalyticsModule };
-} = getFirebaseRoot();
+};

packages/analytics/tsconfig.json

@@ -23,8 +23,16 @@
     "baseUrl": ".",
     "rootDir": ".",
     "paths": {
-      "@react-native-firebase/app/common/*": ["../app/lib/common/*"],
-      "@react-native-firebase/app": ["../app/lib"]
+      "@react-native-firebase/app/lib/common/*": ["../app/dist/typescript/commonjs/lib/common/*"],
+      "@react-native-firebase/app/lib/common": ["../app/dist/typescript/commonjs/lib/common"],
+      "@react-native-firebase/app/lib/internal/web/*": [
+        "../app/dist/typescript/commonjs/lib/internal/web/*"
+      ],
+      "@react-native-firebase/app/lib/internal/*": [
+        "../app/dist/typescript/commonjs/lib/internal/*"
+      ],
+      "@react-native-firebase/app/lib/internal": ["../app/dist/typescript/commonjs/lib/internal"],
+      "@react-native-firebase/app": ["../app/dist/typescript/commonjs/lib"]
     }
   },
   "include": ["lib/**/*"],

packages/app/lib/FirebaseApp.js → packages/app/lib/FirebaseApp.ts

@@ -14,12 +14,26 @@
  * limitations under the License.
  *
  */
-import { warnIfNotModularCall } from '@react-native-firebase/app/lib/common';
+import { warnIfNotModularCall } from './common';
 import { getAppModule } from './internal/registry/nativeModule';
+import type { ReactNativeFirebase, Utils } from './types';
 
-export default class FirebaseApp {
-  constructor(options, appConfig, fromNative, deleteApp) {
-    const { name, automaticDataCollectionEnabled } = appConfig;
+export default class FirebaseApp implements ReactNativeFirebase.FirebaseApp {
+  private _name: string;
+  private _deleted: boolean;
+  private _deleteApp: () => Promise<void>;
+  private _options: ReactNativeFirebase.FirebaseAppOptions;
+  private _automaticDataCollectionEnabled: boolean;
+  _initialized: boolean;
+  _nativeInitialized: boolean;
+
+  constructor(
+    options: ReactNativeFirebase.FirebaseAppOptions,
+    appConfig: ReactNativeFirebase.FirebaseAppConfig,
+    fromNative: boolean,
+    deleteApp: () => Promise<void>,
+  ) {
+    const { name = '[DEFAULT]', automaticDataCollectionEnabled } = appConfig;
 
     this._name = name;
     this._deleted = false;
@@ -36,44 +50,49 @@ export default class FirebaseApp {
     }
   }
 
-  get name() {
+  get name(): string {
     return this._name;
   }
 
-  get options() {
+  get options(): ReactNativeFirebase.FirebaseAppOptions {
     return Object.assign({}, this._options);
   }
 
-  get automaticDataCollectionEnabled() {
+  get automaticDataCollectionEnabled(): boolean {
     return this._automaticDataCollectionEnabled;
   }
 
-  set automaticDataCollectionEnabled(enabled) {
+  set automaticDataCollectionEnabled(enabled: boolean) {
     this._checkDestroyed();
     getAppModule().setAutomaticDataCollectionEnabled(this.name, enabled);
     this._automaticDataCollectionEnabled = enabled;
   }
 
-  _checkDestroyed() {
+  private _checkDestroyed(): void {
     if (this._deleted) {
       throw new Error(`Firebase App named '${this._name}' already deleted`);
     }
   }
 
-  extendApp(extendedProps) {
+  extendApp(extendedProps: Record<string, unknown>): void {
     warnIfNotModularCall(arguments);
     this._checkDestroyed();
     Object.assign(this, extendedProps);
   }
 
-  delete() {
+  delete(): Promise<void> {
     warnIfNotModularCall(arguments, 'deleteApp()');
     this._checkDestroyed();
     return this._deleteApp();
   }
 
-  toString() {
+  toString(): string {
     warnIfNotModularCall(arguments, '.name property');
     return this.name;
   }
+
+  // For backward compatibility - utils method added by registry
+  utils(): Utils.Module {
+    throw new Error('utils() should be added by registry');
+  }
 }