Cilat janë lifecycle hooks që ofron NestJS?

Question

Accepted Answer

NestJS ofron **lifecycle hooks** — metoda që ju implementoni për të ekzekutuar kod në momente specifike në ciklin e jetës të aplikacionit ose të një provideri (inicializim dhe shutdown). Ato janë thelbësore për setup (lidhja me resurset) dhe cleanup (mbyllja e lidhjeve në mënyrë të nxituar).

## Hook-et kryesore

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

## Sekuenca e lifecycle

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

## Një përdorim i zakonshëm: një shërbim Prisma që lidhet/shlidhet

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

Ky është modeli standard për resurset që kanë nevojë për setup/teardown eksplicit — lidhuni në `onModuleInit`, lironi në `onModuleDestroy`.

## Aktivizimi i 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 vetëm ekzekutohen nëse e thërrisni `enableShutdownHooks()` — e lehtë të harrohet, pastaj cleanup kurrë nuk ndodh.

## Pse shutdown i nxituar ka rëndësi

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

## Pse ka rëndësi

Lifecycle hooks janë të rëndësishme për menaxhimin e saktë të resurseve në aplikacionet NestJS — ato ofrojnë vendet e duhura për të kryer **inicializimin** (hapja e lidhjeve të bazës së të dhënave/Redis, ngarkimi i të dhënave, regjistrimi me shërbime) dhe, në mënyrë kritike, **cleanup i nxituar** gjatë shutdown (mbyllja e lidhjeve, flushing buffers, përfundimi i punës në fluturim).

Kuptimi i tyre është thelbësor për besueshmërinë në prodhim: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) sigurojnë që setup të ndodhë në kohën e duhur pasi varësitë janë gati, dhe **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) mundësojnë **shutdown i nxituar** — i cili është jetësor në deployment modern (containere/orkestratorë dërgojnë SIGTERM vazhdimisht gjatë deploy dhe scaling, dhe pa cleanup të duhur rrjedh lidhjeve dhe humbni kërkesa aktive, duke thyer zero-downtime deployments).

Modeli standard i lidhjes në `onModuleInit` dhe shlidhjes në `onModuleDestroy` (p.sh. për shërbime Prisma/database) është njohuri e përditshme NestJS, dhe njohja e kërkesës subtile për të thërritur `enableShutdownHooks()` (ose shutdown hooks në heshtje kurrë nuk zjarrin) është një detaj praktik, i lehtë për të humbur.

Mastering lifecycle hooks është pjesë e ndërtimit të shërbimeve të qëndrueshme, gati për prodhim NestJS që trajtojnë resurset dhe deployments në mënyrë të saktë.