Kaj so DTOs v NestJS?

Question

Accepted Answer

**DTO (Data Transfer Object)** je razred, ki definira **obliko podatkov** poslanih v ali iz vašega API-ja — običajno strukturo telesa zahtevka. DTOs zagotavljajo varnost tipov, služijo kot jasen pogodba za končne točke in (z validacijskimi dekoratorji) omogočajo avtomatsko validacijo vnosa.

## Definiranje DTO-ja

```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 preprost razred, ki opisuje pričakovane podatke, z **validacijskimi dekoratorji** (iz `class-validator`) z navedbo pravil, ki jih mora zadostiti vsako polje.

## Uporaba DTO-ja v nadzorniku

```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 telo zahtevka in — z omogočenim validacijskim cevovodom — ga samodejno validira, preden se zažene vaš behandler.

## Omogočanje avtomatske 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
}));
```

Z `ValidationPipe` NestJS samodejno validira dohodna telesa glede na dekoratorje DTO-ja — pri napaki validacije vrne napako 400 s podrobnostmi, preden se zažene vaša koda.

## DTOs v primerjavi z entitetami

```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 namenoma razlikujejo od entitet podatkovne baze — predstavljajo tisto, kar API sprejme/vrne, ločeno od notranje shrambe.

## Variacije in ponovno uporabe

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

## Zakaj je to pomembno

DTOs so pomemben vzorec NestJS, ki vašim končnim točkam prinaša varnost tipov, jasne pogodbe API-ja in avtomatsko validacijo.

Definiraj točno, katere podatke končna točka sprejme (oblika zahtevka), kar ti daje tipizacijo med prevajanjem in služi kot samodokumentirajoča se pogodba.

Krucialno je, da so v kombinaciji z `class-validator` dekoratorji in `ValidationPipe` omogočena **avtomatska validacija vnosa** — slabo oblikovane ali zlonamerne zahtevke zavrnejo z jasnimi napakami *preden* dosežejo vašo poslovnologiko, kar je bistveno za varnost in robustnost (možnost `whitelist` tudi odstrани nepričakovana svojstva).

Razumevanje DTOs-ov, kako dodati pravila validacije, kako omogočiti cevovod validacije in pomembnega načela **ločevanja DTOs-ov od entitet podatkovne baze** (ločevanja pogodbe API-ja od notranje shrambe) je temeljno za gradnjo varnih, dobro strukturiranih in vzdržljivih NestJS API-jev.

DTOs se pojavljajo v praktično vsaki končni točki, ki sprejme vnos, kar jih dela vsakodnevno, bistveno znanje.