Pipes কি এবং validation কীভাবে কাজ করে?

Question

Accepted Answer

**Pipes** হল এমন ক্লাস যা একটি route handler এ পৌঁছানোর আগে ইনপুট ডেটা **রূপান্তরিত বা যাচাই করে**। তারা controller methods এর আর্গুমেন্টগুলিতে কাজ করে — হয় সেগুলিকে রূপান্তরিত করে (যেমন string → number) বা যাচাই করে (অবৈধ ডেটা প্রত্যাখ্যান করে)। NestJS এ validation pipes এর উপর ভিত্তি করে তৈরি।

## বিল্ট-ইন 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
```

Transformation pipes ইনপুটকে সঠিক ধরনে রূপান্তরিত করে (route params/query সর্বদা strings), রূপান্তর সম্ভব না হলে 400 এর সাথে ব্যর্থ হয়।

## ValidationPipe — স্বয়ংক্রিয় 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` DTO এর `class-validator` decorators পড়ে এবং আসা ডেটা স্বয়ংক্রিয়ভাবে যাচাই করে — ব্যর্থতার সময় বিস্তারিত 400 error প্রদান করে, যাতে আপনার handler শুধুমাত্র বৈধ ডেটা পায়।

## Pipes কীভাবে request flow এ খাপ খায়

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

## কাস্টম pipes

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

কাস্টম validation/transformation logic এর জন্য আপনি `PipeTransform` এর `transform()` method প্রয়োগ করেন।

## বিভিন্ন স্তরে pipes প্রয়োগ করা

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

## কেন এটি গুরুত্বপূর্ণ

Pipes হল ইনপুট নিরাপদে পরিচালনার জন্য NestJS এর একটি মূল বৈশিষ্ট্য, এবং তারা ফ্রেমওয়ার্কের **validation system** এর ভিত্তি।

এটি বোঝা অপরিহার্য কারণ প্রায় প্রতিটি API endpoint ইনপুট যাচাই এবং রূপান্তরিত করার প্রয়োজন: transformation pipes (`ParseIntPipe` ইত্যাদি) নিশ্চিত করে যে parameters সঠিক type, এবং — সবচেয়ে গুরুত্বপূর্ণভাবে — **`ValidationPipe`** DTOs এর সাথে combined করে request bodies এর স্বয়ংক্রিয়, declarative validation প্রদান করে `class-validator` rules এর বিপরীতে, অবৈধ বা ক্ষতিকর ইনপুট প্রত্যাখ্যান করে স্পষ্ট errors এর সাথে *এটি আপনার business logic এ পৌঁছানোর আগে*।

এটি নিরাপত্তা (untrusted ইনপুট যাচাই/sanitize করা, unexpected properties সরানো) এবং robustness (handlers শুধুমাত্র বৈধ ডেটা পায়) উভয়ের জন্যই গুরুত্বপূর্ণ।

গ্লোবাল validation pipe সক্ষম করা কীভাবে করতে হয় sensible options (`whitelist`, `transform`) এর সাথে, বিল্ট-ইন transformation pipes ব্যবহার করা, এবং কাস্টম pipes লেখা জানা safe, well-structured NestJS APIs তৈরির জন্য fundamental — pipes এবং validation ফ্রেমওয়ার্কে প্রতিদিনের, অবশ্য-জানার ধারণা।