@elsikora/commitizen-plugin-commitlint-ai 1.2.0 → 2.0.0-dev.2

package/dist/esm/infrastructure/service/node-command.service.js

@@ -0,0 +1,152 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import chalk from 'chalk';
+
+/**
+ * Implementation of the command service using Node.js child_process.
+ * Provides functionality to execute shell commands.
+ */
+class NodeCommandService {
+    /** CLI interface service for user interaction */
+    CLI_INTERFACE_SERVICE;
+    /**
+     * Promisified version of the exec function from child_process.
+     * Allows for async/await usage of command execution.
+     */
+    EXEC_ASYNC = promisify(exec);
+    /**
+     * @param {ICliInterfaceService} cliInterfaceService - The CLI interface service for user interactions
+     */
+    constructor(cliInterfaceService) {
+        this.CLI_INTERFACE_SERVICE = cliInterfaceService;
+    }
+    /**
+     * Executes a shell command.
+     * @param {string} command - The shell command to execute
+     * @returns {Promise<void>} Promise that resolves when the command completes successfully
+     * @throws Will throw an error if the command execution fails, except for npm install which offers retry options
+     */
+    async execute(command) {
+        try {
+            await this.EXEC_ASYNC(command);
+        }
+        catch (error) {
+            // Check if the failed command is npm
+            if (command.trim().startsWith("npm install") || command.trim().startsWith("npm ci") || command.trim().startsWith("npm update") || command.trim().startsWith("npm uninstall")) {
+                this.formatAndParseNpmError(command, error);
+                await this.handleNpmInstallFailure(command);
+            }
+            else {
+                // For non-npm commands, throw the error as before
+                throw error;
+            }
+        }
+    }
+    /**
+     * Execute a command and return its output
+     * @param {string} command - The command to execute
+     * @returns {Promise<string>} Promise that resolves to the command output
+     */
+    async executeWithOutput(command) {
+        try {
+            const { stdout } = await this.EXEC_ASYNC(command);
+            return stdout.trim();
+        }
+        catch (error) {
+            this.CLI_INTERFACE_SERVICE.handleError(`Failed to execute command: ${command}`, error);
+            throw error;
+        }
+    }
+    /**
+     * Format and parse npm error to readable format
+     * @param {string} command - The original npm command that failed
+     * @param {INodeError} error - Error npm object
+     */
+    formatAndParseNpmError(command, error) {
+        // Форматируем и выводим ошибку
+        console.error(chalk.red.bold("🚨 NPM Command Failed"));
+        console.error(chalk.gray(`Command: ${command}`));
+        console.error(chalk.red("Error Details:"));
+        // Парсим stderr для структурированного вывода
+        if (error.stderr) {
+            const lines = error.stderr.split("\n").filter((line) => line.trim());
+            let errorCode = null;
+            const conflictDetails = [];
+            let resolutionAdvice = null;
+            let logFile = null;
+            for (const line of lines) {
+                if (line.includes("npm error code")) {
+                    errorCode = line.replace("npm error code", "").trim();
+                }
+                else if (line.includes("While resolving") || line.includes("Found") || line.includes("Could not resolve dependency") || line.includes("Conflicting peer dependency")) {
+                    conflictDetails.push(line.replace("npm error", "").trim());
+                }
+                else if (line.includes("Fix the upstream dependency conflict") || line.includes("--force") || line.includes("--legacy-peer-deps")) {
+                    resolutionAdvice = line.replace("npm error", "").trim();
+                }
+                else if (line.includes("A complete log of this run can be found in")) {
+                    logFile = line.replace("npm error", "").trim();
+                }
+            }
+            // Выводим структурированную ошибку
+            if (errorCode) {
+                console.error(chalk.red(`  Code: ${errorCode}`));
+            }
+            if (conflictDetails.length > 0) {
+                console.error(chalk.yellow("  Dependency Conflict:"));
+                for (const detail of conflictDetails)
+                    console.error(chalk.yellow(`    - ${detail}`));
+            }
+            if (resolutionAdvice) {
+                console.error(chalk.cyan("  Resolution:"));
+                console.error(chalk.cyan(`    ${resolutionAdvice}`));
+            }
+            if (logFile) {
+                console.error(chalk.gray(`  Log File: ${logFile}`));
+            }
+        }
+        else {
+            // Если stderr пустой, выводим общую информацию об ошибке
+            console.error(chalk.red("Unknown error occurred"));
+        }
+    }
+    /**
+     * Handles npm install command failures by offering retry options to the user.
+     * @param {string} originalCommand - The original npm command that failed
+     * @returns {Promise<void>} Promise that resolves when the chosen action completes
+     * @throws Will throw an error if the user chooses to cancel or if retried command still fails
+     */
+    async handleNpmInstallFailure(originalCommand) {
+        this.CLI_INTERFACE_SERVICE.warn("npm command exection failed.");
+        const options = [
+            { label: "Retry with --force", value: "force" },
+            { label: "Retry with --legacy-peer-deps", value: "legacy-peer-deps" },
+            { label: "Cancel command execution", value: "cancel" },
+        ];
+        const choice = await this.CLI_INTERFACE_SERVICE.select("How would you like to proceed?", options);
+        switch (choice) {
+            case "force": {
+                this.CLI_INTERFACE_SERVICE.info("Retrying with --force flag...");
+                await this.EXEC_ASYNC(`${originalCommand} --force`);
+                this.CLI_INTERFACE_SERVICE.success("Execution completed with --force flag.");
+                break;
+            }
+            case "legacy-peer-deps": {
+                this.CLI_INTERFACE_SERVICE.info("Retrying with --legacy-peer-deps flag...");
+                await this.EXEC_ASYNC(`${originalCommand} --legacy-peer-deps`);
+                this.CLI_INTERFACE_SERVICE.success("Execution completed with --legacy-peer-deps flag.");
+                break;
+            }
+            case "cancel": {
+                this.CLI_INTERFACE_SERVICE.info("Execution cancelled by user.");
+                throw new Error("npm command execution was cancelled by user.");
+            }
+            default: {
+                throw new Error("Invalid option selected.");
+            }
+        }
+    }
+}
+
+export { NodeCommandService };
+//# sourceMappingURL=node-command.service.js.map

package/dist/esm/infrastructure/service/node-command.service.js.map

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

package/dist/esm/infrastructure/service/node-file-system.service.d.ts

@@ -0,0 +1,62 @@
+import type { IFileSystemService } from '../../application/interface/file-system-service.interface';
+/**
+ * Implementation of the file system service using Node.js fs/promises API.
+ * Provides methods for managing files and directories.
+ */
+export declare class NodeFileSystemService implements IFileSystemService {
+    /**
+     * Creates a directory at the specified path.
+     * @param {string} directoryPath - The path to the directory to create
+     * @param {{ isRecursive: boolean }} options - Optional configuration for directory creation
+     * @param {boolean} options.isRecursive - Whether to create parent directories if they don't exist
+     * @returns {Promise<void>} Promise that resolves when the directory is created
+     */
+    createDirectory(directoryPath: string, options?: {
+        isRecursive: boolean;
+    }): Promise<void>;
+    /**
+     * Deletes a file at the specified path.
+     * @param {string} filePath - The path to the file to delete
+     * @returns {Promise<void>} Promise that resolves when the file is deleted
+     */
+    deleteFile(filePath: string): Promise<void>;
+    /**
+     * Gets the directory name from a file path.
+     * @param {string} filePath - The file path to extract the directory from
+     * @returns {string} The directory name
+     */
+    getDirectoryNameFromFilePath(filePath: string): string;
+    /**
+     * Gets the extension from a file path.
+     * @param {string} filePath - The file path to extract the extension from
+     * @returns {string} The file extension
+     */
+    getExtensionFromFilePath(filePath: string): string;
+    /**
+     * Checks if any of the provided paths exist and returns the first existing path.
+     * @param {Array<string>} paths - Array of paths to check
+     * @returns {Promise<string | undefined>} Promise that resolves to the first existing path or undefined if none exist
+     */
+    isOneOfPathsExists(paths: Array<string>): Promise<string | undefined>;
+    /**
+     * Checks if a file or directory exists at the specified path.
+     * @param {string} filePath - The path to check
+     * @returns {Promise<boolean>} Promise that resolves to true if the path exists, false otherwise
+     */
+    isPathExists(filePath: string): Promise<boolean>;
+    /**
+     * Reads the contents of a file.
+     * @param {string} filePath - The path to the file to read
+     * @param {string} encoding - The encoding to use when reading the file, defaults to "utf8"
+     * @returns {Promise<string>} Promise that resolves to the file contents as a string
+     */
+    readFile(filePath: string, encoding?: BufferEncoding): Promise<string>;
+    /**
+     * Writes content to a file, creating the file and parent directories if they don't exist.
+     * @param {string} filePath - The path to the file to write
+     * @param {string} content - The content to write to the file
+     * @param {string} encoding - The encoding to use when writing the file, defaults to "utf8"
+     * @returns {Promise<void>} Promise that resolves when the file is written
+     */
+    writeFile(filePath: string, content: string, encoding?: BufferEncoding): Promise<void>;
+}

package/dist/esm/infrastructure/service/node-file-system.service.js

@@ -0,0 +1,100 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+/**
+ * Implementation of the file system service using Node.js fs/promises API.
+ * Provides methods for managing files and directories.
+ */
+class NodeFileSystemService {
+    /**
+     * Creates a directory at the specified path.
+     * @param {string} directoryPath - The path to the directory to create
+     * @param {{ isRecursive: boolean }} options - Optional configuration for directory creation
+     * @param {boolean} options.isRecursive - Whether to create parent directories if they don't exist
+     * @returns {Promise<void>} Promise that resolves when the directory is created
+     */
+    async createDirectory(directoryPath, options) {
+        directoryPath = path.dirname(directoryPath);
+        // eslint-disable-next-line @elsikora/typescript/naming-convention
+        await fs.mkdir(directoryPath, { recursive: options?.isRecursive });
+    }
+    /**
+     * Deletes a file at the specified path.
+     * @param {string} filePath - The path to the file to delete
+     * @returns {Promise<void>} Promise that resolves when the file is deleted
+     */
+    async deleteFile(filePath) {
+        await fs.unlink(filePath);
+    }
+    /**
+     * Gets the directory name from a file path.
+     * @param {string} filePath - The file path to extract the directory from
+     * @returns {string} The directory name
+     */
+    getDirectoryNameFromFilePath(filePath) {
+        return path.dirname(filePath);
+    }
+    /**
+     * Gets the extension from a file path.
+     * @param {string} filePath - The file path to extract the extension from
+     * @returns {string} The file extension
+     */
+    getExtensionFromFilePath(filePath) {
+        return path.extname(filePath);
+    }
+    /**
+     * Checks if any of the provided paths exist and returns the first existing path.
+     * @param {Array<string>} paths - Array of paths to check
+     * @returns {Promise<string | undefined>} Promise that resolves to the first existing path or undefined if none exist
+     */
+    async isOneOfPathsExists(paths) {
+        let existingFilePath = undefined;
+        for (const path of paths) {
+            if (await this.isPathExists(path)) {
+                existingFilePath = path;
+                break;
+            }
+        }
+        return existingFilePath;
+    }
+    /**
+     * Checks if a file or directory exists at the specified path.
+     * @param {string} filePath - The path to check
+     * @returns {Promise<boolean>} Promise that resolves to true if the path exists, false otherwise
+     */
+    async isPathExists(filePath) {
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Reads the contents of a file.
+     * @param {string} filePath - The path to the file to read
+     * @param {string} encoding - The encoding to use when reading the file, defaults to "utf8"
+     * @returns {Promise<string>} Promise that resolves to the file contents as a string
+     */
+    // eslint-disable-next-line @elsikora/javascript/no-undef
+    async readFile(filePath, encoding = "utf8") {
+        return await fs.readFile(filePath, { encoding });
+    }
+    /**
+     * Writes content to a file, creating the file and parent directories if they don't exist.
+     * @param {string} filePath - The path to the file to write
+     * @param {string} content - The content to write to the file
+     * @param {string} encoding - The encoding to use when writing the file, defaults to "utf8"
+     * @returns {Promise<void>} Promise that resolves when the file is written
+     */
+    // eslint-disable-next-line @elsikora/javascript/no-undef
+    async writeFile(filePath, content, encoding = "utf8") {
+        // eslint-disable-next-line @elsikora/typescript/naming-convention
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, content, { encoding });
+    }
+}
+
+export { NodeFileSystemService };
+//# sourceMappingURL=node-file-system.service.js.map

package/dist/esm/infrastructure/service/node-file-system.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-file-system.service.js","sources":["../../../../../src/infrastructure/service/node-file-system.service.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAKA;;;AAGG;MACU,qBAAqB,CAAA;AACjC;;;;;;AAMG;AACH,IAAA,MAAM,eAAe,CAAC,aAAqB,EAAE,OAAkC,EAAA;AAC9E,QAAA,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;;AAE3C,QAAA,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;;AAGnE;;;;AAIG;IACH,MAAM,UAAU,CAAC,QAAgB,EAAA;AAChC,QAAA,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;;AAG1B;;;;AAIG;AACH,IAAA,4BAA4B,CAAC,QAAgB,EAAA;AAC5C,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;;AAG9B;;;;AAIG;AACH,IAAA,wBAAwB,CAAC,QAAgB,EAAA;AACxC,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;;AAG9B;;;;AAIG;IACH,MAAM,kBAAkB,CAAC,KAAoB,EAAA;QAC5C,IAAI,gBAAgB,GAAuB,SAAS;AAEpD,QAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;YACzB,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE;gBAClC,gBAAgB,GAAG,IAAI;gBAEvB;;;AAIF,QAAA,OAAO,gBAAgB;;AAGxB;;;;AAIG;IACH,MAAM,YAAY,CAAC,QAAgB,EAAA;AAClC,QAAA,IAAI;AACH,YAAA,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;AAEzB,YAAA,OAAO,IAAI;;AACV,QAAA,MAAM;AACP,YAAA,OAAO,KAAK;;;AAId;;;;;AAKG;;AAEH,IAAA,MAAM,QAAQ,CAAC,QAAgB,EAAE,WAA2B,MAAM,EAAA;QACjE,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC;;AAGjD;;;;;;AAMG;;IAEH,MAAM,SAAS,CAAC,QAAgB,EAAE,OAAe,EAAE,WAA2B,MAAM,EAAA;;AAEnF,QAAA,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC3D,QAAA,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC;;AAEpD;;;;"}

package/dist/esm/infrastructure/service/prompts-cli-interface.service.d.ts

@@ -0,0 +1,117 @@
+import type { ICliInterfaceServiceSelectOptions } from '../../application/interface/cli-interface-service-select-options.interface';
+import type { ICliInterfaceService } from '../../application/interface/cli-interface-service.interface';
+/**
+ * Implementation of the CLI interface service using the prompts library.
+ * Provides methods for interacting with the user through the command line.
+ */
+export declare class PromptsCliInterface implements ICliInterfaceService {
+    /** Reference to the active spinner instance */
+    private spinner;
+    /**
+     * Initializes a new instance of the PromptsCliInterface.
+     * Sets up the spinner for providing visual feedback during operations.
+     */
+    constructor();
+    /**
+     * Clears the console screen.
+     */
+    clear(): void;
+    /**
+     * Displays a confirmation prompt to the user.
+     * @param {string} message - The message to display to the user
+     * @param {boolean} isConfirmedByDefault - The default value for the confirmation, defaults to false
+     * @returns {Promise<boolean>} Promise that resolves to the user's response (true for confirmed, false for declined)
+     */
+    confirm(message: string, isConfirmedByDefault?: boolean): Promise<boolean>;
+    /**
+     * Displays an error message to the user.
+     * @param {string} message - The error message to display
+     */
+    error(message: string): void;
+    /**
+     * Displays a grouped multi-select prompt to the user.
+     * @param {string} message - The message to display to the user
+     * @param {Record<string, Array<ICliInterfaceServiceSelectOptions>>} options - Record of groups and their options
+     * @param {boolean} isRequired - Whether a selection is required, defaults to false
+     * @param {Array<string>} initialValues - Initial selected values
+     * @returns {Promise<Array<T>>} Promise that resolves to an array of selected values
+     * @template T - The type of the selected values
+     */
+    groupMultiselect<T>(message: string, options: Record<string, Array<ICliInterfaceServiceSelectOptions>>, isRequired?: boolean, initialValues?: Array<string>): Promise<Array<T>>;
+    /**
+     * Handles and displays an error message with additional error details.
+     * @param {string} message - The error message to display
+     * @param {unknown} error - The error object or details
+     */
+    handleError(message: string, error: unknown): void;
+    /**
+     * Displays an informational message to the user.
+     * @param {string} message - The info message to display
+     */
+    info(message: string): void;
+    /**
+     * Displays a standard message to the user.
+     * @param {string} message - The message to display
+     */
+    log(message: string): void;
+    /**
+     * Displays a multi-select prompt to the user.
+     * @param {string} message - The message to display to the user
+     * @param {Array<ICliInterfaceServiceSelectOptions>} options - Array of options to select from
+     * @param {boolean} isRequired - Whether a selection is required, defaults to false
+     * @param {Array<string>} initialValues - Initial selected values
+     * @returns {Promise<Array<T>>} Promise that resolves to an array of selected values
+     * @template T - The type of the selected values
+     */
+    multiselect<T>(message: string, options: Array<ICliInterfaceServiceSelectOptions>, isRequired?: boolean, initialValues?: Array<string>): Promise<Array<T>>;
+    /**
+     * Displays a note to the user with a title and message.
+     * @param {string} title - The title of the note
+     * @param {string} message - The message content of the note
+     */
+    note(title: string, message: string): void;
+    /**
+     * Displays a single select prompt to the user.
+     * @param {string} message - The message to display to the user
+     * @param {Array<ICliInterfaceServiceSelectOptions>} options - Array of options to select from
+     * @param {string} initialValue - Initial selected value
+     * @returns {Promise<T>} Promise that resolves to the selected value
+     * @template T - The type of the selected value
+     */
+    select<T>(message: string, options: Array<ICliInterfaceServiceSelectOptions>, initialValue?: string): Promise<T>;
+    /**
+     * Starts a spinner with the specified message.
+     * Stops any existing spinner first.
+     * @param {string} message - The message to display while the spinner is active
+     */
+    startSpinner(message: string): void;
+    /**
+     * Stops the current spinner with an optional completion message.
+     * @param {string} message - Optional message to display when the spinner stops
+     */
+    stopSpinner(message?: string): void;
+    /**
+     * Displays a success message to the user.
+     * @param {string} message - The success message to display
+     */
+    success(message: string): void;
+    /**
+     * Displays a text input prompt to the user.
+     * @param {string} message - The message to display to the user
+     * @param {string} _placeholder - Optional placeholder text for the input field (unused)
+     * @param {string} initialValue - Optional initial value for the input field
+     * @param {(value: string) => Error | string | undefined} validate - Optional validation function for the input
+     * @returns {Promise<string>} Promise that resolves to the user's input text
+     */
+    text(message: string, _placeholder?: string, initialValue?: string, validate?: (value: string) => Error | string | undefined): Promise<string>;
+    /**
+     * Update the spinner message without stopping it.
+     * @param {string} message - The new message to display
+     */
+    updateSpinner(message: string): void;
+    /**
+     * Displays a warning message to the user.
+     * @param {string} message - The warning message to display
+     */
+    warn(message: string): void;
+}