@hemia/common 0.0.6 → 0.0.8

package/README.md

@@ -1,4 +1,3 @@
-
 # @hemia/common
 
 Sistema de decoradores y utilidades para crear controladores HTTP con TypeScript usando metadata reflection.
@@ -241,6 +240,103 @@ externalRedirect() {
   // Redirige temporalmente
 }
 ```
+
+---
+
+## 🆕 Decoradores Avanzados
+
+### Validación y Transformación
+
+#### `@Validate(validatorFn)`
+Valida el parámetro usando una función personalizada.
+
+```typescript
+@Post('/')
+create(@Body() data: any, @Validate(validateUser) _: any) { /* ... */ }
+```
+
+#### `@Transform(transformFn)`
+Transforma el parámetro usando una función personalizada.
+
+```typescript
+@Post('/')
+create(@Body() data: any, @Transform(toUserDto) _: any) { /* ... */ }
+```
+
+#### `@Custom(key: string)`
+Extrae datos personalizados del request.
+
+```typescript
+@Get('/')
+handler(@Custom('customData') custom: any) { /* ... */ }
+```
+
+### Decoradores de Guardias y Autenticación
+
+#### `@ReqUser()`
+Inyecta el usuario autenticado (por ejemplo, desde JWTGuard).
+
+```typescript
+@Get('/profile')
+profile(@ReqUser() user: any) { /* ... */ }
+```
+
+#### `@ReqPermissions()`
+Inyecta los permisos del usuario.
+
+```typescript
+@Get('/admin')
+admin(@ReqPermissions() permissions: string[]) { /* ... */ }
+```
+
+#### `@ReqContext()`
+Inyecta el contexto de la solicitud.
+
+```typescript
+@Get('/context')
+context(@ReqContext() ctx: any) { /* ... */ }
+```
+
+#### `@Cookies(key?: string)`
+Extrae cookies de la petición.
+
+```typescript
+@Get('/')
+handler(@Cookies('token') token: string) { /* ... */ }
+```
+
+#### `@Files()`
+Extrae todos los archivos enviados en la solicitud.
+
+```typescript
+@Post('/upload')
+upload(@Files() files: any[]) { /* ... */ }
+```
+
+#### `@File(key?: string)`
+Extrae un archivo específico.
+
+```typescript
+@Post('/avatar')
+avatar(@File('avatar') avatar: any) { /* ... */ }
+```
+
+#### `@Locale()`
+Extrae el locale del usuario.
+
+```typescript
+@Get('/')
+handler(@Locale() locale: string) { /* ... */ }
+```
+
+#### `@ReqAuth()`
+Extrae datos de autenticación.
+
+```typescript
+@Get('/auth')
+auth(@ReqAuth() auth: any) { /* ... */ }
+```
+
 ---
 
 ## 🔍 Metadata Keys
@@ -288,4 +384,3 @@ ISC
 ## ✨ Generado con Hemia CLI
 
 Este paquete fue generado usando [Hemia CLI](https://www.npmjs.com/package/@hemia/cli).
-    

package/dist/hemia-common.esm.js

@@ -1,4 +1,5 @@
 import 'reflect-metadata';
+import { decorate, injectable } from 'inversify';
 
 const METADATA_KEYS = {
     BASE_PATH: 'base_path',
@@ -6,18 +7,18 @@ const METADATA_KEYS = {
     PARAMS: 'params',
     HEADERS: 'headers',
     REDIRECT: 'redirect',
+    COOKIES: 'cookies',
     GUARDS: 'hemia:guards',
     INTERCEPTORS: 'hemia:interceptors',
     CUSTOM: 'hemia:custom',
     SERIALIZE: 'hemia:serialize',
     ROLES: 'hemia:roles',
-    PERMISSIONS: 'hemia:permissions'
-};
-
-const Controller = (basePath = '/') => {
-    return (target) => {
-        Reflect.defineMetadata(METADATA_KEYS.BASE_PATH, basePath, target);
-    };
+    PERMISSIONS: 'hemia:permissions',
+    TRANSFORMERS: 'hemia:transformers',
+    VALIDATORS: 'hemia:validators',
+    CUSTOMS: 'hemia:customs',
+    MODULE: "hemia:module",
+    INJECTION_ID: "hemia:injection_id"
 };
 
 var HttpMethod;
@@ -43,6 +44,14 @@ var ParamType;
     ParamType["SESSION"] = "SESSION";
     ParamType["IP"] = "IP";
     ParamType["HOST"] = "HOST";
+    ParamType["COOKIES"] = "COOKIES";
+    ParamType["FILES"] = "FILES";
+    ParamType["FILE"] = "FILE";
+    ParamType["LOCALE"] = "LOCALE";
+    ParamType["AUTH"] = "AUTH";
+    ParamType["USER"] = "USER";
+    ParamType["PERMISSIONS"] = "PERMISSIONS";
+    ParamType["CONTEXT"] = "CONTEXT";
 })(ParamType || (ParamType = {}));
 
 const createMethodDecorator = (method) => {
@@ -71,18 +80,126 @@ const createParamDecorator = (type) => {
         };
     };
 };
+/**
+ * Inyecta el objeto Request completo.
+ * @example
+ * async handler(@Request() req) {}
+ */
 const Request = createParamDecorator(ParamType.REQUEST);
+/**
+ * Alias para Request.
+ * @example
+ * async handler(@Req() req) {}
+ */
 const Req = createParamDecorator(ParamType.REQUEST);
+/**
+ * Inyecta el objeto Response.
+ * @example
+ * async handler(@Response() res) {}
+ */
 const Response = createParamDecorator(ParamType.RESPONSE);
+/**
+ * Alias para Response.
+ * @example
+ * async handler(@Res() res) {}
+ */
 const Res = createParamDecorator(ParamType.RESPONSE);
+/**
+ * Inyecta el objeto Next para middlewares.
+ * @example
+ * async handler(@Next() next) {}
+ */
 const Next = createParamDecorator(ParamType.NEXT);
+/**
+ * Inyecta la sesión del usuario.
+ * @example
+ * async handler(@Session() session) {}
+ */
 const Session = createParamDecorator(ParamType.SESSION);
+/**
+ * Inyecta la IP del cliente.
+ * @example
+ * async handler(@Ip() ip) {}
+ */
 const Ip = createParamDecorator(ParamType.IP);
+/**
+ * Inyecta el host de la solicitud.
+ * @example
+ * async handler(@Host() host) {}
+ */
 const Host = createParamDecorator(ParamType.HOST);
+/**
+ * Inyecta el cuerpo de la solicitud.
+ * @example
+ * async handler(@Body() body) {}
+ */
 const Body = createParamDecorator(ParamType.BODY);
+/**
+ * Inyecta los parámetros de consulta (query).
+ * @example
+ * async handler(@Query('search') search) {}
+ */
 const Query = createParamDecorator(ParamType.QUERY);
+/**
+ * Inyecta los parámetros de la URL.
+ * @example
+ * async handler(@Param('id') id) {}
+ */
 const Param = createParamDecorator(ParamType.PARAM);
+/**
+ * Inyecta los encabezados de la solicitud.
+ * @example
+ * async handler(@Headers('authorization') auth) {}
+ */
 const Headers = createParamDecorator(ParamType.HEADERS);
+/**
+ * Inyecta los cookies de la solicitud.
+ * @example
+ * async handler(@Cookies('token') token) {}
+ */
+const Cookies = createParamDecorator(ParamType.COOKIES);
+/**
+ * Inyecta todos los archivos enviados en la solicitud.
+ * @example
+ * async handler(@Files() files) {}
+ */
+const Files = createParamDecorator(ParamType.FILES);
+/**
+ * Inyecta un archivo específico de la solicitud.
+ * @example
+ * async handler(@File('avatar') avatar) {}
+ */
+const File = createParamDecorator(ParamType.FILE);
+/**
+ * Inyecta el locale del usuario.
+ * @example
+ * async handler(@Locale() locale) {}
+ */
+const Locale = createParamDecorator(ParamType.LOCALE);
+/**
+ * Inyecta datos de autenticación.
+ * @example
+ * async handler(@ReqAuth() auth) {}
+ */
+const ReqAuth = createParamDecorator(ParamType.AUTH);
+/**
+ * Inyecta el usuario autenticado.
+ * @example
+ * async handler(@ReqUser() user) {}
+ */
+const ReqUser = createParamDecorator(ParamType.USER);
+/**
+ * Inyecta los permisos del usuario.
+ * @example
+ * async handler(@ReqPermissions() permissions) {}
+ */
+const ReqPermissions = createParamDecorator(ParamType.PERMISSIONS);
+/**
+ * Inyecta el contexto de la solicitud.
+ * @example
+ * async handler(@ReqContext() context) {}
+ */
+const ReqContext = createParamDecorator(ParamType.CONTEXT);
 
 const Header = (name, value) => {
     return (target, propertyKey, descriptor) => {
@@ -162,6 +279,104 @@ function Serialize(dto) {
     return SetMetadata(METADATA_KEYS.SERIALIZE, dto);
 }
 
+function Module(metadata) {
+    return (target) => {
+        Reflect.defineMetadata(METADATA_KEYS.MODULE, metadata, target);
+    };
+}
+
+function registerProvider(target, id) {
+    decorate(injectable(), target);
+    Reflect.defineMetadata(METADATA_KEYS.INJECTION_ID, id || target, target);
+}
+function Service(identifier) {
+    return (target) => registerProvider(target, identifier);
+}
+function Repository(identifier) {
+    return (target) => registerProvider(target, identifier);
+}
+
+function isRedirectResponse(value) {
+    return value && typeof value === 'object' && typeof value.url === 'string';
+}
+
+class ControllerRegistry {
+    static register(target) {
+        if (!this.controllers.includes(target)) {
+            this.controllers.push(target);
+        }
+    }
+    static getAll() {
+        return this.controllers.slice();
+    }
+    static clear() {
+        this.controllers = [];
+    }
+}
+ControllerRegistry.controllers = [];
+
+const Controller = (basePath = '/') => {
+    return (target) => {
+        decorate(injectable(), target);
+        Reflect.defineMetadata(METADATA_KEYS.BASE_PATH, basePath, target);
+        ControllerRegistry.register(target);
+    };
+};
+
+/**
+ * Decorador para extraer datos personalizados del request.
+ *
+ * @example
+ * // Extrae el valor de 'customData' del request
+ * @Custom('customData')
+ * async handler(@Custom() customData: any) {}
+ *
+ * @param key Clave personalizada a extraer del request.
+ */
+function Custom(key) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingCustoms = Reflect.getMetadata(METADATA_KEYS.CUSTOMS, target, propertyKey || '') || [];
+        existingCustoms.push({ index: parameterIndex, key });
+        Reflect.defineMetadata(METADATA_KEYS.CUSTOMS, existingCustoms, target, propertyKey || '');
+    };
+}
+
+/**
+ * Decorador para validar datos de entrada en un controlador.
+ *
+ * @example
+ * // Valida el parámetro 'body' usando la función validateUser
+ * @Validate(validateUser)
+ * async create(@Body() body: any) {}
+ *
+ * @param validator Función de validación que recibe el valor y retorna booleano o lanza error.
+ */
+function Validate(validator) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingValidators = Reflect.getMetadata(METADATA_KEYS.VALIDATORS, target, propertyKey || '') || [];
+        existingValidators.push({ index: parameterIndex, validator });
+        Reflect.defineMetadata(METADATA_KEYS.VALIDATORS, existingValidators, target, propertyKey || '');
+    };
+}
+
+/**
+ * Decorador para transformar datos de entrada en un controlador.
+ *
+ * @example
+ * // Transforma el parámetro 'body' usando la función toUserDto
+ * @Transform(toUserDto)
+ * async create(@Body() body: any) {}
+ *
+ * @param transformer Función de transformación que recibe el valor y retorna el nuevo valor.
+ */
+function Transform(transformer) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingTransformers = Reflect.getMetadata(METADATA_KEYS.TRANSFORMERS, target, propertyKey || '') || [];
+        existingTransformers.push({ index: parameterIndex, transformer });
+        Reflect.defineMetadata(METADATA_KEYS.TRANSFORMERS, existingTransformers, target, propertyKey || '');
+    };
+}
+
 class ApiResponse {
     static success(data, message = 'OK', status = 200) {
         return {
@@ -181,10 +396,6 @@ class ApiResponse {
     }
 }
 
-function isRedirectResponse(value) {
-    return value && typeof value === 'object' && typeof value.url === 'string';
-}
-
 class HttpError extends Error {
     constructor(message, statusCode, error) {
         super(message);
@@ -481,4 +692,4 @@ class InfraDataDeserializationError extends InfrastructureError {
     }
 }
 
-export { ApiResponse, BackupError, BadRequestError, Body, BusinessRuleViolationError, ConfigurationError, ConflictError, ConnectionError, Controller, CustomHttpError, DataConflictError, DataIntegrityError, DataMigrationError, DataNotFoundError, DataValidationError, Delete, DependencyError, DomainError, DuplicateEntityError, EntityNotFoundError, ForbiddenError, GatewayTimeoutError, Get, Head, Header, Headers, Host, HttpError, HttpErrorWithDetails, HttpMethod, IndexingError, InfraAuthenticationError, InfraAuthorizationError, InfraCacheConnectionError, InfraConfigurationError, InfraDataDeserializationError, InfraDataSerializationError, InfraDatabaseConnectionError, InfraExternalServiceError, InfraMessageQueueError, InfraNetworkError, InfraServiceUnavailableError, InfraTimeoutError, InfrastructureError, InternalServerError, Ip, METADATA_KEYS, Next, NotFoundError, OperationNotAllowedError, Options, Param, ParamType, Patch, PersistenceError, Post, Put, Query, QueryExecutionError, Redirect, Req, Request, Res, ResourceLimitError, ResourceLimitExceededError, Response, RestoreError, SchemaMismatchError, Serialize, ServiceUnavailableError, Session, SetMetadata, TimeoutError, TransactionError, UnauthorizedError, UnprocessableEntityError, UseGuards, UseInterceptors, ValidationError, isRedirectResponse };
+export { ApiResponse, BackupError, BadRequestError, Body, BusinessRuleViolationError, ConfigurationError, ConflictError, ConnectionError, Controller, ControllerRegistry, Cookies, Custom, CustomHttpError, DataConflictError, DataIntegrityError, DataMigrationError, DataNotFoundError, DataValidationError, Delete, DependencyError, DomainError, DuplicateEntityError, EntityNotFoundError, File, Files, ForbiddenError, GatewayTimeoutError, Get, Head, Header, Headers, Host, HttpError, HttpErrorWithDetails, HttpMethod, IndexingError, InfraAuthenticationError, InfraAuthorizationError, InfraCacheConnectionError, InfraConfigurationError, InfraDataDeserializationError, InfraDataSerializationError, InfraDatabaseConnectionError, InfraExternalServiceError, InfraMessageQueueError, InfraNetworkError, InfraServiceUnavailableError, InfraTimeoutError, InfrastructureError, InternalServerError, Ip, Locale, METADATA_KEYS, Module, Next, NotFoundError, OperationNotAllowedError, Options, Param, ParamType, Patch, PersistenceError, Post, Put, Query, QueryExecutionError, Redirect, Repository, Req, ReqAuth, ReqContext, ReqPermissions, ReqUser, Request, Res, ResourceLimitError, ResourceLimitExceededError, Response, RestoreError, SchemaMismatchError, Serialize, Service, ServiceUnavailableError, Session, SetMetadata, TimeoutError, TransactionError, Transform, UnauthorizedError, UnprocessableEntityError, UseGuards, UseInterceptors, Validate, ValidationError, isRedirectResponse };

package/dist/hemia-common.js

@@ -1,6 +1,7 @@
 'use strict';
 
 require('reflect-metadata');
+var inversify = require('inversify');
 
 const METADATA_KEYS = {
     BASE_PATH: 'base_path',
@@ -8,18 +9,18 @@ const METADATA_KEYS = {
     PARAMS: 'params',
     HEADERS: 'headers',
     REDIRECT: 'redirect',
+    COOKIES: 'cookies',
     GUARDS: 'hemia:guards',
     INTERCEPTORS: 'hemia:interceptors',
     CUSTOM: 'hemia:custom',
     SERIALIZE: 'hemia:serialize',
     ROLES: 'hemia:roles',
-    PERMISSIONS: 'hemia:permissions'
-};
-
-const Controller = (basePath = '/') => {
-    return (target) => {
-        Reflect.defineMetadata(METADATA_KEYS.BASE_PATH, basePath, target);
-    };
+    PERMISSIONS: 'hemia:permissions',
+    TRANSFORMERS: 'hemia:transformers',
+    VALIDATORS: 'hemia:validators',
+    CUSTOMS: 'hemia:customs',
+    MODULE: "hemia:module",
+    INJECTION_ID: "hemia:injection_id"
 };
 
 exports.HttpMethod = void 0;
@@ -45,6 +46,14 @@ exports.ParamType = void 0;
     ParamType["SESSION"] = "SESSION";
     ParamType["IP"] = "IP";
     ParamType["HOST"] = "HOST";
+    ParamType["COOKIES"] = "COOKIES";
+    ParamType["FILES"] = "FILES";
+    ParamType["FILE"] = "FILE";
+    ParamType["LOCALE"] = "LOCALE";
+    ParamType["AUTH"] = "AUTH";
+    ParamType["USER"] = "USER";
+    ParamType["PERMISSIONS"] = "PERMISSIONS";
+    ParamType["CONTEXT"] = "CONTEXT";
 })(exports.ParamType || (exports.ParamType = {}));
 
 const createMethodDecorator = (method) => {
@@ -73,18 +82,126 @@ const createParamDecorator = (type) => {
         };
     };
 };
+/**
+ * Inyecta el objeto Request completo.
+ * @example
+ * async handler(@Request() req) {}
+ */
 const Request = createParamDecorator(exports.ParamType.REQUEST);
+/**
+ * Alias para Request.
+ * @example
+ * async handler(@Req() req) {}
+ */
 const Req = createParamDecorator(exports.ParamType.REQUEST);
+/**
+ * Inyecta el objeto Response.
+ * @example
+ * async handler(@Response() res) {}
+ */
 const Response = createParamDecorator(exports.ParamType.RESPONSE);
+/**
+ * Alias para Response.
+ * @example
+ * async handler(@Res() res) {}
+ */
 const Res = createParamDecorator(exports.ParamType.RESPONSE);
+/**
+ * Inyecta el objeto Next para middlewares.
+ * @example
+ * async handler(@Next() next) {}
+ */
 const Next = createParamDecorator(exports.ParamType.NEXT);
+/**
+ * Inyecta la sesión del usuario.
+ * @example
+ * async handler(@Session() session) {}
+ */
 const Session = createParamDecorator(exports.ParamType.SESSION);
+/**
+ * Inyecta la IP del cliente.
+ * @example
+ * async handler(@Ip() ip) {}
+ */
 const Ip = createParamDecorator(exports.ParamType.IP);
+/**
+ * Inyecta el host de la solicitud.
+ * @example
+ * async handler(@Host() host) {}
+ */
 const Host = createParamDecorator(exports.ParamType.HOST);
+/**
+ * Inyecta el cuerpo de la solicitud.
+ * @example
+ * async handler(@Body() body) {}
+ */
 const Body = createParamDecorator(exports.ParamType.BODY);
+/**
+ * Inyecta los parámetros de consulta (query).
+ * @example
+ * async handler(@Query('search') search) {}
+ */
 const Query = createParamDecorator(exports.ParamType.QUERY);
+/**
+ * Inyecta los parámetros de la URL.
+ * @example
+ * async handler(@Param('id') id) {}
+ */
 const Param = createParamDecorator(exports.ParamType.PARAM);
+/**
+ * Inyecta los encabezados de la solicitud.
+ * @example
+ * async handler(@Headers('authorization') auth) {}
+ */
 const Headers = createParamDecorator(exports.ParamType.HEADERS);
+/**
+ * Inyecta los cookies de la solicitud.
+ * @example
+ * async handler(@Cookies('token') token) {}
+ */
+const Cookies = createParamDecorator(exports.ParamType.COOKIES);
+/**
+ * Inyecta todos los archivos enviados en la solicitud.
+ * @example
+ * async handler(@Files() files) {}
+ */
+const Files = createParamDecorator(exports.ParamType.FILES);
+/**
+ * Inyecta un archivo específico de la solicitud.
+ * @example
+ * async handler(@File('avatar') avatar) {}
+ */
+const File = createParamDecorator(exports.ParamType.FILE);
+/**
+ * Inyecta el locale del usuario.
+ * @example
+ * async handler(@Locale() locale) {}
+ */
+const Locale = createParamDecorator(exports.ParamType.LOCALE);
+/**
+ * Inyecta datos de autenticación.
+ * @example
+ * async handler(@ReqAuth() auth) {}
+ */
+const ReqAuth = createParamDecorator(exports.ParamType.AUTH);
+/**
+ * Inyecta el usuario autenticado.
+ * @example
+ * async handler(@ReqUser() user) {}
+ */
+const ReqUser = createParamDecorator(exports.ParamType.USER);
+/**
+ * Inyecta los permisos del usuario.
+ * @example
+ * async handler(@ReqPermissions() permissions) {}
+ */
+const ReqPermissions = createParamDecorator(exports.ParamType.PERMISSIONS);
+/**
+ * Inyecta el contexto de la solicitud.
+ * @example
+ * async handler(@ReqContext() context) {}
+ */
+const ReqContext = createParamDecorator(exports.ParamType.CONTEXT);
 
 const Header = (name, value) => {
     return (target, propertyKey, descriptor) => {
@@ -164,6 +281,104 @@ function Serialize(dto) {
     return SetMetadata(METADATA_KEYS.SERIALIZE, dto);
 }
 
+function Module(metadata) {
+    return (target) => {
+        Reflect.defineMetadata(METADATA_KEYS.MODULE, metadata, target);
+    };
+}
+
+function registerProvider(target, id) {
+    inversify.decorate(inversify.injectable(), target);
+    Reflect.defineMetadata(METADATA_KEYS.INJECTION_ID, id || target, target);
+}
+function Service(identifier) {
+    return (target) => registerProvider(target, identifier);
+}
+function Repository(identifier) {
+    return (target) => registerProvider(target, identifier);
+}
+
+function isRedirectResponse(value) {
+    return value && typeof value === 'object' && typeof value.url === 'string';
+}
+
+class ControllerRegistry {
+    static register(target) {
+        if (!this.controllers.includes(target)) {
+            this.controllers.push(target);
+        }
+    }
+    static getAll() {
+        return this.controllers.slice();
+    }
+    static clear() {
+        this.controllers = [];
+    }
+}
+ControllerRegistry.controllers = [];
+
+const Controller = (basePath = '/') => {
+    return (target) => {
+        inversify.decorate(inversify.injectable(), target);
+        Reflect.defineMetadata(METADATA_KEYS.BASE_PATH, basePath, target);
+        ControllerRegistry.register(target);
+    };
+};
+
+/**
+ * Decorador para extraer datos personalizados del request.
+ *
+ * @example
+ * // Extrae el valor de 'customData' del request
+ * @Custom('customData')
+ * async handler(@Custom() customData: any) {}
+ *
+ * @param key Clave personalizada a extraer del request.
+ */
+function Custom(key) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingCustoms = Reflect.getMetadata(METADATA_KEYS.CUSTOMS, target, propertyKey || '') || [];
+        existingCustoms.push({ index: parameterIndex, key });
+        Reflect.defineMetadata(METADATA_KEYS.CUSTOMS, existingCustoms, target, propertyKey || '');
+    };
+}
+
+/**
+ * Decorador para validar datos de entrada en un controlador.
+ *
+ * @example
+ * // Valida el parámetro 'body' usando la función validateUser
+ * @Validate(validateUser)
+ * async create(@Body() body: any) {}
+ *
+ * @param validator Función de validación que recibe el valor y retorna booleano o lanza error.
+ */
+function Validate(validator) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingValidators = Reflect.getMetadata(METADATA_KEYS.VALIDATORS, target, propertyKey || '') || [];
+        existingValidators.push({ index: parameterIndex, validator });
+        Reflect.defineMetadata(METADATA_KEYS.VALIDATORS, existingValidators, target, propertyKey || '');
+    };
+}
+
+/**
+ * Decorador para transformar datos de entrada en un controlador.
+ *
+ * @example
+ * // Transforma el parámetro 'body' usando la función toUserDto
+ * @Transform(toUserDto)
+ * async create(@Body() body: any) {}
+ *
+ * @param transformer Función de transformación que recibe el valor y retorna el nuevo valor.
+ */
+function Transform(transformer) {
+    return (target, propertyKey, parameterIndex) => {
+        const existingTransformers = Reflect.getMetadata(METADATA_KEYS.TRANSFORMERS, target, propertyKey || '') || [];
+        existingTransformers.push({ index: parameterIndex, transformer });
+        Reflect.defineMetadata(METADATA_KEYS.TRANSFORMERS, existingTransformers, target, propertyKey || '');
+    };
+}
+
 class ApiResponse {
     static success(data, message = 'OK', status = 200) {
         return {
@@ -183,10 +398,6 @@ class ApiResponse {
     }
 }
 
-function isRedirectResponse(value) {
-    return value && typeof value === 'object' && typeof value.url === 'string';
-}
-
 class HttpError extends Error {
     constructor(message, statusCode, error) {
         super(message);
@@ -492,6 +703,9 @@ exports.ConfigurationError = ConfigurationError;
 exports.ConflictError = ConflictError;
 exports.ConnectionError = ConnectionError;
 exports.Controller = Controller;
+exports.ControllerRegistry = ControllerRegistry;
+exports.Cookies = Cookies;
+exports.Custom = Custom;
 exports.CustomHttpError = CustomHttpError;
 exports.DataConflictError = DataConflictError;
 exports.DataIntegrityError = DataIntegrityError;
@@ -503,6 +717,8 @@ exports.DependencyError = DependencyError;
 exports.DomainError = DomainError;
 exports.DuplicateEntityError = DuplicateEntityError;
 exports.EntityNotFoundError = EntityNotFoundError;
+exports.File = File;
+exports.Files = Files;
 exports.ForbiddenError = ForbiddenError;
 exports.GatewayTimeoutError = GatewayTimeoutError;
 exports.Get = Get;
@@ -528,7 +744,9 @@ exports.InfraTimeoutError = InfraTimeoutError;
 exports.InfrastructureError = InfrastructureError;
 exports.InternalServerError = InternalServerError;
 exports.Ip = Ip;
+exports.Locale = Locale;
 exports.METADATA_KEYS = METADATA_KEYS;
+exports.Module = Module;
 exports.Next = Next;
 exports.NotFoundError = NotFoundError;
 exports.OperationNotAllowedError = OperationNotAllowedError;
@@ -541,7 +759,12 @@ exports.Put = Put;
 exports.Query = Query;
 exports.QueryExecutionError = QueryExecutionError;
 exports.Redirect = Redirect;
+exports.Repository = Repository;
 exports.Req = Req;
+exports.ReqAuth = ReqAuth;
+exports.ReqContext = ReqContext;
+exports.ReqPermissions = ReqPermissions;
+exports.ReqUser = ReqUser;
 exports.Request = Request;
 exports.Res = Res;
 exports.ResourceLimitError = ResourceLimitError;
@@ -550,14 +773,17 @@ exports.Response = Response;
 exports.RestoreError = RestoreError;
 exports.SchemaMismatchError = SchemaMismatchError;
 exports.Serialize = Serialize;
+exports.Service = Service;
 exports.ServiceUnavailableError = ServiceUnavailableError;
 exports.Session = Session;
 exports.SetMetadata = SetMetadata;
 exports.TimeoutError = TimeoutError;
 exports.TransactionError = TransactionError;
+exports.Transform = Transform;
 exports.UnauthorizedError = UnauthorizedError;
 exports.UnprocessableEntityError = UnprocessableEntityError;
 exports.UseGuards = UseGuards;
 exports.UseInterceptors = UseInterceptors;
+exports.Validate = Validate;
 exports.ValidationError = ValidationError;
 exports.isRedirectResponse = isRedirectResponse;

package/dist/types/decorators/core/index.d.ts

@@ -2,3 +2,6 @@ export * from "./use-guards.decorator";
 export * from "./use-interceptors.decorator";
 export * from "./set-metadata.decorator";
 export * from "./serialize.decorator";
+export * from "./module.decorator";
+export * from "./service.decorator";
+export * from "./controller.decorator";

package/dist/types/decorators/core/module.decorator.d.ts

@@ -0,0 +1,8 @@
+import "reflect-metadata";
+export interface ModuleMetadata {
+    imports?: any[];
+    controllers?: any[];
+    providers?: any[];
+    exports?: any[];
+}
+export declare function Module(metadata: ModuleMetadata): ClassDecorator;

package/dist/types/decorators/core/service.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare function Service(identifier?: symbol | string): ClassDecorator;
+export declare function Repository(identifier?: symbol | string): ClassDecorator;

package/dist/types/decorators/custom/custom.decorator.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+/**
+ * Decorador para extraer datos personalizados del request.
+ *
+ * @example
+ * // Extrae el valor de 'customData' del request
+ * @Custom('customData')
+ * async handler(@Custom() customData: any) {}
+ *
+ * @param key Clave personalizada a extraer del request.
+ */
+export declare function Custom(key: string): ParameterDecorator;

package/dist/types/decorators/custom/index.d.ts

@@ -0,0 +1 @@
+export * from './custom.decorator';

package/dist/types/decorators/http/index.d.ts

@@ -1,4 +1,3 @@
-export * from "./controller.decorator";
 export * from "./method.decorators";
 export * from "./param.decorators";
 export * from "./response.decorators";

package/dist/types/decorators/http/param.decorators.d.ts

@@ -1,13 +1,121 @@
 import 'reflect-metadata';
+/**
+ * Inyecta el objeto Request completo.
+ * @example
+ * async handler(@Request() req) {}
+ */
 export declare const Request: (data?: string) => ParameterDecorator;
+/**
+ * Alias para Request.
+ * @example
+ * async handler(@Req() req) {}
+ */
 export declare const Req: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta el objeto Response.
+ * @example
+ * async handler(@Response() res) {}
+ */
 export declare const Response: (data?: string) => ParameterDecorator;
+/**
+ * Alias para Response.
+ * @example
+ * async handler(@Res() res) {}
+ */
 export declare const Res: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta el objeto Next para middlewares.
+ * @example
+ * async handler(@Next() next) {}
+ */
 export declare const Next: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta la sesión del usuario.
+ * @example
+ * async handler(@Session() session) {}
+ */
 export declare const Session: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta la IP del cliente.
+ * @example
+ * async handler(@Ip() ip) {}
+ */
 export declare const Ip: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta el host de la solicitud.
+ * @example
+ * async handler(@Host() host) {}
+ */
 export declare const Host: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta el cuerpo de la solicitud.
+ * @example
+ * async handler(@Body() body) {}
+ */
 export declare const Body: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta los parámetros de consulta (query).
+ * @example
+ * async handler(@Query('search') search) {}
+ */
 export declare const Query: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta los parámetros de la URL.
+ * @example
+ * async handler(@Param('id') id) {}
+ */
 export declare const Param: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta los encabezados de la solicitud.
+ * @example
+ * async handler(@Headers('authorization') auth) {}
+ */
 export declare const Headers: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta los cookies de la solicitud.
+ * @example
+ * async handler(@Cookies('token') token) {}
+ */
+export declare const Cookies: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta todos los archivos enviados en la solicitud.
+ * @example
+ * async handler(@Files() files) {}
+ */
+export declare const Files: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta un archivo específico de la solicitud.
+ * @example
+ * async handler(@File('avatar') avatar) {}
+ */
+export declare const File: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta el locale del usuario.
+ * @example
+ * async handler(@Locale() locale) {}
+ */
+export declare const Locale: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta datos de autenticación.
+ * @example
+ * async handler(@ReqAuth() auth) {}
+ */
+export declare const ReqAuth: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta el usuario autenticado.
+ * @example
+ * async handler(@ReqUser() user) {}
+ */
+export declare const ReqUser: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta los permisos del usuario.
+ * @example
+ * async handler(@ReqPermissions() permissions) {}
+ */
+export declare const ReqPermissions: (data?: string) => ParameterDecorator;
+/**
+ * Inyecta el contexto de la solicitud.
+ * @example
+ * async handler(@ReqContext() context) {}
+ */
+export declare const ReqContext: (data?: string) => ParameterDecorator;

package/dist/types/decorators/index.d.ts

@@ -1,3 +1,6 @@
 export * from "./http";
 export * from "./metadata";
 export * from "./core";
+export * from "./custom";
+export * from "./validation";
+export * from "./transform";

package/dist/types/decorators/metadata.d.ts

@@ -4,10 +4,16 @@ export declare const METADATA_KEYS: {
     readonly PARAMS: "params";
     readonly HEADERS: "headers";
     readonly REDIRECT: "redirect";
+    readonly COOKIES: "cookies";
     readonly GUARDS: "hemia:guards";
     readonly INTERCEPTORS: "hemia:interceptors";
     readonly CUSTOM: "hemia:custom";
     readonly SERIALIZE: "hemia:serialize";
     readonly ROLES: "hemia:roles";
     readonly PERMISSIONS: "hemia:permissions";
+    readonly TRANSFORMERS: "hemia:transformers";
+    readonly VALIDATORS: "hemia:validators";
+    readonly CUSTOMS: "hemia:customs";
+    readonly MODULE: "hemia:module";
+    readonly INJECTION_ID: "hemia:injection_id";
 };

package/dist/types/decorators/transform/index.d.ts

@@ -0,0 +1 @@
+export * from './transform.decorator';

package/dist/types/decorators/transform/transform.decorator.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+/**
+ * Decorador para transformar datos de entrada en un controlador.
+ *
+ * @example
+ * // Transforma el parámetro 'body' usando la función toUserDto
+ * @Transform(toUserDto)
+ * async create(@Body() body: any) {}
+ *
+ * @param transformer Función de transformación que recibe el valor y retorna el nuevo valor.
+ */
+export declare function Transform(transformer: (value: any) => any): ParameterDecorator;

package/dist/types/decorators/validation/index.d.ts

@@ -0,0 +1 @@
+export * from "./validate.decorator";

package/dist/types/decorators/validation/validate.decorator.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+/**
+ * Decorador para validar datos de entrada en un controlador.
+ *
+ * @example
+ * // Valida el parámetro 'body' usando la función validateUser
+ * @Validate(validateUser)
+ * async create(@Body() body: any) {}
+ *
+ * @param validator Función de validación que recibe el valor y retorna booleano o lanza error.
+ */
+export declare function Validate(validator: (value: any) => boolean | void): ParameterDecorator;

package/dist/types/enums/param-type.enum.d.ts

@@ -8,5 +8,13 @@ export declare enum ParamType {
     HEADERS = "HEADERS",
     SESSION = "SESSION",
     IP = "IP",
-    HOST = "HOST"
+    HOST = "HOST",
+    COOKIES = "COOKIES",
+    FILES = "FILES",
+    FILE = "FILE",
+    LOCALE = "LOCALE",
+    AUTH = "AUTH",
+    USER = "USER",
+    PERMISSIONS = "PERMISSIONS",
+    CONTEXT = "CONTEXT"
 }

package/dist/types/utils/controller-registry.d.ts

@@ -0,0 +1,6 @@
+export declare class ControllerRegistry {
+    private static controllers;
+    static register(target: Function): void;
+    static getAll(): Function[];
+    static clear(): void;
+}

package/dist/types/utils/index.d.ts

@@ -1 +1,2 @@
 export * from "./type-guards";
+export * from "./controller-registry";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hemia/common",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Paquete común para proyectos de Hemia",
   "main": "dist/hemia-common.js",
   "module": "dist/hemia-common.esm.js",
@@ -28,7 +28,8 @@
     "rollup-plugin-typescript2": "^0.36.0",
     "ts-jest": "^29.2.5",
     "ts-node": "^8.9.0",
-    "typescript": "^5.5.4"
+    "typescript": "^5.5.4",
+    "inversify": "^7.11.0"
   },
   "peerDependencies": {
     "reflect-metadata": "^0.2.2"
@@ -37,5 +38,8 @@
   "license": "ISC",
   "files": [
     "dist"
-  ]
+  ],
+  "dependencies": {
+   
+  }
 }