Ce hook-uri de ciclu de viață oferă NestJS?

Question

Accepted Answer

NestJS oferă **hook-uri de ciclu de viață** — metode pe care le implementezi pentru a executa cod în momente specifice ale ciclului de viață al aplicației sau al unui provider (inițializare și shutdown). Sunt esențiale pentru configurare (conectare la resurse) și curățare (închiderea conexiunilor în mod curat).

## Hook-urile principale

```ts
@Injectable()
export class DatabaseService
  implements OnModuleInit, OnApplicationShutdown {

async onModuleInit() {
    // runs once the host MODULE's dependencies are resolved → do INITIALIZATION
    await this.connect();         // e.g. open a database connection
  }

async onApplicationShutdown(signal: string) {
    // runs when the app is shutting down → do CLEANUP
    await this.disconnect();      // close connections, flush, release resources
  }
}
```

## Secvența ciclului de viață

```text
INITIALIZATION (startup):
  onModuleInit()          → after the module's providers are initialized
  onApplicationBootstrap()→ after ALL modules are initialized (whole app ready)

SHUTDOWN (graceful termination):
  onModuleDestroy()         → cleanup as modules are destroyed
  beforeApplicationShutdown() → before shutdown completes
  onApplicationShutdown(signal) → final shutdown (signal = SIGTERM, etc.)
```

## Un caz comun: un serviciu Prisma care se conectează/deconectează

```ts
@Injectable()
export class PrismaService extends PrismaClient
  implements OnModuleInit, OnModuleDestroy {

async onModuleInit() {
    await this.$connect();        // connect on startup
  }
  async onModuleDestroy() {
    await this.$disconnect();      // disconnect on shutdown — clean release
  }
}
```

Acesta este modelul standard pentru resursele care necesită configurare/dezactivare explicită — conectare în `onModuleInit`, eliberare în `onModuleDestroy`.

## Activarea hook-urilor de shutdown

```ts
// shutdown hooks must be enabled explicitly
const app = await NestFactory.create(AppModule);
app.enableShutdownHooks();        // ❗ required for onApplicationShutdown etc. to fire
```

Hook-urile de shutdown se execută doar dacă apelezi `enableShutdownHooks()` — ușor de uitat, și apoi curățarea nu se întâmplă niciodată.

## De ce contează shutdown-ul curat

```text
When the app receives SIGTERM (deploy, scale-down, container stop):
  ✗ Without shutdown hooks → connections left open, in-flight work dropped
  ✓ With shutdown hooks → close DB/Redis/queues cleanly, finish work → zero-downtime
```

## De ce contează

Hook-urile de ciclu de viață sunt importante pentru gestionarea corectă a resurselor în aplicațiile NestJS — oferă locurile potrivite pentru a efectua **inițializare** (deschiderea conexiunilor la baze de date/Redis, încărcarea datelor, înregistrare cu servicii) și, în mod critic, **curățare curat** la shutdown (închiderea conexiunilor, golirea buffer-elor, finalizarea lucrărilor în curs).

Înțelegerea lor este esențială pentru fiabilitatea în producție: **hook-urile de inițializare** (`onModuleInit`, `onApplicationBootstrap`) asigură că configurarea se întâmplă la momentul potrivit odată ce dependențele sunt pregătite, și **hook-urile de shutdown** (`onModuleDestroy`, `onApplicationShutdown`) permit **shutdown curat** — care este vital în implementarea modernă (containerele/orchestratoarele trimit constant SIGTERM în timpul implementărilor și scalării, și fără curățare adecvată pierzi conexiuni și renunți la cereri active, rupând implementările fără timp de inactivitate).

Modelul standard de conectare în `onModuleInit` și deconectare în `onModuleDestroy` (de exemplu pentru serviciile Prisma/baze de date) este cunoaștere cotidiană în NestJS, și știind cerința subtilă de a apela `enableShutdownHooks()` (altfel hook-urile de shutdown tac și nu se execută niciodată) este un detaliu practic, ușor de omis.

Stăpânirea hook-urilor de ciclu de viață face parte din construirea serviciilor NestJS robuste, gata pentru producție, care gestionează resursele și implementările corect.