@umituz/react-native-auth 3.4.32 → 3.4.34

package/src/presentation/components/ProfileComponents.md

@@ -1,575 +1,378 @@
 # Profile Components
 
-Components for user profile display and account management.
-
-## Components
-
-- **[`ProfileSection`](#profilesection)** - Profile display section
-- **[`AccountActions`](#accountactions)** - Account management actions
+Components for displaying user profile information and managing account actions.
 
 ---
 
 ## ProfileSection
 
-Component that displays user profile information including avatar, name, and user ID.
+Displays user profile information including avatar, name, and authentication status.
+
+### Strategy
 
-### Usage
+**Purpose**: Show user profile information with different layouts for authenticated vs anonymous users.
 
+**When to Use**:
+- Settings screens showing user info
+- Profile headers in navigation
+- Account management sections
+- User identification in UI
+
+**Import Path**:
 ```typescript
 import { ProfileSection } from '@umituz/react-native-auth';
-
-function SettingsScreen() {
-  const profile = useUserProfile({
-    accountRoute: 'AccountSettings',
-  });
-
-  const navigation = useNavigation();
-
-  return (
-    <View>
-      <ProfileSection
-        profile={{
-          displayName: profile?.displayName,
-          userId: profile?.userId,
-          isAnonymous: profile?.isAnonymous || false,
-          avatarUrl: profile?.avatarUrl,
-          accountSettingsRoute: profile?.accountSettingsRoute,
-        }}
-        onPress={() => navigation.navigate('EditProfile')}
-        onSignIn={() => navigation.navigate('Login')}
-        signInText="Sign In"
-        anonymousText="Guest"
-      />
-    </View>
-  );
-}
 ```
 
-### Props
+**Component Location**: `src/presentation/components/ProfileSection.tsx`
 
-| Prop | Type | Required | Description |
-|------|------|----------|-------------|
-| `profile` | `ProfileSectionConfig` | Yes | Profile configuration |
-| `onPress` | `() => void` | No | Press handler (for authenticated users) |
-| `onSignIn` | `() => void` | No | Sign-in handler (for anonymous users) |
-| `signInText` | `string` | No | "Sign In" button text |
-| `anonymousText` | `string` | No | Anonymous user label |
+**Data Hook**: `src/presentation/hooks/useUserProfile.ts`
 
-#### ProfileSectionConfig
+### Rules
 
-```typescript
-interface ProfileSectionConfig {
-  displayName?: string;        // Display name
-  userId?: string;             // User ID
-  isAnonymous: boolean;        // Is anonymous user
-  avatarUrl?: string;          // Profile photo URL
-  accountSettingsRoute?: string; // Account settings route
-  benefits?: string[];         // Benefits list
-}
-```
+**MUST**:
+- Pass profile object with required fields
+- Provide different handlers for authenticated vs anonymous users
+- Show avatar fallback if no photo available
+- Display authentication status clearly
+- Handle navigation to profile editing
 
-### Examples
+**MUST NOT**:
+- Show sensitive information (user ID, email publicly)
+- Allow anonymous users to access profile editing
+- Display generic avatar for authenticated users without photo
+- Hardcode profile data (use useUserProfile hook)
 
-#### Authenticated User
+### Constraints
 
-```typescript
-function ProfileSection() {
-  const { user } = useAuth();
-
-  const profile = {
-    displayName: user?.displayName || user?.email,
-    userId: user?.uid,
-    isAnonymous: false,
-    avatarUrl: user?.photoURL,
-    accountSettingsRoute: 'AccountSettings',
-  };
-
-  const navigation = useNavigation();
-
-  return (
-    <ProfileSection
-      profile={profile}
-      onPress={() => navigation.navigate('EditProfile')}
-    />
-  );
-}
-```
+**AUTHENTICATED USER DISPLAY**:
+- Show display name or email
+- Show avatar if available
+- Show "Edit Profile" or settings access
+- Hide authentication prompts
 
-#### Anonymous User
+**ANONYMOUS USER DISPLAY**:
+- Show "Guest" or anonymous label
+- Show generic placeholder avatar
+- Show "Sign In" or "Create Account" prompt
+- Hide profile editing options
 
+**REQUIRED PROPERTIES**:
 ```typescript
-function ProfileSection() {
-  const { user } = useAuth();
-
-  const profile = {
-    displayName: 'Guest User',
-    userId: undefined,
-    isAnonymous: true,
-    avatarUrl: undefined,
-  };
-
-  const navigation = useNavigation();
-
-  return (
-    <ProfileSection
-      profile={profile}
-      onSignIn={() => navigation.navigate('Login')}
-      signInText="Sign In"
-    />
-  );
+{
+  displayName?: string;
+  isAnonymous: boolean;
+  avatarUrl?: string;
+  accountSettingsRoute?: string;
 }
 ```
 
-#### With Benefits
+**PLATFORM SUPPORT**:
+- iOS: ✅ Fully supported
+- Android: ✅ Fully supported
+- Web: ✅ Fully supported
 
-```typescript
-function PremiumProfileSection() {
-  const { user } = useAuth();
-
-  const profile = {
-    displayName: user?.displayName,
-    userId: user?.uid,
-    isAnonymous: false,
-    avatarUrl: user?.photoURL,
-    benefits: [
-      'Access to premium content',
-      'Ad-free experience',
-      'Exclusive discounts',
-    ],
-  };
-
-  return <ProfileSection profile={profile} />;
-}
-```
+---
 
-#### Dynamic Profile
+## AccountActions
 
-```typescript
-function DynamicProfileSection() {
-  const { user } = useAuth();
-  const navigation = useNavigation();
-  const profile = useUserProfile();
-
-  const handlePress = () => {
-    if (profile?.isAnonymous) {
-      navigation.navigate('Login');
-    } else {
-      navigation.navigate('EditProfile');
-    }
-  };
-
-  return (
-    <ProfileSection
-      profile={{
-        displayName: profile?.displayName,
-        userId: profile?.userId,
-        isAnonymous: profile?.isAnonymous || false,
-        avatarUrl: profile?.avatarUrl,
-        benefits: profile?.isAnonymous
-          ? ['Create an account to access more features']
-          : ['Get premium membership', 'Access exclusive content'],
-      }}
-      onPress={handlePress}
-    />
-  );
-}
-```
+Provides buttons for account management operations like sign out and account deletion.
 
-#### With Custom Avatar
+### Strategy
 
-```typescript
-function ProfileSectionWithCustomAvatar() {
-  const { user } = useAuth();
-  const navigation = useNavigation();
-
-  const profile = {
-    displayName: user?.displayName || 'User',
-    userId: user?.uid,
-    isAnonymous: user?.isAnonymous || false,
-    avatarUrl: user?.photoURL || 'https://example.com/default-avatar.png',
-    accountSettingsRoute: 'AccountSettings',
-  };
-
-  return (
-    <ProfileSection
-      profile={profile}
-      onPress={() => navigation.navigate('EditProfile')}
-    />
-  );
-}
-```
+**Purpose**: Safe account management with proper confirmations and error handling.
 
-#### With Edit Indicator
+**When to Use**:
+- Account settings screens
+- Logout functionality
+- Account deletion flows
+- Password change access
 
+**Import Path**:
 ```typescript
-function ProfileSectionWithEditIndicator() {
-  const profile = useUserProfile();
-  const navigation = useNavigation();
-
-  return (
-    <View>
-      <ProfileSection
-        profile={{
-          displayName: profile?.displayName,
-          userId: profile?.userId,
-          isAnonymous: profile?.isAnonymous || false,
-          avatarUrl: profile?.avatarUrl,
-          accountSettingsRoute: 'AccountSettings',
-        }}
-        onPress={() => navigation.navigate('EditProfile')}
-      />
-      <TouchableOpacity
-        style={styles.editButton}
-        onPress={() => navigation.navigate('EditProfile')}
-      >
-        <Text>Edit Profile</Text>
-      </TouchableOpacity>
-    </View>
-  );
-}
+import { AccountActions } from '@umituz/react-native-auth';
 ```
 
+**Component Location**: `src/presentation/components/AccountActions.tsx`
+
+**Management Hook**: `src/presentation/hooks/useAccountManagement.ts`
+
+### Rules
+
+**MUST**:
+- Require confirmation before sign out
+- Require confirmation before account deletion
+- Show clear warnings for account deletion
+- Provide error messages for failures
+- Handle loading states during operations
+- Hide deletion option for anonymous users
+
+**MUST NOT**:
+- Allow account deletion without confirmation
+- Delete account without recent authentication
+- Show account actions to anonymous users
+- Allow immediate destructive actions
+- Expose internal error messages
+
+### Constraints
+
+**SIGN OUT REQUIREMENTS**:
+- Confirmation dialog required
+- Clear sign-out message
+- Cancel option must be available
+- Non-destructive (can sign back in)
+
+**ACCOUNT DELETION REQUIREMENTS**:
+- Double confirmation required (warning + confirm)
+- Clear warning about irreversibility
+- Recent authentication required (Firebase requirement)
+- Error handling for re-authentication failures
+- Cannot delete anonymous accounts
+
+**PASSWORD CHANGE**:
+- Optional feature (configurable)
+- Only for email/password users
+- Requires current password
+- Not available for social auth users
+
+**OPERATION SAFETY**:
+- Disable buttons during operation
+- Show loading indicators
+- Prevent concurrent operations
+- Allow retry on failure
+- Log security events
+
 ---
 
-## AccountActions
+## Anonymous User Handling
 
-Component for account management operations including sign out, password change, and account deletion.
+### Strategy
 
-### Usage
+**Purpose**: Differentiate experience between authenticated and anonymous users appropriately.
 
-```typescript
-import { AccountActions } from '@umituz/react-native-auth';
+### Rules
 
-function AccountSettingsScreen() {
-  const { logout, deleteAccount } = useAccountManagement();
-  const navigation = useNavigation();
-
-  const config = {
-    logoutText: 'Sign Out',
-    deleteAccountText: 'Delete Account',
-    changePasswordText: 'Change Password',
-    logoutConfirmTitle: 'Sign Out',
-    logoutConfirmMessage: 'Are you sure you want to sign out?',
-    deleteConfirmTitle: 'Delete Account',
-    deleteConfirmMessage: 'This action cannot be undone. Continue?',
-    deleteErrorTitle: 'Error',
-    deleteErrorMessage: 'Account could not be deleted. Please try again.',
-    onLogout: async () => {
-      await logout();
-      navigation.replace('Login');
-    },
-    onDeleteAccount: async () => {
-      await deleteAccount();
-      navigation.replace('Login');
-    },
-    showChangePassword: true,
-    onChangePassword: () => {
-      navigation.navigate('ChangePassword');
-    },
-  };
-
-  return (
-    <View>
-      <AccountActions config={config} />
-    </View>
-  );
-}
-```
+**MUST**:
+- Hide account deletion for anonymous users
+- Show "Create Account" prompt instead of sign out
+- Indicate guest status clearly
+- Guide anonymous users toward registration
 
-### Props
+**MUST NOT**:
+- Show account deletion to anonymous users
+- Allow sign out of anonymous session (unless upgrading)
+- Treat anonymous users as authenticated
+- Hide anonymous status from user
 
-| Prop | Type | Required | Description |
-|------|------|----------|-------------|
-| `config` | `AccountActionsConfig` | Yes | Account actions configuration |
+### Constraints
 
-#### AccountActionsConfig
+**ANONYMOUS USER LIMITATIONS**:
+- Cannot delete anonymous account
+- Cannot change password (no password set)
+- Cannot access profile editing
+- Limited account settings access
 
-```typescript
-interface AccountActionsConfig {
-  logoutText: string;                  // "Sign Out" button text
-  deleteAccountText: string;           // "Delete Account" button text
-  changePasswordText?: string;         // "Change Password" button text
-  logoutConfirmTitle: string;          // Sign out confirmation title
-  logoutConfirmMessage: string;        // Sign out confirmation message
-  deleteConfirmTitle: string;          // Delete confirmation title
-  deleteConfirmMessage: string;        // Delete confirmation message
-  deleteErrorTitle?: string;           // Delete error title
-  deleteErrorMessage?: string;         // Delete error message
-  onLogout: () => Promise<void>;       // Sign out handler
-  onDeleteAccount: () => Promise<void>; // Delete handler
-  onChangePassword?: () => void;       // Change password handler
-  showChangePassword?: boolean;        // Show change password button
-}
-```
+**UPGRADE PATH**:
+- Anonymous → Registered: Link credentials
+- Preserves anonymous account data
+- Requires email/password or social auth
+- Seamless transition for user
 
-### Examples
+---
 
-#### Basic Usage
+## Security & Privacy
 
-```typescript
-function SimpleAccountActions() {
-  const { logout, deleteAccount } = useAccountManagement();
-
-  const config = {
-    logoutText: 'Sign Out',
-    deleteAccountText: 'Delete Account',
-    logoutConfirmTitle: 'Sign Out',
-    logoutConfirmMessage: 'Are you sure you want to sign out?',
-    deleteConfirmTitle: 'Delete Account',
-    deleteConfirmMessage: 'Are you sure you want to delete your account?',
-    onLogout: logout,
-    onDeleteAccount: deleteAccount,
-  };
-
-  return <AccountActions config={config} />;
-}
-```
+### Strategy
 
-#### With Password Change
+**Purpose**: Protect user information and prevent unauthorized account access.
 
-```typescript
-function AccountActionsWithPasswordChange() {
-  const { logout, deleteAccount } = useAccountManagement();
-  const navigation = useNavigation();
-
-  const config = {
-    logoutText: 'Sign Out',
-    deleteAccountText: 'Delete Account',
-    changePasswordText: 'Change Password',
-    logoutConfirmTitle: 'Sign Out',
-    logoutConfirmMessage: 'Are you sure you want to sign out?',
-    deleteConfirmTitle: 'Delete Account',
-    deleteConfirmMessage: 'Are you sure you want to delete your account?',
-    onLogout: async () => {
-      await logout();
-      navigation.replace('Login');
-    },
-    onDeleteAccount: async () => {
-      await deleteAccount();
-      navigation.replace('Login');
-    },
-    showChangePassword: true,
-    onChangePassword: () => {
-      navigation.navigate('ChangePassword');
-    },
-  };
-
-  return <AccountActions config={config} />;
-}
-```
+### Rules
 
-#### With Custom Error Handling
+**MUST**:
+- Never display full user ID in UI
+- Never expose sensitive tokens
+- Require recent auth for destructive actions
+- Log account management events
+- Validate permissions before actions
 
-```typescript
-function AccountActionsWithErrorHandling() {
-  const { logout, deleteAccount } = useAccountManagement();
-  const navigation = useNavigation();
-
-  const config = {
-    logoutText: 'Sign Out',
-    deleteAccountText: 'Delete Account',
-    logoutConfirmTitle: 'Sign Out',
-    logoutConfirmMessage: 'Are you sure you want to sign out?',
-    deleteConfirmTitle: 'Delete Account',
-    deleteConfirmMessage: 'This action cannot be undone. Continue?',
-    deleteErrorTitle: 'Account Deletion Failed',
-    deleteErrorMessage: 'An error occurred while deleting your account. Please try again later or contact support.',
-    onLogout: async () => {
-      try {
-        await logout();
-        navigation.replace('Login');
-      } catch (error) {
-        Alert.alert('Error', 'Failed to sign out');
-      }
-    },
-    onDeleteAccount: async () => {
-      try {
-        await deleteAccount();
-        Alert.alert('Success', 'Your account has been deleted');
-        navigation.replace('Login');
-      } catch (error) {
-        // Error is automatically shown (deleteErrorMessage)
-        throw error;
-      }
-    },
-  };
-
-  return <AccountActions config={config} />;
-}
-```
+**MUST NOT**:
+- Show user ID or internal identifiers
+- Display raw email publicly
+- Allow account deletion without re-auth
+- Skip confirmation dialogs
+- Log sensitive data
 
-#### For Anonymous Users
+### Constraints
 
-```typescript
-function AccountActionsAnonymous() {
-  const { isAnonymous } = useAuth();
-
-  if (isAnonymous) {
-    return (
-      <Button onPress={() => navigation.navigate('Register')}>
-        Create Account
-      </Button>
-    );
-  }
-
-  const config = {
-    logoutText: 'Sign Out',
-    deleteAccountText: 'Delete Account',
-    logoutConfirmTitle: 'Sign Out',
-    logoutConfirmMessage: 'Are you sure you want to sign out?',
-    deleteConfirmTitle: 'Delete Account',
-    deleteConfirmMessage: 'Are you sure you want to delete your account?',
-    onLogout: logout,
-    onDeleteAccount: deleteAccount,
-  };
-
-  return <AccountActions config={config} />;
-}
-```
+**INFORMATION DISPLAY**:
+- Display name: OK
+- Email: Only to account owner
+- User ID: Never in UI
+- Auth tokens: Never in logs
 
-#### With Loading States
+**RE-AUTHENTICATION**:
+- Required for: Account deletion, password change
+- Timeout: Usually 5 minutes in Firebase
+- Methods: Re-sign in with existing credentials
+- Failure: Block destructive action
 
-```typescript
-function AccountActionsWithLoading() {
-  const { logout, deleteAccount, isLoading, isDeletingAccount } = useAccountManagement();
-  const navigation = useNavigation();
-
-  const config = {
-    logoutText: isLoading ? 'Signing out...' : 'Sign Out',
-    deleteAccountText: isDeletingAccount ? 'Deleting...' : 'Delete Account',
-    logoutConfirmTitle: 'Sign Out',
-    logoutConfirmMessage: 'Are you sure?',
-    deleteConfirmTitle: 'Delete Account',
-    deleteConfirmMessage: 'This cannot be undone. Continue?',
-    onLogout: async () => {
-      await logout();
-      navigation.replace('Login');
-    },
-    onDeleteAccount: async () => {
-      await deleteAccount();
-      navigation.replace('Login');
-    },
-  };
-
-  return (
-    <AccountActions
-      config={config}
-      isLoading={isLoading}
-      isDeletingAccount={isDeletingAccount}
-    />
-  );
-}
-```
+**EVENT LOGGING**:
+- Log: Account views, settings access
+- Log: Sign out, deletion attempts
+- Never log: Passwords, tokens, full emails
+- Purpose: Security audit, debugging
 
-#### With Analytics
+---
 
-```typescript
-function AccountActionsWithAnalytics() {
-  const { logout, deleteAccount } = useAccountManagement();
-  const analytics = useAnalytics();
-
-  const config = {
-    logoutText: 'Sign Out',
-    deleteAccountText: 'Delete Account',
-    logoutConfirmTitle: 'Sign Out',
-    logoutConfirmMessage: 'Are you sure?',
-    deleteConfirmTitle: 'Delete Account',
-    deleteConfirmMessage: 'This cannot be undone.',
-    onLogout: async () => {
-      analytics.trackEvent('account_logout');
-      await logout();
-    },
-    onDeleteAccount: async () => {
-      analytics.trackEvent('account_delete_initiated');
-      await deleteAccount();
-      analytics.trackEvent('account_delete_completed');
-    },
-  };
-
-  return <AccountActions config={config} />;
-}
-```
+## Navigation Integration
 
-## Combined Usage
+### Strategy
 
-```typescript
-function AccountSettingsScreen() {
-  const profile = useUserProfile();
-  const { logout, deleteAccount } = useAccountManagement();
-  const navigation = useNavigation();
-
-  return (
-    <ScrollView>
-      {/* Profile section */}
-      <ProfileSection
-        profile={{
-          displayName: profile?.displayName,
-          userId: profile?.userId,
-          isAnonymous: profile?.isAnonymous || false,
-          avatarUrl: profile?.avatarUrl,
-        }}
-        onPress={() => navigation.navigate('EditProfile')}
-      />
-
-      {/* Account actions */}
-      {!profile?.isAnonymous && (
-        <AccountActions
-          config={{
-            logoutText: 'Sign Out',
-            deleteAccountText: 'Delete Account',
-            logoutConfirmTitle: 'Sign Out',
-            logoutConfirmMessage: 'Are you sure you want to sign out?',
-            deleteConfirmTitle: 'Delete Account',
-            deleteConfirmMessage: 'This action cannot be undone. Continue?',
-            onLogout: async () => {
-              await logout();
-              navigation.replace('Login');
-            },
-            onDeleteAccount: async () => {
-              await deleteAccount();
-              navigation.replace('Login');
-            },
-          }}
-        />
-      )}
-    </ScrollView>
-  );
-}
-```
+**Purpose**: Proper navigation flow for profile-related screens.
 
-## Styling
+### Rules
 
-Components use design system tokens:
+**MUST**:
+- Provide navigation callbacks for all actions
+- Handle back navigation properly
+- Pass profile data to edit screens
+- Return to proper screen after actions
 
-```typescript
-{
-  colors: {
-    primary: tokens.colors.primary,
-    danger: tokens.colors.error,
-    text: tokens.colors.textPrimary,
-    background: tokens.colors.background,
-  },
-  spacing: tokens.spacing,
-}
-```
+**MUST NOT**:
+- Hardcode navigation paths
+- Break back navigation stack
+- Lose unsaved changes
+- Leave modals open after actions
+
+### Constraints
+
+**NAVIGATION FLOWS**:
+- Profile → Edit Profile → Back to Profile
+- Profile → Account Settings → Back to Profile
+- Sign Out → Login Screen (replace stack)
+- Delete Account → Welcome/Login (replace stack)
+
+**STACK MANAGEMENT**:
+- Sign out: Replace entire stack
+- Delete account: Replace entire stack
+- Edit profile: Push onto stack
+- Settings: Push onto stack
+
+---
+
+## Error Handling
+
+### Strategy
+
+**Purpose**: Clear user feedback for account action failures.
+
+### Rules
+
+**MUST**:
+- Show user-friendly error messages
+- Provide retry options after failures
+- Distinguish error types clearly
+- Guide users to resolution
+- Log errors for debugging
 
-## Accessibility
+**MUST NOT**:
+- Show raw error codes to users
+- Expose technical details
+- Block retry indefinitely
+- Crash on errors
 
-Components include accessibility features:
+### Constraints
 
-- ✅ Screen reader labels
-- ✅ Accessibility hints
-- ✅ Proper touch targets
-- ✅ High contrast support
-- ✅ Semantic button labels
+**ERROR CATEGORIES**:
+- Network errors: "Check your connection"
+- Re-auth required: "Please sign in again"
+- Permission denied: "You don't have permission"
+- Rate limited: "Please try again later"
 
-## Related Components
+**RECOVERY OPTIONS**:
+- Retry button for temporary failures
+- Sign-in prompt for re-auth
+- Support contact for persistent issues
+- Graceful degradation
 
-- [`EditProfileForm`](./README.md) - Profile editing form
-- [`EditProfileAvatar`](./README.md) - Profile photo editing
+---
+
+## Design System Integration
+
+### Strategy
+
+**Purpose**: Consistent styling with application design system.
+
+### Rules
+
+**MUST**:
+- Use design system color tokens
+- Follow design system spacing
+- Use design system typography
+- Match design system component styles
+- Respect design system dark mode
+
+**MUST NOT**:
+- Hardcode colors or sizes
+- Use custom styles outside system
+- Break responsive layouts
+- Ignore accessibility tokens
+
+### Constraints
+
+**STYLE TOKENS**:
+- Colors: Primary, danger, background, text
+- Spacing: Consistent gaps and padding
+- Typography: System fonts and sizes
+- Icons: Design system icon set
+- Avatar sizes: Defined in system
+
+**DARK MODE**:
+- Automatically support dark mode
+- Use system color tokens
+- Test contrast in both modes
+- No hardcoded colors
+
+---
+
+## Accessibility Requirements
+
+### Strategy
+
+**Purpose**: Ensure profile components are accessible to all users.
+
+### Rules
+
+**MUST**:
+- Provide accessibility labels for buttons
+- Announce state changes to screen readers
+- Support keyboard navigation (web)
+- Maintain proper focus order
+- Use semantic HTML elements (web)
+
+**MUST NOT**:
+- Rely on color alone for meaning
+- Hide important information from screen readers
+- Break keyboard navigation
+- Use low contrast colors
+
+### Constraints
+
+**SCREEN READER**:
+- Announce user name and status
+- Announce button actions clearly
+- Provide hints for destructive actions
+- Announce loading states
+
+**VISUAL ACCESSIBILITY**:
+- Minimum contrast: 4.5:1 for text
+- Touch targets: 44x44px minimum
+- Clear focus indicators
+- Not color-dependent
+
+---
 
 ## Related Hooks
 
-- [`useUserProfile`](../hooks/useUserProfile.md) - Profile data hook
-- [`useAccountManagement`](../hooks/useAccountManagement.md) - Account management hook
-- [`useAuth`](../hooks/useAuth.md) - Main auth state management
+- **`useUserProfile`** (`src/presentation/hooks/useUserProfile.ts`) - Profile data management
+- **`useAccountManagement`** (`src/presentation/hooks/useAccountManagement.ts`) - Account operations
+- **`useAuth`** (`src/presentation/hooks/useAuth.ts`) - Authentication state