@kaito-http/core 4.0.0-beta.2 → 4.0.0-beta.21

package/dist/schema/schema.d.cts

@@ -0,0 +1,333 @@
+import { SchemaObject, ReferenceObject } from 'openapi3-ts/oas31';
+
+type JSONPrimitive = string | number | boolean | null;
+type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+declare function isPrimitiveJSONValue(value: unknown): value is JSONPrimitive;
+interface BaseSchemaDef<Input extends JSONValue> {
+    example?: Input | undefined;
+    description?: string | undefined;
+}
+interface Issue {
+    message: string;
+    path: string[];
+}
+type ParseResult<T> = {
+    success: true;
+    result: T;
+} | {
+    success: false;
+    issues: Set<Issue>;
+};
+declare class SchemaError extends Error {
+    readonly issues: Set<Issue>;
+    constructor(issues: Set<Issue>);
+}
+declare class ParseContext {
+    #private;
+    private static readonly ISSUE;
+    readonly ISSUE: typeof ParseContext.ISSUE;
+    addIssue(message: string, path: string[]): typeof ParseContext.ISSUE;
+    addIssues(issues: Iterable<Issue>, path: string[]): typeof ParseContext.ISSUE;
+    get issues(): Set<Issue>;
+    static result<T>(fn: (ctx: ParseContext) => T | typeof ParseContext.ISSUE): ParseResult<T>;
+    static with<T>(fn: (ctx: ParseContext) => T | typeof ParseContext.ISSUE): {
+        type: "FATAL";
+        issues: Set<Issue>;
+        data?: never;
+    } | {
+        type: "PARSED";
+        issues: Set<Issue>;
+        data: T;
+    };
+}
+type AnySchemaFor<T extends JSONValue> = BaseSchema<T, T, BaseSchemaDef<T>>;
+declare abstract class BaseSchema<Input extends JSONValue, Output, Def extends BaseSchemaDef<Input>> {
+    /** @internal */
+    readonly _input: Input;
+    /** @internal */
+    readonly _output: Output;
+    abstract parse(json: unknown): Output;
+    abstract parseSafe(json: unknown): ParseResult<Output>;
+    abstract serialize(value: Output): Input;
+    protected readonly def: Def;
+    abstract toOpenAPI(): SchemaObject | ReferenceObject;
+    protected getSchemaObject(): SchemaObject;
+    protected clone(def: Partial<Def>): this;
+    protected constructor(def: Def);
+    or<OtherInput extends JSONValue, OtherOutput, Def extends BaseSchemaDef<OtherInput>>(other: BaseSchema<OtherInput, OtherOutput, Def>): KUnion<(this | BaseSchema<OtherInput, OtherOutput, Def>)["_input"], (this | BaseSchema<OtherInput, OtherOutput, Def>)["_output"]>;
+    example(example: Input): this;
+    example(): Input | undefined;
+    description(description: string): this;
+    description(): string | undefined;
+}
+type Check<T extends string, P extends {} = {}> = {
+    type: T;
+    message?: string | undefined;
+} & Omit<P, 'message'>;
+type StringFormat = 'date' | 'date-time' | 'password' | 'byte' | 'binary' | 'email' | 'uuid' | 'uri' | 'hostname' | 'ipv4' | 'ipv6';
+declare const STRING_FORMAT_REGEXES: {
+    readonly uuid: RegExp;
+    readonly email: RegExp;
+    readonly ipv4: RegExp;
+    readonly ipv6: RegExp;
+    readonly date: RegExp;
+    readonly uri: RegExp;
+    readonly hostname: RegExp;
+};
+interface StringChecks {
+    min?: Check<'min', {
+        val: number;
+    }>;
+    max?: Check<'max', {
+        val: number;
+    }>;
+    regex?: Check<'regex', {
+        regex: RegExp;
+    }>;
+    format?: Check<'format', {
+        format: StringFormat;
+    }>;
+    startsWith?: Check<'startsWith', {
+        prefix: string;
+    }>;
+    endsWith?: Check<'endsWith', {
+        suffix: string;
+    }>;
+}
+interface StringDef extends BaseSchemaDef<string>, StringChecks {
+}
+declare class KString extends BaseSchema<string, string, StringDef> {
+    static create: () => KString;
+    serialize(value: string): string;
+    private setCheck;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    /**
+     * Sets the minimum length of the string
+     *
+     * @param min The minimum length of the string
+     * @returns A clone of the schema with the minimum length set
+     */
+    min(min: number, message?: string): this;
+    /**
+     * Sets the maximum length of the string
+     *
+     * @param max The maximum length of the string
+     * @returns A clone of the schema with the maximum length set
+     */
+    max(max: number, message?: string): this;
+    regex(regex: RegExp, message?: string): this;
+    startsWith(prefix: string, message?: string): this;
+    endsWith(suffix: string, message?: string): this;
+    private format;
+    uri(message?: string): this;
+    /**
+     * Deprecated because OpenAPI uses the term "uri"
+     * but this method exists for making migration from
+     * Zod easier.
+     *
+     * @deprecated Use {@link uri} instead
+     */
+    url(message?: string): this;
+    email(message?: string): this;
+    uuid(message?: string): this;
+    ipv4(message?: string): this;
+    ipv6(message?: string): this;
+    date(message?: string): this;
+    dateTime(message?: string): this;
+    password(message?: string): this;
+    byte(message?: string): this;
+    binary(message?: string): this;
+    hostname(message?: string): this;
+    parseSafe(json: unknown): ParseResult<string>;
+    parse(json: unknown): string;
+}
+type NumberFormat = 'float' | 'double' | 'int32' | 'int64';
+interface NumberChecks {
+    min?: Check<'min', {
+        val: number;
+    }>;
+    max?: Check<'max', {
+        val: number;
+    }>;
+    integer?: Check<'integer'>;
+    multipleOf?: Check<'multipleOf', {
+        val: number;
+    }>;
+    format?: Check<'format', {
+        format: NumberFormat;
+    }>;
+}
+interface NumberDef extends BaseSchemaDef<number>, NumberChecks {
+}
+declare class KNumber extends BaseSchema<number, number, NumberDef> {
+    static create: () => KNumber;
+    serialize(value: number): number;
+    private setCheck;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    min(min: number): this;
+    max(max: number): this;
+    integer(): this;
+    multipleOf(multipleOf: number): this;
+    float(): this;
+    double(): this;
+    int32(): this;
+    int64(): this;
+    parseSafe(json: unknown): ParseResult<number>;
+    parse(json: unknown): number;
+}
+interface BooleanDef extends BaseSchemaDef<boolean> {
+}
+declare class KBoolean extends BaseSchema<boolean, boolean, BooleanDef> {
+    static create: () => KBoolean;
+    serialize(value: boolean): boolean;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<boolean>;
+    parse(json: unknown): boolean;
+}
+interface ArrayChecks {
+    minItems?: Check<'minItems', {
+        val: number;
+    }>;
+    maxItems?: Check<'maxItems', {
+        val: number;
+    }>;
+    uniqueItems?: Check<'uniqueItems', {
+        val: boolean;
+    }>;
+}
+interface ArrayDef<Input extends JSONValue, Output> extends BaseSchemaDef<Input[]>, ArrayChecks {
+    items: BaseSchema<Input, Output, BaseSchemaDef<Input>>;
+}
+declare class KArray<Input extends JSONValue, Output> extends BaseSchema<Input[], Output[], ArrayDef<Input, Output>> {
+    static create: <ItemsInput extends JSONValue, ItemsOutput, Def extends BaseSchemaDef<ItemsInput>>(items: BaseSchema<ItemsInput, ItemsOutput, Def>) => KArray<ItemsInput, ItemsOutput>;
+    serialize(value: Output[]): Input[];
+    private setCheck;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    min(minItems: number): this;
+    max(maxItems: number): this;
+    unique(): this;
+    notUnique(): this;
+    parseSafe(json: unknown): ParseResult<Output[]>;
+    parse(json: unknown): Output[];
+}
+interface NullDef extends BaseSchemaDef<null> {
+}
+declare class KNull extends BaseSchema<null, null, NullDef> {
+    static create: () => KNull;
+    serialize(value: null): null;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<null>;
+    parse(json: unknown): null;
+}
+interface ObjectDef<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends BaseSchemaDef<Input> {
+    shape: {
+        [K in keyof Input]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>;
+    };
+}
+declare class KObject<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, any>> extends BaseSchema<Input, Output, ObjectDef<Input, Output>> {
+    static create: <Input_1 extends Record<keyof Output_1, any>, Output_1 extends Record<keyof Input_1, any>>(shape: { [K in keyof Input_1 | keyof Output_1]: BaseSchema<Input_1[K], Output_1[K], BaseSchemaDef<Input_1[K]>>; }) => KObject<Input_1, Output_1>;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+    get shape(): { [K in keyof Input]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; };
+}
+declare class KObjectFromURLSearchParams<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends KObject<Input, Output> {
+    static create: <Input_1 extends Record<keyof Output_1, JSONValue>, Output_1 extends Record<keyof Input_1, JSONValue>>(shape: { [K in keyof Input_1 | keyof Output_1]: BaseSchema<Input_1[K], Output_1[K], BaseSchemaDef<Input_1[K]>>; }) => KObjectFromURLSearchParams<Input_1, Output_1>;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+}
+interface RefDef<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends ObjectDef<Input, Output> {
+    name: string;
+    summary?: string | undefined;
+}
+declare class KRef<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends BaseSchema<Input, Output, RefDef<Input, Output>> {
+    static create: <Input_1 extends Record<keyof Output_1, JSONValue>, Output_1 extends Record<keyof Input_1, JSONValue>>(name: string, shape: { [K in keyof Input_1 | keyof Output_1]: BaseSchema<Input_1[K], Output_1[K], BaseSchemaDef<Input_1[K]>>; }) => KRef<Input_1, Output_1>;
+    serialize(value: Output): Input;
+    example(): never;
+    toOpenAPI(): ReferenceObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+    summary(): string | undefined;
+    summary(summary: string): this;
+    get shape(): { [K in keyof Input]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; };
+    get name(): string;
+}
+interface ScalarOptions<ClientRepresentation extends JSONValue, ServerRepresentation> {
+    /**
+     * Parse the value from the unsafe JSON
+     */
+    schema: BaseSchema<ClientRepresentation, ClientRepresentation, BaseSchemaDef<ClientRepresentation>>;
+    /**
+     * Turn the parsed JSON value into something the server can use
+     * @param jsonValue The parsed JSON value
+     * @returns The server representation
+     */
+    toServer: (jsonValue: ClientRepresentation) => ServerRepresentation;
+    /**
+     * Turn the server respresentation back into a JSON value
+     * @param serverValue The value from the server we want to convert back into the client
+     * @returns Convert the data back into a JSON value that the server can understand
+     */
+    toClient: (serverValue: ServerRepresentation) => ClientRepresentation;
+}
+interface ScalarDef<ClientRepresentation extends JSONPrimitive, ServerRepresentation> extends BaseSchemaDef<ClientRepresentation>, ScalarOptions<ClientRepresentation, ServerRepresentation> {
+}
+declare class KScalar<ClientRepresentation extends JSONPrimitive, ServerRepresentation> extends BaseSchema<ClientRepresentation, ServerRepresentation, ScalarDef<ClientRepresentation, ServerRepresentation>> {
+    static create: <ClientRepresentation_1 extends JSONPrimitive, ServerRepresentation_1>(options: ScalarOptions<ClientRepresentation_1, ServerRepresentation_1>) => KScalar<ClientRepresentation_1, ServerRepresentation_1>;
+    constructor(def: ScalarDef<ClientRepresentation, ServerRepresentation>);
+    serialize(value: ServerRepresentation): ClientRepresentation;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<ServerRepresentation>;
+    example(example: ClientRepresentation): this;
+    example(): ClientRepresentation | undefined;
+    description(description: string): this;
+    description(): string | undefined;
+    parse(json: unknown): ServerRepresentation;
+}
+interface UnionDef<Input extends JSONValue, Output> extends BaseSchemaDef<Input> {
+    items: [
+        a: BaseSchema<Input, Output, BaseSchemaDef<Input>>,
+        b: BaseSchema<Input, Output, BaseSchemaDef<Input>>,
+        ...remaining: BaseSchema<Input, Output, BaseSchemaDef<Input>>[]
+    ];
+}
+declare class KUnion<Input extends JSONValue, Output> extends BaseSchema<Input, Output, UnionDef<Input, Output>> {
+    static create: <Items extends [a: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, b: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, ...remaining: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>[]]>(items: Items) => KUnion<Items[number]["_input"], Items[number]["_output"]>;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+}
+interface LiteralDef<Value extends string | number | boolean> extends BaseSchemaDef<Value> {
+    value: Value;
+}
+declare class KLiteral<Value extends string | number | boolean> extends BaseSchema<Value, Value, LiteralDef<Value>> {
+    parse(json: unknown): Value;
+    static create: <Value_1 extends string | number | boolean>(value: Value_1) => KLiteral<Value_1>;
+    serialize(value: Value): Value;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Value>;
+}
+declare const k: {
+    string: () => KString;
+    number: () => KNumber;
+    boolean: () => KBoolean;
+    array: <ItemsInput extends JSONValue, ItemsOutput, Def extends BaseSchemaDef<ItemsInput>>(items: BaseSchema<ItemsInput, ItemsOutput, Def>) => KArray<ItemsInput, ItemsOutput>;
+    null: () => KNull;
+    ref: <Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>>(name: string, shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KRef<Input, Output>;
+    object: <Input extends Record<keyof Output, any>, Output extends Record<keyof Input, any>>(shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KObject<Input, Output>;
+    scalar: <ClientRepresentation extends JSONPrimitive, ServerRepresentation>(options: ScalarOptions<ClientRepresentation, ServerRepresentation>) => KScalar<ClientRepresentation, ServerRepresentation>;
+    literal: <Value extends string | number | boolean>(value: Value) => KLiteral<Value>;
+    union: <Items extends [a: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, b: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, ...remaining: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>[]]>(items: Items) => KUnion<Items[number]["_input"], Items[number]["_output"]>;
+    /**
+     * @internal
+     * @experimental
+     */
+    objectFromURLSearchParams: <Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>>(shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KObjectFromURLSearchParams<Input, Output>;
+};
+
+export { type AnySchemaFor, type ArrayChecks, type ArrayDef, BaseSchema, type BaseSchemaDef, type BooleanDef, type Issue, type JSONPrimitive, type JSONValue, KArray, KBoolean, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRef, KScalar, KString, KUnion, type LiteralDef, type NullDef, type NumberChecks, type NumberDef, type NumberFormat, type ObjectDef, ParseContext, type ParseResult, type RefDef, STRING_FORMAT_REGEXES, type ScalarDef, type ScalarOptions, SchemaError, type StringChecks, type StringDef, type StringFormat, type UnionDef, isPrimitiveJSONValue, k };

package/dist/schema/schema.d.ts

@@ -0,0 +1,333 @@
+import { SchemaObject, ReferenceObject } from 'openapi3-ts/oas31';
+
+type JSONPrimitive = string | number | boolean | null;
+type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+declare function isPrimitiveJSONValue(value: unknown): value is JSONPrimitive;
+interface BaseSchemaDef<Input extends JSONValue> {
+    example?: Input | undefined;
+    description?: string | undefined;
+}
+interface Issue {
+    message: string;
+    path: string[];
+}
+type ParseResult<T> = {
+    success: true;
+    result: T;
+} | {
+    success: false;
+    issues: Set<Issue>;
+};
+declare class SchemaError extends Error {
+    readonly issues: Set<Issue>;
+    constructor(issues: Set<Issue>);
+}
+declare class ParseContext {
+    #private;
+    private static readonly ISSUE;
+    readonly ISSUE: typeof ParseContext.ISSUE;
+    addIssue(message: string, path: string[]): typeof ParseContext.ISSUE;
+    addIssues(issues: Iterable<Issue>, path: string[]): typeof ParseContext.ISSUE;
+    get issues(): Set<Issue>;
+    static result<T>(fn: (ctx: ParseContext) => T | typeof ParseContext.ISSUE): ParseResult<T>;
+    static with<T>(fn: (ctx: ParseContext) => T | typeof ParseContext.ISSUE): {
+        type: "FATAL";
+        issues: Set<Issue>;
+        data?: never;
+    } | {
+        type: "PARSED";
+        issues: Set<Issue>;
+        data: T;
+    };
+}
+type AnySchemaFor<T extends JSONValue> = BaseSchema<T, T, BaseSchemaDef<T>>;
+declare abstract class BaseSchema<Input extends JSONValue, Output, Def extends BaseSchemaDef<Input>> {
+    /** @internal */
+    readonly _input: Input;
+    /** @internal */
+    readonly _output: Output;
+    abstract parse(json: unknown): Output;
+    abstract parseSafe(json: unknown): ParseResult<Output>;
+    abstract serialize(value: Output): Input;
+    protected readonly def: Def;
+    abstract toOpenAPI(): SchemaObject | ReferenceObject;
+    protected getSchemaObject(): SchemaObject;
+    protected clone(def: Partial<Def>): this;
+    protected constructor(def: Def);
+    or<OtherInput extends JSONValue, OtherOutput, Def extends BaseSchemaDef<OtherInput>>(other: BaseSchema<OtherInput, OtherOutput, Def>): KUnion<(this | BaseSchema<OtherInput, OtherOutput, Def>)["_input"], (this | BaseSchema<OtherInput, OtherOutput, Def>)["_output"]>;
+    example(example: Input): this;
+    example(): Input | undefined;
+    description(description: string): this;
+    description(): string | undefined;
+}
+type Check<T extends string, P extends {} = {}> = {
+    type: T;
+    message?: string | undefined;
+} & Omit<P, 'message'>;
+type StringFormat = 'date' | 'date-time' | 'password' | 'byte' | 'binary' | 'email' | 'uuid' | 'uri' | 'hostname' | 'ipv4' | 'ipv6';
+declare const STRING_FORMAT_REGEXES: {
+    readonly uuid: RegExp;
+    readonly email: RegExp;
+    readonly ipv4: RegExp;
+    readonly ipv6: RegExp;
+    readonly date: RegExp;
+    readonly uri: RegExp;
+    readonly hostname: RegExp;
+};
+interface StringChecks {
+    min?: Check<'min', {
+        val: number;
+    }>;
+    max?: Check<'max', {
+        val: number;
+    }>;
+    regex?: Check<'regex', {
+        regex: RegExp;
+    }>;
+    format?: Check<'format', {
+        format: StringFormat;
+    }>;
+    startsWith?: Check<'startsWith', {
+        prefix: string;
+    }>;
+    endsWith?: Check<'endsWith', {
+        suffix: string;
+    }>;
+}
+interface StringDef extends BaseSchemaDef<string>, StringChecks {
+}
+declare class KString extends BaseSchema<string, string, StringDef> {
+    static create: () => KString;
+    serialize(value: string): string;
+    private setCheck;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    /**
+     * Sets the minimum length of the string
+     *
+     * @param min The minimum length of the string
+     * @returns A clone of the schema with the minimum length set
+     */
+    min(min: number, message?: string): this;
+    /**
+     * Sets the maximum length of the string
+     *
+     * @param max The maximum length of the string
+     * @returns A clone of the schema with the maximum length set
+     */
+    max(max: number, message?: string): this;
+    regex(regex: RegExp, message?: string): this;
+    startsWith(prefix: string, message?: string): this;
+    endsWith(suffix: string, message?: string): this;
+    private format;
+    uri(message?: string): this;
+    /**
+     * Deprecated because OpenAPI uses the term "uri"
+     * but this method exists for making migration from
+     * Zod easier.
+     *
+     * @deprecated Use {@link uri} instead
+     */
+    url(message?: string): this;
+    email(message?: string): this;
+    uuid(message?: string): this;
+    ipv4(message?: string): this;
+    ipv6(message?: string): this;
+    date(message?: string): this;
+    dateTime(message?: string): this;
+    password(message?: string): this;
+    byte(message?: string): this;
+    binary(message?: string): this;
+    hostname(message?: string): this;
+    parseSafe(json: unknown): ParseResult<string>;
+    parse(json: unknown): string;
+}
+type NumberFormat = 'float' | 'double' | 'int32' | 'int64';
+interface NumberChecks {
+    min?: Check<'min', {
+        val: number;
+    }>;
+    max?: Check<'max', {
+        val: number;
+    }>;
+    integer?: Check<'integer'>;
+    multipleOf?: Check<'multipleOf', {
+        val: number;
+    }>;
+    format?: Check<'format', {
+        format: NumberFormat;
+    }>;
+}
+interface NumberDef extends BaseSchemaDef<number>, NumberChecks {
+}
+declare class KNumber extends BaseSchema<number, number, NumberDef> {
+    static create: () => KNumber;
+    serialize(value: number): number;
+    private setCheck;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    min(min: number): this;
+    max(max: number): this;
+    integer(): this;
+    multipleOf(multipleOf: number): this;
+    float(): this;
+    double(): this;
+    int32(): this;
+    int64(): this;
+    parseSafe(json: unknown): ParseResult<number>;
+    parse(json: unknown): number;
+}
+interface BooleanDef extends BaseSchemaDef<boolean> {
+}
+declare class KBoolean extends BaseSchema<boolean, boolean, BooleanDef> {
+    static create: () => KBoolean;
+    serialize(value: boolean): boolean;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<boolean>;
+    parse(json: unknown): boolean;
+}
+interface ArrayChecks {
+    minItems?: Check<'minItems', {
+        val: number;
+    }>;
+    maxItems?: Check<'maxItems', {
+        val: number;
+    }>;
+    uniqueItems?: Check<'uniqueItems', {
+        val: boolean;
+    }>;
+}
+interface ArrayDef<Input extends JSONValue, Output> extends BaseSchemaDef<Input[]>, ArrayChecks {
+    items: BaseSchema<Input, Output, BaseSchemaDef<Input>>;
+}
+declare class KArray<Input extends JSONValue, Output> extends BaseSchema<Input[], Output[], ArrayDef<Input, Output>> {
+    static create: <ItemsInput extends JSONValue, ItemsOutput, Def extends BaseSchemaDef<ItemsInput>>(items: BaseSchema<ItemsInput, ItemsOutput, Def>) => KArray<ItemsInput, ItemsOutput>;
+    serialize(value: Output[]): Input[];
+    private setCheck;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    min(minItems: number): this;
+    max(maxItems: number): this;
+    unique(): this;
+    notUnique(): this;
+    parseSafe(json: unknown): ParseResult<Output[]>;
+    parse(json: unknown): Output[];
+}
+interface NullDef extends BaseSchemaDef<null> {
+}
+declare class KNull extends BaseSchema<null, null, NullDef> {
+    static create: () => KNull;
+    serialize(value: null): null;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<null>;
+    parse(json: unknown): null;
+}
+interface ObjectDef<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends BaseSchemaDef<Input> {
+    shape: {
+        [K in keyof Input]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>;
+    };
+}
+declare class KObject<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, any>> extends BaseSchema<Input, Output, ObjectDef<Input, Output>> {
+    static create: <Input_1 extends Record<keyof Output_1, any>, Output_1 extends Record<keyof Input_1, any>>(shape: { [K in keyof Input_1 | keyof Output_1]: BaseSchema<Input_1[K], Output_1[K], BaseSchemaDef<Input_1[K]>>; }) => KObject<Input_1, Output_1>;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+    get shape(): { [K in keyof Input]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; };
+}
+declare class KObjectFromURLSearchParams<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends KObject<Input, Output> {
+    static create: <Input_1 extends Record<keyof Output_1, JSONValue>, Output_1 extends Record<keyof Input_1, JSONValue>>(shape: { [K in keyof Input_1 | keyof Output_1]: BaseSchema<Input_1[K], Output_1[K], BaseSchemaDef<Input_1[K]>>; }) => KObjectFromURLSearchParams<Input_1, Output_1>;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+}
+interface RefDef<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends ObjectDef<Input, Output> {
+    name: string;
+    summary?: string | undefined;
+}
+declare class KRef<Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>> extends BaseSchema<Input, Output, RefDef<Input, Output>> {
+    static create: <Input_1 extends Record<keyof Output_1, JSONValue>, Output_1 extends Record<keyof Input_1, JSONValue>>(name: string, shape: { [K in keyof Input_1 | keyof Output_1]: BaseSchema<Input_1[K], Output_1[K], BaseSchemaDef<Input_1[K]>>; }) => KRef<Input_1, Output_1>;
+    serialize(value: Output): Input;
+    example(): never;
+    toOpenAPI(): ReferenceObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+    summary(): string | undefined;
+    summary(summary: string): this;
+    get shape(): { [K in keyof Input]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; };
+    get name(): string;
+}
+interface ScalarOptions<ClientRepresentation extends JSONValue, ServerRepresentation> {
+    /**
+     * Parse the value from the unsafe JSON
+     */
+    schema: BaseSchema<ClientRepresentation, ClientRepresentation, BaseSchemaDef<ClientRepresentation>>;
+    /**
+     * Turn the parsed JSON value into something the server can use
+     * @param jsonValue The parsed JSON value
+     * @returns The server representation
+     */
+    toServer: (jsonValue: ClientRepresentation) => ServerRepresentation;
+    /**
+     * Turn the server respresentation back into a JSON value
+     * @param serverValue The value from the server we want to convert back into the client
+     * @returns Convert the data back into a JSON value that the server can understand
+     */
+    toClient: (serverValue: ServerRepresentation) => ClientRepresentation;
+}
+interface ScalarDef<ClientRepresentation extends JSONPrimitive, ServerRepresentation> extends BaseSchemaDef<ClientRepresentation>, ScalarOptions<ClientRepresentation, ServerRepresentation> {
+}
+declare class KScalar<ClientRepresentation extends JSONPrimitive, ServerRepresentation> extends BaseSchema<ClientRepresentation, ServerRepresentation, ScalarDef<ClientRepresentation, ServerRepresentation>> {
+    static create: <ClientRepresentation_1 extends JSONPrimitive, ServerRepresentation_1>(options: ScalarOptions<ClientRepresentation_1, ServerRepresentation_1>) => KScalar<ClientRepresentation_1, ServerRepresentation_1>;
+    constructor(def: ScalarDef<ClientRepresentation, ServerRepresentation>);
+    serialize(value: ServerRepresentation): ClientRepresentation;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<ServerRepresentation>;
+    example(example: ClientRepresentation): this;
+    example(): ClientRepresentation | undefined;
+    description(description: string): this;
+    description(): string | undefined;
+    parse(json: unknown): ServerRepresentation;
+}
+interface UnionDef<Input extends JSONValue, Output> extends BaseSchemaDef<Input> {
+    items: [
+        a: BaseSchema<Input, Output, BaseSchemaDef<Input>>,
+        b: BaseSchema<Input, Output, BaseSchemaDef<Input>>,
+        ...remaining: BaseSchema<Input, Output, BaseSchemaDef<Input>>[]
+    ];
+}
+declare class KUnion<Input extends JSONValue, Output> extends BaseSchema<Input, Output, UnionDef<Input, Output>> {
+    static create: <Items extends [a: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, b: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, ...remaining: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>[]]>(items: Items) => KUnion<Items[number]["_input"], Items[number]["_output"]>;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+}
+interface LiteralDef<Value extends string | number | boolean> extends BaseSchemaDef<Value> {
+    value: Value;
+}
+declare class KLiteral<Value extends string | number | boolean> extends BaseSchema<Value, Value, LiteralDef<Value>> {
+    parse(json: unknown): Value;
+    static create: <Value_1 extends string | number | boolean>(value: Value_1) => KLiteral<Value_1>;
+    serialize(value: Value): Value;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Value>;
+}
+declare const k: {
+    string: () => KString;
+    number: () => KNumber;
+    boolean: () => KBoolean;
+    array: <ItemsInput extends JSONValue, ItemsOutput, Def extends BaseSchemaDef<ItemsInput>>(items: BaseSchema<ItemsInput, ItemsOutput, Def>) => KArray<ItemsInput, ItemsOutput>;
+    null: () => KNull;
+    ref: <Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>>(name: string, shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KRef<Input, Output>;
+    object: <Input extends Record<keyof Output, any>, Output extends Record<keyof Input, any>>(shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KObject<Input, Output>;
+    scalar: <ClientRepresentation extends JSONPrimitive, ServerRepresentation>(options: ScalarOptions<ClientRepresentation, ServerRepresentation>) => KScalar<ClientRepresentation, ServerRepresentation>;
+    literal: <Value extends string | number | boolean>(value: Value) => KLiteral<Value>;
+    union: <Items extends [a: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, b: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>, ...remaining: BaseSchema<JSONValue, unknown, BaseSchemaDef<JSONValue>>[]]>(items: Items) => KUnion<Items[number]["_input"], Items[number]["_output"]>;
+    /**
+     * @internal
+     * @experimental
+     */
+    objectFromURLSearchParams: <Input extends Record<keyof Output, JSONValue>, Output extends Record<keyof Input, JSONValue>>(shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KObjectFromURLSearchParams<Input, Output>;
+};
+
+export { type AnySchemaFor, type ArrayChecks, type ArrayDef, BaseSchema, type BaseSchemaDef, type BooleanDef, type Issue, type JSONPrimitive, type JSONValue, KArray, KBoolean, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRef, KScalar, KString, KUnion, type LiteralDef, type NullDef, type NumberChecks, type NumberDef, type NumberFormat, type ObjectDef, ParseContext, type ParseResult, type RefDef, STRING_FORMAT_REGEXES, type ScalarDef, type ScalarOptions, SchemaError, type StringChecks, type StringDef, type StringFormat, type UnionDef, isPrimitiveJSONValue, k };