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

package/mjs/types.d.ts

@@ -0,0 +1,466 @@
+import type { NextRequest } from 'next/server';
+import type { OpenAPIObject, OperationObject } from 'openapi3-ts/oas31';
+import type { JSONLinesResponse } from './JSONLinesResponse';
+import type { VovkStreamAsyncIterable } from './client/types';
+import type { PackageJson } from 'type-fest';
+export type KnownAny = any;
+export type StaticClass = Function;
+export type VovkPackageJson = PackageJson & {
+    rs_name?: string;
+    py_name?: string;
+};
+/**
+ * Schema for an individual handler, available as MyRPC.myHandler.schema and MyController.myHandler.schema
+ */
+export type VovkHandlerSchema = {
+    path: string;
+    httpMethod: string;
+    validation?: {
+        query?: VovkBasicJSONSchema;
+        body?: VovkBasicJSONSchema;
+        params?: VovkBasicJSONSchema;
+        output?: VovkBasicJSONSchema;
+        iteration?: VovkBasicJSONSchema;
+    };
+    operationObject?: VovkOperationObject;
+    misc?: Record<string, KnownAny>;
+};
+/**
+ * Represents the schema of a controller
+ */
+export type VovkControllerSchema = {
+    rpcModuleName: string;
+    originalControllerName?: string;
+    prefix?: string;
+    forceApiRoot?: string;
+    handlers: {
+        [key: string]: VovkHandlerSchema;
+    };
+};
+/**
+ * Represents the schema of a segment
+ */
+export type VovkSegmentSchema = {
+    $schema: typeof VovkSchemaIdEnum.SEGMENT | (string & {});
+    emitSchema: boolean;
+    segmentName: string;
+    segmentType: 'segment' | 'mixin' | (string & {});
+    forceApiRoot?: string;
+    controllers: {
+        [key: string]: VovkControllerSchema;
+    };
+    meta?: {
+        openAPIObject?: Partial<Omit<OpenAPIObject, 'paths'>>;
+        package?: VovkPackageJson;
+    };
+};
+/**
+ * Represents the meta schema
+ */
+export type VovkMetaSchema = {
+    $schema: typeof VovkSchemaIdEnum.META | (string & {});
+    config: RequireFields<Partial<VovkStrictConfig>, '$schema'>;
+    openAPIObject?: Partial<OpenAPIObject>;
+};
+/**
+ * Represents the full schema of composed client or a segment in segmented client.
+ */
+export type VovkSchema = {
+    $schema: typeof VovkSchemaIdEnum.SCHEMA | (string & {});
+    segments: {
+        [key: string]: VovkSegmentSchema;
+    };
+    meta?: VovkMetaSchema;
+};
+/**
+ * The shape of error responses
+ */
+export type VovkErrorResponse = {
+    cause?: unknown;
+    statusCode: HttpStatus;
+    message: string;
+    isError: true;
+};
+export type VovkControllerInternal = {
+    _rpcModuleName?: VovkControllerSchema['rpcModuleName'];
+    _prefix?: VovkControllerSchema['prefix'];
+    _handlers: VovkControllerSchema['handlers'];
+    _handlersMetadata?: Record<string, {
+        staticParams?: Record<string, string>[];
+    }>;
+    _onError?: (err: Error, req: VovkRequest) => void | Promise<void>;
+    _onSuccess?: (resp: unknown, req: VovkRequest) => void | Promise<void>;
+    _onBefore?: (req: VovkRequest) => void | Promise<void>;
+};
+export type VovkController = StaticClass & VovkControllerInternal & {
+    [key: string]: unknown;
+};
+export type DecoratorOptions = {
+    cors?: boolean;
+    headers?: Record<string, string>;
+    staticParams?: Record<string, string>[];
+    before?: (this: VovkController, req: VovkRequest) => unknown;
+};
+export type RouteHandler = ((req: VovkRequest, params: Record<string, string>) => Response | Promise<Response> | Iterable<unknown> | AsyncIterable<unknown>) & {
+    _options?: DecoratorOptions;
+};
+export interface VovkRequest<TBody extends KnownAny = unknown, TQuery extends KnownAny = unknown, TParams extends KnownAny = unknown> extends Omit<NextRequest, 'json' | 'nextUrl'> {
+    json: () => Promise<TBody>;
+    nextUrl: Omit<NextRequest['nextUrl'], 'searchParams'> & {
+        searchParams: Omit<NextRequest['nextUrl']['searchParams'], 'get' | 'getAll' | 'entries' | 'forEach' | 'keys' | 'values'> & {
+            get: <KEY extends keyof TQuery>(key: KEY) => TQuery[KEY] extends readonly (infer ITEM)[] ? ITEM : TQuery[KEY];
+            getAll: <KEY extends keyof TQuery>(key: KEY) => TQuery[KEY] extends KnownAny[] ? TQuery[KEY] : TQuery[KEY][];
+            entries: () => IterableIterator<[keyof TQuery, TQuery[keyof TQuery]]>;
+            forEach: (callbackfn: (value: TQuery[keyof TQuery], key: keyof TQuery, searchParams: NextRequest['nextUrl']['searchParams']) => void) => void;
+            keys: () => IterableIterator<keyof TQuery>;
+            values: () => IterableIterator<TQuery[keyof TQuery]>;
+        };
+    };
+    vovk: {
+        body: () => Promise<TBody>;
+        query: () => TQuery;
+        meta: <T = Record<KnownAny, KnownAny>>(meta?: T | null) => T;
+        form: <T = TBody>() => Promise<T>;
+        params: () => TParams;
+    };
+}
+export type ControllerStaticMethod<REQ extends VovkRequest<KnownAny, KnownAny, KnownAny> = VovkRequest, TParams extends {
+    [key: string]: string;
+} = KnownAny> = ((req: REQ, params: TParams) => unknown) & {
+    _controller?: VovkController;
+};
+export type VovkTypedMethod<T extends (...args: KnownAny[]) => KnownAny, B = KnownAny, Q = KnownAny, P = KnownAny, O = KnownAny, I = KnownAny, IS_FORM extends boolean = false> = T & {
+    __types: {
+        body: B;
+        query: Q;
+        params: P;
+        output: O;
+        iteration: I;
+        isForm: IS_FORM;
+    };
+    isRPC?: boolean;
+};
+export type VovkControllerBody<T extends (...args: KnownAny) => KnownAny> = Awaited<ReturnType<Parameters<T>[0]['vovk']['body']>>;
+export type VovkControllerQuery<T extends (...args: KnownAny) => KnownAny> = ReturnType<Parameters<T>[0]['vovk']['query']>;
+export type VovkControllerParams<T extends (...args: KnownAny) => KnownAny> = Parameters<T>[1] extends object ? Parameters<T>[1] : ReturnType<Parameters<T>[0]['vovk']['params']>;
+export type VovkControllerYieldType<T extends (req: VovkRequest<KnownAny, KnownAny>) => KnownAny> = T extends (...args: KnownAny[]) => AsyncGenerator<infer Y, KnownAny, KnownAny> ? Y : T extends (...args: KnownAny[]) => Generator<infer Y, KnownAny, KnownAny> ? Y : T extends (...args: KnownAny[]) => Promise<JSONLinesResponse<infer Y>> | JSONLinesResponse<infer Y> ? Y : never;
+export type VovkOutput<T> = T extends {
+    __types?: {
+        output?: infer O;
+    };
+} ? O : KnownAny;
+export type VovkIteration<T> = T extends {
+    __types?: {
+        iteration?: infer I;
+    };
+} ? I : KnownAny;
+export type VovkClientBody<T extends (opts: KnownAny) => KnownAny> = Parameters<T>[0] extends {
+    body: infer B;
+} ? B : undefined;
+export type VovkClientQuery<T extends (opts: KnownAny) => KnownAny> = Parameters<T>[0] extends {
+    query: infer Q;
+} ? Q : undefined;
+export type VovkClientParams<T extends (opts: KnownAny) => KnownAny> = Parameters<T>[0] extends {
+    params: infer P;
+} ? P : undefined;
+export type VovkClientYieldType<T extends (...args: KnownAny[]) => unknown> = T extends (...args: KnownAny[]) => Promise<VovkStreamAsyncIterable<infer Y>> ? Y : never;
+export type VovkBody<T extends (...args: KnownAny[]) => unknown> = T extends {
+    isRPC: true;
+} ? VovkClientBody<T> : VovkControllerBody<T>;
+export type VovkQuery<T extends (...args: KnownAny[]) => unknown> = T extends {
+    isRPC: true;
+} ? VovkClientQuery<T> : VovkControllerQuery<T>;
+export type VovkParams<T extends (...args: KnownAny[]) => unknown> = T extends {
+    isRPC: true;
+} ? VovkClientParams<T> : VovkControllerParams<T>;
+export type VovkYieldType<T extends (...args: KnownAny[]) => unknown> = T extends {
+    isRPC: true;
+} ? VovkClientYieldType<T> : VovkControllerYieldType<T>;
+export type VovkReturnType<T extends (...args: KnownAny) => unknown> = Awaited<ReturnType<T>>;
+export type StreamAbortMessage = {
+    isError: true;
+    reason: KnownAny;
+};
+export type VovkValidationType = 'body' | 'query' | 'params' | 'output' | 'iteration';
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    PATCH = "PATCH",
+    DELETE = "DELETE",
+    HEAD = "HEAD",
+    OPTIONS = "OPTIONS"
+}
+export declare enum HttpStatus {
+    NULL = 0,
+    CONTINUE = 100,
+    SWITCHING_PROTOCOLS = 101,
+    PROCESSING = 102,
+    EARLYHINTS = 103,
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    NO_CONTENT = 204,
+    RESET_CONTENT = 205,
+    PARTIAL_CONTENT = 206,
+    AMBIGUOUS = 300,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    SEE_OTHER = 303,
+    NOT_MODIFIED = 304,
+    TEMPORARY_REDIRECT = 307,
+    PERMANENT_REDIRECT = 308,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    PAYMENT_REQUIRED = 402,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    NOT_ACCEPTABLE = 406,
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    REQUEST_TIMEOUT = 408,
+    CONFLICT = 409,
+    GONE = 410,
+    LENGTH_REQUIRED = 411,
+    PRECONDITION_FAILED = 412,
+    PAYLOAD_TOO_LARGE = 413,
+    URI_TOO_LONG = 414,
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    REQUESTED_RANGE_NOT_SATISFIABLE = 416,
+    EXPECTATION_FAILED = 417,
+    I_AM_A_TEAPOT = 418,
+    MISDIRECTED = 421,
+    UNPROCESSABLE_ENTITY = 422,
+    FAILED_DEPENDENCY = 424,
+    PRECONDITION_REQUIRED = 428,
+    TOO_MANY_TRequestS = 429,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504,
+    HTTP_VERSION_NOT_SUPPORTED = 505
+}
+export interface VovkLLMTool {
+    execute: (input: {
+        body?: KnownAny;
+        query?: KnownAny;
+        params?: KnownAny;
+    }, options?: KnownAny) => Promise<KnownAny>;
+    name: string;
+    description: string;
+    parameters?: {
+        type: 'object';
+        properties?: {
+            body?: VovkBasicJSONSchema;
+            query?: VovkBasicJSONSchema;
+            params?: VovkBasicJSONSchema;
+        };
+        required?: ('body' | 'query' | 'params')[];
+        additionalProperties?: boolean;
+    };
+    models: {
+        body?: KnownAny;
+        query?: KnownAny;
+        params?: KnownAny;
+        output?: KnownAny;
+        iteration?: KnownAny;
+    } | undefined;
+    type: 'function';
+}
+export type VovkBasicJSONSchema = {
+    $schema?: string;
+    type?: string | string[];
+    format?: string;
+    $ref?: string;
+    items?: VovkBasicJSONSchema;
+    enum?: KnownAny[];
+    minimum?: number;
+    maximum?: number;
+    title?: string;
+    description?: string;
+    properties?: {
+        [key: string]: VovkBasicJSONSchema;
+    };
+    required?: string[];
+    examples?: KnownAny[];
+    $defs?: {
+        [key: string]: VovkBasicJSONSchema;
+    };
+    definitions?: {
+        [key: string]: VovkBasicJSONSchema;
+    };
+    additionalProperties?: boolean;
+    anyOf?: VovkBasicJSONSchema[];
+    oneOf?: VovkBasicJSONSchema[];
+    allOf?: VovkBasicJSONSchema[];
+    const?: KnownAny;
+    example?: KnownAny;
+    contentEncoding?: string;
+    contentMediaType?: string;
+    minLength?: number;
+    maxLength?: number;
+    [key: `x-${string}`]: KnownAny;
+};
+export type VovkOperationObject = OperationObject & {
+    'x-tool-disable'?: boolean;
+    'x-tool-description'?: string;
+    'x-tool-successMessage'?: string;
+    'x-tool-errorMessage'?: string;
+    'x-tool-includeResponse'?: boolean;
+};
+/**
+ * IDs of the JSON Schema files that can be generated by Vovk.ts
+ */
+export declare enum VovkSchemaIdEnum {
+    META = "https://vovk.dev/api/schema/v3/meta.json",
+    CONFIG = "https://vovk.dev/api/schema/v3/config.json",
+    SEGMENT = "https://vovk.dev/api/schema/v3/segment.json",
+    SCHEMA = "https://vovk.dev/api/schema/v3/schema.json"
+}
+export type VovkReadmeConfig = {
+    banner?: string;
+    installCommand?: string;
+    description?: string;
+};
+export type VovkSamplesConfig = {
+    apiRoot?: string;
+    headers?: Record<string, string>;
+};
+type ClientConfigCommon = {
+    enabled?: boolean;
+    outDir?: string;
+    fromTemplates?: string[];
+    prettifyClient?: boolean;
+} & ({
+    excludeSegments?: never;
+    includeSegments?: string[];
+} | {
+    excludeSegments?: string[];
+    includeSegments?: never;
+});
+type ClientConfigComposed = ClientConfigCommon;
+type ClientConfigSegmented = ClientConfigCommon;
+type BundleConfig = {
+    requires?: Record<string, string>;
+    prebundleOutDir?: string;
+    keepPrebundleDir?: boolean;
+    tsdownBuildOptions?: Parameters<typeof import('tsdown') extends {
+        build: infer T;
+    } ? T : never>[0];
+    generatorConfig?: VovkGeneratorConfig<GeneratorConfigImports>;
+} & ({
+    excludeSegments?: never;
+    includeSegments?: string[];
+} | {
+    excludeSegments?: string[];
+    includeSegments?: never;
+});
+type GeneratorConfigImports = {
+    fetcher?: string | [string, string] | [string];
+    validateOnClient?: string | [string, string] | [string] | null;
+    createRPC?: string | [string, string] | [string];
+};
+type SegmentConfigImports = {
+    fetcher?: string | [string, string] | [string];
+    validateOnClient?: string | [string, string] | [string] | null;
+};
+export interface VovkGeneratorConfig<TImports extends GeneratorConfigImports = GeneratorConfigImports> {
+    origin?: string | null;
+    package?: VovkPackageJson;
+    readme?: VovkReadmeConfig;
+    samples?: VovkSamplesConfig;
+    openAPIObject?: Partial<OpenAPIObject>;
+    reExports?: Record<string, string>;
+    imports?: TImports;
+}
+export type ClientTemplateDef = {
+    extends?: string;
+    templatePath?: string | null;
+    composedClient?: Omit<ClientConfigComposed, 'fromTemplates' | 'enabled'>;
+    segmentedClient?: Omit<ClientConfigSegmented, 'fromTemplates' | 'enabled'>;
+    requires?: Record<string, string>;
+    generatorConfig?: VovkGeneratorConfig<GeneratorConfigImports>;
+};
+export type GetOpenAPINameFn = (config: {
+    operationObject: VovkOperationObject;
+    method: HttpMethod;
+    path: string;
+    openAPIObject: OpenAPIObject;
+}) => string;
+export interface VovkOpenAPIMixin {
+    source: {
+        file: string;
+    } | {
+        url: string;
+        fallback?: string;
+    } | {
+        object: OpenAPIObject;
+    };
+    apiRoot?: string;
+    getModuleName?: 'nestjs-operation-id' | (string & {}) | 'api' | GetOpenAPINameFn;
+    getMethodName?: 'nestjs-operation-id' | 'camel-case-operation-id' | 'auto' | GetOpenAPINameFn;
+    errorMessageKey?: string;
+    mixinName?: string;
+}
+export interface VovkOpenAPIMixinNormalized extends Omit<VovkOpenAPIMixin, 'source' | 'getMethodName' | 'getModuleName'> {
+    source: Exclude<NonNullable<VovkOpenAPIMixin['source']>, {
+        file: string;
+    } | {
+        url: string;
+    }>;
+    getMethodName: GetOpenAPINameFn;
+    getModuleName: GetOpenAPINameFn;
+}
+export interface VovkSegmentConfig extends VovkGeneratorConfig<SegmentConfigImports> {
+    rootEntry?: string;
+    segmentNameOverride?: string;
+    openAPIMixin?: VovkOpenAPIMixin;
+}
+type VovkUserConfig = {
+    $schema?: typeof VovkSchemaIdEnum.CONFIG | (string & {});
+    emitConfig?: boolean | (keyof VovkStrictConfig | (string & {}))[];
+    schemaOutDir?: string;
+    modulesDir?: string;
+    rootEntry?: string;
+    logLevel?: 'error' | 'trace' | 'debug' | 'info' | 'warn' | (string & {});
+    libs?: {
+        ajv: KnownAny;
+        [key: string]: KnownAny;
+    };
+    devHttps?: boolean;
+    composedClient?: ClientConfigComposed;
+    segmentedClient?: ClientConfigSegmented;
+    bundle?: BundleConfig;
+    clientTemplateDefs?: Record<string, ClientTemplateDef>;
+    rootSegmentModulesDirName?: string;
+    moduleTemplates?: {
+        service?: string;
+        controller?: string;
+        [key: string]: string | undefined;
+    };
+    generatorConfig?: VovkGeneratorConfig<GeneratorConfigImports> & {
+        segments?: Record<string, VovkSegmentConfig>;
+    };
+};
+export type VovkConfig = VovkUserConfig;
+export type VovkStrictConfig = Required<Omit<VovkUserConfig, 'emitConfig' | 'libs' | 'composedClient' | 'segmentedClient' | 'bundle'>> & {
+    emitConfig: (keyof VovkStrictConfig | string)[];
+    bundle: RequireAllExcept<NonNullable<VovkUserConfig['bundle']>, 'includeSegments' | 'excludeSegments'>;
+    libs: Record<string, KnownAny>;
+    composedClient: RequireFields<ClientConfigComposed, 'enabled' | 'fromTemplates' | 'outDir' | 'prettifyClient'>;
+    segmentedClient: RequireFields<ClientConfigSegmented, 'enabled' | 'fromTemplates' | 'outDir' | 'prettifyClient'>;
+    generatorConfig: VovkGeneratorConfig<GeneratorConfigImports> & {
+        segments?: Record<string, Omit<VovkSegmentConfig, 'openAPIMixin'> & {
+            openAPIMixin?: VovkOpenAPIMixinNormalized;
+        }>;
+    };
+};
+export type RequireFields<T, K extends keyof T> = T & Required<Pick<T, K>>;
+export type RequireAllExcept<T, K extends keyof T> = Required<Omit<T, K>> & Pick<T, K>;
+export type IsEmptyObject<T> = T extends object ? keyof T extends never ? true : T extends Partial<T> ? Partial<T> extends T ? true : false : false : false;
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export {};

package/mjs/types.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VovkSchemaIdEnum = exports.HttpStatus = exports.HttpMethod = void 0;
+// Enums
+var HttpMethod;
+(function (HttpMethod) {
+    HttpMethod["GET"] = "GET";
+    HttpMethod["POST"] = "POST";
+    HttpMethod["PUT"] = "PUT";
+    HttpMethod["PATCH"] = "PATCH";
+    HttpMethod["DELETE"] = "DELETE";
+    HttpMethod["HEAD"] = "HEAD";
+    HttpMethod["OPTIONS"] = "OPTIONS";
+})(HttpMethod || (exports.HttpMethod = HttpMethod = {}));
+var HttpStatus;
+(function (HttpStatus) {
+    HttpStatus[HttpStatus["NULL"] = 0] = "NULL";
+    HttpStatus[HttpStatus["CONTINUE"] = 100] = "CONTINUE";
+    HttpStatus[HttpStatus["SWITCHING_PROTOCOLS"] = 101] = "SWITCHING_PROTOCOLS";
+    HttpStatus[HttpStatus["PROCESSING"] = 102] = "PROCESSING";
+    HttpStatus[HttpStatus["EARLYHINTS"] = 103] = "EARLYHINTS";
+    HttpStatus[HttpStatus["OK"] = 200] = "OK";
+    HttpStatus[HttpStatus["CREATED"] = 201] = "CREATED";
+    HttpStatus[HttpStatus["ACCEPTED"] = 202] = "ACCEPTED";
+    HttpStatus[HttpStatus["NON_AUTHORITATIVE_INFORMATION"] = 203] = "NON_AUTHORITATIVE_INFORMATION";
+    HttpStatus[HttpStatus["NO_CONTENT"] = 204] = "NO_CONTENT";
+    HttpStatus[HttpStatus["RESET_CONTENT"] = 205] = "RESET_CONTENT";
+    HttpStatus[HttpStatus["PARTIAL_CONTENT"] = 206] = "PARTIAL_CONTENT";
+    HttpStatus[HttpStatus["AMBIGUOUS"] = 300] = "AMBIGUOUS";
+    HttpStatus[HttpStatus["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
+    HttpStatus[HttpStatus["FOUND"] = 302] = "FOUND";
+    HttpStatus[HttpStatus["SEE_OTHER"] = 303] = "SEE_OTHER";
+    HttpStatus[HttpStatus["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
+    HttpStatus[HttpStatus["TEMPORARY_REDIRECT"] = 307] = "TEMPORARY_REDIRECT";
+    HttpStatus[HttpStatus["PERMANENT_REDIRECT"] = 308] = "PERMANENT_REDIRECT";
+    HttpStatus[HttpStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HttpStatus[HttpStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HttpStatus[HttpStatus["PAYMENT_REQUIRED"] = 402] = "PAYMENT_REQUIRED";
+    HttpStatus[HttpStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HttpStatus[HttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HttpStatus[HttpStatus["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
+    HttpStatus[HttpStatus["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
+    HttpStatus[HttpStatus["PROXY_AUTHENTICATION_REQUIRED"] = 407] = "PROXY_AUTHENTICATION_REQUIRED";
+    HttpStatus[HttpStatus["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
+    HttpStatus[HttpStatus["CONFLICT"] = 409] = "CONFLICT";
+    HttpStatus[HttpStatus["GONE"] = 410] = "GONE";
+    HttpStatus[HttpStatus["LENGTH_REQUIRED"] = 411] = "LENGTH_REQUIRED";
+    HttpStatus[HttpStatus["PRECONDITION_FAILED"] = 412] = "PRECONDITION_FAILED";
+    HttpStatus[HttpStatus["PAYLOAD_TOO_LARGE"] = 413] = "PAYLOAD_TOO_LARGE";
+    HttpStatus[HttpStatus["URI_TOO_LONG"] = 414] = "URI_TOO_LONG";
+    HttpStatus[HttpStatus["UNSUPPORTED_MEDIA_TYPE"] = 415] = "UNSUPPORTED_MEDIA_TYPE";
+    HttpStatus[HttpStatus["REQUESTED_RANGE_NOT_SATISFIABLE"] = 416] = "REQUESTED_RANGE_NOT_SATISFIABLE";
+    HttpStatus[HttpStatus["EXPECTATION_FAILED"] = 417] = "EXPECTATION_FAILED";
+    HttpStatus[HttpStatus["I_AM_A_TEAPOT"] = 418] = "I_AM_A_TEAPOT";
+    HttpStatus[HttpStatus["MISDIRECTED"] = 421] = "MISDIRECTED";
+    HttpStatus[HttpStatus["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+    HttpStatus[HttpStatus["FAILED_DEPENDENCY"] = 424] = "FAILED_DEPENDENCY";
+    HttpStatus[HttpStatus["PRECONDITION_REQUIRED"] = 428] = "PRECONDITION_REQUIRED";
+    HttpStatus[HttpStatus["TOO_MANY_TRequestS"] = 429] = "TOO_MANY_TRequestS";
+    HttpStatus[HttpStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    HttpStatus[HttpStatus["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+    HttpStatus[HttpStatus["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+    HttpStatus[HttpStatus["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+    HttpStatus[HttpStatus["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+    HttpStatus[HttpStatus["HTTP_VERSION_NOT_SUPPORTED"] = 505] = "HTTP_VERSION_NOT_SUPPORTED";
+})(HttpStatus || (exports.HttpStatus = HttpStatus = {}));
+// -----
+/**
+ * IDs of the JSON Schema files that can be generated by Vovk.ts
+ */
+var VovkSchemaIdEnum;
+(function (VovkSchemaIdEnum) {
+    VovkSchemaIdEnum["META"] = "https://vovk.dev/api/schema/v3/meta.json";
+    VovkSchemaIdEnum["CONFIG"] = "https://vovk.dev/api/schema/v3/config.json";
+    VovkSchemaIdEnum["SEGMENT"] = "https://vovk.dev/api/schema/v3/segment.json";
+    VovkSchemaIdEnum["SCHEMA"] = "https://vovk.dev/api/schema/v3/schema.json";
+})(VovkSchemaIdEnum || (exports.VovkSchemaIdEnum = VovkSchemaIdEnum = {}));

package/mjs/utils/camelCase.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts string to camel case.
+ * @param {*} input - The value to convert to camel case.
+ * @returns {string}
+ */
+export declare function camelCase(input: string): string;

package/mjs/utils/camelCase.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.camelCase = camelCase;
+// Convert any value to string
+function toString(value) {
+    return value == null ? '' : String(value);
+}
+// Regex to match words (including Unicode letters & digits)
+const reUnicodeWord = /[\p{Lu}]{2,}(?=[\p{Lu}][\p{Ll}]+[0-9]*|\b)|[\p{Lu}]?[\p{Ll}]+[0-9]*|[\p{Lu}]|[0-9]+/gu;
+/**
+ * Splits string into an array of words based on Unicode word boundaries
+ * @param {string} str
+ * @returns {string[]}
+ */
+function unicodeWords(str) {
+    return str.match(reUnicodeWord) || [];
+}
+/**
+ * Converts string to camel case.
+ * @param {*} input - The value to convert to camel case.
+ * @returns {string}
+ */
+function camelCase(input) {
+    const str = toString(input);
+    // replace separators with space
+    const sanitized = str.replace(/[\s_-]+/g, ' ').trim();
+    const words = unicodeWords(sanitized);
+    return words
+        .map((word, index) => {
+        const lower = word.toLowerCase();
+        if (index === 0) {
+            return lower;
+        }
+        return lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join('');
+}

package/mjs/utils/createCodeSamples.d.ts

@@ -0,0 +1,20 @@
+import type { KnownAny, VovkControllerSchema, VovkHandlerSchema, VovkSamplesConfig } from '../types';
+export type CodeSamplePackageJson = {
+    name?: string;
+    version?: string;
+    description?: string;
+    rs_name?: string;
+    py_name?: string;
+    [key: string]: KnownAny;
+};
+export declare function createCodeSamples({ handlerName, handlerSchema, controllerSchema, package: packageJson, config, }: {
+    handlerName: string;
+    handlerSchema: VovkHandlerSchema;
+    controllerSchema: VovkControllerSchema;
+    package?: CodeSamplePackageJson;
+    config: VovkSamplesConfig;
+}): {
+    ts: string;
+    py: string;
+    rs: string;
+};