Pipe'lar nedir ve doğrulama nasıl çalışır?

Question

Accepted Answer

**Pipe'lar**, rota handler'ına ulaşmadan önce giriş verilerini **dönüştüren veya doğrulayan** sınıflardır. Controller metotlarının argümanları üzerinde çalışırlar — onları dönüştürebilirler (örn. string → number) veya doğrulayabilirler (geçersiz veriyi reddedebilirler). NestJS'de doğrulama pipe'lar üzerine kurulmuştur.

## Yerleşik dönüştürme pipe'ları

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

Dönüştürme pipe'ları giriş verilerini doğru türe dönüştürür (rota parametreleri/query her zaman string'dir), dönüştürme mümkün değilse 400 hatası verir.

## ValidationPipe — otomatik DTO doğrulaması

```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` DTO'nun `class-validator` dekoratörlerini okur ve gelen veriyi otomatik olarak doğrular — başarısız olursa detaylı 400 hatası döndürür, böylece handler'ınız sadece geçerli veri alır.

## Pipe'ların istek akışındaki yeri

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

## Özel pipe'lar

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

Özel doğrulama/dönüştürme mantığı için `PipeTransform`'un `transform()` metodunu uygularsınız.

## Pipe'ları farklı seviyelerde uygulama

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

## Neden önemli

Pipe'lar giriş verilerini güvenli bir şekilde ele almak için temel bir NestJS özelliğidir ve framework'ün **doğrulama sisteminin** temelini oluştururlar.

Onları anlamak çok önemlidir çünkü neredeyse her API endpoint'inin giriş verilerini doğrulaması ve dönüştürmesi gerekir: dönüştürme pipe'ları (`ParseIntPipe` vb.) parametrelerin doğru türde olmasını sağlar, ve — en önemlisi — **`ValidationPipe`** DTO'lar ile birleştiğinde, `class-validator` kurallarına karşı otomatik ve deklaratif bir şekilde istek gövdesini doğrulayarak, geçersiz veya kötü niyetli giriş verilerini handler'ınıza ulaşmadan önce açık hatalarla reddeder.

Bu hem güvenlik (güvenilmeyen giriş verilerini doğrulama/sanitizasyon, beklenmeyen özellikleri çıkarma) hem de sağlamlık (handler'lar sadece geçerli veri alır) için kritik önem taşır.

Global doğrulama pipe'ını mantıklı seçenekler (`whitelist`, `transform`) ile nasıl etkinleştireceğini, yerleşik dönüştürme pipe'larını nasıl kullanacağını ve özel pipe'lar nasıl yazacağını bilmek, güvenli ve iyi yapılandırılmış NestJS API'ları oluşturmak için temeldir — pipe'lar ve doğrulama framework'te her gün kullanılan, bilmesi gereken kavramlardır.