@warlock.js/core 4.3.0 → 4.5.0

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

@@ -1 +1 @@
-{"version":3,"file":"herald-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/herald-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Herald Connector\r\n * Manages message broker connection lifecycle using @warlock.js/herald\r\n */\r\nexport class HeraldConnector extends BaseConnector {\r\n  public readonly name = \"herald\";\r\n  public readonly priority = ConnectorPriority.COMMUNICATOR;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger herald restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/herald.ts\"];\r\n\r\n  /**\r\n   * Initialize broker connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const heraldConfig = config.get(\"herald\");\r\n\r\n    if (!heraldConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const { connectToBroker } = await import(\"@warlock.js/herald\");\r\n\r\n      log.info(`herald.${heraldConfig.driver}`, \"connection\", \"Connecting to message broker\");\r\n      await connectToBroker(heraldConfig);\r\n      log.success(`herald.${heraldConfig.driver}`, \"connection\", \"Connected to message broker\");\r\n      this.active = true;\r\n    } catch (error) {\r\n      // Boot-time broker connection failure is unrecoverable — `fatal` makes\r\n      // \"page on fatal only\" alerting clean, aligned with the cascade and\r\n      // cache drivers. Disconnect failures (shutdown path) stay at error.\r\n      log.fatal(\r\n        `herald.${heraldConfig.driver}`,\r\n        \"connection\",\r\n        \"Failed to connect to message broker\",\r\n      );\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown broker connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const { brokerRegistry } = await import(\"@warlock.js/herald\");\r\n\r\n      // Disconnect all registered brokers\r\n      const brokers = brokerRegistry.getAll();\r\n\r\n      for (const broker of brokers) {\r\n        if (broker.driver.isConnected) {\r\n          await broker.driver.disconnect();\r\n        }\r\n      }\r\n\r\n      // Clear the registry for clean restart\r\n      brokerRegistry.clear();\r\n\r\n      this.active = false;\r\n    } catch (error) {\r\n      log.error(\"herald\", \"shutdown\", \"Failed to disconnect from message broker\");\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AASA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,sBAAsB;;;;;CAKzD,MAAa,QAAuB;EAClC,MAAM,eAAe,OAAO,IAAI,QAAQ;EAExC,IAAI,CAAC,cACH;EAGF,IAAI;GACF,MAAM,EAAE,oBAAoB,MAAM,OAAO;GAEzC,IAAI,KAAK,UAAU,aAAa,UAAU,cAAc,8BAA8B;GACtF,MAAM,gBAAgB,YAAY;GAClC,IAAI,QAAQ,UAAU,aAAa,UAAU,cAAc,6BAA6B;GACxF,KAAK,SAAS;EAChB,SAAS,OAAO;GAId,IAAI,MACF,UAAU,aAAa,UACvB,cACA,qCACF;GACA,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GACF,MAAM,EAAE,mBAAmB,MAAM,OAAO;GAGxC,MAAM,UAAU,eAAe,OAAO;GAEtC,KAAK,MAAM,UAAU,SACnB,IAAI,OAAO,OAAO,aAChB,MAAM,OAAO,OAAO,WAAW;GAKnC,eAAe,MAAM;GAErB,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,IAAI,MAAM,UAAU,YAAY,0CAA0C;GAC1E,MAAM;EACR;CACF;AACF"}
+{"version":3,"file":"herald-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/herald-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Herald Connector\r\n * Manages message broker connection lifecycle using @warlock.js/herald\r\n */\r\nexport class HeraldConnector extends BaseConnector {\r\n  public readonly name = \"herald\";\r\n  public readonly priority = ConnectorPriority.COMMUNICATOR;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger herald restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/herald.ts\"];\r\n\r\n  /**\r\n   * Initialize broker connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const heraldConfig = config.get(\"herald\");\r\n\r\n    if (!heraldConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const { connectToBroker } = await import(\"@warlock.js/herald\");\r\n\r\n      log.info(`herald.${heraldConfig.driver}`, \"connection\", \"Connecting to message broker\");\r\n      await connectToBroker(heraldConfig);\r\n      log.success(`herald.${heraldConfig.driver}`, \"connection\", \"Connected to message broker\");\r\n      this.active = true;\r\n    } catch (error) {\r\n      // Boot-time broker connection failure is unrecoverable — `fatal` makes\r\n      // \"page on fatal only\" alerting clean, aligned with the cascade and\r\n      // cache drivers. Disconnect failures (shutdown path) stay at error.\r\n      log.fatal(\r\n        `herald.${heraldConfig.driver}`,\r\n        \"connection\",\r\n        \"Failed to connect to message broker\",\r\n      );\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown broker connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const { brokerRegistry } = await import(\"@warlock.js/herald\");\r\n\r\n      // Disconnect all registered brokers\r\n      const brokers = brokerRegistry.getAll();\r\n\r\n      for (const broker of brokers) {\r\n        if (broker.driver.isConnected) {\r\n          await broker.driver.disconnect();\r\n        }\r\n      }\r\n\r\n      // Clear the registry for clean restart\r\n      brokerRegistry.clear();\r\n\r\n      this.active = false;\r\n    } catch (error) {\r\n      log.error(\"herald\", \"shutdown\", \"Failed to disconnect from message broker\");\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AASA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,sBAAsB;;;;;CAKzD,MAAa,QAAuB;EAClC,MAAM,eAAeA,WAAO,IAAI,QAAQ;EAExC,IAAI,CAAC,cACH;EAGF,IAAI;GACF,MAAM,EAAE,oBAAoB,MAAM,OAAO;GAEzC,IAAI,KAAK,UAAU,aAAa,UAAU,cAAc,8BAA8B;GACtF,MAAM,gBAAgB,YAAY;GAClC,IAAI,QAAQ,UAAU,aAAa,UAAU,cAAc,6BAA6B;GACxF,KAAK,SAAS;EAChB,SAAS,OAAO;GAId,IAAI,MACF,UAAU,aAAa,UACvB,cACA,qCACF;GACA,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GACF,MAAM,EAAE,mBAAmB,MAAM,OAAO;GAGxC,MAAM,UAAU,eAAe,OAAO;GAEtC,KAAK,MAAM,UAAU,SACnB,IAAI,OAAO,OAAO,aAChB,MAAM,OAAO,OAAO,WAAW;GAKnC,eAAe,MAAM;GAErB,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,IAAI,MAAM,UAAU,YAAY,0CAA0C;GAC1E,MAAM;EACR;CACF;AACF"}

package/esm/connectors/http-connector.d.mts

@@ -27,6 +27,14 @@ declare class HttpConnector extends BaseConnector {
    * `start()` so it reads the router after app code has registered.
    */
   boot(): Promise<void>;
+  /**
+   * Register the built-in liveness (`/health`) and readiness (`/ready`)
+   * endpoints directly on the Fastify instance — infra routes, kept off the app
+   * router so they're immune to HMR and never collide with route scanning. Opt
+   * out via `http.health.enabled = false`; rename via `http.health.path` /
+   * `http.health.readinessPath`.
+   */
+  private registerHealthRoutes;
   /**
    * Initialize HTTP server — bind app-registered routes to Fastify
    * then listen. Scanning here (not in `boot`) lets HTTP boot before

package/esm/connectors/http-connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AA+BA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAmBb;;;;;EAAA,mBAZE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;EAoBX,IAAA,IAAI,OAAA;EAPP;;;;;EAoCG,KAAA,IAAS,OAAA;EA0CT;;;;;EAAA,OAAA,IAAW,OAAA;EA0BmB;AAAA;;EAjB9B,QAAA,IAAY,OAAA;;;;;;EAiBlB,aAAA,CAAc,YAAA;AAAA"}
+{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AAsCA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAmBb;;;;;EAAA,mBAZE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;EAoBX,IAAA,IAAI,OAAA;EAPP;;;;;;;EAAA,QA0CF,oBAAA;EA0EgB;;;;;EA1CX,KAAA,IAAS,OAAA;EA+EqB;;;;;EArC9B,OAAA,IAAW,OAAA;;;;EASX,QAAA,IAAY,OAAA;;;;;;EA4BlB,aAAA,CAAc,YAAA;AAAA"}

package/esm/connectors/http-connector.mjs

@@ -2,13 +2,14 @@ import { setBaseUrl } from "../utils/urls.mjs";
 import { container } from "../container/index.mjs";
 import { router } from "../router/router.mjs";
 import { registerHttpPlugins } from "../http/plugins.mjs";
-import { getHttpServer, startHttpServer } from "../http/server.mjs";
+import { closeServerWithTimeout, getHttpServer, startHttpServer } from "../http/server.mjs";
 import { Application } from "../application/application.mjs";
 import "../application/index.mjs";
+import { health } from "../http/health.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 import { devLogError } from "../dev-server/dev-logger.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { log } from "@warlock.js/logger";
 import { colors } from "@mongez/copper";
 
@@ -22,6 +23,11 @@ function environmentColor(environment) {
 	}
 }
 /**
+* Default time to wait for in-flight requests to drain on shutdown before the
+* HTTP server is force-closed. Override via `http.gracefulShutdown.timeout`.
+*/
+const DEFAULT_SHUTDOWN_TIMEOUT = 1e4;
+/**
 * HTTP Connector
 * Manages HTTP server (Fastify) lifecycle
 */
@@ -39,14 +45,37 @@ var HttpConnector = class extends BaseConnector {
 	* `start()` so it reads the router after app code has registered.
 	*/
 	async boot() {
-		const httpConfig = config.get("http");
+		const httpConfig = baseConfig.get("http");
 		if (!httpConfig) return;
 		const port = httpConfig.port;
 		log.info(`http`, "connection", `Starting http server on port ${port} in ${environmentColor(Application.environment)} mode`);
 		this.http = startHttpServer(httpConfig.serverOptions);
 		container.set("http.server", this.http);
 		await registerHttpPlugins(this.http);
-		setBaseUrl(config.get("app.baseUrl"));
+		setBaseUrl(baseConfig.get("app.baseUrl"));
+		this.registerHealthRoutes();
+	}
+	/**
+	* Register the built-in liveness (`/health`) and readiness (`/ready`)
+	* endpoints directly on the Fastify instance — infra routes, kept off the app
+	* router so they're immune to HMR and never collide with route scanning. Opt
+	* out via `http.health.enabled = false`; rename via `http.health.path` /
+	* `http.health.readinessPath`.
+	*/
+	registerHealthRoutes() {
+		if (!this.http) return;
+		const healthConfig = baseConfig.get("http.health");
+		if (healthConfig?.enabled === false) return;
+		const livenessPath = healthConfig?.path ?? "/health";
+		const readinessPath = healthConfig?.readinessPath ?? "/ready";
+		this.http.get(livenessPath, async (_request, reply) => {
+			const result = health.liveness();
+			return reply.code(result.status === "ok" ? 200 : 503).send(result);
+		});
+		this.http.get(readinessPath, async (_request, reply) => {
+			const result = await health.readiness();
+			return reply.code(result.status === "ok" ? 200 : 503).send(result);
+		});
 	}
 	/**
 	* Initialize HTTP server — bind app-registered routes to Fastify
@@ -54,7 +83,7 @@ var HttpConnector = class extends BaseConnector {
 	* app code without losing routes.
 	*/
 	async start() {
-		const httpConfig = config.get("http");
+		const httpConfig = baseConfig.get("http");
 		if (!httpConfig || !this.http) return;
 		if (Application.runtimeStrategy === "development") router.scanDevServer(this.http);
 		else router.scan(this.http);
@@ -63,7 +92,7 @@ var HttpConnector = class extends BaseConnector {
 				port: httpConfig.port,
 				host: httpConfig.host || "localhost"
 			});
-			const baseUrl = config.get("app.baseUrl");
+			const baseUrl = baseConfig.get("app.baseUrl");
 			log.success(`http`, "connection", `Server ready at ${baseUrl}`);
 		} catch (error) {
 			devLogError("Error while starting http server", error);
@@ -88,7 +117,11 @@ var HttpConnector = class extends BaseConnector {
 	*/
 	async shutdown() {
 		if (!this.active) return;
-		getHttpServer()?.close();
+		const server = getHttpServer();
+		if (server) {
+			const timeout = baseConfig.get("http.gracefulShutdown.timeout", DEFAULT_SHUTDOWN_TIMEOUT);
+			if (!await closeServerWithTimeout(server, timeout)) log.warn("http", "shutdown", `In-flight requests did not drain within ${timeout}ms; closing anyway`);
+		}
 		this.active = false;
 	}
 	/**

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

@@ -1 +1 @@
-{"version":3,"file":"http-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/http-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { Application } from \"../application\";\r\nimport { devLogError } from \"../dev-server/dev-logger\";\r\nimport { registerHttpPlugins } from \"../http/plugins\";\r\nimport { FastifyInstance, getHttpServer, startHttpServer } from \"../http/server\";\r\nimport { router } from \"../router/router\";\r\nimport { Environment } from \"../utils\";\r\nimport { setBaseUrl } from \"../utils/urls\";\r\nimport { container } from \"./../container\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\nfunction environmentColor(environment: Environment) {\r\n  switch (environment) {\r\n    case \"development\":\r\n      return colors.magentaBright(environment);\r\n    case \"test\":\r\n      return colors.yellowBright(environment);\r\n    case \"production\":\r\n      return colors.greenBright(environment);\r\n    default:\r\n      return colors.white(environment);\r\n  }\r\n}\r\n\r\n/**\r\n * HTTP Connector\r\n * Manages HTTP server (Fastify) lifecycle\r\n */\r\nexport class HttpConnector extends BaseConnector {\r\n  public readonly name = \"http\";\r\n  public readonly priority = ConnectorPriority.HTTP;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\r\n\r\n  /**\r\n   * Files that trigger HTTP server restart\r\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\r\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/http.ts\", \"src/config/http.tsx\"];\r\n\r\n  /**\r\n   * Fastify Server instance\r\n   */\r\n  protected http?: FastifyInstance;\r\n\r\n  /**\r\n   * Boot the connector — construction only (create Fastify, register\r\n   * plugins, populate container). Route scanning is deferred to\r\n   * `start()` so it reads the router after app code has registered.\r\n   */\r\n  public async boot() {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig) return;\r\n\r\n    const port = httpConfig.port;\r\n    log.info(\r\n      `http`,\r\n      \"connection\",\r\n      `Starting http server on port ${port} in ${environmentColor(Application.environment)} mode`,\r\n    );\r\n\r\n    this.http = startHttpServer(httpConfig.serverOptions);\r\n\r\n    container.set(\"http.server\", this.http);\r\n\r\n    await registerHttpPlugins(this.http);\r\n\r\n    const baseUrl = config.get(\"app.baseUrl\");\r\n\r\n    // update base url\r\n    setBaseUrl(baseUrl);\r\n  }\r\n\r\n  /**\r\n   * Initialize HTTP server — bind app-registered routes to Fastify\r\n   * then listen. Scanning here (not in `boot`) lets HTTP boot before\r\n   * app code without losing routes.\r\n   */\r\n  public async start(): Promise<void> {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig || !this.http) return;\r\n\r\n    if (Application.runtimeStrategy === \"development\") {\r\n      router.scanDevServer(this.http);\r\n    } else {\r\n      router.scan(this.http);\r\n    }\r\n\r\n    try {\r\n      // We can use the url of the server\r\n      await this.http.listen({\r\n        port: httpConfig.port,\r\n        host: httpConfig.host || \"localhost\",\r\n      });\r\n\r\n      const baseUrl = config.get(\"app.baseUrl\");\r\n\r\n      log.success(`http`, \"connection\", `Server ready at ${baseUrl}`);\r\n    } catch (error) {\r\n      devLogError(\"Error while starting http server\", error);\r\n\r\n      // A failed listen()/port-bind at boot means the app can't serve — fatal.\r\n      // devLogError above is the dev-server console UI and bypasses the logger\r\n      // pipeline, so also route it through `log.fatal` to reach Sentry/file,\r\n      // then `await log.flush()` to drain buffered/async channels before exit.\r\n      await log.fatal(\"http\", \"connection\", error);\r\n      await log.flush();\r\n\r\n      process.exit(1); // stop the process, exit with error\r\n    }\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Restart — needs a fresh Fastify instance since `start()` now\r\n   * re-runs `router.scan()`, and re-scanning the same Fastify would\r\n   * register duplicate route handlers.\r\n   */\r\n  public async restart(): Promise<void> {\r\n    await this.shutdown();\r\n    await this.boot();\r\n    await this.start();\r\n  }\r\n\r\n  /**\r\n   * Shutdown HTTP server\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    const server = getHttpServer();\r\n\r\n    server?.close();\r\n\r\n    this.active = false;\r\n  }\r\n\r\n  /**\r\n   * Override shouldRestart to handle routes.ts specially\r\n   * routes.ts changes should NOT restart the server (use HMR instead)\r\n   * Now receives config file paths directly from layer-executor\r\n   */\r\n  public shouldRestart(changedFiles: string[]): boolean {\r\n    // Only restart for config changes, not routes\r\n    return changedFiles.some((file) => {\r\n      const relativePath = file.replace(/\\\\/g, \"/\");\r\n      return this.watchedFiles.includes(relativePath);\r\n    });\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;AAcA,SAAS,iBAAiB,aAA0B;CAClD,QAAQ,aAAR;EACE,KAAK,eACH,OAAO,OAAO,cAAc,WAAW;EACzC,KAAK,QACH,OAAO,OAAO,aAAa,WAAW;EACxC,KAAK,cACH,OAAO,OAAO,YAAY,WAAW;EACvC,SACE,OAAO,OAAO,MAAM,WAAW;CACnC;AACF;;;;;AAMA,IAAa,gBAAb,cAAmC,cAAc;;;cACxB;;;sBASW,CAAC,sBAAsB,qBAAqB;;;;;;;CAY9E,MAAa,OAAO;EAClB,MAAM,aAAa,OAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,YAAY;EAEjB,MAAM,OAAO,WAAW;EACxB,IAAI,KACF,QACA,cACA,gCAAgC,KAAK,MAAM,iBAAiB,YAAY,WAAW,EAAE,MACvF;EAEA,KAAK,OAAO,gBAAgB,WAAW,aAAa;EAEpD,UAAU,IAAI,eAAe,KAAK,IAAI;EAEtC,MAAM,oBAAoB,KAAK,IAAI;EAKnC,WAHgB,OAAO,IAAI,aAGV,CAAC;CACpB;;;;;;CAOA,MAAa,QAAuB;EAClC,MAAM,aAAa,OAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,cAAc,CAAC,KAAK,MAAM;EAE/B,IAAI,YAAY,oBAAoB,eAClC,OAAO,cAAc,KAAK,IAAI;OAE9B,OAAO,KAAK,KAAK,IAAI;EAGvB,IAAI;GAEF,MAAM,KAAK,KAAK,OAAO;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW,QAAQ;GAC3B,CAAC;GAED,MAAM,UAAU,OAAO,IAAI,aAAa;GAExC,IAAI,QAAQ,QAAQ,cAAc,mBAAmB,SAAS;EAChE,SAAS,OAAO;GACd,YAAY,oCAAoC,KAAK;GAMrD,MAAM,IAAI,MAAM,QAAQ,cAAc,KAAK;GAC3C,MAAM,IAAI,MAAM;GAEhB,QAAQ,KAAK,CAAC;EAChB;EAEA,KAAK,SAAS;CAChB;;;;;;CAOA,MAAa,UAAyB;EACpC,MAAM,KAAK,SAAS;EACpB,MAAM,KAAK,KAAK;EAChB,MAAM,KAAK,MAAM;CACnB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAKF,AAFe,cAEV,CAAC,EAAE,MAAM;EAEd,KAAK,SAAS;CAChB;;;;;;CAOA,AAAO,cAAc,cAAiC;EAEpD,OAAO,aAAa,MAAM,SAAS;GACjC,MAAM,eAAe,KAAK,QAAQ,OAAO,GAAG;GAC5C,OAAO,KAAK,aAAa,SAAS,YAAY;EAChD,CAAC;CACH;AACF"}
+{"version":3,"file":"http-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/http-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { Application } from \"../application\";\r\nimport { devLogError } from \"../dev-server/dev-logger\";\r\nimport { health } from \"../http/health\";\r\nimport { registerHttpPlugins } from \"../http/plugins\";\r\nimport { closeServerWithTimeout, FastifyInstance, getHttpServer, startHttpServer } from \"../http/server\";\r\nimport { router } from \"../router/router\";\r\nimport { Environment } from \"../utils\";\r\nimport { setBaseUrl } from \"../utils/urls\";\r\nimport { container } from \"./../container\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\nfunction environmentColor(environment: Environment) {\r\n  switch (environment) {\r\n    case \"development\":\r\n      return colors.magentaBright(environment);\r\n    case \"test\":\r\n      return colors.yellowBright(environment);\r\n    case \"production\":\r\n      return colors.greenBright(environment);\r\n    default:\r\n      return colors.white(environment);\r\n  }\r\n}\r\n\r\n/**\r\n * Default time to wait for in-flight requests to drain on shutdown before the\r\n * HTTP server is force-closed. Override via `http.gracefulShutdown.timeout`.\r\n */\r\nconst DEFAULT_SHUTDOWN_TIMEOUT = 10_000;\r\n\r\n/**\r\n * HTTP Connector\r\n * Manages HTTP server (Fastify) lifecycle\r\n */\r\nexport class HttpConnector extends BaseConnector {\r\n  public readonly name = \"http\";\r\n  public readonly priority = ConnectorPriority.HTTP;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\r\n\r\n  /**\r\n   * Files that trigger HTTP server restart\r\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\r\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/http.ts\", \"src/config/http.tsx\"];\r\n\r\n  /**\r\n   * Fastify Server instance\r\n   */\r\n  protected http?: FastifyInstance;\r\n\r\n  /**\r\n   * Boot the connector — construction only (create Fastify, register\r\n   * plugins, populate container). Route scanning is deferred to\r\n   * `start()` so it reads the router after app code has registered.\r\n   */\r\n  public async boot() {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig) return;\r\n\r\n    const port = httpConfig.port;\r\n    log.info(\r\n      `http`,\r\n      \"connection\",\r\n      `Starting http server on port ${port} in ${environmentColor(Application.environment)} mode`,\r\n    );\r\n\r\n    this.http = startHttpServer(httpConfig.serverOptions);\r\n\r\n    container.set(\"http.server\", this.http);\r\n\r\n    await registerHttpPlugins(this.http);\r\n\r\n    const baseUrl = config.get(\"app.baseUrl\");\r\n\r\n    // update base url\r\n    setBaseUrl(baseUrl);\r\n\r\n    // Liveness/readiness endpoints — registered on Fastify before start() scans\r\n    // the app router, so they exist by the time the server listens.\r\n    this.registerHealthRoutes();\r\n  }\r\n\r\n  /**\r\n   * Register the built-in liveness (`/health`) and readiness (`/ready`)\r\n   * endpoints directly on the Fastify instance — infra routes, kept off the app\r\n   * router so they're immune to HMR and never collide with route scanning. Opt\r\n   * out via `http.health.enabled = false`; rename via `http.health.path` /\r\n   * `http.health.readinessPath`.\r\n   */\r\n  private registerHealthRoutes(): void {\r\n    if (!this.http) {\r\n      return;\r\n    }\r\n\r\n    const healthConfig = config.get(\"http.health\");\r\n\r\n    if (healthConfig?.enabled === false) {\r\n      return;\r\n    }\r\n\r\n    const livenessPath = healthConfig?.path ?? \"/health\";\r\n    const readinessPath = healthConfig?.readinessPath ?? \"/ready\";\r\n\r\n    this.http.get(livenessPath, async (_request: any, reply: any) => {\r\n      const result = health.liveness();\r\n\r\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\r\n    });\r\n\r\n    this.http.get(readinessPath, async (_request: any, reply: any) => {\r\n      const result = await health.readiness();\r\n\r\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Initialize HTTP server — bind app-registered routes to Fastify\r\n   * then listen. Scanning here (not in `boot`) lets HTTP boot before\r\n   * app code without losing routes.\r\n   */\r\n  public async start(): Promise<void> {\r\n    const httpConfig = config.get(\"http\");\r\n\r\n    if (!httpConfig || !this.http) return;\r\n\r\n    if (Application.runtimeStrategy === \"development\") {\r\n      router.scanDevServer(this.http);\r\n    } else {\r\n      router.scan(this.http);\r\n    }\r\n\r\n    try {\r\n      // We can use the url of the server\r\n      await this.http.listen({\r\n        port: httpConfig.port,\r\n        host: httpConfig.host || \"localhost\",\r\n      });\r\n\r\n      const baseUrl = config.get(\"app.baseUrl\");\r\n\r\n      log.success(`http`, \"connection\", `Server ready at ${baseUrl}`);\r\n    } catch (error) {\r\n      devLogError(\"Error while starting http server\", error);\r\n\r\n      // A failed listen()/port-bind at boot means the app can't serve — fatal.\r\n      // devLogError above is the dev-server console UI and bypasses the logger\r\n      // pipeline, so also route it through `log.fatal` to reach Sentry/file,\r\n      // then `await log.flush()` to drain buffered/async channels before exit.\r\n      await log.fatal(\"http\", \"connection\", error);\r\n      await log.flush();\r\n\r\n      process.exit(1); // stop the process, exit with error\r\n    }\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Restart — needs a fresh Fastify instance since `start()` now\r\n   * re-runs `router.scan()`, and re-scanning the same Fastify would\r\n   * register duplicate route handlers.\r\n   */\r\n  public async restart(): Promise<void> {\r\n    await this.shutdown();\r\n    await this.boot();\r\n    await this.start();\r\n  }\r\n\r\n  /**\r\n   * Shutdown HTTP server\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    const server = getHttpServer();\r\n\r\n    if (server) {\r\n      const timeout = config.get(\"http.gracefulShutdown.timeout\", DEFAULT_SHUTDOWN_TIMEOUT);\r\n      const drained = await closeServerWithTimeout(server, timeout);\r\n\r\n      if (!drained) {\r\n        log.warn(\r\n          \"http\",\r\n          \"shutdown\",\r\n          `In-flight requests did not drain within ${timeout}ms; closing anyway`,\r\n        );\r\n      }\r\n    }\r\n\r\n    this.active = false;\r\n  }\r\n\r\n  /**\r\n   * Override shouldRestart to handle routes.ts specially\r\n   * routes.ts changes should NOT restart the server (use HMR instead)\r\n   * Now receives config file paths directly from layer-executor\r\n   */\r\n  public shouldRestart(changedFiles: string[]): boolean {\r\n    // Only restart for config changes, not routes\r\n    return changedFiles.some((file) => {\r\n      const relativePath = file.replace(/\\\\/g, \"/\");\r\n      return this.watchedFiles.includes(relativePath);\r\n    });\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAS,iBAAiB,aAA0B;CAClD,QAAQ,aAAR;EACE,KAAK,eACH,OAAO,OAAO,cAAc,WAAW;EACzC,KAAK,QACH,OAAO,OAAO,aAAa,WAAW;EACxC,KAAK,cACH,OAAO,OAAO,YAAY,WAAW;EACvC,SACE,OAAO,OAAO,MAAM,WAAW;CACnC;AACF;;;;;AAMA,MAAM,2BAA2B;;;;;AAMjC,IAAa,gBAAb,cAAmC,cAAc;;;cACxB;;;sBASW,CAAC,sBAAsB,qBAAqB;;;;;;;CAY9E,MAAa,OAAO;EAClB,MAAM,aAAaA,WAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,YAAY;EAEjB,MAAM,OAAO,WAAW;EACxB,IAAI,KACF,QACA,cACA,gCAAgC,KAAK,MAAM,iBAAiB,YAAY,WAAW,EAAE,MACvF;EAEA,KAAK,OAAO,gBAAgB,WAAW,aAAa;EAEpD,UAAU,IAAI,eAAe,KAAK,IAAI;EAEtC,MAAM,oBAAoB,KAAK,IAAI;EAKnC,WAHgBA,WAAO,IAAI,aAGV,CAAC;EAIlB,KAAK,qBAAqB;CAC5B;;;;;;;;CASA,AAAQ,uBAA6B;EACnC,IAAI,CAAC,KAAK,MACR;EAGF,MAAM,eAAeA,WAAO,IAAI,aAAa;EAE7C,IAAI,cAAc,YAAY,OAC5B;EAGF,MAAM,eAAe,cAAc,QAAQ;EAC3C,MAAM,gBAAgB,cAAc,iBAAiB;EAErD,KAAK,KAAK,IAAI,cAAc,OAAO,UAAe,UAAe;GAC/D,MAAM,SAAS,OAAO,SAAS;GAE/B,OAAO,MAAM,KAAK,OAAO,WAAW,OAAO,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM;EACnE,CAAC;EAED,KAAK,KAAK,IAAI,eAAe,OAAO,UAAe,UAAe;GAChE,MAAM,SAAS,MAAM,OAAO,UAAU;GAEtC,OAAO,MAAM,KAAK,OAAO,WAAW,OAAO,MAAM,GAAG,CAAC,CAAC,KAAK,MAAM;EACnE,CAAC;CACH;;;;;;CAOA,MAAa,QAAuB;EAClC,MAAM,aAAaA,WAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,cAAc,CAAC,KAAK,MAAM;EAE/B,IAAI,YAAY,oBAAoB,eAClC,OAAO,cAAc,KAAK,IAAI;OAE9B,OAAO,KAAK,KAAK,IAAI;EAGvB,IAAI;GAEF,MAAM,KAAK,KAAK,OAAO;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW,QAAQ;GAC3B,CAAC;GAED,MAAM,UAAUA,WAAO,IAAI,aAAa;GAExC,IAAI,QAAQ,QAAQ,cAAc,mBAAmB,SAAS;EAChE,SAAS,OAAO;GACd,YAAY,oCAAoC,KAAK;GAMrD,MAAM,IAAI,MAAM,QAAQ,cAAc,KAAK;GAC3C,MAAM,IAAI,MAAM;GAEhB,QAAQ,KAAK,CAAC;EAChB;EAEA,KAAK,SAAS;CAChB;;;;;;CAOA,MAAa,UAAyB;EACpC,MAAM,KAAK,SAAS;EACpB,MAAM,KAAK,KAAK;EAChB,MAAM,KAAK,MAAM;CACnB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,MAAM,SAAS,cAAc;EAE7B,IAAI,QAAQ;GACV,MAAM,UAAUA,WAAO,IAAI,iCAAiC,wBAAwB;GAGpF,IAAI,CAAC,MAFiB,uBAAuB,QAAQ,OAAO,GAG1D,IAAI,KACF,QACA,YACA,2CAA2C,QAAQ,mBACrD;EAEJ;EAEA,KAAK,SAAS;CAChB;;;;;;CAOA,AAAO,cAAc,cAAiC;EAEpD,OAAO,aAAa,MAAM,SAAS;GACjC,MAAM,eAAe,KAAK,QAAQ,OAAO,GAAG;GAC5C,OAAO,KAAK,aAAa,SAAS,YAAY;EAChD,CAAC;CACH;AACF"}

package/esm/connectors/index.d.mts

@@ -1,6 +1,7 @@
 import { Connector, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 import { AccessConnector } from "./access-connector.mjs";
+import { AiConnector } from "./ai-connector.mjs";
 import { CacheConnector } from "./cache-connector.mjs";
 import { HeraldConnector } from "./herald-connector.mjs";
 import { ConnectorsManager, connectorsManager } from "./connectors-manager.mjs";

package/esm/connectors/index.mjs

@@ -1,6 +1,7 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 import { AccessConnector } from "./access-connector.mjs";
+import { AiConnector } from "./ai-connector.mjs";
 import { CacheConnector } from "./cache-connector.mjs";
 import { HeraldConnector } from "./herald-connector.mjs";
 import { DatabaseConnector } from "./database-connector.mjs";

package/esm/connectors/logger-connector.mjs

@@ -2,7 +2,7 @@ import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 import { setLogConfigurations } from "../logger/logger.mjs";
 import "../logger/index.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { log } from "@warlock.js/logger";
 
 //#region ../@warlock.js/core/src/connectors/logger-connector.ts
@@ -22,7 +22,7 @@ var LoggerConnector = class extends BaseConnector {
 	* Initialize logger configurations
 	*/
 	async start() {
-		const logConfig = config.get("log");
+		const logConfig = baseConfig.get("log");
 		if (!logConfig) return;
 		try {
 			setLogConfigurations(logConfig);

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

@@ -1 +1 @@
-{"version":3,"file":"logger-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/logger-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { setLogConfigurations } from \"../logger\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Logger Connector\r\n * Manages logger lifecycle and ensures synchronous flushing on termination\r\n */\r\nexport class LoggerConnector extends BaseConnector {\r\n  public readonly name = \"logger\";\r\n  public readonly priority = ConnectorPriority.LOGGER;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger logger restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/log.ts\", \"src/config/log.tsx\"];\r\n\r\n  /**\r\n   * Initialize logger configurations\r\n   */\r\n  public async start(): Promise<void> {\r\n    const logConfig = config.get(\"log\");\r\n\r\n    if (!logConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      setLogConfigurations(logConfig);\r\n      this.active = true;\r\n    } catch (error) {\r\n      console.error(\"Failed to initialize logger:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown logger and flush messages synchronously\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      log.flushSync();\r\n      this.active = false;\r\n    } catch (error) {\r\n      console.error(\"Failed to flush logger:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAUA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,qBAAqB,oBAAoB;;;;;CAK5E,MAAa,QAAuB;EAClC,MAAM,YAAY,OAAO,IAAI,KAAK;EAElC,IAAI,CAAC,WACH;EAGF,IAAI;GACF,qBAAqB,SAAS;GAC9B,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,gCAAgC,KAAK;GACnD,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GACF,IAAI,UAAU;GACd,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,2BAA2B,KAAK;GAC9C,MAAM;EACR;CACF;AACF"}
+{"version":3,"file":"logger-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/logger-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { setLogConfigurations } from \"../logger\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Logger Connector\r\n * Manages logger lifecycle and ensures synchronous flushing on termination\r\n */\r\nexport class LoggerConnector extends BaseConnector {\r\n  public readonly name = \"logger\";\r\n  public readonly priority = ConnectorPriority.LOGGER;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger logger restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/log.ts\", \"src/config/log.tsx\"];\r\n\r\n  /**\r\n   * Initialize logger configurations\r\n   */\r\n  public async start(): Promise<void> {\r\n    const logConfig = config.get(\"log\");\r\n\r\n    if (!logConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      setLogConfigurations(logConfig);\r\n      this.active = true;\r\n    } catch (error) {\r\n      console.error(\"Failed to initialize logger:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown logger and flush messages synchronously\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      log.flushSync();\r\n      this.active = false;\r\n    } catch (error) {\r\n      console.error(\"Failed to flush logger:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAUA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,qBAAqB,oBAAoB;;;;;CAK5E,MAAa,QAAuB;EAClC,MAAM,YAAYA,WAAO,IAAI,KAAK;EAElC,IAAI,CAAC,WACH;EAGF,IAAI;GACF,qBAAqB,SAAS;GAC9B,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,gCAAgC,KAAK;GACnD,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GACF,IAAI,UAAU;GACd,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,2BAA2B,KAAK;GAC9C,MAAM;EACR;CACF;AACF"}

package/esm/connectors/mail-connector.mjs

@@ -3,7 +3,7 @@ import { BaseConnector } from "./base-connector.mjs";
 import { setMailConfigurations } from "../mail/config.mjs";
 import { closeAllMailers } from "../mail/mailer-pool.mjs";
 import "../mail/index.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 
 //#region ../@warlock.js/core/src/connectors/mail-connector.ts
 /**
@@ -26,7 +26,7 @@ var MailerConnector = class extends BaseConnector {
 	* Initialize mailer configurations
 	*/
 	async start() {
-		const mailConfig = config.get("mail");
+		const mailConfig = baseConfig.get("mail");
 		if (!mailConfig) return;
 		try {
 			setMailConfigurations(mailConfig);

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

@@ -1 +1 @@
-{"version":3,"file":"mail-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/mail-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { closeAllMailers, setMailConfigurations } from \"../mail\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Mailer Connector\r\n * Manages mailer lifecycle and ensures graceful pool shutdown\r\n */\r\nexport class MailerConnector extends BaseConnector {\r\n  public readonly name = \"mailer\";\r\n  public readonly priority = ConnectorPriority.MAILER;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger mailer restart\r\n   */\r\n  protected readonly watchedFiles = [\".env\", \"src/config/mail.ts\", \"src/config/mail.tsx\"];\r\n\r\n  /**\r\n   * Initialize mailer configurations\r\n   */\r\n  public async start(): Promise<void> {\r\n    const mailConfig = config.get(\"mail\");\r\n\r\n    if (!mailConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      setMailConfigurations(mailConfig);\r\n      this.active = true;\r\n    } catch (error) {\r\n      console.error(\"Failed to initialize mailer:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown mailer pool\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      closeAllMailers();\r\n      this.active = false;\r\n    } catch (error) {\r\n      console.error(\"Failed to close all mailers:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;AASA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW;GAAC;GAAQ;GAAsB;EAAqB;;;;;CAKtF,MAAa,QAAuB;EAClC,MAAM,aAAa,OAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,YACH;EAGF,IAAI;GACF,sBAAsB,UAAU;GAChC,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,gCAAgC,KAAK;GACnD,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GACF,gBAAgB;GAChB,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,gCAAgC,KAAK;GACnD,MAAM;EACR;CACF;AACF"}
+{"version":3,"file":"mail-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/mail-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { closeAllMailers, setMailConfigurations } from \"../mail\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Mailer Connector\r\n * Manages mailer lifecycle and ensures graceful pool shutdown\r\n */\r\nexport class MailerConnector extends BaseConnector {\r\n  public readonly name = \"mailer\";\r\n  public readonly priority = ConnectorPriority.MAILER;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger mailer restart\r\n   */\r\n  protected readonly watchedFiles = [\".env\", \"src/config/mail.ts\", \"src/config/mail.tsx\"];\r\n\r\n  /**\r\n   * Initialize mailer configurations\r\n   */\r\n  public async start(): Promise<void> {\r\n    const mailConfig = config.get(\"mail\");\r\n\r\n    if (!mailConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      setMailConfigurations(mailConfig);\r\n      this.active = true;\r\n    } catch (error) {\r\n      console.error(\"Failed to initialize mailer:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown mailer pool\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      closeAllMailers();\r\n      this.active = false;\r\n    } catch (error) {\r\n      console.error(\"Failed to close all mailers:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;AASA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW;GAAC;GAAQ;GAAsB;EAAqB;;;;;CAKtF,MAAa,QAAuB;EAClC,MAAM,aAAaA,WAAO,IAAI,MAAM;EAEpC,IAAI,CAAC,YACH;EAGF,IAAI;GACF,sBAAsB,UAAU;GAChC,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,gCAAgC,KAAK;GACnD,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GACF,gBAAgB;GAChB,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,gCAAgC,KAAK;GACnD,MAAM;EACR;CACF;AACF"}

package/esm/connectors/notifications-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/notifications-connector.ts
@@ -28,7 +28,7 @@ var NotificationsConnector = class extends BaseConnector {
 	* Register the notifications configuration with the package.
 	*/
 	async start() {
-		const notificationsConfig = config.get("notifications");
+		const notificationsConfig = baseConfig.get("notifications");
 		if (!notificationsConfig) return;
 		const { setNotificationConfig } = await import("@warlock.js/notifications");
 		setNotificationConfig(notificationsConfig);

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

@@ -1 +1 @@
-{"version":3,"file":"notifications-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/notifications-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 * Notifications Connector\n *\n * Wires `@warlock.js/notifications` from `src/config/notifications.ts` at boot:\n * reads the exported config object and hands it to the package's\n * `setNotificationConfig`. Config files stay declarative — they export the\n * config, the connector performs the side-effect.\n *\n * The package is lazy-imported (only when a notifications config is present),\n * so core carries no hard dependency on it — the same pattern as the herald\n * connector with `@warlock.js/herald`.\n */\nexport class NotificationsConnector extends BaseConnector {\n  public readonly name = \"notifications\";\n  public readonly priority = ConnectorPriority.NOTIFICATIONS;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger a notifications restart\n   */\n  protected readonly watchedFiles = [\"src/config/notifications.ts\"];\n\n  /**\n   * Register the notifications configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const notificationsConfig = config.get(\"notifications\");\n\n    if (!notificationsConfig) {\n      return;\n    }\n\n    const { setNotificationConfig } = await import(\"@warlock.js/notifications\");\n\n    setNotificationConfig(notificationsConfig);\n    this.active = true;\n\n    log.info(\"notifications\", \"configured\", \"Notifications wired from config/notifications.ts\");\n  }\n\n  /**\n   * Nothing to tear down — the package holds no external connection of its own\n   * (the optional queue worker + its broker own their lifecycle). Clear the\n   * active flag so a dev restart re-registers from the (possibly changed) config.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,IAAa,yBAAb,cAA4C,cAAc;;;cACjC;;;sBAOW,CAAC,6BAA6B;;;;;CAKhE,MAAa,QAAuB;EAClC,MAAM,sBAAsB,OAAO,IAAI,eAAe;EAEtD,IAAI,CAAC,qBACH;EAGF,MAAM,EAAE,0BAA0B,MAAM,OAAO;EAE/C,sBAAsB,mBAAmB;EACzC,KAAK,SAAS;EAEd,IAAI,KAAK,iBAAiB,cAAc,kDAAkD;CAC5F;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"notifications-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/notifications-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 * Notifications Connector\n *\n * Wires `@warlock.js/notifications` from `src/config/notifications.ts` at boot:\n * reads the exported config object and hands it to the package's\n * `setNotificationConfig`. Config files stay declarative — they export the\n * config, the connector performs the side-effect.\n *\n * The package is lazy-imported (only when a notifications config is present),\n * so core carries no hard dependency on it — the same pattern as the herald\n * connector with `@warlock.js/herald`.\n */\nexport class NotificationsConnector extends BaseConnector {\n  public readonly name = \"notifications\";\n  public readonly priority = ConnectorPriority.NOTIFICATIONS;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger a notifications restart\n   */\n  protected readonly watchedFiles = [\"src/config/notifications.ts\"];\n\n  /**\n   * Register the notifications configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const notificationsConfig = config.get(\"notifications\");\n\n    if (!notificationsConfig) {\n      return;\n    }\n\n    const { setNotificationConfig } = await import(\"@warlock.js/notifications\");\n\n    setNotificationConfig(notificationsConfig);\n    this.active = true;\n\n    log.info(\"notifications\", \"configured\", \"Notifications wired from config/notifications.ts\");\n  }\n\n  /**\n   * Nothing to tear down — the package holds no external connection of its own\n   * (the optional queue worker + its broker own their lifecycle). Clear the\n   * active flag so a dev restart re-registers from the (possibly changed) config.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,IAAa,yBAAb,cAA4C,cAAc;;;cACjC;;;sBAOW,CAAC,6BAA6B;;;;;CAKhE,MAAa,QAAuB;EAClC,MAAM,sBAAsBA,WAAO,IAAI,eAAe;EAEtD,IAAI,CAAC,qBACH;EAGF,MAAM,EAAE,0BAA0B,MAAM,OAAO;EAE/C,sBAAsB,mBAAmB;EACzC,KAAK,SAAS;EAEd,IAAI,KAAK,iBAAiB,cAAc,kDAAkD;CAC5F;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/socket-connector.d.mts

@@ -18,6 +18,15 @@ declare class SocketConnector extends BaseConnector {
    */
   protected readonly watchedFiles: string[];
   protected socket?: Server;
+  /**
+   * Whether this connector created the underlying node HTTP(S) server.
+   *
+   * When `http` is present, socket binds onto the HTTP connector's shared
+   * `fastify.server` and must NOT close it on shutdown — the HTTP connector
+   * owns the graceful drain. Socket only closes the node server when it
+   * created one itself (http absent). See {@link shutdown}.
+   */
+  protected ownsRawServer: boolean;
   /**
    * Boot the connector
    */
@@ -27,7 +36,13 @@ declare class SocketConnector extends BaseConnector {
    */
   start(): Promise<void>;
   /**
-   * Shutdown HTTP server
+   * Shutdown Socket server
+   *
+   * Always closes the Socket.IO layer (and awaits the drain). The underlying
+   * node HTTP(S) server is only closed here when this connector created it
+   * ({@link ownsRawServer}); when `http` owns the shared server, we leave it
+   * for the HTTP connector to drain and close, so the two connectors don't
+   * race to `close()` the same socket.
    */
   shutdown(): Promise<void>;
 }

package/esm/connectors/socket-connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/socket-connector.ts"],"mappings":";;;;;;;AA8BA;;cAAa,eAAA,SAAwB,aAAA;EAAA,SACnB,IAAA,EAAM,aAAA;EAAA,SACN,QAAA,GAAQ,iBAAA,CAAA,MAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EASX;;;;;EAAA,mBAFA,YAAA;EAAA,UAET,MAAA,GAAS,MAAA;EAZgB;;;EAiBtB,IAAA,IAAI,OAAA;EAfO;;;EAqDX,KAAA,IAAS,OAAA;EApDQ;;;EAmEjB,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"socket-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/socket-connector.ts"],"mappings":";;;;;;;AA8BA;;cAAa,eAAA,SAAwB,aAAA;EAAA,SACnB,IAAA,EAAM,aAAA;EAAA,SACN,QAAA,GAAQ,iBAAA,CAAA,MAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EASX;;;;;EAAA,mBAFA,YAAA;EAAA,UAET,MAAA,GAAS,MAAA;EAZgB;;;;;;;;EAAA,UAsBzB,aAAA;EAZS;;;EAiBN,IAAA,IAAI,OAAA;EAAJ;;;EAwCA,KAAA,IAAS,OAAA;EAqBT;;;AAAmB;;;;;;EAAnB,QAAA,IAAY,OAAA;AAAA"}

package/esm/connectors/socket-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 { log } from "@warlock.js/logger";
 import { createServer } from "http";
 import { createServer as createServer$1 } from "https";
@@ -34,12 +34,13 @@ var SocketConnector = class extends BaseConnector {
 		this.priority = 7;
 		this.lifecyclePhase = "late";
 		this.watchedFiles = ["src/config/socket.ts"];
+		this.ownsRawServer = false;
 	}
 	/**
 	* Boot the connector
 	*/
 	async boot() {
-		const socketConfig = config.get("socket");
+		const socketConfig = baseConfig.get("socket");
 		if (!socketConfig) return;
 		let SocketServer;
 		try {
@@ -49,10 +50,13 @@ var SocketConnector = class extends BaseConnector {
 		}
 		log.info("socket", "connection", "Starting Socket.IO server");
 		let server;
-		if (container.has("http.server")) server = container.get("http.server").server;
-		else {
+		if (container.has("http.server")) {
+			server = container.get("http.server").server;
+			this.ownsRawServer = false;
+		} else {
 			server = socketConfig.ssl ? createServer$1() : createServer();
 			server.listen(socketConfig.port);
+			this.ownsRawServer = true;
 		}
 		container.set("socket.rawServer", server);
 		this.socket = new SocketServer(server, socketConfig.options);
@@ -62,17 +66,36 @@ var SocketConnector = class extends BaseConnector {
 	* Initialize Socket server
 	*/
 	async start() {
-		if (!config.get("socket") || !this.socket) return;
+		if (!baseConfig.get("socket") || !this.socket) return;
 		log.success("socket", "connection", "Established Socket.IO server");
 		this.active = true;
 	}
 	/**
-	* Shutdown HTTP server
+	* Shutdown Socket server
+	*
+	* Always closes the Socket.IO layer (and awaits the drain). The underlying
+	* node HTTP(S) server is only closed here when this connector created it
+	* ({@link ownsRawServer}); when `http` owns the shared server, we leave it
+	* for the HTTP connector to drain and close, so the two connectors don't
+	* race to `close()` the same socket.
 	*/
 	async shutdown() {
 		if (!this.active) return;
-		if (container.has("socket")) container.get("socket").close();
-		if (container.has("socket.rawServer")) container.get("socket.rawServer").close();
+		if (container.has("socket")) {
+			const socket = container.get("socket");
+			await new Promise((resolve) => {
+				socket.close(() => resolve());
+			});
+		}
+		if (this.ownsRawServer && container.has("socket.rawServer")) {
+			const server = container.get("socket.rawServer");
+			await new Promise((resolve, reject) => {
+				server.close((error) => {
+					if (error) reject(error);
+					else resolve();
+				});
+			});
+		}
 		this.active = false;
 	}
 };

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

@@ -1 +1 @@
-{"version":3,"file":"socket-connector.mjs","names":["createHttpsServer","createHttpServer"],"sources":["../../../../../../../@warlock.js/core/src/connectors/socket-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { createServer as createHttpServer } from \"http\";\r\nimport { createServer as createHttpsServer } from \"https\";\r\nimport type { Server } from \"socket.io\";\r\nimport { container } from \"../container\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorName, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Shown when a project enables sockets (a `socket` config is present) but the\r\n * optional `socket.io` peer is not installed.\r\n */\r\nconst SOCKET_INSTALL_INSTRUCTIONS = `\r\nRealtime socket server requires the socket.io package.\r\nInstall it with:\r\n\r\n  warlock add socket\r\n\r\nOr manually:\r\n\r\n  npm install socket.io\r\n  pnpm add socket.io\r\n  yarn add socket.io\r\n`.trim();\r\n\r\n/**\r\n * Socket Connector\r\n * Manages Socket server (Socket.IO) lifecycle\r\n */\r\nexport class SocketConnector extends BaseConnector {\r\n  public readonly name: ConnectorName = \"socket\";\r\n  public readonly priority = ConnectorPriority.SOCKET;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\r\n\r\n  /**\r\n   * Files that trigger Socket server restart\r\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\r\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/socket.ts\"];\r\n\r\n  protected socket?: Server;\r\n\r\n  /**\r\n   * Boot the connector\r\n   */\r\n  public async boot() {\r\n    const socketConfig = config.get(\"socket\");\r\n\r\n    if (!socketConfig) return;\r\n\r\n    // socket.io is an optional peer — load it lazily so projects that don't use\r\n    // realtime sockets never need it installed (mirrors the mail/storage drivers).\r\n    let SocketServer: typeof import(\"socket.io\").Server;\r\n    try {\r\n      ({ Server: SocketServer } = await import(\"socket.io\"));\r\n    } catch {\r\n      throw new Error(SOCKET_INSTALL_INSTRUCTIONS);\r\n    }\r\n\r\n    log.info(\"socket\", \"connection\", \"Starting Socket.IO server\");\r\n\r\n    // now we have two cases\r\n    // 1. http is used, then use it\r\n    // 2. http is not used, then create a new server\r\n    let server;\r\n    if (container.has(\"http.server\")) {\r\n      const fastify = container.get(\"http.server\");\r\n      server = fastify.server;\r\n    } else {\r\n      server = socketConfig.ssl ? createHttpsServer() : createHttpServer();\r\n      server.listen(socketConfig.port);\r\n    }\r\n\r\n    container.set(\"socket.rawServer\", server);\r\n\r\n    this.socket = new SocketServer(server, socketConfig.options);\r\n\r\n    container.set(\"socket\", this.socket);\r\n  }\r\n\r\n  /**\r\n   * Initialize Socket server\r\n   */\r\n  public async start(): Promise<void> {\r\n    const socketConfig = config.get(\"socket\");\r\n\r\n    // `this.socket` is only set by boot() once a socket config is present —\r\n    // use it (not a never-assigned field) to detect a successful boot.\r\n    if (!socketConfig || !this.socket) return;\r\n\r\n    log.success(\"socket\", \"connection\", \"Established Socket.IO server\");\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Shutdown HTTP server\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    if (container.has(\"socket\")) {\r\n      const socket = container.get(\"socket\");\r\n      socket.close();\r\n    }\r\n\r\n    if (container.has(\"socket.rawServer\")) {\r\n      const server = container.get(\"socket.rawServer\");\r\n      server.close();\r\n    }\r\n\r\n    this.active = false;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAM,8BAA8B;;;;;;;;;;;EAWlC,KAAK;;;;;AAMP,IAAa,kBAAb,cAAqC,cAAc;;;cACX;;;sBASJ,CAAC,sBAAsB;;;;;CAOzD,MAAa,OAAO;EAClB,MAAM,eAAe,OAAO,IAAI,QAAQ;EAExC,IAAI,CAAC,cAAc;EAInB,IAAI;EACJ,IAAI;GACF,CAAC,CAAE,QAAQ,gBAAiB,MAAM,OAAO;EAC3C,QAAQ;GACN,MAAM,IAAI,MAAM,2BAA2B;EAC7C;EAEA,IAAI,KAAK,UAAU,cAAc,2BAA2B;EAK5D,IAAI;EACJ,IAAI,UAAU,IAAI,aAAa,GAE7B,SADgB,UAAU,IAAI,aACf,CAAC,CAAC;OACZ;GACL,SAAS,aAAa,MAAMA,eAAkB,IAAIC,aAAiB;GACnE,OAAO,OAAO,aAAa,IAAI;EACjC;EAEA,UAAU,IAAI,oBAAoB,MAAM;EAExC,KAAK,SAAS,IAAI,aAAa,QAAQ,aAAa,OAAO;EAE3D,UAAU,IAAI,UAAU,KAAK,MAAM;CACrC;;;;CAKA,MAAa,QAAuB;EAKlC,IAAI,CAJiB,OAAO,IAAI,QAIhB,KAAK,CAAC,KAAK,QAAQ;EAEnC,IAAI,QAAQ,UAAU,cAAc,8BAA8B;EAElE,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI,UAAU,IAAI,QAAQ,GAExB,AADe,UAAU,IAAI,QACxB,CAAC,CAAC,MAAM;EAGf,IAAI,UAAU,IAAI,kBAAkB,GAElC,AADe,UAAU,IAAI,kBACxB,CAAC,CAAC,MAAM;EAGf,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"socket-connector.mjs","names":["config","createHttpsServer","createHttpServer"],"sources":["../../../../../../../@warlock.js/core/src/connectors/socket-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { createServer as createHttpServer } from \"http\";\nimport { createServer as createHttpsServer } from \"https\";\nimport type { Server } from \"socket.io\";\nimport { container } from \"../container\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorName, ConnectorPriority } from \"./types\";\n\n/**\n * Shown when a project enables sockets (a `socket` config is present) but the\n * optional `socket.io` peer is not installed.\n */\nconst SOCKET_INSTALL_INSTRUCTIONS = `\nRealtime socket server requires the socket.io package.\nInstall it with:\n\n  warlock add socket\n\nOr manually:\n\n  npm install socket.io\n  pnpm add socket.io\n  yarn add socket.io\n`.trim();\n\n/**\n * Socket Connector\n * Manages Socket server (Socket.IO) lifecycle\n */\nexport class SocketConnector extends BaseConnector {\n  public readonly name: ConnectorName = \"socket\";\n  public readonly priority = ConnectorPriority.SOCKET;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\n\n  /**\n   * Files that trigger Socket server restart\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\n   */\n  protected readonly watchedFiles = [\"src/config/socket.ts\"];\n\n  protected socket?: Server;\n\n  /**\n   * Whether this connector created the underlying node HTTP(S) server.\n   *\n   * When `http` is present, socket binds onto the HTTP connector's shared\n   * `fastify.server` and must NOT close it on shutdown — the HTTP connector\n   * owns the graceful drain. Socket only closes the node server when it\n   * created one itself (http absent). See {@link shutdown}.\n   */\n  protected ownsRawServer = false;\n\n  /**\n   * Boot the connector\n   */\n  public async boot() {\n    const socketConfig = config.get(\"socket\");\n\n    if (!socketConfig) return;\n\n    // socket.io is an optional peer — load it lazily so projects that don't use\n    // realtime sockets never need it installed (mirrors the mail/storage drivers).\n    let SocketServer: typeof import(\"socket.io\").Server;\n    try {\n      ({ Server: SocketServer } = await import(\"socket.io\"));\n    } catch {\n      throw new Error(SOCKET_INSTALL_INSTRUCTIONS);\n    }\n\n    log.info(\"socket\", \"connection\", \"Starting Socket.IO server\");\n\n    // now we have two cases\n    // 1. http is used, then use it (shared — the HTTP connector owns it)\n    // 2. http is not used, then create a new server (we own it)\n    let server;\n    if (container.has(\"http.server\")) {\n      const fastify = container.get(\"http.server\");\n      server = fastify.server;\n      this.ownsRawServer = false;\n    } else {\n      server = socketConfig.ssl ? createHttpsServer() : createHttpServer();\n      server.listen(socketConfig.port);\n      this.ownsRawServer = true;\n    }\n\n    container.set(\"socket.rawServer\", server);\n\n    this.socket = new SocketServer(server, socketConfig.options);\n\n    container.set(\"socket\", this.socket);\n  }\n\n  /**\n   * Initialize Socket server\n   */\n  public async start(): Promise<void> {\n    const socketConfig = config.get(\"socket\");\n\n    // `this.socket` is only set by boot() once a socket config is present —\n    // use it (not a never-assigned field) to detect a successful boot.\n    if (!socketConfig || !this.socket) return;\n\n    log.success(\"socket\", \"connection\", \"Established Socket.IO server\");\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown Socket server\n   *\n   * Always closes the Socket.IO layer (and awaits the drain). The underlying\n   * node HTTP(S) server is only closed here when this connector created it\n   * ({@link ownsRawServer}); when `http` owns the shared server, we leave it\n   * for the HTTP connector to drain and close, so the two connectors don't\n   * race to `close()` the same socket.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    if (container.has(\"socket\")) {\n      const socket = container.get(\"socket\");\n      // socket.io's close() takes a callback — await it so shutdown doesn't\n      // report done while sockets are still draining.\n      await new Promise<void>((resolve) => {\n        socket.close(() => resolve());\n      });\n    }\n\n    if (this.ownsRawServer && container.has(\"socket.rawServer\")) {\n      const server = container.get(\"socket.rawServer\");\n      await new Promise<void>((resolve, reject) => {\n        server.close((error?: Error) => {\n          if (error) {\n            reject(error);\n          } else {\n            resolve();\n          }\n        });\n      });\n    }\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAM,8BAA8B;;;;;;;;;;;EAWlC,KAAK;;;;;AAMP,IAAa,kBAAb,cAAqC,cAAc;;;cACX;;;sBASJ,CAAC,sBAAsB;uBAY/B;;;;;CAK1B,MAAa,OAAO;EAClB,MAAM,eAAeA,WAAO,IAAI,QAAQ;EAExC,IAAI,CAAC,cAAc;EAInB,IAAI;EACJ,IAAI;GACF,CAAC,CAAE,QAAQ,gBAAiB,MAAM,OAAO;EAC3C,QAAQ;GACN,MAAM,IAAI,MAAM,2BAA2B;EAC7C;EAEA,IAAI,KAAK,UAAU,cAAc,2BAA2B;EAK5D,IAAI;EACJ,IAAI,UAAU,IAAI,aAAa,GAAG;GAEhC,SADgB,UAAU,IAAI,aACf,CAAC,CAAC;GACjB,KAAK,gBAAgB;EACvB,OAAO;GACL,SAAS,aAAa,MAAMC,eAAkB,IAAIC,aAAiB;GACnE,OAAO,OAAO,aAAa,IAAI;GAC/B,KAAK,gBAAgB;EACvB;EAEA,UAAU,IAAI,oBAAoB,MAAM;EAExC,KAAK,SAAS,IAAI,aAAa,QAAQ,aAAa,OAAO;EAE3D,UAAU,IAAI,UAAU,KAAK,MAAM;CACrC;;;;CAKA,MAAa,QAAuB;EAKlC,IAAI,CAJiBF,WAAO,IAAI,QAIhB,KAAK,CAAC,KAAK,QAAQ;EAEnC,IAAI,QAAQ,UAAU,cAAc,8BAA8B;EAElE,KAAK,SAAS;CAChB;;;;;;;;;;CAWA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI,UAAU,IAAI,QAAQ,GAAG;GAC3B,MAAM,SAAS,UAAU,IAAI,QAAQ;GAGrC,MAAM,IAAI,SAAe,YAAY;IACnC,OAAO,YAAY,QAAQ,CAAC;GAC9B,CAAC;EACH;EAEA,IAAI,KAAK,iBAAiB,UAAU,IAAI,kBAAkB,GAAG;GAC3D,MAAM,SAAS,UAAU,IAAI,kBAAkB;GAC/C,MAAM,IAAI,SAAe,SAAS,WAAW;IAC3C,OAAO,OAAO,UAAkB;KAC9B,IAAI,OACF,OAAO,KAAK;UAEZ,QAAQ;IAEZ,CAAC;GACH,CAAC;EACH;EAEA,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/storage.connector.d.mts

@@ -16,6 +16,13 @@ declare class StorageConnector extends BaseConnector {
   protected readonly watchedFiles: string[];
   /**
    * Initialize cache connection
+   *
+   * Unlike its siblings (database, cache, herald), this connector does NOT
+   * early-return when `config.get("storage")` is absent. Storage is
+   * intentionally always-on: `storage.init()` falls back to the built-in
+   * `local` driver (see `storageConfig("default", "local")`), so file storage
+   * works out of the box even when a project ships no `src/config/storage.ts`.
+   * A config-presence guard here would break that default local storage.
    */
   start(): Promise<void>;
   /**

package/esm/connectors/storage.connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/storage.connector.ts"],"mappings":";;;;;;AASA;;cAAa,gBAAA,SAAyB,aAAA;EAAA,SACpB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,OAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAoBL;;;EAAA,mBAfN,YAAA;EARiB;;;EAavB,KAAA,IAAS,OAAA;EAXE;;;EAqBX,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"storage.connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/storage.connector.ts"],"mappings":";;;;;;AASA;;cAAa,gBAAA,SAAyB,aAAA;EAAA,SACpB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,OAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EA2BL;;;EAAA,mBAtBN,YAAA;EARiB;;;;;;;;;;EAoBvB,KAAA,IAAS,OAAA;EAUT;;;EAAA,QAAA,IAAY,OAAA;AAAA"}

package/esm/connectors/storage.connector.mjs

@@ -19,6 +19,13 @@ var StorageConnector = class extends BaseConnector {
 	}
 	/**
 	* Initialize cache connection
+	*
+	* Unlike its siblings (database, cache, herald), this connector does NOT
+	* early-return when `config.get("storage")` is absent. Storage is
+	* intentionally always-on: `storage.init()` falls back to the built-in
+	* `local` driver (see `storageConfig("default", "local")`), so file storage
+	* works out of the box even when a project ships no `src/config/storage.ts`.
+	* A config-presence guard here would break that default local storage.
 	*/
 	async start() {
 		await loadS3();

package/esm/connectors/storage.connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/storage.connector.ts"],"sourcesContent":["import { storage } from \"../storage\";\r\nimport { loadS3 } from \"../storage/drivers/cloud-driver\";\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 StorageConnector extends BaseConnector {\r\n  public readonly name = \"storage\";\r\n  public readonly priority = ConnectorPriority.STORAGE;\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/storage.ts\", \"src/config/storage.tsx\"];\r\n\r\n  /**\r\n   * Initialize cache connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    await loadS3();\r\n    await storage.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    storage.reset();\r\n\r\n    this.active = false;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AASA,IAAa,mBAAb,cAAsC,cAAc;;;cAC3B;;;sBAOW,CAAC,yBAAyB,wBAAwB;;;;;CAKpF,MAAa,QAAuB;EAClC,MAAM,OAAO;EACb,MAAM,QAAQ,KAAK;EAEnB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,QAAQ,MAAM;EAEd,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"storage.connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/storage.connector.ts"],"sourcesContent":["import { storage } from \"../storage\";\nimport { loadS3 } from \"../storage/drivers/cloud-driver\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class StorageConnector extends BaseConnector {\n  public readonly name = \"storage\";\n  public readonly priority = ConnectorPriority.STORAGE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/storage.ts\", \"src/config/storage.tsx\"];\n\n  /**\n   * Initialize cache connection\n   *\n   * Unlike its siblings (database, cache, herald), this connector does NOT\n   * early-return when `config.get(\"storage\")` is absent. Storage is\n   * intentionally always-on: `storage.init()` falls back to the built-in\n   * `local` driver (see `storageConfig(\"default\", \"local\")`), so file storage\n   * works out of the box even when a project ships no `src/config/storage.ts`.\n   * A config-presence guard here would break that default local storage.\n   */\n  public async start(): Promise<void> {\n    await loadS3();\n    await storage.init();\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    storage.reset();\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;AASA,IAAa,mBAAb,cAAsC,cAAc;;;cAC3B;;;sBAOW,CAAC,yBAAyB,wBAAwB;;;;;;;;;;;;CAYpF,MAAa,QAAuB;EAClC,MAAM,OAAO;EACb,MAAM,QAAQ,KAAK;EAEnB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,QAAQ,MAAM;EAEd,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/types.d.mts

@@ -49,7 +49,7 @@ interface Connector {
    */
   shouldRestart(changedFiles: string[]): boolean;
 }
-type ConnectorName = "logger" | "mailer" | "http" | "database" | "cache" | "storage" | "communicator" | "socket" | "notifications" | "access" | (string & {});
+type ConnectorName = "logger" | "mailer" | "http" | "database" | "cache" | "storage" | "herald" | "socket" | "notifications" | "access" | "ai" | (string & {});
 /**
  * When a connector boots relative to user code (main, routes, events).
  *
@@ -76,7 +76,8 @@ declare enum ConnectorPriority {
   STORAGE = 6,
   SOCKET = 7,
   NOTIFICATIONS = 8,
-  ACCESS = 9
+  ACCESS = 9,
+  AI = 10
 }
 //#endregion
 export { Connector, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority };

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/types.ts"],"mappings":";;AAIA;;;UAAiB,SAAA;EAgBU;;;EAAA,SAZhB,IAAA,EAAM,aAAA;EAyCH;;;;EAAA,SAnCH,QAAA;EAAA;;;;EAAA,SAMA,cAAA,EAAgB,uBAAA;EAWV;;;EANf,QAAA;EAkBW;;;;EAZX,IAAA,WAAe,OAAA;EAyBqB;AAAA;AAGtC;;EAtBE,KAAA,IAAS,OAAA;EAsBc;AAAA;AAsBzB;;EAtCE,OAAA,IAAW,OAAA;EAuCX;AACI;AAMN;;EAxCE,QAAA,IAAY,OAAA;EAwCe;;;;;EAjC3B,aAAA,CAAc,YAAA;AAAA;AAAA,KAGJ,aAAA;;;;;AAwCJ;;;;;aAlBI,uBAAA;EACV,KAAA;EACA,IAAI;AAAA;;;;aAMM,iBAAA;EACV,MAAA;EACA,MAAA;EACA,QAAA;EACA,YAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;EACA,aAAA;EACA,MAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/types.ts"],"mappings":";;AAIA;;;UAAiB,SAAA;EAgBU;;;EAAA,SAZhB,IAAA,EAAM,aAAA;EAyCH;;;;EAAA,SAnCH,QAAA;EAAA;;;;EAAA,SAMA,cAAA,EAAgB,uBAAA;EAWV;;;EANf,QAAA;EAkBW;;;;EAZX,IAAA,WAAe,OAAA;EAyBqB;AAAA;AAGtC;;EAtBE,KAAA,IAAS,OAAA;EAsBc;AAAA;AAuBzB;;EAvCE,OAAA,IAAW,OAAA;EAwCX;AACI;AAMN;;EAzCE,QAAA,IAAY,OAAA;EAyCe;;;;;EAlC3B,aAAA,CAAc,YAAA;AAAA;AAAA,KAGJ,aAAA;;;;;;AA0CR;;;;aAnBQ,uBAAA;EACV,KAAA;EACA,IAAI;AAAA;;;;aAMM,iBAAA;EACV,MAAA;EACA,MAAA;EACA,QAAA;EACA,YAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;EACA,aAAA;EACA,MAAA;EACA,EAAA;AAAA"}

package/esm/connectors/types.mjs

@@ -27,6 +27,7 @@ let ConnectorPriority = /* @__PURE__ */ function(ConnectorPriority) {
 	ConnectorPriority[ConnectorPriority["SOCKET"] = 7] = "SOCKET";
 	ConnectorPriority[ConnectorPriority["NOTIFICATIONS"] = 8] = "NOTIFICATIONS";
 	ConnectorPriority[ConnectorPriority["ACCESS"] = 9] = "ACCESS";
+	ConnectorPriority[ConnectorPriority["AI"] = 10] = "AI";
 	return ConnectorPriority;
 }({});
 

package/esm/connectors/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/types.ts"],"sourcesContent":["/**\r\n * Connector Interface\r\n * All service connectors (Database, HTTP, Cache, etc.) must implement this interface\r\n */\r\nexport interface Connector {\r\n  /**\r\n   * Unique name of the connector\r\n   */\r\n  readonly name: ConnectorName;\r\n\r\n  /**\r\n   * Priority for initialization order\r\n   * Lower numbers initialize first (e.g., Database: 1, HTTP: 3)\r\n   */\r\n  readonly priority: number;\r\n\r\n  /**\r\n   * Phase the connector boots in, relative to user code.\r\n   * See `ConnectorLifecyclePhase` for semantics.\r\n   */\r\n  readonly lifecyclePhase: ConnectorLifecyclePhase;\r\n\r\n  /**\r\n   * Whether the connector is currently active/connected\r\n   */\r\n  isActive(): boolean;\r\n\r\n  /**\r\n   * Boot the connector\r\n   * Called during server startup before starting the connector\r\n   */\r\n  boot(): void | Promise<void>;\r\n\r\n  /**\r\n   * Initialize the connector\r\n   * Called during server startup\r\n   */\r\n  start(): Promise<void>;\r\n\r\n  /**\r\n   * Restart the connector\r\n   * Called when watched files change\r\n   */\r\n  restart(): Promise<void>;\r\n\r\n  /**\r\n   * Gracefully shutdown the connector\r\n   * Called during server shutdown\r\n   */\r\n  shutdown(): Promise<void>;\r\n\r\n  /**\r\n   * Determine if this connector needs restart based on changed files\r\n   * @param changedFiles Array of relative file paths that changed\r\n   * @returns true if connector should restart\r\n   */\r\n  shouldRestart(changedFiles: string[]): boolean;\r\n}\r\n\r\nexport type ConnectorName =\r\n  | \"logger\"\r\n  | \"mailer\"\r\n  | \"http\"\r\n  | \"database\"\r\n  | \"cache\"\r\n  | \"storage\"\r\n  | \"communicator\"\r\n  | \"socket\"\r\n  | \"notifications\"\r\n  | \"access\"\r\n  | (string & {});\r\n\r\n/**\r\n * When a connector boots relative to user code (main, routes, events).\r\n *\r\n * - `Early`: before user code is imported. For services user code\r\n *   needs at import time (database, cache, logger, storage, mailer).\r\n * - `Late`: after user code is imported. For services that bind to\r\n *   things user code registered (http scans the router; socket\r\n *   depends on http's instance).\r\n */\r\nexport enum ConnectorLifecyclePhase {\r\n  Early = \"early\",\r\n  Late = \"late\",\r\n}\r\n\r\n/**\r\n * Connector priority constants\r\n */\r\nexport enum ConnectorPriority {\r\n  LOGGER = 0,\r\n  MAILER = 1,\r\n  DATABASE = 2,\r\n  COMMUNICATOR = 3,\r\n  CACHE = 4,\r\n  HTTP = 5,\r\n  STORAGE = 6,\r\n  SOCKET = 7,\r\n  NOTIFICATIONS = 8,\r\n  ACCESS = 9,\r\n}\r\n"],"mappings":";;;;;;;;;;AAiFA,IAAY,0BAAL;CACL;CACA;;AACF;;;;AAKA,IAAY,oBAAL;CACL;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AACF"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/types.ts"],"sourcesContent":["/**\n * Connector Interface\n * All service connectors (Database, HTTP, Cache, etc.) must implement this interface\n */\nexport interface Connector {\n  /**\n   * Unique name of the connector\n   */\n  readonly name: ConnectorName;\n\n  /**\n   * Priority for initialization order\n   * Lower numbers initialize first (e.g., Database: 1, HTTP: 3)\n   */\n  readonly priority: number;\n\n  /**\n   * Phase the connector boots in, relative to user code.\n   * See `ConnectorLifecyclePhase` for semantics.\n   */\n  readonly lifecyclePhase: ConnectorLifecyclePhase;\n\n  /**\n   * Whether the connector is currently active/connected\n   */\n  isActive(): boolean;\n\n  /**\n   * Boot the connector\n   * Called during server startup before starting the connector\n   */\n  boot(): void | Promise<void>;\n\n  /**\n   * Initialize the connector\n   * Called during server startup\n   */\n  start(): Promise<void>;\n\n  /**\n   * Restart the connector\n   * Called when watched files change\n   */\n  restart(): Promise<void>;\n\n  /**\n   * Gracefully shutdown the connector\n   * Called during server shutdown\n   */\n  shutdown(): Promise<void>;\n\n  /**\n   * Determine if this connector needs restart based on changed files\n   * @param changedFiles Array of relative file paths that changed\n   * @returns true if connector should restart\n   */\n  shouldRestart(changedFiles: string[]): boolean;\n}\n\nexport type ConnectorName =\n  | \"logger\"\n  | \"mailer\"\n  | \"http\"\n  | \"database\"\n  | \"cache\"\n  | \"storage\"\n  | \"herald\"\n  | \"socket\"\n  | \"notifications\"\n  | \"access\"\n  | \"ai\"\n  | (string & {});\n\n/**\n * When a connector boots relative to user code (main, routes, events).\n *\n * - `Early`: before user code is imported. For services user code\n *   needs at import time (database, cache, logger, storage, mailer).\n * - `Late`: after user code is imported. For services that bind to\n *   things user code registered (http scans the router; socket\n *   depends on http's instance).\n */\nexport enum ConnectorLifecyclePhase {\n  Early = \"early\",\n  Late = \"late\",\n}\n\n/**\n * Connector priority constants\n */\nexport enum ConnectorPriority {\n  LOGGER = 0,\n  MAILER = 1,\n  DATABASE = 2,\n  COMMUNICATOR = 3,\n  CACHE = 4,\n  HTTP = 5,\n  STORAGE = 6,\n  SOCKET = 7,\n  NOTIFICATIONS = 8,\n  ACCESS = 9,\n  AI = 10,\n}\n"],"mappings":";;;;;;;;;;AAkFA,IAAY,0BAAL;CACL;CACA;;AACF;;;;AAKA,IAAY,oBAAL;CACL;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AACF"}

package/esm/dev-server/development-server.mjs

@@ -1,3 +1,5 @@
+import { Application } from "../application/application.mjs";
+import "../application/index.mjs";
 import { ConnectorLifecyclePhase } from "../connectors/types.mjs";
 import { devLogReady, devLogSection, devLogWarn, devServeLog } from "./dev-logger.mjs";
 import { connectorsManager } from "../connectors/connectors-manager.mjs";
@@ -9,7 +11,7 @@ import { LayerExecutor } from "./layer-executor.mjs";
 import { typeGenerator } from "./type-generator.mjs";
 import { colors } from "@mongez/copper";
 import events from "@mongez/events";
-import { fileExistsAsync, getFileAsync, unlinkAsync } from "@warlock.js/fs";
+import { fileExistsAsync, unlinkAsync } from "@warlock.js/fs";
 
 //#region ../@warlock.js/core/src/dev-server/development-server.ts
 /**
@@ -42,6 +44,11 @@ var DevelopmentServer = class {
 			this.running = true;
 			const duration = performance.now() - startedAt;
 			devLogReady(`Development Server is ready in ${colors.greenBright(parseDuration(duration))}`);
+			Application.markBooted({
+				environment: Application.environment,
+				runtimeStrategy: Application.runtimeStrategy,
+				bootDurationMs: duration
+			});
 			const devServerConfig = await warlockConfigManager.get("devServer");
 			const generateTypings = this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;
 			const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;
@@ -67,9 +74,8 @@ var DevelopmentServer = class {
 	async handleBatchComplete(batch) {
 		if (!this.running || !this.layerExecutor) return;
 		if (batch.changed.includes("warlock.config.ts")) devLogWarn("warlock.config.ts changed — restart the dev server to apply.");
-		if (batch.changed.length > 0) batch.changed = await dropNoOpChanges(batch.changed);
 		if (batch.added.length + batch.changed.length + batch.deleted.length === 0) return;
-		const codeFiles = [...batch.added, ...batch.changed].filter((p) => !isEnvPath(p));
+		const codeFiles = [...batch.added, ...batch.changed].filter((p) => !isEnvPath(p) && p !== "warlock.config.ts");
 		try {
 			await this.layerExecutor.executeBatchReload(codeFiles, filesOrchestrator.getFiles(), batch.deleted, batch.changed);
 			typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed]);
@@ -89,17 +95,6 @@ var DevelopmentServer = class {
 		return this.running;
 	}
 };
-async function dropNoOpChanges(changedPaths) {
-	return (await Promise.all(changedPaths.map(async (relativePath) => {
-		if (isEnvPath(relativePath)) return relativePath;
-		const file = filesOrchestrator.files.get(relativePath);
-		if (!file) return null;
-		const content = await getFileAsync(file.absolutePath);
-		if (content.trim() === file.source) return null;
-		file.source = content;
-		return relativePath;
-	}))).filter((p) => p !== null);
-}
 function isEnvPath(path) {
 	const basename = path.split("/").pop() ?? path;
 	return basename === ".env" || basename.startsWith(".env.");