7. DTOs (Data Transfer Objects), class-validator, class-transformer y ValidationPipe Global
Blinda tus endpoints validando payloads entrantes con decoradores declarativos y bloqueando propiedades intrusas con whitelist y forbidNonWhitelisted.
¿Por qué usar Clases DTO en lugar de Interfaces TypeScript?
Un DTO (Data Transfer Object) define el contrato exacto de los datos que entran a tu API por la red. En NestJS, los DTOs se escriben como clases (export class CrearCursoDto) y no como interfaces de TypeScript.
¿La razón? Las interfaces de TypeScript desaparecen por completo al compilar a JavaScript, por lo que no existen en tiempo de ejecución. En cambio, las clases conservan sus metadatos, permitiendo que class-validator y ValidationPipe validen automáticamente cada propiedad en caliente.
Diagrama 7.1: Filtrado y validación de payloads JSON entrantes mediante ValidationPipe y decoradores de class-validator.
Configuración Blindada de ValidationPipe
# Instalar paquetes oficiales de validación y transformación
npm i class-validator class-transformer
Opción de ValidationPipe |
Efecto de Seguridad (Prevención de Mass Assignment) |
|---|---|
whitelist: true |
Elimina silenciosamente cualquier propiedad del JSON entrante que no tenga decoradores en el DTO (ej. si un atacante envía "esAdmin": true). |
forbidNonWhitelisted: true |
En lugar de solo eliminar los campos intrusos, rechaza inmediatamente la petición con HTTP 400 Bad Request indicando qué propiedad no está permitida. |
transform: true |
Convierte el payload plano JSON en una instancia real de la clase DTO y realiza conversiones de tipos primitivos. |
⚡ DTO con Decoradores de Validación y Activación Global en main.ts
Definición de CrearCursoDto y registro del ValidationPipe global contra ataques de asignación masiva:
import {
IsString,
IsInt,
IsPositive,
MinLength,
MaxLength,
Min,
Max,
IsOptional,
} from 'class-validator';
export class CrearCursoDto {
@IsString({ message: 'El título debe ser una cadena de texto válida' })
@MinLength(5, { message: 'El título debe tener al menos 5 caracteres' })
@MaxLength(150)
readonly titulo: string;
@IsInt({ message: 'Las horas lectivas deben ser un número entero' })
@Min(1)
@Max(159, { message: 'Por normativa de Educación Informal debe ser menor a 160 horas' })
readonly horas: number;
@IsInt()
@IsPositive({ message: 'El precio en COP debe ser mayor a cero' })
readonly precioCop: number;
@IsOptional()
@IsString()
readonly resumen?: string;
}
/*
En src/main.ts se activa globalmente para toda la API:
app.useGlobalPipes(
new ValidationPipe({
whitelist: true,
forbidNonWhitelisted: true,
transform: true,
}),
);
*/
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué combinación de opciones en ValidationPipe evita vulnerabilidades de Asignación Masiva (Mass Assignment) eliminando o rechazando campos JSON que no estén declarados en el DTO?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.