vovk 3.0.0-draft.33 → 3.0.0-draft.331

package/cjs/index.js

@@ -0,0 +1,38 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initSegment = exports.prefix = exports.options = exports.head = exports.del = exports.patch = exports.put = exports.post = exports.get = exports.vovkSchemaToOpenAPI = exports.openAPIToVovkSchema = exports.openapi = exports.progressive = exports.createCodeExamples = exports.createLLMTools = exports.multitenant = exports.createStandardValidation = exports.withValidationLibrary = exports.generateStaticAPI = exports.createFetcher = exports.fetcher = exports.createRPC = exports.createDecorator = exports.createVovkApp = exports.HttpMethod = exports.HttpStatus = exports.HttpException = exports.JSONLinesResponse = exports.VovkSchemaIdEnum = void 0;
+const createVovkApp_1 = require("./createVovkApp");
+Object.defineProperty(exports, "createVovkApp", { enumerable: true, get: function () { return createVovkApp_1.createVovkApp; } });
+const types_1 = require("./types");
+Object.defineProperty(exports, "HttpStatus", { enumerable: true, get: function () { return types_1.HttpStatus; } });
+Object.defineProperty(exports, "HttpMethod", { enumerable: true, get: function () { return types_1.HttpMethod; } });
+Object.defineProperty(exports, "VovkSchemaIdEnum", { enumerable: true, get: function () { return types_1.VovkSchemaIdEnum; } });
+const index_1 = require("./client/index");
+Object.defineProperty(exports, "createRPC", { enumerable: true, get: function () { return index_1.createRPC; } });
+Object.defineProperty(exports, "fetcher", { enumerable: true, get: function () { return index_1.fetcher; } });
+Object.defineProperty(exports, "createFetcher", { enumerable: true, get: function () { return index_1.createFetcher; } });
+Object.defineProperty(exports, "progressive", { enumerable: true, get: function () { return index_1.progressive; } });
+const index_2 = require("./openapi/index");
+Object.defineProperty(exports, "openapi", { enumerable: true, get: function () { return index_2.openapi; } });
+Object.defineProperty(exports, "openAPIToVovkSchema", { enumerable: true, get: function () { return index_2.openAPIToVovkSchema; } });
+Object.defineProperty(exports, "vovkSchemaToOpenAPI", { enumerable: true, get: function () { return index_2.vovkSchemaToOpenAPI; } });
+const HttpException_1 = require("./HttpException");
+Object.defineProperty(exports, "HttpException", { enumerable: true, get: function () { return HttpException_1.HttpException; } });
+const createDecorator_1 = require("./utils/createDecorator");
+Object.defineProperty(exports, "createDecorator", { enumerable: true, get: function () { return createDecorator_1.createDecorator; } });
+const JSONLinesResponse_1 = require("./JSONLinesResponse");
+Object.defineProperty(exports, "JSONLinesResponse", { enumerable: true, get: function () { return JSONLinesResponse_1.JSONLinesResponse; } });
+const generateStaticAPI_1 = require("./utils/generateStaticAPI");
+Object.defineProperty(exports, "generateStaticAPI", { enumerable: true, get: function () { return generateStaticAPI_1.generateStaticAPI; } });
+const withValidationLibrary_1 = require("./utils/withValidationLibrary");
+Object.defineProperty(exports, "withValidationLibrary", { enumerable: true, get: function () { return withValidationLibrary_1.withValidationLibrary; } });
+const createStandardValidation_1 = require("./utils/createStandardValidation");
+Object.defineProperty(exports, "createStandardValidation", { enumerable: true, get: function () { return createStandardValidation_1.createStandardValidation; } });
+const multitenant_1 = require("./utils/multitenant");
+Object.defineProperty(exports, "multitenant", { enumerable: true, get: function () { return multitenant_1.multitenant; } });
+const createLLMTools_1 = require("./utils/createLLMTools");
+Object.defineProperty(exports, "createLLMTools", { enumerable: true, get: function () { return createLLMTools_1.createLLMTools; } });
+const createCodeExamples_1 = require("./utils/createCodeExamples");
+Object.defineProperty(exports, "createCodeExamples", { enumerable: true, get: function () { return createCodeExamples_1.createCodeExamples; } });
+_a = (0, createVovkApp_1.createVovkApp)(), exports.get = _a.get, exports.post = _a.post, exports.put = _a.put, exports.patch = _a.patch, exports.del = _a.del, exports.head = _a.head, exports.options = _a.options, exports.prefix = _a.prefix, exports.initSegment = _a.initSegment;

package/cjs/openapi/error.d.ts

@@ -0,0 +1,2 @@
+import { HttpStatus } from '../types';
+export declare const error: (status: HttpStatus, message: string) => (target: import("../types").KnownAny, propertyKey: string) => void;

package/cjs/openapi/error.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.error = void 0;
+const types_1 = require("../types");
+const createDecorator_1 = require("../utils/createDecorator");
+const statusDisplayText = {
+    [types_1.HttpStatus.NULL]: 'Error',
+    [types_1.HttpStatus.CONTINUE]: 'Continue',
+    [types_1.HttpStatus.SWITCHING_PROTOCOLS]: 'Switching Protocols',
+    [types_1.HttpStatus.PROCESSING]: 'Processing',
+    [types_1.HttpStatus.EARLYHINTS]: 'Early Hints',
+    [types_1.HttpStatus.OK]: 'OK',
+    [types_1.HttpStatus.CREATED]: 'Created',
+    [types_1.HttpStatus.ACCEPTED]: 'Accepted',
+    [types_1.HttpStatus.NON_AUTHORITATIVE_INFORMATION]: 'Non Authoritative Information',
+    [types_1.HttpStatus.NO_CONTENT]: 'No Content',
+    [types_1.HttpStatus.RESET_CONTENT]: 'Reset Content',
+    [types_1.HttpStatus.PARTIAL_CONTENT]: 'Partial Content',
+    [types_1.HttpStatus.AMBIGUOUS]: 'Ambiguous',
+    [types_1.HttpStatus.MOVED_PERMANENTLY]: 'Moved Permanently',
+    [types_1.HttpStatus.FOUND]: 'Found',
+    [types_1.HttpStatus.SEE_OTHER]: 'See Other',
+    [types_1.HttpStatus.NOT_MODIFIED]: 'Not Modified',
+    [types_1.HttpStatus.TEMPORARY_REDIRECT]: 'Temporary Redirect',
+    [types_1.HttpStatus.PERMANENT_REDIRECT]: 'Permanent Redirect',
+    [types_1.HttpStatus.BAD_REQUEST]: 'Bad Request',
+    [types_1.HttpStatus.UNAUTHORIZED]: 'Unauthorized',
+    [types_1.HttpStatus.PAYMENT_REQUIRED]: 'Payment Required',
+    [types_1.HttpStatus.FORBIDDEN]: 'Forbidden',
+    [types_1.HttpStatus.NOT_FOUND]: 'Not Found',
+    [types_1.HttpStatus.METHOD_NOT_ALLOWED]: 'Method Not Allowed',
+    [types_1.HttpStatus.NOT_ACCEPTABLE]: 'Not Acceptable',
+    [types_1.HttpStatus.PROXY_AUTHENTICATION_REQUIRED]: 'Proxy Authentication Required',
+    [types_1.HttpStatus.REQUEST_TIMEOUT]: 'Request Timeout',
+    [types_1.HttpStatus.CONFLICT]: 'Conflict',
+    [types_1.HttpStatus.GONE]: 'Gone',
+    [types_1.HttpStatus.LENGTH_REQUIRED]: 'Length Required',
+    [types_1.HttpStatus.PRECONDITION_FAILED]: 'Precondition Failed',
+    [types_1.HttpStatus.PAYLOAD_TOO_LARGE]: 'Payload Too Large',
+    [types_1.HttpStatus.URI_TOO_LONG]: 'URI Too Long',
+    [types_1.HttpStatus.UNSUPPORTED_MEDIA_TYPE]: 'Unsupported Media Type',
+    [types_1.HttpStatus.REQUESTED_RANGE_NOT_SATISFIABLE]: 'Requested Range Not Satisfiable',
+    [types_1.HttpStatus.EXPECTATION_FAILED]: 'Expectation Failed',
+    [types_1.HttpStatus.I_AM_A_TEAPOT]: 'I am a teapot',
+    [types_1.HttpStatus.MISDIRECTED]: 'Misdirected',
+    [types_1.HttpStatus.UNPROCESSABLE_ENTITY]: 'Unprocessable Entity',
+    [types_1.HttpStatus.FAILED_DEPENDENCY]: 'Failed Dependency',
+    [types_1.HttpStatus.PRECONDITION_REQUIRED]: 'Precondition Required',
+    [types_1.HttpStatus.TOO_MANY_REQUESTS]: 'Too Many Requests',
+    [types_1.HttpStatus.INTERNAL_SERVER_ERROR]: 'Internal Server Error',
+    [types_1.HttpStatus.NOT_IMPLEMENTED]: 'Not Implemented',
+    [types_1.HttpStatus.BAD_GATEWAY]: 'Bad Gateway',
+    [types_1.HttpStatus.SERVICE_UNAVAILABLE]: 'Service Unavailable',
+    [types_1.HttpStatus.GATEWAY_TIMEOUT]: 'Gateway Timeout',
+    [types_1.HttpStatus.HTTP_VERSION_NOT_SUPPORTED]: 'HTTP Version Not Supported',
+};
+exports.error = (0, createDecorator_1.createDecorator)(null, (status, message) => {
+    return (handlerSchema) => {
+        return {
+            ...handlerSchema,
+            openapi: {
+                ...handlerSchema?.openapi,
+                responses: {
+                    ...handlerSchema?.openapi?.responses,
+                    [status]: {
+                        description: `${status} ${statusDisplayText[status]}`,
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    allOf: [
+                                        {
+                                            $ref: '#/components/schemas/VovkErrorResponse',
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                message: {
+                                                    type: 'string',
+                                                    enum: [
+                                                        message,
+                                                        ...(handlerSchema?.openapi?.responses?.[status]?.content?.['application/json']?.schema
+                                                            ?.allOf?.[1]?.properties?.message?.enum ?? []),
+                                                    ],
+                                                },
+                                                statusCode: {
+                                                    type: 'integer',
+                                                    enum: [status],
+                                                },
+                                            },
+                                        },
+                                    ],
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        };
+    };
+});

package/cjs/openapi/generateFnName.d.ts

@@ -0,0 +1,23 @@
+import { HttpMethod } from '../types';
+export interface VerbMapEntry {
+    noParams?: string;
+    withParams?: string;
+    default?: string;
+}
+export declare const VERB_MAP: Record<HttpMethod, VerbMapEntry>;
+export declare function capitalize(str: string): string;
+interface GenerateFnNameOptions {
+    /** Segments to strip out (e.g. ['api','v1']) */
+    ignoreSegments?: string[];
+}
+/**
+ * Turn an HTTP method + OpenAPI path into a camelCased function name.
+ *
+ * Examples:
+ *   generateFnName('GET', '/users')                     // "listUsers"
+ *   generateFnName('GET', '/users/{id}')                // "getUsersById"
+ *   generateFnName('POST', '/v1/api/orders')            // "createOrders"
+ *   generateFnName('PATCH', '/users/{userId}/profile')  // "patchUsersProfileByUserId"
+ */
+export declare function generateFnName(method: HttpMethod, rawPath: string, opts?: GenerateFnNameOptions): string;
+export {};

package/cjs/openapi/generateFnName.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERB_MAP = void 0;
+exports.capitalize = capitalize;
+exports.generateFnName = generateFnName;
+exports.VERB_MAP = {
+    GET: { noParams: 'list', withParams: 'get' },
+    POST: { default: 'create' },
+    PUT: { default: 'update' },
+    PATCH: { default: 'patch' },
+    DELETE: { default: 'delete' },
+    HEAD: { default: 'head' },
+    OPTIONS: { default: 'options' },
+};
+function capitalize(str) {
+    if (str.length === 0)
+        return '';
+    return str[0].toUpperCase() + str.slice(1);
+}
+const DEFAULT_OPTIONS = {
+    ignoreSegments: ['api'],
+};
+/**
+ * Turn an HTTP method + OpenAPI path into a camelCased function name.
+ *
+ * Examples:
+ *   generateFnName('GET', '/users')                     // "listUsers"
+ *   generateFnName('GET', '/users/{id}')                // "getUsersById"
+ *   generateFnName('POST', '/v1/api/orders')            // "createOrders"
+ *   generateFnName('PATCH', '/users/{userId}/profile')  // "patchUsersProfileByUserId"
+ */
+function generateFnName(method, rawPath, opts = {}) {
+    const { ignoreSegments } = {
+        ...DEFAULT_OPTIONS,
+        ...opts,
+    };
+    // 1. Clean & split path
+    const parts = rawPath
+        .replace(/^\/|\/$/g, '') // strip leading/trailing slash
+        .split('/')
+        .filter((seg) => !ignoreSegments?.includes(seg.toLowerCase()))
+        .filter(Boolean);
+    // 2. Separate resource tokens from path-params
+    const resources = [];
+    const params = [];
+    parts.forEach((seg) => {
+        const match = seg.match(/^{?([^}]+)}?$/);
+        if (match) {
+            params.push(match[1]);
+        }
+        else {
+            resources.push(seg);
+        }
+    });
+    // 3. Pick base verb from VERB_MAP
+    let baseVerb;
+    if (method === 'GET') {
+        baseVerb = params.length ? exports.VERB_MAP.GET.withParams : exports.VERB_MAP.GET.noParams;
+    }
+    else {
+        baseVerb = exports.VERB_MAP[method].default;
+    }
+    // 4. Build the “resource” part
+    const resourcePart = resources.map(capitalize).join('');
+    // 5. Build the “ByParam” suffix
+    const byParams = params.length ? 'By' + params.map(capitalize).join('') : '';
+    // 6. Combine and ensure camelCase
+    const rawName = `${baseVerb}${resourcePart}${byParams}`;
+    return rawName[0].toLowerCase() + rawName.slice(1);
+}
+/*
+// --- Example usage ---
+console.log(generateFnName('GET', '/users')); // listUsers
+console.log(generateFnName('GET', '/users/{id}')); // getUsersById
+console.log(generateFnName('POST', '/users')); // createUsers
+console.log(generateFnName('PATCH', '/users/{userId}/profile')); // patchUsersProfileByUserId
+console.log(generateFnName('DELETE', '/v1/api/orders/{orderId}')); // deleteOrdersByOrderId
+
+// You can also enable singularization:
+console.log(generateFnName('GET', '/users/{userId}/orders', { singularizeResources: true })); // getUserOrderByUserId
+*/

package/cjs/openapi/index.d.ts

@@ -0,0 +1,12 @@
+import type { OperationObject } from 'openapi3-ts/oas31';
+import { vovkSchemaToOpenAPI } from './vovkSchemaToOpenAPI';
+import { openAPIToVovkSchema } from './openAPIToVovkSchema';
+import type { KnownAny } from '../types';
+type OperationObjectWithCustomProperties = OperationObject & {
+    [key in `${'x' | 'X'}-${string}`]: KnownAny;
+};
+export declare const openapiDecorator: (openAPIOperationObject?: OperationObjectWithCustomProperties | undefined) => (target: KnownAny, propertyKey: string) => void;
+export declare const openapi: ((openAPIOperationObject?: OperationObjectWithCustomProperties | undefined) => (target: KnownAny, propertyKey: string) => void) & {
+    error: (status: import("../types").HttpStatus, message: string) => (target: KnownAny, propertyKey: string) => void;
+};
+export { vovkSchemaToOpenAPI, openAPIToVovkSchema };

package/cjs/openapi/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAPIToVovkSchema = exports.vovkSchemaToOpenAPI = exports.openapi = exports.openapiDecorator = void 0;
+const vovkSchemaToOpenAPI_1 = require("./vovkSchemaToOpenAPI");
+Object.defineProperty(exports, "vovkSchemaToOpenAPI", { enumerable: true, get: function () { return vovkSchemaToOpenAPI_1.vovkSchemaToOpenAPI; } });
+const openAPIToVovkSchema_1 = require("./openAPIToVovkSchema");
+Object.defineProperty(exports, "openAPIToVovkSchema", { enumerable: true, get: function () { return openAPIToVovkSchema_1.openAPIToVovkSchema; } });
+const error_1 = require("./error");
+const createDecorator_1 = require("../utils/createDecorator");
+exports.openapiDecorator = (0, createDecorator_1.createDecorator)(null, (openAPIOperationObject = {}) => {
+    return (handlerSchema) => {
+        return {
+            ...handlerSchema,
+            openapi: {
+                ...handlerSchema?.openapi,
+                ...openAPIOperationObject,
+            },
+        };
+    };
+});
+exports.openapi = Object.assign(exports.openapiDecorator, { error: error_1.error });

package/cjs/openapi/openAPIToVovkSchema/applyComponentsSchemas.d.ts

@@ -0,0 +1,3 @@
+import { ComponentsObject } from 'openapi3-ts/oas31';
+import { SimpleJSONSchema } from '../../types';
+export declare function applyComponentsSchemas(schema: SimpleJSONSchema, components: ComponentsObject['schemas'], mixinName: string): SimpleJSONSchema | SimpleJSONSchema[];

package/cjs/openapi/openAPIToVovkSchema/applyComponentsSchemas.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyComponentsSchemas = applyComponentsSchemas;
+const camelCase_1 = require("../../utils/camelCase");
+const upperFirst_1 = require("../../utils/upperFirst");
+// fast clone JSON object while ignoring Date, RegExp, and Function types
+function cloneJSON(obj) {
+    if (obj === null || typeof obj !== 'object')
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(cloneJSON);
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value instanceof Date || value instanceof RegExp || typeof value === 'function')
+            continue;
+        result[key] = cloneJSON(value);
+    }
+    return result;
+}
+function applyComponentsSchemas(schema, components, mixinName) {
+    const key = 'components/schemas';
+    if (!components || !Object.keys(components).length)
+        return schema;
+    // Create a deep copy of the schema
+    const result = cloneJSON(schema);
+    // Initialize $defs if it doesn't exist
+    result.$defs = result.$defs || {};
+    // Set to track components we've added to $defs
+    const addedComponents = new Set();
+    // Process a schema object and replace $refs
+    function processSchema(obj) {
+        if (!obj || typeof obj !== 'object')
+            return obj;
+        // Handle arrays first - they don't have $ref
+        if (Array.isArray(obj)) {
+            return obj.map((item) => processSchema(item));
+        }
+        // Now we know it's an object, so we can safely access $ref
+        const newObj = { ...obj };
+        const $ref = newObj.$ref;
+        if ($ref && typeof $ref === 'string' && $ref.startsWith(`#/${key}/`)) {
+            const componentName = $ref.replace(`#/${key}/`, '');
+            if (components[componentName]) {
+                newObj.$ref = `#/$defs/${componentName}`;
+                newObj['x-tsType'] ??= `Mixins.${(0, upperFirst_1.upperFirst)((0, camelCase_1.camelCase)(mixinName))}.${(0, upperFirst_1.upperFirst)((0, camelCase_1.camelCase)(componentName))}`;
+            }
+            else {
+                delete newObj.$ref; // Remove $ref if component not found (Telegram API has Type $refs that is not defined in components)
+            }
+            // Add the component to $defs if not already added
+            if (!addedComponents.has(componentName) && components[componentName]) {
+                addedComponents.add(componentName);
+                // TODO: Optimize
+                result.$defs[componentName] = processSchema(cloneJSON(components[componentName]));
+            }
+        }
+        // Process properties recursively
+        for (const key in newObj) {
+            if (Object.prototype.hasOwnProperty.call(newObj, key)) {
+                newObj[key] = processSchema(newObj[key]);
+            }
+        }
+        return newObj;
+    }
+    // Process the main schema
+    return processSchema(result);
+}

package/cjs/openapi/openAPIToVovkSchema/index.d.ts

@@ -0,0 +1,4 @@
+import { type VovkSchema, VovkStrictConfig } from '../../types';
+export declare function openAPIToVovkSchema({ apiRoot, source: { object: openAPIObject }, getModuleName, getMethodName, errorMessageKey, package: packageJson, mixinName, }: VovkStrictConfig['openApiMixins'][string] & {
+    mixinName: string;
+}): VovkSchema;

package/cjs/openapi/openAPIToVovkSchema/index.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAPIToVovkSchema = openAPIToVovkSchema;
+const types_1 = require("../../types");
+const generateFnName_1 = require("../generateFnName");
+const camelCase_1 = require("../../utils/camelCase");
+const applyComponentsSchemas_1 = require("./applyComponentsSchemas");
+const inlineRefs_1 = require("./inlineRefs");
+const getNamesNestJS = (operationObject) => {
+    const operationId = operationObject.operationId;
+    if (!operationId) {
+        throw new Error('Operation ID is required for NestJS module name generation');
+    }
+    const controllerHandlerMatch = operationId?.match(/^([A-Z][a-zA-Z0-9]*)_([a-zA-Z0-9_]+)/);
+    if (!controllerHandlerMatch) {
+        throw new Error(`Invalid operationId format for NestJS: ${operationId}`);
+    }
+    const [controllerName, handlerName] = controllerHandlerMatch.slice(1, 3);
+    return [controllerName.replace(/Controller$/, 'RPC'), handlerName];
+};
+const normalizeGetModuleName = (getModuleName) => {
+    if (getModuleName === 'nestjs-operation-id') {
+        getModuleName = ({ operationObject }) => getNamesNestJS(operationObject)[0];
+    }
+    else if (typeof getModuleName === 'string') {
+        const moduleName = getModuleName;
+        getModuleName = () => moduleName;
+    }
+    else if (typeof getModuleName !== 'function') {
+        throw new Error('getModuleName must be a function or one of the predefined strings');
+    }
+    return getModuleName;
+};
+const normalizeGetMethodName = (getMethodName) => {
+    if (getMethodName === 'nestjs-operation-id') {
+        getMethodName = ({ operationObject }) => getNamesNestJS(operationObject)[1];
+    }
+    else if (getMethodName === 'camel-case-operation-id') {
+        getMethodName = ({ operationObject }) => {
+            const operationId = operationObject.operationId;
+            if (!operationId) {
+                throw new Error('Operation ID is required for camel-case method name generation');
+            }
+            return (0, camelCase_1.camelCase)(operationId);
+        };
+    }
+    else if (getMethodName === 'auto') {
+        getMethodName = ({ operationObject, method, path }) => {
+            const operationId = operationObject.operationId;
+            const isCamelCase = operationId && /^[a-z][a-zA-Z0-9]*$/.test(operationId);
+            const isSnakeCase = operationId && /^[a-z][a-z0-9_]+$/.test(operationId);
+            return isCamelCase ? operationId : isSnakeCase ? (0, camelCase_1.camelCase)(operationId) : (0, generateFnName_1.generateFnName)(method, path);
+        };
+    }
+    else if (typeof getMethodName !== 'function') {
+        throw new Error('getMethodName must be a function or one of the predefined strings');
+    }
+    return getMethodName;
+};
+function openAPIToVovkSchema({ apiRoot, source: { object: openAPIObject }, getModuleName = 'api', getMethodName = 'auto', errorMessageKey, package: packageJson, mixinName, }) {
+    const forceApiRoot = apiRoot ??
+        openAPIObject.servers?.[0]?.url ??
+        ('host' in openAPIObject
+            ? `https://${openAPIObject.host}${'basePath' in openAPIObject ? openAPIObject.basePath : ''}`
+            : null);
+    if (!forceApiRoot) {
+        throw new Error('API root URL is required in OpenAPI configuration');
+    }
+    const schema = {
+        $schema: types_1.VovkSchemaIdEnum.SCHEMA,
+        segments: {
+            [mixinName]: {
+                $schema: types_1.VovkSchemaIdEnum.SEGMENT,
+                emitSchema: true,
+                segmentName: mixinName,
+                segmentType: 'mixin',
+                controllers: {},
+                meta: {
+                    components: openAPIObject.components,
+                    package: packageJson,
+                },
+            },
+        },
+    };
+    const segment = schema.segments[mixinName];
+    getModuleName = normalizeGetModuleName(getModuleName);
+    getMethodName = normalizeGetMethodName(getMethodName);
+    return Object.entries(openAPIObject.paths ?? {}).reduce((acc, [path, operations]) => {
+        Object.entries(operations ?? {})
+            .filter(([, operation]) => operation && typeof operation === 'object')
+            .forEach(([method, operation]) => {
+            const rpcModuleName = getModuleName({
+                method: method.toUpperCase(),
+                path,
+                openAPIObject,
+                operationObject: operation,
+            });
+            const handlerName = getMethodName({
+                method: method.toUpperCase(),
+                path,
+                openAPIObject,
+                operationObject: operation,
+            });
+            segment.controllers[rpcModuleName] ??= {
+                forceApiRoot,
+                rpcModuleName,
+                handlers: {},
+            };
+            const parameters = (0, inlineRefs_1.inlineRefs)(operation.parameters ?? [], openAPIObject);
+            const queryProperties = parameters.filter((p) => p.in === 'query') ?? null;
+            const pathProperties = parameters.filter((p) => p.in === 'path') ?? null;
+            const query = queryProperties?.length
+                ? {
+                    type: 'object',
+                    properties: Object.fromEntries(queryProperties.map((p) => [p.name, p.schema])),
+                    required: queryProperties.filter((p) => p.required).map((p) => p.name),
+                }
+                : null;
+            const params = pathProperties?.length
+                ? {
+                    type: 'object',
+                    properties: Object.fromEntries(pathProperties.map((p) => [p.name, p.schema])),
+                    required: pathProperties.filter((p) => p.required).map((p) => p.name),
+                }
+                : null;
+            // TODO: how to utilize ReferenceObject?
+            const requestBodyContent = (0, inlineRefs_1.inlineRefs)(operation.requestBody, openAPIObject)?.content ?? {};
+            const jsonBody = requestBodyContent['application/json']?.schema ?? null;
+            const formDataBody = requestBodyContent['multipart/form-data']?.schema ?? null;
+            let urlEncodedBody = requestBodyContent['application/x-www-form-urlencoded']?.schema ?? null;
+            if (formDataBody && urlEncodedBody && JSON.stringify(formDataBody) === JSON.stringify(urlEncodedBody)) {
+                urlEncodedBody = null; // Avoid duplication if both form-data and url-encoded bodies are the same
+            }
+            if (formDataBody) {
+                Object.assign(formDataBody, {
+                    'x-formData': true,
+                    'x-tsType': 'FormData',
+                });
+            }
+            if (urlEncodedBody) {
+                Object.assign(urlEncodedBody, {
+                    'x-formData': true,
+                    'x-tsType': 'FormData',
+                });
+            }
+            const bodySchemas = [jsonBody, formDataBody, urlEncodedBody].filter(Boolean);
+            const body = !bodySchemas.length
+                ? null
+                : bodySchemas.length === 1
+                    ? bodySchemas[0]
+                    : {
+                        anyOf: bodySchemas,
+                    };
+            const output = operation.responses?.['200']?.content?.['application/json']?.schema ??
+                operation.responses?.['201']?.content?.['application/json']?.schema ??
+                null;
+            const iteration = operation.responses?.['200']?.content?.['application/jsonl']?.schema ??
+                operation.responses?.['201']?.content?.['application/jsonl']?.schema ??
+                operation.responses?.['200']?.content?.['application/jsonlines']?.schema ??
+                operation.responses?.['201']?.content?.['application/jsonlines']?.schema ??
+                null;
+            if (errorMessageKey) {
+                operation['x-errorMessageKey'] = errorMessageKey;
+            }
+            const componentsSchemas = openAPIObject.components?.schemas ??
+                ('definitions' in openAPIObject ? openAPIObject.definitions : {});
+            segment.controllers[rpcModuleName].handlers[handlerName] = {
+                httpMethod: method.toUpperCase(),
+                path,
+                openapi: operation,
+                validation: {
+                    ...(query && {
+                        query: (0, applyComponentsSchemas_1.applyComponentsSchemas)(query, componentsSchemas, mixinName),
+                    }),
+                    ...(params && {
+                        params: (0, applyComponentsSchemas_1.applyComponentsSchemas)(params, componentsSchemas, mixinName),
+                    }),
+                    ...(body && {
+                        body: (0, applyComponentsSchemas_1.applyComponentsSchemas)(body, componentsSchemas, mixinName),
+                    }),
+                    ...(output && {
+                        output: (0, applyComponentsSchemas_1.applyComponentsSchemas)(output, componentsSchemas, mixinName),
+                    }),
+                    ...(iteration && {
+                        iteration: (0, applyComponentsSchemas_1.applyComponentsSchemas)(iteration, componentsSchemas, mixinName),
+                    }),
+                },
+            };
+        });
+        return acc;
+    }, schema);
+}

package/cjs/openapi/openAPIToVovkSchema/inlineRefs.d.ts

@@ -0,0 +1,10 @@
+import { OpenAPIObject } from 'openapi3-ts/oas31';
+import { KnownAny } from '../../types';
+/**
+ * Resolves $ref references at the first level only (except for components/schemas references)
+ * For arrays, checks each item at the first level
+ * @param obj - The object to process (may contain $ref properties)
+ * @param openAPIObject - The complete OpenAPI document containing definitions
+ * @returns The object with resolved references (except components/schemas)
+ */
+export declare function inlineRefs<T extends object>(obj: KnownAny, openAPIObject: OpenAPIObject): T;