@warlock.js/core 4.0.48 → 4.0.59

package/esm/cli/parse-cli-args.d.ts

@@ -0,0 +1,18 @@
+export type ParsedCliArgs = {
+    name: string;
+    args: string[];
+    options: Record<string, string | boolean>;
+};
+/**
+ * Parse CLI arguments from process.argv
+ *
+ * @example
+ * parseCliArgs(["node", "warlock", "migrate", "--rollback", "file.ts"])
+ * // Returns: { command: "migrate", args: ["file.ts"], options: { rollback: true } }
+ *
+ * @example
+ * parseCliArgs(["node", "warlock", "dev", "--port=3000", "--fresh"])
+ * // Returns: { command: "dev", args: [], options: { port: "3000", fresh: true } }
+ */
+export declare function parseCliArgs(argv: string[]): ParsedCliArgs;
+//# sourceMappingURL=parse-cli-args.d.ts.map

package/esm/cli/parse-cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cli-args.d.ts","sourceRoot":"","sources":["../../src/cli/parse-cli-args.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAsE1D"}

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

@@ -0,0 +1,82 @@
+import {toCamelCase}from'@mongez/reinforcements';/**
+ * Parse CLI arguments from process.argv
+ *
+ * @example
+ * parseCliArgs(["node", "warlock", "migrate", "--rollback", "file.ts"])
+ * // Returns: { command: "migrate", args: ["file.ts"], options: { rollback: true } }
+ *
+ * @example
+ * parseCliArgs(["node", "warlock", "dev", "--port=3000", "--fresh"])
+ * // Returns: { command: "dev", args: [], options: { port: "3000", fresh: true } }
+ */
+function parseCliArgs(argv) {
+    // Command is at index 2 (after "node" and script path)
+    // But if index 2 starts with "-", it's an option, not a command
+    const potentialCommand = argv[2] || "";
+    const isFirstArgOption = potentialCommand.startsWith("-");
+    const command = isFirstArgOption ? "" : potentialCommand;
+    const args = [];
+    const options = {};
+    // Parse arguments starting from index 3 (or 2 if first arg was an option)
+    const startIndex = isFirstArgOption ? 2 : 3;
+    for (let i = startIndex; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            // Long option: --key or --key=value
+            const withoutDashes = arg.slice(2);
+            const equalIndex = withoutDashes.indexOf("=");
+            if (equalIndex !== -1) {
+                // --key=value format
+                const key = toCamelCase(withoutDashes.slice(0, equalIndex));
+                const value = withoutDashes.slice(equalIndex + 1);
+                options[key] = value;
+            }
+            else {
+                // --key format (check if next arg is a value)
+                const key = toCamelCase(withoutDashes);
+                const nextArg = argv[i + 1];
+                // If next arg exists and doesn't start with -, treat it as value
+                if (nextArg && !nextArg.startsWith("-")) {
+                    options[key] = nextArg;
+                    i++; // Skip next arg
+                }
+                else {
+                    options[key] = true;
+                }
+            }
+        }
+        else if (arg.startsWith("-") && arg.length > 1) {
+            // Short option: -f, -t=value, or -abc (multiple flags)
+            const flags = arg.slice(1);
+            const equalIndex = flags.indexOf("=");
+            if (equalIndex !== -1) {
+                // -t=value format
+                const key = toCamelCase(flags.slice(0, equalIndex));
+                const value = flags.slice(equalIndex + 1);
+                options[key] = value;
+            }
+            else if (flags.length === 1) {
+                // Single flag: -f
+                const nextArg = argv[i + 1];
+                if (nextArg && !nextArg.startsWith("-")) {
+                    options[toCamelCase(flags)] = nextArg;
+                    i++; // Skip next arg
+                }
+                else {
+                    options[toCamelCase(flags)] = true;
+                }
+            }
+            else {
+                // Multiple flags: -abc becomes { a: true, b: true, c: true }
+                for (const flag of flags) {
+                    options[toCamelCase(flag)] = true;
+                }
+            }
+        }
+        else {
+            // Positional argument
+            args.push(arg);
+        }
+    }
+    return { name: command, args, options };
+}export{parseCliArgs};//# sourceMappingURL=parse-cli-args.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cli-args.js","sources":["../../src/cli/parse-cli-args.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/cli/start.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":""}

package/esm/cli/start.js

@@ -1,6 +1,2 @@
-import { CLICommandsManager } from './cli-commands.manager';
-
-const commandsManager = new CLICommandsManager();
-await commandsManager.start();
-//# sourceMappingURL=start.js.map
-//# sourceMappingURL=start.js.map
+import {CLICommandsManager}from'./cli-commands.manager.js';const commandsManager = new CLICommandsManager();
+await commandsManager.start();//# sourceMappingURL=start.js.map

package/esm/cli/start.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../../warlock.js/core/src/cli/start.ts"],"names":[],"mappings":";;AAEA,MAAM,eAAA,GAAkB,IAAI,kBAAA,EAAmB;AAC/C,MAAM,gBAAgB,KAAA,EAAM","file":"start.js","sourcesContent":["import { CLICommandsManager } from \"./cli-commands.manager\";\r\n\r\nconst commandsManager = new CLICommandsManager();\r\nawait commandsManager.start();\r\n"]}
+{"version":3,"file":"start.js","sources":["../../src/cli/start.ts"],"sourcesContent":[null],"names":[],"mappings":"2DAEA,MAAM,eAAe,GAAG,IAAI,kBAAkB,EAAE,CAAC;AACjD,MAAM,eAAe,CAAC,KAAK,EAAE"}

package/esm/cli/string-similarity.d.ts

@@ -0,0 +1,44 @@
+/**
+ * String similarity utilities for CLI command suggestions
+ * Uses Levenshtein distance algorithm for fuzzy matching
+ */
+/**
+ * Calculate the Levenshtein distance between two strings
+ * Lower distance = more similar
+ *
+ * @param str1 - First string
+ * @param str2 - Second string
+ * @returns Distance (number of edits required to transform str1 to str2)
+ */
+export declare function levenshteinDistance(str1: string, str2: string): number;
+/**
+ * Suggestion result with similarity score
+ */
+export type Suggestion = {
+    /** The suggested value */
+    value: string;
+    /** Distance score (lower = more similar) */
+    distance: number;
+};
+/**
+ * Find similar strings from a list
+ *
+ * @param input - The input string to find matches for
+ * @param candidates - List of candidate strings
+ * @param maxDistance - Maximum distance to consider (default: 3)
+ * @param maxResults - Maximum number of results to return (default: 3)
+ * @returns Array of suggestions sorted by similarity
+ *
+ * @example
+ * ```typescript
+ * findSimilar("biuld", ["build", "dev", "start", "test"])
+ * // Returns: [{ value: "build", distance: 1 }]
+ * ```
+ */
+export declare function findSimilar(input: string, candidates: string[], maxDistance?: number, maxResults?: number): Suggestion[];
+/**
+ * Check if a string starts with any of the given prefixes
+ * Useful for command name matching
+ */
+export declare function startsWithAny(str: string, prefixes: string[]): boolean;
+//# sourceMappingURL=string-similarity.d.ts.map

package/esm/cli/string-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-similarity.d.ts","sourceRoot":"","sources":["../../src/cli/string-similarity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBtE;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,GAAE,MAAU,EACvB,UAAU,GAAE,MAAU,GACrB,UAAU,EAAE,CAed;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAEtE"}

package/esm/cli/string-similarity.js

@@ -0,0 +1,57 @@
+/**
+ * String similarity utilities for CLI command suggestions
+ * Uses Levenshtein distance algorithm for fuzzy matching
+ */
+/**
+ * Calculate the Levenshtein distance between two strings
+ * Lower distance = more similar
+ *
+ * @param str1 - First string
+ * @param str2 - Second string
+ * @returns Distance (number of edits required to transform str1 to str2)
+ */
+function levenshteinDistance(str1, str2) {
+    const s1 = str1.toLowerCase();
+    const s2 = str2.toLowerCase();
+    const len1 = s1.length;
+    const len2 = s2.length;
+    // Create matrix
+    const matrix = Array.from({ length: len1 + 1 }, (_, i) => Array.from({ length: len2 + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    // Fill matrix
+    for (let i = 1; i <= len1; i++) {
+        for (let j = 1; j <= len2; j++) {
+            const cost = s1[i - 1] === s2[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, // deletion
+            matrix[i][j - 1] + 1, // insertion
+            matrix[i - 1][j - 1] + cost);
+        }
+    }
+    return matrix[len1][len2];
+}
+/**
+ * Find similar strings from a list
+ *
+ * @param input - The input string to find matches for
+ * @param candidates - List of candidate strings
+ * @param maxDistance - Maximum distance to consider (default: 3)
+ * @param maxResults - Maximum number of results to return (default: 3)
+ * @returns Array of suggestions sorted by similarity
+ *
+ * @example
+ * ```typescript
+ * findSimilar("biuld", ["build", "dev", "start", "test"])
+ * // Returns: [{ value: "build", distance: 1 }]
+ * ```
+ */
+function findSimilar(input, candidates, maxDistance = 3, maxResults = 3) {
+    const results = [];
+    for (const candidate of candidates) {
+        const distance = levenshteinDistance(input, candidate);
+        if (distance <= maxDistance && distance > 0) {
+            results.push({ value: candidate, distance });
+        }
+    }
+    // Sort by distance (most similar first)
+    results.sort((a, b) => a.distance - b.distance);
+    return results.slice(0, maxResults);
+}export{findSimilar,levenshteinDistance};//# sourceMappingURL=string-similarity.js.map

package/esm/cli/string-similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-similarity.js","sources":["../../src/cli/string-similarity.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;AAGG;AAEH;;;;;;;AAOG;AACa,SAAA,mBAAmB,CAAC,IAAY,EAAE,IAAY,EAAA;AAC5D,IAAA,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;AAC9B,IAAA,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;AAE9B,IAAA,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC;AACvB,IAAA,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC;;AAGvB,IAAA,MAAM,MAAM,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAC5E,CAAC;;IAGF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACrB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACpB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;AACpB,YAAA,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAC5B,CAAC;AACH,SAAA;AACF,KAAA;AAED,IAAA,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAYD;;;;;;;;;;;;;;AAcG;AACG,SAAU,WAAW,CACzB,KAAa,EACb,UAAoB,EACpB,WAAsB,GAAA,CAAC,EACvB,UAAA,GAAqB,CAAC,EAAA;IAEtB,MAAM,OAAO,GAAiB,EAAE,CAAC;AAEjC,IAAA,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE;QAClC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAEvD,QAAA,IAAI,QAAQ,IAAI,WAAW,IAAI,QAAQ,GAAG,CAAC,EAAE;YAC3C,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC9C,SAAA;AACF,KAAA;;AAGD,IAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AACtC"}

package/esm/cli/types.d.ts

@@ -0,0 +1,206 @@
+/**
+ * @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.
+ */
+import { ConnectorName } from "../dev2-server/connectors";
+/**
+ * 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"`, `"storage"`
+     */
+    connectors?: ConnectorName[] | 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 raw option text as it appears in help output.
+     * Supports formats: `"--port"`, `"-p"`, `"--port, -p"`, `"-p, --port"`
+     */
+    text: string;
+    /**
+     * The camelCase name of the option (auto-extracted from `text`).
+     * This is the key used in `CommandActionData.options`.
+     */
+    name?: 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;
+};
+export type ResolvedCLICommandOption = Omit<CLICommandOption, "alias" | "name"> & {
+    name: string;
+    alias: string;
+};
+/**
+ * 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,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;;;;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,aAAa,EAAE,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;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,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAAC,GAAG;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,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'../mail/mailer-pool.js';import'../react/index.js';import'@warlock.js/logger';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":"iVAKA;;;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":"AAGA,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;IA+CrF;;;OAGG;IACU,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D;;;;;OAKG;IACH,OAAO,CAAC,aAAa;CAUtB"}