Što su DTOs u NestJS-u?

Question

Accepted Answer

**DTO (Data Transfer Object)** je klasa koja definira **oblik podataka** poslanih na ili s vašeg API-ja — obično strukturu tijela zahtjeva. DTOs pružaju sigurnost tipova, služe kao jasna ugovora za endpointe i (s dekoratorima za validaciju) omogućavaju automatsku validaciju ulaza.

## Definiranje DTO-a

```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 je obična klasa koja opisuje očekivane podatke, s **dekoratorima za validaciju** (iz `class-validator`) koji određuju pravila koja svako polje mora zadovoljiti.

## Korištenje DTO-a u kontroleru

```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` tipizira tijelo zahtjeva i — s omogućenom validation pipe — automatski ga validira prije nego što se vaš handler izvrši.

## Omogućavanje automatske validacije

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

S `ValidationPipe`, NestJS automatski validira dolazna tijela prema dekoratorima DTO-a — vraćajući grešku 400 s detaljima ako validacija ne uspije, prije nego što se vaš kod izvrši.

## DTOs u odnosu na entitete

```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 se namjerno razlikuju od entiteta baze podataka — oni predstavljaju što API prihvaća/vraća, odvojeno od interne pohrane.

## Varijacije i ponovno korištenje

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

## Zašto je važno

DTOs su važan NestJS obrazac koji donosi sigurnost tipova, jasne API ugovore i automatsku validaciju vašim endpointima.

Oni točno definiraju koje podatke endpoint prihvaća (oblik zahtjeva), dajući vam tipizaciju tijekom kompajliranja i služeći kao samoobjašnjavajući ugovori.

Krucijalno, u kombinaciji s `class-validator` dekoratorima i `ValidationPipe`, omogućavaju **automatsku validaciju ulaza** — loše oblikovani ili zlonamjerni zahtjevi se odbacuju s jasnim greškama *prije* nego što stignu do vaše poslovne logike, što je ključno za sigurnost i robusnost (opcija `whitelist` također uklanja neočekivana svojstva).

Razumijevanje DTOs-a, kako dodati pravila validacije, kako omogućiti validation pipe i važan princip **čuvanja DTOs-a odvojenih od entiteta baze podataka** (odvajanje API ugovora od interne pohrane) temeljna je za izgradnju sigurnih, dobro strukturiranih, održivih NestJS API-ja.

DTOs se pojavljuju u gotovo svakom endpointu koji prihvaća ulaz, što ih čini svakodnevnim, bitnim znanjem.