feat: implementing the logout feature

Logout Functionality Overview

Key Features

• API Call First
  Attempts to call the backend logout endpoint to invalidate the token on the server side.

• Graceful Error Handling
  If the API call fails (for example, token already invalid or network issues), a warning is logged and the logout process continues locally.

• Always Clear Local State
  Uses a finally block to ensure the local authentication token is always cleared, even if the API call fails.

---

Related Functions

• clearAuthToken()
  Removes the authentication token from localStorage and sets the auth state to null.

• apiLogout()
  Makes the actual API call to the backend logout endpoint.

---

Logout Usage

• Available through the useAuth() hook.
• Integrated with Axios interceptors via setupAuthInterceptors().
• Supports multi-tab synchronization using the storage event listener.

---

Files Related to Logout Functionality

1. api.ts (Lines 640–645)

• logout()
  API function that calls POST /api/v1/auth/logout to invalidate the token on the backend.

---

2. AuthContext.tsx (Lines 2, 11, 106–118)

• Imports logout as apiLogout from api.ts.
• Exports logout function in the AuthContextValue interface.
• Implements a logout() wrapper that:
  • Calls the backend logout API.
  • Clears the local token using clearAuthToken().
  • Handles errors gracefully (continues local logout even if the API call fails).
• Integrated with Axios interceptors via setupAuthInterceptors().

---

3. DashboardPage.tsx (Lines 11, 21–22)

• Uses logout from the useAuth() hook.
• Contains the handleLogout() function.

---

4. LoginPage.tsx

• Imports authentication utilities from @/contexts/AuthContext.

---

Logout Flow

1. User clicks the Logout button → calls logout() from useAuth().
2. logout() in AuthContext calls apiLogout() from api.ts.
3. API sends POST /api/v1/auth/logout to invalidate the token on the server.
4. Local token is cleared from localStorage via clearAuthToken().
5. User authentication state is reset to null, and the user is redirected to the login page.