NestJS मध्ये DTOs म्हणजे काय?

Question

Accepted Answer

A **DTO (Data Transfer Object)** हा एक क्लास आहे जो आपल्या API ला पाठवलेला किंवा मिळवलेला डेटा — सामान्यतः विनंती मुख्यभाग (request body) — यांचा **आकार** परिभाषित करतो. DTOs प्रकार सुरक्षा प्रदान करतात, endpoints साठी एक स्पष्ट करार म्हणून काम करतात, आणि (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 चालू होण्यापूर्वी स्वयंचलितपणे त्याची proof करते.

## स्वयंचलित 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 विरुद्ध स्वयंचलितपणे proof करते — validation अपयशी झाल्यास 400 त्रुटी तपशील सह परत करते, आपला कोड चालू होण्यापूर्वी.

## 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 जाणूनबुझून डेटाबेस entities पेक्षा भिन्न आहेत — ते API कबूल करतो/परत करतो हे प्रतिनिधित्व करतात, अंतर्गत संचयनापासून स्वतंत्र.

## भिन्नता आणि पुनरावृत्ती

```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 कबूल करतो (विनंती आकार) परिभाषित करतात, आपल्याला compile-time typing देतात आणि स्व-दस्तऐवजीकरण करार म्हणून काम करतात.

महत्वाचे म्हणून, `class-validator` decorators आणि `ValidationPipe` सह एकत्रित, ते **स्वयंचलित इनपुट validation** सक्षम करतात — विकृत किंवा दुर्भावनापूर्ण विनंती स्पष्ट त्रुटीसह नाकारली जातात *आपल्या व्यावसायिक तर्कांपूर्वी*, जो सुरक्षा आणि दृढपणा ("whitelist" पर्याय अप्रत्याशित गुणधर्म काढून टाकते) साठी आवश्यक आहे.

DTOs कसे परिभाषित करायचे, validation नियम कसे जोडायचे, validation pipe कसे सक्षम करायचे, आणि **DTOs डेटाबेस entities पेक्षा वेगळे ठेवण्याचे** महत्वाचे तत्व (API करार अंतर्गत संचयनापासून decoupling) समजणे हे सुरक्षित, सुसंरचित, टिकाऊ NestJS APIs बांधण्यासाठी मूलभूत आहे.

DTOs अक्षरशः प्रत्येक endpoint मध्ये दिसतात जो इनपुट कबूल करतो, त्यांना दैनंदिन, आवश्यक ज्ञान बनवतो.