@warlock.js/core 5.30.0 → 5.31.0

package/esm/connectors/assert-unique-connector-names.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assert-unique-connector-names.mjs","names":[],"sources":["../../../../../../../../packages/core/src/connectors/assert-unique-connector-names.ts"],"sourcesContent":["/**\n * Refuses a `connectors` array that lists the same name more than once.\n *\n * A name is a connector's identity across both halves of its life, and the two\n * halves treat a repeat differently. The build works per ARRAY ENTRY: it drains\n * the build contribution of every element, so a name listed twice contributes\n * twice — files written twice, esbuild patches merged twice. The runtime works\n * per NAME: the first entry registers and every later one with that name is\n * skipped, because registering it again would boot and shut down the same\n * connector twice.\n *\n * So a duplicate is half-applied: built for twice, booted once, with nothing\n * reported either way. The name-set the drift check compares is identical on\n * both sides, so it passes the array straight through — this asymmetry is\n * invisible to it, which is why it is caught here instead.\n *\n * Called by both halves (the build before it drains, the registration before it\n * registers) so neither can be reached with an array the other would refuse.\n * It rejects duplicates WITHIN the array it is handed. A name held OUTSIDE the\n * array is out of scope here: if a BUILT-IN holds it, the reserved-name check\n * refuses it; if an EARLIER CALL configured it, the registration skip treats it\n * as idempotency on purpose — neither validator claims that case.\n */\nimport type { Connector } from \"./types\";\n\nexport function assertUniqueConnectorNames(connectors: Connector[]): void {\n  const seen = new Set<string>();\n  const duplicated = new Set<string>();\n\n  for (const connector of connectors) {\n    if (seen.has(connector.name)) {\n      duplicated.add(connector.name);\n      continue;\n    }\n\n    seen.add(connector.name);\n  }\n\n  if (duplicated.size === 0) return;\n\n  const names = [...duplicated].map((name) => JSON.stringify(name)).join(\", \");\n  const subject = duplicated.size === 1 ? \"name is\" : \"names are\";\n\n  throw new Error(\n    `The same connector ${subject} listed more than once in \\`connectors\\`: [${names}].\\n` +\n      \"Every connector in `warlock.config.ts > connectors` must have a unique name. \" +\n      \"The build prepares artifacts per ENTRY — it drains the build contribution of each one, so a repeated name contributes twice — \" +\n      \"while the runtime registers each NAME once and skips the rest. \" +\n      \"A duplicate is therefore half-applied, and neither half reports it. \" +\n      \"Remove the extra entry, or give the connectors distinct names.\",\n  );\n}\n"],"mappings":";AAyBA,SAAgB,2BAA2B,YAA+B;CACxE,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,6BAAa,IAAI,IAAY;CAEnC,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,KAAK,IAAI,UAAU,IAAI,GAAG;GAC5B,WAAW,IAAI,UAAU,IAAI;GAC7B;EACF;EAEA,KAAK,IAAI,UAAU,IAAI;CACzB;CAEA,IAAI,WAAW,SAAS,GAAG;CAE3B,MAAM,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,SAAS,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;CAC3E,MAAM,UAAU,WAAW,SAAS,IAAI,YAAY;CAEpD,MAAM,IAAI,MACR,sBAAsB,QAAQ,6CAA6C,MAAM,mZAMnF;AACF"}
+{"version":3,"file":"assert-unique-connector-names.mjs","names":[],"sources":["../../../../../../../../packages/core/src/connectors/assert-unique-connector-names.ts"],"sourcesContent":["/**\n * Refuses a `connectors` array that lists the same name more than once.\n *\n * A name is a connector's identity across both halves of its life, and the two\n * halves treat a repeat differently. The build works per ARRAY ENTRY: it drains\n * the build contribution of every element, so a name listed twice contributes\n * twice — files written twice, esbuild patches merged twice. The runtime works\n * per NAME: the first entry registers and every later one with that name is\n * skipped, because registering it again would boot and shut down the same\n * connector twice.\n *\n * So a duplicate is half-applied: built for twice, booted once, with nothing\n * reported either way. The name-set the drift check compares is identical on\n * both sides, so it passes the array straight through — this asymmetry is\n * invisible to it, which is why it is caught here instead.\n *\n * Called by both halves (the build before it drains, the registration before it\n * registers) so neither can be reached with an array the other would refuse.\n * It rejects duplicates WITHIN the array it is handed. A name held OUTSIDE the\n * array is out of scope here: if a BUILT-IN holds it, the reserved-name check\n * refuses it; if an EARLIER CALL configured it, the registration skip treats it\n * as idempotency on purpose — neither validator claims that case.\n */\nimport { WarlockError } from \"../errors/warlock-error\";\nimport type { Connector } from \"./types\";\n\nexport function assertUniqueConnectorNames(connectors: Connector[]): void {\n  const seen = new Set<string>();\n  const duplicated = new Set<string>();\n\n  for (const connector of connectors) {\n    if (seen.has(connector.name)) {\n      duplicated.add(connector.name);\n      continue;\n    }\n\n    seen.add(connector.name);\n  }\n\n  if (duplicated.size === 0) return;\n\n  const names = [...duplicated].map((name) => JSON.stringify(name)).join(\", \");\n  const subject = duplicated.size === 1 ? \"name is\" : \"names are\";\n\n  throw new WarlockError(\n    \"WL1009\",\n    `The same connector ${subject} listed more than once in \\`connectors\\`: [${names}].\\n` +\n      \"Every connector in `warlock.config.ts > connectors` must have a unique name. \" +\n      \"The build prepares artifacts per ENTRY — it drains the build contribution of each one, so a repeated name contributes twice — \" +\n      \"while the runtime registers each NAME once and skips the rest. \" +\n      \"A duplicate is therefore half-applied, and neither half reports it. \" +\n      \"Remove the extra entry, or give the connectors distinct names.\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,2BAA2B,YAA+B;CACxE,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,6BAAa,IAAI,IAAY;CAEnC,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,KAAK,IAAI,UAAU,IAAI,GAAG;GAC5B,WAAW,IAAI,UAAU,IAAI;GAC7B;EACF;EAEA,KAAK,IAAI,UAAU,IAAI;CACzB;CAEA,IAAI,WAAW,SAAS,GAAG;CAE3B,MAAM,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,SAAS,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;CAG3E,MAAM,IAAI,aACR,UACA,sBAJc,WAAW,SAAS,IAAI,YAAY,YAIpB,6CAA6C,MAAM,mZAMnF;AACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AAiDA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAwCb;;;;;EAAA,mBAjCE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;;;;;;;;;;;;;EAAA,cAgCV,iBAAA;EAwRP;;;AAAoC;;EA/Q9B,IAAA,IAAI,OAAA;;;;;;;;UAmCT,oBAAA;;;;;;EAgCK,KAAA,IAAS,OAAA;;;;;;EAkKT,OAAA,IAAW,OAAA;;;;EAcX,QAAA,IAAY,OAAA;;;;;;EA4BlB,aAAA,CAAc,YAAA;AAAA"}
+{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AAiDA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAwCb;;;;;EAAA,mBAjCE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;;;;;;;;;;;;;EAAA,cAgCV,iBAAA;EA8RP;;;AAAoC;;EArR9B,IAAA,IAAI,OAAA;;;;;;;;UAmCT,oBAAA;;;;;;EAsCK,KAAA,IAAS,OAAA;;;;;;EAkKT,OAAA,IAAW,OAAA;;;;EAcX,QAAA,IAAY,OAAA;;;;;;EA4BlB,aAAA,CAAc,YAAA;AAAA"}

package/esm/connectors/http-connector.mjs

@@ -95,11 +95,12 @@ var HttpConnector = class extends BaseConnector {
 		if (healthConfig?.enabled === false) return;
 		const livenessPath = healthConfig?.path ?? "/health";
 		const readinessPath = healthConfig?.readinessPath ?? "/ready";
-		this.http.get(livenessPath, async (_request, reply) => {
+		const routeOptions = { config: { rateLimit: healthConfig?.rateLimit === true ? void 0 : false } };
+		this.http.get(livenessPath, routeOptions, async (_request, reply) => {
 			const result = health.liveness();
 			return reply.code(result.status === "ok" ? 200 : 503).send(result);
 		});
-		this.http.get(readinessPath, async (_request, reply) => {
+		this.http.get(readinessPath, routeOptions, async (_request, reply) => {
 			const result = await health.readiness();
 			return reply.code(result.status === "ok" ? 200 : 503).send(result);
 		});

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    this.http.get(livenessPath, 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, 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":[],"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/single-server-warnings.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"single-server-warnings.mjs","names":[],"sources":["../../../../../../../../packages/core/src/connectors/single-server-warnings.ts"],"sourcesContent":["import type { Environment } from \"../utils/environment\";\n\nconst IN_PROCESS_CACHE_NAMES = [\"memory\", \"memoryextended\", \"lru\"];\nconst IN_PROCESS_CACHE_CLASSES = [\"memorycachedriver\", \"memoryextendedcachedriver\", \"lrumemorycachedriver\"];\n\n/**\n * Warning for a production app whose default cache driver keeps data in this\n * process only. Returns `undefined` when there is nothing to warn about.\n */\nexport function memoryCacheWarning(\n  defaultDriverName: string | undefined,\n  driverClassName: string | undefined,\n  env: Environment,\n  silenced = false,\n): string | undefined {\n  if (env !== \"production\" || silenced || !defaultDriverName) return undefined;\n\n  const byName = IN_PROCESS_CACHE_NAMES.includes(defaultDriverName.toLowerCase());\n  const byClass =\n    !!driverClassName && IN_PROCESS_CACHE_CLASSES.includes(driverClassName.toLowerCase());\n\n  if (!byName && !byClass) return undefined;\n\n  return (\n    `cache: the default driver '${defaultDriverName}' keeps data in this process only. ` +\n    \"With more than one server, repository cache clears, locks and counters don't reach the other servers. \" +\n    \"Use the redis or pg cache driver in production, or set cache.silenceSingleServerWarning = true.\"\n  );\n}\n\n/**\n * Warning for a production app whose default storage driver is the local disk.\n */\nexport function localStorageWarning(\n  defaultDriverName: string | undefined,\n  env: Environment,\n  silenced = false,\n): string | undefined {\n  if (env !== \"production\" || silenced || defaultDriverName !== \"local\") return undefined;\n\n  return (\n    \"storage: the default driver 'local' keeps files on this server's disk only. \" +\n    \"With more than one server, uploads written on one server are missing on the others. \" +\n    \"Use an S3 or R2 storage driver in production, or set storage.silenceSingleServerWarning = true.\"\n  );\n}\n"],"mappings":";AAEA,MAAM,yBAAyB;CAAC;CAAU;CAAkB;AAAK;AACjE,MAAM,2BAA2B;CAAC;CAAqB;CAA6B;AAAsB;;;;;AAM1G,SAAgB,mBACd,mBACA,iBACA,KACA,WAAW,OACS;CACpB,IAAI,QAAQ,gBAAgB,YAAY,CAAC,mBAAmB,OAAO;CAEnE,MAAM,SAAS,uBAAuB,SAAS,kBAAkB,YAAY,CAAC;CAC9E,MAAM,UACJ,CAAC,CAAC,mBAAmB,yBAAyB,SAAS,gBAAgB,YAAY,CAAC;CAEtF,IAAI,CAAC,UAAU,CAAC,SAAS,OAAO;CAEhC,OACE,8BAA8B,kBAAkB;AAIpD;;;;AAKA,SAAgB,oBACd,mBACA,KACA,WAAW,OACS;CACpB,IAAI,QAAQ,gBAAgB,YAAY,sBAAsB,SAAS,OAAO;CAE9E,OACE;AAIJ"}
+{"version":3,"file":"single-server-warnings.mjs","names":[],"sources":["../../../../../../../../packages/core/src/connectors/single-server-warnings.ts"],"sourcesContent":["import type { Environment } from \"../utils/environment\";\n\nconst IN_PROCESS_CACHE_NAMES = [\"memory\", \"memoryextended\", \"lru\"];\nconst IN_PROCESS_CACHE_CLASSES = [\n  \"memorycachedriver\",\n  \"memoryextendedcachedriver\",\n  \"lrumemorycachedriver\",\n];\n\n/**\n * Warning for a production app whose default cache driver keeps data in this\n * process only. Returns `undefined` when there is nothing to warn about.\n */\nexport function memoryCacheWarning(\n  defaultDriverName: string | undefined,\n  driverClassName: string | undefined,\n  env: Environment,\n  silenced = false,\n): string | undefined {\n  if (env !== \"production\" || silenced || !defaultDriverName) return undefined;\n\n  const byName = IN_PROCESS_CACHE_NAMES.includes(defaultDriverName.toLowerCase());\n  const byClass =\n    !!driverClassName && IN_PROCESS_CACHE_CLASSES.includes(driverClassName.toLowerCase());\n\n  if (!byName && !byClass) return undefined;\n\n  return (\n    `cache: the default driver '${defaultDriverName}' keeps data in this process only. ` +\n    \"With more than one server, repository cache clears, locks and counters don't reach the other servers. \" +\n    \"Use the redis or pg cache driver in production, or set cache.silenceSingleServerWarning = true.\"\n  );\n}\n\n/**\n * Warning for a production app whose default storage driver is the local disk.\n */\nexport function localStorageWarning(\n  defaultDriverName: string | undefined,\n  env: Environment,\n  silenced = false,\n): string | undefined {\n  if (env !== \"production\" || silenced || defaultDriverName !== \"local\") return undefined;\n\n  return (\n    \"storage: the default driver 'local' keeps files on this server's disk only. \" +\n    \"With more than one server, uploads written on one server are missing on the others. \" +\n    \"Use an S3 or R2 storage driver in production, or set storage.silenceSingleServerWarning = true.\"\n  );\n}\n"],"mappings":";AAEA,MAAM,yBAAyB;CAAC;CAAU;CAAkB;AAAK;AACjE,MAAM,2BAA2B;CAC/B;CACA;CACA;AACF;;;;;AAMA,SAAgB,mBACd,mBACA,iBACA,KACA,WAAW,OACS;CACpB,IAAI,QAAQ,gBAAgB,YAAY,CAAC,mBAAmB,OAAO;CAEnE,MAAM,SAAS,uBAAuB,SAAS,kBAAkB,YAAY,CAAC;CAC9E,MAAM,UACJ,CAAC,CAAC,mBAAmB,yBAAyB,SAAS,gBAAgB,YAAY,CAAC;CAEtF,IAAI,CAAC,UAAU,CAAC,SAAS,OAAO;CAEhC,OACE,8BAA8B,kBAAkB;AAIpD;;;;AAKA,SAAgB,oBACd,mBACA,KACA,WAAW,OACS;CACpB,IAAI,QAAQ,gBAAgB,YAAY,sBAAsB,SAAS,OAAO;CAE9E,OACE;AAIJ"}

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;EA4EA;;;;;;;;;EA7DX,QAAA,IAAY,OAAA;;;;UA8BjB,iBAAA;EAAA,QAUA,aAAA;;;;;UAqBA,gBAAA;AAAA"}
+{"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"}

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) 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":["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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"}

package/esm/container/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/index.ts"],"mappings":";;;;;;;;;AA6BA;;KAAY,cAAA;EACV,MAAA,EAAQ,MAAA;EACR,aAAA,EAAe,eAAA;EACf,cAAA;EACA,MAAA,EAAQ,MAAA;EACR,iBAAA,EAAmB,UAAA;EACnB,0BAAA,EAA4B,uBAAA;EAC5B,wBAAA,EAA0B,qBAAA;AAAA;AAAA,KAGvB,aAAA,SAAsB,cAAc;AAAA,cAEnC,SAAA;EAVJ;;;EAcO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,EAAG,KAAA,EAAO,cAAA,CAAe,CAAA;EAClE,GAAA,UAAa,GAAA,UAAa,KAAA,EAAO,CAAA;EAZxC;;;;;;;AAE+C;AAC/C;;;EAyBO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC5D,GAAA,UAAa,GAAA,WAAc,CAAA;EAtB9B;;;EAmCG,GAAA,CAAI,GAAA,EAAK,aAAA;EA/BgC;;;;;;;;;EA4CzC,MAAA,iBAAuB,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC/D,MAAA,UAAgB,GAAA,WAAc,CAAA;EADc;;;EAS5C,SAAA,iBAA0B,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAClE,SAAA,UAAmB,GAAA,WAAc,CAAA;EADc;;;EAS/C,MAAA,CAAO,GAAA;AAAA;AAAA,cAKH,SAAA,EAAS,SAAkB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/index.ts"],"mappings":";;;;;;;;;AA0BA;;KAAY,cAAA;EACV,MAAA,EAAQ,MAAA;EACR,aAAA,EAAe,eAAA;EACf,cAAA;EACA,MAAA,EAAQ,MAAA;EACR,iBAAA,EAAmB,UAAA;EACnB,0BAAA,EAA4B,uBAAA;EAC5B,wBAAA,EAA0B,qBAAA;AAAA;AAAA,KAGvB,aAAA,SAAsB,cAAc;AAAA,cAEnC,SAAA;EAVJ;;;EAcO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,EAAG,KAAA,EAAO,cAAA,CAAe,CAAA;EAClE,GAAA,UAAa,GAAA,UAAa,KAAA,EAAO,CAAA;EAZxC;;;;;;;AAE+C;AAC/C;;;EAyBO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC5D,GAAA,UAAa,GAAA,WAAc,CAAA;EAtB9B;;;EAmCG,GAAA,CAAI,GAAA,EAAK,aAAA;EA/BgC;;;;;;;;;EA4CzC,MAAA,iBAAuB,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC/D,MAAA,UAAgB,GAAA,WAAc,CAAA;EADc;;;EAS5C,SAAA,iBAA0B,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAClE,SAAA,UAAmB,GAAA,WAAc,CAAA;EADc;;;EAS/C,MAAA,CAAO,GAAA;AAAA;AAAA,cAKH,SAAA,EAAS,SAAkB"}

package/esm/container/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../packages/core/src/container/index.ts"],"sourcesContent":["import { type DataSource } from \"@warlock.js/cascade\";\nimport { type FastifyInstance } from \"fastify\";\nimport { type Server } from \"socket.io\";\nimport { ContainerKeyMissingError } from \"../errors/container-key-missing-error\";\nimport { type Router } from \"../router\";\nimport {\n  getRegisteredContainerInstances,\n  registerContainerInstance,\n} from \"./container-instance-registry\";\nimport type { DevelopmentAppModules } from \"./development-app-modules\";\nimport type { DevelopmentModelModules } from \"./development-model-modules\";\n\nexport type {\n  DevelopmentAppModuleEntry,\n  DevelopmentAppModules,\n} from \"./development-app-modules\";\nexport type {\n  DevelopmentModelModuleEntry,\n  DevelopmentModelModules,\n  DevelopmentModelModuleState,\n} from \"./development-model-modules\";\n\nconst containerMap: Map<string, any> = new Map();\n\nregisterContainerInstance();\n\n/**\n * Known container types for better IDE support\n */\nexport type ContainerTypes = {\n  router: Router;\n  \"http.server\": FastifyInstance;\n  \"http.baseUrl\": string;\n  socket: Server;\n  \"database.source\": DataSource;\n  \"development.modelModules\": DevelopmentModelModules;\n  \"development.appModules\": DevelopmentAppModules;\n};\n\ntype ContainerKeys = keyof ContainerTypes | (string & {});\n\nclass Container {\n  /**\n   * Set a value in the container\n   */\n  public set<K extends keyof ContainerTypes>(key: K, value: ContainerTypes[K]): void;\n  public set<T = any>(key: string, value: T): void;\n  public set(key: any, value: any) {\n    containerMap.set(key, value);\n  }\n\n  /**\n   * Get a value from the container, or throw if `key` is not registered.\n   *\n   * Behaves exactly like an ordinary \"not registered\" error when only one\n   * copy of this module is loaded. When {@link getRegisteredContainerInstances}\n   * shows more than one, the thrown error additionally names that count, so\n   * a duplicate-instance dev-path miss is never indistinguishable from a\n   * genuine missing registration.\n   *\n   * Use {@link tryGet} instead when the value is genuinely optional.\n   */\n  public get<K extends keyof ContainerTypes>(key: K): ContainerTypes[K];\n  public get<T = any>(key: string): T;\n  public get(key: any): any {\n    if (!containerMap.has(key)) {\n      const instanceCount = getRegisteredContainerInstances().length;\n      throw new ContainerKeyMissingError(key, instanceCount, [...containerMap.keys()]);\n    }\n\n    return containerMap.get(key);\n  }\n\n  /**\n   * Check if a key exists in the container\n   */\n  public has(key: ContainerKeys) {\n    return containerMap.has(key);\n  }\n\n  /**\n   * Get a value from the container, or `undefined` if `key` is not\n   * registered.\n   *\n   * Use this only for genuinely optional dependencies — where the caller\n   * has its own fallback for an absent value. For every other read, prefer\n   * {@link get}: a hole in the container should fail loudly, not hand back\n   * `undefined` typed as the real value.\n   */\n  public tryGet<K extends keyof ContainerTypes>(key: K): ContainerTypes[K] | undefined;\n  public tryGet<T = any>(key: string): T | undefined;\n  public tryGet(key: any): any {\n    return containerMap.get(key);\n  }\n\n  /**\n   * @deprecated `get` now throws for a missing key; use {@link get}.\n   */\n  public getOrFail<K extends keyof ContainerTypes>(key: K): ContainerTypes[K];\n  public getOrFail<T = any>(key: string): T;\n  public getOrFail(key: any): any {\n    return this.get(key);\n  }\n\n  /**\n   * Delete a key from the container\n   */\n  public delete(key: string) {\n    containerMap.delete(key);\n  }\n}\n\nexport const container = new Container();\n"],"mappings":";;;;AAsBA,MAAM,+BAAiC,IAAI,IAAI;AAE/C,0BAA0B;AAiB1B,IAAM,YAAN,MAAgB;CAMd,AAAO,IAAI,KAAU,OAAY;EAC/B,aAAa,IAAI,KAAK,KAAK;CAC7B;CAeA,AAAO,IAAI,KAAe;EACxB,IAAI,CAAC,aAAa,IAAI,GAAG,GAAG;GAC1B,MAAM,gBAAgB,gCAAgC,CAAC,CAAC;GACxD,MAAM,IAAI,yBAAyB,KAAK,eAAe,CAAC,GAAG,aAAa,KAAK,CAAC,CAAC;EACjF;EAEA,OAAO,aAAa,IAAI,GAAG;CAC7B;;;;CAKA,AAAO,IAAI,KAAoB;EAC7B,OAAO,aAAa,IAAI,GAAG;CAC7B;CAaA,AAAO,OAAO,KAAe;EAC3B,OAAO,aAAa,IAAI,GAAG;CAC7B;CAOA,AAAO,UAAU,KAAe;EAC9B,OAAO,KAAK,IAAI,GAAG;CACrB;;;;CAKA,AAAO,OAAO,KAAa;EACzB,aAAa,OAAO,GAAG;CACzB;AACF;AAEA,MAAa,YAAY,IAAI,UAAU"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../packages/core/src/container/index.ts"],"sourcesContent":["import { type DataSource } from \"@warlock.js/cascade\";\nimport { type FastifyInstance } from \"fastify\";\nimport { type Server } from \"socket.io\";\nimport { ContainerKeyMissingError } from \"../errors/container-key-missing-error\";\nimport { type Router } from \"../router\";\nimport {\n  getRegisteredContainerInstances,\n  registerContainerInstance,\n} from \"./container-instance-registry\";\nimport type { DevelopmentAppModules } from \"./development-app-modules\";\nimport type { DevelopmentModelModules } from \"./development-model-modules\";\n\nexport type { DevelopmentAppModuleEntry, DevelopmentAppModules } from \"./development-app-modules\";\nexport type {\n  DevelopmentModelModuleEntry,\n  DevelopmentModelModules,\n  DevelopmentModelModuleState,\n} from \"./development-model-modules\";\n\nconst containerMap: Map<string, any> = new Map();\n\nregisterContainerInstance();\n\n/**\n * Known container types for better IDE support\n */\nexport type ContainerTypes = {\n  router: Router;\n  \"http.server\": FastifyInstance;\n  \"http.baseUrl\": string;\n  socket: Server;\n  \"database.source\": DataSource;\n  \"development.modelModules\": DevelopmentModelModules;\n  \"development.appModules\": DevelopmentAppModules;\n};\n\ntype ContainerKeys = keyof ContainerTypes | (string & {});\n\nclass Container {\n  /**\n   * Set a value in the container\n   */\n  public set<K extends keyof ContainerTypes>(key: K, value: ContainerTypes[K]): void;\n  public set<T = any>(key: string, value: T): void;\n  public set(key: any, value: any) {\n    containerMap.set(key, value);\n  }\n\n  /**\n   * Get a value from the container, or throw if `key` is not registered.\n   *\n   * Behaves exactly like an ordinary \"not registered\" error when only one\n   * copy of this module is loaded. When {@link getRegisteredContainerInstances}\n   * shows more than one, the thrown error additionally names that count, so\n   * a duplicate-instance dev-path miss is never indistinguishable from a\n   * genuine missing registration.\n   *\n   * Use {@link tryGet} instead when the value is genuinely optional.\n   */\n  public get<K extends keyof ContainerTypes>(key: K): ContainerTypes[K];\n  public get<T = any>(key: string): T;\n  public get(key: any): any {\n    if (!containerMap.has(key)) {\n      const instanceCount = getRegisteredContainerInstances().length;\n      throw new ContainerKeyMissingError(key, instanceCount, [...containerMap.keys()]);\n    }\n\n    return containerMap.get(key);\n  }\n\n  /**\n   * Check if a key exists in the container\n   */\n  public has(key: ContainerKeys) {\n    return containerMap.has(key);\n  }\n\n  /**\n   * Get a value from the container, or `undefined` if `key` is not\n   * registered.\n   *\n   * Use this only for genuinely optional dependencies — where the caller\n   * has its own fallback for an absent value. For every other read, prefer\n   * {@link get}: a hole in the container should fail loudly, not hand back\n   * `undefined` typed as the real value.\n   */\n  public tryGet<K extends keyof ContainerTypes>(key: K): ContainerTypes[K] | undefined;\n  public tryGet<T = any>(key: string): T | undefined;\n  public tryGet(key: any): any {\n    return containerMap.get(key);\n  }\n\n  /**\n   * @deprecated `get` now throws for a missing key; use {@link get}.\n   */\n  public getOrFail<K extends keyof ContainerTypes>(key: K): ContainerTypes[K];\n  public getOrFail<T = any>(key: string): T;\n  public getOrFail(key: any): any {\n    return this.get(key);\n  }\n\n  /**\n   * Delete a key from the container\n   */\n  public delete(key: string) {\n    containerMap.delete(key);\n  }\n}\n\nexport const container = new Container();\n"],"mappings":";;;;AAmBA,MAAM,+BAAiC,IAAI,IAAI;AAE/C,0BAA0B;AAiB1B,IAAM,YAAN,MAAgB;CAMd,AAAO,IAAI,KAAU,OAAY;EAC/B,aAAa,IAAI,KAAK,KAAK;CAC7B;CAeA,AAAO,IAAI,KAAe;EACxB,IAAI,CAAC,aAAa,IAAI,GAAG,GAAG;GAC1B,MAAM,gBAAgB,gCAAgC,CAAC,CAAC;GACxD,MAAM,IAAI,yBAAyB,KAAK,eAAe,CAAC,GAAG,aAAa,KAAK,CAAC,CAAC;EACjF;EAEA,OAAO,aAAa,IAAI,GAAG;CAC7B;;;;CAKA,AAAO,IAAI,KAAoB;EAC7B,OAAO,aAAa,IAAI,GAAG;CAC7B;CAaA,AAAO,OAAO,KAAe;EAC3B,OAAO,aAAa,IAAI,GAAG;CAC7B;CAOA,AAAO,UAAU,KAAe;EAC9B,OAAO,KAAK,IAAI,GAAG;CACrB;;;;CAKA,AAAO,OAAO,KAAa;EACzB,aAAa,OAAO,GAAG;CACzB;AACF;AAEA,MAAa,YAAY,IAAI,UAAU"}

package/esm/database/migrate-action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-action.mjs","names":[],"sources":["../../../../../../../../packages/core/src/database/migrate-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  exportMigrationsSQL,\n  freshMigrate,\n  listExecutedMigrations,\n  Migration,\n  type MigrationConstructor,\n  migrationRunner,\n  rollbackMigrations,\n  runMigrations,\n} from \"@warlock.js/cascade\";\nimport dayjs from \"dayjs\";\nimport path from \"path\";\nimport type { CommandActionData } from \"../commands/types\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { Path } from \"../utils/normalized-path\";\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\nimport { srcPath } from \"../utils\";\nimport { isTestFile } from \"../utils/is-test-file\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { exitCodeFor, PENDING_EXIT_CODE } from \"./pending-exit-code\";\nimport {\n  resolvePendingMigrations,\n  type PendingMigrationsResult,\n} from \"./resolve-pending-migrations\";\n\n/**\n * `--list` — print the migration state: what has run, then what will run next.\n *\n * The executed section is printed FIRST and unconditionally, before anything\n * touches disk or config. That ordering is the contract: reading migrations\n * from the table cannot fail because of a broken migration file, and `--list`\n * is the command an operator reaches for *during* an incident. The pending\n * section is best-effort on top of an answer that is already on screen.\n *\n * Always exits 0. It is a report; `--pending` is the gate.\n */\nasync function listMigrationsAction() {\n  await printExecutedMigrations();\n\n  const pending = await resolvePendingMigrations(loadAllMigrations);\n\n  printPendingMigrations(pending);\n}\n\nasync function printExecutedMigrations() {\n  const createdMigrations = await listExecutedMigrations();\n\n  console.log(`\\nTotal Executed Migrations: ${colors.green(createdMigrations.length)}\\n`);\n\n  if (createdMigrations.length === 0) {\n    console.log(colors.gray(\"  No migrations have been executed yet.\\n\"));\n    return;\n  }\n\n  // Display each migration as a block\n  for (const migration of createdMigrations) {\n    const executedAt = dayjs(migration.executedAt).format(\"DD-MM-YYYY hh:mm:ss A\");\n    const createdAt = migration.createdAt\n      ? dayjs(migration.createdAt).format(\"DD-MM-YYYY hh:mm:ss A\")\n      : null;\n\n    // Migration name with checkmark icon\n    console.log(`  ${colors.green(\"✔\")} ${colors.cyanBright(migration.name)}`);\n\n    // Executed date\n    console.log(`    ${colors.gray(\"Executed:\")} ${colors.white(executedAt)}`);\n\n    // Created date (if available)\n    if (createdAt) {\n      console.log(`    ${colors.gray(\"Created:\")}  ${colors.yellow(createdAt)}`);\n    }\n\n    console.log(\"\"); // Empty line between migrations\n  }\n}\n\n/**\n * Print the pending section shared by `--list` and `--pending`.\n *\n * An unavailable result prints an explicit line and NEVER a count. \"0 pending\"\n * over a tree we failed to read is the one output this whole feature exists to\n * prevent.\n */\nfunction printPendingMigrations(result: PendingMigrationsResult) {\n  if (result.type === \"unavailable\") {\n    console.log(\n      `${colors.yellowBright(\"Pending: unavailable\")} — ${result.reason}\\n` +\n        colors.gray(\"  The executed list above is still accurate.\\n\"),\n    );\n    return;\n  }\n\n  const { migrations } = result;\n\n  console.log(`Total Pending Migrations: ${colors.green(migrations.length)}\\n`);\n\n  if (migrations.length === 0) {\n    console.log(colors.gray(\"  Nothing pending — the database is up to date.\\n\"));\n    return;\n  }\n\n  // Numbered because the ORDER is the answer: this is what the next\n  // `warlock migrate` will do, in the sequence it will do it.\n  migrations.forEach((migration, index) => {\n    console.log(`  ${colors.gray(`${index + 1}.`)} ${colors.cyanBright(migration.name)}`);\n  });\n\n  console.log(\"\");\n}\n\n/**\n * `--pending` — the scriptable half. Same computation as `--list`'s pending\n * section, different exit contract: see {@link PENDING_EXIT_CODE}.\n */\nasync function pendingMigrationsAction() {\n  const result = await resolvePendingMigrations(loadAllMigrations);\n\n  printPendingMigrations(result);\n\n  const exitCode = exitCodeFor(result);\n\n  if (exitCode === PENDING_EXIT_CODE.unavailable) {\n    console.error(\n      colors.redBright(\"Could not determine the pending set — exiting 2 rather than reporting 0.\"),\n    );\n  }\n\n  process.exit(exitCode);\n}\n\nasync function allMigrationsFilesAction() {\n  // get all available migration files in the project\n  const files = (await migrationFiles()).map((path) => Path.toRelative(path));\n  console.log(`Total Migration Files: ${colors.green(files.length)}`);\n\n  for (const file of files) {\n    console.log(colors.yellowBright(file));\n  }\n}\n\n/**\n * If path is provided, then run the migration runner against that file only\n * If fresh is provided, then rollback all migrations and run all migrations\n * If rollback is provided, then run the migration runner against all files in reverse order\n */\nexport async function migrateAction(options: CommandActionData) {\n  const { fresh, path, rollback, all, list, pending, sql, pendingOnly, compact } = options.options;\n\n  if (list) {\n    return await listMigrationsAction();\n  }\n\n  if (pending) {\n    return await pendingMigrationsAction();\n  }\n\n  if (all) {\n    return await allMigrationsFilesAction();\n  }\n\n  if (path) {\n    await loadMigrationFile(Path.toAbsolute(path as string));\n  } else {\n    await loadAllMigrations();\n  }\n\n  if (fresh && rollback) {\n    console.log(colors.redBright(\"You can't use --fresh and --rollback together\"));\n    process.exit(1);\n  }\n\n  if (rollback) {\n    await rollbackMigrations({ all: true });\n    return;\n  }\n\n  if (sql) {\n    await exportMigrationsSQL({\n      pendingOnly: pendingOnly as boolean,\n      compact: compact as boolean,\n    });\n    return;\n  }\n\n  if (fresh) {\n    await freshMigrate();\n    return;\n  }\n\n  await runMigrations();\n}\n\nexport async function loadMigrationFile(absPath: string) {\n  const relativePath = Path.toRelative(absPath);\n\n  // MigrationConstructor, not `typeof Migration`: a migration file default-exports a\n  // CONCRETE subclass, while Migration itself is abstract and so cannot satisfy a\n  // `new () => ...` parameter. The annotation described the base class rather than\n  // what is actually loaded, and that is what migrationRunner.register() rejected.\n  const loadedModule = await filesOrchestrator.load<{ default: MigrationConstructor }>(\n    relativePath,\n  );\n\n  if (!loadedModule?.default) {\n    throw new Error(`${Path.toRelative(absPath)} must have a default export`);\n  }\n\n  const MigrationClass = loadedModule.default;\n\n  if (!MigrationClass.migrationName) {\n    MigrationClass.migrationName = path\n      .basename(absPath)\n      .split(\".\")[0]\n      .replace(\"-migration\", \"\")\n      .replace(\"_migration\", \"\");\n  }\n\n  // Extract createdAt timestamp from filename if not already set\n  // Expected format: MM-DD-YYYY_HH-MM-SS-name.migration.ts\n  if (!MigrationClass.createdAt) {\n    const filename = path.basename(absPath);\n    const timestampMatch = filename.match(/^(\\d{2}-\\d{2}-\\d{4}_\\d{2}-\\d{2}-\\d{2})/);\n    if (timestampMatch) {\n      MigrationClass.createdAt = timestampMatch[1];\n    }\n  }\n\n  migrationRunner.register(MigrationClass, \"app\");\n}\n\n/**\n *\n * @returns List of absolute paths to migration files\n */\nasync function migrationFiles() {\n  const migrationFiles = await getFilesFromDirectory(srcPath(\"app\"), \"*/models/*/migrations/*\");\n  const separateMigrationsFolderFIles = await getFilesFromDirectory(\n    srcPath(\"app\"),\n    \"*/migrations/*\",\n  );\n\n  const migrations = [...migrationFiles, ...separateMigrationsFolderFIles].filter(\n    (file) => !isTestFile(file),\n  );\n\n  return migrations;\n}\n\nexport async function loadAllMigrations() {\n  // Load config-registered migrations (from packages like @warlock.js/auth)\n  const configMigrations = warlockConfigManager.get(\"database\")?.migrations || [];\n\n  for (const MigrationClass of configMigrations) {\n    // Use class name as migration name if not set\n    if (!MigrationClass.migrationName) {\n      MigrationClass.migrationName = MigrationClass.name;\n    }\n    migrationRunner.register(MigrationClass, \"package\");\n  }\n\n  // Always load file-based migrations from src/app, regardless of config\n  const migrations = await migrationFiles();\n  for (const migrationFile of migrations) {\n    await loadMigrationFile(migrationFile);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"migrate-action.mjs","names":[],"sources":["../../../../../../../../packages/core/src/database/migrate-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  exportMigrationsSQL,\n  freshMigrate,\n  listExecutedMigrations,\n  type MigrationConstructor,\n  migrationRunner,\n  rollbackMigrations,\n  runMigrations,\n} from \"@warlock.js/cascade\";\nimport dayjs from \"dayjs\";\nimport path from \"path\";\nimport type { CommandActionData } from \"../commands/types\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { Path } from \"../utils/normalized-path\";\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\nimport { srcPath } from \"../utils\";\nimport { isTestFile } from \"../utils/is-test-file\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { exitCodeFor, PENDING_EXIT_CODE } from \"./pending-exit-code\";\nimport {\n  resolvePendingMigrations,\n  type PendingMigrationsResult,\n} from \"./resolve-pending-migrations\";\n\n/**\n * `--list` — print the migration state: what has run, then what will run next.\n *\n * The executed section is printed FIRST and unconditionally, before anything\n * touches disk or config. That ordering is the contract: reading migrations\n * from the table cannot fail because of a broken migration file, and `--list`\n * is the command an operator reaches for *during* an incident. The pending\n * section is best-effort on top of an answer that is already on screen.\n *\n * Always exits 0. It is a report; `--pending` is the gate.\n */\nasync function listMigrationsAction() {\n  await printExecutedMigrations();\n\n  const pending = await resolvePendingMigrations(loadAllMigrations);\n\n  printPendingMigrations(pending);\n}\n\nasync function printExecutedMigrations() {\n  const createdMigrations = await listExecutedMigrations();\n\n  console.log(`\\nTotal Executed Migrations: ${colors.green(createdMigrations.length)}\\n`);\n\n  if (createdMigrations.length === 0) {\n    console.log(colors.gray(\"  No migrations have been executed yet.\\n\"));\n    return;\n  }\n\n  // Display each migration as a block\n  for (const migration of createdMigrations) {\n    const executedAt = dayjs(migration.executedAt).format(\"DD-MM-YYYY hh:mm:ss A\");\n    const createdAt = migration.createdAt\n      ? dayjs(migration.createdAt).format(\"DD-MM-YYYY hh:mm:ss A\")\n      : null;\n\n    // Migration name with checkmark icon\n    console.log(`  ${colors.green(\"✔\")} ${colors.cyanBright(migration.name)}`);\n\n    // Executed date\n    console.log(`    ${colors.gray(\"Executed:\")} ${colors.white(executedAt)}`);\n\n    // Created date (if available)\n    if (createdAt) {\n      console.log(`    ${colors.gray(\"Created:\")}  ${colors.yellow(createdAt)}`);\n    }\n\n    console.log(\"\"); // Empty line between migrations\n  }\n}\n\n/**\n * Print the pending section shared by `--list` and `--pending`.\n *\n * An unavailable result prints an explicit line and NEVER a count. \"0 pending\"\n * over a tree we failed to read is the one output this whole feature exists to\n * prevent.\n */\nfunction printPendingMigrations(result: PendingMigrationsResult) {\n  if (result.type === \"unavailable\") {\n    console.log(\n      `${colors.yellowBright(\"Pending: unavailable\")} — ${result.reason}\\n` +\n        colors.gray(\"  The executed list above is still accurate.\\n\"),\n    );\n    return;\n  }\n\n  const { migrations } = result;\n\n  console.log(`Total Pending Migrations: ${colors.green(migrations.length)}\\n`);\n\n  if (migrations.length === 0) {\n    console.log(colors.gray(\"  Nothing pending — the database is up to date.\\n\"));\n    return;\n  }\n\n  // Numbered because the ORDER is the answer: this is what the next\n  // `warlock migrate` will do, in the sequence it will do it.\n  migrations.forEach((migration, index) => {\n    console.log(`  ${colors.gray(`${index + 1}.`)} ${colors.cyanBright(migration.name)}`);\n  });\n\n  console.log(\"\");\n}\n\n/**\n * `--pending` — the scriptable half. Same computation as `--list`'s pending\n * section, different exit contract: see {@link PENDING_EXIT_CODE}.\n */\nasync function pendingMigrationsAction() {\n  const result = await resolvePendingMigrations(loadAllMigrations);\n\n  printPendingMigrations(result);\n\n  const exitCode = exitCodeFor(result);\n\n  if (exitCode === PENDING_EXIT_CODE.unavailable) {\n    console.error(\n      colors.redBright(\"Could not determine the pending set — exiting 2 rather than reporting 0.\"),\n    );\n  }\n\n  process.exit(exitCode);\n}\n\nasync function allMigrationsFilesAction() {\n  // get all available migration files in the project\n  const files = (await migrationFiles()).map((path) => Path.toRelative(path));\n  console.log(`Total Migration Files: ${colors.green(files.length)}`);\n\n  for (const file of files) {\n    console.log(colors.yellowBright(file));\n  }\n}\n\n/**\n * If path is provided, then run the migration runner against that file only\n * If fresh is provided, then rollback all migrations and run all migrations\n * If rollback is provided, then run the migration runner against all files in reverse order\n */\nexport async function migrateAction(options: CommandActionData) {\n  const { fresh, path, rollback, all, list, pending, sql, pendingOnly, compact } = options.options;\n\n  if (list) {\n    return await listMigrationsAction();\n  }\n\n  if (pending) {\n    return await pendingMigrationsAction();\n  }\n\n  if (all) {\n    return await allMigrationsFilesAction();\n  }\n\n  if (path) {\n    await loadMigrationFile(Path.toAbsolute(path as string));\n  } else {\n    await loadAllMigrations();\n  }\n\n  if (fresh && rollback) {\n    console.log(colors.redBright(\"You can't use --fresh and --rollback together\"));\n    process.exit(1);\n  }\n\n  if (rollback) {\n    await rollbackMigrations({ all: true });\n    return;\n  }\n\n  if (sql) {\n    await exportMigrationsSQL({\n      pendingOnly: pendingOnly as boolean,\n      compact: compact as boolean,\n    });\n    return;\n  }\n\n  if (fresh) {\n    await freshMigrate();\n    return;\n  }\n\n  await runMigrations();\n}\n\nexport async function loadMigrationFile(absPath: string) {\n  const relativePath = Path.toRelative(absPath);\n\n  // MigrationConstructor, not `typeof Migration`: a migration file default-exports a\n  // CONCRETE subclass, while Migration itself is abstract and so cannot satisfy a\n  // `new () => ...` parameter. The annotation described the base class rather than\n  // what is actually loaded, and that is what migrationRunner.register() rejected.\n  const loadedModule = await filesOrchestrator.load<{ default: MigrationConstructor }>(\n    relativePath,\n  );\n\n  if (!loadedModule?.default) {\n    throw new Error(`${Path.toRelative(absPath)} must have a default export`);\n  }\n\n  const MigrationClass = loadedModule.default;\n\n  if (!MigrationClass.migrationName) {\n    MigrationClass.migrationName = path\n      .basename(absPath)\n      .split(\".\")[0]!\n      .replace(\"-migration\", \"\")\n      .replace(\"_migration\", \"\");\n  }\n\n  // Extract createdAt timestamp from filename if not already set\n  // Expected format: MM-DD-YYYY_HH-MM-SS-name.migration.ts\n  if (!MigrationClass.createdAt) {\n    const filename = path.basename(absPath);\n    const timestampMatch = filename.match(/^(\\d{2}-\\d{2}-\\d{4}_\\d{2}-\\d{2}-\\d{2})/);\n    if (timestampMatch) {\n      MigrationClass.createdAt = timestampMatch[1];\n    }\n  }\n\n  migrationRunner.register(MigrationClass, \"app\");\n}\n\n/**\n *\n * @returns List of absolute paths to migration files\n */\nasync function migrationFiles() {\n  const migrationFiles = await getFilesFromDirectory(srcPath(\"app\"), \"*/models/*/migrations/*\");\n  const separateMigrationsFolderFIles = await getFilesFromDirectory(\n    srcPath(\"app\"),\n    \"*/migrations/*\",\n  );\n\n  const migrations = [...migrationFiles, ...separateMigrationsFolderFIles].filter(\n    (file) => !isTestFile(file),\n  );\n\n  return migrations;\n}\n\nexport async function loadAllMigrations() {\n  // Load config-registered migrations (from packages like @warlock.js/auth)\n  const configMigrations = warlockConfigManager.get(\"database\")?.migrations || [];\n\n  for (const MigrationClass of configMigrations) {\n    // Use class name as migration name if not set\n    if (!MigrationClass.migrationName) {\n      MigrationClass.migrationName = MigrationClass.name;\n    }\n    migrationRunner.register(MigrationClass, \"package\");\n  }\n\n  // Always load file-based migrations from src/app, regardless of config\n  const migrations = await migrationFiles();\n  for (const migrationFile of migrations) {\n    await loadMigrationFile(migrationFile);\n  }\n}\n"],"mappings":"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"}

package/esm/database/models/database-log/database-log.d.mts

@@ -11,20 +11,6 @@ declare const schema: import("@warlock.js/seal").ObjectValidator<{
   };
   level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
   date: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
-}> & import("@warlock.js/seal").StandardSchemaV1<{
-  stack?: string | undefined;
-  module: string;
-  action: string;
-  content: any;
-  level: string;
-  date: string;
-}, {
-  stack?: string | undefined;
-  module: string;
-  action: string;
-  content: any;
-  level: string;
-  date: string;
 }>;
 type LogSchema = Infer.Output<typeof schema>;
 declare class DatabaseLogModel extends Model<LogSchema> {
@@ -44,20 +30,6 @@ declare class DatabaseLogModel extends Model<LogSchema> {
     };
     level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
     date: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
-  }> & import("@warlock.js/seal").StandardSchemaV1<{
-    stack?: string | undefined;
-    module: string;
-    action: string;
-    content: any;
-    level: string;
-    date: string;
-  }, {
-    stack?: string | undefined;
-    module: string;
-    action: string;
-    content: any;
-    level: string;
-    date: string;
   }>;
   /**
    * Legacy rows stored `message`/`trace`; map them to `content`/`stack`

package/esm/database/models/database-log/database-log.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/database/models/database-log/database-log.ts"],"mappings":";;;;cAGM,MAAA,6BAAM,eAAA;;;;;;;;;;;;;;;;;;;;;;;;KASP,SAAA,GAAY,KAAA,CAAM,MAAM,QAAQ,MAAA;AAAA,cAExB,gBAAA,SAAyB,KAAK,CAAC,SAAA;;;;SAI5B,KAAA;;;;SAKA,MAAA,6BAAM,eAAA;;;;;;;;;;;;;;;;;;;;;;;;EAAN;;;;EAAA,wBAMU,YAAA;;;;MAQb,OAAA;;;;MAOA,KAAA;;;;EAOJ,GAAA,CAAI,KAAA,UAAe,YAAA;AAAA"}
+{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/database/models/database-log/database-log.ts"],"mappings":";;;;cAGM,MAAA,6BAAM,eAAA;;;;;;;;;;KASP,SAAA,GAAY,KAAA,CAAM,MAAM,QAAQ,MAAA;AAAA,cAExB,gBAAA,SAAyB,KAAK,CAAC,SAAA;;;;SAI5B,KAAA;;;;SAKA,MAAA,6BAAM,eAAA;;;;;;;;;;EAXR;;;;EAAA,wBAiBY,YAAA;EAjBW;;AAAM;EAAN,IAyBxB,OAAA;EAvBiB;;;EAAA,IA8BjB,KAAA;EA9B+B;;;EAqCnC,GAAA,CAAI,KAAA,UAAe,YAAA;AAAA"}

package/esm/database/seeds/seeder.errors.d.mts

@@ -7,6 +7,8 @@
 declare class UnknownSeederDependencyError extends Error {
   readonly seeder: string;
   readonly dependency: string;
+  /** Stable Warlock error code; `warlock explain WL6001` prints the fix. */
+  readonly code = "WL6001";
   constructor(seeder: string, dependency: string);
 }
 /**
@@ -15,6 +17,8 @@ declare class UnknownSeederDependencyError extends Error {
  */
 declare class SeederDependencyCycleError extends Error {
   readonly cycle: string[];
+  /** Stable Warlock error code; `warlock explain WL6002` prints the fix. */
+  readonly code = "WL6002";
   constructor(cycle: string[]);
 }
 //#endregion

package/esm/database/seeds/seeder.errors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"seeder.errors.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.errors.ts"],"mappings":";;AAKA;;;;cAAa,4BAAA,SAAqC,KAAK;EAAA,SAEnC,MAAA;EAAA,SACA,UAAA;cADA,MAAA,UACA,UAAA;AAAA;;;AAAkB;AAatC;cAAa,0BAAA,SAAmC,KAAK;EAAA,SAChB,KAAA;cAAA,KAAA;AAAA"}
+{"version":3,"file":"seeder.errors.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.errors.ts"],"mappings":";;AAKA;;;;cAAa,4BAAA,SAAqC,KAAK;EAAA,SAKnC,MAAA;EAAA,SACA,UAAA;EAJF;EAAA,SAAA,IAAA;cAGE,MAAA,UACA,UAAA;AAAA;;AAAkB;AAatC;;cAAa,0BAAA,SAAmC,KAAK;EAAA,SAIhB,KAAA;EAJW;EAAA,SAE9B,IAAA;cAEmB,KAAA;AAAA"}

package/esm/database/seeds/seeder.errors.mjs

@@ -9,6 +9,7 @@ var UnknownSeederDependencyError = class extends Error {
 		super(`Seeder "${seeder}" depends on "${dependency}", but no seeder with that name is registered.`);
 		this.seeder = seeder;
 		this.dependency = dependency;
+		this.code = "WL6001";
 		this.name = "UnknownSeederDependencyError";
 	}
 };
@@ -20,6 +21,7 @@ var SeederDependencyCycleError = class extends Error {
 	constructor(cycle) {
 		super(`Seeder dependency cycle detected: ${cycle.join(" -> ")}`);
 		this.cycle = cycle;
+		this.code = "WL6002";
 		this.name = "SeederDependencyCycleError";
 	}
 };

package/esm/database/seeds/seeder.errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"seeder.errors.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.errors.ts"],"sourcesContent":["/**\n * Thrown when a seeder's `dependsOn` references a seeder name that is not\n * registered with the manager. Surfaces the offending dependent + the missing\n * dependency so the misconfiguration is obvious without spelunking.\n */\nexport class UnknownSeederDependencyError extends Error {\n  public constructor(\n    public readonly seeder: string,\n    public readonly dependency: string,\n  ) {\n    super(\n      `Seeder \"${seeder}\" depends on \"${dependency}\", but no seeder with that name is registered.`,\n    );\n    this.name = \"UnknownSeederDependencyError\";\n  }\n}\n\n/**\n * Thrown when the `dependsOn` graph contains a cycle, which would make a\n * deterministic run order impossible. Carries the cycle path for diagnosis.\n */\nexport class SeederDependencyCycleError extends Error {\n  public constructor(public readonly cycle: string[]) {\n    super(`Seeder dependency cycle detected: ${cycle.join(\" -> \")}`);\n    this.name = \"SeederDependencyCycleError\";\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAa,+BAAb,cAAkD,MAAM;CACtD,AAAO,YACL,AAAgB,QAChB,AAAgB,YAChB;EACA,MACE,WAAW,OAAO,gBAAgB,WAAW,+CAC/C;EALgB;EACA;EAKhB,KAAK,OAAO;CACd;AACF;;;;;AAMA,IAAa,6BAAb,cAAgD,MAAM;CACpD,AAAO,YAAY,AAAgB,OAAiB;EAClD,MAAM,qCAAqC,MAAM,KAAK,MAAM,GAAG;EAD9B;EAEjC,KAAK,OAAO;CACd;AACF"}
+{"version":3,"file":"seeder.errors.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.errors.ts"],"sourcesContent":["/**\n * Thrown when a seeder's `dependsOn` references a seeder name that is not\n * registered with the manager. Surfaces the offending dependent + the missing\n * dependency so the misconfiguration is obvious without spelunking.\n */\nexport class UnknownSeederDependencyError extends Error {\n  /** Stable Warlock error code; `warlock explain WL6001` prints the fix. */\n  public readonly code = \"WL6001\";\n\n  public constructor(\n    public readonly seeder: string,\n    public readonly dependency: string,\n  ) {\n    super(\n      `Seeder \"${seeder}\" depends on \"${dependency}\", but no seeder with that name is registered.`,\n    );\n    this.name = \"UnknownSeederDependencyError\";\n  }\n}\n\n/**\n * Thrown when the `dependsOn` graph contains a cycle, which would make a\n * deterministic run order impossible. Carries the cycle path for diagnosis.\n */\nexport class SeederDependencyCycleError extends Error {\n  /** Stable Warlock error code; `warlock explain WL6002` prints the fix. */\n  public readonly code = \"WL6002\";\n\n  public constructor(public readonly cycle: string[]) {\n    super(`Seeder dependency cycle detected: ${cycle.join(\" -> \")}`);\n    this.name = \"SeederDependencyCycleError\";\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAa,+BAAb,cAAkD,MAAM;CAItD,AAAO,YACL,AAAgB,QAChB,AAAgB,YAChB;EACA,MACE,WAAW,OAAO,gBAAgB,WAAW,+CAC/C;EALgB;EACA;cAJK;EASrB,KAAK,OAAO;CACd;AACF;;;;;AAMA,IAAa,6BAAb,cAAgD,MAAM;CAIpD,AAAO,YAAY,AAAgB,OAAiB;EAClD,MAAM,qCAAqC,MAAM,KAAK,MAAM,GAAG;EAD9B;cAFZ;EAIrB,KAAK,OAAO;CACd;AACF"}

package/esm/dev-server/boot-precondition-error.mjs

@@ -18,6 +18,7 @@ import { PortInUseError } from "../http/port-preflight.mjs";
 var BootPreconditionError = class extends Error {
 	constructor(message, options) {
 		super(message, options);
+		this.code = "WL2005";
 		this.name = "BootPreconditionError";
 	}
 };

package/esm/dev-server/boot-precondition-error.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"boot-precondition-error.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/boot-precondition-error.ts"],"sourcesContent":["import { PortInUseError } from \"../http/port-preflight\";\n\n/**\n * Marks a startup failure whose cause cannot change because the dev worker\n * tried again — a rejected `Application.onValidateBoot(...)` validator, an\n * unusable configured value, or (via {@link isBootPreconditionError})\n * {@link PortInUseError} itself. Distinct from an ordinary code error or a\n * refused database/cache connection, both of which ARE worth restarting for\n * (the underlying service, or the developer's fix, can change on the next\n * attempt).\n *\n * `start-development-server.ts` checks for this type (never an error\n * message) to decide whether the worker exits with\n * `supervisor.ts`'s `BOOT_PRECONDITION_EXIT_CODE`, which the supervisor\n * treats as terminal — no restart, no crash-budget spend.\n */\nexport class BootPreconditionError extends Error {\n  public constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"BootPreconditionError\";\n  }\n}\n\n/**\n * Whether `error` belongs to the boot-precondition class — checked by TYPE,\n * never by message text, so a legitimate error that happens to share\n * wording with a known failure is never misclassified.\n */\nexport function isBootPreconditionError(error: unknown): boolean {\n  return error instanceof BootPreconditionError || error instanceof PortInUseError;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,IAAa,wBAAb,cAA2C,MAAM;CAC/C,AAAO,YAAY,SAAiB,SAA+B;EACjE,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;CACd;AACF;;;;;;AAOA,SAAgB,wBAAwB,OAAyB;CAC/D,OAAO,iBAAiB,yBAAyB,iBAAiB;AACpE"}
+{"version":3,"file":"boot-precondition-error.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/boot-precondition-error.ts"],"sourcesContent":["import { PortInUseError } from \"../http/port-preflight\";\n\n/**\n * Marks a startup failure whose cause cannot change because the dev worker\n * tried again — a rejected `Application.onValidateBoot(...)` validator, an\n * unusable configured value, or (via {@link isBootPreconditionError})\n * {@link PortInUseError} itself. Distinct from an ordinary code error or a\n * refused database/cache connection, both of which ARE worth restarting for\n * (the underlying service, or the developer's fix, can change on the next\n * attempt).\n *\n * `start-development-server.ts` checks for this type (never an error\n * message) to decide whether the worker exits with\n * `supervisor.ts`'s `BOOT_PRECONDITION_EXIT_CODE`, which the supervisor\n * treats as terminal — no restart, no crash-budget spend.\n */\nexport class BootPreconditionError extends Error {\n  /** Stable Warlock error code; `warlock explain WL2005` prints the fix. */\n  public readonly code = \"WL2005\";\n\n  public constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"BootPreconditionError\";\n  }\n}\n\n/**\n * Whether `error` belongs to the boot-precondition class — checked by TYPE,\n * never by message text, so a legitimate error that happens to share\n * wording with a known failure is never misclassified.\n */\nexport function isBootPreconditionError(error: unknown): boolean {\n  return error instanceof BootPreconditionError || error instanceof PortInUseError;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,IAAa,wBAAb,cAA2C,MAAM;CAI/C,AAAO,YAAY,SAAiB,SAA+B;EACjE,MAAM,SAAS,OAAO;cAHD;EAIrB,KAAK,OAAO;CACd;AACF;;;;;;AAOA,SAAgB,wBAAwB,OAAyB;CAC/D,OAAO,iBAAiB,yBAAyB,iBAAiB;AACpE"}

package/esm/dev-server/create-worker.mjs

@@ -1,5 +1,7 @@
+import { createRequire } from "node:module";
 import path from "node:path";
-import { fileURLToPath } from "url";
+import { pathToFileURL } from "node:url";
+import { fileURLToPath as fileURLToPath$1 } from "url";
 import { Worker } from "worker_threads";
 
 //#region ../../packages/core/src/dev-server/create-worker.ts
@@ -8,7 +10,8 @@ import { Worker } from "worker_threads";
 *
 * The worker shares the CALLING module's extension: `.ts` when core runs from
 * source (loaded via tsx), `.mjs` when core is published. Source workers are
-* run through the tsx loader; published `.mjs` workers run as-is.
+* loaded through tsx's `tsImport` API from a JavaScript bootstrap; published
+* `.mjs` workers run as-is.
 *
 * @param workerPath - Relative path to worker file WITHOUT extension (e.g., "./workers/ts-health.worker")
 * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)
@@ -26,15 +29,18 @@ import { Worker } from "worker_threads";
 * ```
 */
 function createWorker(workerPath, baseUrl, options) {
-	const callerExtension = path.extname(fileURLToPath(baseUrl));
+	const callerExtension = path.extname(fileURLToPath$1(baseUrl));
 	const isSource = callerExtension === ".ts" || callerExtension === ".tsx";
-	const workerFilePath = fileURLToPath(new URL(`${workerPath}${callerExtension}`, baseUrl));
+	const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);
+	const workerFilePath = fileURLToPath$1(workerUrl);
 	const workerOptions = { ...options };
-	if (isSource) workerOptions.execArgv = [
-		...options?.execArgv || [],
-		"--import",
-		"tsx/esm"
-	];
+	if (isSource) {
+		const tsxApi = pathToFileURL(createRequire(import.meta.url).resolve("tsx/esm/api")).href;
+		return new Worker(`import(${JSON.stringify(tsxApi)}).then(({ tsImport }) => tsImport(${JSON.stringify(workerUrl.href)}, ${JSON.stringify(baseUrl)}));`, {
+			...workerOptions,
+			eval: true
+		});
+	}
 	return new Worker(workerFilePath, workerOptions);
 }
 

package/esm/dev-server/create-worker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-worker.mjs","names":[],"sources":["../../../../../../../../packages/core/src/dev-server/create-worker.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath } from \"url\";\nimport { Worker, type WorkerOptions } from \"worker_threads\";\n\n/**\n * Options for creating a health check worker\n */\nexport type CreateWorkerOptions = WorkerOptions & {\n  /**\n   * Worker data to pass to the worker thread\n   */\n  workerData?: Record<string, unknown>;\n};\n\n/**\n * Create a worker that works in both dev (TypeScript) and production (JavaScript) environments.\n *\n * The worker shares the CALLING module's extension: `.ts` when core runs from\n * source (loaded via tsx), `.mjs` when core is published. Source workers are\n * run through the tsx loader; published `.mjs` workers run as-is.\n *\n * @param workerPath - Relative path to worker file WITHOUT extension (e.g., \"./workers/ts-health.worker\")\n * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)\n * @param options - Additional worker options\n * @returns A new Worker instance\n *\n * @example\n * ```typescript\n * // In FilesHealthcareManager\n * const worker = createWorker(\n *   \"./workers/ts-health.worker\",\n *   import.meta.url,\n *   { workerData: { cwd: process.cwd() } }\n * );\n * ```\n */\nexport function createWorker(\n  workerPath: string,\n  baseUrl: string,\n  options?: CreateWorkerOptions,\n): Worker {\n  // The worker shares the CALLING module's extension: `.ts` from source (needs the\n  // tsx loader to execute), `.mjs` when core is published.\n  const callerExtension = path.extname(fileURLToPath(baseUrl));\n  const isSource = callerExtension === \".ts\" || callerExtension === \".tsx\";\n  const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);\n  const workerFilePath = fileURLToPath(workerUrl);\n\n  const workerOptions: WorkerOptions = {\n    ...options,\n  };\n\n  // Source workers are TypeScript — run them through the tsx loader.\n  if (isSource) {\n    workerOptions.execArgv = [...(options?.execArgv || []), \"--import\", \"tsx/esm\"];\n  }\n\n  return new Worker(workerFilePath, workerOptions);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,aACd,YACA,SACA,SACQ;CAGR,MAAM,kBAAkB,KAAK,QAAQ,cAAc,OAAO,CAAC;CAC3D,MAAM,WAAW,oBAAoB,SAAS,oBAAoB;CAElE,MAAM,iBAAiB,cAAc,IADf,IAAI,GAAG,aAAa,mBAAmB,OAChB,CAAC;CAE9C,MAAM,gBAA+B,EACnC,GAAG,QACL;CAGA,IAAI,UACF,cAAc,WAAW;EAAC,GAAI,SAAS,YAAY,CAAC;EAAI;EAAY;CAAS;CAG/E,OAAO,IAAI,OAAO,gBAAgB,aAAa;AACjD"}
+{"version":3,"file":"create-worker.mjs","names":["fileURLToPath"],"sources":["../../../../../../../../packages/core/src/dev-server/create-worker.ts"],"sourcesContent":["import path from \"node:path\";\nimport { createRequire } from \"node:module\";\nimport { pathToFileURL } from \"node:url\";\nimport { fileURLToPath } from \"url\";\nimport { Worker, type WorkerOptions } from \"worker_threads\";\n\n/**\n * Options for creating a health check worker\n */\nexport type CreateWorkerOptions = WorkerOptions & {\n  /**\n   * Worker data to pass to the worker thread\n   */\n  workerData?: Record<string, unknown>;\n};\n\n/**\n * Create a worker that works in both dev (TypeScript) and production (JavaScript) environments.\n *\n * The worker shares the CALLING module's extension: `.ts` when core runs from\n * source (loaded via tsx), `.mjs` when core is published. Source workers are\n * loaded through tsx's `tsImport` API from a JavaScript bootstrap; published\n * `.mjs` workers run as-is.\n *\n * @param workerPath - Relative path to worker file WITHOUT extension (e.g., \"./workers/ts-health.worker\")\n * @param baseUrl - The import.meta.url of the calling module (used to resolve relative paths)\n * @param options - Additional worker options\n * @returns A new Worker instance\n *\n * @example\n * ```typescript\n * // In FilesHealthcareManager\n * const worker = createWorker(\n *   \"./workers/ts-health.worker\",\n *   import.meta.url,\n *   { workerData: { cwd: process.cwd() } }\n * );\n * ```\n */\nexport function createWorker(\n  workerPath: string,\n  baseUrl: string,\n  options?: CreateWorkerOptions,\n): Worker {\n  // The worker shares the CALLING module's extension: `.ts` from source (needs the\n  // tsx loader to execute), `.mjs` when core is published.\n  const callerExtension = path.extname(fileURLToPath(baseUrl));\n  const isSource = callerExtension === \".ts\" || callerExtension === \".tsx\";\n  const workerUrl = new URL(`${workerPath}${callerExtension}`, baseUrl);\n  const workerFilePath = fileURLToPath(workerUrl);\n\n  const workerOptions: WorkerOptions = {\n    ...options,\n  };\n\n  if (isSource) {\n    // Node 22.15 resolves a worker's entry before tsx's --import hook can\n    // handle its .ts extension. Bootstrap JS, then load the entry through\n    // tsx's supported API instead. Resolve from core, even when the app does\n    // not depend on tsx directly.\n    const require = createRequire(import.meta.url);\n    const tsxApi = pathToFileURL(require.resolve(\"tsx/esm/api\")).href;\n    const bootstrap = `import(${JSON.stringify(tsxApi)}).then(({ tsImport }) => tsImport(${JSON.stringify(workerUrl.href)}, ${JSON.stringify(baseUrl)}));`;\n    return new Worker(bootstrap, { ...workerOptions, eval: true });\n  }\n\n  return new Worker(workerFilePath, workerOptions);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,SAAgB,aACd,YACA,SACA,SACQ;CAGR,MAAM,kBAAkB,KAAK,QAAQA,gBAAc,OAAO,CAAC;CAC3D,MAAM,WAAW,oBAAoB,SAAS,oBAAoB;CAClE,MAAM,YAAY,IAAI,IAAI,GAAG,aAAa,mBAAmB,OAAO;CACpE,MAAM,iBAAiBA,gBAAc,SAAS;CAE9C,MAAM,gBAA+B,EACnC,GAAG,QACL;CAEA,IAAI,UAAU;EAMZ,MAAM,SAAS,cADC,cAAc,OAAO,KAAK,GACP,CAAC,CAAC,QAAQ,aAAa,CAAC,CAAC,CAAC;EAE7D,OAAO,IAAI,OAAO,UADU,KAAK,UAAU,MAAM,EAAE,oCAAoC,KAAK,UAAU,UAAU,IAAI,EAAE,IAAI,KAAK,UAAU,OAAO,EAAE,MACrH;GAAE,GAAG;GAAe,MAAM;EAAK,CAAC;CAC/D;CAEA,OAAO,IAAI,OAAO,gBAAgB,aAAa;AACjD"}