@warlock.js/core 4.0.174 → 4.1.3

package/esm/config/config-special-handlers.mjs

@@ -0,0 +1,25 @@
+//#region ../../@warlock.js/core/src/config/config-special-handlers.ts
+var ConfigSpecialHandlers = class {
+	constructor() {
+		this.handlers = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Register a new handler
+	*/
+	register(configName, handler) {
+		this.handlers.set(configName, handler);
+	}
+	/**
+	* Execute handler for the given config name
+	*/
+	async execute(configName, config) {
+		const handler = this.handlers.get(configName);
+		if (!handler) return;
+		return handler(config);
+	}
+};
+const configSpecialHandlers = new ConfigSpecialHandlers();
+
+//#endregion
+export { ConfigSpecialHandlers, configSpecialHandlers };
+//# sourceMappingURL=config-special-handlers.mjs.map

package/esm/config/config-special-handlers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-special-handlers.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/config/config-special-handlers.ts"],"sourcesContent":["import { SpecialConfigHandler } from \"./config-loader\";\n\nexport class ConfigSpecialHandlers {\n  /**\n   * Handlers\n   */\n  protected handlers: Map<string, SpecialConfigHandler> = new Map();\n\n  /**\n   * Register a new handler\n   */\n  public register(configName: string, handler: SpecialConfigHandler) {\n    this.handlers.set(configName, handler);\n  }\n\n  /**\n   * Execute handler for the given config name\n   */\n  public async execute(configName: string, config: any) {\n    const handler = this.handlers.get(configName);\n    if (!handler) {\n      return; // do nothing\n    }\n\n    return handler(config);\n  }\n}\n\nexport const configSpecialHandlers = new ConfigSpecialHandlers();\n"],"mappings":";AAEA,IAAa,wBAAb,MAAmC;;kCAIuB,IAAI,IAAI;;;;;CAKhE,AAAO,SAAS,YAAoB,SAA+B;EACjE,KAAK,SAAS,IAAI,YAAY,OAAO;CACvC;;;;CAKA,MAAa,QAAQ,YAAoB,QAAa;EACpD,MAAM,UAAU,KAAK,SAAS,IAAI,UAAU;EAC5C,IAAI,CAAC,SACH;EAGF,OAAO,QAAQ,MAAM;CACvB;AACF;AAEA,MAAa,wBAAwB,IAAI,sBAAsB"}

package/esm/config/index.mjs

@@ -0,0 +1,5 @@
+import { config } from "./config-getter.mjs";
+import { ConfigSpecialHandlers, configSpecialHandlers } from "./config-special-handlers.mjs";
+import { registerAppConfig } from "./config-handlers.mjs";
+
+export {  };

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

@@ -0,0 +1,24 @@
+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";
+
+//#region ../../@warlock.js/core/src/config/load-config-files.ts
+/**
+* Load config files
+* either config file names (without extensions) or true to load all config files
+*/
+async function loadConfigFiles(config) {
+	let relativePaths = [];
+	if (config === true) relativePaths = (await getFilesFromDirectory(srcPath("config"))).map((path) => Path.toRelative(path));
+	else relativePaths = (await getCertainFilesFromDirectory(srcPath("config"), config)).map((path) => Path.toRelative(path));
+	const configFiles = await Promise.all(relativePaths.map((relativePath) => filesOrchestrator.add(relativePath)));
+	filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.files);
+	await configManager.loadAll(configFiles);
+}
+
+//#endregion
+export { loadConfigFiles };
+//# sourceMappingURL=load-config-files.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-config-files.mjs","names":[],"sources":["../../../../../../@warlock.js/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,GACrC,KAAK,SAAS,KAAK,WAAW,IAAI,CAAC;MAM5E,iBAAgB,MAFuB,6BAA6B,QAAQ,QAAQ,GAAG,MAAM,GAEpD,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/config/types.d.mts

@@ -0,0 +1,53 @@
+//#region ../../@warlock.js/core/src/config/types.d.ts
+/**
+ * Config registry interface.
+ *
+ * Extended via module augmentation by generated typings.
+ * Each key represents a config file name (e.g., "database", "app").
+ *
+ * @example Generated augmentation:
+ * ```typescript
+ * declare module "@warlock.js/core" {
+ *   interface ConfigRegistry {
+ *     app: true;
+ *     database: true;
+ *     storage: true;
+ *   }
+ * }
+ * ```
+ */
+interface ConfigRegistry {}
+/**
+ * Config name type.
+ *
+ * Extracts config names from the registry interface.
+ * Falls back to `string` if no configs are registered.
+ */
+type ConfigName = keyof ConfigRegistry extends never ? string : keyof ConfigRegistry;
+/**
+ * Config key registry interface.
+ *
+ * Extended via module augmentation by generated typings.
+ * Each key is a dot-notation path (e.g., "database.host").
+ *
+ * @example Generated augmentation:
+ * ```typescript
+ * declare module "@warlock.js/core" {
+ *   interface ConfigKeyRegistry {
+ *     "app.appName": true;
+ *     "database.host": true;
+ *   }
+ * }
+ * ```
+ */
+interface ConfigKeyRegistry {}
+/**
+ * Config key type.
+ *
+ * Extracts config key paths from the registry interface.
+ * Falls back to `string` if no keys are registered.
+ */
+type ConfigKey = keyof ConfigKeyRegistry extends never ? string : keyof ConfigKeyRegistry;
+//#endregion
+export { ConfigKey, ConfigKeyRegistry, ConfigName, ConfigRegistry };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/config/types.ts"],"mappings":";;AAiBA;;;;AAA+B;AAQ/B;;;;AAA2F;AAkB3F;;;;AAAkC;AAQlC;UAlCiB,cAAA;;AAkC+E;;;;;KA1BpF,UAAA,SAAmB,cAAA,gCAA8C,cAAc;;;;;;;;;;;;;;;;;UAkB1E,iBAAA;;;;;;;KAQL,SAAA,SAAkB,iBAAA,gCAAiD,iBAAiB"}

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

@@ -0,0 +1,63 @@
+import { Connector, ConnectorLifecyclePhase, ConnectorName } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/connectors/base-connector.d.ts
+/**
+ * Base Connector Class
+ * Provides common functionality for all connectors
+ */
+declare abstract class BaseConnector implements Connector {
+  /**
+   * Connector name
+   */
+  abstract readonly name: ConnectorName;
+  /**
+   * Initialization priority
+   */
+  abstract readonly priority: number;
+  /**
+   * Lifecycle phase. Defaults to `Early`; override to `Late` if the
+   * connector consumes state user code registers at import time
+   * (routes, socket listeners).
+   */
+  readonly lifecyclePhase: ConnectorLifecyclePhase;
+  /**
+   * Files that trigger restart when changed
+   * Use relative paths
+   */
+  protected abstract readonly watchedFiles: string[];
+  /**
+   * Whether the connector is currently active
+   */
+  protected active: boolean;
+  /**
+   * Check if connector is active
+   */
+  isActive(): boolean;
+  /**
+   * Boot the connector
+   */
+  boot(): Promise<void>;
+  /**
+   * Initialize the connector
+   */
+  abstract start(): Promise<void>;
+  /**
+   * Restart the connector
+   */
+  restart(): Promise<void>;
+  /**
+   * Shutdown the connector
+   */
+  abstract shutdown(): Promise<void>;
+  /**
+   * Determine if connector should restart based on changed files
+   */
+  shouldRestart(changedFiles: string[]): boolean;
+  /**
+   * Check if a file is watched by this connector
+   */
+  protected isWatchedFile(file: string): boolean;
+}
+//#endregion
+export { BaseConnector };
+//# sourceMappingURL=base-connector.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-connector.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/connectors/base-connector.ts"],"mappings":";;;;AAQA;;;uBAAsB,aAAA,YAAyB,SAAA;EAgBb;;;EAAA,kBAZP,IAAA,EAAM,aAAA;EAuDH;;;EAAA,kBAlDH,QAAA;EAToB;;;;;EAAA,SAgB7B,cAAA,EAAgB,uBAAA;EAMJ;;;;EAAA,4BAAA,YAAA;EAwBZ;;;EAAA,UAnBN,MAAA;EAgCM;;;EA3BT,QAAA,CAAA;EAwCG;;;EAjCG,IAAA,CAAA,GAAQ,OAAA;;;;WAOL,KAAA,CAAA,GAAS,OAAA;;;;EAKZ,OAAA,CAAA,GAAW,OAAA;;;;WAQR,QAAA,CAAA,GAAY,OAAA;;;;EAKrB,aAAA,CAAc,YAAA;;;;YAQX,aAAA,CAAc,IAAA;AAAA"}

package/esm/connectors/base-connector.mjs

@@ -0,0 +1,52 @@
+import { Path } from "../dev-server/path.mjs";
+import { ConnectorLifecyclePhase } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/connectors/base-connector.ts
+/**
+* Base Connector Class
+* Provides common functionality for all connectors
+*/
+var BaseConnector = class {
+	constructor() {
+		this.lifecyclePhase = "early";
+		this.active = false;
+	}
+	/**
+	* Check if connector is active
+	*/
+	isActive() {
+		return this.active;
+	}
+	/**
+	* Boot the connector
+	*/
+	async boot() {}
+	/**
+	* Restart the connector
+	*/
+	async restart() {
+		await this.shutdown();
+		await this.start();
+	}
+	/**
+	* Determine if connector should restart based on changed files
+	*/
+	shouldRestart(changedFiles) {
+		return changedFiles.some((file) => this.isWatchedFile(file));
+	}
+	/**
+	* Check if a file is watched by this connector
+	*/
+	isWatchedFile(file) {
+		const relativePath = Path.toRelative(file);
+		return this.watchedFiles.some((watchedFile) => {
+			if (watchedFile === relativePath) return true;
+			if (watchedFile.includes("*")) return new RegExp("^" + watchedFile.replace(/\*/g, ".*") + "$").test(relativePath);
+			return false;
+		});
+	}
+};
+
+//#endregion
+export { BaseConnector };
+//# sourceMappingURL=base-connector.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-connector.mjs","names":[],"sources":["../../../../../../@warlock.js/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,EAAE,KAAK,YAAY;GAGlC,OAAO;EACT,CAAC;CACH;AACF"}

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

@@ -0,0 +1,28 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+
+//#region ../../@warlock.js/core/src/connectors/cache-connector.d.ts
+/**
+ * Cache Connector
+ * Manages cache engine connection lifecycle
+ */
+declare class CacheConnector extends BaseConnector {
+  readonly name = "cache";
+  readonly priority = ConnectorPriority.CACHE;
+  readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
+  /**
+   * Files that trigger cache restart
+   */
+  protected readonly watchedFiles: string[];
+  /**
+   * Initialize cache connection
+   */
+  start(): Promise<void>;
+  /**
+   * Shutdown cache connection
+   */
+  shutdown(): Promise<void>;
+}
+//#endregion
+export { CacheConnector };
+//# sourceMappingURL=cache-connector.d.mts.map

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

@@ -0,0 +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,CAAA,GAAS,OAAA;EAXE;;;EA0BX,QAAA,CAAA,GAAY,OAAA;AAAA"}

package/esm/connectors/cache-connector.mjs

@@ -0,0 +1,40 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+import config from "@mongez/config";
+import { cache } from "@warlock.js/cache";
+
+//#region ../../@warlock.js/core/src/connectors/cache-connector.ts
+/**
+* Cache Connector
+* Manages cache engine connection lifecycle
+*/
+var CacheConnector = class extends BaseConnector {
+	constructor(..._args) {
+		super(..._args);
+		this.name = "cache";
+		this.priority = 4;
+		this.lifecyclePhase = "early";
+		this.watchedFiles = ["src/config/cache.ts", "src/config/cache.tsx"];
+	}
+	/**
+	* Initialize cache connection
+	*/
+	async start() {
+		const cacheConfig = config.get("cache");
+		if (!cacheConfig) return;
+		cache.setCacheConfigurations(cacheConfig);
+		await cache.init();
+		this.active = true;
+	}
+	/**
+	* Shutdown cache connection
+	*/
+	async shutdown() {
+		if (!this.active) return;
+		this.active = false;
+	}
+};
+
+//#endregion
+export { CacheConnector };
+//# sourceMappingURL=cache-connector.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-connector.mjs","names":[],"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,cAAc,OAAO,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"}

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

@@ -0,0 +1,56 @@
+import { Connector, ConnectorLifecyclePhase, ConnectorName } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/connectors/connectors-manager.d.ts
+declare class ConnectorsManager {
+  /**
+   * Connectors list
+   */
+  private readonly connectors;
+  /**
+   * Constructor
+   */
+  constructor();
+  /**
+   * Register a connector
+   */
+  register(...connectors: Connector[]): void;
+  /**
+   * Get all connectors
+   */
+  list(): Connector[];
+  /**
+   * start all connectors
+   */
+  start(connectorsNames?: ConnectorName[]): Promise<void>;
+  /**
+   * Start all connectors in the given lifecycle phase.
+   *
+   * The production builder and dev preload split startup around app
+   * code: early phase before app imports, late phase after. Within a
+   * phase, all connectors `boot()` first, then all `start()`, so
+   * cross-connector wiring inside the phase still works (e.g. socket
+   * reads http's instance during its own boot).
+   */
+  startPhase(phase: ConnectorLifecyclePhase): Promise<void>;
+  /**
+   * Start all connectors except the given ones
+   */
+  startWithout(excludedConnectors: ConnectorName[]): Promise<void>;
+  /**
+   * Shutdown all connectors
+   */
+  shutdown(): Promise<void>;
+  /**
+   * Shutdown connectors on process kill
+   *
+   * Handles graceful shutdown for both Unix and Windows:
+   * - 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)
+   */
+  shutdownOnProcessKill(): void;
+}
+declare const connectorsManager: ConnectorsManager;
+//#endregion
+export { ConnectorsManager, connectorsManager };
+//# sourceMappingURL=connectors-manager.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"mappings":";;;cAaa,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EA4BF;;;;EA8B0C;;;EAvClD,QAAA,CAAA,GAAY,UAAA,EAAY,SAAA;EAmEC;;;EA1DzB,IAAA,CAAA,GAAQ,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,CAAA,GAAY,OAAA;EA4Cd;;;;AAA2C;;;;EAzB/C,qBAAA,CAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}

package/esm/connectors/connectors-manager.mjs

@@ -0,0 +1,105 @@
+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";
+import { MailerConnector } from "./mail-connector.mjs";
+import { SocketConnector } from "./socket-connector.mjs";
+import { StorageConnector } from "./storage.connector.mjs";
+import { colors } from "@mongez/copper";
+
+//#region ../../@warlock.js/core/src/connectors/connectors-manager.ts
+var ConnectorsManager = class {
+	/**
+	* Constructor
+	*/
+	constructor() {
+		this.connectors = [];
+		this.register(new LoggerConnector());
+		this.register(new MailerConnector());
+		this.register(new HttpConnector());
+		this.register(new DatabaseConnector());
+		this.register(new HeraldConnector());
+		this.register(new CacheConnector());
+		this.register(new StorageConnector());
+		this.register(new SocketConnector());
+	}
+	/**
+	* Register a connector
+	*/
+	register(...connectors) {
+		this.connectors.push(...connectors);
+		this.connectors.sort((a, b) => a.priority - b.priority);
+	}
+	/**
+	* Get all connectors
+	*/
+	list() {
+		return this.connectors;
+	}
+	/**
+	* start all connectors
+	*/
+	async start(connectorsNames) {
+		const connectorsList = connectorsNames ? this.connectors.filter((connector) => connectorsNames.includes(connector.name)) : this.connectors;
+		for (const connector of connectorsList) await connector.boot();
+		for (const connector of connectorsList) await connector.start();
+	}
+	/**
+	* Start all connectors in the given lifecycle phase.
+	*
+	* The production builder and dev preload split startup around app
+	* code: early phase before app imports, late phase after. Within a
+	* phase, all connectors `boot()` first, then all `start()`, so
+	* cross-connector wiring inside the phase still works (e.g. socket
+	* reads http's instance during its own boot).
+	*/
+	async startPhase(phase) {
+		const phaseConnectors = this.connectors.filter((connector) => connector.lifecyclePhase === phase);
+		for (const connector of phaseConnectors) await connector.boot();
+		for (const connector of phaseConnectors) await connector.start();
+	}
+	/**
+	* Start all connectors except the given ones
+	*/
+	async startWithout(excludedConnectors) {
+		await this.start(this.connectors.filter((connector) => !excludedConnectors.includes(connector.name)).map((connector) => connector.name));
+	}
+	/**
+	* Shutdown all connectors
+	*/
+	async shutdown() {
+		for (const connector of this.connectors.reverse()) try {
+			await connector.shutdown();
+		} catch (error) {
+			devServeLog(colors.redBright(`❌ Failed to shutdown ${connector.name}: ${error}`));
+		}
+	}
+	/**
+	* Shutdown connectors on process kill
+	*
+	* Handles graceful shutdown for both Unix and Windows:
+	* - 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)
+	*/
+	shutdownOnProcessKill() {
+		let isShuttingDown = false;
+		const gracefulShutdown = async (signal) => {
+			if (isShuttingDown) return;
+			isShuttingDown = true;
+			console.log(`\nExiting...`);
+			await this.shutdown();
+			process.exit(0);
+		};
+		process.on("SIGINT", () => gracefulShutdown("SIGINT"));
+		process.on("SIGTERM", () => gracefulShutdown("SIGTERM"));
+		if (process.platform === "win32") process.on("SIGHUP", () => gracefulShutdown("SIGHUP"));
+	}
+};
+const connectorsManager = new ConnectorsManager();
+
+//#endregion
+export { ConnectorsManager, connectorsManager };
+//# sourceMappingURL=connectors-manager.mjs.map

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

@@ -0,0 +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 { devServeLog } from \"../dev-server/dev-logger\";\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 { 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  }\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    // shut down connectors in reverse order\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":";;;;;;;;;;;;AAaA,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;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,EAClE,KAAK,cAAc,UAAU,IAAI,CACtC;CACF;;;;CAKA,MAAa,WAA0B;EAErC,KAAK,MAAM,aAAa,KAAK,WAAW,QAAQ,GAC9C,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"}

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

@@ -0,0 +1,28 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+
+//#region ../../@warlock.js/core/src/connectors/database-connector.d.ts
+/**
+ * Database Connector
+ * Manages database connection lifecycle using @warlock.js/cascade
+ */
+declare class DatabaseConnector extends BaseConnector {
+  readonly name = "database";
+  readonly priority = ConnectorPriority.DATABASE;
+  readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
+  /**
+   * Files that trigger database restart
+   */
+  protected readonly watchedFiles: string[];
+  /**
+   * Initialize database connection
+   */
+  start(): Promise<void>;
+  /**
+   * Shutdown database connection
+   */
+  shutdown(): Promise<void>;
+}
+//#endregion
+export { DatabaseConnector };
+//# sourceMappingURL=database-connector.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-connector.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/connectors/database-connector.ts"],"mappings":";;;;;;AAUA;;cAAa,iBAAA,SAA0B,aAAA;EAAA,SACrB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,QAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EA8BL;;;EAAA,mBAzBN,YAAA;EARkB;;;EAaxB,KAAA,CAAA,GAAS,OAAA;EAXE;;;EA+BX,QAAA,CAAA,GAAY,OAAA;AAAA"}

package/esm/connectors/database-connector.mjs

@@ -0,0 +1,53 @@
+import { container } from "../container/index.mjs";
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+import config from "@mongez/config";
+import { connectToDatabase, dataSourceRegistry } from "@warlock.js/cascade";
+
+//#region ../../@warlock.js/core/src/connectors/database-connector.ts
+/**
+* Database Connector
+* Manages database connection lifecycle using @warlock.js/cascade
+*/
+var DatabaseConnector = class extends BaseConnector {
+	constructor(..._args) {
+		super(..._args);
+		this.name = "database";
+		this.priority = 2;
+		this.lifecyclePhase = "early";
+		this.watchedFiles = ["src/config/database.ts", "src/config/database.tsx"];
+	}
+	/**
+	* Initialize database connection
+	*/
+	async start() {
+		const databaseConfig = config.get("database");
+		if (!databaseConfig) return;
+		try {
+			const source = await connectToDatabase(databaseConfig);
+			container.set("database.source", source);
+			this.active = true;
+		} catch (error) {
+			console.error("Failed to connect to database:", error);
+			throw error;
+		}
+	}
+	/**
+	* Shutdown database connection
+	*/
+	async shutdown() {
+		if (!this.active) return;
+		try {
+			const dataSources = dataSourceRegistry.getAllDataSources();
+			for (const dataSource of dataSources) if (dataSource.driver.isConnected) await dataSource.driver.disconnect();
+			this.active = false;
+		} catch (error) {
+			console.error("Failed to disconnect from database:", error);
+			throw error;
+		}
+	}
+};
+
+//#endregion
+export { DatabaseConnector };
+//# sourceMappingURL=database-connector.mjs.map

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

@@ -0,0 +1 @@
+{"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.d.mts

@@ -0,0 +1,28 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+
+//#region ../../@warlock.js/core/src/connectors/herald-connector.d.ts
+/**
+ * Herald Connector
+ * Manages message broker connection lifecycle using @warlock.js/herald
+ */
+declare class HeraldConnector extends BaseConnector {
+  readonly name = "herald";
+  readonly priority = ConnectorPriority.COMMUNICATOR;
+  readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
+  /**
+   * Files that trigger herald restart
+   */
+  protected readonly watchedFiles: string[];
+  /**
+   * Initialize broker connection
+   */
+  start(): Promise<void>;
+  /**
+   * Shutdown broker connection
+   */
+  shutdown(): Promise<void>;
+}
+//#endregion
+export { HeraldConnector };
+//# sourceMappingURL=herald-connector.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"herald-connector.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/connectors/herald-connector.ts"],"mappings":";;;;;;AASA;;cAAa,eAAA,SAAwB,aAAA;EAAA,SACnB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,YAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAqCL;;;EAAA,mBAhCN,YAAA;EARgB;;;EAatB,KAAA,CAAA,GAAS,OAAA;EAXE;;;EAsCX,QAAA,CAAA,GAAY,OAAA;AAAA"}