NestJS میں dependency injection کیسے کام کرتا ہے؟

Question

Accepted Answer

**Dependency Injection (DI)** ایک بنیادی NestJS pattern ہے جہاں framework **خودکار طور پر بناتا ہے اور فراہم کرتا ہے** وہ dependencies جس کی کسی class کو ضرورت ہے، بجائے اس کے کہ class خود انہیں بنائے۔ آپ constructor میں اعلان کرتے ہیں کہ آپ کو کیا چاہیے، اور NestJS اسے فراہم کرتا ہے — جس سے loosely-coupled، testable code ملتا ہے۔

## یہ کیسے کام کرتا ہے: constructor میں اعلان کریں

```ts
@Injectable()
export class UsersService {
  // declare dependencies as constructor parameters — Nest injects them
  constructor(
    private readonly db: DatabaseService,
    private readonly logger: LoggerService,
  ) {}
  // you NEVER write `new DatabaseService()` — Nest creates and provides it
}
```

Nest constructor کے parameter types کو پڑھتا ہے، متعلقہ registered providers کو تلاش کرتا ہے، انہیں بناتا ہے (اگر پہلے سے نہیں)، اور انہیں pass کرتا ہے — خودکار طور پر پوری dependency graph کو حل کرتے ہوئے۔

## DI flow

```text
1. A class is marked @Injectable() → it's a provider
2. The provider is registered in a module's `providers` array
3. Another class declares it as a constructor parameter
4. NestJS's IoC container resolves and INJECTS the instance automatically
```

## Registration اور resolution

```ts
@Module({
  providers: [UsersService, DatabaseService, LoggerService],  // register all providers
  controllers: [UsersController],
})
export class UsersModule {}
// Nest's container now knows how to construct each and inject them where needed
```

## DI کیوں قیمتی ہے

```text
✓ Loose coupling — classes depend on ABSTRACTIONS, not on constructing concrete deps
✓ Testability — inject MOCK dependencies in tests easily (no real DB needed)
✓ Reusability — one shared instance (singleton) used across the app
✓ Maintainability — change an implementation in one place (the module registration)
```

## Testability — زبردست فائدہ

```ts
// in a test, provide a fake DatabaseService — no real database required
const module = await Test.createTestingModule({
  providers: [
    UsersService,
    { provide: DatabaseService, useValue: mockDatabase },  // inject a mock
  ],
}).compile();
```

کیونکہ class اپنی dependencies کو نہیں بناتی، آپ testing کے لیے mocks میں تبدیل کر سکتے ہیں — DI NestJS apps کو بہت testable بناتا ہے۔

## Non-class values کو inject کرنا

```ts
// use injection tokens for config/values, not just classes
constructor(@Inject("CONFIG") private config: AppConfig) {}
```

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

Dependency injection وہ بنیادی pattern ہے جو NestJS کی پوری architecture کی بنیاد ہے — یہ ہے کہ کیسے controllers کو services ملتی ہیں، services کو repositories اور دوسری services ملتی ہیں، اور پوری application جڑی ہوئی ہے۔

اسے سمجھنا ضروری ہے کیونکہ تقریباً ہر NestJS class DI میں حصہ لیتی ہے: آپ constructor میں dependencies کا اعلان کرتے ہیں اور framework کا IoC container انہیں خودکار طور پر حل کرتا ہے اور فراہم کرتا ہے، دستی instantiation اور tight coupling کو ختم کرتے ہوئے۔

فوائد نمایاں ہیں اور NestJS کی قدر کے لیے مرکزی ہیں: **loose coupling** (abstractions پر منحصر ہو)، **testability** (real dependencies کی جگہ mocks inject کریں — جو مکمل unit testing کو آسان بناتا ہے)، reusability (shared singletons)، اور maintainability۔

DI Angular اور Spring جیسے frameworks سے لیا گیا ہے، اور اسے master کرنا — کیسے dependencies کا اعلان، registration، inject، اور mock کریں — اچھی طریقے سے structured، testable NestJS applications بنانے کے لیے ضروری ہے اور framework میں سب سے اہم concepts میں سے ایک ہے جسے گہرائی سے سمجھنا ضروری ہے۔