पाइप्स म्हणजे काय आणि व्हॅलिडेशन कसे काम करते?

Question

Accepted Answer

**पाइप्स** हे अशा वर्ग आहेत जे **इनपुट डेटाला रूपांतरित किंवा सत्यापित** करतात अगोदर ते रूट हँडलरपर्यंत पोहोचतात. ते नियंत्रक पद्धतींच्या युक्तिवादांवर काम करतात — त्यांना रूपांतरित करून (उदा. string → number) किंवा त्यांची पडताळणी करून (अमान्य डेटा नाकारून). NestJS मधील सत्यापन पाइप्सवर बनवले जाते.

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

ट्रान्सफॉर्मेशन पाइप्स इनपुटला योग्य प्रकारामध्ये रूपांतरित करतात (रूट पॅरामीटर्स/क्वेरी नेहमी स्ट्रिंग असतात), रूपांतर शक्य नसल्यास 400 सह अपयशी होतात.

## 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` DTO च्या `class-validator` डेकोरेटर्स वाचते आणि इनकमिंग डेटा स्वयंचलितपणे सत्यापित करते — अपयशावर तपशील 400 त्रुटी परत करते, जेणेकरून आपला हँडलर केवळ वैध डेटा प्राप्त करतो.

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

आपण कस्टम व्हॅलिडेशन/ट्रान्सफॉर्मेशन लॉजिकसाठी `PipeTransform` च्या `transform()` पद्धतीचा अंमलबजावणी करतात.

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

## हे का महत्वाचे आहे

पाइप्स हे इनपुट सुरक्षितपणे हाताळण्यासाठी NestJS चे एक मुख्य वैशिष्ट्य आहे आणि ते फ्रेमवर्कच्या **सत्यापन प्रणालीचा** आधार आहेत.

हे समजणे आवश्यक आहे कारण जवळजवळ प्रत्येक API एंडपॉइंटला इनपुट सत्यापित आणि रूपांतरित करावा लागतो: ट्रान्सफॉर्मेशन पाइप्स (`ParseIntPipe` इत्यादी) पॅरामीटर्स योग्य प्रकारचे आहेत हे सुनिश्चित करतात, आणि — सर्वात महत्वाचे — DTO सह **`ValidationPipe`** केवळ `class-validator` नियमांविरुद्ध विनंती मुख्य भागाचे स्वयंचलित, घोषणात्मक सत्यापन प्रदान करते, *आपल्या व्यावसायिक तर्कापर्यंत पोहोचण्याआधी* स्पष्ट त्रुटी सह अमान्य किंवा दुर्भावनापूर्ण इनपुट नाकारते.

हे सुरक्षा (अविश्वास्य इनपुटची पडताळणी/सफाई, अपेक्षित मालमत्ता काढून टाकणे) आणि मजबूतता (हँडलर्स केवळ वैध डेटा प्राप्त करतात) या दोन्ही बाबतीत महत्वपूर्ण आहे.

वैश्विक सत्यापन पाइप वाजवी पर्यायांसह (`whitelist`, `transform`) कसे सक्षम करावे, बिल्ट-इन ट्रान्सफॉर्मेशन पाइप्स कसे वापरावे आणि कस्टम पाइप्स कसे लिहायचे हे जाणून घेणे हे सुरक्षित, सुव्यवस्थित NestJS API तयार करण्यासाठी मूलभूत आहे — पाइप्स आणि सत्यापन हे फ्रेमवर्कमधील दैनिक, आवश्यक संकल्पना आहेत.