@warlock.js/core 5.31.0 → 5.33.0

package/esm/connectors/http-connector.mjs

@@ -16,7 +16,7 @@ import { BaseConnector } from "./base-connector.mjs";
 import { ensureFatalIsVisible } from "../logger/fatal-visibility.mjs";
 import { describeServerAddress } from "./describe-server-address.mjs";
 import { readBoundPort } from "./read-bound-port.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { log } from "@warlock.js/logger";
 import { colors } from "@mongez/copper";
 
@@ -72,14 +72,15 @@ 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"));
+		const baseUrl = baseConfig.get("app.baseUrl");
+		setBaseUrl(baseUrl);
 		this.registerHealthRoutes();
 	}
 	/**
@@ -91,7 +92,7 @@ var HttpConnector = class extends BaseConnector {
 	*/
 	registerHealthRoutes() {
 		if (!this.http) return;
-		const healthConfig = config.get("http.health");
+		const healthConfig = baseConfig.get("http.health");
 		if (healthConfig?.enabled === false) return;
 		const livenessPath = healthConfig?.path ?? "/health";
 		const readinessPath = healthConfig?.readinessPath ?? "/ready";
@@ -111,7 +112,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 (!servesHttp()) {
 			log.info("http", "connection", `http: not started (role: ${[...getRoles()].join(", ")})`);
@@ -133,7 +134,7 @@ var HttpConnector = class extends BaseConnector {
 			});
 			const boundPort = readBoundPort(boundAddress, configuredPort);
 			Application.setServedPort(boundPort);
-			const address = describeServerAddress(boundAddress, config.get("app.baseUrl"), httpConfig.host || "localhost");
+			const address = describeServerAddress(boundAddress, baseConfig.get("app.baseUrl"), httpConfig.host || "localhost");
 			setHttpReadyReport({
 				boundAddress: address.boundAddress,
 				url: address.url,
@@ -173,7 +174,7 @@ var HttpConnector = class extends BaseConnector {
 		if (!this.active) return;
 		const server = getHttpServer();
 		if (server) {
-			const timeout = config.get("http.gracefulShutdown.timeout", DEFAULT_SHUTDOWN_TIMEOUT);
+			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":["../../../../../../../../packages/core/src/connectors/http-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport { Application, getRoles, servesHttp } from \"../application\";\nimport { health } from \"../http/health\";\nimport { assertPortIsAvailable } from \"../http/port-preflight\";\nimport { registerHttpPlugins } from \"../http/plugins\";\nimport { notifyHttpServerRebuilt } from \"../http/server-rebuilt\";\nimport { setHttpReadyReport } from \"../http/ready-report\";\nimport { isCanonicalPortValue, resolveBindPort } from \"../http/resolve-bind-port\";\nimport {\n  closeServerWithTimeout,\n  type FastifyInstance,\n  getHttpServer,\n  startHttpServer,\n} from \"../http/server\";\nimport { ensureFatalIsVisible } from \"../logger/fatal-visibility\";\nimport { router } from \"../router/router\";\nimport { type Environment } from \"../utils\";\nimport { setBaseUrl } from \"../utils/urls\";\nimport { container } from \"./../container\";\nimport { BaseConnector } from \"./base-connector\";\nimport { describeServerAddress } from \"./describe-server-address\";\nimport { readBoundPort } from \"./read-bound-port\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\nfunction environmentColor(environment: Environment) {\n  switch (environment) {\n    case \"development\":\n      return colors.magentaBright(environment);\n    case \"test\":\n      return colors.yellowBright(environment);\n    case \"production\":\n      return colors.greenBright(environment);\n    default:\n      return colors.white(environment);\n  }\n}\n\n/**\n * Default time to wait for in-flight requests to drain on shutdown before the\n * HTTP server is force-closed. Override via `http.gracefulShutdown.timeout`.\n */\nconst DEFAULT_SHUTDOWN_TIMEOUT = 10_000;\n\n/**\n * HTTP Connector\n * Manages HTTP server (Fastify) lifecycle\n */\nexport class HttpConnector extends BaseConnector {\n  public readonly name = \"http\";\n  public readonly priority = ConnectorPriority.HTTP;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\n\n  /**\n   * Files that trigger HTTP 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/http.ts\", \"src/config/http.tsx\"];\n\n  /**\n   * Fastify Server instance\n   */\n  protected http?: FastifyInstance;\n\n  /**\n   * Whether someone downstream will render the combined ready block.\n   *\n   * Only the dev server does (`dev-server/ready-block.ts`), and only it can:\n   * the block reports facts — boot duration, the web surface — that this\n   * connector does not own and must not wait for. When it will, this connector\n   * records and stays quiet; otherwise it narrates as it always has.\n   *\n   * Keyed on the runtime strategy rather than on `NODE_ENV`, because that is\n   * what actually distinguishes \"a dev server is driving this boot\" from \"an\n   * app happens to be running with development config\".\n   *\n   * `!isBooted` is the second half and it is not a detail. The block summarises\n   * a BOOT. A `restart()` after boot — an edited `src/config/http.ts` — is an\n   * EVENT, and there is no block coming to carry it, so suppressing the lines\n   * there would rebind the port in total silence.\n   */\n  protected get rendersReadyBlock(): boolean {\n    return Application.runtimeStrategy === \"development\" && !Application.isBooted;\n  }\n\n  /**\n   * Boot the connector — construction only (create Fastify, register\n   * plugins, populate container). Route scanning is deferred to\n   * `start()` so it reads the router after app code has registered.\n   */\n  public async boot() {\n    const httpConfig = config.get(\"http\");\n\n    if (!httpConfig) return;\n\n    const port = httpConfig.port;\n    log.info(\n      `http`,\n      \"connection\",\n      `Starting http server on port ${port} in ${environmentColor(Application.environment)} mode`,\n    );\n\n    this.http = startHttpServer(httpConfig.serverOptions);\n\n    container.set(\"http.server\", this.http);\n\n    await registerHttpPlugins(this.http);\n\n    const baseUrl = config.get(\"app.baseUrl\");\n\n    // update base url\n    setBaseUrl(baseUrl);\n\n    // Liveness/readiness endpoints — registered on Fastify before start() scans\n    // the app router, so they exist by the time the server listens.\n    this.registerHealthRoutes();\n  }\n\n  /**\n   * Register the built-in liveness (`/health`) and readiness (`/ready`)\n   * endpoints directly on the Fastify instance — infra routes, kept off the app\n   * router so they're immune to HMR and never collide with route scanning. Opt\n   * out via `http.health.enabled = false`; rename via `http.health.path` /\n   * `http.health.readinessPath`.\n   */\n  private registerHealthRoutes(): void {\n    if (!this.http) {\n      return;\n    }\n\n    const healthConfig = config.get(\"http.health\");\n\n    if (healthConfig?.enabled === false) {\n      return;\n    }\n\n    const livenessPath = healthConfig?.path ?? \"/health\";\n    const readinessPath = healthConfig?.readinessPath ?? \"/ready\";\n\n    // Infrastructure probes must stay reachable after client quotas are spent.\n    // Opting in inherits the configured global policy and its shared bucket.\n    const routeOptions = {\n      config: { rateLimit: healthConfig?.rateLimit === true ? undefined : false },\n    };\n\n    this.http.get(livenessPath, routeOptions, async (_request: any, reply: any) => {\n      const result = health.liveness();\n\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\n    });\n\n    this.http.get(readinessPath, routeOptions, async (_request: any, reply: any) => {\n      const result = await health.readiness();\n\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\n    });\n  }\n\n  /**\n   * Initialize HTTP server — bind app-registered routes to Fastify\n   * then listen. Scanning here (not in `boot`) lets HTTP boot before\n   * app code without losing routes.\n   */\n  public async start(): Promise<void> {\n    const httpConfig = config.get(\"http\");\n\n    if (!httpConfig || !this.http) return;\n\n    // Neither `api` nor `web` is active — an http-only listener would serve\n    // nothing this process is meant to answer, so it never binds. `worker`\n    // is the only role that reaches here today; named generically so a\n    // future role composition still reads correctly.\n    if (!servesHttp()) {\n      log.info(\"http\", \"connection\", `http: not started (role: ${[...getRoles()].join(\", \")})`);\n\n      return;\n    }\n\n    // Read once. `Application.isBooted` flips during the same boot this method\n    // belongs to, and a predicate that answered differently before and after\n    // `listen()` would print half a report.\n    const deferToReadyBlock = this.rendersReadyBlock;\n\n    if (Application.runtimeStrategy === \"development\") {\n      router.scanDevServer(this.http);\n    } else {\n      router.scan(this.http);\n    }\n\n    // Surface the route table as a readiness signal + a boot log, so an empty\n    // or partial route surface (e.g. a route module that failed to register) is\n    // detectable instead of silently 404ing. `addRoutesRegisteredCheck` is\n    // keyed by name, so re-running on restart is idempotent.\n    health.addRoutesRegisteredCheck(() => router.routeCount());\n\n    const routeCount = router.routeCount();\n\n    // In development this fact is one line of the single ready block rendered\n    // after boot completes (`dev-server/ready-block.ts`); printing it here as\n    // well would put the same number on screen twice, in two formats. Outside\n    // development the line is load-bearing — a supervisor or CI log greps it —\n    // so it stays exactly as it was.\n    if (!deferToReadyBlock) {\n      log.info(\"http\", \"routes\", `${routeCount} route(s) registered`);\n    }\n\n    // Resolved ONCE, here, at the top of the bind sequence: `httpConfig.port`\n    // may still be a string that round-tripped `env()`'s number coercion\n    // (`\"03999\"`, `\" 3999\"`, `\"1e3\"`) — `net.Server.listen({ port })` binds\n    // all of those without complaint, silently, sometimes to the WRONG port\n    // (`\"1e3\"` -> 1000). Every downstream use of the port — the preflight\n    // probe and `listen()` itself — must agree on the same resolved number.\n    //\n    // This is still the port ASKED for, not the port BOUND — `port: 0` asks\n    // for \"any free port\" and this stays `0` for that case. What gets\n    // published to `warlock:ready` is read back from `listen()`'s resolved\n    // address further down, never this value.\n    const configuredPort = resolveBindPort(httpConfig.port);\n\n    if (!isCanonicalPortValue(httpConfig.port, configuredPort)) {\n      log.info(\n        \"http\",\n        \"connection\",\n        `Configured http.port ${JSON.stringify(httpConfig.port)} normalised to ${configuredPort}.`,\n      );\n    }\n\n    try {\n      // Preflight the bind before `listen()` so a collision surfaces as the\n      // instruction in `PortInUseError.message` (which names the port) instead\n      // of a raw `EADDRINUSE` from deep inside Fastify/libuv.\n      //\n      // Port 0 is exempt: it asks the OS for a free port, so probing it binds\n      // some unrelated ephemeral port and \"passes\" while proving nothing about\n      // the port this server will actually take.\n      if (configuredPort !== 0) {\n        await assertPortIsAvailable(configuredPort, httpConfig.host || \"localhost\");\n      }\n\n      // `listen()` RESOLVES with the address it actually bound — which is the\n      // only address worth announcing. See `describe-server-address.ts` for why\n      // announcing `app.baseUrl` here instead was a defect rather than a\n      // shortcut.\n      const boundAddress = await this.http.listen({\n        port: configuredPort,\n        host: httpConfig.host || \"localhost\",\n      });\n\n      // Read the ACTUALLY-bound port back out of what `listen()` resolved,\n      // rather than republishing `configuredPort`. With `http.port: 0` the OS\n      // picks the port, so `configuredPort` stays `0` forever — publishing it\n      // instead of the real port is exactly the \"Server ready at a URL that\n      // gives connection refused\" defect `describe-server-address.ts` already\n      // fixed for the display string. `boundAddress` always carries an\n      // explicit port (Fastify never omits one), so `configuredPort` is only\n      // a defensive fallback for an address this parse cannot make sense of.\n      const boundPort = readBoundPort(boundAddress, configuredPort);\n\n      Application.setServedPort(boundPort);\n\n      const address = describeServerAddress(\n        boundAddress,\n        config.get(\"app.baseUrl\"),\n        // Passed because `listen()` does not report it back: Fastify resolves a\n        // `0.0.0.0` bind to `http://127.0.0.1:<port>`, so the wildcard is only\n        // recoverable from what we ASKED for.\n        httpConfig.host || \"localhost\",\n      );\n\n      // Recorded unconditionally: the ready block reads it in development, and\n      // in every other mode it is simply the one place that knows what was\n      // bound, which is worth having whether or not anything renders it.\n      setHttpReadyReport({\n        boundAddress: address.boundAddress,\n        url: address.url,\n        wildcardBind: address.wildcardBind,\n        port: boundPort,\n        routeCount,\n        publicUrl: address.publicUrl,\n      });\n\n      if (!deferToReadyBlock) {\n        log.success(`http`, \"connection\", address.ready);\n\n        if (address.publicUrl) {\n          log.info(`http`, \"connection\", address.publicUrl);\n        }\n      }\n\n      // NEVER conditional on the block. A base URL pointing at a port nothing\n      // is listening on is the single most misleading state this connector can\n      // be in, and a warning a status block swallows is a warning nobody reads\n      // — so it is logged where it lands ABOVE the block, in both modes.\n      if (address.warning) {\n        log.warn(`http`, \"connection\", address.warning);\n      }\n    } catch (error) {\n      // A failed listen()/port-bind at boot means the app can't serve — fatal.\n      // `log.fatal` reaches Sentry/file; `await log.flush()` drains buffered and\n      // async channels before the process exits.\n      await log.fatal(\"http\", \"connection\", error);\n\n      // …and `log.fatal` reaches NOBODY when the app's log config declares no\n      // terminal channel — the ordinary production shape (`production: {\n      // channels: [new FileLog()] }`), and the shape of every app with no `log`\n      // config at all, since `LoggerConnector.start()` then returns before\n      // `log.configure`. That is how an `EADDRINUSE` at boot became a process\n      // that exited 1 in total silence: the error was constructed, thrown and\n      // caught exactly as designed, and then written to zero channels. stderr\n      // is the one destination that is always there.\n      ensureFatalIsVisible(error);\n\n      await log.flush();\n\n      process.exit(1); // stop the process, exit with error\n    }\n\n    this.active = true;\n  }\n\n  /**\n   * Restart — needs a fresh Fastify instance since `start()` now\n   * re-runs `router.scan()`, and re-scanning the same Fastify would\n   * register duplicate route handlers.\n   */\n  public async restart(): Promise<void> {\n    await this.shutdown();\n    await this.boot();\n\n    // Subscribers (the web connector's Vite middleware) re-attach to the new\n    // instance here: after it exists, before `start()` listens.\n    if (this.http) notifyHttpServerRebuilt(this.http);\n\n    await this.start();\n  }\n\n  /**\n   * Shutdown HTTP server\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const server = getHttpServer();\n\n    if (server) {\n      const timeout = config.get(\"http.gracefulShutdown.timeout\", DEFAULT_SHUTDOWN_TIMEOUT);\n      const drained = await closeServerWithTimeout(server, timeout);\n\n      if (!drained) {\n        log.warn(\n          \"http\",\n          \"shutdown\",\n          `In-flight requests did not drain within ${timeout}ms; closing anyway`,\n        );\n      }\n    }\n\n    this.active = false;\n  }\n\n  /**\n   * Override shouldRestart to handle routes.ts specially\n   * routes.ts changes should NOT restart the server (use HMR instead)\n   * Now receives config file paths directly from layer-executor\n   */\n  public shouldRestart(changedFiles: string[]): boolean {\n    // Only restart for config changes, not routes\n    return changedFiles.some((file) => {\n      const relativePath = file.replace(/\\\\/g, \"/\");\n      return this.watchedFiles.includes(relativePath);\n    });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"http-connector.mjs","names":["config"],"sources":["../../../../../../../../packages/core/src/connectors/http-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport { Application, getRoles, servesHttp } from \"../application\";\nimport { health } from \"../http/health\";\nimport { assertPortIsAvailable } from \"../http/port-preflight\";\nimport { registerHttpPlugins } from \"../http/plugins\";\nimport { notifyHttpServerRebuilt } from \"../http/server-rebuilt\";\nimport { setHttpReadyReport } from \"../http/ready-report\";\nimport { isCanonicalPortValue, resolveBindPort } from \"../http/resolve-bind-port\";\nimport {\n  closeServerWithTimeout,\n  type FastifyInstance,\n  getHttpServer,\n  startHttpServer,\n} from \"../http/server\";\nimport { ensureFatalIsVisible } from \"../logger/fatal-visibility\";\nimport { router } from \"../router/router\";\nimport { type Environment } from \"../utils\";\nimport { setBaseUrl } from \"../utils/urls\";\nimport { container } from \"./../container\";\nimport { BaseConnector } from \"./base-connector\";\nimport { describeServerAddress } from \"./describe-server-address\";\nimport { readBoundPort } from \"./read-bound-port\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\nfunction environmentColor(environment: Environment) {\n  switch (environment) {\n    case \"development\":\n      return colors.magentaBright(environment);\n    case \"test\":\n      return colors.yellowBright(environment);\n    case \"production\":\n      return colors.greenBright(environment);\n    default:\n      return colors.white(environment);\n  }\n}\n\n/**\n * Default time to wait for in-flight requests to drain on shutdown before the\n * HTTP server is force-closed. Override via `http.gracefulShutdown.timeout`.\n */\nconst DEFAULT_SHUTDOWN_TIMEOUT = 10_000;\n\n/**\n * HTTP Connector\n * Manages HTTP server (Fastify) lifecycle\n */\nexport class HttpConnector extends BaseConnector {\n  public readonly name = \"http\";\n  public readonly priority = ConnectorPriority.HTTP;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\n\n  /**\n   * Files that trigger HTTP 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/http.ts\", \"src/config/http.tsx\"];\n\n  /**\n   * Fastify Server instance\n   */\n  protected http?: FastifyInstance;\n\n  /**\n   * Whether someone downstream will render the combined ready block.\n   *\n   * Only the dev server does (`dev-server/ready-block.ts`), and only it can:\n   * the block reports facts — boot duration, the web surface — that this\n   * connector does not own and must not wait for. When it will, this connector\n   * records and stays quiet; otherwise it narrates as it always has.\n   *\n   * Keyed on the runtime strategy rather than on `NODE_ENV`, because that is\n   * what actually distinguishes \"a dev server is driving this boot\" from \"an\n   * app happens to be running with development config\".\n   *\n   * `!isBooted` is the second half and it is not a detail. The block summarises\n   * a BOOT. A `restart()` after boot — an edited `src/config/http.ts` — is an\n   * EVENT, and there is no block coming to carry it, so suppressing the lines\n   * there would rebind the port in total silence.\n   */\n  protected get rendersReadyBlock(): boolean {\n    return Application.runtimeStrategy === \"development\" && !Application.isBooted;\n  }\n\n  /**\n   * Boot the connector — construction only (create Fastify, register\n   * plugins, populate container). Route scanning is deferred to\n   * `start()` so it reads the router after app code has registered.\n   */\n  public async boot() {\n    const httpConfig = config.get(\"http\");\n\n    if (!httpConfig) return;\n\n    const port = httpConfig.port;\n    log.info(\n      `http`,\n      \"connection\",\n      `Starting http server on port ${port} in ${environmentColor(Application.environment)} mode`,\n    );\n\n    this.http = startHttpServer(httpConfig.serverOptions);\n\n    container.set(\"http.server\", this.http);\n\n    await registerHttpPlugins(this.http);\n\n    const baseUrl = config.get(\"app.baseUrl\");\n\n    // update base url\n    setBaseUrl(baseUrl);\n\n    // Liveness/readiness endpoints — registered on Fastify before start() scans\n    // the app router, so they exist by the time the server listens.\n    this.registerHealthRoutes();\n  }\n\n  /**\n   * Register the built-in liveness (`/health`) and readiness (`/ready`)\n   * endpoints directly on the Fastify instance — infra routes, kept off the app\n   * router so they're immune to HMR and never collide with route scanning. Opt\n   * out via `http.health.enabled = false`; rename via `http.health.path` /\n   * `http.health.readinessPath`.\n   */\n  private registerHealthRoutes(): void {\n    if (!this.http) {\n      return;\n    }\n\n    const healthConfig = config.get(\"http.health\");\n\n    if (healthConfig?.enabled === false) {\n      return;\n    }\n\n    const livenessPath = healthConfig?.path ?? \"/health\";\n    const readinessPath = healthConfig?.readinessPath ?? \"/ready\";\n\n    // Infrastructure probes must stay reachable after client quotas are spent.\n    // Opting in inherits the configured global policy and its shared bucket.\n    const routeOptions = {\n      config: { rateLimit: healthConfig?.rateLimit === true ? undefined : false },\n    };\n\n    this.http.get(livenessPath, routeOptions, async (_request: any, reply: any) => {\n      const result = health.liveness();\n\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\n    });\n\n    this.http.get(readinessPath, routeOptions, async (_request: any, reply: any) => {\n      const result = await health.readiness();\n\n      return reply.code(result.status === \"ok\" ? 200 : 503).send(result);\n    });\n  }\n\n  /**\n   * Initialize HTTP server — bind app-registered routes to Fastify\n   * then listen. Scanning here (not in `boot`) lets HTTP boot before\n   * app code without losing routes.\n   */\n  public async start(): Promise<void> {\n    const httpConfig = config.get(\"http\");\n\n    if (!httpConfig || !this.http) return;\n\n    // Neither `api` nor `web` is active — an http-only listener would serve\n    // nothing this process is meant to answer, so it never binds. `worker`\n    // is the only role that reaches here today; named generically so a\n    // future role composition still reads correctly.\n    if (!servesHttp()) {\n      log.info(\"http\", \"connection\", `http: not started (role: ${[...getRoles()].join(\", \")})`);\n\n      return;\n    }\n\n    // Read once. `Application.isBooted` flips during the same boot this method\n    // belongs to, and a predicate that answered differently before and after\n    // `listen()` would print half a report.\n    const deferToReadyBlock = this.rendersReadyBlock;\n\n    if (Application.runtimeStrategy === \"development\") {\n      router.scanDevServer(this.http);\n    } else {\n      router.scan(this.http);\n    }\n\n    // Surface the route table as a readiness signal + a boot log, so an empty\n    // or partial route surface (e.g. a route module that failed to register) is\n    // detectable instead of silently 404ing. `addRoutesRegisteredCheck` is\n    // keyed by name, so re-running on restart is idempotent.\n    health.addRoutesRegisteredCheck(() => router.routeCount());\n\n    const routeCount = router.routeCount();\n\n    // In development this fact is one line of the single ready block rendered\n    // after boot completes (`dev-server/ready-block.ts`); printing it here as\n    // well would put the same number on screen twice, in two formats. Outside\n    // development the line is load-bearing — a supervisor or CI log greps it —\n    // so it stays exactly as it was.\n    if (!deferToReadyBlock) {\n      log.info(\"http\", \"routes\", `${routeCount} route(s) registered`);\n    }\n\n    // Resolved ONCE, here, at the top of the bind sequence: `httpConfig.port`\n    // may still be a string that round-tripped `env()`'s number coercion\n    // (`\"03999\"`, `\" 3999\"`, `\"1e3\"`) — `net.Server.listen({ port })` binds\n    // all of those without complaint, silently, sometimes to the WRONG port\n    // (`\"1e3\"` -> 1000). Every downstream use of the port — the preflight\n    // probe and `listen()` itself — must agree on the same resolved number.\n    //\n    // This is still the port ASKED for, not the port BOUND — `port: 0` asks\n    // for \"any free port\" and this stays `0` for that case. What gets\n    // published to `warlock:ready` is read back from `listen()`'s resolved\n    // address further down, never this value.\n    const configuredPort = resolveBindPort(httpConfig.port);\n\n    if (!isCanonicalPortValue(httpConfig.port, configuredPort)) {\n      log.info(\n        \"http\",\n        \"connection\",\n        `Configured http.port ${JSON.stringify(httpConfig.port)} normalised to ${configuredPort}.`,\n      );\n    }\n\n    try {\n      // Preflight the bind before `listen()` so a collision surfaces as the\n      // instruction in `PortInUseError.message` (which names the port) instead\n      // of a raw `EADDRINUSE` from deep inside Fastify/libuv.\n      //\n      // Port 0 is exempt: it asks the OS for a free port, so probing it binds\n      // some unrelated ephemeral port and \"passes\" while proving nothing about\n      // the port this server will actually take.\n      if (configuredPort !== 0) {\n        await assertPortIsAvailable(configuredPort, httpConfig.host || \"localhost\");\n      }\n\n      // `listen()` RESOLVES with the address it actually bound — which is the\n      // only address worth announcing. See `describe-server-address.ts` for why\n      // announcing `app.baseUrl` here instead was a defect rather than a\n      // shortcut.\n      const boundAddress = await this.http.listen({\n        port: configuredPort,\n        host: httpConfig.host || \"localhost\",\n      });\n\n      // Read the ACTUALLY-bound port back out of what `listen()` resolved,\n      // rather than republishing `configuredPort`. With `http.port: 0` the OS\n      // picks the port, so `configuredPort` stays `0` forever — publishing it\n      // instead of the real port is exactly the \"Server ready at a URL that\n      // gives connection refused\" defect `describe-server-address.ts` already\n      // fixed for the display string. `boundAddress` always carries an\n      // explicit port (Fastify never omits one), so `configuredPort` is only\n      // a defensive fallback for an address this parse cannot make sense of.\n      const boundPort = readBoundPort(boundAddress, configuredPort);\n\n      Application.setServedPort(boundPort);\n\n      const address = describeServerAddress(\n        boundAddress,\n        config.get(\"app.baseUrl\"),\n        // Passed because `listen()` does not report it back: Fastify resolves a\n        // `0.0.0.0` bind to `http://127.0.0.1:<port>`, so the wildcard is only\n        // recoverable from what we ASKED for.\n        httpConfig.host || \"localhost\",\n      );\n\n      // Recorded unconditionally: the ready block reads it in development, and\n      // in every other mode it is simply the one place that knows what was\n      // bound, which is worth having whether or not anything renders it.\n      setHttpReadyReport({\n        boundAddress: address.boundAddress,\n        url: address.url,\n        wildcardBind: address.wildcardBind,\n        port: boundPort,\n        routeCount,\n        publicUrl: address.publicUrl,\n      });\n\n      if (!deferToReadyBlock) {\n        log.success(`http`, \"connection\", address.ready);\n\n        if (address.publicUrl) {\n          log.info(`http`, \"connection\", address.publicUrl);\n        }\n      }\n\n      // NEVER conditional on the block. A base URL pointing at a port nothing\n      // is listening on is the single most misleading state this connector can\n      // be in, and a warning a status block swallows is a warning nobody reads\n      // — so it is logged where it lands ABOVE the block, in both modes.\n      if (address.warning) {\n        log.warn(`http`, \"connection\", address.warning);\n      }\n    } catch (error) {\n      // A failed listen()/port-bind at boot means the app can't serve — fatal.\n      // `log.fatal` reaches Sentry/file; `await log.flush()` drains buffered and\n      // async channels before the process exits.\n      await log.fatal(\"http\", \"connection\", error);\n\n      // …and `log.fatal` reaches NOBODY when the app's log config declares no\n      // terminal channel — the ordinary production shape (`production: {\n      // channels: [new FileLog()] }`), and the shape of every app with no `log`\n      // config at all, since `LoggerConnector.start()` then returns before\n      // `log.configure`. That is how an `EADDRINUSE` at boot became a process\n      // that exited 1 in total silence: the error was constructed, thrown and\n      // caught exactly as designed, and then written to zero channels. stderr\n      // is the one destination that is always there.\n      ensureFatalIsVisible(error);\n\n      await log.flush();\n\n      process.exit(1); // stop the process, exit with error\n    }\n\n    this.active = true;\n  }\n\n  /**\n   * Restart — needs a fresh Fastify instance since `start()` now\n   * re-runs `router.scan()`, and re-scanning the same Fastify would\n   * register duplicate route handlers.\n   */\n  public async restart(): Promise<void> {\n    await this.shutdown();\n    await this.boot();\n\n    // Subscribers (the web connector's Vite middleware) re-attach to the new\n    // instance here: after it exists, before `start()` listens.\n    if (this.http) notifyHttpServerRebuilt(this.http);\n\n    await this.start();\n  }\n\n  /**\n   * Shutdown HTTP server\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const server = getHttpServer();\n\n    if (server) {\n      const timeout = config.get(\"http.gracefulShutdown.timeout\", DEFAULT_SHUTDOWN_TIMEOUT);\n      const drained = await closeServerWithTimeout(server, timeout);\n\n      if (!drained) {\n        log.warn(\n          \"http\",\n          \"shutdown\",\n          `In-flight requests did not drain within ${timeout}ms; closing anyway`,\n        );\n      }\n    }\n\n    this.active = false;\n  }\n\n  /**\n   * Override shouldRestart to handle routes.ts specially\n   * routes.ts changes should NOT restart the server (use HMR instead)\n   * Now receives config file paths directly from layer-executor\n   */\n  public shouldRestart(changedFiles: string[]): boolean {\n    // Only restart for config changes, not routes\n    return changedFiles.some((file) => {\n      const relativePath = file.replace(/\\\\/g, \"/\");\n      return this.watchedFiles.includes(relativePath);\n    });\n  }\n}\n"],"mappings":"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"}

package/esm/connectors/index.d.mts

@@ -14,4 +14,5 @@ import { MailerConnector } from "./mail-connector.mjs";
 import { NotificationsConnector } from "./notifications-connector.mjs";
 import { RegisterConfiguredConnectorsOptions, registerConfiguredConnectors } from "./register-configured-connectors.mjs";
 import { SocketConnector } from "./socket-connector.mjs";
-import { StorageConnector } from "./storage.connector.mjs";
+import { StorageConnector } from "./storage.connector.mjs";
+export { AccessConnector, AiConnector, BaseConnector, CacheConnector, Connector, ConnectorBuildContext, ConnectorBuildContribution, ConnectorBuildGenerateResult, ConnectorEsbuildPatch, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority, ConnectorsManager, DatabaseConnector, HeraldConnector, HttpConnector, LoggerConnector, MailerConnector, NotificationsConnector, RegisterConfiguredConnectorsOptions, SocketConnector, StorageConnector, assertNoReservedConnectorNames, assertUniqueConnectorNames, connectorsManager, registerConfiguredConnectors };

package/esm/connectors/index.mjs

@@ -16,4 +16,4 @@ import { assertNoReservedConnectorNames } from "./assert-no-reserved-connector-n
 import { assertUniqueConnectorNames } from "./assert-unique-connector-names.mjs";
 import { registerConfiguredConnectors } from "./register-configured-connectors.mjs";
 
-export {  };
+export { AccessConnector, AiConnector, BaseConnector, CacheConnector, ConnectorLifecyclePhase, ConnectorPriority, ConnectorsManager, DatabaseConnector, HeraldConnector, HttpConnector, LoggerConnector, MailerConnector, NotificationsConnector, SocketConnector, StorageConnector, assertNoReservedConnectorNames, assertUniqueConnectorNames, connectorsManager, registerConfiguredConnectors };

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

@@ -1,12 +1,11 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-
 //#region ../../packages/core/src/connectors/logger-connector.d.ts
 /**
  * Logger Connector
  * Manages logger lifecycle and ensures synchronous flushing on termination
  */
-declare class LoggerConnector extends BaseConnector {
+export declare class LoggerConnector extends BaseConnector {
   readonly name = "logger";
   readonly priority = ConnectorPriority.LOGGER;
   readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
@@ -24,5 +23,4 @@ declare class LoggerConnector extends BaseConnector {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { LoggerConnector };
 //# sourceMappingURL=logger-connector.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/logger-connector.ts"],"mappings":";;;;;;AAUA;;cAAa,eAAA,SAAwB,aAAA;EAAA,SACnB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,MAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EA6BL;;;EAAA,mBAxBN,YAAA;EARgB;;;EAatB,KAAA,IAAS,OAAA;EAXE;;;EA8BX,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"logger-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/logger-connector.ts"],"mappings":";;;;;;;qBAUa,wBAAwB;WACnB;WACA,WAAQ,kBAAA;WACR,iBAAc,wBAAA;;;;qBAKX;;;;EAKN,SAAS;;;;EAmBT,YAAY"}

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 ../../packages/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":["../../../../../../../../packages/core/src/connectors/logger-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { setLogConfigurations } from \"../logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Logger Connector\n * Manages logger lifecycle and ensures synchronous flushing on termination\n */\nexport class LoggerConnector extends BaseConnector {\n  public readonly name = \"logger\";\n  public readonly priority = ConnectorPriority.LOGGER;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger logger restart\n   */\n  protected readonly watchedFiles = [\"src/config/log.ts\", \"src/config/log.tsx\"];\n\n  /**\n   * Initialize logger configurations\n   */\n  public async start(): Promise<void> {\n    const logConfig = config.get(\"log\");\n\n    if (!logConfig) {\n      return;\n    }\n\n    try {\n      setLogConfigurations(logConfig);\n      this.active = true;\n    } catch (error) {\n      console.error(\"Failed to initialize logger:\", error);\n      throw error;\n    }\n  }\n\n  /**\n   * Shutdown logger and flush messages synchronously\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    try {\n      log.flushSync();\n      this.active = false;\n    } catch (error) {\n      console.error(\"Failed to flush logger:\", error);\n      throw error;\n    }\n  }\n}\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":["../../../../../../../../packages/core/src/connectors/logger-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { setLogConfigurations } from \"../logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Logger Connector\n * Manages logger lifecycle and ensures synchronous flushing on termination\n */\nexport class LoggerConnector extends BaseConnector {\n  public readonly name = \"logger\";\n  public readonly priority = ConnectorPriority.LOGGER;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger logger restart\n   */\n  protected readonly watchedFiles = [\"src/config/log.ts\", \"src/config/log.tsx\"];\n\n  /**\n   * Initialize logger configurations\n   */\n  public async start(): Promise<void> {\n    const logConfig = config.get(\"log\");\n\n    if (!logConfig) {\n      return;\n    }\n\n    try {\n      setLogConfigurations(logConfig);\n      this.active = true;\n    } catch (error) {\n      console.error(\"Failed to initialize logger:\", error);\n      throw error;\n    }\n  }\n\n  /**\n   * Shutdown logger and flush messages synchronously\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    try {\n      log.flushSync();\n      this.active = false;\n    } catch (error) {\n      console.error(\"Failed to flush logger:\", error);\n      throw error;\n    }\n  }\n}\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.d.mts

@@ -1,12 +1,11 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-
 //#region ../../packages/core/src/connectors/mail-connector.d.ts
 /**
  * Mailer Connector
  * Manages mailer lifecycle and ensures graceful pool shutdown
  */
-declare class MailerConnector extends BaseConnector {
+export declare class MailerConnector extends BaseConnector {
   readonly name = "mailer";
   readonly priority = ConnectorPriority.MAILER;
   readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
@@ -24,5 +23,4 @@ declare class MailerConnector extends BaseConnector {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { MailerConnector };
 //# sourceMappingURL=mail-connector.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mail-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/mail-connector.ts"],"mappings":";;;;;;AASA;;cAAa,eAAA,SAAwB,aAAA;EAAA,SACnB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,MAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EA6BL;;;EAAA,mBAxBN,YAAA;EARgB;;;EAatB,KAAA,IAAS,OAAA;EAXE;;;EA8BX,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"mail-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/mail-connector.ts"],"mappings":";;;;;;;qBASa,wBAAwB;WACnB;WACA,WAAQ,kBAAA;WACR,iBAAc,wBAAA;;;;qBAKX;;;;EAKN,SAAS;;;;EAmBT,YAAY"}

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 ../../packages/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":["../../../../../../../../packages/core/src/connectors/mail-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { closeAllMailers, setMailConfigurations } from \"../mail\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Mailer Connector\n * Manages mailer lifecycle and ensures graceful pool shutdown\n */\nexport class MailerConnector extends BaseConnector {\n  public readonly name = \"mailer\";\n  public readonly priority = ConnectorPriority.MAILER;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger mailer restart\n   */\n  protected readonly watchedFiles = [\".env\", \"src/config/mail.ts\", \"src/config/mail.tsx\"];\n\n  /**\n   * Initialize mailer configurations\n   */\n  public async start(): Promise<void> {\n    const mailConfig = config.get(\"mail\");\n\n    if (!mailConfig) {\n      return;\n    }\n\n    try {\n      setMailConfigurations(mailConfig);\n      this.active = true;\n    } catch (error) {\n      console.error(\"Failed to initialize mailer:\", error);\n      throw error;\n    }\n  }\n\n  /**\n   * Shutdown mailer pool\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    try {\n      closeAllMailers();\n      this.active = false;\n    } catch (error) {\n      console.error(\"Failed to close all mailers:\", error);\n      throw error;\n    }\n  }\n}\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":["../../../../../../../../packages/core/src/connectors/mail-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { closeAllMailers, setMailConfigurations } from \"../mail\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Mailer Connector\n * Manages mailer lifecycle and ensures graceful pool shutdown\n */\nexport class MailerConnector extends BaseConnector {\n  public readonly name = \"mailer\";\n  public readonly priority = ConnectorPriority.MAILER;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger mailer restart\n   */\n  protected readonly watchedFiles = [\".env\", \"src/config/mail.ts\", \"src/config/mail.tsx\"];\n\n  /**\n   * Initialize mailer configurations\n   */\n  public async start(): Promise<void> {\n    const mailConfig = config.get(\"mail\");\n\n    if (!mailConfig) {\n      return;\n    }\n\n    try {\n      setMailConfigurations(mailConfig);\n      this.active = true;\n    } catch (error) {\n      console.error(\"Failed to initialize mailer:\", error);\n      throw error;\n    }\n  }\n\n  /**\n   * Shutdown mailer pool\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    try {\n      closeAllMailers();\n      this.active = false;\n    } catch (error) {\n      console.error(\"Failed to close all mailers:\", error);\n      throw error;\n    }\n  }\n}\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.d.mts

@@ -1,6 +1,5 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-
 //#region ../../packages/core/src/connectors/notifications-connector.d.ts
 /**
  * Notifications Connector
@@ -14,7 +13,7 @@ import { BaseConnector } from "./base-connector.mjs";
  * so core carries no hard dependency on it — the same pattern as the herald
  * connector with `@warlock.js/herald`.
  */
-declare class NotificationsConnector extends BaseConnector {
+export declare class NotificationsConnector extends BaseConnector {
   readonly name = "notifications";
   readonly priority = ConnectorPriority.NOTIFICATIONS;
   readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
@@ -34,5 +33,4 @@ declare class NotificationsConnector extends BaseConnector {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { NotificationsConnector };
 //# sourceMappingURL=notifications-connector.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"notifications-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/notifications-connector.ts"],"mappings":";;;;;;AAiBA;;;;;;;;;;cAAa,sBAAA,SAA+B,aAAA;EAAA,SAC1B,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,aAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EADN;;;EAAA,mBAML,YAAA;EAAA;;;EAKN,KAAA,IAAS,OAAA;EAoBG;;AAAO;;;EAAnB,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"notifications-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/notifications-connector.ts"],"mappings":";;;;;;;;;;;;;;;qBAiBa,+BAA+B;WAC1B;WACA,WAAQ,kBAAA;WACR,iBAAc,wBAAA;;;;qBAKX;;;;EAKN,SAAS;;;;;;EAoBT,YAAY"}

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 ../../packages/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":["../../../../../../../../packages/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":["../../../../../../../../packages/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/register-configured-connectors.d.mts

@@ -1,14 +1,12 @@
 import { Connector } from "./types.mjs";
-
 //#region ../../packages/core/src/connectors/register-configured-connectors.d.ts
-type RegisterConfiguredConnectorsOptions = {
+export type RegisterConfiguredConnectorsOptions = {
   /**
    * The connector names, in order, that the build resolved. The generated
    * production entry bakes this in; every other caller omits it.
    */
   expectedNames?: string[];
 };
-declare function registerConfiguredConnectors(connectors?: Connector[], options?: RegisterConfiguredConnectorsOptions): void;
+export declare function registerConfiguredConnectors(connectors?: Connector[], options?: RegisterConfiguredConnectorsOptions): void;
 //#endregion
-export { RegisterConfiguredConnectorsOptions, registerConfiguredConnectors };
 //# sourceMappingURL=register-configured-connectors.d.mts.map

package/esm/connectors/register-configured-connectors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"register-configured-connectors.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/register-configured-connectors.ts"],"mappings":";;;KAwCY,mCAAA;;AAAZ;;;EAKE,aAAa;AAAA;AAAA,iBAGC,4BAAA,CACd,UAAA,GAAa,SAAA,IACb,OAAA,GAAS,mCAAwC"}
+{"version":3,"file":"register-configured-connectors.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/register-configured-connectors.ts"],"mappings":";;YAwCY;;;;;EAKV;;wBAGc,6BACd,aAAa,aACb,UAAS"}

package/esm/connectors/shutdown-timeout.mjs

@@ -0,0 +1,7 @@
+//#region ../../packages/core/src/connectors/shutdown-timeout.ts
+/** Overall connector shutdown budget; overridden by `app.shutdownTimeout`. */
+const DEFAULT_SHUTDOWN_TIMEOUT = 1e4;
+
+//#endregion
+export { DEFAULT_SHUTDOWN_TIMEOUT };
+//# sourceMappingURL=shutdown-timeout.mjs.map

package/esm/connectors/shutdown-timeout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-timeout.mjs","names":[],"sources":["../../../../../../../../packages/core/src/connectors/shutdown-timeout.ts"],"sourcesContent":["/** Overall connector shutdown budget; overridden by `app.shutdownTimeout`. */\nexport const DEFAULT_SHUTDOWN_TIMEOUT = 10_000;\n"],"mappings":";;AACA,MAAa,2BAA2B"}

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

@@ -1,13 +1,12 @@
 import { ConnectorLifecyclePhase, ConnectorName, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 import { Server } from "socket.io";
-
 //#region ../../packages/core/src/connectors/socket-connector.d.ts
 /**
  * Socket Connector
  * Manages Socket server (Socket.IO) lifecycle
  */
-declare class SocketConnector extends BaseConnector {
+export declare class SocketConnector extends BaseConnector {
   readonly name: ConnectorName;
   readonly priority = ConnectorPriority.SOCKET;
   readonly lifecyclePhase = ConnectorLifecyclePhase.Late;
@@ -76,5 +75,4 @@ declare class SocketConnector extends BaseConnector {
   private restoreListeners;
 }
 //#endregion
-export { SocketConnector };
 //# sourceMappingURL=socket-connector.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"socket-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/socket-connector.ts"],"mappings":";;;;;;;AAkCA;;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;EAnBM;;;EAAA,UAwBN,YAAA;EAfA;;;;;;EAAA,UAuBA,iBAAA;IACR,KAAA,EAAO,KAAA,cAAmB,IAAA;IAC1B,OAAA,EAAS,KAAA,cAAmB,IAAA;EAAA;EAAA;;;EAMjB,IAAA,IAAI,OAAA;EA2EK;;;EAAT,KAAA,IAAS,OAAA;EA+BG;;;;EAfZ,OAAA,IAAW,OAAA;EA6EA;;;;;;;;;EA9DX,QAAA,IAAY,OAAA;;;;UA8BjB,iBAAA;EAAA,QAUA,aAAA;;;;;UAsBA,gBAAA;AAAA"}
+{"version":3,"file":"socket-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/socket-connector.ts"],"mappings":";;;;;;;;qBAkCa,wBAAwB;WACnB,MAAM;WACN,WAAQ,kBAAA;WACR,iBAAc,wBAAA;;;;;;qBAOX;YAET,SAAS;;;;;;;;;YAUT;;;;YAKA;;;;;;;YAQA;IACR,OAAO,mBAAmB;IAC1B,SAAS,mBAAmB;;;;;EAMjB,QAAI;;;;EAqFJ,SAAS;;;;;EAgBT,WAAW;;;;;;;;;;EAeX,YAAY;;;;UA8BjB;UAUA;;;;;UAsBA"}

package/esm/connectors/socket-connector.mjs

@@ -2,7 +2,7 @@ import { environment } from "../utils/environment.mjs";
 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";
@@ -46,7 +46,7 @@ var SocketConnector = class extends BaseConnector {
 	* Boot the connector
 	*/
 	async boot() {
-		const socketConfig = config.get("socket");
+		const socketConfig = baseConfig.get("socket");
 		if (!socketConfig) return;
 		let SocketServer;
 		try {
@@ -68,7 +68,14 @@ var SocketConnector = class extends BaseConnector {
 			server.on("error", (error) => {
 				log.error("socket", "connection", error, { port: socketConfig.port });
 			});
-			server.listen(socketConfig.port);
+			await new Promise((resolve, reject) => {
+				const onBindError = (error) => reject(error);
+				server.once("error", onBindError);
+				server.listen(socketConfig.port, () => {
+					server.removeListener("error", onBindError);
+					resolve();
+				});
+			});
 			this.ownsRawServer = true;
 		}
 		container.set("socket.rawServer", server);
@@ -89,7 +96,7 @@ 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;
 	}
@@ -114,13 +121,15 @@ var SocketConnector = class extends BaseConnector {
 	async shutdown() {
 		if (!this.active) return;
 		const socket = container.tryGet("socket");
-		if (socket) if (this.ownsRawServer) await new Promise((resolve) => {
-			socket.close(() => resolve());
-		});
-		else {
-			socket.of("/").disconnectSockets(true);
-			socket.engine.close();
-			this.restoreListeners();
+		if (socket) {
+			if (this.ownsRawServer) await new Promise((resolve) => {
+				socket.close(() => resolve());
+			});
+			else {
+				socket.of("/").disconnectSockets(true);
+				socket.engine.close();
+				this.restoreListeners();
+			}
 		}
 		this.active = false;
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"socket-connector.mjs","names":["createHttpsServer","createHttpServer"],"sources":["../../../../../../../../packages/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 { environment } from \"../utils/environment\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, type 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\nconst SINGLE_SERVER_WARNING =\n  \"socket: no adapter configured — broadcasts only reach clients connected to this server. Use @socket.io/redis-adapter (socket.adapter) behind a load balancer, with sticky sessions for the polling transport.\";\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   * The shared server socket.io attached to, kept for the detach.\n   */\n  protected sharedServer?: any;\n\n  /**\n   * Listener changes socket.io/engine.io made on the shared server at attach:\n   * the listeners they added, and the ones they removed (engine.io lifts the\n   * existing `request` listeners into its own wrapper). Undone on detach so\n   * repeated dev restarts don't stack engines on Fastify's server.\n   */\n  protected attachedListeners: {\n    added: Array<[string, (...args: any[]) => void]>;\n    removed: Array<[string, (...args: any[]) => void]>;\n  } = { added: [], removed: [] };\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    const fastify = container.tryGet(\"http.server\");\n    if (fastify) {\n      server = fastify.server;\n      this.ownsRawServer = false;\n    } else {\n      server = socketConfig.ssl\n        ? createHttpsServer({ key: socketConfig.ssl.key, cert: socketConfig.ssl.cert })\n        : createHttpServer();\n      // Without a handler, EADDRINUSE is an unhandled 'error' event that crashes\n      // the process with no context.\n      server.on(\"error\", (error: Error) => {\n        log.error(\"socket\", \"connection\", error, { port: socketConfig.port });\n      });\n      server.listen(socketConfig.port);\n      this.ownsRawServer = true;\n    }\n\n    container.set(\"socket.rawServer\", server);\n\n    const before = this.snapshotListeners(server);\n\n    this.socket = new SocketServer(server, {\n      // The shared raw server may carry OTHER `upgrade` consumers — Vite's HMR\n      // websocket does exactly that when `WebConnector` is registered\n      // (`web/src/server/web-connector.ts`, `server.hmr.server = fastify.server`).\n      // engine.io's default `destroyUpgrade: true` schedules a destroy for every\n      // upgrade whose path is not `/socket.io`\n      // (`engine.io/build/server.js:676-695`: `setTimeout(… socket.end(), 1000)`),\n      // and the only thing saving a foreign websocket today is that it wrote its\n      // handshake bytes synchronously and so trips the `bytesWritten <= 0` guard\n      // before the 1s timer fires. That is an undocumented race, not a contract.\n      // Turning the destroy off removes the coupling outright and makes the\n      // shared server safe for any app-owned websocket route.\n      // A project can still override it via `socket.options`.\n      destroyUpgrade: false,\n      ...socketConfig.options,\n    });\n\n    if (!this.ownsRawServer) {\n      this.sharedServer = server;\n      this.attachedListeners = this.diffListeners(before, this.snapshotListeners(server));\n    }\n\n    if (socketConfig.adapter) {\n      this.socket.adapter((await socketConfig.adapter(this.socket)) as never);\n    } else if (environment() === \"production\" && !socketConfig.silenceSingleServerWarning) {\n      log.warn(\"socket\", \"adapter\", SINGLE_SERVER_WARNING);\n    }\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   * Restart re-boots too: the closed `io` must be replaced and the new\n   * `socket` config read, otherwise a config edit in dev restarts nothing.\n   */\n  public async restart(): Promise<void> {\n    await this.shutdown();\n    await this.boot();\n    await this.start();\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    const socket = container.tryGet(\"socket\");\n    if (socket) {\n      if (this.ownsRawServer) {\n        // We own the raw server: `io.close()` closes it too, so it is the only\n        // close needed (a second `rawServer.close()` always rejects with\n        // ERR_SERVER_NOT_RUNNING).\n        await new Promise<void>((resolve) => {\n          socket.close(() => resolve());\n        });\n      } else {\n        // Shared mode: `io.close()` calls `httpServer.close()`, which would close\n        // Fastify's server from here and bypass its graceful drain. Detach\n        // instead: disconnect the clients and close the engine only.\n        socket.of(\"/\").disconnectSockets(true);\n        socket.engine.close();\n        this.restoreListeners();\n      }\n    }\n\n    this.active = false;\n  }\n\n  /**\n   * Current listeners of the events socket.io touches on a node server.\n   */\n  private snapshotListeners(server: any): Map<string, Array<(...args: any[]) => void>> {\n    const snapshot = new Map<string, Array<(...args: any[]) => void>>();\n\n    for (const event of [\"request\", \"upgrade\", \"close\", \"listening\"]) {\n      snapshot.set(event, server?.listeners?.(event)?.slice() ?? []);\n    }\n\n    return snapshot;\n  }\n\n  private diffListeners(\n    before: Map<string, Array<(...args: any[]) => void>>,\n    after: Map<string, Array<(...args: any[]) => void>>,\n  ) {\n    const added: Array<[string, (...args: any[]) => void]> = [];\n    const removed: Array<[string, (...args: any[]) => void]> = [];\n\n    for (const [event, listeners] of before) {\n      const now = after.get(event) ?? [];\n\n      for (const listener of now) if (!listeners.includes(listener)) added.push([event, listener]);\n      for (const listener of listeners)\n        if (!now.includes(listener)) removed.push([event, listener]);\n    }\n\n    return { added, removed };\n  }\n\n  /**\n   * Undo what attaching did to the shared server, leaving listeners other\n   * consumers added since (e.g. Vite's HMR upgrade handler) untouched.\n   */\n  private restoreListeners(): void {\n    const server = this.sharedServer;\n\n    if (!server) return;\n\n    const { added, removed } = this.attachedListeners;\n\n    for (const [event, listener] of added) server.removeListener(event, listener);\n    for (const [event, listener] of removed) server.on(event, listener);\n\n    this.attachedListeners = { added: [], removed: [] };\n    this.sharedServer = undefined;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"socket-connector.mjs","names":["config","createHttpsServer","createHttpServer"],"sources":["../../../../../../../../packages/core/src/connectors/socket-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { createServer as createHttpServer, type Server as HttpServer } from \"http\";\nimport { createServer as createHttpsServer } from \"https\";\nimport type { Server } from \"socket.io\";\nimport { container } from \"../container\";\nimport { environment } from \"../utils/environment\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, type 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\nconst SINGLE_SERVER_WARNING =\n  \"socket: no adapter configured — broadcasts only reach clients connected to this server. Use @socket.io/redis-adapter (socket.adapter) behind a load balancer, with sticky sessions for the polling transport.\";\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   * The shared server socket.io attached to, kept for the detach.\n   */\n  protected sharedServer?: any;\n\n  /**\n   * Listener changes socket.io/engine.io made on the shared server at attach:\n   * the listeners they added, and the ones they removed (engine.io lifts the\n   * existing `request` listeners into its own wrapper). Undone on detach so\n   * repeated dev restarts don't stack engines on Fastify's server.\n   */\n  protected attachedListeners: {\n    added: Array<[string, (...args: any[]) => void]>;\n    removed: Array<[string, (...args: any[]) => void]>;\n  } = { added: [], removed: [] };\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: HttpServer;\n    const fastify = container.tryGet(\"http.server\");\n    if (fastify) {\n      server = fastify.server;\n      this.ownsRawServer = false;\n    } else {\n      server = socketConfig.ssl\n        ? createHttpsServer({ key: socketConfig.ssl.key, cert: socketConfig.ssl.cert })\n        : createHttpServer();\n      // Without a handler, EADDRINUSE is an unhandled 'error' event that crashes\n      // the process with no context.\n      server.on(\"error\", (error: Error) => {\n        log.error(\"socket\", \"connection\", error, { port: socketConfig.port });\n      });\n      // Boot must await the socket-only listener too: Application.markBooted\n      // reports readiness to PM2 after the late phase resolves. Logging a bind\n      // error alone would otherwise still let the app announce readiness.\n      await new Promise<void>((resolve, reject) => {\n        const onBindError = (error: Error) => reject(error);\n        server.once(\"error\", onBindError);\n        server.listen(socketConfig.port, () => {\n          server.removeListener(\"error\", onBindError);\n          resolve();\n        });\n      });\n      this.ownsRawServer = true;\n    }\n\n    container.set(\"socket.rawServer\", server);\n\n    const before = this.snapshotListeners(server);\n\n    this.socket = new SocketServer(server, {\n      // The shared raw server may carry OTHER `upgrade` consumers — Vite's HMR\n      // websocket does exactly that when `WebConnector` is registered\n      // (`web/src/server/web-connector.ts`, `server.hmr.server = fastify.server`).\n      // engine.io's default `destroyUpgrade: true` schedules a destroy for every\n      // upgrade whose path is not `/socket.io`\n      // (`engine.io/build/server.js:676-695`: `setTimeout(… socket.end(), 1000)`),\n      // and the only thing saving a foreign websocket today is that it wrote its\n      // handshake bytes synchronously and so trips the `bytesWritten <= 0` guard\n      // before the 1s timer fires. That is an undocumented race, not a contract.\n      // Turning the destroy off removes the coupling outright and makes the\n      // shared server safe for any app-owned websocket route.\n      // A project can still override it via `socket.options`.\n      destroyUpgrade: false,\n      ...socketConfig.options,\n    });\n\n    if (!this.ownsRawServer) {\n      this.sharedServer = server;\n      this.attachedListeners = this.diffListeners(before, this.snapshotListeners(server));\n    }\n\n    if (socketConfig.adapter) {\n      this.socket.adapter((await socketConfig.adapter(this.socket)) as never);\n    } else if (environment() === \"production\" && !socketConfig.silenceSingleServerWarning) {\n      log.warn(\"socket\", \"adapter\", SINGLE_SERVER_WARNING);\n    }\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   * Restart re-boots too: the closed `io` must be replaced and the new\n   * `socket` config read, otherwise a config edit in dev restarts nothing.\n   */\n  public async restart(): Promise<void> {\n    await this.shutdown();\n    await this.boot();\n    await this.start();\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    const socket = container.tryGet(\"socket\");\n    if (socket) {\n      if (this.ownsRawServer) {\n        // We own the raw server: `io.close()` closes it too, so it is the only\n        // close needed (a second `rawServer.close()` always rejects with\n        // ERR_SERVER_NOT_RUNNING).\n        await new Promise<void>((resolve) => {\n          socket.close(() => resolve());\n        });\n      } else {\n        // Shared mode: `io.close()` calls `httpServer.close()`, which would close\n        // Fastify's server from here and bypass its graceful drain. Detach\n        // instead: disconnect the clients and close the engine only.\n        socket.of(\"/\").disconnectSockets(true);\n        socket.engine.close();\n        this.restoreListeners();\n      }\n    }\n\n    this.active = false;\n  }\n\n  /**\n   * Current listeners of the events socket.io touches on a node server.\n   */\n  private snapshotListeners(server: any): Map<string, Array<(...args: any[]) => void>> {\n    const snapshot = new Map<string, Array<(...args: any[]) => void>>();\n\n    for (const event of [\"request\", \"upgrade\", \"close\", \"listening\"]) {\n      snapshot.set(event, server?.listeners?.(event)?.slice() ?? []);\n    }\n\n    return snapshot;\n  }\n\n  private diffListeners(\n    before: Map<string, Array<(...args: any[]) => void>>,\n    after: Map<string, Array<(...args: any[]) => void>>,\n  ) {\n    const added: Array<[string, (...args: any[]) => void]> = [];\n    const removed: Array<[string, (...args: any[]) => void]> = [];\n\n    for (const [event, listeners] of before) {\n      const now = after.get(event) ?? [];\n\n      for (const listener of now) if (!listeners.includes(listener)) added.push([event, listener]);\n      for (const listener of listeners)\n        if (!now.includes(listener)) removed.push([event, listener]);\n    }\n\n    return { added, removed };\n  }\n\n  /**\n   * Undo what attaching did to the shared server, leaving listeners other\n   * consumers added since (e.g. Vite's HMR upgrade handler) untouched.\n   */\n  private restoreListeners(): void {\n    const server = this.sharedServer;\n\n    if (!server) return;\n\n    const { added, removed } = this.attachedListeners;\n\n    for (const [event, listener] of added) server.removeListener(event, listener);\n    for (const [event, listener] of removed) server.on(event, listener);\n\n    this.attachedListeners = { added: [], removed: [] };\n    this.sharedServer = undefined;\n  }\n}\n"],"mappings":"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"}

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

@@ -1,12 +1,11 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-
 //#region ../../packages/core/src/connectors/storage.connector.d.ts
 /**
  * Cache Connector
  * Manages cache engine connection lifecycle
  */
-declare class StorageConnector extends BaseConnector {
+export declare class StorageConnector extends BaseConnector {
   readonly name = "storage";
   readonly priority = ConnectorPriority.STORAGE;
   readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
@@ -37,5 +36,4 @@ declare class StorageConnector extends BaseConnector {
   shutdown(): Promise<void>;
 }
 //#endregion
-export { StorageConnector };
 //# sourceMappingURL=storage.connector.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage.connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/storage.connector.ts"],"mappings":";;;;;;AAaA;;cAAa,gBAAA,SAAyB,aAAA;EAAA,SACpB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,OAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAyCL;;;EAAA,mBApCN,YAAA;EARiB;;;;;;;;;;;;;;AA4CJ;;EAlBnB,KAAA,IAAS,OAAA;;;;EAkBT,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"storage.connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/storage.connector.ts"],"mappings":";;;;;;;qBAaa,yBAAyB;WACpB;WACA,WAAQ,kBAAA;WACR,iBAAc,wBAAA;;;;qBAKX;;;;;;;;;;;;;;;;;EAkBN,SAAS;;;;EAkBT,YAAY"}

package/esm/connectors/storage.connector.mjs

@@ -5,7 +5,7 @@ import "../storage/index.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 import { localStorageWarning } from "./single-server-warnings.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 import { log } from "@warlock.js/logger";
 
 //#region ../../packages/core/src/connectors/storage.connector.ts
@@ -40,7 +40,7 @@ var StorageConnector = class extends BaseConnector {
 	async start() {
 		await loadS3();
 		await storage.init();
-		const warning = localStorageWarning(config.get("storage.default", "local"), environment(), config.get("storage.silenceSingleServerWarning") === true);
+		const warning = localStorageWarning(baseConfig.get("storage.default", "local"), environment(), baseConfig.get("storage.silenceSingleServerWarning") === true);
 		if (warning) log.warn("storage", "single-server", warning);
 		this.active = true;
 	}