Kas yra vamzdžiai (pipes) ir kaip veikia validavimas?

Question

Accepted Answer

**Vamzdžiai (pipes)** yra klasės, kurios **transformuoja arba validuoja** įvesties duomenis, kol jie pasiekia maršruto tvarkiklį (route handler). Jie veikia kontrolerio metodų argumentuose — juos transformuodami (pvz., string → number) arba juos validuodami (atmesdami netinkamus duomenis). Validavimas NestJS yra pagrįstas vamzdžiais.

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

Transformacijos vamzdžiai konvertuoja įvestį į tinkamą tipą (maršruto parametrai/užklausos visada yra eilutės), nesėkmingi su 400, jei konversija nėra įmanoma.

## The ValidationPipe — automatic DTO validation

```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` nuskaito DTO `class-validator` dekoratorius ir automatiškai validuoja gautuosius duomenis — grąžina detalią 400 klaidą esant trūkumui, todėl jūsų tvarkiklis gauna tik tinkamus duomenis.

## How pipes fit in the request flow

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

Jūs įgyvendinate `PipeTransform` `transform()` metodą, skirtą pasirinktiniam validavimui/transformacijai.

## Applying pipes at different levels

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

## Kodėl tai svarbu

Vamzdžiai yra svarbi NestJS savybė, skirta saugiai tvarkyti įvestį, ir jie yra sistemos **validavimo sistemos** pagrindas.

Suprasti juos yra būtina, nes beveik kiekvienas API galas turi validuoti ir transformuoti įvestį: transformacijos vamzdžiai (`ParseIntPipe` ir kt.) užtikrina, kad parametrai yra tinkamo tipo, o — svarbiausia — **`ValidationPipe`** kartu su DTO teikia automatinį, deklaratyvų prašymo kūno validavimą pagal `class-validator` taisykles, atmetant netinkamus arba kenkėjiškus įvestis aiškiomis klaidomis *prieš* pasiekiant jūsų verslo logiką.

Tai svarbu ir saugumui (netikėtos įvesties validavimas/valymas, nenaudotų savybių šalinimas), ir patikimumui (tvarkikliai gauna tik tinkamus duomenis).

Žinoti, kaip įjungti globalų validavimo vamzdį su protingomis parinktimis (`whitelist`, `transform`), naudoti integruotus transformacijos vamzdžius ir rašyti pasirinktinus vamzdžius yra pagrindinis dalykas saugiai ir gerai sustruktūrintai NestJS API-jų kūrimui — vamzdžiai ir validavimas yra kasdienis, būtinas koncepcijas framework'e.