9. Pipes de Transformación (ParseIntPipe, ParseUUIDPipe) y Serialización con @Exclude()
Valida y convierte parámetros de URL automáticamente y oculta campos sensibles (como passwordHash) en las respuestas con ClassSerializerInterceptor.
Pipes Nativos para Parámetros de Ruta y Consulta
Por naturaleza del protocolo HTTP, todos los parámetros recibidos en la URL (@Param() y @Query()) llegan inicialmente como cadenas de texto (string).
En lugar de usar parseInt(id, 10) y validar manualmente isNaN() en cada controlador, NestJS incluye Pipes nativos que validan el formato y convierten el tipo automáticamente (o rechazan la solicitud con 400 Bad Request si un usuario envía /cursos/abc cuando se esperaba un entero):
Pipe Nativo (@nestjs/common) |
Transformación y Validación |
|---|---|
ParseIntPipe |
Verifica que la cadena sea un número entero válido y la convierte al tipo primitivo number. |
ParseUUIDPipe |
Valida que el parámetro cumpla el formato estándar UUID (v3, v4 o v5) antes de consultar la base de datos. |
ParseBoolPipe |
Transforma cadenas "true" o "false" en valores booleanos reales. |
DefaultValuePipe |
Asigna un valor por defecto cuando un parámetro opcional @Query() no es enviado (ej: paginación). |
Ocultar Secretos en Salidas JSON con ClassSerializerInterceptor
Así como filtramos lo que entra con ValidationPipe, debemos asegurarnos de que al devolver una entidad Usuario jamás se exponga su passwordHash en el JSON. Combinando el decorador @Exclude() de class-transformer con el interceptor nativo ClassSerializerInterceptor, NestJS elimina las propiedades confidenciales automáticamente antes de serializar la respuesta.
⚡ Uso de ParseIntPipe, DefaultValuePipe y @Exclude() en Entidades
Conversión segura de parámetros en el controlador y ocultamiento automático de contraseñas:
import { Exclude, Expose } from 'class-transformer';
import {
Controller,
Get,
Param,
Query,
ParseIntPipe,
DefaultValuePipe,
UseInterceptors,
ClassSerializerInterceptor,
} from '@nestjs/common';
export class UsuarioEntity {
id: number;
nombre: string;
correo: string;
// @Exclude() garantiza que passwordHash NUNCA viaje en el JSON de respuesta
@Exclude()
passwordHash: string;
@Expose()
get perfilPublico(): string {
return `${this.nombre} <${this.correo}>`;
}
constructor(partial: Partial<UsuarioEntity>) {
Object.assign(this, partial);
}
}
@Controller('usuarios')
@UseInterceptors(ClassSerializerInterceptor)
export class UsuariosController {
// GET /api/v1/usuarios/15?pagina=1
@Get(':id')
obtenerUno(
@Param('id', ParseIntPipe) id: number,
@Query('pagina', new DefaultValuePipe(1), ParseIntPipe) pagina: number,
): UsuarioEntity {
return new UsuarioEntity({
id,
nombre: 'Juan Sebastián Amador',
correo: '[email protected]',
passwordHash: '$2b$10$secretoInquebrantableBcryptHash',
});
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué ocurre si un método de controlador recibe @Param("id", ParseIntPipe) id: number y el cliente realiza una petición GET /usuarios/texto-invalido?
¿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.