NestJS ले कुन lifecycle hooks प्रदान गर्छ?

Question

Accepted Answer

NestJS ले **lifecycle hooks** प्रदान गर्छ — यी विधिहरू हुन् जुन तपाईंले अनुप्रयोगको वा प्रदानकर्ताको जीवनचक्रको विशिष्ट क्षणमा कोड चलाउन कार्यान्वयन गर्नुहुन्छ (आरम्भीकरण र बन्द करना)। यी सेटअप (संसाधनहरूमा जडान गर्न) र सफाई (कनेक्शनहरू सुचारु ढंगले बन्द गर्न) को लागि आवश्यक हुन्छन्।

## मुख्य 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
  }
}
```

## जीवनचक्र क्रम

```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 सेवा जडान/विच्छेद गर्दै

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

यो संसाधनहरूको लागि मानक नमूना हो जुन स्पष्ट सेटअप/टियरडाउन आवश्यक हुन्छ — `onModuleInit` मा जडान गर्नुहोस्, `onModuleDestroy` मा रिलिज गर्नुहोस्।

## बन्द गर्ने hooks सक्षम गर्दै

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

बन्द गर्ने hooks केवल चल्छन् यदि तपाईंले `enableShutdownHooks()` कल गर्नुहुन्छ — यो सजिलो भूल्न सकिन्छ, त्यसपछि सफाई कहिले हुँदैन।

## सुचारु बन्द गर्ना किन महत्वपूर्ण छ

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

## किन यो महत्वपूर्ण छ

जीवनचक्र hooks NestJS अनुप्रयोगहरूमा संसाधनहरूलाई सही तरीकाले व्यवस्थापन गर्नका लागि महत्वपूर्ण छन् — यी **आरम्भीकरण** (डाटाबेस/Redis कनेक्शन खोल्न, डेटा लोड गर्न, सेवाहरूसँग दर्ता गर्न) र विशेष गरी, **सुचारु सफाई** बन्द गर्दा (कनेक्शनहरू बन्द गर्न, बफरहरू फ्लश गर्न, उडान भरिएको कामलाई समाप्त गर्न) गर्नका लागि सही ठाउँहरू प्रदान गर्छन्।

यी बुझ्न उत्पादन विश्वसनीयताको लागि आवश्यक छ: **आरम्भीकरण hooks** (`onModuleInit`, `onApplicationBootstrap`) सेटअप सुनिश्चित गर्दछ जब निर्भरताहरू तयार हुन्छन्, र **बन्द गर्ने hooks** (`onModuleDestroy`, `onApplicationShutdown`) **सुचारु बन्द गर्ना** सक्षम गर्दछ — जो आधुनिक परिनियोजनमा महत्वपूर्ण छ (कन्टेनरहरू/अর्केस्ट्रेटरहरूले SIGTERM लगातार परिनियोजन र स्केलिङको समयमा पठाउँछन्, र उचित सफाई बिना तपाईं कनेक्शनहरू फोकी दिनुहुन्छ र सक्रिय अनुरोधहरू छोड्नुहुन्छ, शून्य-डाउनटाइम परिनियोजनहरू भाँचिदिन्छ)।

`onModuleInit` मा जडान गर्ने र `onModuleDestroy` मा विच्छेद गर्ने मानक नमूना (उदाहरणका लागि Prisma/डाटाबेस सेवाहरूको लागि) दैनिक NestJS ज्ञान हो, र `enableShutdownHooks()` कल गर्नको सूक्ष्म आवश्यकता जान्न (वा बन्द गर्ने hooks साइलेन्टमा कहिले कार्य गर्दैन) एक व्यावहारिक, सजिलो-छोडिएको विवरण हो।

जीवनचक्र hooks मा महारत हासिल गर्न मजबूत, उत्पादन-तयार NestJS सेवाहरू निर्माण गर्नको भाग हो जो संसाधनहरू र परिनियोजनहरू सही तरीकाले सँभाल्छन्।