refactor(auth)!: migrate to TypeScript and bring auth closer in alignment with firebase-js-sdk API

.github/scripts/compare-types/configs/auth.ts

@@ -0,0 +1,191 @@
+/**
+ * Known differences between the firebase-js-sdk @firebase/auth public
+ * API and the @react-native-firebase/auth modular API.
+ *
+ * Each entry must have a `name` and a `reason`. Any undocumented
+ * difference or stale entry will fail `yarn compare:types`.
+ */
+
+import type { PackageConfig } from '../src/types';
+
+const config: PackageConfig = {
+  nameMapping: {},
+
+  missingInRN: [
+    {
+      name: 'initializeRecaptchaConfig',
+      reason:
+        'Web-only reCAPTCHA bootstrap helper from the firebase-js-sdk. RN Firebase does not expose browser reCAPTCHA initialization because native SDKs own the phone-auth verification flow.',
+    },
+    {
+      name: 'AuthErrorCodes',
+      reason:
+        'RN Firebase still relies on native auth error code strings and does not export the firebase-js-sdk AuthErrorCodes constant map.',
+    },
+    {
+      name: 'browserCookiePersistence',
+      reason:
+        'Browser-only persistence implementation from the firebase-js-sdk. Not applicable to React Native native-auth persistence.',
+    },
+    {
+      name: 'browserLocalPersistence',
+      reason:
+        'Browser-only localStorage persistence implementation from the firebase-js-sdk. Not applicable to React Native native-auth persistence.',
+    },
+    {
+      name: 'browserPopupRedirectResolver',
+      reason:
+        'Browser-only popup/redirect resolver from the firebase-js-sdk. Native provider flows do not use the browser popup resolver stack.',
+    },
+    {
+      name: 'browserSessionPersistence',
+      reason:
+        'Browser-only sessionStorage persistence implementation from the firebase-js-sdk. Not applicable to React Native native-auth persistence.',
+    },
+    {
+      name: 'debugErrorMap',
+      reason:
+        'firebase-js-sdk web error-map helper. RN Firebase does not expose the SDK error-map selection API.',
+    },
+    {
+      name: 'indexedDBLocalPersistence',
+      reason:
+        'IndexedDB persistence is web-only and not applicable to React Native native-auth persistence.',
+    },
+    {
+      name: 'inMemoryPersistence',
+      reason:
+        'The firebase-js-sdk persistence object is not exported by RN Firebase because auth state is managed by the underlying native SDKs.',
+    },
+    {
+      name: 'prodErrorMap',
+      reason:
+        'firebase-js-sdk web error-map helper. RN Firebase does not expose the SDK error-map selection API.',
+    },
+    {
+      name: 'ReactNativeAsyncStorage',
+      reason:
+        'The firebase-js-sdk React Native persistence helper type is not exported by RN Firebase because persistence is delegated to the native iOS/Android SDKs rather than configured through initializeAuth().',
+    },
+    {
+      name: 'RecaptchaParameters',
+      reason: 'Browser reCAPTCHA configuration is not part of the RN Firebase native auth surface.',
+    },
+    {
+      name: 'RecaptchaVerifier',
+      reason:
+        'Browser reCAPTCHA verifier implementation is not available in RN Firebase because native SDKs own application verification.',
+    },
+    {
+      name: 'SAMLAuthProvider',
+      reason:
+        'SAMLAuthProvider is not yet surfaced on the RN Firebase modular/public auth surface.',
+    },
+  ],
+
+  extraInRN: [
+    {
+      name: 'AppleAuthProvider',
+      reason:
+        'RN Firebase-specific Apple auth provider helper exposed for native Sign in with Apple flows; the firebase-js-sdk does not export a separate AppleAuthProvider class.',
+    },
+    {
+      name: 'NativeFirebaseAuthError',
+      reason:
+        'RN Firebase-specific native bridge auth error type used in place of the firebase-js-sdk AuthError export.',
+    },
+    {
+      name: 'OIDCAuthProvider',
+      reason:
+        'RN Firebase-specific OIDC auth provider class retained for compatibility with the existing public package surface; the firebase-js-sdk exposes OAuthProvider instead of a separate OIDCAuthProvider class.',
+    },
+    {
+      name: 'OIDCProvider',
+      reason:
+        'RN Firebase-specific OIDC provider class export retained for compatibility with the existing package surface.',
+    },
+    {
+      name: 'PhoneAuthState',
+      reason: 'RN Firebase-specific enum-like object describing native phone-auth listener states.',
+    },
+    {
+      name: 'PhoneAuthListener',
+      reason: 'RN Firebase-specific listener object returned by verifyPhoneNumber().',
+    },
+    {
+      name: 'PhoneAuthError',
+      reason:
+        'RN Firebase-specific phone verification error snapshot type used by native phone-auth listeners.',
+    },
+    {
+      name: 'PhoneAuthSnapshot',
+      reason:
+        'RN Firebase-specific phone verification snapshot type used by native phone-auth listeners.',
+    },
+    {
+      name: 'verifyPhoneNumber',
+      reason:
+        'RN Firebase-specific helper exposing the native phone verification listener flow; the firebase-js-sdk does not export this helper.',
+    },
+    {
+      name: 'setLanguageCode',
+      reason:
+        'RN Firebase keeps a modular helper for setting auth.languageCode, while the firebase-js-sdk only exposes the writable property.',
+    },
+    {
+      name: 'useUserAccessGroup',
+      reason:
+        'RN Firebase-specific iOS keychain sharing helper with no firebase-js-sdk equivalent.',
+    },
+    {
+      name: 'getCustomAuthDomain',
+      reason:
+        'RN Firebase-specific helper that exposes the configured native auth domain; no firebase-js-sdk equivalent exists.',
+    },
+  ],
+
+  differentShape: [
+    {
+      name: 'isSignInWithEmailLink',
+      reason:
+        'RN Firebase resolves this check asynchronously through the native bridge and returns Promise<boolean>, whereas the firebase-js-sdk returns a synchronous boolean.',
+    },
+    {
+      name: 'linkWithRedirect',
+      reason:
+        'Native provider flows resolve immediately with a UserCredential instead of following the browser redirect contract used by the firebase-js-sdk.',
+    },
+    {
+      name: 'reauthenticateWithRedirect',
+      reason:
+        'Native provider flows do not follow the browser redirect contract. RN Firebase models this as Promise<void> rather than the firebase-js-sdk Promise<never> signature.',
+    },
+    {
+      name: 'signInWithRedirect',
+      reason:
+        'Native provider flows resolve immediately with a UserCredential instead of following the browser redirect contract used by the firebase-js-sdk.',
+    },
+    {
+      name: 'OAuthProvider',
+      reason:
+        'RN Firebase supports the firebase-js-sdk credential(options) and credentialFromJSON APIs, but its native helper class still differs by retaining RNFB provider configuration helpers and omitting credentialFromResult/credentialFromError helpers.',
+    },
+    {
+      name: 'PhoneAuthProvider',
+      reason:
+        'RN Firebase now mirrors the firebase-js-sdk credential and single-factor verifyPhoneNumber signatures while retaining an RNFB multi-factor overload; it still omits credentialFromResult/credentialFromError helpers because native provider results do not expose web credential extraction.',
+    },
+    {
+      name: 'TotpMultiFactorGenerator',
+      reason:
+        'RN Firebase now mirrors the firebase-js-sdk assertion return types and default-app generateSecret signature while retaining an RNFB auth overload for non-default native apps.',
+    },
+    {
+      name: 'TotpSecret',
+      reason:
+        'RN Firebase now exports TotpSecret from the modular surface, but the native-backed helper class exposes a reduced field set plus async/native helper methods that do not match the firebase-js-sdk TotpSecret class shape.',
+    },
+  ],
+};
+
+export default config;

.github/scripts/compare-types/src/registry.ts

@@ -18,11 +18,11 @@ import appCheckConfig from '../configs/app-check';
 import firestoreConfig from '../configs/firestore';
 import firestorePipelinesConfig from '../configs/firestore-pipelines';
 import remoteConfigConfig from '../configs/remote-config';
+import authConfig from '../configs/auth';
 import installationsConfig from '../configs/installations';
 import perfConfig from '../configs/perf-config';
 
-const SCRIPT_DIR = path.resolve(__dirname, '..');
-const REPO_ROOT = path.resolve(SCRIPT_DIR, '..', '..', '..');
+const REPO_ROOT = path.resolve(__dirname, '..', '..', '..', '..');
 
 export interface PackageEntry {
   /** Short name used in reports (e.g. "remote-config"). */
@@ -103,6 +103,41 @@ function optionalFirebasePackage(
 }
 
 export const packages: PackageEntry[] = [
+  {
+    name: 'auth',
+    firebaseSdkTypesPaths: [requiredFirebaseTypes('auth')],
+    rnFirebaseModularFiles: [
+      path.join(rnDist('auth'), 'types', 'auth.d.ts'),
+      path.join(rnDist('auth'), 'modular.d.ts'),
+    ],
+    rnFirebaseSupportFiles: [
+      path.join(rnDist('auth'), 'index.d.ts'),
+      path.join(rnDist('auth'), 'constants.d.ts'),
+      path.join(rnDist('auth'), 'namespaced.d.ts'),
+      path.join(rnDist('auth'), 'types', 'namespaced.d.ts'),
+      path.join(rnDist('auth'), 'types', 'internal.d.ts'),
+      path.join(rnDist('auth'), 'ConfirmationResult.d.ts'),
+      path.join(rnDist('auth'), 'MultiFactorResolver.d.ts'),
+      path.join(rnDist('auth'), 'PhoneAuthListener.d.ts'),
+      path.join(rnDist('auth'), 'PhoneMultiFactorGenerator.d.ts'),
+      path.join(rnDist('auth'), 'Settings.d.ts'),
+      path.join(rnDist('auth'), 'TotpMultiFactorGenerator.d.ts'),
+      path.join(rnDist('auth'), 'TotpSecret.d.ts'),
+      path.join(rnDist('auth'), 'User.d.ts'),
+      path.join(rnDist('auth'), 'getMultiFactorResolver.d.ts'),
+      path.join(rnDist('auth'), 'multiFactor.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'AppleAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'EmailAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'FacebookAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'GithubAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'GoogleAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'OAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'OIDCAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'PhoneAuthProvider.d.ts'),
+      path.join(rnDist('auth'), 'providers', 'TwitterAuthProvider.d.ts'),
+    ],
+    config: authConfig,
+  },
   {
     name: 'storage',
     firebaseSdkTypesPaths: [requiredFirebaseTypes('storage')],

packages/ai/tsconfig.json

@@ -31,7 +31,7 @@
       ],
       "@react-native-firebase/app/lib/internal": ["../app/dist/typescript/lib/internal"],
       "@react-native-firebase/app": ["../app/dist/typescript/lib"],
-      "@react-native-firebase/auth": ["../auth/lib"],
+      "@react-native-firebase/auth": ["../auth/dist/typescript/lib"],
       "@react-native-firebase/app-check": ["../app-check/dist/typescript/lib"]
     },
     "types": ["react-native", "node"]