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:
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¿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.