Tema 8 · Mapped Types

8. Reutilización de DTOs con @nestjs/mapped-types: PartialType, PickType y OmitType

Evita duplicar reglas de validación en endpoints PATCH/PUT derivando DTOs de actualización automáticamente a partir de tus DTOs de creación.

El Principio DRY en la Validación de DTOs

Cuando construyes un endpoint PATCH /cursos/:id para actualizar un recurso existente, normalmente necesitas exactamente las mismas reglas de validación que en CrearCursoDto, pero haciendo que todos los campos sean opcionales.

Copiar y pegar la clase entera agregando @IsOptional() a cada propiedad viola el principio DRY (Don't Repeat Yourself). Para resolverlo, NestJS ofrece el paquete oficial @nestjs/mapped-types (o su equivalente en @nestjs/swagger si documentas con OpenAPI).

Las 4 Utilidades de Transformación de Tipos

Función Utilidad Comportamiento sobre el DTO Base
PartialType(CrearDto) Hereda todas las propiedades y sus decoradores de class-validator, pero aplica @IsOptional() a cada una automáticamente.
PickType(CrearDto, ['titulo']) Crea un nuevo DTO seleccionando únicamente el subconjunto de propiedades indicadas en el arreglo.
OmitType(CrearDto, ['slug']) Toma todas las propiedades del DTO base excepto las enumeradas en el arreglo (útil cuando un campo no puede modificarse tras la creación).
IntersectionType(DtoA, DtoB) Fusiona las propiedades y reglas de validación de dos DTOs independientes en una sola clase combinada.

⚡ Combinación de PartialType y OmitType para un Endpoint PATCH

Creación de ActualizarCursoDto en 4 líneas de código heredando todas las reglas de CrearCursoDto:

src/cursos/dto/actualizar-curso.dto.ts
Solo lectura
import { PartialType, OmitType } from '@nestjs/mapped-types';
import { CrearCursoDto } from './crear-curso.dto';

/**
 * ActualizarCursoDto toma todas las propiedades de CrearCursoDto,
 * conserva sus validaciones (@MinLength, @Max, @IsPositive),
 * las vuelve opcionales (PartialType) para peticiones PATCH,
 * y prohíbe modificar una propiedad inmutable si fuera necesario con OmitType.
 */
export class ActualizarCursoDto extends PartialType(CrearCursoDto) {}

// Ejemplo combinando PartialType + OmitType para impedir cambiar 'codigoInterno':
// export class ActualizarCursoSeguroDto extends PartialType(
//   OmitType(CrearCursoDto, ['codigoInterno'] as const),
// ) {}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Qué hace exactamente la función PartialType(CrearCursoDto) del paquete @nestjs/mapped-types en tiempo de ejecución?
🦉
¿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.