ts-openapi-codegen 2.0.0-beta.9 → 2.1.0-beta.1

package/dist/cli/initOpenApiConfig/utils/buildConfig.js

@@ -31,7 +31,22 @@ async function buildConfig(validatedSpecs, useMultiOption, customRequest, perSpe
             useOptions: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useOptions,
             useSeparatedIndexes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useSeparatedIndexes,
             useUnionTypes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useUnionTypes,
+            modelsMode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+            diffReport: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
             ...(!perSpecRequest && customRequest ? { request: customRequest } : {}),
+            models: {
+                mode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            },
+            analyze: {
+                useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+                reportPath: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
+            },
+            miracles: {
+                enabled: true,
+                confidence: 1,
+                types: ['RENAME', 'TYPE_COERCION'],
+            },
         };
     }
     else {
@@ -53,7 +68,22 @@ async function buildConfig(validatedSpecs, useMultiOption, customRequest, perSpe
             useOptions: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useOptions,
             useSeparatedIndexes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useSeparatedIndexes,
             useUnionTypes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useUnionTypes,
+            modelsMode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+            diffReport: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
             ...(customRequest ? { request: customRequest } : {}),
+            models: {
+                mode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            },
+            analyze: {
+                useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+                reportPath: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
+            },
+            miracles: {
+                enabled: true,
+                confidence: 1,
+                types: ['RENAME', 'TYPE_COERCION'],
+            },
         };
     }
 }
@@ -84,7 +114,22 @@ function buildExampleConfig(useMultiOption, customRequest, perSpecRequest) {
             useOptions: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useOptions,
             useSeparatedIndexes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useSeparatedIndexes,
             useUnionTypes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useUnionTypes,
+            modelsMode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+            diffReport: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
             ...(!perSpecRequest && customRequest ? { request: customRequest } : {}),
+            models: {
+                mode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            },
+            analyze: {
+                useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+                reportPath: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
+            },
+            miracles: {
+                enabled: true,
+                confidence: 1,
+                types: ['RENAME', 'TYPE_COERCION'],
+            },
         };
     }
     else {
@@ -101,7 +146,22 @@ function buildExampleConfig(useMultiOption, customRequest, perSpecRequest) {
             useOptions: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useOptions,
             useSeparatedIndexes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useSeparatedIndexes,
             useUnionTypes: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useUnionTypes,
+            modelsMode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+            diffReport: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
             ...(customRequest ? { request: customRequest } : {}),
+            models: {
+                mode: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode,
+            },
+            analyze: {
+                useHistory: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory,
+                reportPath: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport,
+            },
+            miracles: {
+                enabled: true,
+                confidence: 1,
+                types: ['RENAME', 'TYPE_COERCION'],
+            },
         };
     }
 }

package/dist/cli/initOpenApiConfig/utils/validateSpecFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateSpecFile.d.ts","sourceRoot":"","sources":["../../../../src/cli/initOpenApiConfig/utils/validateSpecFile.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzE"}
+{"version":3,"file":"validateSpecFile.d.ts","sourceRoot":"","sources":["../../../../src/cli/initOpenApiConfig/utils/validateSpecFile.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzE"}

package/dist/cli/initOpenApiConfig/utils/validateSpecFile.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateSpecFile = validateSpecFile;
 const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
 const Consts_1 = require("../../../common/Consts");
+const LoggerMessages_1 = require("../../../common/LoggerMessages");
 /**
  * Валидирует файл спецификации через SwaggerParser
  * @param filePath - Путь к файлу спецификации
@@ -17,7 +18,7 @@ async function validateSpecFile(filePath) {
         return true;
     }
     catch {
-        Consts_1.APP_LOGGER.warn(`Skipping invalid spec file: ${filePath}`);
+        Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.SPEC_VALIDATION.SKIP_INVALID_FILE(filePath));
         return false;
     }
 }

package/dist/cli/initOpenApiConfig/utils/writeConfigFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeConfigFile.d.ts","sourceRoot":"","sources":["../../../../src/cli/initOpenApiConfig/utils/writeConfigFile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAerH"}
+{"version":3,"file":"writeConfigFile.d.ts","sourceRoot":"","sources":["../../../../src/cli/initOpenApiConfig/utils/writeConfigFile.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI1D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAerH"}

package/dist/cli/initOpenApiConfig/utils/writeConfigFile.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.writeConfigFile = writeConfigFile;
 const path_1 = __importDefault(require("path"));
 const Consts_1 = require("../../../common/Consts");
+const LoggerMessages_1 = require("../../../common/LoggerMessages");
 const fileSystemHelpers_1 = require("../../../common/utils/fileSystemHelpers");
 const format_1 = require("../../../common/utils/format");
 const pathHelpers_1 = require("../../../common/utils/pathHelpers");
@@ -27,5 +28,5 @@ async function writeConfigFile(configPath, config, templates) {
     const templateResult = templates.config(config);
     const formattedValue = await (0, format_1.format)(templateResult, 'json');
     await fileSystemHelpers_1.fileSystemHelpers.writeFile(resolvedPath, formattedValue);
-    Consts_1.APP_LOGGER.info(`Configuration file created: ${resolvedPath}`);
+    Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.CONFIG_CREATED(resolvedPath));
 }

package/dist/cli/interactive/confirmDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"confirmDialog.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/confirmDialog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAerF"}
+{"version":3,"file":"confirmDialog.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/confirmDialog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrF"}

package/dist/cli/interactive/confirmDialog.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.confirmDialog = confirmDialog;
 const enquirer_1 = require("enquirer");
 const Consts_1 = require("../../common/Consts");
-const constants_1 = require("./constants");
+const LoggerMessages_1 = require("../../common/LoggerMessages");
 /**
  * Отображает диалог подтверждения для пользователя.
  * Используется для критичных действий (удаление, публикация и т.д.)
@@ -30,7 +30,8 @@ async function confirmDialog(options) {
     }
     catch {
         // Пользователь прервал процесс (Ctrl+C)
-        Consts_1.APP_LOGGER.error(`\n${constants_1.DIALOG_MESSAGES.OPERATION_CANCELLED}`);
+        Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.DIALOG.OPERATION_CANCELLED);
+        await Consts_1.APP_LOGGER.shutdownLoggerAsync();
         process.exit(0);
     }
 }

package/dist/cli/interactive/constants.d.ts

@@ -1,7 +1,7 @@
 import { EConfigType, EnquirerSelectChoice } from './types';
 export declare const OPEN_API_CONFIG_SELECT_OPTIONS: EnquirerSelectChoice<EConfigType>[];
 export declare const DIALOG_MESSAGES: {
-    readonly OPERATION_CANCELLED: "Операция отменена пользователем.";
-    readonly SELECTION_CANCELLED: "Выбор отменён.";
+    readonly OPERATION_CANCELLED: "The operation was canceled by the user.";
+    readonly SELECTION_CANCELLED: "The choice is canceled.";
 };
 //# sourceMappingURL=constants.d.ts.map

package/dist/cli/interactive/constants.js

@@ -4,22 +4,22 @@ exports.DIALOG_MESSAGES = exports.OPEN_API_CONFIG_SELECT_OPTIONS = void 0;
 const types_1 = require("./types");
 exports.OPEN_API_CONFIG_SELECT_OPTIONS = [
     {
-        name: 'Набор опций',
+        name: 'Single options',
         value: types_1.EConfigType.FLAT,
-        hint: 'Набор параметров для генерации по одной спецификации.',
+        hint: 'A set of parameters to generate according to a single specification.',
     },
     {
-        name: 'Множественные опции',
+        name: 'Multiple options',
         value: types_1.EConfigType.MULTI,
-        hint: 'Набор параметров для генерации по нескольким файлам спецификаций.',
+        hint: 'A set of parameters for generating multiple specification files.',
     },
     {
-        name: 'Не генерировать',
+        name: 'Do not generate',
         value: types_1.EConfigType.NONE,
-        hint: 'Не создавать файл конфигурации',
+        hint: 'Do not create a configuration file',
     },
 ];
 exports.DIALOG_MESSAGES = {
-    OPERATION_CANCELLED: 'Операция отменена пользователем.',
-    SELECTION_CANCELLED: 'Выбор отменён.',
+    OPERATION_CANCELLED: 'The operation was canceled by the user.',
+    SELECTION_CANCELLED: 'The choice is canceled.',
 };

package/dist/cli/interactive/selectDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selectDialog.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/selectDialog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAsB5F"}
+{"version":3,"file":"selectDialog.d.ts","sourceRoot":"","sources":["../../../src/cli/interactive/selectDialog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA2B5F"}

package/dist/cli/interactive/selectDialog.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.selectDialog = selectDialog;
 const enquirer_1 = require("enquirer");
 const Consts_1 = require("../../common/Consts");
-const constants_1 = require("./constants");
+const LoggerMessages_1 = require("../../common/LoggerMessages");
 /**
  * Отображает диалог выбора одного варианта из списка.
  *
@@ -24,20 +24,25 @@ async function selectDialog(options) {
             type: 'select',
             name: 'choice',
             message: options.message,
-            choices: options.choices.map(choice => ({
-                name: choice.name,
+            choices: options.choices.map((choice, index) => ({
+                // Enquirer возвращает `name` выбранного пункта.
+                // Храним в `name` технический id, а в `message` - текст для пользователя.
+                name: String(index),
+                message: choice.name,
                 value: choice.value,
                 hint: choice.hint,
             })),
             initial: options.initial,
-            result(value) {
-                return value.value;
+            result(selectedName) {
+                const selectedChoice = this.choices.find((choice) => choice.name === selectedName);
+                return selectedChoice?.value;
             },
         });
         return response.choice;
     }
     catch {
-        Consts_1.APP_LOGGER.error(`\n${constants_1.DIALOG_MESSAGES.SELECTION_CANCELLED}`);
+        Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.DIALOG.SELECTION_CANCELLED);
+        await Consts_1.APP_LOGGER.shutdownLoggerAsync();
         process.exit(0);
     }
 }

package/dist/cli/previewChanges/previewChanges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"previewChanges.d.ts","sourceRoot":"","sources":["../../../src/cli/previewChanges/previewChanges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA4BzC;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiJzE"}
+{"version":3,"file":"previewChanges.d.ts","sourceRoot":"","sources":["../../../src/cli/previewChanges/previewChanges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAoHzC;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoNzE"}

package/dist/cli/previewChanges/previewChanges.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.previewChanges = previewChanges;
 const Consts_1 = require("../../common/Consts");
 const Enums_1 = require("../../common/Enums");
+const LoggerMessages_1 = require("../../common/LoggerMessages");
 const convertArrayToObject_1 = require("../../common/utils/convertArrayToObject");
 const fileSystemHelpers_1 = require("../../common/utils/fileSystemHelpers");
 const loadConfigIfExists_1 = require("../../common/utils/loadConfigIfExists");
@@ -51,37 +52,116 @@ const formatDiff_1 = require("./utils/formatDiff");
 const isDirectoryEmpty_1 = require("./utils/isDirectoryEmpty");
 const readDirectoryRecursive_1 = require("./utils/readDirectoryRecursive");
 const updateOutputPaths_1 = require("./utils/updateOutputPaths");
+function buildSummary(changes) {
+    const added = [];
+    const removed = [];
+    const modified = [];
+    for (const change of changes) {
+        if (change.status === 'added') {
+            added.push(change.file);
+            continue;
+        }
+        if (change.status === 'removed') {
+            removed.push(change.file);
+            continue;
+        }
+        modified.push(change.file);
+    }
+    added.sort();
+    removed.sort();
+    modified.sort();
+    return {
+        added,
+        removed,
+        modified,
+        total: changes.length,
+    };
+}
+function toFileLink(filePath) {
+    return `./${filePath}.md`;
+}
+function toCategoryMarkdown(title, files) {
+    const lines = [`# ${title}`, ''];
+    if (files.length === 0) {
+        lines.push('_No files_', '');
+        return lines.join('\n');
+    }
+    for (const file of files) {
+        lines.push(`- [${file}](${toFileLink(file)})`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function toSummaryMarkdown(summary) {
+    return [
+        '# Preview Changes Summary',
+        '',
+        `Total changes: ${summary.total}`,
+        `Added files: ${summary.added.length}`,
+        `Removed files: ${summary.removed.length}`,
+        `Modified files: ${summary.modified.length}`,
+        '',
+        '## Reports',
+        '- [Added files](./added-files.md)',
+        '- [Removed files](./removed-files.md)',
+        '- [Modified files](./modified-files.md)',
+        '',
+        '## Added',
+        ...summary.added.map(file => `- [${file}](${toFileLink(file)})`),
+        '',
+        '## Removed',
+        ...summary.removed.map(file => `- [${file}](${toFileLink(file)})`),
+        '',
+        '## Modified',
+        ...summary.modified.map(file => `- [${file}](${toFileLink(file)})`),
+        '',
+    ].join('\n');
+}
 /**
  * Основная функция для предпросмотра изменений
  *
  * TODO: Добавить проверку опций команды перед выполнением
  */
 async function previewChanges(options) {
-    const validationResult = (0, validateZodOptions_1.validateZodOptions)(schemas_1.previewChangesSchema, options);
-    if (!validationResult.success) {
-        Consts_1.APP_LOGGER.error(validationResult.errors.join('\n'));
-        process.exit(1);
-    }
-    const { openapiConfig, generatedDir, previewDir, diffDir } = validationResult.data;
-    const resolvedGeneratedDir = (0, pathHelpers_1.resolveHelper)(process.cwd(), generatedDir || '');
-    const resolvedPreviewDir = (0, pathHelpers_1.resolveHelper)(process.cwd(), previewDir || '');
-    const resolvedDiffDir = (0, pathHelpers_1.resolveHelper)(process.cwd(), diffDir || '');
+    let exitCode = 0;
+    let resolvedPreviewDir = '';
     let previewDirCreated = false;
     try {
+        const validationResult = (0, validateZodOptions_1.validateZodOptions)(schemas_1.previewChangesSchema, options);
+        if (!validationResult.success) {
+            Consts_1.APP_LOGGER.errorWithHint({
+                code: 'NO_OPTIONS_PROVIDED',
+                message: LoggerMessages_1.LOGGER_MESSAGES.ERROR.GENERIC(validationResult.errors.join('\n')),
+            });
+            await Consts_1.APP_LOGGER.shutdownLoggerAsync();
+            process.exit(1);
+        }
+        const { openapiConfig, generatedDir, previewDir, diffDir } = validationResult.data;
+        const resolvedGeneratedDir = (0, pathHelpers_1.resolveHelper)(process.cwd(), generatedDir || '');
+        resolvedPreviewDir = (0, pathHelpers_1.resolveHelper)(process.cwd(), previewDir || '');
+        const resolvedDiffDir = (0, pathHelpers_1.resolveHelper)(process.cwd(), diffDir || '');
         // 1. Проверка директории со сгенерированным кодом
         if (await (0, isDirectoryEmpty_1.isDirectoryEmpty)(resolvedGeneratedDir)) {
-            Consts_1.APP_LOGGER.info(`Directory "${generatedDir}" is empty or does not exist. Nothing to compare.`);
-            process.exit(0);
+            Consts_1.APP_LOGGER.errorWithHint({
+                code: 'PREVIEW_DIR_EMPTY',
+                message: LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.GENERATED_DIR_EMPTY(generatedDir || ''),
+            });
+            await Consts_1.APP_LOGGER.shutdownLoggerAsync();
+            process.exit(1);
         }
-        // 2. Создание временной директории для preview
-        await fileSystemHelpers_1.fileSystemHelpers.mkdir(resolvedPreviewDir);
-        previewDirCreated = true;
-        // 3. Загрузка конфигурации
+        // 2. Загрузка конфигурации
         const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(openapiConfig);
         if (!configData) {
-            Consts_1.APP_LOGGER.error('The configuration file is missing');
+            Consts_1.APP_LOGGER.errorWithHint({
+                code: openapiConfig ? 'CONFIG_FILE_NOT_FOUND_AT' : 'CONFIG_FILE_MISSING',
+                message: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_MISSING,
+            });
+            await Consts_1.APP_LOGGER.shutdownLoggerAsync();
             process.exit(1);
         }
+        if (Array.isArray(configData)) {
+            Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.ARRAY_DEPRECATED);
+        }
         const preparedOptions = (0, convertArrayToObject_1.convertArrayToObject)(configData);
         // Миграция опций
         const migratedOptions = (0, migrateDataToLatestSchemaVersion_1.migrateDataToLatestSchemaVersion)({
@@ -91,26 +171,36 @@ async function previewChanges(options) {
             migrationMode: Enums_1.EMigrationMode.GENERATE_OPENAPI,
         });
         if (!migratedOptions) {
-            Consts_1.APP_LOGGER.error("Couldn't convert the set of options to the current version");
+            Consts_1.APP_LOGGER.errorWithHint({
+                code: 'NO_VALID_SPEC_FILES_FOUND',
+                message: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.CONVERSION_FAILED,
+            });
+            await Consts_1.APP_LOGGER.shutdownLoggerAsync();
             process.exit(1);
         }
+        // 3. Подготовка и создание временной директории preview
+        await fileSystemHelpers_1.fileSystemHelpers.rmdir(resolvedPreviewDir);
+        await fileSystemHelpers_1.fileSystemHelpers.mkdir(resolvedPreviewDir);
+        previewDirCreated = true;
         // 4. Обновление путей output для генерации в preview директорию
         const migratedValue = migratedOptions.value;
         const previewOptions = (0, updateOutputPaths_1.updateOutputPaths)(migratedValue, previewDir || '', generatedDir || '');
         // 5. Генерация кода в preview директорию
-        Consts_1.APP_LOGGER.info(`Generating code to preview directory: ${previewDir}`);
+        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.GENERATING_PREVIEW(previewDir || ''));
         await OpenAPI.generate(previewOptions);
         // 6. Сравнение файлов
-        Consts_1.APP_LOGGER.info('Comparing files...');
+        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.COMPARING_FILES);
         const oldFiles = await (0, readDirectoryRecursive_1.readDirectoryRecursive)(resolvedGeneratedDir);
         const newFiles = await (0, readDirectoryRecursive_1.readDirectoryRecursive)(resolvedPreviewDir);
-        const allFiles = new Set([...oldFiles, ...newFiles]);
+        const oldFileSet = new Set(oldFiles);
+        const newFileSet = new Set(newFiles);
+        const allFiles = new Set([...oldFileSet, ...newFileSet]);
         const changes = [];
-        for (const file of allFiles) {
+        for (const file of [...allFiles].sort()) {
             const oldPath = (0, pathHelpers_1.joinHelper)(resolvedGeneratedDir, file);
             const newPath = (0, pathHelpers_1.joinHelper)(resolvedPreviewDir, file);
-            const oldExists = await fileSystemHelpers_1.fileSystemHelpers.exists(oldPath);
-            const newExists = await fileSystemHelpers_1.fileSystemHelpers.exists(newPath);
+            const oldExists = oldFileSet.has(file);
+            const newExists = newFileSet.has(file);
             if (oldExists && newExists) {
                 // Файл существует в обеих директориях - сравниваем
                 const fileDiff = await (0, compareFiles_1.compareFiles)(oldPath, newPath);
@@ -122,7 +212,7 @@ async function previewChanges(options) {
                     });
                 }
                 else {
-                    Consts_1.APP_LOGGER.info(`File "${file}" has no changes`);
+                    Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.FILE_NO_CHANGES(file));
                 }
             }
             else if (!oldExists && newExists) {
@@ -142,6 +232,7 @@ async function previewChanges(options) {
         }
         // 7. Сохранение результатов в diff директорию
         if (changes.length > 0) {
+            await fileSystemHelpers_1.fileSystemHelpers.rmdir(resolvedDiffDir);
             await fileSystemHelpers_1.fileSystemHelpers.mkdir(resolvedDiffDir);
             for (const change of changes) {
                 const diffFilePath = (0, pathHelpers_1.joinHelper)(resolvedDiffDir, `${change.file}.md`);
@@ -158,32 +249,53 @@ async function previewChanges(options) {
                     diffContent = (0, formatDiff_1.formatDiff)(change.file, change.status, change.diff);
                 }
                 await fileSystemHelpers_1.fileSystemHelpers.writeFile(diffFilePath, diffContent, 'utf-8');
-                Consts_1.APP_LOGGER.info(`Diff saved: ${diffFilePath}`);
+                Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.DIFF_SAVED(diffFilePath));
             }
-            Consts_1.APP_LOGGER.info(`\nTotal changes: ${changes.length}`);
-            Consts_1.APP_LOGGER.info(`Diff files saved to: ${diffDir}`);
+            const summary = buildSummary(changes);
+            await fileSystemHelpers_1.fileSystemHelpers.writeFile((0, pathHelpers_1.joinHelper)(resolvedDiffDir, 'added-files.md'), toCategoryMarkdown('Added Files', summary.added), 'utf-8');
+            await fileSystemHelpers_1.fileSystemHelpers.writeFile((0, pathHelpers_1.joinHelper)(resolvedDiffDir, 'removed-files.md'), toCategoryMarkdown('Removed Files', summary.removed), 'utf-8');
+            await fileSystemHelpers_1.fileSystemHelpers.writeFile((0, pathHelpers_1.joinHelper)(resolvedDiffDir, 'modified-files.md'), toCategoryMarkdown('Modified Files', summary.modified), 'utf-8');
+            await fileSystemHelpers_1.fileSystemHelpers.writeFile((0, pathHelpers_1.joinHelper)(resolvedDiffDir, 'summary.json'), JSON.stringify(summary, null, 2), 'utf-8');
+            await fileSystemHelpers_1.fileSystemHelpers.writeFile((0, pathHelpers_1.joinHelper)(resolvedDiffDir, 'summary.md'), toSummaryMarkdown(summary), 'utf-8');
+            Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.TOTAL_CHANGES(changes.length));
+            Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.DIFF_FILES_SAVED_TO(diffDir || ''));
         }
         else {
-            Consts_1.APP_LOGGER.info('No changes detected. All files are identical.');
+            await fileSystemHelpers_1.fileSystemHelpers.rmdir(resolvedDiffDir);
+            Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.NO_CHANGES_DETECTED);
         }
-        // 8. Удаление временной директории preview
-        Consts_1.APP_LOGGER.info(`Cleaning up preview directory: ${previewDir}`);
-        await fileSystemHelpers_1.fileSystemHelpers.rmdir(resolvedPreviewDir);
-        previewDirCreated = false;
-        process.exit(0);
     }
     catch (error) {
-        // Очистка preview директории в случае ошибки
-        if (previewDirCreated) {
+        exitCode = 1;
+        const message = error instanceof Error ? error.message : String(error);
+        Consts_1.APP_LOGGER.errorWithHint({
+            code: 'SPEC_FILES_FIND_ERROR',
+            message: LoggerMessages_1.LOGGER_MESSAGES.ERROR.GENERIC(message),
+            error,
+        });
+    }
+    finally {
+        if (previewDirCreated || resolvedPreviewDir) {
             try {
-                Consts_1.APP_LOGGER.info(`Cleaning up preview directory after error: ${previewDir}`);
-                await fileSystemHelpers_1.fileSystemHelpers.rmdir(resolvedPreviewDir);
+                if (resolvedPreviewDir) {
+                    Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.CLEANUP_PREVIEW_DIR(resolvedPreviewDir));
+                    await fileSystemHelpers_1.fileSystemHelpers.rmdir(resolvedPreviewDir);
+                }
             }
             catch (cleanupError) {
-                Consts_1.APP_LOGGER.error(`Failed to cleanup preview directory: ${cleanupError.message}`);
+                const msg = cleanupError instanceof Error ? cleanupError.message : String(cleanupError);
+                Consts_1.APP_LOGGER.errorWithHint({
+                    code: 'PREVIEW_CLEANUP_FAILED',
+                    message: LoggerMessages_1.LOGGER_MESSAGES.PREVIEW.CLEANUP_PREVIEW_FAILED(msg),
+                    error: cleanupError,
+                });
+                exitCode = 1;
             }
         }
-        Consts_1.APP_LOGGER.error(error.message);
+    }
+    await Consts_1.APP_LOGGER.shutdownLoggerAsync();
+    if (exitCode !== 0) {
         process.exit(1);
     }
+    process.exit(0);
 }

package/dist/cli/previewChanges/utils/updateOutputPaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateOutputPaths.d.ts","sourceRoot":"","sources":["../../../../src/cli/previewChanges/utils/updateOutputPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACrB,WAAW,CAuIb"}
+{"version":3,"file":"updateOutputPaths.d.ts","sourceRoot":"","sources":["../../../../src/cli/previewChanges/utils/updateOutputPaths.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACrB,WAAW,CA6Ib"}

package/dist/cli/previewChanges/utils/updateOutputPaths.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.updateOutputPaths = updateOutputPaths;
+const path_1 = require("path");
 const pathHelpers_1 = require("../../../common/utils/pathHelpers");
 /**
  * Обновляет пути output в опциях для генерации в preview директорию
@@ -23,6 +24,11 @@ function updateOutputPaths(options, previewDir, generatedDir) {
         if (relativePath.startsWith('./')) {
             relativePath = relativePath.substring(2);
         }
+        // Если путь выходит за пределы generatedDir, используем basename для безопасного переноса
+        if (relativePath.startsWith('../')) {
+            const outputBaseName = (0, path_1.basename)(resolvedOldPath);
+            return (0, pathHelpers_1.joinHelper)(previewDir, outputBaseName);
+        }
         // Если путь пустой или равен текущей директории, возвращаем previewDir
         if (!relativePath || relativePath === '' || relativePath === './') {
             return previewDir;

package/dist/cli/schemas/analyzeDiff.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const analyzeDiffOptionsSchema: z.ZodObject<{
+    input: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    compareWith: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    git: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    outputReport: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>>;
+    governanceConfig: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    strictPluginMode: z.ZodOptional<z.ZodBoolean>;
+    ci: z.ZodOptional<z.ZodBoolean>;
+    allowBreaking: z.ZodOptional<z.ZodBoolean>;
+    openapiConfig: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type AnalyzeDiffOptions = z.infer<typeof analyzeDiffOptionsSchema>;
+//# sourceMappingURL=analyzeDiff.d.ts.map

package/dist/cli/schemas/analyzeDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeDiff.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/analyzeDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAsB/B,CAAC;AAEP,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/cli/schemas/analyzeDiff.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeDiffOptionsSchema = void 0;
+const zod_1 = require("zod");
+const Consts_1 = require("../../common/Consts");
+const base_1 = require("./base");
+exports.analyzeDiffOptionsSchema = zod_1.z
+    .object({
+    ...base_1.baseCLIOptionsSchema.shape,
+    input: base_1.emptyStringToUndefined,
+    compareWith: base_1.emptyStringToUndefined,
+    git: base_1.emptyStringToUndefined,
+    outputReport: base_1.emptyStringToUndefined.default(Consts_1.DEFAULT_ANALYZE_DIFF_REPORT_PATH),
+    governanceConfig: base_1.emptyStringToUndefined,
+    strictPluginMode: zod_1.z.boolean().optional(),
+    ci: zod_1.z.boolean().optional(),
+    allowBreaking: zod_1.z.boolean().optional(),
+})
+    .superRefine((data, ctx) => {
+    if (!data.input) {
+        ctx.addIssue({
+            code: 'custom',
+            message: '"--input" is required for analyze-diff command',
+            path: ['input'],
+        });
+    }
+    // Old spec source is resolved as compareWith ?? git at runtime.
+});

package/dist/cli/schemas/generate.d.ts

@@ -1,7 +1,16 @@
 import { z } from 'zod';
+import { ModelsMode } from '../../core/types/enums/ModelsMode.enum';
 export declare const generateOptionsSchema: z.ZodObject<{
     input: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
     output: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    useHistory: z.ZodOptional<z.ZodBoolean>;
+    diffReport: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    modelsMode: z.ZodOptional<z.ZodEnum<typeof ModelsMode>>;
+    strictOpenapi: z.ZodOptional<z.ZodBoolean>;
+    reportFile: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    useProjectPrettier: z.ZodOptional<z.ZodBoolean>;
+    useEslintFix: z.ZodOptional<z.ZodBoolean>;
+    governanceConfig: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
     openapiConfig: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 export type GenerateOptions = z.infer<typeof generateOptionsSchema>;

package/dist/cli/schemas/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,qBAAqB;;;;iBA2C5B,CAAC;AAEP,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAGpE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAmD5B,CAAC;AAEP,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}