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

package/dist/core/utils/expandOpenApiRefsForSemanticDiff.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandOpenApiRefsForSemanticDiff = expandOpenApiRefsForSemanticDiff;
+const path_1 = __importDefault(require("path"));
+const pathHelpers_1 = require("../../common/utils/pathHelpers");
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function isUrlLike(value) {
+    return /^[a-z][a-z\d+\-.]*:/i.test(value);
+}
+function normalizeSourceFile(sourceFile) {
+    if (!sourceFile || isUrlLike(sourceFile)) {
+        return sourceFile;
+    }
+    return (0, pathHelpers_1.normalizeHelper)(sourceFile);
+}
+function parseRef(ref) {
+    const fragmentIndex = ref.indexOf('#');
+    if (fragmentIndex === -1) {
+        return { file: ref || undefined };
+    }
+    const file = ref.slice(0, fragmentIndex);
+    const pointer = ref.slice(fragmentIndex);
+    return {
+        file: file || undefined,
+        pointer: pointer || '#',
+    };
+}
+function normalizeRefFile(file, currentSourceFile) {
+    if (!file) {
+        return normalizeSourceFile(currentSourceFile);
+    }
+    if (isUrlLike(file)) {
+        return file;
+    }
+    if (path_1.default.isAbsolute(file)) {
+        return (0, pathHelpers_1.normalizeHelper)(file);
+    }
+    if (currentSourceFile && !isUrlLike(currentSourceFile)) {
+        return (0, pathHelpers_1.resolveHelper)(path_1.default.dirname(currentSourceFile), file);
+    }
+    return (0, pathHelpers_1.normalizeHelper)(file);
+}
+function createCanonicalRef(ref, currentSourceFile) {
+    const parsed = parseRef(ref);
+    const sourceFile = normalizeRefFile(parsed.file, currentSourceFile);
+    const pointer = parsed.pointer;
+    if (!sourceFile) {
+        return { canonicalRef: pointer ?? ref, pointer };
+    }
+    return {
+        canonicalRef: `${sourceFile}${pointer ?? ''}`,
+        sourceFile,
+        pointer,
+    };
+}
+function decodeJsonPointerSegment(segment) {
+    return decodeURIComponent(segment).replace(/~1/g, '/').replace(/~0/g, '~');
+}
+function resolveJsonPointer(root, pointer) {
+    if (!pointer || pointer === '#') {
+        return root;
+    }
+    if (!pointer.startsWith('#/')) {
+        return undefined;
+    }
+    return pointer
+        .slice(2)
+        .split('/')
+        .map(decodeJsonPointerSegment)
+        .reduce((current, segment) => {
+        if (Array.isArray(current)) {
+            const index = Number(segment);
+            return Number.isInteger(index) ? current[index] : undefined;
+        }
+        if (isRecord(current)) {
+            return current[segment];
+        }
+        return undefined;
+    }, root);
+}
+function readRefFromResolver(refs, candidates) {
+    if (!refs) {
+        return undefined;
+    }
+    for (const candidate of candidates) {
+        try {
+            if (refs.exists && !refs.exists(candidate)) {
+                continue;
+            }
+            const value = refs.get(candidate);
+            if (value !== undefined) {
+                return value;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return undefined;
+}
+function resolveRef(root, ref, currentSourceFile, options) {
+    const normalized = createCanonicalRef(ref, currentSourceFile);
+    const candidates = [normalized.canonicalRef, ref];
+    const resolvedFromRefs = readRefFromResolver(options.refs, [...new Set(candidates)]);
+    if (resolvedFromRefs !== undefined) {
+        return {
+            canonicalRef: normalized.canonicalRef,
+            sourceFile: normalized.sourceFile,
+            value: resolvedFromRefs,
+        };
+    }
+    const rootSourceFile = normalizeSourceFile(options.sourceFile);
+    const isLocalRootRef = !normalized.sourceFile || normalized.sourceFile === rootSourceFile;
+    if (isLocalRootRef) {
+        const resolvedFromRoot = resolveJsonPointer(root, normalized.pointer);
+        if (resolvedFromRoot !== undefined) {
+            return {
+                canonicalRef: normalized.canonicalRef,
+                sourceFile: rootSourceFile,
+                value: resolvedFromRoot,
+            };
+        }
+    }
+    return null;
+}
+function expandNode(root, node, currentSourceFile, options, refStack) {
+    if (Array.isArray(node)) {
+        return node.map(item => expandNode(root, item, currentSourceFile, options, refStack));
+    }
+    if (!isRecord(node)) {
+        return node;
+    }
+    const ref = node.$ref;
+    if (typeof ref === 'string') {
+        const target = resolveRef(root, ref, currentSourceFile, options);
+        if (!target) {
+            return { ...node };
+        }
+        if (refStack.has(target.canonicalRef)) {
+            return { $ref: ref };
+        }
+        const nextStack = new Set(refStack);
+        nextStack.add(target.canonicalRef);
+        return expandNode(root, target.value, target.sourceFile ?? currentSourceFile, options, nextStack);
+    }
+    return Object.fromEntries(Object.entries(node).map(([key, value]) => [key, expandNode(root, value, currentSourceFile, options, refStack)]));
+}
+/**
+ * Строит клон спецификации с развёрнутыми refs для семантического сравнения.
+ * Циклы и неразрешённые refs остаются стабильными `$ref`-объектами.
+ * @param root корневой узел OpenAPI-документа
+ * @param [options] опции резолва ссылок
+ * @returns клон с развёрнутыми refs
+ */
+function expandOpenApiRefsForSemanticDiff(root, options = {}) {
+    const sourceFile = normalizeSourceFile(options.sourceFile);
+    return expandNode(root, root, sourceFile, options, new Set());
+}

package/dist/core/utils/getOpenApiSpec.d.ts

@@ -1,4 +1,10 @@
 import { Context } from '../Context';
 import { CommonOpenApi } from '../types/shared/CommonOpenApi.model';
+/**
+ * Загружает и резолвит OpenAPI-спецификацию для генерации клиента.
+ * @param context контекст генерации
+ * @param input путь к файлу спецификации
+ * @returns загруженная OpenAPI-спецификация
+ */
 export declare function getOpenApiSpec(context: Context, input: string): Promise<CommonOpenApi>;
 //# sourceMappingURL=getOpenApiSpec.d.ts.map

package/dist/core/utils/getOpenApiSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getOpenApiSpec.d.ts","sourceRoot":"","sources":["../../../src/core/utils/getOpenApiSpec.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyB5F"}
+{"version":3,"file":"getOpenApiSpec.d.ts","sourceRoot":"","sources":["../../../src/core/utils/getOpenApiSpec.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyB5F"}

package/dist/core/utils/getOpenApiSpec.js

@@ -7,6 +7,12 @@ exports.getOpenApiSpec = getOpenApiSpec;
 const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
 const fileSystemHelpers_1 = require("../../common/utils/fileSystemHelpers");
 const pathHelpers_1 = require("../../common/utils/pathHelpers");
+/**
+ * Загружает и резолвит OpenAPI-спецификацию для генерации клиента.
+ * @param context контекст генерации
+ * @param input путь к файлу спецификации
+ * @returns загруженная OpenAPI-спецификация
+ */
 async function getOpenApiSpec(context, input) {
     const absoluteInput = (0, pathHelpers_1.resolveHelper)(process.cwd(), input);
     if (!input) {

package/dist/core/utils/getOperationErrors.d.ts

@@ -1,4 +1,4 @@
-import { OperationError } from "../types/shared/OperationError.model";
-import { OperationResponse } from "../types/shared/OperationResponse.model";
+import { OperationError } from '../types/shared/OperationError.model';
+import { OperationResponse } from '../types/shared/OperationResponse.model';
 export declare function getOperationErrors(operationResponses: OperationResponse[]): OperationError[];
 //# sourceMappingURL=getOperationErrors.d.ts.map

package/dist/core/utils/getOperationErrors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getOperationErrors.d.ts","sourceRoot":"","sources":["../../../src/core/utils/getOperationErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAI5E,wBAAgB,kBAAkB,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,GAAG,cAAc,EAAE,CAS5F"}
+{"version":3,"file":"getOperationErrors.d.ts","sourceRoot":"","sources":["../../../src/core/utils/getOperationErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAG5E,wBAAgB,kBAAkB,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,GAAG,cAAc,EAAE,CAS5F"}

package/dist/core/utils/getOperationResults.d.ts

@@ -1,3 +1,3 @@
-import { OperationResponse } from "../types/shared/OperationResponse.model";
+import { OperationResponse } from '../types/shared/OperationResponse.model';
 export declare function getOperationResults(operationResponses: OperationResponse[]): OperationResponse[];
 //# sourceMappingURL=getOperationResults.d.ts.map

package/dist/core/utils/getPropertyGroupSimple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getPropertyGroupSimple.d.ts","sourceRoot":"","sources":["../../../src/core/utils/getPropertyGroupSimple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAGxE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,mBAAmB,CAIrE"}
+{"version":3,"file":"getPropertyGroupSimple.d.ts","sourceRoot":"","sources":["../../../src/core/utils/getPropertyGroupSimple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAGxE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,mBAAmB,CAErE"}

package/dist/core/utils/getPropertyGroupSimple.js

@@ -3,7 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPropertyGroupSimple = getPropertyGroupSimple;
 // Auxiliary function for defining a property group
 function getPropertyGroupSimple(prop) {
-    return prop.isRequired && prop.default === undefined
-        ? 'requires-value'
-        : 'other';
+    return prop.isRequired && prop.default === undefined ? 'requires-value' : 'other';
 }

package/dist/core/utils/isSubdirectory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isSubdirectory.d.ts","sourceRoot":"","sources":["../../../src/core/utils/isSubdirectory.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAK3D"}
+{"version":3,"file":"isSubdirectory.d.ts","sourceRoot":"","sources":["../../../src/core/utils/isSubdirectory.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAK3D"}

package/dist/core/utils/loadDiffReport.d.ts

@@ -1,39 +1,20 @@
 import type { Logger } from '../../common/Logger';
-import type { DiffInfo } from '../types/shared/DiffInfo.model';
-import type { MiracleEntry } from '../types/shared/Miracle.model';
-export interface DiffReportEntry extends DiffInfo {
-    action: DiffInfo['action'];
-}
-export interface DiffReport {
-    version?: string;
-    timestamp?: string;
-    metadata?: {
-        base?: string;
-        target?: string;
-        baseHash?: string;
-        targetHash?: string;
-    };
-    stats?: {
-        totalChanges?: number;
-        added?: number;
-        removed?: number;
-        changed?: number;
-        ignored?: number;
-    };
-    diff?: {
-        breaking?: DiffReportEntry[];
-        warnings?: DiffReportEntry[];
-        info?: DiffReportEntry[];
-        all?: DiffReportEntry[];
-    };
-    miracles?: MiracleEntry[];
-}
+import { type DiffReport, type DiffReportEntry } from '../types/DiffReport.model';
+/** Реэкспорт типов legacy diff-отчёта. */
+export type { DiffReport, DiffReportEntry };
 type LoadDiffReportParams = {
     useHistory?: boolean;
     diffReport?: string;
     inputPath?: string;
     logger: Logger;
 };
+/**
+ * Загружает diff-отчёт с диска и приводит его к legacy-формату для генерации.
+ * @param useHistory признак использования истории изменений; отчёт загружается только при true
+ * @param [diffReport] путь к файлу отчёта
+ * @param [inputPath] путь к входной спецификации для проверки актуальности отчёта
+ * @param logger логгер для диагностических сообщений
+ * @returns legacy diff-отчёт или null, если отчёт отсутствует или устарел
+ */
 export declare const loadDiffReport: ({ useHistory, diffReport, inputPath, logger }: LoadDiffReportParams) => DiffReport | null;
-export {};
 //# sourceMappingURL=loadDiffReport.d.ts.map

package/dist/core/utils/loadDiffReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadDiffReport.d.ts","sourceRoot":"","sources":["../../../src/core/utils/loadDiffReport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC7C,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;QACzB,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,KAAK,oBAAoB,GAAG;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF,eAAO,MAAM,cAAc,GAAI,+CAA+C,oBAAoB,KAAG,UAAU,GAAG,IA8BjH,CAAC"}
+{"version":3,"file":"loadDiffReport.d.ts","sourceRoot":"","sources":["../../../src/core/utils/loadDiffReport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,eAAe,EAA8D,MAAM,2BAA2B,CAAC;AAG9I,0CAA0C;AAC1C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;AAE5C,KAAK,oBAAoB,GAAG;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAqDF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,+CAA+C,oBAAoB,KAAG,UAAU,GAAG,IAuDjH,CAAC"}

package/dist/core/utils/loadDiffReport.js

@@ -6,6 +6,43 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadDiffReport = void 0;
 const fs_1 = __importDefault(require("fs"));
 const Consts_1 = require("../../common/Consts");
+const LoggerMessages_1 = require("../../common/LoggerMessages");
+const analyzeOpenApiDiff_1 = require("../semanticDiff/analyzeOpenApiDiff");
+const DiffReport_model_1 = require("../types/DiffReport.model");
+const adapters_1 = require("./adapters");
+const isSemanticDiffReport = (value) => {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const report = value;
+    return report.schemaVersion === analyzeOpenApiDiff_1.SEMANTIC_DIFF_REPORT_SCHEMA_VERSION && Array.isArray(report.changes);
+};
+const isUnifiedDiffReport = (value) => {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const report = value;
+    return report.schemaVersion === DiffReport_model_1.UNIFIED_DIFF_REPORT_SCHEMA_VERSION && !!report.structural && Array.isArray(report.structural.diff?.all);
+};
+const convertSemanticReportToLegacy = (report) => {
+    const structural = (0, adapters_1.adaptSemanticToStructural)(report);
+    return {
+        version: report.schemaVersion,
+        diff: structural.diff,
+        miracles: structural.miracles,
+        stats: structural.stats,
+    };
+};
+const convertUnifiedReportToLegacy = (report) => {
+    return {
+        version: report.schemaVersion,
+        timestamp: report.timestamp,
+        metadata: report.metadata,
+        diff: report.structural.diff,
+        miracles: report.structural.miracles,
+        stats: report.structural.stats,
+    };
+};
 const isFreshEnough = (reportPath, inputPath) => {
     if (!inputPath)
         return true;
@@ -18,33 +55,62 @@ const isFreshEnough = (reportPath, inputPath) => {
         return true;
     }
 };
+/**
+ * Загружает diff-отчёт с диска и приводит его к legacy-формату для генерации.
+ * @param useHistory признак использования истории изменений; отчёт загружается только при true
+ * @param [diffReport] путь к файлу отчёта
+ * @param [inputPath] путь к входной спецификации для проверки актуальности отчёта
+ * @param logger логгер для диагностических сообщений
+ * @returns legacy diff-отчёт или null, если отчёт отсутствует или устарел
+ */
 const loadDiffReport = ({ useHistory, diffReport, inputPath, logger }) => {
-    const shouldLoad = useHistory || !!diffReport;
-    if (!shouldLoad)
+    if (!useHistory)
         return null;
     const reportPath = diffReport || Consts_1.DEFAULT_ANALYZE_DIFF_REPORT_PATH;
     if (!fs_1.default.existsSync(reportPath)) {
-        logger.info(`[openapi-codegen] Diff report not found at "${reportPath}". Skipping history annotations.`);
+        logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.NOT_FOUND(reportPath));
         return null;
     }
     if (!isFreshEnough(reportPath, inputPath)) {
-        logger.warn(`[openapi-codegen] Diff report "${reportPath}" is older than the input spec. Skipping history annotations.`);
+        logger.warn(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.STALE(reportPath));
         return null;
     }
     try {
         const raw = fs_1.default.readFileSync(reportPath, 'utf-8');
         const parsed = JSON.parse(raw);
-        const hasDiffEntries = !!parsed?.diff?.all?.length;
-        const hasMiracles = !!parsed?.miracles?.length;
+        if (isUnifiedDiffReport(parsed)) {
+            const legacyReport = convertUnifiedReportToLegacy(parsed);
+            const hasDiffEntries = !!legacyReport.diff?.all?.length;
+            const hasMiracles = !!legacyReport.miracles?.length;
+            if (!hasDiffEntries && !hasMiracles) {
+                logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.EMPTY(reportPath));
+                return null;
+            }
+            logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.LOADED(reportPath, legacyReport.diff?.all?.length ?? 0, legacyReport.miracles?.length ?? 0));
+            return legacyReport;
+        }
+        if (isSemanticDiffReport(parsed)) {
+            if (!parsed.changes.length) {
+                logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.EMPTY(reportPath));
+                return null;
+            }
+            const legacyReport = convertSemanticReportToLegacy(parsed);
+            logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.LOADED(reportPath, legacyReport.diff?.all?.length ?? 0, legacyReport.miracles?.length ?? 0));
+            return legacyReport;
+        }
+        const legacyReport = parsed;
+        const hasDiffEntries = !!legacyReport?.diff?.all?.length;
+        const hasMiracles = !!legacyReport?.miracles?.length;
         if (!hasDiffEntries && !hasMiracles) {
-            logger.info(`[openapi-codegen] Diff report "${reportPath}" has no entries. Skipping history annotations.`);
+            logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.EMPTY(reportPath));
             return null;
         }
-        return parsed;
+        logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.LOADED(reportPath, legacyReport.diff?.all?.length ?? 0, legacyReport.miracles?.length ?? 0));
+        return legacyReport;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        logger.warn(`[openapi-codegen] Failed to read diff report "${reportPath}": ${message}`);
+        logger.warn(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.READ_FAILED(reportPath, message));
         return null;
     }
 };

package/dist/core/utils/loadSemanticOpenApiSpec.d.ts

@@ -0,0 +1,15 @@
+import { CommonOpenApi } from '../types/shared/CommonOpenApi.model';
+/**
+ * Загружает OpenAPI-файл для семантического diff без полного dereference.
+ * @param input путь к файлу спецификации
+ * @returns спецификация с развёрнутыми refs для семантического сравнения
+ */
+export declare function loadSemanticOpenApiSpec(input: string): Promise<CommonOpenApi>;
+/**
+ * Разворачивает уже загруженный OpenAPI-объект для семантического diff.
+ * @param spec загруженная спецификация
+ * @param [sourceFile] исходный путь к файлу для резолва внешних refs
+ * @returns спецификация с развёрнутыми refs для семантического сравнения
+ */
+export declare function loadSemanticOpenApiObject(spec: unknown, sourceFile?: string): Promise<CommonOpenApi>;
+//# sourceMappingURL=loadSemanticOpenApiSpec.d.ts.map

package/dist/core/utils/loadSemanticOpenApiSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadSemanticOpenApiSpec.d.ts","sourceRoot":"","sources":["../../../src/core/utils/loadSemanticOpenApiSpec.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAqBpE;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBnF;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAW1G"}

package/dist/core/utils/loadSemanticOpenApiSpec.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSemanticOpenApiSpec = loadSemanticOpenApiSpec;
+exports.loadSemanticOpenApiObject = loadSemanticOpenApiObject;
+const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
+const fileSystemHelpers_1 = require("../../common/utils/fileSystemHelpers");
+const pathHelpers_1 = require("../../common/utils/pathHelpers");
+const expandOpenApiRefsForSemanticDiff_1 = require("./expandOpenApiRefsForSemanticDiff");
+function createSwaggerRefsResolver(refs) {
+    return {
+        exists: ref => refs.exists(ref),
+        get: ref => refs.get(ref),
+    };
+}
+function assertOpenApiObject(spec, source) {
+    if (!spec || typeof spec !== 'object' || Array.isArray(spec)) {
+        throw new Error(`Invalid OpenAPI schema at ${source}`);
+    }
+}
+/**
+ * Загружает OpenAPI-файл для семантического diff без полного dereference.
+ * @param input путь к файлу спецификации
+ * @returns спецификация с развёрнутыми refs для семантического сравнения
+ */
+async function loadSemanticOpenApiSpec(input) {
+    const absoluteInput = (0, pathHelpers_1.resolveHelper)(process.cwd(), input);
+    if (!input) {
+        throw new Error(`OpenAPI spec path is empty`);
+    }
+    const exists = await fileSystemHelpers_1.fileSystemHelpers.exists(absoluteInput);
+    if (!exists) {
+        throw new Error(`OpenAPI spec not found: ${absoluteInput}`);
+    }
+    const parser = new swagger_parser_1.default();
+    const resolved = (await parser.resolve(absoluteInput));
+    const raw = resolved.get(absoluteInput);
+    assertOpenApiObject(raw, absoluteInput);
+    return (0, expandOpenApiRefsForSemanticDiff_1.expandOpenApiRefsForSemanticDiff)(raw, {
+        refs: createSwaggerRefsResolver(resolved),
+        sourceFile: absoluteInput,
+    });
+}
+/**
+ * Разворачивает уже загруженный OpenAPI-объект для семантического diff.
+ * @param spec загруженная спецификация
+ * @param [sourceFile] исходный путь к файлу для резолва внешних refs
+ * @returns спецификация с развёрнутыми refs для семантического сравнения
+ */
+async function loadSemanticOpenApiObject(spec, sourceFile) {
+    assertOpenApiObject(spec, sourceFile ?? 'in-memory OpenAPI object');
+    const parser = new swagger_parser_1.default();
+    const resolved = (await parser.resolve(spec));
+    const absoluteSourceFile = sourceFile ? (0, pathHelpers_1.resolveHelper)(process.cwd(), sourceFile) : undefined;
+    return (0, expandOpenApiRefsForSemanticDiff_1.expandOpenApiRefsForSemanticDiff)(spec, {
+        refs: createSwaggerRefsResolver(resolved),
+        sourceFile: absoluteSourceFile,
+    });
+}

package/dist/core/utils/modelHelpers.d.ts

@@ -1,11 +1,18 @@
 import type { Model } from '../types/shared/Model.model';
+type AliasAssignable = {
+    name: string;
+    alias: string;
+};
+/**
+ * Назначает различающие алиасы, когда несколько элементов имеют одно имя.
+ * Первое вхождение сохраняет имя без алиаса; следующие получают $2, $3 и т.д.
+ * @param items массив элементов с полями name и alias
+ * @returns тот же массив с обновлёнными алиасами
+ */
+export declare const assignDuplicateAliases: <T extends AliasAssignable>(items: T[]) => T[];
 /**
  * Assigns alias to models with the same name.
- * Modifies objects of in-place models and returns an array.
- *
- * Example: if there are two models with name="Pet", the following will be assigned:
- * - first: alias="Pet$1"
- * - second: alias="Pet$2"
+ * Modifies objects in-place and returns the same array.
  *
  * @param models - an array of models sorted by name
  * @returns the same array of models (modified)
@@ -25,4 +32,5 @@ export declare function setDuplicateModelAliases(models: Model[]): Model[];
  * @returns the same array of models (modified)
  */
 export declare function resolveModelImports(models: Model[], outputModelsDir: string): Model[];
+export {};
 //# sourceMappingURL=modelHelpers.d.ts.map

package/dist/core/utils/modelHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modelHelpers.d.ts","sourceRoot":"","sources":["../../../src/core/utils/modelHelpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAkBjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,EAAE,CA4ErF"}
+{"version":3,"file":"modelHelpers.d.ts","sourceRoot":"","sources":["../../../src/core/utils/modelHelpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAEzD,KAAK,eAAe,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,eAAe,EAAE,OAAO,CAAC,EAAE,KAAG,CAAC,EAoB/E,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAEjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,EAAE,CAyErF"}

package/dist/core/utils/modelHelpers.js

@@ -3,40 +3,45 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.assignDuplicateAliases = void 0;
 exports.setDuplicateModelAliases = setDuplicateModelAliases;
 exports.resolveModelImports = resolveModelImports;
 const path_1 = __importDefault(require("path"));
 const pathHelpers_1 = require("../../common/utils/pathHelpers");
+/**
+ * Назначает различающие алиасы, когда несколько элементов имеют одно имя.
+ * Первое вхождение сохраняет имя без алиаса; следующие получают $2, $3 и т.д.
+ * @param items массив элементов с полями name и alias
+ * @returns тот же массив с обновлёнными алиасами
+ */
+const assignDuplicateAliases = (items) => {
+    const nameCounts = new Map();
+    items.forEach(item => {
+        nameCounts.set(item.name, (nameCounts.get(item.name) ?? 0) + 1);
+    });
+    const nameIndex = new Map();
+    items.forEach(item => {
+        const count = nameCounts.get(item.name) ?? 1;
+        if (count <= 1) {
+            item.alias = '';
+            return;
+        }
+        const index = (nameIndex.get(item.name) ?? 0) + 1;
+        nameIndex.set(item.name, index);
+        item.alias = index === 1 ? '' : `${item.name}$${index}`;
+    });
+    return items;
+};
+exports.assignDuplicateAliases = assignDuplicateAliases;
 /**
  * Assigns alias to models with the same name.
- * Modifies objects of in-place models and returns an array.
- *
- * Example: if there are two models with name="Pet", the following will be assigned:
- * - first: alias="Pet$1"
- * - second: alias="Pet$2"
+ * Modifies objects in-place and returns the same array.
  *
  * @param models - an array of models sorted by name
  * @returns the same array of models (modified)
  */
 function setDuplicateModelAliases(models) {
-    let previous;
-    let index = 1;
-    models.forEach(model => {
-        if (previous && previous.name === model.name) {
-            if (index === 1) {
-                previous.alias = `${model.name}$${index}`;
-                index++;
-            }
-            model.alias = `${model.name}$${index}`;
-            index++;
-        }
-        else {
-            model.alias = '';
-            index = 1;
-        }
-        previous = model;
-    });
-    return models;
+    return (0, exports.assignDuplicateAliases)(models);
 }
 /**
  * Adjusts the imports fields of the models to relative paths and correct aliases,

package/dist/core/utils/normalizeString.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizeString.d.ts","sourceRoot":"","sources":["../../../src/core/utils/normalizeString.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAUzE"}
+{"version":3,"file":"normalizeString.d.ts","sourceRoot":"","sources":["../../../src/core/utils/normalizeString.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAMzE"}

package/dist/core/utils/normalizeString.js

@@ -6,9 +6,5 @@ function normalizeString(value) {
     if (!value) {
         return value;
     }
-    return value
-        .replace(Consts_1.REGEX_BACKSLASH, '/')
-        .replace(Consts_1.REGEX_MULTIPLE_SLASHES, '/')
-        .replace(Consts_1.REGEX_DOT_SLASH, '/')
-        .replace(Consts_1.REGEX_LEADING_DOT_SLASH, './');
+    return value.replace(Consts_1.REGEX_BACKSLASH, '/').replace(Consts_1.REGEX_MULTIPLE_SLASHES, '/').replace(Consts_1.REGEX_DOT_SLASH, '/').replace(Consts_1.REGEX_LEADING_DOT_SLASH, './');
 }

package/dist/core/utils/postProcessServiceImports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postProcessServiceImports.d.ts","sourceRoot":"","sources":["../../../src/core/utils/postProcessServiceImports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAIpE"}
+{"version":3,"file":"postProcessServiceImports.d.ts","sourceRoot":"","sources":["../../../src/core/utils/postProcessServiceImports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAEpE"}

package/dist/core/utils/postProcessServiceImports.js

@@ -8,7 +8,5 @@ const unique_1 = require("./unique");
  * @param service
  */
 function postProcessServiceImports(service) {
-    return service.imports
-        .filter(unique_1.unique)
-        .sort(sort_1.sort);
+    return service.imports.filter(unique_1.unique).sort(sort_1.sort);
 }