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

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

@@ -0,0 +1,52 @@
+"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");
+const flatConfig = {
+    input: './test/spec/v3.json',
+    output: './test/generated',
+    httpClient: HttpClient_enum_1.HttpClient.FETCH,
+};
+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)('returns failure when options fail schema validation', async () => {
+        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);
+        const result = await (0, updateConfig_1.updateConfig)({ openapiConfig: 123 });
+        node_assert_1.default.strictEqual(result.success, false);
+        node_assert_1.default.ok(result.error);
+        shutdownMock.mock.restore();
+        errorMock.mock.restore();
+    });
+    (0, node_test_1.test)('returns failure 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 shutdownMock = node_test_1.mock.method(Consts_1.APP_LOGGER, 'shutdownLoggerAsync', async () => undefined);
+        const result = await (0, updateConfig_1.updateConfig)({ openapiConfig: configPath });
+        node_assert_1.default.strictEqual(result.success, false);
+        node_assert_1.default.ok(result.error);
+        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);
+        const result = await (0, updateConfig_1.updateConfig)({ openapiConfig: configPath });
+        node_assert_1.default.strictEqual(result.success, true);
+        node_assert_1.default.strictEqual(infoMock.mock.callCount(), 1);
+        infoMock.mock.restore();
+    });
+});

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

@@ -1,4 +1,5 @@
 import { OptionValues } from 'commander';
+import { CLICommandResult } from '../types';
 /**
  * Проверяет конфигурационный файл на корректность и актуальность.
  * Если обнаружены проблемы, предлагает действия для их исправления.
@@ -9,5 +10,5 @@ import { OptionValues } from 'commander';
  * @example
  * await checkConfig('./openapi-config.json');
  */
-export declare function checkConfig(options: OptionValues): Promise<void>;
+export declare function checkConfig(options: OptionValues): Promise<CLICommandResult>;
 //# sourceMappingURL=checkConfig.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"checkConfig.d.ts","sourceRoot":"","sources":["../../../src/cli/checkAndUpdateConfig/checkConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAWzC;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDtE"}
+{"version":3,"file":"checkConfig.d.ts","sourceRoot":"","sources":["../../../src/cli/checkAndUpdateConfig/checkConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAK5C;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoDlF"}

package/dist/cli/checkAndUpdateConfig/checkConfig.js

@@ -24,14 +24,14 @@ async function checkConfig(options) {
     if (!validationResult.success) {
         Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.ERROR.GENERIC(validationResult.errors.join('\n')));
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        process.exit(1);
+        return { success: false, error: validationResult.errors.join('\n') };
     }
     const validatedOptions = validationResult.data;
     const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(validatedOptions.openapiConfig);
     if (!configData) {
         Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_NOT_FOUND(validatedOptions.openapiConfig || ''));
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        process.exit(1);
+        return { success: false, error: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_NOT_FOUND(validatedOptions.openapiConfig || '') };
     }
     try {
         const { isActualConfigVersion, hasDefaultValues, migratedData } = (0, validateAndMigrateConfigData_1.validateAndMigrateConfigData)(configData);
@@ -44,7 +44,8 @@ async function checkConfig(options) {
                 warningMessage: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.WARNING_OUTDATED_CONFIG,
                 actionChoices: constants_1.ACTION_FOR_CONFIG_DATA_OPTIONS,
             });
-            return;
+            await Consts_1.APP_LOGGER.shutdownLoggerAsync();
+            return { success: true };
         }
         // Если есть значения по умолчанию, предложить их удаление
         if (hasDefaultValues) {
@@ -55,11 +56,14 @@ async function checkConfig(options) {
                 actionChoices: constants_1.ACTION_FOR_CONFIG_DATA_OPTIONS,
             });
         }
+        await Consts_1.APP_LOGGER.shutdownLoggerAsync();
+        return { success: true };
     }
     catch (error) {
         handleConfigError(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.CHECKING_FAILED, error);
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        process.exit(1);
+        const message = error instanceof Error ? error.message : String(error);
+        return { success: false, error: message };
     }
 }
 /**

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

@@ -1,4 +1,5 @@
 import { OptionValues } from 'commander';
+import { CLICommandResult } from '../types';
 /**
  * Обновляет конфигурационный файл до актуальной версии.
  * Выполняет миграцию данных при необходимости.
@@ -9,5 +10,5 @@ import { OptionValues } from 'commander';
  * @example
  * await updateConfig('./openapi-config.json');
  */
-export declare function updateConfig(options: OptionValues): Promise<void>;
+export declare function updateConfig(options: OptionValues): Promise<CLICommandResult>;
 //# sourceMappingURL=updateConfig.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"updateConfig.d.ts","sourceRoot":"","sources":["../../../src/cli/checkAndUpdateConfig/updateConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAUzC;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCvE"}
+{"version":3,"file":"updateConfig.d.ts","sourceRoot":"","sources":["../../../src/cli/checkAndUpdateConfig/updateConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAI5C;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuCnF"}

package/dist/cli/checkAndUpdateConfig/updateConfig.js

@@ -23,14 +23,14 @@ async function updateConfig(options) {
     if (!validationResult.success) {
         Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.ERROR.GENERIC(validationResult.errors.join('\n')));
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        process.exit(1);
+        return { success: false, error: validationResult.errors.join('\n') };
     }
     const validatedOptions = validationResult.data;
     const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(validatedOptions.openapiConfig);
     if (!configData) {
         Consts_1.APP_LOGGER.error(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_NOT_FOUND(validatedOptions.openapiConfig || ''));
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        process.exit(1);
+        return { success: false, error: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_NOT_FOUND(validatedOptions.openapiConfig || '') };
     }
     try {
         const { isActualConfigVersion, migratedData } = (0, validateAndMigrateConfigData_1.validateAndMigrateConfigData)(configData);
@@ -44,11 +44,14 @@ async function updateConfig(options) {
                 isUpdating: true,
             });
         }
+        await Consts_1.APP_LOGGER.shutdownLoggerAsync();
+        return { success: true };
     }
     catch (error) {
         handleUpdateError(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.UPDATING_FAILED, error);
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        process.exit(1);
+        const message = error instanceof Error ? error.message : String(error);
+        return { success: false, error: message };
     }
 }
 /**

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/checkAndUpdateConfig/utils/validateAndMigrateConfigData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateAndMigrateConfigData.d.ts","sourceRoot":"","sources":["../../../../src/cli/checkAndUpdateConfig/utils/validateAndMigrateConfigData.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,uBAAuB,CAmC7H"}
+{"version":3,"file":"validateAndMigrateConfigData.d.ts","sourceRoot":"","sources":["../../../../src/cli/checkAndUpdateConfig/utils/validateAndMigrateConfigData.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AA6BnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,uBAAuB,CAmC7H"}

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

@@ -12,6 +12,24 @@ const OptionsVersionedSchemas_1 = require("../../../common/VersionedSchema/Optio
 const migrateDataToLatestSchemaVersion_1 = require("../../../common/VersionedSchema/Utils/migrateDataToLatestSchemaVersion");
 const isInstanceOfMultiOptions_1 = require("../../../core/utils/isInstanceOfMultiOptions");
 const removeDefaultConfigValues_1 = require("./removeDefaultConfigValues");
+const omitUndefinedValues = (data) => {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            result[key] = value.map(item => item && typeof item === 'object' && !Array.isArray(item) ? omitUndefinedValues(item) : item);
+            continue;
+        }
+        if (value && typeof value === 'object') {
+            result[key] = omitUndefinedValues(value);
+            continue;
+        }
+        result[key] = value;
+    }
+    return result;
+};
 /**
  * Валидирует и мигрирует данные конфигурации до последней версии схемы.
  * Определяет тип конфигурации (одиночная или множественная опция) и применяет соответствующий план миграции.
@@ -31,7 +49,7 @@ function validateAndMigrateConfigData(configData) {
     if (isArrayFormat) {
         Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.ARRAY_DEPRECATED);
     }
-    const normalizedData = (0, convertArrayToObject_1.convertArrayToObject)(configData);
+    const normalizedData = omitUndefinedValues((0, convertArrayToObject_1.convertArrayToObject)(configData));
     const isMultiOptions = (0, isInstanceOfMultiOptions_1.isInstanceOfMultioptions)(normalizedData);
     // Выбрать соответствующие схемы и планы миграции
     const migrationPlans = isMultiOptions ? MultiOptionsMigrationPlan_1.multiOptionsMigrationPlan : OptionsMigrationPlans_1.optionsMigrationPlans;

package/dist/cli/generateOpenApiClient/__tests__/generateOpenApiClient.strict.test.js

@@ -7,6 +7,7 @@ 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 silenceLoggers_1 = require("../../../test/helpers/silenceLoggers");
 const generateOpenApiClient_1 = require("../generateOpenApiClient");
 const repoRoot = node_path_1.default.join(__dirname, '..', '..', '..', '..');
 const cliDefaults = {
@@ -35,23 +36,31 @@ function createTempDir(t, prefix) {
     return tempDir;
 }
 function runStrictGenerate(options) {
-    return (0, generateOpenApiClient_1.runGenerateOpenApiClient)({
+    return (0, generateOpenApiClient_1.generateOpenApiClient)({
         ...cliDefaults,
         ...options,
     });
 }
 (0, node_test_1.describe)('@unit: generateOpenApiClient strict-openapi', () => {
-    (0, node_test_1.test)('returns exit code 0 and writes report file when strict has no errors', async (t) => {
+    let restoreLoggers;
+    (0, node_test_1.beforeEach)(() => {
+        restoreLoggers = (0, silenceLoggers_1.installSilenceLoggers)();
+    });
+    (0, node_test_1.afterEach)(() => {
+        restoreLoggers?.();
+        restoreLoggers = undefined;
+    });
+    (0, node_test_1.test)('returns success and writes report file when strict has no errors', async (t) => {
         const tempDir = createTempDir(t, 'openapi-cli-strict-ok-');
         const reportFile = node_path_1.default.join(tempDir, 'strict-report.json');
         const outputDir = node_path_1.default.join(tempDir, 'generated');
-        const exitCode = await runStrictGenerate({
+        const result = await runStrictGenerate({
             input: node_path_1.default.join(repoRoot, 'test/spec/lom/lom_api.yaml'),
             output: outputDir,
             strictOpenapi: true,
             reportFile,
         });
-        node_assert_1.default.strictEqual(exitCode, 0);
+        node_assert_1.default.strictEqual(result.success, true);
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportFile, 'utf8'));
         node_assert_1.default.ok(Array.isArray(report.issues));
         node_assert_1.default.ok(Array.isArray(report.governance.violations));
@@ -59,7 +68,7 @@ function runStrictGenerate(options) {
         node_assert_1.default.strictEqual(typeof report.summary.warnings, 'number');
         node_assert_1.default.strictEqual(typeof report.summary.info, 'number');
     });
-    (0, node_test_1.test)('returns exit code 1 and writes report file when strict finds errors', async (t) => {
+    (0, node_test_1.test)('returns failure and writes report file when strict finds errors', async (t) => {
         const tempDir = createTempDir(t, 'openapi-cli-strict-error-');
         const inputSpec = node_path_1.default.join(tempDir, 'broken-openapi.json');
         const reportFile = node_path_1.default.join(tempDir, 'strict-report.json');
@@ -92,13 +101,13 @@ function runStrictGenerate(options) {
                 schemas: {},
             },
         }));
-        const exitCode = await runStrictGenerate({
+        const result = await runStrictGenerate({
             input: inputSpec,
             output: outputDir,
             strictOpenapi: true,
             reportFile,
         });
-        node_assert_1.default.strictEqual(exitCode, 1);
+        node_assert_1.default.strictEqual(result.success, false);
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportFile, 'utf8'));
         node_assert_1.default.ok(report.summary.errors > 0);
         node_assert_1.default.ok(report.issues.some(issue => issue.severity === 'error'));
@@ -137,14 +146,14 @@ function runStrictGenerate(options) {
                 },
             },
         }));
-        const exitCode = await runStrictGenerate({
+        const result = await runStrictGenerate({
             input: inputSpec,
             output: outputDir,
             strictOpenapi: true,
             reportFile,
             governanceConfig,
         });
-        node_assert_1.default.strictEqual(exitCode, 0);
+        node_assert_1.default.strictEqual(result.success, true);
         const report = JSON.parse((0, node_fs_1.readFileSync)(reportFile, 'utf8'));
         node_assert_1.default.ok(!report.governance.violations.some(violation => violation.ruleId === 'REQUIRE_OPERATION_ID'));
         node_assert_1.default.ok(report.governance.violations.some(violation => violation.ruleId === 'NO_DEFAULT_WITHOUT_2XX' && violation.severity === 'error'));

package/dist/cli/generateOpenApiClient/generateOpenApiClient.d.ts

@@ -1,11 +1,8 @@
 import { OptionValues } from 'commander';
+import { CLICommandResult } from '../types';
 /**
  * Runs OpenAPI client generation and returns a process exit code.
  * Does not call `process.exit` — safe for in-process unit tests.
  */
-export declare function runGenerateOpenApiClient(options: OptionValues): Promise<number>;
-/**
- * CLI entry: runs generation and terminates the process with the resulting exit code.
- */
-export declare function generateOpenApiClient(options: OptionValues): Promise<void>;
+export declare function generateOpenApiClient(options: OptionValues): Promise<CLICommandResult>;
 //# sourceMappingURL=generateOpenApiClient.d.ts.map

package/dist/cli/generateOpenApiClient/generateOpenApiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateOpenApiClient.d.ts","sourceRoot":"","sources":["../../../src/cli/generateOpenApiClient/generateOpenApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA0BzC;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA+FrF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF"}
+{"version":3,"file":"generateOpenApiClient.d.ts","sourceRoot":"","sources":["../../../src/cli/generateOpenApiClient/generateOpenApiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAezC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAY5C;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmG5F"}

package/dist/cli/generateOpenApiClient/generateOpenApiClient.js

@@ -33,7 +33,6 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runGenerateOpenApiClient = runGenerateOpenApiClient;
 exports.generateOpenApiClient = generateOpenApiClient;
 const Consts_1 = require("../../common/Consts");
 const Enums_1 = require("../../common/Enums");
@@ -60,7 +59,7 @@ const generateCliFlatSchema = UnifiedVersionedSchemas_1.flatOptionsSchema.strict
  * Runs OpenAPI client generation and returns a process exit code.
  * Does not call `process.exit` — safe for in-process unit tests.
  */
-async function runGenerateOpenApiClient(options) {
+async function generateOpenApiClient(options) {
     const { openapiConfig, ...clientOptions } = options;
     try {
         const validationResult = (0, validateZodOptions_1.validateZodOptions)(schemas_1.generateOptionsSchema, {
@@ -73,7 +72,7 @@ async function runGenerateOpenApiClient(options) {
                 message: LoggerMessages_1.LOGGER_MESSAGES.ERROR.GENERIC(validationResult.errors.join('\n')),
             });
             await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-            return 1;
+            return { success: false, error: validationResult.errors.join('\n') };
         }
         const validatedOptions = validationResult.data;
         const hasMinimumRequiredOptions = !!validatedOptions.input && !!validatedOptions.output;
@@ -89,11 +88,11 @@ async function runGenerateOpenApiClient(options) {
                     message: LoggerMessages_1.LOGGER_MESSAGES.ERROR.GENERIC(directOptionsValidationResult.errors.join('\n')),
                 });
                 await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-                return 1;
+                return { success: false, error: directOptionsValidationResult.errors.join('\n') };
             }
             await OpenAPI.generate(directOptionsValidationResult.data);
             await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-            return 0;
+            return { success: true };
         }
         const configData = (0, loadConfigIfExists_1.loadConfigIfExists)(validatedOptions.openapiConfig);
         if (!configData) {
@@ -102,7 +101,7 @@ async function runGenerateOpenApiClient(options) {
                 message: `${LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_MISSING}\n${LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_MISSING_HINT}`,
             });
             await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-            return 1;
+            return { success: false, error: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.FILE_MISSING };
         }
         if (Array.isArray(configData)) {
             Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.CONFIG.ARRAY_DEPRECATED);
@@ -120,7 +119,7 @@ async function runGenerateOpenApiClient(options) {
                 message: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.CONVERSION_FAILED,
             });
             await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-            return 1;
+            return { success: false, error: LoggerMessages_1.LOGGER_MESSAGES.CONFIG.CONVERSION_FAILED };
         }
         const { value } = migratedOptions;
         const mergedOptions = {
@@ -128,10 +127,14 @@ async function runGenerateOpenApiClient(options) {
             strictOpenapi: validatedOptions.strictOpenapi ?? value.strictOpenapi,
             reportFile: validatedOptions.reportFile ?? value.reportFile,
             governanceConfig: validatedOptions.governanceConfig ?? value.governanceConfig,
+            cache: validatedOptions.cache ?? value.cache,
+            cachePath: validatedOptions.cachePath ?? value.cachePath,
+            cacheStrategy: validatedOptions.cacheStrategy ?? value.cacheStrategy,
+            cacheDebug: validatedOptions.cacheDebug ?? value.cacheDebug,
         };
         await OpenAPI.generate(mergedOptions);
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        return 0;
+        return { success: true };
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
@@ -141,13 +144,6 @@ async function runGenerateOpenApiClient(options) {
             error,
         });
         await Consts_1.APP_LOGGER.shutdownLoggerAsync();
-        return 1;
+        return { success: false, error: message };
     }
 }
-/**
- * CLI entry: runs generation and terminates the process with the resulting exit code.
- */
-async function generateOpenApiClient(options) {
-    const exitCode = await runGenerateOpenApiClient(options);
-    process.exit(exitCode);
-}