rn-swiftauth-sdk 1.0.2 → 1.0.4

package/README.md

@@ -231,69 +231,269 @@ 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>
 ```
 
 ---
 
-## Error Handling
+### 📌 Usage Example (React Native)
 
-SwiftAuth maps Firebase errors to user-friendly messages:
+```ts
+import React, { useState } from 'react';
+import { View, TextInput, Button, Alert, Text } from 'react-native';
+import { useAuth } from 'rn-swiftauth-sdk';
 
-| Error Code | User Message |
-|------------|--------------|
-| `auth/invalid-credentials` | "Invalid email or password." |
-| `auth/user-not-found` | "Invalid email or password." |
-| `auth/email-already-in-use` | "This email is already registered." |
-| `auth/weak-password` | "Password is too weak." |
-| `auth/network-request-failed` | "Network error. Please check your connection." |
+export const ForgotPasswordScreen = () => {
+  const [email, setEmail] = useState('');
+  const { sendPasswordReset, isLoading, error } = useAuth();
 
-### Basic Usage
+  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 👍
 
-```typescript
-const { error } = useAuth();
 
-if (error) {
-  return <Text style={{ color: 'red' }}>{error.message}</Text>;
-}
 ```
 
-### Advanced: Raw Firebase Errors
+---
 
-For custom UI implementations, access raw Firebase errors:
+## Error Handling
 
-**Method 1: Try/Catch Block**
+SwiftAuth provides a comprehensive error handling system with custom exceptions that map Firebase errors to user-friendly messages.
+
+### Custom Exception Classes
+
+All errors extend the base `AuthException` class and include:
+- `code`: Machine-readable error code
+- `message`: User-friendly error message
+- `timestamp`: When the error occurred
+- `originalError`: The underlying Firebase error (optional)
+- `toJSON()`: Serialize for logging/debugging
+
+### Supported Exceptions
+
+| Exception Class | Error Code | User Message |
+|-----------------|------------|--------------|
+| `InvalidCredentialsException` | `auth/invalid-credentials` | "Invalid email or password. Please check your credentials and try again." |
+| `UserNotFoundException` | `auth/user-not-found` | "No account found with this email. Please sign up first." |
+| `EmailAlreadyInUseException` | `auth/email-already-in-use` | "This email is already registered. Please sign in or use a different email." |
+| `WeakPasswordException` | `auth/weak-password` | "Password is too weak. Please use at least 6 characters with a mix of letters and numbers." |
+| `TokenExpiredException` | `auth/token-expired` | "Your session has expired. Please sign in again." |
+| `NetworkException` | `auth/network-error` | "Network error. Please check your internet connection and try again." |
+| `GoogleSignInCancelledException` | `auth/google-sign-in-cancelled` | "Google Sign-In was cancelled." |
+| `AppleSignInCancelledException` | `auth/apple-sign-in-cancelled` | "Apple Sign-In was cancelled." |
+| `AppleSignInNotSupportedException` | `auth/apple-sign-in-not-supported` | "Apple Sign-In is only available on iOS 13+ devices." |
+| `GooglePlayServicesUnavailableException` | `auth/google-play-services-unavailable` | "Google Play Services are not available. Please update Google Play Services." |
+| `ConfigurationException` | `auth/configuration-error` | Custom message based on configuration issue |
+| `UnknownAuthException` | `auth/unknown` | "An unexpected error occurred." |
+
+### Basic Error Display
 ```typescript
-const { signInWithEmail } = useAuth();
+import { useAuth } from 'rn-swiftauth-sdk';
 
-const handleLogin = async () => {
-  try {
-    await signInWithEmail({ email, password });
-  } catch (rawError: any) {
-    if (rawError.code === 'auth/requires-recent-login') {
-      showReauthModal();
-    } else if (rawError.code === 'auth/quota-exceeded') {
-      Alert.alert("System Overload", "Please try again later.");
+const LoginScreen = () => {
+  const { error, clearError } = useAuth();
+
+  return (
+    <View>
+      {error && (
+        <View style={styles.errorContainer}>
+          <Text style={styles.errorText}>{error.message}</Text>
+          <Button title="Dismiss" onPress={clearError} />
+        </View>
+      )}
+    </View>
+  );
+};
+```
+
+### Handling Specific Exception Types
+```typescript
+import { 
+  useAuth,
+  InvalidCredentialsException,
+  EmailAlreadyInUseException,
+  NetworkException 
+} from 'rn-swiftauth-sdk';
+
+const SignUpScreen = () => {
+  const { signUpWithEmail } = useAuth();
+
+  const handleSignUp = async () => {
+    try {
+      await signUpWithEmail({ email, password });
+    } catch (error) {
+      if (error instanceof EmailAlreadyInUseException) {
+        Alert.alert(
+          "Account Exists",
+          "Would you like to sign in instead?",
+          [
+            { text: "Cancel", style: "cancel" },
+            { text: "Sign In", onPress: () => navigation.navigate('SignIn') }
+          ]
+        );
+      } else if (error instanceof NetworkException) {
+        Alert.alert("Connection Issue", "Please check your internet and try again.");
+      } else if (error instanceof InvalidCredentialsException) {
+        Alert.alert("Invalid Input", "Please check your email and password.");
+      } else {
+        Alert.alert("Error", error.message);
+      }
     }
-  }
+  };
+
+  return <Button title="Sign Up" onPress={handleSignUp} />;
 };
 ```
 
-**Method 2: Global State**
+### Accessing Original Firebase Errors
+
+For advanced use cases, access the raw Firebase error:
 ```typescript
 const { error } = useAuth();
 
 useEffect(() => {
   if (error?.originalError) {
-    const rawCode = (error.originalError as any).code;
-    console.log("Raw Firebase Code:", rawCode);
+    console.log('Firebase Error Code:', error.originalError.code);
+    console.log('Firebase Error Message:', error.originalError.message);
     
-    if (rawCode === 'auth/invalid-email') {
-      setLocalizedMessage(t('errors.bad_email'));
+    // Custom handling for specific Firebase codes
+    if (error.originalError.code === 'auth/requires-recent-login') {
+      showReauthenticationPrompt();
     }
   }
 }, [error]);
 ```
 
+### Error Logging for Debugging
+```typescript
+const { error } = useAuth();
+
+useEffect(() => {
+  if (error) {
+    // Log full error details (includes timestamp, code, original error)
+    console.log('Auth Error:', JSON.stringify(error.toJSON(), null, 2));
+    
+    // Send to error tracking service (e.g., Sentry)
+    logErrorToService(error.toJSON());
+  }
+}, [error]);
+```
+
+### Global Error Boundary
+```typescript
+import { useAuth } from 'rn-swiftauth-sdk';
+
+const ErrorBoundary = ({ children }) => {
+  const { error, clearError } = useAuth();
+
+  if (error) {
+    return (
+      <View style={styles.errorScreen}>
+        <Text style={styles.errorTitle}>Oops!</Text>
+        <Text style={styles.errorMessage}>{error.message}</Text>
+        <Text style={styles.errorCode}>Error Code: {error.code}</Text>
+        <Button title="Try Again" onPress={clearError} />
+      </View>
+    );
+  }
+
+  return <>{children}</>;
+};
+```
+
 ---
 
 ## Session Management
@@ -413,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.
 
 ---
 
@@ -421,4 +621,4 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 - **Issues:** [GitHub Issues](https://github.com/allcodez/Auth-SDK_Stage8/issues)
 - **NPM Package:** [rn-swiftauth-sdk](https://www.npmjs.com/package/rn-swiftauth-sdk)
-- **Documentation:** [Full Docs](https://github.com/allcodez/Auth-SDK_Stage8)
+- **Documentation:** [Full Docs](https://github.com/allcodez/Auth-SDK_Stage8)

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"));
@@ -113,9 +114,11 @@ const AuthProvider = ({ config, children }) => {
                         if (tokenError.code === types_1.ProviderErrorCodes.USER_TOKEN_EXPIRED ||
                             tokenError.code === types_1.ProviderErrorCodes.NULL_USER) {
                             setStatus(types_1.AuthStatus.TOKEN_EXPIRED);
+                            setError((0, errors_1.mapFirebaseError)(tokenError));
                         }
                         else {
                             setStatus(types_1.AuthStatus.UNAUTHENTICATED);
+                            setError((0, errors_1.mapFirebaseError)(tokenError));
                         }
                         setUser(null);
                     }
@@ -128,6 +131,7 @@ const AuthProvider = ({ config, children }) => {
             catch (err) {
                 console.error("Auth State Error:", err);
                 setStatus(types_1.AuthStatus.UNAUTHENTICATED);
+                setError((0, errors_1.mapFirebaseError)(err));
             }
             finally {
                 setIsDataLoading(false);
@@ -145,10 +149,10 @@ const AuthProvider = ({ config, children }) => {
             await FirebaseAuth.signInWithEmailAndPassword(firebaseAuthInstance, email, password);
         }
         catch (err) {
-            const mapped = (0, errors_1.mapFirebaseError)(err);
-            setError({ ...mapped, originalError: err });
+            const mappedException = (0, errors_1.mapFirebaseError)(err);
+            setError(mappedException);
             setStatus(types_1.AuthStatus.UNAUTHENTICATED);
-            throw err;
+            throw mappedException;
         }
     };
     const signUpWithEmail = async ({ email, password }) => {
@@ -160,18 +164,36 @@ const AuthProvider = ({ config, children }) => {
             await FirebaseAuth.createUserWithEmailAndPassword(firebaseAuthInstance, email, password);
         }
         catch (err) {
-            const mapped = (0, errors_1.mapFirebaseError)(err);
-            setError({ ...mapped, originalError: err });
+            const mappedException = (0, errors_1.mapFirebaseError)(err);
+            setError(mappedException);
             setStatus(types_1.AuthStatus.UNAUTHENTICATED);
-            throw err;
+            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');
         if (!config.enableGoogle || !config.googleWebClientId) {
-            setError({ code: types_1.AuthErrorCode.CONFIG_ERROR, message: 'Google Auth not configured. Missing googleWebClientId.' });
-            return;
+            const configError = new errors_1.ConfigurationException('Google Auth not configured. Missing googleWebClientId.');
+            setError(configError);
+            throw configError;
         }
         try {
             setError(null);
@@ -187,55 +209,29 @@ const AuthProvider = ({ config, children }) => {
         }
         catch (err) {
             console.error('Google Sign-In Error:', err);
-            let mappedError;
             if (err.code === types_1.ProviderErrorCodes.GOOGLE_CANCELLED) {
-                mappedError = {
-                    code: types_1.AuthErrorCode.GOOGLE_SIGN_IN_CANCELLED,
-                    message: 'Google Sign-In was cancelled',
-                    originalError: err
-                };
+                const cancelError = new errors_1.GoogleSignInCancelledException(err);
+                setError(cancelError);
                 setStatus(types_1.AuthStatus.UNAUTHENTICATED);
                 return;
             }
-            else if (err.code === types_1.ProviderErrorCodes.GOOGLE_IN_PROGRESS) {
-                mappedError = {
-                    code: types_1.AuthErrorCode.GOOGLE_SIGN_IN_IN_PROGRESS,
-                    message: 'Google Sign-In is already in progress',
-                    originalError: err
-                };
-            }
-            else if (err.code === types_1.ProviderErrorCodes.GOOGLE_PLAY_UNAVAILABLE) {
-                mappedError = {
-                    code: types_1.AuthErrorCode.GOOGLE_PLAY_SERVICES_NOT_AVAILABLE,
-                    message: 'Google Play Services are not available. Please update Google Play Services.',
-                    originalError: err
-                };
-            }
-            else {
-                mappedError = (0, errors_1.mapFirebaseError)(err);
-            }
-            setError({ ...mappedError, originalError: err });
+            const mappedException = (0, errors_1.mapFirebaseError)(err);
+            setError(mappedException);
             setStatus(types_1.AuthStatus.UNAUTHENTICATED);
-            throw mappedError;
+            throw mappedException;
         }
     };
     const signInWithApple = async () => {
         if (!firebaseAuthInstance)
             throw new Error('Firebase not initialized');
         if (react_native_1.Platform.OS !== 'ios') {
-            const platformError = {
-                code: types_1.AuthErrorCode.APPLE_SIGN_IN_NOT_SUPPORTED,
-                message: 'Apple Sign-In is only available on iOS devices',
-            };
+            const platformError = new errors_1.AppleSignInNotSupportedException();
             setError(platformError);
             throw platformError;
         }
         const isAvailable = await AppleAuthentication.isAvailableAsync();
         if (!isAvailable) {
-            const availabilityError = {
-                code: types_1.AuthErrorCode.APPLE_SIGN_IN_NOT_SUPPORTED,
-                message: 'Apple Sign-In is not available on this device (requires iOS 13+)',
-            };
+            const availabilityError = new errors_1.AppleSignInNotSupportedException();
             setError(availabilityError);
             throw availabilityError;
         }
@@ -265,19 +261,15 @@ const AuthProvider = ({ config, children }) => {
         catch (err) {
             console.error('Apple Sign-In Error:', err);
             if (err.code === types_1.ProviderErrorCodes.APPLE_CANCELLED) {
-                const cancelError = {
-                    code: types_1.AuthErrorCode.APPLE_SIGN_IN_CANCELLED,
-                    message: 'Apple Sign-In was cancelled',
-                    originalError: err
-                };
+                const cancelError = new errors_1.AppleSignInCancelledException(err);
                 setError(cancelError);
                 setStatus(types_1.AuthStatus.UNAUTHENTICATED);
                 return;
             }
-            const mappedError = (0, errors_1.mapFirebaseError)(err);
-            setError({ ...mappedError, originalError: err });
+            const mappedException = (0, errors_1.mapFirebaseError)(err);
+            setError(mappedException);
             setStatus(types_1.AuthStatus.UNAUTHENTICATED);
-            throw mappedError;
+            throw mappedException;
         }
     };
     const signOut = async () => {
@@ -297,6 +289,8 @@ const AuthProvider = ({ config, children }) => {
         }
         catch (err) {
             console.error('Sign out error:', err);
+            const signOutError = (0, errors_1.mapFirebaseError)(err);
+            setError(signOutError);
             setUser(null);
             setStatus(types_1.AuthStatus.UNAUTHENTICATED);
         }
@@ -310,6 +304,7 @@ const AuthProvider = ({ config, children }) => {
         config,
         signInWithEmail,
         signUpWithEmail,
+        sendPasswordReset,
         signInWithGoogle,
         signInWithApple,
         signOut,

package/dist/errors/errorMapper.d.ts

@@ -1,2 +1,10 @@
-import { AuthError } from '../types';
-export declare const mapFirebaseError: (error: any) => AuthError;
+import { AuthException } from './exceptions';
+export declare const mapFirebaseError: (error: any) => AuthException;
+/**
+ * Helper function to check if an error is a specific exception type
+ */
+export declare const isAuthException: (error: any, exceptionType: new (...args: any[]) => AuthException) => boolean;
+/**
+ * Helper to extract user-friendly message from any error
+ */
+export declare const getErrorMessage: (error: any) => string;