vovk 3.0.0-draft.46 → 3.0.0-draft.461

package/cjs/utils/createCodeSamples.js

@@ -0,0 +1,279 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCodeSamples = createCodeSamples;
+const getJSONSchemaExample_1 = require("./getJSONSchemaExample");
+const getSampleFromObject_1 = require("./getSampleFromObject");
+const toSnakeCase = (str) => str
+    .replace(/-/g, '_') // Replace hyphens with underscores
+    .replace(/([a-z0-9])([A-Z])/g, '$1_$2') // Add underscore between lowercase/digit and uppercase
+    .replace(/([A-Z])([A-Z])(?=[a-z])/g, '$1_$2') // Add underscore between uppercase letters if the second one is followed by a lowercase
+    .toLowerCase()
+    .replace(/^_/, ''); // Remove leading underscore
+const getIndentSpaces = (level) => ' '.repeat(level);
+function isTextFormat(mimeType) {
+    if (!mimeType)
+        return false;
+    return (mimeType.startsWith('text/') ||
+        [
+            'application/json',
+            'application/ld+json',
+            'application/xml',
+            'application/xhtml+xml',
+            'application/javascript',
+            'application/typescript',
+            'application/yaml',
+            'application/x-yaml',
+            'application/toml',
+            'application/sql',
+            'application/graphql',
+            'application/x-www-form-urlencoded',
+        ].includes(mimeType) ||
+        mimeType.endsWith('+json') ||
+        mimeType.endsWith('+xml'));
+}
+function generateTypeScriptCode({ handlerName, rpcName, packageName, queryValidation, bodyValidation, paramsValidation, outputValidation, iterationValidation, hasArg, config, }) {
+    const getTsSample = (schema, indent) => (0, getJSONSchemaExample_1.getJSONSchemaExample)(schema, { stripQuotes: true, indent: indent ?? 4 });
+    const getTsFormSample = (schema) => {
+        let formSample = '\nconst formData = new FormData();';
+        for (const [key, prop] of Object.entries(schema.properties || {})) {
+            const target = prop.oneOf?.[0] || prop.anyOf?.[0] || prop.allOf?.[0] || prop;
+            const desc = target.description ?? prop.description ?? undefined;
+            if (target.type === 'array' && target.items) {
+                formSample += getTsFormAppend(target.items, key, desc);
+                formSample += getTsFormAppend(target.items, key, desc);
+            }
+            else {
+                formSample += getTsFormAppend(target, key, desc);
+            }
+        }
+        return formSample;
+    };
+    const getTsFormAppend = (schema, key, description) => {
+        let sampleValue;
+        if (schema.type === 'string' && schema.format === 'binary') {
+            sampleValue = `new Blob(${isTextFormat(schema.contentMediaType) ? '["text_content"]' : '[binary_data]'}${schema.contentMediaType ? `, { type: "${schema.contentMediaType}" }` : ''})`;
+        }
+        else if (schema.type === 'object') {
+            sampleValue = '"object_unknown"';
+        }
+        else {
+            sampleValue = `"${(0, getJSONSchemaExample_1.getSampleValue)(schema)}"`;
+        }
+        const desc = schema.description ?? description;
+        return `\n${desc ? `// ${desc}\n` : ''}formData.append("${key}", ${sampleValue});`;
+    };
+    const tsArgs = hasArg
+        ? `{
+${[
+            bodyValidation ? `    body: ${bodyValidation['x-isForm'] ? 'formData' : getTsSample(bodyValidation)},` : null,
+            queryValidation ? `    query: ${getTsSample(queryValidation)},` : null,
+            paramsValidation ? `    params: ${getTsSample(paramsValidation)},` : null,
+            config?.apiRoot ? `    apiRoot: '${config.apiRoot}',` : null,
+            config?.headers
+                ? `    init: {
+      headers: ${(0, getSampleFromObject_1.getSampleFromObject)(config.headers, { stripQuotes: true, indent: 6, nestingIndent: 4 })}
+    },`
+                : null,
+        ]
+            .filter(Boolean)
+            .join('\n')}
+}`
+        : '';
+    const TS_CODE = `import { ${rpcName} } from '${packageName}';
+${bodyValidation?.['x-isForm'] ? getTsFormSample(bodyValidation) + '\n' : ''}
+${iterationValidation ? 'using' : 'const'} response = await ${rpcName}.${handlerName}(${tsArgs});
+${outputValidation
+        ? `
+console.log(response); 
+/* 
+${getTsSample(outputValidation, 0)}
+*/`
+        : ''}${iterationValidation
+        ? `
+for await (const item of response) {
+    console.log(item); 
+    /*
+    ${getTsSample(iterationValidation)}
+    */
+}`
+        : ''}`;
+    return TS_CODE.trim();
+}
+function generatePythonCode({ handlerName, rpcName, packageName, queryValidation, bodyValidation, paramsValidation, outputValidation, iterationValidation, hasArg, config, }) {
+    const getPySample = (schema, indent) => (0, getJSONSchemaExample_1.getJSONSchemaExample)(schema, {
+        stripQuotes: false,
+        indent: indent ?? 4,
+        comment: '#',
+        ignoreBinary: true,
+        nestingIndent: 4,
+    });
+    const handlerNameSnake = toSnakeCase(handlerName);
+    const getFileTouple = (schema) => {
+        return `('name.ext', BytesIO(${isTextFormat(schema.contentMediaType) ? '"text_content".encode("utf-8")' : 'binary_data'})${schema.contentMediaType ? `, "${schema.contentMediaType}"` : ''})`;
+    };
+    const getPyFiles = (schema) => {
+        return Object.entries(schema.properties ?? {}).reduce((acc, [key, prop]) => {
+            const target = prop.oneOf?.[0] || prop.anyOf?.[0] || prop.allOf?.[0] || prop;
+            const desc = target.description ?? prop.description ?? undefined;
+            if (target.type === 'string' && target.format === 'binary') {
+                acc.push(`${desc ? `${getIndentSpaces(8)}# ${desc}\n` : ''}${getIndentSpaces(8)}('${key}', ${getFileTouple(target)})`);
+            }
+            else if (target.type === 'array' && target.items?.format === 'binary') {
+                const val = `${desc ? `${getIndentSpaces(8)}# ${desc}\n` : ''}${getIndentSpaces(8)}('${key}', ${getFileTouple(target.items)})`;
+                acc.push(val, val);
+            }
+            return acc;
+        }, []);
+    };
+    const pyFiles = bodyValidation ? getPyFiles(bodyValidation) : null;
+    const pyFilesArg = pyFiles?.length
+        ? `${getIndentSpaces(4)}files=[\n${pyFiles.join(',\n')}\n${getIndentSpaces(4)}],`
+        : null;
+    const PY_CODE = `from ${packageName} import ${rpcName}
+${bodyValidation?.['x-isForm'] ? 'from io import BytesIO\n' : ''}
+response = ${rpcName}.${handlerNameSnake}(${hasArg
+        ? '\n' +
+            [
+                bodyValidation ? `    body=${getPySample(bodyValidation)},` : null,
+                pyFilesArg,
+                queryValidation ? `    query=${getPySample(queryValidation)},` : null,
+                paramsValidation ? `    params=${getPySample(paramsValidation)},` : null,
+                config?.apiRoot ? `    api_root="${config.apiRoot}",` : null,
+                config?.headers
+                    ? `    headers=${(0, getSampleFromObject_1.getSampleFromObject)(config.headers, { stripQuotes: false, indent: 4, nestingIndent: 4 })},`
+                    : null,
+            ]
+                .filter(Boolean)
+                .join('\n') +
+            '\n'
+        : ''})
+
+${outputValidation ? `print(response)\n${getPySample(outputValidation, 0)}` : ''}${iterationValidation
+        ? `for i, item in enumerate(response):
+    print(f"iteration #{i}:\\n {item}")
+    # iteration #0:
+    ${getPySample(iterationValidation)}`
+        : ''}`;
+    return PY_CODE.trim();
+}
+function generateRustCode({ handlerName, rpcName, packageName, queryValidation, bodyValidation, paramsValidation, outputValidation, iterationValidation, config, }) {
+    const getRsJSONSample = (schema, indent) => (0, getJSONSchemaExample_1.getJSONSchemaExample)(schema, { stripQuotes: false, indent: indent ?? 4 });
+    const getRsOutputSample = (schema, indent) => (0, getJSONSchemaExample_1.getJSONSchemaExample)(schema, { stripQuotes: true, indent: indent ?? 4 });
+    const getRsFormSample = (schema) => {
+        let formSample = 'let form = multipart::Form::new()';
+        for (const [key, prop] of Object.entries(schema.properties || {})) {
+            const target = prop.oneOf?.[0] || prop.anyOf?.[0] || prop.allOf?.[0] || prop;
+            const desc = target.description ?? prop.description ?? undefined;
+            if (target.type === 'array' && target.items) {
+                formSample += getRsFormPart(target.items, key, desc);
+                formSample += getRsFormPart(target.items, key, desc);
+            }
+            else {
+                formSample += getRsFormPart(target, key, desc);
+            }
+        }
+        return formSample;
+    };
+    const getRsFormPart = (schema, key, description) => {
+        let sampleValue;
+        if (schema.type === 'string' && schema.format === 'binary') {
+            sampleValue = isTextFormat(schema.contentMediaType)
+                ? 'multipart::Part::text("text_content")'
+                : 'multipart::Part::bytes(binary_data)';
+            if (schema.contentMediaType) {
+                sampleValue += `.mime_str("${schema.contentMediaType}").unwrap()`;
+            }
+        }
+        else if (schema.type === 'object') {
+            sampleValue = '"object_unknown"';
+        }
+        else {
+            sampleValue = `"${(0, getJSONSchemaExample_1.getSampleValue)(schema)}"`;
+        }
+        const desc = schema.description ?? description;
+        return `\n${getIndentSpaces(4)}${desc ? `// ${desc}\n` : ''}${getIndentSpaces(4)}.part("${key}", ${sampleValue});`;
+    };
+    const getHashMapSample = (map, indent = 4) => {
+        const entries = Object.entries(map)
+            .map(([key, value]) => {
+            return `${getIndentSpaces(indent + 2)}("${key}".to_string(), "${value}".to_string())`;
+        })
+            .join(',\n');
+        return `Some(&HashMap::from([\n${entries}\n${getIndentSpaces(4)}]))`;
+    };
+    const getBody = (schema) => {
+        if (schema['x-isForm']) {
+            return 'form';
+        }
+        return serdeUnwrap(getRsJSONSample(schema));
+    };
+    const handlerNameSnake = toSnakeCase(handlerName);
+    const rpcNameSnake = toSnakeCase(rpcName);
+    const serdeUnwrap = (fake) => `from_value(json!(${fake})).unwrap()`;
+    const RS_CODE = `use ${packageName}::${rpcNameSnake};
+use serde_json::{ 
+  from_value, 
+  json 
+};
+${bodyValidation?.['x-isForm'] ? `use multipart;\n` : ''}
+pub fn main() {${bodyValidation?.['x-isForm'] ? '\n  ' + getRsFormSample(bodyValidation) + '\n' : ''}
+  let response = ${rpcNameSnake}::${handlerNameSnake}(
+    ${bodyValidation ? getBody(bodyValidation) : '()'}, /* body */ 
+    ${queryValidation ? serdeUnwrap(getRsJSONSample(queryValidation)) : '()'}, /* query */ 
+    ${paramsValidation ? serdeUnwrap(getRsJSONSample(paramsValidation)) : '()'}, /* params */ 
+    ${config?.headers ? `${getHashMapSample(config.headers)}, /* headers */` : 'None, /* headers (HashMap) */ '}
+    ${config?.apiRoot ? `"${config.apiRoot}".to_string(), /* api_root */` : 'None, /* api_root */'}
+    false, /* disable_client_validation */
+  );${outputValidation
+        ? `\n\nmatch response {
+    Ok(output) => println!("{:?}", output),
+    /* 
+    output ${getRsOutputSample(outputValidation)} 
+    */
+    Err(e) => println!("error: {:?}", e),
+  }`
+        : ''}${iterationValidation
+        ? `\n\nmatch response {
+    Ok(stream) => {
+      for (i, item) in stream.enumerate() {
+        println!("#{}: {:?}", i, item);
+        /*
+        #0: iteration ${getRsOutputSample(iterationValidation, 8)}
+        */
+      }
+    },
+    Err(e) => println!("Error initiating stream: {:?}", e),
+  }`
+        : ''}
+}`;
+    return RS_CODE.trim();
+}
+function createCodeSamples({ handlerName, handlerSchema, controllerSchema, package: packageJson, config, }) {
+    const queryValidation = handlerSchema?.validation?.query;
+    const bodyValidation = handlerSchema?.validation?.body;
+    const paramsValidation = handlerSchema?.validation?.params;
+    const outputValidation = handlerSchema?.validation?.output;
+    const iterationValidation = handlerSchema?.validation?.iteration;
+    const hasArg = !!queryValidation || !!bodyValidation || !!paramsValidation || !!config?.apiRoot || !!config?.headers;
+    const rpcName = controllerSchema.rpcModuleName;
+    const packageName = packageJson?.name || 'vovk-client';
+    const packageNameSnake = toSnakeCase(packageName);
+    const pyPackageName = packageJson?.py_name ?? packageNameSnake;
+    const rsPackageName = packageJson?.rs_name ?? packageNameSnake;
+    const commonParams = {
+        handlerName,
+        rpcName,
+        packageName,
+        queryValidation,
+        bodyValidation,
+        paramsValidation,
+        outputValidation,
+        iterationValidation,
+        hasArg,
+        config,
+    };
+    const ts = generateTypeScriptCode(commonParams);
+    const py = generatePythonCode({ ...commonParams, packageName: pyPackageName });
+    const rs = generateRustCode({ ...commonParams, packageName: rsPackageName });
+    return { ts, py, rs };
+}

package/cjs/utils/createDecorator.d.ts

@@ -0,0 +1,6 @@
+import type { VovkHandlerSchema, KnownAny, VovkController, VovkRequest } from '../types';
+type Next = () => Promise<unknown>;
+export declare function createDecorator<TArgs extends unknown[], TRequest = VovkRequest>(handler: null | ((this: VovkController, req: TRequest, next: Next, ...args: TArgs) => unknown), initHandler?: (this: VovkController, ...args: TArgs) => Omit<VovkHandlerSchema, 'path' | 'httpMethod'> | ((handlerSchema: VovkHandlerSchema | null, options: {
+    handlerName: string;
+}) => Omit<Partial<VovkHandlerSchema>, 'path' | 'httpMethod'>) | null | undefined): (...args: TArgs) => (target: KnownAny, propertyKey: string) => void;
+export {};

package/{createDecorator.js → cjs/utils/createDecorator.js}

@@ -10,29 +10,39 @@ function createDecorator(handler, initHandler) {
                 throw new Error(`Unable to decorate: ${propertyKey} is not a function`);
             }
             const sourceMethod = originalMethod._sourceMethod ?? originalMethod;
-            const handlerSchema = controller._handlers?.[propertyKey] ?? null;
-            const initResultReturn = initHandler?.call(controller, ...args);
-            const initResult = typeof initResultReturn === 'function' ? initResultReturn(handlerSchema) : initResultReturn;
-            controller._handlers = {
-                ...controller._handlers,
-                [propertyKey]: {
-                    ...handlerSchema,
-                    // avoid override of path and httpMethod
-                    ...(initResult?.validation ? { validation: initResult.validation } : {}),
-                    ...(initResult?.custom ? { custom: initResult.custom } : {}),
-                },
-            };
             const method = function method(req, params) {
                 const next = async () => {
                     return (await originalMethod.call(controller, req, params));
                 };
                 return handler ? handler.call(controller, req, next, ...args) : next();
             };
+            controller[propertyKey] = method;
             method._controller = controller;
+            method._sourceMethod = sourceMethod;
+            method.fn = originalMethod.fn;
+            method.models = originalMethod.models;
+            sourceMethod.wrapper = method;
             // TODO define internal method type
             originalMethod._controller = controller;
-            controller[propertyKey] = method;
-            method._sourceMethod = sourceMethod;
+            const handlerSchema = controller._handlers?.[propertyKey] ?? null;
+            const initResultReturn = initHandler?.call(controller, ...args);
+            const initResult = typeof initResultReturn === 'function'
+                ? initResultReturn(handlerSchema, {
+                    handlerName: propertyKey,
+                })
+                : initResultReturn;
+            const methodSchema = {
+                ...handlerSchema,
+                // avoid override of path and httpMethod
+                ...(initResult?.validation ? { validation: initResult.validation } : {}),
+                ...(initResult?.operationObject ? { operationObject: initResult.operationObject } : {}),
+                ...(initResult?.misc ? { misc: initResult.misc } : {}),
+            };
+            method.schema = methodSchema;
+            controller._handlers = {
+                ...controller._handlers,
+                [propertyKey]: methodSchema,
+            };
         };
     };
 }

package/cjs/utils/createLLMTools.d.ts

@@ -0,0 +1,50 @@
+import type { KnownAny, VovkHandlerSchema, VovkLLMTool, VovkBasicJSONSchema } from '../types';
+type Handler = ((...args: KnownAny[]) => KnownAny) & {
+    fn?: (input: KnownAny) => KnownAny;
+    isRPC?: boolean;
+    schema?: VovkHandlerSchema;
+    models?: {
+        body?: VovkBasicJSONSchema;
+        query?: VovkBasicJSONSchema;
+        params?: VovkBasicJSONSchema;
+        output?: VovkBasicJSONSchema;
+        iteration?: VovkBasicJSONSchema;
+    };
+};
+type CallerInput = {
+    handler: Handler;
+    body: KnownAny;
+    query: KnownAny;
+    params: KnownAny;
+    schema: VovkHandlerSchema;
+    models: {
+        body?: KnownAny;
+        query?: KnownAny;
+        params?: KnownAny;
+        output?: KnownAny;
+        iteration?: KnownAny;
+    } | undefined;
+    init: RequestInit | undefined;
+    apiRoot: string | undefined;
+    meta: Record<string, KnownAny> | undefined;
+    handlerName: string;
+    moduleName: string;
+    resultFormatter: typeof defaultResultFormatter;
+};
+declare function defaultCaller({ handler, body, query, params, init, meta, resultFormatter, schema }: CallerInput, _options: KnownAny): Promise<[any, null] | [any, Error]>;
+declare function defaultResultFormatter(result: KnownAny, _schema: VovkHandlerSchema): Promise<any>;
+export declare function createLLMTools({ modules, caller, meta, resultFormatter, onExecute, onError, }: {
+    modules: Record<string, object | [object, {
+        init?: RequestInit;
+        apiRoot?: string;
+    }]>;
+    caller?: typeof defaultCaller;
+    meta?: Record<string, KnownAny>;
+    resultFormatter?: typeof defaultResultFormatter | null | 'mcp';
+    onExecute?: (result: KnownAny, callerInput: CallerInput, options: KnownAny) => void;
+    onError?: (error: Error, callerInput: CallerInput, options: KnownAny) => void;
+}): {
+    tools: VovkLLMTool[];
+    toolsByName: Record<string, VovkLLMTool>;
+};
+export {};

package/cjs/utils/createLLMTools.js

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLLMTools = createLLMTools;
+const createLLMTool = ({ moduleName, handlerName, caller, module, init, apiRoot, meta, resultFormatter, onExecute, onError, }) => {
+    if (!module) {
+        throw new Error(`Module "${moduleName}" not found.`);
+    }
+    const handler = module[handlerName];
+    if (!handler) {
+        throw new Error(`Handler "${handlerName}" not found in module "${moduleName}".`);
+    }
+    const { schema, models } = handler;
+    if (!schema || !schema.operationObject) {
+        throw new Error(`Handler "${handlerName}" in module "${moduleName}" does not have a valid schema.`);
+    }
+    const execute = async (input, options) => {
+        const { body, query, params } = input;
+        const callerInput = {
+            schema,
+            models,
+            handler,
+            body,
+            query,
+            params,
+            init,
+            apiRoot,
+            meta,
+            handlerName,
+            moduleName,
+            resultFormatter,
+        };
+        const [result, error] = await caller(callerInput, options);
+        if (error) {
+            onError?.(error, callerInput, options);
+        }
+        else {
+            onExecute(result, callerInput, options);
+        }
+        return result;
+    };
+    const parametersProperties = {
+        ...(schema?.validation?.body
+            ? {
+                body: schema.validation.body,
+            }
+            : {}),
+        ...(schema?.validation?.query
+            ? {
+                query: schema.validation.query,
+            }
+            : {}),
+        ...(schema?.validation?.params
+            ? {
+                params: schema.validation.params,
+            }
+            : {}),
+    };
+    return {
+        type: 'function',
+        execute,
+        name: `${moduleName}_${handlerName}`,
+        description: schema.operationObject?.['x-tool-description'] ??
+            ([schema.operationObject?.summary ?? '', schema.operationObject?.description ?? ''].filter(Boolean).join('\n') ||
+                handlerName),
+        parameters: {
+            type: 'object',
+            properties: parametersProperties,
+            required: Object.keys(parametersProperties),
+            additionalProperties: false,
+        },
+        models,
+    };
+};
+async function defaultCaller({ handler, body, query, params, init, meta, resultFormatter, schema }, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_options) {
+    if (!handler.isRPC && !handler.fn) {
+        throw new Error('Handler is not a valid RPC or controller method');
+    }
+    try {
+        let result;
+        if (handler.isRPC) {
+            result = await handler({
+                handler,
+                body,
+                query,
+                params,
+                init,
+                meta,
+            });
+        }
+        if (handler.fn) {
+            result = await handler.fn({
+                body,
+                query,
+                params,
+                meta,
+            });
+        }
+        return [resultFormatter(result, schema), null];
+    }
+    catch (e) {
+        return [resultFormatter(e, schema), e];
+    }
+}
+async function mcpResultFormatter(result, schema) {
+    const successMessage = schema?.operationObject?.['x-tool-successMessage'] ?? 'Tool executed successfully.';
+    const errorMessage = schema?.operationObject?.['x-tool-errorMessage'] ?? 'An error occurred while executing the tool.';
+    const includeResponse = schema?.operationObject?.['x-tool-includeResponse'] ?? true;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    result instanceof Error ? errorMessage : successMessage,
+                    includeResponse
+                        ? `${result instanceof Error ? 'Error' : 'Result'}:\n${JSON.stringify(result, null, 2)}`
+                        : null,
+                ]
+                    .filter(Boolean)
+                    .join('\n\n'),
+            },
+        ],
+    };
+}
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+async function defaultResultFormatter(result, _schema) {
+    return result;
+}
+function createLLMTools({ modules, caller = defaultCaller, meta, resultFormatter, onExecute = (result) => result, onError = () => { }, }) {
+    const moduleWithConfig = modules;
+    const tools = Object.entries(moduleWithConfig ?? {})
+        .map(([moduleName, moduleWithconfig]) => {
+        let init;
+        let apiRoot;
+        let module;
+        if (Array.isArray(moduleWithconfig)) {
+            [module, { init, apiRoot }] = moduleWithconfig;
+        }
+        else {
+            module = moduleWithconfig;
+        }
+        return Object.entries(module ?? {})
+            .filter(([, handler]) => handler?.schema?.operationObject && !handler?.schema?.operationObject?.['x-tool-disable'])
+            .map(([handlerName]) => createLLMTool({
+            moduleName,
+            handlerName,
+            caller,
+            module,
+            init,
+            apiRoot,
+            meta,
+            resultFormatter: resultFormatter
+                ? resultFormatter === 'mcp'
+                    ? mcpResultFormatter
+                    : resultFormatter
+                : defaultResultFormatter,
+            onExecute,
+            onError,
+        }));
+    })
+        .flat();
+    const toolsByName = Object.fromEntries(tools.map((tool) => [tool.name, tool]));
+    return {
+        tools,
+        toolsByName,
+    };
+}

package/cjs/utils/createStandardValidation.d.ts

@@ -0,0 +1,83 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+import { type KnownAny, type VovkRequest, type VovkTypedMethod, type VovkValidationType, type VovkOperationObject } from '../types';
+export declare function createStandardValidation({ toJSONSchema, }: {
+    toJSONSchema: (model: KnownAny, meta: {
+        type: VovkValidationType;
+    }) => KnownAny;
+}): <T extends (req: REQ, params: TParams extends StandardSchemaV1 ? StandardSchemaV1.InferOutput<TParams> : Record<string, string>) => KnownAny, TBody extends StandardSchemaV1, TQuery extends StandardSchemaV1, TParams extends StandardSchemaV1, OUTPUT extends StandardSchemaV1, ITERATION extends StandardSchemaV1, REQ extends VovkRequest<KnownAny, KnownAny, KnownAny> = VovkRequest<TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : undefined, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : undefined, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : undefined>, IS_FORM extends boolean = false>({ isForm, body, query, params, output, iteration, handle, disableServerSideValidation, skipSchemaEmission, validateEachIteration, preferTransformed, operationObject, }: {
+    isForm?: IS_FORM;
+    body?: TBody;
+    query?: TQuery;
+    params?: TParams;
+    output?: OUTPUT;
+    iteration?: ITERATION;
+    handle: T;
+    disableServerSideValidation?: boolean | VovkValidationType[];
+    skipSchemaEmission?: boolean | VovkValidationType[];
+    validateEachIteration?: boolean;
+    preferTransformed?: boolean;
+    operationObject?: VovkOperationObject;
+}) => T & {
+    __types: {
+        body: TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any;
+        query: TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any;
+        params: TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any;
+        output: OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any;
+        iteration: ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any;
+        isForm: IS_FORM;
+    };
+    isRPC?: boolean;
+} & {
+    schema: Omit<import("../types").VovkHandlerSchema, "httpMethod" | "path"> & Partial<import("../types").VovkHandlerSchema>;
+    wrapper?: ((req: VovkRequest<any, any, any>, params: Parameters<VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>>[1]) => ReturnType<VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>>) | undefined;
+} & {
+    fn: {
+        <RETURN_TYPE = ReturnType<VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>>>(input?: ((undefined extends TBody | undefined ? undefined extends TQuery | undefined ? undefined extends TParams | undefined ? true : false : false : false) extends true ? {
+            disableClientValidation?: boolean;
+        } & (undefined extends TBody | undefined ? {
+            body?: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["body"] | undefined;
+        } : {
+            body: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["body"];
+        }) & (undefined extends TQuery | undefined ? {
+            query?: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["query"] | undefined;
+        } : {
+            query: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["query"];
+        }) & (undefined extends TParams | undefined ? {
+            params?: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["params"] | undefined;
+        } : {
+            params: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["params"];
+        }) & {
+            meta?: {
+                [key: string]: any;
+                __disableClientValidation?: boolean;
+            };
+        } : never) | undefined): (undefined extends TBody | undefined ? undefined extends TQuery | undefined ? undefined extends TParams | undefined ? true : false : false : false) extends true ? RETURN_TYPE : never;
+        <RETURN_TYPE = ReturnType<VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>>>(input: {
+            disableClientValidation?: boolean;
+        } & (undefined extends TBody | undefined ? {
+            body?: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["body"] | undefined;
+        } : {
+            body: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["body"];
+        }) & (undefined extends TQuery | undefined ? {
+            query?: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["query"] | undefined;
+        } : {
+            query: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["query"];
+        }) & (undefined extends TParams | undefined ? {
+            params?: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["params"] | undefined;
+        } : {
+            params: VovkTypedMethod<T, TBody extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TBody> : any, TQuery extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TQuery> : any, TParams extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<TParams> : any, OUTPUT extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<OUTPUT> : any, ITERATION extends StandardSchemaV1<unknown, unknown> ? StandardSchemaV1.InferOutput<ITERATION> : any, IS_FORM>["__types"]["params"];
+        }) & {
+            meta?: {
+                [key: string]: any;
+                __disableClientValidation?: boolean;
+            };
+        }): RETURN_TYPE;
+    };
+    models: {
+        iteration?: (ITERATION & ({} | null)) | undefined;
+        output?: (OUTPUT & ({} | null)) | undefined;
+        params?: (TParams & ({} | null)) | undefined;
+        query?: (TQuery & ({} | null)) | undefined;
+        body?: (TBody & ({} | null)) | undefined;
+    };
+};