NestJS-এ DTO গুলি কি?

Question

Accepted Answer

একটি **DTO (Data Transfer Object)** হল একটি ক্লাস যা আপনার API-তে পাঠানো বা প্রাপ্ত ডেটার **আকৃতি** সংজ্ঞায়িত করে — সাধারণত একটি অনুরোধ বডির কাঠামো। DTO গুলি টাইপ সেফটি প্রদান করে, এন্ডপয়েন্টগুলির জন্য একটি স্পষ্ট চুক্তি হিসাবে কাজ করে এবং (যাচাইকরণ ডেকোরেটর সহ) স্বয়ংক্রিয় ইনপুট যাচাইকরণ সক্ষম করে।

## একটি 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-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` অনুরোধ বডিকে টাইপ করে এবং — যাচাইকরণ পাইপ সক্ষম হলে — আপনার হ্যান্ডলার চালানোর আগে স্বয়ংক্রিয়ভাবে এটি যাচাই করে।

## স্বয়ংক্রিয় যাচাইকরণ সক্ষম করা

```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-র ডেকোরেটরগুলির বিরুদ্ধে আসন্ন বডিগুলি স্বয়ংক্রিয়ভাবে যাচাই করে — যাচাইকরণ ব্যর্থ হলে 400 ত্রুটি বিবরণ সহ ফেরত দেয়, আপনার কোড চলার আগে।

## DTO বনাম Entity

```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.)
```

DTO গুলি ইচ্ছাকৃতভাবে ডেটাবেস সত্তা থেকে আলাদা — তারা API যা গ্রহণ/ফেরত দেয় তা প্রতিনিধিত্ব করে, অভ্যন্তরীণ সঞ্চয়স্থান থেকে বিচ্ছিন্ন।

## বৈচিত্র্য এবং পুনর্ব্যবহার

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

## এটি কেন গুরুত্বপূর্ণ

DTO গুলি একটি গুরুত্বপূর্ণ NestJS প্যাটার্ন যা আপনার এন্ডপয়েন্টগুলিতে টাইপ সেফটি, স্পষ্ট API চুক্তি এবং স্বয়ংক্রিয় যাচাইকরণ নিয়ে আসে।

তারা সংজ্ঞায়িত করে যে একটি এন্ডপয়েন্ট কী ডেটা গ্রহণ করে (অনুরোধের আকৃতি), আপনাকে সংকলন-সময়ের টাইপিং প্রদান করে এবং স্ব-নথিভুক্ত চুক্তি হিসাবে কাজ করে।

সবচেয়ে গুরুত্বপূর্ণভাবে, `class-validator` ডেকোরেটর এবং `ValidationPipe` এর সাথে মিলিত হয়ে, তারা **স্বয়ংক্রিয় ইনপুট যাচাইকরণ** সক্ষম করে — বিকৃত বা ক্ষতিকর অনুরোধগুলি স্পষ্ট ত্রুটিগুলির সাথে প্রত্যাখ্যান করা হয় *আপনার ব্যবসায়িক লজিক পৌঁছানোর আগে*, যা নিরাপত্তা এবং শক্তিশালীতার জন্য অপরিহার্য (the `whitelist` অপশন অপ্রত্যাশিত বৈশিষ্ট্যগুলিও সরিয়ে দেয়)।

DTO গুলি কীভাবে বুঝতে হয়, কীভাবে যাচাইকরণ নিয়মগুলি যোগ করতে হয়, কীভাবে যাচাইকরণ পাইপ সক্ষম করতে হয় এবং **ডেটাবেস সত্তা থেকে DTO গুলি আলাদা রাখার** গুরুত্বপূর্ণ নীতি (API চুক্তি এবং অভ্যন্তরীণ সঞ্চয়স্থান বিচ্ছিন্ন করা) সুরক্ষিত, সুসংগঠিত, রক্ষণাবেক্ষণযোগ্য NestJS API তৈরির জন্য মৌলিক।

DTO গুলি প্রায় প্রতিটি এন্ডপয়েন্টে যা ইনপুট গ্রহণ করে তা প্রদর্শিত হয়, যা তাদের দৈনন্দিন, অপরিহার্য জ্ঞান করে তোলে।