ts-openapi-codegen 2.1.0-beta.1 → 2.1.0-beta.10

package/dist/core/OpenApiClient.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenApiClient = void 0;
+const fs_1 = require("fs");
 const Consts_1 = require("../common/Consts");
 const Logger_1 = require("../common/Logger");
 const LoggerMessages_1 = require("../common/LoggerMessages");
+const TEslintFixOptions_1 = require("../common/TEslintFixOptions");
+const eslintFix_1 = require("../common/utils/eslintFix");
 const fileSystemHelpers_1 = require("../common/utils/fileSystemHelpers");
 const pathHelpers_1 = require("../common/utils/pathHelpers");
 const Parser_1 = require("./api/v2/Parser");
@@ -16,6 +19,7 @@ const EmptySchemaStrategy_enum_1 = require("./types/enums/EmptySchemaStrategy.en
 const ModelsMode_enum_1 = require("./types/enums/ModelsMode.enum");
 const ValidationLibrary_enum_1 = require("./types/enums/ValidationLibrary.enum");
 const applyDiffReportToClient_1 = require("./utils/applyDiffReportToClient");
+const GenerationCache_1 = require("./utils/GenerationCache");
 const getOpenApiSpec_1 = require("./utils/getOpenApiSpec");
 const getOpenApiVersion_1 = require("./utils/getOpenApiVersion");
 const getOutputPaths_1 = require("./utils/getOutputPaths");
@@ -23,9 +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');
@@ -64,6 +77,11 @@ class OpenApiClient {
                 strictOpenapi: rawOptions.strictOpenapi,
                 reportFile: rawOptions.reportFile,
                 governanceConfig: rawOptions.governanceConfig,
+                cache: rawOptions.cache,
+                cachePath: rawOptions.cachePath,
+                cacheStrategy: rawOptions.cacheStrategy,
+                cacheDebug: rawOptions.cacheDebug,
+                prettierConfigPath: rawOptions.prettierConfigPath,
             }));
         }
         else {
@@ -100,6 +118,11 @@ class OpenApiClient {
                     strictOpenapi: rawOptions.strictOpenapi,
                     reportFile: rawOptions.reportFile,
                     governanceConfig: rawOptions.governanceConfig,
+                    cache: rawOptions.cache,
+                    cachePath: rawOptions.cachePath,
+                    cacheStrategy: rawOptions.cacheStrategy,
+                    cacheDebug: rawOptions.cacheDebug,
+                    prettierConfigPath: rawOptions.prettierConfigPath,
                 },
             ];
         }
@@ -138,18 +161,57 @@ class OpenApiClient {
             miracles: item.miracles || Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.miracles,
             strictOpenapi: item.strictOpenapi ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.strictOpenapi,
             reportFile: item.reportFile || Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.reportFile,
-            useProjectPrettier: item.useProjectPrettier ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useProjectPrettier,
-            useEslintFix: item.useEslintFix ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useEslintFix,
+            prettierConfigPath: item.prettierConfigPath ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.prettierConfigPath,
             governanceConfig: item.governanceConfig || Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.governanceConfig,
+            cache: item.cache ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cache,
+            cachePath: item.cachePath || Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cachePath,
+            cacheStrategy: item.cacheStrategy ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cacheStrategy,
+            cacheDebug: item.cacheDebug ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cacheDebug,
         };
     }
-    async cleanOutputDirectories(option) {
-        const outputDirs = [option.output, option.outputCore, option.outputSchemas, option.outputModels, option.outputServices];
-        for (const dir of outputDirs) {
-            if (dir) {
-                await fileSystemHelpers_1.fileSystemHelpers.rmdir(dir);
+    getOutputRoots(items) {
+        const roots = new Set();
+        for (const item of items) {
+            const outputDirs = [item.output, item.outputCore, item.outputSchemas, item.outputModels, item.outputServices];
+            for (const dir of outputDirs) {
+                if (dir) {
+                    roots.add((0, pathHelpers_1.resolveHelper)(process.cwd(), dir));
+                }
             }
         }
+        return Array.from(roots);
+    }
+    async cleanupStaleOutputs(items) {
+        const outputRoots = this.getOutputRoots(items);
+        const expectedFiles = this.writeClient.getExpectedOutputFiles();
+        for (const root of outputRoots) {
+            await this.removeStaleFilesInDirectory(root, expectedFiles);
+        }
+    }
+    async removeStaleFilesInDirectory(path, expectedFiles) {
+        const stats = await fs_1.promises.stat(path).catch(() => null);
+        if (!stats) {
+            return false;
+        }
+        if (stats.isFile()) {
+            if (!expectedFiles.has(path)) {
+                await fileSystemHelpers_1.fileSystemHelpers.rmdir(path);
+                return false;
+            }
+            return true;
+        }
+        const entries = await fs_1.promises.readdir(path);
+        let hasAnyFile = false;
+        for (const entry of entries) {
+            const childPath = (0, pathHelpers_1.resolveHelper)(path, entry);
+            const childHasFiles = await this.removeStaleFilesInDirectory(childPath, expectedFiles);
+            hasAnyFile = hasAnyFile || childHasFiles;
+        }
+        if (!hasAnyFile) {
+            await fileSystemHelpers_1.fileSystemHelpers.rmdir(path);
+            return false;
+        }
+        return true;
     }
     async generateCodeForItems(items) {
         if (items.length === 0) {
@@ -158,12 +220,27 @@ class OpenApiClient {
         this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.STARTED(items.length));
         try {
             const start = process.hrtime.bigint();
-            for (const option of items) {
-                await this.cleanOutputDirectories(option);
+            const cacheEnabled = items[0]?.cache === true;
+            const generationCaches = new Map();
+            if (!cacheEnabled) {
+                this.warnOnSharedOutputsWithoutCache(items);
+            }
+            else {
+                for (const outputRoot of this.getUniqueResolvedOutputs(items)) {
+                    const sampleItem = items.find(item => this.resolveOutputRoot(item.output) === outputRoot);
+                    if (!sampleItem) {
+                        continue;
+                    }
+                    const cachePath = this.resolveCachePathForOutput(sampleItem.output, sampleItem.cachePath);
+                    const generationCache = new GenerationCache_1.GenerationCache(cachePath);
+                    await generationCache.load();
+                    generationCaches.set(outputRoot, generationCache);
+                }
             }
             for (const option of items) {
                 const fileStart = process.hrtime.bigint();
-                await this.generateSingle(option);
+                const generationCache = cacheEnabled ? (generationCaches.get(this.resolveOutputRoot(option.output)) ?? null) : null;
+                await this.generateSingle(option, generationCache);
                 const fileEnd = process.hrtime.bigint();
                 const fileDurationInSeconds = Number(fileEnd - fileStart) / 1e9;
                 this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.DURATION_FOR_FILE(option.input, fileDurationInSeconds.toFixed(3)));
@@ -174,6 +251,15 @@ class OpenApiClient {
             else {
                 await this.writeClient.combineAndWrite();
             }
+            await this.cleanupStaleOutputs(items);
+            if (cacheEnabled) {
+                for (const generationCache of generationCaches.values()) {
+                    await generationCache.save();
+                }
+            }
+            const writeStats = this.writeClient.getWriteStats();
+            this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.WRITE_STATS(writeStats.written, writeStats.unchanged));
+            await this.runBatchEslintFixIfEnabled();
             this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.FINISHED);
             const end = process.hrtime.bigint();
             const durationInSeconds = Number(end - start) / 1e9;
@@ -185,8 +271,34 @@ class OpenApiClient {
         }
         this.writeClient.logger.shutdownLogger();
     }
-    async generateSingle(item) {
-        const { input, output, outputCore, outputServices, outputModels, outputSchemas, httpClient, useOptions, useUnionTypes, excludeCoreServiceFiles, request, plugins, customExecutorPath, interfacePrefix, enumPrefix, typePrefix, useCancelableRequest, sortByRequired, useSeparatedIndexes, validationLibrary = ValidationLibrary_enum_1.ValidationLibrary.NONE, emptySchemaStrategy = EmptySchemaStrategy_enum_1.EmptySchemaStrategy.KEEP, useHistory, diffReport, modelsMode = ModelsMode_enum_1.ModelsMode.INTERFACES, strictOpenapi, reportFile, useProjectPrettier = false, useEslintFix = false, governanceConfig, } = item;
+    getUniqueResolvedOutputs(items) {
+        return Array.from(new Set(items.map(item => this.resolveOutputRoot(item.output))));
+    }
+    resolveOutputRoot(output) {
+        return (0, pathHelpers_1.resolveHelper)(process.cwd(), output);
+    }
+    resolveCachePathForOutput(output, cachePath) {
+        if (cachePath.startsWith('/') || /^[A-Za-z]:[\\/]/.test(cachePath)) {
+            return cachePath;
+        }
+        return (0, pathHelpers_1.resolveHelper)(this.resolveOutputRoot(output), cachePath || OpenApiClient.DEFAULT_CACHE_FILENAME);
+    }
+    warnOnSharedOutputsWithoutCache(items) {
+        const countByOutput = new Map();
+        for (const item of items) {
+            const output = this.resolveOutputRoot(item.output);
+            countByOutput.set(output, (countByOutput.get(output) ?? 0) + 1);
+        }
+        const duplicatedOutputs = Array.from(countByOutput.entries())
+            .filter(([, count]) => count > 1)
+            .map(([output]) => output);
+        if (duplicatedOutputs.length === 0) {
+            return;
+        }
+        this.writeClient.logger.warn(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.CACHE_SHARED_OUTPUT_WARNING(duplicatedOutputs.map(output => `- ${output}`).join('\n')));
+    }
+    async generateSingle(item, generationCache) {
+        const { input, output, outputCore, outputServices, outputModels, outputSchemas, httpClient, useOptions, useUnionTypes, excludeCoreServiceFiles, request, plugins, customExecutorPath, interfacePrefix, enumPrefix, typePrefix, useCancelableRequest, sortByRequired, useSeparatedIndexes, validationLibrary = ValidationLibrary_enum_1.ValidationLibrary.NONE, emptySchemaStrategy = EmptySchemaStrategy_enum_1.EmptySchemaStrategy.KEEP, useHistory, diffReport, modelsMode = ModelsMode_enum_1.ModelsMode.INTERFACES, strictOpenapi, reportFile, prettierConfigPath, governanceConfig, } = item;
         const outputPaths = (0, getOutputPaths_1.getOutputPaths)({
             output,
             outputCore,
@@ -195,6 +307,28 @@ class OpenApiClient {
             outputSchemas,
         });
         const absoluteInput = (0, pathHelpers_1.resolveHelper)(process.cwd(), input);
+        const cacheKey = this.getCacheKey(item, absoluteInput);
+        const cacheFingerprint = await this.getCacheFingerprint(item, absoluteInput);
+        const useEntityCache = item.cache && item.cacheStrategy === 'entity' && generationCache !== null;
+        if (useEntityCache) {
+            const cachedEntry = generationCache.get(cacheKey);
+            if (cachedEntry && cachedEntry.fingerprint === cacheFingerprint) {
+                const allFilesExist = await this.filesExist(cachedEntry.files);
+                if (allFilesExist) {
+                    for (const filePath of cachedEntry.files) {
+                        this.writeClient.registerOutputFile(filePath);
+                    }
+                    if (item.cacheDebug) {
+                        this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.CACHE_HIT(input));
+                    }
+                    return;
+                }
+            }
+            if (item.cacheDebug) {
+                this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.CACHE_MISS(input));
+            }
+        }
+        const knownFilesBefore = new Set(this.writeClient.getExpectedOutputFilesArray());
         const generatorPlugins = await (0, loadGeneratorPlugins_1.loadGeneratorPlugins)(plugins);
         const context = new Context_1.Context({
             input: absoluteInput,
@@ -214,7 +348,7 @@ class OpenApiClient {
                 governanceConfig: governancePolicy,
             });
             const reportPath = await (0, validateOpenApiStrict_1.writeOpenApiStrictReport)(strictReport, reportFile);
-            this.writeClient.logger.forceInfo(`Strict OpenAPI report created: ${reportPath}`);
+            this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.STRICT_REPORT_CREATED(reportPath));
             if (strictReport.summary.errors > 0) {
                 throw new Error(`Strict OpenAPI validation failed with ${strictReport.summary.errors} error(s). Report: ${reportPath}`);
             }
@@ -225,12 +359,17 @@ class OpenApiClient {
             useUnionTypes,
             useOptions,
             validationLibrary,
+            useBatchEslintFix: Boolean(this.eslintFixOptions.tsconfigPath && this.eslintFixOptions.eslintConfigPath),
         });
         const diffReportData = await this.loadDiffReportIfNeeded({
             useHistory,
             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: {
@@ -245,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,
@@ -262,8 +401,7 @@ class OpenApiClient {
                     validationLibrary,
                     emptySchemaStrategy,
                     modelsMode,
-                    useProjectPrettier,
-                    useEslintFix,
+                    prettierConfigPath,
                 });
                 break;
             }
@@ -279,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,
@@ -296,12 +434,108 @@ class OpenApiClient {
                     validationLibrary,
                     emptySchemaStrategy,
                     modelsMode,
-                    useProjectPrettier,
-                    useEslintFix,
+                    prettierConfigPath,
                 });
                 break;
             }
         }
+        const generatedFiles = this.writeClient.getExpectedOutputFilesArray().filter(filePath => !knownFilesBefore.has(filePath));
+        if (item.cache && generationCache) {
+            generationCache.set({
+                key: cacheKey,
+                fingerprint: cacheFingerprint,
+                files: generatedFiles,
+                updatedAt: Date.now(),
+            });
+        }
+    }
+    getCacheKey(item, absoluteInput) {
+        return GenerationCache_1.GenerationCache.hash(JSON.stringify({
+            input: absoluteInput,
+            output: item.output,
+            outputCore: item.outputCore,
+            outputServices: item.outputServices,
+            outputModels: item.outputModels,
+            outputSchemas: item.outputSchemas,
+        }));
+    }
+    async getCacheFingerprint(item, absoluteInput) {
+        const specContent = await fileSystemHelpers_1.fileSystemHelpers.readFile(absoluteInput, 'utf8');
+        const fingerprint = {
+            cacheFingerprintVersion: OpenApiClient.CACHE_FINGERPRINT_VERSION,
+            generatorVersion: process.env.npm_package_version || 'dev',
+            specHash: GenerationCache_1.GenerationCache.hash(specContent),
+            options: {
+                httpClient: item.httpClient,
+                useOptions: item.useOptions,
+                useUnionTypes: item.useUnionTypes,
+                includeSchemasFiles: item.includeSchemasFiles,
+                excludeCoreServiceFiles: item.excludeCoreServiceFiles,
+                request: item.request,
+                plugins: item.plugins,
+                customExecutorPath: item.customExecutorPath,
+                interfacePrefix: item.interfacePrefix,
+                enumPrefix: item.enumPrefix,
+                typePrefix: item.typePrefix,
+                useCancelableRequest: item.useCancelableRequest,
+                sortByRequired: item.sortByRequired,
+                useSeparatedIndexes: item.useSeparatedIndexes,
+                validationLibrary: item.validationLibrary,
+                emptySchemaStrategy: item.emptySchemaStrategy,
+                useHistory: item.useHistory,
+                diffReport: item.diffReport,
+                modelsMode: item.modelsMode,
+                strictOpenapi: item.strictOpenapi,
+            },
+        };
+        return GenerationCache_1.GenerationCache.hash(JSON.stringify(fingerprint));
+    }
+    async filesExist(paths) {
+        for (const filePath of paths) {
+            const exists = await fileSystemHelpers_1.fileSystemHelpers.exists(filePath);
+            if (!exists) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Runs batch ESLint fix after combineAndWrite / combineAndWrightSimple when both paths are set.
+     * Warns and skips when only one path is provided; always clears the WriteClient lint registry.
+     */
+    async runBatchEslintFixIfEnabled() {
+        const opts = this.eslintFixOptions;
+        const hasTsconfig = !!opts.tsconfigPath;
+        const hasEslintConfig = !!opts.eslintConfigPath;
+        if (!hasTsconfig && !hasEslintConfig) {
+            this.writeClient.clearLintTargets();
+            return;
+        }
+        if (!hasTsconfig || !hasEslintConfig) {
+            this.writeClient.logger.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_PATHS_MISSING);
+            this.writeClient.clearLintTargets();
+            return;
+        }
+        try {
+            const { files, includeGlobs } = this.writeClient.getLintTargets();
+            if (files.length === 0) {
+                return;
+            }
+            const fixStart = process.hrtime.bigint();
+            this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_BATCH_STARTED);
+            await (0, eslintFix_1.eslintFixBatch)({
+                files,
+                includeGlobs,
+                tsconfigPath: opts.tsconfigPath,
+                eslintConfigPath: opts.eslintConfigPath,
+            });
+            const fixEnd = process.hrtime.bigint();
+            const durationInSeconds = Number(fixEnd - fixStart) / 1e9;
+            this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_BATCH_FINISHED(durationInSeconds.toFixed(3)));
+        }
+        finally {
+            this.writeClient.clearLintTargets();
+        }
     }
     async loadDiffReportIfNeeded(params) {
         return (0, loadDiffReport_1.loadDiffReport)({
@@ -321,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,
@@ -330,6 +569,7 @@ class OpenApiClient {
             logOutput: rawOptions.logTarget ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.logTarget,
         });
         this._writeClient = new WriteClient_1.WriteClient(logger);
+        this.eslintFixOptions = (0, TEslintFixOptions_1.extractEslintFixOptions)(rawOptions);
         const items = this.normalizeOptions(rawOptions).map(item => this.addDefaultValues(item));
         await this.generateCodeForItems(items);
     }

package/dist/core/WriteClient.d.ts

@@ -18,18 +18,25 @@ import { writeClientSchemasIndex } from './utils/writeClientSchemasIndex';
 import { writeClientServices } from './utils/writeClientServices';
 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;
@@ -46,32 +53,81 @@ type TWriteClientProps = {
     validationLibrary?: ValidationLibrary;
     emptySchemaStrategy: EmptySchemaStrategy;
     modelsMode?: ModelsMode;
-    useProjectPrettier?: boolean;
-    useEslintFix?: boolean;
+    prettierConfigPath?: string;
 };
 type TAPIClientGeneratorConfig = Omit<TWriteClientProps, 'httpClient' | 'useOptions' | 'request' | 'useCancelableRequest' | 'useSeparatedIndexes'> & {
     schemaModels: Model[];
 };
 /**
- * The client which is writing all items and keep the parameters to write index file
+ * Клиент записи сгенерированных артефактов и сборки index-файлов.
  */
 export declare class WriteClient {
     private config;
+    private expectedOutputFiles;
+    private writeStats;
+    /** Absolute paths of generated model/service files for batch ESLint. */
+    private lintTargetFiles;
+    /** 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;
+    };
+    /**
+     * Registers a generated file for the post-generation batch ESLint pass.
+     *
+     * @param filePath - Written file path (absolute or relative to cwd).
+     * @param outputRoot - Models or services output directory used to build a narrow tsconfig glob.
+     */
+    registerLintTarget(filePath: string, outputRoot: string): void;
+    /**
+     * Returns collected lint targets after all writeClient* calls.
+     */
+    getLintTargets(): {
+        files: string[];
+        includeGlobs: string[];
+    };
+    /** Clears the lint registry after batch ESLint finishes or is skipped. */
+    clearLintTargets(): void;
     private buildSimpleClientIndexMap;
     private buildClientIndexMap;
     private finalizeAndWrite;
@@ -82,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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"}