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

package/dist/common/LoggerMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoggerMessages.d.ts","sourceRoot":"","sources":["../../src/common/LoggerMessages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAWrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAqBzE,CAAC;AAEF,eAAO,MAAM,eAAe;;kCAGH,MAAM;;oDAEY,MAAM;2CACf,MAAM,YAAY,MAAM;;;;;;;;;;;wCAe3B,MAAM;2CACH,MAAM;;;;sCAIX,MAAM;2CACD,MAAM;4CACL,MAAM;;0CAER,MAAM;;4DAEY,MAAM;;wCAE1B,MAAM;gDACE,MAAM;;gDAIN,MAAM;kDACJ,MAAM;;;;;yCAKf,MAAM;;;;oCAMX,MAAM;yCACD,MAAM,WAAW,MAAM;;;;;;;;;0DAeN,MAAM;;sCAE1B,MAAM;;;+CAKG,MAAM;;;4CAKT,MAAM;2CACP,MAAM;;yCAER,MAAM;wCACP,MAAM;wCACN,MAAM;4CACF,MAAM;;4CAEN,MAAM;iDACD,MAAM;;;;;;8DAUO,MAAM;;gDAEpB,MAAM,SAAS,MAAM;;2CAE1B,MAAM,SAAS,MAAM;4CACpB,MAAM;;;oCAKd,MAAM,cAAc,MAAM;;6CAEjB,MAAM;sDACG,MAAM;iDAEX;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;8CAI7F,MAAM;mCAEvB;YACJ,OAAO,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAC;gBAAC,aAAa,EAAE,MAAM,CAAA;aAAE,CAAC;YAC1E,UAAU,EAAE;gBAAE,OAAO,EAAE;oBAAE,MAAM,EAAE,MAAM,CAAC;oBAAC,QAAQ,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAC;SAC/E,cACW,MAAM;0CAGG;YAAE,cAAc,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,EAAE,CAAA;aAAE,CAAA;SAAE;sCAEjG;YAAE,UAAU,EAAE;gBAAE,OAAO,EAAE;oBAAE,MAAM,EAAE,MAAM,CAAC;oBAAC,QAAQ,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE;iDAEpE,MAAM;;0CAEb,MAAM;4CACJ,MAAM;mDACC,MAAM,SAAS,MAAM;qCACnC,MAAM;yCACF,MAAM;iDACE,MAAM;yCACd;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE;0CAExE,MAAM;0CACN,MAAM;yCACP,MAAM;;CAE5B,CAAC"}
+{"version":3,"file":"LoggerMessages.d.ts","sourceRoot":"","sources":["../../src/common/LoggerMessages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAWrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAqBzE,CAAC;AAEF,eAAO,MAAM,eAAe;;kCAGH,MAAM;;oDAEY,MAAM;2CACf,MAAM,YAAY,MAAM;;wCAE3B,MAAM,aAAa,MAAM;wDACT,MAAM;oCAG1B,MAAM;qCACL,MAAM;qDACU,MAAM;;;;;;;;;;wCAcnB,MAAM;2CACH,MAAM;;;;sCAIX,MAAM;2CACD,MAAM;4CACL,MAAM;;0CAER,MAAM;;4DAEY,MAAM;;wCAE1B,MAAM;gDACE,MAAM;;gDAIN,MAAM;kDACJ,MAAM;;;;;yCAKf,MAAM;;;;oCAMX,MAAM;yCACD,MAAM,WAAW,MAAM;4CACpB,MAAM;;;;;;;;;0DAeQ,MAAM;;sCAE1B,MAAM;;;+CAKG,MAAM;;;4CAKT,MAAM;2CACP,MAAM;;yCAER,MAAM;wCACP,MAAM;wCACN,MAAM;4CACF,MAAM;;4CAEN,MAAM;iDACD,MAAM;;;;;;;8BAQzB,MAAM;kCACF,MAAM;0CACE,MAAM;kCACd,MAAM,SAAS,MAAM,WAAW,MAAM,WAAW,MAAM;yCAEhD,MAAM;wCACP,MAAM;wCACN,MAAM;8CACA,MAAM;mDACD,MAAM,SAAS,MAAM;oCACpC,MAAM,cAAc,MAAM;;6CAEjB,MAAM;sDACG,MAAM;iDAEX;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;8CAI7F,MAAM;mCAEvB;YACJ,OAAO,EAAE;gBAAE,QAAQ,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAC;gBAAC,aAAa,EAAE,MAAM,CAAA;aAAE,CAAC;YAC1E,UAAU,EAAE;gBAAE,OAAO,EAAE;oBAAE,MAAM,EAAE,MAAM,CAAC;oBAAC,QAAQ,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAC;SAC/E,cACW,MAAM;0CAGG;YAAE,cAAc,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,EAAE,CAAA;aAAE,CAAA;SAAE;sCAEjG;YAAE,UAAU,EAAE;gBAAE,OAAO,EAAE;oBAAE,MAAM,EAAE,MAAM,CAAC;oBAAC,QAAQ,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE;iDAEpE,MAAM;;0CAEb,MAAM;4CACJ,MAAM;qCACb,MAAM;yCACF,MAAM;iDACE,MAAM;yCACd;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE;0CAExE,MAAM;0CACN,MAAM;yCACP,MAAM;;;yCAIN,MAAM;qCACV,MAAM;qCACN,MAAM;2CACA,MAAM,WAAW,MAAM;;;;6CAKrB,MAAM;;;8CAIL,MAAM;2CACT,MAAM;gDACD,MAAM;mDACH,MAAM;;;;;;;;;iDASR,MAAM;4CACX,MAAM;;;8CAIJ,MAAM;;;;;;8DAUU,MAAM;;gDAEpB,MAAM,SAAS,MAAM;;2CAE1B,MAAM,SAAS,MAAM;4CACpB,MAAM;;CAE/B,CAAC"}

package/dist/common/LoggerMessages.js

@@ -40,6 +40,12 @@ exports.LOGGER_MESSAGES = {
         FINISHED_WITH_DURATION: (duration) => `Generation completed in ${duration} sec`,
         DURATION_FOR_FILE: (file, duration) => `Duration for "${file}": ${duration} sec`,
         NO_OPTIONS: 'No options provided for generation',
+        WRITE_STATS: (written, unchanged) => `[openapi-codegen] Write stats: written=${written}, unchanged=${unchanged}`,
+        CACHE_SHARED_OUTPUT_WARNING: (outputs) => `[openapi-codegen] Cache is disabled and multiple items write to the same output directories:\n${outputs}\n` +
+            'This can overwrite previously generated files in the final output. Consider enabling cache via "cache: true" or "--cache".',
+        CACHE_HIT: (input) => `[openapi-codegen] Cache hit: ${input}`,
+        CACHE_MISS: (input) => `[openapi-codegen] Cache miss: ${input}`,
+        STRICT_REPORT_CREATED: (reportPath) => `Strict OpenAPI report created: ${reportPath}`,
     },
     // ========== OpenAPI Specification Messages ==========
     OPENAPI: {
@@ -81,6 +87,7 @@ exports.LOGGER_MESSAGES = {
         PREFIX: 'Error:',
         GENERIC: (message) => message,
         WITH_DETAILS: (message, details) => `${message}: ${details}`,
+        TECHNICAL_DETAILS: (error) => `Technical details: ${error}`,
     },
     // ========== Separator ==========
     SEPARATOR: '==========================================',
@@ -113,21 +120,20 @@ exports.LOGGER_MESSAGES = {
         CLEANUP_PREVIEW_DIR: (dir) => `Cleaning up preview directory: ${dir}`,
         CLEANUP_PREVIEW_FAILED: (error) => `Failed to cleanup preview directory: ${error}`,
     },
-    // ========== Migration Messages ==========
-    MIGRATION: {
-        OPENAPI_SCHEMA_MIGRATED: 'To perform OpenAPI generation, it was necessary to migrate the schema of your data to the current one. To update the configuration in the file, use the command `npm openapi-codegen-cli update-config`',
-    },
-    // ========== Formatting Messages ==========
-    FORMATTING: {
-        PRETTIER_PROJECT_CONFIG_RESOLVED: (filePath) => `Prettier config resolved from: ${filePath}`,
-        PRETTIER_PROJECT_CONFIG_NOT_FOUND: 'No project Prettier config found, falling back to built-in options',
-        PRETTIER_FORMAT_FAILED: (file, error) => `Prettier formatting failed for "${file}": ${error}`,
-        ESLINT_NOT_INSTALLED: 'ESLint is not installed in this project. Skipping --useEslintFix.',
-        ESLINT_FIX_FAILED: (file, error) => `ESLint fix failed for "${file}": ${error}`,
-        ESLINT_FIX_APPLIED: (file) => `ESLint fix applied: ${file}`,
-    },
-    // ========== Analyze Diff Messages ==========
     ANALYZE_DIFF: {
+        INPUT_REQUIRED: '"--input" option is required for analyze-diff command',
+        HISTORY_SKIPPED: 'History analysis skipped: no base spec provided (use --compare-with or --git)',
+        ANALYZING: '\n[openapi-codegen] Analyzing OpenAPI changes...',
+        SUMMARY_TITLE: '[openapi-codegen] Analyze-diff summary',
+        BASE: (base) => `Base: ${base}`,
+        TARGET: (target) => `Target: ${target}`,
+        STABILITY_SCORE: (score) => `Stability score: ${score}%`,
+        CHANGES: (total, added, removed, changed) => `Changes: total=${total}, added=${added}, removed=${removed}, changed=${changed}`,
+        BREAKING_COUNT: (count) => `[openapi-codegen] BREAKING: ${count} item(s)`,
+        WARNING_COUNT: (count) => `[openapi-codegen] WARNINGS: ${count} item(s)`,
+        IGNORED_COUNT: (count) => `[openapi-codegen] IGNORED: ${count} item(s) by config rules`,
+        REPORT_WRITTEN: (reportPath) => `[openapi-codegen] Report written to: ${reportPath}`,
+        INVALID_IGNORE_PATTERN: (pattern, error) => `[openapi-codegen] Invalid ignore pattern: ${pattern} — ${error}`,
         STARTED: (newSpec, baseSource) => `Starting analyze-diff: input=${newSpec}, base=${baseSource}`,
         SKIPPED_NO_BASE: 'History analysis skipped: no base spec provided (use --compare-with or --git).',
         VALIDATION_ERROR: (message) => `Analyze-diff options validation failed: ${message}`,
@@ -144,7 +150,6 @@ exports.LOGGER_MESSAGES = {
         CI_FAILURE: 'CI mode failed because governance errors were found.',
         IGNORED_CHANGES: (count) => `[openapi-codegen] IGNORED: ${count} semantic change(s) filtered by analyze.ignore`,
         EXECUTION_ERROR: (message) => `Analyze-diff execution failed: ${message}`,
-        INVALID_IGNORE_PATTERN: (pattern, error) => `[openapi-codegen] Invalid ignore pattern: ${pattern} — ${error}`,
         LEGACY_BASE: (base) => `Base: ${base}`,
         LEGACY_TARGET: (target) => `Target: ${target}`,
         LEGACY_STABILITY_SCORE: (score) => `Stability score: ${score}%`,
@@ -153,4 +158,46 @@ exports.LOGGER_MESSAGES = {
         LEGACY_WARNINGS: (count) => `[openapi-codegen] WARNINGS: ${count} item(s)`,
         LEGACY_IGNORED: (count) => `[openapi-codegen] IGNORED: ${count} item(s) by config rules`,
     },
+    DIFF_REPORT: {
+        NOT_FOUND: (reportPath) => `[openapi-codegen] Diff report not found at "${reportPath}". Skipping history annotations.`,
+        STALE: (reportPath) => `[openapi-codegen] Diff report "${reportPath}" is older than the input spec. Skipping history annotations.`,
+        EMPTY: (reportPath) => `[openapi-codegen] Diff report "${reportPath}" has no entries. Skipping history annotations.`,
+        READ_FAILED: (reportPath, message) => `[openapi-codegen] Failed to read diff report "${reportPath}": ${message}`,
+    },
+    TEMPLATES: {
+        PRECOMPILE_SUCCESS: 'The templates have been successfully precompiled and saved!',
+        PRECOMPILE_ERROR: (message) => `Error during pre-compilation of templates: ${message}`,
+    },
+    WRITE_CLIENT: {
+        DATA_WRITE_START: (filePath) => `The recording of the file data begins: ${filePath}`,
+        FILE_RECORDED: (filePath) => `File recording completed: ${filePath}`,
+        INDEX_DATA_WRITTEN: (filePath) => `Data has been written to a file: ${filePath}`,
+        INDEX_WRITE_COMPLETED: (filePath) => `Writing to the file is completed: ${filePath}`,
+        CORE_START: 'The recording of the kernel files begins',
+        CORE_FINISH: 'The writing of the kernel files has been completed successfully',
+        MODELS_START: 'Recording of model files begins',
+        MODELS_FINISH: 'Model file recording completed successfully',
+        SERVICES_START: 'Recording of service files begins',
+        SERVICES_FINISH: 'Service file recording completed successfully',
+        SCHEMAS_START: 'The recording of model validation schema files begins.',
+        SCHEMAS_FINISH: 'The recording of model validation schema files has been completed successfully',
+        DIRECTORY_CREATING: (directory) => `A directory is being created: ${directory}`,
+        EXECUTOR_START: (filePath) => `The recording of the file data begins: ${filePath}`,
+    },
+    LOGGER: {
+        NEXT_STEPS: (recommendation) => `What you can do next: ${recommendation}`,
+    },
+    // ========== Migration Messages ==========
+    MIGRATION: {
+        OPENAPI_SCHEMA_MIGRATED: 'To perform OpenAPI generation, it was necessary to migrate the schema of your data to the current one. To update the configuration in the file, use the command `npm openapi-codegen-cli update-config`',
+    },
+    // ========== Formatting Messages ==========
+    FORMATTING: {
+        PRETTIER_PROJECT_CONFIG_RESOLVED: (filePath) => `Prettier config resolved from: ${filePath}`,
+        PRETTIER_PROJECT_CONFIG_NOT_FOUND: 'No project Prettier config found, falling back to built-in options',
+        PRETTIER_FORMAT_FAILED: (file, error) => `Prettier formatting failed for "${file}": ${error}`,
+        ESLINT_NOT_INSTALLED: 'ESLint is not installed in this project. Skipping --useEslintFix.',
+        ESLINT_FIX_FAILED: (file, error) => `ESLint fix failed for "${file}": ${error}`,
+        ESLINT_FIX_APPLIED: (file) => `ESLint fix applied: ${file}`,
+    },
 };

package/dist/common/VersionedSchema/AllVersionedSchemas/UnifiedOptionsSchemaV5.d.ts

@@ -73,6 +73,13 @@ export declare const unifiedOptionsSchemaV5: z.ZodObject<{
     useUnionTypes: z.ZodOptional<z.ZodBoolean>;
     useProjectPrettier: z.ZodOptional<z.ZodBoolean>;
     useEslintFix: z.ZodOptional<z.ZodBoolean>;
+    cache: z.ZodOptional<z.ZodBoolean>;
+    cachePath: z.ZodOptional<z.ZodString>;
+    cacheStrategy: z.ZodOptional<z.ZodEnum<{
+        content: "content";
+        entity: "entity";
+    }>>;
+    cacheDebug: z.ZodOptional<z.ZodBoolean>;
     strictOpenapi: z.ZodOptional<z.ZodBoolean>;
     reportFile: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/common/VersionedSchema/AllVersionedSchemas/UnifiedOptionsSchemaV5.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnifiedOptionsSchemaV5.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/AllVersionedSchemas/UnifiedOptionsSchemaV5.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIjC,CAAC"}
+{"version":3,"file":"UnifiedOptionsSchemaV5.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/AllVersionedSchemas/UnifiedOptionsSchemaV5.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQjC,CAAC"}

package/dist/common/VersionedSchema/AllVersionedSchemas/UnifiedOptionsSchemaV5.js

@@ -8,6 +8,10 @@ exports.unifiedOptionsSchemaV5 = UnifiedOptionsSchemaV4_1.unifiedOptionsSchemaV4
     ...CommonSchemas_1.strictModeParametersSchema.shape,
     useProjectPrettier: zod_1.z.boolean().optional(),
     useEslintFix: zod_1.z.boolean().optional(),
+    cache: zod_1.z.boolean().optional(),
+    cachePath: zod_1.z.string().optional(),
+    cacheStrategy: zod_1.z.enum(['content', 'entity']).optional(),
+    cacheDebug: zod_1.z.boolean().optional(),
 });
 /*
 type TUnifiedV5 = TUnifiedV4 & {
@@ -16,4 +20,4 @@ type TUnifiedV5 = TUnifiedV4 & {
     useProjectPrettier: boolean | undefined;
     useEslintFix: boolean | undefined;
 }
-*/ 
+*/

package/dist/common/VersionedSchema/AllVersionedSchemas/UnifiedVersionedSchemas.d.ts

@@ -293,6 +293,13 @@ declare const unifiedSchemaDefinitions: readonly [{
         useUnionTypes: z.ZodOptional<z.ZodBoolean>;
         useProjectPrettier: z.ZodOptional<z.ZodBoolean>;
         useEslintFix: z.ZodOptional<z.ZodBoolean>;
+        cache: z.ZodOptional<z.ZodBoolean>;
+        cachePath: z.ZodOptional<z.ZodString>;
+        cacheStrategy: z.ZodOptional<z.ZodEnum<{
+            content: "content";
+            entity: "entity";
+        }>>;
+        cacheDebug: z.ZodOptional<z.ZodBoolean>;
         strictOpenapi: z.ZodOptional<z.ZodBoolean>;
         reportFile: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
@@ -356,6 +363,13 @@ export declare const flatOptionsSchema: z.ZodObject<{
     }, z.core.$strip>>;
     useProjectPrettier: z.ZodOptional<z.ZodBoolean>;
     useEslintFix: z.ZodOptional<z.ZodBoolean>;
+    cache: z.ZodOptional<z.ZodBoolean>;
+    cachePath: z.ZodOptional<z.ZodString>;
+    cacheStrategy: z.ZodOptional<z.ZodEnum<{
+        content: "content";
+        entity: "entity";
+    }>>;
+    cacheDebug: z.ZodOptional<z.ZodBoolean>;
     input: z.ZodString;
     output: z.ZodString;
 }, z.core.$strip>;

package/dist/common/VersionedSchema/AllVersionedSchemas/UnifiedVersionedSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UnifiedVersionedSchemas.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/AllVersionedSchemas/UnifiedVersionedSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAS3C,KAAK,IAAI,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE/F,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMpB,CAAC;AAEX,KAAK,wBAAwB,GAAG,OAAO,wBAAwB,CAAC;AAChE,KAAK,uBAAuB,GAAG,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAE9D,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,EAMlE,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,uBAAuB,CAAC,MAAM,CAAgC,CAAC;AAE9F,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG5B,CAAC"}
+{"version":3,"file":"UnifiedVersionedSchemas.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/AllVersionedSchemas/UnifiedVersionedSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAS3C,KAAK,IAAI,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE/F,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMpB,CAAC;AAEX,KAAK,wBAAwB,GAAG,OAAO,wBAAwB,CAAC;AAChE,KAAK,uBAAuB,GAAG,IAAI,CAAC,wBAAwB,CAAC,CAAC;AAE9D,eAAO,MAAM,uBAAuB,EAAE,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,EAMlE,CAAC;AAIF,eAAO,MAAM,gBAAgB,EAAE,uBAAuB,CAAC,MAAM,CAAgC,CAAC;AAE9F,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG5B,CAAC"}

package/dist/common/VersionedSchema/Utils/__mocks__/compatibilityCases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compatibilityCases.d.ts","sourceRoot":"","sources":["../../../../../src/common/VersionedSchema/Utils/__mocks__/compatibilityCases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAkHjD,CAAC"}
+{"version":3,"file":"compatibilityCases.d.ts","sourceRoot":"","sources":["../../../../../src/common/VersionedSchema/Utils/__mocks__/compatibilityCases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,iBAAiB,GAAG;IACrB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAuHjD,CAAC"}

package/dist/common/VersionedSchema/Utils/__mocks__/compatibilityCases.js

@@ -118,7 +118,12 @@ exports.compatibilityCases = [
         from: 'v4',
         to: 'v5',
         expect: [
-            { type: 'added', key: 'useProjectPrettier' }, { type: 'added', key: 'useEslintFix' },
+            { type: 'added', key: 'useProjectPrettier' },
+            { type: 'added', key: 'useEslintFix' },
+            { type: 'added', key: 'cache' },
+            { type: 'added', key: 'cachePath' },
+            { type: 'added', key: 'cacheStrategy' },
+            { type: 'added', key: 'cacheDebug' },
         ],
     },
 ];

package/dist/common/VersionedSchema/Utils/migrateDataToLatestSchemaVersion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrateDataToLatestSchemaVersion.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/migrateDataToLatestSchemaVersion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AASpF;;GAEG;AACH,KAAK,oBAAoB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IAChF,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;IAClD,aAAa,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,KAAK,qBAAqB,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,cAAc,EAAE,kBAAkB,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,oBAAoB,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,EAAE,oBAAoB,GAAG,qBAAqB,GAAG,IAAI,CAkFlK"}
+{"version":3,"file":"migrateDataToLatestSchemaVersion.d.ts","sourceRoot":"","sources":["../../../../src/common/VersionedSchema/Utils/migrateDataToLatestSchemaVersion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AASpF;;GAEG;AACH,KAAK,oBAAoB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,cAAc,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IAChF,gBAAgB,EAAE,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;IAClD,aAAa,EAAE,cAAc,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,KAAK,qBAAqB,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,cAAc,EAAE,kBAAkB,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,oBAAoB,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,EAAE,oBAAoB,GAAG,qBAAqB,GAAG,IAAI,CAkFlK"}

package/dist/common/VersionedSchema/Utils/migrateDataToLatestSchemaVersion.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.migrateDataToLatestSchemaVersion = migrateDataToLatestSchemaVersion;
 const Consts_1 = require("../../Consts");
-const LoggerMessages_1 = require("../../LoggerMessages");
 const Enums_1 = require("../../Enums");
+const LoggerMessages_1 = require("../../LoggerMessages");
 const validateZodOptions_1 = require("../../Validation/validateZodOptions");
 const determineBestMatchingSchemaVersion_1 = require("./determineBestMatchingSchemaVersion");
 const generateKeyMappingForInvalidKeys_1 = require("./generateKeyMappingForInvalidKeys");

package/dist/core/OpenApiClient.d.ts

@@ -1,13 +1,24 @@
 import { TRawOptions } from '../common/TRawOptions';
 import { WriteClient } from './WriteClient';
 export declare class OpenApiClient {
+    private static readonly CACHE_FINGERPRINT_VERSION;
+    private static readonly DEFAULT_CACHE_FILENAME;
     private _writeClient;
     get writeClient(): WriteClient;
     private normalizeOptions;
     private addDefaultValues;
-    private cleanOutputDirectories;
+    private getOutputRoots;
+    private cleanupStaleOutputs;
+    private removeStaleFilesInDirectory;
     private generateCodeForItems;
+    private getUniqueResolvedOutputs;
+    private resolveOutputRoot;
+    private resolveCachePathForOutput;
+    private warnOnSharedOutputsWithoutCache;
     private generateSingle;
+    private getCacheKey;
+    private getCacheFingerprint;
+    private filesExist;
     private loadDiffReportIfNeeded;
     private applyDiffReportIfNeeded;
     generate(rawOptions: TRawOptions): Promise<void>;

package/dist/core/OpenApiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAwBtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,aAAa;IACtB,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAwExB,OAAO,CAAC,gBAAgB;YAwCV,sBAAsB;YAUtB,oBAAoB;YAoCpB,cAAc;YA2Jd,sBAAsB;IASpC,OAAO,CAAC,uBAAuB;IAczB,QAAQ,CAAC,UAAU,EAAE,WAAW;CAWzC"}
+{"version":3,"file":"OpenApiClient.d.ts","sourceRoot":"","sources":["../../src/core/OpenApiClient.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,WAAW,EAAsB,MAAM,uBAAuB,CAAC;AAyBtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAK;IACtD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAiC;IAC/E,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAgFxB,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,cAAc;YAaR,mBAAmB;YASnB,2BAA2B;YA+B3B,oBAAoB;IA2DlC,OAAO,CAAC,wBAAwB;IAIhC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,+BAA+B;YAiBzB,cAAc;IA0L5B,OAAO,CAAC,WAAW;YAaL,mBAAmB;YAiCnB,UAAU;YAUV,sBAAsB;IASpC,OAAO,CAAC,uBAAuB;IAczB,QAAQ,CAAC,UAAU,EAAE,WAAW;CAWzC"}

package/dist/core/OpenApiClient.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenApiClient = void 0;
+const fs_1 = require("fs");
 const Consts_1 = require("../common/Consts");
 const Logger_1 = require("../common/Logger");
 const LoggerMessages_1 = require("../common/LoggerMessages");
@@ -16,6 +17,7 @@ const EmptySchemaStrategy_enum_1 = require("./types/enums/EmptySchemaStrategy.en
 const ModelsMode_enum_1 = require("./types/enums/ModelsMode.enum");
 const ValidationLibrary_enum_1 = require("./types/enums/ValidationLibrary.enum");
 const applyDiffReportToClient_1 = require("./utils/applyDiffReportToClient");
+const GenerationCache_1 = require("./utils/GenerationCache");
 const getOpenApiSpec_1 = require("./utils/getOpenApiSpec");
 const getOpenApiVersion_1 = require("./utils/getOpenApiVersion");
 const getOutputPaths_1 = require("./utils/getOutputPaths");
@@ -25,6 +27,8 @@ const prepareDtoModels_1 = require("./utils/prepareDtoModels");
 const registerHandlebarTemplates_1 = require("./utils/registerHandlebarTemplates");
 const WriteClient_1 = require("./WriteClient");
 class OpenApiClient {
+    static CACHE_FINGERPRINT_VERSION = 1;
+    static DEFAULT_CACHE_FILENAME = '.openapi-codegen-cache.json';
     _writeClient = null;
     get writeClient() {
         if (!this._writeClient) {
@@ -64,6 +68,10 @@ class OpenApiClient {
                 strictOpenapi: rawOptions.strictOpenapi,
                 reportFile: rawOptions.reportFile,
                 governanceConfig: rawOptions.governanceConfig,
+                cache: rawOptions.cache,
+                cachePath: rawOptions.cachePath,
+                cacheStrategy: rawOptions.cacheStrategy,
+                cacheDebug: rawOptions.cacheDebug,
             }));
         }
         else {
@@ -100,6 +108,10 @@ class OpenApiClient {
                     strictOpenapi: rawOptions.strictOpenapi,
                     reportFile: rawOptions.reportFile,
                     governanceConfig: rawOptions.governanceConfig,
+                    cache: rawOptions.cache,
+                    cachePath: rawOptions.cachePath,
+                    cacheStrategy: rawOptions.cacheStrategy,
+                    cacheDebug: rawOptions.cacheDebug,
                 },
             ];
         }
@@ -141,15 +153,55 @@ class OpenApiClient {
             useProjectPrettier: item.useProjectPrettier ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useProjectPrettier,
             useEslintFix: item.useEslintFix ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.useEslintFix,
             governanceConfig: item.governanceConfig || Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.governanceConfig,
+            cache: item.cache ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cache,
+            cachePath: item.cachePath || Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cachePath,
+            cacheStrategy: item.cacheStrategy ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cacheStrategy,
+            cacheDebug: item.cacheDebug ?? Consts_1.COMMON_DEFAULT_OPTIONS_VALUES.cacheDebug,
         };
     }
-    async cleanOutputDirectories(option) {
-        const outputDirs = [option.output, option.outputCore, option.outputSchemas, option.outputModels, option.outputServices];
-        for (const dir of outputDirs) {
-            if (dir) {
-                await fileSystemHelpers_1.fileSystemHelpers.rmdir(dir);
+    getOutputRoots(items) {
+        const roots = new Set();
+        for (const item of items) {
+            const outputDirs = [item.output, item.outputCore, item.outputSchemas, item.outputModels, item.outputServices];
+            for (const dir of outputDirs) {
+                if (dir) {
+                    roots.add((0, pathHelpers_1.resolveHelper)(process.cwd(), dir));
+                }
             }
         }
+        return Array.from(roots);
+    }
+    async cleanupStaleOutputs(items) {
+        const outputRoots = this.getOutputRoots(items);
+        const expectedFiles = this.writeClient.getExpectedOutputFiles();
+        for (const root of outputRoots) {
+            await this.removeStaleFilesInDirectory(root, expectedFiles);
+        }
+    }
+    async removeStaleFilesInDirectory(path, expectedFiles) {
+        const stats = await fs_1.promises.stat(path).catch(() => null);
+        if (!stats) {
+            return false;
+        }
+        if (stats.isFile()) {
+            if (!expectedFiles.has(path)) {
+                await fileSystemHelpers_1.fileSystemHelpers.rmdir(path);
+                return false;
+            }
+            return true;
+        }
+        const entries = await fs_1.promises.readdir(path);
+        let hasAnyFile = false;
+        for (const entry of entries) {
+            const childPath = (0, pathHelpers_1.resolveHelper)(path, entry);
+            const childHasFiles = await this.removeStaleFilesInDirectory(childPath, expectedFiles);
+            hasAnyFile = hasAnyFile || childHasFiles;
+        }
+        if (!hasAnyFile) {
+            await fileSystemHelpers_1.fileSystemHelpers.rmdir(path);
+            return false;
+        }
+        return true;
     }
     async generateCodeForItems(items) {
         if (items.length === 0) {
@@ -158,12 +210,27 @@ class OpenApiClient {
         this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.STARTED(items.length));
         try {
             const start = process.hrtime.bigint();
-            for (const option of items) {
-                await this.cleanOutputDirectories(option);
+            const cacheEnabled = items[0]?.cache === true;
+            const generationCaches = new Map();
+            if (!cacheEnabled) {
+                this.warnOnSharedOutputsWithoutCache(items);
+            }
+            else {
+                for (const outputRoot of this.getUniqueResolvedOutputs(items)) {
+                    const sampleItem = items.find(item => this.resolveOutputRoot(item.output) === outputRoot);
+                    if (!sampleItem) {
+                        continue;
+                    }
+                    const cachePath = this.resolveCachePathForOutput(sampleItem.output, sampleItem.cachePath);
+                    const generationCache = new GenerationCache_1.GenerationCache(cachePath);
+                    await generationCache.load();
+                    generationCaches.set(outputRoot, generationCache);
+                }
             }
             for (const option of items) {
                 const fileStart = process.hrtime.bigint();
-                await this.generateSingle(option);
+                const generationCache = cacheEnabled ? generationCaches.get(this.resolveOutputRoot(option.output)) ?? null : null;
+                await this.generateSingle(option, generationCache);
                 const fileEnd = process.hrtime.bigint();
                 const fileDurationInSeconds = Number(fileEnd - fileStart) / 1e9;
                 this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.DURATION_FOR_FILE(option.input, fileDurationInSeconds.toFixed(3)));
@@ -174,6 +241,14 @@ class OpenApiClient {
             else {
                 await this.writeClient.combineAndWrite();
             }
+            await this.cleanupStaleOutputs(items);
+            if (cacheEnabled) {
+                for (const generationCache of generationCaches.values()) {
+                    await generationCache.save();
+                }
+            }
+            const writeStats = this.writeClient.getWriteStats();
+            this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.WRITE_STATS(writeStats.written, writeStats.unchanged));
             this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.FINISHED);
             const end = process.hrtime.bigint();
             const durationInSeconds = Number(end - start) / 1e9;
@@ -185,7 +260,33 @@ class OpenApiClient {
         }
         this.writeClient.logger.shutdownLogger();
     }
-    async generateSingle(item) {
+    getUniqueResolvedOutputs(items) {
+        return Array.from(new Set(items.map(item => this.resolveOutputRoot(item.output))));
+    }
+    resolveOutputRoot(output) {
+        return (0, pathHelpers_1.resolveHelper)(process.cwd(), output);
+    }
+    resolveCachePathForOutput(output, cachePath) {
+        if (cachePath.startsWith('/') || /^[A-Za-z]:[\\/]/.test(cachePath)) {
+            return cachePath;
+        }
+        return (0, pathHelpers_1.resolveHelper)(this.resolveOutputRoot(output), cachePath || OpenApiClient.DEFAULT_CACHE_FILENAME);
+    }
+    warnOnSharedOutputsWithoutCache(items) {
+        const countByOutput = new Map();
+        for (const item of items) {
+            const output = this.resolveOutputRoot(item.output);
+            countByOutput.set(output, (countByOutput.get(output) ?? 0) + 1);
+        }
+        const duplicatedOutputs = Array.from(countByOutput.entries())
+            .filter(([, count]) => count > 1)
+            .map(([output]) => output);
+        if (duplicatedOutputs.length === 0) {
+            return;
+        }
+        this.writeClient.logger.warn(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.CACHE_SHARED_OUTPUT_WARNING(duplicatedOutputs.map(output => `- ${output}`).join('\n')));
+    }
+    async generateSingle(item, generationCache) {
         const { input, output, outputCore, outputServices, outputModels, outputSchemas, httpClient, useOptions, useUnionTypes, excludeCoreServiceFiles, request, plugins, customExecutorPath, interfacePrefix, enumPrefix, typePrefix, useCancelableRequest, sortByRequired, useSeparatedIndexes, validationLibrary = ValidationLibrary_enum_1.ValidationLibrary.NONE, emptySchemaStrategy = EmptySchemaStrategy_enum_1.EmptySchemaStrategy.KEEP, useHistory, diffReport, modelsMode = ModelsMode_enum_1.ModelsMode.INTERFACES, strictOpenapi, reportFile, useProjectPrettier = false, useEslintFix = false, governanceConfig, } = item;
         const outputPaths = (0, getOutputPaths_1.getOutputPaths)({
             output,
@@ -195,6 +296,28 @@ class OpenApiClient {
             outputSchemas,
         });
         const absoluteInput = (0, pathHelpers_1.resolveHelper)(process.cwd(), input);
+        const cacheKey = this.getCacheKey(item, absoluteInput);
+        const cacheFingerprint = await this.getCacheFingerprint(item, absoluteInput);
+        const useEntityCache = item.cache && item.cacheStrategy === 'entity' && generationCache !== null;
+        if (useEntityCache) {
+            const cachedEntry = generationCache.get(cacheKey);
+            if (cachedEntry && cachedEntry.fingerprint === cacheFingerprint) {
+                const allFilesExist = await this.filesExist(cachedEntry.files);
+                if (allFilesExist) {
+                    for (const filePath of cachedEntry.files) {
+                        this.writeClient.registerOutputFile(filePath);
+                    }
+                    if (item.cacheDebug) {
+                        this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.CACHE_HIT(input));
+                    }
+                    return;
+                }
+            }
+            if (item.cacheDebug) {
+                this.writeClient.logger.info(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.CACHE_MISS(input));
+            }
+        }
+        const knownFilesBefore = new Set(this.writeClient.getExpectedOutputFilesArray());
         const generatorPlugins = await (0, loadGeneratorPlugins_1.loadGeneratorPlugins)(plugins);
         const context = new Context_1.Context({
             input: absoluteInput,
@@ -214,7 +337,7 @@ class OpenApiClient {
                 governanceConfig: governancePolicy,
             });
             const reportPath = await (0, validateOpenApiStrict_1.writeOpenApiStrictReport)(strictReport, reportFile);
-            this.writeClient.logger.forceInfo(`Strict OpenAPI report created: ${reportPath}`);
+            this.writeClient.logger.forceInfo(LoggerMessages_1.LOGGER_MESSAGES.GENERATION.STRICT_REPORT_CREATED(reportPath));
             if (strictReport.summary.errors > 0) {
                 throw new Error(`Strict OpenAPI validation failed with ${strictReport.summary.errors} error(s). Report: ${reportPath}`);
             }
@@ -302,6 +425,65 @@ class OpenApiClient {
                 break;
             }
         }
+        const generatedFiles = this.writeClient.getExpectedOutputFilesArray().filter(filePath => !knownFilesBefore.has(filePath));
+        if (item.cache && generationCache) {
+            generationCache.set({
+                key: cacheKey,
+                fingerprint: cacheFingerprint,
+                files: generatedFiles,
+                updatedAt: Date.now(),
+            });
+        }
+    }
+    getCacheKey(item, absoluteInput) {
+        return GenerationCache_1.GenerationCache.hash(JSON.stringify({
+            input: absoluteInput,
+            output: item.output,
+            outputCore: item.outputCore,
+            outputServices: item.outputServices,
+            outputModels: item.outputModels,
+            outputSchemas: item.outputSchemas,
+        }));
+    }
+    async getCacheFingerprint(item, absoluteInput) {
+        const specContent = await fileSystemHelpers_1.fileSystemHelpers.readFile(absoluteInput, 'utf8');
+        const fingerprint = {
+            cacheFingerprintVersion: OpenApiClient.CACHE_FINGERPRINT_VERSION,
+            generatorVersion: process.env.npm_package_version || 'dev',
+            specHash: GenerationCache_1.GenerationCache.hash(specContent),
+            options: {
+                httpClient: item.httpClient,
+                useOptions: item.useOptions,
+                useUnionTypes: item.useUnionTypes,
+                includeSchemasFiles: item.includeSchemasFiles,
+                excludeCoreServiceFiles: item.excludeCoreServiceFiles,
+                request: item.request,
+                plugins: item.plugins,
+                customExecutorPath: item.customExecutorPath,
+                interfacePrefix: item.interfacePrefix,
+                enumPrefix: item.enumPrefix,
+                typePrefix: item.typePrefix,
+                useCancelableRequest: item.useCancelableRequest,
+                sortByRequired: item.sortByRequired,
+                useSeparatedIndexes: item.useSeparatedIndexes,
+                validationLibrary: item.validationLibrary,
+                emptySchemaStrategy: item.emptySchemaStrategy,
+                useHistory: item.useHistory,
+                diffReport: item.diffReport,
+                modelsMode: item.modelsMode,
+                strictOpenapi: item.strictOpenapi,
+            },
+        };
+        return GenerationCache_1.GenerationCache.hash(JSON.stringify(fingerprint));
+    }
+    async filesExist(paths) {
+        for (const filePath of paths) {
+            const exists = await fileSystemHelpers_1.fileSystemHelpers.exists(filePath);
+            if (!exists) {
+                return false;
+            }
+        }
+        return true;
     }
     async loadDiffReportIfNeeded(params) {
         return (0, loadDiffReport_1.loadDiffReport)({

package/dist/core/WriteClient.d.ts

@@ -18,6 +18,7 @@ import { writeClientSchemasIndex } from './utils/writeClientSchemasIndex';
 import { writeClientServices } from './utils/writeClientServices';
 import { writeClientServicesIndex } from './utils/writeClientServicesIndex';
 import { writeClientSimpleIndex } from './utils/writeClientSimpleIndex';
+import { WriteFileIfChangedResult } from './utils/writeFileIfChanged';
 /**
  * @param client Client object with all the models, services, etc.
  * @param templates Templates wrapper with all loaded Handlebars templates
@@ -57,6 +58,8 @@ type TAPIClientGeneratorConfig = Omit<TWriteClientProps, 'httpClient' | 'useOpti
  */
 export declare class WriteClient {
     private config;
+    private expectedOutputFiles;
+    private writeStats;
     private _logger;
     constructor(logger?: Logger);
     /**
@@ -72,6 +75,14 @@ export declare class WriteClient {
     combineAndWrite(): Promise<void>;
     combineAndWrightSimple(): Promise<void>;
     get logger(): Logger;
+    writeOutputFile(filePath: string, content: string): Promise<WriteFileIfChangedResult>;
+    registerOutputFile(filePath: string): void;
+    getExpectedOutputFiles(): Set<string>;
+    getExpectedOutputFilesArray(): string[];
+    getWriteStats(): {
+        written: number;
+        unchanged: number;
+    };
     private buildSimpleClientIndexMap;
     private buildClientIndexMap;
     private finalizeAndWrite;

package/dist/core/WriteClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WriteClient.d.ts","sourceRoot":"","sources":["../../src/core/WriteClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"WriteClient.d.ts","sourceRoot":"","sources":["../../src/core/WriteClient.ts"],"names":[],"mappings":"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"}