X'inhu DTOs f'NestJS?

Question

Accepted Answer

A **DTO (Data Transfer Object)** huwa klassi li tiddefinisci l-**forma tad-dejta** li titmanda jew tiġi mandata mill-API tiegħek — tipikament l-istruttura ta' request body. DTOs jipprovdu type safety, jisservu bħala kuntratt ċar għall-endpoints, u (bl-validation decorators) jippermettu l-validazzjoni awtomatika ta' input.

## Tiddefinizzjoni ta' 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;
}
```

A DTO huwa klassi sempliċi li tiddeskrivi l-ejta mistennija, b'**validation decorators** (minn `class-validator`) li jispeċifikaw ir-regoli li kull field iridu jissodisfu.

## L-użu ta' DTO f'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);
}
```

The `@Body() dto: CreateUserDto` tittipiza l-request body u — b'validation pipe mmikkit — awtomatikament tavalidja qabel ma jitħaddem l-handler tiegħek.

## L-attivazzjoni tal-validazzjoni awtomatika

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

B' `ValidationPipe`, NestJS tavalidja l-incoming bodies kontra d-decorators tal-DTO awtomatikament — u tirritorna 400 error bi dettalji jekk il-validazzjoni tiksu, qabel ma jitħaddem il-kodiċi tiegħek.

## 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 intenzjonalment jidifferenzjaw minn database entities — jirrappreżentaw dak li l-API jaċċetta/jirritorna, separati mill-ħażna interna.

## Varjazzjonijiet u ri-użu

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

## Għaliex hija importanti

DTOs huma pattern importanti f'NestJS li jġibu type safety, kuntratti ta' API ċari, u validazzjoni awtomatika għall-endpoints tiegħek.

Jiddefinizzjaw eżattament x'ejta endpoint jaċċetta (il-forma tal-request), jagħtuk typing tal-compile-time u jisservu bħala kuntratti li jindokumentaw lilhom infushom.

B'mod kruċjali, kombinati ma' `class-validator` decorators u l-`ValidationPipe`, jippermettu **validazzjoni awtomatika ta' input** — irrikesti malformati jew malijziużi huma rrifjutati bi errors ċari *qabel* ma jilħqu l-logika tan-negozju tiegħek, li huwa essenzjali għas-sigurtà u r-robustezza (l-opciju `whitelist` jneħħi wkoll properties inaspettati).
". L-għarifa ta' DTOs, kif tinnexxi regoli ta' validazzjoni, kif taattiva l-validation pipe, u l-prinċipju importanti ta' **żamma ta' DTOs separati minn database entities** (separazzjoni tal-kuntratt ta' API mill-ħażna interna) huwa fundamentali għall-kostruzzjoni ta' APIs NestJS siguri, strutturati tajjeb, u mantenut tajjeb.

DTOs jidhru fi virtwalment kull endpoint li jaċċetta input, li jagħmilhom ilmu kwotidjan u essenzjali.