@warlock.js/core 4.0.48 → 4.0.59

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

@@ -0,0 +1,71 @@
+import { CLICommand } from "./cli-command";
+import { CommandActionData, ResolvedCLICommandOption } from "./types";
+export declare class CLICommandsManager {
+    /**
+     * List of commands
+     */
+    commands: CLICommand[];
+    /**
+     * Commands map (name -> command)
+     */
+    commandsMap: Map<string, CLICommand>;
+    /**
+     * Alias map (alias -> command name)
+     */
+    aliasMap: Map<string, string>;
+    /**
+     * Register the given commands
+     */
+    register(...commands: CLICommand[]): this;
+    /**
+     * Get command by name or alias
+     */
+    getCommand(name: string): CLICommand | undefined;
+    /**
+     * Get all command names and aliases
+     * Used for fuzzy matching suggestions
+     */
+    getAllCommandNames(): string[];
+    /**
+     * Start the cli manager
+     */
+    start(): Promise<void>;
+    /**
+     * Show global help with all commands
+     * Uses manifest if available for fast display
+     */
+    protected showGlobalHelp(): Promise<void>;
+    /**
+     * Warm cache - scan all project commands and save to manifest
+     */
+    protected warmCache(): Promise<void>;
+    /**
+     * Load plugins commands
+     */
+    protected loadPluginsCommands(): Promise<void>;
+    /**
+     * Try to find the command based on the given command name or alias
+     */
+    protected lazyGetCommand(name: string): Promise<CLICommand>;
+    /**
+     * Load project commands
+     */
+    protected loadProjectCommands(name: string): Promise<void>;
+    /**
+     * Validate required options
+     */
+    protected validateOptions(command: CLICommand, options: Record<string, string | boolean | number>): ResolvedCLICommandOption[];
+    /**
+     * Apply default values to options
+     */
+    protected applyDefaultOptions(command: CLICommand, options: Record<string, string | boolean | number>): Record<string, string | boolean | number>;
+    /**
+     * Execute the given command
+     */
+    execute(command: CLICommand, data: CommandActionData): Promise<void>;
+    /**
+     * Load preloaders
+     */
+    protected loadPreloaders(command: CLICommand): Promise<void>;
+}
+//# sourceMappingURL=cli-commands.manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commands.manager.d.ts","sourceRoot":"","sources":["../../src/cli/cli-commands.manager.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAkB3C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEtE,qBAAa,kBAAkB;IAC7B;;OAEG;IACI,QAAQ,EAAE,UAAU,EAAE,CAAM;IAEnC;;OAEG;IACI,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAa;IAExD;;OAEG;IACI,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAEjD;;OAEG;IACI,QAAQ,CAAC,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAyBhD;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAcvD;;;OAGG;IACI,kBAAkB,IAAI,MAAM,EAAE;IA6BrC;;OAEG;IACU,KAAK;IAgFlB;;;OAGG;cACa,cAAc;IAwC9B;;OAEG;cACa,SAAS;IAgBzB;;OAEG;cACa,mBAAmB;IAenC;;OAEG;cACa,cAAc,CAAC,IAAI,EAAE,MAAM;IA2B3C;;OAEG;cACa,mBAAmB,CAAC,IAAI,EAAE,MAAM;IAiChD;;OAEG;IACH,SAAS,CAAC,eAAe,CACvB,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,GACjD,wBAAwB,EAAE;IAiB7B;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAC3B,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,GACjD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAoB5C;;OAEG;IACU,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB;IAwCjE;;OAEG;cACa,cAAc,CAAC,OAAO,EAAE,UAAU;CA0BnD"}

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

@@ -0,0 +1,348 @@
+import {colors}from'@mongez/copper';import {loadEnv}from'@mongez/dotenv';import {ensureDirectoryAsync}from'@mongez/fs';import {bootstrap}from'../bootstrap.js';import {loadConfigFiles}from'../config/load-config-files.js';import {connectorsManager}from'../dev2-server/connectors/connectors-manager.js';import {filesOrchestrator}from'../dev2-server/files-orchestrator.js';import {manifestManager}from'../manifest/manifest-manager.js';import'@warlock.js/logger';import'../database/models/database-log/database-log.js';import'../http/context/request-context.js';import {warlockPath}from'../utils/paths.js';import'@mongez/slug';import'@mongez/supportive-is';import'@mongez/reinforcements';import {warlockConfigManager}from'../warlock-config/warlock-config.manager.js';import {displayWarlockVersionInTerminal,displayMissingCommand,displayCommandNotFound,displayCommandHelp,displayHelp,isMatchingCommandName,displayMissingOptions,displayExecutingCommand,displayCommandSuccess,displayCommandError}from'./cli-commands.utils.js';import {cliCommandsLoader}from'./commands-loader.js';import {frameworkCommands}from'./framework-cli-commands.js';import {parseCliArgs}from'./parse-cli-args.js';import {findSimilar}from'./string-similarity.js';class CLICommandsManager {
+    /**
+     * List of commands
+     */
+    commands = [];
+    /**
+     * Commands map (name -> command)
+     */
+    commandsMap = new Map();
+    /**
+     * Alias map (alias -> command name)
+     */
+    aliasMap = new Map();
+    /**
+     * Register the given commands
+     */
+    register(...commands) {
+        this.commands.push(...commands);
+        commands.forEach((command) => {
+            const commandKey = command.name.split(" ")[0];
+            manifestManager.addCommandToList(command.name, {
+                relativePath: command.commandRelativePath,
+                source: command.commandSource || "project",
+                description: command.commandDescription,
+                alias: command.commandAlias,
+                options: command.commandOptions.length > 0 ? command.commandOptions : undefined,
+            });
+            this.commandsMap.set(commandKey, command);
+            // Register alias if exists
+            if (command.commandAlias) {
+                this.aliasMap.set(command.commandAlias, commandKey);
+            }
+        });
+        return this;
+    }
+    /**
+     * Get command by name or alias
+     */
+    getCommand(name) {
+        // First try direct lookup
+        let command = this.commandsMap.get(name);
+        if (command)
+            return command;
+        // Try alias lookup
+        const realName = this.aliasMap.get(name);
+        if (realName) {
+            return this.commandsMap.get(realName);
+        }
+        return;
+    }
+    /**
+     * Get all command names and aliases
+     * Used for fuzzy matching suggestions
+     */
+    getAllCommandNames() {
+        const names = [];
+        // Add all command names
+        for (const name of this.commandsMap.keys()) {
+            names.push(name);
+        }
+        // Add all aliases
+        for (const alias of this.aliasMap.keys()) {
+            names.push(alias);
+        }
+        // Also include cached commands from manifest
+        const manifestCommands = manifestManager.commandsJson?.commands || {};
+        for (const name of Object.keys(manifestCommands)) {
+            const baseName = name.split(" ")[0];
+            if (!names.includes(baseName)) {
+                names.push(baseName);
+            }
+            const alias = manifestCommands[name].alias;
+            if (alias && !names.includes(alias)) {
+                names.push(alias);
+            }
+        }
+        return names;
+    }
+    /**
+     * Start the cli manager
+     */
+    async start() {
+        const { name, options, args } = parseCliArgs(process.argv);
+        if (options.noCache) {
+            manifestManager.clearCommandsCache();
+            // remove the commands.json file as wel
+            await manifestManager.removeCommandsFile();
+        }
+        if (options.version || options.v) {
+            await displayWarlockVersionInTerminal();
+            process.exit(0);
+        }
+        // Try to load from manifest first (fastest path)
+        await manifestManager.loadCommands();
+        // Register framework commands first (needed for help)
+        this.register(...frameworkCommands.map((command) => {
+            if (!command.commandSource) {
+                command.commandSource = "framework";
+            }
+            return command;
+        }));
+        await ensureDirectoryAsync(warlockPath("cache"));
+        const isHelpCommand = options.help || options.h;
+        // Handle global help (no command)
+        if (!name && isHelpCommand) {
+            await this.showGlobalHelp();
+            process.exit(0);
+        }
+        // Handle warm cache
+        if (options.warmCache) {
+            await this.warmCache();
+            process.exit(0);
+        }
+        if (!name) {
+            displayMissingCommand();
+            process.exit(1);
+        }
+        const command = await this.lazyGetCommand(name);
+        if (manifestManager.hasChanges) {
+            await manifestManager.saveCommands();
+        }
+        if (!command) {
+            // Find similar commands for suggestions
+            const allCommandNames = this.getAllCommandNames();
+            const suggestions = findSimilar(name, allCommandNames).map((s) => s.value);
+            displayCommandNotFound(name, suggestions);
+            process.exit(1);
+        }
+        // Handle command-specific help
+        if (isHelpCommand) {
+            displayCommandHelp({
+                name: command.name,
+                alias: command.commandAlias,
+                description: command.commandDescription,
+                options: command.commandOptions,
+            });
+            process.exit(0);
+        }
+        await this.execute(command, {
+            options,
+            args,
+        });
+    }
+    /**
+     * Show global help with all commands
+     * Uses manifest if available for fast display
+     */
+    async showGlobalHelp() {
+        if (manifestManager.isCommandLoaded &&
+            Object.keys(manifestManager.commandsJson?.commands || {}).length > 0) {
+            // Use manifest directly - no need to load command files
+            const helpCommands = Object.entries(manifestManager.commandsJson?.commands || {}).map(([name, cmd]) => ({
+                name,
+                alias: cmd.alias,
+                description: cmd.description,
+                source: cmd.source,
+            }));
+            await displayHelp(helpCommands);
+            return;
+        }
+        // Fallback: No manifest, build from registered commands
+        // This happens on first run before warm-cache
+        await this.loadPluginsCommands();
+        const projectCommands = await cliCommandsLoader.scanAll();
+        this.register(...projectCommands);
+        await manifestManager.saveCommands();
+        // Build help info from registered commands
+        const helpCommands = this.commands.map((cmd) => ({
+            name: cmd.name,
+            alias: cmd.commandAlias,
+            description: cmd.commandDescription,
+            source: cmd.commandSource || "project",
+        }));
+        await displayHelp(helpCommands);
+    }
+    /**
+     * Warm cache - scan all project commands and save to manifest
+     */
+    async warmCache() {
+        console.log();
+        console.log(`  ${colors.cyan("›")} Scanning project commands...`);
+        const projectCommands = await cliCommandsLoader.scanAll();
+        this.register(...projectCommands);
+        await manifestManager.saveCommands();
+        console.log(`  ${colors.green("✔")} Cached ${colors.bold(String(projectCommands.length))} project commands`);
+        console.log();
+    }
+    /**
+     * Load plugins commands
+     */
+    async loadPluginsCommands() {
+        await warlockConfigManager.load();
+        if (warlockConfigManager.isLoaded) {
+            this.register(...(warlockConfigManager.get("cli")?.commands || []).map((command) => {
+                if (!command.commandSource) {
+                    command.commandSource = "plugin";
+                }
+                return command;
+            }));
+        }
+    }
+    /**
+     * Try to find the command based on the given command name or alias
+     */
+    async lazyGetCommand(name) {
+        // first step, try to find it directly through current commands
+        let command = this.getCommand(name);
+        if (command) {
+            return command;
+        }
+        // second step, try to find it through warlock config commands
+        await this.loadPluginsCommands();
+        command = this.getCommand(name);
+        if (command) {
+            return command;
+        }
+        // third step, try to find it through project commands
+        await this.loadProjectCommands(name);
+        command = this.getCommand(name);
+        if (command) {
+            return command;
+        }
+        return null;
+    }
+    /**
+     * Load project commands
+     */
+    async loadProjectCommands(name) {
+        // first get the commands.json contents as an object
+        const jsonCommandsFile = await manifestManager.loadCommands();
+        if (jsonCommandsFile) {
+            // Check by name or alias
+            for (const fullCommandName in jsonCommandsFile.commands) {
+                const cmdMeta = jsonCommandsFile.commands[fullCommandName];
+                // Match by name or alias
+                if (isMatchingCommandName(fullCommandName, name) || cmdMeta.alias === name) {
+                    const commandPath = cmdMeta.relativePath;
+                    if (commandPath) {
+                        const executedCommand = await cliCommandsLoader.load(commandPath);
+                        if (executedCommand) {
+                            executedCommand.$relativePath(commandPath);
+                            this.register(executedCommand);
+                            return;
+                        }
+                    }
+                }
+            }
+        }
+        const command = await cliCommandsLoader.locate(name);
+        if (command) {
+            this.register(command);
+            return;
+        }
+    }
+    /**
+     * Validate required options
+     */
+    validateOptions(command, options) {
+        const missing = [];
+        command.commandOptions.forEach((opt) => {
+            if (opt.required) {
+                // Check if option is provided by name or alias
+                const hasOption = options[opt.name] !== undefined || (opt.alias && options[opt.alias] !== undefined);
+                if (!hasOption) {
+                    missing.push(opt);
+                }
+            }
+        });
+        return missing;
+    }
+    /**
+     * Apply default values to options
+     */
+    applyDefaultOptions(command, options) {
+        const result = { ...options };
+        command.commandOptions.forEach((opt) => {
+            if (opt.defaultValue !== undefined) {
+                const hasOption = result[opt.name] !== undefined || (opt.alias && result[opt.alias] !== undefined);
+                if (!hasOption) {
+                    result[opt.name] = opt.defaultValue;
+                }
+            }
+            if (opt.alias !== undefined && result[opt.alias] && result[opt.name] === undefined) {
+                result[opt.name] = result[opt.alias];
+            }
+        });
+        return result;
+    }
+    /**
+     * Execute the given command
+     */
+    async execute(command, data) {
+        const startTime = Date.now();
+        // Validate required options
+        const missingOptions = this.validateOptions(command, data.options);
+        if (missingOptions.length > 0) {
+            displayMissingOptions(missingOptions);
+            process.exit(1);
+        }
+        // Apply default values
+        data.options = this.applyDefaultOptions(command, data.options);
+        displayExecutingCommand(command.name);
+        if (command.commandPreAction) {
+            await command.commandPreAction(data);
+        }
+        // load preloaders
+        if (command.commandPreload) {
+            await this.loadPreloaders(command);
+        }
+        try {
+            await command.execute(data);
+            if (!command.isPersistent) {
+                displayCommandSuccess(command.name, Date.now() - startTime);
+                process.exit(0);
+            }
+        }
+        catch (error) {
+            displayCommandError(command.name, error);
+            if (!command.isPersistent) {
+                process.exit(1);
+            }
+        }
+    }
+    /**
+     * Load preloaders
+     */
+    async loadPreloaders(command) {
+        const preloaders = command.commandPreload || {};
+        await warlockConfigManager.load();
+        // if (preloaders.warlockConfig) {
+        // }
+        if (preloaders.env && !preloaders.bootstrap) {
+            await loadEnv();
+        }
+        else if (preloaders.bootstrap) {
+            bootstrap();
+        }
+        // Load configuration files
+        if (preloaders.config) {
+            await filesOrchestrator.init();
+            await loadConfigFiles(preloaders.config);
+        }
+        // Initialize connectors
+        if (preloaders.connectors) {
+            await connectorsManager.start(preloaders.connectors === true ? undefined : preloaders.connectors);
+        }
+    }
+}export{CLICommandsManager};//# sourceMappingURL=cli-commands.manager.js.map

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

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

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

@@ -0,0 +1,73 @@
+import { Environment } from "../utils";
+export declare function isMatchingCommandName(commandName: string, targetingCommandName: string): boolean;
+/**
+ * Get the framework version from package.json (cached)
+ */
+export declare function getWarlockVersion(): Promise<string>;
+/**
+ * Display the Warlock.js version banner
+ */
+export declare function displayWarlockVersionInTerminal(): Promise<void>;
+type StartBannerOptions = {
+    environment: Environment;
+};
+/**
+ * Display CLI startup banner
+ */
+export declare function displayStartupBanner({ environment }: StartBannerOptions): Promise<void>;
+/**
+ * Display command execution header
+ */
+export declare function displayExecutingCommand(commandName: string): void;
+/**
+ * Display command not found error with optional suggestions
+ */
+export declare function displayCommandNotFound(commandName: string, suggestions?: string[]): void;
+/**
+ * Display missing command error
+ */
+export declare function displayMissingCommand(): void;
+/**
+ * Display command success message
+ */
+export declare function displayCommandSuccess(commandName: string, durationMs?: number): void;
+/**
+ * Display command error message
+ */
+export declare function displayCommandError(commandName: string, error: Error): void;
+/**
+ * Display missing required options error
+ */
+export declare function displayMissingOptions(options: {
+    name: string;
+    text: string;
+}[]): void;
+/**
+ * Command info for help display
+ */
+export type HelpCommandInfo = {
+    name: string;
+    alias?: string;
+    description?: string;
+    source: "framework" | "plugin" | "project";
+};
+/**
+ * Display global help with all commands grouped by source
+ */
+export declare function displayHelp(commands: HelpCommandInfo[]): Promise<void>;
+/**
+ * Display help for a specific command
+ */
+export declare function displayCommandHelp(command: {
+    name: string;
+    alias?: string;
+    description?: string;
+    options?: {
+        name: string;
+        text: string;
+        description?: string;
+        required?: boolean;
+    }[];
+}): void;
+export {};
+//# sourceMappingURL=cli-commands.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-commands.utils.d.ts","sourceRoot":"","sources":["../../src/cli/cli-commands.utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,WAEtF;AAOD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAUzD;AAED;;GAEG;AACH,wBAAsB,+BAA+B,kBAGpD;AAED,KAAK,kBAAkB,GAAG;IACxB,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC;AAeF;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,WAAW,EAAE,EAAE,kBAAkB,iBAK7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,QAG1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAiBjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,SAOpC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,QAO7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,QAKpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,QAO9E;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,iBA0E5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACtF,QA4BA"}