Koje lifecycle hooks nudi NestJS?

Question

Accepted Answer

NestJS pruža **lifecycle hooks** — metode koje implementirate da pokrenete kod u specifičnim trenucima životnog ciklusa aplikacije ili providera (inicijalizacija i gašenje). Oni su bitni za setup (povezivanje na resurse) i cleanup (korektno zatvaranje konekcija).

## Glavni hooks

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

## Slijed životnog ciklusa

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

## Česta primjena: Prisma servis koji se povezuje/odjavljuje

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

Ovo je standardni pattern za resurse koji trebaju eksplicitan setup/teardown — povežite se u `onModuleInit`, oslobodite u `onModuleDestroy`.

## Omogućavanje shutdown hooks

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

Shutdown hooks se izvršavaju samo ako pozovete `enableShutdownHooks()` — lako je zaboraviti, pa cleanup nikad ne happens.

## Zašto je graceful shutdown bitan

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

## Zašto je to važno

Lifecycle hooks su važni za ispravno upravljanje resursima u NestJS aplikacijama — oni pružaju pravi mjesta za izvršavanje **inicijalizacije** (otvaranje baza/Redis konekcija, učitavanje podataka, registracija sa servisima) i, što je kritično, **graceful cleanup** pri gašenju (zatvaranje konekcija, pražnjenje buffer-a, završavanje u toku rada).

Razumijevanje ih je bitno za production pouzdanost: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) osiguravaju da setup bude u pravi trenutak kad su zavisnosti spremne, a **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) omogućavaju **graceful shutdown** — što je ključno u modernom deploymentu (kontejneri/orkestratori konstantno šalju SIGTERM tijekom deploymenta i skaliranja, a bez provedenog cleanup-a curite konekcije i gubite aktivne zahtjeve, što prekida zero-downtime deploymenta).

Standardni pattern povezivanja u `onModuleInit` i odvajanja u `onModuleDestroy` (npr. za Prisma/database servise) je svakodnevno NestJS znanje, a znanje suptilnog zahtjeva pozivanja `enableShutdownHooks()` (ili shutdown hooks tiho nikad ne rade) je praktična, lako-propustiva detalja.

Ovladavanje lifecycle hooks-ima dio je gradnje robusnih, production-ready NestJS servisa koji ispravno upravljaju resursima i deploymentima.