X'inhuma pipes u kif jaħdem il-validazzjoni?

Question

Accepted Answer

**Pipes** huma klassijiet li **ittrasformaw jew jivvalidaw** id-data ta' input qabel ma jilħqu handler tar-rotta. Jaħdmu fuq l-argumenti ta' metodi tal-kontroller — ittrasformaw (p.es. string → number) jew jivvalidaw (iċċedu data invalida). Il-validazzjoni f'NestJS tinbena fuq 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 tat-trasformazzjoni jikkonverti l-input mal-tip it-tajjeb (parametri ta' rotta/query huma dejjem strings), inqas b'400 jekk il-konverżjoni mhix possibbli.

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

Il-`ValidationPipe` jaqra d-dekoraturi `class-validator` tad-DTO u jivvalida awtomatikament id-data incoming — jirritorna errur 400 dettaljat fuq falliment, sabiex il-handler tiegħek jirċievi biss data valida.

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

Int timplimenta l-metodu `transform()` ta' `PipeTransform` għal loġika ta' validazzjoni/trasformazzjoni personalizzata.

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

## Għaliex dan huwa importanti

Pipes huma feature ewlenija ta' NestJS għad-diġestjoni safe ta' input, u huma l-fondazzjoni tas-**sistema ta' validazzjoni** tal-framework.

Ufhimhom huwa essenzjali għaliex kważi kull API endpoint jeħtieġ jivvalida u ittrasforma l-input: pipes tat-trasformazzjoni (`ParseIntPipe`, eċċ.) jiżguraw li l-parametri huma tat-tip korrett, u — l-iktar importanti — il-**`ValidationPipe`** magħqud ma' DTOs jipprovdi validazzjoni awtomatika u deklarattiva tal-body tar-riquest kontra r-regoli `class-validator`, u jiċċedu input invalidu jew malizzjuż b'errors ċari *qabel* ma jilħqu l-loġika tal-bisniess tiegħek.

Dan huwa kritiku tant għas-sigurtà (jivvalida/ينظف input li mhuwiex trusted, jneħħi proprjetà mhux mistennija) kif ukoll għar-robustezza (handlers jirċievu biss data valida).

Il-ħsieb ta' kif tuħettaġ il-global validation pipe b'opzjonijiet sensati (`whitelist`, `transform`), tuża pipes tat-trasformazzjoni built-in, u tikteb pipes personalizzati huwa fundamentali għall-kostruzzjoni ta' APIs NestJS siguri u strutturati sew — pipes u validazzjoni huma kunċetti ta' kuljum u essenzjali fil-framework.