ts-openapi-codegen 2.0.0-beta.2 → 2.0.0-beta.3

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

@@ -1 +1 @@
-{"version":3,"file":"runGenerateOpenApi.d.ts","sourceRoot":"","sources":["../../../src/cli/generate/runGenerateOpenApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAYzC;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC7E"}
+{"version":3,"file":"runGenerateOpenApi.d.ts","sourceRoot":"","sources":["../../../src/cli/generate/runGenerateOpenApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAgBzC;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D7E"}

package/dist/cli/generate/runGenerateOpenApi.js

@@ -37,12 +37,15 @@ exports.runGenerateOpenApi = runGenerateOpenApi;
 const Consts_1 = require("../../common/Consts");
 const defaultOptions_1 = require("../../common/defaultOptions");
 const Enums_1 = require("../../common/Enums");
+const LoggerMessages_1 = require("../../common/LoggerMessages");
 const convertArrayToObject_1 = require("../../common/utils/convertArrayToObject");
 const loadConfigIfExists_1 = require("../../common/utils/loadConfigIfExists");
 const AllMigrationPlans_1 = require("../../common/VersionedSchema/AllVersionedSchemas/AllMigrationPlans");
 const AllVersionedSchemas_1 = require("../../common/VersionedSchema/AllVersionedSchemas/AllVersionedSchemas");
 const migrateDataToLatestSchemaVersion_1 = require("../../common/VersionedSchema/Utils/migrateDataToLatestSchemaVersion");
 const OpenAPI = __importStar(require("../../core"));
+const generate_1 = require("../schemas/generate");
+const validation_1 = require("../validation");
 /**
  * Запускает генерацию OpenAPI клиента
  * Поддерживает как конфиг-файл, так и параметры из CLI
@@ -50,17 +53,35 @@ const OpenAPI = __importStar(require("../../core"));
 async function runGenerateOpenApi(options) {
     const { openapiConfig, ...clientOptions } = options;
     try {
-        const hasMinimumRequiredOptions = !!clientOptions.input && !!clientOptions.output;
+        // Валидация опций через Zod
+        const validationResult = (0, validation_1.validateCLIOptions)(generate_1.generateOptionsSchema, {
+            openapiConfig,
+            ...clientOptions,
+        });
+        if (!validationResult.success) {
+            Consts_1.APP_LOGGER.error(validationResult.error);
+            process.exit(1);
+        }
+        const validatedOptions = validationResult.data;
+        // Если есть минимальные опции (input и output), используем их
+        const hasMinimumRequiredOptions = !!validatedOptions.input && !!validatedOptions.output;
         if (hasMinimumRequiredOptions) {
-            const { error: defaultValuesError, value } = defaultOptions_1.defaultOptions.validate(clientOptions);
+            // Используем старую Joi валидацию для обратной совместимости
+            // В будущем можно заменить на Zod
+            const { error: defaultValuesError, value } = defaultOptions_1.defaultOptions.validate({
+                input: validatedOptions.input,
+                output: validatedOptions.output,
+                ...clientOptions,
+            });
             if (defaultValuesError) {
                 await OpenAPI.generate(value);
                 process.exit(0);
             }
         }
-        const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(openapiConfig);
+        const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(validatedOptions.openapiConfig);
         if (!configData) {
-            Consts_1.APP_LOGGER.error('The configuration file is missing');
+            Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_MISSING);
+            process.exit(1);
         }
         const preparedOptions = (0, convertArrayToObject_1.convertArrayToObject)(configData);
         // Use unified migration system for all schema types
@@ -71,15 +92,15 @@ async function runGenerateOpenApi(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");
-        }
-        else {
-            const { value } = migratedOptions;
-            await OpenAPI.generate(value);
+            Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.CONVERSION_FAILED);
+            process.exit(1);
         }
+        const { value } = migratedOptions;
+        await OpenAPI.generate(value);
         process.exit(0);
     }
     catch (error) {
         Consts_1.APP_LOGGER.error(error.message);
+        process.exit(1);
     }
 }

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

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { ELogLevel, ELogOutput } from '../../common/Enums';
+import { HttpClient } from '../../core/types/enums/HttpClient.enum';
+/**
+ * Базовая схема с общими опциями для всех команд
+ */
+export declare const baseCLIOptionsSchema: z.ZodObject<{
+    openapiConfig: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type BaseCLIOptions = z.infer<typeof baseCLIOptionsSchema>;
+/**
+ * Enum схемы для типизированных значений
+ */
+export declare const httpClientSchema: z.ZodEnum<typeof HttpClient>;
+export declare const logLevelSchema: z.ZodEnum<typeof ELogLevel>;
+export declare const logTargetSchema: z.ZodEnum<typeof ELogOutput>;
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;iBAE/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,gBAAgB,8BAA2B,CAAC;AACzD,eAAO,MAAM,cAAc,6BAA0B,CAAC;AACtD,eAAO,MAAM,eAAe,8BAA2B,CAAC"}

package/dist/cli/schemas/base.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logTargetSchema = exports.logLevelSchema = exports.httpClientSchema = exports.baseCLIOptionsSchema = void 0;
+const zod_1 = require("zod");
+const Consts_1 = require("../../common/Consts");
+const Enums_1 = require("../../common/Enums");
+const HttpClient_enum_1 = require("../../core/types/enums/HttpClient.enum");
+/**
+ * Базовая схема с общими опциями для всех команд
+ */
+exports.baseCLIOptionsSchema = zod_1.z.object({
+    openapiConfig: zod_1.z.string().optional().default(Consts_1.DEFAULT_OPENAPI_CONFIG_FILENAME),
+});
+/**
+ * Enum схемы для типизированных значений
+ */
+exports.httpClientSchema = zod_1.z.nativeEnum(HttpClient_enum_1.HttpClient);
+exports.logLevelSchema = zod_1.z.nativeEnum(Enums_1.ELogLevel);
+exports.logTargetSchema = zod_1.z.nativeEnum(Enums_1.ELogOutput);

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

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const checkConfigOptionsSchema: z.ZodObject<{
+    openapiConfig: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type CheckConfigOptions = z.infer<typeof checkConfigOptionsSchema>;
+//# sourceMappingURL=checkConfig.d.ts.map

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

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

package/dist/cli/schemas/checkConfig.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkConfigOptionsSchema = void 0;
+const base_1 = require("./base");
+exports.checkConfigOptionsSchema = base_1.baseCLIOptionsSchema;

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

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/**
+ * Схема для команды generate
+ * Основана на baseFlatOptionsSchema, но с добавлением:
+ * - openapiConfig (из baseCLIOptionsSchema)
+ * - опциональными input/output (валидируются условно)
+ */
+export declare const generateOptionsSchema: z.ZodObject<{
+    openapiConfig: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    outputCore: z.ZodOptional<z.ZodString>;
+    outputServices: z.ZodOptional<z.ZodString>;
+    outputModels: z.ZodOptional<z.ZodString>;
+    outputSchemas: z.ZodOptional<z.ZodString>;
+    interfacePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    enumPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    typePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    httpClient: z.ZodOptional<z.ZodEnum<typeof import("../..").HttpClient>>;
+    useOptions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useUnionTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    excludeCoreServiceFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    request: z.ZodOptional<z.ZodString>;
+    useCancelableRequest: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    logLevel: z.ZodOptional<z.ZodEnum<typeof import("../../common/Enums").ELogLevel>>;
+    logTarget: z.ZodOptional<z.ZodEnum<typeof import("../../common/Enums").ELogOutput>>;
+    sortByRequired: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useSeparatedIndexes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    validationLibrary: z.ZodOptional<z.ZodEnum<typeof import("../../core/types/enums/ValidationLibrary.enum").ValidationLibrary>>;
+    input: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+    output: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type GenerateOptions = z.infer<typeof generateOptionsSchema>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgBxB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;iBAwC5B,CAAC;AAEP,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/cli/schemas/generate.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateOptionsSchema = void 0;
+const zod_1 = require("zod");
+const Consts_1 = require("../../common/Consts");
+const configSchemas_1 = require("../../common/schemas/configSchemas");
+const loadConfigIfExists_1 = require("../../common/utils/loadConfigIfExists");
+const base_1 = require("./base");
+/**
+ * Преобразует пустые строки в undefined для опциональных полей
+ * Это нужно, потому что Commander.js передает пустые строки для опций без значений
+ */
+const emptyStringToUndefined = zod_1.z.preprocess((val) => (val === '' ? undefined : val), zod_1.z.string().min(1).optional());
+/**
+ * Схема для команды generate
+ * Основана на baseFlatOptionsSchema, но с добавлением:
+ * - openapiConfig (из baseCLIOptionsSchema)
+ * - опциональными input/output (валидируются условно)
+ */
+exports.generateOptionsSchema = base_1.baseCLIOptionsSchema
+    .merge(configSchemas_1.baseFlatOptionsSchema)
+    .extend({
+    input: emptyStringToUndefined,
+    output: emptyStringToUndefined,
+})
+    .superRefine((data, ctx) => {
+    // Проверка: если excludeCoreServiceFiles === true, request не должен быть указан
+    if (data.excludeCoreServiceFiles === true && data.request) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: '"--request" can only be used when "excludeCoreServiceFiles" is false',
+            path: ['request'],
+        });
+    }
+    // Проверка: input и output обязательны, если конфиг-файл не существует или пуст
+    const configPath = data.openapiConfig || Consts_1.DEFAULT_OPENAPI_CONFIG_FILENAME;
+    const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(configPath);
+    // Если конфиг не существует или пуст, требуем input и output
+    const needsInputOutput = !configData || (Array.isArray(configData) && configData.length === 0) || (typeof configData === 'object' && Object.keys(configData).length === 0);
+    if (needsInputOutput) {
+        if (!data.input || data.input.trim() === '') {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: '"--input" is required when no valid config file is provided',
+                path: ['input'],
+            });
+        }
+        if (!data.output || data.output.trim() === '') {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: '"--output" is required when no valid config file is provided',
+                path: ['output'],
+            });
+        }
+    }
+});

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

@@ -0,0 +1,7 @@
+export * from './base';
+export * from './checkConfig';
+export * from './generate';
+export * from './init';
+export * from './updateConfig';
+export type CLIOptions = import('./generate').GenerateOptions | import('./checkConfig').CheckConfigOptions | import('./updateConfig').UpdateConfigOptions | import('./init').InitOptions;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAG/B,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,EAAE,eAAe,GAAG,OAAO,eAAe,EAAE,kBAAkB,GAAG,OAAO,gBAAgB,EAAE,mBAAmB,GAAG,OAAO,QAAQ,EAAE,WAAW,CAAC"}

package/dist/cli/schemas/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base"), exports);
+__exportStar(require("./checkConfig"), exports);
+__exportStar(require("./generate"), exports);
+__exportStar(require("./init"), exports);
+__exportStar(require("./updateConfig"), exports);

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

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { EOptionType } from '../initOpenApiConfig/Enums';
+export declare const initOptionsSchema: z.ZodObject<{
+    openapiConfig: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<typeof EOptionType>>>;
+}, z.core.$strip>;
+export type InitOptions = z.infer<typeof initOptionsSchema>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD,eAAO,MAAM,iBAAiB;;;iBAE5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/cli/schemas/init.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initOptionsSchema = void 0;
+const zod_1 = require("zod");
+const Enums_1 = require("../initOpenApiConfig/Enums");
+const base_1 = require("./base");
+exports.initOptionsSchema = base_1.baseCLIOptionsSchema.extend({
+    type: zod_1.z.nativeEnum(Enums_1.EOptionType).optional().default(Enums_1.EOptionType.OPTION),
+});

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

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const updateConfigOptionsSchema: z.ZodObject<{
+    openapiConfig: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type UpdateConfigOptions = z.infer<typeof updateConfigOptionsSchema>;
+//# sourceMappingURL=updateConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateConfig.d.ts","sourceRoot":"","sources":["../../../src/cli/schemas/updateConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,yBAAyB;;iBAAuB,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/cli/schemas/updateConfig.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateConfigOptionsSchema = void 0;
+const base_1 = require("./base");
+exports.updateConfigOptionsSchema = base_1.baseCLIOptionsSchema;

package/dist/cli/validation/errorFormatter.d.ts

@@ -0,0 +1,6 @@
+import { ZodError } from 'zod';
+/**
+ * Форматирует Zod ошибку в читаемое сообщение для CLI
+ */
+export declare function formatZodErrorForCLI(error: ZodError): string;
+//# sourceMappingURL=errorFormatter.d.ts.map

package/dist/cli/validation/errorFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorFormatter.d.ts","sourceRoot":"","sources":["../../../src/cli/validation/errorFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAY5D"}

package/dist/cli/validation/errorFormatter.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatZodErrorForCLI = formatZodErrorForCLI;
+/**
+ * Форматирует Zod ошибку в читаемое сообщение для CLI
+ */
+function formatZodErrorForCLI(error) {
+    if (!error || error.issues.length === 0) {
+        return 'Validation error occurred';
+    }
+    const messages = [];
+    for (const issue of error.issues) {
+        messages.push(formatIssue(issue));
+    }
+    return messages.join('\n');
+}
+/**
+ * Форматирует отдельную Zod issue в читаемое сообщение
+ */
+function formatIssue(issue) {
+    const path = formatPath(issue.path);
+    const message = issue.message;
+    // Если issue имеет кастомное сообщение, используем его
+    if (issue.code === 'custom') {
+        return message;
+    }
+    // Форматируем стандартные ошибки с использованием type guards
+    if (issue.code === 'invalid_type') {
+        if ('received' in issue && issue.received === 'undefined') {
+            const fieldName = formatPath(issue.path).replace(/^--/, '');
+            return `${path}: "${fieldName}" is required`;
+        }
+        if ('expected' in issue && 'received' in issue) {
+            return `${path}: Expected ${issue.expected}, received ${issue.received}`;
+        }
+    }
+    if (issue.code === 'invalid_format' && 'format' in issue) {
+        const fieldName = formatPath(issue.path).replace(/^--/, '');
+        const format = issue.format;
+        if (format === 'email') {
+            return `${path}: "${fieldName}" must be a valid email`;
+        }
+        if (format === 'url') {
+            return `${path}: "${fieldName}" must be a valid URL`;
+        }
+        return `${path}: "${fieldName}" has invalid format: ${format}`;
+    }
+    if (issue.code === 'too_small' && 'minimum' in issue && 'type' in issue) {
+        const fieldName = formatPath(issue.path).replace(/^--/, '');
+        const type = issue.type;
+        const minimum = issue.minimum;
+        if (type === 'string') {
+            return `${path}: "${fieldName}" must be at least ${minimum} characters long`;
+        }
+        if (type === 'number') {
+            return `${path}: "${fieldName}" must be at least ${minimum}`;
+        }
+        if (type === 'array') {
+            return `${path}: "${fieldName}" must contain at least ${minimum} items`;
+        }
+    }
+    if (issue.code === 'too_big' && 'maximum' in issue && 'type' in issue) {
+        const fieldName = formatPath(issue.path).replace(/^--/, '');
+        const type = issue.type;
+        const maximum = issue.maximum;
+        if (type === 'string') {
+            return `${path}: "${fieldName}" must be at most ${maximum} characters long`;
+        }
+        if (type === 'number') {
+            return `${path}: "${fieldName}" must be at most ${maximum}`;
+        }
+        if (type === 'array') {
+            return `${path}: "${fieldName}" must contain at most ${maximum} items`;
+        }
+    }
+    if (issue.code === 'invalid_value') {
+        const fieldName = formatPath(issue.path).replace(/^--/, '');
+        return `${path}: "${fieldName}" has invalid value`;
+    }
+    if (issue.code === 'unrecognized_keys' && 'keys' in issue) {
+        return `${path}: Unrecognized keys: ${issue.keys.join(', ')}`;
+    }
+    // Для всех остальных случаев используем стандартное сообщение
+    return `${path}: ${message}`;
+}
+/**
+ * Форматирует путь к полю в читаемый формат
+ */
+function formatPath(path) {
+    if (path.length === 0) {
+        return 'root';
+    }
+    // Объединяем путь, используя точки для вложенных полей
+    // Например: ['options', 'input'] -> 'options.input'
+    // Для CLI опций обычно это будет просто название опции: ['input'] -> '--input'
+    const formattedPath = path
+        .map(segment => {
+        if (typeof segment === 'number') {
+            return `[${segment}]`;
+        }
+        if (typeof segment === 'symbol') {
+            return `[Symbol(${segment.description || 'unknown'})]`;
+        }
+        return String(segment);
+    })
+        .join('.');
+    // Для CLI опций добавляем префикс --
+    // Проверяем, является ли это именем опции (не вложенным полем)
+    if (path.length === 1 && typeof path[0] === 'string') {
+        return `--${formattedPath}`;
+    }
+    return formattedPath;
+}

package/dist/cli/validation/index.d.ts

@@ -0,0 +1,3 @@
+export * from './errorFormatter';
+export * from './validateCLIOptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/validation/index.d.ts.map

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

package/dist/cli/validation/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errorFormatter"), exports);
+__exportStar(require("./validateCLIOptions"), exports);

package/dist/cli/validation/validateCLIOptions.d.ts

@@ -0,0 +1,27 @@
+import { ZodError, ZodSchema } from 'zod';
+/**
+ * Результат валидации
+ */
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Валидирует данные с помощью Zod схемы и возвращает отформатированный результат
+ */
+export declare function validateCLIOptions<T>(schema: ZodSchema<T>, data: unknown): ValidationResult<T>;
+/**
+ * Валидирует данные с помощью Zod схемы и возвращает raw результат
+ * (полезно когда нужен доступ к ZodError для дополнительной обработки)
+ */
+export declare function validateCLIOptionsRaw<T>(schema: ZodSchema<T>, data: unknown): {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: ZodError;
+};
+//# sourceMappingURL=validateCLIOptions.d.ts.map

package/dist/cli/validation/validateCLIOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateCLIOptions.d.ts","sourceRoot":"","sources":["../../../src/cli/validation/validateCLIOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAI1C;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAiB9F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAQ9I"}

package/dist/cli/validation/validateCLIOptions.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCLIOptions = validateCLIOptions;
+exports.validateCLIOptionsRaw = validateCLIOptionsRaw;
+const zod_1 = require("zod");
+const errorFormatter_1 = require("./errorFormatter");
+/**
+ * Валидирует данные с помощью Zod схемы и возвращает отформатированный результат
+ */
+function validateCLIOptions(schema, data) {
+    try {
+        const result = schema.parse(data);
+        return { success: true, data: result };
+    }
+    catch (error) {
+        if (error instanceof zod_1.ZodError) {
+            return {
+                success: false,
+                error: (0, errorFormatter_1.formatZodErrorForCLI)(error),
+            };
+        }
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown validation error',
+        };
+    }
+}
+/**
+ * Валидирует данные с помощью Zod схемы и возвращает raw результат
+ * (полезно когда нужен доступ к ZodError для дополнительной обработки)
+ */
+function validateCLIOptionsRaw(schema, data) {
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return { success: false, error: result.error };
+}

package/dist/common/TRawOptions.d.ts

@@ -1,41 +1,8 @@
-import { HttpClient } from '../core/types/enums/HttpClient.enum';
-import { ValidationLibrary } from '../core/types/enums/ValidationLibrary.enum';
-import { ELogLevel, ELogOutput } from './Enums';
-type TItemConfig = {
-    input: string;
-    output: string;
-    outputCore?: string;
-    outputServices?: string;
-    outputModels?: string;
-    outputSchemas?: string;
-    request?: string;
-};
-export type TRawOptions = {
-    items?: TItemConfig[];
-    input?: string;
-    output?: string;
-    outputCore?: string;
-    outputServices?: string;
-    outputModels?: string;
-    outputSchemas?: string;
-    httpClient?: HttpClient;
-    useOptions?: boolean;
-    useUnionTypes?: boolean;
-    excludeCoreServiceFiles?: boolean;
-    request?: string;
-    interfacePrefix?: string;
-    enumPrefix?: string;
-    typePrefix?: string;
-    useCancelableRequest?: boolean;
-    logLevel?: ELogLevel;
-    logTarget?: ELogOutput;
-    sortByRequired?: boolean;
-    useSeparatedIndexes?: boolean;
-    validationLibrary?: ValidationLibrary;
-};
-export type TFlatOptions = Omit<TRawOptions, 'items'>;
+import { z } from 'zod';
+import { flatOptionsSchema, rawOptionsSchema } from "./schemas/configSchemas";
+export type TRawOptions = z.infer<typeof rawOptionsSchema>;
+export type TFlatOptions = z.infer<typeof flatOptionsSchema>;
 export type TStrictFlatOptions = {
     [P in keyof TFlatOptions]-?: NonNullable<TFlatOptions[P]>;
 };
-export {};
 //# sourceMappingURL=TRawOptions.d.ts.map

package/dist/common/TRawOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TRawOptions.d.ts","sourceRoot":"","sources":["../../src/common/TRawOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhD,KAAK,WAAW,GAAG;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACtB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG;KAC5B,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAC5D,CAAC"}
+{"version":3,"file":"TRawOptions.d.ts","sourceRoot":"","sources":["../../src/common/TRawOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE9E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG;KAC5B,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;CAC5D,CAAC"}

package/dist/common/VersionedSchema/AllVersionedSchemas/AllMigrationPlans.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AllMigrationPlans.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/AllVersionedSchemas/AllMigrationPlans.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAc/C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAmB5F,CAAC"}
+{"version":3,"file":"AllMigrationPlans.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/AllVersionedSchemas/AllMigrationPlans.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAgB/C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EA4B5F,CAAC"}

package/dist/common/VersionedSchema/AllVersionedSchemas/AllMigrationPlans.js

@@ -4,7 +4,9 @@ exports.allMigrationPlans = void 0;
 const ValidationLibrary_enum_1 = require("../../../core/types/enums/ValidationLibrary.enum");
 const MultiOptionsMigrationPlan_1 = require("../MultiOptionsVersioned/MultiOptionsMigrationPlan");
 const OptionsMigrationPlans_1 = require("../OptionsVersioned/OptionsMigrationPlans");
+const createFieldTransformationMigration_1 = require("../Utils/createFieldTransformationMigration");
 const createTrivialMigration_1 = require("../Utils/createTrivialMigration");
+const getLatestVersionFromMigrationPlans_1 = require("../Utils/getLatestVersionFromMigrationPlans");
 /**
  * Adds a prefix to all version strings in a migration plan array.
  */
@@ -23,17 +25,13 @@ function addVersionPrefixToMigrationPlans(plans, prefix) {
 exports.allMigrationPlans = [
     // ===== OPTIONS migrations (with prefix) =====
     ...addVersionPrefixToMigrationPlans(OptionsMigrationPlans_1.optionsMigrationPlans, 'OPTIONS'),
-    // Migration from OPTIONS v4 to UNIFIED v1
-    (0, createTrivialMigration_1.createTrivialMigration)('OPTIONS_v4', 'UNIFIED_v1', 'Migrate from OPTIONS to UNIFIED schema'),
+    // Migration from OPTIONS latest version to UNIFIED v1
+    (0, createTrivialMigration_1.createTrivialMigration)(`OPTIONS_${(0, getLatestVersionFromMigrationPlans_1.getLatestVersionFromMigrationPlans)(OptionsMigrationPlans_1.optionsMigrationPlans)}`, 'UNIFIED_v1', 'Migrate from OPTIONS to UNIFIED schema'),
     // ===== MULTI_OPTIONS migrations (with prefix) =====
     ...addVersionPrefixToMigrationPlans(MultiOptionsMigrationPlan_1.multiOptionsMigrationPlan, 'MULTI_OPTIONS'),
-    // Migration from MULTI_OPTIONS v5 to UNIFIED v1
-    (0, createTrivialMigration_1.createTrivialMigration)('MULTI_OPTIONS_v5', 'UNIFIED_v1', 'Migrate from MULTI_OPTIONS to UNIFIED schema'),
-    {
-        fromVersion: 'UNIFIED_v1',
-        toVersion: 'UNIFIED_v2',
-        migrate: ({ includeSchemasFiles, ...otherProps }) => {
-            return { ...otherProps, validationLibrary: !includeSchemasFiles ? ValidationLibrary_enum_1.ValidationLibrary.NONE : undefined };
-        },
-    },
+    // Migration from MULTI_OPTIONS latest version to UNIFIED v1
+    (0, createTrivialMigration_1.createTrivialMigration)(`MULTI_OPTIONS_${(0, getLatestVersionFromMigrationPlans_1.getLatestVersionFromMigrationPlans)(MultiOptionsMigrationPlan_1.multiOptionsMigrationPlan)}`, 'UNIFIED_v1', 'Migrate from MULTI_OPTIONS to UNIFIED schema'),
+    (0, createFieldTransformationMigration_1.createFieldTransformationMigration)('UNIFIED_v1', 'UNIFIED_v2', ({ includeSchemasFiles, ...otherProps }) => {
+        return { ...otherProps, validationLibrary: !includeSchemasFiles ? ValidationLibrary_enum_1.ValidationLibrary.NONE : undefined };
+    }, 'Transforms includeSchemasFiles to validationLibrary: if includeSchemasFiles is false, sets validationLibrary to NONE'),
 ];

package/dist/common/VersionedSchema/MultiOptionsVersioned/MultiOptionsMigrationPlan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiOptionsMigrationPlan.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/MultiOptionsVersioned/MultiOptionsMigrationPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG/C;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EA0BpG,CAAC"}
+{"version":3,"file":"MultiOptionsMigrationPlan.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/MultiOptionsVersioned/MultiOptionsMigrationPlan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAI/C;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EA4BpG,CAAC"}

package/dist/common/VersionedSchema/MultiOptionsVersioned/MultiOptionsMigrationPlan.js

@@ -2,29 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.multiOptionsMigrationPlan = void 0;
 const createDefaultFieldsMigration_1 = require("../Utils/createDefaultFieldsMigration");
+const createFieldTransformationMigration_1 = require("../Utils/createFieldTransformationMigration");
 /**
  * Migration plan for multi options models.
  */
 exports.multiOptionsMigrationPlan = [
-    {
-        fromVersion: 'v1',
-        toVersion: 'v2',
-        migrate: ({ client, ...otherProps }) => ({
-            ...otherProps,
-            httpClient: client,
-        }),
-    },
+    (0, createFieldTransformationMigration_1.createFieldTransformationMigration)('v1', 'v2', ({ client, ...otherProps }) => ({
+        ...otherProps,
+        httpClient: client,
+    }), 'Renames client field to httpClient'),
     (0, createDefaultFieldsMigration_1.createDefaultFieldsMigration)('v2', 'v3', {
         useCancelableRequest: false,
     }),
-    {
-        fromVersion: 'v3',
-        toVersion: 'v4',
-        migrate: ({ items, input, output, outputCore, outputServices, outputModels, outputSchemas, ...otherProps }) => ({
-            ...otherProps,
-            items: items.map((el) => ({ ...el, input, output, outputCore, outputServices, outputModels, outputSchemas })),
-        }),
-    },
+    (0, createFieldTransformationMigration_1.createFieldTransformationMigration)('v3', 'v4', ({ items, input, output, outputCore, outputServices, outputModels, outputSchemas, ...otherProps }) => ({
+        ...otherProps,
+        items: items.map((el) => ({ ...el, input, output, outputCore, outputServices, outputModels, outputSchemas })),
+    }), 'Moves input, output, and output paths from root level into each item in the items array'),
     (0, createDefaultFieldsMigration_1.createDefaultFieldsMigration)('v4', 'v5', {
         excludeCoreServiceFiles: false,
         includeSchemasFiles: false,

package/dist/common/VersionedSchema/OptionsVersioned/OptionsMigrationPlans.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OptionsMigrationPlans.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsMigrationPlans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG/C;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAehG,CAAC"}
+{"version":3,"file":"OptionsMigrationPlans.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/OptionsVersioned/OptionsMigrationPlans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAI/C;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAgBhG,CAAC"}

package/dist/common/VersionedSchema/OptionsVersioned/OptionsMigrationPlans.js

@@ -2,15 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.optionsMigrationPlans = void 0;
 const createDefaultFieldsMigration_1 = require("../Utils/createDefaultFieldsMigration");
+const createFieldTransformationMigration_1 = require("../Utils/createFieldTransformationMigration");
 /**
  * Migration plan for option models.
  */
 exports.optionsMigrationPlans = [
-    {
-        fromVersion: 'v1',
-        toVersion: 'v2',
-        migrate: ({ client, ...otherProps }) => ({ ...otherProps, httpClient: client }),
-    },
+    (0, createFieldTransformationMigration_1.createFieldTransformationMigration)('v1', 'v2', ({ client, ...otherProps }) => ({ ...otherProps, httpClient: client }), 'Renames client field to httpClient'),
     (0, createDefaultFieldsMigration_1.createDefaultFieldsMigration)('v2', 'v3', {
         useCancelableRequest: false,
     }),

package/dist/common/VersionedSchema/Utils/createFieldTransformationMigration.d.ts

@@ -0,0 +1,32 @@
+import { SchemaMigrationPlan } from '../Types';
+/**
+ * Creates a migration plan that transforms fields using a custom migration function.
+ * Use this for migrations that require field renaming, restructuring, or complex transformations
+ * that cannot be handled by createDefaultFieldsMigration or createTrivialMigration.
+ *
+ * @param fromVersion - Source version
+ * @param toVersion - Target version
+ * @param migrate - Custom migration function that transforms the data
+ * @param description - Optional description of what this migration does
+ * @returns A migration plan with the custom transformation
+ *
+ * @example
+ * ```ts
+ * // Rename field: client -> httpClient
+ * createFieldTransformationMigration('v1', 'v2',
+ *   ({ client, ...otherProps }) => ({ ...otherProps, httpClient: client }),
+ *   'Renames client field to httpClient'
+ * )
+ *
+ * // Transform items array
+ * createFieldTransformationMigration('v3', 'v4',
+ *   ({ items, input, output, ...otherProps }) => ({
+ *     ...otherProps,
+ *     items: items.map(el => ({ ...el, input, output }))
+ *   }),
+ *   'Moves input/output fields into each item'
+ * )
+ * ```
+ */
+export declare function createFieldTransformationMigration<From extends Record<string, any>, To extends Record<string, any>>(fromVersion: string, toVersion: string, migrate: (input: From) => To, description?: string): SchemaMigrationPlan<From, To>;
+//# sourceMappingURL=createFieldTransformationMigration.d.ts.map

package/dist/common/VersionedSchema/Utils/createFieldTransformationMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFieldTransformationMigration.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/createFieldTransformationMigration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/G,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,EAAE,EAC5B,WAAW,CAAC,EAAE,MAAM,GACrB,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,CAO/B"}

package/dist/common/VersionedSchema/Utils/createFieldTransformationMigration.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFieldTransformationMigration = createFieldTransformationMigration;
+/**
+ * Creates a migration plan that transforms fields using a custom migration function.
+ * Use this for migrations that require field renaming, restructuring, or complex transformations
+ * that cannot be handled by createDefaultFieldsMigration or createTrivialMigration.
+ *
+ * @param fromVersion - Source version
+ * @param toVersion - Target version
+ * @param migrate - Custom migration function that transforms the data
+ * @param description - Optional description of what this migration does
+ * @returns A migration plan with the custom transformation
+ *
+ * @example
+ * ```ts
+ * // Rename field: client -> httpClient
+ * createFieldTransformationMigration('v1', 'v2',
+ *   ({ client, ...otherProps }) => ({ ...otherProps, httpClient: client }),
+ *   'Renames client field to httpClient'
+ * )
+ *
+ * // Transform items array
+ * createFieldTransformationMigration('v3', 'v4',
+ *   ({ items, input, output, ...otherProps }) => ({
+ *     ...otherProps,
+ *     items: items.map(el => ({ ...el, input, output }))
+ *   }),
+ *   'Moves input/output fields into each item'
+ * )
+ * ```
+ */
+function createFieldTransformationMigration(fromVersion, toVersion, migrate, description) {
+    return {
+        fromVersion,
+        toVersion,
+        migrate,
+        description: description || `Custom field transformation migration from ${fromVersion} to ${toVersion}`,
+    };
+}

package/dist/common/VersionedSchema/Utils/getLatestVersionFromMigrationPlans.d.ts

@@ -0,0 +1,16 @@
+import { SchemaMigrationPlan } from '../Types';
+/**
+ * Gets the latest version from a migration plans array.
+ * Returns the `toVersion` of the last migration plan in the array.
+ *
+ * @param migrationPlans - Array of migration plans
+ * @returns The latest version string (e.g., 'v4')
+ *
+ * @example
+ * ```ts
+ * const latestVersion = getLatestVersionFromMigrationPlans(optionsMigrationPlans);
+ * // Returns 'v4'
+ * ```
+ */
+export declare function getLatestVersionFromMigrationPlans(migrationPlans: SchemaMigrationPlan<Record<string, any>, Record<string, any>>[]): string;
+//# sourceMappingURL=getLatestVersionFromMigrationPlans.d.ts.map

package/dist/common/VersionedSchema/Utils/getLatestVersionFromMigrationPlans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLatestVersionFromMigrationPlans.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/getLatestVersionFromMigrationPlans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAC9C,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAChF,MAAM,CAOR"}

package/dist/common/VersionedSchema/Utils/getLatestVersionFromMigrationPlans.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLatestVersionFromMigrationPlans = getLatestVersionFromMigrationPlans;
+/**
+ * Gets the latest version from a migration plans array.
+ * Returns the `toVersion` of the last migration plan in the array.
+ *
+ * @param migrationPlans - Array of migration plans
+ * @returns The latest version string (e.g., 'v4')
+ *
+ * @example
+ * ```ts
+ * const latestVersion = getLatestVersionFromMigrationPlans(optionsMigrationPlans);
+ * // Returns 'v4'
+ * ```
+ */
+function getLatestVersionFromMigrationPlans(migrationPlans) {
+    if (migrationPlans.length === 0) {
+        throw new Error('Migration plans array is empty. Cannot determine latest version.');
+    }
+    const lastPlan = migrationPlans[migrationPlans.length - 1];
+    return lastPlan.toVersion;
+}

package/dist/common/schemas/configSchemas.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { ValidationLibrary } from '../../core/types/enums/ValidationLibrary.enum';
+/**
+ * Базовая схема опций без обязательных input/output
+ * Используется как основа для CLI команд и конфиг-файлов
+ */
+export declare const baseFlatOptionsSchema: z.ZodObject<{
+    outputCore: z.ZodOptional<z.ZodString>;
+    outputServices: z.ZodOptional<z.ZodString>;
+    outputModels: z.ZodOptional<z.ZodString>;
+    outputSchemas: z.ZodOptional<z.ZodString>;
+    interfacePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    enumPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    typePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    httpClient: z.ZodOptional<z.ZodEnum<typeof import("../..").HttpClient>>;
+    useOptions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useUnionTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    excludeCoreServiceFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    request: z.ZodOptional<z.ZodString>;
+    useCancelableRequest: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    logLevel: z.ZodOptional<z.ZodEnum<typeof import("../Enums").ELogLevel>>;
+    logTarget: z.ZodOptional<z.ZodEnum<typeof import("../Enums").ELogOutput>>;
+    sortByRequired: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useSeparatedIndexes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    validationLibrary: z.ZodOptional<z.ZodEnum<typeof ValidationLibrary>>;
+}, z.core.$strip>;
+/**
+ * Полная схема для конфиг-файла (TRawOptions)
+ * Поддерживает два формата:
+ * 1. С массивом items (multi-options)
+ * 2. С input/output в корне (single-options)
+ */
+export declare const rawOptionsSchema: z.ZodObject<{
+    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        input: z.ZodString;
+        output: z.ZodString;
+        outputCore: z.ZodOptional<z.ZodString>;
+        outputServices: z.ZodOptional<z.ZodString>;
+        outputModels: z.ZodOptional<z.ZodString>;
+        outputSchemas: z.ZodOptional<z.ZodString>;
+        request: z.ZodOptional<z.ZodString>;
+        httpClient: z.ZodOptional<z.ZodEnum<typeof import("../..").HttpClient>>;
+    }, z.core.$strip>>>;
+    input: z.ZodOptional<z.ZodString>;
+    output: z.ZodOptional<z.ZodString>;
+    outputCore: z.ZodOptional<z.ZodString>;
+    outputServices: z.ZodOptional<z.ZodString>;
+    outputModels: z.ZodOptional<z.ZodString>;
+    outputSchemas: z.ZodOptional<z.ZodString>;
+    interfacePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    enumPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    typePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    httpClient: z.ZodOptional<z.ZodEnum<typeof import("../..").HttpClient>>;
+    useOptions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useUnionTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    excludeCoreServiceFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    request: z.ZodOptional<z.ZodString>;
+    useCancelableRequest: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    logLevel: z.ZodOptional<z.ZodEnum<typeof import("../Enums").ELogLevel>>;
+    logTarget: z.ZodOptional<z.ZodEnum<typeof import("../Enums").ELogOutput>>;
+    sortByRequired: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useSeparatedIndexes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    validationLibrary: z.ZodOptional<z.ZodEnum<typeof ValidationLibrary>>;
+}, z.core.$strip>;
+/**
+ * Схема для плоских опций (без items) - TFlatOptions
+ * Используется для конфиг-файлов с одной спецификацией
+ */
+export declare const flatOptionsSchema: z.ZodObject<{
+    outputCore: z.ZodOptional<z.ZodString>;
+    outputServices: z.ZodOptional<z.ZodString>;
+    outputModels: z.ZodOptional<z.ZodString>;
+    outputSchemas: z.ZodOptional<z.ZodString>;
+    interfacePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    enumPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    typePrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    httpClient: z.ZodOptional<z.ZodEnum<typeof import("../..").HttpClient>>;
+    useOptions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useUnionTypes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    excludeCoreServiceFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    request: z.ZodOptional<z.ZodString>;
+    useCancelableRequest: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    logLevel: z.ZodOptional<z.ZodEnum<typeof import("../Enums").ELogLevel>>;
+    logTarget: z.ZodOptional<z.ZodEnum<typeof import("../Enums").ELogOutput>>;
+    sortByRequired: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    useSeparatedIndexes: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    validationLibrary: z.ZodOptional<z.ZodEnum<typeof ValidationLibrary>>;
+    input: z.ZodString;
+    output: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=configSchemas.d.ts.map

package/dist/common/schemas/configSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSchemas.d.ts","sourceRoot":"","sources":["../../../src/common/schemas/configSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAqDlF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;iBAAqE,CAAC;AAExG;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqDvB,CAAC;AAEP;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;iBAcxB,CAAC"}

package/dist/common/schemas/configSchemas.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flatOptionsSchema = exports.rawOptionsSchema = exports.baseFlatOptionsSchema = void 0;
+const zod_1 = require("zod");
+const base_1 = require("../../cli/schemas/base");
+const ValidationLibrary_enum_1 = require("../../core/types/enums/ValidationLibrary.enum");
+/**
+ * Схема для отдельного элемента конфигурации (используется в массиве items)
+ */
+const itemConfigSchema = zod_1.z.object({
+    input: zod_1.z.string().min(1, 'Input is required'),
+    output: zod_1.z.string().min(1, 'Output is required'),
+    outputCore: zod_1.z.string().min(1).optional(),
+    outputServices: zod_1.z.string().min(1).optional(),
+    outputModels: zod_1.z.string().min(1).optional(),
+    outputSchemas: zod_1.z.string().min(1).optional(),
+    request: zod_1.z.string().min(1).optional(),
+    httpClient: base_1.httpClientSchema.optional(),
+});
+/**
+ * Схема для output директорий (используется как в items, так и в корне)
+ */
+const outputPathsSchema = zod_1.z.object({
+    outputCore: zod_1.z.string().min(1).optional(),
+    outputServices: zod_1.z.string().min(1).optional(),
+    outputModels: zod_1.z.string().min(1).optional(),
+    outputSchemas: zod_1.z.string().min(1).optional(),
+});
+/**
+ * Схема для префиксов
+ */
+const prefixesSchema = zod_1.z.object({
+    interfacePrefix: zod_1.z.string().min(1).optional().default('I'),
+    enumPrefix: zod_1.z.string().min(1).optional().default('E'),
+    typePrefix: zod_1.z.string().min(1).optional().default('T'),
+});
+/**
+ * Базовая схема для общих опций (без items/input/output)
+ */
+const commonOptionsSchema = zod_1.z.object({
+    httpClient: base_1.httpClientSchema.optional(),
+    useOptions: zod_1.z.boolean().optional().default(false),
+    useUnionTypes: zod_1.z.boolean().optional().default(false),
+    excludeCoreServiceFiles: zod_1.z.boolean().optional().default(false),
+    request: zod_1.z.string().min(1).optional(),
+    useCancelableRequest: zod_1.z.boolean().optional().default(false),
+    logLevel: base_1.logLevelSchema.optional(),
+    logTarget: base_1.logTargetSchema.optional(),
+    sortByRequired: zod_1.z.boolean().optional().default(false),
+    useSeparatedIndexes: zod_1.z.boolean().optional().default(false),
+    validationLibrary: zod_1.z.nativeEnum(ValidationLibrary_enum_1.ValidationLibrary).optional()
+});
+/**
+ * Базовая схема опций без обязательных input/output
+ * Используется как основа для CLI команд и конфиг-файлов
+ */
+exports.baseFlatOptionsSchema = outputPathsSchema.merge(prefixesSchema).merge(commonOptionsSchema);
+/**
+ * Полная схема для конфиг-файла (TRawOptions)
+ * Поддерживает два формата:
+ * 1. С массивом items (multi-options)
+ * 2. С input/output в корне (single-options)
+ */
+exports.rawOptionsSchema = zod_1.z
+    .object({
+    // Multi-item configuration
+    items: zod_1.z.array(itemConfigSchema).min(1, 'Items array must contain at least one item').optional(),
+    // Single-item configuration (взаимоисключающие с items)
+    input: zod_1.z.string().min(1).optional(),
+    output: zod_1.z.string().min(1).optional(),
+})
+    .merge(exports.baseFlatOptionsSchema)
+    .superRefine((data, ctx) => {
+    // Проверка: либо items, либо input+output должны быть указаны
+    const hasItems = data.items && data.items.length > 0;
+    const hasInputOutput = !!(data.input && data.output);
+    if (!hasItems && !hasInputOutput) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: 'Either "items" array or "input" + "output" must be provided',
+            path: [],
+        });
+    }
+    // Если есть items, то input и output в корне не должны быть указаны
+    if (hasItems && hasInputOutput) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: 'Cannot use both "items" array and "input"/"output" at the root level',
+            path: ['items'],
+        });
+    }
+    // Валидация: если excludeCoreServiceFiles === true, request не должен быть указан
+    if (data.excludeCoreServiceFiles === true && data.request) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: '"request" can only be used when "excludeCoreServiceFiles" is false',
+            path: ['request'],
+        });
+    }
+    // Валидация для каждого элемента в items
+    if (hasItems && data.items) {
+        data.items.forEach((item, index) => {
+            if (item.request && data.excludeCoreServiceFiles === true) {
+                ctx.addIssue({
+                    code: zod_1.z.ZodIssueCode.custom,
+                    message: '"request" in items can only be used when "excludeCoreServiceFiles" is false',
+                    path: ['items', index, 'request'],
+                });
+            }
+        });
+    }
+});
+/**
+ * Схема для плоских опций (без items) - TFlatOptions
+ * Используется для конфиг-файлов с одной спецификацией
+ */
+exports.flatOptionsSchema = exports.baseFlatOptionsSchema
+    .extend({
+    input: zod_1.z.string().min(1, 'Input is required'),
+    output: zod_1.z.string().min(1, 'Output is required'),
+})
+    .superRefine((data, ctx) => {
+    // Валидация: если excludeCoreServiceFiles === true, request не должен быть указан
+    if (data.excludeCoreServiceFiles === true && data.request) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: '"request" can only be used when "excludeCoreServiceFiles" is false',
+            path: ['request'],
+        });
+    }
+});

package/dist/core/OpenApiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAetF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,aAAa;IACtB,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,gBAAgB;YAyBV,sBAAsB;YAUtB,oBAAoB;YAmCpB,cAAc;IAkFtB,QAAQ,CAAC,UAAU,EAAE,WAAW;CAWzC"}
+{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAetF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,aAAa;IACtB,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,gBAAgB;YAyBV,sBAAsB;YAUtB,oBAAoB;YAmCpB,cAAc;IAkFtB,QAAQ,CAAC,UAAU,EAAE,WAAW;CAWzC"}

package/dist/core/OpenApiClient.js

@@ -30,11 +30,46 @@ class OpenApiClient {
             return rawOptions.items.map(item => ({
                 ...item,
                 request: item.request ?? rawOptions.request, // ?? для fallback на глобальный
+                useOptions: rawOptions.useOptions,
+                useUnionTypes: rawOptions.useUnionTypes,
+                excludeCoreServiceFiles: rawOptions.excludeCoreServiceFiles,
+                interfacePrefix: rawOptions.interfacePrefix,
+                enumPrefix: rawOptions.enumPrefix,
+                typePrefix: rawOptions.typePrefix,
+                useCancelableRequest: rawOptions.useCancelableRequest,
+                logLevel: rawOptions.logLevel,
+                logTarget: rawOptions.logTarget,
+                sortByRequired: rawOptions.sortByRequired,
+                useSeparatedIndexes: rawOptions.useSeparatedIndexes,
+                validationLibrary: rawOptions.validationLibrary,
             }));
         }
         else {
             // Плоский формат (из CLI или старого конфига): Один item с глобальным request
-            return [rawOptions];
+            return [
+                {
+                    input: rawOptions.input ?? '',
+                    output: rawOptions.output ?? '',
+                    outputCore: rawOptions.outputCore,
+                    outputServices: rawOptions.outputServices,
+                    outputModels: rawOptions.outputModels,
+                    outputSchemas: rawOptions.outputSchemas,
+                    httpClient: rawOptions.httpClient,
+                    useOptions: rawOptions.useOptions,
+                    useUnionTypes: rawOptions.useUnionTypes,
+                    excludeCoreServiceFiles: rawOptions.excludeCoreServiceFiles,
+                    request: rawOptions.request,
+                    interfacePrefix: rawOptions.interfacePrefix,
+                    enumPrefix: rawOptions.enumPrefix,
+                    typePrefix: rawOptions.typePrefix,
+                    useCancelableRequest: rawOptions.useCancelableRequest,
+                    logLevel: rawOptions.logLevel,
+                    logTarget: rawOptions.logTarget,
+                    sortByRequired: rawOptions.sortByRequired,
+                    useSeparatedIndexes: rawOptions.useSeparatedIndexes,
+                    validationLibrary: rawOptions.validationLibrary,
+                },
+            ];
         }
     }
     addDefaultValues(item) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ts-openapi-codegen",
-    "version": "2.0.0-beta.2",
+    "version": "2.0.0-beta.3",
     "description": "Library that generates Typescript clients based on the OpenAPI specification. It bases on openapi-typescript-codegen",
     "author": "Alexey Zverev",
     "homepage": "https://github.com/ozonophore/openapi-codegen.git",
@@ -78,7 +78,8 @@
         "leven": "^4.0.0",
         "semver": "^7.7.1",
         "winston": "^3.17.0",
-        "winston-daily-rotate-file": "^5.0.0"
+        "winston-daily-rotate-file": "^5.0.0",
+        "zod": "^4.3.5"
     },
     "devDependencies": {
         "@babel/cli": "7.14.8",