Çfarë janë DTOs në NestJS?

Question

Accepted Answer

Një **DTO (Data Transfer Object)** është një klasë që përcakton **formën e të dhënave** të dërguara drejt ose nga API-ja juaj — zakonisht struktura e një request body. DTOs ofrojnë sigurinë e tipave, shërbejnë si një kontratë e qartë për endpoints, dhe (me dekoratorë validimi) mundësojnë validimin automatik të inputit.

## Përcaktimi i një 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;
}
```

Një DTO është një klasë e thjeshtë që përshkruan të dhënat e pritura, me **dekoratorë validimi** (nga `class-validator`) që specifikojnë rregullat që secili fushë duhet të plotësojë.

## Përdorimi i një DTO në një kontroller

```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` tipizon request body-n dhe — me validation pipe të aktivizuar — automatikisht e validizon atë përpara se handler-i juaj të ekzekutohet.

## Aktivizimi i validimit automatik

```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
}));
```

Me `ValidationPipe`, NestJS validizon automatikisht incoming bodies kundër dekoratorëve të DTO-s — duke kthyer një gabim 400 me detaje nëse validimi dështon, përpara se kodi juaj të ekzekutohet.

## 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 qëllimisht ndryshojnë nga entitetet e bazës së të dhënave — ato përfaqësojnë atë që API-ja pranon/kthen, të decoupled nga ruajtja e brendshme.

## Variacionet dhe riperdorimi

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

## Pse është e rëndësishme

DTOs janë një model i rëndësishëm i NestJS-it që sjell sigurinë e tipave, kontrata të qarta të API-s, dhe validim automatik në endpoints-at tuaj.

Ata përcaktojnë saktësisht çfarë të dhënash pranon një endpoint (forma e request-it), duke ju dhënë dizajnim në kohën e kompilimit dhe duke shërbyer si kontrata vetë-dokumentuese.

Crucially, në kombinim me dekoratorë `class-validator` dhe `ValidationPipe`, ato mundësojnë **validimin automatik të inputit** — request-et e formuar gabim ose kërcënuese refuzohen me gabime të qarta *përpara* se të arrijnë logjikën tuaj të biznesit, që është thelbësor për sigurinë dhe qëndrueshmërinë (opsioni `whitelist` gjithashtu heq vetitë e papritura).

Kuptimi i DTOs, se si të shtoni rregulla validimi, se si të aktivizoni validation pipe, dhe parim i rëndësishëm i **ndarjes së DTOs nga entitetet e bazës së të dhënave** (decoupling i kontratës API-s nga ruajtja e brendshme) është themelor për ndërtimin e API-ve NestJS të sigurta, të strukturuara mirë dhe të maintainable-a.

DTOs shfaqen në praktikisht çdo endpoint që pranon input, duke i bërë ato njohuri të përditshme, të domosdoshme.