@kaito-http/core 4.0.0-beta.25 → 4.0.0-beta.27

package/dist/{chunk-IEGYJT4R.js → chunk-BJVNFSCY.js}

@@ -830,6 +830,88 @@ var KLiteral = class _KLiteral extends BaseSchema {
   visit() {
   }
 };
+var KRecord = class _KRecord extends BaseSchema {
+  static create = (keys, values) => new _KRecord({ keys, values });
+  serialize(value) {
+    const result = {};
+    for (const key in value) {
+      if (!Object.prototype.hasOwnProperty.call(value, key)) continue;
+      const keySerialize = this.def.keys.serialize(key);
+      const valueSerialize = this.def.values.serialize(value[key]);
+      result[keySerialize] = valueSerialize;
+    }
+    return result;
+  }
+  toOpenAPI() {
+    const baseSchema = this.getSchemaObject();
+    return {
+      ...baseSchema,
+      type: "object",
+      propertyNames: this.def.keys.toOpenAPI(),
+      additionalProperties: this.def.values.toOpenAPI()
+    };
+  }
+  parseSafe(json) {
+    return ParseContext.result((ctx) => {
+      if (typeof json !== "object" || json === null || Array.isArray(json)) {
+        return ctx.addIssue("Expected object", []);
+      }
+      const result = {};
+      for (const key in json) {
+        if (!Object.prototype.hasOwnProperty.call(json, key)) continue;
+        const keyParse = this.def.keys.parseSafe(key);
+        if (!keyParse.success) {
+          return ctx.addIssues(keyParse.issues, [key]);
+        }
+        const value = json[keyParse.result];
+        const valueParse = this.def.values.parseSafe(value);
+        if (!valueParse.success) {
+          return ctx.addIssues(valueParse.issues, [key]);
+        }
+        result[keyParse.result] = valueParse.result;
+      }
+      return result;
+    });
+  }
+  parse(json) {
+    const result = this.parseSafe(json);
+    if (!result.success) {
+      throw new SchemaError(result.issues);
+    }
+    return result.result;
+  }
+  visit(visitor) {
+    visitor(this.def.keys);
+    visitor(this.def.values);
+  }
+};
+var KLazy = class _KLazy extends BaseSchema {
+  schema;
+  static create = (getter) => new _KLazy({ getter });
+  getSchema() {
+    if (!this.schema) {
+      this.schema = this.def.getter();
+    }
+    return this.schema;
+  }
+  serialize(value) {
+    return this.getSchema().serialize(value);
+  }
+  toOpenAPI() {
+    return this.getSchema().toOpenAPI();
+  }
+  parseSafe(json) {
+    return this.getSchema().parseSafe(json);
+  }
+  parse(json) {
+    return this.getSchema().parse(json);
+  }
+  visit(visitor) {
+    const schema = this.getSchema();
+    visitor(schema);
+    schema.visit(visitor);
+  }
+};
 var k = {
   string: KString.create,
   number: KNumber.create,
@@ -837,10 +919,21 @@ var k = {
   array: KArray.create,
   null: KNull.create,
   ref: KRef.create,
+  record: KRecord.create,
   object: KObject.create,
   scalar: KScalar.create,
   literal: KLiteral.create,
   union: KUnion.create,
+  lazy: KLazy.create,
+  /**
+   * Schema for any valid JSON value
+   */
+  json: () => {
+    const jsonSchema = k.lazy(
+      () => k.union([k.string(), k.number(), k.boolean(), k.null(), k.array(jsonSchema), k.record(k.string(), jsonSchema)])
+    );
+    return jsonSchema;
+  },
   /**
    * @internal
    * @experimental
@@ -865,5 +958,7 @@ export {
   KScalar,
   KUnion,
   KLiteral,
+  KRecord,
+  KLazy,
   k
 };

package/dist/index.cjs

@@ -23,11 +23,13 @@ __export(index_exports, {
   BaseSchema: () => BaseSchema,
   KArray: () => KArray,
   KBoolean: () => KBoolean,
+  KLazy: () => KLazy,
   KLiteral: () => KLiteral,
   KNull: () => KNull,
   KNumber: () => KNumber,
   KObject: () => KObject,
   KObjectFromURLSearchParams: () => KObjectFromURLSearchParams,
+  KRecord: () => KRecord,
   KRef: () => KRef,
   KScalar: () => KScalar,
   KString: () => KString,
@@ -988,6 +990,88 @@ var KLiteral = class _KLiteral extends BaseSchema {
   visit() {
   }
 };
+var KRecord = class _KRecord extends BaseSchema {
+  static create = (keys, values) => new _KRecord({ keys, values });
+  serialize(value) {
+    const result = {};
+    for (const key in value) {
+      if (!Object.prototype.hasOwnProperty.call(value, key)) continue;
+      const keySerialize = this.def.keys.serialize(key);
+      const valueSerialize = this.def.values.serialize(value[key]);
+      result[keySerialize] = valueSerialize;
+    }
+    return result;
+  }
+  toOpenAPI() {
+    const baseSchema = this.getSchemaObject();
+    return {
+      ...baseSchema,
+      type: "object",
+      propertyNames: this.def.keys.toOpenAPI(),
+      additionalProperties: this.def.values.toOpenAPI()
+    };
+  }
+  parseSafe(json) {
+    return ParseContext.result((ctx) => {
+      if (typeof json !== "object" || json === null || Array.isArray(json)) {
+        return ctx.addIssue("Expected object", []);
+      }
+      const result = {};
+      for (const key in json) {
+        if (!Object.prototype.hasOwnProperty.call(json, key)) continue;
+        const keyParse = this.def.keys.parseSafe(key);
+        if (!keyParse.success) {
+          return ctx.addIssues(keyParse.issues, [key]);
+        }
+        const value = json[keyParse.result];
+        const valueParse = this.def.values.parseSafe(value);
+        if (!valueParse.success) {
+          return ctx.addIssues(valueParse.issues, [key]);
+        }
+        result[keyParse.result] = valueParse.result;
+      }
+      return result;
+    });
+  }
+  parse(json) {
+    const result = this.parseSafe(json);
+    if (!result.success) {
+      throw new SchemaError(result.issues);
+    }
+    return result.result;
+  }
+  visit(visitor) {
+    visitor(this.def.keys);
+    visitor(this.def.values);
+  }
+};
+var KLazy = class _KLazy extends BaseSchema {
+  schema;
+  static create = (getter) => new _KLazy({ getter });
+  getSchema() {
+    if (!this.schema) {
+      this.schema = this.def.getter();
+    }
+    return this.schema;
+  }
+  serialize(value) {
+    return this.getSchema().serialize(value);
+  }
+  toOpenAPI() {
+    return this.getSchema().toOpenAPI();
+  }
+  parseSafe(json) {
+    return this.getSchema().parseSafe(json);
+  }
+  parse(json) {
+    return this.getSchema().parse(json);
+  }
+  visit(visitor) {
+    const schema = this.getSchema();
+    visitor(schema);
+    schema.visit(visitor);
+  }
+};
 var k = {
   string: KString.create,
   number: KNumber.create,
@@ -995,10 +1079,21 @@ var k = {
   array: KArray.create,
   null: KNull.create,
   ref: KRef.create,
+  record: KRecord.create,
   object: KObject.create,
   scalar: KScalar.create,
   literal: KLiteral.create,
   union: KUnion.create,
+  lazy: KLazy.create,
+  /**
+   * Schema for any valid JSON value
+   */
+  json: () => {
+    const jsonSchema = k.lazy(
+      () => k.union([k.string(), k.number(), k.boolean(), k.null(), k.array(jsonSchema), k.record(k.string(), jsonSchema)])
+    );
+    return jsonSchema;
+  },
   /**
    * @internal
    * @experimental
@@ -1213,11 +1308,12 @@ var Router = class _Router {
     const addSchemaForRef = (ref) => {
       const name = ref.name;
       const properties = Object.fromEntries(Object.entries(ref.shape).map(([key, value]) => [key, value.toOpenAPI()]));
+      const desc = ref.description();
       const schemaObject = {
         type: "object",
         properties,
         required: Object.keys(ref.shape),
-        ...ref.description() ? { description: ref.description() } : {}
+        ...desc ? { description: desc } : {}
       };
       const existing = componentsSchemas[name];
       if (existing) {
@@ -1327,11 +1423,13 @@ var create = Router.create;
   BaseSchema,
   KArray,
   KBoolean,
+  KLazy,
   KLiteral,
   KNull,
   KNumber,
   KObject,
   KObjectFromURLSearchParams,
+  KRecord,
   KRef,
   KScalar,
   KString,

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as OpenAPI from 'openapi3-ts/oas31';
 import { JSONValue as JSONValue$1, AnySchemaFor, BaseSchema, BaseSchemaDef } from './schema/schema.cjs';
-export { ArrayChecks, ArrayDef, BooleanDef, Issue, JSONPrimitive, KArray, KBoolean, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRef, KScalar, KString, KUnion, LiteralDef, NullDef, NumberChecks, NumberDef, NumberFormat, ObjectDef, ParseContext, ParseResult, RefDef, STRING_FORMAT_REGEXES, ScalarDef, ScalarOptions, SchemaError, StringChecks, StringDef, StringFormat, UnionDef, isPrimitiveJSONValue, k } from './schema/schema.cjs';
+export { ArrayChecks, ArrayDef, BooleanDef, Issue, JSONPrimitive, KArray, KBoolean, KLazy, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRecord, KRef, KScalar, KString, KUnion, LazyDef, LiteralDef, NullDef, NumberChecks, NumberDef, NumberFormat, ObjectDef, ParseContext, ParseResult, RecordDef, RefDef, STRING_FORMAT_REGEXES, ScalarDef, ScalarOptions, SchemaError, StringChecks, StringDef, StringFormat, UnionDef, isPrimitiveJSONValue, k } from './schema/schema.cjs';
 import { KaitoSSEResponse } from './stream/stream.cjs';
 
 declare class WrappedError<T> extends Error {
@@ -158,11 +158,7 @@ type JSONOutputSpec<ResultInput, ResultOutput extends JSONValue$1> = {
     schema: BaseSchema<ResultOutput, ResultInput, BaseSchemaDef<ResultOutput>>;
     description?: string | undefined;
 };
-type OutputSpec<ResultInput, ResultOutput> = ResultInput extends KaitoSSEResponse<infer R> ? SSEOutputSpec<Extract<R, JSONValue$1>> & {
-    description?: string;
-} : JSONOutputSpec<ResultOutput, Extract<ResultInput, JSONValue$1>> & {
-    description?: string;
-};
+type OutputSpec<ResultInput, ResultOutput> = ResultInput extends KaitoSSEResponse<infer R> ? SSEOutputSpec<Extract<R, JSONValue$1>> : JSONOutputSpec<ResultOutput, Extract<ResultInput, JSONValue$1>>;
 type Route<ContextFrom, ContextTo, RouterInput extends readonly unknown[], ResultInput, ResultOutput, Path extends string, AdditionalParams extends string, Method extends KaitoMethod, Query extends Record<string, JSONValue$1>, Body extends JSONValue$1> = {
     body?: AnySchemaFor<Body>;
     query?: {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as OpenAPI from 'openapi3-ts/oas31';
 import { JSONValue as JSONValue$1, AnySchemaFor, BaseSchema, BaseSchemaDef } from './schema/schema.js';
-export { ArrayChecks, ArrayDef, BooleanDef, Issue, JSONPrimitive, KArray, KBoolean, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRef, KScalar, KString, KUnion, LiteralDef, NullDef, NumberChecks, NumberDef, NumberFormat, ObjectDef, ParseContext, ParseResult, RefDef, STRING_FORMAT_REGEXES, ScalarDef, ScalarOptions, SchemaError, StringChecks, StringDef, StringFormat, UnionDef, isPrimitiveJSONValue, k } from './schema/schema.js';
+export { ArrayChecks, ArrayDef, BooleanDef, Issue, JSONPrimitive, KArray, KBoolean, KLazy, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRecord, KRef, KScalar, KString, KUnion, LazyDef, LiteralDef, NullDef, NumberChecks, NumberDef, NumberFormat, ObjectDef, ParseContext, ParseResult, RecordDef, RefDef, STRING_FORMAT_REGEXES, ScalarDef, ScalarOptions, SchemaError, StringChecks, StringDef, StringFormat, UnionDef, isPrimitiveJSONValue, k } from './schema/schema.js';
 import { KaitoSSEResponse } from './stream/stream.js';
 
 declare class WrappedError<T> extends Error {
@@ -158,11 +158,7 @@ type JSONOutputSpec<ResultInput, ResultOutput extends JSONValue$1> = {
     schema: BaseSchema<ResultOutput, ResultInput, BaseSchemaDef<ResultOutput>>;
     description?: string | undefined;
 };
-type OutputSpec<ResultInput, ResultOutput> = ResultInput extends KaitoSSEResponse<infer R> ? SSEOutputSpec<Extract<R, JSONValue$1>> & {
-    description?: string;
-} : JSONOutputSpec<ResultOutput, Extract<ResultInput, JSONValue$1>> & {
-    description?: string;
-};
+type OutputSpec<ResultInput, ResultOutput> = ResultInput extends KaitoSSEResponse<infer R> ? SSEOutputSpec<Extract<R, JSONValue$1>> : JSONOutputSpec<ResultOutput, Extract<ResultInput, JSONValue$1>>;
 type Route<ContextFrom, ContextTo, RouterInput extends readonly unknown[], ResultInput, ResultOutput, Path extends string, AdditionalParams extends string, Method extends KaitoMethod, Query extends Record<string, JSONValue$1>, Body extends JSONValue$1> = {
     body?: AnySchemaFor<Body>;
     query?: {

package/dist/index.js

@@ -2,11 +2,13 @@ import {
   BaseSchema,
   KArray,
   KBoolean,
+  KLazy,
   KLiteral,
   KNull,
   KNumber,
   KObject,
   KObjectFromURLSearchParams,
+  KRecord,
   KRef,
   KScalar,
   KString,
@@ -16,7 +18,7 @@ import {
   SchemaError,
   isPrimitiveJSONValue,
   k
-} from "./chunk-IEGYJT4R.js";
+} from "./chunk-BJVNFSCY.js";
 
 // src/router/router.ts
 import "openapi3-ts/oas31";
@@ -334,11 +336,12 @@ var Router = class _Router {
     const addSchemaForRef = (ref) => {
       const name = ref.name;
       const properties = Object.fromEntries(Object.entries(ref.shape).map(([key, value]) => [key, value.toOpenAPI()]));
+      const desc = ref.description();
       const schemaObject = {
         type: "object",
         properties,
         required: Object.keys(ref.shape),
-        ...ref.description() ? { description: ref.description() } : {}
+        ...desc ? { description: desc } : {}
       };
       const existing = componentsSchemas[name];
       if (existing) {
@@ -447,11 +450,13 @@ export {
   BaseSchema,
   KArray,
   KBoolean,
+  KLazy,
   KLiteral,
   KNull,
   KNumber,
   KObject,
   KObjectFromURLSearchParams,
+  KRecord,
   KRef,
   KScalar,
   KString,

package/dist/schema/schema.cjs

@@ -23,11 +23,13 @@ __export(schema_exports, {
   BaseSchema: () => BaseSchema,
   KArray: () => KArray,
   KBoolean: () => KBoolean,
+  KLazy: () => KLazy,
   KLiteral: () => KLiteral,
   KNull: () => KNull,
   KNumber: () => KNumber,
   KObject: () => KObject,
   KObjectFromURLSearchParams: () => KObjectFromURLSearchParams,
+  KRecord: () => KRecord,
   KRef: () => KRef,
   KScalar: () => KScalar,
   KString: () => KString,
@@ -870,6 +872,88 @@ var KLiteral = class _KLiteral extends BaseSchema {
   visit() {
   }
 };
+var KRecord = class _KRecord extends BaseSchema {
+  static create = (keys, values) => new _KRecord({ keys, values });
+  serialize(value) {
+    const result = {};
+    for (const key in value) {
+      if (!Object.prototype.hasOwnProperty.call(value, key)) continue;
+      const keySerialize = this.def.keys.serialize(key);
+      const valueSerialize = this.def.values.serialize(value[key]);
+      result[keySerialize] = valueSerialize;
+    }
+    return result;
+  }
+  toOpenAPI() {
+    const baseSchema = this.getSchemaObject();
+    return {
+      ...baseSchema,
+      type: "object",
+      propertyNames: this.def.keys.toOpenAPI(),
+      additionalProperties: this.def.values.toOpenAPI()
+    };
+  }
+  parseSafe(json) {
+    return ParseContext.result((ctx) => {
+      if (typeof json !== "object" || json === null || Array.isArray(json)) {
+        return ctx.addIssue("Expected object", []);
+      }
+      const result = {};
+      for (const key in json) {
+        if (!Object.prototype.hasOwnProperty.call(json, key)) continue;
+        const keyParse = this.def.keys.parseSafe(key);
+        if (!keyParse.success) {
+          return ctx.addIssues(keyParse.issues, [key]);
+        }
+        const value = json[keyParse.result];
+        const valueParse = this.def.values.parseSafe(value);
+        if (!valueParse.success) {
+          return ctx.addIssues(valueParse.issues, [key]);
+        }
+        result[keyParse.result] = valueParse.result;
+      }
+      return result;
+    });
+  }
+  parse(json) {
+    const result = this.parseSafe(json);
+    if (!result.success) {
+      throw new SchemaError(result.issues);
+    }
+    return result.result;
+  }
+  visit(visitor) {
+    visitor(this.def.keys);
+    visitor(this.def.values);
+  }
+};
+var KLazy = class _KLazy extends BaseSchema {
+  schema;
+  static create = (getter) => new _KLazy({ getter });
+  getSchema() {
+    if (!this.schema) {
+      this.schema = this.def.getter();
+    }
+    return this.schema;
+  }
+  serialize(value) {
+    return this.getSchema().serialize(value);
+  }
+  toOpenAPI() {
+    return this.getSchema().toOpenAPI();
+  }
+  parseSafe(json) {
+    return this.getSchema().parseSafe(json);
+  }
+  parse(json) {
+    return this.getSchema().parse(json);
+  }
+  visit(visitor) {
+    const schema = this.getSchema();
+    visitor(schema);
+    schema.visit(visitor);
+  }
+};
 var k = {
   string: KString.create,
   number: KNumber.create,
@@ -877,10 +961,21 @@ var k = {
   array: KArray.create,
   null: KNull.create,
   ref: KRef.create,
+  record: KRecord.create,
   object: KObject.create,
   scalar: KScalar.create,
   literal: KLiteral.create,
   union: KUnion.create,
+  lazy: KLazy.create,
+  /**
+   * Schema for any valid JSON value
+   */
+  json: () => {
+    const jsonSchema = k.lazy(
+      () => k.union([k.string(), k.number(), k.boolean(), k.null(), k.array(jsonSchema), k.record(k.string(), jsonSchema)])
+    );
+    return jsonSchema;
+  },
   /**
    * @internal
    * @experimental
@@ -892,11 +987,13 @@ var k = {
   BaseSchema,
   KArray,
   KBoolean,
+  KLazy,
   KLiteral,
   KNull,
   KNumber,
   KObject,
   KObjectFromURLSearchParams,
+  KRecord,
   KRef,
   KScalar,
   KString,

package/dist/schema/schema.d.cts

@@ -53,7 +53,10 @@ declare abstract class BaseSchema<Input extends JSONValue, Output, Def extends B
     abstract serialize(value: Output): Input;
     protected readonly def: Def;
     abstract toOpenAPI(): SchemaObject | ReferenceObject;
-    protected getSchemaObject(): SchemaObject;
+    protected getSchemaObject(): {
+        description?: string;
+        example?: Input;
+    };
     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"]>;
@@ -322,6 +325,31 @@ declare class KLiteral<Value extends string | number | boolean> extends BaseSche
     parseSafe(json: unknown): ParseResult<Value>;
     visit(): void;
 }
+interface RecordDef<KeyInput extends string, KeyOutput extends string, ValueInput extends JSONValue, ValueOutput> extends BaseSchemaDef<Record<KeyInput, ValueInput>> {
+    keys: BaseSchema<KeyInput, KeyOutput, BaseSchemaDef<KeyInput>>;
+    values: BaseSchema<ValueInput, ValueOutput, BaseSchemaDef<ValueInput>>;
+}
+declare class KRecord<KeyInput extends string, KeyOutput extends string, ValueInput extends JSONValue, ValueOutput> extends BaseSchema<Record<KeyInput, ValueInput>, Record<KeyOutput, ValueOutput>, RecordDef<KeyInput, KeyOutput, ValueInput, ValueOutput>> {
+    static create: <KeyInput_1 extends string, KeyOutput_1 extends string, ValueInput_1 extends JSONValue, ValueOutput_1>(keys: BaseSchema<KeyInput_1, KeyOutput_1, BaseSchemaDef<KeyInput_1>>, values: BaseSchema<ValueInput_1, ValueOutput_1, BaseSchemaDef<ValueInput_1>>) => KRecord<KeyInput_1, KeyOutput_1, ValueInput_1, ValueOutput_1>;
+    serialize(value: Record<KeyOutput, ValueOutput>): Record<KeyInput, ValueInput>;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Record<KeyOutput, ValueOutput>>;
+    parse(json: unknown): Record<KeyOutput, ValueOutput>;
+    visit(visitor: (schema: BaseSchema<any, any, any>) => void): void;
+}
+interface LazyDef<Input extends JSONValue, Output> extends BaseSchemaDef<Input> {
+    getter: () => BaseSchema<Input, Output, BaseSchemaDef<Input>>;
+}
+declare class KLazy<Input extends JSONValue, Output> extends BaseSchema<Input, Output, LazyDef<Input, Output>> {
+    private schema?;
+    static create: <Input_1 extends JSONValue, Output_1>(getter: () => BaseSchema<Input_1, Output_1, BaseSchemaDef<Input_1>>) => KLazy<Input_1, Output_1>;
+    private getSchema;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+    visit(visitor: (schema: BaseSchema<any, any, any>) => void): void;
+}
 declare const k: {
     string: () => KString;
     number: () => KNumber;
@@ -329,10 +357,16 @@ declare const k: {
     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, any>>(name: string, shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KRef<Input, Output>;
+    record: <KeyInput extends string, KeyOutput extends string, ValueInput extends JSONValue, ValueOutput>(keys: BaseSchema<KeyInput, KeyOutput, BaseSchemaDef<KeyInput>>, values: BaseSchema<ValueInput, ValueOutput, BaseSchemaDef<ValueInput>>) => KRecord<KeyInput, KeyOutput, ValueInput, ValueOutput>;
     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"]>;
+    lazy: <Input extends JSONValue, Output>(getter: () => BaseSchema<Input, Output, BaseSchemaDef<Input>>) => KLazy<Input, Output>;
+    /**
+     * Schema for any valid JSON value
+     */
+    json: () => BaseSchema<JSONValue, JSONValue, BaseSchemaDef<JSONValue>>;
     /**
      * @internal
      * @experimental
@@ -340,4 +374,4 @@ declare const k: {
     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 };
+export { type AnySchemaFor, type ArrayChecks, type ArrayDef, BaseSchema, type BaseSchemaDef, type BooleanDef, type Issue, type JSONPrimitive, type JSONValue, KArray, KBoolean, KLazy, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRecord, KRef, KScalar, KString, KUnion, type LazyDef, type LiteralDef, type NullDef, type NumberChecks, type NumberDef, type NumberFormat, type ObjectDef, ParseContext, type ParseResult, type RecordDef, 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

@@ -53,7 +53,10 @@ declare abstract class BaseSchema<Input extends JSONValue, Output, Def extends B
     abstract serialize(value: Output): Input;
     protected readonly def: Def;
     abstract toOpenAPI(): SchemaObject | ReferenceObject;
-    protected getSchemaObject(): SchemaObject;
+    protected getSchemaObject(): {
+        description?: string;
+        example?: Input;
+    };
     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"]>;
@@ -322,6 +325,31 @@ declare class KLiteral<Value extends string | number | boolean> extends BaseSche
     parseSafe(json: unknown): ParseResult<Value>;
     visit(): void;
 }
+interface RecordDef<KeyInput extends string, KeyOutput extends string, ValueInput extends JSONValue, ValueOutput> extends BaseSchemaDef<Record<KeyInput, ValueInput>> {
+    keys: BaseSchema<KeyInput, KeyOutput, BaseSchemaDef<KeyInput>>;
+    values: BaseSchema<ValueInput, ValueOutput, BaseSchemaDef<ValueInput>>;
+}
+declare class KRecord<KeyInput extends string, KeyOutput extends string, ValueInput extends JSONValue, ValueOutput> extends BaseSchema<Record<KeyInput, ValueInput>, Record<KeyOutput, ValueOutput>, RecordDef<KeyInput, KeyOutput, ValueInput, ValueOutput>> {
+    static create: <KeyInput_1 extends string, KeyOutput_1 extends string, ValueInput_1 extends JSONValue, ValueOutput_1>(keys: BaseSchema<KeyInput_1, KeyOutput_1, BaseSchemaDef<KeyInput_1>>, values: BaseSchema<ValueInput_1, ValueOutput_1, BaseSchemaDef<ValueInput_1>>) => KRecord<KeyInput_1, KeyOutput_1, ValueInput_1, ValueOutput_1>;
+    serialize(value: Record<KeyOutput, ValueOutput>): Record<KeyInput, ValueInput>;
+    toOpenAPI(): SchemaObject;
+    parseSafe(json: unknown): ParseResult<Record<KeyOutput, ValueOutput>>;
+    parse(json: unknown): Record<KeyOutput, ValueOutput>;
+    visit(visitor: (schema: BaseSchema<any, any, any>) => void): void;
+}
+interface LazyDef<Input extends JSONValue, Output> extends BaseSchemaDef<Input> {
+    getter: () => BaseSchema<Input, Output, BaseSchemaDef<Input>>;
+}
+declare class KLazy<Input extends JSONValue, Output> extends BaseSchema<Input, Output, LazyDef<Input, Output>> {
+    private schema?;
+    static create: <Input_1 extends JSONValue, Output_1>(getter: () => BaseSchema<Input_1, Output_1, BaseSchemaDef<Input_1>>) => KLazy<Input_1, Output_1>;
+    private getSchema;
+    serialize(value: Output): Input;
+    toOpenAPI(): SchemaObject | ReferenceObject;
+    parseSafe(json: unknown): ParseResult<Output>;
+    parse(json: unknown): Output;
+    visit(visitor: (schema: BaseSchema<any, any, any>) => void): void;
+}
 declare const k: {
     string: () => KString;
     number: () => KNumber;
@@ -329,10 +357,16 @@ declare const k: {
     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, any>>(name: string, shape: { [K in keyof Input | keyof Output]: BaseSchema<Input[K], Output[K], BaseSchemaDef<Input[K]>>; }) => KRef<Input, Output>;
+    record: <KeyInput extends string, KeyOutput extends string, ValueInput extends JSONValue, ValueOutput>(keys: BaseSchema<KeyInput, KeyOutput, BaseSchemaDef<KeyInput>>, values: BaseSchema<ValueInput, ValueOutput, BaseSchemaDef<ValueInput>>) => KRecord<KeyInput, KeyOutput, ValueInput, ValueOutput>;
     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"]>;
+    lazy: <Input extends JSONValue, Output>(getter: () => BaseSchema<Input, Output, BaseSchemaDef<Input>>) => KLazy<Input, Output>;
+    /**
+     * Schema for any valid JSON value
+     */
+    json: () => BaseSchema<JSONValue, JSONValue, BaseSchemaDef<JSONValue>>;
     /**
      * @internal
      * @experimental
@@ -340,4 +374,4 @@ declare const k: {
     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 };
+export { type AnySchemaFor, type ArrayChecks, type ArrayDef, BaseSchema, type BaseSchemaDef, type BooleanDef, type Issue, type JSONPrimitive, type JSONValue, KArray, KBoolean, KLazy, KLiteral, KNull, KNumber, KObject, KObjectFromURLSearchParams, KRecord, KRef, KScalar, KString, KUnion, type LazyDef, type LiteralDef, type NullDef, type NumberChecks, type NumberDef, type NumberFormat, type ObjectDef, ParseContext, type ParseResult, type RecordDef, type RefDef, STRING_FORMAT_REGEXES, type ScalarDef, type ScalarOptions, SchemaError, type StringChecks, type StringDef, type StringFormat, type UnionDef, isPrimitiveJSONValue, k };

package/dist/schema/schema.js

@@ -2,11 +2,13 @@ import {
   BaseSchema,
   KArray,
   KBoolean,
+  KLazy,
   KLiteral,
   KNull,
   KNumber,
   KObject,
   KObjectFromURLSearchParams,
+  KRecord,
   KRef,
   KScalar,
   KString,
@@ -16,16 +18,18 @@ import {
   SchemaError,
   isPrimitiveJSONValue,
   k
-} from "../chunk-IEGYJT4R.js";
+} from "../chunk-BJVNFSCY.js";
 export {
   BaseSchema,
   KArray,
   KBoolean,
+  KLazy,
   KLiteral,
   KNull,
   KNumber,
   KObject,
   KObjectFromURLSearchParams,
+  KRecord,
   KRef,
   KScalar,
   KString,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kaito-http/core",
   "type": "module",
-  "version": "4.0.0-beta.25",
+  "version": "4.0.0-beta.27",
   "author": "Alistair Smith <hi@alistair.sh>",
   "repository": "https://github.com/kaito-http/kaito",
   "dependencies": {