NestJS ਵਿੱਚ DTOs ਕੀ ਹਨ?

Question

Accepted Answer

A **DTO (Data Transfer Object)** ਇੱਕ ਕਲਾਸ ਹੈ ਜੋ ਆਪਣੇ API ਨੂੰ ਭੇਜੇ ਜਾਂ ਪ੍ਰਾਪਤ ਕੀਤੇ ਗਏ ਡੇਟਾ ਦੀ **ਸ਼ਕਲ** ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੀ ਹੈ — ਆਮ ਤੌਰ ਤੇ ਇੱਕ ਬੇਨਤੀ ਬਾਡੀ ਦਾ ਢਾਂਚਾ। DTOs ਕਿਸਮ ਦੀ ਸੁਰੱਖਿਆ ਪ੍ਰਦਾਨ ਕਰਦੇ ਹਨ, ਐਂਡਪੁਆਇੰਟਾਂ ਲਈ ਇੱਕ ਸਪੱਸ਼ਟ ਇਕਰਾਰਨਾਮੇ ਦੇ ਤੌਰ ਤੇ ਕੰਮ ਕਰਦੇ ਹਨ, ਅਤੇ (validation decorators ਦੇ ਨਾਲ) خودکار ਇਨਪੁਟ 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` ਤੋਂ) ਜੋ ਨਿਯਮਾਂ ਨੂੰ ਨਿਰਧਾਰਤ ਕਰਦੇ ਹਨ ਜੋ ਹਰੇਕ ਖੇਤਰ ਨੂੰ ਪੂਰਾ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ।

## ਇੱਕ controller ਵਿੱਚ 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 ਨੂੰ ਟਾਈਪ ਕਰਦਾ ਹੈ ਅਤੇ — validation pipe ਸਮਰਥ ਹੋਣ ਨਾਲ — ਆਪਣੇ handler ਤੋਂ ਪਹਿਲਾਂ ਇਸ ਨੂੰ خودکار ਤੌਰ ਤੇ validate ਕਰਦਾ ਹੈ।

## Automatic 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 ਕਰਦਾ ਹੈ — 400 ਗਲਤੀ ਵਾਪਸ ਕਰਦਾ ਹੈ ਜੇ validation ਫੇਲ ਹੋ ਜਾਵੇ, ਆਪਣੇ ਕੋਡ ਤੋਂ ਪਹਿਲਾਂ۔

## DTOs vs 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 intentionally database entities ਤੋਂ ਵੱਖਰੇ ਹਨ — ਉਹ ਦਰਸਾਉਂਦੇ ਹਨ ਕਿ API ਕੀ ਸਵੀਕਾਰ/ਵਾਪਸ ਕਰਦਾ ਹੈ، ਅੰਦਰੂਨੀ storage ਤੋਂ ਵੱਖ।

## Variations ਅਤੇ reuse

```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 ਪੈਟਰਨ ਹਨ ਜੋ ਆਪਣੇ endpoints ਨੂੰ کیلئے type safety، سپاف API contracts، ਅਤੇ automatic validation ਲਿਆਉਂਦਾ ਹੈ۔

ਉਹ ਬਿਲਕੁਲ ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੇ ਹਨ ਕਿ endpoint ਕਿਹੜਾ ڈیٹا ਸਵੀਕਾਰ ਕਰਦਾ ਹੈ (request shape)، ਤੁਹਾਨੂੰ compile-time typing ਅਤੇ self-documenting contracts ਦੇ ਤੌਰ تے ਪ੍ਰਦਾਨ ਕਰਦੇ ہیں۔

مہم طور پر، `class-validator` decorators ਅਤੇ `ValidationPipe` ਦੇ ਨਾਲ ملا کر، وہ **automatic input validation** ਨੂੰ سماہ بناتے ہیں — غلط FileInputStream یا harmful requests ਸپاف غلطیاں ہٹا کر reject کیے جاتے ہیں *آپکے business logic تک پہنچنے سے پہلے*، جو security ਅਤے robustness کے لیے ضروری ہے (یہ `whitelist` option غیر متوقع properties کو بھی ہٹاتا ہے)۔

DTOs ਨੂੰ سمجھنا، کیسے validation rules شامل کریں، کیسے validation pipe کو سماہ بنائیں، اور اہم اصول کہ **DTOs کو database entities سے علیحدہ رکھیں** (API contract کو internal storage سے decoupled رکھیں) بنیادی ہے محفوظ, منطقی, برقرار NestJS APIs تعمیر کرنے کے لیے۔

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