NestJS کس طرح decorators استعمال کرتا ہے؟

Question

Accepted Answer

NestJS **TypeScript decorators** کے ارد گرد بنایا گیا ہے — خصوصی `@`-سابقہ annotation جو کلاسز، methods، اور parameters کو **metadata** منسلک کرتے ہیں۔ NestJS یہ metadata (reflection کے ذریعے) پڑھتا ہے تاکہ routing، dependency injection، validation، اور بہت کچھ declaratively کو wire کرے۔ Decorators NestJS میں ہر جگہ ہیں۔

## کلاس decorators — کلاس کا کردار متعین کریں

```ts
@Controller("users")     // this class is a CONTROLLER, prefix /users
export class UsersController {}

@Injectable()            // this class is a PROVIDER (injectable)
export class UsersService {}

@Module({ ... })         // this class is a MODULE
export class UsersModule {}
```

کلاس decorators بیان کرتے ہیں کہ NestJS architecture میں کلاس *کیا* ہے (controller، provider، module) اور اسے configure کرتے ہیں۔

## Method decorators — routes کو map کریں اور رویہ لاگو کریں

```ts
@Get()                   // GET request handler
@Post()                  // POST handler
@Get(":id")              // GET /users/:id
@HttpCode(204)           // set the response status code
@UseGuards(AuthGuard)    // apply a guard to this route
@UseInterceptors(LoggingInterceptor)
findAll() {}
```

## Parameter decorators — request data نکالیں

```ts
findOne(
  @Param("id") id: string,       // route parameter
  @Query("sort") sort: string,   // query string
  @Body() dto: CreateUserDto,    // request body
  @Headers("auth") auth: string, // header
) {}
```

Parameter decorators declaratively request سے بالکل وہی data نکالتے ہیں جو آپ کو چاہیے — کوئی دستی `req` parsing نہیں۔

## Property/validation decorators (DTOs پر)

```ts
export class CreateUserDto {
  @IsEmail()                     // validation rules (class-validator)
  email: string;

@IsString()
  @MinLength(8)
  password: string;
}
```

## کیوں decorators؟ Declarative metadata

```text
Decorators attach METADATA that NestJS reads at runtime (via reflection) to:
  ✓ Register routes (@Get, @Controller)
  ✓ Wire dependency injection (@Injectable, @Inject)
  ✓ Apply guards/interceptors/pipes (@UseGuards, etc.)
  ✓ Validate input (@IsEmail, @IsString)
→ Behavior is declared WHERE it applies, concisely and readably.
```

## Custom decorators

```ts
// you can create your own — e.g. extract the current user from the request
export const CurrentUser = createParamDecorator((data, ctx) =>
  ctx.switchToHttp().getRequest().user
);
// usage: findProfile(@CurrentUser() user: User) {}
```

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

Decorators NestJS کی تعریفی syntactic feature ہیں — پوری framework ان کے ارد گرد organized ہے، اس لیے یہ سمجھنا کہ وہ کیسے کام کرتے ہیں کسی بھی NestJS code کو پڑھنے اور لکھنے کے لیے ضروری ہے۔

وہ ایک **declarative**، metadata-driven approach فراہم کرتے ہیں: imperative configuration کی بجائے، آپ کلاسز، methods، اور parameters کو annotate کرتے ہیں تاکہ routing (`@Controller`, `@Get`)، dependency injection (`@Injectable`)، cross-cutting behavior (`@UseGuards`, `@UseInterceptors`)، اور validation (`@IsEmail`) کو بالکل وہاں declare کریں جہاں وہ apply ہوتے ہیں — مختصر اور readable۔

یہ metadata-via-reflection mechanism (Angular اور Java/Spring annotations کے پیچھے وہی خیال) وہ ہے جو NestJS کی clean، structured style کو enable کرتا ہے۔

زمرہ جات کو پہچاننا (class، method، parameter، property decorators)، عام decorators کو جاننا، اور custom decorators بنانے کی صلاحیت NestJS fluency کی بنیاد ہے — decorators وہ ہیں جس سے تقریباً ہر feature express کیا جاتا ہے، انہیں framework میں سمجھنے کے لیے سب سے پہلی اور سب سے اہم چیز بناتے ہیں۔