Kina kake aiki da abubuwan ƙarewa masu kamata?

Question

Accepted Answer

NestJS yana baka damar aiwatar da **abubuwan ƙarewa masu kamata** domin kudde abubuwan aiki da zai iya sake amfani da su — mafi yawa **abubuwan ƙarewa na sigar jinjirwa** (don cire bayanan daga buƙatu) da **abubuwan ƙarewa na bayani** (don haɗa bayanan da masu kulla/masu hana zai iya karantawa). Suna ajiye kalantar ƙirja da saurin gabatarwa.

## Abubuwan ƙarewa na jinjirwa masu kamata — cire bayanan buƙatu

```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` yana gina abubuwan ƙarewa na sigar jinjirwa: aikinsa yana karɓa `ExecutionContext`, yana cire bayanan, kuma yana mai da kimar zuwa buɗe. Wannan yana maye gurbin maimaita `@Req() req` + `req.user` samun bayanan tare da cikakken, zai iya sake amfani da `@CurrentUser()`.

## Abubuwan ƙarewa na jinjirwa tare da jigogi

```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
```

## Abubuwan ƙarewa na bayani masu kamata (domin masu kulla/masu hana su karantawa)

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

Taɗi na `@Roles()` + `RolesGuard` — abubuwan ƙarewa na bayani da masu kulla suka karantawa ta hanyar `Reflector` — shine buƙatun tsarin gida don haɗin kamata bisa jeri.

## Hada abubuwan ƙarewa

```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
```

## Me ya sa haka mahimmaci

Aiwatar da abubuwan ƙarewa masu kamata muhimmiyar fasaha ce ta NestJS domin ajiye kalantar ƙirja, saurin gabatarwa, da trewa. **Abubuwan ƙarewa na jinjirwa masu kamata** (`createParamDecorator`) suka ba ka damar kudde bayanan da aka saba samun daga buƙatu (kamar `@CurrentUser()`) zuwa sauki, zai iya sake amfani da gabatarwa — m gida fiye da maimaita `@Req() req` da buƙata cikin aiki a kowane hanyar. **Abubuwan ƙarewa na bayani masu kamata** (`SetMetadata`) sune tushen tsarina ta NestJS na baiwa izini: ta damina `@Roles()` + `RolesGuard` (karantawa ta hanyar `Reflector`) hanya domin sarƙon samun dama bisa jeri ta girma jajere kan fahimtar bayani masu ƙarewa.
"]kuma **hada abubuwan ƙarewa** (`applyDecorators`) yana baka damar haɗa abubuwan ƙarewa da alaƙa (misali `@Auth()` wanda ke aika masu kulla da bayani juna) don tambajtawa, daidai amfani.

Fahimta ta nawa ake aiwatar da waɗannan da zai baka damar gina NestJS APIs da jike tsari masu nuni (sunan masu amfani buɗewa, RBAC) ta hanyar da tsarin yana son — ƙwarewar kamata, da aka yi amfani a aiki da yawa a ƙwaƙwar abubuwan NestJS.

Zai tashi maka daga amfani kawai da abubuwan ƙarewa da aka gina zuwa tseron tsarin karantarwa ta hanyar kayi kalma gida ga bukunan aikinka — ƙwarewar da ta kira jiya, da aka yi amfani a aiki a yawa a ainihin abubuwan NestJS.