@warlock.js/core 4.0.6 → 4.0.15

package/esm/cli/types.d.ts

@@ -0,0 +1,201 @@
+/**
+ * @fileoverview CLI2 Type Definitions
+ * @description Core type definitions for the Warlock.js CLI v2 system.
+ * These types define the structure for commands, options, preloading, and actions.
+ */
+/**
+ * Indicates the origin/source of a CLI command.
+ *
+ * - `"framework"` - Built-in commands provided by Warlock.js (e.g., `dev`, `help`)
+ * - `"plugin"` - Commands from installed Warlock.js plugins
+ * - `"project"` - Custom commands defined in the project's source code
+ */
+export type CLICommandSource = "framework" | "plugin" | "project";
+/**
+ * Data passed to command action and preAction functions.
+ *
+ * @example
+ * // For command: warlock migrate users --fresh --limit=10
+ * {
+ *   args: ["users"],
+ *   options: { fresh: true, limit: "10" }
+ * }
+ */
+export type CommandActionData = {
+    /**
+     * Positional arguments passed after the command name.
+     * @example `warlock migrate users posts` → args: ["users", "posts"]
+     */
+    args: string[];
+    /**
+     * Named options/flags parsed from CLI arguments.
+     * Kebab-case options are converted to camelCase.
+     * @example `--no-cache --port=3000` → { noCache: true, port: "3000" }
+     */
+    options: Record<string, string | boolean | number>;
+};
+/**
+ * Configuration for lazy-loading resources before command execution.
+ * Only specified resources are loaded, optimizing startup time.
+ *
+ * @example
+ * // Load only database config and connector
+ * preload: {
+ *   config: ["database"],
+ *   connectors: ["database"]
+ * }
+ *
+ * @example
+ * // Load everything (full bootstrap)
+ * preload: {
+ *   bootstrap: true,
+ *   config: true,
+ *   connectors: true
+ * }
+ */
+export type CLICommandPreload = {
+    /**
+     * Configuration files to load.
+     * - `true` - Load all config files
+     * - `string[]` - Load only specified config modules (e.g., `["database", "cache"]`)
+     */
+    config?: true | string[];
+    /**
+     * Load warlock config
+     */
+    warlockConfig?: boolean;
+    /**
+     * Whether to load environment variables from .env files.
+     * Note: If `bootstrap` is true, env is loaded automatically.
+     */
+    env?: boolean;
+    /**
+     * Whether to run the full bootstrap process.
+     * This includes loading env and initializing the application.
+     */
+    bootstrap?: boolean;
+    /**
+     * Connectors to initialize before command execution.
+     * - `true` - Initialize all connectors (http, database, cache)
+     * - `string[]` - Initialize only specified connectors
+     *
+     * Available connectors: `"http"`, `"database"`, `"cache"`
+     */
+    connectors?: ("http" | "database" | "cache")[] | true;
+};
+/**
+ * Definition for a CLI command option/flag.
+ *
+ * @example
+ * {
+ *   name: "port",
+ *   text: "--port, -p",
+ *   alias: "p",
+ *   description: "Server port number",
+ *   type: "number",
+ *   required: false
+ * }
+ */
+export type CLICommandOption = {
+    /**
+     * The camelCase name of the option (auto-extracted from `text`).
+     * This is the key used in `CommandActionData.options`.
+     */
+    name: string;
+    /**
+     * The raw option text as it appears in help output.
+     * Supports formats: `"--port"`, `"-p"`, `"--port, -p"`, `"-p, --port"`
+     */
+    text: string;
+    /**
+     * Short alias for the option (auto-extracted from `text`).
+     * @example For `"--port, -p"` → alias: "p"
+     */
+    alias?: string;
+    /**
+     * Human-readable description shown in help output.
+     */
+    description?: string;
+    /**
+     * Expected value type for validation and parsing.
+     * @default "string"
+     */
+    type?: "string" | "boolean" | "number";
+    /**
+     * Default value if option is not provided.
+     */
+    defaultValue?: string | boolean | number;
+    /**
+     * Whether this option is required.
+     * If true and not provided, command will fail with an error.
+     */
+    required?: boolean;
+};
+/**
+ * Command action function signature.
+ * Receives parsed CLI data and can be sync or async.
+ */
+export type CLICommandAction = (data: CommandActionData) => void | Promise<void>;
+/**
+ * Configuration object for creating a CLI command using the `command()` factory.
+ *
+ * @example
+ * command({
+ *   name: "migrate",
+ *   description: "Run database migrations",
+ *   preload: {
+ *     bootstrap: true,
+ *     connectors: ["database"]
+ *   },
+ *   options: [
+ *     { text: "--fresh, -f", description: "Drop all tables first" }
+ *   ],
+ *   action: async ({ options }) => {
+ *     if (options.fresh) await dropTables();
+ *     await runMigrations();
+ *   }
+ * })
+ */
+export type CLICommandOptions = {
+    /**
+     * The command name. Use dot notation for namespaced commands.
+     * @example "migrate", "db.seed", "jwt.generate"
+     */
+    name: string;
+    /**
+     * Short alias for the command.
+     * @example "m" for "migrate", "g" for "generate"
+     */
+    alias?: string;
+    /**
+     * Human-readable description shown in help output.
+     */
+    description?: string;
+    /**
+     * Resources to preload before command execution.
+     * @see CLICommandPreload
+     */
+    preload?: CLICommandPreload;
+    /**
+     * Whether the command keeps the process alive (e.g., dev server, watchers).
+     * If false, process exits after action completes.
+     * @default false
+     */
+    persistent?: boolean;
+    /**
+     * Function to run BEFORE preloading resources.
+     * Useful for displaying banners, validating input, etc.
+     */
+    preAction?: CLICommandAction;
+    /**
+     * The main command action function.
+     * Executed after preloading resources.
+     */
+    action: CLICommandAction;
+    /**
+     * Command-specific options/flags.
+     * @see CLICommandOption
+     */
+    options?: CLICommandOption[];
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;CACpD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEvC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAEzC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;;OAGG;IACH,MAAM,EAAE,gBAAgB,CAAC;IAEzB;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC"}

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

@@ -0,0 +1,35 @@
+import type { ConfigKey, ConfigRegistry } from "./types";
+/**
+ * Config accessor interface with typed overloads
+ */
+interface ConfigAccessor {
+    /**
+     * Get a config value by dot-notation key path.
+     */
+    key<T = any>(key: ConfigKey | string, defaultValue?: T): T;
+    /**
+     * Get an entire config group by name with type inference.
+     * Returns the typed config object for known config names.
+     */
+    get<K extends keyof ConfigRegistry>(name: K, defaultValue?: ConfigRegistry[K]): ConfigRegistry[K];
+    /**
+     * Get an entire config group by name (dynamic string).
+     */
+    get<T = any>(name: string, defaultValue?: T): T;
+}
+/**
+ * Config accessor with typed autocomplete and return type inference.
+ *
+ * @example
+ * ```typescript
+ * // Get entire config group - returns the actual config type
+ * const db = config.get("database"); // → DatabaseConfigurations
+ *
+ * // Get specific key with dot notation
+ * const host = config.key("database.host");
+ * const port = config.key<number>("database.port", 27017);
+ * ```
+ */
+export declare const config: ConfigAccessor;
+export {};
+//# sourceMappingURL=config-getter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-getter.d.ts","sourceRoot":"","sources":["../../src/config/config-getter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzD;;GAEG;AACH,UAAU,cAAc;IACtB;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAE3D;;;OAGG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAElG;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,EAAE,cAQpB,CAAC"}

package/esm/config/config-getter.js

@@ -0,0 +1,21 @@
+import config$1 from'@mongez/config';/**
+ * Config accessor with typed autocomplete and return type inference.
+ *
+ * @example
+ * ```typescript
+ * // Get entire config group - returns the actual config type
+ * const db = config.get("database"); // → DatabaseConfigurations
+ *
+ * // Get specific key with dot notation
+ * const host = config.key("database.host");
+ * const port = config.key<number>("database.port", 27017);
+ * ```
+ */
+const config = {
+    key(key, defaultValue) {
+        return config$1.get(key, defaultValue);
+    },
+    get(name, defaultValue) {
+        return config$1.get(name, defaultValue);
+    },
+};export{config};//# sourceMappingURL=config-getter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-getter.js","sources":["../../src/config/config-getter.ts"],"sourcesContent":[null],"names":["baseConfig"],"mappings":"qCAwBA;;;;;;;;;;;;AAYG;AACU,MAAA,MAAM,GAAmB;IACpC,GAAG,CAAC,GAAuB,EAAE,YAAkB,EAAA;QAC7C,OAAOA,QAAU,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;KAC1C;IAED,GAAG,CAAC,IAAY,EAAE,YAAkB,EAAA;QAClC,OAAOA,QAAU,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;KAC3C;"}

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

@@ -0,0 +1,19 @@
+import { LogConfigurations } from "../logger";
+import { MailConfigurations } from "../mail";
+import { AppConfigurations } from "../utils/types";
+/**
+ * App Config Handler
+ * Handles locale loading for dayjs
+ */
+export declare const registerAppConfig: (config: AppConfigurations) => Promise<void>;
+/**
+ * Log Config Handler
+ * Sets log configurations in @warlock.js/core
+ */
+export declare const registerLogConfig: (logConfig: LogConfigurations) => Promise<void>;
+/**
+ * Mail Config Handler
+ * Sets mail configurations in @warlock.js/core
+ */
+export declare const registerMailConfig: (mailConfig: MailConfigurations) => Promise<void>;
+//# sourceMappingURL=config-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-handlers.d.ts","sourceRoot":"","sources":["../../src/config/config-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAyB,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAAkB,iBAAiB,kBAahE,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,cAAqB,iBAAiB,kBAOnE,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,eAAsB,kBAAkB,kBAOtE,CAAC"}

package/esm/config/config-handlers.js

@@ -0,0 +1,47 @@
+import {setLogConfigurations}from'../logger/logger.js';import {setMailConfigurations}from'../mail/config.js';import'@mongez/events';import'@mongez/reinforcements';import'@warlock.js/logger';import'nodemailer';import'react';import'react-dom/server';import'node:fs/promises';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);
+/**
+ * Log Config Handler
+ * Sets log configurations in @warlock.js/core
+ */
+const registerLogConfig = async (logConfig) => {
+    try {
+        setLogConfigurations(logConfig);
+    }
+    catch (error) {
+        // @warlock.js/core might not be available in all projects
+        console.warn("   ⚠️  Could not set log configurations");
+    }
+};
+configSpecialHandlers.register("log", registerLogConfig);
+/**
+ * Mail Config Handler
+ * Sets mail configurations in @warlock.js/core
+ */
+const registerMailConfig = async (mailConfig) => {
+    try {
+        setMailConfigurations(mailConfig);
+    }
+    catch (error) {
+        // @warlock.js/core might not be available in all projects
+        console.warn("   ⚠️  Could not set mail configurations");
+    }
+};
+configSpecialHandlers.register("mail", registerMailConfig);export{registerAppConfig,registerLogConfig,registerMailConfig};//# 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":"kVAKA;;;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,CAAC;AAEzD;;;AAGG;MACU,iBAAiB,GAAG,OAAO,SAA4B,KAAI;IACtE,IAAI;QACF,oBAAoB,CAAC,SAAS,CAAC,CAAC;AACjC,KAAA;AAAC,IAAA,OAAO,KAAK,EAAE;;AAEd,QAAA,OAAO,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;AACzD,KAAA;AACH,EAAE;AAEF,qBAAqB,CAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;AAEzD;;;AAGG;MACU,kBAAkB,GAAG,OAAO,UAA8B,KAAI;IACzE,IAAI;QACF,qBAAqB,CAAC,UAAU,CAAC,CAAC;AACnC,KAAA;AAAC,IAAA,OAAO,KAAK,EAAE;;AAEd,QAAA,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;AAC1D,KAAA;AACH,EAAE;AAEF,qBAAqB,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { FileManager } from "../dev2-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":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D;;;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;IAsCrF;;;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,82 @@
+import config from'@mongez/config';import {pathToFileURL}from'node:url';import {warlockCachePath}from'../dev2-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 = pathToFileURL(warlockCachePath(file.cachePath)).href;
+            // Add timestamp for cache busting (forces re-import for HMR)
+            if (bustCache) {
+                const timestamp = Date.now();
+                fileUrl += `?t=${timestamp}`;
+            }
+            // Dynamic import the config file
+            const configModule = await import(fileUrl);
+            // Get the default export (the config value)
+            const configValue = configModule.default;
+            if (configValue === undefined) {
+                throw new Error(`Config file ${file.relativePath} does not have a default export`);
+            }
+            // 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":"gMAYA;;;;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,GAAG,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;;AAGnE,YAAA,IAAI,SAAS,EAAE;AACb,gBAAA,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC7B,gBAAA,OAAO,IAAI,CAAA,GAAA,EAAM,SAAS,CAAA,CAAE,CAAC;AAC9B,aAAA;;AAGD,YAAA,MAAM,YAAY,GAAG,MAAM,OAAO,OAAO,CAAC,CAAC;;AAG3C,YAAA,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC;YAEzC,IAAI,WAAW,KAAK,SAAS,EAAE;gBAC7B,MAAM,IAAI,KAAK,CAAC,CAAA,YAAA,EAAe,IAAI,CAAC,YAAY,CAAiC,+BAAA,CAAA,CAAC,CAAC;AACpF,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 "../dev2-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,6BAA6B,CAAC;AAC1D,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

@@ -1,5 +1,5 @@
-export * from "./define-config";
-export * from "./get-warlock-config";
-export * from "./typed-config";
+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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"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,iBAkB5D"}

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

@@ -0,0 +1,19 @@
+import {filesOrchestrator}from'../dev2-server/files-orchestrator.js';import {Path}from'../dev2-server/path.js';import {getFilesFromDirectory,getCertainFilesFromDirectory}from'../dev2-server/utils.js';import'@warlock.js/logger';import'@warlock.js/cascade';import'../utils/date-output.js';import'../http/middleware/inject-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":"8fAMA;;;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;;AAEL,QAAA,MAAM,wBAAwB,GAAG,MAAM,4BAA4B,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AAC/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"}