server/src/typings/express.d.ts

// Augments Express's `Request` with the fields TREK middleware + Nest guards
// attach after authentication. Replaces the per-site casts
// (`(req as AuthRequest).user`, `getRequest<Request & { user?: User }>()`) with
// a single source of truth so downstream code can read `req.user` directly.

import type { User } from '../types';

declare module 'express-serve-static-core' {
  interface Request {
    /**
     * Set by `authenticate` middleware (Express) and `JwtAuthGuard` (Nest).
     * Present on every route mounted behind those guards. `null` is used by
     * `optionalAuthenticate` to signal "checked, but unauthenticated".
     */
    user?: User | null;
  }
}

// This file has imports, so TS treats it as a module. The empty export keeps
// the `declare module` augmentation visible project-wide.
export {};