Kaj so pipe-i in kako deluje validacija?

Question

Accepted Answer

**Pipe-i** so razredi, ki **transformirajo ali preverjajo** vhodne podatke, preden dosežejo upravljalnik poti (route handler). Delujejo na argumentih metod krmilnika — bodisi jih transformirajo (npr. niz → število) bodisi jih preverjajo (zavrnejo neveljavne podatke). Validacija v NestJS je zgrajena na pipe-ih.

## Vgrajeni pipe-i za transformacijo

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

Pipe-i za transformacijo pretvarjajo vhod v pravi tip (parametri poti/poizvedbe so vedno nizi), pri čemer se ne uspejo s 400 napako, če pretvorka ni mogoča.

## ValidationPipe — samodejno preverjanje 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` prebere dekorarorje `class-validator` DTO-ja in samodejno preveri podatke — ob neuspehu vrne podrobno napako 400, tako da vaš upravljalnik prejme samo veljavne podatke.

## Kako se pipe-i umestijo v tok zahtevka

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

## Lastni pipe-i

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

Za lastno logiko validacije/transformacije implementirate metodo `transform()` vmesnika `PipeTransform`.

## Uporaba pipe-ov na različnih ravneh

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

## Zakaj je to pomembno

Pipe-i so ključna NestJS funkcionalnost za varno ravnanje z vhodom in predstavljajo temelje sistema **validacije** ogrodja.

Razumevanje pipe-ov je bistvenega pomena, ker skoraj vsaka API končna točka potrebuje validacijo in transformacijo vhoda: pipe-i za transformacijo (`ParseIntPipe` itd.) zagotavljajo, da so parametri pravilnega tipa, in — kar je najpomembneje — **`ValidationPipe`** v kombinaciji s DTO-ji zagotavlja samodejno, deklarativno validacijo teles zahtevkov glede na pravila `class-validator`, pri čemer zavrne neveljavne ali zlonamerne podatke z jasnimi napakami *preden* dosežejo vašo poslovno logiko.

To je kritično tako za varnost (validacija/čiščenje nezaupanja vrednih vhodov, odstranjevanje nepričakovanih lastnosti) kot tudi za robustnost (upravljalniki prejemajo samo veljavne podatke).

Znanje, kako omogočiti globalni validation pipe s smiselnimi možnostmi (`whitelist`, `transform`), uporabiti vgrajene pipe-e za transformacijo in pisati lastne pipe-e, je temeljno za gradnjo varnih, dobro strukturiranih NestJS API-jev — pipe-i in validacija so vsakodnevni, neobhodni koncepti v ogrodju.