[Enhancement] Enhance useAuth hook with user context and session persistence

[kingksjo]

Domain: Authentication

---

Issue [Enhancement] Enhance useAuth hook with user context and session persistence

Tier: 🟡 Medium

Description:

• Problem: The useAuth hook in src/hooks/useAuth.ts only checks for the existence of a token string in localStorage. It provides no user information (role, email, org ID), no logout function, and no way to refresh auth state after login. Components needing user details (like CompanyDashboard for enterpriseId or UserManagement for role-based access) have no centralized source of truth.
• Implementation: Enhance useAuth to: (1) decode the JWT payload to extract user info (id, email, role, organizationId), (2) expose a user object, logout() function, and refreshAuth() method, (3) create an AuthContext provider wrapping the app so all components can access auth state without prop drilling.

Dependencies:

• Depends on Issue [Design] Create the Navin design system and color tokens #5 (token validation)

Acceptance Criteria:

• useAuth returns { isLoading, isAuthenticated, user, logout, refreshAuth }.
• user object includes id, email, name, role, and organizationId from the token.
• logout() clears token, resets state, and navigates to /login.
• AuthContext provider wraps the app in the component tree.
• Components can access useAuth() from any level without prop drilling.
• Token expiration is detected and triggers automatic logout.

Testing Requirements:

• Unit tests for token decoding with valid and expired JWTs.
• Unit tests for logout() clearing state and storage.
• Unit tests written for the core logic (target 80%+ coverage).
• Context provider renders children correctly when authenticated and unauthenticated.

PR Checklist:

• Branch is named conventionally (e.g., feature/issue-15-useauth-enhancement).
• pnpm run lint and pnpm run build pass with zero warnings.
• Screenshot of passing test terminal logs is attached to the PR.

[temitope-007]

@temitope-007 has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hi maintainer

Please I would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @temitope-007 to this issue.

[dykdee]

@dykdee has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

I would like to work on this issue because improving the useAuth hook will make authentication more reliable and easier to use across the app. Having user details, logout, refresh logic, and a shared AuthContext will also reduce repeated auth handling in components.

I have experience working with React hooks, context providers, JWT-based auth flows, and frontend state management. I can update src/hooks/useAuth.ts to decode the token, expose the user, logout, and refreshAuth methods, add the AuthContext provider around the app, and include tests for valid tokens, expired tokens, logout behavior, and authenticated/unauthenticated rendering.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @dykdee to this issue.

[nikkybel]

@nikkybel has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Can I be assigned this issue?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @nikkybel to this issue.

[drips-wave]

Congratulations, @nikkybel! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

🧑‍💻 @nikkybel: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊