Katere lifecycle hooks ponuja NestJS?

Question

Accepted Answer

NestJS ponuja **lifecycle hooks** — metode, ki jih implementirate, da se koda izvede v specifičnih trenutkih v životnem ciklu aplikacije ali ponudnika (inicijalizacija in zaustavitev). So nujne za nastavitev (povezovanje s viri) in čiščenje (graceful zaprtje povezav).

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

## Zaporedje životnega cikla

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

## Pogost primer: Prisma service za povezovanje/preklapljanje

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

To je standardni vzorec za vire, ki potrebujejo eksplicitno nastavitev/razrešitev — povežite v `onModuleInit`, sprostite v `onModuleDestroy`.

## Omogočanje 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šijo le, če pokličete `enableShutdownHooks()` — enostavno se je to pozabiti, nato pa čiščenje nikoli ne poteka.

## Zakaj je graceful shutdown pomemben

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

## Zakaj je to pomembno

Lifecycle hooks so pomembni za pravilno upravljanje virov v NestJS aplikacijah — zagotavljajo prave mesta za izvedbo **inicijalizacije** (odpiranje baz podatkov/Redis povezav, nalaganje podatkov, registracija pri servisih) in, kar je kritično, **graceful čiščenja** ob zaustavitvi (zaprtje povezav, izpraznitev buffer-jev, zaključek aktivnih zahtevkov).

Razumevanje njih je bistvenega pomena za zanesljivost v produkciji: **inicijalizacijski hooks** (`onModuleInit`, `onApplicationBootstrap`) zagotavljajo, da se nastavitev zgodi v pravem trenutku, ko so odvisnosti pripravljene, in **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) omogočajo **graceful shutdown** — kar je ključno pri sodobnem razmeščanju (kontejnerji/orkestratorji neprestano pošiljajo SIGTERM med razmeščanjem in skaliranjem, in brez pravilnega čiščenja puščate tekočine povezav in padate aktivne zahtevke, kar ruši razmeščanja brez izpada).

Standardni vzorec povezovanja v `onModuleInit` in preklapljanja v `onModuleDestroy` (npr. za Prisma/database servise) je vsakodnevno NestJS znanje, in poznavanje subtilne zahteve po klicu `enableShutdownHooks()` (ali shutdown hooks tiho nikoli ne prižgejo) je praktična, enostavno spregledan detalj.

Ovladovanje lifecycle hooks je del gradnje robustnih, production-ready NestJS servisov, ki pravilno ravnajo z viri in razmeščanjem.