@hemia/common 0.0.15 → 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.
@@ -466,6 +536,61 @@ class GatewayTimeoutError extends HttpError {
         super(message, 504, error);
     }
 }
+class TooManyRequestsError extends HttpError {
+    constructor(message = 'Too Many Requests', error) {
+        super(message, 429, error);
+    }
+}
+class MethodNotAllowedError extends HttpError {
+    constructor(message = 'Method Not Allowed', error) {
+        super(message, 405, error);
+    }
+}
+class NotAcceptableError extends HttpError {
+    constructor(message = 'Not Acceptable', error) {
+        super(message, 406, error);
+    }
+}
+class ProxyAuthenticationRequiredError extends HttpError {
+    constructor(message = 'Proxy Authentication Required', error) {
+        super(message, 407, error);
+    }
+}
+class RequestTimeoutError extends HttpError {
+    constructor(message = 'Request Timeout', error) {
+        super(message, 408, error);
+    }
+}
+class UnsupportedMediaTypeError extends HttpError {
+    constructor(message = 'Unsupported Media Type', error) {
+        super(message, 415, error);
+    }
+}
+class PreconditionFailedError extends HttpError {
+    constructor(message = 'Precondition Failed', error) {
+        super(message, 412, error);
+    }
+}
+class PayloadTooLargeError extends HttpError {
+    constructor(message = 'Payload Too Large', error) {
+        super(message, 413, error);
+    }
+}
+class URITooLongError extends HttpError {
+    constructor(message = 'URI Too Long', error) {
+        super(message, 414, error);
+    }
+}
+class NotImplementedError extends HttpError {
+    constructor(message = 'Not Implemented', error) {
+        super(message, 501, error);
+    }
+}
+class BadGatewayError extends HttpError {
+    constructor(message = 'Bad Gateway', error) {
+        super(message, 502, error);
+    }
+}
 class CustomHttpError extends HttpError {
     constructor(message, statusCode, error) {
         super(message, statusCode, error);
@@ -1047,4 +1172,4 @@ class ApiResponse {
     }
 }
 
-export { AllowAny, ApiKey, ApiResponse, BackupError, 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, Module, Next, NotFoundError, OperationNotAllowedError, Options, Owner, Param, ParamType, ParseArrayPipe, ParseBoolPipe, ParseDatePipe, ParseEnumPipe, ParseFilePipe, ParseFloatPipe, ParseIntPipe, ParseUUIDPipe, Patch, Permissions, PersistenceError, PolicyBased, Post, Public, Put, Query, QueryExecutionError, RateLimit, Redirect, Repository, Req, ReqAuth, ReqContext, ReqPermissions, ReqUser, Request, Res, ResourceLimitError, ResourceLimitExceededError, Response, RestoreError, Roles, SchemaMismatchError, Scopes, Serialize, Service, ServiceUnavailableError, Session, SetMetadata, Throttle, TimeoutError, TransactionError, Transform, UnauthorizedError, UnprocessableEntityError, 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.
@@ -468,6 +538,61 @@ class GatewayTimeoutError extends HttpError {
         super(message, 504, error);
     }
 }
+class TooManyRequestsError extends HttpError {
+    constructor(message = 'Too Many Requests', error) {
+        super(message, 429, error);
+    }
+}
+class MethodNotAllowedError extends HttpError {
+    constructor(message = 'Method Not Allowed', error) {
+        super(message, 405, error);
+    }
+}
+class NotAcceptableError extends HttpError {
+    constructor(message = 'Not Acceptable', error) {
+        super(message, 406, error);
+    }
+}
+class ProxyAuthenticationRequiredError extends HttpError {
+    constructor(message = 'Proxy Authentication Required', error) {
+        super(message, 407, error);
+    }
+}
+class RequestTimeoutError extends HttpError {
+    constructor(message = 'Request Timeout', error) {
+        super(message, 408, error);
+    }
+}
+class UnsupportedMediaTypeError extends HttpError {
+    constructor(message = 'Unsupported Media Type', error) {
+        super(message, 415, error);
+    }
+}
+class PreconditionFailedError extends HttpError {
+    constructor(message = 'Precondition Failed', error) {
+        super(message, 412, error);
+    }
+}
+class PayloadTooLargeError extends HttpError {
+    constructor(message = 'Payload Too Large', error) {
+        super(message, 413, error);
+    }
+}
+class URITooLongError extends HttpError {
+    constructor(message = 'URI Too Long', error) {
+        super(message, 414, error);
+    }
+}
+class NotImplementedError extends HttpError {
+    constructor(message = 'Not Implemented', error) {
+        super(message, 501, error);
+    }
+}
+class BadGatewayError extends HttpError {
+    constructor(message = 'Bad Gateway', error) {
+        super(message, 502, error);
+    }
+}
 class CustomHttpError extends HttpError {
     constructor(message, statusCode, error) {
         super(message, statusCode, error);
@@ -1053,6 +1178,7 @@ exports.AllowAny = AllowAny;
 exports.ApiKey = ApiKey;
 exports.ApiResponse = ApiResponse;
 exports.BackupError = BackupError;
+exports.BadGatewayError = BadGatewayError;
 exports.BadRequestError = BadRequestError;
 exports.Body = Body;
 exports.BusinessRuleViolationError = BusinessRuleViolationError;
@@ -1107,9 +1233,12 @@ exports.IpWhitelist = IpWhitelist;
 exports.Locale = Locale;
 exports.METADATA_KEYS = METADATA_KEYS;
 exports.ManualRegister = ManualRegister;
+exports.MethodNotAllowedError = MethodNotAllowedError;
 exports.Module = Module;
 exports.Next = Next;
+exports.NotAcceptableError = NotAcceptableError;
 exports.NotFoundError = NotFoundError;
+exports.NotImplementedError = NotImplementedError;
 exports.OperationNotAllowedError = OperationNotAllowedError;
 exports.Options = Options;
 exports.Owner = Owner;
@@ -1123,10 +1252,13 @@ exports.ParseFloatPipe = ParseFloatPipe;
 exports.ParseIntPipe = ParseIntPipe;
 exports.ParseUUIDPipe = ParseUUIDPipe;
 exports.Patch = Patch;
+exports.PayloadTooLargeError = PayloadTooLargeError;
 exports.Permissions = Permissions;
 exports.PersistenceError = PersistenceError;
 exports.PolicyBased = PolicyBased;
 exports.Post = Post;
+exports.PreconditionFailedError = PreconditionFailedError;
+exports.ProxyAuthenticationRequiredError = ProxyAuthenticationRequiredError;
 exports.Public = Public;
 exports.Put = Put;
 exports.Query = Query;
@@ -1140,6 +1272,7 @@ exports.ReqContext = ReqContext;
 exports.ReqPermissions = ReqPermissions;
 exports.ReqUser = ReqUser;
 exports.Request = Request;
+exports.RequestTimeoutError = RequestTimeoutError;
 exports.Res = Res;
 exports.ResourceLimitError = ResourceLimitError;
 exports.ResourceLimitExceededError = ResourceLimitExceededError;
@@ -1155,14 +1288,19 @@ exports.Session = Session;
 exports.SetMetadata = SetMetadata;
 exports.Throttle = Throttle;
 exports.TimeoutError = TimeoutError;
+exports.TooManyRequestsError = TooManyRequestsError;
 exports.TransactionError = TransactionError;
 exports.Transform = Transform;
+exports.URITooLongError = URITooLongError;
 exports.UnauthorizedError = UnauthorizedError;
 exports.UnprocessableEntityError = UnprocessableEntityError;
+exports.UnsupportedMediaTypeError = UnsupportedMediaTypeError;
 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/dist/types/errors/http.error.d.ts

@@ -31,6 +31,39 @@ export declare class ServiceUnavailableError extends HttpError {
 export declare class GatewayTimeoutError extends HttpError {
     constructor(message?: string, error?: string);
 }
+export declare class TooManyRequestsError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class MethodNotAllowedError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class NotAcceptableError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class ProxyAuthenticationRequiredError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class RequestTimeoutError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class UnsupportedMediaTypeError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class PreconditionFailedError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class PayloadTooLargeError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class URITooLongError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class NotImplementedError extends HttpError {
+    constructor(message?: string, error?: string);
+}
+export declare class BadGatewayError extends HttpError {
+    constructor(message?: string, error?: string);
+}
 export declare class CustomHttpError extends HttpError {
     constructor(message: string, statusCode: number, error?: string);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hemia/common",
-  "version": "0.0.15",
+  "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": [