@warlock.js/core 4.4.0 → 4.6.0

package/esm/cli/commands/routes/routes-command.action.mjs

@@ -0,0 +1,43 @@
+import { router } from "../../../router/router.mjs";
+import { filterRouteRows, sortRouteRows, toRouteRow } from "./route-row.mjs";
+import { printRoutesTable } from "./format-routes-table.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/routes/routes-command.action.ts
+/**
+* Read the active option as a trimmed string, or `undefined` when it is absent
+* or not a string (a bare boolean flag).
+*
+* @param value - The parsed option value
+* @returns The string value, or `undefined`
+*/
+function stringOption(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+/**
+* Action behind `warlock routes`. Reads the registered routes from the router
+* singleton (populated by the `bootstrap` preload, with no connectors started),
+* applies the `--method` / `--path` / `--name` filters, sorts them, and either
+* prints a verb-colored table or — with `--json` — emits the normalized rows as
+* JSON for piping into scripts/CI.
+*
+* Read-only: it never opens a database/cache/socket connection and never
+* mutates the router.
+*
+* @param data - Parsed CLI args (`options.method` / `path` / `name` / `json`).
+*/
+function routesCommandAction({ options }) {
+	const rows = sortRouteRows(filterRouteRows(router.list().map(toRouteRow), {
+		method: stringOption(options.method),
+		path: stringOption(options.path),
+		name: stringOption(options.name)
+	}));
+	if (options.json) {
+		console.log(JSON.stringify(rows, null, 2));
+		return;
+	}
+	printRoutesTable(rows);
+}
+
+//#endregion
+export { routesCommandAction };
+//# sourceMappingURL=routes-command.action.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes-command.action.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/core/src/cli/commands/routes/routes-command.action.ts"],"sourcesContent":["import { router } from \"../../../router/router\";\nimport type { CommandActionData } from \"../../types\";\nimport { printRoutesTable } from \"./format-routes-table\";\nimport { filterRouteRows, sortRouteRows, toRouteRow } from \"./route-row\";\n\n/**\n * Read the active option as a trimmed string, or `undefined` when it is absent\n * or not a string (a bare boolean flag).\n *\n * @param value - The parsed option value\n * @returns The string value, or `undefined`\n */\nfunction stringOption(value: string | number | boolean | undefined): string | undefined {\n  return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : undefined;\n}\n\n/**\n * Action behind `warlock routes`. Reads the registered routes from the router\n * singleton (populated by the `bootstrap` preload, with no connectors started),\n * applies the `--method` / `--path` / `--name` filters, sorts them, and either\n * prints a verb-colored table or — with `--json` — emits the normalized rows as\n * JSON for piping into scripts/CI.\n *\n * Read-only: it never opens a database/cache/socket connection and never\n * mutates the router.\n *\n * @param data - Parsed CLI args (`options.method` / `path` / `name` / `json`).\n */\nexport function routesCommandAction({ options }: CommandActionData): void {\n  const rows = sortRouteRows(\n    filterRouteRows(router.list().map(toRouteRow), {\n      method: stringOption(options.method),\n      path: stringOption(options.path),\n      name: stringOption(options.name),\n    }),\n  );\n\n  if (options.json) {\n    console.log(JSON.stringify(rows, null, 2));\n    return;\n  }\n\n  printRoutesTable(rows);\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAS,aAAa,OAAkE;CACtF,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,CAAC,CAAC,SAAS,IAAI,MAAM,KAAK,IAAI;AAC/E;;;;;;;;;;;;;AAcA,SAAgB,oBAAoB,EAAE,WAAoC;CACxE,MAAM,OAAO,cACX,gBAAgB,OAAO,KAAK,CAAC,CAAC,IAAI,UAAU,GAAG;EAC7C,QAAQ,aAAa,QAAQ,MAAM;EACnC,MAAM,aAAa,QAAQ,IAAI;EAC/B,MAAM,aAAa,QAAQ,IAAI;CACjC,CAAC,CACH;CAEA,IAAI,QAAQ,MAAM;EAChB,QAAQ,IAAI,KAAK,UAAU,MAAM,MAAM,CAAC,CAAC;EACzC;CACF;CAEA,iBAAiB,IAAI;AACvB"}

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

@@ -0,0 +1,51 @@
+import { command } from "../cli-command.mjs";
+import { routesCommandAction } from "./routes/routes-command.action.mjs";
+
+//#region ../@warlock.js/core/src/cli/commands/routes.command.ts
+/**
+* `warlock routes` — list every registered HTTP route as a table (a read-only
+* sibling of `warlock doctor`). Filter with `--method` / `--path` / `--name`,
+* or emit the normalized rows as JSON with `--json`.
+*
+* Preload plan: load config + bootstrap app code so route modules register on
+* the router singleton, but start NO connectors — listing routes must never
+* open a database/cache/socket connection. Because the route-module loader is
+* fail-loud, a route file that throws on import surfaces here instead of being
+* silently omitted from the table.
+*/
+const routesCommand = command({
+	name: "routes",
+	description: "List the registered HTTP routes as a table (read-only); filter with --method / --path / --name, or emit JSON with --json",
+	action: routesCommandAction,
+	preload: {
+		config: true,
+		env: true,
+		bootstrap: true
+	},
+	options: [
+		{
+			text: "--method, -m",
+			description: "Filter by HTTP method (case-insensitive, e.g. GET, POST)",
+			type: "string"
+		},
+		{
+			text: "--path, -p",
+			description: "Filter by a case-insensitive path substring",
+			type: "string"
+		},
+		{
+			text: "--name, -n",
+			description: "Filter by a case-insensitive route-name substring",
+			type: "string"
+		},
+		{
+			text: "--json, -j",
+			description: "Output the routes as JSON instead of a table",
+			type: "boolean"
+		}
+	]
+});
+
+//#endregion
+export { routesCommand };
+//# sourceMappingURL=routes.command.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/routes.command.ts"],"sourcesContent":["import { command } from \"../cli-command\";\nimport { routesCommandAction } from \"./routes/routes-command.action\";\n\n/**\n * `warlock routes` — list every registered HTTP route as a table (a read-only\n * sibling of `warlock doctor`). Filter with `--method` / `--path` / `--name`,\n * or emit the normalized rows as JSON with `--json`.\n *\n * Preload plan: load config + bootstrap app code so route modules register on\n * the router singleton, but start NO connectors — listing routes must never\n * open a database/cache/socket connection. Because the route-module loader is\n * fail-loud, a route file that throws on import surfaces here instead of being\n * silently omitted from the table.\n */\nexport const routesCommand = command({\n  name: \"routes\",\n  description:\n    \"List the registered HTTP routes as a table (read-only); filter with --method / --path / --name, or emit JSON with --json\",\n  action: routesCommandAction,\n  preload: {\n    config: true,\n    env: true,\n    bootstrap: true,\n  },\n  options: [\n    {\n      text: \"--method, -m\",\n      description: \"Filter by HTTP method (case-insensitive, e.g. GET, POST)\",\n      type: \"string\",\n    },\n    {\n      text: \"--path, -p\",\n      description: \"Filter by a case-insensitive path substring\",\n      type: \"string\",\n    },\n    {\n      text: \"--name, -n\",\n      description: \"Filter by a case-insensitive route-name substring\",\n      type: \"string\",\n    },\n    {\n      text: \"--json, -j\",\n      description: \"Output the routes as JSON instead of a table\",\n      type: \"boolean\",\n    },\n  ],\n});\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,aACE;CACF,QAAQ;CACR,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;CACb;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}

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

@@ -32,6 +32,11 @@ const seedCommand = command({
 			description: "Run seeds in a transaction",
 			type: "boolean",
 			defaultValue: true
+		},
+		{
+			text: "--drop, -d",
+			description: "Undo seeded data — delete tracked records (reverse order) and reset the seed log; scope to one seeder with --drop=\"Seed Name\"",
+			type: "string"
 		}
 	]
 });

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

@@ -1 +1 @@
-{"version":3,"file":"seed.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/seed.command.ts"],"sourcesContent":["import { seedCommandAction } from \"../../database/seed-command-action\";\r\nimport { command } from \"../cli-command\";\r\n\r\nexport const seedCommand = command({\r\n  action: seedCommandAction,\r\n  name: \"seed\",\r\n  description: \"Run database seeds\",\r\n  preload: {\r\n    config: true,\r\n    env: true,\r\n    bootstrap: true,\r\n    connectors: [\"database\", \"cache\", \"logger\"],\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--fresh, -f\",\r\n      description: \"Drop all tables records and run seeds\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--list, -l\",\r\n      description: \"Display the seeds list in order without execution\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--transaction, -t\",\r\n      description: \"Run seeds in a transaction\",\r\n      type: \"boolean\",\r\n      defaultValue: true,\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;AAGA,MAAa,cAAc,QAAQ;CACjC,QAAQ;CACR,MAAM;CACN,aAAa;CACb,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;EACX,YAAY;GAAC;GAAY;GAAS;EAAQ;CAC5C;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACN,cAAc;EAChB;CACF;AACF,CAAC"}
+{"version":3,"file":"seed.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/seed.command.ts"],"sourcesContent":["import { seedCommandAction } from \"../../database/seed-command-action\";\nimport { command } from \"../cli-command\";\n\nexport const seedCommand = command({\n  action: seedCommandAction,\n  name: \"seed\",\n  description: \"Run database seeds\",\n  preload: {\n    config: true,\n    env: true,\n    bootstrap: true,\n    connectors: [\"database\", \"cache\", \"logger\"],\n  },\n  options: [\n    {\n      text: \"--fresh, -f\",\n      description: \"Drop all tables records and run seeds\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--list, -l\",\n      description: \"Display the seeds list in order without execution\",\n      type: \"boolean\",\n    },\n    {\n      text: \"--transaction, -t\",\n      description: \"Run seeds in a transaction\",\n      type: \"boolean\",\n      defaultValue: true,\n    },\n    {\n      text: \"--drop, -d\",\n      description:\n        'Undo seeded data — delete tracked records (reverse order) and reset the seed log; scope to one seeder with --drop=\"Seed Name\"',\n      type: \"string\",\n    },\n  ],\n});\n"],"mappings":";;;;AAGA,MAAa,cAAc,QAAQ;CACjC,QAAQ;CACR,MAAM;CACN,aAAa;CACb,SAAS;EACP,QAAQ;EACR,KAAK;EACL,WAAW;EACX,YAAY;GAAC;GAAY;GAAS;EAAQ;CAC5C;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACN,cAAc;EAChB;EACA;GACE,MAAM;GACN,aACE;GACF,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/framework-cli-commands.mjs

@@ -2,9 +2,11 @@ import { addCommand } from "./commands/add.command.mjs";
 import { buildCommand } from "./commands/build.command.mjs";
 import { createDatabaseCommand } from "./commands/create-database.command.mjs";
 import { devServerCommand } from "./commands/dev-server.command.mjs";
+import { doctorCommand } from "./commands/doctor.command.mjs";
 import { dropTablesCommand } from "./commands/drop-tables.command.mjs";
 import { generateCommand, generateControllerCommand, generateMigrationCommand, generateModelCommand, generateModuleCommand, generateRepositoryCommand, generateResourceCommand, generateServiceCommand } from "./commands/generate/generate.command.mjs";
 import { migrateCommand } from "./commands/migrate.command.mjs";
+import { routesCommand } from "./commands/routes.command.mjs";
 import { seedCommand } from "./commands/seed.command.mjs";
 import { startProductionCommand } from "./commands/start-production.command.mjs";
 import { storagePutCommand } from "./commands/storage-put.command.mjs";
@@ -15,6 +17,8 @@ import { updateCommand } from "./commands/update.command.mjs";
 const frameworkCommands = [
 	devServerCommand,
 	typingsGeneratorCommand,
+	doctorCommand,
+	routesCommand,
 	buildCommand,
 	startProductionCommand,
 	migrateCommand,

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

@@ -1 +1 @@
-{"version":3,"file":"framework-cli-commands.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/cli/framework-cli-commands.ts"],"sourcesContent":["import { addCommand } from \"./commands/add.command\";\r\nimport { buildCommand } from \"./commands/build.command\";\r\nimport { createDatabaseCommand } from \"./commands/create-database.command\";\r\nimport { devServerCommand } from \"./commands/dev-server.command\";\r\nimport { dropTablesCommand } from \"./commands/drop-tables.command\";\r\nimport {\r\n  generateCommand,\r\n  generateControllerCommand,\r\n  generateMigrationCommand,\r\n  generateModelCommand,\r\n  generateModuleCommand,\r\n  generateRepositoryCommand,\r\n  generateResourceCommand,\r\n  generateServiceCommand,\r\n} from \"./commands/generate/generate.command\";\r\nimport { migrateCommand } from \"./commands/migrate.command\";\r\nimport { seedCommand } from \"./commands/seed.command\";\r\nimport { startProductionCommand } from \"./commands/start-production.command\";\r\nimport { storagePutCommand } from \"./commands/storage-put.command\";\r\nimport { typingsGeneratorCommand } from \"./commands/typings-generator.command\";\r\nimport { updateCommand } from \"./commands/update.command\";\r\n\r\nexport const frameworkCommands = [\r\n  // development commands\r\n  devServerCommand,\r\n  typingsGeneratorCommand,\r\n\r\n  // production commands\r\n  buildCommand,\r\n  startProductionCommand,\r\n\r\n  // database commands\r\n  migrateCommand,\r\n  seedCommand,\r\n  createDatabaseCommand,\r\n  dropTablesCommand,\r\n\r\n  // generation/installation commands\r\n  addCommand,\r\n  updateCommand,\r\n\r\n  // scaffolding commands\r\n  generateCommand,\r\n  generateModuleCommand,\r\n  generateControllerCommand,\r\n  generateServiceCommand,\r\n  generateModelCommand,\r\n  generateRepositoryCommand,\r\n  generateResourceCommand,\r\n  generateMigrationCommand,\r\n\r\n  // storage commands\r\n  storagePutCommand,\r\n];\r\n"],"mappings":";;;;;;;;;;;;;;AAsBA,MAAa,oBAAoB;CAE/B;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;AACF"}
+{"version":3,"file":"framework-cli-commands.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/cli/framework-cli-commands.ts"],"sourcesContent":["import { addCommand } from \"./commands/add.command\";\r\nimport { buildCommand } from \"./commands/build.command\";\r\nimport { createDatabaseCommand } from \"./commands/create-database.command\";\r\nimport { devServerCommand } from \"./commands/dev-server.command\";\r\nimport { doctorCommand } from \"./commands/doctor.command\";\r\nimport { dropTablesCommand } from \"./commands/drop-tables.command\";\r\nimport {\r\n  generateCommand,\r\n  generateControllerCommand,\r\n  generateMigrationCommand,\r\n  generateModelCommand,\r\n  generateModuleCommand,\r\n  generateRepositoryCommand,\r\n  generateResourceCommand,\r\n  generateServiceCommand,\r\n} from \"./commands/generate/generate.command\";\r\nimport { migrateCommand } from \"./commands/migrate.command\";\r\nimport { routesCommand } from \"./commands/routes.command\";\r\nimport { seedCommand } from \"./commands/seed.command\";\r\nimport { startProductionCommand } from \"./commands/start-production.command\";\r\nimport { storagePutCommand } from \"./commands/storage-put.command\";\r\nimport { typingsGeneratorCommand } from \"./commands/typings-generator.command\";\r\nimport { updateCommand } from \"./commands/update.command\";\r\n\r\nexport const frameworkCommands = [\r\n  // development commands\r\n  devServerCommand,\r\n  typingsGeneratorCommand,\r\n\r\n  // diagnostics commands\r\n  doctorCommand,\r\n  routesCommand,\r\n\r\n  // production commands\r\n  buildCommand,\r\n  startProductionCommand,\r\n\r\n  // database commands\r\n  migrateCommand,\r\n  seedCommand,\r\n  createDatabaseCommand,\r\n  dropTablesCommand,\r\n\r\n  // generation/installation commands\r\n  addCommand,\r\n  updateCommand,\r\n\r\n  // scaffolding commands\r\n  generateCommand,\r\n  generateModuleCommand,\r\n  generateControllerCommand,\r\n  generateServiceCommand,\r\n  generateModelCommand,\r\n  generateRepositoryCommand,\r\n  generateResourceCommand,\r\n  generateMigrationCommand,\r\n\r\n  // storage commands\r\n  storagePutCommand,\r\n];\r\n"],"mappings":";;;;;;;;;;;;;;;;AAwBA,MAAa,oBAAoB;CAE/B;CACA;CAGA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;AACF"}

package/esm/config/config-getter.mjs

@@ -1,4 +1,4 @@
-import baseConfig from "@mongez/config";
+import config from "@mongez/config";
 
 //#region ../@warlock.js/core/src/config/config-getter.ts
 /**
@@ -14,15 +14,15 @@ import baseConfig from "@mongez/config";
 * const port = config.key<number>("database.port", 27017);
 * ```
 */
-const config = {
+const config$1 = {
 	key(key, defaultValue) {
-		return baseConfig.get(key, defaultValue);
+		return config.get(key, defaultValue);
 	},
 	get(name, defaultValue) {
-		return baseConfig.get(name, defaultValue);
+		return config.get(name, defaultValue);
 	}
 };
 
 //#endregion
-export { config };
+export { config$1 as config };
 //# sourceMappingURL=config-getter.mjs.map

package/esm/config/config-getter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-getter.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/config/config-getter.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport type { ConfigKey, ConfigRegistry } from \"./types\";\n\n/**\n * Config accessor interface with typed overloads\n */\ninterface ConfigAccessor {\n  /**\n   * Get a config value by dot-notation key path.\n   */\n  key<T = any>(key: ConfigKey | (string & {}), defaultValue?: T): T;\n\n  /**\n   * Get an entire config group by name with type inference.\n   * Returns the typed config object for known config names.\n   */\n  get<K extends keyof ConfigRegistry>(name: K, defaultValue?: ConfigRegistry[K]): ConfigRegistry[K];\n\n  /**\n   * Get an entire config group by name (dynamic string).\n   */\n  get<T = any>(name: string, defaultValue?: T): T;\n}\n\n/**\n * Config accessor with typed autocomplete and return type inference.\n *\n * @example\n * ```typescript\n * // Get entire config group - returns the actual config type\n * const db = config.get(\"database\"); // → DatabaseConfigurations\n *\n * // Get specific key with dot notation\n * const host = config.key(\"database.host\");\n * const port = config.key<number>(\"database.port\", 27017);\n * ```\n */\nexport const config: ConfigAccessor = {\n  key(key: ConfigKey | (string & {}), defaultValue?: any): any {\n    return baseConfig.get(key, defaultValue);\n  },\n\n  get(name: string, defaultValue?: any): any {\n    return baseConfig.get(name, defaultValue);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,MAAa,SAAyB;CACpC,IAAI,KAAgC,cAAyB;EAC3D,OAAO,WAAW,IAAI,KAAK,YAAY;CACzC;CAEA,IAAI,MAAc,cAAyB;EACzC,OAAO,WAAW,IAAI,MAAM,YAAY;CAC1C;AACF"}
+{"version":3,"file":"config-getter.mjs","names":["config","baseConfig"],"sources":["../../../../../../../@warlock.js/core/src/config/config-getter.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport type { ConfigKey, ConfigRegistry } from \"./types\";\n\n/**\n * Config accessor interface with typed overloads\n */\ninterface ConfigAccessor {\n  /**\n   * Get a config value by dot-notation key path.\n   */\n  key<T = any>(key: ConfigKey | (string & {}), defaultValue?: T): T;\n\n  /**\n   * Get an entire config group by name with type inference.\n   * Returns the typed config object for known config names.\n   */\n  get<K extends keyof ConfigRegistry>(name: K, defaultValue?: ConfigRegistry[K]): ConfigRegistry[K];\n\n  /**\n   * Get an entire config group by name (dynamic string).\n   */\n  get<T = any>(name: string, defaultValue?: T): T;\n}\n\n/**\n * Config accessor with typed autocomplete and return type inference.\n *\n * @example\n * ```typescript\n * // Get entire config group - returns the actual config type\n * const db = config.get(\"database\"); // → DatabaseConfigurations\n *\n * // Get specific key with dot notation\n * const host = config.key(\"database.host\");\n * const port = config.key<number>(\"database.port\", 27017);\n * ```\n */\nexport const config: ConfigAccessor = {\n  key(key: ConfigKey | (string & {}), defaultValue?: any): any {\n    return baseConfig.get(key, defaultValue);\n  },\n\n  get(name: string, defaultValue?: any): any {\n    return baseConfig.get(name, defaultValue);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,MAAaA,WAAyB;CACpC,IAAI,KAAgC,cAAyB;EAC3D,OAAOC,OAAW,IAAI,KAAK,YAAY;CACzC;CAEA,IAAI,MAAc,cAAyB;EACzC,OAAOA,OAAW,IAAI,MAAM,YAAY;CAC1C;AACF"}

package/esm/config/config-loader.mjs

@@ -1,5 +1,5 @@
 import { configSpecialHandlers } from "./config-special-handlers.mjs";
-import baseConfig from "@mongez/config";
+import config from "@mongez/config";
 import { colors } from "@mongez/copper";
 import { pathToFileURL } from "node:url";
 
@@ -27,7 +27,7 @@ var ConfigLoader = class {
 				console.log(colors.red(`config error: `), `Config file ${colors.yellow(file.relativePath)} does not have a default export`);
 				return;
 			}
-			baseConfig.set(configName, configValue);
+			config.set(configName, configValue);
 			await configSpecialHandlers.execute(configName, configValue);
 		} catch (error) {
 			throw error;

package/esm/config/config-loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { pathToFileURL } from \"node:url\";\r\nimport type { FileManager } from \"../dev-server/file-manager\";\r\nimport { configSpecialHandlers } from \"./config-special-handlers\";\r\n\r\n/**\r\n * Special Config Handler\r\n * A function that handles special configuration loading\r\n */\r\nexport type SpecialConfigHandler = (configValue: any) => void | Promise<void>;\r\n\r\n/**\r\n * Config Loader\r\n * Dynamically loads all configuration files and registers them with @mongez/config\r\n * Supports special handlers for configs that require additional processing\r\n */\r\nexport class ConfigLoader {\r\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\r\n    for (const file of configFiles) {\r\n      await this.loadConfig(file);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load a single configuration file.\r\n   *\r\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\r\n   * cycle gets a fresh module — no manual cache-busting needed here.\r\n   */\r\n  public async loadConfig(file: FileManager): Promise<void> {\r\n    const configName = this.getConfigName(file.relativePath);\r\n\r\n    try {\r\n      const fileUrl = pathToFileURL(file.absolutePath).href;\r\n      const configModule = await import(fileUrl);\r\n      const configValue = configModule.default;\r\n\r\n      if (configValue === undefined) {\r\n        console.log(\r\n          colors.red(`config error: `),\r\n          `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\r\n        );\r\n        return;\r\n      }\r\n\r\n      config.set(configName, configValue);\r\n      await configSpecialHandlers.execute(configName, configValue);\r\n    } catch (error) {\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  public async reloadConfig(file: FileManager): Promise<void> {\r\n    await this.loadConfig(file);\r\n  }\r\n\r\n  private getConfigName(relativePath: string): string {\r\n    const match = relativePath.match(/^src\\/config\\/(.+)\\.(ts|tsx)$/);\r\n\r\n    if (!match) {\r\n      throw new Error(`Invalid config file path: ${relativePath}`);\r\n    }\r\n\r\n    return match[1];\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AAiBA,IAAa,eAAb,MAA0B;CACxB,MAAa,QAAQ,aAA2C;EAC9D,KAAK,MAAM,QAAQ,aACjB,MAAM,KAAK,WAAW,IAAI;CAE9B;;;;;;;CAQA,MAAa,WAAW,MAAkC;EACxD,MAAM,aAAa,KAAK,cAAc,KAAK,YAAY;EAEvD,IAAI;GAGF,MAAM,eAAc,MADO,OADX,cAAc,KAAK,YAAY,CAAC,CAAC,MAEjB,CAAC;GAEjC,IAAI,gBAAgB,QAAW;IAC7B,QAAQ,IACN,OAAO,IAAI,gBAAgB,GAC3B,eAAe,OAAO,OAAO,KAAK,YAAY,EAAE,gCAClD;IACA;GACF;GAEA,WAAO,IAAI,YAAY,WAAW;GAClC,MAAM,sBAAsB,QAAQ,YAAY,WAAW;EAC7D,SAAS,OAAO;GACd,MAAM;EACR;CACF;CAEA,MAAa,aAAa,MAAkC;EAC1D,MAAM,KAAK,WAAW,IAAI;CAC5B;CAEA,AAAQ,cAAc,cAA8B;EAClD,MAAM,QAAQ,aAAa,MAAM,+BAA+B;EAEhE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,OAAO,MAAM;CACf;AACF"}
+{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { pathToFileURL } from \"node:url\";\r\nimport type { FileManager } from \"../dev-server/file-manager\";\r\nimport { configSpecialHandlers } from \"./config-special-handlers\";\r\n\r\n/**\r\n * Special Config Handler\r\n * A function that handles special configuration loading\r\n */\r\nexport type SpecialConfigHandler = (configValue: any) => void | Promise<void>;\r\n\r\n/**\r\n * Config Loader\r\n * Dynamically loads all configuration files and registers them with @mongez/config\r\n * Supports special handlers for configs that require additional processing\r\n */\r\nexport class ConfigLoader {\r\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\r\n    for (const file of configFiles) {\r\n      await this.loadConfig(file);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load a single configuration file.\r\n   *\r\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\r\n   * cycle gets a fresh module — no manual cache-busting needed here.\r\n   */\r\n  public async loadConfig(file: FileManager): Promise<void> {\r\n    const configName = this.getConfigName(file.relativePath);\r\n\r\n    try {\r\n      const fileUrl = pathToFileURL(file.absolutePath).href;\r\n      const configModule = await import(fileUrl);\r\n      const configValue = configModule.default;\r\n\r\n      if (configValue === undefined) {\r\n        console.log(\r\n          colors.red(`config error: `),\r\n          `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\r\n        );\r\n        return;\r\n      }\r\n\r\n      config.set(configName, configValue);\r\n      await configSpecialHandlers.execute(configName, configValue);\r\n    } catch (error) {\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  public async reloadConfig(file: FileManager): Promise<void> {\r\n    await this.loadConfig(file);\r\n  }\r\n\r\n  private getConfigName(relativePath: string): string {\r\n    const match = relativePath.match(/^src\\/config\\/(.+)\\.(ts|tsx)$/);\r\n\r\n    if (!match) {\r\n      throw new Error(`Invalid config file path: ${relativePath}`);\r\n    }\r\n\r\n    return match[1];\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AAiBA,IAAa,eAAb,MAA0B;CACxB,MAAa,QAAQ,aAA2C;EAC9D,KAAK,MAAM,QAAQ,aACjB,MAAM,KAAK,WAAW,IAAI;CAE9B;;;;;;;CAQA,MAAa,WAAW,MAAkC;EACxD,MAAM,aAAa,KAAK,cAAc,KAAK,YAAY;EAEvD,IAAI;GAGF,MAAM,eAAc,MADO,OADX,cAAc,KAAK,YAAY,CAAC,CAAC,MAEjB,CAAC;GAEjC,IAAI,gBAAgB,QAAW;IAC7B,QAAQ,IACN,OAAO,IAAI,gBAAgB,GAC3B,eAAe,OAAO,OAAO,KAAK,YAAY,EAAE,gCAClD;IACA;GACF;GAEA,OAAO,IAAI,YAAY,WAAW;GAClC,MAAM,sBAAsB,QAAQ,YAAY,WAAW;EAC7D,SAAS,OAAO;GACd,MAAM;EACR;CACF;CAEA,MAAa,aAAa,MAAkC;EAC1D,MAAM,KAAK,WAAW,IAAI;CAC5B;CAEA,AAAQ,cAAc,cAA8B;EAClD,MAAM,QAAQ,aAAa,MAAM,+BAA+B;EAEhE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,OAAO,MAAM;CACf;AACF"}

package/esm/connectors/access-connector.mjs

@@ -1,6 +1,6 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import baseConfig from "@mongez/config";
+import config from "@mongez/config";
 import { log } from "@warlock.js/logger";
 
 //#region ../@warlock.js/core/src/connectors/access-connector.ts
@@ -29,7 +29,7 @@ var AccessConnector = class extends BaseConnector {
 	* Register the access configuration with the package.
 	*/
 	async start() {
-		const accessConfiguration = baseConfig.get("access");
+		const accessConfiguration = config.get("access");
 		if (!accessConfiguration) return;
 		const { setAccessConfig } = await import("@warlock.js/access");
 		setAccessConfig(accessConfiguration);

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

@@ -1 +1 @@
-{"version":3,"file":"access-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/access-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Access Connector\n *\n * Wires `@warlock.js/access` from `src/config/access.ts` at boot: reads the\n * exported config object and hands it to the package's `setAccessConfig`, which\n * validates that a resolver is present — so a misconfigured authorization layer\n * fails at STARTUP, not on the first protected request. Config files stay\n * declarative; the connector performs the side-effect.\n *\n * The package is lazy-imported (only when an access config is present), so core\n * carries no hard dependency on it — the same pattern as the notifications and\n * herald connectors.\n */\nexport class AccessConnector extends BaseConnector {\n  public readonly name = \"access\";\n  public readonly priority = ConnectorPriority.ACCESS;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger an access restart\n   */\n  protected readonly watchedFiles = [\"src/config/access.ts\"];\n\n  /**\n   * Register the access configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const accessConfiguration = config.get(\"access\");\n\n    if (!accessConfiguration) {\n      return;\n    }\n\n    const { setAccessConfig } = await import(\"@warlock.js/access\");\n\n    setAccessConfig(accessConfiguration);\n    this.active = true;\n\n    log.info(\"access\", \"configured\", \"Authorization wired from config/access.ts\");\n  }\n\n  /**\n   * Clear the active config so a dev restart re-registers from the (possibly\n   * changed, or now-removed) config file. The package holds no external\n   * connection of its own.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const { resetAccessConfig } = await import(\"@warlock.js/access\");\n\n    resetAccessConfig();\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,sBAAsB;;;;;CAKzD,MAAa,QAAuB;EAClC,MAAM,sBAAsBA,WAAO,IAAI,QAAQ;EAE/C,IAAI,CAAC,qBACH;EAGF,MAAM,EAAE,oBAAoB,MAAM,OAAO;EAEzC,gBAAgB,mBAAmB;EACnC,KAAK,SAAS;EAEd,IAAI,KAAK,UAAU,cAAc,2CAA2C;CAC9E;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,MAAM,EAAE,sBAAsB,MAAM,OAAO;EAE3C,kBAAkB;EAClB,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"access-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/access-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Access Connector\n *\n * Wires `@warlock.js/access` from `src/config/access.ts` at boot: reads the\n * exported config object and hands it to the package's `setAccessConfig`, which\n * validates that a resolver is present — so a misconfigured authorization layer\n * fails at STARTUP, not on the first protected request. Config files stay\n * declarative; the connector performs the side-effect.\n *\n * The package is lazy-imported (only when an access config is present), so core\n * carries no hard dependency on it — the same pattern as the notifications and\n * herald connectors.\n */\nexport class AccessConnector extends BaseConnector {\n  public readonly name = \"access\";\n  public readonly priority = ConnectorPriority.ACCESS;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger an access restart\n   */\n  protected readonly watchedFiles = [\"src/config/access.ts\"];\n\n  /**\n   * Register the access configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const accessConfiguration = config.get(\"access\");\n\n    if (!accessConfiguration) {\n      return;\n    }\n\n    const { setAccessConfig } = await import(\"@warlock.js/access\");\n\n    setAccessConfig(accessConfiguration);\n    this.active = true;\n\n    log.info(\"access\", \"configured\", \"Authorization wired from config/access.ts\");\n  }\n\n  /**\n   * Clear the active config so a dev restart re-registers from the (possibly\n   * changed, or now-removed) config file. The package holds no external\n   * connection of its own.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const { resetAccessConfig } = await import(\"@warlock.js/access\");\n\n    resetAccessConfig();\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,IAAa,kBAAb,cAAqC,cAAc;;;cAC1B;;;sBAOW,CAAC,sBAAsB;;;;;CAKzD,MAAa,QAAuB;EAClC,MAAM,sBAAsB,OAAO,IAAI,QAAQ;EAE/C,IAAI,CAAC,qBACH;EAGF,MAAM,EAAE,oBAAoB,MAAM,OAAO;EAEzC,gBAAgB,mBAAmB;EACnC,KAAK,SAAS;EAEd,IAAI,KAAK,UAAU,cAAc,2CAA2C;CAC9E;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,MAAM,EAAE,sBAAsB,MAAM,OAAO;EAE3C,kBAAkB;EAClB,KAAK,SAAS;CAChB;AACF"}

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

@@ -0,0 +1,43 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+
+//#region ../@warlock.js/core/src/connectors/ai-connector.d.ts
+/**
+ * AI Connector
+ *
+ * Wires `@warlock.js/ai` from `src/config/ai.ts` at boot: reads the exported
+ * config object and hands it to the package's `ai.config(...)`. Config files stay
+ * declarative; the connector performs the side-effect.
+ *
+ * The package is lazy-imported (only when an ai config is present), so core
+ * carries no hard dependency on it — the same pattern as the access,
+ * notifications and herald connectors.
+ *
+ * Because the satellite packages' side-effect imports sit at the TOP of
+ * config/ai.ts, they have already registered their surface on `ai` (ai.tools /
+ * ai.mcp, ai.workspace, panoptic) by the time config-loader runs the file and
+ * this connector applies the config — so this single `ai.config(...)` call also
+ * fires panoptic's onConfigApplied wiring.
+ */
+declare class AiConnector extends BaseConnector {
+  readonly name = "ai";
+  readonly priority = ConnectorPriority.AI;
+  readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
+  /**
+   * Files that trigger an ai restart
+   */
+  protected readonly watchedFiles: string[];
+  /**
+   * Register the ai configuration with the package.
+   */
+  start(): Promise<void>;
+  /**
+   * Clear the active flag so a dev restart re-registers from the (possibly
+   * changed, or now-removed) config file. The package holds no external
+   * connection of its own.
+   */
+  shutdown(): Promise<void>;
+}
+//#endregion
+export { AiConnector };
+//# sourceMappingURL=ai-connector.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/ai-connector.ts"],"mappings":";;;;;;AAsBA;;;;;;;;;;;;;;;cAAa,WAAA,SAAoB,aAAA;EAAA,SACf,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,EAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAUjB;;;EAAA,mBALM,YAAA;EAuBa;AAAA;;EAlBnB,KAAA,IAAS,OAAA;;;;;;EAkBT,QAAA,IAAY,OAAA;AAAA"}

package/esm/connectors/ai-connector.mjs

@@ -0,0 +1,56 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+import config from "@mongez/config";
+import { log } from "@warlock.js/logger";
+
+//#region ../@warlock.js/core/src/connectors/ai-connector.ts
+/**
+* AI Connector
+*
+* Wires `@warlock.js/ai` from `src/config/ai.ts` at boot: reads the exported
+* config object and hands it to the package's `ai.config(...)`. Config files stay
+* declarative; the connector performs the side-effect.
+*
+* The package is lazy-imported (only when an ai config is present), so core
+* carries no hard dependency on it — the same pattern as the access,
+* notifications and herald connectors.
+*
+* Because the satellite packages' side-effect imports sit at the TOP of
+* config/ai.ts, they have already registered their surface on `ai` (ai.tools /
+* ai.mcp, ai.workspace, panoptic) by the time config-loader runs the file and
+* this connector applies the config — so this single `ai.config(...)` call also
+* fires panoptic's onConfigApplied wiring.
+*/
+var AiConnector = class extends BaseConnector {
+	constructor(..._args) {
+		super(..._args);
+		this.name = "ai";
+		this.priority = 10;
+		this.lifecyclePhase = "early";
+		this.watchedFiles = ["src/config/ai.ts"];
+	}
+	/**
+	* Register the ai configuration with the package.
+	*/
+	async start() {
+		const aiConfiguration = config.get("ai");
+		if (!aiConfiguration) return;
+		const { ai } = await import("../ai/src/index.mjs");
+		ai.config(aiConfiguration);
+		this.active = true;
+		log.info("ai", "configured", "AI wired from config/ai.ts");
+	}
+	/**
+	* Clear the active flag so a dev restart re-registers from the (possibly
+	* changed, or now-removed) config file. The package holds no external
+	* connection of its own.
+	*/
+	async shutdown() {
+		if (!this.active) return;
+		this.active = false;
+	}
+};
+
+//#endregion
+export { AiConnector };
+//# sourceMappingURL=ai-connector.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/ai-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * AI Connector\n *\n * Wires `@warlock.js/ai` from `src/config/ai.ts` at boot: reads the exported\n * config object and hands it to the package's `ai.config(...)`. Config files stay\n * declarative; the connector performs the side-effect.\n *\n * The package is lazy-imported (only when an ai config is present), so core\n * carries no hard dependency on it — the same pattern as the access,\n * notifications and herald connectors.\n *\n * Because the satellite packages' side-effect imports sit at the TOP of\n * config/ai.ts, they have already registered their surface on `ai` (ai.tools /\n * ai.mcp, ai.workspace, panoptic) by the time config-loader runs the file and\n * this connector applies the config — so this single `ai.config(...)` call also\n * fires panoptic's onConfigApplied wiring.\n */\nexport class AiConnector extends BaseConnector {\n  public readonly name = \"ai\";\n  public readonly priority = ConnectorPriority.AI;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger an ai restart\n   */\n  protected readonly watchedFiles = [\"src/config/ai.ts\"];\n\n  /**\n   * Register the ai configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const aiConfiguration = config.get(\"ai\");\n\n    if (!aiConfiguration) return;\n\n    const { ai } = await import(\"@warlock.js/ai\");\n\n    ai.config(aiConfiguration);\n    this.active = true;\n\n    log.info(\"ai\", \"configured\", \"AI wired from config/ai.ts\");\n  }\n\n  /**\n   * Clear the active flag so a dev restart re-registers from the (possibly\n   * changed, or now-removed) config file. The package holds no external\n   * connection of its own.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) return;\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,cAAb,cAAiC,cAAc;;;cACtB;;;sBAOW,CAAC,kBAAkB;;;;;CAKrD,MAAa,QAAuB;EAClC,MAAM,kBAAkB,OAAO,IAAI,IAAI;EAEvC,IAAI,CAAC,iBAAiB;EAEtB,MAAM,EAAE,OAAO,MAAM,OAAO;EAE5B,GAAG,OAAO,eAAe;EACzB,KAAK,SAAS;EAEd,IAAI,KAAK,MAAM,cAAc,4BAA4B;CAC3D;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QAAQ;EAElB,KAAK,SAAS;CAChB;AACF"}

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

@@ -20,6 +20,11 @@ declare class CacheConnector extends BaseConnector {
   start(): Promise<void>;
   /**
    * Shutdown cache connection
+   *
+   * Disconnects every loaded cache driver so external clients (e.g. a Redis
+   * connection) are released instead of left dangling — mirroring the
+   * database and herald connectors, which disconnect all registered
+   * connections on shutdown.
    */
   shutdown(): Promise<void>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cache-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"mappings":";;;;;;AASA;;cAAa,cAAA,SAAuB,aAAA;EAAA,SAClB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,KAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAyBL;;;EAAA,mBApBN,YAAA;EARe;;;EAarB,KAAA,IAAS,OAAA;EAXE;;;EA0BX,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"cache-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"mappings":";;;;;;AAUA;;cAAa,cAAA,SAAuB,aAAA;EAAA,SAClB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,KAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EA8BL;;;EAAA,mBAzBN,YAAA;EARe;;;EAarB,KAAA,IAAS,OAAA;EAXE;;;;;;;;EA+BX,QAAA,IAAY,OAAA;AAAA"}

package/esm/connectors/cache-connector.mjs

@@ -1,6 +1,6 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import baseConfig from "@mongez/config";
+import config from "@mongez/config";
 import { cache } from "@warlock.js/cache";
 
 //#region ../@warlock.js/core/src/connectors/cache-connector.ts
@@ -20,7 +20,7 @@ var CacheConnector = class extends BaseConnector {
 	* Initialize cache connection
 	*/
 	async start() {
-		const cacheConfig = baseConfig.get("cache");
+		const cacheConfig = config.get("cache");
 		if (!cacheConfig) return;
 		cache.setCacheConfigurations(cacheConfig);
 		await cache.init();
@@ -28,9 +28,16 @@ var CacheConnector = class extends BaseConnector {
 	}
 	/**
 	* Shutdown cache connection
+	*
+	* Disconnects every loaded cache driver so external clients (e.g. a Redis
+	* connection) are released instead of left dangling — mirroring the
+	* database and herald connectors, which disconnect all registered
+	* connections on shutdown.
 	*/
 	async shutdown() {
 		if (!this.active) return;
+		const drivers = Object.values(cache.loadedDrivers);
+		for (const driver of drivers) await driver.disconnect();
 		this.active = false;
 	}
 };

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

@@ -1 +1 @@
-{"version":3,"file":"cache-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { cache } from \"@warlock.js/cache\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Cache Connector\r\n * Manages cache engine connection lifecycle\r\n */\r\nexport class CacheConnector extends BaseConnector {\r\n  public readonly name = \"cache\";\r\n  public readonly priority = ConnectorPriority.CACHE;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger cache restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/cache.ts\", \"src/config/cache.tsx\"];\r\n\r\n  /**\r\n   * Initialize cache connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const cacheConfig = config.get(\"cache\");\r\n\r\n    if (!cacheConfig) return;\r\n\r\n    cache.setCacheConfigurations(cacheConfig);\r\n\r\n    await cache.init();\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Shutdown cache connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    // TODO: Implement actual cache disconnection\r\n    // - Close all active connections\r\n    // - Clean up resources\r\n\r\n    this.active = false;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AASA,IAAa,iBAAb,cAAoC,cAAc;;;cACzB;;;sBAOW,CAAC,uBAAuB,sBAAsB;;;;;CAKhF,MAAa,QAAuB;EAClC,MAAM,cAAcA,WAAO,IAAI,OAAO;EAEtC,IAAI,CAAC,aAAa;EAElB,MAAM,uBAAuB,WAAW;EAExC,MAAM,MAAM,KAAK;EAEjB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAOF,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"cache-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { cache } from \"@warlock.js/cache\";\nimport type { CacheDriver } from \"@warlock.js/cache\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class CacheConnector extends BaseConnector {\n  public readonly name = \"cache\";\n  public readonly priority = ConnectorPriority.CACHE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/cache.ts\", \"src/config/cache.tsx\"];\n\n  /**\n   * Initialize cache connection\n   */\n  public async start(): Promise<void> {\n    const cacheConfig = config.get(\"cache\");\n\n    if (!cacheConfig) return;\n\n    cache.setCacheConfigurations(cacheConfig);\n\n    await cache.init();\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   *\n   * Disconnects every loaded cache driver so external clients (e.g. a Redis\n   * connection) are released instead of left dangling — mirroring the\n   * database and herald connectors, which disconnect all registered\n   * connections on shutdown.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    // Disconnect every driver the manager loaded (not just the current one),\n    // so secondary drivers selected via `cache.use(\"...\")` also release their\n    // connections.\n    const drivers: CacheDriver<unknown, unknown>[] = Object.values(cache.loadedDrivers);\n\n    for (const driver of drivers) {\n      await driver.disconnect();\n    }\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;AAUA,IAAa,iBAAb,cAAoC,cAAc;;;cACzB;;;sBAOW,CAAC,uBAAuB,sBAAsB;;;;;CAKhF,MAAa,QAAuB;EAClC,MAAM,cAAc,OAAO,IAAI,OAAO;EAEtC,IAAI,CAAC,aAAa;EAElB,MAAM,uBAAuB,WAAW;EAExC,MAAM,MAAM,KAAK;EAEjB,KAAK,SAAS;CAChB;;;;;;;;;CAUA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAMF,MAAM,UAA2C,OAAO,OAAO,MAAM,aAAa;EAElF,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,WAAW;EAG1B,KAAK,SAAS;CAChB;AACF"}

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

@@ -43,10 +43,14 @@ declare class ConnectorsManager {
   /**
    * Shutdown connectors on process kill
    *
-   * Handles graceful shutdown for both Unix and Windows:
+   * Registers signal handlers that run an idempotent graceful shutdown:
    * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes
    * - SIGTERM: Termination signal (Unix primarily)
-   * - beforeExit: Fires when Node.js empties its event loop (more reliable on Windows)
+   * - SIGHUP: registered on Windows (`win32`) only, to catch Ctrl+C / console close
+   *
+   * Note: no `beforeExit` handler is registered — `beforeExit` cannot reliably
+   * await async teardown (the process exits once the callback returns), so
+   * shutdown is driven entirely by the signal handlers above.
    */
   shutdownOnProcessKill(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"mappings":";;;cAgBa,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EA8BF;;;;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;EAkDd;;;;AAA2C;;;;EAzB/C,qBAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}
+{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/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"}

package/esm/connectors/connectors-manager.mjs

@@ -1,6 +1,7 @@
 import { Application } from "../application/application.mjs";
 import "../application/index.mjs";
 import { AccessConnector } from "./access-connector.mjs";
+import { AiConnector } from "./ai-connector.mjs";
 import { CacheConnector } from "./cache-connector.mjs";
 import { HeraldConnector } from "./herald-connector.mjs";
 import { devServeLog } from "../dev-server/dev-logger.mjs";
@@ -30,6 +31,7 @@ var ConnectorsManager = class {
 		this.register(new SocketConnector());
 		this.register(new NotificationsConnector());
 		this.register(new AccessConnector());
+		this.register(new AiConnector());
 	}
 	/**
 	* Register a connector
@@ -86,10 +88,14 @@ var ConnectorsManager = class {
 	/**
 	* Shutdown connectors on process kill
 	*
-	* Handles graceful shutdown for both Unix and Windows:
+	* Registers signal handlers that run an idempotent graceful shutdown:
 	* - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes
 	* - SIGTERM: Termination signal (Unix primarily)
-	* - beforeExit: Fires when Node.js empties its event loop (more reliable on Windows)
+	* - SIGHUP: registered on Windows (`win32`) only, to catch Ctrl+C / console close
+	*
+	* Note: no `beforeExit` handler is registered — `beforeExit` cannot reliably
+	* await async teardown (the process exits once the callback returns), so
+	* shutdown is driven entirely by the signal handlers above.
 	*/
 	shutdownOnProcessKill() {
 		let isShuttingDown = false;

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

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.mjs","names":[],"sources":["../../../../../../../@warlock.js/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 { 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  }\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   * Handles graceful shutdown for both Unix and Windows:\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   * - beforeExit: Fires when Node.js empties its event loop (more reliable on Windows)\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;CACrC;;;;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;;;;;;;;;CAUA,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":["../../../../../../../@warlock.js/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"}

package/esm/connectors/database-connector.mjs

@@ -1,7 +1,7 @@
 import { container } from "../container/index.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import baseConfig from "@mongez/config";
+import config from "@mongez/config";
 import { connectToDatabase, dataSourceRegistry } from "@warlock.js/cascade";
 
 //#region ../@warlock.js/core/src/connectors/database-connector.ts
@@ -21,7 +21,7 @@ var DatabaseConnector = class extends BaseConnector {
 	* Initialize database connection
 	*/
 	async start() {
-		const databaseConfig = baseConfig.get("database");
+		const databaseConfig = config.get("database");
 		if (!databaseConfig) return;
 		try {
 			const source = await connectToDatabase(databaseConfig);

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

@@ -1 +1 @@
-{"version":3,"file":"database-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/database-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { connectToDatabase, dataSourceRegistry } from \"@warlock.js/cascade\";\r\nimport { container } from \"../container\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Database Connector\r\n * Manages database connection lifecycle using @warlock.js/cascade\r\n */\r\nexport class DatabaseConnector extends BaseConnector {\r\n  public readonly name = \"database\";\r\n  public readonly priority = ConnectorPriority.DATABASE;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger database restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/database.ts\", \"src/config/database.tsx\"];\r\n\r\n  /**\r\n   * Initialize database connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const databaseConfig = config.get(\"database\");\r\n\r\n    if (!databaseConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const source = await connectToDatabase(databaseConfig);\r\n      container.set(\"database.source\", source);\r\n      this.active = true;\r\n    } catch (error) {\r\n      console.error(\"Failed to connect to database:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown database connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      // Disconnect all registered data sources\r\n      const dataSources = dataSourceRegistry.getAllDataSources();\r\n\r\n      for (const dataSource of dataSources) {\r\n        if (dataSource.driver.isConnected) {\r\n          await dataSource.driver.disconnect();\r\n        }\r\n      }\r\n\r\n      this.active = false;\r\n    } catch (error) {\r\n      console.error(\"Failed to disconnect from database:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AAUA,IAAa,oBAAb,cAAuC,cAAc;;;cAC5B;;;sBAOW,CAAC,0BAA0B,yBAAyB;;;;;CAKtF,MAAa,QAAuB;EAClC,MAAM,iBAAiBA,WAAO,IAAI,UAAU;EAE5C,IAAI,CAAC,gBACH;EAGF,IAAI;GACF,MAAM,SAAS,MAAM,kBAAkB,cAAc;GACrD,UAAU,IAAI,mBAAmB,MAAM;GACvC,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,kCAAkC,KAAK;GACrD,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GAEF,MAAM,cAAc,mBAAmB,kBAAkB;GAEzD,KAAK,MAAM,cAAc,aACvB,IAAI,WAAW,OAAO,aACpB,MAAM,WAAW,OAAO,WAAW;GAIvC,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,uCAAuC,KAAK;GAC1D,MAAM;EACR;CACF;AACF"}
+{"version":3,"file":"database-connector.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/database-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { connectToDatabase, dataSourceRegistry } from \"@warlock.js/cascade\";\r\nimport { container } from \"../container\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Database Connector\r\n * Manages database connection lifecycle using @warlock.js/cascade\r\n */\r\nexport class DatabaseConnector extends BaseConnector {\r\n  public readonly name = \"database\";\r\n  public readonly priority = ConnectorPriority.DATABASE;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger database restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/database.ts\", \"src/config/database.tsx\"];\r\n\r\n  /**\r\n   * Initialize database connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const databaseConfig = config.get(\"database\");\r\n\r\n    if (!databaseConfig) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      const source = await connectToDatabase(databaseConfig);\r\n      container.set(\"database.source\", source);\r\n      this.active = true;\r\n    } catch (error) {\r\n      console.error(\"Failed to connect to database:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown database connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    try {\r\n      // Disconnect all registered data sources\r\n      const dataSources = dataSourceRegistry.getAllDataSources();\r\n\r\n      for (const dataSource of dataSources) {\r\n        if (dataSource.driver.isConnected) {\r\n          await dataSource.driver.disconnect();\r\n        }\r\n      }\r\n\r\n      this.active = false;\r\n    } catch (error) {\r\n      console.error(\"Failed to disconnect from database:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AAUA,IAAa,oBAAb,cAAuC,cAAc;;;cAC5B;;;sBAOW,CAAC,0BAA0B,yBAAyB;;;;;CAKtF,MAAa,QAAuB;EAClC,MAAM,iBAAiB,OAAO,IAAI,UAAU;EAE5C,IAAI,CAAC,gBACH;EAGF,IAAI;GACF,MAAM,SAAS,MAAM,kBAAkB,cAAc;GACrD,UAAU,IAAI,mBAAmB,MAAM;GACvC,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,kCAAkC,KAAK;GACrD,MAAM;EACR;CACF;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,IAAI;GAEF,MAAM,cAAc,mBAAmB,kBAAkB;GAEzD,KAAK,MAAM,cAAc,aACvB,IAAI,WAAW,OAAO,aACpB,MAAM,WAAW,OAAO,WAAW;GAIvC,KAAK,SAAS;EAChB,SAAS,OAAO;GACd,QAAQ,MAAM,uCAAuC,KAAK;GAC1D,MAAM;EACR;CACF;AACF"}

package/esm/connectors/herald-connector.mjs

@@ -1,6 +1,6 @@
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
-import baseConfig from "@mongez/config";
+import config from "@mongez/config";
 import { log } from "@warlock.js/logger";
 
 //#region ../@warlock.js/core/src/connectors/herald-connector.ts
@@ -20,7 +20,7 @@ var HeraldConnector = class extends BaseConnector {
 	* Initialize broker connection
 	*/
 	async start() {
-		const heraldConfig = baseConfig.get("herald");
+		const heraldConfig = config.get("herald");
 		if (!heraldConfig) return;
 		try {
 			const { connectToBroker } = await import("@warlock.js/herald");