Çfarë janë pipes dhe si funksionon validimi?

Question

Accepted Answer

**Pipes** janë klasa që **transformojnë ose validojnë** të dhënat hyrëse përpara se të arrijnë në një route handler. Ato operojnë në argumentet e metodave të kontrollerit — duke i transformuar ato (p.sh. string → number) ose duke i validuar ato (duke refuzuar të dhënat e pavlefshme). Validimi në NestJS është ndërtuar mbi pipes.

## Transformation pipes të ndërtuara

```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 konvertojnë hyrjen në llojin e duhur (route params/query janë gjithmonë strings), dështojnë me një 400 nëse konvertimi nuk është i mundur.

## ValidationPipe — validimi automatik i DTO-ve

```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` lexon dekoratorët e `class-validator` të DTO-s dhe validan automatikisht të dhënat hyrëse — duke kthyer një detaje 400 gabimi në rast dështimi, kështu që handler-i juaj merr vetëm të dhëna të vlefshme.

## Si pipes përshtaten në rrjedhën e kërkesës

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

## Pipes të personalizuara

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

Ju zbatoni metodën `transform()` të `PipeTransform` për logjikën e personalizuar të validimit/transformimit.

## Zbatimi i pipes në nivele të ndryshme

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

## Pse ka rëndësi

Pipes janë një tipar kyç i NestJS për trajtimin e hyrjes në mënyrë të sigurt, dhe ata janë themeli i **sistemit të validimit** të framework-ut.

Kuptimi i tyre është i domosdoshëm sepse pothuajse çdo pikë përfundimi i API-t ka nevojë të validojë dhe transformojë hyrjen: transformation pipes (`ParseIntPipe`, etj.) sigurojnë që parametrat janë të tipit të saktë, dhe — më i rëndësishmja — **`ValidationPipe`** e kombinuar me DTO-ve ofron validim automatik dhe deklarativ të trupave të kërkesave kundër rregullave të `class-validator`, duke refuzuar hyrjen të pavlefshme ose të keqe me gabime të qarta *përpara* se të arrijë në logjikën tuaj të biznesit.

Kjo është kritike si për sigurinë (validimi/sanitizimi i hyrjes jo të besuar, heqja e pronave të papritshme) ashtu edhe për qëndrueshmërinë (handlers marrin vetëm të dhëna të vlefshme).

Dija se si të aktivizoni tubin global të validimit me opsione të arsyeshme (`whitelist`, `transform`), përdorni transformation pipes të ndërtuara, dhe shkruani pipes të personalizuara është themelore për ndërtimin e NestJS APIs të sigurta dhe të strukturuara mirë — pipes dhe validimi janë koncepte të përditshme, të cilat duhet të njihen në framework.