Τι είναι οι custom providers και τα injection tokens;

Question

Accepted Answer

Πέρα από τις απλές κλάσεις `@Injectable()`, το NestJS υποστηρίζει **custom providers** — ευέλικτους τρόπους για να ορίσετε τι θα εγχυθεί — χρησιμοποιώντας **injection tokens**. Αυτό σας επιτρέπει να εγχύετε τιμές, να διαμορφώσετε πώς δημιουργούνται οι instances, να αντικαταστήσετε υλοποιήσεις και να εγχύετε non-class dependencies.

## Οι τέσσερις τύποι custom provider

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

## Injection tokens — για non-class 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 ή μια απλή τιμή ανά τύπο (δεν υπάρχουν κατά την εκτέλεση), χρησιμοποιείτε ένα **token** (ένα string ή `Symbol`) με `@Inject(token)` για να το εγχύσετε. Έτσι εγχύετε αντικείμενα διαμόρφωσης, third-party clients ή dependencies τύπου interface.

## useFactory — το πιο ισχυρό (δυναμικό, ασύγχρονο setup)

```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` εκτελεί μια συνάρτηση (με injected dependencies) για να παράγει τον provider — απαραίτητο για συνδέσεις, clients ή οτιδήποτε χρειάζεται διαμόρφωση κατά την εκτέλεση ή ασύγχρονο setup.

## Αντικατάσταση υλοποιήσεων (useClass) — ευελιξία & δοκιμές

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

Επειδή οι καταναλωτές εξαρτώνται από το token (`PaymentService`), μπορείτε να αντικαταστήσετε την συγκεκριμένη κλάση — μια πραγματική υπηρεσία Stripe στην παραγωγή, ένα mock στις δοκιμές — χωρίς να αλλάξετε κάποιον κώδικα που την καταναλώνει.

## Γιατί έχει σημασία

Οι custom providers και τα injection tokens επεκτείνουν την dependency injection του NestJS πέρα από τις απλές κλάσεις, δίνοντάς σας την ευελιξία που χρειάζεται για εφαρμογές στον πραγματικό κόσμο.

Τα κατανόησης τους είναι σημαντικά για διάφορα συνηθισμένα σενάρια: **εγχύση non-class τιμών** (αντικείμενα διαμόρφωσης, σταθερές) μέσω `useValue` και string/Symbol tokens (επειδή δεν μπορείτε να εγχύσετε interfaces ή απλές τιμές ανά τύπο); **δυναμική/ασύγχρονη δημιουργία provider** μέσω `useFactory` (η πιο ισχυρή μορφή — δημιουργία συνδέσεων βάσης δεδομένων, Redis clients ή instances τρίτων SDK διαμορφωμένα από τιμές κατά την εκτέλεση, με τα δικά τους injected dependencies); και **αντικατάσταση υλοποιήσεων** μέσω `useClass` πίσω από ένα token (ενδυναμώνοντας υλοποιήσεις που βασίζονται σε περιβάλλον και, κρυσίμως, εύκολο **mocking στις δοκιμές** — παρέχετε μια mock κλάση για ένα token χωρίς να αγγίζετε τους καταναλωτές).

Αυτή η ευελιξία είναι αυτό που κάνει το DI του NestJS ισχυρό για αρχιτεκτονική παραγωγής και εξαιρετική δοκιμασιμότητα.

Το γνώρισμα των τεσσάρων τύπων provider (`useClass`, `useValue`, `useFactory`, `useExisting`), του τρόπου λειτουργίας των injection tokens για non-class dependencies και του πότε να ανατρέξετε σε καθένα είναι ένα σημαντικό βήμα πέρα από το βασικό DI — αυτός είναι ο τρόπος για να συνδέσετε βάσεις δεδομένων, εξωτερικές υπηρεσίες, διαμόρφωση και swappable/mockable dependencies με τον ιδιωματικό τρόπο του NestJS, κάνοντάς το ένα συχνά απαιτούμενο, αρχιτεκτονικά σημαντικό θέμα σε πραγματικές εφαρμογές.