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

package/README.md

@@ -28,6 +28,7 @@
 - Supports tsc and @babel/plugin-transform-typescript
 - Supports customization names of models
 - Supports external references using [`swagger-parser`](https://github.com/APIDevTools/swagger-parser/)
+- Supports binary request/response generation (`format: binary` -> `Blob`)
 
 ## Install
 
@@ -38,7 +39,7 @@ npm install ts-openapi-codegen --save-dev
 
 ## Usage
 
-The CLI tool supports five commands: `generate`, `check-config`, `update-config`, `init`, and `preview-changes`.
+The CLI tool supports six commands: `generate`, `check-config`, `update-config`, `init`, `preview-changes`, and `analyze-diff`.
 
 ### Command: `generate`
 
@@ -76,6 +77,9 @@ openapi generate --input ./spec.json --output ./dist
 | `--logTarget` | `-t` | string | `console` | Logging target: `console` or `file` |
 | `--validationLibrary` | - | string | `none` | Validation library for schema generation: `none`, `zod`, `joi`, `yup`, or `jsonschema` |
 | `--emptySchemaStrategy` | - | string | `keep` | Strategy for empty schemas: `keep`, `semantic`, or `skip` |
+| `--modelsMode` | - | string | `interfaces` | Models generation mode: `interfaces` or `classes` |
+| `--useHistory` | - | boolean | `false` | Apply diff report annotations during generation |
+| `--diffReport` | - | string | `./openapi-diff-report.json` | Path to diff report JSON |
 
 **Examples:**
 ```bash
@@ -163,6 +167,46 @@ openapi preview-changes --openapi-config ./custom-config.json
 - `--preview-dir` / `-pd` - Temporary preview generation directory (default: `./.ts-openapi-codegen-preview-changes`)
 - `--diff-dir` / `-dd` - Directory for diff reports (default: `./.ts-openapi-codegen-diff-changes`)
 
+### Command: `analyze-diff`
+
+Analyzes differences between two OpenAPI specifications and produces a JSON report.
+
+**Usage:**
+```bash
+openapi analyze-diff --input ./openapi/current.yaml --compare-with ./openapi/previous.yaml --output-report ./openapi-diff-report.json
+openapi analyze-diff --input ./openapi/spec.yaml --git HEAD~1
+```
+
+**Options:**
+- `--input` / `-i` - Path to current OpenAPI specification file (required)
+- `--compare-with` - Path to previous OpenAPI specification file
+- `--git` - Git ref to read previous specification version from (e.g. `HEAD~1`)
+- `--output-report` - Path to save JSON diff report (default: `./openapi-diff-report.json`)
+
+#### Miracles and confirmation
+
+The diff report can contain a `miracles` section with detected renames/type-coercions. Only confirmed miracles are applied in generation.
+
+**How to confirm miracles:**
+1. Run `analyze-diff` and open the generated report (default: `./openapi-diff-report.json`).
+2. Find the entry in `miracles` you want to accept.
+3. Change `"status": "auto-generated"` to `"status": "confirmed"` and commit the report.
+
+Example (excerpt):
+```json
+{
+  "miracles": [
+    {
+      "oldPath": "$.components.schemas.User.properties.user_name",
+      "newPath": "$.components.schemas.User.properties.userName",
+      "type": "RENAME",
+      "confidence": 0.85,
+      "status": "confirmed"
+    }
+  ]
+}
+```
+
 ### Configuration File
 
 Instead of passing all options via CLI, you can use a configuration file. Create `openapi.config.json` in your project root:
@@ -183,7 +227,22 @@ Instead of passing all options via CLI, you can use a configuration file. Create
     "sortByRequired": false,
     "useSeparatedIndexes": false,
     "request": "./custom-request.ts",
-    "customExecutorPath": "./custom/createExecutorAdapter.ts"
+    "customExecutorPath": "./custom/createExecutorAdapter.ts",
+    "modelsMode": "interfaces",
+    "useHistory": false,
+    "diffReport": "./openapi-diff-report.json",
+    "models": {
+        "mode": "interfaces"
+    },
+    "analyze": {
+        "useHistory": false,
+        "reportPath": "./openapi-diff-report.json"
+    },
+    "miracles": {
+        "enabled": true,
+        "confidence": 1,
+        "types": ["RENAME", "TYPE_COERCION"]
+    }
 }
 ```
 
@@ -244,6 +303,12 @@ Instead of passing all options via CLI, you can use a configuration file. Create
 | `items` | array | - | Array of configurations (for multi-options format) |
 | `validationLibrary` | string | `none` | Validation library for schema generation: `none`, `zod`, `joi`, `yup`, or `jsonschema` |
 | `emptySchemaStrategy` | string | `keep` | Strategy for empty schemas: `keep`, `semantic`, or `skip` |
+| `modelsMode` | string | `interfaces` | Models generation mode: `interfaces` or `classes` |
+| `useHistory` | boolean | `false` | Apply diff report annotations during generation |
+| `diffReport` | string | `./openapi-diff-report.json` | Path to diff report JSON |
+| `models` | object | - | Models config section (e.g. `mode`) |
+| `analyze` | object | - | Analyze config section (e.g. reportPath, useHistory, ignore) |
+| `miracles` | object | - | Miracles config section (enabled, confidence, types) |
 
 **Note:** You can use the `init` command to generate a template configuration file.
 
@@ -265,6 +330,16 @@ openapi init
 openapi generate
 ```
 
+**With DTO models (classes mode):**
+```bash
+openapi generate --input ./spec.json --output ./dist --modelsMode classes
+```
+
+**Generate diff report:**
+```bash
+openapi analyze-diff --input ./openapi/current.yaml --compare-with ./openapi/previous.yaml --output-report ./openapi-diff-report.json
+```
+
 **Check configuration:**
 ```bash
 openapi check-config
@@ -423,6 +498,20 @@ The `--validationLibrary` parameter allows you to generate runtime validation sc
 - **yup** - Generate Yup validation schemas
 - **jsonschema** - Generate JSON Schema validation schemas
 
+When `--useHistory` is enabled and a diff report marks a type change, validators will attempt to coerce values:
+- **Zod** uses `z.coerce.*`
+- **Joi** uses `Joi.alternatives().try(...)`
+- **Yup** uses `.transform(...)`
+- **JSON Schema (AJV)** enables `coerceTypes`
+
+### Models mode `--modelsMode`
+
+By default, models are generated as TypeScript interfaces/types. When `--modelsMode classes` is used, the generator produces:
+- `*Raw` interfaces matching the API JSON
+- `*Dto` classes with getters, defaults, recursive constructors, and `toJSON()`
+
+The output is consolidated into a single `models.ts` file, and `BaseDto`/`dtoUtils` are emitted in `core`.
+
 Let's say we have the following model:
 
 ```json

package/README.rus.md

@@ -28,6 +28,7 @@
 - Поддерживает tsc и @babel/plugin-transform-typescript
 - Поддерживает кастомизацию имен моделей
 - Поддерживает внешние ссылки с помощью [`swagger-parser`](https://github.com/APIDevTools/swagger-parser/)
+- Поддерживает генерацию бинарных request/response (`format: binary` -> `Blob`)
 
 ## Установка
 
@@ -37,7 +38,7 @@ npm install ts-openapi-codegen --save-dev
 
 ## Использование
 
-CLI инструмент поддерживает пять команд: `generate`, `check-config`, `update-config`, `init` и `preview-changes`.
+CLI инструмент поддерживает шесть команд: `generate`, `check-config`, `update-config`, `init`, `preview-changes` и `analyze-diff`.
 
 ### Команда: `generate`
 
@@ -75,6 +76,9 @@ openapi generate --input ./spec.json --output ./dist
 | `--logTarget` | `-t` | string | `console` | Цель логирования: `console` или `file` |
 | `--validationLibrary` | - | string | `none` | Библиотека валидации для генерации схем: `none`, `zod`, `joi`, `yup`, или `jsonschema` |
 | `--emptySchemaStrategy` | - | string | `keep` | Стратегия для пустых схем: `keep`, `semantic`, или `skip` |
+| `--modelsMode` | - | string | `interfaces` | Режим генерации моделей: `interfaces` или `classes` |
+| `--useHistory` | - | boolean | `false` | Применять diff-отчёт при генерации |
+| `--diffReport` | - | string | `./openapi-diff-report.json` | Путь к diff-отчёту |
 
 **Примеры:**
 ```bash
@@ -162,6 +166,46 @@ openapi preview-changes --openapi-config ./custom-config.json
 - `--preview-dir` / `-pd` - Временная директория для preview-генерации (по умолчанию: `./.ts-openapi-codegen-preview-changes`)
 - `--diff-dir` / `-dd` - Директория для diff-отчетов (по умолчанию: `./.ts-openapi-codegen-diff-changes`)
 
+### Команда: `analyze-diff`
+
+Анализирует изменения между двумя версиями OpenAPI и формирует JSON‑отчет.
+
+**Использование:**
+```bash
+openapi analyze-diff --input ./openapi/current.yaml --compare-with ./openapi/previous.yaml --output-report ./openapi-diff-report.json
+openapi analyze-diff --input ./openapi/spec.yaml --git HEAD~1
+```
+
+**Опции:**
+- `--input` / `-i` - Путь к текущей спецификации OpenAPI (обязательно)
+- `--compare-with` - Путь к предыдущей спецификации
+- `--git` - Git ref для чтения предыдущей версии спецификации (например, `HEAD~1`)
+- `--output-report` - Путь для сохранения diff‑отчёта (по умолчанию: `./openapi-diff-report.json`)
+
+#### Miracles и подтверждение
+
+В diff‑отчёте может быть раздел `miracles` с обнаруженными переименованиями/коэрсингом типов. В генерации применяются только подтверждённые записи.
+
+**Как подтверждать чудеса:**
+1. Запустите `analyze-diff` и откройте отчёт (по умолчанию: `./openapi-diff-report.json`).
+2. Найдите нужную запись в `miracles`.
+3. Измените `"status": "auto-generated"` на `"status": "confirmed"` и закоммитьте отчёт.
+
+Пример (фрагмент):
+```json
+{
+  "miracles": [
+    {
+      "oldPath": "$.components.schemas.User.properties.user_name",
+      "newPath": "$.components.schemas.User.properties.userName",
+      "type": "RENAME",
+      "confidence": 0.85,
+      "status": "confirmed"
+    }
+  ]
+}
+```
+
 ### Файл конфигурации
 
 Вместо передачи всех опций через CLI, вы можете использовать файл конфигурации. Создайте `openapi.config.json` в корне вашего проекта:
@@ -182,7 +226,22 @@ openapi preview-changes --openapi-config ./custom-config.json
     "sortByRequired": false,
     "useSeparatedIndexes": false,
     "request": "./custom-request.ts",
-    "customExecutorPath": "./custom/createExecutorAdapter.ts"
+    "customExecutorPath": "./custom/createExecutorAdapter.ts",
+    "modelsMode": "interfaces",
+    "useHistory": false,
+    "diffReport": "./openapi-diff-report.json",
+    "models": {
+        "mode": "interfaces"
+    },
+    "analyze": {
+        "useHistory": false,
+        "reportPath": "./openapi-diff-report.json"
+    },
+    "miracles": {
+        "enabled": true,
+        "confidence": 1,
+        "types": ["RENAME", "TYPE_COERCION"]
+    }
 }
 ```
 
@@ -243,6 +302,12 @@ openapi preview-changes --openapi-config ./custom-config.json
 | `items` | array | - | Массив конфигураций (для формата multi-options) |
 | `validationLibrary` | string | `none` | Библиотека валидации для генерации схем: `none`, `zod`, `joi`, `yup`, или `jsonschema` |
 | `emptySchemaStrategy` | string | `keep` | Стратегия для пустых схем: `keep`, `semantic`, или `skip` |
+| `modelsMode` | string | `interfaces` | Режим генерации моделей: `interfaces` или `classes` |
+| `useHistory` | boolean | `false` | Применять diff‑отчёт при генерации |
+| `diffReport` | string | `./openapi-diff-report.json` | Путь к diff‑отчёту |
+| `models` | object | - | Секция конфигурации моделей (например, `mode`) |
+| `analyze` | object | - | Секция анализа (например, reportPath, useHistory, ignore) |
+| `miracles` | object | - | Секция чудес (enabled, confidence, types) |
 
 **Примечание:** Вы можете использовать команду `init` для генерации шаблона файла конфигурации.
 
@@ -264,6 +329,16 @@ openapi init
 openapi generate
 ```
 
+**С DTO моделями (режим classes):**
+```bash
+openapi generate --input ./spec.json --output ./dist --modelsMode classes
+```
+
+**Сгенерировать diff‑отчёт:**
+```bash
+openapi analyze-diff --input ./openapi/current.yaml --compare-with ./openapi/previous.yaml --output-report ./openapi-diff-report.json
+```
+
 **Проверка конфигурации:**
 ```bash
 openapi check-config
@@ -422,6 +497,20 @@ const order: Order = {
 - **yup** - Генерация схем валидации Yup
 - **jsonschema** - Генерация схем валидации JSON Schema
 
+Если включен `--useHistory` и в diff‑отчёте есть смена типа, валидаторы будут пытаться выполнять коэрсинг:
+- **Zod** использует `z.coerce.*`
+- **Joi** использует `Joi.alternatives().try(...)`
+- **Yup** использует `.transform(...)`
+- **JSON Schema (AJV)** включает `coerceTypes`
+
+### Режим моделей `--modelsMode`
+
+По умолчанию модели генерируются как интерфейсы/типы. При `--modelsMode classes` генератор создаёт:
+- `*Raw` интерфейсы (JSON‑формат API)
+- `*Dto` классы с геттерами, дефолтами, рекурсивными конструкторами и `toJSON()`
+
+Вывод консолидируется в один файл `models.ts`, а `BaseDto`/`dtoUtils` добавляются в `core`.
+
 Допустим, у нас есть следующая модель:
 
 ```json

package/dist/cli/analyzeDiff/__tests__/analyzeDiff.cli.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analyzeDiff.cli.test.d.ts.map

package/dist/cli/analyzeDiff/__tests__/analyzeDiff.cli.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeDiff.cli.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/analyzeDiff/__tests__/analyzeDiff.cli.test.ts"],"names":[],"mappings":""}

package/dist/cli/analyzeDiff/__tests__/analyzeDiff.cli.test.js

@@ -0,0 +1,365 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = require("node:test");
+const LoggerMessages_1 = require("../../../common/LoggerMessages");
+const semanticDiffReportSchema_1 = require("../../../core/semanticDiff/semanticDiffReportSchema");
+const analyzeDiff_1 = require("../analyzeDiff");
+const ciSummary_1 = require("../ciSummary");
+const repoRoot = node_path_1.default.join(__dirname, '..', '..', '..', '..');
+function createTempDir(t, prefix) {
+    const generatedRoot = node_path_1.default.join(__dirname, 'generated');
+    (0, node_fs_1.mkdirSync)(generatedRoot, { recursive: true });
+    const tempDir = (0, node_fs_1.mkdtempSync)(node_path_1.default.join(generatedRoot, prefix));
+    t.after(() => {
+        (0, node_fs_1.rmSync)(tempDir, { recursive: true, force: true });
+    });
+    return tempDir;
+}
+async function runAnalyzeDiffCli(options) {
+    const result = await (0, analyzeDiff_1.analyzeDiff)(options);
+    return {
+        exitCode: (0, analyzeDiff_1.toAnalyzeDiffExitCode)(result),
+        result,
+    };
+}
+(0, node_test_1.describe)('@unit: analyzeDiff cli', () => {
+    (0, node_test_1.test)('returns exit code 0 and skips when --input has no base source', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-skip-');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        const inputSpecPath = node_path_1.default.join(repoRoot, 'test/spec/v3.json');
+        const { exitCode, result } = await runAnalyzeDiffCli({
+            input: inputSpecPath,
+            outputReport: reportPath,
+            ci: false,
+        });
+        node_assert_1.default.strictEqual(exitCode, 0);
+        node_assert_1.default.strictEqual(result.skipped, true);
+        node_assert_1.default.strictEqual(result.error, undefined);
+    });
+    (0, node_test_1.test)('returns exit code 0 for --input + --git', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-git-');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        const inputSpecPath = node_path_1.default.join(repoRoot, 'test/spec/v3.json');
+        const { exitCode } = await runAnalyzeDiffCli({
+            input: inputSpecPath,
+            outputReport: reportPath,
+            git: 'HEAD',
+            ci: true,
+        });
+        node_assert_1.default.strictEqual(exitCode, 0);
+    });
+    (0, node_test_1.test)('returns exit code 0 for non-breaking diff in ci mode', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-ok-');
+        const oldSpecPath = node_path_1.default.join(tempDir, 'old.json');
+        const newSpecPath = node_path_1.default.join(tempDir, 'new.json');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        (0, node_fs_1.writeFileSync)(oldSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'Old', version: '1.0.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        (0, node_fs_1.writeFileSync)(newSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'New', version: '1.1.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+                '/pong': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        const { exitCode } = await runAnalyzeDiffCli({
+            input: newSpecPath,
+            outputReport: reportPath,
+            compareWith: oldSpecPath,
+            ci: true,
+        });
+        node_assert_1.default.strictEqual(exitCode, 0);
+        const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
+        const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
+        node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
+        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
+        node_assert_1.default.strictEqual(report.summary.breaking, 0);
+        node_assert_1.default.ok(report.summary.nonBreaking > 0);
+        node_assert_1.default.strictEqual(report.recommendation.semver, 'minor');
+        node_assert_1.default.ok(report.recommendation.reasons.includes('HAS_BACKWARD_COMPATIBLE_CHANGES'));
+        node_assert_1.default.strictEqual(report.governance.summary.errors, 0);
+        const ciSummary = (0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath);
+        node_assert_1.default.ok(ciSummary.includes('### OpenAPI Semantic Diff'));
+        node_assert_1.default.ok(ciSummary.includes('HAS_BACKWARD_COMPATIBLE_CHANGES'));
+    });
+    (0, node_test_1.test)('returns exit code 1 for breaking diff in ci mode', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-breaking-');
+        const oldSpecPath = node_path_1.default.join(tempDir, 'old.json');
+        const newSpecPath = node_path_1.default.join(tempDir, 'new.json');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        (0, node_fs_1.writeFileSync)(oldSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'Old', version: '1.0.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        (0, node_fs_1.writeFileSync)(newSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'New', version: '2.0.0' },
+            paths: {},
+        }));
+        const { exitCode } = await runAnalyzeDiffCli({
+            input: newSpecPath,
+            outputReport: reportPath,
+            compareWith: oldSpecPath,
+            ci: true,
+        });
+        node_assert_1.default.strictEqual(exitCode, 1);
+        const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
+        const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
+        node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
+        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
+        node_assert_1.default.ok(report.summary.breaking > 0);
+        node_assert_1.default.ok(report.changes.some(change => change.severity === 'breaking'));
+        node_assert_1.default.strictEqual(report.recommendation.semver, 'major');
+        node_assert_1.default.ok(report.recommendation.reasons.includes('HAS_BREAKING_CHANGES'));
+        node_assert_1.default.ok(report.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
+        const ciSummary = (0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath);
+        node_assert_1.default.ok(ciSummary.includes('### OpenAPI Semantic Diff'));
+        node_assert_1.default.ok(ciSummary.includes('HAS_BREAKING_CHANGES'));
+    });
+    (0, node_test_1.test)('returns exit code 0 for breaking diff in ci mode when allow-breaking is enabled', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-breaking-allowed-');
+        const oldSpecPath = node_path_1.default.join(tempDir, 'old.json');
+        const newSpecPath = node_path_1.default.join(tempDir, 'new.json');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        (0, node_fs_1.writeFileSync)(oldSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'Old', version: '1.0.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        operationId: 'getPing',
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        (0, node_fs_1.writeFileSync)(newSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'New', version: '2.0.0' },
+            paths: {},
+        }));
+        const { exitCode } = await runAnalyzeDiffCli({
+            input: newSpecPath,
+            outputReport: reportPath,
+            compareWith: oldSpecPath,
+            ci: true,
+            allowBreaking: true,
+        });
+        node_assert_1.default.strictEqual(exitCode, 0);
+        const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
+        const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
+        node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
+        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
+        node_assert_1.default.ok(report.summary.breaking > 0);
+        node_assert_1.default.ok(!report.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
+        node_assert_1.default.ok((0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath).includes('### OpenAPI Semantic Diff'));
+    });
+    (0, node_test_1.test)('returns exit code 0 for breaking diff in ci mode when governance config disables no-breaking rule', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-breaking-policy-');
+        const oldSpecPath = node_path_1.default.join(tempDir, 'old.json');
+        const newSpecPath = node_path_1.default.join(tempDir, 'new.json');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        const governanceConfigPath = node_path_1.default.join(tempDir, 'governance.json');
+        (0, node_fs_1.writeFileSync)(oldSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'Old', version: '1.0.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        operationId: 'getPing',
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        (0, node_fs_1.writeFileSync)(newSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'New', version: '2.0.0' },
+            paths: {},
+        }));
+        (0, node_fs_1.writeFileSync)(governanceConfigPath, JSON.stringify({
+            rules: {
+                NO_BREAKING_WITHOUT_FLAG: {
+                    enabled: false,
+                },
+            },
+        }));
+        const { exitCode } = await runAnalyzeDiffCli({
+            input: newSpecPath,
+            outputReport: reportPath,
+            compareWith: oldSpecPath,
+            ci: true,
+            governanceConfig: governanceConfigPath,
+        });
+        node_assert_1.default.strictEqual(exitCode, 0);
+        const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
+        const schemaValidation = (0, semanticDiffReportSchema_1.validateSemanticDiffReportSchema)(report);
+        node_assert_1.default.strictEqual(schemaValidation.valid, true, schemaValidation.errors.join('\n'));
+        node_assert_1.default.strictEqual(report.schemaVersion, '1.1.0');
+        node_assert_1.default.ok(report.summary.breaking > 0);
+        node_assert_1.default.ok(!report.governance.violations.some(violation => violation.ruleId === 'NO_BREAKING_WITHOUT_FLAG'));
+        node_assert_1.default.ok((0, ciSummary_1.formatCiMarkdownSummary)(report, reportPath).includes('### OpenAPI Semantic Diff'));
+    });
+    (0, node_test_1.test)('uses --compare-with over --git when both flags are provided', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-priority-');
+        const oldSpecPath = node_path_1.default.join(tempDir, 'old.json');
+        const newSpecPath = node_path_1.default.join(tempDir, 'new.json');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        (0, node_fs_1.writeFileSync)(oldSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'Old', version: '1.0.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        (0, node_fs_1.writeFileSync)(newSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'New', version: '1.1.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        const { exitCode, result } = await runAnalyzeDiffCli({
+            input: newSpecPath,
+            outputReport: reportPath,
+            compareWith: oldSpecPath,
+            git: 'HEAD~9999',
+            ci: true,
+        });
+        node_assert_1.default.strictEqual(exitCode, 0);
+        node_assert_1.default.strictEqual(result.success, true);
+        const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
+        node_assert_1.default.strictEqual(report.summary.breaking, 0);
+        node_assert_1.default.strictEqual(report.recommendation.semver, 'patch');
+        node_assert_1.default.ok(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.COMPARE_WITH_OVERRIDES_GIT('HEAD~9999').includes('Ignoring git ref'));
+    });
+    (0, node_test_1.test)('filters semantic changes with analyze.ignore and recalculates summary', async (t) => {
+        const tempDir = createTempDir(t, 'openapi-cli-analyze-ignore-');
+        const oldSpecPath = node_path_1.default.join(tempDir, 'old.json');
+        const newSpecPath = node_path_1.default.join(tempDir, 'new.json');
+        const reportPath = node_path_1.default.join(tempDir, 'report.json');
+        const configPath = node_path_1.default.join(tempDir, 'openapi.config.json');
+        (0, node_fs_1.writeFileSync)(oldSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'Old', version: '1.0.0' },
+            paths: {
+                '/ping': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        (0, node_fs_1.writeFileSync)(newSpecPath, JSON.stringify({
+            openapi: '3.0.0',
+            info: { title: 'New', version: '1.0.1' },
+            paths: {
+                '/ping': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+                '/pong': {
+                    get: {
+                        responses: {
+                            '200': { description: 'ok' },
+                        },
+                    },
+                },
+            },
+        }));
+        (0, node_fs_1.writeFileSync)(configPath, JSON.stringify({
+            analyze: {
+                ignore: [
+                    {
+                        path: '#/paths/GET /pong',
+                    },
+                ],
+            },
+        }, null, 2));
+        const { exitCode, result } = await runAnalyzeDiffCli({
+            input: newSpecPath,
+            outputReport: reportPath,
+            compareWith: oldSpecPath,
+            openapiConfig: configPath,
+            ci: true,
+        });
+        node_assert_1.default.strictEqual(exitCode, 0);
+        node_assert_1.default.strictEqual(result.ignored, 1);
+        const report = JSON.parse((0, node_fs_1.readFileSync)(reportPath, 'utf8'));
+        node_assert_1.default.strictEqual(report.summary.breaking, 0);
+        node_assert_1.default.strictEqual(report.summary.nonBreaking, 0);
+        node_assert_1.default.strictEqual(report.summary.informational, 0);
+        node_assert_1.default.strictEqual(report.recommendation.semver, 'patch');
+        node_assert_1.default.ok(LoggerMessages_1.LOGGER_MESSAGES.ANALYZE_DIFF.IGNORED_CHANGES(1).includes('IGNORED: 1 semantic change'));
+    });
+    (0, node_test_1.test)('fails when --input is missing', async () => {
+        const result = await (0, analyzeDiff_1.analyzeDiff)({ git: 'HEAD~1' });
+        node_assert_1.default.strictEqual((0, analyzeDiff_1.toAnalyzeDiffExitCode)(result), 1);
+        node_assert_1.default.ok(result.error?.includes('"--input" is required for analyze-diff command'));
+    });
+    (0, node_test_1.test)('fails when analyze-diff is invoked without --input (legacy positional args are not accepted)', async () => {
+        const result = await (0, analyzeDiff_1.analyzeDiff)({});
+        node_assert_1.default.strictEqual((0, analyzeDiff_1.toAnalyzeDiffExitCode)(result), 1);
+        node_assert_1.default.ok(result.error?.includes('"--input" is required for analyze-diff command'));
+    });
+});

package/dist/cli/analyzeDiff/__tests__/analyzeDiffRenameAndInvalidRegex.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analyzeDiffRenameAndInvalidRegex.test.d.ts.map

package/dist/cli/analyzeDiff/__tests__/analyzeDiffRenameAndInvalidRegex.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeDiffRenameAndInvalidRegex.test.d.ts","sourceRoot":"","sources":["../../../../src/cli/analyzeDiff/__tests__/analyzeDiffRenameAndInvalidRegex.test.ts"],"names":[],"mappings":""}