NestJS ਕਿਹੜੇ lifecycle hooks ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ?

Question

Accepted Answer

NestJS **lifecycle hooks** ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ — ਇਹ methods ਹਨ ਜੋ ਤੁਸੀਂ implement ਕਰਦੇ ਹੋ ਤਾਂ ਜੋ application ਦੇ ਜਾਂ provider ਦੇ lifecycle ਦੇ specific ਸਮੇਂ code ਚਲਾਇਆ ਜਾ ਸਕੇ (initialization ਅਤੇ shutdown)। ਇਹ setup (resources ਨਾਲ ਜੁੜਨਾ) ਅਤੇ cleanup (gracefully connections ਨੂੰ ਬੰਦ ਕਰਨਾ) ਲਈ ਜ਼ਰੂਰੀ ਹਨ।

## ਮੁੱਖ 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
  }
}
```

## lifecycle sequence

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

## ਇੱਕ ਆਮ ਉਪਯੋਗ: ਇੱਕ Prisma service ਜੋ connect/disconnect ਕਰਦਾ ਹੈ

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

ਇਹ resources ਲਈ ਸਟੈਂਡਰਡ pattern ਹੈ ਜਿਨ੍ਹਾਂ ਨੂੰ explicit setup/teardown ਦੀ ਲੋੜ ਹੈ — `onModuleInit` ਵਿੱਚ connect ਕਰੋ, `onModuleDestroy` ਵਿੱਚ release ਕਰੋ।

## Shutdown hooks ਨੂੰ enable ਕਰਨਾ

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

Shutdown hooks ਸਿਰਫ਼ ਚਲਦੇ ਹਨ ਜੇ ਤੁਸੀਂ `enableShutdownHooks()` ਨੂੰ call ਕਰਦੇ ਹੋ — ਭੁੱਲਣਾ ਸੌਖਾ ਹੈ, ਫਿਰ cleanup ਕਦੇ ਨਹੀਂ ਹੁੰਦਾ।

## Graceful shutdown ਮਹੱਤਵਪੂਰਨ ਕਿਉਂ ਹੈ

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

## ਇਹ ਮਹੱਤਵਪੂਰਨ ਕਿਉਂ ਹੈ

Lifecycle hooks NestJS applications ਵਿੱਚ resources ਨੂੰ ਸਹੀ ਢੰਗ ਨਾਲ manage ਕਰਨ ਲਈ ਮਹੱਤਵਪੂਰਨ ਹਨ — ਇਹ **initialization** (database/Redis connections ਖੋਲ੍ਹਣਾ, data load ਕਰਨਾ, services ਨਾਲ register ਕਰਨਾ) ਅਤੇ, ਆਲੋਚਨਾਤਮਕ ਤੌਰ 'ਤੇ, shutdown 'ਤੇ **graceful cleanup** (connections ਬੰਦ ਕਰਨਾ, buffers flush ਕਰਨਾ, in-flight work ਪੂਰਾ ਕਰਨਾ) ਲਈ ਸਹੀ ਥਾਂਵਾਂ ਫ਼ਰਾਹਮ ਕਰਦੇ ਹਨ।
en੍ਹਾਂ ਨੂੰ ਸਮਝਣਾ production reliability ਲਈ ਜ਼ਰੂਰੀ ਹੈ: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) ਇਹ ਯਕੀਨੀ ਬਣਾਉਂਦੇ ਹਨ ਕਿ setup ਸਹੀ ਸਮੇਂ ਹੋਵੇ ਜਦੋਂ dependencies ਤਿਆਰ ਹਾਂ, ਅਤੇ **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) **graceful shutdown** ਨੂੰ enable ਕਰਦੇ ਹਨ — ਜੋ ਕਿ modern deployment (containers/orchestrators ਵਿੱਚ SIGTERM ਲਗਾਤਾਰ ਭੇਜਦੇ ਹਨ deploys ਅਤੇ scaling ਦੌਰਾਨ) ਲਈ ਜ਼ਰੂਰੀ ਹੈ, ਅਤੇ proper cleanup ਤੋਂ ਬਿਨਾਂ ਤੁਸੀਂ connections leak ਕਰਦੇ ਹੋ ਅਤੇ active requests ਨੂੰ drop ਕਰਦੇ ਹੋ, zero-downtime deployments ਨੂੰ ਤੋੜਦੇ ਹੋ।

`onModuleInit` ਵਿੱਚ connect ਕਰਨਾ ਅਤੇ `onModuleDestroy` ਵਿੱਚ disconnect ਕਰਨਾ (ਉਦਾਹਰਣ ਲਈ Prisma/database services ਲਈ) ਰੋਜ਼ਮਰਾਂ ਦਾ NestJS knowledge ਹੈ, ਅਤੇ `enableShutdownHooks()` ਨੂੰ call ਕਰਨ ਦੀ subtle requirement ਨੂੰ ਜਾਣਨਾ (ਜਾਂ shutdown hooks silently ਕਦੇ fire ਨਹੀਂ ਹੁੰਦੇ) ਇੱਕ practical, ਆਸਾਨੀ ਨਾਲ miss ਕਰ ਸਕਣ ਵਾਲੀ detail ਹੈ।

Lifecycle hooks ਨੂੰ ਮਾਸਟਰ ਕਰਨਾ robust, production-ready NestJS services ਬਣਾਉਣ ਦਾ ਹਿੱਸਾ ਹੈ ਜੋ resources ਅਤੇ deployments ਨੂੰ ਸਹੀ ਢੰਗ ਨਾਲ handle ਕਰਦੇ ਹਨ।