Pipes یہ classes ہیں جو data کو transform یا validate کرتی ہیں اس سے پہلے کہ یہ route handler تک پہنچے۔ یہ controller methods کی arguments پر کام کرتی ہیں — انہیں transform کرتے ہوئے (مثلاً string → number) یا انہیں validate کرتے ہوئے (غلط data کو مسترد کرتے ہوئے)۔ NestJS میں validation pipes پر بنایا گیا ہے۔
()
() {
..(id);
}
Transformation pipes input کو صحیح قسم میں تبدیل کرتی ہیں (route params/query ہمیشہ strings ہوتی ہیں)، اگر تبدیلی ممکن نہ ہو تو 400 کے ساتھ ناکام ہوتی ہیں۔
// 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
}));
// 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 کو پڑھتی ہے اور incoming data کو خودکار طور پر validate کرتی ہے — ناکامی پر تفصیلی 400 error واپس کرتے ہوئے، تاکہ آپ کا handler صرف valid data حاصل کرے۔
Request → ...middleware/guards/interceptors... → PIPES (transform/validate) → Handler
Pipes run JUST BEFORE the route handler, operating on its method arguments.
@Injectable()
export class TrimPipe implements PipeTransform {
transform(value: any) {
return typeof value === "string" ? value.trim() : value; // custom transformation
}
}
// usage: @Body(TrimPipe) ...
آپ custom validation/transformation logic کے لیے PipeTransform کے transform() method کو implement کرتے ہیں۔
@UsePipes(new ValidationPipe()) // method or controller level
@Param("id", ParseIntPipe) // parameter level
app.useGlobalPipes(new ValidationPipe()) // global (most common for validation)
Pipes NestJS کی ایک اہم خصوصیت ہیں input کو محفوظ طریقے سے handle کرنے کے لیے، اور یہ framework کے validation system کی بنیاد ہیں۔
انہیں سمجھنا ضروری ہے کیونکہ تقریباً ہر API endpoint کو input کو validate اور transform کرنا پڑتا ہے: transformation pipes (ParseIntPipe وغیرہ) یقینی بناتی ہیں کہ parameters صحیح قسم کی ہیں، اور — سب سے اہم بات — ValidationPipe DTOs کے ساتھ مل کر request bodies کی خودکار، declarative validation فراہم کرتا ہے class-validator rules کے خلاف، غلط یا malicious input کو واضح errors کے ساتھ مسترد کرتے ہوئے پہلے یہ آپ کی business logic تک پہنچے۔
یہ security (untrusted input کو validate/sanitize کرنا، غیر متوقع properties کو ہٹانا) اور robustness (handlers صرف valid data حاصل کرتے ہیں) دونوں کے لیے اہم ہے۔
Global validation pipe کو sensible options (whitelist, transform) کے ساتھ enable کرنا، built-in transformation pipes استعمال کرنا، اور custom pipes لکھنا جاننا محفوظ، اچھی طرح سے structured NestJS APIs بنانے کے لیے بنیادی ہے — pipes اور validation framework میں روزمرہ، لازمی معلوم ہونے والے concepts ہیں۔