آپ کسٹم ڈیکوریٹرز کو کیسے بناتے ہیں؟

Question

Accepted Answer

NestJS آپ کو **کسٹم ڈیکوریٹرز** بنانے کی سہولت دیتا ہے تاکہ دوبارہ استعمال ہونے والی منطق کو محفوظ کیا جا سکے — اکثر **پیرامیٹر ڈیکوریٹرز** (درخواست سے ڈیٹا نکالنے کے لیے) اور **میٹا ڈیٹا ڈیکوریٹرز** (گارڈز/انٹرسیپٹرز کے ذریعے پڑھے جانے والے ڈیٹا کو منسلک کرنے کے لیے)۔ یہ کوڈ کو DRY رکھتے ہیں اور اسے واضح بناتے ہیں۔

## کسٹم پیرامیٹر ڈیکوریٹر — درخواست سے ڈیٹا نکالیں

```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` ایک پیرامیٹر ڈیکوریٹر بناتا ہے: اس کی تقریب کو `ExecutionContext` ملتا ہے، ڈیٹا نکالتا ہے، اور انجیکٹ کرنے کے لیے قیمت واپس کرتا ہے۔ یہ بار بار `@Req() req` + `req.user` رسائی کو صاف، دوبارہ استعمال ہونے والے `@CurrentUser()` سے بدل دیتا ہے۔

## دلائل کے ساتھ پیرامیٹر ڈیکوریٹر

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

## کسٹم میٹا ڈیٹا ڈیکوریٹر (گارڈز/انٹرسیپٹرز کے لیے پڑھنے کے لیے)

```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` کا امتزاج — ایک میٹا ڈیٹا ڈیکوریٹر جو گارڈ `Reflector` کے ذریعے پڑھتا ہے — کردار پر مبنی اختیار کے لیے منونیاتی نمونہ ہے۔

## ڈیکوریٹرز کو ملانا

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

## یہ کیوں اہم ہے

کسٹم ڈیکوریٹرز بنانا NestJS میں کوڈ کو DRY، واضح، اور برقرار رکھنے کی ایک اہم تکنیک ہے۔ **کسٹم پیرامیٹر ڈیکوریٹرز** (`createParamDecorator`) آپ کو عام درخواست ڈیٹا نکالنے (جیسے `@CurrentUser()`) کو صاف، دوبارہ استعمال ہونے والی تشریحات میں محفوظ کرنے دیتے ہیں — ہر ہینڈلر میں `@Req() req` دہرانے سے بہت بہتر ہے۔ **کسٹم میٹا ڈیٹا ڈیکوریٹرز** (`SetMetadata`) NestJS کی اختیار کی تراکیب کی بنیاد ہیں: معیاری `@Roles()` + `RolesGuard` (Reflector کے ذریعے پڑھا جاتا ہے) کردار پر مبنی رسائی کنٹرول کے لیے مکمل طور پر میٹا ڈیٹا ڈیکوریٹرز کو سمجھنے پر منحصر ہے۔

اور **ڈیکوریٹرز کو ملانا** (`applyDecorators`) آپ کو متعلقہ ڈیکوریٹرز کو بنڈل کرنے دیتا ہے (مثلاً ایک `@Auth()` جو گارڈز اور میٹا ڈیٹا کو اکٹھا لاگو کرتا ہے) اختصار کے لیے، مستقل استعمال کے لیے۔

یہ سمجھنا کہ یہ کیسے بنائے جائیں وہ ہے جو آپ کو واضح، اردوجہ NestJS APIs بنانے اور عام نمونوں (موجودہ صارف انجیکشن، RBAC) کو فریم ورک کے ارادے والے طریقے سے نافذ کرنے دیتا ہے۔

یہ آپ کو محض بنائے ہوئے ڈیکوریٹرز استعمال کرنے سے آگے بڑھاتا ہے — اپنی ایپلیکیشن کی ضروریات کے لیے فریم ورک کے اعلانیہ انداز کو بڑھانے تک — حقیقی NestJS منصوبوں میں ایک قیمتی، بار بار لاگو ہونے والی مہارت۔