nestelia proporciona hooks de ciclo de vida que te permiten ejecutar lógica en puntos específicos durante el arranque y el apagado de la aplicación.

Hooks del Ciclo de Vida del Módulo

Implementa estas interfaces en tus servicios @Injectable() o controladores:

OnModuleInit

Se llama una vez que todos los proveedores de todos los módulos han sido instanciados. Esto garantiza que cualquier proveedor puede obtenerse de forma segura mediante ModuleRef en este momento:

import { Injectable, OnModuleInit } from "nestelia";

@Injectable()
class DatabaseService implements OnModuleInit {
  async onModuleInit() {
    await this.connect();
    console.log("Database connected");
  }
}

Puedes usar ModuleRef para obtener dinámicamente otro proveedor dentro de onModuleInit:

import { Injectable, ModuleRef, OnModuleInit } from "nestelia";

@Injectable()
class CacheService implements OnModuleInit {
  constructor(private moduleRef: ModuleRef) {}

  onModuleInit() {
    const db = this.moduleRef.get(DatabaseService);
    console.log(`Cache connected to ${db.getUrl()}`);
  }
}

OnApplicationBootstrap

Se llama una vez, después de que todos los módulos han sido inicializados (todos los hooks onModuleInit se han ejecutado). Se dispara durante createElysiaApplication() — no necesitas llamar a listen() para que se ejecute, por lo que también funciona en configuraciones serverless y getHttpServer().handle():

@Injectable()
class AppService implements OnApplicationBootstrap {
  async onApplicationBootstrap() {
    console.log("Application is ready");
  }
}

OnModuleDestroy

Se llama cuando el módulo está siendo destruido (durante el apagado):

@Injectable()
class CacheService implements OnModuleDestroy {
  async onModuleDestroy() {
    await this.cache.flush();
  }
}

BeforeApplicationShutdown

Se llama antes de que la aplicación comience a apagarse. Recibe la señal que desencadenó el apagado:

@Injectable()
class GracefulService implements BeforeApplicationShutdown {
  async beforeApplicationShutdown(signal?: string) {
    console.log(`Shutting down due to: ${signal}`);
    await this.drainRequests();
  }
}

OnApplicationShutdown

Se llama después de que todos los módulos han sido destruidos:

@Injectable()
class CleanupService implements OnApplicationShutdown {
  async onApplicationShutdown(signal?: string) {
    await this.releaseResources();
  }
}

Orden de Ejecución

Durante el arranque (dentro de createElysiaApplication()):

1. OnModuleInit — después de que todos los proveedores son instanciados
2. OnApplicationBootstrap — una vez, después de que todos los módulos han sido inicializados

Durante el apagado (dentro de app.close()):

1. OnModuleDestroy
2. BeforeApplicationShutdown
3. OnApplicationShutdown

Garantías

• Cada hook se dispara para cada proveedor. Un proveedor recibe cada hook que implementa de forma independiente — no necesitas implementar también onModuleInit para que se ejecuten los demás hooks.
• El bootstrap se ejecuta en la inicialización. OnApplicationBootstrap se dispara una vez durante createElysiaApplication() y es idempotente, por lo que un app.listen() posterior no lo ejecutará dos veces.
• Los hooks de apagado requieren app.close(). OnModuleDestroy, BeforeApplicationShutdown y OnApplicationShutdown se ejecutan cuando llamas a app.close().

Decoradores de Ciclo de Vida de Elysia

nestelia también expone los hooks del ciclo de vida de solicitudes de Elysia como decoradores de métodos en los controladores:

import {
  OnRequest,
  OnBeforeHandle,
  OnAfterHandle,
  OnAfterResponse,
  OnError,
} from "nestelia";

@Controller("/")
class AppController {
  @OnRequest()
  logRequest(ctx: any) {
    console.log(`${ctx.request.method} ${ctx.request.url}`);
  }

  @OnBeforeHandle()
  checkAuth(ctx: any) {
    // se ejecuta antes del manejador de ruta
  }

  @OnAfterHandle()
  addHeaders(ctx: any) {
    ctx.set.headers["x-powered-by"] = "nestelia";
  }

  @OnError()
  handleError(ctx: any) {
    console.error("Error:", ctx.error);
  }

  @OnAfterResponse()
  logResponse(ctx: any) {
    console.log("Response sent");
  }
}

Decoradores de ciclo de vida de Elysia disponibles:

Decorador	Hook
@OnRequest()	Antes del enrutamiento
@OnParse()	Parseo del cuerpo
@OnTransform()	Transformar solicitud
@OnBeforeHandle()	Antes del manejador
@OnAfterHandle()	Después del manejador
@OnMapResponse()	Mapear respuesta
@OnAfterResponse()	Después de enviar la respuesta
@OnError()	Manejador de errores