Što su pipes i kako funkcionira validacija?

Question

Accepted Answer

**Pipes** su klase koje **transformiraju ili validiraju** ulazne podatke prije nego što dosegnu route handler. Oni se koriste na argumentima metoda kontrolera — ili transformirajući ih (npr. string → number) ili validirajući ih (odbijajući nevaljane podatke). Validacija u NestJS-u je izgrađena na pipes.

## Ugrađeni 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
```

Transformation pipes konvertiraju ulaz na ispravan tip (route parametri/query su uvijek stringovi), vraćajući 400 ako konverzija nije moguća.

## ValidationPipe — automatska validacija DTO-a

```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` čita `class-validator` dekoratore DTO-a i automatski validira ulazne podatke — vraćajući detaljnu 400 grešku pri neuspjehu, tako da handler uvijek primi samo valjane podatke.

## Kako pipes spadaju u tok zahtjeva

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

## Prilagođeni pipes

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

Implementirate `PipeTransform`-ovu `transform()` metodu za prilagođenu validaciju/transformaciju logiku.

## Primjena pipes-a na različitim razinama

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

## Zašto je važno

Pipes su ključna NestJS značajka za sigurnu manipulaciju ulazima, i oni su temelj **sistema validacije** frameworka.

Razumijevanje je bitno jer gotovo svaki API endpoint trebate validirati i transformirati ulaz: transformation pipes (`ParseIntPipe`, itd.) osiguravaju da su parametri ispravnog tipa, a — što je najvažnije — **`ValidationPipe`** kombiniran s DTO-ima pruža automatsku, deklarativnu validaciju tijela zahtjeva prema `class-validator` pravilima, odbijajući nevaljane ili zlonamjerne podatke s jasnim greškama *prije* nego što dosegnu vašu poslovnu logiku.

Ovo je kritično za sigurnost (validacija/sanifikacija nepouzdanih ulaza, uklanjanje neočekivanih svojstava) i robustnost (handleri primaju samo valjane podatke).

Znanje kako omogućiti globalni validation pipe s razumnim opcijama (`whitelist`, `transform`), koristiti ugrađene transformation pipes i napisati prilagođene pipes je temeljno za izgradnju sigurnih, dobro strukturiranih NestJS API-ja — pipes i validacija su svakodnevni, obavezni koncepti u frameworku.