ts-openapi-codegen 2.0.0 → 2.1.0-beta.2

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

@@ -0,0 +1,90 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_assert_1 = __importDefault(require("node:assert"));
+const node_test_1 = require("node:test");
+const Consts_1 = require("../../Consts");
+const format_1 = require("../format");
+(0, node_test_1.describe)('@unit: format', () => {
+    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,
+                message: options.message,
+                error: options.error,
+            });
+        };
+    });
+    (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)('default behavior (useProjectConfig=false)', () => {
+        (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);
+            node_assert_1.default.ok(result.includes('const x'), 'should include variable declaration');
+            node_assert_1.default.ok(result.trim().length > 0, 'should produce non-empty output');
+        });
+        (0, node_test_1.test)('uses typescript parser by default', async () => {
+            const input = `interface IFoo { bar: string; }`;
+            const result = await (0, format_1.format)(input);
+            node_assert_1.default.ok(result.includes('IFoo'), 'should preserve interface name');
+        });
+        (0, node_test_1.test)('respects custom parser argument', async () => {
+            const input = `{"key":"value"}`;
+            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 () => {
+            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.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.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) => {
+                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;
+            });
+            node_assert_1.default.ok(errorWithHintCalls.some(c => c.code === 'PRETTIER_FORMAT_FAILED'), 'should call errorWithHint with PRETTIER_FORMAT_FAILED code');
+        });
+    });
+});

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,CA6GxH"}
+{"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"}

package/dist/common/utils/convertArrayToObject.js

@@ -33,6 +33,9 @@ function convertArrayToObject(optionsArr) {
             'useSeparatedIndexes',
             'validationLibrary',
             'emptySchemaStrategy',
+            'modelsMode',
+            'useHistory',
+            'diffReport',
         ];
         const getNormalizedFieldValue = (item, field) => {
             if (field === 'httpClient') {

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

@@ -0,0 +1,7 @@
+/**
+ * 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.
+ */
+export declare function eslintFix(filePath: string): Promise<void>;
+//# sourceMappingURL=eslintFix.d.ts.map

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

@@ -0,0 +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"}

package/dist/common/utils/eslintFix.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eslintFix = eslintFix;
+const Consts_1 = require("../Consts");
+const LoggerMessages_1 = require("../LoggerMessages");
+/**
+ * Dynamically resolves the ESLint module from the user's project.
+ * Returns null if ESLint is not installed.
+ */
+async function tryImportESLint() {
+    try {
+        const mod = await Promise.resolve().then(() => __importStar(require('eslint')));
+        return mod;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 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.
+ */
+async function eslintFix(filePath) {
+    const eslintModule = await tryImportESLint();
+    if (!eslintModule) {
+        Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_NOT_INSTALLED);
+        return;
+    }
+    try {
+        const eslint = new eslintModule.ESLint({ fix: true });
+        const results = await eslint.lintFiles([filePath]);
+        await eslintModule.ESLint.outputFixes(results);
+        Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_FIX_APPLIED(filePath));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        Consts_1.APP_LOGGER.errorWithHint({
+            code: LoggerMessages_1.LOGGER_ERROR_CODES.ESLINT_FIX_FAILED,
+            message: LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.ESLINT_FIX_FAILED(filePath, message),
+            error,
+        });
+        throw error;
+    }
+}

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

@@ -1,3 +1,3 @@
 import { BuiltInParserName, LiteralUnion } from 'prettier';
-export declare function format(input: string, parser?: LiteralUnion<BuiltInParserName>): Promise<string>;
+export declare function format(input: string, parser?: LiteralUnion<BuiltInParserName>, useProjectConfig?: boolean): Promise<string>;
 //# sourceMappingURL=format.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/common/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA2B,YAAY,EAAE,MAAM,UAAU,CAAC;AAEpF,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrG"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/common/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA4B,YAAY,EAA6C,MAAM,UAAU,CAAC;AAiBhI,wBAAsB,MAAM,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,EACxC,gBAAgB,CAAC,EAAE,OAAO,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6BjB"}

package/dist/common/utils/format.js

@@ -2,23 +2,47 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.format = format;
 const prettier_1 = require("prettier");
-async function format(input, parser) {
+const Consts_1 = require("../Consts");
+const LoggerMessages_1 = require("../LoggerMessages");
+const BUILTIN_PRETTIER_OPTIONS = {
+    tabWidth: 4,
+    printWidth: 120,
+    useTabs: false,
+    singleQuote: true,
+    quoteProps: 'as-needed',
+    trailingComma: 'all',
+    bracketSpacing: true,
+    arrowParens: 'avoid',
+    endOfLine: 'auto',
+};
+async function format(input, parser, useProjectConfig) {
+    let options = { ...BUILTIN_PRETTIER_OPTIONS, parser: parser ?? 'typescript' };
+    if (useProjectConfig) {
+        try {
+            const resolved = await (0, prettier_1.resolveConfig)(process.cwd(), { useCache: false });
+            if (resolved) {
+                Consts_1.APP_LOGGER.info(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_PROJECT_CONFIG_RESOLVED(process.cwd()));
+                options = { ...resolved, parser: parser ?? resolved.parser ?? 'typescript' };
+            }
+            else {
+                Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_PROJECT_CONFIG_NOT_FOUND);
+            }
+        }
+        catch {
+            Consts_1.APP_LOGGER.warn(LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_PROJECT_CONFIG_NOT_FOUND);
+        }
+    }
     try {
-        const formatedCode = await (0, prettier_1.format)(input, {
-            parser: parser ?? 'typescript',
-            tabWidth: 4,
-            printWidth: 120,
-            useTabs: false,
-            singleQuote: true,
-            quoteProps: 'as-needed',
-            trailingComma: 'all',
-            bracketSpacing: true,
-            arrowParens: 'avoid',
-            endOfLine: 'auto',
-        });
+        const formatedCode = await (0, prettier_1.format)(input, options);
         return formatedCode;
     }
-    catch {
-        throw new Error('Could not to format the value via prettier');
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        Consts_1.APP_LOGGER.errorWithHint({
+            code: LoggerMessages_1.LOGGER_ERROR_CODES.PRETTIER_FORMAT_FAILED,
+            message: LoggerMessages_1.LOGGER_MESSAGES.FORMATTING.PRETTIER_FORMAT_FAILED('(generated content)', message),
+            error,
+        });
+        throw new Error(`Could not format the value via prettier: ${message}`);
     }
 }

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

@@ -0,0 +1,5 @@
+type JsonPathSegment = string | number;
+export declare const toJsonPath: (segments: JsonPathSegment[]) => string;
+export declare const parseJsonPath: (path: string) => string[];
+export {};
+//# sourceMappingURL=jsonPath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonPath.d.ts","sourceRoot":"","sources":["../../../src/common/utils/jsonPath.ts"],"names":[],"mappings":"AAAA,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,eAAO,MAAM,UAAU,GAAI,UAAU,eAAe,EAAE,KAAG,MAcxD,CAAC;AAIF,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,KAAG,MAAM,EAQlD,CAAC"}

package/dist/common/utils/jsonPath.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseJsonPath = exports.toJsonPath = void 0;
+const toJsonPath = (segments) => {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return segments.reduce((path, seg) => {
+        const segment = String(seg);
+        const needsBrackets = segment.includes('.') || segment.includes('/') || segment.includes('-') || segment.includes('[') || segment.includes(']');
+        if (segment === '') {
+            return path;
+        }
+        return path + (needsBrackets ? `['${segment}']` : `.${segment}`);
+    }, '$');
+};
+exports.toJsonPath = toJsonPath;
+const JSON_PATH_SEGMENT_REGEX = /\[['"]([^'"]+)['"]\]|\.([A-Za-z0-9_$]+)/g;
+const parseJsonPath = (path) => {
+    const segments = [];
+    JSON_PATH_SEGMENT_REGEX.lastIndex = 0;
+    let match;
+    while ((match = JSON_PATH_SEGMENT_REGEX.exec(path)) !== null) {
+        segments.push(match[1] ?? match[2]);
+    }
+    return segments.filter(segment => segment.length > 0);
+};
+exports.parseJsonPath = parseJsonPath;

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

@@ -0,0 +1,2 @@
+export declare const normalizeObject: (value: any) => any;
+//# sourceMappingURL=normalizeObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeObject.d.ts","sourceRoot":"","sources":["../../../src/common/utils/normalizeObject.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,eAAe,GAAI,OAAO,GAAG,KAAG,GA2B5C,CAAC"}

package/dist/common/utils/normalizeObject.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeObject = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const isPlainObject = (value) => {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};
+const mergeObjects = (base, next) => {
+    const result = { ...base };
+    for (const [key, value] of Object.entries(next)) {
+        const existing = result[key];
+        if (isPlainObject(existing) && isPlainObject(value)) {
+            result[key] = mergeObjects(existing, value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+};
+const expandAllOf = (value) => {
+    const allOf = Array.isArray(value.allOf) ? value.allOf : null;
+    if (!allOf)
+        return value;
+    let merged = {};
+    for (const item of allOf) {
+        if (isPlainObject(item)) {
+            merged = mergeObjects(merged, item);
+        }
+    }
+    const rest = {};
+    for (const [key, val] of Object.entries(value)) {
+        if (key === 'allOf')
+            continue;
+        rest[key] = val;
+    }
+    return mergeObjects(merged, rest);
+};
+const normalizeObject = (value) => {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => (0, exports.normalizeObject)(item));
+    }
+    if (typeof value !== 'object') {
+        return value;
+    }
+    const expanded = expandAllOf(value);
+    const entries = Object.entries(expanded).sort(([a], [b]) => {
+        if (a < b)
+            return -1;
+        if (a > b)
+            return 1;
+        return 0;
+    });
+    const result = {};
+    for (const [key, val] of entries) {
+        result[key] = (0, exports.normalizeObject)(val);
+    }
+    return result;
+};
+exports.normalizeObject = normalizeObject;

package/dist/core/Context.d.ts

@@ -1,4 +1,5 @@
 import { JSONSchema4Type, JSONSchema6Type, JSONSchema7Type } from 'json-schema';
+import { OpenApiGeneratorPlugin, SchemaTypeOverrideContext } from './plugins/GeneratorPlugin.model';
 import { OutputPaths } from './types/base/OutputPaths.model';
 import { PrefixArtifacts } from './types/base/PrefixArtifacts.model';
 import { $Root } from './types/base/Root.model';
@@ -7,6 +8,7 @@ type TContextProps = {
     output: OutputPaths;
     prefix?: PrefixArtifacts;
     sortByRequired?: boolean;
+    plugins?: OpenApiGeneratorPlugin[];
 };
 type RefsLike = {
     values: (...args: any[]) => Record<string, any>;
@@ -32,10 +34,11 @@ export declare class Context {
     private _output;
     prefix: PrefixArtifacts;
     private _sortByRequired;
+    private _plugins;
     private specRoot;
     private entryFile?;
     private virtualFiles;
-    constructor({ input, output, prefix, sortByRequired }: TContextProps);
+    constructor({ input, output, prefix, sortByRequired, plugins }: TContextProps);
     addRefs(refs: RefsLike): Context;
     values(...types: string[]): Record<string, any>;
     get($ref: string, parentSourceFile?: string): JSONSchema4Type | JSONSchema6Type | JSONSchema7Type;
@@ -45,6 +48,10 @@ export declare class Context {
     get output(): OutputPaths;
     get sortByRequired(): boolean;
     get root(): $Root | undefined;
+    /**
+     * Resolves custom type override for schema via registered plugins.
+     */
+    resolveSchemaTypeOverride(schema: Record<string, any>, context: SchemaTypeOverrideContext): string | undefined;
     private canonicalizeRef;
     private mapSourceToOutput;
     private walkSchemaForFragments;

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

@@ -1 +1 @@
-{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/core/Context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAIhF,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAMhD,KAAK,aAAa,GAAG;IACjB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,QAAQ,GAAG;IACZ,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;IAC7E,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EAAE,CAAC;IACpC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,UAAU,WAAW;IACjB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,KAAK,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE/C;;GAEG;AACH,qBAAa,OAAO;IAChB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAc;IACtB,MAAM,EAAE,eAAe,CAI5B;IAEF,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA6B;gBAErC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,aAAa;IAmB7D,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAKhC,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAO/C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe;IAQjG,KAAK,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAOnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO;IAQxD,QAAQ,IAAI,MAAM;IAOzB,IAAW,MAAM,gBAKhB;IAED,IAAW,cAAc,YAExB;IAED,IAAW,IAAI,IAAI,KAAK,GAAG,SAAS,CAEnC;IAED,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,sBAAsB;IA+BvB,wBAAwB,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM;IAuC/D,eAAe,IAAI,cAAc;IAIjC,mBAAmB,IAAI,MAAM,EAAE;IAgB/B,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GACpE;QACI,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,GACD,SAAS;IAef,OAAO,CAAC,qBAAqB;CAyBhC"}
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/core/Context.ts"],"names":[],"mappings":"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"}

package/dist/core/Context.js

@@ -20,10 +20,11 @@ class Context {
         type: 'T',
     };
     _sortByRequired = false;
+    _plugins = [];
     specRoot;
     entryFile;
     virtualFiles = new Map();
-    constructor({ input, output, prefix, sortByRequired }) {
+    constructor({ input, output, prefix, sortByRequired, plugins }) {
         this._output = output;
         this._refs = {};
         if ((0, isString_1.isString)(input)) {
@@ -38,6 +39,7 @@ class Context {
         if (sortByRequired !== undefined && sortByRequired !== null) {
             this._sortByRequired = sortByRequired;
         }
+        this._plugins = plugins || [];
         return this;
     }
     addRefs(refs) {
@@ -88,6 +90,18 @@ class Context {
     get root() {
         return this._root;
     }
+    /**
+     * Resolves custom type override for schema via registered plugins.
+     */
+    resolveSchemaTypeOverride(schema, context) {
+        for (const plugin of this._plugins) {
+            const override = plugin.resolveSchemaTypeOverride?.({ schema, context });
+            if (typeof override === 'string' && override.trim()) {
+                return override.trim();
+            }
+        }
+        return undefined;
+    }
     canonicalizeRef(ref, parentSourceFile) {
         const parsed = (0, parseRef_1.parseRef)(ref);
         // LOCAL_FRAGMENT → тот же файл
@@ -164,9 +178,14 @@ class Context {
         }
         // Обходим каждый файл чтобы найти $ref с фрагментами (#)
         for (const [sourceFile] of this.virtualFiles) {
-            const schema = this._refs?.get(sourceFile);
-            if (schema && typeof schema === 'object') {
-                this.walkSchemaForFragments(schema, sourceFile);
+            try {
+                const schema = this._refs?.get(sourceFile);
+                if (schema && typeof schema === 'object') {
+                    this.walkSchemaForFragments(schema, sourceFile);
+                }
+            }
+            catch {
+                // Skip unresolved entries from refs.paths().
             }
         }
     }

package/dist/core/OpenApiClient.d.ts

@@ -8,6 +8,8 @@ export declare class OpenApiClient {
     private cleanOutputDirectories;
     private generateCodeForItems;
     private generateSingle;
+    private loadDiffReportIfNeeded;
+    private applyDiffReportIfNeeded;
     generate(rawOptions: TRawOptions): Promise<void>;
 }
 //# sourceMappingURL=OpenApiClient.d.ts.map

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;AAgBtF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,qBAAa,aAAa;IACtB,OAAO,CAAC,YAAY,CAA4B;IAEhD,IAAW,WAAW,gBAKrB;IAED,OAAO,CAAC,gBAAgB;IAuDxB,OAAO,CAAC,gBAAgB;YA4BV,sBAAsB;YAUtB,oBAAoB;YAmCpB,cAAc;IAwFtB,QAAQ,CAAC,UAAU,EAAE,WAAW;CAWzC"}
+{"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"}