NestJS میں DTOs کیا ہیں؟

Question

Accepted Answer

ایک **DTO (Data Transfer Object)** ایک کلاس ہے جو آپ کے API کو بھیجے یا حاصل کیے جانے والے ڈیٹا کی **شکل** کی تعریف کرتی ہے — عام طور پر request body کی ساخت۔ DTOs قسم کی حفاظت فراہم کرتے ہیں، endpoints کے لیے ایک واضح معاہدہ کے طور پر کام کرتے ہیں، اور (validation decorators کے ساتھ) خودکار input validation کو فعال کرتے ہیں۔

## DTO کی تعریف

```ts
import { IsEmail, IsString, MinLength, IsOptional, IsInt, Min } from "class-validator";

export class CreateUserDto {
  @IsEmail()                    // must be a valid email
  email: string;

@IsString()
  @MinLength(8)                 // password at least 8 chars
  password: string;

@IsOptional()                 // optional field
  @IsInt()
  @Min(0)
  age?: number;
}
```

ایک DTO متوقع ڈیٹا کی تفصیل دینے والی ایک سادہ کلاس ہے، جس میں **validation decorators** (`class-validator` سے) ہر فیلڈ کو پورا کرنے والے قوانین کی نشاندہی کرتے ہیں۔

## ایک کنٹرولر میں DTO استعمال کرنا

```ts
@Post()
create(@Body() dto: CreateUserDto) {     // the body is typed AND validated as CreateUserDto
  // dto is guaranteed to be valid here (with the validation pipe enabled)
  return this.usersService.create(dto);
}
```

`@Body() dto: CreateUserDto` request body کو type کرتا ہے اور — validation pipe فعال ہونے کے ساتھ — آپ کے handler سے پہلے اسے خودکار طور پر validate کرتا ہے۔

## خودکار validation کو فعال کرنا

```ts
// main.ts — turn on the global validation pipe
app.useGlobalPipes(new ValidationPipe({
  whitelist: true,              // strip properties NOT in the DTO (security)
  forbidNonWhitelisted: true,   // reject requests with extra unknown properties
  transform: true,              // auto-transform payloads to DTO instances + convert types
}));
```

`ValidationPipe` کے ساتھ، NestJS incoming bodies کو DTO کے decorators کے خلاف خودکار طور پر validate کرتا ہے — اگر validation ناکام ہو تو تفصیلات کے ساتھ 400 کی خرابی واپس کرتا ہے، آپ کے کوڈ سے پہلے۔

## DTOs بمقابلہ Entities

```text
DTO    → the shape of data crossing the API boundary (request/response contract)
Entity → the database model (e.g. a TypeORM entity / Prisma model)
→ Keep them SEPARATE: the API contract shouldn't be coupled to the DB schema.
  (A CreateUserDto has password+email; the User entity has id, timestamps, etc.)
```

DTOs جان بوجھ کر ڈیٹابیس entities سے مختلف ہیں — وہ اس بات کی نمائندگی کرتے ہیں کہ API کیا قبول/واپس کرتا ہے، داخلی storage سے الگ۔

## تغیرات اور دوبارہ استعمال

```ts
import { PartialType } from "@nestjs/mapped-types";
// derive an UpdateUserDto where all fields are optional — no duplication
export class UpdateUserDto extends PartialType(CreateUserDto) {}
```

## اہم کیوں ہے

DTOs ایک اہم NestJS نمونہ ہے جو قسم کی حفاظت، واضح API معاہدے، اور خودکار validation کو آپ کے endpoints میں لاتا ہے۔

یہ بالکل تعریف کرتے ہیں کہ کون سا ڈیٹا ایک endpoint قبول کرتا ہے (request کی شکل)، آپ کو compile-time typing اور self-documenting معاہدے کے طور پر کام کرتے ہوئے۔

اہم بات یہ ہے کہ، `class-validator` decorators اور `ValidationPipe` کے ساتھ ملا کر، وہ **خودکار input validation** کو فعال کرتے ہیں — غلط شدہ یا بدنیتی والی requests کو واضح errors کے ساتھ مسترد کیا جاتا ہے *پہلے* آپ کے business logic تک پہنچنے سے، جو حفاظت اور مضبوطی کے لیے ضروری ہے (`whitelist` آپشن غیر متوقع properties کو بھی ہٹاتا ہے)۔

DTOs کو سمجھنا، کس طرح validation rules شامل کریں، validation pipe کو کیسے فعال کریں، اور **DTOs کو database entities سے الگ رکھنے** کا اہم اصول (API معاہدے کو داخلی storage سے الگ کرنا) محفوظ، اچھی طریقے سے ساخت والے، قابل برقراری NestJS APIs بنانے کے لیے بنیادی ہے۔

DTOs تقریباً ہر endpoint میں ظاہر ہوتے ہیں جو input قبول کرتے ہیں، انہیں روزمرہ، ضروری علم بناتے ہوئے۔