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

package/dist/core/WriteClient.js

@@ -21,11 +21,14 @@ const writeClientSchemasIndex_1 = require("./utils/writeClientSchemasIndex");
 const writeClientServices_1 = require("./utils/writeClientServices");
 const writeClientServicesIndex_1 = require("./utils/writeClientServicesIndex");
 const writeClientSimpleIndex_1 = require("./utils/writeClientSimpleIndex");
+const writeFileIfChanged_1 = require("./utils/writeFileIfChanged");
 /**
  * The client which is writing all items and keep the parameters to write index file
  */
 class WriteClient {
     config = new Map();
+    expectedOutputFiles = new Set();
+    writeStats = { written: 0, unchanged: 0 };
     _logger;
     constructor(logger) {
         this._logger =
@@ -158,8 +161,8 @@ class WriteClient {
         await fileSystemHelpers_1.fileSystemHelpers.mkdir(outputPaths.outputModels);
         const shouldInlineDtoCore = modelsMode === ModelsMode_enum_1.ModelsMode.CLASSES && excludeCoreServiceFiles;
         if (shouldInlineDtoCore) {
-            await fileSystemHelpers_1.fileSystemHelpers.writeFile((0, pathHelpers_1.resolveHelper)(outputPaths.outputModels, 'BaseDto.ts'), templates.core.baseDto({}));
-            await fileSystemHelpers_1.fileSystemHelpers.writeFile((0, pathHelpers_1.resolveHelper)(outputPaths.outputModels, 'dtoUtils.ts'), templates.core.dtoUtils({}));
+            await this.writeOutputFile((0, pathHelpers_1.resolveHelper)(outputPaths.outputModels, 'BaseDto.ts'), templates.core.baseDto({}));
+            await this.writeOutputFile((0, pathHelpers_1.resolveHelper)(outputPaths.outputModels, 'dtoUtils.ts'), templates.core.dtoUtils({}));
         }
         await this.writeClientModels({
             models: client.models,
@@ -218,6 +221,24 @@ class WriteClient {
     get logger() {
         return this._logger;
     }
+    async writeOutputFile(filePath, content) {
+        this.expectedOutputFiles.add((0, pathHelpers_1.resolveHelper)(process.cwd(), filePath));
+        const result = await (0, writeFileIfChanged_1.writeFileIfChanged)(filePath, content);
+        this.writeStats[result] += 1;
+        return result;
+    }
+    registerOutputFile(filePath) {
+        this.expectedOutputFiles.add((0, pathHelpers_1.resolveHelper)(process.cwd(), filePath));
+    }
+    getExpectedOutputFiles() {
+        return this.expectedOutputFiles;
+    }
+    getExpectedOutputFilesArray() {
+        return Array.from(this.expectedOutputFiles);
+    }
+    getWriteStats() {
+        return { ...this.writeStats };
+    }
     buildSimpleClientIndexMap() {
         const result = new Map();
         for (const [key, value] of this.config.entries()) {

package/dist/core/plugins/getBuiltinPlugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getBuiltinPlugins.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/getBuiltinPlugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGjE;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,sBAAsB,EAAE,CAE5D"}
+{"version":3,"file":"getBuiltinPlugins.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/getBuiltinPlugins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,sBAAsB,EAAE,CAE5D"}

package/dist/core/plugins/loadGeneratorPlugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadGeneratorPlugins.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/loadGeneratorPlugins.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAiDjE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAcnG"}
+{"version":3,"file":"loadGeneratorPlugins.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/loadGeneratorPlugins.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAgDjE;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAcnG"}

package/dist/core/plugins/loadGeneratorPlugins.js

@@ -34,9 +34,9 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadGeneratorPlugins = loadGeneratorPlugins;
+const node_url_1 = require("node:url");
 const pathHelpers_1 = require("../../common/utils/pathHelpers");
 const getBuiltinPlugins_1 = require("./getBuiltinPlugins");
-const node_url_1 = require("node:url");
 /**
  * Type guard for runtime plugin objects.
  */

package/dist/core/types/shared/Client.model.d.ts

@@ -1,5 +1,5 @@
-import type { Model } from './Model.model';
 import type { MiracleEntry } from './Miracle.model';
+import type { Model } from './Model.model';
 import type { Service } from './Service.model';
 export interface Client {
     version: string;

package/dist/core/types/shared/Client.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Client.model.d.ts","sourceRoot":"","sources":["../../../../src/core/types/shared/Client.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"Client.model.d.ts","sourceRoot":"","sources":["../../../../src/core/types/shared/Client.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,MAAM;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B"}

package/dist/core/types/shared/Model.model.d.ts

@@ -1,5 +1,5 @@
-import type { Enum } from './Enum.model';
 import type { DiffInfo } from './DiffInfo.model';
+import type { Enum } from './Enum.model';
 import { Import } from './Import.model';
 import type { Schema } from './Schema.model';
 export interface Model extends Schema {

package/dist/core/types/shared/Model.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Model.model.d.ts","sourceRoot":"","sources":["../../../../src/core/types/shared/Model.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,KAAM,SAAQ,MAAM;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACjH,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,UAAU,EAAE,KAAK,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB"}
+{"version":3,"file":"Model.model.d.ts","sourceRoot":"","sources":["../../../../src/core/types/shared/Model.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,KAAM,SAAQ,MAAM;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACjH,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,UAAU,EAAE,KAAK,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/core/utils/GenerationCache.d.ts

@@ -0,0 +1,18 @@
+type CacheEntry = {
+    key: string;
+    fingerprint: string;
+    files: string[];
+    updatedAt: number;
+};
+export declare class GenerationCache {
+    private readonly cachePath;
+    private data;
+    constructor(cachePath: string);
+    static hash(value: string): string;
+    load(): Promise<void>;
+    get(key: string): CacheEntry | undefined;
+    set(entry: CacheEntry): void;
+    save(): Promise<void>;
+}
+export type { CacheEntry };
+//# sourceMappingURL=GenerationCache.d.ts.map

package/dist/core/utils/GenerationCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerationCache.d.ts","sourceRoot":"","sources":["../../../src/core/utils/GenerationCache.ts"],"names":[],"mappings":"AAMA,KAAK,UAAU,GAAG;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AASF,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,IAAI,CAA8D;gBAE9D,SAAS,EAAE,MAAM;IAI7B,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIxC,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/core/utils/GenerationCache.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerationCache = void 0;
+const crypto_1 = require("crypto");
+const path_1 = require("path");
+const fileSystemHelpers_1 = require("../../common/utils/fileSystemHelpers");
+const pathHelpers_1 = require("../../common/utils/pathHelpers");
+const CURRENT_CACHE_VERSION = 1;
+class GenerationCache {
+    cachePath;
+    data = { version: CURRENT_CACHE_VERSION, entries: {} };
+    constructor(cachePath) {
+        this.cachePath = (0, pathHelpers_1.resolveHelper)(process.cwd(), cachePath);
+    }
+    static hash(value) {
+        return (0, crypto_1.createHash)('sha256').update(value).digest('hex');
+    }
+    async load() {
+        const exists = await fileSystemHelpers_1.fileSystemHelpers.exists(this.cachePath);
+        if (!exists) {
+            return;
+        }
+        const raw = await fileSystemHelpers_1.fileSystemHelpers.readFile(this.cachePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || parsed.version !== CURRENT_CACHE_VERSION || !parsed.entries) {
+            return;
+        }
+        this.data = parsed;
+    }
+    get(key) {
+        return this.data.entries[key];
+    }
+    set(entry) {
+        this.data.entries[entry.key] = entry;
+    }
+    async save() {
+        await fileSystemHelpers_1.fileSystemHelpers.mkdir((0, path_1.dirname)(this.cachePath));
+        await fileSystemHelpers_1.fileSystemHelpers.writeFile(this.cachePath, JSON.stringify(this.data, null, 2));
+    }
+}
+exports.GenerationCache = GenerationCache;

package/dist/core/utils/__tests__/GenerationCache.test.d.ts

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

package/dist/core/utils/__tests__/GenerationCache.test.d.ts.map

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

package/dist/core/utils/__tests__/GenerationCache.test.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+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 GenerationCache_1 = require("../GenerationCache");
+(0, node_test_1.describe)('@unit: GenerationCache', () => {
+    (0, node_test_1.test)('saves and loads entries', async () => {
+        const tmpDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'openapi-codegen-cache-'));
+        try {
+            const reportPath = node_path_1.default.join(tmpDir, 'report.json');
+            const cacheA = new GenerationCache_1.GenerationCache(reportPath);
+            await cacheA.load();
+            cacheA.set({
+                key: 'k1',
+                fingerprint: 'f1',
+                files: ['/tmp/a.ts'],
+                updatedAt: Date.now(),
+            });
+            await cacheA.save();
+            const cacheB = new GenerationCache_1.GenerationCache(reportPath);
+            await cacheB.load();
+            const entry = cacheB.get('k1');
+            strict_1.default.ok(entry);
+            strict_1.default.equal(entry?.fingerprint, 'f1');
+            strict_1.default.deepEqual(entry?.files, ['/tmp/a.ts']);
+        }
+        finally {
+            node_fs_1.default.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+});

package/dist/core/utils/__tests__/loadDiffReport.test.d.ts

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

package/dist/core/utils/__tests__/loadDiffReport.test.d.ts.map

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

package/dist/core/utils/__tests__/loadDiffReport.test.js

@@ -0,0 +1,97 @@
+"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_path_1 = __importDefault(require("node:path"));
+const node_test_1 = require("node:test");
+const Enums_1 = require("../../../common/Enums");
+const Logger_1 = require("../../../common/Logger");
+const loadDiffReport_1 = require("../loadDiffReport");
+const createTempDir = (t, prefix) => {
+    const root = node_path_1.default.join(__dirname, 'generated');
+    node_fs_1.default.mkdirSync(root, { recursive: true });
+    const tempDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(root, prefix));
+    t.after(() => {
+        node_fs_1.default.rmSync(tempDir, { recursive: true, force: true });
+    });
+    return tempDir;
+};
+const createLogger = () => new Logger_1.Logger({
+    instanceId: 'load-diff-report-test',
+    level: Enums_1.ELogLevel.ERROR,
+    logOutput: Enums_1.ELogOutput.CONSOLE,
+    disableColors: true,
+});
+(0, node_test_1.describe)('@unit: loadDiffReport', () => {
+    (0, node_test_1.test)('returns null when history and diffReport path are disabled', () => {
+        const result = (0, loadDiffReport_1.loadDiffReport)({
+            useHistory: false,
+            logger: createLogger(),
+        });
+        node_assert_1.default.strictEqual(result, null);
+    });
+    (0, node_test_1.test)('returns null when report file is missing', () => {
+        const result = (0, loadDiffReport_1.loadDiffReport)({
+            useHistory: true,
+            diffReport: node_path_1.default.join(__dirname, 'missing-report.json'),
+            logger: createLogger(),
+        });
+        node_assert_1.default.strictEqual(result, null);
+    });
+    (0, node_test_1.test)('loads report with diff entries', async (t) => {
+        const dir = createTempDir(t, 'diff-report-');
+        const reportPath = node_path_1.default.join(dir, 'report.json');
+        const report = {
+            diff: {
+                all: [{ action: 'changed', path: '$.info.version', severity: 'info', from: '1', to: '2' }],
+            },
+        };
+        node_fs_1.default.writeFileSync(reportPath, JSON.stringify(report), 'utf-8');
+        const loaded = (0, loadDiffReport_1.loadDiffReport)({
+            diffReport: reportPath,
+            logger: createLogger(),
+        });
+        node_assert_1.default.ok(loaded);
+        node_assert_1.default.strictEqual(loaded?.diff?.all?.length, 1);
+    });
+    (0, node_test_1.test)('returns null for empty report without diff or miracles', async (t) => {
+        const dir = createTempDir(t, 'diff-report-empty-');
+        const reportPath = node_path_1.default.join(dir, 'empty.json');
+        node_fs_1.default.writeFileSync(reportPath, JSON.stringify({ diff: { all: [] }, miracles: [] }), 'utf-8');
+        const loaded = (0, loadDiffReport_1.loadDiffReport)({
+            diffReport: reportPath,
+            logger: createLogger(),
+        });
+        node_assert_1.default.strictEqual(loaded, null);
+    });
+    (0, node_test_1.test)('returns null when report is older than input spec', async (t) => {
+        const dir = createTempDir(t, 'diff-report-stale-');
+        const reportPath = node_path_1.default.join(dir, 'report.json');
+        const inputPath = node_path_1.default.join(dir, 'spec.json');
+        node_fs_1.default.writeFileSync(reportPath, JSON.stringify({
+            diff: { all: [{ action: 'changed', path: '$.info.version', severity: 'info' }] },
+        }), 'utf-8');
+        const past = Date.now() - 60_000;
+        node_fs_1.default.utimesSync(reportPath, past / 1000, past / 1000);
+        node_fs_1.default.writeFileSync(inputPath, '{"openapi":"3.0.0"}', 'utf-8');
+        const loaded = (0, loadDiffReport_1.loadDiffReport)({
+            diffReport: reportPath,
+            inputPath,
+            logger: createLogger(),
+        });
+        node_assert_1.default.strictEqual(loaded, null);
+    });
+    (0, node_test_1.test)('returns null when report JSON is invalid', async (t) => {
+        const dir = createTempDir(t, 'diff-report-broken-');
+        const reportPath = node_path_1.default.join(dir, 'broken.json');
+        node_fs_1.default.writeFileSync(reportPath, '{ not-json', 'utf-8');
+        const loaded = (0, loadDiffReport_1.loadDiffReport)({
+            diffReport: reportPath,
+            logger: createLogger(),
+        });
+        node_assert_1.default.strictEqual(loaded, null);
+    });
+});

package/dist/core/utils/__tests__/prepareDtoModels.test.js

@@ -113,4 +113,99 @@ const createInterfaceModel = (name, properties) => ({
         node_assert_1.default.strictEqual(preparedUser?.dtoGetters?.[0].oldName, 'oldName');
         node_assert_1.default.strictEqual(preparedUser?.dtoGetters?.[0].newName, 'fullName');
     });
+    (0, node_test_1.test)('resolves one-of and dictionary property types', () => {
+        const tag = createPrimitiveModel('tag', 'string');
+        const tagRef = {
+            ...createPrimitiveModel('value', 'string'),
+            export: 'reference',
+            type: 'string',
+            isRequired: true,
+        };
+        const oneOfProp = {
+            ...createPrimitiveModel('payload', 'string | number'),
+            export: 'one-of',
+            properties: [createPrimitiveModel('a', 'string'), createPrimitiveModel('b', 'number')],
+            isRequired: true,
+        };
+        const dictProp = {
+            ...createPrimitiveModel('tags', 'Record<string, string>'),
+            export: 'dictionary',
+            link: tagRef,
+            isRequired: false,
+        };
+        const container = createInterfaceModel('IContainer', [oneOfProp, dictProp]);
+        const client = {
+            version: '1.0.0',
+            server: 'http://localhost',
+            models: [container, tag],
+            services: [],
+        };
+        const prepared = (0, prepareDtoModels_1.prepareDtoModels)(client);
+        const preparedContainer = prepared.models.find(model => model.name === 'IContainer');
+        const preparedOneOf = preparedContainer?.properties.find(prop => prop.name === 'payload');
+        const preparedDict = preparedContainer?.properties.find(prop => prop.name === 'tags');
+        node_assert_1.default.ok(preparedOneOf?.dtoType?.includes('|'));
+        node_assert_1.default.match(preparedDict?.dtoType ?? '', /Record<string, string>/);
+    });
+    (0, node_test_1.test)('resolves enum property types in dtoType', () => {
+        const statusEnum = {
+            ...createPrimitiveModel('Status', 'string'),
+            export: 'enum',
+            enum: [
+                { name: 'Active', value: "'active'", type: 'string', description: null },
+                { name: 'Inactive', value: "'inactive'", type: 'string', description: null },
+            ],
+        };
+        const statusProp = {
+            ...createPrimitiveModel('status', 'string'),
+            export: 'enum',
+            enum: statusEnum.enum,
+            isRequired: true,
+        };
+        const model = createInterfaceModel('IUser', [statusProp]);
+        const client = {
+            version: '1.0.0',
+            server: 'http://localhost',
+            models: [model, statusEnum],
+            services: [],
+        };
+        const prepared = (0, prepareDtoModels_1.prepareDtoModels)(client);
+        const property = prepared.models[0]?.properties[0];
+        node_assert_1.default.match(property?.dtoType ?? '', /active/);
+        node_assert_1.default.match(property?.dtoType ?? '', /inactive/);
+    });
+    (0, node_test_1.test)('uses optional toJSON for non-required reference properties', () => {
+        const profile = createInterfaceModel('IProfile', [createPrimitiveModel('bio', 'string')]);
+        const profileRef = {
+            ...createPrimitiveModel('profile', 'IProfile'),
+            export: 'reference',
+            type: 'IProfile',
+            isRequired: false,
+        };
+        const user = createInterfaceModel('IUser', [profileRef]);
+        const client = {
+            version: '1.0.0',
+            server: 'http://localhost',
+            models: [user, profile],
+            services: [],
+        };
+        const prepared = (0, prepareDtoModels_1.prepareDtoModels)(client);
+        const property = prepared.models.find(m => m.name === 'IUser')?.properties[0];
+        node_assert_1.default.match(property?.dtoInit ?? '', /\? new IProfileDto/);
+        node_assert_1.default.match(property?.dtoToJSON ?? '', /\? this.profile.toJSON/);
+    });
+    (0, node_test_1.test)('uses bracket accessor for quoted property names', () => {
+        const quotedProp = createPrimitiveModel("'weird-name'", 'string');
+        const model = createInterfaceModel('IQuoted', [quotedProp]);
+        const client = {
+            version: '1.0.0',
+            server: 'http://localhost',
+            models: [model],
+            services: [],
+        };
+        const prepared = (0, prepareDtoModels_1.prepareDtoModels)(client);
+        const property = prepared.models[0]?.properties[0];
+        node_assert_1.default.strictEqual(property?.dtoInit, "data['weird-name']");
+        node_assert_1.default.strictEqual(property?.dtoTarget, "['weird-name']");
+    });
 });

package/dist/core/utils/__tests__/templateRendering.test.d.ts

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

package/dist/core/utils/__tests__/templateRendering.test.d.ts.map

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

package/dist/core/utils/__tests__/templateRendering.test.js

@@ -0,0 +1,119 @@
+"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 HttpClient_enum_1 = require("../../types/enums/HttpClient.enum");
+const ModelsMode_enum_1 = require("../../types/enums/ModelsMode.enum");
+const ValidationLibrary_enum_1 = require("../../types/enums/ValidationLibrary.enum");
+const registerHandlebarTemplates_1 = require("../registerHandlebarTemplates");
+const requestContext = {
+    httpClient: HttpClient_enum_1.HttpClient.FETCH,
+    server: 'https://api.example.com',
+    version: '1.0.0',
+    useCancelableRequest: false,
+    useSeparatedIndexes: false,
+};
+const schemaModel = {
+    name: 'UserSchema',
+    alias: '',
+    path: 'schemas',
+    export: 'interface',
+    type: 'UserSchema',
+    base: 'UserSchema',
+    template: null,
+    link: null,
+    description: null,
+    isDefinition: true,
+    isReadOnly: false,
+    isRequired: false,
+    isNullable: false,
+    imports: [],
+    enum: [],
+    enums: [],
+    properties: [
+        {
+            name: 'id',
+            alias: '',
+            path: 'schemas',
+            export: 'generic',
+            type: 'string',
+            base: 'string',
+            template: null,
+            link: null,
+            description: null,
+            isDefinition: false,
+            isReadOnly: false,
+            isRequired: true,
+            isNullable: false,
+            imports: [],
+            enum: [],
+            enums: [],
+            properties: [],
+        },
+    ],
+};
+const exportClientContext = {
+    outputCore: './generated/core',
+    useCustomRequest: false,
+    services: [],
+};
+const exportModelsContext = {
+    models: [schemaModel],
+    httpClient: HttpClient_enum_1.HttpClient.FETCH,
+    useUnionTypes: false,
+    useOptions: false,
+    outputCore: '../core',
+    modelsMode: ModelsMode_enum_1.ModelsMode.CLASSES,
+};
+(0, node_test_1.describe)('@unit: templateRendering', () => {
+    for (const httpClient of Object.values(HttpClient_enum_1.HttpClient)) {
+        for (const useCancelableRequest of [false, true]) {
+            (0, node_test_1.test)(`renders request template for ${httpClient} (cancelable=${useCancelableRequest})`, () => {
+                const templates = (0, registerHandlebarTemplates_1.registerHandlebarTemplates)({
+                    httpClient,
+                    useOptions: false,
+                    useUnionTypes: false,
+                    validationLibrary: ValidationLibrary_enum_1.ValidationLibrary.NONE,
+                });
+                const output = templates.core.request({
+                    ...requestContext,
+                    httpClient,
+                    useCancelableRequest,
+                });
+                node_assert_1.default.ok(output.length > 100);
+                node_assert_1.default.match(output, /function request/i);
+            });
+        }
+    }
+    (0, node_test_1.test)('renders exportClient and exportModels templates', () => {
+        const templates = (0, registerHandlebarTemplates_1.registerHandlebarTemplates)({
+            httpClient: HttpClient_enum_1.HttpClient.FETCH,
+            useOptions: false,
+            useUnionTypes: false,
+            validationLibrary: ValidationLibrary_enum_1.ValidationLibrary.NONE,
+        });
+        const clientOutput = templates.exports.client(exportClientContext);
+        const modelsOutput = templates.exports.models(exportModelsContext);
+        node_assert_1.default.match(clientOutput, /createClient|RequestExecutor/i);
+        node_assert_1.default.match(modelsOutput, /BaseDto|fromArray/);
+    });
+    (0, node_test_1.test)('renders schema export with validation library context', () => {
+        const templates = (0, registerHandlebarTemplates_1.registerHandlebarTemplates)({
+            httpClient: HttpClient_enum_1.HttpClient.FETCH,
+            useOptions: false,
+            useUnionTypes: false,
+            validationLibrary: ValidationLibrary_enum_1.ValidationLibrary.ZOD,
+        });
+        const output = templates.exports.schema({
+            ...schemaModel,
+            httpClient: HttpClient_enum_1.HttpClient.FETCH,
+            useUnionTypes: false,
+            validationLibrary: ValidationLibrary_enum_1.ValidationLibrary.ZOD,
+        });
+        node_assert_1.default.ok(output.length > 20);
+        node_assert_1.default.match(output, /UserSchema/i);
+    });
+});

package/dist/core/utils/__tests__/writeFileIfChanged.test.d.ts

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

package/dist/core/utils/__tests__/writeFileIfChanged.test.d.ts.map

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

package/dist/core/utils/__tests__/writeFileIfChanged.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 strict_1 = __importDefault(require("node:assert/strict"));
+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 writeFileIfChanged_1 = require("../writeFileIfChanged");
+(0, node_test_1.describe)('@unit: writeFileIfChanged', () => {
+    (0, node_test_1.test)('writes new file and skips unchanged content', async () => {
+        const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'openapi-codegen-'));
+        const file = (0, node_path_1.join)(dir, 'index.ts');
+        try {
+            const firstResult = await (0, writeFileIfChanged_1.writeFileIfChanged)(file, 'export const a = 1;\n');
+            const secondResult = await (0, writeFileIfChanged_1.writeFileIfChanged)(file, 'export const a = 1;\n');
+            const thirdResult = await (0, writeFileIfChanged_1.writeFileIfChanged)(file, 'export const a = 2;\n');
+            const content = await (0, promises_1.readFile)(file, 'utf8');
+            strict_1.default.equal(firstResult, 'written');
+            strict_1.default.equal(secondResult, 'unchanged');
+            strict_1.default.equal(thirdResult, 'written');
+            strict_1.default.equal(content, 'export const a = 2;\n');
+        }
+        finally {
+            await (0, promises_1.rm)(dir, { recursive: true, force: true });
+        }
+    });
+});

package/dist/core/utils/loadDiffReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadDiffReport.d.ts","sourceRoot":"","sources":["../../../src/core/utils/loadDiffReport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC7C,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;QACzB,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,KAAK,oBAAoB,GAAG;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF,eAAO,MAAM,cAAc,GAAI,+CAA+C,oBAAoB,KAAG,UAAU,GAAG,IA8BjH,CAAC"}
+{"version":3,"file":"loadDiffReport.d.ts","sourceRoot":"","sources":["../../../src/core/utils/loadDiffReport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,WAAW,eAAgB,SAAQ,QAAQ;IAC7C,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,KAAK,CAAC,EAAE;QACJ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE;QACH,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7B,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;QACzB,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,KAAK,oBAAoB,GAAG;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAaF,eAAO,MAAM,cAAc,GAAI,+CAA+C,oBAAoB,KAAG,UAAU,GAAG,IA8BjH,CAAC"}

package/dist/core/utils/loadDiffReport.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadDiffReport = void 0;
 const fs_1 = __importDefault(require("fs"));
 const Consts_1 = require("../../common/Consts");
+const LoggerMessages_1 = require("../../common/LoggerMessages");
 const isFreshEnough = (reportPath, inputPath) => {
     if (!inputPath)
         return true;
@@ -24,11 +25,11 @@ const loadDiffReport = ({ useHistory, diffReport, inputPath, logger }) => {
         return null;
     const reportPath = diffReport || Consts_1.DEFAULT_ANALYZE_DIFF_REPORT_PATH;
     if (!fs_1.default.existsSync(reportPath)) {
-        logger.info(`[openapi-codegen] Diff report not found at "${reportPath}". Skipping history annotations.`);
+        logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.NOT_FOUND(reportPath));
         return null;
     }
     if (!isFreshEnough(reportPath, inputPath)) {
-        logger.warn(`[openapi-codegen] Diff report "${reportPath}" is older than the input spec. Skipping history annotations.`);
+        logger.warn(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.STALE(reportPath));
         return null;
     }
     try {
@@ -37,14 +38,14 @@ const loadDiffReport = ({ useHistory, diffReport, inputPath, logger }) => {
         const hasDiffEntries = !!parsed?.diff?.all?.length;
         const hasMiracles = !!parsed?.miracles?.length;
         if (!hasDiffEntries && !hasMiracles) {
-            logger.info(`[openapi-codegen] Diff report "${reportPath}" has no entries. Skipping history annotations.`);
+            logger.info(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.EMPTY(reportPath));
             return null;
         }
         return parsed;
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        logger.warn(`[openapi-codegen] Failed to read diff report "${reportPath}": ${message}`);
+        logger.warn(LoggerMessages_1.LOGGER_MESSAGES.DIFF_REPORT.READ_FAILED(reportPath, message));
         return null;
     }
 };