Hook lifecycle apa saja yang disediakan NestJS?

Question

Accepted Answer

NestJS menyediakan **lifecycle hooks** — method yang Anda implementasikan untuk menjalankan kode pada momen-momen spesifik dalam siklus hidup aplikasi atau provider (inisialisasi dan shutdown). Mereka sangat penting untuk setup (menghubungkan ke resource) dan cleanup (menutup koneksi dengan graceful).

## Hook utama

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

## Urutan 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.)
```

## Penggunaan umum: service Prisma yang 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
  }
}
```

Ini adalah pola standar untuk resource yang memerlukan setup/teardown eksplisit — connect di `onModuleInit`, release di `onModuleDestroy`.

## Mengaktifkan 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 hanya berjalan jika Anda memanggil `enableShutdownHooks()` — mudah terlupakan, kemudian cleanup tidak pernah terjadi.

## Mengapa graceful shutdown penting

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

## Mengapa ini penting

Lifecycle hooks penting untuk mengelola resource dengan benar dalam aplikasi NestJS — mereka menyediakan tempat yang tepat untuk melakukan **initialization** (membuka koneksi database/Redis, memuat data, mendaftar ke service) dan, yang kritis, **graceful cleanup** pada shutdown (menutup koneksi, flushing buffer, menyelesaikan pekerjaan yang sedang berlangsung).

Memahami mereka sangat penting untuk reliabilitas production: **initialization hooks** (`onModuleInit`, `onApplicationBootstrap`) memastikan setup terjadi pada waktu yang tepat setelah dependency siap, dan **shutdown hooks** (`onModuleDestroy`, `onApplicationShutdown`) memungkinkan **graceful shutdown** — yang vital dalam modern deployment (container/orchestrator mengirim SIGTERM terus-menerus selama deploy dan scaling, dan tanpa cleanup yang tepat Anda leak koneksi dan drop active request, memecahkan zero-downtime deployment).

Pola standar dari connect di `onModuleInit` dan disconnect di `onModuleDestroy` (contohnya untuk Prisma/database service) adalah pengetahuan sehari-hari NestJS, dan mengetahui persyaratan subtle untuk memanggil `enableShutdownHooks()` (atau shutdown hooks akan silent tidak fire) adalah detail praktis yang mudah terlewatkan.

Menguasai lifecycle hooks adalah bagian dari membangun service NestJS yang robust dan production-ready yang menangani resource dan deployment dengan benar.