NestJS कोणते lifecycle hooks प्रदान करते?

Question

Accepted Answer

NestJS **lifecycle hooks** प्रदान करते — हे अशी methods आहेत जी तुम्ही application किंवा provider च्या lifecycle मध्ये विशिष्ट क्षणी code चलवण्यासाठी implement करता (initialization आणि shutdown). ते setup (resources शी जोडणे) आणि cleanup (connections gracefully बंद करणे) यांसाठी आवश्यक आहेत।

## मुख्य 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 आहे जांना स्पष्ट 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()` 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 लोड करणे, services शी register करणे) आणि, गंभीरपणे, shutdown वेळी **graceful cleanup** (connections बंद करणे, buffers flush करणे, in-flight work पूर्ण करणे) यांसाठी योग्य ठिकाणे प्रदान करतात।

त्यांना समजणे production reliability साठी आवश्यक आहे: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) हे सुनिश्चित करतात की setup dependencies तयार झाल्यानंतर योग्य वेळी होते, आणि **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) **graceful shutdown** enable करतात — जे आधुनिक deployment (containers/orchestrators SIGTERM constant पाठवतात deploys आणि scaling दरम्यान) मध्ये महत्वाचे आहे, आणि योग्य cleanup विना तुम्ही connections leak करता आणि active requests drop करता, zero-downtime deployments तोडता।

`onModuleInit` मध्ये connect आणि `onModuleDestroy` मध्ये disconnect करण्याचा मानक pattern (उदा. Prisma/database services साठी) रोजचा NestJS ज्ञान आहे, आणि `enableShutdownHooks()` call करण्याची सूक्ष्म आवश्यकता जाणून घेणे (किंवा shutdown hooks शांतपणे कधीही fire होत नाहीत) एक व्यावहारिक, सहज मिस होणारा तपशील आहे।

Lifecycle hooks मध्ये माहिर होणे robust, production-ready NestJS services बांधण्याचा भाग आहे जे resources आणि deployments योग्यरित्या हाताळतात।