NestJS कौन-से lifecycle hooks प्रदान करता है?

Question

Accepted Answer

NestJS **lifecycle hooks** प्रदान करता है — ऐसी methods जिन्हें आप application या किसी provider के lifecycle के विशिष्ट क्षणों (initialization और shutdown) पर code चलाने के लिए implement करते हैं। वे setup (resources से connect करना) और cleanup (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 क्रम

```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 है जिन्हें स्पष्ट setup/teardown की आवश्यकता होती है — `onModuleInit` में connect करें, `onModuleDestroy` में release करें।

## 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 तभी चलते हैं जब आप `enableShutdownHooks()` कॉल करते हैं — इसे भूलना आसान है, और फिर 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 को सही ढंग से प्रबंधित करने के लिए महत्वपूर्ण हैं — वे **initialization** (database/Redis connections खोलना, data लोड करना, services के साथ register करना) और, महत्वपूर्ण रूप से, shutdown पर **graceful cleanup** (connections बंद करना, buffers flush करना, in-flight कार्य पूरा करना) करने के उचित स्थान प्रदान करते हैं।

इन्हें समझना production विश्वसनीयता के लिए आवश्यक है: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) सुनिश्चित करते हैं कि setup सही समय पर हो जब dependencies तैयार हों, और **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) **graceful shutdown** सक्षम करते हैं — जो आधुनिक deployment में महत्वपूर्ण है (containers/orchestrators deploys और scaling के दौरान लगातार SIGTERM भेजते हैं, और उचित cleanup के बिना आप connections लीक करते हैं और सक्रिय requests छोड़ देते हैं, जिससे zero-downtime deployments टूट जाते हैं)।

`onModuleInit` में connect करने और `onModuleDestroy` में disconnect करने का मानक pattern (जैसे Prisma/database services के लिए) रोज़मर्रा का NestJS ज्ञान है, और `enableShutdownHooks()` कॉल करने की सूक्ष्म आवश्यकता को जानना (अन्यथा shutdown hooks चुपचाप कभी नहीं चलते) एक व्यावहारिक, आसानी से छूट जाने वाला विवरण है।

Lifecycle hooks में महारत हासिल करना मज़बूत, production-तैयार NestJS services बनाने का हिस्सा है जो resources और deployments को सही ढंग से संभालते हैं।