@warlock.js/core 4.0.161 → 4.0.163

package/esm/config/config-handlers.js

@@ -0,0 +1,19 @@
+import {configSpecialHandlers}from'./config-special-handlers.js';/**
+ * App Config Handler
+ * Handles locale loading for dayjs
+ */
+const registerAppConfig = async (config) => {
+    // Load dayjs locales based on app.localeCodes
+    const locales = config.locales || ["en"];
+    for (const locale of locales) {
+        if (locale === "en")
+            continue; // English is default
+        try {
+            await import(`dayjs/locale/${locale}.js`);
+        }
+        catch (error) {
+            console.warn(`   ⚠️  Failed to load dayjs locale: ${locale}`);
+        }
+    }
+};
+configSpecialHandlers.register("app", registerAppConfig);export{registerAppConfig};//# sourceMappingURL=config-handlers.js.map

package/esm/config/config-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-handlers.js","sources":["../../src/config/config-handlers.ts"],"sourcesContent":[null],"names":[],"mappings":"iEAGA;;;AAGG;MACU,iBAAiB,GAAG,OAAO,MAAyB,KAAI;;IAEnE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AAEzC,IAAA,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE;QAC5B,IAAI,MAAM,KAAK,IAAI;AAAE,YAAA,SAAS;QAE9B,IAAI;AACF,YAAA,MAAM,OAAO,CAAA,aAAA,EAAgB,MAAM,CAAA,GAAA,CAAK,CAAC,CAAC;AAC3C,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,IAAI,CAAC,uCAAuC,MAAM,CAAA,CAAE,CAAC,CAAC;AAC/D,SAAA;AACF,KAAA;AACH,EAAE;AAEF,qBAAqB,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC"}

package/esm/config/config-loader.d.ts

@@ -0,0 +1,37 @@
+import type { FileManager } from "../dev-server/file-manager";
+/**
+ * Special Config Handler
+ * A function that handles special configuration loading
+ */
+export type SpecialConfigHandler = (configValue: any) => void | Promise<void>;
+/**
+ * Config Loader
+ * Dynamically loads all configuration files and registers them with @mongez/config
+ * Supports special handlers for configs that require additional processing
+ */
+export declare class ConfigLoader {
+    /**
+     * Load all configuration files
+     * @param configFiles Array of config FileManager instances
+     */
+    loadAll(configFiles: FileManager[]): Promise<void>;
+    /**
+     * Load a single configuration file
+     * @param file FileManager instance for the config file
+     * @param bustCache Whether to bust the cache (add timestamp to URL)
+     */
+    loadConfig(file: FileManager, bustCache?: boolean): Promise<void>;
+    /**
+     * Reload a configuration file (for HMR)
+     * @param file FileManager instance for the config file
+     */
+    reloadConfig(file: FileManager): Promise<void>;
+    /**
+     * Extract config name from file path
+     * Examples:
+     *   src/config/database.ts → "database"
+     *   src/config/payment/stripe.ts → "payment.stripe"
+     */
+    private getConfigName;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/esm/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,WAAW,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E;;;;GAIG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACU,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/D;;;;OAIG;IACU,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CrF;;;OAGG;IACU,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAUtB"}

package/esm/config/config-loader.js

@@ -0,0 +1,85 @@
+import config from'@mongez/config';import {colors}from'@mongez/copper';import {pathToFileURL}from'node:url';import {warlockCachePath}from'../dev-server/utils.js';import {configSpecialHandlers}from'./config-special-handlers.js';/**
+ * Config Loader
+ * Dynamically loads all configuration files and registers them with @mongez/config
+ * Supports special handlers for configs that require additional processing
+ */
+class ConfigLoader {
+    /**
+     * Load all configuration files
+     * @param configFiles Array of config FileManager instances
+     */
+    async loadAll(configFiles) {
+        if (configFiles.length === 0) {
+            return;
+        }
+        // Load all configs in parallel
+        // await Promise.all(
+        //   configFiles.map(async file => {
+        //     await this.loadConfig(file);
+        //   }),
+        // );
+        for (const file of configFiles) {
+            await this.loadConfig(file);
+        }
+    }
+    /**
+     * Load a single configuration file
+     * @param file FileManager instance for the config file
+     * @param bustCache Whether to bust the cache (add timestamp to URL)
+     */
+    async loadConfig(file, bustCache = false) {
+        const configName = this.getConfigName(file.relativePath);
+        // devLogInfo(`Loading configuration file: ${configName}`);
+        try {
+            // Convert absolute path to file:// URL for cross-platform compatibility
+            let fileUrl = typeof __import !== "undefined"
+                ? file.cachePath
+                : pathToFileURL(warlockCachePath(file.cachePath)).href;
+            // Add timestamp for cache busting (forces re-import for HMR)
+            if (bustCache && typeof __import === "undefined") {
+                const timestamp = Date.now();
+                fileUrl += `?t=${timestamp}`;
+            }
+            // Dynamic import the config file
+            const configModule = typeof __import !== "undefined" ? await __import(fileUrl) : await import(fileUrl);
+            // Get the default export (the config value)
+            const configValue = configModule.default;
+            if (configValue === undefined) {
+                console.log(colors.red(`config error: `), `Config file ${colors.yellow(file.relativePath)} does not have a default export`);
+                return;
+            }
+            // Store in @mongez/config
+            // @mongez/config automatically handles nested access (e.g., config.get("database.host"))
+            config.set(configName, configValue);
+            // devLogInfo(`Configuration file loaded: ${file.relativePath}`);
+            // Handle special configs if handler is registered
+            await configSpecialHandlers.execute(configName, configValue);
+            // devLogInfo(`Special configuration handled: ${configName}`);
+        }
+        catch (error) {
+            throw error; // Abort on config errors
+        }
+    }
+    /**
+     * Reload a configuration file (for HMR)
+     * @param file FileManager instance for the config file
+     */
+    async reloadConfig(file) {
+        // Reload the config with cache busting (adds timestamp to URL)
+        await this.loadConfig(file, true);
+    }
+    /**
+     * Extract config name from file path
+     * Examples:
+     *   src/config/database.ts → "database"
+     *   src/config/payment/stripe.ts → "payment.stripe"
+     */
+    getConfigName(relativePath) {
+        // Extract the part after "src/config/"
+        const match = relativePath.match(/^src\/config\/(.+)\.(ts|tsx)$/);
+        if (!match) {
+            throw new Error(`Invalid config file path: ${relativePath}`);
+        }
+        return match[1];
+    }
+}export{ConfigLoader};//# sourceMappingURL=config-loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sources":["../../src/config/config-loader.ts"],"sourcesContent":[null],"names":[],"mappings":"mOAaA;;;;AAIG;MACU,YAAY,CAAA;AACvB;;;AAGG;IACI,MAAM,OAAO,CAAC,WAA0B,EAAA;AAC7C,QAAA,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;YAC5B,OAAO;AACR,SAAA;;;;;;;AAQD,QAAA,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE;AAC9B,YAAA,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC7B,SAAA;KACF;AAED;;;;AAIG;AACI,IAAA,MAAM,UAAU,CAAC,IAAiB,EAAE,YAAqB,KAAK,EAAA;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;;QAGzD,IAAI;;AAEF,YAAA,IAAI,OAAO,GACT,OAAO,QAAQ,KAAK,WAAW;kBAC3B,IAAI,CAAC,SAAS;AAChB,kBAAE,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;;AAG3D,YAAA,IAAI,SAAS,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE;AAChD,gBAAA,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC7B,gBAAA,OAAO,IAAI,CAAA,GAAA,EAAM,SAAS,CAAA,CAAE,CAAC;AAC9B,aAAA;;YAID,MAAM,YAAY,GAChB,OAAO,QAAQ,KAAK,WAAW,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,MAAM,OAAO,OAAO,CAAC,CAAC;;AAGpF,YAAA,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC;YAEzC,IAAI,WAAW,KAAK,SAAS,EAAE;gBAC7B,OAAO,CAAC,GAAG,CACT,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAC5B,eAAe,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAiC,+BAAA,CAAA,CACjF,CAAC;gBACF,OAAO;AACR,aAAA;;;AAID,YAAA,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;;;YAKpC,MAAM,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;;AAE9D,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;YACd,MAAM,KAAK,CAAC;AACb,SAAA;KACF;AAED;;;AAGG;IACI,MAAM,YAAY,CAAC,IAAiB,EAAA;;QAEzC,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;KACnC;AAED;;;;;AAKG;AACK,IAAA,aAAa,CAAC,YAAoB,EAAA;;QAExC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAElE,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,CAAA,CAAE,CAAC,CAAC;AAC9D,SAAA;AAED,QAAA,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;AACF"}

package/esm/config/config-manager.d.ts

@@ -0,0 +1,22 @@
+import { FileManager } from "../dev-server/file-manager";
+import { ConfigLoader } from "./config-loader";
+export declare class ConfigManager {
+    /**
+     * Config loader instance
+     */
+    loader: ConfigLoader;
+    /**
+     * Constructor
+     */
+    constructor();
+    /**
+     * Load all config files
+     */
+    loadAll(files: FileManager[]): Promise<void>;
+    /**
+     * Reload a config file
+     */
+    reload(file: FileManager): Promise<void>;
+}
+export declare const configManager: ConfigManager;
+//# sourceMappingURL=config-manager.d.ts.map

package/esm/config/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/config/config-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,qBAAa,aAAa;IACxB;;OAEG;IACI,MAAM,eAAsB;IAEnC;;OAEG;;IAKH;;OAEG;IACU,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE;IAIzC;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,WAAW;CAGtC;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/esm/config/config-manager.js

@@ -0,0 +1,25 @@
+import {ConfigLoader}from'./config-loader.js';class ConfigManager {
+    /**
+     * Config loader instance
+     */
+    loader = new ConfigLoader();
+    /**
+     * Constructor
+     */
+    constructor() {
+        //
+    }
+    /**
+     * Load all config files
+     */
+    async loadAll(files) {
+        return this.loader.loadAll(files);
+    }
+    /**
+     * Reload a config file
+     */
+    async reload(file) {
+        return this.loader.reloadConfig(file);
+    }
+}
+const configManager = new ConfigManager();export{ConfigManager,configManager};//# sourceMappingURL=config-manager.js.map

package/esm/config/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.js","sources":["../../src/config/config-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"oDAGa,aAAa,CAAA;AACxB;;AAEG;AACI,IAAA,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;AAEnC;;AAEG;AACH,IAAA,WAAA,GAAA;;KAEC;AAED;;AAEG;IACI,MAAM,OAAO,CAAC,KAAoB,EAAA;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;KACnC;AAED;;AAEG;IACI,MAAM,MAAM,CAAC,IAAiB,EAAA;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;KACvC;AACF,CAAA;AAEY,MAAA,aAAa,GAAG,IAAI,aAAa"}

package/esm/config/config-special-handlers.d.ts

@@ -0,0 +1,17 @@
+import { SpecialConfigHandler } from "./config-loader";
+export declare class ConfigSpecialHandlers {
+    /**
+     * Handlers
+     */
+    protected handlers: Map<string, SpecialConfigHandler>;
+    /**
+     * Register a new handler
+     */
+    register(configName: string, handler: SpecialConfigHandler): void;
+    /**
+     * Execute handler for the given config name
+     */
+    execute(configName: string, config: any): Promise<void>;
+}
+export declare const configSpecialHandlers: ConfigSpecialHandlers;
+//# sourceMappingURL=config-special-handlers.d.ts.map

package/esm/config/config-special-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-special-handlers.d.ts","sourceRoot":"","sources":["../../src/config/config-special-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,qBAAa,qBAAqB;IAChC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAa;IAElE;;OAEG;IACI,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB;IAIjE;;OAEG;IACU,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;CAQrD;AAED,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

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

@@ -0,0 +1,23 @@
+class ConfigSpecialHandlers {
+    /**
+     * Handlers
+     */
+    handlers = 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; // do nothing
+        }
+        return handler(config);
+    }
+}
+const configSpecialHandlers = new ConfigSpecialHandlers();export{ConfigSpecialHandlers,configSpecialHandlers};//# sourceMappingURL=config-special-handlers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-special-handlers.js","sources":["../../src/config/config-special-handlers.ts"],"sourcesContent":[null],"names":[],"mappings":"MAEa,qBAAqB,CAAA;AAChC;;AAEG;AACO,IAAA,QAAQ,GAAsC,IAAI,GAAG,EAAE,CAAC;AAElE;;AAEG;IACI,QAAQ,CAAC,UAAkB,EAAE,OAA6B,EAAA;QAC/D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;KACxC;AAED;;AAEG;AACI,IAAA,MAAM,OAAO,CAAC,UAAkB,EAAE,MAAW,EAAA;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,OAAO;AACR,SAAA;AAED,QAAA,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC;KACxB;AACF,CAAA;AAEY,MAAA,qBAAqB,GAAG,IAAI,qBAAqB"}

package/esm/config/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./config-getter";
+export * from "./config-handlers";
+export * from "./config-special-handlers";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/esm/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC"}

package/esm/config/load-config-files.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Load config files
+ * either config file names (without extensions) or true to load all config files
+ */
+export declare function loadConfigFiles(config: string[] | true): Promise<void>;
+//# sourceMappingURL=load-config-files.d.ts.map

package/esm/config/load-config-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config-files.d.ts","sourceRoot":"","sources":["../../src/config/load-config-files.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,iBAoB5D"}

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

@@ -0,0 +1,19 @@
+import {filesOrchestrator}from'../dev-server/files-orchestrator.js';import {Path}from'../dev-server/path.js';import {getFilesFromDirectory,getCertainFilesFromDirectory}from'../dev-server/utils.js';import'@warlock.js/logger';import'../database/models/database-log/database-log.js';import'../http/context/request-context.js';import {srcPath}from'../utils/paths.js';import'@mongez/slug';import'@mongez/supportive-is';import'@mongez/reinforcements';import {configManager}from'./config-manager.js';/**
+ * 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) {
+        const configFilesAbsulatePaths = await getFilesFromDirectory(srcPath("config"));
+        relativePaths = configFilesAbsulatePaths.map((path) => Path.toRelative(path));
+    }
+    else {
+        // define only the given config files
+        const configFilesAbsulatePaths = await getCertainFilesFromDirectory(srcPath("config"), config);
+        relativePaths = configFilesAbsulatePaths.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);
+}export{loadConfigFiles};//# sourceMappingURL=load-config-files.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-config-files.js","sources":["../../src/config/load-config-files.ts"],"sourcesContent":[null],"names":[],"mappings":"6eAMA;;;AAGG;AACI,eAAe,eAAe,CAAC,MAAuB,EAAA;IAC3D,IAAI,aAAa,GAAa,EAAE,CAAC;IACjC,IAAI,MAAM,KAAK,IAAI,EAAE;QACnB,MAAM,wBAAwB,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAChF,QAAA,aAAa,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,KAAA;AAAM,SAAA;;AAGL,QAAA,MAAM,wBAAwB,GAAG,MAAM,4BAA4B,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AAE/F,QAAA,aAAa,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,KAAA;IAED,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CACnC,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,KAAK,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CACzE,CAAC;IAEF,iBAAiB,CAAC,qBAAqB,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAEzE,IAAA,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAC3C"}

package/esm/config/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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;
+ *   }
+ * }
+ * ```
+ */
+export interface ConfigRegistry {
+}
+/**
+ * Config name type.
+ *
+ * Extracts config names from the registry interface.
+ * Falls back to `string` if no configs are registered.
+ */
+export 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;
+ *   }
+ * }
+ * ```
+ */
+export interface ConfigKeyRegistry {
+}
+/**
+ * Config key type.
+ *
+ * Extracts config key paths from the registry interface.
+ * Falls back to `string` if no keys are registered.
+ */
+export type ConfigKey = keyof ConfigKeyRegistry extends never ? string : keyof ConfigKeyRegistry;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,cAAc;CAAG;AAElC;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,cAAc,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,cAAc,CAAC;AAE5F;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;CAAG;AAErC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,iBAAiB,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,49 @@
+import type { Connector, ConnectorName } from "./types";
+/**
+ * Base Connector Class
+ * Provides common functionality for all connectors
+ */
+export declare abstract class BaseConnector implements Connector {
+    /**
+     * Connector name
+     */
+    abstract readonly name: ConnectorName;
+    /**
+     * Initialization priority
+     */
+    abstract readonly priority: number;
+    /**
+     * 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;
+    /**
+     * 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;
+}
+//# sourceMappingURL=base-connector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-connector.d.ts","sourceRoot":"","sources":["../../src/connectors/base-connector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;;GAGG;AACH,8BAAsB,aAAc,YAAW,SAAS;IACtD;;OAEG;IACH,kBAAyB,IAAI,EAAE,aAAa,CAAC;IAE7C;;OAEG;IACH,kBAAyB,QAAQ,EAAE,MAAM,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEnD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAS;IAElC;;OAEG;IACI,QAAQ,IAAI,OAAO;IAI1B;;OAEG;aACa,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC;;OAEG;aACa,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAEzC;;OAEG;IACI,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO;IAKrD;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAkB/C"}

package/esm/connectors/base-connector.js

@@ -0,0 +1,48 @@
+import {Path}from'../dev-server/path.js';/**
+ * Base Connector Class
+ * Provides common functionality for all connectors
+ */
+class BaseConnector {
+    /**
+     * Whether the connector is currently active
+     */
+    active = false;
+    /**
+     * Check if connector is active
+     */
+    isActive() {
+        return this.active;
+    }
+    /**
+     * Restart the connector
+     */
+    async restart() {
+        await this.shutdown();
+        await this.start();
+    }
+    /**
+     * Determine if connector should restart based on changed files
+     */
+    shouldRestart(changedFiles) {
+        // Check if any changed file matches watched files
+        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) => {
+            // Exact match
+            if (watchedFile === relativePath) {
+                return true;
+            }
+            // Pattern match (e.g., "config/*.ts")
+            if (watchedFile.includes("*")) {
+                const pattern = new RegExp("^" + watchedFile.replace(/\*/g, ".*") + "$");
+                return pattern.test(relativePath);
+            }
+            return false;
+        });
+    }
+}export{BaseConnector};//# sourceMappingURL=base-connector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-connector.js","sources":["../../src/connectors/base-connector.ts"],"sourcesContent":[null],"names":[],"mappings":"yCAGA;;;AAGG;MACmB,aAAa,CAAA;AAiBjC;;AAEG;IACO,MAAM,GAAY,KAAK,CAAC;AAElC;;AAEG;IACI,QAAQ,GAAA;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;KACpB;AAOD;;AAEG;AACI,IAAA,MAAM,OAAO,GAAA;AAClB,QAAA,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;AACtB,QAAA,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;KACpB;AAOD;;AAEG;AACI,IAAA,aAAa,CAAC,YAAsB,EAAA;;AAEzC,QAAA,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;KAC9D;AAED;;AAEG;AACO,IAAA,aAAa,CAAC,IAAY,EAAA;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAE3C,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,KAAI;;YAE5C,IAAI,WAAW,KAAK,YAAY,EAAE;AAChC,gBAAA,OAAO,IAAI,CAAC;AACb,aAAA;;AAGD,YAAA,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;AAC7B,gBAAA,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;AACzE,gBAAA,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACnC,aAAA;AAED,YAAA,OAAO,KAAK,CAAC;AACf,SAAC,CAAC,CAAC;KACJ;AACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-connector.d.ts","sourceRoot":"","sources":["../../src/connectors/cache-connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAgB,IAAI,WAAW;IAC/B,SAAgB,QAAQ,2BAA2B;IAEnD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,WAAmD;IAElF;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAWvC"}

package/esm/connectors/cache-connector.js

@@ -0,0 +1,35 @@
+import config from'@mongez/config';import {cache}from'@warlock.js/cache';import {BaseConnector}from'./base-connector.js';import {ConnectorPriority}from'./types.js';/**
+ * Cache Connector
+ * Manages cache engine connection lifecycle
+ */
+class CacheConnector extends BaseConnector {
+    name = "cache";
+    priority = ConnectorPriority.CACHE;
+    /**
+     * Files that trigger cache restart
+     */
+    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;
+        }
+        // TODO: Implement actual cache disconnection
+        // - Close all active connections
+        // - Clean up resources
+        this.active = false;
+    }
+}export{CacheConnector};//# sourceMappingURL=cache-connector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-connector.js","sources":["../../src/connectors/cache-connector.ts"],"sourcesContent":[null],"names":[],"mappings":"oKAKA;;;AAGG;AACG,MAAO,cAAe,SAAQ,aAAa,CAAA;IAC/B,IAAI,GAAG,OAAO,CAAC;AACf,IAAA,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAEnD;;AAEG;AACgB,IAAA,YAAY,GAAG,CAAC,qBAAqB,EAAE,sBAAsB,CAAC,CAAC;AAElF;;AAEG;AACI,IAAA,MAAM,KAAK,GAAA;QAChB,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExC,QAAA,IAAI,CAAC,WAAW;YAAE,OAAO;AAEzB,QAAA,KAAK,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;AAE1C,QAAA,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;AAEnB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;KACpB;AAED;;AAEG;AACI,IAAA,MAAM,QAAQ,GAAA;AACnB,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAChB,OAAO;AACR,SAAA;;;;AAMD,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;KACrB;AACF"}

package/esm/connectors/communicator-connector.d.ts

@@ -0,0 +1,23 @@
+import { BaseConnector } from "./base-connector";
+import { ConnectorPriority } from "./types";
+/**
+ * Communicator Connector
+ * Manages message broker connection lifecycle using @warlock.js/herald
+ */
+export declare class CommunicatorConnector extends BaseConnector {
+    readonly name = "communicator";
+    readonly priority = ConnectorPriority.COMMUNICATOR;
+    /**
+     * Files that trigger communicator restart
+     */
+    protected readonly watchedFiles: string[];
+    /**
+     * Initialize communicator connection
+     */
+    start(): Promise<void>;
+    /**
+     * Shutdown communicator connection
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=communicator-connector.d.ts.map

package/esm/connectors/communicator-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communicator-connector.d.ts","sourceRoot":"","sources":["../../src/connectors/communicator-connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,SAAgB,IAAI,kBAAkB;IACtC,SAAgB,QAAQ,kCAAkC;IAE1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,WAI7B;IAEF;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCnC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA0BvC"}

package/esm/connectors/communicator-connector.js

@@ -0,0 +1,62 @@
+import config from'@mongez/config';import {log}from'@warlock.js/logger';import {BaseConnector}from'./base-connector.js';import {ConnectorPriority}from'./types.js';/**
+ * Communicator Connector
+ * Manages message broker connection lifecycle using @warlock.js/herald
+ */
+class CommunicatorConnector extends BaseConnector {
+    name = "communicator";
+    priority = ConnectorPriority.COMMUNICATOR;
+    /**
+     * Files that trigger communicator restart
+     */
+    watchedFiles = [
+        ".env",
+        "src/config/communicator.ts",
+        "src/config/communicator.tsx",
+    ];
+    /**
+     * Initialize communicator connection
+     */
+    async start() {
+        const communicatorConfig = config.get("communicator");
+        if (!communicatorConfig) {
+            return;
+        }
+        try {
+            const { connectToCommunicator } = await import('@warlock.js/herald');
+            log.info(`communicator.${communicatorConfig.driver}`, "connection", "Connecting to communicator");
+            await connectToCommunicator(communicatorConfig);
+            log.success(`communicator.${communicatorConfig.driver}`, "connection", "Connected to communicator");
+            this.active = true;
+        }
+        catch (error) {
+            console.error("Failed to connect to communicator:", error);
+            log.error(`communicator.${communicatorConfig.driver}`, "connection", "Failed to connect to communicator");
+            throw error;
+        }
+    }
+    /**
+     * Shutdown communicator connection
+     */
+    async shutdown() {
+        if (!this.active) {
+            return;
+        }
+        try {
+            const { communicatorRegistry } = await import('@warlock.js/herald');
+            // Disconnect all registered communicators
+            const communicators = communicatorRegistry.getAll();
+            for (const communicator of communicators) {
+                if (communicator.driver.isConnected) {
+                    await communicator.driver.disconnect();
+                }
+            }
+            // Clear the registry for clean restart
+            communicatorRegistry.clear();
+            this.active = false;
+        }
+        catch (error) {
+            console.error("Failed to disconnect from communicator:", error);
+            throw error;
+        }
+    }
+}export{CommunicatorConnector};//# sourceMappingURL=communicator-connector.js.map

package/esm/connectors/communicator-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communicator-connector.js","sources":["../../src/connectors/communicator-connector.ts"],"sourcesContent":[null],"names":[],"mappings":"mKAKA;;;AAGG;AACG,MAAO,qBAAsB,SAAQ,aAAa,CAAA;IACtC,IAAI,GAAG,cAAc,CAAC;AACtB,IAAA,QAAQ,GAAG,iBAAiB,CAAC,YAAY,CAAC;AAE1D;;AAEG;AACgB,IAAA,YAAY,GAAG;QAChC,MAAM;QACN,4BAA4B;QAC5B,6BAA6B;KAC9B,CAAC;AAEF;;AAEG;AACI,IAAA,MAAM,KAAK,GAAA;QAChB,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAEtD,IAAI,CAAC,kBAAkB,EAAE;YACvB,OAAO;AACR,SAAA;QAED,IAAI;YACF,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAErE,YAAA,GAAG,CAAC,IAAI,CACN,CAAA,aAAA,EAAgB,kBAAkB,CAAC,MAAM,CAAA,CAAE,EAC3C,YAAY,EACZ,4BAA4B,CAC7B,CAAC;AACF,YAAA,MAAM,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;AAChD,YAAA,GAAG,CAAC,OAAO,CACT,CAAA,aAAA,EAAgB,kBAAkB,CAAC,MAAM,CAAA,CAAE,EAC3C,YAAY,EACZ,2BAA2B,CAC5B,CAAC;AACF,YAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;AACpB,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;AAC3D,YAAA,GAAG,CAAC,KAAK,CACP,CAAA,aAAA,EAAgB,kBAAkB,CAAC,MAAM,CAAA,CAAE,EAC3C,YAAY,EACZ,mCAAmC,CACpC,CAAC;AACF,YAAA,MAAM,KAAK,CAAC;AACb,SAAA;KACF;AAED;;AAEG;AACI,IAAA,MAAM,QAAQ,GAAA;AACnB,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAChB,OAAO;AACR,SAAA;QAED,IAAI;YACF,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,OAAO,oBAAoB,CAAC,CAAC;;AAGpE,YAAA,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,EAAE,CAAC;AAEpD,YAAA,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;AACxC,gBAAA,IAAI,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE;AACnC,oBAAA,MAAM,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;AACxC,iBAAA;AACF,aAAA;;YAGD,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAE7B,YAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;AACrB,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;AAChE,YAAA,MAAM,KAAK,CAAC;AACb,SAAA;KACF;AACF"}