NestJS کون سے lifecycle hooks فراہم کرتا ہے؟

Question

Accepted Answer

NestJS **lifecycle hooks** فراہم کرتا ہے — یہ methods ہیں جو آپ application یا provider کی lifecycle میں مخصوص لمحوں پر code چلانے کے لیے implement کرتے ہیں (initialization اور shutdown)۔ یہ setup (resources سے connect کرنا) اور 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 کی ترتیب

```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 کو 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 مکمل کرنا) کے لیے صحیح جگہیں فراہم کرتے ہیں۔
	uن کو سمجھنا production reliability کے لیے ضروری ہے: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) یقینی بناتے ہیں کہ setup اس وقت ہو جب dependencies تیار ہوں، اور **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) **graceful shutdown** کو enable کرتے ہیں — جو جدید deployment میں حیاتی ہے (containers/orchestrators مسلسل SIGTERM بھیجتے ہیں deploys اور scaling کے دوران، اور بغیر proper cleanup کے آپ connections leak کرتے ہیں اور active requests کو drop کرتے ہیں، zero-downtime deployments کو توڑتے ہیں)۔

`onModuleInit` میں connect کرنے اور `onModuleDestroy` میں disconnect کرنے کا معیاری pattern (مثال کے طور پر Prisma/database services کے لیے) روزمرہ NestJS knowledge ہے، اور یہ جاننا کہ `enableShutdownHooks()` کو call کرنے کی subtleties ہیں (یا shutdown hooks خاموشی سے کبھی fire نہیں ہوں گے) ایک عملی، آسانی سے miss ہونے والی تفصیل ہے۔

Lifecycle hooks میں مہارت حاصل کرنا robust، production-ready NestJS services بنانے کا حصہ ہے جو resources اور deployments کو صحیح طریقے سے handle کرتے ہیں۔