Validando parámetros con class-validator y mapped-types

npm i class-validator class-transformer @nestjs/mapped-types

Tremendo aporte de los validadores. Es increíble todo lo que nos brinda Nest.js.

Con class-validator también tenemos la opción de retornar mensajes personalizados para cada una de las validaciones.
Solo basta con, en la validación que corresponda, agregar un objeto con la key message que contendra dicho mensaje.

Y la respuesta de la API se verá algo así:

Validar que los tipos coincidan con los DTOs

Instalar dependencias: npm install @nestjs/mapped-types class-validator class-transformer

Importar las dependencias en el main.ts

import { NestFactory } from '@nestjs/core';
import { ValidationPipe } from '@nestjs/common';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe());
  await app.listen(3000);
}
bootstrap();

importar en el DTO:

import {
  IsString,
  IsNumber,
  IsUrl,
  IsNotEmpty,
  IsPositive,
} from 'class-validator';

import { PartialType } from '@nestjs/mapped-types';

Implementar en la clase del DTO:

export class CreateProductDto {
  @IsString()
  @IsNotEmpty()
  readonly name: string;

  @IsString()
  @IsNotEmpty()
  readonly description: string;

  @IsNumber()
  @IsNotEmpty()
  @IsPositive()
  readonly price: number;

  @IsNumber()
  @IsNotEmpty()
  @IsPositive()
  readonly stock: number;

  @IsUrl() //valida que sea una url
  @IsNotEmpty()
  readonly image: string;
}

Se puede extender a una clase pero que sea opcional pero que valida sus campos de esta forma:

export class UpdateProductDto extends PartialType(CreateProductDto) {}

Se puede extender un mensaje custom al decorador

@IsString({message: 'My custom message'})

Wow no conocía estas opciones de nest, y al principio parece too much, para una api bien robusta me parece perfecto.

Al querer instalar @nestjs/mapped-types me encontre con problemas de dependencias internas con class-transformer.
En este momento (noviembre 2021) class-transformer esta en version 0.5.1 y @nestjs/mapped-types requiere 0.4.0.
Solucion instalar: npm i [email protected] y luego npm i @nestjs/mapped-types

Si quieren agregar un campo en el DTO con tipo Date pueden hacer esto:

1. Permiten la transformacion en el main.ts

  app.useGlobalPipes(new ValidationPipe({ transform: true }));

1. Agregan @Type de la libreria class-transform

@IsDate()
@Type(() => Date)
@IsNotEmpty()
readonly date: Date;

1. En el request pueden enviar varios formatos, por ej:
   "date": "06/18/2021",

Ok estas validaciones son middleware, creería yo…

nest es BRUTAL

Para quienes estén haciendo el curso y tengan un error al instalar mapped-types deben usar la versión 0.13.0 de class-validator, hasta ahora no es compatible con la versión 0.14.0 que es la que se instala por defecto

npm i [email protected]

Hola 👋
Para los que preferimos yarn sobre npm

yarn add class-validator class-transformer

Espero haberles aportado algo 🚀

Importante

Recuerden poner el nombre de las importaciones de class-validator en CammelCase, o sea, con la primera letra en mayuscula, ya que tambien tienen su opcion de ponerlo en minuscula pero en esa le tienes que pasar el valor dentro de los parentesis.

Instalar una dependencia de @nestjs mapped-types nos ayuda a reutilizar código de clases que ya tenemos

import { ValidationPipe } from '@nestjs/common';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalPipes(new ValidationPipe());
  await app.listen(3000);
}

Al día de hoy a mi no me funciono el comando

npm i @nestjs/mapped-types

Ya que según la documentación de nest ahora dice que debemos usar @nestjs/swagger

npm i @nestjs/swagger

y para que realmente sea opcional debemos agregar el decorador @ApiProperty() para que PartialType los pueda omitir quedando de la siguiente manera

export class CreateProductDto {
  @IsNotEmpty()
  @IsString()
  @ApiProperty()
  readonly name: string;
  @IsNotEmpty()
  @IsString()
  @ApiProperty()
  readonly description: string;
  @IsNotEmpty()
  @IsNumber()
  @IsPositive()
  @ApiProperty()
  readonly stock: number;
  @IsNotEmpty()
  @IsUrl()
  @ApiProperty()
  readonly image: string;
  @IsNotEmpty()
  @IsNumber()
  @IsPositive()
  @ApiProperty()
  readonly price: number;
}

Fuente: https://docs.nestjs.com/openapi/mapped-types#mapped-types

Me encontré la documentación de Nest sobre este tema acá

Que maravilloso.

el cero no lo válida como positivo

Es increible la cantidad de tiempo que nos ahorran los decoradores de validación. Aunque solo es un layer más ya que la robustez de los datos debe siempre estar en los modelos. Excelente clase!

uff que hit este tema

Add @nestjs/mapped-types

Using Class validator annotations for execution time validation not only dev experience

Add class-validator and class-transformer

Bonito aporte!

Al venir de express, me faltó gritar de alegría al ver estos decoradores!!! es increible la cantidad de trabajo que nos ahorran.

Normalmente cuando hago apis las hago con express + typescript, y este tipo de validaciones las hago con express-validators, y es un poco engorroso crear middlewares para responder el error. Crear dtos es mucho más sencillo.

Utilizar decorador @isPositive para numeros positivos de class-validator

Activar las validaciones de class-validator

class-validator tienes muchos decoradores uno de ellos son: @isString, @isNumber,@isUrl, @isEmail, @isNotEmpity

instalar la dependencia class-validator y la class-transformer

Encantado con esta parte de la validación, sobre todo el uso de Dtos, que es de gran apoyo.

PartialType

👏👏