@hemia/common 0.0.16 → 0.0.17

package/dist/hemia-common.esm.js

@@ -1,5 +1,7 @@
 import 'reflect-metadata';
 import { decorate, injectable } from 'inversify';
+import { validate } from 'class-validator';
+import { plainToInstance } from 'class-transformer';
 
 const METADATA_KEYS = {
     BASE_PATH: 'base_path',
@@ -378,22 +380,90 @@ function Custom(key) {
 }
 
 /**
- * Decorador para validar datos de entrada en un controlador.
+ * Decorador para validar datos de entrada usando class-validator.
  *
  * @example
- * // Valida el parámetro 'body' usando la función validateUser
- * @Validate(validateUser)
- * async create(@Body() body: any) {}
+ * // Valida el body usando un DTO
+ * async create(@Validate(CreateUserDto) @Body() body: CreateUserDto) {}
+ *
+ * @example
+ * // Valida con función personalizada
+ * @Validate((value) => value.age > 18)
+ * async create(@Body('age') age: number) {}
  *
- * @param validator Función de validación que recibe el valor y retorna booleano o lanza error.
+ * @param validatorOrDto Clase DTO o función de validación.
  */
-function Validate(validator) {
+function Validate(validatorOrDto) {
     return (target, propertyKey, parameterIndex) => {
         const existingValidators = Reflect.getMetadata(METADATA_KEYS.VALIDATORS, target, propertyKey || '') || [];
-        existingValidators.push({ index: parameterIndex, validator });
+        // Determinar si es una clase DTO o función
+        const isClassValidator = typeof validatorOrDto === 'function' && validatorOrDto.prototype;
+        const validator = isClassValidator
+            ? async (value) => {
+                const instance = plainToInstance(validatorOrDto, value);
+                const errors = await validate(instance, { whitelist: true, forbidNonWhitelisted: true });
+                if (errors.length > 0) {
+                    throw new ValidationException(errors);
+                }
+                return true;
+            }
+            : validatorOrDto;
+        existingValidators.push({ index: parameterIndex, validator, dtoClass: isClassValidator ? validatorOrDto : null });
         Reflect.defineMetadata(METADATA_KEYS.VALIDATORS, existingValidators, target, propertyKey || '');
     };
 }
+/**
+ * Decorador de método para validar todo el body con un DTO
+ * @example
+ * @Post()
+ * @ValidateDto(CreateUserDto)
+ * async create(@Body() body: CreateUserDto) {}
+ */
+function ValidateDto(dtoClass) {
+    return (target, propertyKey, descriptor) => {
+        const existingValidators = Reflect.getMetadata(METADATA_KEYS.VALIDATORS, target, propertyKey) || [];
+        const validator = async (value) => {
+            const instance = plainToInstance(dtoClass, value);
+            const errors = await validate(instance, {
+                whitelist: true,
+                forbidNonWhitelisted: true
+            });
+            if (errors.length > 0) {
+                throw new ValidationException(errors);
+            }
+            return true;
+        };
+        const paramsMetadata = Reflect.getMetadata(METADATA_KEYS.PARAMS, target, propertyKey) || [];
+        const bodyParam = paramsMetadata.find((p) => p.type === ParamType.BODY);
+        if (bodyParam) {
+            existingValidators.push({
+                index: bodyParam.index,
+                validator,
+                dtoClass
+            });
+            Reflect.defineMetadata(METADATA_KEYS.VALIDATORS, existingValidators, target, propertyKey);
+        }
+        return descriptor;
+    };
+}
+/**
+ * Excepción personalizada para errores de validación
+ */
+class ValidationException extends Error {
+    constructor(errors) {
+        super('Validation failed');
+        this.statusCode = 400;
+        this.errors = errors;
+        this.name = 'ValidationException';
+    }
+    toJSON() {
+        return this.errors.map(error => ({
+            property: error.property,
+            value: error.value,
+            constraints: error.constraints
+        }));
+    }
+}
 
 /**
  * Decorador para transformar datos de entrada en un controlador.
@@ -1102,4 +1172,4 @@ class ApiResponse {
     }
 }
 
-export { AllowAny, ApiKey, ApiResponse, BackupError, BadGatewayError, BadRequestError, Body, BusinessRuleViolationError, ConfigurationError, ConflictError, ConnectionError, Controller, ControllerRegistry, Cookies, Custom, CustomHttpError, DataConflictError, DataIntegrityError, DataMigrationError, DataNotFoundError, DataValidationError, DefaultValuePipe, Delete, DependencyError, DomainError, DuplicateEntityError, EntityNotFoundError, FeatureFlag, 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, IpWhitelist, Locale, METADATA_KEYS, ManualRegister, MethodNotAllowedError, Module, Next, NotAcceptableError, NotFoundError, NotImplementedError, OperationNotAllowedError, Options, Owner, Param, ParamType, ParseArrayPipe, ParseBoolPipe, ParseDatePipe, ParseEnumPipe, ParseFilePipe, ParseFloatPipe, ParseIntPipe, ParseUUIDPipe, Patch, PayloadTooLargeError, Permissions, PersistenceError, PolicyBased, Post, PreconditionFailedError, ProxyAuthenticationRequiredError, Public, Put, Query, QueryExecutionError, RateLimit, Redirect, Repository, Req, ReqAuth, ReqContext, ReqPermissions, ReqUser, Request, RequestTimeoutError, Res, ResourceLimitError, ResourceLimitExceededError, Response, RestoreError, Roles, SchemaMismatchError, Scopes, Serialize, Service, ServiceUnavailableError, Session, SetMetadata, Throttle, TimeoutError, TooManyRequestsError, TransactionError, Transform, URITooLongError, UnauthorizedError, UnprocessableEntityError, UnsupportedMediaTypeError, UseGuards, UseInterceptors, UsePipes, Validate, ValidationError, ValidationPipe, isRedirectResponse };
+export { AllowAny, ApiKey, ApiResponse, BackupError, BadGatewayError, BadRequestError, Body, BusinessRuleViolationError, ConfigurationError, ConflictError, ConnectionError, Controller, ControllerRegistry, Cookies, Custom, CustomHttpError, DataConflictError, DataIntegrityError, DataMigrationError, DataNotFoundError, DataValidationError, DefaultValuePipe, Delete, DependencyError, DomainError, DuplicateEntityError, EntityNotFoundError, FeatureFlag, 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, IpWhitelist, Locale, METADATA_KEYS, ManualRegister, MethodNotAllowedError, Module, Next, NotAcceptableError, NotFoundError, NotImplementedError, OperationNotAllowedError, Options, Owner, Param, ParamType, ParseArrayPipe, ParseBoolPipe, ParseDatePipe, ParseEnumPipe, ParseFilePipe, ParseFloatPipe, ParseIntPipe, ParseUUIDPipe, Patch, PayloadTooLargeError, Permissions, PersistenceError, PolicyBased, Post, PreconditionFailedError, ProxyAuthenticationRequiredError, Public, Put, Query, QueryExecutionError, RateLimit, Redirect, Repository, Req, ReqAuth, ReqContext, ReqPermissions, ReqUser, Request, RequestTimeoutError, Res, ResourceLimitError, ResourceLimitExceededError, Response, RestoreError, Roles, SchemaMismatchError, Scopes, Serialize, Service, ServiceUnavailableError, Session, SetMetadata, Throttle, TimeoutError, TooManyRequestsError, TransactionError, Transform, URITooLongError, UnauthorizedError, UnprocessableEntityError, UnsupportedMediaTypeError, UseGuards, UseInterceptors, UsePipes, Validate, ValidateDto, ValidationError, ValidationException, ValidationPipe, isRedirectResponse };

package/dist/hemia-common.js

@@ -2,6 +2,8 @@
 
 require('reflect-metadata');
 var inversify = require('inversify');
+var classValidator = require('class-validator');
+var classTransformer = require('class-transformer');
 
 const METADATA_KEYS = {
     BASE_PATH: 'base_path',
@@ -380,22 +382,90 @@ function Custom(key) {
 }
 
 /**
- * Decorador para validar datos de entrada en un controlador.
+ * Decorador para validar datos de entrada usando class-validator.
  *
  * @example
- * // Valida el parámetro 'body' usando la función validateUser
- * @Validate(validateUser)
- * async create(@Body() body: any) {}
+ * // Valida el body usando un DTO
+ * async create(@Validate(CreateUserDto) @Body() body: CreateUserDto) {}
+ *
+ * @example
+ * // Valida con función personalizada
+ * @Validate((value) => value.age > 18)
+ * async create(@Body('age') age: number) {}
  *
- * @param validator Función de validación que recibe el valor y retorna booleano o lanza error.
+ * @param validatorOrDto Clase DTO o función de validación.
  */
-function Validate(validator) {
+function Validate(validatorOrDto) {
     return (target, propertyKey, parameterIndex) => {
         const existingValidators = Reflect.getMetadata(METADATA_KEYS.VALIDATORS, target, propertyKey || '') || [];
-        existingValidators.push({ index: parameterIndex, validator });
+        // Determinar si es una clase DTO o función
+        const isClassValidator = typeof validatorOrDto === 'function' && validatorOrDto.prototype;
+        const validator = isClassValidator
+            ? async (value) => {
+                const instance = classTransformer.plainToInstance(validatorOrDto, value);
+                const errors = await classValidator.validate(instance, { whitelist: true, forbidNonWhitelisted: true });
+                if (errors.length > 0) {
+                    throw new ValidationException(errors);
+                }
+                return true;
+            }
+            : validatorOrDto;
+        existingValidators.push({ index: parameterIndex, validator, dtoClass: isClassValidator ? validatorOrDto : null });
         Reflect.defineMetadata(METADATA_KEYS.VALIDATORS, existingValidators, target, propertyKey || '');
     };
 }
+/**
+ * Decorador de método para validar todo el body con un DTO
+ * @example
+ * @Post()
+ * @ValidateDto(CreateUserDto)
+ * async create(@Body() body: CreateUserDto) {}
+ */
+function ValidateDto(dtoClass) {
+    return (target, propertyKey, descriptor) => {
+        const existingValidators = Reflect.getMetadata(METADATA_KEYS.VALIDATORS, target, propertyKey) || [];
+        const validator = async (value) => {
+            const instance = classTransformer.plainToInstance(dtoClass, value);
+            const errors = await classValidator.validate(instance, {
+                whitelist: true,
+                forbidNonWhitelisted: true
+            });
+            if (errors.length > 0) {
+                throw new ValidationException(errors);
+            }
+            return true;
+        };
+        const paramsMetadata = Reflect.getMetadata(METADATA_KEYS.PARAMS, target, propertyKey) || [];
+        const bodyParam = paramsMetadata.find((p) => p.type === exports.ParamType.BODY);
+        if (bodyParam) {
+            existingValidators.push({
+                index: bodyParam.index,
+                validator,
+                dtoClass
+            });
+            Reflect.defineMetadata(METADATA_KEYS.VALIDATORS, existingValidators, target, propertyKey);
+        }
+        return descriptor;
+    };
+}
+/**
+ * Excepción personalizada para errores de validación
+ */
+class ValidationException extends Error {
+    constructor(errors) {
+        super('Validation failed');
+        this.statusCode = 400;
+        this.errors = errors;
+        this.name = 'ValidationException';
+    }
+    toJSON() {
+        return this.errors.map(error => ({
+            property: error.property,
+            value: error.value,
+            constraints: error.constraints
+        }));
+    }
+}
 
 /**
  * Decorador para transformar datos de entrada en un controlador.
@@ -1229,6 +1299,8 @@ exports.UseGuards = UseGuards;
 exports.UseInterceptors = UseInterceptors;
 exports.UsePipes = UsePipes;
 exports.Validate = Validate;
+exports.ValidateDto = ValidateDto;
 exports.ValidationError = ValidationError;
+exports.ValidationException = ValidationException;
 exports.ValidationPipe = ValidationPipe;
 exports.isRedirectResponse = isRedirectResponse;

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

@@ -1,12 +1,40 @@
 import 'reflect-metadata';
+import { ValidationError } from 'class-validator';
 /**
- * Decorador para validar datos de entrada en un controlador.
+ * Decorador para validar datos de entrada usando class-validator.
  *
  * @example
- * // Valida el parámetro 'body' usando la función validateUser
- * @Validate(validateUser)
- * async create(@Body() body: any) {}
+ * // Valida el body usando un DTO
+ * async create(@Validate(CreateUserDto) @Body() body: CreateUserDto) {}
  *
- * @param validator Función de validación que recibe el valor y retorna booleano o lanza error.
+ * @example
+ * // Valida con función personalizada
+ * @Validate((value) => value.age > 18)
+ * async create(@Body('age') age: number) {}
+ *
+ * @param validatorOrDto Clase DTO o función de validación.
+ */
+export declare function Validate(validatorOrDto: any): ParameterDecorator;
+/**
+ * Decorador de método para validar todo el body con un DTO
+ * @example
+ * @Post()
+ * @ValidateDto(CreateUserDto)
+ * async create(@Body() body: CreateUserDto) {}
+ */
+export declare function ValidateDto(dtoClass: any): MethodDecorator;
+/**
+ * Excepción personalizada para errores de validación
  */
-export declare function Validate(validator: (value: any) => boolean | void): ParameterDecorator;
+export declare class ValidationException extends Error {
+    errors: ValidationError[];
+    statusCode: number;
+    constructor(errors: ValidationError[]);
+    toJSON(): {
+        property: string;
+        value: any;
+        constraints: {
+            [type: string]: string;
+        } | undefined;
+    }[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hemia/common",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "Paquete común para proyectos de Hemia",
   "main": "dist/hemia-common.js",
   "module": "dist/hemia-common.esm.js",
@@ -30,11 +30,17 @@
     "ts-jest": "^29.2.5",
     "ts-node": "^8.9.0",
     "typescript": "^5.5.4",
-    "inversify": "^7.11.0"
+    "inversify": "^7.11.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.15.1"
   },
   "peerDependencies": {
     "reflect-metadata": "^0.2.2"
   },
+  "optionalDependencies": {
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.15.1"
+  },
   "author": "Hemia Team",
   "license": "ISC",
   "files": [