Tema 9 · Pipes & Serialización

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:

src/usuarios/entities/usuario.entity.ts
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ 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.