NestJS मा DTOs के हुन्?

Question

Accepted Answer

एक **DTO (Data Transfer Object)** एक class हो जसले तपाईंको API मा पठाइने वा प्राप्त गरिने डेटाको **आकृति** परिभाषित गर्छ — सामान्यतः request body को संरचना। DTOs ले type safety प्रदान गर्छ, 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 एक सरल class हो जसले अपेक्षित डेटा वर्णन गर्छ, **validation decorators** (को साथ `class-validator` बाट) प्रत्येक field ले पूरा गर्नुपर्ने नियमहरू निर्दिष्ट गर्दै।

## एक 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 लाई 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 DTO को decorators को विरुद्ध आएको bodies लाई स्वचालित रूपमा validate गर्छ — validation असफल भएमा तपाईंको code चल्नुअघि 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 जानबूझकर database 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 pattern हो जसले type safety, स्पष्ट API अनुबंध, र स्वचालित validation तपाईंको endpoints मा ल्याउँछ।

तिनीहरूले परिभाषित गर्छन् कि एक endpoint कस्तो डेटा स्वीकार गर्छ (request को आकृति), तपाईंलाई compile-time typing दिइ र स्व-नथाङ्कित अनुबंध को रूपमा सेवा गर्छ।

मुख्य रूपमा, `class-validator` decorators र `ValidationPipe` सँग संयोजनमा, तिनीहरूले **स्वचालित input validation** सक्षम गर्छन् — गलत वा दुर्भावनापूर्ण requests तपाईंको business logic मा पहुँचनुअघि स्पष्ट त्रुटिहरू सँग अस्वीकार गरिन्छ, जो सुरक्षा र दृढता को लागि आवश्यक हो (को `whitelist` विकल्पले पनि अप्रत्याशित properties लाई हटाउँछ)।

DTOs बुझ्नु, validation नियमहरू कसरी जोड्ने, validation pipe कसरी सक्षम गर्ने, र **DTOs लाई database entities बाट अलग राख्ने** को महत्त्वपूर्ण सिद्धान्त (API अनुबंध लाई आन्तरिक storage बाट अलग गर्दै) सुरक्षित, राम्रो-संरचित, टिकाऊ NestJS APIs निर्माण गर्नको लागि मौलिक हो।

DTOs लगभग प्रत्येक endpoint मा प्रकट हुन्छन् जो input स्वीकार गर्छ, तिनीहरूलाई दैनिक, आवश्यक ज्ञान बनाइ।