typestack/routing-controllers

Features

• Class-Based Logic Organization - Organizes API endpoints into structured classes using decorators to define routes and shared behaviors.
• REST API Frameworks - Provides a declarative system for building JSON APIs with automated response formatting and input validation.
• Integration Adapters - Decouples routing logic from underlying web frameworks using adapters for Express and Koa.
• Reflection-Based Data Mapping - Uses reflection and metadata to convert plain JSON request data into typed class instances.
• Request Validation - Validates and transforms incoming request parameters into typed class instances using reflection.
• Declarative API Router Registrations - Implements a declarative system for defining HTTP routes and request handling using class-based decorators.
• Automatic Parameter Injection - Automatically extracts data from request bodies or headers and injects them as typed arguments into handler methods.
• Parameter Coercion and Validation - Validates and coerces incoming request parameters against defined types and constraints, returning structured errors on failure.
• Express Integrations - Acts as a routing wrapper that adds structured class controllers and dependency injection to Express servers.
• Express Routing Integration - Organizes Express routes and request handlers using class-based decorators to reduce boilerplate.
• Koa Integrations - Acts as a routing wrapper that adds structured class controllers and dependency injection to Koa servers.
• Koa Routing Middleware - Provides structured class-based routing and middleware definition for Koa servers using TypeScript.
• Parameter Injections - Automatically extracts request parameters from bodies, headers, and queries and injects them into handler arguments.
• Request Data Transformation - Transforms plain JSON request payloads into typed class instances to ensure type safety and business logic consistency.
• Decorator-Based Route Mappings - Uses TypeScript decorators to map HTTP endpoints to specific class methods via metadata.
• TypeScript - Builds structured server-side applications using TypeScript to organize endpoints into a declarative class-based architecture.
• Web Framework Controllers - Provides a declarative class-based routing layer for organizing API endpoints using decorators in TypeScript.
• Web Server Adapter Drivers - Implements an adapter-based system to decouple routing logic from underlying web servers like Express and Koa.
• Request and Response Interception - Provides a layer to intercept and transform the data returned by controllers before the final response is delivered.
• JSON Response Serializers - Automatically serializes controller return values into JSON and sets the appropriate Content-Type headers.
• Role-Based Access Control - Implements access control via decorators to restrict controller actions based on assigned user roles and permissions.
• Automatic Dependency Discovery - Automatically discovers and registers controllers, middleware, and interceptors using filesystem glob patterns.
• Parameter - Provides reusable decorators to extract specific values from the request context directly into action parameters.
• Dependency Injection - Supports injecting services into controllers and handlers using compatible dependency injection containers.
• Authenticated User Injectors - Injects the identity of the authenticated user directly into controller methods via a custom retrieval function.
• Filesystem Scanning - Automatically registers controllers and middleware by scanning the filesystem using glob patterns.
• HTTP Response Builders - Provides decorators to programmatically define HTTP status codes, headers, and redirects for API responses.
• Global Error Handlers - Captures exceptions across the application and converts them into a standardized format via a custom global handler.
• Standard HTTP Error Responses - Returns standardized HTTP error responses using built-in or custom exception classes like NotFoundError.
• Request Middleware - Enables running custom logic before or after route handlers at the global, controller, or method level.
• Ordered Middleware Pipelines - Provides an ordered pipeline for executing global, class-level, or method-level middleware.
• Request-Response Interceptors - Implements application-level interceptors to modify the final result of a controller before it is sent to the client.
• Backend Middleware - Implements global and route-specific logic for authentication and authorization using TypeScript decorators.
• Typed Path Parameter Decoders - Provides type-safe parsing and validation of URL path and query parameters into primitive types.

Star history