@warlock.js/core 4.0.162 → 4.0.163

package/esm/cli/commands-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-loader.d.ts","sourceRoot":"","sources":["../../src/cli/commands-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,qBAAa,iBAAiB;IAC5B;;OAEG;IACU,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAkBzE;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAgB7C;;OAEG;IACU,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;CAKzE;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/esm/cli/commands-loader.js

@@ -0,0 +1,45 @@
+import {filesOrchestrator}from'../dev-server/files-orchestrator.js';import {Path}from'../dev-server/path.js';import {getFilesFromDirectory}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 {isMatchingCommandName}from'./cli-commands.utils.js';class CLICommandsLoader {
+    /**
+     * Locate command by name
+     */
+    async locate(commandName) {
+        const files = await getFilesFromDirectory(srcPath("app"), "**/commands/*.{ts,tsx}");
+        // now convert them into relative paths
+        const relativeFiles = files.map((path) => Path.toRelative(path));
+        for (const relativeFile of relativeFiles) {
+            const command = await this.load(relativeFile);
+            if (command) {
+                command.$relativePath(relativeFile);
+                if (isMatchingCommandName(command.name, commandName)) {
+                    return command;
+                }
+            }
+        }
+        return;
+    }
+    /**
+     * Scan all project commands and return them
+     * Used for warm cache functionality
+     */
+    async scanAll() {
+        const files = await getFilesFromDirectory(srcPath("app"), "**/commands/*.{ts,tsx}");
+        const relativeFiles = files.map((path) => Path.toRelative(path));
+        const commands = [];
+        for (const relativeFile of relativeFiles) {
+            const command = await this.load(relativeFile);
+            if (command) {
+                command.$relativePath(relativeFile);
+                commands.push(command);
+            }
+        }
+        return commands;
+    }
+    /**
+     * Load command from a relative path
+     */
+    async load(relativePath) {
+        const output = await filesOrchestrator.load(relativePath);
+        return output?.default;
+    }
+}
+const cliCommandsLoader = new CLICommandsLoader();export{CLICommandsLoader,cliCommandsLoader};//# sourceMappingURL=commands-loader.js.map

package/esm/cli/commands-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-loader.js","sources":["../../src/cli/commands-loader.ts"],"sourcesContent":[null],"names":[],"mappings":"keAOa,iBAAiB,CAAA;AAC5B;;AAEG;IACI,MAAM,MAAM,CAAC,WAAmB,EAAA;AACrC,QAAA,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAC;;AAEpF,QAAA,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAEjE,QAAA,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;YACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC9C,YAAA,IAAI,OAAO,EAAE;AACX,gBAAA,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;gBACpC,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE;AACpD,oBAAA,OAAO,OAAO,CAAC;AAChB,iBAAA;AACF,aAAA;AACF,SAAA;QAED,OAAO;KACR;AAED;;;AAGG;AACI,IAAA,MAAM,OAAO,GAAA;AAClB,QAAA,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAC;AACpF,QAAA,MAAM,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAiB,EAAE,CAAC;AAElC,QAAA,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;YACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC9C,YAAA,IAAI,OAAO,EAAE;AACX,gBAAA,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;AACpC,gBAAA,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxB,aAAA;AACF,SAAA;AAED,QAAA,OAAO,QAAQ,CAAC;KACjB;AAED;;AAEG;IACI,MAAM,IAAI,CAAC,YAAoB,EAAA;QACpC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAA0B,YAAY,CAAC,CAAC;QAEnF,OAAO,MAAM,EAAE,OAAO,CAAC;KACxB;AACF,CAAA;AAEY,MAAA,iBAAiB,GAAG,IAAI,iBAAiB"}

package/esm/cli/framework-cli-commands.d.ts

@@ -0,0 +1,2 @@
+export declare const frameworkCommands: import("./cli-command").CLICommand[];
+//# sourceMappingURL=framework-cli-commands.d.ts.map

package/esm/cli/framework-cli-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-cli-commands.d.ts","sourceRoot":"","sources":["../../src/cli/framework-cli-commands.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,iBAAiB,sCA+B7B,CAAC"}

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

@@ -0,0 +1,27 @@
+import {addCommand}from'./commands/add.command.js';import {buildCommand}from'./commands/build.command.js';import {createDatabaseCommand}from'./commands/create-database.command.js';import {devServerCommand}from'./commands/dev-server.command.js';import {dropTablesCommand}from'./commands/drop-tables.command.js';import {generateCommand,generateModuleCommand,generateControllerCommand,generateServiceCommand,generateModelCommand,generateRepositoryCommand,generateResourceCommand,generateValidationCommand,generateMigrationCommand}from'./commands/generate/generate.command.js';import {migrateCommand}from'./commands/migrate.command.js';import {seedCommand}from'./commands/seed.command.js';import {startProductionCommand}from'./commands/start-production.command.js';import {storagePutCommand}from'./commands/storage-put.command.js';import {typingsGeneratorCommand}from'./commands/typings-generator.command.js';const frameworkCommands = [
+    // development commands
+    devServerCommand,
+    typingsGeneratorCommand,
+    // production commands
+    buildCommand,
+    startProductionCommand,
+    // database commands
+    migrateCommand,
+    seedCommand,
+    createDatabaseCommand,
+    dropTablesCommand,
+    // generation/installation commands
+    addCommand,
+    // scaffolding commands
+    generateCommand,
+    generateModuleCommand,
+    generateControllerCommand,
+    generateServiceCommand,
+    generateModelCommand,
+    generateRepositoryCommand,
+    generateResourceCommand,
+    generateValidationCommand,
+    generateMigrationCommand,
+    // storage commands
+    storagePutCommand,
+];export{frameworkCommands};//# sourceMappingURL=framework-cli-commands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework-cli-commands.js","sources":["../../src/cli/framework-cli-commands.ts"],"sourcesContent":[null],"names":[],"mappings":"y4BAsBa,MAAA,iBAAiB,GAAG;;IAE/B,gBAAgB;IAChB,uBAAuB;;IAGvB,YAAY;IACZ,sBAAsB;;IAGtB,cAAc;IACd,WAAW;IACX,qBAAqB;IACrB,iBAAiB;;IAGjB,UAAU;;IAGV,eAAe;IACf,qBAAqB;IACrB,yBAAyB;IACzB,sBAAsB;IACtB,oBAAoB;IACpB,yBAAyB;IACzB,uBAAuB;IACvB,yBAAyB;IACzB,wBAAwB;;IAGxB,iBAAiB;"}

package/esm/cli/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./cli-command";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAE9B,cAAc,SAAS,CAAC"}

package/esm/cli/index.js

@@ -0,0 +1 @@
+export{CLICommand,command}from'./cli-command.js';//# sourceMappingURL=index.js.map

package/esm/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

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

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

package/esm/cli/start.js.map

@@ -0,0 +1 @@
+{"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,218 @@
+/**
+ * @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 "../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 prestart file after (bootstrap and configurations are loaded).
+     */
+    prestart?: boolean;
+    /**
+     * Load warlock config
+     */
+    warlockConfig?: boolean;
+    /**
+     * Set runtime strategy
+     */
+    runtimeStrategy?: "production" | "development";
+    /**
+     * Override current detect environment
+     */
+    environemnt?: "production" | "development" | "test";
+    /**
+     * 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,eAAe,CAAC;AAE9C;;;;;;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,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,eAAe,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;IAE/C;;OAEG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;IAEpD;;;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,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAElE;;;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,GAA8B,EAAE,YAAkB,EAAA;QACpD,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,7 @@
+import { AppConfigurations } from "../utils/types";
+/**
+ * App Config Handler
+ * Handles locale loading for dayjs
+ */
+export declare const registerAppConfig: (config: AppConfigurations) => 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,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,WAAkB,iBAAiB,kBAahE,CAAC"}