@warlock.js/core 5.0.2 → 5.2.0

package/esm/connectors/register-configured-connectors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"register-configured-connectors.mjs","names":[],"sources":["../../../../../../../core/src/connectors/register-configured-connectors.ts"],"sourcesContent":["/**\n * Registration half of the `connectors` config key.\n *\n * ONE key drives both halves of a connector's life: `warlock build` reads the\n * same array to drain each connector's build contribution, and this function\n * registers that array with the connectors manager so the runtime boots it.\n * Reading them from one place is the whole point — a bundle \"built for\" web\n * that \"boots without\" web is a green build with a missing client bundle, and\n * the failure is silent. A second key would let the two drift; this cannot.\n *\n * Two callers, two ways in:\n *\n * - The generated production entry PASSES the array explicitly. Inside a\n *   bundled artifact nothing ever loads `warlock.config.ts` — the build\n *   imports it statically so esbuild bakes it into the bundle, then hands the\n *   array straight here. No config manager, no runtime file read. It also\n *   passes `expectedNames` — the list the build resolved — so a config that\n *   resolves differently at startup is refused instead of booted.\n * - The dev preloader OMITS the array and lets this read the already-resolved\n *   warlock config, which dev has loaded by then. It also omits\n *   `expectedNames`, so dev gets NO drift check — deliberately. Drift is a\n *   relationship between what a build baked and what a runtime registers, and\n *   dev has no build: there is nothing to drift from, and inventing a second\n *   source of truth to compare against would create the disagreement this\n *   check exists to prevent. The absence of a check on this path is the\n *   design, not an omission — do not harmonise it with the production path.\n *   A conditional config that works in dev and is refused at production boot\n *   is this working as intended, not a gap.\n *\n * Idempotent either way: a connector whose name an EARLIER CALL in the same\n * process already registered is skipped rather than stacked, since a duplicate\n * would boot and shut down twice. A built-in's name is not that case — it is\n * reserved, and an array claiming one is refused rather than skipped.\n */\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { assertNoReservedConnectorNames } from \"./assert-no-reserved-connector-names\";\nimport { assertUniqueConnectorNames } from \"./assert-unique-connector-names\";\nimport { connectorsManager } from \"./connectors-manager\";\nimport type { Connector } from \"./types\";\n\nexport type RegisterConfiguredConnectorsOptions = {\n  /**\n   * The connector names, in order, that the build resolved. The generated\n   * production entry bakes this in; every other caller omits it.\n   */\n  expectedNames?: string[];\n};\n\nexport function registerConfiguredConnectors(\n  connectors?: Connector[],\n  options: RegisterConfiguredConnectorsOptions = {},\n): void {\n  const registering = connectors ?? configuredConnectors();\n\n  // First, and before the drift check: a name listed twice is registered once\n  // here but was drained twice by the build, and the two lists the drift check\n  // compares are identical in that case — so it would wave the array through\n  // and the asymmetry would survive into the boot. Reported as the duplicate it\n  // is, rather than as whatever the next check happens to make of it.\n  assertUniqueConnectorNames(registering);\n\n  // Then the names that were taken before this array was ever read. The skip\n  // below treats an already-held name as idempotency, which is right for a name\n  // an EARLIER CALL registered — the same array arriving twice in one process —\n  // and wrong for a built-in: nothing the app configured put that name there, so\n  // the skip would drop a connector the app asked for and the build already\n  // prepared artifacts for. Same call the build makes, so neither half can be\n  // reached with an array the other refuses.\n  assertNoReservedConnectorNames(registering);\n\n  // Before anything is registered: a half-registered manager is worse than a\n  // refused boot, because the phases would start on top of it.\n  if (options.expectedNames) {\n    assertNoConnectorDrift(options.expectedNames, registering);\n  }\n\n  for (const connector of registering) {\n    if (connectorsManager.has(connector.name)) continue;\n\n    connectorsManager.register(connector);\n  }\n}\n\n/**\n * Refuses a boot whose connector list is not the one the build was made from.\n *\n * `connectors` in warlock.config is a normal expression, so it may read the\n * environment — the build resolves it once, and the artifact re-evaluates the\n * same source at startup. Nothing forces the two results to agree, and when\n * they do not the failure is silent: the bundle carries what a connector\n * contributed at build time while the runtime never boots it, or boots one the\n * build never prepared for.\n *\n * Order counts as a difference. The build drains connector contributions\n * SEQUENTIALLY in config-array order — each one writing files and merging\n * esbuild options on top of what the previous ones left — so the same names in\n * another order describe an artifact produced by a drain sequence this build\n * never ran. Start order is NOT the reason: connectors start in PRIORITY order,\n * and the array's order only breaks ties between equal priorities.\n *\n * Names only — this compares WHICH connectors are present, never how any of\n * them is configured, so it cannot catch a connector pointed at the wrong\n * database. Saying so in the message is the point: a check that reads as\n * broader than it is buys false confidence.\n */\nfunction assertNoConnectorDrift(expectedNames: string[], connectors: Connector[]): void {\n  const actualNames = connectors.map((connector) => connector.name);\n\n  const matches =\n    expectedNames.length === actualNames.length &&\n    expectedNames.every((name, index) => name === actualNames[index]);\n\n  if (matches) return;\n\n  throw new Error(\n    \"The connector list this server booted with does not match the list its build was made from.\\n\" +\n      `  expected (resolved when the app was built): ${formatNames(expectedNames)}\\n` +\n      `  actual (handed over at boot): ${formatNames(actualNames)}\\n` +\n      \"This compares the set and order of connectors only, and says nothing about how any connector is configured. \" +\n      \"It usually means `connectors` in warlock.config resolves differently here than it did at build time — \" +\n      \"rebuild the app in the same configuration environment this server runs in, \" +\n      \"or make the array resolve to the same connectors in both.\",\n  );\n}\n\nfunction formatNames(names: string[]): string {\n  return `[${names.map((name) => JSON.stringify(name)).join(\", \")}]`;\n}\n\n/**\n * The connectors the resolved warlock config declares.\n *\n * Reached only when the caller omitted the array. An unloaded config here is\n * not \"nothing to register\" — it is a caller asking this function to read a\n * source that does not exist yet, so it throws instead of returning empty.\n * Returning empty is how the production entry once registered NOTHING while\n * reporting success: the bundle booted none of the connectors it was built\n * for, and no line of output said so.\n */\nfunction configuredConnectors(): Connector[] {\n  if (!warlockConfigManager.isLoaded) {\n    throw new Error(\n      \"registerConfiguredConnectors: warlock config is not loaded; pass the connectors array explicitly or load the config first\",\n    );\n  }\n\n  return warlockConfigManager.get(\"connectors\") ?? [];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,6BACd,YACA,UAA+C,CAAC,GAC1C;CACN,MAAM,cAAc,cAAc,qBAAqB;CAOvD,2BAA2B,WAAW;CAStC,+BAA+B,WAAW;CAI1C,IAAI,QAAQ,eACV,uBAAuB,QAAQ,eAAe,WAAW;CAG3D,KAAK,MAAM,aAAa,aAAa;EACnC,IAAI,kBAAkB,IAAI,UAAU,IAAI,GAAG;EAE3C,kBAAkB,SAAS,SAAS;CACtC;AACF;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAS,uBAAuB,eAAyB,YAA+B;CACtF,MAAM,cAAc,WAAW,KAAK,cAAc,UAAU,IAAI;CAMhE,IAHE,cAAc,WAAW,YAAY,UACrC,cAAc,OAAO,MAAM,UAAU,SAAS,YAAY,MAAM,GAErD;CAEb,MAAM,IAAI,MACR;gDACmD,YAAY,aAAa,EAAE,oCACzC,YAAY,WAAW,EAAE,2VAKhE;AACF;AAEA,SAAS,YAAY,OAAyB;CAC5C,OAAO,IAAI,MAAM,KAAK,SAAS,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;AAClE;;;;;;;;;;;AAYA,SAAS,uBAAoC;CAC3C,IAAI,CAAC,qBAAqB,UACxB,MAAM,IAAI,MACR,2HACF;CAGF,OAAO,qBAAqB,IAAI,YAAY,KAAK,CAAC;AACpD"}
+{"version":3,"file":"register-configured-connectors.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/connectors/register-configured-connectors.ts"],"sourcesContent":["/**\n * Registration half of the `connectors` config key.\n *\n * ONE key drives both halves of a connector's life: `warlock build` reads the\n * same array to drain each connector's build contribution, and this function\n * registers that array with the connectors manager so the runtime boots it.\n * Reading them from one place is the whole point — a bundle \"built for\" web\n * that \"boots without\" web is a green build with a missing client bundle, and\n * the failure is silent. A second key would let the two drift; this cannot.\n *\n * Two callers, two ways in:\n *\n * - The generated production entry PASSES the array explicitly. Inside a\n *   bundled artifact nothing ever loads `warlock.config.ts` — the build\n *   imports it statically so esbuild bakes it into the bundle, then hands the\n *   array straight here. No config manager, no runtime file read. It also\n *   passes `expectedNames` — the list the build resolved — so a config that\n *   resolves differently at startup is refused instead of booted.\n * - The dev preloader OMITS the array and lets this read the already-resolved\n *   warlock config, which dev has loaded by then. It also omits\n *   `expectedNames`, so dev gets NO drift check — deliberately. Drift is a\n *   relationship between what a build baked and what a runtime registers, and\n *   dev has no build: there is nothing to drift from, and inventing a second\n *   source of truth to compare against would create the disagreement this\n *   check exists to prevent. The absence of a check on this path is the\n *   design, not an omission — do not harmonise it with the production path.\n *   A conditional config that works in dev and is refused at production boot\n *   is this working as intended, not a gap.\n *\n * Idempotent either way: a connector whose name an EARLIER CALL in the same\n * process already registered is skipped rather than stacked, since a duplicate\n * would boot and shut down twice. A built-in's name is not that case — it is\n * reserved, and an array claiming one is refused rather than skipped.\n */\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\nimport { assertNoReservedConnectorNames } from \"./assert-no-reserved-connector-names\";\nimport { assertUniqueConnectorNames } from \"./assert-unique-connector-names\";\nimport { connectorsManager } from \"./connectors-manager\";\nimport type { Connector } from \"./types\";\n\nexport type RegisterConfiguredConnectorsOptions = {\n  /**\n   * The connector names, in order, that the build resolved. The generated\n   * production entry bakes this in; every other caller omits it.\n   */\n  expectedNames?: string[];\n};\n\nexport function registerConfiguredConnectors(\n  connectors?: Connector[],\n  options: RegisterConfiguredConnectorsOptions = {},\n): void {\n  const registering = connectors ?? configuredConnectors();\n\n  // First, and before the drift check: a name listed twice is registered once\n  // here but was drained twice by the build, and the two lists the drift check\n  // compares are identical in that case — so it would wave the array through\n  // and the asymmetry would survive into the boot. Reported as the duplicate it\n  // is, rather than as whatever the next check happens to make of it.\n  assertUniqueConnectorNames(registering);\n\n  // Then the names that were taken before this array was ever read. The skip\n  // below treats an already-held name as idempotency, which is right for a name\n  // an EARLIER CALL registered — the same array arriving twice in one process —\n  // and wrong for a built-in: nothing the app configured put that name there, so\n  // the skip would drop a connector the app asked for and the build already\n  // prepared artifacts for. Same call the build makes, so neither half can be\n  // reached with an array the other refuses.\n  assertNoReservedConnectorNames(registering);\n\n  // Before anything is registered: a half-registered manager is worse than a\n  // refused boot, because the phases would start on top of it.\n  if (options.expectedNames) {\n    assertNoConnectorDrift(options.expectedNames, registering);\n  }\n\n  for (const connector of registering) {\n    if (connectorsManager.has(connector.name)) continue;\n\n    connectorsManager.register(connector);\n  }\n}\n\n/**\n * Refuses a boot whose connector list is not the one the build was made from.\n *\n * `connectors` in warlock.config is a normal expression, so it may read the\n * environment — the build resolves it once, and the artifact re-evaluates the\n * same source at startup. Nothing forces the two results to agree, and when\n * they do not the failure is silent: the bundle carries what a connector\n * contributed at build time while the runtime never boots it, or boots one the\n * build never prepared for.\n *\n * Order counts as a difference. The build drains connector contributions\n * SEQUENTIALLY in config-array order — each one writing files and merging\n * esbuild options on top of what the previous ones left — so the same names in\n * another order describe an artifact produced by a drain sequence this build\n * never ran. Start order is NOT the reason: connectors start in PRIORITY order,\n * and the array's order only breaks ties between equal priorities.\n *\n * Names only — this compares WHICH connectors are present, never how any of\n * them is configured, so it cannot catch a connector pointed at the wrong\n * database. Saying so in the message is the point: a check that reads as\n * broader than it is buys false confidence.\n */\nfunction assertNoConnectorDrift(expectedNames: string[], connectors: Connector[]): void {\n  const actualNames = connectors.map((connector) => connector.name);\n\n  const matches =\n    expectedNames.length === actualNames.length &&\n    expectedNames.every((name, index) => name === actualNames[index]);\n\n  if (matches) return;\n\n  throw new Error(\n    \"The connector list this server booted with does not match the list its build was made from.\\n\" +\n      `  expected (resolved when the app was built): ${formatNames(expectedNames)}\\n` +\n      `  actual (handed over at boot): ${formatNames(actualNames)}\\n` +\n      \"This compares the set and order of connectors only, and says nothing about how any connector is configured. \" +\n      \"It usually means `connectors` in warlock.config resolves differently here than it did at build time — \" +\n      \"rebuild the app in the same configuration environment this server runs in, \" +\n      \"or make the array resolve to the same connectors in both.\",\n  );\n}\n\nfunction formatNames(names: string[]): string {\n  return `[${names.map((name) => JSON.stringify(name)).join(\", \")}]`;\n}\n\n/**\n * The connectors the resolved warlock config declares.\n *\n * Reached only when the caller omitted the array. An unloaded config here is\n * not \"nothing to register\" — it is a caller asking this function to read a\n * source that does not exist yet, so it throws instead of returning empty.\n * Returning empty is how the production entry once registered NOTHING while\n * reporting success: the bundle booted none of the connectors it was built\n * for, and no line of output said so.\n */\nfunction configuredConnectors(): Connector[] {\n  if (!warlockConfigManager.isLoaded) {\n    throw new Error(\n      \"registerConfiguredConnectors: warlock config is not loaded; pass the connectors array explicitly or load the config first\",\n    );\n  }\n\n  return warlockConfigManager.get(\"connectors\") ?? [];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,6BACd,YACA,UAA+C,CAAC,GAC1C;CACN,MAAM,cAAc,cAAc,qBAAqB;CAOvD,2BAA2B,WAAW;CAStC,+BAA+B,WAAW;CAI1C,IAAI,QAAQ,eACV,uBAAuB,QAAQ,eAAe,WAAW;CAG3D,KAAK,MAAM,aAAa,aAAa;EACnC,IAAI,kBAAkB,IAAI,UAAU,IAAI,GAAG;EAE3C,kBAAkB,SAAS,SAAS;CACtC;AACF;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAS,uBAAuB,eAAyB,YAA+B;CACtF,MAAM,cAAc,WAAW,KAAK,cAAc,UAAU,IAAI;CAMhE,IAHE,cAAc,WAAW,YAAY,UACrC,cAAc,OAAO,MAAM,UAAU,SAAS,YAAY,MAAM,GAErD;CAEb,MAAM,IAAI,MACR;gDACmD,YAAY,aAAa,EAAE,oCACzC,YAAY,WAAW,EAAE,2VAKhE;AACF;AAEA,SAAS,YAAY,OAAyB;CAC5C,OAAO,IAAI,MAAM,KAAK,SAAS,KAAK,UAAU,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE;AAClE;;;;;;;;;;;AAYA,SAAS,uBAAoC;CAC3C,IAAI,CAAC,qBAAqB,UACxB,MAAM,IAAI,MACR,2HACF;CAGF,OAAO,qBAAqB,IAAI,YAAY,KAAK,CAAC;AACpD"}

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

@@ -2,7 +2,7 @@ import { ConnectorLifecyclePhase, ConnectorName, ConnectorPriority } from "./typ
 import { BaseConnector } from "./base-connector.mjs";
 import { Server } from "socket.io";
 
-//#region ../core/src/connectors/socket-connector.d.ts
+//#region core/src/connectors/socket-connector.d.ts
 /**
  * Socket Connector
  * Manages Socket server (Socket.IO) lifecycle

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

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

package/esm/connectors/socket-connector.mjs

@@ -6,7 +6,7 @@ import { log } from "@warlock.js/logger";
 import { createServer } from "http";
 import { createServer as createServer$1 } from "https";
 
-//#region ../core/src/connectors/socket-connector.ts
+//#region core/src/connectors/socket-connector.ts
 /**
 * Shown when a project enables sockets (a `socket` config is present) but the
 * optional `socket.io` peer is not installed.

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

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

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

@@ -1,7 +1,7 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 
-//#region ../core/src/connectors/storage.connector.d.ts
+//#region core/src/connectors/storage.connector.d.ts
 /**
  * Cache Connector
  * Manages cache engine connection lifecycle

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

@@ -1 +1 @@
-{"version":3,"file":"storage.connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/storage.connector.ts"],"mappings":";;;;;;AASA;;cAAa,gBAAA,SAAyB,aAAA;EAAA,SACpB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,OAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAiCL;;;EAAA,mBA5BN,YAAA;EARiB;;;;;;;;;;;;;;AAoCJ;;EAVnB,KAAA,IAAS,OAAA;;;;EAUT,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"storage.connector.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/connectors/storage.connector.ts"],"mappings":";;;;;;AASA;;cAAa,gBAAA,SAAyB,aAAA;EAAA,SACpB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,OAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAiCL;;;EAAA,mBA5BN,YAAA;EARiB;;;;;;;;;;;;;;AAoCJ;;EAVnB,KAAA,CAAA,GAAS,OAAA;;;;EAUT,QAAA,CAAA,GAAY,OAAA;AAAA"}

package/esm/connectors/storage.connector.mjs

@@ -4,7 +4,7 @@ import "../storage/index.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
 
-//#region ../core/src/connectors/storage.connector.ts
+//#region core/src/connectors/storage.connector.ts
 /**
 * Cache Connector
 * Manages cache engine connection lifecycle

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

@@ -1 +1 @@
-{"version":3,"file":"storage.connector.mjs","names":[],"sources":["../../../../../../../core/src/connectors/storage.connector.ts"],"sourcesContent":["import { storage } from \"../storage\";\nimport { loadS3 } from \"../storage/drivers/cloud-driver\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class StorageConnector extends BaseConnector {\n  public readonly name = \"storage\";\n  public readonly priority = ConnectorPriority.STORAGE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/storage.ts\", \"src/config/storage.tsx\"];\n\n  /**\n   * Initialize storage.\n   *\n   * Unlike its siblings (database, cache, herald), this connector does NOT\n   * early-return when `config.get(\"storage\")` is absent. Storage is\n   * intentionally always-on: `storage.init()` registers a built-in `local`\n   * driver rooted at `uploadsPath()` before reading configured drivers, so file\n   * storage works out of the box even when a project ships no\n   * `src/config/storage.ts`. A config-presence guard here would break that.\n   *\n   * That fallback is real as of 4.11.0. Until then this comment described it\n   * and nothing implemented it, so every app without `src/config/storage.ts`\n   * died at boot with `Storage driver \"local\" is not configured` — a decision\n   * to skip the guard, taken on the authority of behaviour nobody had written.\n   * See `Storage.registerBuiltInLocalDriver`.\n   */\n  public async start(): Promise<void> {\n    await loadS3();\n    await storage.init();\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    storage.reset();\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;AASA,IAAa,mBAAb,cAAsC,cAAc;;;cAC3B;;;sBAOW,CAAC,yBAAyB,wBAAwB;;;;;;;;;;;;;;;;;;CAkBpF,MAAa,QAAuB;EAClC,MAAM,OAAO;EACb,MAAM,QAAQ,KAAK;EAEnB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,QAAQ,MAAM;EAEd,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"storage.connector.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/connectors/storage.connector.ts"],"sourcesContent":["import { storage } from \"../storage\";\nimport { loadS3 } from \"../storage/drivers/cloud-driver\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class StorageConnector extends BaseConnector {\n  public readonly name = \"storage\";\n  public readonly priority = ConnectorPriority.STORAGE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/storage.ts\", \"src/config/storage.tsx\"];\n\n  /**\n   * Initialize storage.\n   *\n   * Unlike its siblings (database, cache, herald), this connector does NOT\n   * early-return when `config.get(\"storage\")` is absent. Storage is\n   * intentionally always-on: `storage.init()` registers a built-in `local`\n   * driver rooted at `uploadsPath()` before reading configured drivers, so file\n   * storage works out of the box even when a project ships no\n   * `src/config/storage.ts`. A config-presence guard here would break that.\n   *\n   * That fallback is real as of 4.11.0. Until then this comment described it\n   * and nothing implemented it, so every app without `src/config/storage.ts`\n   * died at boot with `Storage driver \"local\" is not configured` — a decision\n   * to skip the guard, taken on the authority of behaviour nobody had written.\n   * See `Storage.registerBuiltInLocalDriver`.\n   */\n  public async start(): Promise<void> {\n    await loadS3();\n    await storage.init();\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    storage.reset();\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;AASA,IAAa,mBAAb,cAAsC,cAAc;;;cAC3B;;;sBAOW,CAAC,yBAAyB,wBAAwB;;;;;;;;;;;;;;;;;;CAkBpF,MAAa,QAAuB;EAClC,MAAM,OAAO;EACb,MAAM,QAAQ,KAAK;EAEnB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,QAAQ,MAAM;EAEd,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/types.d.mts

@@ -1,7 +1,7 @@
 import { ResolvedBuildConfig } from "../production/resolve-build-config.mjs";
 import { BuildOptions } from "esbuild";
 
-//#region ../core/src/connectors/types.d.ts
+//#region core/src/connectors/types.d.ts
 /**
  * Connector Interface
  * All service connectors (Database, HTTP, Cache, etc.) must implement this interface

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/types.ts"],"mappings":";;;;;;AAOA;;UAAiB,SAAA;EAIA;;;EAAA,SAAN,IAAA,EAAM,aAAA;EAmCJ;;;;EAAA,SA7BF,QAAA;EANA;;;;EAAA,SAYA,cAAA,EAAgB,uBAAA;EAKzB;;;EAAA,QAAA;EAYS;;;;EANT,IAAA,WAAe,OAAA;EAyBf;;;;EAnBA,KAAA,IAAS,OAAA;EA8BkC;AAO7C;;;EA/BE,OAAA,IAAW,OAAA;EAiCX;;;;EA3BA,QAAA,IAAY,OAAA;EA+BgB;AAa9B;;;;EArCE,aAAA,CAAc,YAAA;EA6CJ;;;;;;;;AAUqB;EAVrB,SAlCD,KAAA,GAAQ,0BAAA;AAAA;;;;;KAOP,qBAAA;EAqEK,uEAnEf,aAAA,UAmE8C;EAjE9C,OAAA,UAwDA;EAtDA,OAAA,EAAS,mBAAmB;AAAA;;;;;;;;;AA+DkB;AAGhD;KArDY,qBAAA,GAAwB,IAAI,CACtC,YAAA;;;AAoDuB;KA7Cb,4BAAA;EAoEuB;;;AAE7B;AAMN;;;EApEE,YAAA,aAqEA;EAnEA,OAAA,GAAU,qBAAqB;AAAA;;;;;;;;;;AA6E7B;;;;;KA5DQ,0BAAA;;;;;;EAMV,QAAA,EACE,OAAA,EAAS,qBAAA,GACR,OAAA,CAAQ,4BAAA,WAAuC,4BAAA;;;;;;EAOlD,IAAA,EAAM,OAAA,EAAS,qBAAA,GAAwB,OAAA;AAAA;AAAA,KAG7B,aAAA;;;;;;;;;;aAuBA,uBAAA;EACV,KAAA;EACA,IAAI;AAAA;;;;aAMM,iBAAA;EACV,MAAA;EACA,MAAA;EACA,QAAA;EACA,YAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;EACA,aAAA;EACA,MAAA;EACA,EAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/connectors/types.ts"],"mappings":";;;;;;AAOA;;UAAiB,SAAA;EAIA;;;EAAA,SAAN,IAAA,EAAM,aAAA;EAmCJ;;;;EAAA,SA7BF,QAAA;EANA;;;;EAAA,SAYA,cAAA,EAAgB,uBAAA;EAKzB;;;EAAA,QAAA;EAYS;;;;EANT,IAAA,WAAe,OAAA;EAyBf;;;;EAnBA,KAAA,IAAS,OAAA;EA8BkC;AAO7C;;;EA/BE,OAAA,IAAW,OAAA;EAiCX;;;;EA3BA,QAAA,IAAY,OAAA;EA+BgB;AAa9B;;;;EArCE,aAAA,CAAc,YAAA;EA6CJ;;;;;;;;AAUqB;EAVrB,SAlCD,KAAA,GAAQ,0BAAA;AAAA;;;;;KAOP,qBAAA;EAqEK,uEAnEf,aAAA,UAmE8C;EAjE9C,OAAA,UAwDA;EAtDA,OAAA,EAAS,mBAAmB;AAAA;;;;;;;;;AA+DkB;AAGhD;KArDY,qBAAA,GAAwB,IAAI,CACtC,YAAA;;;AAoDuB;KA7Cb,4BAAA;EAoEuB;;;AAE7B;AAMN;;;EApEE,YAAA,aAqEA;EAnEA,OAAA,GAAU,qBAAqB;AAAA;;;;;;;;;;AA6E7B;;;;;KA5DQ,0BAAA;;;;;;EAMV,QAAA,EACE,OAAA,EAAS,qBAAA,GACR,OAAA,CAAQ,4BAAA,WAAuC,4BAAA;;;;;;EAOlD,IAAA,EAAM,OAAA,EAAS,qBAAA,GAAwB,OAAA;AAAA;AAAA,KAG7B,aAAA;;;;;;;;;;aAuBA,uBAAA;EACV,KAAA;EACA,IAAI;AAAA;;;;aAMM,iBAAA;EACV,MAAA;EACA,MAAA;EACA,QAAA;EACA,YAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;EACA,aAAA;EACA,MAAA;EACA,EAAA;AAAA"}

package/esm/connectors/types.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/connectors/types.ts
+//#region core/src/connectors/types.ts
 /**
 * When a connector boots relative to user code (main, routes, events).
 *

package/esm/connectors/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../core/src/connectors/types.ts"],"sourcesContent":["import type { BuildOptions } from \"esbuild\";\nimport type { ResolvedBuildConfig } from \"../production/resolve-build-config\";\n\n/**\n * Connector Interface\n * All service connectors (Database, HTTP, Cache, etc.) must implement this interface\n */\nexport interface Connector {\n  /**\n   * Unique name of the connector\n   */\n  readonly name: ConnectorName;\n\n  /**\n   * Priority for initialization order\n   * Lower numbers initialize first (e.g., Database: 1, HTTP: 3)\n   */\n  readonly priority: number;\n\n  /**\n   * Phase the connector boots in, relative to user code.\n   * See `ConnectorLifecyclePhase` for semantics.\n   */\n  readonly lifecyclePhase: ConnectorLifecyclePhase;\n\n  /**\n   * Whether the connector is currently active/connected\n   */\n  isActive(): boolean;\n\n  /**\n   * Boot the connector\n   * Called during server startup before starting the connector\n   */\n  boot(): void | Promise<void>;\n\n  /**\n   * Initialize the connector\n   * Called during server startup\n   */\n  start(): Promise<void>;\n\n  /**\n   * Restart the connector\n   * Called when watched files change\n   */\n  restart(): Promise<void>;\n\n  /**\n   * Gracefully shutdown the connector\n   * Called during server shutdown\n   */\n  shutdown(): Promise<void>;\n\n  /**\n   * Determine if this connector needs restart based on changed files\n   * @param changedFiles Array of relative file paths that changed\n   * @returns true if connector should restart\n   */\n  shouldRestart(changedFiles: string[]): boolean;\n\n  /**\n   * What this connector contributes to `warlock build`.\n   *\n   * Read STATICALLY from `warlock.config.ts > connectors` — `warlock build`\n   * never calls `boot()`/`start()`, so nothing here may assume a running\n   * connector. The same `connectors` key drives both halves of a connector's\n   * life — build-time contribution and runtime boot; see\n   * {@link ConnectorBuildContribution}.\n   */\n  readonly build?: ConnectorBuildContribution;\n}\n\n/**\n * What a build contribution is handed. Everything it needs to write files\n * and shape the bundle, and nothing that would let it reach the runtime.\n */\nexport type ConnectorBuildContext = {\n  /** Absolute path to `.warlock/production` — deleted after the build */\n  productionDir: string;\n  /** Absolute path to the application root (where `package.json` lives) */\n  appRoot: string;\n  /** The build config after framework defaults and user overrides */\n  options: ResolvedBuildConfig;\n};\n\n/**\n * The esbuild options a contributor may patch.\n *\n * Deliberately a narrow `Pick`, not `Partial<BuildOptions>`: `entryPoints`,\n * `tsconfig` and `tsconfigRaw` stay forbidden here for the same reason they\n * are forbidden in the user's `build` block — they re-compile every file in\n * the bundle, workspace packages included (see `ForbiddenBuildOptionError`).\n * A contributor reaching them would reintroduce the failure the user-level\n * guard exists to prevent.\n */\nexport type ConnectorEsbuildPatch = Pick<\n  BuildOptions,\n  \"jsx\" | \"jsxImportSource\" | \"define\" | \"external\" | \"loader\"\n>;\n\n/**\n * What `generate` may hand back to the builder.\n */\nexport type ConnectorBuildGenerateResult = {\n  /**\n   * Lines appended verbatim to section 4 of the generated entry, AFTER the\n   * `./routes` import — page registration must see the routes app code\n   * collected, mirroring dev's ordering.\n   *\n   * @example ['await import(\"./pages\");']\n   */\n  entryImports?: string[];\n  /** Merged into the esbuild call: defaults < this patch < user `build` */\n  esbuild?: ConnectorEsbuildPatch;\n};\n\n/**\n * A connector's build-time half: two hooks, both awaited, drained in\n * `connectors` array order. A hook that throws fails the build.\n *\n * **This type is closed on purpose**: exactly these two optional function properties and ZERO data-bearing\n * fields. There is deliberately no property where a Vite/babel plugin\n * instance, an alias map or a compiled pipeline could live, so\n * `build: { plugins: [...] }` is a type error rather than something a\n * reviewer has to catch. Anything heavy must be constructed INSIDE a hook,\n * after that hook dynamically imports it — that is what keeps a connector's\n * static import graph out of the runtime closure. The drain mirrors this at\n * read time by rejecting unknown enumerable keys (`assertClosedContribution`):\n * the type narrows, the runtime asserts.\n */\nexport type ConnectorBuildContribution = {\n  /**\n   * Write files into `ctx.productionDir` and/or patch the bundle.\n   *\n   * Runs after the generated-imports check and before esbuild bundles.\n   */\n  generate?(\n    context: ConnectorBuildContext,\n  ): Promise<ConnectorBuildGenerateResult | void> | ConnectorBuildGenerateResult | void;\n\n  /**\n   * Produce artifacts esbuild does not — e.g. a client bundle.\n   *\n   * Runs after esbuild and before `.warlock/production` is removed.\n   */\n  emit?(context: ConnectorBuildContext): Promise<void> | void;\n};\n\nexport type ConnectorName =\n  | \"logger\"\n  | \"mailer\"\n  | \"http\"\n  | \"database\"\n  | \"cache\"\n  | \"storage\"\n  | \"herald\"\n  | \"socket\"\n  | \"notifications\"\n  | \"access\"\n  | \"ai\"\n  | (string & {});\n\n/**\n * When a connector boots relative to user code (main, routes, events).\n *\n * - `Early`: before user code is imported. For services user code\n *   needs at import time (database, cache, logger, storage, mailer).\n * - `Late`: after user code is imported. For services that bind to\n *   things user code registered (http scans the router; socket\n *   depends on http's instance).\n */\nexport enum ConnectorLifecyclePhase {\n  Early = \"early\",\n  Late = \"late\",\n}\n\n/**\n * Connector priority constants\n */\nexport enum ConnectorPriority {\n  LOGGER = 0,\n  MAILER = 1,\n  DATABASE = 2,\n  COMMUNICATOR = 3,\n  CACHE = 4,\n  HTTP = 5,\n  STORAGE = 6,\n  SOCKET = 7,\n  NOTIFICATIONS = 8,\n  ACCESS = 9,\n  AI = 10,\n}\n"],"mappings":";;;;;;;;;;AA4KA,IAAY,0BAAL;CACL;CACA;;AACF;;;;AAKA,IAAY,oBAAL;CACL;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AACF"}
+{"version":3,"file":"types.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/connectors/types.ts"],"sourcesContent":["import type { BuildOptions } from \"esbuild\";\nimport type { ResolvedBuildConfig } from \"../production/resolve-build-config\";\n\n/**\n * Connector Interface\n * All service connectors (Database, HTTP, Cache, etc.) must implement this interface\n */\nexport interface Connector {\n  /**\n   * Unique name of the connector\n   */\n  readonly name: ConnectorName;\n\n  /**\n   * Priority for initialization order\n   * Lower numbers initialize first (e.g., Database: 1, HTTP: 3)\n   */\n  readonly priority: number;\n\n  /**\n   * Phase the connector boots in, relative to user code.\n   * See `ConnectorLifecyclePhase` for semantics.\n   */\n  readonly lifecyclePhase: ConnectorLifecyclePhase;\n\n  /**\n   * Whether the connector is currently active/connected\n   */\n  isActive(): boolean;\n\n  /**\n   * Boot the connector\n   * Called during server startup before starting the connector\n   */\n  boot(): void | Promise<void>;\n\n  /**\n   * Initialize the connector\n   * Called during server startup\n   */\n  start(): Promise<void>;\n\n  /**\n   * Restart the connector\n   * Called when watched files change\n   */\n  restart(): Promise<void>;\n\n  /**\n   * Gracefully shutdown the connector\n   * Called during server shutdown\n   */\n  shutdown(): Promise<void>;\n\n  /**\n   * Determine if this connector needs restart based on changed files\n   * @param changedFiles Array of relative file paths that changed\n   * @returns true if connector should restart\n   */\n  shouldRestart(changedFiles: string[]): boolean;\n\n  /**\n   * What this connector contributes to `warlock build`.\n   *\n   * Read STATICALLY from `warlock.config.ts > connectors` — `warlock build`\n   * never calls `boot()`/`start()`, so nothing here may assume a running\n   * connector. The same `connectors` key drives both halves of a connector's\n   * life — build-time contribution and runtime boot; see\n   * {@link ConnectorBuildContribution}.\n   */\n  readonly build?: ConnectorBuildContribution;\n}\n\n/**\n * What a build contribution is handed. Everything it needs to write files\n * and shape the bundle, and nothing that would let it reach the runtime.\n */\nexport type ConnectorBuildContext = {\n  /** Absolute path to `.warlock/production` — deleted after the build */\n  productionDir: string;\n  /** Absolute path to the application root (where `package.json` lives) */\n  appRoot: string;\n  /** The build config after framework defaults and user overrides */\n  options: ResolvedBuildConfig;\n};\n\n/**\n * The esbuild options a contributor may patch.\n *\n * Deliberately a narrow `Pick`, not `Partial<BuildOptions>`: `entryPoints`,\n * `tsconfig` and `tsconfigRaw` stay forbidden here for the same reason they\n * are forbidden in the user's `build` block — they re-compile every file in\n * the bundle, workspace packages included (see `ForbiddenBuildOptionError`).\n * A contributor reaching them would reintroduce the failure the user-level\n * guard exists to prevent.\n */\nexport type ConnectorEsbuildPatch = Pick<\n  BuildOptions,\n  \"jsx\" | \"jsxImportSource\" | \"define\" | \"external\" | \"loader\"\n>;\n\n/**\n * What `generate` may hand back to the builder.\n */\nexport type ConnectorBuildGenerateResult = {\n  /**\n   * Lines appended verbatim to section 4 of the generated entry, AFTER the\n   * `./routes` import — page registration must see the routes app code\n   * collected, mirroring dev's ordering.\n   *\n   * @example ['await import(\"./pages\");']\n   */\n  entryImports?: string[];\n  /** Merged into the esbuild call: defaults < this patch < user `build` */\n  esbuild?: ConnectorEsbuildPatch;\n};\n\n/**\n * A connector's build-time half: two hooks, both awaited, drained in\n * `connectors` array order. A hook that throws fails the build.\n *\n * **This type is closed on purpose**: exactly these two optional function properties and ZERO data-bearing\n * fields. There is deliberately no property where a Vite/babel plugin\n * instance, an alias map or a compiled pipeline could live, so\n * `build: { plugins: [...] }` is a type error rather than something a\n * reviewer has to catch. Anything heavy must be constructed INSIDE a hook,\n * after that hook dynamically imports it — that is what keeps a connector's\n * static import graph out of the runtime closure. The drain mirrors this at\n * read time by rejecting unknown enumerable keys (`assertClosedContribution`):\n * the type narrows, the runtime asserts.\n */\nexport type ConnectorBuildContribution = {\n  /**\n   * Write files into `ctx.productionDir` and/or patch the bundle.\n   *\n   * Runs after the generated-imports check and before esbuild bundles.\n   */\n  generate?(\n    context: ConnectorBuildContext,\n  ): Promise<ConnectorBuildGenerateResult | void> | ConnectorBuildGenerateResult | void;\n\n  /**\n   * Produce artifacts esbuild does not — e.g. a client bundle.\n   *\n   * Runs after esbuild and before `.warlock/production` is removed.\n   */\n  emit?(context: ConnectorBuildContext): Promise<void> | void;\n};\n\nexport type ConnectorName =\n  | \"logger\"\n  | \"mailer\"\n  | \"http\"\n  | \"database\"\n  | \"cache\"\n  | \"storage\"\n  | \"herald\"\n  | \"socket\"\n  | \"notifications\"\n  | \"access\"\n  | \"ai\"\n  | (string & {});\n\n/**\n * When a connector boots relative to user code (main, routes, events).\n *\n * - `Early`: before user code is imported. For services user code\n *   needs at import time (database, cache, logger, storage, mailer).\n * - `Late`: after user code is imported. For services that bind to\n *   things user code registered (http scans the router; socket\n *   depends on http's instance).\n */\nexport enum ConnectorLifecyclePhase {\n  Early = \"early\",\n  Late = \"late\",\n}\n\n/**\n * Connector priority constants\n */\nexport enum ConnectorPriority {\n  LOGGER = 0,\n  MAILER = 1,\n  DATABASE = 2,\n  COMMUNICATOR = 3,\n  CACHE = 4,\n  HTTP = 5,\n  STORAGE = 6,\n  SOCKET = 7,\n  NOTIFICATIONS = 8,\n  ACCESS = 9,\n  AI = 10,\n}\n"],"mappings":";;;;;;;;;;AA4KA,IAAY,0BAAL;CACL;CACA;;AACF;;;;AAKA,IAAY,oBAAL;CACL;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AACF"}

package/esm/container/index.d.mts

@@ -3,7 +3,7 @@ import { DataSource } from "@warlock.js/cascade";
 import { FastifyInstance } from "fastify";
 import { Server } from "socket.io";
 
-//#region ../core/src/container/index.d.ts
+//#region core/src/container/index.d.ts
 /**
  * Known container types for better IDE support
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../core/src/container/index.ts"],"mappings":";;;;;;;;;KAUY,cAAA;EACV,MAAA,EAAQ,MAAA;EACR,aAAA,EAAe,eAAA;EACf,cAAA;EACA,MAAA,EAAQ,MAAA;EACR,iBAAA,EAAmB,UAAA;AAAA;AAAA,KAGhB,aAAA,SAAsB,cAAc;AAAA,cAEnC,SAAA;EATJ;;;EAaO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,EAAG,KAAA,EAAO,cAAA,CAAe,CAAA;EAClE,GAAA,UAAa,GAAA,UAAa,KAAA,EAAO,CAAA;EAXxC;;;EAmBO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC5D,GAAA,UAAa,GAAA,WAAc,CAAA;EAnBL;AAC7B;;EA0BO,GAAA,CAAI,GAAA,EAAK,aAAA;EAxBuB;AAAA;AAAA;EA+BhC,MAAA,CAAO,GAAA;AAAA;AAAA,cAKH,SAAA,EAAS,SAAkB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/container/index.ts"],"mappings":";;;;;;;;;KAUY,cAAA;EACV,MAAA,EAAQ,MAAA;EACR,aAAA,EAAe,eAAA;EACf,cAAA;EACA,MAAA,EAAQ,MAAA;EACR,iBAAA,EAAmB,UAAA;AAAA;AAAA,KAGhB,aAAA,SAAsB,cAAc;AAAA,cAEnC,SAAA;EATJ;;;EAaO,GAAA,iBAAoB,cAAA,CAAA,CAAgB,GAAA,EAAK,CAAA,EAAG,KAAA,EAAO,cAAA,CAAe,CAAA;EAClE,GAAA,SAAA,CAAa,GAAA,UAAa,KAAA,EAAO,CAAA;EAXxC;;;EAmBO,GAAA,iBAAoB,cAAA,CAAA,CAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC5D,GAAA,SAAA,CAAa,GAAA,WAAc,CAAA;EAnBL;AAC7B;;EA0BO,GAAA,CAAI,GAAA,EAAK,aAAA;EAxBuB;AAAA;AAAA;EA+BhC,MAAA,CAAO,GAAA;AAAA;AAAA,cAKH,SAAA,EAAS,SAAkB"}

package/esm/container/index.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/container/index.ts
+//#region core/src/container/index.ts
 const containerMap = /* @__PURE__ */ new Map();
 var Container = class {
 	set(key, value) {

package/esm/container/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../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 { type Router } from \"../router\";\n\nconst containerMap: Map<string, any> = new Map();\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};\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\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    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   * 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":";AAKA,MAAM,+BAAiC,IAAI,IAAI;AAe/C,IAAM,YAAN,MAAgB;CAMd,AAAO,IAAI,KAAU,OAAY;EAC/B,aAAa,IAAI,KAAK,KAAK;CAC7B;CAOA,AAAO,IAAI,KAAe;EACxB,OAAO,aAAa,IAAI,GAAG;CAC7B;;;;CAKA,AAAO,IAAI,KAAoB;EAC7B,OAAO,aAAa,IAAI,GAAG;CAC7B;;;;CAKA,AAAO,OAAO,KAAa;EACzB,aAAa,OAAO,GAAG;CACzB;AACF;AAEA,MAAa,YAAY,IAAI,UAAU"}
+{"version":3,"file":"index.mjs","names":[],"sources":["C:/Work/Warlock.js/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 { type Router } from \"../router\";\n\nconst containerMap: Map<string, any> = new Map();\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};\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\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    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   * 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":";AAKA,MAAM,+BAAiC,IAAI,IAAI;AAe/C,IAAM,YAAN,MAAgB;CAMd,AAAO,IAAI,KAAU,OAAY;EAC/B,aAAa,IAAI,KAAK,KAAK;CAC7B;CAOA,AAAO,IAAI,KAAe;EACxB,OAAO,aAAa,IAAI,GAAG;CAC7B;;;;CAKA,AAAO,IAAI,KAAoB;EAC7B,OAAO,aAAa,IAAI,GAAG;CAC7B;;;;CAKA,AAAO,OAAO,KAAa;EACzB,aAAa,OAAO,GAAG;CACzB;AACF;AAEA,MAAa,YAAY,IAAI,UAAU"}

package/esm/database/create-database-action.mjs

@@ -4,7 +4,7 @@ import { createDatabase } from "@warlock.js/cascade";
 import { log } from "@warlock.js/logger";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/database/create-database-action.ts
+//#region core/src/database/create-database-action.ts
 async function createDatabaseAction(command) {
 	const name = command.args[0];
 	const { connection = "default" } = command.options;

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

@@ -1 +1 @@
-{"version":3,"file":"create-database-action.mjs","names":[],"sources":["../../../../../../../core/src/database/create-database-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { createDatabase } from \"@warlock.js/cascade\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { CommandActionData } from \"../commands/types\";\r\nimport { config } from \"../config\";\r\n\r\nexport async function createDatabaseAction(command: CommandActionData) {\r\n  const name = command.args[0];\r\n  const { connection = \"default\" } = command.options;\r\n\r\n  const connectionName =\r\n    connection === \"default\" || connection === true ? undefined : String(connection);\r\n\r\n  let databaseName = name;\r\n\r\n  if (!databaseName) {\r\n    if (connection === \"default\") {\r\n      databaseName = config.get(\"database\")?.database;\r\n    }\r\n  }\r\n\r\n  if (!databaseName) {\r\n    log.error(\r\n      \"database\",\r\n      \"create\",\r\n      \"Database name is required. Please provide a name or configure it in the database config.\",\r\n    );\r\n    return;\r\n  }\r\n\r\n  log.info(\"database\", \"create\", `Creating database ${colors.cyan(databaseName)}...`);\r\n\r\n  try {\r\n    const { created } = await createDatabase(databaseName, { connection: connectionName });\r\n\r\n    if (created) {\r\n      log.success(\r\n        \"database\",\r\n        \"create\",\r\n        `Database ${colors.green(databaseName)} created successfully.`,\r\n      );\r\n    } else {\r\n      log.warn(\"database\", \"create\", `Database ${colors.yellow(databaseName)} already exists.`);\r\n    }\r\n  } catch (error: any) {\r\n    log.error(\r\n      \"database\",\r\n      \"create\",\r\n      `Failed to create database ${colors.red(databaseName)}: ${error.message}`,\r\n    );\r\n  }\r\n}\r\n"],"mappings":";;;;;;;AAMA,eAAsB,qBAAqB,SAA4B;CACrE,MAAM,OAAO,QAAQ,KAAK;CAC1B,MAAM,EAAE,aAAa,cAAc,QAAQ;CAE3C,MAAM,iBACJ,eAAe,aAAa,eAAe,OAAO,SAAY,OAAO,UAAU;CAEjF,IAAI,eAAe;CAEnB,IAAI,CAAC,cACH;MAAI,eAAe,WACjB,eAAe,OAAO,IAAI,UAAU,CAAC,EAAE;CACzC;CAGF,IAAI,CAAC,cAAc;EACjB,IAAI,MACF,YACA,UACA,0FACF;EACA;CACF;CAEA,IAAI,KAAK,YAAY,UAAU,qBAAqB,OAAO,KAAK,YAAY,EAAE,IAAI;CAElF,IAAI;EACF,MAAM,EAAE,YAAY,MAAM,eAAe,cAAc,EAAE,YAAY,eAAe,CAAC;EAErF,IAAI,SACF,IAAI,QACF,YACA,UACA,YAAY,OAAO,MAAM,YAAY,EAAE,uBACzC;OAEA,IAAI,KAAK,YAAY,UAAU,YAAY,OAAO,OAAO,YAAY,EAAE,iBAAiB;CAE5F,SAAS,OAAY;EACnB,IAAI,MACF,YACA,UACA,6BAA6B,OAAO,IAAI,YAAY,EAAE,IAAI,MAAM,SAClE;CACF;AACF"}
+{"version":3,"file":"create-database-action.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/database/create-database-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { createDatabase } from \"@warlock.js/cascade\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { CommandActionData } from \"../commands/types\";\r\nimport { config } from \"../config\";\r\n\r\nexport async function createDatabaseAction(command: CommandActionData) {\r\n  const name = command.args[0];\r\n  const { connection = \"default\" } = command.options;\r\n\r\n  const connectionName =\r\n    connection === \"default\" || connection === true ? undefined : String(connection);\r\n\r\n  let databaseName = name;\r\n\r\n  if (!databaseName) {\r\n    if (connection === \"default\") {\r\n      databaseName = config.get(\"database\")?.database;\r\n    }\r\n  }\r\n\r\n  if (!databaseName) {\r\n    log.error(\r\n      \"database\",\r\n      \"create\",\r\n      \"Database name is required. Please provide a name or configure it in the database config.\",\r\n    );\r\n    return;\r\n  }\r\n\r\n  log.info(\"database\", \"create\", `Creating database ${colors.cyan(databaseName)}...`);\r\n\r\n  try {\r\n    const { created } = await createDatabase(databaseName, { connection: connectionName });\r\n\r\n    if (created) {\r\n      log.success(\r\n        \"database\",\r\n        \"create\",\r\n        `Database ${colors.green(databaseName)} created successfully.`,\r\n      );\r\n    } else {\r\n      log.warn(\"database\", \"create\", `Database ${colors.yellow(databaseName)} already exists.`);\r\n    }\r\n  } catch (error: any) {\r\n    log.error(\r\n      \"database\",\r\n      \"create\",\r\n      `Failed to create database ${colors.red(databaseName)}: ${error.message}`,\r\n    );\r\n  }\r\n}\r\n"],"mappings":";;;;;;;AAMA,eAAsB,qBAAqB,SAA4B;CACrE,MAAM,OAAO,QAAQ,KAAK;CAC1B,MAAM,EAAE,aAAa,cAAc,QAAQ;CAE3C,MAAM,iBACJ,eAAe,aAAa,eAAe,OAAO,SAAY,OAAO,UAAU;CAEjF,IAAI,eAAe;CAEnB,IAAI,CAAC,cACH;MAAI,eAAe,WACjB,eAAe,OAAO,IAAI,UAAU,GAAG;CACzC;CAGF,IAAI,CAAC,cAAc;EACjB,IAAI,MACF,YACA,UACA,0FACF;EACA;CACF;CAEA,IAAI,KAAK,YAAY,UAAU,qBAAqB,OAAO,KAAK,YAAY,EAAE,IAAI;CAElF,IAAI;EACF,MAAM,EAAE,YAAY,MAAM,eAAe,cAAc,EAAE,YAAY,eAAe,CAAC;EAErF,IAAI,SACF,IAAI,QACF,YACA,UACA,YAAY,OAAO,MAAM,YAAY,EAAE,uBACzC;OAEA,IAAI,KAAK,YAAY,UAAU,YAAY,OAAO,OAAO,YAAY,EAAE,iBAAiB;CAE5F,SAAS,OAAY;EACnB,IAAI,MACF,YACA,UACA,6BAA6B,OAAO,IAAI,YAAY,EAAE,IAAI,MAAM,SAClE;CACF;AACF"}

package/esm/database/drop-tables-action.mjs

@@ -3,7 +3,7 @@ import { dataSourceRegistry, dropAllTables } from "@warlock.js/cascade";
 import { log } from "@warlock.js/logger";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/database/drop-tables-action.ts
+//#region core/src/database/drop-tables-action.ts
 async function dropTablesAction(command) {
 	const { force } = command.options;
 	if (force) {

package/esm/database/drop-tables-action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"drop-tables-action.mjs","names":[],"sources":["../../../../../../../core/src/database/drop-tables-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { dataSourceRegistry, dropAllTables } from \"@warlock.js/cascade\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { confirm } from \"../cli/commands/generate/utils/prompt\";\r\nimport { CommandActionData } from \"../commands/types\";\r\n\r\nexport async function dropTablesAction(command: CommandActionData) {\r\n  const { force } = command.options;\r\n\r\n  if (force) {\r\n    const { dropped } = await dropAllTables();\r\n    log.success(\r\n      \"database\",\r\n      \"drop\",\r\n      `Dropped ${colors.yellowBright(dropped)} tables successfully.`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  // Preview phase — we keep direct driver access so we can show per-table\r\n  // row counts before asking for confirmation. The actual drop still goes\r\n  // through the Cascade Operations API.\r\n  const driver = dataSourceRegistry.get().driver;\r\n  const tables = await driver.blueprint.listTables();\r\n\r\n  if (tables.length === 0) {\r\n    log.warn(\"database\", \"drop\", \"No tables found in the database.\");\r\n    return;\r\n  }\r\n\r\n  log.info(\"database\", \"drop\", `Found ${colors.yellowBright(tables.length)} tables:`);\r\n\r\n  for (const table of tables) {\r\n    const count = await driver.queryBuilder(table).count();\r\n    console.log(`  - ${colors.cyan(table)}: ${colors.green(count)} rows`);\r\n  }\r\n\r\n  const confirmed = await confirm(\r\n    `Are you sure you want to drop all ${colors.red(tables.length)} tables?`,\r\n  );\r\n\r\n  if (!confirmed) {\r\n    log.info(\"database\", \"drop\", \"Operation cancelled.\");\r\n    return;\r\n  }\r\n\r\n  const { dropped } = await dropAllTables();\r\n\r\n  log.success(\r\n    \"database\",\r\n    \"drop\",\r\n    `Dropped ${colors.yellowBright(dropped)} tables successfully.`,\r\n  );\r\n}\r\n"],"mappings":";;;;;;AAMA,eAAsB,iBAAiB,SAA4B;CACjE,MAAM,EAAE,UAAU,QAAQ;CAE1B,IAAI,OAAO;EACT,MAAM,EAAE,YAAY,MAAM,cAAc;EACxC,IAAI,QACF,YACA,QACA,WAAW,OAAO,aAAa,OAAO,EAAE,sBAC1C;EACA;CACF;CAKA,MAAM,SAAS,mBAAmB,IAAI,CAAC,CAAC;CACxC,MAAM,SAAS,MAAM,OAAO,UAAU,WAAW;CAEjD,IAAI,OAAO,WAAW,GAAG;EACvB,IAAI,KAAK,YAAY,QAAQ,kCAAkC;EAC/D;CACF;CAEA,IAAI,KAAK,YAAY,QAAQ,SAAS,OAAO,aAAa,OAAO,MAAM,EAAE,SAAS;CAElF,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,QAAQ,MAAM,OAAO,aAAa,KAAK,CAAC,CAAC,MAAM;EACrD,QAAQ,IAAI,OAAO,OAAO,KAAK,KAAK,EAAE,IAAI,OAAO,MAAM,KAAK,EAAE,MAAM;CACtE;CAMA,IAAI,CAAC,MAJmB,QACtB,qCAAqC,OAAO,IAAI,OAAO,MAAM,EAAE,SACjE,GAEgB;EACd,IAAI,KAAK,YAAY,QAAQ,sBAAsB;EACnD;CACF;CAEA,MAAM,EAAE,YAAY,MAAM,cAAc;CAExC,IAAI,QACF,YACA,QACA,WAAW,OAAO,aAAa,OAAO,EAAE,sBAC1C;AACF"}
+{"version":3,"file":"drop-tables-action.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/database/drop-tables-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { dataSourceRegistry, dropAllTables } from \"@warlock.js/cascade\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { confirm } from \"../cli/commands/generate/utils/prompt\";\r\nimport { CommandActionData } from \"../commands/types\";\r\n\r\nexport async function dropTablesAction(command: CommandActionData) {\r\n  const { force } = command.options;\r\n\r\n  if (force) {\r\n    const { dropped } = await dropAllTables();\r\n    log.success(\r\n      \"database\",\r\n      \"drop\",\r\n      `Dropped ${colors.yellowBright(dropped)} tables successfully.`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  // Preview phase — we keep direct driver access so we can show per-table\r\n  // row counts before asking for confirmation. The actual drop still goes\r\n  // through the Cascade Operations API.\r\n  const driver = dataSourceRegistry.get().driver;\r\n  const tables = await driver.blueprint.listTables();\r\n\r\n  if (tables.length === 0) {\r\n    log.warn(\"database\", \"drop\", \"No tables found in the database.\");\r\n    return;\r\n  }\r\n\r\n  log.info(\"database\", \"drop\", `Found ${colors.yellowBright(tables.length)} tables:`);\r\n\r\n  for (const table of tables) {\r\n    const count = await driver.queryBuilder(table).count();\r\n    console.log(`  - ${colors.cyan(table)}: ${colors.green(count)} rows`);\r\n  }\r\n\r\n  const confirmed = await confirm(\r\n    `Are you sure you want to drop all ${colors.red(tables.length)} tables?`,\r\n  );\r\n\r\n  if (!confirmed) {\r\n    log.info(\"database\", \"drop\", \"Operation cancelled.\");\r\n    return;\r\n  }\r\n\r\n  const { dropped } = await dropAllTables();\r\n\r\n  log.success(\r\n    \"database\",\r\n    \"drop\",\r\n    `Dropped ${colors.yellowBright(dropped)} tables successfully.`,\r\n  );\r\n}\r\n"],"mappings":";;;;;;AAMA,eAAsB,iBAAiB,SAA4B;CACjE,MAAM,EAAE,UAAU,QAAQ;CAE1B,IAAI,OAAO;EACT,MAAM,EAAE,YAAY,MAAM,cAAc;EACxC,IAAI,QACF,YACA,QACA,WAAW,OAAO,aAAa,OAAO,EAAE,sBAC1C;EACA;CACF;CAKA,MAAM,SAAS,mBAAmB,IAAI,EAAE;CACxC,MAAM,SAAS,MAAM,OAAO,UAAU,WAAW;CAEjD,IAAI,OAAO,WAAW,GAAG;EACvB,IAAI,KAAK,YAAY,QAAQ,kCAAkC;EAC/D;CACF;CAEA,IAAI,KAAK,YAAY,QAAQ,SAAS,OAAO,aAAa,OAAO,MAAM,EAAE,SAAS;CAElF,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,QAAQ,MAAM,OAAO,aAAa,KAAK,EAAE,MAAM;EACrD,QAAQ,IAAI,OAAO,OAAO,KAAK,KAAK,EAAE,IAAI,OAAO,MAAM,KAAK,EAAE,MAAM;CACtE;CAMA,IAAI,CAAC,MAJmB,QACtB,qCAAqC,OAAO,IAAI,OAAO,MAAM,EAAE,SACjE,GAEgB;EACd,IAAI,KAAK,YAAY,QAAQ,sBAAsB;EACnD;CACF;CAEA,MAAM,EAAE,YAAY,MAAM,cAAc;CAExC,IAAI,QACF,YACA,QACA,WAAW,OAAO,aAAa,OAAO,EAAE,sBAC1C;AACF"}

package/esm/database/migrate-action.mjs

@@ -11,7 +11,7 @@ import path from "path";
 import { colors } from "@mongez/copper";
 import dayjs from "dayjs";
 
-//#region ../core/src/database/migrate-action.ts
+//#region core/src/database/migrate-action.ts
 /**
 * `--list` — print the migration state: what has run, then what will run next.
 *

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

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

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

@@ -1,7 +1,7 @@
 import { Infer } from "@warlock.js/seal";
 import { Model } from "@warlock.js/cascade";
 
-//#region ../core/src/database/models/database-log/database-log.d.ts
+//#region core/src/database/models/database-log/database-log.d.ts
 declare const schema: import("@warlock.js/seal").ObjectValidator<{
   module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
   action: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;

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

@@ -1 +1 @@
-{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../../core/src/database/models/database-log/database-log.ts"],"mappings":";;;;cAGM,MAAA,6BAAM,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;KAQP,SAAA,GAAY,KAAA,CAAM,MAAM,QAAQ,MAAA;AAAA,cAExB,gBAAA,SAAyB,KAAA,CAAM,SAAA;;;;SAI5B,KAAA;;;;SAKA,MAAA,6BAAM,eAAA"}
+{"version":3,"file":"database-log.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/database/models/database-log/database-log.ts"],"mappings":";;;;cAGM,MAAA,6BAAM,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;KAQP,SAAA,GAAY,KAAA,CAAM,MAAM,QAAQ,MAAA;AAAA,cAExB,gBAAA,SAAyB,KAAA,CAAM,SAAA;;;;SAI5B,KAAA;;;;SAKA,MAAA,6BAAM,eAAA"}

package/esm/database/models/database-log/database-log.mjs

@@ -1,7 +1,7 @@
 import { v } from "@warlock.js/seal";
 import { Model } from "@warlock.js/cascade";
 
-//#region ../core/src/database/models/database-log/database-log.ts
+//#region core/src/database/models/database-log/database-log.ts
 const schema = v.object({
 	module: v.string(),
 	action: v.string(),

package/esm/database/models/database-log/database-log.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-log.mjs","names":[],"sources":["../../../../../../../../../core/src/database/models/database-log/database-log.ts"],"sourcesContent":["import { Model } from \"@warlock.js/cascade\";\r\nimport { Infer, v } from \"@warlock.js/seal\";\r\n\r\nconst schema = v.object({\r\n  module: v.string(),\r\n  action: v.string(),\r\n  message: v.string(),\r\n  trace: v.record(v.any()),\r\n  level: v.string(),\r\n});\r\n\r\ntype LogSchema = Infer.Output<typeof schema>;\r\n\r\nexport class DatabaseLogModel extends Model<LogSchema> {\r\n  /**\r\n   * Table name\r\n   */\r\n  public static table = \"logs\";\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public static schema = schema;\r\n}\r\n"],"mappings":";;;;AAGA,MAAM,SAAS,EAAE,OAAO;CACtB,QAAQ,EAAE,OAAO;CACjB,QAAQ,EAAE,OAAO;CACjB,SAAS,EAAE,OAAO;CAClB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;CACvB,OAAO,EAAE,OAAO;AAClB,CAAC;AAID,IAAa,mBAAb,cAAsC,MAAiB;;eAI/B;;;gBAKC;;AACzB"}
+{"version":3,"file":"database-log.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/database/models/database-log/database-log.ts"],"sourcesContent":["import { Model } from \"@warlock.js/cascade\";\r\nimport { type Infer, v } from \"@warlock.js/seal\";\r\n\r\nconst schema = v.object({\r\n  module: v.string(),\r\n  action: v.string(),\r\n  message: v.string(),\r\n  trace: v.record(v.any()),\r\n  level: v.string(),\r\n});\r\n\r\ntype LogSchema = Infer.Output<typeof schema>;\r\n\r\nexport class DatabaseLogModel extends Model<LogSchema> {\r\n  /**\r\n   * Table name\r\n   */\r\n  public static table = \"logs\";\r\n\r\n  /**\r\n   * {@inheritdoc}\r\n   */\r\n  public static schema = schema;\r\n}\r\n"],"mappings":";;;;AAGA,MAAM,SAAS,EAAE,OAAO;CACtB,QAAQ,EAAE,OAAO;CACjB,QAAQ,EAAE,OAAO;CACjB,SAAS,EAAE,OAAO;CAClB,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;CACvB,OAAO,EAAE,OAAO;AAClB,CAAC;AAID,IAAa,mBAAb,cAAsC,MAAiB;;eAI/B;;;gBAKC;;AACzB"}

package/esm/database/pending-exit-code.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/database/pending-exit-code.ts
+//#region core/src/database/pending-exit-code.ts
 /**
 * Exit codes for `warlock migrate --pending`.
 *

package/esm/database/pending-exit-code.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"pending-exit-code.mjs","names":[],"sources":["../../../../../../../core/src/database/pending-exit-code.ts"],"sourcesContent":["import type { PendingMigrationsResult } from \"./resolve-pending-migrations\";\n\n/**\n * Exit codes for `warlock migrate --pending`.\n *\n * `--pending` is a GATE, not a report: it is written into `migrate --pending &&\n * deploy` and into CI steps asserting nothing is outstanding. So it must\n * distinguish three outcomes, not two.\n *\n * Two codes would fold `pending` and `unavailable` into a single non-zero, and\n * a script could no longer tell \"three migrations are waiting\" from \"I could\n * not work out what is waiting\". Those demand opposite responses — the first is\n * \"run them\", the second is \"stop and get a human\".\n *\n * `warlock migrate --list` is the report half and always exits `0`, whatever\n * the pending section says.\n */\nexport const PENDING_EXIT_CODE = {\n  /** Computed, and nothing is pending. */\n  clear: 0,\n  /** Computed, and at least one migration is pending. */\n  pending: 1,\n  /** Could not be computed. Never conflate this with `clear`. */\n  unavailable: 2,\n} as const;\n\nexport type PendingExitCode = (typeof PENDING_EXIT_CODE)[keyof typeof PENDING_EXIT_CODE];\n\n/**\n * Map a resolution outcome onto the exit code a gate should report.\n *\n * @example\n * exitCodeFor({ type: \"resolved\", migrations: [] }); // 0\n * exitCodeFor({ type: \"unavailable\", reason: \"…\" }); // 2\n */\nexport function exitCodeFor(result: PendingMigrationsResult): PendingExitCode {\n  if (result.type === \"unavailable\") {\n    return PENDING_EXIT_CODE.unavailable;\n  }\n\n  return result.migrations.length > 0 ? PENDING_EXIT_CODE.pending : PENDING_EXIT_CODE.clear;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,MAAa,oBAAoB;;CAE/B,OAAO;;CAEP,SAAS;;CAET,aAAa;AACf;;;;;;;;AAWA,SAAgB,YAAY,QAAkD;CAC5E,IAAI,OAAO,SAAS,eAClB,OAAO,kBAAkB;CAG3B,OAAO,OAAO,WAAW,SAAS,IAAI,kBAAkB,UAAU,kBAAkB;AACtF"}
+{"version":3,"file":"pending-exit-code.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/database/pending-exit-code.ts"],"sourcesContent":["import type { PendingMigrationsResult } from \"./resolve-pending-migrations\";\n\n/**\n * Exit codes for `warlock migrate --pending`.\n *\n * `--pending` is a GATE, not a report: it is written into `migrate --pending &&\n * deploy` and into CI steps asserting nothing is outstanding. So it must\n * distinguish three outcomes, not two.\n *\n * Two codes would fold `pending` and `unavailable` into a single non-zero, and\n * a script could no longer tell \"three migrations are waiting\" from \"I could\n * not work out what is waiting\". Those demand opposite responses — the first is\n * \"run them\", the second is \"stop and get a human\".\n *\n * `warlock migrate --list` is the report half and always exits `0`, whatever\n * the pending section says.\n */\nexport const PENDING_EXIT_CODE = {\n  /** Computed, and nothing is pending. */\n  clear: 0,\n  /** Computed, and at least one migration is pending. */\n  pending: 1,\n  /** Could not be computed. Never conflate this with `clear`. */\n  unavailable: 2,\n} as const;\n\nexport type PendingExitCode = (typeof PENDING_EXIT_CODE)[keyof typeof PENDING_EXIT_CODE];\n\n/**\n * Map a resolution outcome onto the exit code a gate should report.\n *\n * @example\n * exitCodeFor({ type: \"resolved\", migrations: [] }); // 0\n * exitCodeFor({ type: \"unavailable\", reason: \"…\" }); // 2\n */\nexport function exitCodeFor(result: PendingMigrationsResult): PendingExitCode {\n  if (result.type === \"unavailable\") {\n    return PENDING_EXIT_CODE.unavailable;\n  }\n\n  return result.migrations.length > 0 ? PENDING_EXIT_CODE.pending : PENDING_EXIT_CODE.clear;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,MAAa,oBAAoB;;CAE/B,OAAO;;CAEP,SAAS;;CAET,aAAa;AACf;;;;;;;;AAWA,SAAgB,YAAY,QAAkD;CAC5E,IAAI,OAAO,SAAS,eAClB,OAAO,kBAAkB;CAG3B,OAAO,OAAO,WAAW,SAAS,IAAI,kBAAkB,UAAU,kBAAkB;AACtF"}

package/esm/database/resolve-pending-migrations.mjs

@@ -1,6 +1,6 @@
 import { listPendingMigrations } from "@warlock.js/cascade";
 
-//#region ../core/src/database/resolve-pending-migrations.ts
+//#region core/src/database/resolve-pending-migrations.ts
 /**
 * Load the project's migrations, then compute which of them have not run yet.
 *

package/esm/database/resolve-pending-migrations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-pending-migrations.mjs","names":[],"sources":["../../../../../../../core/src/database/resolve-pending-migrations.ts"],"sourcesContent":["import { listPendingMigrations, type PendingMigration } from \"@warlock.js/cascade\";\n\n/**\n * Outcome of trying to compute the pending migration set.\n *\n * The \"unavailable\" arm exists because the two failure modes are NOT the same\n * answer: a database with nothing pending and a tree we could not read both\n * produce an empty list, and only one of them means it is safe to proceed.\n * Collapsing them into `[]` is how a pre-flight check reports a confident\n * all-clear over an unknown.\n */\nexport type PendingMigrationsResult =\n  | {\n      readonly type: \"resolved\";\n      readonly migrations: PendingMigration[];\n    }\n  | {\n      readonly type: \"unavailable\";\n      readonly reason: string;\n    };\n\n/**\n * Load the project's migrations, then compute which of them have not run yet.\n *\n * `loadMigrations` must be the SAME registration path a real `warlock migrate`\n * takes. Skipping it does not fail — it silently yields an empty pending set,\n * because the pending set is computed from the runner's registry.\n *\n * Loading executes project code (a migration file is imported, and a broken one\n * throws), so every failure is converted into an `unavailable` result rather\n * than propagating. Callers decide what an unknown means for them: a listing\n * prints it and carries on, a gate refuses to pass.\n *\n * @example\n * const result = await resolvePendingMigrations(loadAllMigrations);\n *\n * if (result.type === \"unavailable\") {\n *   console.error(`Pending: unavailable — ${result.reason}`);\n * }\n */\nexport async function resolvePendingMigrations(\n  loadMigrations: () => Promise<void>,\n): Promise<PendingMigrationsResult> {\n  try {\n    await loadMigrations();\n\n    const migrations = await listPendingMigrations();\n\n    return { type: \"resolved\", migrations };\n  } catch (error) {\n    return { type: \"unavailable\", reason: describeFailure(error) };\n  }\n}\n\n/**\n * Reduce a thrown value to a single line an operator can act on. The message is\n * the actionable part — a stack trace in the middle of a listing buries the\n * executed section the reader still needs.\n */\nfunction describeFailure(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAwCA,eAAsB,yBACpB,gBACkC;CAClC,IAAI;EACF,MAAM,eAAe;EAIrB,OAAO;GAAE,MAAM;GAAY,kBAFF,sBAAsB;EAET;CACxC,SAAS,OAAO;EACd,OAAO;GAAE,MAAM;GAAe,QAAQ,gBAAgB,KAAK;EAAE;CAC/D;AACF;;;;;;AAOA,SAAS,gBAAgB,OAAwB;CAC/C,IAAI,iBAAiB,OACnB,OAAO,MAAM;CAGf,OAAO,OAAO,KAAK;AACrB"}
+{"version":3,"file":"resolve-pending-migrations.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/database/resolve-pending-migrations.ts"],"sourcesContent":["import { listPendingMigrations, type PendingMigration } from \"@warlock.js/cascade\";\n\n/**\n * Outcome of trying to compute the pending migration set.\n *\n * The \"unavailable\" arm exists because the two failure modes are NOT the same\n * answer: a database with nothing pending and a tree we could not read both\n * produce an empty list, and only one of them means it is safe to proceed.\n * Collapsing them into `[]` is how a pre-flight check reports a confident\n * all-clear over an unknown.\n */\nexport type PendingMigrationsResult =\n  | {\n      readonly type: \"resolved\";\n      readonly migrations: PendingMigration[];\n    }\n  | {\n      readonly type: \"unavailable\";\n      readonly reason: string;\n    };\n\n/**\n * Load the project's migrations, then compute which of them have not run yet.\n *\n * `loadMigrations` must be the SAME registration path a real `warlock migrate`\n * takes. Skipping it does not fail — it silently yields an empty pending set,\n * because the pending set is computed from the runner's registry.\n *\n * Loading executes project code (a migration file is imported, and a broken one\n * throws), so every failure is converted into an `unavailable` result rather\n * than propagating. Callers decide what an unknown means for them: a listing\n * prints it and carries on, a gate refuses to pass.\n *\n * @example\n * const result = await resolvePendingMigrations(loadAllMigrations);\n *\n * if (result.type === \"unavailable\") {\n *   console.error(`Pending: unavailable — ${result.reason}`);\n * }\n */\nexport async function resolvePendingMigrations(\n  loadMigrations: () => Promise<void>,\n): Promise<PendingMigrationsResult> {\n  try {\n    await loadMigrations();\n\n    const migrations = await listPendingMigrations();\n\n    return { type: \"resolved\", migrations };\n  } catch (error) {\n    return { type: \"unavailable\", reason: describeFailure(error) };\n  }\n}\n\n/**\n * Reduce a thrown value to a single line an operator can act on. The message is\n * the actionable part — a stack trace in the middle of a listing buries the\n * executed section the reader still needs.\n */\nfunction describeFailure(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  return String(error);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAwCA,eAAsB,yBACpB,gBACkC;CAClC,IAAI;EACF,MAAM,eAAe;EAIrB,OAAO;GAAE,MAAM;GAAY,kBAFF,sBAAsB;EAET;CACxC,SAAS,OAAO;EACd,OAAO;GAAE,MAAM;GAAe,QAAQ,gBAAgB,KAAK;EAAE;CAC/D;AACF;;;;;;AAOA,SAAS,gBAAgB,OAAwB;CAC/C,IAAI,iBAAiB,OACnB,OAAO,MAAM;CAGf,OAAO,OAAO,KAAK;AACrB"}

package/esm/database/seed-command-action.mjs

@@ -8,7 +8,7 @@ import { SeedersManager } from "./seeds/seeders.manager.mjs";
 import { dataSourceRegistry, transaction } from "@warlock.js/cascade";
 import { colors } from "@mongez/copper";
 
-//#region ../core/src/database/seed-command-action.ts
+//#region core/src/database/seed-command-action.ts
 async function clearAllTables(datasource) {
 	const tables = await datasource.driver.blueprint.listTables();
 	for (const table of tables) await datasource.driver.truncateTable(table, { cascade: true });

package/esm/database/seed-command-action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"seed-command-action.mjs","names":["runInTransaction"],"sources":["../../../../../../../core/src/database/seed-command-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  DataSource,\r\n  dataSourceRegistry,\r\n  transaction as runInTransaction,\r\n} from \"@warlock.js/cascade\";\r\nimport { CommandActionData } from \"../commands/types\";\r\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\r\nimport { srcPath } from \"../utils\";\r\nimport { Seeder } from \"./seeds/seeder\";\r\nimport { SeedersManager } from \"./seeds/seeders.manager\";\r\nimport { SeedClock, SeedRecordRef } from \"./seeds/types\";\r\nimport { seedRecordsTableName, seedsTableName } from \"./seeds/utils\";\r\n\r\n/**\r\n * Programmatic-only overrides for {@link seedCommandAction}.\r\n *\r\n * Not derived from CLI flags (the CLI passes only {@link CommandActionData}),\r\n * so a back-fill script or a test can inject behaviour the command line can't\r\n * express.\r\n */\r\nexport type SeedCommandOverrides = {\r\n  /**\r\n   * Clock the run reads for the `now` handed to each seeder and for the\r\n   * seeds-log metadata timestamps. Defaults to `() => new Date()`. Forwarded to\r\n   * {@link SeedersManager}'s `clock` option.\r\n   */\r\n  clock?: SeedClock;\r\n};\r\n\r\nasync function clearAllTables(datasource: DataSource) {\r\n  const tables = await datasource.driver.blueprint.listTables();\r\n\r\n  for (const table of tables) {\r\n    await datasource.driver.truncateTable(table, { cascade: true });\r\n  }\r\n}\r\n\r\ntype SeedRecordRow = SeedRecordRef & { id: number };\r\n\r\n/**\r\n * Undo seeded data by deleting the records a seeder tracked via `track`.\r\n *\r\n * Reads `seed_records` (all seeders, or a single `seederName`), then deletes\r\n * the referenced records in REVERSE seed-order and, within each seed, in\r\n * reverse insertion-order. Insertion id is strictly increasing across the\r\n * whole run, so deleting by descending `id` satisfies both at once. The whole\r\n * operation runs in a single transaction, and the matching seeds-log rows are\r\n * reset afterwards so `once: true` seeds re-run on the next `warlock seed`.\r\n *\r\n * @returns the number of tracked records deleted.\r\n */\r\nexport async function dropSeedRecords(\r\n  datasource: DataSource,\r\n  seederName?: string,\r\n): Promise<number> {\r\n  const driver = datasource.driver;\r\n\r\n  if (!(await driver.blueprint.tableExists(seedRecordsTableName))) {\r\n    return 0;\r\n  }\r\n\r\n  const query = driver.queryBuilder<SeedRecordRow>(seedRecordsTableName);\r\n\r\n  if (seederName) {\r\n    query.where(\"seeder\", seederName);\r\n  }\r\n\r\n  const rows = await query.get();\r\n\r\n  if (rows.length === 0) {\r\n    return 0;\r\n  }\r\n\r\n  // Descending insertion id == reverse seed-order + reverse within-seed order.\r\n  const ordered = [...rows].sort((a, b) => b.id - a.id);\r\n\r\n  await runInTransaction(async () => {\r\n    for (const row of ordered) {\r\n      await driver.deleteMany(row.table, { id: row.recordId });\r\n    }\r\n\r\n    // Clear the tracked refs we just acted on.\r\n    if (seederName) {\r\n      await driver.deleteMany(seedRecordsTableName, { seeder: seederName });\r\n    } else {\r\n      await driver.deleteMany(seedRecordsTableName, {});\r\n    }\r\n\r\n    // Reset the seeds-log rows so `once: true` seeds re-run.\r\n    const seederNames = seederName\r\n      ? [seederName]\r\n      : [...new Set(ordered.map((row) => row.seeder))];\r\n\r\n    for (const name of seederNames) {\r\n      await driver.deleteMany(seedsTableName, { name });\r\n    }\r\n  });\r\n\r\n  return ordered.length;\r\n}\r\n\r\n/**\r\n * Run database seeds.\r\n *\r\n * @example\r\n * ```ts\r\n * import { seedCommandAction } from \"@warlock.js/core\";\r\n *\r\n * await seedCommandAction({\r\n *   command: \"seed\",\r\n *   options: { fresh: true, list: false }\r\n * });\r\n * ```\r\n *\r\n * @param overrides Programmatic-only overrides (e.g. an injected `clock`); the\r\n * CLI never passes this, so the command-line signature stays unchanged.\r\n */\r\nexport async function seedCommandAction(\r\n  options: CommandActionData,\r\n  overrides?: SeedCommandOverrides,\r\n) {\r\n  const { path, fresh, transaction, list, drop } = options.options;\r\n\r\n  const datasource = dataSourceRegistry.get();\r\n\r\n  if (drop) {\r\n    // `--drop` (boolean) undoes every tracked record; `--drop=<name>` scopes to\r\n    // a single seeder.\r\n    const seederName = typeof drop === \"string\" ? drop : undefined;\r\n\r\n    const deleted = await dropSeedRecords(datasource, seederName);\r\n\r\n    const scope = seederName ? colors.cyan(seederName) : \"all seeders\";\r\n    console.log(\r\n      `🗑️  Dropped ${colors.redBright(deleted)} tracked record(s) for ${scope}; matching seeds-log entries reset.`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  if (fresh) {\r\n    await clearAllTables(datasource);\r\n  }\r\n\r\n  if (list) {\r\n    const seedFiles = await listSeedsFiles();\r\n\r\n    if (seedFiles.length === 0) {\r\n      console.log(\"No seeds found.\");\r\n      return;\r\n    }\r\n\r\n    const seedersManager = new SeedersManager();\r\n\r\n    seedersManager.register(...seedFiles);\r\n\r\n    const seeds = seedersManager.sort().seeders.map((seed) => {\r\n      return {\r\n        name: seed.name,\r\n        order: seed.order,\r\n        enabled: seed.enabled,\r\n      };\r\n    });\r\n\r\n    console.table(seeds);\r\n\r\n    console.log(\r\n      `Total Seeds: ${colors.blueBright(seeds.length)}, enabled: ${colors.greenBright(seeds.filter((seed) => seed.enabled !== false).length)}, disabled: ${colors.redBright(seeds.filter((seed) => seed.enabled === false).length)}`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  const seeds = path\r\n    ? [await loadSeedFile(Path.toAbsolute(path as string))]\r\n    : await listSeedsFiles();\r\n\r\n  const seedersManager = new SeedersManager({ clock: overrides?.clock });\r\n\r\n  seedersManager.register(...seeds);\r\n\r\n  await seedersManager.run(transaction as boolean);\r\n}\r\n\r\nasync function listSeedsFiles() {\r\n  const seedsFiles = await getFilesFromDirectory(srcPath(\"app\"), \"*/seeds/*.ts\");\r\n\r\n  const seeds = [];\r\n\r\n  for (const seedFile of seedsFiles) {\r\n    const seed = await loadSeedFile(seedFile);\r\n    seeds.push(seed);\r\n  }\r\n\r\n  return seeds;\r\n}\r\n\r\nasync function loadSeedFile(absPath: string): Promise<Seeder> {\r\n  const relativePath = Path.toRelative(absPath);\r\n  const seedImport = await filesOrchestrator.load<{ default: Seeder }>(relativePath);\r\n\r\n  if (!seedImport || !seedImport.default) {\r\n    throw new Error(`Seeder file ${relativePath} does not export a default seeder.`);\r\n  }\r\n\r\n  return seedImport.default;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"seed-command-action.mjs","names":["runInTransaction"],"sources":["C:/Work/Warlock.js/core/src/database/seed-command-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  DataSource,\r\n  dataSourceRegistry,\r\n  transaction as runInTransaction,\r\n} from \"@warlock.js/cascade\";\r\nimport { CommandActionData } from \"../commands/types\";\r\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\r\nimport { srcPath } from \"../utils\";\r\nimport { Seeder } from \"./seeds/seeder\";\r\nimport { SeedersManager } from \"./seeds/seeders.manager\";\r\nimport { SeedClock, SeedRecordRef } from \"./seeds/types\";\r\nimport { seedRecordsTableName, seedsTableName } from \"./seeds/utils\";\r\n\r\n/**\r\n * Programmatic-only overrides for {@link seedCommandAction}.\r\n *\r\n * Not derived from CLI flags (the CLI passes only {@link CommandActionData}),\r\n * so a back-fill script or a test can inject behaviour the command line can't\r\n * express.\r\n */\r\nexport type SeedCommandOverrides = {\r\n  /**\r\n   * Clock the run reads for the `now` handed to each seeder and for the\r\n   * seeds-log metadata timestamps. Defaults to `() => new Date()`. Forwarded to\r\n   * {@link SeedersManager}'s `clock` option.\r\n   */\r\n  clock?: SeedClock;\r\n};\r\n\r\nasync function clearAllTables(datasource: DataSource) {\r\n  const tables = await datasource.driver.blueprint.listTables();\r\n\r\n  for (const table of tables) {\r\n    await datasource.driver.truncateTable(table, { cascade: true });\r\n  }\r\n}\r\n\r\ntype SeedRecordRow = SeedRecordRef & { id: number };\r\n\r\n/**\r\n * Undo seeded data by deleting the records a seeder tracked via `track`.\r\n *\r\n * Reads `seed_records` (all seeders, or a single `seederName`), then deletes\r\n * the referenced records in REVERSE seed-order and, within each seed, in\r\n * reverse insertion-order. Insertion id is strictly increasing across the\r\n * whole run, so deleting by descending `id` satisfies both at once. The whole\r\n * operation runs in a single transaction, and the matching seeds-log rows are\r\n * reset afterwards so `once: true` seeds re-run on the next `warlock seed`.\r\n *\r\n * @returns the number of tracked records deleted.\r\n */\r\nexport async function dropSeedRecords(\r\n  datasource: DataSource,\r\n  seederName?: string,\r\n): Promise<number> {\r\n  const driver = datasource.driver;\r\n\r\n  if (!(await driver.blueprint.tableExists(seedRecordsTableName))) {\r\n    return 0;\r\n  }\r\n\r\n  const query = driver.queryBuilder<SeedRecordRow>(seedRecordsTableName);\r\n\r\n  if (seederName) {\r\n    query.where(\"seeder\", seederName);\r\n  }\r\n\r\n  const rows = await query.get();\r\n\r\n  if (rows.length === 0) {\r\n    return 0;\r\n  }\r\n\r\n  // Descending insertion id == reverse seed-order + reverse within-seed order.\r\n  const ordered = [...rows].sort((a, b) => b.id - a.id);\r\n\r\n  await runInTransaction(async () => {\r\n    for (const row of ordered) {\r\n      await driver.deleteMany(row.table, { id: row.recordId });\r\n    }\r\n\r\n    // Clear the tracked refs we just acted on.\r\n    if (seederName) {\r\n      await driver.deleteMany(seedRecordsTableName, { seeder: seederName });\r\n    } else {\r\n      await driver.deleteMany(seedRecordsTableName, {});\r\n    }\r\n\r\n    // Reset the seeds-log rows so `once: true` seeds re-run.\r\n    const seederNames = seederName\r\n      ? [seederName]\r\n      : [...new Set(ordered.map((row) => row.seeder))];\r\n\r\n    for (const name of seederNames) {\r\n      await driver.deleteMany(seedsTableName, { name });\r\n    }\r\n  });\r\n\r\n  return ordered.length;\r\n}\r\n\r\n/**\r\n * Run database seeds.\r\n *\r\n * @example\r\n * ```ts\r\n * import { seedCommandAction } from \"@warlock.js/core\";\r\n *\r\n * await seedCommandAction({\r\n *   command: \"seed\",\r\n *   options: { fresh: true, list: false }\r\n * });\r\n * ```\r\n *\r\n * @param overrides Programmatic-only overrides (e.g. an injected `clock`); the\r\n * CLI never passes this, so the command-line signature stays unchanged.\r\n */\r\nexport async function seedCommandAction(\r\n  options: CommandActionData,\r\n  overrides?: SeedCommandOverrides,\r\n) {\r\n  const { path, fresh, transaction, list, drop } = options.options;\r\n\r\n  const datasource = dataSourceRegistry.get();\r\n\r\n  if (drop) {\r\n    // `--drop` (boolean) undoes every tracked record; `--drop=<name>` scopes to\r\n    // a single seeder.\r\n    const seederName = typeof drop === \"string\" ? drop : undefined;\r\n\r\n    const deleted = await dropSeedRecords(datasource, seederName);\r\n\r\n    const scope = seederName ? colors.cyan(seederName) : \"all seeders\";\r\n    console.log(\r\n      `🗑️  Dropped ${colors.redBright(deleted)} tracked record(s) for ${scope}; matching seeds-log entries reset.`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  if (fresh) {\r\n    await clearAllTables(datasource);\r\n  }\r\n\r\n  if (list) {\r\n    const seedFiles = await listSeedsFiles();\r\n\r\n    if (seedFiles.length === 0) {\r\n      console.log(\"No seeds found.\");\r\n      return;\r\n    }\r\n\r\n    const seedersManager = new SeedersManager();\r\n\r\n    seedersManager.register(...seedFiles);\r\n\r\n    const seeds = seedersManager.sort().seeders.map((seed) => {\r\n      return {\r\n        name: seed.name,\r\n        order: seed.order,\r\n        enabled: seed.enabled,\r\n      };\r\n    });\r\n\r\n    console.table(seeds);\r\n\r\n    console.log(\r\n      `Total Seeds: ${colors.blueBright(seeds.length)}, enabled: ${colors.greenBright(seeds.filter((seed) => seed.enabled !== false).length)}, disabled: ${colors.redBright(seeds.filter((seed) => seed.enabled === false).length)}`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  const seeds = path\r\n    ? [await loadSeedFile(Path.toAbsolute(path as string))]\r\n    : await listSeedsFiles();\r\n\r\n  const seedersManager = new SeedersManager({ clock: overrides?.clock });\r\n\r\n  seedersManager.register(...seeds);\r\n\r\n  await seedersManager.run(transaction as boolean);\r\n}\r\n\r\nasync function listSeedsFiles() {\r\n  const seedsFiles = await getFilesFromDirectory(srcPath(\"app\"), \"*/seeds/*.ts\");\r\n\r\n  const seeds = [];\r\n\r\n  for (const seedFile of seedsFiles) {\r\n    const seed = await loadSeedFile(seedFile);\r\n    seeds.push(seed);\r\n  }\r\n\r\n  return seeds;\r\n}\r\n\r\nasync function loadSeedFile(absPath: string): Promise<Seeder> {\r\n  const relativePath = Path.toRelative(absPath);\r\n  const seedImport = await filesOrchestrator.load<{ default: Seeder }>(relativePath);\r\n\r\n  if (!seedImport || !seedImport.default) {\r\n    throw new Error(`Seeder file ${relativePath} does not export a default seeder.`);\r\n  }\r\n\r\n  return seedImport.default;\r\n}\r\n"],"mappings":"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"}

package/esm/database/seeds/seed-records-table-migration.mjs

@@ -1,7 +1,7 @@
 import { seedRecordsTableName } from "./utils.mjs";
 import { Migration } from "@warlock.js/cascade";
 
-//#region ../core/src/database/seeds/seed-records-table-migration.ts
+//#region core/src/database/seeds/seed-records-table-migration.ts
 /**
 * Creates the `seed_records` table that backs `warlock seed --drop`.
 *
@@ -27,7 +27,7 @@ var SeedRecordsTableMigration = class extends Migration {
 		this.dateTime("runAt").useCurrent();
 	}
 	down() {
-		this.dropTableIfExists(seedRecordsTableName);
+		this.dropTableIfExists();
 	}
 };
 

package/esm/database/seeds/seed-records-table-migration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"seed-records-table-migration.mjs","names":[],"sources":["../../../../../../../../core/src/database/seeds/seed-records-table-migration.ts"],"sourcesContent":["import { Migration } from \"@warlock.js/cascade\";\nimport { seedRecordsTableName } from \"./utils\";\n\n/**\n * Creates the `seed_records` table that backs `warlock seed --drop`.\n *\n * Each row is a reference to a single record a seeder created, captured via the\n * `track` helper inside the same transaction the seed ran in. `--drop` reads\n * these refs to delete exactly (and only) the records a seed produced, then\n * resets the matching seeds-log row so a `once: true` seed can re-run.\n */\nexport class SeedRecordsTableMigration extends Migration {\n  public static migrationName = \"seed-records-table-migration\";\n  public table = seedRecordsTableName;\n\n  public up() {\n    this.createTableIfNotExists();\n\n    this.id();\n    this.text(\"seeder\");\n    this.text(\"table\");\n    this.text(\"recordId\");\n    this.dateTime(\"runAt\").useCurrent();\n  }\n\n  public down() {\n    this.dropTableIfExists(seedRecordsTableName);\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,4BAAb,cAA+C,UAAU;;;eAExC;;;uBADe;;CAG9B,AAAO,KAAK;EACV,KAAK,uBAAuB;EAE5B,KAAK,GAAG;EACR,KAAK,KAAK,QAAQ;EAClB,KAAK,KAAK,OAAO;EACjB,KAAK,KAAK,UAAU;EACpB,KAAK,SAAS,OAAO,CAAC,CAAC,WAAW;CACpC;CAEA,AAAO,OAAO;EACZ,KAAK,kBAAkB,oBAAoB;CAC7C;AACF"}
+{"version":3,"file":"seed-records-table-migration.mjs","names":[],"sources":["C:/Work/Warlock.js/core/src/database/seeds/seed-records-table-migration.ts"],"sourcesContent":["import { Migration } from \"@warlock.js/cascade\";\nimport { seedRecordsTableName } from \"./utils\";\n\n/**\n * Creates the `seed_records` table that backs `warlock seed --drop`.\n *\n * Each row is a reference to a single record a seeder created, captured via the\n * `track` helper inside the same transaction the seed ran in. `--drop` reads\n * these refs to delete exactly (and only) the records a seed produced, then\n * resets the matching seeds-log row so a `once: true` seed can re-run.\n */\nexport class SeedRecordsTableMigration extends Migration {\n  public static migrationName = \"seed-records-table-migration\";\n  public table = seedRecordsTableName;\n\n  public up() {\n    this.createTableIfNotExists();\n\n    this.id();\n    this.text(\"seeder\");\n    this.text(\"table\");\n    this.text(\"recordId\");\n    this.dateTime(\"runAt\").useCurrent();\n  }\n\n  public down() {\n    // No argument: dropTableIfExists() operates on `this.table`, set as a class\n    // field above. The name passed here was silently ignored at runtime.\n    this.dropTableIfExists();\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAWA,IAAa,4BAAb,cAA+C,UAAU;;;eAExC;;;uBADe;;CAG9B,AAAO,KAAK;EACV,KAAK,uBAAuB;EAE5B,KAAK,GAAG;EACR,KAAK,KAAK,QAAQ;EAClB,KAAK,KAAK,OAAO;EACjB,KAAK,KAAK,UAAU;EACpB,KAAK,SAAS,OAAO,EAAE,WAAW;CACpC;CAEA,AAAO,OAAO;EAGZ,KAAK,kBAAkB;CACzB;AACF"}

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

@@ -1,6 +1,6 @@
 import { SeedContext, SeedResult } from "./types.mjs";
 
-//#region ../core/src/database/seeds/seeder.d.ts
+//#region core/src/database/seeds/seeder.d.ts
 type Seeder = {
   /**
    * Seed name

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

@@ -1 +1 @@
-{"version":3,"file":"seeder.d.mts","names":[],"sources":["../../../../../../../../core/src/database/seeds/seeder.ts"],"mappings":";;;KAEY,MAAA;;AAAZ;;EAIE,IAAA;EA6CS;;;EAzCT,OAAA;EAyC8B;;;EArC9B,WAAA;EAIA;;;EAAA,SAAA;EAiCA;;;EA7BA,IAAA;EA6B+B;;AAAU;EAzBzC,KAAA;EA+BoB;;;;;;;EAvBpB,SAAA;;;;;;;;;;;;;;;;;EAiBA,GAAA,CAAI,GAAA,EAAK,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA;;;;iBAMjB,MAAA,CAAO,MAAA,EAAQ,MAAA,GAAM,MAAA"}
+{"version":3,"file":"seeder.d.mts","names":[],"sources":["C:/Work/Warlock.js/core/src/database/seeds/seeder.ts"],"mappings":";;;KAEY,MAAA;;AAAZ;;EAIE,IAAA;EA6CS;;;EAzCT,OAAA;EAyC8B;;;EArC9B,WAAA;EAIA;;;EAAA,SAAA;EAiCA;;;EA7BA,IAAA;EA6B+B;;AAAU;EAzBzC,KAAA;EA+BoB;;;;;;;EAvBpB,SAAA;;;;;;;;;;;;;;;;;EAiBA,GAAA,CAAI,GAAA,EAAK,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA;;;;iBAMjB,MAAA,CAAO,MAAA,EAAQ,MAAA,GAAM,MAAA"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/database/seeds/seeder.errors.d.ts
+//#region core/src/database/seeds/seeder.errors.d.ts
 /**
  * Thrown when a seeder's `dependsOn` references a seeder name that is not
  * registered with the manager. Surfaces the offending dependent + the missing

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

@@ -1 +1 @@
-{"version":3,"file":"seeder.errors.d.mts","names":[],"sources":["../../../../../../../../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":["C:/Work/Warlock.js/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"}

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

@@ -1,4 +1,4 @@
-//#region ../core/src/database/seeds/seeder.errors.ts
+//#region core/src/database/seeds/seeder.errors.ts
 /**
 * Thrown when a seeder's `dependsOn` references a seeder name that is not
 * registered with the manager. Surfaces the offending dependent + the missing