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

package/dist/common/utils/__tests__/eslintFix.test.js

@@ -37,26 +37,19 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const node_assert_1 = __importDefault(require("node:assert"));
-const node_path_1 = __importDefault(require("node:path"));
 const node_test_1 = require("node:test");
 const Consts_1 = require("../../Consts");
-(0, node_test_1.describe)('@unit: eslintFix', () => {
+(0, node_test_1.describe)('@unit: eslintFixBatch', () => {
     let warnMessages = [];
-    let infoMessages = [];
     let errorWithHintCalls = [];
     const originalWarn = Consts_1.APP_LOGGER.warn.bind(Consts_1.APP_LOGGER);
-    const originalInfo = Consts_1.APP_LOGGER.info.bind(Consts_1.APP_LOGGER);
     const originalErrorWithHint = Consts_1.APP_LOGGER.errorWithHint.bind(Consts_1.APP_LOGGER);
     (0, node_test_1.beforeEach)(() => {
         warnMessages = [];
-        infoMessages = [];
         errorWithHintCalls = [];
         Consts_1.APP_LOGGER.warn = (msg) => {
             warnMessages.push(msg);
         };
-        Consts_1.APP_LOGGER.info = (msg) => {
-            infoMessages.push(msg);
-        };
         Consts_1.APP_LOGGER.errorWithHint = options => {
             errorWithHintCalls.push({
                 code: options.code,
@@ -67,68 +60,33 @@ const Consts_1 = require("../../Consts");
     });
     (0, node_test_1.afterEach)(() => {
         Consts_1.APP_LOGGER.warn = originalWarn;
-        Consts_1.APP_LOGGER.info = originalInfo;
         Consts_1.APP_LOGGER.errorWithHint = originalErrorWithHint;
     });
-    (0, node_test_1.describe)('when eslint is available', () => {
-        (0, node_test_1.test)('calls lintFiles and outputFixes and logs ESLINT_FIX_APPLIED', async () => {
-            // We import eslintFix here after mocking APP_LOGGER.
-            // If ESLint is installed in the project, it will run; otherwise the warn path is tested.
-            const { eslintFix } = await Promise.resolve().then(() => __importStar(require('../eslintFix')));
-            const filePath = node_path_1.default.resolve(__dirname, '__fixtures__/dummy.ts');
-            let threw = false;
-            try {
-                await eslintFix(filePath);
-            }
-            catch {
-                threw = true;
-            }
-            if (!threw) {
-                // ESLint is available — it either applied fixes or logged info
-                const fixApplied = infoMessages.some(m => m.includes('ESLint fix applied') || m.includes(filePath));
-                const notInstalled = warnMessages.some(m => m.includes('ESLint is not installed'));
-                node_assert_1.default.ok(fixApplied || notInstalled, 'should log either fix applied or not installed');
-            }
-        });
-    });
-    (0, node_test_1.describe)('when eslint is NOT available (graceful fallback)', () => {
-        (0, node_test_1.test)('logs ESLINT_NOT_INSTALLED warning and does not throw', async () => {
-            // Patch the module by temporarily replacing the tryImportESLint logic
-            // via an environment variable guard checked in eslintFix
-            // Since we can't easily mock dynamic import in tsx, we test the exported function
-            // with a patched internal approach: we verify the module itself handles the error.
-            // Re-import to get a fresh reference; the real behavior depends on whether eslint is installed.
-            const { eslintFix } = await Promise.resolve().then(() => __importStar(require('../eslintFix')));
-            // If eslint is not installed in devDeps, calling eslintFix should warn and not throw.
-            // If it IS installed, this test is a no-op (covered by the other test).
-            try {
-                await eslintFix('/non/existent/path/that/wont/lint.ts');
-                // Either it runs eslint on the fake path (may fail) or warns about not installed
-            }
-            catch {
-                // If eslint is installed but fails on non-existent path, verify errorWithHint was called
-                node_assert_1.default.ok(errorWithHintCalls.some(c => c.code === 'ESLINT_FIX_FAILED'), 'should call errorWithHint with ESLINT_FIX_FAILED when eslint throws');
-            }
+    (0, node_test_1.test)('returns null when file list is empty', async () => {
+        const { eslintFixBatch } = await Promise.resolve().then(() => __importStar(require('../eslintFix')));
+        const result = await eslintFixBatch({
+            files: [],
+            includeGlobs: ['./generated/**/*.ts'],
+            tsconfigPath: './tsconfig.json',
+            eslintConfigPath: './eslint.config.mjs',
         });
+        node_assert_1.default.strictEqual(result, null);
     });
-    (0, node_test_1.describe)('when eslint throws during fix', () => {
-        (0, node_test_1.test)('calls APP_LOGGER.errorWithHint with ESLINT_FIX_FAILED and re-throws', async () => {
-            const { eslintFix } = await Promise.resolve().then(() => __importStar(require('../eslintFix')));
-            // Pass a path that will cause ESLint to fail if installed
-            let threw = false;
-            try {
-                await eslintFix('/path/does/not/exist/file.ts');
-            }
-            catch {
-                threw = true;
-            }
-            if (threw) {
-                node_assert_1.default.ok(errorWithHintCalls.some(c => c.code === 'ESLINT_FIX_FAILED'), 'should log ESLINT_FIX_FAILED before re-throwing');
-            }
-            else {
-                // ESLint not installed — check warn was logged
-                node_assert_1.default.ok(warnMessages.some(m => m.includes('ESLint is not installed')), 'should warn that ESLint is not installed');
-            }
-        });
+    (0, node_test_1.test)('does not throw when eslint is unavailable or config is missing', async () => {
+        const { eslintFixBatch } = await Promise.resolve().then(() => __importStar(require('../eslintFix')));
+        let threw = false;
+        try {
+            await eslintFixBatch({
+                files: ['/non/existent/generated/file.ts'],
+                includeGlobs: ['./generated/**/*.ts'],
+                tsconfigPath: './tsconfig.json',
+                eslintConfigPath: './eslint.config.mjs',
+            });
+        }
+        catch {
+            threw = true;
+        }
+        const warnedNotInstalled = warnMessages.some(message => message.includes('ESLint is not installed'));
+        node_assert_1.default.ok(!threw || warnedNotInstalled || errorWithHintCalls.length > 0);
     });
 });

package/dist/common/utils/__tests__/extractEslintFixOptions.test.d.ts

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

package/dist/common/utils/__tests__/extractEslintFixOptions.test.d.ts.map

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

package/dist/common/utils/__tests__/extractEslintFixOptions.test.js

@@ -0,0 +1,28 @@
+"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 TEslintFixOptions_1 = require("../../TEslintFixOptions");
+(0, node_test_1.describe)('@unit: extractEslintFixOptions', () => {
+    (0, node_test_1.test)('reads eslint paths from top-level raw options', () => {
+        const result = (0, TEslintFixOptions_1.extractEslintFixOptions)({
+            httpClient: 'fetch',
+            tsconfigPath: './tsconfig.json',
+            eslintConfigPath: './eslint.config.mjs',
+            items: [{ input: './a.yaml', output: './out/a' }],
+        });
+        node_assert_1.default.strictEqual(result.tsconfigPath, './tsconfig.json');
+        node_assert_1.default.strictEqual(result.eslintConfigPath, './eslint.config.mjs');
+    });
+    (0, node_test_1.test)('returns undefined paths when not set', () => {
+        const result = (0, TEslintFixOptions_1.extractEslintFixOptions)({
+            httpClient: 'fetch',
+            items: [{ input: './a.yaml', output: './out/a' }],
+        });
+        node_assert_1.default.strictEqual(result.tsconfigPath, undefined);
+        node_assert_1.default.strictEqual(result.eslintConfigPath, undefined);
+    });
+});

package/dist/common/utils/__tests__/format.test.js

@@ -4,6 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (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("../../Consts");
 const format_1 = require("../format");
@@ -11,6 +14,7 @@ const format_1 = require("../format");
     let warnMessages = [];
     let infoMessages = [];
     let errorWithHintCalls = [];
+    let tempDir = null;
     const originalWarn = Consts_1.APP_LOGGER.warn.bind(Consts_1.APP_LOGGER);
     const originalInfo = Consts_1.APP_LOGGER.info.bind(Consts_1.APP_LOGGER);
     const originalErrorWithHint = Consts_1.APP_LOGGER.errorWithHint.bind(Consts_1.APP_LOGGER);
@@ -18,6 +22,7 @@ const format_1 = require("../format");
         warnMessages = [];
         infoMessages = [];
         errorWithHintCalls = [];
+        tempDir = null;
         Consts_1.APP_LOGGER.warn = (msg) => {
             warnMessages.push(msg);
         };
@@ -32,12 +37,15 @@ const format_1 = require("../format");
             });
         };
     });
-    (0, node_test_1.afterEach)(() => {
+    (0, node_test_1.afterEach)(async () => {
         Consts_1.APP_LOGGER.warn = originalWarn;
         Consts_1.APP_LOGGER.info = originalInfo;
         Consts_1.APP_LOGGER.errorWithHint = originalErrorWithHint;
+        if (tempDir) {
+            await (0, promises_1.rm)(tempDir, { recursive: true, force: true });
+        }
     });
-    (0, node_test_1.describe)('default behavior (useProjectConfig=false)', () => {
+    (0, node_test_1.describe)('default behavior (no prettierConfigPath)', () => {
         (0, node_test_1.test)('formats valid TypeScript with built-in options', async () => {
             const input = `const x={a:1,b:2}`;
             const result = await (0, format_1.format)(input);
@@ -54,32 +62,33 @@ const format_1 = require("../format");
             const result = await (0, format_1.format)(input, 'json');
             node_assert_1.default.ok(result.includes('"key"'), 'should format as JSON');
         });
-        (0, node_test_1.test)('does not call warn or info when useProjectConfig is omitted', async () => {
+        (0, node_test_1.test)('does not call warn or info when prettierConfigPath is omitted', async () => {
             await (0, format_1.format)(`const a = 1;`);
             node_assert_1.default.strictEqual(warnMessages.length, 0, 'should not warn');
             node_assert_1.default.strictEqual(infoMessages.length, 0, 'should not log info');
         });
     });
-    (0, node_test_1.describe)('useProjectConfig=true', () => {
-        (0, node_test_1.test)('falls back to built-in options and warns when no project config is found', async () => {
-            // Running from workspace root which may not have a .prettierrc matching every field;
-            // the only guaranteed outcome is that the function does not throw and returns formatted code.
-            const input = `const x = 1;`;
-            const result = await (0, format_1.format)(input, undefined, true);
-            node_assert_1.default.ok(result.trim().length > 0, 'should produce non-empty output');
+    (0, node_test_1.describe)('prettierConfigPath', () => {
+        (0, node_test_1.test)('resolves existing config file and logs info', async () => {
+            tempDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'format-test-'));
+            const configPath = (0, node_path_1.join)(tempDir, '.prettierrc');
+            await (0, promises_1.writeFile)(configPath, JSON.stringify({ singleQuote: false, tabWidth: 2 }));
+            const result = await (0, format_1.format)(`const x=1`, undefined, configPath);
+            node_assert_1.default.ok(result.includes('const x'), 'should produce formatted output');
+            node_assert_1.default.ok(infoMessages.some(m => m.includes('Prettier config resolved')), 'should log resolved config path');
         });
-        (0, node_test_1.test)('logs info when project config is resolved, or warns when not found', async () => {
-            await (0, format_1.format)(`const x = 1;`, undefined, true);
-            const resolvedSomething = infoMessages.some(m => m.includes('Prettier config resolved')) ||
-                warnMessages.some(m => m.includes('No project Prettier config'));
-            node_assert_1.default.ok(resolvedSomething, 'should log either resolved config path or fallback warning');
+        (0, node_test_1.test)('falls back to built-in options and warns when config file does not exist', async () => {
+            tempDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'format-test-'));
+            const missingConfigPath = (0, node_path_1.join)(tempDir, 'missing-prettier.json');
+            const result = await (0, format_1.format)(`const x = 1;`, undefined, missingConfigPath);
+            node_assert_1.default.ok(result.trim().length > 0, 'should produce non-empty output');
+            node_assert_1.default.ok(warnMessages.some(m => m.includes('missing-prettier.json')), 'should warn about missing config path');
         });
     });
     (0, node_test_1.describe)('error handling', () => {
         (0, node_test_1.test)('throws an Error and calls APP_LOGGER.errorWithHint when prettier fails', async () => {
-            // Feed an unparseable string with a syntax error that prettier cannot fix
             const invalidInput = `{{{{{{{ this is not valid typescript ;;; !!!`;
-            await node_assert_1.default.rejects(() => (0, format_1.format)(invalidInput, 'typescript', false), (err) => {
+            await node_assert_1.default.rejects(() => (0, format_1.format)(invalidInput, 'typescript'), (err) => {
                 node_assert_1.default.ok(err instanceof Error, 'should throw an Error');
                 node_assert_1.default.ok(err.message.includes('Could not format'), 'message should mention formatting failure');
                 return true;

package/dist/common/utils/__tests__/prepareTempTsConfig.test.d.ts

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

package/dist/common/utils/__tests__/prepareTempTsConfig.test.d.ts.map

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

package/dist/common/utils/__tests__/prepareTempTsConfig.test.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = require("node:test");
+const codegenTempDir_1 = require("../codegenTempDir");
+const prepareTempTsConfig_1 = require("../prepareTempTsConfig");
+(0, node_test_1.describe)('@unit: prepareTempTsConfig', () => {
+    let tempDir;
+    (0, node_test_1.afterEach)(async () => {
+        if (tempDir) {
+            await (0, codegenTempDir_1.cleanupCodegenTempDir)(tempDir);
+            node_fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+        }
+    });
+    (0, node_test_1.test)('replaces base include with narrow output globs only', async () => {
+        tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'openapi-eslint-'));
+        const baseTsconfigPath = node_path_1.default.join(tempDir, 'tsconfig.json');
+        node_fs_1.default.writeFileSync(baseTsconfigPath, JSON.stringify({
+            compilerOptions: { target: 'ES2020', strict: true },
+            include: ['src/**/*'],
+        }));
+        const tempPath = await (0, prepareTempTsConfig_1.prepareTempTsConfig)({
+            baseTsconfigPath,
+            includeGlobs: ['./generated/models/**/*.ts', './generated/services/**/*.ts'],
+            cwd: tempDir,
+        });
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(tempPath, 'utf8'));
+        node_assert_1.default.deepStrictEqual(parsed.include, [node_path_1.default.join(tempDir, 'generated/models/**/*.ts'), node_path_1.default.join(tempDir, 'generated/services/**/*.ts')]);
+        node_assert_1.default.notDeepEqual(parsed.include, [node_path_1.default.join(tempDir, 'src/**/*')]);
+        node_assert_1.default.strictEqual(parsed.compilerOptions.target, 'ES2020');
+        node_assert_1.default.strictEqual(parsed.compilerOptions.noEmit, true);
+        node_assert_1.default.strictEqual(parsed.compilerOptions.skipLibCheck, true);
+        node_assert_1.default.strictEqual(parsed.compilerOptions.incremental, false);
+    });
+    (0, node_test_1.test)('preserves raw lib entries from the base tsconfig', async () => {
+        tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'openapi-eslint-'));
+        const baseTsconfigPath = node_path_1.default.join(tempDir, 'tsconfig.json');
+        node_fs_1.default.writeFileSync(baseTsconfigPath, JSON.stringify({
+            compilerOptions: {
+                target: 'ES2022',
+                lib: ['es6', 'es2017', 'dom'],
+            },
+        }));
+        const tempPath = await (0, prepareTempTsConfig_1.prepareTempTsConfig)({
+            baseTsconfigPath,
+            includeGlobs: ['./generated/**/*.ts'],
+            cwd: tempDir,
+        });
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(tempPath, 'utf8'));
+        node_assert_1.default.deepStrictEqual(parsed.compilerOptions.lib, ['es6', 'es2017', 'dom']);
+    });
+    (0, node_test_1.test)('writes enum compiler options as tsconfig string literals', async () => {
+        tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'openapi-eslint-'));
+        const baseTsconfigPath = node_path_1.default.join(tempDir, 'tsconfig.json');
+        node_fs_1.default.writeFileSync(baseTsconfigPath, JSON.stringify({
+            compilerOptions: {
+                target: 'ES2022',
+                module: 'commonjs',
+                moduleResolution: 'node',
+            },
+        }));
+        const tempPath = await (0, prepareTempTsConfig_1.prepareTempTsConfig)({
+            baseTsconfigPath,
+            includeGlobs: ['./generated/**/*.ts'],
+            cwd: tempDir,
+        });
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(tempPath, 'utf8'));
+        node_assert_1.default.strictEqual(parsed.compilerOptions.target, 'ES2022');
+        node_assert_1.default.strictEqual(parsed.compilerOptions.module, 'commonjs');
+        node_assert_1.default.strictEqual(parsed.compilerOptions.moduleResolution, 'node');
+    });
+});

package/dist/common/utils/codegenTempDir.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Returns the absolute path to the temporary codegen directory.
+ *
+ * @param cwd - Project root (defaults to process.cwd()).
+ */
+export declare function getCodegenTempDir(cwd?: string): string;
+/**
+ * Creates the temporary codegen directory if it does not exist.
+ *
+ * @param cwd - Project root (defaults to process.cwd()).
+ * @returns Absolute path to .openapi-codegen.
+ */
+export declare function ensureCodegenTempDir(cwd?: string): Promise<string>;
+/**
+ * Recursively removes the temporary codegen directory.
+ *
+ * @param cwd - Project root (defaults to process.cwd()).
+ */
+export declare function cleanupCodegenTempDir(cwd?: string): Promise<void>;
+//# sourceMappingURL=codegenTempDir.d.ts.map

package/dist/common/utils/codegenTempDir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegenTempDir.d.ts","sourceRoot":"","sources":["../../../src/common/utils/codegenTempDir.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAErE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtF"}

package/dist/common/utils/codegenTempDir.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCodegenTempDir = getCodegenTempDir;
+exports.ensureCodegenTempDir = ensureCodegenTempDir;
+exports.cleanupCodegenTempDir = cleanupCodegenTempDir;
+const node_path_1 = __importDefault(require("node:path"));
+const fileSystemHelpers_1 = require("./fileSystemHelpers");
+/** Directory name under the project root for temporary codegen configs. */
+const TEMP_DIR_NAME = '.openapi-codegen';
+/**
+ * Returns the absolute path to the temporary codegen directory.
+ *
+ * @param cwd - Project root (defaults to process.cwd()).
+ */
+function getCodegenTempDir(cwd = process.cwd()) {
+    return node_path_1.default.join(cwd, TEMP_DIR_NAME);
+}
+/**
+ * Creates the temporary codegen directory if it does not exist.
+ *
+ * @param cwd - Project root (defaults to process.cwd()).
+ * @returns Absolute path to .openapi-codegen.
+ */
+async function ensureCodegenTempDir(cwd = process.cwd()) {
+    const dir = getCodegenTempDir(cwd);
+    await fileSystemHelpers_1.fileSystemHelpers.mkdir(dir);
+    return dir;
+}
+/**
+ * Recursively removes the temporary codegen directory.
+ *
+ * @param cwd - Project root (defaults to process.cwd()).
+ */
+async function cleanupCodegenTempDir(cwd = process.cwd()) {
+    const dir = getCodegenTempDir(cwd);
+    if (await fileSystemHelpers_1.fileSystemHelpers.exists(dir)) {
+        await fileSystemHelpers_1.fileSystemHelpers.rmdir(dir);
+    }
+}

package/dist/common/utils/convertArrayToObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convertArrayToObject.d.ts","sourceRoot":"","sources":["../../../src/common/utils/convertArrayToObject.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgHxH"}
+{"version":3,"file":"convertArrayToObject.d.ts","sourceRoot":"","sources":["../../../src/common/utils/convertArrayToObject.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAyGxH"}

package/dist/common/utils/convertArrayToObject.js

@@ -44,24 +44,19 @@ function convertArrayToObject(optionsArr) {
             return item[field];
         };
         const getRootValueOrThrow = (field) => {
-            const definedValues = optionsArr
-                .map(item => getNormalizedFieldValue(item, field))
-                .filter(value => value !== undefined);
+            const definedValues = optionsArr.map(item => getNormalizedFieldValue(item, field)).filter(value => value !== undefined);
             if (definedValues.length === 0) {
                 return undefined;
             }
             const firstValue = definedValues[0];
             const hasConflict = definedValues.some(value => value !== firstValue);
             if (hasConflict) {
-                throw new Error(`Legacy array config has conflicting "${field}" values. ` +
-                    `This option must have the same value for all array items.`);
+                throw new Error(`Legacy array config has conflicting "${field}" values. ` + `This option must have the same value for all array items.`);
             }
             return firstValue;
         };
         const getCommonOptionalRootValue = (field) => {
-            const definedValues = optionsArr
-                .map(item => item[field])
-                .filter(value => value !== undefined);
+            const definedValues = optionsArr.map(item => item[field]).filter(value => value !== undefined);
             if (definedValues.length === 0) {
                 return undefined;
             }

package/dist/common/utils/eslintFix.d.ts

@@ -1,7 +1,51 @@
+/** Single ESLint diagnostic stored in {@link EslintFixReport} (no source/output). */
+export interface EslintFixReportMessage {
+    filePath: string;
+    ruleId: string | null;
+    line: number;
+    column: number;
+    message: string;
+    severity: number;
+}
+/** Per-file lint messages in {@link EslintFixReport}. */
+export interface EslintFixReportFile {
+    filePath: string;
+    messages: EslintFixReportMessage[];
+}
+/** Aggregated batch ESLint results written to eslint-fix-report.json. */
+export interface EslintFixReport {
+    summary: {
+        totalFiles: number;
+        errorCount: number;
+        warningCount: number;
+        fixableErrorCount: number;
+        fixableWarningCount: number;
+    };
+    files: EslintFixReportFile[];
+}
+/** Options for {@link eslintFixBatch}. */
+export interface EslintFixBatchOptions {
+    /** Absolute or cwd-relative paths to generated TypeScript files. */
+    files: string[];
+    /** Narrow include globs for the temporary tsconfig (models/services output). */
+    includeGlobs: string[];
+    /** Path to the host project's base tsconfig.json. */
+    tsconfigPath: string;
+    /** Path to the host project's ESLint config. */
+    eslintConfigPath: string;
+    /** Project root (defaults to process.cwd()). */
+    cwd?: string;
+    /** Number of files per lintFiles call (default 50, or ESLINT_FIX_BATCH_SIZE env). */
+    batchSize?: number;
+}
 /**
- * Runs ESLint --fix on the given file using the user's project ESLint config.
- * Silently skips if ESLint is not installed.
- * Logs an error and re-throws if ESLint fails during the fix.
+ * Runs ESLint --fix in memory-safe batches on an explicit file list.
+ *
+ * Creates temporary configs under .openapi-codegen/, lints in chunks, applies fixes,
+ * writes eslint-fix-report.json, then removes temp files. Does not use projectService.
+ *
+ * @param options - File paths, globs, and host project config paths.
+ * @returns Lint report, or null when there are no files or ESLint is not installed.
  */
-export declare function eslintFix(filePath: string): Promise<void>;
+export declare function eslintFixBatch(options: EslintFixBatchOptions): Promise<EslintFixReport | null>;
 //# sourceMappingURL=eslintFix.d.ts.map

package/dist/common/utils/eslintFix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslintFix.d.ts","sourceRoot":"","sources":["../../../src/common/utils/eslintFix.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB/D"}
+{"version":3,"file":"eslintFix.d.ts","sourceRoot":"","sources":["../../../src/common/utils/eslintFix.ts"],"names":[],"mappings":"AAYA,qFAAqF;AACrF,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACtC;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IAClC,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAyGD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiEpG"}