import { HttpClient, HttpErrorResponse } from '@angular/common/http'; import { Injectable, computed, inject, signal } from '@angular/core'; import { firstValueFrom } from 'rxjs'; import { AUTH_BFF_BASE_URL, AUTH_NAVIGATOR } from './auth.config'; import type { AuthState, CurrentUser } from './auth.types'; /** * SPA-side authentication state, sourced from the BFF's * `GET /api/auth/me` (ADR-0009 / ADR-0010). Acts as the single point * of truth for "is the user signed in?" — every consumer (header * widget, future route guards, downstream API gates) reads from the * `state` / `currentUser` signals. * * Auto-bootstraps on first injection: the constructor fires an * unawaited `refresh()`, so consuming components see `{kind: * 'loading'}` briefly, then either `authenticated` or `anonymous`. * * `login()` and `logout()` perform full-page navigations to the BFF * routes — the SPA never holds tokens (per ADR-0009), so a browser * redirect through the Entra round-trip is the canonical path. */ @Injectable({ providedIn: 'root' }) export class AuthService { private readonly http = inject(HttpClient); private readonly bffBaseUrl = inject(AUTH_BFF_BASE_URL); private readonly navigate = inject(AUTH_NAVIGATOR); private readonly _state = signal({ kind: 'loading' }); readonly state = this._state.asReadonly(); /** * Convenience: the user payload when authenticated, `null` * otherwise. Lets templates write `@if (currentUser(); as user)` * without unwrapping the discriminated state by hand. */ readonly currentUser = computed(() => { const s = this._state(); return s.kind === 'authenticated' ? s.user : null; }); /** True only while the very first /me round-trip is in flight. */ readonly isLoading = computed(() => this._state().kind === 'loading'); constructor() { // Fire-and-forget so the constructor stays synchronous — // Angular DI runs `providedIn: 'root'` services on first inject, // which happens during app boot; awaiting here would push the // first render behind the network round-trip. void this.refresh(); } /** * Re-fetch `/auth/me`. Called automatically on first injection; * consumers can call it again to refresh after a flow that may * have changed the session (login redirect return, MFA step-up). * Resolves once the new state is committed. */ async refresh(): Promise { try { // `withCredentials: true` is mandatory: the SPA at // http://localhost:4200 calls the BFF at http://localhost:3000 — // different origins, so `fetch`'s default `credentials: // 'same-origin'` would drop the `__Host-portal_session` cookie // and /me would always answer 401. Production (single origin // behind the same edge) doesn't need it but it's harmless there. // CORS on the BFF side already allows credentials // (`apps/portal-bff/src/main.ts` → `enableCors({ credentials: // true })`). const user = await firstValueFrom( this.http.get(this.meUrl, { withCredentials: true }), ); this._state.set({ kind: 'authenticated', user }); } catch (err) { this._state.set(toErrorState(err)); } } /** * Initiate sign-in by navigating to the BFF's `/auth/login`. The * BFF builds the Entra authorize URL and 302s the browser; the * round-trip lands on `/auth/callback` which writes the session * and redirects back to the SPA. * * The navigation goes through the injected {@link AUTH_NAVIGATOR} * function — `window.location.assign` in production, a `vi.fn()` * in specs. */ login(): void { this.navigate(this.loginUrl); } /** * Initiate sign-out by navigating to the BFF's `/auth/logout`, * which destroys the session, clears the cookie, and 302s through * Entra's RP-initiated logout — single sign-out per ADR-0009. */ logout(): void { this.navigate(this.logoutUrl); } get meUrl(): string { return `${this.bffBaseUrl}/auth/me`; } get loginUrl(): string { return `${this.bffBaseUrl}/auth/login`; } get logoutUrl(): string { return `${this.bffBaseUrl}/auth/logout`; } } function toErrorState(err: unknown): AuthState { // The BFF returns 401 with `{error: 'unauthenticated'}` when no // session is on the request. Anything else (network failure, // 5xx, malformed response) lands in the explicit `error` state so // the UI can distinguish "please sign in" from "can't reach the // server right now". if (err instanceof HttpErrorResponse && err.status === 401) { return { kind: 'anonymous' }; } return { kind: 'error' }; }