vovk 3.0.0-draft.98 → 3.0.0

package/dist/validation/procedure.d.ts

@@ -0,0 +1,261 @@
+import type { CombinedSpec } from '../types/validation.js';
+/**
+ * Procedure function for defining validation schemas for API procedures.
+ * @see https://vovk.dev/procedure
+ */
+export declare const procedure: (<TBody extends CombinedSpec, TQuery extends CombinedSpec, TParams extends CombinedSpec, TOutput extends CombinedSpec, TIteration extends CombinedSpec, TReq extends import("../index.js").VovkRequest<import("../types/utils.js").KnownAny, import("../types/utils.js").KnownAny, import("../types/utils.js").KnownAny> = import("../index.js").VovkRequest<TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined, TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined, TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined>, TContentType extends import("../types/validation.js").ContentType | import("../types/validation.js").ContentType[] = ["application/json"]>(options?: {
+    contentType?: TContentType | undefined;
+    body?: TBody | undefined;
+    query?: TQuery | undefined;
+    params?: TParams | undefined;
+    output?: TOutput | undefined;
+    iteration?: TIteration | undefined;
+    disableServerSideValidation?: boolean | import("../internal.js").VovkValidationType[];
+    skipSchemaEmission?: boolean | import("../internal.js").VovkValidationType[];
+    validateEachIteration?: boolean;
+    preferTransformed?: boolean;
+    operationObject?: import("../internal.js").VovkOperationObject;
+    target?: CombinedSpec.Target;
+}) => {
+    (req: TReq, params: TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : Record<string, string>): import("../types/utils.js").KnownAny;
+    __types: {
+        body: TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : any;
+        query: TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : any;
+        params: TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : any;
+        output: unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput>;
+        iteration: TIteration extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TIteration> : any;
+        contentType: import("../types/validation.js").NormalizeContentType<TContentType>;
+    };
+    __handleFn: (...args: import("../types/utils.js").KnownAny[]) => import("../types/utils.js").KnownAny;
+    isRPC?: boolean;
+    fn: {
+        <TTransformed>(input: {
+            body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+            query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+            params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+            meta?: Record<string, import("../types/utils.js").KnownAny>;
+            disableClientValidation?: boolean;
+            transform: (data: any, fakeReq: Pick<TReq, "vovk">) => TTransformed;
+        }): Promise<TTransformed>;
+        <TReturnType = any>(input?: {
+            body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+            query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+            params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+            meta?: Record<string, import("../types/utils.js").KnownAny>;
+            disableClientValidation?: boolean;
+        } | undefined): TReturnType;
+        (input?: {
+            body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+            query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+            params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+            meta?: Record<string, import("../types/utils.js").KnownAny>;
+            disableClientValidation?: boolean;
+        } | undefined): any;
+    };
+    definition: import("../types/utils.js").KnownAny;
+    schema: import("../types/utils.js").KnownAny;
+    wrapper?: import("../types/utils.js").KnownAny;
+} & {
+    handle: unknown extends CombinedSpec.InferOutput<TOutput> ? <THandleFn extends (req: TReq, params: TParams extends CombinedSpec ? CombinedSpec.InferOutput<TParams> : Record<string, string>) => import("../types/utils.js").KnownAny>(fn: THandleFn) => {
+        (req: TReq, params: TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : Record<string, string>): import("../types/utils.js").KnownAny;
+        __types: {
+            body: TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : any;
+            query: TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : any;
+            params: TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : any;
+            output: unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput>;
+            iteration: TIteration extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TIteration> : any;
+            contentType: import("../types/validation.js").NormalizeContentType<TContentType>;
+        };
+        __handleFn: THandleFn;
+        isRPC?: boolean;
+        fn: {
+            <TTransformed>(input: {
+                body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+                query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+                params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+                meta?: Record<string, import("../types/utils.js").KnownAny>;
+                disableClientValidation?: boolean;
+                transform: (data: Awaited<ReturnType<THandleFn>>, fakeReq: Pick<TReq, "vovk">) => TTransformed;
+            }): Promise<TTransformed>;
+            <TReturnType = ReturnType<THandleFn>>(input?: {
+                body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+                query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+                params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+                meta?: Record<string, import("../types/utils.js").KnownAny>;
+                disableClientValidation?: boolean;
+            } | undefined): TReturnType;
+            (input?: {
+                body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+                query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+                params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+                meta?: Record<string, import("../types/utils.js").KnownAny>;
+                disableClientValidation?: boolean;
+            } | undefined): ReturnType<THandleFn>;
+        };
+        definition: import("../types/utils.js").KnownAny;
+        schema: import("../types/utils.js").KnownAny;
+        wrapper?: import("../types/utils.js").KnownAny;
+    } : (fn: (req: TReq, params: TParams extends CombinedSpec ? CombinedSpec.InferOutput<TParams> : Record<string, string>) => unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput> | Promise<CombinedSpec.InferOutput<TOutput>> | (unknown extends CombinedSpec.InferOutput<TIteration> ? never : AsyncGenerator<CombinedSpec.InferOutput<TIteration>, any, any>)) => {
+        (req: TReq, params: TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : Record<string, string>): import("../types/utils.js").KnownAny;
+        __types: {
+            body: TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : any;
+            query: TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : any;
+            params: TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : any;
+            output: unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput>;
+            iteration: TIteration extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TIteration> : any;
+            contentType: import("../types/validation.js").NormalizeContentType<TContentType>;
+        };
+        __handleFn: (req: TReq, params: TParams extends CombinedSpec ? CombinedSpec.InferOutput<TParams> : Record<string, string>) => unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput> | Promise<CombinedSpec.InferOutput<TOutput>> | (unknown extends CombinedSpec.InferOutput<TIteration> ? never : AsyncGenerator<CombinedSpec.InferOutput<TIteration>, any, any>);
+        isRPC?: boolean;
+        fn: {
+            <TTransformed>(input: {
+                body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+                query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+                params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+                meta?: Record<string, import("../types/utils.js").KnownAny>;
+                disableClientValidation?: boolean;
+                transform: (data: Awaited<unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput> | Promise<CombinedSpec.InferOutput<TOutput>> | (unknown extends CombinedSpec.InferOutput<TIteration> ? never : AsyncGenerator<CombinedSpec.InferOutput<TIteration>, any, any>)>, fakeReq: Pick<TReq, "vovk">) => TTransformed;
+            }): Promise<TTransformed>;
+            <TReturnType = unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput> | Promise<CombinedSpec.InferOutput<TOutput>> | (unknown extends CombinedSpec.InferOutput<TIteration> ? never : AsyncGenerator<CombinedSpec.InferOutput<TIteration>, any, any>)>(input?: {
+                body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+                query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+                params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+                meta?: Record<string, import("../types/utils.js").KnownAny>;
+                disableClientValidation?: boolean;
+            } | undefined): TReturnType;
+            (input?: {
+                body?: (TBody extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TBody> : undefined) | undefined;
+                query?: (TQuery extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TQuery> : undefined) | undefined;
+                params?: (TParams extends CombinedSpec<unknown, unknown> ? CombinedSpec.InferOutput<TParams> : undefined) | undefined;
+                meta?: Record<string, import("../types/utils.js").KnownAny>;
+                disableClientValidation?: boolean;
+            } | undefined): unknown extends CombinedSpec.InferOutput<TOutput> ? any : CombinedSpec.InferOutput<TOutput> | Promise<CombinedSpec.InferOutput<TOutput>> | (unknown extends CombinedSpec.InferOutput<TIteration> ? never : AsyncGenerator<CombinedSpec.InferOutput<TIteration>, any, any>);
+        };
+        definition: import("../types/utils.js").KnownAny;
+        schema: import("../types/utils.js").KnownAny;
+        wrapper?: import("../types/utils.js").KnownAny;
+    };
+}) & {
+    createTool: {
+        <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("../internal.js").VovkToolNonDerived<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("../internal.js").VovkToolNonDerived<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;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema: CombinedSpec<TInput, TInput>;
+        } & {
+            outputSchema: CombinedSpec<TOutput, TOutput>;
+        } & {
+            execute: (input: TInput, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput: TToModelOutput;
+        }): import("../internal.js").VovkToolNonDerived<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>;
+        <TInput, TOutput>(options: {
+            name: string;
+            title?: string;
+            description: string;
+            onExecute?: ((result: unknown, tool: import("../internal.js").VovkToolNonDerived<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../internal.js").VovkToolNonDerived<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema: CombinedSpec<TInput, TInput>;
+        } & {
+            outputSchema: CombinedSpec<TOutput, TOutput>;
+        } & {
+            execute: (input: TInput, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput?: undefined;
+        }): import("../internal.js").VovkToolNonDerived<TInput, TOutput, import("../tools/toModelOutputDefault.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("../internal.js").VovkToolNonDerived<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("../internal.js").VovkToolNonDerived<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;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema: CombinedSpec<TInput, TInput>;
+        } & {
+            outputSchema?: undefined;
+        } & {
+            execute: (input: TInput, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput: TToModelOutput;
+        }): import("../internal.js").VovkToolNonDerived<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>;
+        <TInput, TOutput>(options: {
+            name: string;
+            title?: string;
+            description: string;
+            onExecute?: ((result: unknown, tool: import("../internal.js").VovkToolNonDerived<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../internal.js").VovkToolNonDerived<TInput, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema: CombinedSpec<TInput, TInput>;
+        } & {
+            outputSchema?: undefined;
+        } & {
+            execute: (input: TInput, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput?: undefined;
+        }): import("../internal.js").VovkToolNonDerived<TInput, TOutput, import("../tools/toModelOutputDefault.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("../internal.js").VovkToolNonDerived<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("../internal.js").VovkToolNonDerived<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;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema?: undefined;
+        } & {
+            outputSchema: CombinedSpec<TOutput, TOutput>;
+        } & {
+            execute: (input: null, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput: TToModelOutput;
+        }): import("../internal.js").VovkToolNonDerived<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>;
+        <TOutput>(options: {
+            name: string;
+            title?: string;
+            description: string;
+            onExecute?: ((result: unknown, tool: import("../internal.js").VovkToolNonDerived<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../internal.js").VovkToolNonDerived<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema?: undefined;
+        } & {
+            outputSchema: CombinedSpec<TOutput, TOutput>;
+        } & {
+            execute: (input: null, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput?: undefined;
+        }): import("../internal.js").VovkToolNonDerived<null, TOutput, import("../tools/toModelOutputDefault.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("../internal.js").VovkToolNonDerived<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("../internal.js").VovkToolNonDerived<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;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema?: undefined;
+        } & {
+            outputSchema?: undefined;
+        } & {
+            execute: (input: null, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput: TToModelOutput;
+        }): import("../internal.js").VovkToolNonDerived<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>;
+        <TOutput>(options: {
+            name: string;
+            title?: string;
+            description: string;
+            onExecute?: ((result: unknown, tool: import("../internal.js").VovkToolNonDerived<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            onError?: ((error: Error, tool: import("../internal.js").VovkToolNonDerived<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>) => void) | undefined;
+            target?: CombinedSpec.Target;
+        } & {
+            inputSchema?: undefined;
+        } & {
+            outputSchema?: undefined;
+        } & {
+            execute: (input: null, processingMeta?: unknown) => TOutput | Promise<TOutput>;
+            toModelOutput?: undefined;
+        }): import("../internal.js").VovkToolNonDerived<null, TOutput, import("../tools/toModelOutputDefault.js").DefaultModelOutput<TOutput>>;
+    };
+};

package/dist/validation/procedure.js

@@ -0,0 +1,8 @@
+import { createStandardValidation } from './createStandardValidation.js';
+/**
+ * Procedure function for defining validation schemas for API procedures.
+ * @see https://vovk.dev/procedure
+ */
+export const procedure = createStandardValidation({
+    toJSONSchema: (schema, options) => schema['~standard']?.jsonSchema?.input({ target: options.target ?? 'draft-2020-12' }) ?? {},
+});

package/dist/validation/withValidationLibrary.d.ts

@@ -0,0 +1,119 @@
+import type { VovkHandlerSchema, VovkValidationType } from '../types/core.js';
+import type { VovkRequest } from '../types/request.js';
+import type { 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?: THandle["__types"]["body"];
+        } : {
+            body: 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?: THandle["__types"]["body"];
+        } : {
+            body: 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?: THandle["__types"]["body"];
+        } : {
+            body: 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/withValidationLibrary.js

@@ -0,0 +1,174 @@
+import { HttpException } from '../core/HttpException.js';
+import { reqMeta } from '../req/reqMeta.js';
+import { setHandlerSchema } from '../core/setHandlerSchema.js';
+import { JSONLinesResponder } from '../core/JSONLinesResponder.js';
+import { HttpStatus } from '../types/enums.js';
+import { validateContentType } from '../req/validateContentType.js';
+import { bufferBody } from '../req/bufferBody.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) {
+        const fakeReq = {
+            vovk: {
+                body: () => Promise.resolve((input?.body ?? {})),
+                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

@@ -1,19 +1,50 @@
 {
   "name": "vovk",
-  "version": "3.0.0-draft.98",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "description": "RESTful RPC for Next.js - Transforms Next.js into a powerful REST API platform with RPC capabilities.",
+  "type": "module",
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "version": "3.0.0",
+  "bin": {
+    "vovk-cli-npx": "./bin/index.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    },
+    "./fetcher": {
+      "types": "./dist/client/fetcher.d.ts",
+      "default": "./dist/client/fetcher.js"
+    },
+    "./createRPC": {
+      "types": "./dist/client/createRPC.d.ts",
+      "default": "./dist/client/createRPC.js"
+    },
+    "./createValidateOnClient": {
+      "types": "./dist/validation/createValidateOnClient.d.ts",
+      "default": "./dist/validation/createValidateOnClient.js"
+    }
+  },
+  "description": "Back-end Framework for Next.js App Router",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/finom/vovk.git"
   },
   "scripts": {
-    "build": "tsc",
-    "rm-dist": "shx rm -rf dist",
+    "postbuild": "chmod +x ./bin/index.mjs",
+    "build": "rm -f *.tsbuildinfo && tsc",
+    "rm-dist": "rm -rf mjs cjs",
     "lint": "eslint . --fix",
     "tsc": "tsc --noEmit",
-    "npm-publish": "if [ -z \"$NPM_TAG\" ]; then echo 'Error: NPM_TAG is not set'; exit 1; fi; cd ./dist && npm publish --tag=$NPM_TAG && cd ..",
+    "npm-publish": "if [ -z \"$NPM_TAG\" ]; then echo 'Error: NPM_TAG is not set'; exit 1; fi; npm publish --tag=$NPM_TAG",
     "ncu": "npm-check-updates -u"
   },
   "keywords": [
@@ -27,9 +58,12 @@
   },
   "homepage": "https://vovk.dev",
   "peerDependencies": {
-    "next": "*"
+    "openapi3-ts": "^4.5.0",
+    "next": ">=15.0.0"
   },
-  "optionalDependencies": {
-    "openapi3-ts": "*"
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
   }
 }