vovk 3.5.0 → 3.7.0

package/dist/validation/create-validate-on-client.js

@@ -0,0 +1,23 @@
+import { HttpException } from '../core/http-exception.js';
+import { HttpStatus } from '../types/enums.js';
+// types and enums required for client validation libs
+export { createValidateOnClient, HttpException, HttpStatus, };
+/**
+ * Creates a validation function for client-side input validation.
+ */
+function createValidateOnClient({ validate, }) {
+    const validateOnClient = async function validateOnClient(input, validation, meta) {
+        const newInput = { ...input };
+        if (input.body && validation.body) {
+            newInput.body = (await validate(input.body, validation.body, { ...meta, type: 'body' })) ?? input.body;
+        }
+        if (input.query && validation.query) {
+            newInput.query = (await validate(input.query, validation.query, { ...meta, type: 'query' })) ?? input.query;
+        }
+        if (input.params && validation.params) {
+            newInput.params = (await validate(input.params, validation.params, { ...meta, type: 'params' })) ?? input.params;
+        }
+        return newInput;
+    };
+    return validateOnClient;
+}

package/dist/validation/procedure.d.ts

@@ -141,8 +141,8 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema: CombinedSpec<TInput, TInput>;
@@ -151,13 +151,13 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: TInput, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput: TToModelOutput;
-        }): import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
+        }): import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
         <TInput, TOutput>(options: {
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema: CombinedSpec<TInput, TInput>;
@@ -166,13 +166,13 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: TInput, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput?: undefined;
-        }): import("../index.js").VovkTool<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>;
+        }): import("../index.js").VovkTool<TInput, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>;
         <TInput, TOutput, TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => import("../types/utils.js").KnownAny>(options: {
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema: CombinedSpec<TInput, TInput>;
@@ -181,13 +181,13 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: TInput, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput: TToModelOutput;
-        }): import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
+        }): import("../index.js").VovkTool<TInput, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
         <TInput, TOutput>(options: {
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<TInput, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema: CombinedSpec<TInput, TInput>;
@@ -196,13 +196,13 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: TInput, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput?: undefined;
-        }): import("../index.js").VovkTool<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>;
+        }): import("../index.js").VovkTool<TInput, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>;
         <TOutput, TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => import("../types/utils.js").KnownAny>(options: {
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema?: undefined;
@@ -211,13 +211,13 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: null, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput: TToModelOutput;
-        }): import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
+        }): import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
         <TOutput>(options: {
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema?: undefined;
@@ -226,13 +226,13 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: null, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput?: undefined;
-        }): import("../index.js").VovkTool<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>;
+        }): import("../index.js").VovkTool<null, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>;
         <TOutput, TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => import("../types/utils.js").KnownAny>(options: {
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema?: undefined;
@@ -241,13 +241,13 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: null, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput: TToModelOutput;
-        }): import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/toModelOutputDefault.js").ToModelOutputDefaultFn ? import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
+        }): import("../index.js").VovkTool<null, TOutput, TToModelOutput extends import("../tools/to-model-output-default.js").ToModelOutputDefaultFn ? import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput> : TToModelOutput extends (...args: import("../types/utils.js").KnownAny[]) => infer R ? R extends Promise<infer U> ? U : R : unknown>;
         <TOutput>(options: {
             name: string;
             title?: string;
             description: string;
-            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
-            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onExecute?: ((result: unknown, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../index.js").VovkTool<null, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>) => void) | undefined;
             target?: CombinedSpec.Target;
         } & {
             inputSchema?: undefined;
@@ -256,6 +256,6 @@ export declare const procedure: (<TBody extends CombinedSpec, TQuery extends Com
         } & {
             execute: (input: null, processingMeta?: import("../types/utils.js").KnownAny) => TOutput | Promise<TOutput>;
             toModelOutput?: undefined;
-        }): import("../index.js").VovkTool<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>;
+        }): import("../index.js").VovkTool<null, TOutput, import("../tools/to-model-output-default.js").DefaultModelOutput<TOutput>>;
     };
 };

package/dist/validation/procedure.js

@@ -1,4 +1,4 @@
-import { createStandardValidation } from './createStandardValidation.js';
+import { createStandardValidation } from './create-standard-validation.js';
 /**
  * Procedure function for defining validation schemas for API procedures.
  * @see https://vovk.dev/procedure

package/dist/validation/validation-schemas-object-to-single-validation-schema.d.ts

@@ -0,0 +1,17 @@
+import type { CombinedSpec } from '../types/validation.js';
+type SchemasObject = {
+    body?: CombinedSpec;
+    query?: CombinedSpec;
+    params?: CombinedSpec;
+};
+/**
+ * Combine optional `body` / `query` / `params` Standard Schemas into a single
+ * `CombinedSpec` whose `~standard` interface fully conforms to Standard Schema
+ * + Standard JSON Schema. Top-level validation (object shape, key presence,
+ * rejection of unknown keys) is handled here; per-slot value validation and
+ * JSON Schema conversion are delegated to the slot schemas.
+ *
+ * Internal helper. Not exported from the public `vovk` entrypoint.
+ */
+export declare function validationSchemasObjectToSingleValidationSchema<TSchemas extends SchemasObject>(schemas: TSchemas): CombinedSpec & TSchemas;
+export {};

package/dist/validation/validation-schemas-object-to-single-validation-schema.js

@@ -0,0 +1,92 @@
+const SLOT_KEYS = ['body', 'query', 'params'];
+function isThenable(value) {
+    return typeof value === 'object' && value !== null && typeof value.then === 'function';
+}
+function prefixIssues(issues, slot) {
+    return issues.map((issue) => ({
+        message: issue.message,
+        path: [{ key: slot }, ...(issue.path ?? [])],
+    }));
+}
+/**
+ * Combine optional `body` / `query` / `params` Standard Schemas into a single
+ * `CombinedSpec` whose `~standard` interface fully conforms to Standard Schema
+ * + Standard JSON Schema. Top-level validation (object shape, key presence,
+ * rejection of unknown keys) is handled here; per-slot value validation and
+ * JSON Schema conversion are delegated to the slot schemas.
+ *
+ * Internal helper. Not exported from the public `vovk` entrypoint.
+ */
+export function validationSchemasObjectToSingleValidationSchema(schemas) {
+    const definedSlots = SLOT_KEYS.filter((key) => schemas[key] !== undefined);
+    const definedSlotSet = new Set(definedSlots);
+    const validate = (input) => {
+        if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+            return { issues: [{ message: 'Expected object', path: [] }] };
+        }
+        const topLevelIssues = [];
+        const inputRecord = input;
+        for (const slot of definedSlots) {
+            if (!(slot in inputRecord)) {
+                topLevelIssues.push({ message: 'Required', path: [{ key: slot }] });
+            }
+        }
+        for (const key of Object.keys(inputRecord)) {
+            if (!definedSlotSet.has(key)) {
+                topLevelIssues.push({ message: 'Unexpected key', path: [{ key }] });
+            }
+        }
+        const pending = [];
+        for (const slot of definedSlots) {
+            if (slot in inputRecord) {
+                pending.push({ slot, result: schemas[slot]['~standard'].validate(inputRecord[slot]) });
+            }
+        }
+        const combine = (resolved) => {
+            const issues = [...topLevelIssues];
+            const value = {};
+            for (const { slot, result } of resolved) {
+                if (result.issues?.length) {
+                    issues.push(...prefixIssues(result.issues, slot));
+                }
+                else {
+                    value[slot] = result.value;
+                }
+            }
+            return issues.length > 0 ? { issues } : { value };
+        };
+        if (pending.some(({ result }) => isThenable(result))) {
+            return Promise.all(pending.map(async ({ slot, result }) => ({ slot, result: await result }))).then(combine);
+        }
+        return combine(pending);
+    };
+    const buildJSONSchema = (options, direction) => {
+        const properties = {};
+        for (const slot of definedSlots) {
+            properties[slot] = schemas[slot]['~standard'].jsonSchema?.[direction](options) ?? {};
+        }
+        return {
+            type: 'object',
+            properties,
+            required: [...definedSlots],
+            additionalProperties: false,
+        };
+    };
+    const standard = {
+        version: 1,
+        vendor: 'vovk',
+        validate,
+        jsonSchema: {
+            input: (options) => buildJSONSchema(options, 'input'),
+            output: (options) => buildJSONSchema(options, 'output'),
+        },
+    };
+    const result = { '~standard': standard };
+    if (schemas.body !== undefined)
+        result.body = schemas.body;
+    if (schemas.query !== undefined)
+        result.query = schemas.query;
+    if (schemas.params !== undefined)
+        result.params = schemas.params;
+    return result;
+}

package/dist/validation/with-validation-library.d.ts

@@ -0,0 +1,119 @@
+import type { VovkHandlerSchema, VovkValidationType } from '../types/core.js';
+import type { VovkRequest } from '../types/request.js';
+import type { BodyTypeFromContentType, ContentType, VovkTypedProcedure } from '../types/validation.js';
+import type { VovkOperationObject } from '../types/operation.js';
+import type { KnownAny } from '../types/utils.js';
+type VovkRequestAny = VovkRequest<KnownAny, KnownAny, KnownAny>;
+type Meta = {
+    __disableClientValidation?: boolean;
+    [key: string]: KnownAny;
+};
+export declare function withValidationLibrary<THandle extends VovkTypedProcedure<(req: KnownAny, params: KnownAny) => KnownAny, KnownAny, KnownAny, KnownAny, KnownAny, KnownAny, ContentType[]>, TBodyModel, TQueryModel, TParamsModel, TOutputModel, TIterationModel, TContentType extends ContentType[] = ['application/json']>({ contentType, disableServerSideValidation, skipSchemaEmission, validateEachIteration, body, query, params, output, iteration, handle, toJSONSchema, validate, preferTransformed, operationObject, }: {
+    contentType: TContentType | undefined;
+    disableServerSideValidation: boolean | VovkValidationType[] | undefined;
+    skipSchemaEmission: boolean | VovkValidationType[] | undefined;
+    validateEachIteration: boolean | undefined;
+    body: TBodyModel | undefined;
+    query: TQueryModel | undefined;
+    params: TParamsModel | undefined;
+    output: TOutputModel | undefined;
+    iteration: TIterationModel | undefined;
+    handle: THandle;
+    toJSONSchema: ((model: KnownAny, meta: {
+        validationType: VovkValidationType;
+    }) => KnownAny) | undefined;
+    validate: (data: unknown, model: NonNullable<TBodyModel | TQueryModel | TParamsModel | TOutputModel | TIterationModel>, meta: {
+        validationType: VovkValidationType;
+        req: VovkRequestAny;
+        status?: number;
+        i?: number;
+    }) => unknown;
+    preferTransformed: boolean | undefined;
+    operationObject: VovkOperationObject | undefined;
+}): THandle & {
+    schema: Omit<VovkHandlerSchema, "httpMethod" | "path"> & Partial<VovkHandlerSchema>;
+    wrapper?: (req: VovkRequestAny, params: Parameters<THandle>[1]) => ReturnType<THandle>;
+} & {
+    fn: {
+        <TTransformed>(input: Omit<{
+            disableClientValidation?: boolean;
+            transform?: undefined;
+        } & (undefined extends TBodyModel | undefined ? {
+            body?: BodyTypeFromContentType<TContentType, THandle["__types"]["body"]>;
+        } : {
+            body: BodyTypeFromContentType<TContentType, THandle["__types"]["body"]>;
+        }) & (undefined extends TQueryModel | undefined ? {
+            query?: THandle["__types"]["query"];
+        } : {
+            query: THandle["__types"]["query"];
+        }) & (undefined extends TParamsModel | undefined ? {
+            params?: THandle["__types"]["params"];
+        } : {
+            params: THandle["__types"]["params"];
+        }) & {
+            meta?: Meta;
+        }, "transform"> & {
+            transform: (result: Awaited<ReturnType<THandle>>, fakeReq: Pick<VovkRequestAny, "vovk">) => TTransformed;
+        }): Promise<TTransformed>;
+        <TReturnType = ReturnType<THandle>>(input?: {
+            disableClientValidation?: boolean;
+            transform?: undefined;
+        } & (undefined extends TBodyModel | undefined ? {
+            body?: BodyTypeFromContentType<TContentType, THandle["__types"]["body"]>;
+        } : {
+            body: BodyTypeFromContentType<TContentType, THandle["__types"]["body"]>;
+        }) & (undefined extends TQueryModel | undefined ? {
+            query?: THandle["__types"]["query"];
+        } : {
+            query: THandle["__types"]["query"];
+        }) & (undefined extends TParamsModel | undefined ? {
+            params?: THandle["__types"]["params"];
+        } : {
+            params: THandle["__types"]["params"];
+        }) & {
+            meta?: Meta;
+        }): TReturnType;
+        <TReturnType = ReturnType<THandle>>(input?: (undefined extends TBodyModel | undefined ? undefined extends TQueryModel | undefined ? undefined extends TParamsModel | undefined ? true : false : false : false) extends true ? {
+            disableClientValidation?: boolean;
+            transform?: undefined;
+        } & (undefined extends TBodyModel | undefined ? {
+            body?: BodyTypeFromContentType<TContentType, THandle["__types"]["body"]>;
+        } : {
+            body: BodyTypeFromContentType<TContentType, THandle["__types"]["body"]>;
+        }) & (undefined extends TQueryModel | undefined ? {
+            query?: THandle["__types"]["query"];
+        } : {
+            query: THandle["__types"]["query"];
+        }) & (undefined extends TParamsModel | undefined ? {
+            params?: THandle["__types"]["params"];
+        } : {
+            params: THandle["__types"]["params"];
+        }) & {
+            meta?: Meta;
+        } : never): (undefined extends TBodyModel | undefined ? undefined extends TQueryModel | undefined ? undefined extends TParamsModel | undefined ? true : false : false : false) extends true ? TReturnType : never;
+    };
+    definition: {
+        contentType: TContentType | undefined;
+        disableServerSideValidation: boolean | VovkValidationType[] | undefined;
+        skipSchemaEmission: boolean | VovkValidationType[] | undefined;
+        validateEachIteration: boolean | undefined;
+        body: TBodyModel | undefined;
+        query: TQueryModel | undefined;
+        params: TParamsModel | undefined;
+        output: TOutputModel | undefined;
+        iteration: TIterationModel | undefined;
+        handle: THandle;
+        toJSONSchema: ((model: KnownAny, meta: {
+            validationType: VovkValidationType;
+        }) => KnownAny) | undefined;
+        validate: (data: unknown, model: NonNullable<TBodyModel | TQueryModel | TParamsModel | TOutputModel | TIterationModel>, meta: {
+            validationType: VovkValidationType;
+            req: VovkRequestAny;
+            status?: number;
+            i?: number;
+        }) => unknown;
+        preferTransformed: boolean;
+        operationObject: VovkOperationObject | undefined;
+    };
+};
+export {};

package/dist/validation/with-validation-library.js

@@ -0,0 +1,184 @@
+import { HttpException } from '../core/http-exception.js';
+import { reqMeta } from '../req/req-meta.js';
+import { setHandlerSchema } from '../core/set-handler-schema.js';
+import { JSONLinesResponder } from '../core/json-lines-responder.js';
+import { HttpStatus } from '../types/enums.js';
+import { validateContentType } from '../req/validate-content-type.js';
+import { bufferBody } from '../req/buffer-body.js';
+import { parseForm } from '../req/parse-form.js';
+const validationTypes = ['body', 'query', 'params', 'output', 'iteration'];
+export function withValidationLibrary({ contentType, disableServerSideValidation, skipSchemaEmission, validateEachIteration, body, query, params, output, iteration, handle, toJSONSchema, validate, preferTransformed, operationObject, }) {
+    preferTransformed = preferTransformed ?? true;
+    const disableServerSideValidationKeys = disableServerSideValidation === false
+        ? []
+        : disableServerSideValidation === true
+            ? validationTypes
+            : (disableServerSideValidation ?? []);
+    const skipSchemaEmissionKeys = skipSchemaEmission === false ? [] : skipSchemaEmission === true ? validationTypes : (skipSchemaEmission ?? []);
+    const outputHandler = async (req, handlerParams) => {
+        const { __disableClientValidation } = req.vovk.meta();
+        const data = await handle(req, handlerParams);
+        if (__disableClientValidation) {
+            return data;
+        }
+        if (output && iteration) {
+            throw new HttpException(HttpStatus.INTERNAL_SERVER_ERROR, "Output and iteration are mutually exclusive. You can't use them together.");
+        }
+        if (output && !disableServerSideValidationKeys.includes('output')) {
+            if (!data) {
+                throw new HttpException(HttpStatus.INTERNAL_SERVER_ERROR, 'Output is required. You probably forgot to return something from your handler.');
+            }
+            const parsed = (await validate(data, output, { validationType: 'output', req })) ?? data;
+            return preferTransformed ? parsed : data;
+        }
+        if (iteration && !disableServerSideValidationKeys.includes('iteration')) {
+            // We assume `data` is an async iterable here; you might want to check that:
+            if (!data || (typeof data[Symbol.asyncIterator] !== 'function' && !(data instanceof JSONLinesResponder))) {
+                throw new HttpException(HttpStatus.INTERNAL_SERVER_ERROR, 'Data is not an async iterable, neither JSONLinesResponder but iteration validation is defined.');
+            }
+            if (data instanceof JSONLinesResponder) {
+                data.onBeforeSend = async (item, i) => {
+                    let parsed;
+                    if (validateEachIteration || i === 0) {
+                        parsed = (await validate(item, iteration, { validationType: 'iteration', req, status: 200, i })) ?? item;
+                    }
+                    else {
+                        parsed = item;
+                    }
+                    return preferTransformed ? parsed : item;
+                };
+                return data;
+            }
+            // Return a brand-new async generator that yields validated items
+            return (async function* () {
+                let i = 0;
+                for await (const item of data) {
+                    let parsed;
+                    if (validateEachIteration || i === 0) {
+                        parsed = (await validate(item, iteration, { validationType: 'iteration', req, status: 200, i })) ?? item;
+                    }
+                    else {
+                        parsed = item;
+                    }
+                    i++;
+                    yield preferTransformed ? parsed : item;
+                }
+            })();
+        }
+        else if (validateEachIteration) {
+            throw new HttpException(HttpStatus.INTERNAL_SERVER_ERROR, 'validateEachIteration is set but iteration is not defined.');
+        }
+        return data;
+    };
+    const resultHandler = (async (req, handlerParams) => {
+        const { __disableClientValidation } = req.vovk.meta();
+        if (!__disableClientValidation) {
+            if (body && !disableServerSideValidationKeys.includes('body')) {
+                if (typeof req.url === 'string')
+                    await bufferBody(req); // buffer the body to make it replayable for validation and actual parsing
+                validateContentType(req, contentType ?? ['application/json']);
+                const data = await req.vovk.body();
+                const parsed = (await validate(data, body, { validationType: 'body', req })) ?? data;
+                const instance = preferTransformed ? parsed : data;
+                req.vovk.body = () => Promise.resolve(instance);
+            }
+            if (query && !disableServerSideValidationKeys.includes('query')) {
+                const data = req.vovk.query();
+                const parsed = (await validate(data, query, { validationType: 'query', req })) ?? data;
+                const instance = preferTransformed ? parsed : data;
+                req.vovk.query = () => instance;
+            }
+            if (params && !disableServerSideValidationKeys.includes('params')) {
+                const data = req.vovk.params();
+                const parsed = (await validate(data, params, { validationType: 'params', req })) ?? data;
+                const instance = preferTransformed ? parsed : data;
+                req.vovk.params = () => instance;
+            }
+        }
+        return outputHandler(req, handlerParams);
+    });
+    function fn(input) {
+        let bodyCache;
+        const fakeReq = {
+            vovk: {
+                body: () => {
+                    if (input && input.body instanceof FormData) {
+                        bodyCache ??= parseForm(input.body);
+                    }
+                    else {
+                        bodyCache = input?.body;
+                    }
+                    return Promise.resolve(bodyCache ?? null);
+                },
+                query: () => input?.query ?? {},
+                params: () => input?.params ?? {},
+                meta: (meta) => reqMeta(fakeReq, meta),
+            },
+        };
+        fakeReq.vovk.meta({ __disableClientValidation: input?.disableClientValidation, ...input?.meta });
+        const result = (resultHandler.wrapper ?? resultHandler)(fakeReq, (input?.params ?? {}));
+        if (input && 'transform' in input && typeof input.transform === 'function') {
+            return Promise.resolve(result).then((resolvedResult) => input.transform(resolvedResult, fakeReq));
+        }
+        return result;
+    }
+    const definition = {
+        contentType,
+        disableServerSideValidation,
+        skipSchemaEmission,
+        validateEachIteration,
+        body,
+        query,
+        params,
+        output,
+        iteration,
+        handle,
+        toJSONSchema,
+        validate,
+        preferTransformed,
+        operationObject,
+    };
+    const resultHandlerEnhanced = Object.assign(resultHandler, { fn, definition });
+    const validation = {};
+    if (toJSONSchema) {
+        const getJSONSchema = (model, validationType) => Object.assign(toJSONSchema(model, { validationType }), validationType === 'body' ? { 'x-contentType': contentType } : {});
+        if (body && !skipSchemaEmissionKeys.includes('body')) {
+            let bodyJSONSchema;
+            Object.defineProperty(validation, 'body', {
+                enumerable: true,
+                get: () => (bodyJSONSchema ??= getJSONSchema(body, 'body')),
+            });
+        }
+        if (query && !skipSchemaEmissionKeys.includes('query')) {
+            let queryJSONSchema;
+            Object.defineProperty(validation, 'query', {
+                enumerable: true,
+                get: () => (queryJSONSchema ??= getJSONSchema(query, 'query')),
+            });
+        }
+        if (params && !skipSchemaEmissionKeys.includes('params')) {
+            let paramsJSONSchema;
+            Object.defineProperty(validation, 'params', {
+                enumerable: true,
+                get: () => (paramsJSONSchema ??= getJSONSchema(params, 'params')),
+            });
+        }
+        if (output && !skipSchemaEmissionKeys.includes('output')) {
+            let outputJSONSchema;
+            Object.defineProperty(validation, 'output', {
+                enumerable: true,
+                get: () => (outputJSONSchema ??= getJSONSchema(output, 'output')),
+            });
+        }
+        if (iteration && !skipSchemaEmissionKeys.includes('iteration')) {
+            let iterationJSONSchema;
+            Object.defineProperty(validation, 'iteration', {
+                enumerable: true,
+                get: () => (iterationJSONSchema ??= getJSONSchema(iteration, 'iteration')),
+            });
+        }
+    }
+    resultHandlerEnhanced.schema = { validation, operationObject };
+    setHandlerSchema(resultHandlerEnhanced, { validation, operationObject });
+    return resultHandlerEnhanced;
+}

package/package.json

@@ -7,7 +7,7 @@
   ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "version": "3.5.0",
+  "version": "3.7.0",
   "bin": {
     "vovk-cli-npx": "./bin/index.mjs"
   },
@@ -24,13 +24,21 @@
       "types": "./dist/client/fetcher.d.ts",
       "default": "./dist/client/fetcher.js"
     },
+    "./create-rpc": {
+      "types": "./dist/client/create-rpc.d.ts",
+      "default": "./dist/client/create-rpc.js"
+    },
+    "./create-validate-on-client": {
+      "types": "./dist/validation/create-validate-on-client.d.ts",
+      "default": "./dist/validation/create-validate-on-client.js"
+    },
     "./createRPC": {
-      "types": "./dist/client/createRPC.d.ts",
-      "default": "./dist/client/createRPC.js"
+      "types": "./dist/client/create-rpc.d.ts",
+      "default": "./dist/client/create-rpc.js"
     },
     "./createValidateOnClient": {
-      "types": "./dist/validation/createValidateOnClient.d.ts",
-      "default": "./dist/validation/createValidateOnClient.js"
+      "types": "./dist/validation/create-validate-on-client.d.ts",
+      "default": "./dist/validation/create-validate-on-client.js"
     }
   },
   "description": "Back-end Framework for Next.js App Router",