Ce sunt pipes-urile și cum funcționează validarea?

Question

Accepted Answer

**Pipes-urile** sunt clase care **transformă sau validează** datele de intrare înainte ca acestea să ajungă la un handler de rută. Acestea operează pe argumentele metodelor de control — fie transformându-le (de ex. string → număr), fie validîndu-le (respingând datele nevalide). Validarea în NestJS este construită pe baza pipes-urilor.

## Built-in transformation pipes

```ts
@Get(":id")
findOne(@Param("id", ParseIntPipe) id: number) {    // transforms "5" (string) → 5 (number)
  // id is guaranteed to be a number; non-numeric input → 400 error automatically
  return this.usersService.findOne(id);
}
// other built-ins: ParseBoolPipe, ParseUUIDPipe, ParseArrayPipe, DefaultValuePipe
```

Pipes-urile de transformare convertesc intrarea la tipul corect (parametrii de rută/query sunt întotdeauna stringuri), eşuând cu o eroare 400 dacă conversia nu este posibilă.

## The ValidationPipe — validare automată de DTO

```ts
// enable globally in main.ts
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // remove properties not declared in the DTO
  forbidNonWhitelisted: true,   // throw if unknown properties are present
  transform: true,              // turn plain objects into DTO instances, convert types
}));
```

```ts
// with a DTO using class-validator decorators:
export class CreateUserDto {
  @IsEmail() email: string;
  @MinLength(8) password: string;
}

@Post()
create(@Body() dto: CreateUserDto) {   // ValidationPipe validates the body automatically
  // if invalid → 400 with details, BEFORE this runs
}
```

`ValidationPipe` citește decoratorii `class-validator` ai DTO-ului și validează datele de intrare automat — returnând o eroare 400 detaliată în caz de eşec, deci handlerul dumneavoastră primește doar date valide.

## Cum pipes-urile se potrivesc în fluxul de cereri

```text
Request → ...middleware/guards/interceptors... → PIPES (transform/validate) → Handler
Pipes run JUST BEFORE the route handler, operating on its method arguments.
```

## Custom pipes

```ts
@Injectable()
export class TrimPipe implements PipeTransform {
  transform(value: any) {
    return typeof value === "string" ? value.trim() : value;   // custom transformation
  }
}
// usage: @Body(TrimPipe) ...
```

Implementați metoda `transform()` a `PipeTransform` pentru logica de validare/transformare personalizată.

## Aplicarea pipes-urilor la diferite niveluri

```ts
@UsePipes(new ValidationPipe())      // method or controller level
@Param("id", ParseIntPipe)            // parameter level
app.useGlobalPipes(new ValidationPipe())   // global (most common for validation)
```

## De ce este important

Pipes-urile sunt o caracteristică cheie a NestJS pentru gestionarea sigură a intrării, și sunt baza **sistemului de validare** al framework-ului.

Înțelegerea lor este esențială deoarece practic fiecare endpoint API trebuie să valideze și să transforme intrarea: pipes-urile de transformare (`ParseIntPipe`, etc.) asigură că parametrii sunt de tipul corect, și — cel mai important — **`ValidationPipe`** combinat cu DTO-uri oferă validare automată și declarativă a trupurilor de cereri împotriva regulilor `class-validator`, respingând datele nevalide sau rău intenționate cu erori clare *înainte* ca acestea să ajungă la logica de afaceri a dumneavoastră.

Aceasta este critică atât pentru securitate (validarea/igienizarea intrării de neinceput, eliminarea proprietăților neașteptate) cât și pentru robustețe (handlere primesc doar date valide).

A ști cum să activați pipes-ul de validare global cu opțiuni rezonabile (`whitelist`, `transform`), să utilizați pipes-uri de transformare incorporate și să scrieți pipes-uri personalizate este fundamental pentru construirea de API-uri NestJS sigure și bine structurate — pipes-urile și validarea sunt concepte de zi cu zi, care trebuie cunoscute în framework.