feat(react-native): implements useAuthStateReady hook

react-native/auth/index.ts

@@ -10,3 +10,4 @@ export * from "./useSignOutMutation";
 export * from "./useIdToken";
 export * from "./useReauthenticateWitCredentialMutation";
 export * from "./useReauthenticateWitRedirectMutation";
+export * from "./useAuthStateReady";

react-native/auth/useAuthStateReady.ts

@@ -0,0 +1,38 @@
+import { useAuth } from "./useAuth";
+import { useEffect, useState } from "react";
+
+/**
+ * A custom hook that determines if the Firebase authentication state is ready.
+ * It uses Firebase authentication to check if the auth state is ready and updates the state accordingly.
+ *
+ * @group Hook
+ *
+ * @returns {boolean}
+ *
+ * @example
+ * ```jsx
+ * export const MyComponent = () => {
+ *  const isAuthStateReady = useAuthStateReady();
+ *  console.log(isAuthStateReady);
+ * };
+ * ```
+ */
+export const useAuthStateReady = () => {
+    const firebaseAuth = useAuth();
+
+    const [isAuthStateReady, setIsAuthStateReady] = useState(false);
+
+    useEffect(() => {
+        const subscription = firebaseAuth.onAuthStateChanged(() => {
+            if (!isAuthStateReady) {
+                setIsAuthStateReady(true);
+            }
+        });
+
+        return () => {
+            subscription();
+        };
+    }, [firebaseAuth, isAuthStateReady]);
+
+    return isAuthStateReady;
+};

web/auth/useAuthStateReady.ts

@@ -4,7 +4,18 @@ import { useCallback, useEffect, useState } from "react";
 /**
  * A custom hook that determines if the Firebase authentication state is ready.
  * It uses Firebase authentication to check if the auth state is ready and updates the state accordingly.
- * @returns {boolean} Indicates whether the authentication state is ready.
+ *
+ * @group Hook
+ *
+ * @returns {boolean}
+ *
+ * @example
+ * ```jsx
+ * export const MyComponent = () => {
+ *  const isAuthStateReady = useAuthStateReady();
+ *  console.log(isAuthStateReady);
+ * };
+ * ```
  */
 export const useAuthStateReady = () => {
     const firebaseAuth = useAuth();