@warlock.js/core 4.11.0 → 4.13.0

package/esm/cli/commands/start-production.command.mjs

@@ -1,4 +1,4 @@
-import { command } from "../cli-command.mjs";
+import { command } from "../../commands/cli-command.mjs";
 import { resolveBuildConfig } from "../../production/resolve-build-config.mjs";
 import { superviseProductionProcess } from "../../production/production-supervisor.mjs";
 

package/esm/cli/commands/start-production.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"start-production.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/start-production.command.ts"],"sourcesContent":["import { superviseProductionProcess } from \"../../production/production-supervisor\";\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\nimport { command } from \"../cli-command\";\n\nexport const startProductionCommand = command({\n  name: \"start\",\n  description: \"Start production server\",\n  persistent: true,\n  preload: {\n    warlockConfig: true,\n  },\n  action: async () => {\n    const { entryPath, sourcemap } = resolveBuildConfig();\n\n    // Build node args\n    const nodeArgs: string[] = [];\n\n    // Enable source maps if configured\n    if (sourcemap !== false) {\n      nodeArgs.push(\"--enable-source-maps\");\n    }\n\n    // Add entry file\n    nodeArgs.push(entryPath);\n\n    // Pass through any additional flags after \"start\" command\n    // process.argv = [node, cli.ts, start, ...extra]\n    const startIndex = process.argv.findIndex((arg) => arg === \"start\");\n    if (startIndex !== -1 && startIndex < process.argv.length - 1) {\n      const extraArgs = process.argv.slice(startIndex + 1);\n      nodeArgs.push(...extraArgs);\n    }\n\n    // Progress goes to stderr, never stdout. Stdout carries exactly one claim —\n    // \"started\" — so that whatever greps it cannot mistake an intention for an\n    // outcome. The banner that used to print here, in `preAction`, printed\n    // before the child had even been spawned.\n    console.error(`🚀 Starting production server...\\n`);\n\n    const { exitCode } = await superviseProductionProcess({ nodeArgs });\n\n    process.exit(exitCode);\n  },\n});\n"],"mappings":";;;;;AAIA,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS,EACP,eAAe,KACjB;CACA,QAAQ,YAAY;EAClB,MAAM,EAAE,WAAW,cAAc,mBAAmB;EAGpD,MAAM,WAAqB,CAAC;EAG5B,IAAI,cAAc,OAChB,SAAS,KAAK,sBAAsB;EAItC,SAAS,KAAK,SAAS;EAIvB,MAAM,aAAa,QAAQ,KAAK,WAAW,QAAQ,QAAQ,OAAO;EAClE,IAAI,eAAe,MAAM,aAAa,QAAQ,KAAK,SAAS,GAAG;GAC7D,MAAM,YAAY,QAAQ,KAAK,MAAM,aAAa,CAAC;GACnD,SAAS,KAAK,GAAG,SAAS;EAC5B;EAMA,QAAQ,MAAM,oCAAoC;EAElD,MAAM,EAAE,aAAa,MAAM,2BAA2B,EAAE,SAAS,CAAC;EAElE,QAAQ,KAAK,QAAQ;CACvB;AACF,CAAC"}
+{"version":3,"file":"start-production.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/start-production.command.ts"],"sourcesContent":["import { superviseProductionProcess } from \"../../production/production-supervisor\";\r\nimport { resolveBuildConfig } from \"../../production/resolve-build-config\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const startProductionCommand = command({\r\n  name: \"start\",\r\n  description: \"Start production server\",\r\n  persistent: true,\r\n  preload: {\r\n    warlockConfig: true,\r\n  },\r\n  action: async () => {\r\n    const { entryPath, sourcemap } = resolveBuildConfig();\r\n\r\n    // Build node args\r\n    const nodeArgs: string[] = [];\r\n\r\n    // Enable source maps if configured\r\n    if (sourcemap !== false) {\r\n      nodeArgs.push(\"--enable-source-maps\");\r\n    }\r\n\r\n    // Add entry file\r\n    nodeArgs.push(entryPath);\r\n\r\n    // Pass through any additional flags after \"start\" command\r\n    // process.argv = [node, cli.ts, start, ...extra]\r\n    const startIndex = process.argv.findIndex((arg) => arg === \"start\");\r\n    if (startIndex !== -1 && startIndex < process.argv.length - 1) {\r\n      const extraArgs = process.argv.slice(startIndex + 1);\r\n      nodeArgs.push(...extraArgs);\r\n    }\r\n\r\n    // Progress goes to stderr, never stdout. Stdout carries exactly one claim —\r\n    // \"started\" — so that whatever greps it cannot mistake an intention for an\r\n    // outcome. The banner that used to print here, in `preAction`, printed\r\n    // before the child had even been spawned.\r\n    console.error(`🚀 Starting production server...\\n`);\r\n\r\n    const { exitCode } = await superviseProductionProcess({ nodeArgs });\r\n\r\n    process.exit(exitCode);\r\n  },\r\n});\r\n"],"mappings":";;;;;AAIA,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS,EACP,eAAe,KACjB;CACA,QAAQ,YAAY;EAClB,MAAM,EAAE,WAAW,cAAc,mBAAmB;EAGpD,MAAM,WAAqB,CAAC;EAG5B,IAAI,cAAc,OAChB,SAAS,KAAK,sBAAsB;EAItC,SAAS,KAAK,SAAS;EAIvB,MAAM,aAAa,QAAQ,KAAK,WAAW,QAAQ,QAAQ,OAAO;EAClE,IAAI,eAAe,MAAM,aAAa,QAAQ,KAAK,SAAS,GAAG;GAC7D,MAAM,YAAY,QAAQ,KAAK,MAAM,aAAa,CAAC;GACnD,SAAS,KAAK,GAAG,SAAS;EAC5B;EAMA,QAAQ,MAAM,oCAAoC;EAElD,MAAM,EAAE,aAAa,MAAM,2BAA2B,EAAE,SAAS,CAAC;EAElE,QAAQ,KAAK,QAAQ;CACvB;AACF,CAAC"}

package/esm/cli/commands/storage-put.action.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage-put.action.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/storage-put.action.ts"],"sourcesContent":["import fs from \"fs/promises\";\nimport path from \"path\";\nimport { config } from \"../../config\";\nimport { storage } from \"../../storage\";\nimport type { CommandActionData } from \"../types\";\n\n/**\n * Action for `warlock storage.put <localPath> [destination] [--driver <name>] [--concurrency <n>]`\n *\n * Uploads a local file or directory into any configured storage driver.\n * Auto-detects whether <localPath> is a file or directory and calls the\n * appropriate storage method.\n *\n * @example\n * # Upload entire uploads directory to R2 (root of bucket)\n * warlock storage.put ./uploads --driver r2\n *\n * @example\n * # Upload to a specific destination prefix\n * warlock storage.put ./uploads backups/2026 --driver r2\n *\n * @example\n * # Single file upload with custom concurrency\n * warlock storage.put ./public/logo.png assets/logo.png --driver s3\n */\nexport async function storagePutAction({ args, options }: CommandActionData): Promise<void> {\n  const [localPath, destination = \"\"] = args;\n\n  if (!localPath) {\n    console.error(\"✖  Missing required argument: <localPath>\");\n    console.error(\"   Usage: warlock storage.put <localPath> [destination] [--driver <name>]\");\n    process.exit(1);\n  }\n\n  // Resolve to absolute path relative to CWD\n  const absolutePath = path.resolve(process.cwd(), localPath);\n  const driverName = options.driver as string | undefined;\n  const concurrency = options.concurrency ? Number(options.concurrency) : 5;\n\n  // Verify the local path exists\n  let stat: Awaited<ReturnType<typeof fs.stat>>;\n  try {\n    stat = await fs.stat(absolutePath);\n  } catch {\n    console.error(`✖  Path not found: ${absolutePath}`);\n    process.exit(1);\n  }\n\n  // Select the driver — use named driver or fall back to default\n  const store = driverName ? storage.use(driverName) : storage;\n  const driverLabel = driverName ?? config.get(\"storage.default\");\n\n  console.log(`\\n  Driver    : ${driverLabel}`);\n  console.log(`  Source    : ${absolutePath}`);\n  console.log(`  Dest      : ${destination || \"(root)\"}\\n`);\n\n  if (stat.isDirectory()) {\n    // ── Directory upload ────────────────────────────────────────────────────\n    const result = await store.putDirectory(absolutePath, destination, {\n      concurrency,\n      // Skip hidden files (e.g. .DS_Store) by default\n      filter: (_, rel) => !path.basename(rel).startsWith(\".\"),\n      onProgress: (done, total, file) => {\n        process.stdout.write(`\\r  Progress  : ${done}/${total}  ${file.path}`);\n      },\n    });\n\n    // Clear the progress line and print summary\n    process.stdout.write(\"\\n\");\n    console.log(`\\n  ✔  ${result.uploaded.length} file(s) uploaded`);\n\n    if (result.failed.length > 0) {\n      console.warn(`\\n  ⚠  ${result.failed.length} file(s) failed:`);\n      for (const { localPath: fp, error } of result.failed) {\n        console.warn(`     - ${fp}: ${error.message}`);\n      }\n    }\n  } else {\n    // ── Single file upload ──────────────────────────────────────────────────\n    // Destination is used as the storage path; if empty, fall back to filename\n    const storagePath = destination || path.basename(absolutePath);\n\n    console.log(`  Uploading : ${path.basename(absolutePath)} → ${storagePath}`);\n\n    const file = await store.put(absolutePath, storagePath);\n\n    console.log(`\\n  ✔  Uploaded: ${file.url}`);\n  }\n\n  console.log();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,eAAsB,iBAAiB,EAAE,MAAM,WAA6C;CAC1F,MAAM,CAAC,WAAW,cAAc,MAAM;CAEtC,IAAI,CAAC,WAAW;EACd,QAAQ,MAAM,2CAA2C;EACzD,QAAQ,MAAM,2EAA2E;EACzF,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,eAAe,KAAK,QAAQ,QAAQ,IAAI,GAAG,SAAS;CAC1D,MAAM,aAAa,QAAQ;CAC3B,MAAM,cAAc,QAAQ,cAAc,OAAO,QAAQ,WAAW,IAAI;CAGxE,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,GAAG,KAAK,YAAY;CACnC,QAAQ;EACN,QAAQ,MAAM,sBAAsB,cAAc;EAClD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,QAAQ,aAAa,QAAQ,IAAI,UAAU,IAAI;CACrD,MAAM,cAAc,cAAc,OAAO,IAAI,iBAAiB;CAE9D,QAAQ,IAAI,mBAAmB,aAAa;CAC5C,QAAQ,IAAI,iBAAiB,cAAc;CAC3C,QAAQ,IAAI,iBAAiB,eAAe,SAAS,GAAG;CAExD,IAAI,KAAK,YAAY,GAAG;EAEtB,MAAM,SAAS,MAAM,MAAM,aAAa,cAAc,aAAa;GACjE;GAEA,SAAS,GAAG,QAAQ,CAAC,KAAK,SAAS,GAAG,CAAC,CAAC,WAAW,GAAG;GACtD,aAAa,MAAM,OAAO,SAAS;IACjC,QAAQ,OAAO,MAAM,mBAAmB,KAAK,GAAG,MAAM,IAAI,KAAK,MAAM;GACvE;EACF,CAAC;EAGD,QAAQ,OAAO,MAAM,IAAI;EACzB,QAAQ,IAAI,UAAU,OAAO,SAAS,OAAO,kBAAkB;EAE/D,IAAI,OAAO,OAAO,SAAS,GAAG;GAC5B,QAAQ,KAAK,UAAU,OAAO,OAAO,OAAO,iBAAiB;GAC7D,KAAK,MAAM,EAAE,WAAW,IAAI,WAAW,OAAO,QAC5C,QAAQ,KAAK,UAAU,GAAG,IAAI,MAAM,SAAS;EAEjD;CACF,OAAO;EAGL,MAAM,cAAc,eAAe,KAAK,SAAS,YAAY;EAE7D,QAAQ,IAAI,iBAAiB,KAAK,SAAS,YAAY,EAAE,KAAK,aAAa;EAE3E,MAAM,OAAO,MAAM,MAAM,IAAI,cAAc,WAAW;EAEtD,QAAQ,IAAI,oBAAoB,KAAK,KAAK;CAC5C;CAEA,QAAQ,IAAI;AACd"}
+{"version":3,"file":"storage-put.action.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/storage-put.action.ts"],"sourcesContent":["import fs from \"fs/promises\";\r\nimport path from \"path\";\r\nimport { config } from \"../../config\";\r\nimport { storage } from \"../../storage\";\r\nimport type { CommandActionData } from \"../../commands/types\";\r\n\r\n/**\r\n * Action for `warlock storage.put <localPath> [destination] [--driver <name>] [--concurrency <n>]`\r\n *\r\n * Uploads a local file or directory into any configured storage driver.\r\n * Auto-detects whether <localPath> is a file or directory and calls the\r\n * appropriate storage method.\r\n *\r\n * @example\r\n * # Upload entire uploads directory to R2 (root of bucket)\r\n * warlock storage.put ./uploads --driver r2\r\n *\r\n * @example\r\n * # Upload to a specific destination prefix\r\n * warlock storage.put ./uploads backups/2026 --driver r2\r\n *\r\n * @example\r\n * # Single file upload with custom concurrency\r\n * warlock storage.put ./public/logo.png assets/logo.png --driver s3\r\n */\r\nexport async function storagePutAction({ args, options }: CommandActionData): Promise<void> {\r\n  const [localPath, destination = \"\"] = args;\r\n\r\n  if (!localPath) {\r\n    console.error(\"✖  Missing required argument: <localPath>\");\r\n    console.error(\"   Usage: warlock storage.put <localPath> [destination] [--driver <name>]\");\r\n    process.exit(1);\r\n  }\r\n\r\n  // Resolve to absolute path relative to CWD\r\n  const absolutePath = path.resolve(process.cwd(), localPath);\r\n  const driverName = options.driver as string | undefined;\r\n  const concurrency = options.concurrency ? Number(options.concurrency) : 5;\r\n\r\n  // Verify the local path exists\r\n  let stat: Awaited<ReturnType<typeof fs.stat>>;\r\n  try {\r\n    stat = await fs.stat(absolutePath);\r\n  } catch {\r\n    console.error(`✖  Path not found: ${absolutePath}`);\r\n    process.exit(1);\r\n  }\r\n\r\n  // Select the driver — use named driver or fall back to default\r\n  const store = driverName ? storage.use(driverName) : storage;\r\n  const driverLabel = driverName ?? config.get(\"storage.default\");\r\n\r\n  console.log(`\\n  Driver    : ${driverLabel}`);\r\n  console.log(`  Source    : ${absolutePath}`);\r\n  console.log(`  Dest      : ${destination || \"(root)\"}\\n`);\r\n\r\n  if (stat.isDirectory()) {\r\n    // ── Directory upload ────────────────────────────────────────────────────\r\n    const result = await store.putDirectory(absolutePath, destination, {\r\n      concurrency,\r\n      // Skip hidden files (e.g. .DS_Store) by default\r\n      filter: (_, rel) => !path.basename(rel).startsWith(\".\"),\r\n      onProgress: (done, total, file) => {\r\n        process.stdout.write(`\\r  Progress  : ${done}/${total}  ${file.path}`);\r\n      },\r\n    });\r\n\r\n    // Clear the progress line and print summary\r\n    process.stdout.write(\"\\n\");\r\n    console.log(`\\n  ✔  ${result.uploaded.length} file(s) uploaded`);\r\n\r\n    if (result.failed.length > 0) {\r\n      console.warn(`\\n  ⚠  ${result.failed.length} file(s) failed:`);\r\n      for (const { localPath: fp, error } of result.failed) {\r\n        console.warn(`     - ${fp}: ${error.message}`);\r\n      }\r\n    }\r\n  } else {\r\n    // ── Single file upload ──────────────────────────────────────────────────\r\n    // Destination is used as the storage path; if empty, fall back to filename\r\n    const storagePath = destination || path.basename(absolutePath);\r\n\r\n    console.log(`  Uploading : ${path.basename(absolutePath)} → ${storagePath}`);\r\n\r\n    const file = await store.put(absolutePath, storagePath);\r\n\r\n    console.log(`\\n  ✔  Uploaded: ${file.url}`);\r\n  }\r\n\r\n  console.log();\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,eAAsB,iBAAiB,EAAE,MAAM,WAA6C;CAC1F,MAAM,CAAC,WAAW,cAAc,MAAM;CAEtC,IAAI,CAAC,WAAW;EACd,QAAQ,MAAM,2CAA2C;EACzD,QAAQ,MAAM,2EAA2E;EACzF,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,eAAe,KAAK,QAAQ,QAAQ,IAAI,GAAG,SAAS;CAC1D,MAAM,aAAa,QAAQ;CAC3B,MAAM,cAAc,QAAQ,cAAc,OAAO,QAAQ,WAAW,IAAI;CAGxE,IAAI;CACJ,IAAI;EACF,OAAO,MAAM,GAAG,KAAK,YAAY;CACnC,QAAQ;EACN,QAAQ,MAAM,sBAAsB,cAAc;EAClD,QAAQ,KAAK,CAAC;CAChB;CAGA,MAAM,QAAQ,aAAa,QAAQ,IAAI,UAAU,IAAI;CACrD,MAAM,cAAc,cAAc,OAAO,IAAI,iBAAiB;CAE9D,QAAQ,IAAI,mBAAmB,aAAa;CAC5C,QAAQ,IAAI,iBAAiB,cAAc;CAC3C,QAAQ,IAAI,iBAAiB,eAAe,SAAS,GAAG;CAExD,IAAI,KAAK,YAAY,GAAG;EAEtB,MAAM,SAAS,MAAM,MAAM,aAAa,cAAc,aAAa;GACjE;GAEA,SAAS,GAAG,QAAQ,CAAC,KAAK,SAAS,GAAG,CAAC,CAAC,WAAW,GAAG;GACtD,aAAa,MAAM,OAAO,SAAS;IACjC,QAAQ,OAAO,MAAM,mBAAmB,KAAK,GAAG,MAAM,IAAI,KAAK,MAAM;GACvE;EACF,CAAC;EAGD,QAAQ,OAAO,MAAM,IAAI;EACzB,QAAQ,IAAI,UAAU,OAAO,SAAS,OAAO,kBAAkB;EAE/D,IAAI,OAAO,OAAO,SAAS,GAAG;GAC5B,QAAQ,KAAK,UAAU,OAAO,OAAO,OAAO,iBAAiB;GAC7D,KAAK,MAAM,EAAE,WAAW,IAAI,WAAW,OAAO,QAC5C,QAAQ,KAAK,UAAU,GAAG,IAAI,MAAM,SAAS;EAEjD;CACF,OAAO;EAGL,MAAM,cAAc,eAAe,KAAK,SAAS,YAAY;EAE7D,QAAQ,IAAI,iBAAiB,KAAK,SAAS,YAAY,EAAE,KAAK,aAAa;EAE3E,MAAM,OAAO,MAAM,MAAM,IAAI,cAAc,WAAW;EAEtD,QAAQ,IAAI,oBAAoB,KAAK,KAAK;CAC5C;CAEA,QAAQ,IAAI;AACd"}

package/esm/cli/commands/storage-put.command.mjs

@@ -1,4 +1,4 @@
-import { command } from "../cli-command.mjs";
+import { command } from "../../commands/cli-command.mjs";
 import { storagePutAction } from "./storage-put.action.mjs";
 
 //#region ../core/src/cli/commands/storage-put.command.ts

package/esm/cli/commands/storage-put.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage-put.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/storage-put.command.ts"],"sourcesContent":["import { command } from \"../cli-command\";\nimport { storagePutAction } from \"./storage-put.action\";\n\n/**\n * `storage.put` CLI command\n *\n * Uploads a local file or directory to any configured storage driver.\n * Auto-detects file vs directory and streams each file (no full buffer in memory).\n *\n * @example\n * # Upload full uploads/ directory to R2 (migrating from local to cloud)\n * warlock storage.put ./uploads --driver r2\n *\n * @example\n * # Upload under a specific prefix\n * warlock storage.put ./uploads backups/2026 --driver r2\n *\n * @example\n * # Single file upload to default driver\n * warlock storage.put ./public/logo.png assets/logo.png\n */\nexport const storagePutCommand = command({\n  name: \"storage.put <localPath> [destination]\",\n  alias: \"sput\",\n  action: storagePutAction,\n  description: \"Upload a local file or directory to storage\",\n  preload: {\n    env: true,\n    config: [\"storage\"],\n    connectors: [\"storage\"],\n  },\n  options: [\n    {\n      text: \"--driver, -d\",\n      description:\n        \"Storage driver name (as defined in config). Defaults to the configured default driver.\",\n    },\n    {\n      text: \"--concurrency, -c\",\n      description: \"Number of concurrent uploads when uploading a directory\",\n      type: \"number\",\n      defaultValue: 5,\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,oBAAoB,QAAQ;CACvC,MAAM;CACN,OAAO;CACP,QAAQ;CACR,aAAa;CACb,SAAS;EACP,KAAK;EACL,QAAQ,CAAC,SAAS;EAClB,YAAY,CAAC,SAAS;CACxB;CACA,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,GACA;EACE,MAAM;EACN,aAAa;EACb,MAAM;EACN,cAAc;CAChB,CACF;AACF,CAAC"}
+{"version":3,"file":"storage-put.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/storage-put.command.ts"],"sourcesContent":["import { command } from \"../../commands/cli-command\";\r\nimport { storagePutAction } from \"./storage-put.action\";\r\n\r\n/**\r\n * `storage.put` CLI command\r\n *\r\n * Uploads a local file or directory to any configured storage driver.\r\n * Auto-detects file vs directory and streams each file (no full buffer in memory).\r\n *\r\n * @example\r\n * # Upload full uploads/ directory to R2 (migrating from local to cloud)\r\n * warlock storage.put ./uploads --driver r2\r\n *\r\n * @example\r\n * # Upload under a specific prefix\r\n * warlock storage.put ./uploads backups/2026 --driver r2\r\n *\r\n * @example\r\n * # Single file upload to default driver\r\n * warlock storage.put ./public/logo.png assets/logo.png\r\n */\r\nexport const storagePutCommand = command({\r\n  name: \"storage.put <localPath> [destination]\",\r\n  alias: \"sput\",\r\n  action: storagePutAction,\r\n  description: \"Upload a local file or directory to storage\",\r\n  preload: {\r\n    env: true,\r\n    config: [\"storage\"],\r\n    connectors: [\"storage\"],\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--driver, -d\",\r\n      description:\r\n        \"Storage driver name (as defined in config). Defaults to the configured default driver.\",\r\n    },\r\n    {\r\n      text: \"--concurrency, -c\",\r\n      description: \"Number of concurrent uploads when uploading a directory\",\r\n      type: \"number\",\r\n      defaultValue: 5,\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,oBAAoB,QAAQ;CACvC,MAAM;CACN,OAAO;CACP,QAAQ;CACR,aAAa;CACb,SAAS;EACP,KAAK;EACL,QAAQ,CAAC,SAAS;EAClB,YAAY,CAAC,SAAS;CACxB;CACA,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,GACA;EACE,MAAM;EACN,aAAa;EACb,MAAM;EACN,cAAc;CAChB,CACF;AACF,CAAC"}

package/esm/cli/commands/typings-generator.command.mjs

@@ -1,7 +1,7 @@
+import { Path } from "../../utils/normalized-path.mjs";
 import { srcPath } from "../../utils/paths.mjs";
 import "../../utils/index.mjs";
-import { command } from "../cli-command.mjs";
-import { Path } from "../../dev-server/path.mjs";
+import { command } from "../../commands/cli-command.mjs";
 import { getFilesFromDirectory } from "../../dev-server/utils.mjs";
 import { filesOrchestrator } from "../../dev-server/files-orchestrator.mjs";
 import { typeGenerator } from "../../dev-server/type-generator.mjs";

package/esm/cli/commands/typings-generator.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"typings-generator.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/typings-generator.command.ts"],"sourcesContent":["import { filesOrchestrator } from \"../../dev-server/files-orchestrator\";\nimport { Path } from \"../../dev-server/path\";\nimport { typeGenerator } from \"../../dev-server/type-generator\";\nimport { getFilesFromDirectory } from \"../../dev-server/utils\";\nimport { srcPath } from \"../../utils\";\nimport { command } from \"../cli-command\";\n\nexport const typingsGeneratorCommand = command({\n  name: \"generate.typings\",\n  description: \"Generate type definitions for the project\",\n  options: [\n    {\n      text: \"--files, -f\",\n      description:\n        \"Files to generate typings for, if not passed, it will generate typings for all files\",\n    },\n  ],\n  action: async ({ options }) => {\n    const configFilesPaths: string[] = [];\n    if (options.files) {\n      const files = String(options.files)\n        .split(\",\")\n        .map((file) => {\n          if (file.startsWith(\"./\")) {\n            return Path.toAbsolute(file);\n          }\n\n          return file;\n        });\n\n      if (files?.length) {\n        configFilesPaths.push(...files);\n      }\n    }\n\n    if (configFilesPaths.length === 0) {\n      // grab all config files\n      const configFiles = await getFilesFromDirectory(srcPath(\"config\"));\n      configFilesPaths.push(...configFiles);\n    }\n\n    const results = await Promise.allSettled(\n      configFilesPaths.map((path) => filesOrchestrator.add(Path.toRelative(path))),\n    );\n\n    const failed = results.filter((r) => r.status === \"rejected\");\n\n    if (failed.length) {\n      console.warn(`Failed to process ${failed.length} files`);\n    }\n\n    await typeGenerator.generateAll();\n  },\n});\n"],"mappings":";;;;;;;;;AAOA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,CACF;CACA,QAAQ,OAAO,EAAE,cAAc;EAC7B,MAAM,mBAA6B,CAAC;EACpC,IAAI,QAAQ,OAAO;GACjB,MAAM,QAAQ,OAAO,QAAQ,KAAK,CAAC,CAChC,MAAM,GAAG,CAAC,CACV,KAAK,SAAS;IACb,IAAI,KAAK,WAAW,IAAI,GACtB,OAAO,KAAK,WAAW,IAAI;IAG7B,OAAO;GACT,CAAC;GAEH,IAAI,OAAO,QACT,iBAAiB,KAAK,GAAG,KAAK;EAElC;EAEA,IAAI,iBAAiB,WAAW,GAAG;GAEjC,MAAM,cAAc,MAAM,sBAAsB,QAAQ,QAAQ,CAAC;GACjE,iBAAiB,KAAK,GAAG,WAAW;EACtC;EAMA,MAAM,UAAS,MAJO,QAAQ,WAC5B,iBAAiB,KAAK,SAAS,kBAAkB,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,CAC7E,EAEsB,CAAC,QAAQ,MAAM,EAAE,WAAW,UAAU;EAE5D,IAAI,OAAO,QACT,QAAQ,KAAK,qBAAqB,OAAO,OAAO,OAAO;EAGzD,MAAM,cAAc,YAAY;CAClC;AACF,CAAC"}
+{"version":3,"file":"typings-generator.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/typings-generator.command.ts"],"sourcesContent":["import { filesOrchestrator } from \"../../dev-server/files-orchestrator\";\r\nimport { Path } from \"../../utils/normalized-path\";\r\nimport { typeGenerator } from \"../../dev-server/type-generator\";\r\nimport { getFilesFromDirectory } from \"../../dev-server/utils\";\r\nimport { srcPath } from \"../../utils\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const typingsGeneratorCommand = command({\r\n  name: \"generate.typings\",\r\n  description: \"Generate type definitions for the project\",\r\n  options: [\r\n    {\r\n      text: \"--files, -f\",\r\n      description:\r\n        \"Files to generate typings for, if not passed, it will generate typings for all files\",\r\n    },\r\n  ],\r\n  action: async ({ options }) => {\r\n    const configFilesPaths: string[] = [];\r\n    if (options.files) {\r\n      const files = String(options.files)\r\n        .split(\",\")\r\n        .map((file) => {\r\n          if (file.startsWith(\"./\")) {\r\n            return Path.toAbsolute(file);\r\n          }\r\n\r\n          return file;\r\n        });\r\n\r\n      if (files?.length) {\r\n        configFilesPaths.push(...files);\r\n      }\r\n    }\r\n\r\n    if (configFilesPaths.length === 0) {\r\n      // grab all config files\r\n      const configFiles = await getFilesFromDirectory(srcPath(\"config\"));\r\n      configFilesPaths.push(...configFiles);\r\n    }\r\n\r\n    const results = await Promise.allSettled(\r\n      configFilesPaths.map((path) => filesOrchestrator.add(Path.toRelative(path))),\r\n    );\r\n\r\n    const failed = results.filter((r) => r.status === \"rejected\");\r\n\r\n    if (failed.length) {\r\n      console.warn(`Failed to process ${failed.length} files`);\r\n    }\r\n\r\n    await typeGenerator.generateAll();\r\n  },\r\n});\r\n"],"mappings":";;;;;;;;;AAOA,MAAa,0BAA0B,QAAQ;CAC7C,MAAM;CACN,aAAa;CACb,SAAS,CACP;EACE,MAAM;EACN,aACE;CACJ,CACF;CACA,QAAQ,OAAO,EAAE,cAAc;EAC7B,MAAM,mBAA6B,CAAC;EACpC,IAAI,QAAQ,OAAO;GACjB,MAAM,QAAQ,OAAO,QAAQ,KAAK,CAAC,CAChC,MAAM,GAAG,CAAC,CACV,KAAK,SAAS;IACb,IAAI,KAAK,WAAW,IAAI,GACtB,OAAO,KAAK,WAAW,IAAI;IAG7B,OAAO;GACT,CAAC;GAEH,IAAI,OAAO,QACT,iBAAiB,KAAK,GAAG,KAAK;EAElC;EAEA,IAAI,iBAAiB,WAAW,GAAG;GAEjC,MAAM,cAAc,MAAM,sBAAsB,QAAQ,QAAQ,CAAC;GACjE,iBAAiB,KAAK,GAAG,WAAW;EACtC;EAMA,MAAM,UAAS,MAJO,QAAQ,WAC5B,iBAAiB,KAAK,SAAS,kBAAkB,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,CAC7E,EAEsB,CAAC,QAAQ,MAAM,EAAE,WAAW,UAAU;EAE5D,IAAI,OAAO,QACT,QAAQ,KAAK,qBAAqB,OAAO,OAAO,OAAO;EAGzD,MAAM,cAAc,YAAY;CAClC;AACF,CAAC"}

package/esm/cli/commands/update.command.mjs

@@ -1,4 +1,4 @@
-import { command } from "../cli-command.mjs";
+import { command } from "../../commands/cli-command.mjs";
 import { updateWarlockPackages } from "../../updater/update-warlock-packages.mjs";
 import { colors } from "@mongez/copper";
 

package/esm/cli/commands/update.command.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"update.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/update.command.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { updateWarlockPackages } from \"../../updater/update-warlock-packages\";\nimport { command } from \"../cli-command\";\n\nexport const updateCommand = command({\n  name: \"update\",\n  description: \"Update all @warlock.js packages in this project to their latest version\",\n  action: async (data) => {\n    // `parseCliArgs` camelCases every flag, so `--no-install` arrives as\n    // `options.noInstall` (not `options[\"no-install\"]`).\n    const check = Boolean(data.options.check);\n    const dryRun = check || Boolean(data.options.dryRun);\n\n    const result = await updateWarlockPackages({\n      install: !data.options.noInstall,\n      dryRun,\n    });\n\n    // `updateWarlockPackages` resolves on a failed install so the dev-server\n    // shortcut can survive it; a one-shot CLI run must still exit non-zero.\n    if (result.outcome === \"install-failed\") {\n      throw result.error ?? new Error(\"Package manager install failed.\");\n    }\n\n    // `--check` is a gate, so its exit code carries the answer: 0 current,\n    // 1 behind. `--dry-run` only reports, and always succeeds.\n    if (check && result.outcome === \"outdated\") {\n      console.log(\n        colors.dim(\"Run \") +\n          colors.cyan(\"warlock update\") +\n          colors.dim(\" to apply these, or --dry-run to preview without a gate.\"),\n      );\n      process.exit(1);\n    }\n  },\n  options: [\n    {\n      text: \"--no-install\",\n      description:\n        \"Rewrite the @warlock.js versions in package.json without running the package manager install\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--dry-run\",\n      description: \"Show which packages would be updated without changing package.json\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--check\",\n      description:\n        \"Like --dry-run, but exits 1 when any package is behind — a CI gate for staying current\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;AAIA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aAAa;CACb,QAAQ,OAAO,SAAS;EAGtB,MAAM,QAAQ,QAAQ,KAAK,QAAQ,KAAK;EACxC,MAAM,SAAS,SAAS,QAAQ,KAAK,QAAQ,MAAM;EAEnD,MAAM,SAAS,MAAM,sBAAsB;GACzC,SAAS,CAAC,KAAK,QAAQ;GACvB;EACF,CAAC;EAID,IAAI,OAAO,YAAY,kBACrB,MAAM,OAAO,yBAAS,IAAI,MAAM,iCAAiC;EAKnE,IAAI,SAAS,OAAO,YAAY,YAAY;GAC1C,QAAQ,IACN,OAAO,IAAI,MAAM,IACf,OAAO,KAAK,gBAAgB,IAC5B,OAAO,IAAI,0DAA0D,CACzE;GACA,QAAQ,KAAK,CAAC;EAChB;CACF;CACA,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"update.command.mjs","names":[],"sources":["../../../../../../../../core/src/cli/commands/update.command.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { updateWarlockPackages } from \"../../updater/update-warlock-packages\";\r\nimport { command } from \"../../commands/cli-command\";\r\n\r\nexport const updateCommand = command({\r\n  name: \"update\",\r\n  description: \"Update all @warlock.js packages in this project to their latest version\",\r\n  action: async (data) => {\r\n    // `parseCliArgs` camelCases every flag, so `--no-install` arrives as\r\n    // `options.noInstall` (not `options[\"no-install\"]`).\r\n    const check = Boolean(data.options.check);\r\n    const dryRun = check || Boolean(data.options.dryRun);\r\n\r\n    const result = await updateWarlockPackages({\r\n      install: !data.options.noInstall,\r\n      dryRun,\r\n    });\r\n\r\n    // `updateWarlockPackages` resolves on a failed install so the dev-server\r\n    // shortcut can survive it; a one-shot CLI run must still exit non-zero.\r\n    if (result.outcome === \"install-failed\") {\r\n      throw result.error ?? new Error(\"Package manager install failed.\");\r\n    }\r\n\r\n    // `--check` is a gate, so its exit code carries the answer: 0 current,\r\n    // 1 behind. `--dry-run` only reports, and always succeeds.\r\n    if (check && result.outcome === \"outdated\") {\r\n      console.log(\r\n        colors.dim(\"Run \") +\r\n          colors.cyan(\"warlock update\") +\r\n          colors.dim(\" to apply these, or --dry-run to preview without a gate.\"),\r\n      );\r\n      process.exit(1);\r\n    }\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--no-install\",\r\n      description:\r\n        \"Rewrite the @warlock.js versions in package.json without running the package manager install\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--dry-run\",\r\n      description: \"Show which packages would be updated without changing package.json\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--check\",\r\n      description:\r\n        \"Like --dry-run, but exits 1 when any package is behind — a CI gate for staying current\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;AAIA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aAAa;CACb,QAAQ,OAAO,SAAS;EAGtB,MAAM,QAAQ,QAAQ,KAAK,QAAQ,KAAK;EACxC,MAAM,SAAS,SAAS,QAAQ,KAAK,QAAQ,MAAM;EAEnD,MAAM,SAAS,MAAM,sBAAsB;GACzC,SAAS,CAAC,KAAK,QAAQ;GACvB;EACF,CAAC;EAID,IAAI,OAAO,YAAY,kBACrB,MAAM,OAAO,yBAAS,IAAI,MAAM,iCAAiC;EAKnE,IAAI,SAAS,OAAO,YAAY,YAAY;GAC1C,QAAQ,IACN,OAAO,IAAI,MAAM,IACf,OAAO,KAAK,gBAAgB,IAC5B,OAAO,IAAI,0DAA0D,CACzE;GACA,QAAQ,KAAK,CAAC;EAChB;CACF;CACA,SAAS;EACP;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands-loader.mjs

@@ -1,6 +1,6 @@
+import { Path } from "../utils/normalized-path.mjs";
 import { srcPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
-import { Path } from "../dev-server/path.mjs";
 import { getFilesFromDirectory } from "../dev-server/utils.mjs";
 import { filesOrchestrator } from "../dev-server/files-orchestrator.mjs";
 import { isMatchingCommandName } from "./cli-commands.utils.mjs";

package/esm/cli/commands-loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"commands-loader.mjs","names":[],"sources":["../../../../../../../core/src/cli/commands-loader.ts"],"sourcesContent":["import { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { Path } from \"../dev-server/path\";\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\nimport { srcPath } from \"../utils\";\nimport { CLICommand } from \"./cli-command\";\nimport { isMatchingCommandName } from \"./cli-commands.utils\";\n\nexport class CLICommandsLoader {\n  /**\n   * Locate command by name\n   */\n  public async locate(commandName: string): Promise<CLICommand | undefined> {\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\n    // now convert them into relative paths\n    const relativeFiles = files.map((path) => Path.toRelative(path));\n\n    for (const relativeFile of relativeFiles) {\n      const command = await this.load(relativeFile);\n      if (command) {\n        command.$relativePath(relativeFile);\n        if (isMatchingCommandName(command.name, commandName)) {\n          return command;\n        }\n      }\n    }\n\n    return;\n  }\n\n  /**\n   * Scan all project commands and return them\n   * Used for warm cache functionality\n   */\n  public async scanAll(): Promise<CLICommand[]> {\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\n    const relativeFiles = files.map((path) => Path.toRelative(path));\n    const commands: CLICommand[] = [];\n\n    for (const relativeFile of relativeFiles) {\n      const command = await this.load(relativeFile);\n      if (command) {\n        command.$relativePath(relativeFile);\n        commands.push(command);\n      }\n    }\n\n    return commands;\n  }\n\n  /**\n   * Load command from a relative path\n   */\n  public async load(relativePath: string): Promise<CLICommand | undefined> {\n    const output = await filesOrchestrator.load<{ default: CLICommand }>(relativePath);\n\n    return output?.default;\n  }\n}\n\nexport const cliCommandsLoader = new CLICommandsLoader();\n"],"mappings":";;;;;;;;AAOA,IAAa,oBAAb,MAA+B;;;;CAI7B,MAAa,OAAO,aAAsD;EAGxE,MAAM,iBAAgB,MAFF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,EAEvD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAE/D,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,IAAI,sBAAsB,QAAQ,MAAM,WAAW,GACjD,OAAO;GAEX;EACF;CAGF;;;;;CAMA,MAAa,UAAiC;EAE5C,MAAM,iBAAgB,MADF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,EACvD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAC/D,MAAM,WAAyB,CAAC;EAEhC,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,SAAS,KAAK,OAAO;GACvB;EACF;EAEA,OAAO;CACT;;;;CAKA,MAAa,KAAK,cAAuD;EAGvE,QAAO,MAFc,kBAAkB,KAA8B,YAAY,EAEpE,EAAE;CACjB;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}
+{"version":3,"file":"commands-loader.mjs","names":[],"sources":["../../../../../../../core/src/cli/commands-loader.ts"],"sourcesContent":["import { 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 { CLICommand } from \"../commands/cli-command\";\r\nimport { isMatchingCommandName } from \"./cli-commands.utils\";\r\n\r\nexport class CLICommandsLoader {\r\n  /**\r\n   * Locate command by name\r\n   */\r\n  public async locate(commandName: string): Promise<CLICommand | undefined> {\r\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\r\n    // now convert them into relative paths\r\n    const relativeFiles = files.map((path) => Path.toRelative(path));\r\n\r\n    for (const relativeFile of relativeFiles) {\r\n      const command = await this.load(relativeFile);\r\n      if (command) {\r\n        command.$relativePath(relativeFile);\r\n        if (isMatchingCommandName(command.name, commandName)) {\r\n          return command;\r\n        }\r\n      }\r\n    }\r\n\r\n    return;\r\n  }\r\n\r\n  /**\r\n   * Scan all project commands and return them\r\n   * Used for warm cache functionality\r\n   */\r\n  public async scanAll(): Promise<CLICommand[]> {\r\n    const files = await getFilesFromDirectory(srcPath(\"app\"), \"**/commands/*.{ts,tsx}\");\r\n    const relativeFiles = files.map((path) => Path.toRelative(path));\r\n    const commands: CLICommand[] = [];\r\n\r\n    for (const relativeFile of relativeFiles) {\r\n      const command = await this.load(relativeFile);\r\n      if (command) {\r\n        command.$relativePath(relativeFile);\r\n        commands.push(command);\r\n      }\r\n    }\r\n\r\n    return commands;\r\n  }\r\n\r\n  /**\r\n   * Load command from a relative path\r\n   */\r\n  public async load(relativePath: string): Promise<CLICommand | undefined> {\r\n    const output = await filesOrchestrator.load<{ default: CLICommand }>(relativePath);\r\n\r\n    return output?.default;\r\n  }\r\n}\r\n\r\nexport const cliCommandsLoader = new CLICommandsLoader();\r\n"],"mappings":";;;;;;;;AAOA,IAAa,oBAAb,MAA+B;;;;CAI7B,MAAa,OAAO,aAAsD;EAGxE,MAAM,iBAAgB,MAFF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,EAEvD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAE/D,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,IAAI,sBAAsB,QAAQ,MAAM,WAAW,GACjD,OAAO;GAEX;EACF;CAGF;;;;;CAMA,MAAa,UAAiC;EAE5C,MAAM,iBAAgB,MADF,sBAAsB,QAAQ,KAAK,GAAG,wBAAwB,EACvD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;EAC/D,MAAM,WAAyB,CAAC;EAEhC,KAAK,MAAM,gBAAgB,eAAe;GACxC,MAAM,UAAU,MAAM,KAAK,KAAK,YAAY;GAC5C,IAAI,SAAS;IACX,QAAQ,cAAc,YAAY;IAClC,SAAS,KAAK,OAAO;GACvB;EACF;EAEA,OAAO;CACT;;;;CAKA,MAAa,KAAK,cAAuD;EAGvE,QAAO,MAFc,kBAAkB,KAA8B,YAAY,EAEpE,EAAE;CACjB;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}

package/esm/cli/parse-cli-args.mjs

@@ -2,22 +2,93 @@ import { toCamelCase } from "@mongez/reinforcements";
 
 //#region ../core/src/cli/parse-cli-args.ts
 /**
+* Thrown when a declared boolean option is given a value that is neither
+* true-ish nor false-ish.
+*
+* We refuse to guess. Guessing is exactly what produced #21: `--rollback=false`
+* was kept as the truthy string `"false"` and dropped every table. An option
+* that gates a destructive action must fail loudly on input it cannot read.
+*/
+var CliOptionValueError = class extends Error {
+	constructor(optionToken, value) {
+		super(`Invalid value ${JSON.stringify(value)} for boolean option ${optionToken}. Expected one of: true, false, 1, 0, yes, no — or pass ${optionToken} on its own for true.`);
+		this.optionToken = optionToken;
+		this.value = value;
+		this.name = "CliOptionValueError";
+	}
+};
+const TRUE_VALUES = new Set([
+	"true",
+	"1",
+	"yes"
+]);
+const FALSE_VALUES = new Set([
+	"false",
+	"0",
+	"no"
+]);
+/**
+* Collect the camelCased keys (names AND aliases) of every option the command
+* declared as `type: "boolean"`.
+*
+* Both sides are camelCased because declared names keep their raw kebab form
+* (`"pending-only"`) while the parser emits camelCase keys (`pendingOnly`).
+*/
+function collectBooleanKeys(schema) {
+	const keys = /* @__PURE__ */ new Set();
+	for (const option of schema) {
+		if (option.type !== "boolean") continue;
+		if (option.name) keys.add(toCamelCase(option.name));
+		if (option.alias) keys.add(toCamelCase(option.alias));
+	}
+	return keys;
+}
+/**
+* Turn the value written after `=` into a real boolean, or throw.
+*/
+function toBoolean(optionToken, value) {
+	const normalized = value.toLowerCase();
+	if (TRUE_VALUES.has(normalized)) return true;
+	if (FALSE_VALUES.has(normalized)) return false;
+	throw new CliOptionValueError(optionToken, value);
+}
+/**
 * Parse CLI arguments from process.argv
 *
+* Called with a `schema` (the resolved command's declared options), every
+* option declared `type: "boolean"` is resolved as a boolean:
+* `--flag` → true, `--flag=false|0|no` → false, `--flag=true|1|yes` → true,
+* and `--flag <token>` leaves `<token>` as a POSITIONAL instead of swallowing
+* it as the flag's value. Anything else throws {@link CliOptionValueError}.
+*
+* Called without a schema — which is how the command name is discovered,
+* before any command object exists — behaviour is unchanged: every value stays
+* a raw string and a bare `--flag` still consumes the following non-dash token.
+* Nothing is blanket-coerced here on purpose: `--name=false` on a string-typed
+* option must survive as the string `"false"`.
+*
+* Options the schema does not declare keep the schema-less behaviour.
+*
 * @example
 * parseCliArgs(["node", "warlock", "migrate", "--rollback", "file.ts"])
 * // Returns: { name: "migrate", args: [], options: { rollback: "file.ts" } }
 *
 * @example
+* // `rollback` declared as type: "boolean" — the file stays a positional
+* parseCliArgs(["node", "warlock", "migrate", "--rollback", "file.ts"], migrateOptions)
+* // Returns: { name: "migrate", args: ["file.ts"], options: { rollback: true } }
+*
+* @example
 * parseCliArgs(["node", "warlock", "dev", "--port=3000", "--fresh"])
 * // Returns: { name: "dev", args: [], options: { port: "3000", fresh: true } }
 */
-function parseCliArgs(argv) {
+function parseCliArgs(argv, schema = []) {
 	const potentialCommand = argv[2] || "";
 	const isFirstArgOption = potentialCommand.startsWith("-");
 	const command = isFirstArgOption ? "" : potentialCommand;
 	const args = [];
 	const options = {};
+	const booleanKeys = collectBooleanKeys(schema);
 	const startIndex = isFirstArgOption ? 2 : 3;
 	for (let i = startIndex; i < argv.length; i++) {
 		const arg = argv[i];
@@ -26,11 +97,13 @@ function parseCliArgs(argv) {
 			const equalIndex = withoutDashes.indexOf("=");
 			if (equalIndex !== -1) {
 				const key = toCamelCase(withoutDashes.slice(0, equalIndex));
-				options[key] = withoutDashes.slice(equalIndex + 1);
+				const value = withoutDashes.slice(equalIndex + 1);
+				options[key] = booleanKeys.has(key) ? toBoolean(`--${withoutDashes.slice(0, equalIndex)}`, value) : value;
 			} else {
 				const key = toCamelCase(withoutDashes);
 				const nextArg = argv[i + 1];
-				if (nextArg && !nextArg.startsWith("-")) {
+				if (booleanKeys.has(key)) options[key] = true;
+				else if (nextArg && !nextArg.startsWith("-")) {
 					options[key] = nextArg;
 					i++;
 				} else options[key] = true;
@@ -39,14 +112,18 @@ function parseCliArgs(argv) {
 			const flags = arg.slice(1);
 			const equalIndex = flags.indexOf("=");
 			if (equalIndex !== -1) {
-				const key = toCamelCase(flags.slice(0, equalIndex));
-				options[key] = flags.slice(equalIndex + 1);
+				const rawKey = flags.slice(0, equalIndex);
+				const key = toCamelCase(rawKey);
+				const value = flags.slice(equalIndex + 1);
+				options[key] = booleanKeys.has(key) ? toBoolean(`-${rawKey}`, value) : value;
 			} else if (flags.length === 1) {
+				const key = toCamelCase(flags);
 				const nextArg = argv[i + 1];
-				if (nextArg && !nextArg.startsWith("-")) {
-					options[toCamelCase(flags)] = nextArg;
+				if (booleanKeys.has(key)) options[key] = true;
+				else if (nextArg && !nextArg.startsWith("-")) {
+					options[key] = nextArg;
 					i++;
-				} else options[toCamelCase(flags)] = true;
+				} else options[key] = true;
 			} else for (const flag of flags) options[toCamelCase(flag)] = true;
 		} else args.push(arg);
 	}
@@ -58,5 +135,5 @@ function parseCliArgs(argv) {
 }
 
 //#endregion
-export { parseCliArgs };
+export { CliOptionValueError, parseCliArgs };
 //# sourceMappingURL=parse-cli-args.mjs.map

package/esm/cli/parse-cli-args.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-cli-args.mjs","names":[],"sources":["../../../../../../../core/src/cli/parse-cli-args.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\n\nexport type ParsedCliArgs = {\n  name: string;\n  args: string[];\n  options: Record<string, string | boolean>;\n};\n\n/**\n * Parse CLI arguments from process.argv\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"])\n * // Returns: { name: \"migrate\", args: [], options: { rollback: \"file.ts\" } }\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"dev\", \"--port=3000\", \"--fresh\"])\n * // Returns: { name: \"dev\", args: [], options: { port: \"3000\", fresh: true } }\n */\nexport function parseCliArgs(argv: string[]): ParsedCliArgs {\n  // Command is at index 2 (after \"node\" and script path)\n  // But if index 2 starts with \"-\", it's an option, not a command\n  const potentialCommand = argv[2] || \"\";\n  const isFirstArgOption = potentialCommand.startsWith(\"-\");\n  const command = isFirstArgOption ? \"\" : potentialCommand;\n  const args: string[] = [];\n  const options: Record<string, string | boolean> = {};\n\n  // Parse arguments starting from index 3 (or 2 if first arg was an option)\n  const startIndex = isFirstArgOption ? 2 : 3;\n  for (let i = startIndex; i < argv.length; i++) {\n    const arg = argv[i];\n\n    if (arg.startsWith(\"--\")) {\n      // Long option: --key or --key=value\n      const withoutDashes = arg.slice(2);\n      const equalIndex = withoutDashes.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // --key=value format\n        const key = toCamelCase(withoutDashes.slice(0, equalIndex));\n        const value = withoutDashes.slice(equalIndex + 1);\n        options[key] = value;\n      } else {\n        // --key format (check if next arg is a value)\n        const key = toCamelCase(withoutDashes);\n        const nextArg = argv[i + 1];\n\n        // If next arg exists and doesn't start with -, treat it as value\n        if (nextArg && !nextArg.startsWith(\"-\")) {\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      }\n    } else if (arg.startsWith(\"-\") && arg.length > 1) {\n      // Short option: -f, -t=value, or -abc (multiple flags)\n      const flags = arg.slice(1);\n      const equalIndex = flags.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // -t=value format\n        const key = toCamelCase(flags.slice(0, equalIndex));\n        const value = flags.slice(equalIndex + 1);\n        options[key] = value;\n      } else if (flags.length === 1) {\n        // Single flag: -f\n        const nextArg = argv[i + 1];\n\n        if (nextArg && !nextArg.startsWith(\"-\")) {\n          options[toCamelCase(flags)] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[toCamelCase(flags)] = true;\n        }\n      } else {\n        // Multiple flags: -abc becomes { a: true, b: true, c: true }\n        for (const flag of flags) {\n          options[toCamelCase(flag)] = true;\n        }\n      }\n    } else {\n      // Positional argument\n      args.push(arg);\n    }\n  }\n\n  return { name: command, args, options };\n}\n"],"mappings":";;;;;;;;;;;;;;AAmBA,SAAgB,aAAa,MAA+B;CAG1D,MAAM,mBAAmB,KAAK,MAAM;CACpC,MAAM,mBAAmB,iBAAiB,WAAW,GAAG;CACxD,MAAM,UAAU,mBAAmB,KAAK;CACxC,MAAM,OAAiB,CAAC;CACxB,MAAM,UAA4C,CAAC;CAGnD,MAAM,aAAa,mBAAmB,IAAI;CAC1C,KAAK,IAAI,IAAI,YAAY,IAAI,KAAK,QAAQ,KAAK;EAC7C,MAAM,MAAM,KAAK;EAEjB,IAAI,IAAI,WAAW,IAAI,GAAG;GAExB,MAAM,gBAAgB,IAAI,MAAM,CAAC;GACjC,MAAM,aAAa,cAAc,QAAQ,GAAG;GAE5C,IAAI,eAAe,IAAI;IAErB,MAAM,MAAM,YAAY,cAAc,MAAM,GAAG,UAAU,CAAC;IAE1D,QAAQ,OADM,cAAc,MAAM,aAAa,CAC5B;GACrB,OAAO;IAEL,MAAM,MAAM,YAAY,aAAa;IACrC,MAAM,UAAU,KAAK,IAAI;IAGzB,IAAI,WAAW,CAAC,QAAQ,WAAW,GAAG,GAAG;KACvC,QAAQ,OAAO;KACf;IACF,OACE,QAAQ,OAAO;GAEnB;EACF,OAAO,IAAI,IAAI,WAAW,GAAG,KAAK,IAAI,SAAS,GAAG;GAEhD,MAAM,QAAQ,IAAI,MAAM,CAAC;GACzB,MAAM,aAAa,MAAM,QAAQ,GAAG;GAEpC,IAAI,eAAe,IAAI;IAErB,MAAM,MAAM,YAAY,MAAM,MAAM,GAAG,UAAU,CAAC;IAElD,QAAQ,OADM,MAAM,MAAM,aAAa,CACpB;GACrB,OAAO,IAAI,MAAM,WAAW,GAAG;IAE7B,MAAM,UAAU,KAAK,IAAI;IAEzB,IAAI,WAAW,CAAC,QAAQ,WAAW,GAAG,GAAG;KACvC,QAAQ,YAAY,KAAK,KAAK;KAC9B;IACF,OACE,QAAQ,YAAY,KAAK,KAAK;GAElC,OAEE,KAAK,MAAM,QAAQ,OACjB,QAAQ,YAAY,IAAI,KAAK;EAGnC,OAEE,KAAK,KAAK,GAAG;CAEjB;CAEA,OAAO;EAAE,MAAM;EAAS;EAAM;CAAQ;AACxC"}
+{"version":3,"file":"parse-cli-args.mjs","names":[],"sources":["../../../../../../../core/src/cli/parse-cli-args.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\n\nexport type ParsedCliArgs = {\n  name: string;\n  args: string[];\n  options: Record<string, string | boolean>;\n};\n\n/**\n * The slice of a declared command option this parser needs.\n *\n * `CLICommand.commandOptions` (`ResolvedCLICommandOption[]`) satisfies it, but\n * the parser stays independent of the command classes so it can be unit-tested\n * and reused with a hand-written schema.\n */\nexport type CliOptionSchema = {\n  name?: string;\n  alias?: string;\n  type?: \"string\" | \"boolean\" | \"number\";\n};\n\n/**\n * Thrown when a declared boolean option is given a value that is neither\n * true-ish nor false-ish.\n *\n * We refuse to guess. Guessing is exactly what produced #21: `--rollback=false`\n * was kept as the truthy string `\"false\"` and dropped every table. An option\n * that gates a destructive action must fail loudly on input it cannot read.\n */\nexport class CliOptionValueError extends Error {\n  public constructor(\n    public readonly optionToken: string,\n    public readonly value: string,\n  ) {\n    super(\n      `Invalid value ${JSON.stringify(value)} for boolean option ${optionToken}. ` +\n        `Expected one of: true, false, 1, 0, yes, no — or pass ${optionToken} on its own for true.`,\n    );\n\n    this.name = \"CliOptionValueError\";\n  }\n}\n\nconst TRUE_VALUES = new Set([\"true\", \"1\", \"yes\"]);\nconst FALSE_VALUES = new Set([\"false\", \"0\", \"no\"]);\n\n/**\n * Collect the camelCased keys (names AND aliases) of every option the command\n * declared as `type: \"boolean\"`.\n *\n * Both sides are camelCased because declared names keep their raw kebab form\n * (`\"pending-only\"`) while the parser emits camelCase keys (`pendingOnly`).\n */\nfunction collectBooleanKeys(schema: CliOptionSchema[]): Set<string> {\n  const keys = new Set<string>();\n\n  for (const option of schema) {\n    if (option.type !== \"boolean\") continue;\n\n    if (option.name) {\n      keys.add(toCamelCase(option.name));\n    }\n\n    if (option.alias) {\n      keys.add(toCamelCase(option.alias));\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Turn the value written after `=` into a real boolean, or throw.\n */\nfunction toBoolean(optionToken: string, value: string): boolean {\n  const normalized = value.toLowerCase();\n\n  if (TRUE_VALUES.has(normalized)) return true;\n  if (FALSE_VALUES.has(normalized)) return false;\n\n  throw new CliOptionValueError(optionToken, value);\n}\n\n/**\n * Parse CLI arguments from process.argv\n *\n * Called with a `schema` (the resolved command's declared options), every\n * option declared `type: \"boolean\"` is resolved as a boolean:\n * `--flag` → true, `--flag=false|0|no` → false, `--flag=true|1|yes` → true,\n * and `--flag <token>` leaves `<token>` as a POSITIONAL instead of swallowing\n * it as the flag's value. Anything else throws {@link CliOptionValueError}.\n *\n * Called without a schema — which is how the command name is discovered,\n * before any command object exists — behaviour is unchanged: every value stays\n * a raw string and a bare `--flag` still consumes the following non-dash token.\n * Nothing is blanket-coerced here on purpose: `--name=false` on a string-typed\n * option must survive as the string `\"false\"`.\n *\n * Options the schema does not declare keep the schema-less behaviour.\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"])\n * // Returns: { name: \"migrate\", args: [], options: { rollback: \"file.ts\" } }\n *\n * @example\n * // `rollback` declared as type: \"boolean\" — the file stays a positional\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"], migrateOptions)\n * // Returns: { name: \"migrate\", args: [\"file.ts\"], options: { rollback: true } }\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"dev\", \"--port=3000\", \"--fresh\"])\n * // Returns: { name: \"dev\", args: [], options: { port: \"3000\", fresh: true } }\n */\nexport function parseCliArgs(argv: string[], schema: CliOptionSchema[] = []): ParsedCliArgs {\n  // Command is at index 2 (after \"node\" and script path)\n  // But if index 2 starts with \"-\", it's an option, not a command\n  const potentialCommand = argv[2] || \"\";\n  const isFirstArgOption = potentialCommand.startsWith(\"-\");\n  const command = isFirstArgOption ? \"\" : potentialCommand;\n  const args: string[] = [];\n  const options: Record<string, string | boolean> = {};\n  const booleanKeys = collectBooleanKeys(schema);\n\n  // Parse arguments starting from index 3 (or 2 if first arg was an option)\n  const startIndex = isFirstArgOption ? 2 : 3;\n  for (let i = startIndex; i < argv.length; i++) {\n    const arg = argv[i];\n\n    if (arg.startsWith(\"--\")) {\n      // Long option: --key or --key=value\n      const withoutDashes = arg.slice(2);\n      const equalIndex = withoutDashes.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // --key=value format\n        const key = toCamelCase(withoutDashes.slice(0, equalIndex));\n        const value = withoutDashes.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key)\n          ? toBoolean(`--${withoutDashes.slice(0, equalIndex)}`, value)\n          : value;\n      } else {\n        // --key format (check if next arg is a value)\n        const key = toCamelCase(withoutDashes);\n        const nextArg = argv[i + 1];\n\n        // A declared boolean NEVER consumes the next token: `--rollback\n        // users.ts` means \"rollback, and here is a positional\", not \"rollback\n        // the file users.ts\". Swallowing it silently discarded the operator's\n        // only stated scope and rolled back everything.\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          // If next arg exists and doesn't start with -, treat it as value\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      }\n    } else if (arg.startsWith(\"-\") && arg.length > 1) {\n      // Short option: -f, -t=value, or -abc (multiple flags)\n      const flags = arg.slice(1);\n      const equalIndex = flags.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // -t=value format\n        const rawKey = flags.slice(0, equalIndex);\n        const key = toCamelCase(rawKey);\n        const value = flags.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key) ? toBoolean(`-${rawKey}`, value) : value;\n      } else if (flags.length === 1) {\n        // Single flag: -f\n        const key = toCamelCase(flags);\n        const nextArg = argv[i + 1];\n\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      } else {\n        // Multiple flags: -abc becomes { a: true, b: true, c: true }\n        // A bundle carries no value and never consumes the next token, so a\n        // declared boolean already resolves to `true` here.\n        for (const flag of flags) {\n          options[toCamelCase(flag)] = true;\n        }\n      }\n    } else {\n      // Positional argument\n      args.push(arg);\n    }\n  }\n\n  return { name: command, args, options };\n}\n"],"mappings":"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"}

package/esm/{cli → commands}/cli-command.d.mts

@@ -1,6 +1,6 @@
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./types.mjs";
 
-//#region ../core/src/cli/cli-command.d.ts
+//#region ../core/src/commands/cli-command.d.ts
 declare class CLICommand {
   name: string;
   /**

package/esm/commands/cli-command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.d.mts","names":[],"sources":["../../../../../../../core/src/commands/cli-command.ts"],"mappings":";;;cAUa,UAAA;EAqDF,IAAA;EArDE;;;EAIJ,aAAA,GAAgB,gBAAA;EAKA;;;EAAhB,aAAA,GAAgB,gBAAA;EAyDD;;;;EAnDf,gBAAA,GAAmB,gBAAA;EAuHuC;;;EAlH1D,cAAA,GAAiB,iBAAA;EAoNA;;;EA/MjB,kBAAA;EAuNqC;;;EAlNrC,cAAA,EAAgB,wBAAA;EArBhB;;;;;EA4BA,mBAAA;EAZA;;;EAiBA,YAAA;EAAA;;;EAKA,YAAA;EAOL;;;cADO,IAAA,UACP,WAAA;EAoBK;;;EARA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAyBf;;;EAjBA,WAAA,CAAY,WAAA;EAyBL;;;EAjBP,UAAA,CAAW,YAAA;EAkCX;;;;EAzBA,KAAA,CAAM,KAAA;EA0CN;;;EAlCA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAmCR;;;;EA1BP,SAAA,CAAU,MAAA,EAAQ,gBAAA;EAwDf;;;EAhDH,OAAA,CAAQ,OAAA,EAAS,gBAAA;EA8FhB;;;EArFD,aAAA,CAAc,YAAA;EAmHR;;;EA3GN,MAAA,CAAO,MAAA,EAAQ,gBAAA;EACf,MAAA,CAAO,IAAA,UAAc,WAAA,WAAsB,OAAA,GAAU,IAAA,CAAK,gBAAA;EA0GrB;AAS9C;;;;;;;;EAT8C,UA5ElC,WAAA,CAAY,MAAA,EAAQ,gBAAA,GAAmB,wBAAA;;;;;;;;;UA8CzC,iBAAA;;;;EAsBD,OAAA,CAAQ,OAAA,EAAS,iBAAA;;;;EAQX,OAAA,CAAQ,IAAA,EAAM,iBAAA,GAAiB,OAAA;AAAA;AAAA,iBAS9B,OAAA,CAAQ,OAAA,EAAS,iBAAA,GAAiB,UAAA"}

package/esm/{cli → commands}/cli-command.mjs

@@ -1,4 +1,4 @@
-//#region ../core/src/cli/cli-command.ts
+//#region ../core/src/commands/cli-command.ts
 var CLICommand = class {
 	/**
 	* Constructor

package/esm/commands/cli-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command.mjs","names":[],"sources":["../../../../../../../core/src/commands/cli-command.ts"],"sourcesContent":["import type {\n  CLICommandAction,\n  CLICommandOption,\n  CLICommandOptions,\n  CLICommandPreload,\n  CLICommandSource,\n  CommandActionData,\n  ResolvedCLICommandOption,\n} from \"./types\";\n\nexport class CLICommand {\n  /**\n   * Command source\n   */\n  public commandSource?: CLICommandSource;\n\n  /**\n   * Command action\n   */\n  public commandAction?: CLICommandAction;\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public commandPreAction?: CLICommandAction;\n\n  /**\n   *    Command preload\n   */\n  public commandPreload?: CLICommandPreload;\n\n  /**\n   * Command description\n   */\n  public commandDescription?: string;\n\n  /**\n   * Command options\n   */\n  public commandOptions: ResolvedCLICommandOption[] = [];\n\n  /**\n   * Command relative path\n   * Available only for project commands\n   * Auto injected by the framework itself\n   */\n  public commandRelativePath?: string;\n\n  /**\n   * Determine if the command is persistent\n   */\n  public isPersistent: boolean = false;\n\n  /**\n   * Command alias (short name)\n   */\n  public commandAlias?: string;\n\n  /**\n   * Constructor\n   */\n  public constructor(\n    public name: string,\n    description?: string,\n  ) {\n    if (description) {\n      this.commandDescription = description;\n    }\n\n    return this;\n  }\n\n  /**\n   * Add command source\n   */\n  public source(source: CLICommandSource): this {\n    this.commandSource = source;\n    return this;\n  }\n\n  /**\n   * Set command description\n   */\n  public description(description: string): this {\n    this.commandDescription = description;\n    return this;\n  }\n\n  /**\n   * Determine if the command is persistent\n   */\n  public persistent(isPersistent = true): this {\n    this.isPersistent = isPersistent;\n    return this;\n  }\n\n  /**\n   * Set command alias (short name)\n   * @example .alias(\"m\") for \"migrate\"\n   */\n  public alias(alias: string): this {\n    this.commandAlias = alias;\n    return this;\n  }\n\n  /**\n   * Command action\n   */\n  public action(action: CLICommandAction): this {\n    this.commandAction = action;\n    return this;\n  }\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public preAction(action: CLICommandAction): this {\n    this.commandPreAction = action;\n    return this;\n  }\n\n  /**\n   * Add command options\n   */\n  public options(options: CLICommandOption[]): this {\n    options.map((option) => this.option(option));\n\n    return this;\n  }\n\n  /**\n   * Add command relative path\n   */\n  public $relativePath(relativePath: string) {\n    this.commandRelativePath = relativePath;\n    return this;\n  }\n\n  /**\n   * Add command option\n   */\n  public option(option: CLICommandOption): this;\n  public option(name: string, description?: string, options?: Omit<CLICommandOption, \"name\">): this;\n  public option(\n    ...args: [CLICommandOption] | [string, string?, Omit<CLICommandOption, \"name\">?]\n  ): this {\n    let option: CLICommandOption;\n    if (args.length === 1) {\n      option = args[0] as CLICommandOption;\n    } else {\n      option = {\n        text: args[0],\n        description: args[1],\n        ...args[2],\n        name: \"\",\n      };\n    }\n\n    this.commandOptions.push(this.parseOption(option));\n\n    return this;\n  }\n\n  /**\n   * Parse option name and alias if exists\n   *\n   * Supports formats:\n   * - \"--port, -p\" → name: \"port\", alias: \"p\"\n   * - \"-p, --port\" → name: \"port\", alias: \"p\"\n   * - \"--port\" → name: \"port\", alias: undefined\n   * - \"-p\" → name: \"p\", alias: undefined\n   */\n  protected parseOption(option: CLICommandOption): ResolvedCLICommandOption {\n    const text = option.text.trim();\n\n    // Split by comma to check for alias\n    const parts = text.split(\",\").map((part) => part.trim());\n\n    let name = \"\";\n    let alias = \"\";\n\n    if (parts.length === 1) {\n      // Single option: \"--port\" or \"-p\"\n      name = this.extractOptionName(parts[0]);\n    } else if (parts.length === 2) {\n      // Two options: \"--port, -p\" or \"-p, --port\"\n      const first = parts[0];\n      const second = parts[1];\n\n      // Determine which is the long form (name) and which is short (alias)\n      if (first.startsWith(\"--\")) {\n        name = this.extractOptionName(first);\n        alias = this.extractOptionName(second);\n      } else {\n        name = this.extractOptionName(second);\n        alias = this.extractOptionName(first);\n      }\n    }\n\n    if (alias === \"h\" || name === \"help\") {\n      throw new Error(\"Help option is not allowed, it's reserved for displaying command help\");\n    }\n\n    return {\n      ...option,\n      name,\n      alias,\n    };\n  }\n\n  /**\n   * Extract option name from text (removes -- or -)\n   *\n   * @example\n   * extractOptionName(\"--port\") → \"port\"\n   * extractOptionName(\"-p\") → \"p\"\n   * extractOptionName(\"--port=3000\") → \"port\"\n   */\n  private extractOptionName(text: string): string {\n    // Remove leading dashes\n    let name = text.replace(/^-+/, \"\");\n\n    // Remove value assignment if exists (e.g., \"--port=3000\" → \"port\")\n    const equalIndex = name.indexOf(\"=\");\n    if (equalIndex !== -1) {\n      name = name.slice(0, equalIndex);\n    }\n\n    // Remove angle brackets if exists (e.g., \"--port <number>\" → \"port\")\n    const spaceIndex = name.indexOf(\" \");\n    if (spaceIndex !== -1) {\n      name = name.slice(0, spaceIndex);\n    }\n\n    return name.trim();\n  }\n\n  /**\n   * Command preload\n   */\n  public preload(options: CLICommandPreload) {\n    this.commandPreload = options;\n    return this;\n  }\n\n  /**\n   * Execute the command\n   */\n  public async execute(data: CommandActionData) {\n    if (!this.commandAction) {\n      throw new Error(`Command \"${this.name}\" has no action defined`);\n    }\n\n    await this.commandAction(data);\n  }\n}\n\nexport function command(options: CLICommandOptions) {\n  const commandInstnace = new CLICommand(options.name, options.description);\n\n  if (options.preload) {\n    commandInstnace.preload(options.preload);\n  }\n\n  if (options.persistent) {\n    commandInstnace.persistent(options.persistent);\n  }\n\n  if (options.alias) {\n    commandInstnace.alias(options.alias);\n  }\n\n  commandInstnace.action(options.action);\n\n  if (options.options) {\n    commandInstnace.options(options.options);\n  }\n\n  if (options.preAction) {\n    commandInstnace.preAction(options.preAction);\n  }\n\n  return commandInstnace;\n}\n"],"mappings":"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"}

package/esm/{cli → commands}/types.d.mts

@@ -1,6 +1,6 @@
 import { RuntimeStrategy } from "../utils/environment.mjs";
 import { ConnectorName } from "../connectors/types.mjs";
-//#region ../core/src/cli/types.d.ts
+//#region ../core/src/commands/types.d.ts
 /**
  * Indicates the origin/source of a CLI command.
  *

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/commands/types.ts"],"mappings":";;;;;AAgB4B;AAY5B;;;;KAZY,gBAAA;;;;AAwBK;AAsBjB;;;;;;KAlCY,iBAAA;EAuDV;;;;EAlDA,IAAA;EAiFA;;;AAA0B;AAgB5B;EA1FE,OAAA,EAAS,MAAM;AAAA;;;;;;;;;;AAiIP;AAGV;;;;;;;;;KA9GY,iBAAA;EAuHA;;;;;EAjHV,MAAA;EAiHiE;;AAAO;EA5GxE,QAAA;EAkI2B;;;EA7H3B,aAAA;EAsKQ;;;EAjKR,eAAA,GAAkB,eAAA;EA6HlB;;;EAxHA,WAAA;EAyIU;;;;;;;;;EA9HV,GAAA;;;;;EAMA,SAAA;;;;;;;;EASA,UAAA,GAAa,aAAa;AAAA;;;;;;;;;;;;;;KAgBhB,gBAAA;;;;;EAKV,IAAA;;;;;EAMA,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,IAAA;;;;EAKA,YAAA;;;;;EAMA,QAAA;AAAA;AAAA,KAGU,wBAAA,GAA2B,IAAI,CAAC,gBAAA;EAC1C,IAAA;EACA,KAAA;AAAA;;;;;KAOU,gBAAA,IAAoB,IAAA,EAAM,iBAAA,YAA6B,OAAO;;;;;;;;;;;;;;;;;;;;;KAsB9D,iBAAA;;;;;EAKV,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,OAAA,GAAU,iBAAA;;;;;;EAOV,UAAA;;;;;EAMA,SAAA,GAAY,gBAAA;;;;;EAMZ,MAAA,EAAQ,gBAAA;;;;;EAMR,OAAA,GAAU,gBAAA;AAAA"}

package/esm/config/load-config-files.mjs

@@ -1,6 +1,6 @@
+import { Path } from "../utils/normalized-path.mjs";
 import { srcPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
-import { Path } from "../dev-server/path.mjs";
 import { getCertainFilesFromDirectory, getFilesFromDirectory } from "../dev-server/utils.mjs";
 import { filesOrchestrator } from "../dev-server/files-orchestrator.mjs";
 import { configManager } from "./config-manager.mjs";

package/esm/config/load-config-files.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"load-config-files.mjs","names":[],"sources":["../../../../../../../core/src/config/load-config-files.ts"],"sourcesContent":["import { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { Path } from \"../dev-server/path\";\nimport { getCertainFilesFromDirectory, getFilesFromDirectory } from \"../dev-server/utils\";\nimport { srcPath } from \"../utils\";\nimport { configManager } from \"./config-manager\";\n\n/**\n * Load config files\n * either config file names (without extensions) or true to load all config files\n */\nexport async function loadConfigFiles(config: string[] | true) {\n  let relativePaths: string[] = [];\n  if (config === true) {\n    const configFilesAbsulatePaths = await getFilesFromDirectory(srcPath(\"config\"));\n    relativePaths = configFilesAbsulatePaths.map((path) => Path.toRelative(path));\n  } else {\n    // define only the given config files\n\n    const configFilesAbsulatePaths = await getCertainFilesFromDirectory(srcPath(\"config\"), config);\n\n    relativePaths = configFilesAbsulatePaths.map((path) => Path.toRelative(path));\n  }\n\n  const configFiles = await Promise.all(\n    relativePaths.map((relativePath) => filesOrchestrator.add(relativePath)),\n  );\n\n  filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.files);\n\n  await configManager.loadAll(configFiles);\n}\n"],"mappings":";;;;;;;;;;;;AAUA,eAAsB,gBAAgB,QAAyB;CAC7D,IAAI,gBAA0B,CAAC;CAC/B,IAAI,WAAW,MAEb,iBAAgB,MADuB,sBAAsB,QAAQ,QAAQ,CAAC,EACtC,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;MAM5E,iBAAgB,MAFuB,6BAA6B,QAAQ,QAAQ,GAAG,MAAM,EAErD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;CAG9E,MAAM,cAAc,MAAM,QAAQ,IAChC,cAAc,KAAK,iBAAiB,kBAAkB,IAAI,YAAY,CAAC,CACzE;CAEA,kBAAkB,sBAAsB,QAAQ,kBAAkB,KAAK;CAEvE,MAAM,cAAc,QAAQ,WAAW;AACzC"}
+{"version":3,"file":"load-config-files.mjs","names":[],"sources":["../../../../../../../core/src/config/load-config-files.ts"],"sourcesContent":["import { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { Path } from \"../utils/normalized-path\";\nimport { getCertainFilesFromDirectory, getFilesFromDirectory } from \"../dev-server/utils\";\nimport { srcPath } from \"../utils\";\nimport { configManager } from \"./config-manager\";\n\n/**\n * Load config files\n * either config file names (without extensions) or true to load all config files\n */\nexport async function loadConfigFiles(config: string[] | true) {\n  let relativePaths: string[] = [];\n  if (config === true) {\n    const configFilesAbsulatePaths = await getFilesFromDirectory(srcPath(\"config\"));\n    relativePaths = configFilesAbsulatePaths.map((path) => Path.toRelative(path));\n  } else {\n    // define only the given config files\n\n    const configFilesAbsulatePaths = await getCertainFilesFromDirectory(srcPath(\"config\"), config);\n\n    relativePaths = configFilesAbsulatePaths.map((path) => Path.toRelative(path));\n  }\n\n  const configFiles = await Promise.all(\n    relativePaths.map((relativePath) => filesOrchestrator.add(relativePath)),\n  );\n\n  filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.files);\n\n  await configManager.loadAll(configFiles);\n}\n"],"mappings":";;;;;;;;;;;;AAUA,eAAsB,gBAAgB,QAAyB;CAC7D,IAAI,gBAA0B,CAAC;CAC/B,IAAI,WAAW,MAEb,iBAAgB,MADuB,sBAAsB,QAAQ,QAAQ,CAAC,EACtC,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;MAM5E,iBAAgB,MAFuB,6BAA6B,QAAQ,QAAQ,GAAG,MAAM,EAErD,CAAC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;CAG9E,MAAM,cAAc,MAAM,QAAQ,IAChC,cAAc,KAAK,iBAAiB,kBAAkB,IAAI,YAAY,CAAC,CACzE;CAEA,kBAAkB,sBAAsB,QAAQ,kBAAkB,KAAK;CAEvE,MAAM,cAAc,QAAQ,WAAW;AACzC"}

package/esm/connectors/base-connector.mjs

@@ -1,4 +1,4 @@
-import { Path } from "../dev-server/path.mjs";
+import { Path } from "../utils/normalized-path.mjs";
 import { ConnectorLifecyclePhase } from "./types.mjs";
 
 //#region ../core/src/connectors/base-connector.ts

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

@@ -1 +1 @@
-{"version":3,"file":"base-connector.mjs","names":[],"sources":["../../../../../../../core/src/connectors/base-connector.ts"],"sourcesContent":["import { Path } from \"../dev-server/path\";\r\nimport { ConnectorLifecyclePhase } from \"./types\";\r\nimport type { Connector, ConnectorName } from \"./types\";\r\n\r\n/**\r\n * Base Connector Class\r\n * Provides common functionality for all connectors\r\n */\r\nexport abstract class BaseConnector implements Connector {\r\n  /**\r\n   * Connector name\r\n   */\r\n  public abstract readonly name: ConnectorName;\r\n\r\n  /**\r\n   * Initialization priority\r\n   */\r\n  public abstract readonly priority: number;\r\n\r\n  /**\r\n   * Lifecycle phase. Defaults to `Early`; override to `Late` if the\r\n   * connector consumes state user code registers at import time\r\n   * (routes, socket listeners).\r\n   */\r\n  public readonly lifecyclePhase: ConnectorLifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger restart when changed\r\n   * Use relative paths\r\n   */\r\n  protected abstract readonly watchedFiles: string[];\r\n\r\n  /**\r\n   * Whether the connector is currently active\r\n   */\r\n  protected active: boolean = false;\r\n\r\n  /**\r\n   * Check if connector is active\r\n   */\r\n  public isActive(): boolean {\r\n    return this.active;\r\n  }\r\n\r\n  /**\r\n   * Boot the connector\r\n   */\r\n  public async boot(): Promise<void> {\r\n    return;\r\n  }\r\n\r\n  /**\r\n   * Initialize the connector\r\n   */\r\n  public abstract start(): Promise<void>;\r\n\r\n  /**\r\n   * Restart the connector\r\n   */\r\n  public async restart(): Promise<void> {\r\n    await this.shutdown();\r\n    await this.start();\r\n  }\r\n\r\n  /**\r\n   * Shutdown the connector\r\n   */\r\n  public abstract shutdown(): Promise<void>;\r\n\r\n  /**\r\n   * Determine if connector should restart based on changed files\r\n   */\r\n  public shouldRestart(changedFiles: string[]): boolean {\r\n    // Check if any changed file matches watched files\r\n    return changedFiles.some((file) => this.isWatchedFile(file));\r\n  }\r\n\r\n  /**\r\n   * Check if a file is watched by this connector\r\n   */\r\n  protected isWatchedFile(file: string): boolean {\r\n    const relativePath = Path.toRelative(file);\r\n\r\n    return this.watchedFiles.some((watchedFile) => {\r\n      // Exact match\r\n      if (watchedFile === relativePath) {\r\n        return true;\r\n      }\r\n\r\n      // Pattern match (e.g., \"config/*.ts\")\r\n      if (watchedFile.includes(\"*\")) {\r\n        const pattern = new RegExp(\"^\" + watchedFile.replace(/\\*/g, \".*\") + \"$\");\r\n        return pattern.test(relativePath);\r\n      }\r\n\r\n      return false;\r\n    });\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;AAQA,IAAsB,gBAAtB,MAAyD;;;gBA2B3B;;;;;CAK5B,AAAO,WAAoB;EACzB,OAAO,KAAK;CACd;;;;CAKA,MAAa,OAAsB,CAEnC;;;;CAUA,MAAa,UAAyB;EACpC,MAAM,KAAK,SAAS;EACpB,MAAM,KAAK,MAAM;CACnB;;;;CAUA,AAAO,cAAc,cAAiC;EAEpD,OAAO,aAAa,MAAM,SAAS,KAAK,cAAc,IAAI,CAAC;CAC7D;;;;CAKA,AAAU,cAAc,MAAuB;EAC7C,MAAM,eAAe,KAAK,WAAW,IAAI;EAEzC,OAAO,KAAK,aAAa,MAAM,gBAAgB;GAE7C,IAAI,gBAAgB,cAClB,OAAO;GAIT,IAAI,YAAY,SAAS,GAAG,GAE1B,OAAO,IADa,OAAO,MAAM,YAAY,QAAQ,OAAO,IAAI,IAAI,GACvD,CAAC,CAAC,KAAK,YAAY;GAGlC,OAAO;EACT,CAAC;CACH;AACF"}
+{"version":3,"file":"base-connector.mjs","names":[],"sources":["../../../../../../../core/src/connectors/base-connector.ts"],"sourcesContent":["import { Path } from \"../utils/normalized-path\";\nimport { ConnectorLifecyclePhase } from \"./types\";\nimport type { Connector, ConnectorName } from \"./types\";\n\n/**\n * Base Connector Class\n * Provides common functionality for all connectors\n */\nexport abstract class BaseConnector implements Connector {\n  /**\n   * Connector name\n   */\n  public abstract readonly name: ConnectorName;\n\n  /**\n   * Initialization priority\n   */\n  public abstract readonly priority: number;\n\n  /**\n   * Lifecycle phase. Defaults to `Early`; override to `Late` if the\n   * connector consumes state user code registers at import time\n   * (routes, socket listeners).\n   */\n  public readonly lifecyclePhase: ConnectorLifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger restart when changed\n   * Use relative paths\n   */\n  protected abstract readonly watchedFiles: string[];\n\n  /**\n   * Whether the connector is currently active\n   */\n  protected active: boolean = false;\n\n  /**\n   * Check if connector is active\n   */\n  public isActive(): boolean {\n    return this.active;\n  }\n\n  /**\n   * Boot the connector\n   */\n  public async boot(): Promise<void> {\n    return;\n  }\n\n  /**\n   * Initialize the connector\n   */\n  public abstract start(): Promise<void>;\n\n  /**\n   * Restart the connector\n   */\n  public async restart(): Promise<void> {\n    await this.shutdown();\n    await this.start();\n  }\n\n  /**\n   * Shutdown the connector\n   */\n  public abstract shutdown(): Promise<void>;\n\n  /**\n   * Determine if connector should restart based on changed files\n   */\n  public shouldRestart(changedFiles: string[]): boolean {\n    // Check if any changed file matches watched files\n    return changedFiles.some((file) => this.isWatchedFile(file));\n  }\n\n  /**\n   * Check if a file is watched by this connector\n   */\n  protected isWatchedFile(file: string): boolean {\n    const relativePath = Path.toRelative(file);\n\n    return this.watchedFiles.some((watchedFile) => {\n      // Exact match\n      if (watchedFile === relativePath) {\n        return true;\n      }\n\n      // Pattern match (e.g., \"config/*.ts\")\n      if (watchedFile.includes(\"*\")) {\n        const pattern = new RegExp(\"^\" + watchedFile.replace(/\\*/g, \".*\") + \"$\");\n        return pattern.test(relativePath);\n      }\n\n      return false;\n    });\n  }\n}\n"],"mappings":";;;;;;;;AAQA,IAAsB,gBAAtB,MAAyD;;;gBA2B3B;;;;;CAK5B,AAAO,WAAoB;EACzB,OAAO,KAAK;CACd;;;;CAKA,MAAa,OAAsB,CAEnC;;;;CAUA,MAAa,UAAyB;EACpC,MAAM,KAAK,SAAS;EACpB,MAAM,KAAK,MAAM;CACnB;;;;CAUA,AAAO,cAAc,cAAiC;EAEpD,OAAO,aAAa,MAAM,SAAS,KAAK,cAAc,IAAI,CAAC;CAC7D;;;;CAKA,AAAU,cAAc,MAAuB;EAC7C,MAAM,eAAe,KAAK,WAAW,IAAI;EAEzC,OAAO,KAAK,aAAa,MAAM,gBAAgB;GAE7C,IAAI,gBAAgB,cAClB,OAAO;GAIT,IAAI,YAAY,SAAS,GAAG,GAE1B,OAAO,IADa,OAAO,MAAM,YAAY,QAAQ,OAAO,IAAI,IAAI,GACvD,CAAC,CAAC,KAAK,YAAY;GAGlC,OAAO;EACT,CAAC;CACH;AACF"}

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

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

package/esm/connectors/connectors-manager.mjs

@@ -4,7 +4,6 @@ import { AccessConnector } from "./access-connector.mjs";
 import { AiConnector } from "./ai-connector.mjs";
 import { CacheConnector } from "./cache-connector.mjs";
 import { HeraldConnector } from "./herald-connector.mjs";
-import { devServeLog } from "../dev-server/dev-logger.mjs";
 import { DatabaseConnector } from "./database-connector.mjs";
 import { HttpConnector } from "./http-connector.mjs";
 import { LoggerConnector } from "./logger-connector.mjs";
@@ -12,7 +11,7 @@ import { MailerConnector } from "./mail-connector.mjs";
 import { NotificationsConnector } from "./notifications-connector.mjs";
 import { SocketConnector } from "./socket-connector.mjs";
 import { StorageConnector } from "./storage.connector.mjs";
-import { colors } from "@mongez/copper";
+import { log } from "@warlock.js/logger";
 
 //#region ../core/src/connectors/connectors-manager.ts
 var ConnectorsManager = class {
@@ -82,8 +81,11 @@ var ConnectorsManager = class {
 		for (const connector of [...this.connectors].reverse()) try {
 			await connector.shutdown();
 		} catch (error) {
-			devServeLog(colors.redBright(`❌ Failed to shutdown ${connector.name}: ${error}`));
+			try {
+				await log.error("connectors", "shutdown", error, { connector: connector.name });
+			} catch {}
 		}
+		await log.flush();
 	}
 	/**
 	* Shutdown connectors on process kill

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

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.mjs","names":[],"sources":["../../../../../../../core/src/connectors/connectors-manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { Application } from \"../application\";\r\nimport { devServeLog } from \"../dev-server/dev-logger\";\r\nimport { AccessConnector } from \"./access-connector\";\r\nimport { AiConnector } from \"./ai-connector\";\r\nimport { CacheConnector } from \"./cache-connector\";\r\nimport { DatabaseConnector } from \"./database-connector\";\r\nimport { HeraldConnector } from \"./herald-connector\";\r\nimport { HttpConnector } from \"./http-connector\";\r\nimport { LoggerConnector } from \"./logger-connector\";\r\nimport { MailerConnector } from \"./mail-connector\";\r\nimport { NotificationsConnector } from \"./notifications-connector\";\r\nimport { SocketConnector } from \"./socket-connector\";\r\nimport { StorageConnector } from \"./storage.connector\";\r\nimport { ConnectorLifecyclePhase } from \"./types\";\r\nimport type { Connector, ConnectorName } from \"./types\";\r\n\r\nexport class ConnectorsManager {\r\n  /**\r\n   * Connectors list\r\n   */\r\n  private readonly connectors: Connector[] = [];\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor() {\r\n    this.register(new LoggerConnector());\r\n    this.register(new MailerConnector());\r\n    this.register(new HttpConnector());\r\n    this.register(new DatabaseConnector());\r\n    this.register(new HeraldConnector());\r\n    this.register(new CacheConnector());\r\n    this.register(new StorageConnector());\r\n    this.register(new SocketConnector());\r\n    this.register(new NotificationsConnector());\r\n    this.register(new AccessConnector());\r\n    this.register(new AiConnector());\r\n  }\r\n\r\n  /**\r\n   * Register a connector\r\n   */\r\n  public register(...connectors: Connector[]): void {\r\n    this.connectors.push(...connectors);\r\n    // sort connectors by priority\r\n    this.connectors.sort((a, b) => a.priority - b.priority);\r\n  }\r\n\r\n  /**\r\n   * Get all connectors\r\n   */\r\n  public list(): Connector[] {\r\n    return this.connectors;\r\n  }\r\n\r\n  /**\r\n   * start all connectors\r\n   */\r\n  public async start(connectorsNames?: ConnectorName[]): Promise<void> {\r\n    const connectorsList = connectorsNames\r\n      ? this.connectors.filter((connector) => connectorsNames.includes(connector.name))\r\n      : this.connectors;\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors in the given lifecycle phase.\r\n   *\r\n   * The production builder and dev preload split startup around app\r\n   * code: early phase before app imports, late phase after. Within a\r\n   * phase, all connectors `boot()` first, then all `start()`, so\r\n   * cross-connector wiring inside the phase still works (e.g. socket\r\n   * reads http's instance during its own boot).\r\n   */\r\n  public async startPhase(phase: ConnectorLifecyclePhase): Promise<void> {\r\n    const phaseConnectors = this.connectors.filter(\r\n      (connector) => connector.lifecyclePhase === phase,\r\n    );\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors except the given ones\r\n   */\r\n  public async startWithout(excludedConnectors: ConnectorName[]): Promise<void> {\r\n    await this.start(\r\n      this.connectors\r\n        .filter((connector) => !excludedConnectors.includes(connector.name))\r\n        .map((connector) => connector.name),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Shutdown all connectors\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    // App-owned teardown runs first, while every connector (db, cache, http) is\r\n    // still up, so cleanup hooks can use them. Idempotent + error-isolated.\r\n    await Application.runShutdownHooks();\r\n\r\n    // Shut down connectors in reverse priority order. Copy the list first —\r\n    // `reverse()` mutates in place, so reversing the live array would corrupt\r\n    // the order on a second shutdown pass.\r\n    for (const connector of [...this.connectors].reverse()) {\r\n      try {\r\n        await connector.shutdown();\r\n      } catch (error) {\r\n        devServeLog(colors.redBright(`❌ Failed to shutdown ${connector.name}: ${error}`));\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown connectors on process kill\r\n   *\r\n   * Registers signal handlers that run an idempotent graceful shutdown:\r\n   * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes\r\n   * - SIGTERM: Termination signal (Unix primarily)\r\n   * - SIGHUP: registered on Windows (`win32`) only, to catch Ctrl+C / console close\r\n   *\r\n   * Note: no `beforeExit` handler is registered — `beforeExit` cannot reliably\r\n   * await async teardown (the process exits once the callback returns), so\r\n   * shutdown is driven entirely by the signal handlers above.\r\n   */\r\n  public shutdownOnProcessKill(): void {\r\n    let isShuttingDown = false;\r\n\r\n    const gracefulShutdown = async (signal: string) => {\r\n      if (isShuttingDown) return;\r\n      isShuttingDown = true;\r\n\r\n      console.log(`\\nExiting...`);\r\n      await this.shutdown();\r\n      process.exit(0);\r\n    };\r\n\r\n    // Unix signals\r\n    process.on(\"SIGINT\", () => gracefulShutdown(\"SIGINT\"));\r\n    process.on(\"SIGTERM\", () => gracefulShutdown(\"SIGTERM\"));\r\n\r\n    // Windows-specific: handle when process is about to exit\r\n    // This is more reliable on Windows for spawned child processes\r\n    if (process.platform === \"win32\") {\r\n      // Handle Ctrl+C on Windows specifically\r\n      process.on(\"SIGHUP\", () => gracefulShutdown(\"SIGHUP\"));\r\n    }\r\n  }\r\n}\r\n\r\nexport const connectorsManager = new ConnectorsManager();\r\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,oBAAb,MAA+B;;;;CAS7B,AAAO,cAAc;oBALsB,CAAC;EAM1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,cAAc,CAAC;EACjC,KAAK,SAAS,IAAI,kBAAkB,CAAC;EACrC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,eAAe,CAAC;EAClC,KAAK,SAAS,IAAI,iBAAiB,CAAC;EACpC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,uBAAuB,CAAC;EAC1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,YAAY,CAAC;CACjC;;;;CAKA,AAAO,SAAS,GAAG,YAA+B;EAChD,KAAK,WAAW,KAAK,GAAG,UAAU;EAElC,KAAK,WAAW,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;CACxD;;;;CAKA,AAAO,OAAoB;EACzB,OAAO,KAAK;CACd;;;;CAKA,MAAa,MAAM,iBAAkD;EACnE,MAAM,iBAAiB,kBACnB,KAAK,WAAW,QAAQ,cAAc,gBAAgB,SAAS,UAAU,IAAI,CAAC,IAC9E,KAAK;EAET,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,MAAM;CAE1B;;;;;;;;;;CAWA,MAAa,WAAW,OAA+C;EACrE,MAAM,kBAAkB,KAAK,WAAW,QACrC,cAAc,UAAU,mBAAmB,KAC9C;EAEA,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,MAAM;CAE1B;;;;CAKA,MAAa,aAAa,oBAAoD;EAC5E,MAAM,KAAK,MACT,KAAK,WACF,QAAQ,cAAc,CAAC,mBAAmB,SAAS,UAAU,IAAI,CAAC,CAAC,CACnE,KAAK,cAAc,UAAU,IAAI,CACtC;CACF;;;;CAKA,MAAa,WAA0B;EAGrC,MAAM,YAAY,iBAAiB;EAKnC,KAAK,MAAM,aAAa,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC,QAAQ,GACnD,IAAI;GACF,MAAM,UAAU,SAAS;EAC3B,SAAS,OAAO;GACd,YAAY,OAAO,UAAU,wBAAwB,UAAU,KAAK,IAAI,OAAO,CAAC;EAClF;CAEJ;;;;;;;;;;;;;CAcA,AAAO,wBAA8B;EACnC,IAAI,iBAAiB;EAErB,MAAM,mBAAmB,OAAO,WAAmB;GACjD,IAAI,gBAAgB;GACpB,iBAAiB;GAEjB,QAAQ,IAAI,cAAc;GAC1B,MAAM,KAAK,SAAS;GACpB,QAAQ,KAAK,CAAC;EAChB;EAGA,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;EACrD,QAAQ,GAAG,iBAAiB,iBAAiB,SAAS,CAAC;EAIvD,IAAI,QAAQ,aAAa,SAEvB,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;CAEzD;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}
+{"version":3,"file":"connectors-manager.mjs","names":[],"sources":["../../../../../../../core/src/connectors/connectors-manager.ts"],"sourcesContent":["import { Application } from \"../application\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { AccessConnector } from \"./access-connector\";\r\nimport { AiConnector } from \"./ai-connector\";\r\nimport { CacheConnector } from \"./cache-connector\";\r\nimport { DatabaseConnector } from \"./database-connector\";\r\nimport { HeraldConnector } from \"./herald-connector\";\r\nimport { HttpConnector } from \"./http-connector\";\r\nimport { LoggerConnector } from \"./logger-connector\";\r\nimport { MailerConnector } from \"./mail-connector\";\r\nimport { NotificationsConnector } from \"./notifications-connector\";\r\nimport { SocketConnector } from \"./socket-connector\";\r\nimport { StorageConnector } from \"./storage.connector\";\r\nimport { ConnectorLifecyclePhase } from \"./types\";\r\nimport type { Connector, ConnectorName } from \"./types\";\r\n\r\nexport class ConnectorsManager {\r\n  /**\r\n   * Connectors list\r\n   */\r\n  private readonly connectors: Connector[] = [];\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor() {\r\n    this.register(new LoggerConnector());\r\n    this.register(new MailerConnector());\r\n    this.register(new HttpConnector());\r\n    this.register(new DatabaseConnector());\r\n    this.register(new HeraldConnector());\r\n    this.register(new CacheConnector());\r\n    this.register(new StorageConnector());\r\n    this.register(new SocketConnector());\r\n    this.register(new NotificationsConnector());\r\n    this.register(new AccessConnector());\r\n    this.register(new AiConnector());\r\n  }\r\n\r\n  /**\r\n   * Register a connector\r\n   */\r\n  public register(...connectors: Connector[]): void {\r\n    this.connectors.push(...connectors);\r\n    // sort connectors by priority\r\n    this.connectors.sort((a, b) => a.priority - b.priority);\r\n  }\r\n\r\n  /**\r\n   * Get all connectors\r\n   */\r\n  public list(): Connector[] {\r\n    return this.connectors;\r\n  }\r\n\r\n  /**\r\n   * start all connectors\r\n   */\r\n  public async start(connectorsNames?: ConnectorName[]): Promise<void> {\r\n    const connectorsList = connectorsNames\r\n      ? this.connectors.filter((connector) => connectorsNames.includes(connector.name))\r\n      : this.connectors;\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors in the given lifecycle phase.\r\n   *\r\n   * The production builder and dev preload split startup around app\r\n   * code: early phase before app imports, late phase after. Within a\r\n   * phase, all connectors `boot()` first, then all `start()`, so\r\n   * cross-connector wiring inside the phase still works (e.g. socket\r\n   * reads http's instance during its own boot).\r\n   */\r\n  public async startPhase(phase: ConnectorLifecyclePhase): Promise<void> {\r\n    const phaseConnectors = this.connectors.filter(\r\n      (connector) => connector.lifecyclePhase === phase,\r\n    );\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors except the given ones\r\n   */\r\n  public async startWithout(excludedConnectors: ConnectorName[]): Promise<void> {\r\n    await this.start(\r\n      this.connectors\r\n        .filter((connector) => !excludedConnectors.includes(connector.name))\r\n        .map((connector) => connector.name),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Shutdown all connectors\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    // App-owned teardown runs first, while every connector (db, cache, http) is\r\n    // still up, so cleanup hooks can use them. Idempotent + error-isolated.\r\n    await Application.runShutdownHooks();\r\n\r\n    // Shut down connectors in reverse priority order. Copy the list first —\r\n    // `reverse()` mutates in place, so reversing the live array would corrupt\r\n    // the order on a second shutdown pass.\r\n    for (const connector of [...this.connectors].reverse()) {\r\n      try {\r\n        await connector.shutdown();\r\n      } catch (error) {\r\n        try {\r\n          // Awaited deliberately: the caller (`shutdownOnProcessKill`) calls\r\n          // `process.exit(0)` as soon as this resolves, so an un-awaited log is\r\n          // a log that never happens.\r\n          await log.error(\"connectors\", \"shutdown\", error as Error, { connector: connector.name });\r\n        } catch {\r\n          // Reporting a failure must never become a worse failure than the one\r\n          // being reported. `Logger.log()` fans out to channels without\r\n          // isolating them, so a channel that throws synchronously rejects this\r\n          // call — and this call sits INSIDE the catch, so that rejection\r\n          // escapes `shutdown()` entirely: the remaining connectors are never\r\n          // torn down and `process.exit(0)` never runs, leaving the process\r\n          // alive on the handles they still hold.\r\n          //\r\n          // Swallowed rather than re-reported: the only channel we could report\r\n          // it through is the one that just threw.\r\n        }\r\n      }\r\n    }\r\n\r\n    // `Logger.log()` hands each entry to `channel.log()` without awaiting it, so\r\n    // awaiting the calls above is not enough on its own — a buffered or async\r\n    // channel (file, Sentry) still loses the entry when the process exits.\r\n    // Drained once here rather than per failure: shutdown is exactly when\r\n    // buffered logs must reach their destination, and re-draining every channel\r\n    // once per failed connector buys nothing.\r\n    await log.flush();\r\n  }\r\n\r\n  /**\r\n   * Shutdown connectors on process kill\r\n   *\r\n   * Registers signal handlers that run an idempotent graceful shutdown:\r\n   * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes\r\n   * - SIGTERM: Termination signal (Unix primarily)\r\n   * - SIGHUP: registered on Windows (`win32`) only, to catch Ctrl+C / console close\r\n   *\r\n   * Note: no `beforeExit` handler is registered — `beforeExit` cannot reliably\r\n   * await async teardown (the process exits once the callback returns), so\r\n   * shutdown is driven entirely by the signal handlers above.\r\n   */\r\n  public shutdownOnProcessKill(): void {\r\n    let isShuttingDown = false;\r\n\r\n    const gracefulShutdown = async (signal: string) => {\r\n      if (isShuttingDown) return;\r\n      isShuttingDown = true;\r\n\r\n      console.log(`\\nExiting...`);\r\n      await this.shutdown();\r\n      process.exit(0);\r\n    };\r\n\r\n    // Unix signals\r\n    process.on(\"SIGINT\", () => gracefulShutdown(\"SIGINT\"));\r\n    process.on(\"SIGTERM\", () => gracefulShutdown(\"SIGTERM\"));\r\n\r\n    // Windows-specific: handle when process is about to exit\r\n    // This is more reliable on Windows for spawned child processes\r\n    if (process.platform === \"win32\") {\r\n      // Handle Ctrl+C on Windows specifically\r\n      process.on(\"SIGHUP\", () => gracefulShutdown(\"SIGHUP\"));\r\n    }\r\n  }\r\n}\r\n\r\nexport const connectorsManager = new ConnectorsManager();\r\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,IAAa,oBAAb,MAA+B;;;;CAS7B,AAAO,cAAc;oBALsB,CAAC;EAM1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,cAAc,CAAC;EACjC,KAAK,SAAS,IAAI,kBAAkB,CAAC;EACrC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,eAAe,CAAC;EAClC,KAAK,SAAS,IAAI,iBAAiB,CAAC;EACpC,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,uBAAuB,CAAC;EAC1C,KAAK,SAAS,IAAI,gBAAgB,CAAC;EACnC,KAAK,SAAS,IAAI,YAAY,CAAC;CACjC;;;;CAKA,AAAO,SAAS,GAAG,YAA+B;EAChD,KAAK,WAAW,KAAK,GAAG,UAAU;EAElC,KAAK,WAAW,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;CACxD;;;;CAKA,AAAO,OAAoB;EACzB,OAAO,KAAK;CACd;;;;CAKA,MAAa,MAAM,iBAAkD;EACnE,MAAM,iBAAiB,kBACnB,KAAK,WAAW,QAAQ,cAAc,gBAAgB,SAAS,UAAU,IAAI,CAAC,IAC9E,KAAK;EAET,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,gBACtB,MAAM,UAAU,MAAM;CAE1B;;;;;;;;;;CAWA,MAAa,WAAW,OAA+C;EACrE,MAAM,kBAAkB,KAAK,WAAW,QACrC,cAAc,UAAU,mBAAmB,KAC9C;EAEA,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,KAAK;EAGvB,KAAK,MAAM,aAAa,iBACtB,MAAM,UAAU,MAAM;CAE1B;;;;CAKA,MAAa,aAAa,oBAAoD;EAC5E,MAAM,KAAK,MACT,KAAK,WACF,QAAQ,cAAc,CAAC,mBAAmB,SAAS,UAAU,IAAI,CAAC,CAAC,CACnE,KAAK,cAAc,UAAU,IAAI,CACtC;CACF;;;;CAKA,MAAa,WAA0B;EAGrC,MAAM,YAAY,iBAAiB;EAKnC,KAAK,MAAM,aAAa,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC,QAAQ,GACnD,IAAI;GACF,MAAM,UAAU,SAAS;EAC3B,SAAS,OAAO;GACd,IAAI;IAIF,MAAM,IAAI,MAAM,cAAc,YAAY,OAAgB,EAAE,WAAW,UAAU,KAAK,CAAC;GACzF,QAAQ,CAWR;EACF;EASF,MAAM,IAAI,MAAM;CAClB;;;;;;;;;;;;;CAcA,AAAO,wBAA8B;EACnC,IAAI,iBAAiB;EAErB,MAAM,mBAAmB,OAAO,WAAmB;GACjD,IAAI,gBAAgB;GACpB,iBAAiB;GAEjB,QAAQ,IAAI,cAAc;GAC1B,MAAM,KAAK,SAAS;GACpB,QAAQ,KAAK,CAAC;EAChB;EAGA,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;EACrD,QAAQ,GAAG,iBAAiB,iBAAiB,SAAS,CAAC;EAIvD,IAAI,QAAQ,aAAa,SAEvB,QAAQ,GAAG,gBAAgB,iBAAiB,QAAQ,CAAC;CAEzD;AACF;AAEA,MAAa,oBAAoB,IAAI,kBAAkB"}

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

@@ -1 +1 @@
-{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AAsCA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAmBb;;;;;EAAA,mBAZE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;EAoBX,IAAA,IAAI,OAAA;EAPP;;;;;;;EAAA,QA0CF,oBAAA;EAmFgB;;;;;EAnDX,KAAA,IAAS,OAAA;EAwFqB;;;;;EArC9B,OAAA,IAAW,OAAA;;;;EASX,QAAA,IAAY,OAAA;;;;;;EA4BlB,aAAA,CAAc,YAAA;AAAA"}
+{"version":3,"file":"http-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/http-connector.ts"],"mappings":";;;;;;;AAqCA;;cAAa,aAAA,SAAsB,aAAA;EAAA,SACjB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,IAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EAmBb;;;;;EAAA,mBAZE,YAAA;EAV2B;;;EAAA,UAepC,IAAA,GAAO,eAAA;EAbO;;;;;EAoBX,IAAA,IAAI,OAAA;EAPP;;;;;;;EAAA,QA0CF,oBAAA;EAgFgB;;;;;EAhDX,KAAA,IAAS,OAAA;EAqFqB;;;;;EArC9B,OAAA,IAAW,OAAA;;;;EASX,QAAA,IAAY,OAAA;;;;;;EA4BlB,aAAA,CAAc,YAAA;AAAA"}

package/esm/connectors/http-connector.mjs

@@ -8,7 +8,6 @@ import "../application/index.mjs";
 import { health } from "../http/health.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import { devLogError } from "../dev-server/dev-logger.mjs";
 import config from "@mongez/config";
 import { log } from "@warlock.js/logger";
 import { colors } from "@mongez/copper";
@@ -98,7 +97,6 @@ var HttpConnector = class extends BaseConnector {
 			const baseUrl = config.get("app.baseUrl");
 			log.success(`http`, "connection", `Server ready at ${baseUrl}`);
 		} catch (error) {
-			devLogError("Error while starting http server", error);
 			await log.fatal("http", "connection", error);
 			await log.flush();
 			process.exit(1);