ts-openapi-codegen 2.0.0-beta.9 → 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 three main commands: `generate`, `check-openapi-config`, and `init-openapi-config`.
+The CLI tool supports six commands: `generate`, `check-config`, `update-config`, `init`, `preview-changes`, and `analyze-diff`.
 
 ### Command: `generate`
 
@@ -65,6 +66,7 @@ openapi generate --input ./spec.json --output ./dist
 | `--useUnionTypes` | - | boolean | `false` | Use union types instead of enums |
 | `--excludeCoreServiceFiles` | - | boolean | `false` | Exclude generation of core and service files |
 | `--request` | - | string | - | Path to custom request file |
+| `--customExecutorPath` | - | string | - | Path to custom `createExecutorAdapter` module |
 | `--interfacePrefix` | - | string | `I` | Prefix for interface models |
 | `--enumPrefix` | - | string | `E` | Prefix for enum models |
 | `--typePrefix` | - | string | `T` | Prefix for type models |
@@ -74,6 +76,10 @@ openapi generate --input ./spec.json --output ./dist
 | `--logLevel` | `-l` | string | `error` | Logging level: `info`, `warn`, or `error` |
 | `--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
@@ -96,38 +102,110 @@ openapi generate \
   --logLevel info
 ```
 
-### Command: `check-openapi-config`
+### Command: `check-config`
 
 Validates the configuration file structure and values.
 
 **Usage:**
 ```bash
-openapi check-openapi-config
-openapi check-openapi-config --openapi-config ./custom-config.json
+openapi check-config
+openapi check-config --openapi-config ./custom-config.json
 ```
 
 **Options:**
 - `--openapi-config` / `-ocn` - Path to configuration file (default: `openapi.config.json`)
 
-### Command: `init-openapi-config`
+### Command: `update-config`
 
-Generates a configuration file template.
+Updates the configuration file to the latest supported schema version.
 
 **Usage:**
 ```bash
-# Generate single options template
-openapi init-openapi-config
+openapi update-config
+openapi update-config --openapi-config ./custom-config.json
+```
+
+**Options:**
+- `--openapi-config` / `-ocn` - Path to configuration file (default: `openapi.config.json`)
 
-# Generate multi-options template
-openapi init-openapi-config --type MULTIOPTION
+### Command: `init`
+
+Generates a configuration file template.
+
+**Usage:**
+```bash
+# Generate config using default settings
+openapi init
 
 # Custom config file name
-openapi init-openapi-config --openapi-config ./my-config.json
+openapi init --openapi-config ./my-config.json
+
+# Specify directory with OpenAPI specs
+openapi init --specs-dir ./openapi
 ```
 
 **Options:**
 - `--openapi-config` / `-ocn` - Path to output configuration file (default: `openapi.config.json`)
-- `--type` / `-t` - Template type: `OPTION` (single) or `MULTIOPTION` (multiple) (default: `OPTION`)
+- `--specs-dir` / `-sd` - Directory with OpenAPI specification files (default: `./openapi`)
+- `--request` - Path to custom request file
+- `--useCancelableRequest` - Generate cancelable request handling
+- `--useInteractiveMode` - Enable interactive mode for guided setup
+
+### Command: `preview-changes`
+
+Previews differences between already generated code and newly generated output without overwriting your current generated directory.
+
+**Usage:**
+```bash
+openapi preview-changes
+openapi preview-changes --openapi-config ./custom-config.json
+```
+
+**Options:**
+- `--openapi-config` / `-ocn` - Path to configuration file (default: `openapi.config.json`)
+- `--generated-dir` / `-gd` - Directory with current generated files (default: `./generated`)
+- `--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
 
@@ -148,7 +226,23 @@ Instead of passing all options via CLI, you can use a configuration file. Create
     "useCancelableRequest": false,
     "sortByRequired": false,
     "useSeparatedIndexes": false,
-    "request": "./custom-request.ts"
+    "request": "./custom-request.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"]
+    }
 }
 ```
 
@@ -199,6 +293,7 @@ Instead of passing all options via CLI, you can use a configuration file. Create
 | `useUnionTypes` | boolean | `false` | Use union types instead of enums |
 | `excludeCoreServiceFiles` | boolean | `false` | Exclude core and service files generation |
 | `request` | string | - | Path to custom request file |
+| `customExecutorPath` | string | - | Path to custom `createExecutorAdapter` module |
 | `interfacePrefix` | string | `I` | Prefix for interface models |
 | `enumPrefix` | string | `E` | Prefix for enum models |
 | `typePrefix` | string | `T` | Prefix for type models |
@@ -207,8 +302,15 @@ Instead of passing all options via CLI, you can use a configuration file. Create
 | `useSeparatedIndexes` | boolean | `false` | Use separate index files |
 | `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-openapi-config` command to generate a template configuration file.
+**Note:** You can use the `init` command to generate a template configuration file.
 
 ## Examples
 
@@ -222,15 +324,31 @@ openapi generate --input ./spec.json --output ./dist
 **With configuration file:**
 ```bash
 # First, create config file
-openapi init-openapi-config
+openapi init
 
 # Then generate
 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-openapi-config
+openapi check-config
+openapi update-config
+```
+
+**Preview changes before applying:**
+```bash
+openapi preview-changes
 ```
 
 ### Using NPX
@@ -247,8 +365,10 @@ npx ts-openapi-codegen generate --input ./spec.json --output ./dist
     "scripts": {
         "generate": "openapi generate --input ./spec.json --output ./dist",
         "generate:config": "openapi generate",
-        "check-config": "openapi check-openapi-config",
-        "init-config": "openapi init-openapi-config"
+        "check-config": "openapi check-config",
+        "update-config": "openapi update-config",
+        "init-config": "openapi init",
+        "preview-changes": "openapi preview-changes"
     }
 }
 ```
@@ -378,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
@@ -630,6 +764,31 @@ const service = new SimpleService(executor);
 await service.getCallWithoutParametersAndResponse({ timeout: 5000 });
 ```
 
+#### Using generated `createClient` with `customExecutorPath` and `executorFactory`
+
+If you set `customExecutorPath` in generation config, `createClient.ts` imports your custom
+`createExecutorAdapter` and uses it as the default executor.
+
+You can additionally pass `executorFactory` at runtime to wrap/extend this default executor
+(for retry, tracing, metrics, etc.) without changing generated services.
+
+```ts
+import { createClient } from './generated';
+
+const client = createClient({
+    executorFactory: ({ openApiConfig, createDefaultExecutor }) => {
+        const baseExecutor = createDefaultExecutor();
+
+        return {
+            async request<TResponse>(config, options) {
+                console.debug('Request to', openApiConfig.BASE, config.path);
+                return baseExecutor.request<TResponse>(config, options);
+            },
+        };
+    },
+});
+```
+
 ### Sorting strategy for function arguments `--sortByRequired`
 By default, the OpenAPI generator sorts the parameters of service functions according to a simplified scheme. If you need a more strict sorting option, then you need to use the `--sortByRequired` flag. The simplified sorting option is similar to the one used in version 0.2.3 of the OpenAPI generator. This flag allows you to upgrade to a new version of the generator if you are "stuck" on version 0.2.3.
 

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-openapi-config`, и `init-openapi-config`.
+CLI инструмент поддерживает шесть команд: `generate`, `check-config`, `update-config`, `init`, `preview-changes` и `analyze-diff`.
 
 ### Команда: `generate`
 
@@ -64,6 +65,7 @@ openapi generate --input ./spec.json --output ./dist
 | `--useUnionTypes` | - | boolean | `false` | Использовать union типы вместо enums |
 | `--excludeCoreServiceFiles` | - | boolean | `false` | Исключить генерацию core и сервисных файлов |
 | `--request` | - | string | - | Путь к пользовательскому файлу запросов |
+| `--customExecutorPath` | - | string | - | Путь к пользовательскому модулю `createExecutorAdapter` |
 | `--interfacePrefix` | - | string | `I` | Префикс для интерфейсов моделей |
 | `--enumPrefix` | - | string | `E` | Префикс для enum моделей |
 | `--typePrefix` | - | string | `T` | Префикс для type моделей |
@@ -73,6 +75,10 @@ openapi generate --input ./spec.json --output ./dist
 | `--logLevel` | `-l` | string | `error` | Уровень логирования: `info`, `warn`, или `error` |
 | `--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
@@ -95,38 +101,110 @@ openapi generate \
   --logLevel info
 ```
 
-### Команда: `check-openapi-config`
+### Команда: `check-config`
 
 Проверяет структуру и значения файла конфигурации.
 
 **Использование:**
 ```bash
-openapi check-openapi-config
-openapi check-openapi-config --openapi-config ./custom-config.json
+openapi check-config
+openapi check-config --openapi-config ./custom-config.json
 ```
 
 **Опции:**
 - `--openapi-config` / `-ocn` - Путь к файлу конфигурации (по умолчанию: `openapi.config.json`)
 
-### Команда: `init-openapi-config`
+### Команда: `update-config`
 
-Генерирует шаблон файла конфигурации.
+Обновляет файл конфигурации до последней поддерживаемой версии схемы.
 
 **Использование:**
 ```bash
-# Генерация шаблона с одним набором опций
-openapi init-openapi-config
+openapi update-config
+openapi update-config --openapi-config ./custom-config.json
+```
+
+**Опции:**
+- `--openapi-config` / `-ocn` - Путь к файлу конфигурации (по умолчанию: `openapi.config.json`)
 
-# Генерация шаблона с несколькими наборами опций
-openapi init-openapi-config --type MULTIOPTION
+### Команда: `init`
+
+Генерирует шаблон файла конфигурации.
+
+**Использование:**
+```bash
+# Генерация шаблона с настройками по умолчанию
+openapi init
 
 # Пользовательское имя файла конфигурации
-openapi init-openapi-config --openapi-config ./my-config.json
+openapi init --openapi-config ./my-config.json
+
+# Явно указать директорию со спецификациями OpenAPI
+openapi init --specs-dir ./openapi
 ```
 
 **Опции:**
 - `--openapi-config` / `-ocn` - Путь к выходному файлу конфигурации (по умолчанию: `openapi.config.json`)
-- `--type` / `-t` - Тип шаблона: `OPTION` (одиночный) или `MULTIOPTION` (множественный) (по умолчанию: `OPTION`)
+- `--specs-dir` / `-sd` - Директория с файлами OpenAPI спецификаций (по умолчанию: `./openapi`)
+- `--request` - Путь к пользовательскому request-файлу
+- `--useCancelableRequest` - Включить генерацию cancelable request
+- `--useInteractiveMode` - Включить интерактивный режим настройки
+
+### Команда: `preview-changes`
+
+Показывает различия между уже сгенерированным кодом и новым результатом генерации без перезаписи текущей директории generated-кода.
+
+**Использование:**
+```bash
+openapi preview-changes
+openapi preview-changes --openapi-config ./custom-config.json
+```
+
+**Опции:**
+- `--openapi-config` / `-ocn` - Путь к файлу конфигурации (по умолчанию: `openapi.config.json`)
+- `--generated-dir` / `-gd` - Директория с текущим generated-кодом (по умолчанию: `./generated`)
+- `--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"
+    }
+  ]
+}
+```
 
 ### Файл конфигурации
 
@@ -147,7 +225,23 @@ openapi init-openapi-config --openapi-config ./my-config.json
     "useCancelableRequest": false,
     "sortByRequired": false,
     "useSeparatedIndexes": false,
-    "request": "./custom-request.ts"
+    "request": "./custom-request.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"]
+    }
 }
 ```
 
@@ -198,6 +292,7 @@ openapi init-openapi-config --openapi-config ./my-config.json
 | `useUnionTypes` | boolean | `false` | Использовать union типы вместо enums |
 | `excludeCoreServiceFiles` | boolean | `false` | Исключить генерацию core и сервисных файлов |
 | `request` | string | - | Путь к пользовательскому файлу запросов |
+| `customExecutorPath` | string | - | Путь к пользовательскому модулю `createExecutorAdapter` |
 | `interfacePrefix` | string | `I` | Префикс для интерфейсов моделей |
 | `enumPrefix` | string | `E` | Префикс для enum моделей |
 | `typePrefix` | string | `T` | Префикс для type моделей |
@@ -206,8 +301,15 @@ openapi init-openapi-config --openapi-config ./my-config.json
 | `useSeparatedIndexes` | boolean | `false` | Использовать отдельные index файлы |
 | `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-openapi-config` для генерации шаблона файла конфигурации.
+**Примечание:** Вы можете использовать команду `init` для генерации шаблона файла конфигурации.
 
 ## Примеры
 
@@ -221,15 +323,31 @@ openapi generate --input ./spec.json --output ./dist
 **С файлом конфигурации:**
 ```bash
 # Сначала создайте файл конфигурации
-openapi init-openapi-config
+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-openapi-config
+openapi check-config
+openapi update-config
+```
+
+**Предпросмотр изменений перед применением:**
+```bash
+openapi preview-changes
 ```
 
 ### Использование NPX
@@ -246,8 +364,10 @@ npx ts-openapi-codegen generate --input ./spec.json --output ./dist
     "scripts": {
         "generate": "openapi generate --input ./spec.json --output ./dist",
         "generate:config": "openapi generate",
-        "check-config": "openapi check-openapi-config",
-        "init-config": "openapi init-openapi-config"
+        "check-config": "openapi check-config",
+        "update-config": "openapi update-config",
+        "init-config": "openapi init",
+        "preview-changes": "openapi preview-changes"
     }
 }
 ```
@@ -377,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
@@ -630,6 +764,31 @@ const service = new SimpleService(executor);
 await service.getCallWithoutParametersAndResponse({ timeout: 5000 });
 ```
 
+#### Использование сгенерированного `createClient` с `customExecutorPath` и `executorFactory`
+
+Если в конфигурации генерации задан `customExecutorPath`, в `createClient.ts` будет импортирован ваш
+пользовательский `createExecutorAdapter`, и он станет базовым executor по умолчанию.
+
+Дополнительно в runtime можно передать `executorFactory`, чтобы обернуть/расширить этот базовый executor
+(retry, tracing, metrics и т.д.) без изменения сгенерированных сервисов.
+
+```ts
+import { createClient } from './generated';
+
+const client = createClient({
+    executorFactory: ({ openApiConfig, createDefaultExecutor }) => {
+        const baseExecutor = createDefaultExecutor();
+
+        return {
+            async request<TResponse>(config, options) {
+                console.debug('Request to', openApiConfig.BASE, config.path);
+                return baseExecutor.request<TResponse>(config, options);
+            },
+        };
+    },
+});
+```
+
 ### Стратегия сортировки аргументов функций `--sortByRequired`
 По умолчанию генератор OpenAPI сортирует параметры сервисных функций согласно упрощенной схеме. Если вам нужна более строгая опция сортировки, используйте флаг `--sortByRequired`. Упрощенная опция сортировки похожа на ту, что использовалась в версии 0.2.3 генератора OpenAPI. Этот флаг позволяет обновиться до новой версии генератора, если вы "застряли" на версии 0.2.3.
 
@@ -841,6 +1000,3 @@ npm install form-data --save-dev
 [stars-image]: https://img.shields.io/github/stars/ozonophore/openapi-codegen.svg
 [librariesio-image]: https://img.shields.io/librariesio/github/ozonophore/openapi-codegen
 [lines-image]: https://img.shields.io/tokei/lines/github/ozonophore/openapi-codegen
-
-
-

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":""}