NestJS কী কী lifecycle hooks প্রদান করে?

Question

Accepted Answer

NestJS **lifecycle hooks** প্রদান করে — এগুলি এমন মেথড যা আপনি বাস্তবায়ন করেন যাতে অ্যাপ্লিকেশন বা প্রদানকারীর lifecycle-এর নির্দিষ্ট মুহূর্তে কোড চালাতে পারেন (initialization এবং shutdown)। এগুলি setup-এর জন্য অপরিহার্য (সংস্থান সংযোগ করা) এবং cleanup-এর জন্য (সংযোগ 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 সেবা সংযোগ/বিচ্ছিন্ন করা

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

এটি হল সেই সংস্থানগুলির জন্য মান pattern যাদের explicit setup/teardown প্রয়োজন — `onModuleInit`-এ সংযোগ করুন, `onModuleDestroy`-এ রিলিজ করুন।

## 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 অ্যাপ্লিকেশনে সংস্থান সঠিকভাবে পরিচালনা করার জন্য গুরুত্বপূর্ণ — এগুলি **initialization** (ডাটাবেস/Redis সংযোগ খোলা, ডেটা লোড করা, সেবার সাথে নিবন্ধন করা) এবং বিশেষত, shutdown-এ **graceful cleanup** (সংযোগ বন্ধ করা, বাফার ফ্লাশ করা, চলমান কাজ শেষ করা) সম্পাদনের সঠিক স্থান প্রদান করে।

তাদের বোঝা উৎপাদন নির্ভরযোগ্যতার জন্য অপরিহার্য: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) নিশ্চিত করে যে setup সঠিক সময়ে ঘটে একবার dependencies প্রস্তুত থাকে, এবং **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) **graceful shutdown** সক্ষম করে — যা আধুনিক deployment-এ অত্যন্ত গুরুত্বপূর্ণ (containers/orchestrators ক্রমাগত deploys এবং scaling-এর সময় SIGTERM পাঠায়, এবং যথাযথ cleanup ছাড়া আপনি সংযোগ leaks করেন এবং active requests ড্রপ করেন, zero-downtime deployments ভেঙ্গে দেন)।

`onModuleInit`-এ সংযোগ করা এবং `onModuleDestroy`-এ সংযোগ বিচ্ছিন্ন করার মান pattern (যেমন Prisma/database সেবার জন্য) প্রতিদিনের NestJS জ্ঞান, এবং `enableShutdownHooks()` কল করার সূক্ষ্ম প্রয়োজনীয়তা জানা (অথবা shutdown hooks নীরবে কখনো ফায়ার করে না) একটি ব্যবহারিক, সহজেই মিস করার যোগ্য বিবরণ।

Lifecycle hooks আয়ত্ত করা robust, production-ready NestJS সেবা তৈরির অংশ যা সংস্থান এবং deployments সঠিকভাবে পরিচালনা করে।