How jcsb83/base-nestjs-backend-auth-db works
This is a NestJS HTTP authentication backend. Clients log in to receive access and refresh tokens; protected requests validate the access token against persisted user/session state, while refresh, logout, and session-management endpoints update that state. The graph also preserves the documented configuration, logging, health, and Prometheus capabilities. Edges use README statements and indexed imports or calls; some persistence links are dashed because the relevant use-case implementations were not excerpted.
Main entry points: controllers Auth controllers · app.module.ts Root modules · main.ts Nest bootstrap · session.repository.ts Session repository
Components 21
Application runtime
- Nest bootstrap
src/main.ts - Root modules
src/app.module.ts - Validated config
src/app.config.ts - Shared response/errors
src/modules/shared/controllers/common.controller.ts
Authentication API
- Auth controllers
src/modules/auth-db/presentation/controllers - JWT guard
src/modules/auth-db/infrastructure/guards/jwt.authguard.ts
Auth application
- Login use case
src/modules/auth-db/application/use-cases/login.use-case.ts - Refresh use case
src/modules/auth-db/application/use-cases/refreshToken.use-case.ts - Session use cases
src/modules/auth-db/application/use-cases - Token validation
src/modules/auth-db/application/use-cases/validateToken.use-case.ts
Auth persistence
- User repository
src/modules/auth-db/infrastructure/persistence/typeorm/repositories/user.repository.ts - Session repository
src/modules/auth-db/infrastructure/persistence/typeorm/repositories/session.repository.ts - Refresh-token repository
src/modules/auth-db/infrastructure/persistence/typeorm/repositories/refreshToken.repository.ts
Operations
- Health endpoints
src/modules/health/health.controller.ts - Metrics endpoints
src/modules/metrics/metrics.controller.ts - Metrics service
src/modules/metrics/metrics.service.ts - Request logging
src/modules/shared/interceptors/log-request.interceptor.ts - Logger providers
src/modules/shared/services/log4jsLogger.service.ts
Other components
- HTTP client
- PostgreSQL
- Loki
Connections 25
- HTTP client → Nest bootstrap: sends requests
- Nest bootstrap → Root modules: starts
src/main.ts - Root modules → Validated config: loads configuration
src/app.module.ts - Root modules → Auth controllers: loads auth module
src/app.module.ts - Root modules → Health endpoints: loads health module
src/app.module.ts - Root modules → Metrics endpoints: loads metrics module
src/app.module.ts - HTTP client → Auth controllers: calls endpoints
- Auth controllers → Login use case: executes login
src/modules/auth-db/presentation/controllers/login.controller.ts - Auth controllers → Refresh use case: executes renewal
src/modules/auth-db/presentation/controllers/refresh.controller.ts - Auth controllers → Session use cases: executes session actions
src/modules/auth-db/presentation/controllers/session.controller.ts - Auth controllers → JWT guard: guards protected routes
src/modules/auth-db/presentation/controllers/session.controller.ts - JWT guard → Token validation: validates token
src/modules/auth-db/infrastructure/guards/jwt.authguard.ts - Login use case → User repository: checks credentials
- Token validation → User repository: loads user
- Token validation → Session repository: checks session
- Refresh use case → Session repository: replaces session
- Session repository → Refresh-token repository: updates token records
src/modules/auth-db/infrastructure/persistence/typeorm/repositories/session.repository.ts - User repository → PostgreSQL: queries
src/modules/auth-db/infrastructure/persistence/typeorm/repositories/user.repository.ts - Session repository → PostgreSQL: reads and writes
src/modules/auth-db/infrastructure/persistence/typeorm/repositories/session.repository.ts - Refresh-token repository → PostgreSQL: reads and writes
src/modules/auth-db/infrastructure/persistence/typeorm/repositories/refreshToken.repository.ts - Auth controllers → Shared response/errors: formats errors
src/modules/auth-db/presentation/controllers/refresh.controller.ts - Metrics endpoints → Metrics service: reads metrics
src/modules/metrics/metrics.controller.ts - Nest bootstrap → Request logging: registers interceptor
src/main.ts - Nest bootstrap → Logger providers: configures logging
- Logger providers → Loki: ships logs