ts-openapi-codegen 2.1.0-beta.8 → 2.1.0-beta.9

package/dist/cli/analyzeUsage/rules/ServiceRule.d.ts

@@ -1,6 +1,14 @@
 import type { ProjectContext } from '../core/ProjectContext';
 import type { Contract, Finding, Rule, Stats } from '../types';
+/** Правило проверки вызовов методов сгенерированных сервисов в потребителях API. */
 export declare class ServiceRule implements Rule {
+    /**
+     * Проверяет вызовы методов сервисов и соответствие их сигнатурам.
+     * @param context контекст проекта
+     * @param contract контракт сгенерированного API
+     * @param stats накопительная статистика использования
+     * @returns список найденных проблем
+     */
     check(context: ProjectContext, contract: Contract, stats: Stats): Promise<Finding[]>;
     private getExpectedParameterType;
 }

package/dist/cli/analyzeUsage/rules/ServiceRule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceRule.d.ts","sourceRoot":"","sources":["../../../../src/cli/analyzeUsage/rules/ServiceRule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAG/D,qBAAa,WAAY,YAAW,IAAI;IAC9B,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA8E1F,OAAO,CAAC,wBAAwB;CASnC"}
+{"version":3,"file":"ServiceRule.d.ts","sourceRoot":"","sources":["../../../../src/cli/analyzeUsage/rules/ServiceRule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAG/D,oFAAoF;AACpF,qBAAa,WAAY,YAAW,IAAI;IACpC;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgF1F,OAAO,CAAC,wBAAwB;CASnC"}

package/dist/cli/analyzeUsage/rules/ServiceRule.js

@@ -3,7 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceRule = void 0;
 const ts_morph_1 = require("ts-morph");
 const fuzzy_1 = require("../utils/fuzzy");
+/** Правило проверки вызовов методов сгенерированных сервисов в потребителях API. */
 class ServiceRule {
+    /**
+     * Проверяет вызовы методов сервисов и соответствие их сигнатурам.
+     * @param context контекст проекта
+     * @param contract контракт сгенерированного API
+     * @param stats накопительная статистика использования
+     * @returns список найденных проблем
+     */
     async check(context, contract, stats) {
         const findings = [];
         const checker = context.getTypeChecker();
@@ -58,6 +66,8 @@ class ServiceRule {
                     if (!expectedType)
                         continue;
                     const providedType = checker.getTypeAtLocation(args[i]);
+                    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+                    // @ts-ignore
                     if (!providedType.isAssignableTo(expectedType)) {
                         findings.push({
                             id: 'SERVICE_ARGUMENT_TYPE_MISMATCH',

package/dist/common/LoggerMessages.d.ts

@@ -2,6 +2,7 @@
  * Константы с текстовыми сообщениями для Logger
  * Все тексты для логирования должны быть вынесены сюда для централизованного управления
  */
+/** Коды ошибок CLI для централизованного логирования. */
 export declare const LOGGER_ERROR_CODES: {
     readonly CONFIG_FILE_MISSING: "CONFIG_FILE_MISSING";
     readonly CONFIG_FILE_NOT_FOUND_AT: "CONFIG_FILE_NOT_FOUND_AT";
@@ -14,11 +15,13 @@ export declare const LOGGER_ERROR_CODES: {
     readonly PRETTIER_FORMAT_FAILED: "PRETTIER_FORMAT_FAILED";
     readonly ESLINT_FIX_FAILED: "ESLINT_FIX_FAILED";
 };
+/** Тип кода ошибки CLI. */
 export type TLoggerErrorCode = keyof typeof LOGGER_ERROR_CODES;
 /**
  * Человекочитаемые рекомендации для пользователя CLI по коду ошибки
  */
 export declare const LOGGER_ERROR_RECOMMENDATIONS: Record<TLoggerErrorCode, string>;
+/** Централизованные текстовые сообщения для Logger. */
 export declare const LOGGER_MESSAGES: {
     readonly GENERATION: {
         readonly STARTED: (count: number) => string;
@@ -174,6 +177,8 @@ export declare const LOGGER_MESSAGES: {
         readonly NOT_FOUND: (reportPath: string) => string;
         readonly STALE: (reportPath: string) => string;
         readonly EMPTY: (reportPath: string) => string;
+        readonly LOADED: (reportPath: string, diffCount: number, miracleCount: number) => string;
+        readonly USE_HISTORY_NO_REPORT: (reportPath: string) => string;
         readonly READ_FAILED: (reportPath: string, message: string) => string;
     };
     readonly TEMPLATES: {

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

@@ -1 +1 @@
-{"version":3,"file":"LoggerMessages.d.ts","sourceRoot":"","sources":["../../src/common/LoggerMessages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"LoggerMessages.d.ts","sourceRoot":"","sources":["../../src/common/LoggerMessages.ts"],"names":[],"mappings":"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"}

package/dist/common/LoggerMessages.js

@@ -5,6 +5,7 @@ exports.LOGGER_MESSAGES = exports.LOGGER_ERROR_RECOMMENDATIONS = exports.LOGGER_
  * Константы с текстовыми сообщениями для Logger
  * Все тексты для логирования должны быть вынесены сюда для централизованного управления
  */
+/** Коды ошибок CLI для централизованного логирования. */
 exports.LOGGER_ERROR_CODES = {
     CONFIG_FILE_MISSING: 'CONFIG_FILE_MISSING',
     CONFIG_FILE_NOT_FOUND_AT: 'CONFIG_FILE_NOT_FOUND_AT',
@@ -32,6 +33,7 @@ exports.LOGGER_ERROR_RECOMMENDATIONS = {
     PRETTIER_FORMAT_FAILED: 'Проверьте синтаксис сгенерированного фрагмента и настройки Prettier (включая опцию prettierConfigPath). При необходимости укажите корректный путь к конфигу или поправьте файл конфигурации.',
     ESLINT_FIX_FAILED: 'Проверьте, что пути tsconfigPath и eslintConfigPath корректны, ESLint установлен в проекте, и что сгенерированные файлы доступны для чтения и записи.',
 };
+/** Централизованные текстовые сообщения для Logger. */
 exports.LOGGER_MESSAGES = {
     // ========== Generation Messages (OpenApiClient) ==========
     GENERATION: {
@@ -162,6 +164,8 @@ exports.LOGGER_MESSAGES = {
         NOT_FOUND: (reportPath) => `[openapi-codegen] Diff report not found at "${reportPath}". Skipping history annotations.`,
         STALE: (reportPath) => `[openapi-codegen] Diff report "${reportPath}" is older than the input spec. Skipping history annotations.`,
         EMPTY: (reportPath) => `[openapi-codegen] Diff report "${reportPath}" has no entries. Skipping history annotations.`,
+        LOADED: (reportPath, diffCount, miracleCount) => `[openapi-codegen] Loaded diff report "${reportPath}" (${diffCount} change(s), ${miracleCount} miracle(s)).`,
+        USE_HISTORY_NO_REPORT: (reportPath) => `[openapi-codegen] useHistory is enabled but no diff report was loaded from "${reportPath}". Skipping history annotations.`,
         READ_FAILED: (reportPath, message) => `[openapi-codegen] Failed to read diff report "${reportPath}": ${message}`,
     },
     TEMPLATES: {

package/dist/core/OpenApiClient.d.ts

@@ -1,11 +1,15 @@
 import { TRawOptions } from '../common/TRawOptions';
 import { WriteClient } from './WriteClient';
+/**
+ * Оркестратор генерации OpenAPI-клиента: парсинг спецификации, применение diff-отчёта и запись артефактов.
+ */
 export declare class OpenApiClient {
     private static readonly CACHE_FINGERPRINT_VERSION;
     private static readonly DEFAULT_CACHE_FILENAME;
     private _writeClient;
     /** ESLint paths from top-level rawOptions (not per items[] entry). */
     private eslintFixOptions;
+    /** Экземпляр WriteClient для записи сгенерированных файлов. */
     get writeClient(): WriteClient;
     private normalizeOptions;
     private addDefaultValues;
@@ -28,6 +32,10 @@ export declare class OpenApiClient {
     private runBatchEslintFixIfEnabled;
     private loadDiffReportIfNeeded;
     private applyDiffReportIfNeeded;
+    /**
+     * Запускает генерацию клиента по опциям CLI или конфигурации.
+     * @param rawOptions сырые опции генерации
+     */
     generate(rawOptions: TRawOptions): Promise<void>;
 }
 //# sourceMappingURL=OpenApiClient.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AA0BtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAiC;IAC/E,OAAO,CAAC,YAAY,CAA4B;IAChD,sEAAsE;IACtE,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAkFxB,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,cAAc;YAaR,mBAAmB;YASnB,2BAA2B;YA+B3B,oBAAoB;IA8DlC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,+BAA+B;YAiBzB,cAAc;IAsL5B,OAAO,CAAC,WAAW;YAaL,mBAAmB;YAiCnB,UAAU;IAUxB;;;OAGG;YACW,0BAA0B;YAwC1B,sBAAsB;IASpC,OAAO,CAAC,uBAAuB;IAczB,QAAQ,CAAC,UAAU,EAAE,WAAW;CAYzC"}
+{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AA2BtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAiC;IAC/E,OAAO,CAAC,YAAY,CAA4B;IAChD,sEAAsE;IACtE,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,+DAA+D;IAC/D,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAkFxB,OAAO,CAAC,gBAAgB;IA2CxB,OAAO,CAAC,cAAc;YAaR,mBAAmB;YASnB,2BAA2B;YA+B3B,oBAAoB;IA8DlC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,+BAA+B;YAiBzB,cAAc;IA0L5B,OAAO,CAAC,WAAW;YAaL,mBAAmB;YAiCnB,UAAU;IAUxB;;;OAGG;YACW,0BAA0B;YAwC1B,sBAAsB;IASpC,OAAO,CAAC,uBAAuB;IAe/B;;;OAGG;IACG,QAAQ,CAAC,UAAU,EAAE,WAAW;CAYzC"}

package/dist/core/OpenApiClient.js

@@ -27,13 +27,18 @@ const loadDiffReport_1 = require("./utils/loadDiffReport");
 const postProcessClient_1 = require("./utils/postProcessClient");
 const prepareDtoModels_1 = require("./utils/prepareDtoModels");
 const registerHandlebarTemplates_1 = require("./utils/registerHandlebarTemplates");
+const resolveClassesModeTypes_1 = require("./utils/resolveClassesModeTypes");
 const WriteClient_1 = require("./WriteClient");
+/**
+ * Оркестратор генерации OpenAPI-клиента: парсинг спецификации, применение diff-отчёта и запись артефактов.
+ */
 class OpenApiClient {
     static CACHE_FINGERPRINT_VERSION = 1;
     static DEFAULT_CACHE_FILENAME = '.openapi-codegen-cache.json';
     _writeClient = null;
     /** ESLint paths from top-level rawOptions (not per items[] entry). */
     eslintFixOptions = {};
+    /** Экземпляр WriteClient для записи сгенерированных файлов. */
     get writeClient() {
         if (!this._writeClient) {
             throw new Error('WriteClient must be initialized');
@@ -361,6 +366,10 @@ class OpenApiClient {
             diffReport,
             inputPath: absoluteInput,
         });
+        if (useHistory && !diffReportData) {
+            const reportPath = diffReport || Consts_1.DEFAULT_ANALYZE_DIFF_REPORT_PATH;
+            this.writeClient.logger.warn(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.USE_HISTORY_NO_REPORT(reportPath));
+        }
         this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.OPENAPI.DEFINING_VERSION);
         switch (openApiVersion) {
             case getOpenApiVersion_1.OpenApiVersion.V2: {
@@ -375,7 +384,7 @@ class OpenApiClient {
                     context,
                 });
                 const clientFinal = (0, postProcessClient_1.postProcessClient)(clientWithDiff);
-                const clientPrepared = modelsMode === ModelsMode_enum_1.ModelsMode.CLASSES ? (0, prepareDtoModels_1.prepareDtoModels)(clientFinal) : clientFinal;
+                const clientPrepared = modelsMode === ModelsMode_enum_1.ModelsMode.CLASSES ? (0, resolveClassesModeTypes_1.resolveClassesModeTypes)((0, prepareDtoModels_1.prepareDtoModels)(clientFinal)) : clientFinal;
                 this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.OPENAPI.WRITING_V2);
                 await this.writeClient.writeClient({
                     client: clientPrepared,
@@ -408,7 +417,7 @@ class OpenApiClient {
                     context,
                 });
                 const clientFinal = (0, postProcessClient_1.postProcessClient)(clientWithDiff);
-                const clientPrepared = modelsMode === ModelsMode_enum_1.ModelsMode.CLASSES ? (0, prepareDtoModels_1.prepareDtoModels)(clientFinal) : clientFinal;
+                const clientPrepared = modelsMode === ModelsMode_enum_1.ModelsMode.CLASSES ? (0, resolveClassesModeTypes_1.resolveClassesModeTypes)((0, prepareDtoModels_1.prepareDtoModels)(clientFinal)) : clientFinal;
                 this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.OPENAPI.WRITING_V3);
                 await this.writeClient.writeClient({
                     client: clientPrepared,
@@ -546,8 +555,13 @@ class OpenApiClient {
             openApiVersion: params.openApiVersion,
             diffReport: params.diffReport,
             prefix: params.context.prefix,
+            context: params.context,
         });
     }
+    /**
+     * Запускает генерацию клиента по опциям CLI или конфигурации.
+     * @param rawOptions сырые опции генерации
+     */
     async generate(rawOptions) {
         const logger = new Logger_1.Logger({
             level: rawOptions.logLevel ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.logLevel,

package/dist/core/WriteClient.d.ts

@@ -20,17 +20,23 @@ import { writeClientServicesIndex } from './utils/writeClientServicesIndex';
 import { writeClientSimpleIndex } from './utils/writeClientSimpleIndex';
 import { WriteFileIfChangedResult } from './utils/writeFileIfChanged';
 /**
- * @param client Client object with all the models, services, etc.
- * @param templates Templates wrapper with all loaded Handlebars templates
- * @param outputPaths The relative location of the output directory
- * @param httpClient The selected httpClient (fetch, xhr or node)
- * @param useOptions Use options or arguments functions
- * @param useUnionTypes Use union types instead of enums
- * @param excludeCoreServiceFiles The generation of the core and services is excluded
- * @param request: Path to custom request file
- * @param useCancelableRequest Use cancelable request type.
- * @param useSeparatedIndexes Use separate index files for the core, models, schemas, and services
- * @param validationLibrary Validation library to use for schema validation
+ * Параметры записи OpenAPI-клиента на диск.
+ * @property client клиент со всеми моделями и сервисами
+ * @property templates загруженные Handlebars-шаблоны
+ * @property outputPaths относительные пути выходных директорий
+ * @property httpClient выбранный HTTP-клиент
+ * @property useOptions использовать options-функции вместо аргументов
+ * @property useUnionTypes использовать union types вместо enum
+ * @property excludeCoreServiceFiles исключить генерацию core и services
+ * @property [request] путь к кастомному request-файлу
+ * @property [customExecutorPath] путь к кастомному executor
+ * @property [useCancelableRequest] использовать cancelable request type
+ * @property [useSeparatedIndexes] писать отдельные index-файлы для core, models, schemas и services
+ * @property [validationLibrary] библиотека валидации схем
+ * @property emptySchemaStrategy стратегия обработки пустых схем
+ * @property [modelsMode] режим генерации моделей
+ * @property [useProjectPrettier] форматировать через Prettier проекта
+ * @property [useEslintFix] применять ESLint fix к сгенерированным файлам
  */
 type TWriteClientProps = {
     client: Client;
@@ -53,7 +59,7 @@ type TAPIClientGeneratorConfig = Omit<TWriteClientProps, 'httpClient' | 'useOpti
     schemaModels: Model[];
 };
 /**
- * The client which is writing all items and keep the parameters to write index file
+ * Клиент записи сгенерированных артефактов и сборки index-файлов.
  */
 export declare class WriteClient {
     private config;
@@ -64,24 +70,44 @@ export declare class WriteClient {
     /** Output directory globs for the temporary tsconfig include. */
     private lintIncludeGlobs;
     private _logger;
+    /**
+     * @param [logger] логгер записи клиента
+     */
     constructor(logger?: Logger);
     /**
-     * Write our OpenAPI client, using the given templates at the given output
+     * Записывает OpenAPI-клиент по шаблонам в выходные директории.
+     * @param options параметры записи клиента
      */
     writeClient(options: TWriteClientProps): Promise<void>;
     private writeModelsAndFinalize;
     /**
-     * Method keeps all options that is need to create index file
-     * @param config
+     * Сохраняет конфигурацию генератора для последующей сборки index-файла.
+     * @param config конфигурация генератора клиента
      */
     buildClientGeneratorConfigMap(config: TAPIClientGeneratorConfig): void;
+    /** Собирает и записывает полный index клиента. */
     combineAndWrite(): Promise<void>;
+    /** Собирает и записывает упрощённый index клиента. */
     combineAndWrightSimple(): Promise<void>;
+    /** Логгер записи клиента. */
     get logger(): Logger;
+    /**
+     * Записывает выходной файл, если содержимое изменилось.
+     * @param filePath путь к файлу
+     * @param content содержимое файла
+     * @returns результат записи: written или unchanged
+     */
     writeOutputFile(filePath: string, content: string): Promise<WriteFileIfChangedResult>;
+    /**
+     * Регистрирует ожидаемый выходной файл без записи содержимого.
+     * @param filePath путь к файлу
+     */
     registerOutputFile(filePath: string): void;
+    /** Возвращает множество ожидаемых выходных файлов. */
     getExpectedOutputFiles(): Set<string>;
+    /** Возвращает список ожидаемых выходных файлов. */
     getExpectedOutputFilesArray(): string[];
+    /** Возвращает статистику записи файлов. */
     getWriteStats(): {
         written: number;
         unchanged: number;
@@ -112,16 +138,27 @@ export declare class WriteClient {
     private isSameModel;
     private isSameShema;
     private isSomeService;
+    /** Делегирует запись core-части клиента. */
     writeClientCore: typeof writeClientCore;
+    /** Делегирует запись index core-части. */
     writeClientCoreIndex: typeof writeClientCoreIndex;
+    /** Делегирует запись полного index клиента. */
     writeClientFullIndex: typeof writeClientFullIndex;
+    /** Делегирует запись моделей клиента. */
     writeClientModels: typeof writeClientModels;
+    /** Делегирует запись index моделей. */
     writeClientModelsIndex: typeof writeClientModelsIndex;
+    /** Делегирует запись схем клиента. */
     writeClientSchemas: typeof writeClientSchemas;
+    /** Делегирует запись index схем. */
     writeClientSchemasIndex: typeof writeClientSchemasIndex;
+    /** Делегирует запись сервисов клиента. */
     writeClientServices: typeof writeClientServices;
+    /** Делегирует запись index сервисов. */
     writeClientServicesIndex: typeof writeClientServicesIndex;
+    /** Делегирует запись упрощённого index клиента. */
     writeClientSimpleIndex: typeof writeClientSimpleIndex;
+    /** Делегирует запись executor клиента. */
     writeClientExecutor: typeof writeClientExecutor;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"WriteClient.d.ts","sourceRoot":"","sources":["../../src/core/WriteClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WriteClient.d.ts","sourceRoot":"","sources":["../../src/core/WriteClient.ts"],"names":[],"mappings":"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"}

package/dist/core/WriteClient.js

@@ -23,7 +23,7 @@ const writeClientServicesIndex_1 = require("./utils/writeClientServicesIndex");
 const writeClientSimpleIndex_1 = require("./utils/writeClientSimpleIndex");
 const writeFileIfChanged_1 = require("./utils/writeFileIfChanged");
 /**
- * The client which is writing all items and keep the parameters to write index file
+ * Клиент записи сгенерированных артефактов и сборки index-файлов.
  */
 class WriteClient {
     config = new Map();
@@ -34,6 +34,9 @@ class WriteClient {
     /** Output directory globs for the temporary tsconfig include. */
     lintIncludeGlobs = new Set();
     _logger;
+    /**
+     * @param [logger] логгер записи клиента
+     */
     constructor(logger) {
         this._logger =
             logger ||
@@ -44,7 +47,8 @@ class WriteClient {
                 });
     }
     /**
-     * Write our OpenAPI client, using the given templates at the given output
+     * Записывает OpenAPI-клиент по шаблонам в выходные директории.
+     * @param options параметры записи клиента
      */
     async writeClient(options) {
         const { client, templates, outputPaths, httpClient, useOptions, useUnionTypes, excludeCoreServiceFiles = false, request, customExecutorPath, useCancelableRequest = false, useSeparatedIndexes = false, validationLibrary = ValidationLibrary_enum_1.ValidationLibrary.NONE, emptySchemaStrategy, modelsMode, prettierConfigPath, } = options;
@@ -77,6 +81,7 @@ class WriteClient {
                 useOptions,
                 useCancelableRequest,
                 prettierConfigPath,
+                modelsMode,
             });
             await this.writeClientServicesIndex({
                 services: client.services,
@@ -195,8 +200,8 @@ class WriteClient {
         });
     }
     /**
-     * Method keeps all options that is need to create index file
-     * @param config
+     * Сохраняет конфигурацию генератора для последующей сборки index-файла.
+     * @param config конфигурация генератора клиента
      */
     buildClientGeneratorConfigMap(config) {
         const { outputPaths } = config;
@@ -208,32 +213,48 @@ class WriteClient {
             this.config.set(outputPaths.output, Array.of(config));
         }
     }
+    /** Собирает и записывает полный index клиента. */
     async combineAndWrite() {
         const result = this.buildClientIndexMap();
         await this.finalizeAndWrite(result);
     }
+    /** Собирает и записывает упрощённый index клиента. */
     async combineAndWrightSimple() {
         const result = this.buildSimpleClientIndexMap();
         await this.simpledFinalizeAndWrite(result);
     }
+    /** Логгер записи клиента. */
     get logger() {
         return this._logger;
     }
+    /**
+     * Записывает выходной файл, если содержимое изменилось.
+     * @param filePath путь к файлу
+     * @param content содержимое файла
+     * @returns результат записи: written или unchanged
+     */
     async writeOutputFile(filePath, content) {
         this.expectedOutputFiles.add((0, pathHelpers_1.resolveHelper)(process.cwd(), filePath));
         const result = await (0, writeFileIfChanged_1.writeFileIfChanged)(filePath, content);
         this.writeStats[result] += 1;
         return result;
     }
+    /**
+     * Регистрирует ожидаемый выходной файл без записи содержимого.
+     * @param filePath путь к файлу
+     */
     registerOutputFile(filePath) {
         this.expectedOutputFiles.add((0, pathHelpers_1.resolveHelper)(process.cwd(), filePath));
     }
+    /** Возвращает множество ожидаемых выходных файлов. */
     getExpectedOutputFiles() {
         return this.expectedOutputFiles;
     }
+    /** Возвращает список ожидаемых выходных файлов. */
     getExpectedOutputFilesArray() {
         return Array.from(this.expectedOutputFiles);
     }
+    /** Возвращает статистику записи файлов. */
     getWriteStats() {
         return { ...this.writeStats };
     }
@@ -406,16 +427,27 @@ class WriteClient {
     isSomeService(a, name, pkg) {
         return a.name === name && a.package === pkg;
     }
+    /** Делегирует запись core-части клиента. */
     writeClientCore = writeClientCore_1.writeClientCore;
+    /** Делегирует запись index core-части. */
     writeClientCoreIndex = writeClientCoreIndex_1.writeClientCoreIndex;
+    /** Делегирует запись полного index клиента. */
     writeClientFullIndex = writeClientFullIndex_1.writeClientFullIndex;
+    /** Делегирует запись моделей клиента. */
     writeClientModels = writeClientModels_1.writeClientModels;
+    /** Делегирует запись index моделей. */
     writeClientModelsIndex = writeClientModelsIndex_1.writeClientModelsIndex;
+    /** Делегирует запись схем клиента. */
     writeClientSchemas = writeClientSchemas_1.writeClientSchemas;
+    /** Делегирует запись index схем. */
     writeClientSchemasIndex = writeClientSchemasIndex_1.writeClientSchemasIndex;
+    /** Делегирует запись сервисов клиента. */
     writeClientServices = writeClientServices_1.writeClientServices;
+    /** Делегирует запись index сервисов. */
     writeClientServicesIndex = writeClientServicesIndex_1.writeClientServicesIndex;
+    /** Делегирует запись упрощённого index клиента. */
     writeClientSimpleIndex = writeClientSimpleIndex_1.writeClientSimpleIndex;
+    /** Делегирует запись executor клиента. */
     writeClientExecutor = writeClientExecutor_1.writeClientExecutor;
 }
 exports.WriteClient = WriteClient;

package/dist/core/semanticDiff/__tests__/analyzeOpenApiDiff.test.js

@@ -44,6 +44,78 @@ const analyzeOpenApiDiff_1 = require("../analyzeOpenApiDiff");
         node_assert_1.default.ok(report.changes.some(change => change.type === 'model.removed'));
         node_assert_1.default.ok(report.changes.some(change => change.type === 'operation.removed'));
     });
+    (0, node_test_1.test)('includes from/to on property type and enum value changes', () => {
+        const oldSpec = {
+            openapi: '3.0.0',
+            paths: {},
+            components: {
+                schemas: {
+                    User: {
+                        type: 'object',
+                        properties: {
+                            age: { type: 'number' },
+                            role: { enum: ['user', 'admin'] },
+                        },
+                    },
+                },
+            },
+        };
+        const newSpec = {
+            openapi: '3.0.0',
+            paths: {},
+            components: {
+                schemas: {
+                    User: {
+                        type: 'object',
+                        properties: {
+                            age: { type: 'integer' },
+                            role: { enum: ['admin'] },
+                        },
+                    },
+                },
+            },
+        };
+        const report = (0, analyzeOpenApiDiff_1.analyzeOpenApiDiff)(oldSpec, newSpec);
+        const typeChange = report.changes.find(change => change.type === 'model.property.type.changed' && change.path.includes('/age'));
+        const roleTypeChange = report.changes.find(change => change.type === 'model.property.type.changed' && change.path.includes('/role'));
+        node_assert_1.default.strictEqual(typeChange?.from, 'number');
+        node_assert_1.default.strictEqual(typeChange?.to, 'integer');
+        node_assert_1.default.strictEqual(roleTypeChange?.from, 'enum(admin|user)');
+        node_assert_1.default.strictEqual(roleTypeChange?.to, 'enum(admin)');
+    });
+    (0, node_test_1.test)('includes operation metadata on operation.removed', () => {
+        const oldSpec = {
+            openapi: '3.0.0',
+            paths: {
+                '/pets': {
+                    get: {
+                        operationId: 'listPets',
+                        summary: 'List pets',
+                        description: 'Returns pets',
+                        tags: ['pets'],
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+            components: { schemas: {} },
+        };
+        const newSpec = {
+            openapi: '3.0.0',
+            paths: {},
+            components: { schemas: {} },
+        };
+        const report = (0, analyzeOpenApiDiff_1.analyzeOpenApiDiff)(oldSpec, newSpec);
+        const removed = report.changes.find(change => change.type === 'operation.removed');
+        node_assert_1.default.ok(removed);
+        node_assert_1.default.deepStrictEqual(removed?.from, {
+            operationId: 'listPets',
+            summary: 'List pets',
+            description: 'Returns pets',
+            tags: ['pets'],
+        });
+    });
     (0, node_test_1.test)('detects property required/type changes and enum changes', () => {
         const oldSpec = {
             openapi: '3.0.0',

package/dist/core/semanticDiff/__tests__/semanticDiffReportSchema.test.js

@@ -5,11 +5,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
 const node_test_1 = require("node:test");
+const DiffReport_model_1 = require("../../types/DiffReport.model");
+const adapters_1 = require("../../utils/adapters");
 const analyzeOpenApiDiff_1 = require("../analyzeOpenApiDiff");
 const semanticDiffReportSchema_1 = require("../semanticDiffReportSchema");
 (0, node_test_1.describe)('@unit: semanticDiffReportSchema', () => {
     (0, node_test_1.test)('validates report produced by analyzeOpenApiDiff', () => {
-        const report = (0, analyzeOpenApiDiff_1.analyzeOpenApiDiff)({
+        const semanticReport = (0, analyzeOpenApiDiff_1.analyzeOpenApiDiff)({
             openapi: '3.0.0',
             paths: {
                 '/ping': {
@@ -35,6 +37,23 @@ const semanticDiffReportSchema_1 = require("../semanticDiffReportSchema");
             },
             components: { schemas: {} },
         });
+        const report = {
+            schemaVersion: DiffReport_model_1.UNIFIED_DIFF_REPORT_SCHEMA_VERSION,
+            timestamp: '2026-01-01T00:00:00.000Z',
+            metadata: {
+                base: 'old',
+                target: 'new',
+                baseHash: 'old-hash',
+                targetHash: 'new-hash',
+            },
+            semantic: {
+                changes: semanticReport.changes,
+                governance: semanticReport.governance,
+                recommendation: semanticReport.recommendation,
+                summary: semanticReport.summary,
+            },
+            structural: (0, adapters_1.adaptSemanticToStructural)(semanticReport),
+        };
         const validation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
         node_assert_1.default.strictEqual(validation.valid, true, validation.errors.join('\n'));
     });