Co to są pipes i jak działa walidacja?

Question

Accepted Answer

**Pipes** to klasy, które **transformują lub walidują** dane wejściowe zanim dotrą do obsługi trasy (route handler). Operują na argumentach metod kontrolera — albo je transformując (np. string → liczba), albo je walidując (odrzucając nieprawidłowe dane). Walidacja w NestJS jest zbudowana na pipes.

## 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 transformacji konwertują dane wejściowe na właściwy typ (parametry trasy/query zawsze są stringami), kończąc się błędem 400, jeśli konwersja nie jest możliwa.

## The ValidationPipe — automatyczna walidacja 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` odczytuje dekoratory `class-validator` z DTO i automatycznie waliduje przychodzące dane — zwracając szczegółowy błąd 400 w przypadku awarii, więc handler otrzymuje tylko prawidłowe dane.

## Jak pipes wpisują się w przepływ żądania

```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) ...
```

Implementujesz metodę `transform()` `PipeTransform` dla własnej logiki walidacji/transformacji.

## Dlaczego to ważne

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

## Dlaczego to ważne

Pipes są kluczową funkcją NestJS do bezpiecznej obsługi danych wejściowych i stanowią fundament systemu **walidacji** frameworka.

Zrozumienie ich jest niezbędne, ponieważ praktycznie każdy endpoint API musi walidować i transformować dane wejściowe: pipes transformacji (`ParseIntPipe` itp.) zapewniają, że parametry są właściwego typu, a — co najważniejsze — **`ValidationPipe`** połączony z DTO zapewnia automatyczną, deklaratywną walidację treści żądań względem reguł `class-validator`, odrzucając nieprawidłowe lub złośliwe dane z jasnymi błędami *zanim* dotrą do logiki biznesowej.

Jest to krytyczne zarówno dla bezpieczeństwa (walidacja/oczyszczanie niezaufanych danych wejściowych, usuwanie nieoczekiwanych właściwości) jak i niezawodności (handlery otrzymują tylko prawidłowe dane).

Wiedza, jak włączyć globalny pipe walidacji z rozsądnymi opcjami (`whitelist`, `transform`), korzystać z wbudowanych pipes transformacji i pisać niestandardowe pipes, jest fundamentalna do budowania bezpiecznych, dobrze zstrukturyzowanych API NestJS — pipes i walidacja to codzienne, obowiązkowe koncepcje w frameworku.