Tema 7 · DTOs & ValidationPipe

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 Técnico: Validación de DTOs con ValidationPipe y Persistencia ORM en NestJS

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:

src/cursos/dto/crear-curso.dto.ts
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.