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

package/package.json

@@ -1,139 +1,133 @@
 {
-    "name": "ts-openapi-codegen",
-    "version": "2.1.0-beta.7",
-    "description": "Library that generates Typescript clients based on the OpenAPI specification. It bases on openapi-typescript-codegen",
-    "author": "Alexey Zverev",
-    "homepage": "https://github.com/ozonophore/openapi-codegen.git",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/ozonophore/openapi-codegen.git"
-    },
-    "bugs": {
-        "url": "https://github.com/ozonophore/openapi-codegen.git"
-    },
-    "license": "MIT",
-    "languageName": "node",
-    "keywords": [
-        "openapi",
-        "swagger",
-        "codegen",
-        "generator",
-        "client",
-        "typescript",
-        "yaml",
-        "json",
-        "fetch",
-        "xhr",
-        "node",
-        "axios"
-    ],
-    "maintainers": [
-        {
-            "name": "Alexey Zverev",
-            "email": "ozonophore@gmail.com"
-        }
-    ],
-    "main": "dist/index.js",
-    "module": "dist/index.js",
-    "types": "dist/index.d.ts",
-    "bin": {
-        "openapi-codegen-cli": "dist/cli/index.js"
-    },
-    "directories": {
-        "example": "example"
-    },
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "clean": "shx rm -rf ./dist ./generated ./test/generated ./test/e2e/generated ./samples/generated ./coverage ./node_modules/.cache",
-        "build": "tsc -p .",
-        "build:hbs": "tsx ./src/core/utils/precompileTemplates.ts",
-        "release": "npm run build:hbs && npm run build",
-        "run": "node ./test/index.js",
-        "test:unit": "node --experimental-test-coverage --import tsx --test-name-pattern \"@unit\" --test \"**/*.test.ts\"",
-        "test:update": "UPDATE_SNAPSHOTS=true npm run test:unit",
-        "test:coverage": "node --experimental-test-coverage --import tsx --test-name-pattern \"@unit\" --test \"**/*.test.ts\"",
-        "eslint": "eslint \"./src/**/*.ts\"",
-        "eslint:fix": "eslint \"./src/**/*.ts\" --fix",
-        "prettier": "prettier \"./src/**/*.ts\" \"./types/index.d.ts\" --check",
-        "prettier:fix": "prettier \"./src/**/*.ts\" \"./types/index.d.ts\" --write",
-        "prepublish": "npm run clean && npm run release",
-        "codecov": "codecov --token=89a9fe76-2714-4b5b-83e3-9d809615064d",
-        "find-deadcode": "knip"
-    },
-    "dependencies": {
-        "@apidevtools/swagger-parser": "12.0.0",
-        "boxen": "^5.1.2",
-        "camelcase": "6.2.0",
-        "chalk": "^4.1.2",
-        "commander": "9.0.0",
-        "configstore": "^5.0.1",
-        "deep-diff": "^1.0.2",
-        "diff": "^8.0.2",
-        "enquirer": "^2.4.1",
-        "fast-deep-equal": "^3.1.3",
-        "figlet": "^1.8.0",
-        "handlebars": "4.7.6",
-        "joi": ">=17.13.3",
-        "json-schema": "0.4.0",
-        "leven": "^4.0.0",
-        "semver": "^7.7.1",
-        "ts-morph": "^28.0.0",
-        "winston": "^3.17.0",
-        "winston-daily-rotate-file": "^5.0.0",
-        "zod": ">=4.3.2"
-    },
-    "devDependencies": {
-        "@babel/cli": "7.14.8",
-        "@babel/core": "7.14.8",
-        "@babel/preset-env": "7.14.9",
-        "@babel/preset-typescript": "7.14.5",
-        "@eslint/compat": "^1.3.0",
-        "@eslint/eslintrc": "^3.3.1",
-        "@eslint/js": "^9.29.0",
-        "@types/axios": "^0.14.0",
-        "@types/configstore": "^6.0.2",
-        "@types/deep-diff": "^1.0.5",
-        "@types/express": "4.17.13",
-        "@types/figlet": "^1.5.8",
-        "@types/glob": "^8.1.0",
-        "@types/json-schema": "^7.0.15",
-        "@types/node": "^22.5.1",
-        "@types/node-fetch": "2.5.12",
-        "@types/prettier": "3.0.0",
-        "@types/qs": "6.9.7",
-        "@types/semver": "^7.7.0",
-        "@types/winston": "^2.4.4",
-        "@typescript-eslint/eslint-plugin": "^8.34.1",
-        "@typescript-eslint/parser": "^8.34.1",
-        "abort-controller": "^3.0.0",
-        "axios": "1.8.2",
-        "codecov": "3.8.3",
-        "eslint": "^9.29.0",
-        "eslint-config-prettier": "^10.1.5",
-        "eslint-plugin-jsdoc": "^51.0.3",
-        "eslint-plugin-lodash": "^8.0.0",
-        "eslint-plugin-prettier": "^5.5.0",
-        "eslint-plugin-simple-import-sort": "^12.1.1",
-        "express": "4.17.1",
-        "form-data": "4.0.0",
-        "glob": "7.1.7",
-        "globals": "^16.2.0",
-        "knip": "^5.77.1",
-        "node-fetch": "2.6.1",
-        "prettier": "^3.4.2",
-        "puppeteer": "10.1.0",
-        "qs": "6.10.1",
-        "shx": "^0.4.0",
-        "tsx": "^4.20.3",
-        "typescript": "^5.8.3",
-        "zod": "^4.3.2"
-    },
-    "peerDependencies": {
-        "axios": ">=1.8.2",
-        "joi": ">=17.13.3",
-        "prettier": ">=3.4.2",
-        "zod": ">=4.3.2"
+  "name": "ts-openapi-codegen",
+  "version": "2.1.0-beta.9",
+  "description": "Library that generates Typescript clients based on the OpenAPI specification. It bases on openapi-typescript-codegen",
+  "author": "Alexey Zverev",
+  "homepage": "https://github.com/ozonophore/openapi-codegen.git",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ozonophore/openapi-codegen.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ozonophore/openapi-codegen.git"
+  },
+  "license": "MIT",
+  "languageName": "node",
+  "keywords": [
+    "openapi",
+    "swagger",
+    "codegen",
+    "generator",
+    "client",
+    "typescript",
+    "yaml",
+    "json",
+    "fetch",
+    "xhr",
+    "node",
+    "axios"
+  ],
+  "maintainers": [
+    {
+      "name": "Alexey Zverev",
+      "email": "ozonophore@gmail.com"
     }
+  ],
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openapi-codegen-cli": "dist/cli/index.js"
+  },
+  "directories": {
+    "example": "example"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "shx rm -rf ./dist ./generated ./test/generated ./test/e2e/generated ./samples/generated ./coverage ./node_modules/.cache",
+    "build": "tsc -p .",
+    "build:hbs": "tsx ./src/core/utils/precompileTemplates.ts",
+    "release": "npm run build:hbs && npm run build",
+    "run": "node ./test/index.js",
+    "test:unit": "node --experimental-test-coverage --import tsx --test-name-pattern \"@unit\" --test \"**/*.test.ts\"",
+    "test:update": "UPDATE_SNAPSHOTS=true npm run test:unit",
+    "test:coverage": "node --experimental-test-coverage --import tsx --test-name-pattern \"@unit\" --test \"**/*.test.ts\"",
+    "eslint": "eslint \"./src/**/*.ts\"",
+    "eslint:fix": "eslint \"./src/**/*.ts\" --fix",
+    "prettier": "prettier \"./src/**/*.ts\" --check",
+    "prettier:fix": "prettier \"./src/**/*.ts\" --write",
+    "prepublish": "npm run clean && npm run release",
+    "codecov": "codecov --token=89a9fe76-2714-4b5b-83e3-9d809615064d",
+    "checkTypes": "tsc --noEmit",
+    "find-deadcode:dev": "knip",
+    "find-deadcode": "knip --production --strict",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@apidevtools/swagger-parser": "12.0.0",
+    "boxen": "^5.1.2",
+    "camelcase": "6.2.0",
+    "chalk": "^4.1.2",
+    "commander": "9.0.0",
+    "configstore": "^5.0.1",
+    "diff": "^8.0.2",
+    "enquirer": "^2.4.1",
+    "fast-deep-equal": "^3.1.3",
+    "figlet": "^1.8.0",
+    "handlebars": "4.7.6",
+    "json-schema": "0.4.0",
+    "leven": "^4.0.0",
+    "semver": "^7.7.1",
+    "ts-morph": "^28.0.0",
+    "typescript": "^5.8.3",
+    "winston": "^3.17.0",
+    "winston-daily-rotate-file": "^5.0.0",
+    "zod": ">=4.3.2"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.0",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.29.0",
+    "@types/axios": "^0.14.0",
+    "@types/configstore": "^6.0.2",
+    "@types/figlet": "^1.5.8",
+    "@types/glob": "^8.1.0",
+    "@types/json-schema": "^7.0.15",
+    "@types/node": "^22.5.1",
+    "@types/node-fetch": "2.5.12",
+    "@types/prettier": "3.0.0",
+    "@types/qs": "6.9.7",
+    "@types/semver": "^7.7.0",
+    "@types/winston": "^2.4.4",
+    "@typescript-eslint/eslint-plugin": "^8.34.1",
+    "@typescript-eslint/parser": "^8.34.1",
+    "abort-controller": "^3.0.0",
+    "axios": "1.8.2",
+    "codecov": "3.8.3",
+    "eslint": "^9.29.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-jsdoc": "^51.0.3",
+    "eslint-plugin-lodash": "^8.0.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "form-data": "4.0.0",
+    "glob": "7.1.7",
+    "globals": "^16.2.0",
+    "husky": "^9.1.7",
+    "knip": "^5.77.1",
+    "lint-staged": "^16.4.0",
+    "node-fetch": "2.6.1",
+    "prettier": "^3.4.2",
+    "qs": "6.10.1",
+    "shx": "^0.4.0",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "zod": "^4.3.2"
+  },
+  "peerDependencies": {
+    "axios": ">=1.8.2",
+    "prettier": ">=3.4.2",
+    "zod": ">=4.3.2"
+  }
 }

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

@@ -1,17 +0,0 @@
-import type { DiffReport, IgnoreRule, JsonValue } from './types';
-type BuildLegacyReportParams = {
-    baseLabel: string;
-    targetLabel: string;
-    oldSpec: JsonValue;
-    newSpec: JsonValue;
-    ignoreRules: IgnoreRule[];
-};
-/**
- * Собирает legacy diff-отчет по сравнению двух спецификаций.
- */
-export declare function buildLegacyReport(params: BuildLegacyReportParams): {
-    report: DiffReport;
-    ignored: number;
-};
-export {};
-//# sourceMappingURL=buildLegacyReport.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"buildLegacyReport.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/buildLegacyReport.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAa,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE5E,KAAK,uBAAuB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6C1G"}

package/dist/cli/analyzeDiff/buildLegacyReport.js

@@ -1,54 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildLegacyReport = buildLegacyReport;
-const crypto_1 = __importDefault(require("crypto"));
-const diffEngine_1 = require("./diffEngine");
-const ignoreRules_1 = require("./ignoreRules");
-const miracles_1 = require("./miracles");
-/**
- * Собирает legacy diff-отчет по сравнению двух спецификаций.
- */
-function buildLegacyReport(params) {
-    const { baseLabel, targetLabel, oldSpec, newSpec, ignoreRules } = params;
-    const normalizedOld = (0, diffEngine_1.normalizeForDiff)(oldSpec);
-    const normalizedNew = (0, diffEngine_1.normalizeForDiff)(newSpec);
-    const baseHash = crypto_1.default.createHash('sha256').update(JSON.stringify(normalizedOld)).digest('hex');
-    const targetHash = crypto_1.default.createHash('sha256').update(JSON.stringify(normalizedNew)).digest('hex');
-    const entries = (0, diffEngine_1.withDiffType)((0, diffEngine_1.collectDiffEntries)(normalizedOld, normalizedNew));
-    const { filtered, ignored } = (0, ignoreRules_1.applyIgnoreRules)(entries, ignoreRules);
-    const breakingCount = filtered.filter(entry => entry.severity === 'breaking').length;
-    const stabilityScore = filtered.length === 0 ? 100 : Math.round(((filtered.length - breakingCount) / filtered.length) * 100);
-    const stats = {
-        totalChanges: filtered.length,
-        added: filtered.filter(entry => entry.action === 'added').length,
-        removed: filtered.filter(entry => entry.action === 'removed').length,
-        changed: filtered.filter(entry => entry.action === 'changed').length,
-        ignored: ignored || undefined,
-        stabilityScore,
-    };
-    const breaking = filtered.filter(entry => entry.severity === 'breaking');
-    const warnings = filtered.filter(entry => entry.severity === 'warning');
-    const info = filtered.filter(entry => entry.severity === 'info');
-    const report = {
-        version: '1.0.0',
-        timestamp: new Date().toISOString(),
-        metadata: {
-            base: baseLabel,
-            target: targetLabel,
-            baseHash,
-            targetHash,
-        },
-        stats,
-        diff: {
-            breaking,
-            warnings,
-            info,
-            all: filtered,
-        },
-        miracles: (0, miracles_1.buildMiracles)(entries, normalizedOld, normalizedNew),
-    };
-    return { report, ignored };
-}

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

@@ -1,54 +0,0 @@
-import { Diff } from 'deep-diff';
-import type { DiffAction, DiffEntry, JsonValue } from './types';
-/**
- * Проверяет, содержит ли путь сегменты, указывающие на полиморфную схему (oneOf/anyOf).
- * @param segments сегменты json-path
- * @returns true если встречены полиморфные сегменты
- */
-export declare const hasPolymorphicSegment: (segments: (string | number)[]) => boolean;
-/**
- * Классифицирует серьёзность изменения по действию (added/removed/changed).
- * @param action действие изменения
- * @returns уровень серьёзности
- */
-export declare const classifySeverity: (action: DiffAction) => "info" | "warning" | "breaking";
-/**
- * Строит единичную запись отличия из набора сегментов пути и значений.
- * Добавляет заметку при полиморфных изменениях.
- * @param action действие изменения
- * @param segments сегменты пути
- * @param from предыдущее значение
- * @param to новое значение
- * @returns готовая запись DiffEntry
- */
-export declare const buildDiffEntry: (action: DiffAction, segments: (string | number)[], from?: JsonValue, to?: JsonValue) => DiffEntry;
-/**
- * Пытается классифицировать тип изменения по структуре json-path и самой записи.
- * Возвращает семантические коды типа изменения (METHOD_REMOVED, PROPERTY_ADDED и т.д.).
- * @param entry запись diff
- * @returns код типа изменения или undefined
- */
-export declare const classifyDiffType: (entry: DiffEntry) => string | undefined;
-/**
- * Добавляет поле type к каждой записи diff, вычисленное через classifyDiffType, если отсутствует.
- * @param entries массив записей diff
- * @returns массив записей с полем type
- */
-export declare const withDiffType: (entries: DiffEntry[]) => DiffEntry[];
-/**
- * Преобразует единичный объект отличия из deep-diff в один или несколько DiffEntry.
- * Обрабатывает массивные/индексные отличия (kind 'A') рекурсивно.
- * @param difference объект отличия от deep-diff
- * @returns массив DiffEntry
- */
-export declare const diffToEntries: (difference: Diff<unknown, unknown>) => DiffEntry[];
-/**
- * Собирает все записи отличий между двумя JSON-структурами: старой и новой.
- * Выполняет глубокое сравнение и маппинг на DiffEntry.
- * @param oldValue старая версия спецификации
- * @param newValue новая версия спецификации
- * @returns массив DiffEntry
- */
-export declare const collectDiffEntries: (oldValue: JsonValue, newValue: JsonValue) => DiffEntry[];
-export declare const normalizeForDiff: (value: JsonValue) => JsonValue;
-//# sourceMappingURL=diffEngine.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"diffEngine.d.ts","sourceRoot":"","sources":["../../../src/cli/analyzeDiff/diffEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AAMnD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAG,OAErE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,UAAU,oCAUlD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,UAAU,EAAE,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,OAAO,SAAS,EAAE,KAAK,SAAS,KAAG,SAoBpH,CAAC;AA0BF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,SAAS,KAAG,MAAM,GAAG,SAwC5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,SAAS,EAAE,KAAG,SAAS,EAK5D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,KAAG,SAAS,EA8B3E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,SAAS,EAAE,UAAU,SAAS,KAAG,SAAS,EAMtF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,SAAS,KAAG,SAGnD,CAAC"}

package/dist/cli/analyzeDiff/diffEngine.js

@@ -1,209 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeForDiff = exports.collectDiffEntries = exports.diffToEntries = exports.withDiffType = exports.classifyDiffType = exports.buildDiffEntry = exports.classifySeverity = exports.hasPolymorphicSegment = void 0;
-const deep_diff_1 = require("deep-diff");
-const fast_deep_equal_1 = __importDefault(require("fast-deep-equal"));
-const jsonPath_1 = require("../../common/utils/jsonPath");
-const normalizeObject_1 = require("../../common/utils/normalizeObject");
-const miracles_1 = require("./miracles");
-/**
- * Проверяет, содержит ли путь сегменты, указывающие на полиморфную схему (oneOf/anyOf).
- * @param segments сегменты json-path
- * @returns true если встречены полиморфные сегменты
- */
-const hasPolymorphicSegment = (segments) => {
-    return segments.includes('oneOf') || segments.includes('anyOf');
-};
-exports.hasPolymorphicSegment = hasPolymorphicSegment;
-/**
- * Классифицирует серьёзность изменения по действию (added/removed/changed).
- * @param action действие изменения
- * @returns уровень серьёзности
- */
-const classifySeverity = (action) => {
-    if (action === 'removed') {
-        return 'breaking';
-    }
-    if (action === 'changed') {
-        return 'warning';
-    }
-    return 'info';
-};
-exports.classifySeverity = classifySeverity;
-/**
- * Строит единичную запись отличия из набора сегментов пути и значений.
- * Добавляет заметку при полиморфных изменениях.
- * @param action действие изменения
- * @param segments сегменты пути
- * @param from предыдущее значение
- * @param to новое значение
- * @returns готовая запись DiffEntry
- */
-const buildDiffEntry = (action, segments, from, to) => {
-    const path = (0, jsonPath_1.toJsonPath)(segments);
-    if ((0, exports.hasPolymorphicSegment)(segments)) {
-        return {
-            action: 'changed',
-            path,
-            from,
-            to,
-            severity: 'warning',
-            note: 'Manual review required: polymorphic schema change',
-            type: 'POLYMORPHIC_CHANGE',
-        };
-    }
-    return {
-        action,
-        path,
-        from,
-        to,
-        severity: (0, exports.classifySeverity)(action),
-    };
-};
-exports.buildDiffEntry = buildDiffEntry;
-/**
- * Возвращает имя корневой схемы из сегментов пути, если путь указывает на components.schemas или definitions.
- * @param segments сегменты json-path
- * @returns имя схемы или null
- */
-const getSchemaRootName = (segments) => {
-    const s = segments.map(String);
-    if (s[0] === 'components' && s[1] === 'schemas')
-        return s[2] ?? null;
-    if (s[0] === 'definitions')
-        return s[1] ?? null;
-    return null;
-};
-/**
- * Извлекает имя свойства из сегментов пути (ищет 'properties' и следующий сегмент).
- * @param segments сегменты json-path
- * @returns имя свойства или null
- */
-const getPropertyNameFromSegments = (segments) => {
-    const s = segments.map(String);
-    const propsIndex = s.indexOf('properties');
-    if (propsIndex === -1)
-        return null;
-    return s[propsIndex + 1] ?? null;
-};
-/**
- * Пытается классифицировать тип изменения по структуре json-path и самой записи.
- * Возвращает семантические коды типа изменения (METHOD_REMOVED, PROPERTY_ADDED и т.д.).
- * @param entry запись diff
- * @returns код типа изменения или undefined
- */
-const classifyDiffType = (entry) => {
-    const segments = (0, jsonPath_1.parseJsonPath)(entry.path);
-    const s = segments.map(String);
-    if (s[0] === 'paths') {
-        const hasMethod = s.length >= 3;
-        const isMethodRoot = s.length === 3;
-        if (hasMethod && isMethodRoot) {
-            if (entry.action === 'removed')
-                return 'METHOD_REMOVED';
-            if (entry.action === 'added')
-                return 'METHOD_ADDED';
-            return 'METHOD_CHANGED';
-        }
-        return 'PATH_CHANGED';
-    }
-    const schemaName = getSchemaRootName(s);
-    if (schemaName) {
-        const isSchemaRoot = s.length <= 3;
-        if (isSchemaRoot) {
-            if (entry.action === 'removed')
-                return 'SCHEMA_REMOVED';
-            if (entry.action === 'added')
-                return 'SCHEMA_ADDED';
-            return 'SCHEMA_CHANGED';
-        }
-        const propertyName = getPropertyNameFromSegments(s);
-        if (propertyName) {
-            const fromType = (0, miracles_1.getTypeSignature)((entry.from ?? {}));
-            const toType = (0, miracles_1.getTypeSignature)((entry.to ?? {}));
-            if (entry.action === 'changed' && fromType && toType && fromType !== toType) {
-                return 'TYPE_CHANGED';
-            }
-            if (entry.action === 'removed')
-                return 'PROPERTY_REMOVED';
-            if (entry.action === 'added')
-                return 'PROPERTY_ADDED';
-            return 'PROPERTY_CHANGED';
-        }
-        return 'SCHEMA_CHANGED';
-    }
-    return undefined;
-};
-exports.classifyDiffType = classifyDiffType;
-/**
- * Добавляет поле type к каждой записи diff, вычисленное через classifyDiffType, если отсутствует.
- * @param entries массив записей diff
- * @returns массив записей с полем type
- */
-const withDiffType = (entries) => {
-    return entries.map(entry => ({
-        ...entry,
-        type: entry.type ?? (0, exports.classifyDiffType)(entry),
-    }));
-};
-exports.withDiffType = withDiffType;
-/**
- * Преобразует единичный объект отличия из deep-diff в один или несколько DiffEntry.
- * Обрабатывает массивные/индексные отличия (kind 'A') рекурсивно.
- * @param difference объект отличия от deep-diff
- * @returns массив DiffEntry
- */
-const diffToEntries = (difference) => {
-    if (difference.kind === 'A') {
-        const segments = [...(difference.path ?? []), difference.index];
-        const item = difference.item;
-        if (item.kind === 'A') {
-            return (0, exports.diffToEntries)({ ...item, path: segments });
-        }
-        if (item.kind === 'N') {
-            return [(0, exports.buildDiffEntry)('added', segments, undefined, item.rhs)];
-        }
-        if (item.kind === 'D') {
-            return [(0, exports.buildDiffEntry)('removed', segments, item.lhs, undefined)];
-        }
-        if (item.kind === 'E') {
-            return [(0, exports.buildDiffEntry)('changed', segments, item.lhs, item.rhs)];
-        }
-        return [];
-    }
-    const segments = difference.path ?? [];
-    if (difference.kind === 'N') {
-        return [(0, exports.buildDiffEntry)('added', segments, undefined, difference.rhs)];
-    }
-    if (difference.kind === 'D') {
-        return [(0, exports.buildDiffEntry)('removed', segments, difference.lhs, undefined)];
-    }
-    if (difference.kind === 'E') {
-        return [(0, exports.buildDiffEntry)('changed', segments, difference.lhs, difference.rhs)];
-    }
-    return [];
-};
-exports.diffToEntries = diffToEntries;
-/**
- * Собирает все записи отличий между двумя JSON-структурами: старой и новой.
- * Выполняет глубокое сравнение и маппинг на DiffEntry.
- * @param oldValue старая версия спецификации
- * @param newValue новая версия спецификации
- * @returns массив DiffEntry
- */
-const collectDiffEntries = (oldValue, newValue) => {
-    if ((0, fast_deep_equal_1.default)(oldValue, newValue)) {
-        return [];
-    }
-    const differences = (0, deep_diff_1.diff)(oldValue, newValue) ?? [];
-    return differences.flatMap(exports.diffToEntries);
-};
-exports.collectDiffEntries = collectDiffEntries;
-const normalizeForDiff = (value) => {
-    // обёртка вокруг normalizeObject, если нужно
-    return (0, normalizeObject_1.normalizeObject)(value);
-};
-exports.normalizeForDiff = normalizeForDiff;