call getAuth() directly all the time

Author: DoctorJohn

docs/auth/multi-factor-auth.md

@@ -23,8 +23,7 @@ operations:
 ```js
 import authModule, { PhoneAuthProvider, getAuth, multiFactor } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-const multiFactorUser = await multiFactor(auth.currentUser);
+const multiFactorUser = await multiFactor(getAuth().currentUser);
 ```
 
 Request the session identifier and use the phone number obtained from the user
@@ -38,7 +37,7 @@ const phoneOptions = {
 };
 
 // Sends a text message to the user
-const verificationId = await auth.verifyPhoneNumberForMultiFactor(phoneOptions);
+const verificationId = await getAuth().verifyPhoneNumberForMultiFactor(phoneOptions);
 ```
 
 Once the user has provided the verification code received by text message, you
@@ -67,9 +66,7 @@ import authModule, {
   getMultiFactorResolver,
 } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
-signInWithEmailAndPassword(auth, email, password)
+signInWithEmailAndPassword(getAuth(), email, password)
   .then(() => {
     // User has not enrolled a second factor
   })
@@ -89,7 +86,7 @@ Using the error object you can obtain a
 continue the flow:
 
 ```js
-const resolver = getMultiFactorResolver(auth, error);
+const resolver = getMultiFactorResolver(getAuth(), error);
 ```
 
 The resolver object has all the required information to prompt the user for a
@@ -113,7 +110,7 @@ verification code to the user:
 const hint = resolver.hints[0];
 const sessionId = resolver.session;
 
-auth
+getAuth()
   .verifyPhoneNumberWithMultiFactorInfo(hint, sessionId) // triggers the message to the user
   .then(verificationId => setVerificationId(verificationId));
 ```
@@ -145,9 +142,7 @@ import authModule, {
   getMultiFactorResolver,
 } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
-signInWithEmailAndPassword(auth, email, password)
+signInWithEmailAndPassword(getAuth(), email, password)
   .then(() => {
     // User has not enrolled a second factor
   })
@@ -166,7 +161,7 @@ signInWithEmailAndPassword(auth, email, password)
         const hint = resolver.hints[0];
         const sessionId = resolver.session;
 
-        auth
+        getAuth()
           .verifyPhoneNumberWithMultiFactorInfo(hint, sessionId) // triggers the message to the user
           .then(verificationId => setVerificationId(verificationId));
 

docs/auth/oidc-auth.md

@@ -64,6 +64,5 @@ const credential = OIDCAuthProvider.credential(
   authState.idToken,
 );
 
-const auth = getAuth();
-await signInWithCredential(auth, credential);
+await signInWithCredential(getAuth(), credential);
 ```

docs/auth/phone-auth.md

@@ -56,12 +56,10 @@ a code. Based on whether the code is correct for the device, the method rejects
 The example below demonstrates how you could setup such a flow within your own application:
 
 ```jsx
-import React, { useState, useEffect } from 'react';
+import { useState, useEffect } from 'react';
 import { Button, TextInput } from 'react-native';
 import { getAuth, onAuthStateChanged, signInWithPhoneNumber } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
 function PhoneSignIn() {
   // If null, no SMS has been sent
   const [confirm, setConfirm] = useState(null);
@@ -80,13 +78,13 @@ function PhoneSignIn() {
   }
 
   useEffect(() => {
-    const subscriber = onAuthStateChanged(auth, handleAuthStateChanged);
+    const subscriber = onAuthStateChanged(getAuth(), handleAuthStateChanged);
     return subscriber; // unsubscribe on unmount
   }, []);
 
   // Handle the button press
   async function handleSignInWithPhoneNumber(phoneNumber) {
-    const confirmation = await signInWithPhoneNumber(auth, phoneNumber);
+    const confirmation = await signInWithPhoneNumber(getAuth(), phoneNumber);
     setConfirm(confirmation);
   }
 
@@ -148,8 +146,6 @@ import {
   verifyPhoneNumber,
 } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
 export default function PhoneVerification() {
   // Set an initializing state whilst Firebase connects
   const [initializing, setInitializing] = useState(true);
@@ -167,14 +163,14 @@ export default function PhoneVerification() {
   }
 
   useEffect(() => {
-    const subscriber = onAuthStateChanged(auth, handleAuthStateChanged);
+    const subscriber = onAuthStateChanged(getAuth(), handleAuthStateChanged);
     return subscriber; // unsubscribe on unmount
   }, []);
 
   // Handle create account button press
   async function createAccount() {
     try {
-      await createUserWithEmailAndPassword(auth, 'jane.doe@example.com', 'SuperSecretPassword!');
+      await createUserWithEmailAndPassword(getAuth(), 'jane.doe@example.com', 'SuperSecretPassword!');
       console.log('User account created & signed in!');
     } catch (error) {
       if (error.code === 'auth/email-already-in-use') {
@@ -190,15 +186,15 @@ export default function PhoneVerification() {
 
   // Handle the verify phone button press
   async function handlePhoneNumberVerification(phoneNumber) {
-    const confirmation = await verifyPhoneNumber(auth, phoneNumber);
+    const confirmation = await verifyPhoneNumber(getAuth(), phoneNumber);
     setConfirm(confirmation);
   }
 
   // Handle confirm code button press
   async function confirmCode() {
     try {
       const credential = PhoneAuthProvider.credential(confirm.verificationId, code);
-      let userData = await auth.currentUser.linkWithCredential(credential);
+      let userData = await getAuth().currentUser.linkWithCredential(credential);
       setUser(userData.user);
     } catch (error) {
       if (error.code == 'auth/invalid-verification-code') {

docs/auth/social-auth.md

@@ -74,8 +74,7 @@ async function onAppleButtonPress() {
   const appleCredential = AppleAuthProvider.credential(identityToken, nonce);
 
   // Sign the user in with the credential
-  const auth = getAuth();
-  return signInWithCredential(auth, appleCredential);
+  return signInWithCredential(getAuth(), appleCredential);
 }
 ```
 
@@ -85,7 +84,7 @@ with the new authentication state of the user.
 Apple also requires that the app revoke the `Sign in with Apple` token when the user chooses to delete their account. This can be accomplished with the `revokeToken` API.
 
 ```js
-import { getAuth } from '@react-native-firebase/auth';
+import { getAuth, revokeToken } from '@react-native-firebase/auth';
 import { appleAuth } from '@invertase/react-native-apple-authentication';
 
 async function revokeSignInWithAppleToken() {
@@ -100,8 +99,7 @@ async function revokeSignInWithAppleToken() {
   }
 
   // Revoke the token
-  const auth = getAuth();
-  return auth.revokeToken(auth, authorizationCode);
+  return revokeToken(getAuth(), authorizationCode);
 }
 ```
 
@@ -158,8 +156,7 @@ async function onFacebookButtonPress() {
   const facebookCredential = FacebookAuthProvider.credential(data.accessToken);
 
   // Sign-in the user with the credential
-  const auth = getAuth();
-  return signInWithCredential(auth, facebookCredential);
+  return signInWithCredential(getAuth(), facebookCredential);
 }
 ```
 
@@ -200,8 +197,7 @@ async function onFacebookButtonPress() {
   const facebookCredential = FacebookAuthProvider.credential(data.authenticationToken, nonce);
 
   // Sign-in the user with the credential
-  const auth = getAuth();
-  return signInWithCredential(auth, facebookCredential);
+  return signInWithCredential(getAuth(), facebookCredential);
 }
 ```
 
@@ -277,8 +273,7 @@ async function onGoogleButtonPress() {
   const googleCredential = GoogleAuthProvider.credential(signInResult.data.idToken);
 
   // Sign-in the user with the credential
-  const auth = getAuth();
-  return signInWithCredential(auth, googleCredential);
+  return signInWithCredential(getAuth(), googleCredential);
 }
 ```
 
@@ -332,8 +327,7 @@ const onMicrosoftButtonPress = async () => {
   });
 
   // Sign-in the user with the provider
-  const auth = getAuth();
-  return signInWithRedirect(auth, provider);
+  return signInWithRedirect(getAuth(), provider);
 };
 ```
 
@@ -393,8 +387,7 @@ async function onTwitterButtonPress() {
   const twitterCredential = TwitterAuthProvider.credential(authToken, authTokenSecret);
 
   // Sign-in the user with the credential
-  const auth = getAuth();
-  return signInWithCredential(auth, twitterCredential);
+  return signInWithCredential(getAuth(), twitterCredential);
 }
 ```
 
@@ -417,8 +410,6 @@ This code demonstrates linking a Google provider to an account that is already s
 import { GoogleAuthProvider, getAuth } from '@react-native-firebase/auth';
 import { GoogleSignin } from '@react-native-google-signin/google-signin';
 
-const auth = getAuth();
-
 async function onGoogleLinkButtonPress() {
   // Ensure the device supports Google Play services
   await GoogleSignin.hasPlayServices({ showPlayServicesUpdateDialog: true });
@@ -429,7 +420,7 @@ async function onGoogleLinkButtonPress() {
   const googleCredential = GoogleAuthProvider.credential(idToken);
 
   // Link the user's account with the Google credential
-  const firebaseUserCredential = await auth.currentUser.linkWithCredential(googleCredential);
+  const firebaseUserCredential = await getAuth().currentUser.linkWithCredential(googleCredential);
   //  Handle the linked account as needed in your app
   return;
 }

docs/auth/usage/index.md

@@ -52,8 +52,6 @@ import React, { useState, useEffect } from 'react';
 import { View, Text } from 'react-native';
 import { getAuth, onAuthStateChanged } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
 function App() {
   // Set an initializing state whilst Firebase connects
   const [initializing, setInitializing] = useState(true);
@@ -66,7 +64,7 @@ function App() {
   }
 
   useEffect(() => {
-    const subscriber = onAuthStateChanged(auth, onAuthStateChanged);
+    const subscriber = onAuthStateChanged(getAuth(), onAuthStateChanged);
     return subscriber; // unsubscribe on unmount
   }, []);
 
@@ -114,9 +112,7 @@ Ensure the "Anonymous" sign-in provider is enabled on the [Firebase Console](htt
 ```js
 import { getAuth, signInAnonymously } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
-signInAnonymously()
+signInAnonymously(getAuth())
   .then(() => {
     console.log('User signed in anonymously');
   })
@@ -149,9 +145,7 @@ then signing them in.
 ```js
 import { getAuth, createUserWithEmailAndPassword } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
-createUserWithEmailAndPassword(auth, 'jane.doe@example.com', 'SuperSecretPassword!')
+createUserWithEmailAndPassword(getAuth(), 'jane.doe@example.com', 'SuperSecretPassword!')
   .then(() => {
     console.log('User account created & signed in!');
   })
@@ -185,9 +179,7 @@ If you'd like to sign the user out of their current authentication state, call t
 ```js
 import { getAuth, signOut } from '@react-native-firebase/auth';
 
-const auth = getAuth();
-
-signOut(auth).then(() => console.log('User signed out!'));
+signOut(getAuth()).then(() => console.log('User signed out!'));
 ```
 
 Once successfully signed out, any [`onAuthStateChanged`](#listening-to-authentication-state) listeners will trigger an event