How nestjs/authorization works
This is a NestJS policy-based authorization library. Its main workflow is to declare policy abilities and route requirements, then evaluate those requirements through a guard or the injectable AuthorizationService; denials become transport-appropriate errors and can emit audit events. The graph also includes configurable module setup, policy discovery and user extraction. The README documents support across HTTP, GraphQL, WebSockets, and microservices; source excerpts show transport-specific user/error handling, while some module wiring is supported by the source index rather than an excerpt.
Main entry points: authorization.guard.ts Authorization guard · policy-evaluator.service.ts Policy evaluator · authorization.service.ts Authorization service · authorization.module.ts Authorization module
Components 19
Policy declarations
- Can decorator
lib/decorators/can.decorator.ts - Policy decorator
lib/decorators/policy.decorator.ts - Policy contracts
lib/interfaces - Authorization metadata
lib/authorization.constants.ts
Policy evaluation
- Policy registry
lib/services/policy-registry.service.ts - Policy evaluator
lib/services/policy-evaluator.service.ts
Enforcement and transports
- Authorization service
lib/authorization.service.ts - Authorization guard
lib/guards/authorization.guard.ts - User extraction
lib/utils/get-user.util.ts - Authorization errors
lib/errors/authorization.error.ts - Transport error mapping
lib/utils/transport-error.util.ts - Error interceptor
lib/interceptors/authorization-error.interceptor.ts
Module and events
- Module configuration
lib/authorization.module-definition.ts - Authorization module
lib/authorization.module.ts - Denial events
lib/events/authorization-events.service.ts
Other components
- Nest application
- Route handler
- Policy providers
- Audit consumers
Connections 22
- Nest application → Module configuration: configures
lib/authorization.module-definition.ts - Module configuration → Authorization module: configures
lib/authorization.module.ts - Authorization module → Authorization guard: registers
lib/authorization.module.ts - Authorization module → Error interceptor: registers
lib/authorization.module.ts - Policy decorator → Authorization metadata: sets metadata
lib/decorators/policy.decorator.ts - Can decorator → Authorization metadata: sets metadata
lib/decorators/can.decorator.ts - Route handler → Authorization guard: guarded by
README.md - Policy providers → Policy registry: discovered by
lib/services/policy-registry.service.ts - Authorization guard → User extraction: extracts user
lib/guards/authorization.guard.ts - Authorization guard → Policy evaluator: requests decision
lib/guards/authorization.guard.ts - Authorization service → Policy evaluator: requests decision
lib/authorization.service.ts - Policy evaluator → Policy registry: gets policy
lib/services/policy-evaluator.service.ts - Policy evaluator → User extraction: normalizes user
lib/services/policy-evaluator.service.ts - Authorization guard → Denial events: emits denial
lib/guards/authorization.guard.ts - Authorization service → Denial events: emits denial
lib/authorization.service.ts - Authorization guard → Authorization errors: throws denial
lib/guards/authorization.guard.ts - Authorization service → Authorization errors: throws denial
lib/authorization.service.ts - Authorization guard → Transport error mapping: maps denial
lib/guards/authorization.guard.ts - Error interceptor → Transport error mapping: maps denial
lib/interceptors/authorization-error.interceptor.ts - Denial events → Audit consumers: publishes events
lib/events/authorization-events.service.ts - Can decorator → Policy contracts: uses requirements
lib/decorators/can.decorator.ts - Policy evaluator → Policy contracts: checks abilities
lib/services/policy-evaluator.service.ts