कस्टम प्रोभाइडर र इञ्जेक्शन टोकन के हुन्?

Question

Accepted Answer

साधारण `@Injectable()` क्लासहरूभन्दा अगाडि, NestJS ले **कस्टम प्रोभाइडरहरू** लाई समर्थन गर्छ — के इञ्जेक्ट गरिन्छ भनेर परिभाषित गर्ने लचकदार तरिकाहरू — **इञ्जेक्शन टोकन** प्रयोग गरेर। यसले तपाईलाई मानहरू इञ्जेक्ट गर्न, उदाहरणहरू कसरी सिर्जना गरिन्छ भनेर कन्फिगर गर्न, कार्यान्वयनहरू स्वैप गर्न, र गैर-क्लास निर्भरताहरू इञ्जेक्ट गर्न दिन्छ।

## चार कस्टम प्रोभाइडर प्रकारहरू

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

## इञ्जेक्शन टोकनहरू — गैर-क्लास निर्भरताहरूको लागि

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

तपाईले इन्टरफेस वा साधारण मान लाई प्रकारद्वारा इञ्जेक्ट गर्न सक्नुहुन्न (तिनीहरू रनटाइममा अस्तित्वमा छैनन्), तपाईले **टोकन** (स्ट्रिङ वा `Symbol`) को साथ `@Inject(token)` प्रयोग गर्नुहुन्छ। यो कसरी तपाईले कन्फिगरेशन वस्तुहरू, तृतीय-पक्ष क्लाइन्टहरू, वा इन्टरफेस-टाइप गरिएका निर्भरताहरू इञ्जेक्ट गर्नुहुन्छ।

## useFactory — सबैभन्दा शक्तिशाली (गतिशील, एसिङ्क सेटअप)

```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` ले एक फंक्शन चलाउँछ (इञ्जेक्ट गरिएका निर्भरताहरूसहित) प्रोभाइडर उत्पादन गर्नको लागि — जडानहरू, क्लाइन्टहरू, वा रनटाइम कन्फिगरेशन वा एसिङ्क सेटअप आवश्यक गरिएका कुनै पनि चीजको लागि आवश्यक।

## कार्यान्वयनहरू स्वैप गर्दै (useClass) — लचकपन र परीक्षण

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

कारण उपभोक्ताहरू टोकनमा निर्भर छन् (`PaymentService`), तपाईले कंक्रीट क्लास स्वैप गर्न सक्नुहुन्छ — उत्पादनमा वास्तविक Stripe सेवा, परीक्षणहरूमा नकल — कुनै पनि उपभोग गर्ने कोडमा परिवर्तन गरी।

## यो किन महत्त्वपूर्ण छ

कस्टम प्रोभाइडरहरू र इञ्जेक्शन टोकनहरू NestJS को निर्भरता इञ्जेक्शनलाई साधारण क्लासहरूभन्दा अगाडि विस्तार गर्छन्, तपाईलाई वास्तविक-विश्व अनुप्रयोगहरूको लागि आवश्यक लचकपन दिन्छ।

तिनीहरूलाई बुझ्नु धेरै सामान्य परिदृश्यहरूको लागि महत्त्वपूर्ण छ: **गैर-क्लास मानहरू इञ्जेक्ट गर्दै** (कन्फिगरेशन वस्तुहरू, स्थिरांकहरू) `useValue` र स्ट्रिङ/Symbol टोकनहरू मार्फत (किनकि तपाईले इन्टरफेसहरू वा साधारण मानहरू प्रकारद्वारा इञ्जेक्ट गर्न सक्नुहुन्न); **गतिशील/एसिङ्क प्रोभाइडर सिर्जना** `useFactory` मार्फत (सबैभन्दा शक्तिशाली रूप — डेटाबेस जडानहरू, Redis क्लाइन्टहरू, वा रनटाइम मानहरू, तिनीहरूको आफ्नै इञ्जेक्ट गरिएका निर्भरताहरूसहित कन्फिगर गरिएको तृतीय-पक्ष SDK उदाहरणहरू सिर्जना गर्दै); र **कार्यान्वयनहरू स्वैप गर्दै** `useClass` टोकन पछाडि (वातावरण-आधारित कार्यान्वयनहरू सक्षम गर्दै र, महत्त्वपूर्ण रूपमा, परीक्षणहरूमा **सजिलै नकल गर्दै** — उपभोग गर्नेहरूलाई छोई बिना टोकनको लागि नकल क्लास प्रदान गर्दै)।

यो लचकपन NestJS को DI लाई उत्पादन आर्किटेक्चरको लागि शक्तिशाली र उत्कृष्ट परीक्षणयोग्यताको लागि बनाउँछ।

चार प्रोभाइडर प्रकारहरू (`useClass`, `useValue`, `useFactory`, `useExisting`) जान्नु, इञ्जेक्शन टोकनहरू गैर-क्लास निर्भरताहरूको लागि कसरी काम गर्छन्, र प्रत्येकको लागि कहिले पहुँच गर्नु पर्ने भनेर बुझ्नु आधारभूत DI भन्दा परे महत्त्वपूर्ण कदम हो — यो कसरी तपाईले डेटाबेसहरू, बाहिरी सेवाहरू, कन्फिगरेशन, र स्वैप गर्न सकिने/नकल गर्न सकिने निर्भरताहरू idiomatic NestJS तरिकामा तार गर्नुहुन्छ, यसलाई वास्तविक अनुप्रयोगहरूमा बारम्बार आवश्यक, आर्किटेक्चरभावे-महत्त्वपूर्ण विषय बनाउँछ।