@warlock.js/core 4.3.0 → 4.4.0

package/CHANGELOG.md

@@ -4,7 +4,22 @@ All notable changes to `@warlock.js/core` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
-## [Unreleased]
+## 4.4.0 - 2026-06-21
+
+### Added
+
+- `Application.onceBooted(cb)` — run a callback once the app is fully booted (fires immediately if already booted)
+- `Application.whenBooted()` — promise that resolves with the boot context when the app is fully booted
+- `Application.isBooted` — whether the app has finished booting
+- `Application.onShutdown(cb)` — run teardown once on shutdown, before connectors stop (mirror of `onceBooted`)
+- `Application.isShuttingDown` — whether shutdown has begun
+- built-in `/health` (liveness) and `/ready` (readiness) endpoints with a `health` check registry (`health.addCheck`)
+- graceful HTTP shutdown — drains in-flight requests on shutdown, bounded by `http.gracefulShutdown.timeout`
+- `http.health.*` config to toggle or rename the health endpoints
+
+### Fixed
+
+- connector shutdown no longer reverses the connector list in place (could corrupt order on a repeated shutdown)
 
 ## 4.3.0 - 2026-06-21
 

package/esm/application/application.d.mts

@@ -1,6 +1,33 @@
-import { Environment } from "../utils/environment.mjs";
+import { Environment, RuntimeStrategy } from "../utils/environment.mjs";
 
 //#region ../@warlock.js/core/src/application/application.d.ts
+/**
+ * Snapshot of the global facts known the moment the application finished
+ * booting: every connector (early + late) is active and all app files
+ * (locales, events, main, routes) are loaded. Passed to every
+ * `Application.onceBooted` listener and resolved from `Application.whenBooted`.
+ */
+type BootContext = {
+  environment: Environment;
+  runtimeStrategy: RuntimeStrategy;
+  /**
+   * Wall-clock milliseconds the boot took. The dev server measures it; the
+   * production entry omits it.
+   */
+  bootDurationMs?: number;
+};
+/**
+ * A callback registered through `Application.onceBooted`. May be async — its
+ * rejection is caught and logged so a single listener can never break boot or
+ * the other listeners.
+ */
+type BootListener = (context: BootContext) => void | Promise<void>;
+/**
+ * A callback registered through `Application.onShutdown`. Runs once, while the
+ * connectors (db, cache, http) are still up, so it can release app-owned
+ * resources cleanly. May be async — its rejection is caught and logged.
+ */
+type ShutdownListener = () => void | Promise<void>;
 declare class Application {
   /**
    * Project start time regarding the process start time
@@ -9,7 +36,29 @@ declare class Application {
   /**
    * Runtime strategy
    */
-  static runtimeStrategy: "production" | "development";
+  static runtimeStrategy: RuntimeStrategy;
+  /**
+   * Whether the application has finished booting. Flipped once by `markBooted`.
+   */
+  private static booted;
+  /**
+   * The boot context, set once booted so it can be replayed to late subscribers.
+   */
+  private static bootContext;
+  /**
+   * Listeners queued before boot completed, drained in registration order by
+   * `markBooted`.
+   */
+  private static bootListeners;
+  /**
+   * Whether the application has begun (or finished) shutting down. Flipped once
+   * by `runShutdownHooks`.
+   */
+  private static shuttingDown;
+  /**
+   * Teardown callbacks, run once when shutdown begins.
+   */
+  private static shutdownListeners;
   /**
    * Get framework version
    */
@@ -17,7 +66,80 @@ declare class Application {
   /**
    * Set the runtime strategy
    */
-  static setRuntimeStrategy(strategy: "production" | "development"): void;
+  static setRuntimeStrategy(strategy: RuntimeStrategy): void;
+  /**
+   * Whether the application has finished booting — every connector in both
+   * the early and late phases is active and all app files (locales, events,
+   * main, routes) have been loaded.
+   */
+  static get isBooted(): boolean;
+  /**
+   * Run a callback once the application is fully booted.
+   *
+   * App files (`main` / `events` / `routes` / locales) are imported BEFORE the
+   * late-phase connectors (http, socket) start, so a listener registered at
+   * import time waits for the whole sequence to finish before it runs. If the
+   * application is already booted, the callback runs on the next microtask —
+   * so a late subscriber never silently misses the event.
+   *
+   * @example
+   * Application.onceBooted(({ environment }) => {
+   *   log.info("app", "booted", `ready in ${environment}`);
+   * });
+   */
+  static onceBooted(listener: BootListener): void;
+  /**
+   * Promise form of {@link onceBooted} — resolves with the boot context once
+   * the application is booted, or immediately if it already is.
+   */
+  static whenBooted(): Promise<BootContext>;
+  /**
+   * Flip the boot latch and drain every queued listener. The dev server and
+   * the production entry call this once, right after the late phase starts. It
+   * is idempotent — a second call is a no-op, so a double-invoke can never
+   * double-fire listeners.
+   *
+   * @internal Framework entry points call this; application code must not.
+   */
+  static markBooted(context: BootContext): void;
+  /**
+   * Invoke a single boot listener, isolating its failure so neither boot nor
+   * the remaining listeners are affected.
+   */
+  private static runBootListener;
+  /**
+   * Whether the application has begun shutting down. Once true, readiness
+   * checks report not-ready so a load balancer drains this instance before the
+   * HTTP server stops accepting requests.
+   */
+  static get isShuttingDown(): boolean;
+  /**
+   * Register a teardown callback, run once when the application shuts down —
+   * before the connectors (db, cache, http) are torn down, so it can still use
+   * them. The natural place to close an app-owned resource opened in
+   * `onceBooted`. If shutdown has already begun, the callback runs immediately.
+   *
+   * @example
+   * Application.onShutdown(async () => {
+   *   await myQueueConsumer.stop();
+   * });
+   */
+  static onShutdown(listener: ShutdownListener): void;
+  /**
+   * Flip the shutdown latch and run every teardown callback. The connectors
+   * manager calls this at the start of shutdown — before any connector is torn
+   * down. Idempotent and error-isolated: each callback is awaited, a thrown one
+   * is logged and does not stop the rest. Listeners run LIFO (reverse of
+   * registration), mirroring resource-unwind order.
+   *
+   * @internal Framework entry points call this; application code must not.
+   */
+  static runShutdownHooks(): Promise<void>;
+  /**
+   * Invoke a single teardown callback, isolating its failure so the rest still
+   * run and shutdown is never blocked by one bad hook.
+   */
+  private static runShutdownListener;
   /**
    * Get project uptime in milliseconds
    */
@@ -68,5 +190,5 @@ declare class Application {
   static get publicPath(): string;
 }
 //#endregion
-export { Application };
+export { Application, BootContext, BootListener, ShutdownListener };
 //# sourceMappingURL=application.d.mts.map

package/esm/application/application.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/application/application.ts"],"mappings":";;;cAIa,WAAA;;AAAb;;kBAIyB,SAAA,EAAS,IAAA;EAAA;;;EAAA,OAKlB,eAAA;EAiC+B;;;EAAA,WA5B3B,OAAA;EAAA;;;EAAA,OAOJ,kBAAA,CAAmB,QAAA;EAcf;;;EAAA,WAPA,MAAA;EAcW;;;EAAA,WAPX,WAAA,IAAe,WAAA;EAmCf;;;EAAA,OA5BJ,cAAA,CAAe,GAAA,EAAK,WAAA;EAwDhB;;;EAAA,WAjDA,YAAA;;;;aAOA,aAAA;;;;aAOA,MAAA;;;;aAOA,QAAA;;;;aAOA,OAAA;;;;aAOA,OAAA;;;;aAOA,WAAA;;;;aAOA,WAAA;;;;aAOA,UAAA;AAAA"}
+{"version":3,"file":"application.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/application/application.ts"],"mappings":";;;;;AAgBA;;;;KAAY,WAAA;EACV,WAAA,EAAa,WAAA;EACb,eAAA,EAAiB,eAAe;EAAf;;;AAKH;EAAd,cAAA;AAAA;;;;;;KAQU,YAAA,IAAgB,OAAA,EAAS,WAAA,YAAuB,OAAO;AAAA;AAOnE;;;;AAPmE,KAOvD,gBAAA,gBAAgC,OAAO;AAAA,cAEtC,WAAA;EAAW;;;EAAA,gBAIC,SAAA,EAAS,IAAA;EA4CW;;;EAAA,OAvC7B,eAAA,EAAiB,eAAA;EAmGG;;;EAAA,eA9FnB,MAAA;EAgNmB;;;EAAA,eA3MnB,WAAA;EAfiB;;;;EAAA,eAqBjB,aAAA;EAAA;;;;EAAA,eAMA,YAAA;EAiB4B;;;EAAA,eAZ5B,iBAAA;EAuCoB;;;EAAA,WAlCjB,OAAA;EAiDkB;;;EAAA,OA1CtB,kBAAA,CAAmB,QAAA,EAAU,eAAA;EAgFtB;;;;;EAAA,WAvEH,QAAA;EAyHsB;;;;;;;;;;;;;;EAAA,OAvG1B,UAAA,CAAW,QAAA,EAAU,YAAA;EA2MjB;;;AAOU;EAPV,OA5LJ,UAAA,IAAc,OAAA,CAAQ,WAAA;;;;;;;;;SAkBtB,UAAA,CAAW,OAAA,EAAS,WAAA;;;;;iBAoBb,eAAA;;;;;;aAgBH,cAAA;;;;;;;;;;;;SAeJ,UAAA,CAAW,QAAA,EAAU,gBAAA;;;;;;;;;;SAmBf,gBAAA,IAAoB,OAAA;;;;;iBAmBnB,mBAAA;;;;aAWH,MAAA;;;;aAOA,WAAA,IAAe,WAAA;;;;SAOnB,cAAA,CAAe,GAAA,EAAK,WAAA;;;;aAOhB,YAAA;;;;aAOA,aAAA;;;;aAOA,MAAA;;;;aAOA,QAAA;;;;aAOA,OAAA;;;;aAOA,OAAA;;;;aAOA,WAAA;;;;aAOA,WAAA;;;;aAOA,UAAA;AAAA"}

package/esm/application/application.mjs

@@ -1,12 +1,25 @@
 import { environment, setEnvironment } from "../utils/environment.mjs";
 import { appPath, publicPath, rootPath, srcPath, storagePath, uploadsPath } from "../utils/paths.mjs";
 import { getFrameworkVersion } from "../utils/framework-vesion.mjs";
+import { log } from "@warlock.js/logger";
 
 //#region ../@warlock.js/core/src/application/application.ts
 var Application = class {
 	static {
 		this.startedAt = /* @__PURE__ */ new Date(Date.now() - process.uptime() * 1e3);
 	}
+	static {
+		this.booted = false;
+	}
+	static {
+		this.bootListeners = [];
+	}
+	static {
+		this.shuttingDown = false;
+	}
+	static {
+		this.shutdownListeners = [];
+	}
 	/**
 	* Get framework version
 	*/
@@ -20,6 +33,126 @@ var Application = class {
 		this.runtimeStrategy = strategy;
 	}
 	/**
+	* Whether the application has finished booting — every connector in both
+	* the early and late phases is active and all app files (locales, events,
+	* main, routes) have been loaded.
+	*/
+	static get isBooted() {
+		return this.booted;
+	}
+	/**
+	* Run a callback once the application is fully booted.
+	*
+	* App files (`main` / `events` / `routes` / locales) are imported BEFORE the
+	* late-phase connectors (http, socket) start, so a listener registered at
+	* import time waits for the whole sequence to finish before it runs. If the
+	* application is already booted, the callback runs on the next microtask —
+	* so a late subscriber never silently misses the event.
+	*
+	* @example
+	* Application.onceBooted(({ environment }) => {
+	*   log.info("app", "booted", `ready in ${environment}`);
+	* });
+	*/
+	static onceBooted(listener) {
+		if (this.booted && this.bootContext) {
+			const context = this.bootContext;
+			this.runBootListener(listener, context);
+			return;
+		}
+		this.bootListeners.push(listener);
+	}
+	/**
+	* Promise form of {@link onceBooted} — resolves with the boot context once
+	* the application is booted, or immediately if it already is.
+	*/
+	static whenBooted() {
+		if (this.booted && this.bootContext) return Promise.resolve(this.bootContext);
+		return new Promise((resolve) => {
+			this.onceBooted((context) => resolve(context));
+		});
+	}
+	/**
+	* Flip the boot latch and drain every queued listener. The dev server and
+	* the production entry call this once, right after the late phase starts. It
+	* is idempotent — a second call is a no-op, so a double-invoke can never
+	* double-fire listeners.
+	*
+	* @internal Framework entry points call this; application code must not.
+	*/
+	static markBooted(context) {
+		if (this.booted) return;
+		this.booted = true;
+		this.bootContext = context;
+		const listeners = this.bootListeners;
+		this.bootListeners = [];
+		for (const listener of listeners) this.runBootListener(listener, context);
+	}
+	/**
+	* Invoke a single boot listener, isolating its failure so neither boot nor
+	* the remaining listeners are affected.
+	*/
+	static async runBootListener(listener, context) {
+		try {
+			await listener(context);
+		} catch (error) {
+			log.error("application", "booted-listener", error);
+		}
+	}
+	/**
+	* Whether the application has begun shutting down. Once true, readiness
+	* checks report not-ready so a load balancer drains this instance before the
+	* HTTP server stops accepting requests.
+	*/
+	static get isShuttingDown() {
+		return this.shuttingDown;
+	}
+	/**
+	* Register a teardown callback, run once when the application shuts down —
+	* before the connectors (db, cache, http) are torn down, so it can still use
+	* them. The natural place to close an app-owned resource opened in
+	* `onceBooted`. If shutdown has already begun, the callback runs immediately.
+	*
+	* @example
+	* Application.onShutdown(async () => {
+	*   await myQueueConsumer.stop();
+	* });
+	*/
+	static onShutdown(listener) {
+		if (this.shuttingDown) {
+			this.runShutdownListener(listener);
+			return;
+		}
+		this.shutdownListeners.push(listener);
+	}
+	/**
+	* Flip the shutdown latch and run every teardown callback. The connectors
+	* manager calls this at the start of shutdown — before any connector is torn
+	* down. Idempotent and error-isolated: each callback is awaited, a thrown one
+	* is logged and does not stop the rest. Listeners run LIFO (reverse of
+	* registration), mirroring resource-unwind order.
+	*
+	* @internal Framework entry points call this; application code must not.
+	*/
+	static async runShutdownHooks() {
+		if (this.shuttingDown) return;
+		this.shuttingDown = true;
+		const listeners = this.shutdownListeners.reverse();
+		this.shutdownListeners = [];
+		for (const listener of listeners) await this.runShutdownListener(listener);
+	}
+	/**
+	* Invoke a single teardown callback, isolating its failure so the rest still
+	* run and shutdown is never blocked by one bad hook.
+	*/
+	static async runShutdownListener(listener) {
+		try {
+			await listener();
+		} catch (error) {
+			log.error("application", "shutdown-listener", error);
+		}
+	}
+	/**
 	* Get project uptime in milliseconds
 	*/
 	static get uptime() {

package/esm/application/application.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"application.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/application/application.ts"],"sourcesContent":["import { environment, setEnvironment, type Environment } from \"../utils/environment\";\nimport { getFrameworkVersion } from \"../utils/framework-vesion\";\nimport { appPath, publicPath, rootPath, srcPath, storagePath, uploadsPath } from \"../utils/paths\";\n\nexport class Application {\n  /**\n   * Project start time regarding the process start time\n   */\n  public static readonly startedAt = new Date(Date.now() - process.uptime() * 1000);\n\n  /**\n   * Runtime strategy\n   */\n  public static runtimeStrategy: \"production\" | \"development\";\n\n  /**\n   * Get framework version\n   */\n  public static get version() {\n    return getFrameworkVersion();\n  }\n\n  /**\n   * Set the runtime strategy\n   */\n  public static setRuntimeStrategy(strategy: \"production\" | \"development\") {\n    this.runtimeStrategy = strategy;\n  }\n\n  /**\n   * Get project uptime in milliseconds\n   */\n  public static get uptime(): number {\n    return process.uptime() * 1000;\n  }\n\n  /**\n   * Get the current environment\n   */\n  public static get environment(): Environment {\n    return environment();\n  }\n\n  /**\n   * Set the current environment\n   */\n  public static setEnvironment(env: Environment) {\n    setEnvironment(env);\n  }\n\n  /**\n   * Check if the application is running in production environment\n   */\n  public static get isProduction(): boolean {\n    return this.environment === \"production\";\n  }\n\n  /**\n   * Check if the application is running in development environment\n   */\n  public static get isDevelopment(): boolean {\n    return this.environment === \"development\";\n  }\n\n  /**\n   * Check if the application is running in test environment\n   */\n  public static get isTest(): boolean {\n    return this.environment === \"test\";\n  }\n\n  /**\n   * Get the root path\n   */\n  public static get rootPath(): string {\n    return rootPath();\n  }\n\n  /**\n   * Get the src path\n   */\n  public static get srcPath(): string {\n    return srcPath();\n  }\n\n  /**\n   * Get the app path\n   */\n  public static get appPath(): string {\n    return appPath();\n  }\n\n  /**\n   * Get the storage path\n   */\n  public static get storagePath(): string {\n    return storagePath();\n  }\n\n  /**\n   * Get the uploads path\n   */\n  public static get uploadsPath(): string {\n    return uploadsPath();\n  }\n\n  /**\n   * Get the public path\n   */\n  public static get publicPath(): string {\n    return publicPath();\n  }\n}\n"],"mappings":";;;;;AAIA,IAAa,cAAb,MAAyB;;mCAIY,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,OAAO,IAAI,GAAI;;;;;CAUhF,WAAkB,UAAU;EAC1B,OAAO,oBAAoB;CAC7B;;;;CAKA,OAAc,mBAAmB,UAAwC;EACvE,KAAK,kBAAkB;CACzB;;;;CAKA,WAAkB,SAAiB;EACjC,OAAO,QAAQ,OAAO,IAAI;CAC5B;;;;CAKA,WAAkB,cAA2B;EAC3C,OAAO,YAAY;CACrB;;;;CAKA,OAAc,eAAe,KAAkB;EAC7C,eAAe,GAAG;CACpB;;;;CAKA,WAAkB,eAAwB;EACxC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,gBAAyB;EACzC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,SAAkB;EAClC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,WAAmB;EACnC,OAAO,SAAS;CAClB;;;;CAKA,WAAkB,UAAkB;EAClC,OAAO,QAAQ;CACjB;;;;CAKA,WAAkB,UAAkB;EAClC,OAAO,QAAQ;CACjB;;;;CAKA,WAAkB,cAAsB;EACtC,OAAO,YAAY;CACrB;;;;CAKA,WAAkB,cAAsB;EACtC,OAAO,YAAY;CACrB;;;;CAKA,WAAkB,aAAqB;EACrC,OAAO,WAAW;CACpB;AACF"}
+{"version":3,"file":"application.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/application/application.ts"],"sourcesContent":["import { log } from \"@warlock.js/logger\";\nimport {\n  environment,\n  setEnvironment,\n  type Environment,\n  type RuntimeStrategy,\n} from \"../utils/environment\";\nimport { getFrameworkVersion } from \"../utils/framework-vesion\";\nimport { appPath, publicPath, rootPath, srcPath, storagePath, uploadsPath } from \"../utils/paths\";\n\n/**\n * Snapshot of the global facts known the moment the application finished\n * booting: every connector (early + late) is active and all app files\n * (locales, events, main, routes) are loaded. Passed to every\n * `Application.onceBooted` listener and resolved from `Application.whenBooted`.\n */\nexport type BootContext = {\n  environment: Environment;\n  runtimeStrategy: RuntimeStrategy;\n  /**\n   * Wall-clock milliseconds the boot took. The dev server measures it; the\n   * production entry omits it.\n   */\n  bootDurationMs?: number;\n};\n\n/**\n * A callback registered through `Application.onceBooted`. May be async — its\n * rejection is caught and logged so a single listener can never break boot or\n * the other listeners.\n */\nexport type BootListener = (context: BootContext) => void | Promise<void>;\n\n/**\n * A callback registered through `Application.onShutdown`. Runs once, while the\n * connectors (db, cache, http) are still up, so it can release app-owned\n * resources cleanly. May be async — its rejection is caught and logged.\n */\nexport type ShutdownListener = () => void | Promise<void>;\n\nexport class Application {\n  /**\n   * Project start time regarding the process start time\n   */\n  public static readonly startedAt = new Date(Date.now() - process.uptime() * 1000);\n\n  /**\n   * Runtime strategy\n   */\n  public static runtimeStrategy: RuntimeStrategy;\n\n  /**\n   * Whether the application has finished booting. Flipped once by `markBooted`.\n   */\n  private static booted = false;\n\n  /**\n   * The boot context, set once booted so it can be replayed to late subscribers.\n   */\n  private static bootContext: BootContext | undefined;\n\n  /**\n   * Listeners queued before boot completed, drained in registration order by\n   * `markBooted`.\n   */\n  private static bootListeners: BootListener[] = [];\n\n  /**\n   * Whether the application has begun (or finished) shutting down. Flipped once\n   * by `runShutdownHooks`.\n   */\n  private static shuttingDown = false;\n\n  /**\n   * Teardown callbacks, run once when shutdown begins.\n   */\n  private static shutdownListeners: ShutdownListener[] = [];\n\n  /**\n   * Get framework version\n   */\n  public static get version() {\n    return getFrameworkVersion();\n  }\n\n  /**\n   * Set the runtime strategy\n   */\n  public static setRuntimeStrategy(strategy: RuntimeStrategy) {\n    this.runtimeStrategy = strategy;\n  }\n\n  /**\n   * Whether the application has finished booting — every connector in both\n   * the early and late phases is active and all app files (locales, events,\n   * main, routes) have been loaded.\n   */\n  public static get isBooted(): boolean {\n    return this.booted;\n  }\n\n  /**\n   * Run a callback once the application is fully booted.\n   *\n   * App files (`main` / `events` / `routes` / locales) are imported BEFORE the\n   * late-phase connectors (http, socket) start, so a listener registered at\n   * import time waits for the whole sequence to finish before it runs. If the\n   * application is already booted, the callback runs on the next microtask —\n   * so a late subscriber never silently misses the event.\n   *\n   * @example\n   * Application.onceBooted(({ environment }) => {\n   *   log.info(\"app\", \"booted\", `ready in ${environment}`);\n   * });\n   */\n  public static onceBooted(listener: BootListener): void {\n    if (this.booted && this.bootContext) {\n      const context = this.bootContext;\n      void this.runBootListener(listener, context);\n\n      return;\n    }\n\n    this.bootListeners.push(listener);\n  }\n\n  /**\n   * Promise form of {@link onceBooted} — resolves with the boot context once\n   * the application is booted, or immediately if it already is.\n   */\n  public static whenBooted(): Promise<BootContext> {\n    if (this.booted && this.bootContext) {\n      return Promise.resolve(this.bootContext);\n    }\n\n    return new Promise<BootContext>((resolve) => {\n      this.onceBooted((context) => resolve(context));\n    });\n  }\n\n  /**\n   * Flip the boot latch and drain every queued listener. The dev server and\n   * the production entry call this once, right after the late phase starts. It\n   * is idempotent — a second call is a no-op, so a double-invoke can never\n   * double-fire listeners.\n   *\n   * @internal Framework entry points call this; application code must not.\n   */\n  public static markBooted(context: BootContext): void {\n    if (this.booted) {\n      return;\n    }\n\n    this.booted = true;\n    this.bootContext = context;\n\n    const listeners = this.bootListeners;\n    this.bootListeners = [];\n\n    for (const listener of listeners) {\n      void this.runBootListener(listener, context);\n    }\n  }\n\n  /**\n   * Invoke a single boot listener, isolating its failure so neither boot nor\n   * the remaining listeners are affected.\n   */\n  private static async runBootListener(\n    listener: BootListener,\n    context: BootContext,\n  ): Promise<void> {\n    try {\n      await listener(context);\n    } catch (error) {\n      log.error(\"application\", \"booted-listener\", error as Error);\n    }\n  }\n\n  /**\n   * Whether the application has begun shutting down. Once true, readiness\n   * checks report not-ready so a load balancer drains this instance before the\n   * HTTP server stops accepting requests.\n   */\n  public static get isShuttingDown(): boolean {\n    return this.shuttingDown;\n  }\n\n  /**\n   * Register a teardown callback, run once when the application shuts down —\n   * before the connectors (db, cache, http) are torn down, so it can still use\n   * them. The natural place to close an app-owned resource opened in\n   * `onceBooted`. If shutdown has already begun, the callback runs immediately.\n   *\n   * @example\n   * Application.onShutdown(async () => {\n   *   await myQueueConsumer.stop();\n   * });\n   */\n  public static onShutdown(listener: ShutdownListener): void {\n    if (this.shuttingDown) {\n      void this.runShutdownListener(listener);\n\n      return;\n    }\n\n    this.shutdownListeners.push(listener);\n  }\n\n  /**\n   * Flip the shutdown latch and run every teardown callback. The connectors\n   * manager calls this at the start of shutdown — before any connector is torn\n   * down. Idempotent and error-isolated: each callback is awaited, a thrown one\n   * is logged and does not stop the rest. Listeners run LIFO (reverse of\n   * registration), mirroring resource-unwind order.\n   *\n   * @internal Framework entry points call this; application code must not.\n   */\n  public static async runShutdownHooks(): Promise<void> {\n    if (this.shuttingDown) {\n      return;\n    }\n\n    this.shuttingDown = true;\n\n    const listeners = this.shutdownListeners.reverse();\n    this.shutdownListeners = [];\n\n    for (const listener of listeners) {\n      await this.runShutdownListener(listener);\n    }\n  }\n\n  /**\n   * Invoke a single teardown callback, isolating its failure so the rest still\n   * run and shutdown is never blocked by one bad hook.\n   */\n  private static async runShutdownListener(listener: ShutdownListener): Promise<void> {\n    try {\n      await listener();\n    } catch (error) {\n      log.error(\"application\", \"shutdown-listener\", error as Error);\n    }\n  }\n\n  /**\n   * Get project uptime in milliseconds\n   */\n  public static get uptime(): number {\n    return process.uptime() * 1000;\n  }\n\n  /**\n   * Get the current environment\n   */\n  public static get environment(): Environment {\n    return environment();\n  }\n\n  /**\n   * Set the current environment\n   */\n  public static setEnvironment(env: Environment) {\n    setEnvironment(env);\n  }\n\n  /**\n   * Check if the application is running in production environment\n   */\n  public static get isProduction(): boolean {\n    return this.environment === \"production\";\n  }\n\n  /**\n   * Check if the application is running in development environment\n   */\n  public static get isDevelopment(): boolean {\n    return this.environment === \"development\";\n  }\n\n  /**\n   * Check if the application is running in test environment\n   */\n  public static get isTest(): boolean {\n    return this.environment === \"test\";\n  }\n\n  /**\n   * Get the root path\n   */\n  public static get rootPath(): string {\n    return rootPath();\n  }\n\n  /**\n   * Get the src path\n   */\n  public static get srcPath(): string {\n    return srcPath();\n  }\n\n  /**\n   * Get the app path\n   */\n  public static get appPath(): string {\n    return appPath();\n  }\n\n  /**\n   * Get the storage path\n   */\n  public static get storagePath(): string {\n    return storagePath();\n  }\n\n  /**\n   * Get the uploads path\n   */\n  public static get uploadsPath(): string {\n    return uploadsPath();\n  }\n\n  /**\n   * Get the public path\n   */\n  public static get publicPath(): string {\n    return publicPath();\n  }\n}\n"],"mappings":";;;;;;AAwCA,IAAa,cAAb,MAAyB;;mCAIY,IAAI,KAAK,KAAK,IAAI,IAAI,QAAQ,OAAO,IAAI,GAAI;;;gBAUxD;;;uBAWuB,CAAC;;;sBAMlB;;;2BAKyB,CAAC;;;;;CAKxD,WAAkB,UAAU;EAC1B,OAAO,oBAAoB;CAC7B;;;;CAKA,OAAc,mBAAmB,UAA2B;EAC1D,KAAK,kBAAkB;CACzB;;;;;;CAOA,WAAkB,WAAoB;EACpC,OAAO,KAAK;CACd;;;;;;;;;;;;;;;CAgBA,OAAc,WAAW,UAA8B;EACrD,IAAI,KAAK,UAAU,KAAK,aAAa;GACnC,MAAM,UAAU,KAAK;GACrB,AAAK,KAAK,gBAAgB,UAAU,OAAO;GAE3C;EACF;EAEA,KAAK,cAAc,KAAK,QAAQ;CAClC;;;;;CAMA,OAAc,aAAmC;EAC/C,IAAI,KAAK,UAAU,KAAK,aACtB,OAAO,QAAQ,QAAQ,KAAK,WAAW;EAGzC,OAAO,IAAI,SAAsB,YAAY;GAC3C,KAAK,YAAY,YAAY,QAAQ,OAAO,CAAC;EAC/C,CAAC;CACH;;;;;;;;;CAUA,OAAc,WAAW,SAA4B;EACnD,IAAI,KAAK,QACP;EAGF,KAAK,SAAS;EACd,KAAK,cAAc;EAEnB,MAAM,YAAY,KAAK;EACvB,KAAK,gBAAgB,CAAC;EAEtB,KAAK,MAAM,YAAY,WACrB,AAAK,KAAK,gBAAgB,UAAU,OAAO;CAE/C;;;;;CAMA,aAAqB,gBACnB,UACA,SACe;EACf,IAAI;GACF,MAAM,SAAS,OAAO;EACxB,SAAS,OAAO;GACd,IAAI,MAAM,eAAe,mBAAmB,KAAc;EAC5D;CACF;;;;;;CAOA,WAAkB,iBAA0B;EAC1C,OAAO,KAAK;CACd;;;;;;;;;;;;CAaA,OAAc,WAAW,UAAkC;EACzD,IAAI,KAAK,cAAc;GACrB,AAAK,KAAK,oBAAoB,QAAQ;GAEtC;EACF;EAEA,KAAK,kBAAkB,KAAK,QAAQ;CACtC;;;;;;;;;;CAWA,aAAoB,mBAAkC;EACpD,IAAI,KAAK,cACP;EAGF,KAAK,eAAe;EAEpB,MAAM,YAAY,KAAK,kBAAkB,QAAQ;EACjD,KAAK,oBAAoB,CAAC;EAE1B,KAAK,MAAM,YAAY,WACrB,MAAM,KAAK,oBAAoB,QAAQ;CAE3C;;;;;CAMA,aAAqB,oBAAoB,UAA2C;EAClF,IAAI;GACF,MAAM,SAAS;EACjB,SAAS,OAAO;GACd,IAAI,MAAM,eAAe,qBAAqB,KAAc;EAC9D;CACF;;;;CAKA,WAAkB,SAAiB;EACjC,OAAO,QAAQ,OAAO,IAAI;CAC5B;;;;CAKA,WAAkB,cAA2B;EAC3C,OAAO,YAAY;CACrB;;;;CAKA,OAAc,eAAe,KAAkB;EAC7C,eAAe,GAAG;CACpB;;;;CAKA,WAAkB,eAAwB;EACxC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,gBAAyB;EACzC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,SAAkB;EAClC,OAAO,KAAK,gBAAgB;CAC9B;;;;CAKA,WAAkB,WAAmB;EACnC,OAAO,SAAS;CAClB;;;;CAKA,WAAkB,UAAkB;EAClC,OAAO,QAAQ;CACjB;;;;CAKA,WAAkB,UAAkB;EAClC,OAAO,QAAQ;CACjB;;;;CAKA,WAAkB,cAAsB;EACtC,OAAO,YAAY;CACrB;;;;CAKA,WAAkB,cAAsB;EACtC,OAAO,YAAY;CACrB;;;;CAKA,WAAkB,aAAqB;EACrC,OAAO,WAAW;CACpB;AACF"}

package/esm/application/index.d.mts

@@ -1,3 +1,3 @@
 import { app } from "./app.mjs";
-import { Application } from "./application.mjs";
+import { Application, BootContext, BootListener, ShutdownListener } from "./application.mjs";
 import { AppConfigurations } from "./application-config-types.mjs";

package/esm/cli/types.d.mts

@@ -1,3 +1,4 @@
+import { RuntimeStrategy } from "../utils/environment.mjs";
 import { ConnectorName } from "../connectors/types.mjs";
 //#region ../@warlock.js/core/src/cli/types.d.ts
 /**
@@ -68,7 +69,7 @@ type CLICommandPreload = {
   /**
    * Set runtime strategy
    */
-  runtimeStrategy?: "production" | "development";
+  runtimeStrategy?: RuntimeStrategy;
   /**
    * Override current detect environment
    */

package/esm/cli/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/cli/types.ts"],"mappings":";;;;AAe4B;AAY5B;;;;KAZY,gBAAA;;;;AAwBK;AAsBjB;;;;;;KAlCY,iBAAA;EAuDV;;;;EAlDA,IAAA;EA4Ea;;AAAa;AAgB5B;;EArFE,OAAA,EAAS,MAAM;AAAA;;;;;;;;;AA4HP;AAGV;;;;;;;;;AAEO;KA3GK,iBAAA;EAkHgB;;;;;EA5G1B,MAAA;EA4GwE;AAAA;AAsB1E;EA7HE,QAAA;;;;EAKA,aAAA;EAuKU;;;EAlKV,eAAA;EA8HA;;;EAzHA,WAAA;EA2IA;;;;EArIA,GAAA;EAuJA;;;AAA0B;EAjJ1B,SAAA;;;;;;;;EASA,UAAA,GAAa,aAAa;AAAA;;;;;;;;;;;;;;KAgBhB,gBAAA;;;;;EAKV,IAAA;;;;;EAMA,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,IAAA;;;;EAKA,YAAA;;;;;EAMA,QAAA;AAAA;AAAA,KAGU,wBAAA,GAA2B,IAAI,CAAC,gBAAA;EAC1C,IAAA;EACA,KAAA;AAAA;;;;;KAOU,gBAAA,IAAoB,IAAA,EAAM,iBAAA,YAA6B,OAAO;;;;;;;;;;;;;;;;;;;;;KAsB9D,iBAAA;;;;;EAKV,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,OAAA,GAAU,iBAAA;;;;;;EAOV,UAAA;;;;;EAMA,SAAA,GAAY,gBAAA;;;;;EAMZ,MAAA,EAAQ,gBAAA;;;;;EAMR,OAAA,GAAU,gBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/cli/types.ts"],"mappings":";;;;;AAgB4B;AAY5B;;;;KAZY,gBAAA;;;;AAwBK;AAsBjB;;;;;;KAlCY,iBAAA;EAuDV;;;;EAlDA,IAAA;EA4EA;;;AAA0B;AAgB5B;EArFE,OAAA,EAAS,MAAM;AAAA;;;;;;;;;;AA4HP;AAGV;;;;;;;;;KAzGY,iBAAA;EAkHA;;;;;EA5GV,MAAA;EA4GiE;;AAAO;EAvGxE,QAAA;EA6H2B;;;EAxH3B,aAAA;EAiKQ;;;EA5JR,eAAA,GAAkB,eAAA;EAwHlB;;;EAnHA,WAAA;EAoIU;;;;EA9HV,GAAA;EAiJQ;;;;EA3IR,SAAA;;;;;;;;EASA,UAAA,GAAa,aAAa;AAAA;;;;;;;;;;;;;;KAgBhB,gBAAA;;;;;EAKV,IAAA;;;;;EAMA,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,IAAA;;;;EAKA,YAAA;;;;;EAMA,QAAA;AAAA;AAAA,KAGU,wBAAA,GAA2B,IAAI,CAAC,gBAAA;EAC1C,IAAA;EACA,KAAA;AAAA;;;;;KAOU,gBAAA,IAAoB,IAAA,EAAM,iBAAA,YAA6B,OAAO;;;;;;;;;;;;;;;;;;;;;KAsB9D,iBAAA;;;;;EAKV,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,OAAA,GAAU,iBAAA;;;;;;EAOV,UAAA;;;;;EAMA,SAAA,GAAY,gBAAA;;;;;EAMZ,MAAA,EAAQ,gBAAA;;;;;EAMR,OAAA,GAAU,gBAAA;AAAA"}

package/esm/config/config-getter.mjs

@@ -1,4 +1,4 @@
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 
 //#region ../@warlock.js/core/src/config/config-getter.ts
 /**
@@ -14,15 +14,15 @@ import config from "@mongez/config";
 * const port = config.key<number>("database.port", 27017);
 * ```
 */
-const config$1 = {
+const config = {
 	key(key, defaultValue) {
-		return config.get(key, defaultValue);
+		return baseConfig.get(key, defaultValue);
 	},
 	get(name, defaultValue) {
-		return config.get(name, defaultValue);
+		return baseConfig.get(name, defaultValue);
 	}
 };
 
 //#endregion
-export { config$1 as config };
+export { config };
 //# sourceMappingURL=config-getter.mjs.map

package/esm/config/config-getter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-getter.mjs","names":["config","baseConfig"],"sources":["../../../../../../../@warlock.js/core/src/config/config-getter.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport type { ConfigKey, ConfigRegistry } from \"./types\";\n\n/**\n * Config accessor interface with typed overloads\n */\ninterface ConfigAccessor {\n  /**\n   * Get a config value by dot-notation key path.\n   */\n  key<T = any>(key: ConfigKey | (string & {}), defaultValue?: T): T;\n\n  /**\n   * Get an entire config group by name with type inference.\n   * Returns the typed config object for known config names.\n   */\n  get<K extends keyof ConfigRegistry>(name: K, defaultValue?: ConfigRegistry[K]): ConfigRegistry[K];\n\n  /**\n   * Get an entire config group by name (dynamic string).\n   */\n  get<T = any>(name: string, defaultValue?: T): T;\n}\n\n/**\n * Config accessor with typed autocomplete and return type inference.\n *\n * @example\n * ```typescript\n * // Get entire config group - returns the actual config type\n * const db = config.get(\"database\"); // → DatabaseConfigurations\n *\n * // Get specific key with dot notation\n * const host = config.key(\"database.host\");\n * const port = config.key<number>(\"database.port\", 27017);\n * ```\n */\nexport const config: ConfigAccessor = {\n  key(key: ConfigKey | (string & {}), defaultValue?: any): any {\n    return baseConfig.get(key, defaultValue);\n  },\n\n  get(name: string, defaultValue?: any): any {\n    return baseConfig.get(name, defaultValue);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,MAAaA,WAAyB;CACpC,IAAI,KAAgC,cAAyB;EAC3D,OAAOC,OAAW,IAAI,KAAK,YAAY;CACzC;CAEA,IAAI,MAAc,cAAyB;EACzC,OAAOA,OAAW,IAAI,MAAM,YAAY;CAC1C;AACF"}
+{"version":3,"file":"config-getter.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/config/config-getter.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport type { ConfigKey, ConfigRegistry } from \"./types\";\n\n/**\n * Config accessor interface with typed overloads\n */\ninterface ConfigAccessor {\n  /**\n   * Get a config value by dot-notation key path.\n   */\n  key<T = any>(key: ConfigKey | (string & {}), defaultValue?: T): T;\n\n  /**\n   * Get an entire config group by name with type inference.\n   * Returns the typed config object for known config names.\n   */\n  get<K extends keyof ConfigRegistry>(name: K, defaultValue?: ConfigRegistry[K]): ConfigRegistry[K];\n\n  /**\n   * Get an entire config group by name (dynamic string).\n   */\n  get<T = any>(name: string, defaultValue?: T): T;\n}\n\n/**\n * Config accessor with typed autocomplete and return type inference.\n *\n * @example\n * ```typescript\n * // Get entire config group - returns the actual config type\n * const db = config.get(\"database\"); // → DatabaseConfigurations\n *\n * // Get specific key with dot notation\n * const host = config.key(\"database.host\");\n * const port = config.key<number>(\"database.port\", 27017);\n * ```\n */\nexport const config: ConfigAccessor = {\n  key(key: ConfigKey | (string & {}), defaultValue?: any): any {\n    return baseConfig.get(key, defaultValue);\n  },\n\n  get(name: string, defaultValue?: any): any {\n    return baseConfig.get(name, defaultValue);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,MAAa,SAAyB;CACpC,IAAI,KAAgC,cAAyB;EAC3D,OAAO,WAAW,IAAI,KAAK,YAAY;CACzC;CAEA,IAAI,MAAc,cAAyB;EACzC,OAAO,WAAW,IAAI,MAAM,YAAY;CAC1C;AACF"}

package/esm/config/config-loader.mjs

@@ -1,5 +1,5 @@
 import { configSpecialHandlers } from "./config-special-handlers.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { colors } from "@mongez/copper";
 import { pathToFileURL } from "node:url";
 
@@ -27,7 +27,7 @@ var ConfigLoader = class {
 				console.log(colors.red(`config error: `), `Config file ${colors.yellow(file.relativePath)} does not have a default export`);
 				return;
 			}
-			config.set(configName, configValue);
+			baseConfig.set(configName, configValue);
 			await configSpecialHandlers.execute(configName, configValue);
 		} catch (error) {
 			throw error;

package/esm/config/config-loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { pathToFileURL } from \"node:url\";\r\nimport type { FileManager } from \"../dev-server/file-manager\";\r\nimport { configSpecialHandlers } from \"./config-special-handlers\";\r\n\r\n/**\r\n * Special Config Handler\r\n * A function that handles special configuration loading\r\n */\r\nexport type SpecialConfigHandler = (configValue: any) => void | Promise<void>;\r\n\r\n/**\r\n * Config Loader\r\n * Dynamically loads all configuration files and registers them with @mongez/config\r\n * Supports special handlers for configs that require additional processing\r\n */\r\nexport class ConfigLoader {\r\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\r\n    for (const file of configFiles) {\r\n      await this.loadConfig(file);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load a single configuration file.\r\n   *\r\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\r\n   * cycle gets a fresh module — no manual cache-busting needed here.\r\n   */\r\n  public async loadConfig(file: FileManager): Promise<void> {\r\n    const configName = this.getConfigName(file.relativePath);\r\n\r\n    try {\r\n      const fileUrl = pathToFileURL(file.absolutePath).href;\r\n      const configModule = await import(fileUrl);\r\n      const configValue = configModule.default;\r\n\r\n      if (configValue === undefined) {\r\n        console.log(\r\n          colors.red(`config error: `),\r\n          `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\r\n        );\r\n        return;\r\n      }\r\n\r\n      config.set(configName, configValue);\r\n      await configSpecialHandlers.execute(configName, configValue);\r\n    } catch (error) {\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  public async reloadConfig(file: FileManager): Promise<void> {\r\n    await this.loadConfig(file);\r\n  }\r\n\r\n  private getConfigName(relativePath: string): string {\r\n    const match = relativePath.match(/^src\\/config\\/(.+)\\.(ts|tsx)$/);\r\n\r\n    if (!match) {\r\n      throw new Error(`Invalid config file path: ${relativePath}`);\r\n    }\r\n\r\n    return match[1];\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AAiBA,IAAa,eAAb,MAA0B;CACxB,MAAa,QAAQ,aAA2C;EAC9D,KAAK,MAAM,QAAQ,aACjB,MAAM,KAAK,WAAW,IAAI;CAE9B;;;;;;;CAQA,MAAa,WAAW,MAAkC;EACxD,MAAM,aAAa,KAAK,cAAc,KAAK,YAAY;EAEvD,IAAI;GAGF,MAAM,eAAc,MADO,OADX,cAAc,KAAK,YAAY,CAAC,CAAC,MAEjB,CAAC;GAEjC,IAAI,gBAAgB,QAAW;IAC7B,QAAQ,IACN,OAAO,IAAI,gBAAgB,GAC3B,eAAe,OAAO,OAAO,KAAK,YAAY,EAAE,gCAClD;IACA;GACF;GAEA,OAAO,IAAI,YAAY,WAAW;GAClC,MAAM,sBAAsB,QAAQ,YAAY,WAAW;EAC7D,SAAS,OAAO;GACd,MAAM;EACR;CACF;CAEA,MAAa,aAAa,MAAkC;EAC1D,MAAM,KAAK,WAAW,IAAI;CAC5B;CAEA,AAAQ,cAAc,cAA8B;EAClD,MAAM,QAAQ,aAAa,MAAM,+BAA+B;EAEhE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,OAAO,MAAM;CACf;AACF"}
+{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { pathToFileURL } from \"node:url\";\r\nimport type { FileManager } from \"../dev-server/file-manager\";\r\nimport { configSpecialHandlers } from \"./config-special-handlers\";\r\n\r\n/**\r\n * Special Config Handler\r\n * A function that handles special configuration loading\r\n */\r\nexport type SpecialConfigHandler = (configValue: any) => void | Promise<void>;\r\n\r\n/**\r\n * Config Loader\r\n * Dynamically loads all configuration files and registers them with @mongez/config\r\n * Supports special handlers for configs that require additional processing\r\n */\r\nexport class ConfigLoader {\r\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\r\n    for (const file of configFiles) {\r\n      await this.loadConfig(file);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load a single configuration file.\r\n   *\r\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\r\n   * cycle gets a fresh module — no manual cache-busting needed here.\r\n   */\r\n  public async loadConfig(file: FileManager): Promise<void> {\r\n    const configName = this.getConfigName(file.relativePath);\r\n\r\n    try {\r\n      const fileUrl = pathToFileURL(file.absolutePath).href;\r\n      const configModule = await import(fileUrl);\r\n      const configValue = configModule.default;\r\n\r\n      if (configValue === undefined) {\r\n        console.log(\r\n          colors.red(`config error: `),\r\n          `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\r\n        );\r\n        return;\r\n      }\r\n\r\n      config.set(configName, configValue);\r\n      await configSpecialHandlers.execute(configName, configValue);\r\n    } catch (error) {\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  public async reloadConfig(file: FileManager): Promise<void> {\r\n    await this.loadConfig(file);\r\n  }\r\n\r\n  private getConfigName(relativePath: string): string {\r\n    const match = relativePath.match(/^src\\/config\\/(.+)\\.(ts|tsx)$/);\r\n\r\n    if (!match) {\r\n      throw new Error(`Invalid config file path: ${relativePath}`);\r\n    }\r\n\r\n    return match[1];\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AAiBA,IAAa,eAAb,MAA0B;CACxB,MAAa,QAAQ,aAA2C;EAC9D,KAAK,MAAM,QAAQ,aACjB,MAAM,KAAK,WAAW,IAAI;CAE9B;;;;;;;CAQA,MAAa,WAAW,MAAkC;EACxD,MAAM,aAAa,KAAK,cAAc,KAAK,YAAY;EAEvD,IAAI;GAGF,MAAM,eAAc,MADO,OADX,cAAc,KAAK,YAAY,CAAC,CAAC,MAEjB,CAAC;GAEjC,IAAI,gBAAgB,QAAW;IAC7B,QAAQ,IACN,OAAO,IAAI,gBAAgB,GAC3B,eAAe,OAAO,OAAO,KAAK,YAAY,EAAE,gCAClD;IACA;GACF;GAEA,WAAO,IAAI,YAAY,WAAW;GAClC,MAAM,sBAAsB,QAAQ,YAAY,WAAW;EAC7D,SAAS,OAAO;GACd,MAAM;EACR;CACF;CAEA,MAAa,aAAa,MAAkC;EAC1D,MAAM,KAAK,WAAW,IAAI;CAC5B;CAEA,AAAQ,cAAc,cAA8B;EAClD,MAAM,QAAQ,aAAa,MAAM,+BAA+B;EAEhE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,OAAO,MAAM;CACf;AACF"}

package/esm/connectors/access-connector.mjs

@@ -1,6 +1,6 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { log } from "@warlock.js/logger";
 
 //#region ../@warlock.js/core/src/connectors/access-connector.ts
@@ -29,7 +29,7 @@ var AccessConnector = class extends BaseConnector {
 	* Register the access configuration with the package.
 	*/
 	async start() {
-		const accessConfiguration = config.get("access");
+		const accessConfiguration = baseConfig.get("access");
 		if (!accessConfiguration) return;
 		const { setAccessConfig } = await import("@warlock.js/access");
 		setAccessConfig(accessConfiguration);

package/esm/connectors/access-connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"access-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/access-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Access Connector\n *\n * Wires `@warlock.js/access` from `src/config/access.ts` at boot: reads the\n * exported config object and hands it to the package's `setAccessConfig`, which\n * validates that a resolver is present — so a misconfigured authorization layer\n * fails at STARTUP, not on the first protected request. Config files stay\n * declarative; the connector performs the side-effect.\n *\n * The package is lazy-imported (only when an access config is present), so core\n * carries no hard dependency on it — the same pattern as the notifications and\n * herald connectors.\n */\nexport class AccessConnector extends BaseConnector {\n  public readonly name = \"access\";\n  public readonly priority = ConnectorPriority.ACCESS;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger an access restart\n   */\n  protected readonly watchedFiles = [\"src/config/access.ts\"];\n\n  /**\n   * Register the access configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const accessConfiguration = config.get(\"access\");\n\n    if (!accessConfiguration) {\n      return;\n    }\n\n    const { setAccessConfig } = await import(\"@warlock.js/access\");\n\n    setAccessConfig(accessConfiguration);\n    this.active = true;\n\n    log.info(\"access\", \"configured\", \"Authorization wired from config/access.ts\");\n  }\n\n  /**\n   * Clear the active config so a dev restart re-registers from the (possibly\n   * changed, or now-removed) config file. The package holds no external\n   * connection of its own.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const { resetAccessConfig } = await import(\"@warlock.js/access\");\n\n    resetAccessConfig();\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,sBAAsB;;;;;CAKzD,MAAa,QAAuB;EAClC,MAAM,sBAAsB,OAAO,IAAI,QAAQ;EAE/C,IAAI,CAAC,qBACH;EAGF,MAAM,EAAE,oBAAoB,MAAM,OAAO;EAEzC,gBAAgB,mBAAmB;EACnC,KAAK,SAAS;EAEd,IAAI,KAAK,UAAU,cAAc,2CAA2C;CAC9E;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,MAAM,EAAE,sBAAsB,MAAM,OAAO;EAE3C,kBAAkB;EAClB,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"access-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/access-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Access Connector\n *\n * Wires `@warlock.js/access` from `src/config/access.ts` at boot: reads the\n * exported config object and hands it to the package's `setAccessConfig`, which\n * validates that a resolver is present — so a misconfigured authorization layer\n * fails at STARTUP, not on the first protected request. Config files stay\n * declarative; the connector performs the side-effect.\n *\n * The package is lazy-imported (only when an access config is present), so core\n * carries no hard dependency on it — the same pattern as the notifications and\n * herald connectors.\n */\nexport class AccessConnector extends BaseConnector {\n  public readonly name = \"access\";\n  public readonly priority = ConnectorPriority.ACCESS;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger an access restart\n   */\n  protected readonly watchedFiles = [\"src/config/access.ts\"];\n\n  /**\n   * Register the access configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const accessConfiguration = config.get(\"access\");\n\n    if (!accessConfiguration) {\n      return;\n    }\n\n    const { setAccessConfig } = await import(\"@warlock.js/access\");\n\n    setAccessConfig(accessConfiguration);\n    this.active = true;\n\n    log.info(\"access\", \"configured\", \"Authorization wired from config/access.ts\");\n  }\n\n  /**\n   * Clear the active config so a dev restart re-registers from the (possibly\n   * changed, or now-removed) config file. The package holds no external\n   * connection of its own.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const { resetAccessConfig } = await import(\"@warlock.js/access\");\n\n    resetAccessConfig();\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,sBAAsB;;;;;CAKzD,MAAa,QAAuB;EAClC,MAAM,sBAAsBA,WAAO,IAAI,QAAQ;EAE/C,IAAI,CAAC,qBACH;EAGF,MAAM,EAAE,oBAAoB,MAAM,OAAO;EAEzC,gBAAgB,mBAAmB;EACnC,KAAK,SAAS;EAEd,IAAI,KAAK,UAAU,cAAc,2CAA2C;CAC9E;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,MAAM,EAAE,sBAAsB,MAAM,OAAO;EAE3C,kBAAkB;EAClB,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/cache-connector.mjs

@@ -1,6 +1,6 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { cache } from "@warlock.js/cache";
 
 //#region ../@warlock.js/core/src/connectors/cache-connector.ts
@@ -20,7 +20,7 @@ var CacheConnector = class extends BaseConnector {
 	* Initialize cache connection
 	*/
 	async start() {
-		const cacheConfig = config.get("cache");
+		const cacheConfig = baseConfig.get("cache");
 		if (!cacheConfig) return;
 		cache.setCacheConfigurations(cacheConfig);
 		await cache.init();

package/esm/connectors/cache-connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cache-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { cache } from \"@warlock.js/cache\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Cache Connector\r\n * Manages cache engine connection lifecycle\r\n */\r\nexport class CacheConnector extends BaseConnector {\r\n  public readonly name = \"cache\";\r\n  public readonly priority = ConnectorPriority.CACHE;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger cache restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/cache.ts\", \"src/config/cache.tsx\"];\r\n\r\n  /**\r\n   * Initialize cache connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const cacheConfig = config.get(\"cache\");\r\n\r\n    if (!cacheConfig) return;\r\n\r\n    cache.setCacheConfigurations(cacheConfig);\r\n\r\n    await cache.init();\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Shutdown cache connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    // TODO: Implement actual cache disconnection\r\n    // - Close all active connections\r\n    // - Clean up resources\r\n\r\n    this.active = false;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AASA,IAAa,iBAAb,cAAoC,cAAc;;;cACzB;;;sBAOW,CAAC,uBAAuB,sBAAsB;;;;;CAKhF,MAAa,QAAuB;EAClC,MAAM,cAAc,OAAO,IAAI,OAAO;EAEtC,IAAI,CAAC,aAAa;EAElB,MAAM,uBAAuB,WAAW;EAExC,MAAM,MAAM,KAAK;EAEjB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAOF,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"cache-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { cache } from \"@warlock.js/cache\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Cache Connector\r\n * Manages cache engine connection lifecycle\r\n */\r\nexport class CacheConnector extends BaseConnector {\r\n  public readonly name = \"cache\";\r\n  public readonly priority = ConnectorPriority.CACHE;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger cache restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/cache.ts\", \"src/config/cache.tsx\"];\r\n\r\n  /**\r\n   * Initialize cache connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const cacheConfig = config.get(\"cache\");\r\n\r\n    if (!cacheConfig) return;\r\n\r\n    cache.setCacheConfigurations(cacheConfig);\r\n\r\n    await cache.init();\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Shutdown cache connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    // TODO: Implement actual cache disconnection\r\n    // - Close all active connections\r\n    // - Clean up resources\r\n\r\n    this.active = false;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AASA,IAAa,iBAAb,cAAoC,cAAc;;;cACzB;;;sBAOW,CAAC,uBAAuB,sBAAsB;;;;;CAKhF,MAAa,QAAuB;EAClC,MAAM,cAAcA,WAAO,IAAI,OAAO;EAEtC,IAAI,CAAC,aAAa;EAElB,MAAM,uBAAuB,WAAW;EAExC,MAAM,MAAM,KAAK;EAEjB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAOF,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/connectors-manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"mappings":";;;cAea,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EA8BF;;;;EA8B0C;;;EAvClD,QAAA,IAAY,UAAA,EAAY,SAAA;EAmEC;;;EA1DzB,IAAA,IAAQ,SAAA;EATR;;;EAgBM,KAAA,CAAM,eAAA,GAAkB,aAAA,KAAkB,OAAA;EAPxC;;;;;;;;;EA8BF,UAAA,CAAW,KAAA,EAAO,uBAAA,GAA0B,OAAA;EAiBX;;;EAAjC,YAAA,CAAa,kBAAA,EAAoB,aAAA,KAAkB,OAAA;EAWvC;;;EAAZ,QAAA,IAAY,OAAA;EA4Cd;;;;AAA2C;;;;EAzB/C,qBAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}
+{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"mappings":";;;cAgBa,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EA8BF;;;;EA8B0C;;;EAvClD,QAAA,IAAY,UAAA,EAAY,SAAA;EAmEC;;;EA1DzB,IAAA,IAAQ,SAAA;EATR;;;EAgBM,KAAA,CAAM,eAAA,GAAkB,aAAA,KAAkB,OAAA;EAPxC;;;;;;;;;EA8BF,UAAA,CAAW,KAAA,EAAO,uBAAA,GAA0B,OAAA;EAiBX;;;EAAjC,YAAA,CAAa,kBAAA,EAAoB,aAAA,KAAkB,OAAA;EAWvC;;;EAAZ,QAAA,IAAY,OAAA;EAkDd;;;;AAA2C;;;;EAzB/C,qBAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}

package/esm/connectors/connectors-manager.mjs

@@ -1,3 +1,5 @@
+import { Application } from "../application/application.mjs";
+import "../application/index.mjs";
 import { AccessConnector } from "./access-connector.mjs";
 import { CacheConnector } from "./cache-connector.mjs";
 import { HeraldConnector } from "./herald-connector.mjs";
@@ -74,7 +76,8 @@ var ConnectorsManager = class {
 	* Shutdown all connectors
 	*/
 	async shutdown() {
-		for (const connector of this.connectors.reverse()) try {
+		await Application.runShutdownHooks();
+		for (const connector of [...this.connectors].reverse()) try {
 			await connector.shutdown();
 		} catch (error) {
 			devServeLog(colors.redBright(`❌ Failed to shutdown ${connector.name}: ${error}`));

package/esm/connectors/connectors-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { devServeLog } from \"../dev-server/dev-logger\";\r\nimport { AccessConnector } from \"./access-connector\";\r\nimport { CacheConnector } from \"./cache-connector\";\r\nimport { DatabaseConnector } from \"./database-connector\";\r\nimport { HeraldConnector } from \"./herald-connector\";\r\nimport { HttpConnector } from \"./http-connector\";\r\nimport { LoggerConnector } from \"./logger-connector\";\r\nimport { MailerConnector } from \"./mail-connector\";\r\nimport { NotificationsConnector } from \"./notifications-connector\";\r\nimport { SocketConnector } from \"./socket-connector\";\r\nimport { StorageConnector } from \"./storage.connector\";\r\nimport { ConnectorLifecyclePhase } from \"./types\";\r\nimport type { Connector, ConnectorName } from \"./types\";\r\n\r\nexport class ConnectorsManager {\r\n  /**\r\n   * Connectors list\r\n   */\r\n  private readonly connectors: Connector[] = [];\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor() {\r\n    this.register(new LoggerConnector());\r\n    this.register(new MailerConnector());\r\n    this.register(new HttpConnector());\r\n    this.register(new DatabaseConnector());\r\n    this.register(new HeraldConnector());\r\n    this.register(new CacheConnector());\r\n    this.register(new StorageConnector());\r\n    this.register(new SocketConnector());\r\n    this.register(new NotificationsConnector());\r\n    this.register(new AccessConnector());\r\n  }\r\n\r\n  /**\r\n   * Register a connector\r\n   */\r\n  public register(...connectors: Connector[]): void {\r\n    this.connectors.push(...connectors);\r\n    // sort connectors by priority\r\n    this.connectors.sort((a, b) => a.priority - b.priority);\r\n  }\r\n\r\n  /**\r\n   * Get all connectors\r\n   */\r\n  public list(): Connector[] {\r\n    return this.connectors;\r\n  }\r\n\r\n  /**\r\n   * start all connectors\r\n   */\r\n  public async start(connectorsNames?: ConnectorName[]): Promise<void> {\r\n    const connectorsList = connectorsNames\r\n      ? this.connectors.filter((connector) => connectorsNames.includes(connector.name))\r\n      : this.connectors;\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors in the given lifecycle phase.\r\n   *\r\n   * The production builder and dev preload split startup around app\r\n   * code: early phase before app imports, late phase after. Within a\r\n   * phase, all connectors `boot()` first, then all `start()`, so\r\n   * cross-connector wiring inside the phase still works (e.g. socket\r\n   * reads http's instance during its own boot).\r\n   */\r\n  public async startPhase(phase: ConnectorLifecyclePhase): Promise<void> {\r\n    const phaseConnectors = this.connectors.filter(\r\n      (connector) => connector.lifecyclePhase === phase,\r\n    );\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors except the given ones\r\n   */\r\n  public async startWithout(excludedConnectors: ConnectorName[]): Promise<void> {\r\n    await this.start(\r\n      this.connectors\r\n        .filter((connector) => !excludedConnectors.includes(connector.name))\r\n        .map((connector) => connector.name),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Shutdown all connectors\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    // shut down connectors in reverse order\r\n    for (const connector of this.connectors.reverse()) {\r\n      try {\r\n        await connector.shutdown();\r\n      } catch (error) {\r\n        devServeLog(colors.redBright(`❌ Failed to shutdown ${connector.name}: ${error}`));\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown connectors on process kill\r\n   *\r\n   * Handles graceful shutdown for both Unix and Windows:\r\n   * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes\r\n   * - SIGTERM: Termination signal (Unix primarily)\r\n   * - beforeExit: Fires when Node.js empties its event loop (more reliable on Windows)\r\n   */\r\n  public shutdownOnProcessKill(): void {\r\n    let isShuttingDown = false;\r\n\r\n    const gracefulShutdown = async (signal: string) => {\r\n      if (isShuttingDown) return;\r\n      isShuttingDown = true;\r\n\r\n      console.log(`\\nExiting...`);\r\n      await this.shutdown();\r\n      process.exit(0);\r\n    };\r\n\r\n    // Unix signals\r\n    process.on(\"SIGINT\", () => gracefulShutdown(\"SIGINT\"));\r\n    process.on(\"SIGTERM\", () => gracefulShutdown(\"SIGTERM\"));\r\n\r\n    // Windows-specific: handle when process is about to exit\r\n    // This is more reliable on Windows for spawned child processes\r\n    if (process.platform === \"win32\") {\r\n      // Handle Ctrl+C on Windows specifically\r\n      process.on(\"SIGHUP\", () => gracefulShutdown(\"SIGHUP\"));\r\n    }\r\n  }\r\n}\r\n\r\nexport const connectorsManager = new ConnectorsManager();\r\n"],"mappings":";;;;;;;;;;;;;;AAeA,IAAa,oBAAb,MAA+B;;;;CAS7B,AAAO,cAAc;oBALsB,CAAC;EAM1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,cAAc,CAAC;EACjC,KAAK,SAAS,IAAI,kBAAkB,CAAC;EACrC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,eAAe,CAAC;EAClC,KAAK,SAAS,IAAI,iBAAiB,CAAC;EACpC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,uBAAuB,CAAC;EAC1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;CACrC;;;;CAKA,AAAO,SAAS,GAAG,YAA+B;EAChD,KAAK,WAAW,KAAK,GAAG,UAAU;EAElC,KAAK,WAAW,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;CACxD;;;;CAKA,AAAO,OAAoB;EACzB,OAAO,KAAK;CACd;;;;CAKA,MAAa,MAAM,iBAAkD;EACnE,MAAM,iBAAiB,kBACnB,KAAK,WAAW,QAAQ,cAAc,gBAAgB,SAAS,UAAU,IAAI,CAAC,IAC9E,KAAK;EAET,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,MAAM;CAE1B;;;;;;;;;;CAWA,MAAa,WAAW,OAA+C;EACrE,MAAM,kBAAkB,KAAK,WAAW,QACrC,cAAc,UAAU,mBAAmB,KAC9C;EAEA,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,MAAM;CAE1B;;;;CAKA,MAAa,aAAa,oBAAoD;EAC5E,MAAM,KAAK,MACT,KAAK,WACF,QAAQ,cAAc,CAAC,mBAAmB,SAAS,UAAU,IAAI,CAAC,CAAC,CACnE,KAAK,cAAc,UAAU,IAAI,CACtC;CACF;;;;CAKA,MAAa,WAA0B;EAErC,KAAK,MAAM,aAAa,KAAK,WAAW,QAAQ,GAC9C,IAAI;GACF,MAAM,UAAU,SAAS;EAC3B,SAAS,OAAO;GACd,YAAY,OAAO,UAAU,wBAAwB,UAAU,KAAK,IAAI,OAAO,CAAC;EAClF;CAEJ;;;;;;;;;CAUA,AAAO,wBAA8B;EACnC,IAAI,iBAAiB;EAErB,MAAM,mBAAmB,OAAO,WAAmB;GACjD,IAAI,gBAAgB;GACpB,iBAAiB;GAEjB,QAAQ,IAAI,cAAc;GAC1B,MAAM,KAAK,SAAS;GACpB,QAAQ,KAAK,CAAC;EAChB;EAGA,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;EACrD,QAAQ,GAAG,iBAAiB,iBAAiB,SAAS,CAAC;EAIvD,IAAI,QAAQ,aAAa,SAEvB,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;CAEzD;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}
+{"version":3,"file":"connectors-manager.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { Application } from \"../application\";\r\nimport { devServeLog } from \"../dev-server/dev-logger\";\r\nimport { AccessConnector } from \"./access-connector\";\r\nimport { CacheConnector } from \"./cache-connector\";\r\nimport { DatabaseConnector } from \"./database-connector\";\r\nimport { HeraldConnector } from \"./herald-connector\";\r\nimport { HttpConnector } from \"./http-connector\";\r\nimport { LoggerConnector } from \"./logger-connector\";\r\nimport { MailerConnector } from \"./mail-connector\";\r\nimport { NotificationsConnector } from \"./notifications-connector\";\r\nimport { SocketConnector } from \"./socket-connector\";\r\nimport { StorageConnector } from \"./storage.connector\";\r\nimport { ConnectorLifecyclePhase } from \"./types\";\r\nimport type { Connector, ConnectorName } from \"./types\";\r\n\r\nexport class ConnectorsManager {\r\n  /**\r\n   * Connectors list\r\n   */\r\n  private readonly connectors: Connector[] = [];\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor() {\r\n    this.register(new LoggerConnector());\r\n    this.register(new MailerConnector());\r\n    this.register(new HttpConnector());\r\n    this.register(new DatabaseConnector());\r\n    this.register(new HeraldConnector());\r\n    this.register(new CacheConnector());\r\n    this.register(new StorageConnector());\r\n    this.register(new SocketConnector());\r\n    this.register(new NotificationsConnector());\r\n    this.register(new AccessConnector());\r\n  }\r\n\r\n  /**\r\n   * Register a connector\r\n   */\r\n  public register(...connectors: Connector[]): void {\r\n    this.connectors.push(...connectors);\r\n    // sort connectors by priority\r\n    this.connectors.sort((a, b) => a.priority - b.priority);\r\n  }\r\n\r\n  /**\r\n   * Get all connectors\r\n   */\r\n  public list(): Connector[] {\r\n    return this.connectors;\r\n  }\r\n\r\n  /**\r\n   * start all connectors\r\n   */\r\n  public async start(connectorsNames?: ConnectorName[]): Promise<void> {\r\n    const connectorsList = connectorsNames\r\n      ? this.connectors.filter((connector) => connectorsNames.includes(connector.name))\r\n      : this.connectors;\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors in the given lifecycle phase.\r\n   *\r\n   * The production builder and dev preload split startup around app\r\n   * code: early phase before app imports, late phase after. Within a\r\n   * phase, all connectors `boot()` first, then all `start()`, so\r\n   * cross-connector wiring inside the phase still works (e.g. socket\r\n   * reads http's instance during its own boot).\r\n   */\r\n  public async startPhase(phase: ConnectorLifecyclePhase): Promise<void> {\r\n    const phaseConnectors = this.connectors.filter(\r\n      (connector) => connector.lifecyclePhase === phase,\r\n    );\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors except the given ones\r\n   */\r\n  public async startWithout(excludedConnectors: ConnectorName[]): Promise<void> {\r\n    await this.start(\r\n      this.connectors\r\n        .filter((connector) => !excludedConnectors.includes(connector.name))\r\n        .map((connector) => connector.name),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Shutdown all connectors\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    // App-owned teardown runs first, while every connector (db, cache, http) is\r\n    // still up, so cleanup hooks can use them. Idempotent + error-isolated.\r\n    await Application.runShutdownHooks();\r\n\r\n    // Shut down connectors in reverse priority order. Copy the list first —\r\n    // `reverse()` mutates in place, so reversing the live array would corrupt\r\n    // the order on a second shutdown pass.\r\n    for (const connector of [...this.connectors].reverse()) {\r\n      try {\r\n        await connector.shutdown();\r\n      } catch (error) {\r\n        devServeLog(colors.redBright(`❌ Failed to shutdown ${connector.name}: ${error}`));\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown connectors on process kill\r\n   *\r\n   * Handles graceful shutdown for both Unix and Windows:\r\n   * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes\r\n   * - SIGTERM: Termination signal (Unix primarily)\r\n   * - beforeExit: Fires when Node.js empties its event loop (more reliable on Windows)\r\n   */\r\n  public shutdownOnProcessKill(): void {\r\n    let isShuttingDown = false;\r\n\r\n    const gracefulShutdown = async (signal: string) => {\r\n      if (isShuttingDown) return;\r\n      isShuttingDown = true;\r\n\r\n      console.log(`\\nExiting...`);\r\n      await this.shutdown();\r\n      process.exit(0);\r\n    };\r\n\r\n    // Unix signals\r\n    process.on(\"SIGINT\", () => gracefulShutdown(\"SIGINT\"));\r\n    process.on(\"SIGTERM\", () => gracefulShutdown(\"SIGTERM\"));\r\n\r\n    // Windows-specific: handle when process is about to exit\r\n    // This is more reliable on Windows for spawned child processes\r\n    if (process.platform === \"win32\") {\r\n      // Handle Ctrl+C on Windows specifically\r\n      process.on(\"SIGHUP\", () => gracefulShutdown(\"SIGHUP\"));\r\n    }\r\n  }\r\n}\r\n\r\nexport const connectorsManager = new ConnectorsManager();\r\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,IAAa,oBAAb,MAA+B;;;;CAS7B,AAAO,cAAc;oBALsB,CAAC;EAM1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,cAAc,CAAC;EACjC,KAAK,SAAS,IAAI,kBAAkB,CAAC;EACrC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,eAAe,CAAC;EAClC,KAAK,SAAS,IAAI,iBAAiB,CAAC;EACpC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,uBAAuB,CAAC;EAC1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;CACrC;;;;CAKA,AAAO,SAAS,GAAG,YAA+B;EAChD,KAAK,WAAW,KAAK,GAAG,UAAU;EAElC,KAAK,WAAW,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;CACxD;;;;CAKA,AAAO,OAAoB;EACzB,OAAO,KAAK;CACd;;;;CAKA,MAAa,MAAM,iBAAkD;EACnE,MAAM,iBAAiB,kBACnB,KAAK,WAAW,QAAQ,cAAc,gBAAgB,SAAS,UAAU,IAAI,CAAC,IAC9E,KAAK;EAET,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,MAAM;CAE1B;;;;;;;;;;CAWA,MAAa,WAAW,OAA+C;EACrE,MAAM,kBAAkB,KAAK,WAAW,QACrC,cAAc,UAAU,mBAAmB,KAC9C;EAEA,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,MAAM;CAE1B;;;;CAKA,MAAa,aAAa,oBAAoD;EAC5E,MAAM,KAAK,MACT,KAAK,WACF,QAAQ,cAAc,CAAC,mBAAmB,SAAS,UAAU,IAAI,CAAC,CAAC,CACnE,KAAK,cAAc,UAAU,IAAI,CACtC;CACF;;;;CAKA,MAAa,WAA0B;EAGrC,MAAM,YAAY,iBAAiB;EAKnC,KAAK,MAAM,aAAa,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC,QAAQ,GACnD,IAAI;GACF,MAAM,UAAU,SAAS;EAC3B,SAAS,OAAO;GACd,YAAY,OAAO,UAAU,wBAAwB,UAAU,KAAK,IAAI,OAAO,CAAC;EAClF;CAEJ;;;;;;;;;CAUA,AAAO,wBAA8B;EACnC,IAAI,iBAAiB;EAErB,MAAM,mBAAmB,OAAO,WAAmB;GACjD,IAAI,gBAAgB;GACpB,iBAAiB;GAEjB,QAAQ,IAAI,cAAc;GAC1B,MAAM,KAAK,SAAS;GACpB,QAAQ,KAAK,CAAC;EAChB;EAGA,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;EACrD,QAAQ,GAAG,iBAAiB,iBAAiB,SAAS,CAAC;EAIvD,IAAI,QAAQ,aAAa,SAEvB,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;CAEzD;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}

package/esm/connectors/database-connector.mjs

@@ -1,7 +1,7 @@
 import { container } from "../container/index.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { connectToDatabase, dataSourceRegistry } from "@warlock.js/cascade";
 
 //#region ../@warlock.js/core/src/connectors/database-connector.ts
@@ -21,7 +21,7 @@ var DatabaseConnector = class extends BaseConnector {
 	* Initialize database connection
 	*/
 	async start() {
-		const databaseConfig = config.get("database");
+		const databaseConfig = baseConfig.get("database");
 		if (!databaseConfig) return;
 		try {
 			const source = await connectToDatabase(databaseConfig);