ts-openapi-codegen 2.1.0-beta.5 → 2.1.0-beta.6

package/README.md

@@ -30,6 +30,7 @@
 - Supports strict OpenAPI diagnostics with JSON reports (`--strict-openapi`, `--report-file`)
 - Supports generator plugins (`plugins`) including built-in `x-typescript-type`
 - Supports binary request/response generation (`format: binary` -> `Blob`)
+- Supports opt-in generation cache and incremental writes (`--cache`, `--cachePath`, `--cacheStrategy`, `--cacheDebug`)
 
 ## Install
 
@@ -43,6 +44,8 @@ npm install ts-openapi-codegen --save-dev
 - [Configuration file](docs/en/configuration.md)
 - [Examples](docs/en/examples.md)
 - [Features](docs/en/features.md)
+- [Plugins](docs/en/plugins.md)
+- [Plugin API v2 (RFC)](docs/en/plugin-api-v2.md)
 - [Русская версия README](README.rus.md)
 - [Русская документация](docs/ru/usage.md)
 

package/README.rus.md

@@ -30,6 +30,7 @@
 - Поддерживает strict-диагностику OpenAPI с JSON-отчетом (`--strict-openapi`, `--report-file`)
 - Поддерживает плагины генератора (`plugins`), включая встроенный `x-typescript-type`
 - Поддерживает генерацию бинарных request/response (`format: binary` -> `Blob`)
+- Поддерживает opt-in кэш генерации и инкрементальную запись (`--cache`, `--cachePath`, `--cacheStrategy`, `--cacheDebug`)
 
 ## Установка
 
@@ -43,6 +44,8 @@ npm install ts-openapi-codegen --save-dev
 - [Файл конфигурации](docs/ru/configuration.md)
 - [Примеры](docs/ru/examples.md)
 - [Возможности](docs/ru/features.md)
+- [Плагины](docs/ru/plugins.md)
+- [Plugin API v2 (RFC)](docs/ru/plugin-api-v2.md)
 - [English README](README.md)
 - [English docs](docs/en/usage.md)
 

package/dist/cli/checkAndUpdateConfig/__tests__/checkConfig.test.d.ts

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

package/dist/cli/checkAndUpdateConfig/__tests__/checkConfig.test.d.ts.map

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

package/dist/cli/checkAndUpdateConfig/__tests__/checkConfig.test.js

@@ -0,0 +1,63 @@
+"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 promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_test_1 = require("node:test");
+const Consts_1 = require("../../../common/Consts");
+const HttpClient_enum_1 = require("../../../core/types/enums/HttpClient.enum");
+const checkConfig_1 = require("../checkConfig");
+class ProcessExitError extends Error {
+    exitCode;
+    constructor(exitCode) {
+        super(`process.exit(${exitCode})`);
+        this.exitCode = exitCode;
+        this.name = 'ProcessExitError';
+    }
+}
+/** Config without schema-default fields so checkConfig does not open enquirer. */
+const flatConfig = {
+    input: './test/spec/v3.json',
+    output: './test/generated',
+    httpClient: HttpClient_enum_1.HttpClient.AXIOS,
+};
+const mockProcessExit = () => node_test_1.mock.method(process, 'exit', (code) => {
+    throw new ProcessExitError(Number(code ?? 0));
+});
+async function writeConfig(dir, content) {
+    const configPath = (0, node_path_1.join)(dir, 'openapi.config.json');
+    await (0, promises_1.writeFile)(configPath, JSON.stringify(content, null, 2), 'utf8');
+    return configPath;
+}
+(0, node_test_1.describe)('@unit: checkConfig', () => {
+    (0, node_test_1.test)('exits when options fail schema validation', async () => {
+        const exitMock = mockProcessExit();
+        const shutdownMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'shutdownLoggerAsync', async () => undefined);
+        const errorMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'error', () => undefined);
+        await node_assert_1.default.rejects(() => (0, checkConfig_1.checkConfig)({ openapiConfig: 123 }), ProcessExitError);
+        exitMock.mock.restore();
+        shutdownMock.mock.restore();
+        errorMock.mock.restore();
+    });
+    (0, node_test_1.test)('exits when config file is missing', async () => {
+        const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'check-config-'));
+        const configPath = (0, node_path_1.join)(dir, 'missing.json');
+        const exitMock = mockProcessExit();
+        const shutdownMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'shutdownLoggerAsync', async () => undefined);
+        await node_assert_1.default.rejects(() => (0, checkConfig_1.checkConfig)({ openapiConfig: configPath }), ProcessExitError);
+        exitMock.mock.restore();
+        shutdownMock.mock.restore();
+    });
+    (0, node_test_1.test)('reports valid config without prompting when up to date', async () => {
+        const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'check-config-'));
+        const configPath = await writeConfig(dir, flatConfig);
+        const infoMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'info', () => undefined);
+        await (0, checkConfig_1.checkConfig)({ openapiConfig: configPath });
+        node_assert_1.default.strictEqual(infoMock.mock.callCount(), 1);
+        infoMock.mock.restore();
+    });
+});

package/dist/cli/checkAndUpdateConfig/__tests__/updateConfig.test.d.ts

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

package/dist/cli/checkAndUpdateConfig/__tests__/updateConfig.test.d.ts.map

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

package/dist/cli/checkAndUpdateConfig/__tests__/updateConfig.test.js

@@ -0,0 +1,62 @@
+"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 promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_test_1 = require("node:test");
+const Consts_1 = require("../../../common/Consts");
+const HttpClient_enum_1 = require("../../../core/types/enums/HttpClient.enum");
+const updateConfig_1 = require("../updateConfig");
+class ProcessExitError extends Error {
+    exitCode;
+    constructor(exitCode) {
+        super(`process.exit(${exitCode})`);
+        this.exitCode = exitCode;
+        this.name = 'ProcessExitError';
+    }
+}
+const flatConfig = {
+    input: './test/spec/v3.json',
+    output: './test/generated',
+    httpClient: HttpClient_enum_1.HttpClient.FETCH,
+};
+const mockProcessExit = () => node_test_1.mock.method(process, 'exit', (code) => {
+    throw new ProcessExitError(Number(code ?? 0));
+});
+async function writeConfig(dir, content) {
+    const configPath = (0, node_path_1.join)(dir, 'openapi.config.json');
+    await (0, promises_1.writeFile)(configPath, JSON.stringify(content, null, 2), 'utf8');
+    return configPath;
+}
+(0, node_test_1.describe)('@unit: updateConfig', () => {
+    (0, node_test_1.test)('exits when options fail schema validation', async () => {
+        const exitMock = mockProcessExit();
+        const shutdownMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'shutdownLoggerAsync', async () => undefined);
+        const errorMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'error', () => undefined);
+        await node_assert_1.default.rejects(() => (0, updateConfig_1.updateConfig)({ openapiConfig: 123 }), ProcessExitError);
+        exitMock.mock.restore();
+        shutdownMock.mock.restore();
+        errorMock.mock.restore();
+    });
+    (0, node_test_1.test)('exits when config file is missing', async () => {
+        const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'update-config-'));
+        const configPath = (0, node_path_1.join)(dir, 'missing.json');
+        const exitMock = mockProcessExit();
+        const shutdownMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'shutdownLoggerAsync', async () => undefined);
+        await node_assert_1.default.rejects(() => (0, updateConfig_1.updateConfig)({ openapiConfig: configPath }), ProcessExitError);
+        exitMock.mock.restore();
+        shutdownMock.mock.restore();
+    });
+    (0, node_test_1.test)('logs up to date when config is current', async () => {
+        const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'update-config-'));
+        const configPath = await writeConfig(dir, flatConfig);
+        const infoMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'info', () => undefined);
+        await (0, updateConfig_1.updateConfig)({ openapiConfig: configPath });
+        node_assert_1.default.strictEqual(infoMock.mock.callCount(), 1);
+        infoMock.mock.restore();
+    });
+});

package/dist/cli/checkAndUpdateConfig/utils/__tests__/prepareConfigData.test.d.ts

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

package/dist/cli/checkAndUpdateConfig/utils/__tests__/prepareConfigData.test.d.ts.map

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

package/dist/cli/checkAndUpdateConfig/utils/__tests__/prepareConfigData.test.js

@@ -0,0 +1,20 @@
+"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_test_1 = require("node:test");
+const prepareConfigData_1 = require("../prepareConfigData");
+(0, node_test_1.describe)('@unit: prepareConfigData', () => {
+    (0, node_test_1.test)('serializes and formats config as JSON string', async () => {
+        const formatted = await (0, prepareConfigData_1.prepareConfigData)({
+            input: './test/spec/v3.json',
+            output: './generated',
+        });
+        node_assert_1.default.match(formatted, /"input":\s*"\.\/test\/spec\/v3\.json"/);
+        node_assert_1.default.match(formatted, /"output":\s*"\.\/generated"/);
+        node_assert_1.default.ok(formatted.trim().startsWith('{'));
+        node_assert_1.default.ok(formatted.trim().endsWith('}'));
+    });
+});

package/dist/cli/checkAndUpdateConfig/utils/__tests__/removeDefaultConfigValues.test.d.ts

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

package/dist/cli/checkAndUpdateConfig/utils/__tests__/removeDefaultConfigValues.test.d.ts.map

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

package/dist/cli/checkAndUpdateConfig/utils/__tests__/removeDefaultConfigValues.test.js

@@ -0,0 +1,35 @@
+"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_test_1 = require("node:test");
+const Consts_1 = require("../../../../common/Consts");
+const HttpClient_enum_1 = require("../../../../core/types/enums/HttpClient.enum");
+const removeDefaultConfigValues_1 = require("../removeDefaultConfigValues");
+(0, node_test_1.describe)('@unit: removeDefaultConfigValues', () => {
+    (0, node_test_1.test)('removes keys that match COMMON_DEFAULT_OPTIONS_VALUES', () => {
+        const cleaned = (0, removeDefaultConfigValues_1.removeDefaultConfigValues)({
+            input: './spec.json',
+            output: './generated',
+            httpClient: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.httpClient,
+            sortByRequired: Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.sortByRequired,
+        });
+        node_assert_1.default.deepStrictEqual(cleaned, {
+            input: './spec.json',
+            output: './generated',
+        });
+    });
+    (0, node_test_1.test)('keeps custom values that differ from defaults', () => {
+        const cleaned = (0, removeDefaultConfigValues_1.removeDefaultConfigValues)({
+            input: './spec.json',
+            output: './generated',
+            httpClient: HttpClient_enum_1.HttpClient.AXIOS,
+            interfacePrefix: 'Api',
+        });
+        node_assert_1.default.strictEqual(cleaned.httpClient, HttpClient_enum_1.HttpClient.AXIOS);
+        node_assert_1.default.strictEqual(cleaned.interfacePrefix, 'Api');
+        node_assert_1.default.strictEqual(cleaned.input, './spec.json');
+    });
+});

package/dist/cli/checkAndUpdateConfig/utils/__tests__/validateAndMigrateConfigData.test.d.ts

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

package/dist/cli/checkAndUpdateConfig/utils/__tests__/validateAndMigrateConfigData.test.d.ts.map

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

package/dist/cli/checkAndUpdateConfig/utils/__tests__/validateAndMigrateConfigData.test.js

@@ -0,0 +1,59 @@
+"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_test_1 = require("node:test");
+const Consts_1 = require("../../../../common/Consts");
+const HttpClient_enum_1 = require("../../../../core/types/enums/HttpClient.enum");
+const validateAndMigrateConfigData_1 = require("../validateAndMigrateConfigData");
+const flatConfig = {
+    input: './test/spec/v3.json',
+    output: './generated',
+    httpClient: HttpClient_enum_1.HttpClient.FETCH,
+};
+(0, node_test_1.describe)('@unit: validateAndMigrateConfigData', () => {
+    (0, node_test_1.test)('accepts current flat object config', () => {
+        const result = (0, validateAndMigrateConfigData_1.validateAndMigrateConfigData)({ ...flatConfig });
+        node_assert_1.default.strictEqual(result.isActualConfigVersion, true);
+        node_assert_1.default.strictEqual(result.migratedData.input, flatConfig.input);
+        node_assert_1.default.strictEqual(result.migratedData.output, flatConfig.output);
+    });
+    (0, node_test_1.test)('marks deprecated array format as outdated', () => {
+        const warnMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'warn', () => undefined);
+        const legacyArray = [
+            { input: './a.json', output: './generated/a', httpClient: HttpClient_enum_1.HttpClient.AXIOS, useOptions: true },
+            { input: './b.json', output: './generated/b', httpClient: HttpClient_enum_1.HttpClient.AXIOS, useOptions: true },
+        ];
+        const result = (0, validateAndMigrateConfigData_1.validateAndMigrateConfigData)(legacyArray);
+        node_assert_1.default.strictEqual(result.isActualConfigVersion, false);
+        node_assert_1.default.ok(Array.isArray(result.migratedData.items));
+        node_assert_1.default.strictEqual(result.migratedData.items.length, 2);
+        node_assert_1.default.strictEqual(warnMock.mock.callCount(), 1);
+        warnMock.mock.restore();
+    });
+    (0, node_test_1.test)('migrates multi-options config with items', () => {
+        const multiConfig = {
+            items: [
+                { input: './api/v1.json', output: './generated/v1' },
+                { input: './api/v2.json', output: './generated/v2' },
+            ],
+            httpClient: HttpClient_enum_1.HttpClient.AXIOS,
+        };
+        const result = (0, validateAndMigrateConfigData_1.validateAndMigrateConfigData)(multiConfig);
+        node_assert_1.default.ok(result.migratedData.items);
+        node_assert_1.default.strictEqual(result.migratedData.items.length, 2);
+        node_assert_1.default.strictEqual(result.migratedData.httpClient, HttpClient_enum_1.HttpClient.AXIOS);
+    });
+    (0, node_test_1.test)('detects default values when config matches defaults', () => {
+        const withDefaults = {
+            ...flatConfig,
+            httpClient: HttpClient_enum_1.HttpClient.FETCH,
+            sortByRequired: false,
+        };
+        const result = (0, validateAndMigrateConfigData_1.validateAndMigrateConfigData)(withDefaults);
+        node_assert_1.default.strictEqual(result.hasDefaultValues, true);
+        node_assert_1.default.strictEqual(result.migratedData.httpClient, undefined);
+    });
+});

package/dist/cli/index.js

@@ -60,6 +60,7 @@ program
     .option('--enumPrefix <value>', 'Prefix for enum model(default: "E")', 'E')
     .option('--typePrefix <value>', 'Prefix for type model(default: "T")', 'T')
     .option('--useCancelableRequest', 'Use cancelled promise as returned data type in request (default: false)')
+    .option('--useRequestRaw [value]', 'Generate requestRaw methods and raw HTTP stack (default: true)', (value) => value === undefined || value === 'true' || value === true)
     .addOption(new commander_1.Option('-l, --logLevel <level>', 'Logging level').choices([...Object.values(Enums_1.ELogLevel)]).default(Enums_1.ELogLevel.ERROR))
     .addOption(new commander_1.Option('-t, --logTarget <target>', 'Target of logging').choices([...Object.values(Enums_1.ELogOutput)]).default(Enums_1.ELogOutput.CONSOLE))
     .option('-s, --sortByRequired', 'Property sorting strategy: simplified or extended')
@@ -116,6 +117,7 @@ program
     .option('-sd, --specs-dir <value>', 'Путь до директории с файлами спецификации', './openapi')
     .option('--request <value>', 'Path to custom request file')
     .option('--useCancelableRequest', 'Use cancelled promise as returned data type in request (default: false)')
+    .option('--useRequestRaw [value]', 'Generate requestRaw methods and raw HTTP stack (default: true)', (value) => value === undefined || value === true || value === 'true')
     .option('--useInteractiveMode', 'Использовать интерактивный режим команды. В терминале будут задаваться вопросы  (default: false)')
     .hook('preAction', async () => {
     await updateNotifier.checkAndNotify();

package/dist/cli/initOpenApiConfig/__tests__/init.test.d.ts

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

package/dist/cli/initOpenApiConfig/__tests__/init.test.d.ts.map

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

package/dist/cli/initOpenApiConfig/__tests__/init.test.js

@@ -0,0 +1,30 @@
+"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_test_1 = require("node:test");
+const Consts_1 = require("../../../common/Consts");
+const init_1 = require("../init");
+class ProcessExitError extends Error {
+    exitCode;
+    constructor(exitCode) {
+        super(`process.exit(${exitCode})`);
+        this.exitCode = exitCode;
+        this.name = 'ProcessExitError';
+    }
+}
+(0, node_test_1.describe)('@unit: init', () => {
+    (0, node_test_1.test)('exits when options fail schema validation', async () => {
+        const exitMock = node_test_1.mock.method(process, 'exit', (code) => {
+            throw new ProcessExitError(Number(code ?? 0));
+        });
+        const shutdownMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'shutdownLoggerAsync', async () => undefined);
+        const errorMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'error', () => undefined);
+        await node_assert_1.default.rejects(() => (0, init_1.init)({ specsDir: 123 }), ProcessExitError);
+        exitMock.mock.restore();
+        shutdownMock.mock.restore();
+        errorMock.mock.restore();
+    });
+});

package/dist/cli/initOpenApiConfig/__tests__/initConfig.test.d.ts

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

package/dist/cli/initOpenApiConfig/__tests__/initConfig.test.d.ts.map

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

package/dist/cli/initOpenApiConfig/__tests__/initConfig.test.js

@@ -0,0 +1,47 @@
+"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 promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_test_1 = require("node:test");
+const Consts_1 = require("../../../common/Consts");
+const initConfig_1 = require("../initConfig");
+const registerHandlebarTemplates_1 = require("../utils/registerHandlebarTemplates");
+(0, node_test_1.describe)('@unit: initConfig', () => {
+    (0, node_test_1.test)('leaves existing config unchanged in non-interactive mode', async () => {
+        const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'init-config-'));
+        const configPath = (0, node_path_1.join)(dir, 'openapi.config.json');
+        await (0, promises_1.writeFile)(configPath, '{"input":"./x.json","output":"./out"}', 'utf8');
+        const warnMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'warn', () => undefined);
+        const infoMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'info', () => undefined);
+        const templates = (0, registerHandlebarTemplates_1.registerHandlebarTemplates)();
+        await (0, initConfig_1.initConfig)({
+            openapiConfig: configPath,
+            specsDir: dir,
+            templates,
+            useInteractiveMode: false,
+        });
+        node_assert_1.default.strictEqual(warnMock.mock.callCount(), 1);
+        node_assert_1.default.strictEqual(infoMock.mock.callCount(), 1);
+        warnMock.mock.restore();
+        infoMock.mock.restore();
+    });
+    (0, node_test_1.test)('writes example config when no specs are found', async () => {
+        const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'init-config-'));
+        const configPath = (0, node_path_1.join)(dir, 'new-openapi.config.json');
+        const templates = (0, registerHandlebarTemplates_1.registerHandlebarTemplates)();
+        await (0, initConfig_1.initConfig)({
+            openapiConfig: configPath,
+            specsDir: (0, node_path_1.join)(dir, 'empty-specs'),
+            templates,
+            useInteractiveMode: false,
+        });
+        const written = await (0, promises_1.readFile)(configPath, 'utf8');
+        node_assert_1.default.match(written, /"input"/);
+        node_assert_1.default.match(written, /"output"/);
+    });
+});

package/dist/cli/initOpenApiConfig/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/initOpenApiConfig/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAWzC;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,YAAY,iBAwD/C"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/initOpenApiConfig/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAWzC;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,YAAY,iBA0D/C"}

package/dist/cli/initOpenApiConfig/init.js

@@ -43,6 +43,7 @@ async function init(options) {
             await (0, initCustomRequest_1.initCustomRequest)({
                 templates,
                 useCancelableRequest: validatedOptions?.useCancelableRequest,
+                useRequestRaw: validatedOptions?.useRequestRaw,
                 customRequestPath: validatedOptions.request,
                 useInteractiveMode: validatedOptions.useInteractiveMode,
             });
@@ -59,6 +60,7 @@ async function init(options) {
         await (0, initCustomRequest_1.initCustomRequest)({
             templates,
             useCancelableRequest: validatedOptions?.useCancelableRequest,
+            useRequestRaw: validatedOptions?.useRequestRaw,
             customRequestPath: validatedOptions.request,
             useInteractiveMode: validatedOptions.useInteractiveMode,
         });

package/dist/cli/initOpenApiConfig/initCustomRequest.d.ts

@@ -2,6 +2,7 @@ import { CLITemplates } from './Types';
 type InitCustomRequestParams = {
     templates: CLITemplates;
     useCancelableRequest?: boolean;
+    useRequestRaw?: boolean;
     customRequestPath?: string;
     useInteractiveMode?: boolean;
 };

package/dist/cli/initOpenApiConfig/initCustomRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initCustomRequest.d.ts","sourceRoot":"","sources":["../../../src/cli/initOpenApiConfig/initCustomRequest.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,KAAK,uBAAuB,GAAG;IAC3B,SAAS,EAAE,YAAY,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDtF"}
+{"version":3,"file":"initCustomRequest.d.ts","sourceRoot":"","sources":["../../../src/cli/initOpenApiConfig/initCustomRequest.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,KAAK,uBAAuB,GAAG;IAC3B,SAAS,EAAE,YAAY,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDtF"}

package/dist/cli/initOpenApiConfig/initCustomRequest.js

@@ -12,7 +12,7 @@ const format_1 = require("../../common/utils/format");
 const pathHelpers_1 = require("../../common/utils/pathHelpers");
 const confirmDialog_1 = require("../interactive/confirmDialog");
 async function initCustomRequest(params) {
-    const { templates, useCancelableRequest, customRequestPath, useInteractiveMode } = params;
+    const { templates, useCancelableRequest, useRequestRaw, customRequestPath, useInteractiveMode } = params;
     if (!customRequestPath) {
         Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.CUSTOM_REQUEST.PATH_NOT_PROVIDED);
         return;
@@ -25,6 +25,7 @@ async function initCustomRequest(params) {
         : false;
     const artifacts = {
         useCancelableRequest,
+        useRequestRaw,
     };
     const file = (0, pathHelpers_1.resolveHelper)(process.cwd(), customRequestPath);
     const fileDir = path_1.default.dirname(file);

package/dist/cli/initOpenApiConfig/utils/__tests__/buildConfig.test.d.ts

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

package/dist/cli/initOpenApiConfig/utils/__tests__/buildConfig.test.d.ts.map

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

package/dist/cli/initOpenApiConfig/utils/__tests__/buildConfig.test.js

@@ -0,0 +1,99 @@
+"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_test_1 = require("node:test");
+const Consts_1 = require("../../../../common/Consts");
+const buildConfig_1 = require("../buildConfig");
+const createMockSpec = (relativePath = './test/spec.yml') => ({
+    relativePath,
+    path: '',
+});
+(0, node_test_1.describe)('@unit: buildConfig', () => {
+    (0, node_test_1.test)('creates items array for multiple specs in multi-option mode', async () => {
+        const validatedSpecs = [
+            createMockSpec('./api/v1.yml'),
+            createMockSpec('./api/v2.yml'),
+        ];
+        const result = await (0, buildConfig_1.buildConfig)(validatedSpecs, true);
+        node_assert_1.default.strictEqual(result.items?.length, 2);
+        node_assert_1.default.strictEqual(result.items?.[0].input, './api/v1.yml');
+        node_assert_1.default.strictEqual(result.items?.[1].input, './api/v2.yml');
+        node_assert_1.default.strictEqual(result.items?.[0].output, Consts_1.DEFAULT_OUTPUT_API_DIR);
+        node_assert_1.default.strictEqual(result.items?.[1].output, Consts_1.DEFAULT_OUTPUT_API_DIR);
+    });
+    (0, node_test_1.test)('includes per-item request when perSpecRequest is enabled', async () => {
+        const validatedSpecs = [createMockSpec()];
+        const customRequest = './custom/request.ts';
+        const result = await (0, buildConfig_1.buildConfig)(validatedSpecs, true, customRequest, true);
+        node_assert_1.default.strictEqual(result.items?.[0].request, customRequest);
+        node_assert_1.default.strictEqual(result.request, undefined);
+    });
+    (0, node_test_1.test)('includes root request when perSpecRequest is disabled', async () => {
+        const validatedSpecs = [createMockSpec()];
+        const customRequest = './custom/request.ts';
+        const result = await (0, buildConfig_1.buildConfig)(validatedSpecs, true, customRequest, false);
+        node_assert_1.default.strictEqual(result.items?.[0].request, undefined);
+        node_assert_1.default.strictEqual(result.request, customRequest);
+    });
+    (0, node_test_1.test)('sets default values from COMMON_DEFAULT_OPTIONS_VALUES in multi mode', async () => {
+        const result = await (0, buildConfig_1.buildConfig)([createMockSpec()], true);
+        node_assert_1.default.strictEqual(result.httpClient, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.httpClient);
+        node_assert_1.default.strictEqual(result.sortByRequired, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.sortByRequired);
+        node_assert_1.default.strictEqual(result.enumPrefix, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.enumPrefix);
+        node_assert_1.default.strictEqual(result.excludeCoreServiceFiles, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.excludeCoreServiceFiles);
+        node_assert_1.default.strictEqual(result.interfacePrefix, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.interfacePrefix);
+        node_assert_1.default.strictEqual(result.typePrefix, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.typePrefix);
+        node_assert_1.default.strictEqual(result.useCancelableRequest, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useCancelableRequest);
+        node_assert_1.default.strictEqual(result.useOptions, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useOptions);
+        node_assert_1.default.strictEqual(result.useSeparatedIndexes, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useSeparatedIndexes);
+        node_assert_1.default.strictEqual(result.useUnionTypes, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useUnionTypes);
+        node_assert_1.default.strictEqual(result.modelsMode, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.modelsMode);
+        node_assert_1.default.strictEqual(result.useHistory, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useHistory);
+        node_assert_1.default.strictEqual(result.diffReport, Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.diffReport);
+    });
+    (0, node_test_1.test)('uses first spec for flat config', async () => {
+        const validatedSpecs = [
+            createMockSpec('./api/v1.yml'),
+            createMockSpec('./api/v2.yml'),
+        ];
+        const result = await (0, buildConfig_1.buildConfig)(validatedSpecs, false);
+        node_assert_1.default.strictEqual(result.input, './api/v1.yml');
+        node_assert_1.default.strictEqual(result.output, Consts_1.DEFAULT_OUTPUT_API_DIR);
+    });
+    (0, node_test_1.test)('throws when no validated specs in flat mode', async () => {
+        await node_assert_1.default.rejects(() => (0, buildConfig_1.buildConfig)([], false), /No validated spec files found/);
+    });
+    (0, node_test_1.test)('includes request in flat mode', async () => {
+        const customRequest = './custom/request.ts';
+        const result = await (0, buildConfig_1.buildConfig)([createMockSpec()], false, customRequest);
+        node_assert_1.default.strictEqual(result.request, customRequest);
+    });
+});
+(0, node_test_1.describe)('@unit: buildExampleConfig', () => {
+    (0, node_test_1.test)('creates multi-option example with placeholder spec path', () => {
+        const result = (0, buildConfig_1.buildExampleConfig)(true);
+        node_assert_1.default.strictEqual(result.items?.length, 1);
+        node_assert_1.default.strictEqual(result.items?.[0].input, './openapi/spec.yml');
+        node_assert_1.default.strictEqual(result.items?.[0].output, Consts_1.DEFAULT_OUTPUT_API_DIR);
+    });
+    (0, node_test_1.test)('creates flat example with placeholder spec path', () => {
+        const result = (0, buildConfig_1.buildExampleConfig)(false);
+        node_assert_1.default.strictEqual(result.input, './openapi/spec.yml');
+        node_assert_1.default.strictEqual(result.output, Consts_1.DEFAULT_OUTPUT_API_DIR);
+    });
+    (0, node_test_1.test)('includes root request for multi-option when not perSpecRequest', () => {
+        const customRequest = './custom/request.ts';
+        const result = (0, buildConfig_1.buildExampleConfig)(true, customRequest, false);
+        node_assert_1.default.strictEqual(result.request, customRequest);
+        node_assert_1.default.strictEqual(result.items?.[0].request, undefined);
+    });
+    (0, node_test_1.test)('includes per-item request when perSpecRequest is true', () => {
+        const customRequest = './custom/request.ts';
+        const result = (0, buildConfig_1.buildExampleConfig)(true, customRequest, true);
+        node_assert_1.default.strictEqual(result.request, undefined);
+        node_assert_1.default.strictEqual(result.items?.[0].request, customRequest);
+    });
+});

package/dist/cli/initOpenApiConfig/utils/__tests__/findSpecFiles.test.d.ts

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

package/dist/cli/initOpenApiConfig/utils/__tests__/findSpecFiles.test.d.ts.map

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