Jaké lifecycle hooky NestJS poskytuje?

Question

Accepted Answer

NestJS poskytuje **lifecycle hooky** — metody, které implementujete, abyste spustili kód v konkrétních okamžicích v životním cyklu aplikace nebo poskytovatele (inicializace a vypnutí). Jsou nezbytné pro nastavení (připojování k prostředkům) a čištění (elegantní zavírání spojení).

## Hlavní hooky

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

## Sekvence životního cyklu

```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.)
```

## Běžné použití: Prisma služba s připojením/odpojením

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

Toto je standardní pattern pro prostředky, které vyžadují explicitní nastavení a odstranění — připojení v `onModuleInit`, uvolnění v `onModuleDestroy`.

## Povolení shutdown hooků

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

Shutdown hooky se spustí pouze pokud zavoláte `enableShutdownHooks()` — snadno se zapomene, pak se cleanup nikdy neproběhne.

## Proč je elegantní vypnutí důležité

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

## Proč je to důležité

Lifecycle hooky jsou důležité pro správné řízení prostředků v NestJS aplikacích — poskytují správná místa k provedení **inicializace** (otevírání databází/Redis spojení, načítání dat, registrace u služeb) a kriticky, **elegantního čištění** při vypnutí (zavírání spojení, vyprazdňování vyrovnávacích pamětí, dokončování probíhající práce).

Porozumění jim je nezbytné pro produkční spolehlivost: **inicializační hooky** (`onModuleInit`, `onApplicationBootstrap`) zajišťují, že se nastavení provede ve správný čas, jakmile jsou závislosti připraveny, a **shutdown hooky** (`onModuleDestroy`, `onApplicationShutdown`) umožňují **elegantní vypnutí** — což je kritické v moderním nasazení (containery/orchestrátory neustále posílají SIGTERM během deploymentů a škálování, a bez správného čištění dochází k úniku spojení a ztrátě aktivních požadavků, což narušuje zero-downtime deploymenty).

Standardní pattern připojení v `onModuleInit` a odpojení v `onModuleDestroy` (např. pro Prisma/databázové služby) je každodenní znalostí NestJS, a znalost jemné požadavky volat `enableShutdownHooks()` (nebo shutdown hooky tiše nikdy nevykonáme) je praktickým, lehko přehlédnutelným detailem.

Zvládnutí lifecycle hooků je součástí vytváření robustních, produkčně připravených NestJS služeb, které správně řídí prostředky a deploymenty.