rn-swiftauth-sdk 1.0.3 → 1.0.4

package/README.md

@@ -231,6 +231,120 @@ const {
     buttonText: { color: '#000000', fontWeight: 'bold' }
   }}
 />
+
+
+
+---
+
+## 🔐 Password Management
+
+The **SwiftAuth SDK** includes built-in support for **password recovery flows** using **Firebase’s email-based password reset mechanism**.
+
+---
+
+### ✉️ Sending a Reset Email
+
+The `sendPasswordReset(email)` function sends a password reset link to the user’s email address.
+
+#### Method Signature
+
+```ts
+sendPasswordReset: (email: string) => Promise<void>
+```
+
+---
+
+### 📌 Usage Example (React Native)
+
+```ts
+import React, { useState } from 'react';
+import { View, TextInput, Button, Alert, Text } from 'react-native';
+import { useAuth } from 'rn-swiftauth-sdk';
+
+export const ForgotPasswordScreen = () => {
+  const [email, setEmail] = useState('');
+  const { sendPasswordReset, isLoading, error } = useAuth();
+
+  const handleReset = async () => {
+    if (!email) {
+      Alert.alert("Error", "Please enter your email address.");
+      return;
+    }
+
+    try {
+      await sendPasswordReset(email);
+      Alert.alert("Success", "Password reset link sent! Check your email.");
+    } catch (err) {
+      // Errors are automatically handled by the global `error` state,
+      // but can also be caught locally for custom logic.
+      console.error("Reset failed:", err);
+    }
+  };
+
+  return (
+    <View>
+      <TextInput
+        placeholder="Enter your email"
+        value={email}
+        onChangeText={setEmail}
+        autoCapitalize="none"
+        keyboardType="email-address"
+      />
+
+      <Button
+        title={isLoading ? "Sending..." : "Reset Password"}
+        onPress={handleReset}
+        disabled={isLoading}
+      />
+
+      {error && <Text style={{ color: 'red' }}>{error.message}</Text>}
+    </View>
+  );
+};
+```
+
+---
+
+### ⚠️ Error Handling
+
+The error handling system includes **specific exceptions** for password reset flows.
+
+| Exception Class         | Error Code            | User Message                                                        |
+| ----------------------- | --------------------- | ------------------------------------------------------------------- |
+| `UserNotFoundException` | `auth/user-not-found` | "No account found with this email. Please check the email address." |
+| `InvalidEmailException` | `auth/invalid-email`  | "The email address is badly formatted."                             |
+
+Errors are exposed through the global `error` state returned by `useAuth()` and can also be handled locally using `try/catch`.
+
+---
+
+### 🎨 Integration with Custom UI
+
+You can integrate password recovery into **custom login forms** by toggling a “Forgot Password” mode using the headless hook.
+
+```ts
+const { sendPasswordReset } = useAuth();
+
+const onForgotPasswordPress = async (email: string) => {
+  await sendPasswordReset(email);
+  // Show success feedback to the user
+};
+```
+
+This allows you to fully control your UI while leveraging SwiftAuth’s secure password reset flow.
+
+---
+
+If you want, I can also:
+
+* Add **UX flow diagrams**
+* Add **Firebase setup prerequisites**
+* Document **rate limits & edge cases**
+* Align tone with the rest of your SDK README
+
+Just tell me 👍
+
+
 ```
 
 ---
@@ -499,7 +613,7 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License - see [LICENSE](LICENSE) file for detailss.
 
 ---
 

package/dist/components/LoginForm.js

@@ -40,16 +40,35 @@ const useAuth_1 = require("../hooks/useAuth");
 const PasswordInput_1 = require("./PasswordInput");
 const validation_1 = require("../utils/validation");
 const LoginForm = ({ styles: userStyles }) => {
-    const { signInWithEmail, signInWithGoogle, signInWithApple, isLoading, error, config } = (0, useAuth_1.useAuth)();
+    const { signInWithEmail, signInWithGoogle, signInWithApple, sendPasswordReset, isLoading, error, config, clearError } = (0, useAuth_1.useAuth)();
     const [email, setEmail] = (0, react_1.useState)('');
     const [password, setPassword] = (0, react_1.useState)('');
+    const [isResetMode, setIsResetMode] = (0, react_1.useState)(false); // ✅ 2. Mode Toggle State
     const [validationErrors, setValidationErrors] = (0, react_1.useState)({});
-    //Check if form is filled to enable button
-    const isFormFilled = email.length > 0 && password.length > 0;
+    // ✅ 3. Dynamic check: If resetting, we only need Email. If logging in, we need both.
+    const isFormFilled = isResetMode
+        ? email.length > 0
+        : (email.length > 0 && password.length > 0);
+    // ✅ 4. New Handler for Password Reset
+    const handleResetPassword = async () => {
+        setValidationErrors({});
+        const emailErr = (0, validation_1.validateEmail)(email);
+        if (emailErr) {
+            setValidationErrors({ email: emailErr });
+            return;
+        }
+        try {
+            await sendPasswordReset(email);
+            react_native_1.Alert.alert("Check your email", "If an account exists with this email, a password reset link has been sent.");
+            setIsResetMode(false); // Go back to login screen
+        }
+        catch (e) {
+            console.log('Reset failed:', e);
+        }
+    };
     const handleLogin = async () => {
-        // 1. Reset previous errors
         setValidationErrors({});
-        // 2. Validate Inputs
+        // Validate Inputs
         const emailErr = (0, validation_1.validateEmail)(email);
         const passErr = (0, validation_1.validatePasswordLogin)(password);
         if (emailErr || passErr) {
@@ -57,16 +76,12 @@ const LoginForm = ({ styles: userStyles }) => {
                 email: emailErr || undefined,
                 password: passErr || undefined
             });
-            return; //Stop if invalid
+            return;
         }
-        // 3. Attempt Login
         try {
-            //UPDATED: Clean Object Syntax
             await signInWithEmail({ email, password });
         }
         catch (e) {
-            // Auth errors handled by global state
-            // DX: Log it for the developer (Optional but helpful for debugging)
             console.log('Login failed:', e);
         }
     };
@@ -86,8 +101,15 @@ const LoginForm = ({ styles: userStyles }) => {
             console.error('Apple Sign-In Error:', e);
         }
     };
+    const toggleResetMode = () => {
+        setIsResetMode(!isResetMode);
+        clearError();
+        setValidationErrors({});
+        setPassword('');
+    };
     return (react_1.default.createElement(react_native_1.View, { style: [defaultStyles.container, userStyles?.container] },
         error && (react_1.default.createElement(react_native_1.Text, { style: [defaultStyles.errorText, userStyles?.errorText] }, error.message)),
+        isResetMode && (react_1.default.createElement(react_native_1.Text, { style: defaultStyles.modeTitle }, "Reset Password")),
         react_1.default.createElement(react_native_1.TextInput, { style: [
                 defaultStyles.input,
                 userStyles?.input,
@@ -98,34 +120,30 @@ const LoginForm = ({ styles: userStyles }) => {
                     setValidationErrors({ ...validationErrors, email: undefined });
             }, autoCapitalize: "none", keyboardType: "email-address", placeholderTextColor: "#999", editable: !isLoading }),
         validationErrors.email && (react_1.default.createElement(react_native_1.Text, { style: defaultStyles.validationText }, validationErrors.email)),
-        react_1.default.createElement(PasswordInput_1.PasswordInput, { styles: userStyles, placeholder: "Password", value: password, onChangeText: (text) => {
-                setPassword(text);
-                if (validationErrors.password)
-                    setValidationErrors({ ...validationErrors, password: undefined });
-            }, editable: !isLoading }),
-        validationErrors.password && (react_1.default.createElement(react_native_1.Text, { style: defaultStyles.validationText }, validationErrors.password)),
+        !isResetMode && (react_1.default.createElement(react_1.default.Fragment, null,
+            react_1.default.createElement(PasswordInput_1.PasswordInput, { styles: userStyles, placeholder: "Password", value: password, onChangeText: (text) => {
+                    setPassword(text);
+                    if (validationErrors.password)
+                        setValidationErrors({ ...validationErrors, password: undefined });
+                }, editable: !isLoading }),
+            validationErrors.password && (react_1.default.createElement(react_native_1.Text, { style: defaultStyles.validationText }, validationErrors.password)),
+            react_1.default.createElement(react_native_1.TouchableOpacity, { style: defaultStyles.forgotPasswordContainer, onPress: toggleResetMode, disabled: isLoading },
+                react_1.default.createElement(react_native_1.Text, { style: [defaultStyles.forgotPasswordText, userStyles?.linkText] }, "Forgot Password?")))),
         react_1.default.createElement(react_native_1.TouchableOpacity, { style: [
                 defaultStyles.button,
-                // Disable style if loading OR form is incomplete
                 (isLoading || !isFormFilled) && defaultStyles.buttonDisabled,
                 userStyles?.button
-            ], onPress: handleLogin, 
-            // Disable interaction if loading OR form is incomplete
-            disabled: isLoading || !isFormFilled }, isLoading ? (react_1.default.createElement(react_native_1.ActivityIndicator, { color: userStyles?.loadingIndicatorColor || "#fff" })) : (react_1.default.createElement(react_native_1.Text, { style: [defaultStyles.buttonText, userStyles?.buttonText] }, "Sign In"))),
-        (config.enableGoogle || config.enableApple) && !isLoading && (react_1.default.createElement(react_1.default.Fragment, null,
+            ], onPress: isResetMode ? handleResetPassword : handleLogin, disabled: isLoading || !isFormFilled }, isLoading ? (react_1.default.createElement(react_native_1.ActivityIndicator, { color: userStyles?.loadingIndicatorColor || "#fff" })) : (react_1.default.createElement(react_native_1.Text, { style: [defaultStyles.buttonText, userStyles?.buttonText] }, isResetMode ? "Send Reset Link" : "Sign In"))),
+        isResetMode && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: defaultStyles.cancelButton, onPress: toggleResetMode, disabled: isLoading },
+            react_1.default.createElement(react_native_1.Text, { style: defaultStyles.cancelButtonText }, "Back to Sign In"))),
+        !isResetMode && (config.enableGoogle || config.enableApple) && !isLoading && (react_1.default.createElement(react_1.default.Fragment, null,
             react_1.default.createElement(react_native_1.View, { style: defaultStyles.dividerContainer },
                 react_1.default.createElement(react_native_1.View, { style: defaultStyles.divider }),
                 react_1.default.createElement(react_native_1.Text, { style: defaultStyles.dividerText }, "OR"),
                 react_1.default.createElement(react_native_1.View, { style: defaultStyles.divider })),
-            config.enableGoogle && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: [
-                    defaultStyles.oauthButton,
-                    defaultStyles.googleButton,
-                ], onPress: handleGoogleSignIn },
+            config.enableGoogle && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: [defaultStyles.oauthButton, defaultStyles.googleButton], onPress: handleGoogleSignIn },
                 react_1.default.createElement(react_native_1.Text, { style: defaultStyles.googleButtonText }, "Continue with Google"))),
-            config.enableApple && react_native_1.Platform.OS === 'ios' && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: [
-                    defaultStyles.oauthButton,
-                    defaultStyles.appleButton,
-                ], onPress: handleAppleSignIn },
+            config.enableApple && react_native_1.Platform.OS === 'ios' && (react_1.default.createElement(react_native_1.TouchableOpacity, { style: [defaultStyles.oauthButton, defaultStyles.appleButton], onPress: handleAppleSignIn },
                 react_1.default.createElement(react_native_1.Text, { style: defaultStyles.appleButtonText }, "Continue with Apple")))))));
 };
 exports.LoginForm = LoginForm;
@@ -185,4 +203,31 @@ const defaultStyles = react_native_1.StyleSheet.create({
         fontSize: 16,
         fontWeight: '600',
     },
+    forgotPasswordContainer: {
+        alignSelf: 'flex-end',
+        marginBottom: 12,
+        padding: 4,
+    },
+    forgotPasswordText: {
+        color: '#007AFF',
+        fontSize: 14,
+        fontWeight: '500',
+    },
+    modeTitle: {
+        fontSize: 18,
+        fontWeight: 'bold',
+        marginBottom: 16,
+        color: '#333',
+        textAlign: 'center',
+    },
+    cancelButton: {
+        marginTop: 16,
+        alignItems: 'center',
+        padding: 8,
+    },
+    cancelButtonText: {
+        color: '#666',
+        fontSize: 14,
+        fontWeight: '500',
+    },
 });

package/dist/core/AuthProvider.js

@@ -41,6 +41,7 @@ const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
 const app_1 = require("firebase/app");
 const FirebaseAuth = __importStar(require("firebase/auth"));
+const auth_1 = require("firebase/auth");
 const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
 const google_signin_1 = require("@react-native-google-signin/google-signin");
 const AppleAuthentication = __importStar(require("expo-apple-authentication"));
@@ -169,6 +170,23 @@ const AuthProvider = ({ config, children }) => {
             throw mappedException;
         }
     };
+    const sendPasswordReset = async (email) => {
+        if (!firebaseAuthInstance)
+            return;
+        try {
+            setError(null);
+            setStatus(types_1.AuthStatus.LOADING);
+            await (0, auth_1.sendPasswordResetEmail)(firebaseAuthInstance, email);
+            setStatus(types_1.AuthStatus.UNAUTHENTICATED);
+            console.log(`Password reset email sent to ${email}`);
+        }
+        catch (err) {
+            const mappedException = (0, errors_1.mapFirebaseError)(err);
+            setError(mappedException);
+            setStatus(types_1.AuthStatus.UNAUTHENTICATED);
+            throw mappedException;
+        }
+    };
     const signInWithGoogle = async () => {
         if (!firebaseAuthInstance)
             throw new Error('Firebase not initialized');
@@ -286,6 +304,7 @@ const AuthProvider = ({ config, children }) => {
         config,
         signInWithEmail,
         signUpWithEmail,
+        sendPasswordReset,
         signInWithGoogle,
         signInWithApple,
         signOut,

package/dist/types/auth.types.d.ts

@@ -30,6 +30,7 @@ export interface AuthContextType {
     config: AuthConfig;
     signInWithEmail: (options: EmailSignInOptions) => Promise<void>;
     signUpWithEmail: (options: EmailSignUpOptions) => Promise<void>;
+    sendPasswordReset: (email: string) => Promise<void>;
     signInWithGoogle: () => Promise<void>;
     signInWithApple: () => Promise<void>;
     signOut: () => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rn-swiftauth-sdk",
-    "version": "1.0.3",
+    "version": "1.0.4",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "files": [

package/src/components/LoginForm.tsx

@@ -6,7 +6,8 @@ import {
   TouchableOpacity,
   StyleSheet,
   ActivityIndicator,
-  Platform
+  Platform,
+  Alert
 } from 'react-native';
 import { useAuth } from '../hooks/useAuth';
 import { AuthScreenStyles } from '../types';
@@ -22,24 +23,49 @@ export const LoginForm = ({ styles: userStyles }: LoginFormProps) => {
     signInWithEmail,
     signInWithGoogle,
     signInWithApple,
+    sendPasswordReset,
     isLoading,
     error,
-    config
+    config,
+    clearError
   } = useAuth();
 
   const [email, setEmail] = useState('');
   const [password, setPassword] = useState('');
+  const [isResetMode, setIsResetMode] = useState(false); // ✅ 2. Mode Toggle State
   
   const [validationErrors, setValidationErrors] = useState<{ email?: string; password?: string }>({});
 
-  //Check if form is filled to enable button
-  const isFormFilled = email.length > 0 && password.length > 0;
+  // ✅ 3. Dynamic check: If resetting, we only need Email. If logging in, we need both.
+  const isFormFilled = isResetMode 
+    ? email.length > 0 
+    : (email.length > 0 && password.length > 0);
 
-  const handleLogin = async () => {
-    // 1. Reset previous errors
+  // ✅ 4. New Handler for Password Reset
+  const handleResetPassword = async () => {
     setValidationErrors({});
+    const emailErr = validateEmail(email);
+    if (emailErr) {
+      setValidationErrors({ email: emailErr });
+      return;
+    }
+
+    try {
+      await sendPasswordReset(email);
+      Alert.alert(
+        "Check your email", 
+        "If an account exists with this email, a password reset link has been sent."
+      );
+      setIsResetMode(false); // Go back to login screen
+    } catch (e) {
+      console.log('Reset failed:', e);
+    }
+  };
 
-    // 2. Validate Inputs
+  const handleLogin = async () => {
+    setValidationErrors({});
+    
+    // Validate Inputs
     const emailErr = validateEmail(email);
     const passErr = validatePasswordLogin(password);
 
@@ -48,16 +74,12 @@ export const LoginForm = ({ styles: userStyles }: LoginFormProps) => {
         email: emailErr || undefined,
         password: passErr || undefined
       });
-      return; //Stop if invalid
+      return;
     }
 
-    // 3. Attempt Login
     try {
-      //UPDATED: Clean Object Syntax
       await signInWithEmail({ email, password });
     } catch (e) { 
-      // Auth errors handled by global state
-      // DX: Log it for the developer (Optional but helpful for debugging)
       console.log('Login failed:', e);
     }
   };
@@ -78,16 +100,30 @@ export const LoginForm = ({ styles: userStyles }: LoginFormProps) => {
     }
   };
 
+
+  const toggleResetMode = () => {
+    setIsResetMode(!isResetMode);
+    clearError();
+    setValidationErrors({});
+
+    setPassword('');
+  };
+
   return (
     <View style={[defaultStyles.container, userStyles?.container]}>
-      {/* Global API Error */}
+
       {error && (
         <Text style={[defaultStyles.errorText, userStyles?.errorText]}>
           {error.message}
         </Text>
       )}
 
-      {/* Email Input */}
+
+      {isResetMode && (
+        <Text style={defaultStyles.modeTitle}>Reset Password</Text>
+      )}
+
+
       <TextInput
         style={[
           defaultStyles.input, 
@@ -109,44 +145,69 @@ export const LoginForm = ({ styles: userStyles }: LoginFormProps) => {
         <Text style={defaultStyles.validationText}>{validationErrors.email}</Text>
       )}
 
-      {/* Password Input */}
-      <PasswordInput
-        styles={userStyles}
-        placeholder="Password"
-        value={password}
-        onChangeText={(text) => {
-          setPassword(text);
-          if (validationErrors.password) setValidationErrors({...validationErrors, password: undefined});
-        }}
-        editable={!isLoading}
-      />
-      {validationErrors.password && (
-        <Text style={defaultStyles.validationText}>{validationErrors.password}</Text>
+
+      {!isResetMode && (
+        <>
+          <PasswordInput
+            styles={userStyles}
+            placeholder="Password"
+            value={password}
+            onChangeText={(text) => {
+              setPassword(text);
+              if (validationErrors.password) setValidationErrors({...validationErrors, password: undefined});
+            }}
+            editable={!isLoading}
+          />
+          {validationErrors.password && (
+            <Text style={defaultStyles.validationText}>{validationErrors.password}</Text>
+          )}
+
+
+          <TouchableOpacity 
+            style={defaultStyles.forgotPasswordContainer} 
+            onPress={toggleResetMode}
+            disabled={isLoading}
+          >
+            <Text style={[defaultStyles.forgotPasswordText, userStyles?.linkText]}>
+              Forgot Password?
+            </Text>
+          </TouchableOpacity>
+        </>
       )}
 
-      {/* Sign In Button */}
+
       <TouchableOpacity
         style={[
           defaultStyles.button,
-          // Disable style if loading OR form is incomplete
           (isLoading || !isFormFilled) && defaultStyles.buttonDisabled,
           userStyles?.button
         ]}
-        onPress={handleLogin}
-        // Disable interaction if loading OR form is incomplete
+
+        onPress={isResetMode ? handleResetPassword : handleLogin}
         disabled={isLoading || !isFormFilled}
       >
         {isLoading ? (
           <ActivityIndicator color={userStyles?.loadingIndicatorColor || "#fff"} />
         ) : (
           <Text style={[defaultStyles.buttonText, userStyles?.buttonText]}>
-            Sign In
+            {isResetMode ? "Send Reset Link" : "Sign In"}
           </Text>
         )}
       </TouchableOpacity>
 
-      {/* OAuth Section */}
-      {(config.enableGoogle || config.enableApple) && !isLoading && (
+
+      {isResetMode && (
+        <TouchableOpacity 
+          style={defaultStyles.cancelButton} 
+          onPress={toggleResetMode}
+          disabled={isLoading}
+        >
+          <Text style={defaultStyles.cancelButtonText}>Back to Sign In</Text>
+        </TouchableOpacity>
+      )}
+
+
+      {!isResetMode && (config.enableGoogle || config.enableApple) && !isLoading && (
         <>
           <View style={defaultStyles.dividerContainer}>
             <View style={defaultStyles.divider} />
@@ -157,30 +218,20 @@ export const LoginForm = ({ styles: userStyles }: LoginFormProps) => {
           {/* Google Button */}
           {config.enableGoogle && (
             <TouchableOpacity
-              style={[
-                defaultStyles.oauthButton,
-                defaultStyles.googleButton,
-              ]}
+              style={[defaultStyles.oauthButton, defaultStyles.googleButton]}
               onPress={handleGoogleSignIn}
             >
-              <Text style={defaultStyles.googleButtonText}>
-                Continue with Google
-              </Text>
+              <Text style={defaultStyles.googleButtonText}>Continue with Google</Text>
             </TouchableOpacity>
           )}
 
           {/* Apple Button (iOS Only) */}
           {config.enableApple && Platform.OS === 'ios' && (
             <TouchableOpacity
-              style={[
-                defaultStyles.oauthButton,
-                defaultStyles.appleButton,
-              ]}
+              style={[defaultStyles.oauthButton, defaultStyles.appleButton]}
               onPress={handleAppleSignIn}
             >
-              <Text style={defaultStyles.appleButtonText}>
-                Continue with Apple
-              </Text>
+              <Text style={defaultStyles.appleButtonText}>Continue with Apple</Text>
             </TouchableOpacity>
           )}
         </>
@@ -252,4 +303,33 @@ const defaultStyles = StyleSheet.create({
     fontSize: 16,
     fontWeight: '600',
   },
+
+
+  forgotPasswordContainer: {
+    alignSelf: 'flex-end',
+    marginBottom: 12,
+    padding: 4,
+  },
+  forgotPasswordText: {
+    color: '#007AFF',
+    fontSize: 14,
+    fontWeight: '500',
+  },
+  modeTitle: {
+    fontSize: 18,
+    fontWeight: 'bold',
+    marginBottom: 16,
+    color: '#333',
+    textAlign: 'center',
+  },
+  cancelButton: {
+    marginTop: 16,
+    alignItems: 'center',
+    padding: 8,
+  },
+  cancelButtonText: {
+    color: '#666',
+    fontSize: 14,
+    fontWeight: '500',
+  },
 });

package/src/core/AuthProvider.tsx

@@ -2,6 +2,8 @@ import React, { useEffect, useState, ReactNode, useMemo } from 'react';
 import { Platform } from 'react-native';
 import { initializeApp, getApps, getApp, FirebaseApp } from 'firebase/app';
 import * as FirebaseAuth from 'firebase/auth';
+
+import { sendPasswordResetEmail } from 'firebase/auth'; 
 import ReactNativeAsyncStorage from '@react-native-async-storage/async-storage';
 import { GoogleSignin } from '@react-native-google-signin/google-signin';
 import * as AppleAuthentication from 'expo-apple-authentication';
@@ -152,6 +154,26 @@ export const AuthProvider: React.FC<AuthProviderProps> = ({ config, children })
     }
   };
 
+
+  const sendPasswordReset = async (email: string) => {
+    if (!firebaseAuthInstance) return;
+    try {
+      setError(null);
+      setStatus(AuthStatus.LOADING);
+      
+      await sendPasswordResetEmail(firebaseAuthInstance, email);
+      
+
+      setStatus(AuthStatus.UNAUTHENTICATED);
+      console.log(`Password reset email sent to ${email}`);
+    } catch (err: any) {
+      const mappedException = mapFirebaseError(err);
+      setError(mappedException);
+      setStatus(AuthStatus.UNAUTHENTICATED);
+      throw mappedException;
+    }
+  };
+
   const signInWithGoogle = async () => {
     if (!firebaseAuthInstance) throw new Error('Firebase not initialized');
     if (!config.enableGoogle || !config.googleWebClientId) {
@@ -286,6 +308,7 @@ export const AuthProvider: React.FC<AuthProviderProps> = ({ config, children })
     config,
     signInWithEmail,
     signUpWithEmail,
+    sendPasswordReset,
     signInWithGoogle,
     signInWithApple,
     signOut,

package/src/types/auth.types.ts

@@ -38,7 +38,7 @@ export interface AuthContextType {
   // Function Signatures
   signInWithEmail: (options: EmailSignInOptions) => Promise<void>;
   signUpWithEmail: (options: EmailSignUpOptions) => Promise<void>;
-
+  sendPasswordReset: (email: string) => Promise<void>;
   signInWithGoogle: () => Promise<void>;
   signInWithApple: () => Promise<void>;
   signOut: () => Promise<void>;