Τι είναι DTOs στο NestJS;

Question

Accepted Answer

Ένα **DTO (Data Transfer Object)** είναι μια κλάση που ορίζει το **σχήμα δεδομένων** που αποστέλλονται προς ή από το API σας — συνήθως την δομή ενός request body. Τα DTOs παρέχουν type safety, χρησιμεύουν ως σαφές συμβόλαιο για τα endpoints, και (με validation decorators) ενεργοποιούν αυτόματη επικύρωση εισόδου.

## Ορισμός ενός 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`) που προσδιορίζουν τους κανόνες που πρέπει να ικανοποιήσει κάθε πεδίο.

## Χρήση ενός DTO σε έναν controller

```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 σας.

## Ενεργοποίηση αυτόματης επικύρωσης

```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 επικυρώνει τα εισερχόμενα bodies σύμφωνα με τους decorators του DTO αυτόματα — επιστρέφοντας ένα σφάλμα 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 διαφέρουν σκόπιμα από τις database 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 είναι ένα σημαντικό pattern του NestJS που φέρνει type safety, σαφή API contracts, και αυτόματη επικύρωση στα endpoints σας.

Ορίζουν ακριβώς τι δεδομένα δέχεται ένα endpoint (το σχήμα του request), δίνοντάς σας compile-time typing και χρησιμεύοντας ως αυτο-τεκμηριώνοντα συμβόλαια.

Σημαντικά, σε συνδυασμό με `class-validator` decorators και το `ValidationPipe`, ενεργοποιούν **αυτόματη επικύρωση εισόδου** — τα ακατάλληλα ή κακόβουλα requests απορρίπτονται με σαφή σφάλματα *πριν* φτάσουν στη business logic σας, κάτι που είναι ουσιώδες για την ασφάλεια και την ευρωστία (η επιλογή `whitelist` αφαιρεί και τις απροσδόκητες ιδιότητες).

Η κατανόηση των DTOs, τον τρόπο προσθήκης κανόνων επικύρωσης, τον τρόπο ενεργοποίησης του validation pipe, και την σημαντική αρχή του **διαχωρισμού των DTOs από τις database entities** (ανεξαρτητοποίηση του API contract από την εσωτερική αποθήκευση) είναι θεμελιώδης για την κατασκευή ασφαλών, καλά δομημένων, συντηρήσιμων NestJS APIs.

Τα DTOs εμφανίζονται σχεδόν σε κάθε endpoint που δέχεται εισόδο, καθιστώντας τα καθημερινή, ουσιώδη γνώση.