کسٹم فراہم کنندگان اور انجیکشن ٹوکنز کیا ہیں؟

Question

Accepted Answer

سادہ `@Injectable()` کلاسز سے آگے، NestJS **کسٹم فراہم کنندگان** کو سپورٹ کرتا ہے — انجیکشن ٹوکنز استعمال کرتے ہوئے جو انجیکٹ کرنا ہے اس کی تعریف کے لیے لچکدار طریقے۔ یہ آپ کو قیمتیں انجیکٹ کرنے، مثالیں کیسے بنائی جاتی ہیں اس کو ترتیب دینے، تعمیرات کو بدلنے، اور غیر کلاس dependencies انجیکٹ کرنے دیتا ہے۔

## چار کسٹم فراہم کنندہ کی اقسام

```ts
@Module({
  providers: [
    // 1. useClass — standard (or swap the implementation behind a token)
    { provide: PaymentService, useClass: StripePaymentService },

// 2. useValue — inject a constant/object/mock (great for config and testing)
    { provide: "CONFIG", useValue: { apiKey: "abc", timeout: 5000 } },

// 3. useFactory — compute the provider dynamically (can use other deps)
    {
      provide: "DATABASE_CONNECTION",
      useFactory: async (config: ConfigService) => {
        return await createConnection(config.get("DB_URL"));   // async setup
      },
      inject: [ConfigService],        // dependencies for the factory
    },

// 4. useExisting — create an alias for an existing provider
    { provide: "ALIAS", useExisting: PaymentService },
  ],
})
export class AppModule {}
```

## انجیکشن ٹوکنز — غیر کلاس dependencies کے لیے

```ts
// classes can be tokens directly (by type). For values/interfaces, use a string/Symbol token:
@Injectable()
export class PaymentProcessor {
  constructor(@Inject("CONFIG") private config: AppConfig) {}   // inject by token
}
```

آپ interface یا سادہ قیمت کو قسم سے انجیکٹ نہیں کر سکتے (وہ رن ٹائم پر موجود نہیں ہیں)، اس لیے آپ `@Inject(token)` کے ساتھ ایک **ٹوکن** (سٹرنگ یا `Symbol`) استعمال کرتے ہیں اسے انجیکٹ کرنے کے لیے۔ یہ ہے کہ آپ کنفگریشن آبجیکٹس، تیسری طرف کی کلائنٹس، یا interface قسم کی dependencies کو کیسے انجیکٹ کرتے ہیں۔

## useFactory — سب سے طاقتور (متحرک، async سیٹ اپ)

```ts
// create a provider whose value depends on runtime config / async initialization
{
  provide: "REDIS_CLIENT",
  useFactory: (config: ConfigService) => new Redis(config.get("REDIS_URL")),
  inject: [ConfigService],
}
```

`useFactory` ایک فنکشن چلاتا ہے (انجیکٹ کی گئی dependencies کے ساتھ) فراہم کنندہ بنانے کے لیے — کنکشنز، کلائنٹس، یا کسی بھی چیز کے لیے ضروری ہے جس میں رن ٹائم کنفگریشن یا async سیٹ اپ کی ضرورت ہو۔

## تعمیرات میں تبدیلی (useClass) — لچک اور ٹیسٹنگ

```ts
// inject a different implementation based on environment
{
  provide: PaymentService,
  useClass: process.env.NODE_ENV === "test" ? MockPaymentService : StripePaymentService,
}
```

کیونکہ صارفین ٹوکن پر منحصر ہوتے ہیں (`PaymentService`)، آپ concrete کلاس میں تبدیلی کر سکتے ہیں — پروڈکشن میں حقیقی Stripe سروس، ٹیسٹس میں نقل — کسی بھی استعمال کنندہ کوڈ میں تبدیلی کے بغیر۔

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

کسٹم فراہم کنندگان اور انجیکشن ٹوکنز NestJS کی dependency injection کو سادہ کلاسز سے آگے بڑھاتے ہیں، جو آپ کو حقیقی دنیا کی ایپلیکیشنز کے لیے ضروری لچک دیتے ہیں۔

انہیں سمجھنا کئی عام حالات میں اہم ہے: **غیر کلاس قیمتیں انجیکٹ کرنا** (کنفگریشن آبجیکٹس، constants) `useValue` اور سٹرنگ/Symbol ٹوکنز کے ذریعے (کیونکہ آپ interfaces یا سادہ قیمتوں کو قسم سے انجیکٹ نہیں کر سکتے)؛ **متحرک/async فراہم کنندہ بنانا** `useFactory` کے ذریعے (سب سے طاقتور شکل — ڈیٹابیس کنکشنز، Redis کلائنٹس، یا تیسری طرف کے SDK انسٹینسز بنانا جو رن ٹائم قیمتوں سے ترتیب دیے گئے ہوں، ان کی اپنی انجیکٹ کی گئی dependencies کے ساتھ)؛ اور **تعمیرات میں تبدیلی** ایک ٹوکن کے پیچھے `useClass` کے ذریعے (ماحول پر مبنی تعمیرات اور، اہم طور پر، ٹیسٹس میں آسان **mocking** — ایک mock کلاس فراہم کریں ٹوکن کے لیے بغیر صارفین کو چھوئے)۔

یہ لچک ہی NestJS کی DI کو پروڈکشن آرکیٹیکچر کے لیے طاقتور بناتی ہے اور بہترین testability فراہم کرتی ہے۔

چار فراہم کنندہ کی اقسام (`useClass`, `useValue`, `useFactory`, `useExisting`) جاننا، انجیکشن ٹوکنز غیر کلاس dependencies کے لیے کیسے کام کرتے ہیں، اور ہر ایک کب استعمال کریں — یہ بنیادی DI سے آگے ایک اہم قدم ہے — یہ ہے کہ آپ ڈیٹابیسز، بیرونی سروسز، کنفگریشن، اور swappable/mockable dependencies کو idiomatic NestJS طریقے سے کیسے سیٹ اپ کرتے ہیں، جو اسے حقیقی ایپلیکیشنز میں بار بار ضروری، architecturally اہم موضوع بناتا ہے۔