Πώς δημιουργείς custom decorators;

Question

Accepted Answer

Το NestJS σας επιτρέπει να δημιουργήσετε **custom decorators** για να ενσωματώσετε επαναχρησιμοποιήσιμη λογική — συνηθέστερα **parameter decorators** (για εξαγωγή δεδομένων από το request) και **metadata decorators** (για προσάρτηση δεδομένων που διαβάζονται από guards/interceptors). Διατηρούν τον κώδικα DRY και εκφραστικό.

## Custom parameter decorator — εξαγωγή δεδομένων από το request

```ts
import { createParamDecorator, ExecutionContext } from "@nestjs/common";

// extract the authenticated user (attached to the request by an auth guard)
export const CurrentUser = createParamDecorator(
  (data: unknown, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest();
    return request.user;        // return whatever you want injected
  },
);

// usage — clean and readable
@Get("profile")
getProfile(@CurrentUser() user: User) {     // instead of @Req() req and req.user
  return user;
}
```

Το `createParamDecorator` κατασκευάζει ένα parameter decorator: η συνάρτησή του λαμβάνει το `ExecutionContext`, εξάγει δεδομένα και επιστρέφει την τιμή που θα εγχυθεί. Αυτό αντικαθιστά την επαναλαμβανόμενη χρήση `@Req() req` + `req.user` με ένα καθαρό, επαναχρησιμοποιήσιμο `@CurrentUser()`.

## Parameter decorator με ορίσματα

```ts
// extract a specific property: @CurrentUser("email")
export const CurrentUser = createParamDecorator(
  (data: string, ctx: ExecutionContext) => {
    const user = ctx.switchToHttp().getRequest().user;
    return data ? user?.[data] : user;   // `data` is the argument passed to the decorator
  },
);
// @CurrentUser("email") email: string  → injects just user.email
```

## Custom metadata decorator (για guards/interceptors να διαβάσουν)

```ts
import { SetMetadata } from "@nestjs/common";

// a @Roles() decorator that ATTACHES metadata to a route
export const Roles = (...roles: string[]) => SetMetadata("roles", roles);

// usage
@Roles("admin", "editor")
@Get("users")
listUsers() {}
```

```ts
// a guard reads the metadata via Reflector
@Injectable()
export class RolesGuard implements CanActivate {
  constructor(private reflector: Reflector) {}
  canActivate(ctx: ExecutionContext): boolean {
    const roles = this.reflector.get<string[]>("roles", ctx.getHandler());   // read it
    const { user } = ctx.switchToHttp().getRequest();
    return !roles || roles.some(r => user.roles?.includes(r));
  }
}
```

Ο συνδυασμός `@Roles()` + `RolesGuard` — ένα metadata decorator που ένα guard διαβάζει μέσω `Reflector` — είναι το κανονικό pattern για επιχειρηματική εξουσιοδότηση ভিত্তিক σε ρόλους.

## Σύνθεση decorators

```ts
import { applyDecorators } from "@nestjs/common";
// bundle multiple decorators into one reusable decorator
export function Auth(...roles: string[]) {
  return applyDecorators(SetMetadata("roles", roles), UseGuards(AuthGuard, RolesGuard));
}
// usage: @Auth("admin")  — applies metadata + guards in one decorator
```

## Γιατί είναι σημαντικό

Η δημιουργία custom decorators είναι μια σημαντική τεχνική του NestJS για να διατηρήσετε τον κώδικα DRY, εκφραστικό και συντηρήσιμο. Τα **custom parameter decorators** (`createParamDecorator`) σας επιτρέπουν να ενσωματώσετε συνήθη εξαγωγή δεδομένων από το request (όπως το `@CurrentUser()`) σε καθαρές, επαναχρησιμοποιήσιμες σχολιάσεις — πολύ καλύτερο από το να επαναλαμβάνετε `@Req() req` και να σκάβετε στο αντικείμενο του request σε κάθε handler. Τα **custom metadata decorators** (`SetMetadata`) είναι το θεμέλιο των authorization patterns του NestJS: η πρότυπη προσέγγιση `@Roles()` + `RolesGuard` (διαβάσιμη μέσω `Reflector`) για role-based access control εξαρτάται εντελώς από την κατανόηση των metadata decorators.

Και η **σύνθεση decorators** (`applyDecorators`) σας επιτρέπει να δεσμεύσετε σχετικά decorators (π.χ. ένα `@Auth()` που εφαρμόζει guards και metadata μαζί) για συνοπτική, συνεπή εφαρμογή.

Η κατανόηση του πώς να δημιουργήσετε αυτά είναι αυτό που σας επιτρέπει να κατασκευάσετε εκφραστικά, idiomatικά NestJS APIs και να εφαρμόσετε συνήθη patterns (current-user injection, RBAC) με τον τρόπο που προτίθεται το framework. Σας ανυψώνει από το απλό χρήση των ενσωματωμένων decorators στην επέκταση του δηλωτικού στυλ του framework για τις ανάγκες της δικής σας εφαρμογής — μια πολύτιμη, συχνά εφαρμοζόμενη δεξιότητα στα πραγματικά projects του NestJS.