@kaito-http/core 4.0.0-beta.24 → 4.0.0-beta.26

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,
@@ -101,14 +103,14 @@ var KaitoHead = class {
    * @param body The Kaito JSON format to be sent as the response body
    * @returns A Response instance, ready to be sent
    */
-  toResponse(body) {
+  toResponse(data) {
     const init = {
       status: this.#status
     };
     if (this.#headers) {
       init.headers = this.#headers;
     }
-    return Response.json(body, init);
+    return Response.json(data, init);
   }
   /**
    * Whether this KaitoHead instance has been touched/modified
@@ -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
@@ -1093,12 +1188,7 @@ var Router = class _Router {
       const method = req.method;
       const { route, params: rawParams } = findRoute(method, url.pathname);
       if (!route) {
-        const body = {
-          success: false,
-          data: null,
-          message: `Cannot ${method} ${url.pathname}`
-        };
-        return Response.json(body, { status: 404 });
+        return Response.json({ message: `Cannot ${method} ${url.pathname}` }, { status: 404 });
       }
       const request = new KaitoRequest(url, req);
       const head = new KaitoHead();
@@ -1136,44 +1226,30 @@ var Router = class _Router {
             );
           }
           const parsed = route.openapi.schema.serialize(result);
-          return head.toResponse({
-            success: true,
-            data: parsed
-          });
+          return head.toResponse(parsed);
         }
-        return head.toResponse({
-          success: true,
-          data: result
-        });
+        return head.toResponse(result);
       } catch (e) {
         const error = WrappedError.maybe(e);
         if (error instanceof KaitoError) {
           return head.status(error.status).toResponse({
-            success: false,
-            data: null,
             message: error.message
           });
         }
         if (!this.#state.config.onError) {
           return head.status(500).toResponse({
-            success: false,
-            data: null,
             message: "Internal Server Error"
           });
         }
         try {
           const { status, message } = await this.#state.config.onError(error, request);
           return head.status(status).toResponse({
-            success: false,
-            data: null,
             message
           });
         } catch (e2) {
           console.error("[Kaito] Failed to handle error inside `.onError()`, returning 500 and Internal Server Error");
           console.error(e2);
           return head.status(500).toResponse({
-            success: false,
-            data: null,
             message: "Internal Server Error"
           });
         }
@@ -1202,6 +1278,27 @@ var Router = class _Router {
       return response;
     };
   };
+  /**
+   * Create a `/openapi.json` route on this router.
+   *
+   * Any routes defined AFTER this method call will NOT be included in the
+   * file. This is because all methods in Kaito are immutable, so there's no
+   * way for the router to know about routes that were created in the future
+   * on another router.
+   *
+   * @example
+   * ```ts
+   * router.get("/", () => "hey").openapi({
+   * 	info: {
+   * 		title: "My API",
+   * 		version: "1.0.0",
+   * 	},
+   * });
+   * ```
+   *
+   * @param options Options object
+   * @returns
+   */
   openapi = ({
     info,
     servers
@@ -1264,10 +1361,7 @@ var Router = class _Router {
             description: route.openapi?.description ?? "Successful response",
             content: {
               [contentType]: {
-                schema: k.object({
-                  success: k.literal(true),
-                  data: route.openapi.schema
-                }).toOpenAPI()
+                schema: route.openapi.schema.toOpenAPI()
               }
             }
           }
@@ -1328,11 +1422,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, 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';
+import { JSONValue as JSONValue$1, AnySchemaFor, BaseSchema, BaseSchemaDef } 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 {
@@ -29,6 +29,11 @@ declare class KaitoRequest {
     get request(): Request;
 }
 
+type JSONPrimitive = string | number | boolean | null;
+type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+
 /**
  * This class is merely a wrapper around a `Headers` object and a status code.
  * It's used while the router is executing a route to store any mutations to the status
@@ -67,7 +72,7 @@ declare class KaitoHead {
      * @param body The Kaito JSON format to be sent as the response body
      * @returns A Response instance, ready to be sent
      */
-    toResponse<T>(body: APIResponse<T>): Response;
+    toResponse<T extends JSONValue>(data: T): Response;
     /**
      * Whether this KaitoHead instance has been touched/modified
      */
@@ -97,18 +102,39 @@ declare class Router<ContextFrom, ContextTo, RequiredParams extends string, Rout
         params: Record<string, string>;
     };
     serve: () => (request: Request, ...args: Input) => Promise<Response>;
+    /**
+     * Create a `/openapi.json` route on this router.
+     *
+     * Any routes defined AFTER this method call will NOT be included in the
+     * file. This is because all methods in Kaito are immutable, so there's no
+     * way for the router to know about routes that were created in the future
+     * on another router.
+     *
+     * @example
+     * ```ts
+     * router.get("/", () => "hey").openapi({
+     * 	info: {
+     * 		title: "My API",
+     * 		version: "1.0.0",
+     * 	},
+     * });
+     * ```
+     *
+     * @param options Options object
+     * @returns
+     */
     openapi: ({ info, servers, }: {
         info: OpenAPI.InfoObject;
         servers?: Partial<Record<(`https://` | `http://`) | ({} & string), string>>;
     }) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, never, Response, "/openapi.json", RequiredParams, "GET", {}, never>, Input>;
     private readonly method;
-    readonly get: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, "body" | "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, Input>;
-    readonly post: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, Input>;
-    readonly put: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, Input>;
-    readonly patch: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, Input>;
-    readonly delete: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, Input>;
-    readonly head: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, Input>;
-    readonly options: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, Input>;
+    readonly get: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, "body" | "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, Input>;
+    readonly post: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, Input>;
+    readonly put: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, Input>;
+    readonly patch: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, Input>;
+    readonly delete: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, Input>;
+    readonly head: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, Input>;
+    readonly options: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, Input>;
     through: <NextContext>(through: (context: ContextTo, params: Record<RequiredParams, string>) => MaybePromise<NextContext>) => Router<ContextFrom, NextContext, RequiredParams, Routes, Input>;
 }
 
@@ -122,22 +148,18 @@ type AnyQuery = {
     [key in string]: any;
 };
 type Through<From, To, RequiredParams extends string> = (context: From, params: Record<RequiredParams, string>) => Promise<To>;
-type SSEOutputSpec<Result extends JSONValue> = {
+type SSEOutputSpec<Result extends JSONValue$1> = {
     type: 'sse';
     schema: AnySchemaFor<Result>;
     description?: string | undefined;
 };
-type JSONOutputSpec<ResultInput, ResultOutput extends JSONValue> = {
+type JSONOutputSpec<ResultInput, ResultOutput extends JSONValue$1> = {
     type: 'json';
     schema: BaseSchema<ResultOutput, ResultInput, BaseSchemaDef<ResultOutput>>;
     description?: string | undefined;
 };
-type OutputSpec<ResultInput, ResultOutput> = ResultInput extends KaitoSSEResponse<infer R> ? SSEOutputSpec<Extract<R, JSONValue>> & {
-    description?: string;
-} : JSONOutputSpec<ResultOutput, Extract<ResultInput, JSONValue>> & {
-    description?: string;
-};
-type Route<ContextFrom, ContextTo, RouterInput extends readonly unknown[], ResultInput, ResultOutput, Path extends string, AdditionalParams extends string, Method extends KaitoMethod, Query extends Record<string, JSONValue>, Body extends JSONValue> = {
+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?: {
         [Key in keyof Query]: AnySchemaFor<Query[Key]>;
@@ -154,16 +176,6 @@ type AnyRoute = Route<any, any, any, any, any, any, any, any, any, any>;
  * A helper to check if the environment is Node.js-like and the `NODE_ENV` environment variable is set to `'development'`
  */
 declare const isNodeLikeDev: boolean;
-type ErroredAPIResponse = {
-    success: false;
-    data: null;
-    message: string;
-};
-type SuccessfulAPIResponse<T> = {
-    success: true;
-    data: T;
-};
-type APIResponse<T> = ErroredAPIResponse | SuccessfulAPIResponse<T>;
 type MaybePromise<T> = T | Promise<T>;
 type KaitoMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
 type ExtractRouteParams<T extends string> = string extends T ? string : T extends `${string}:${infer Param}/${infer Rest}` ? Param | ExtractRouteParams<Rest> : T extends `${string}:${infer Param}` ? Param : never;
@@ -260,4 +272,4 @@ interface KaitoConfig<ContextFrom, Input extends readonly unknown[]> {
  */
 declare const create: <Context = null, Input extends readonly unknown[] = []>(config?: KaitoConfig<Context, Input>) => Router<Context, Context, never, never, Input>;
 
-export { type APIResponse, type AnyQuery, type AnyRoute, AnySchemaFor, BaseSchema, BaseSchemaDef, type ErroredAPIResponse, type ExtractRouteParams, type GetContext, type InferRoutes, type JSONOutputSpec, JSONValue, type KaitoConfig, KaitoError, KaitoHead, type KaitoMethod, KaitoRequest, type MaybePromise, type OutputSpec, type Route, type RouteRunData, Router, type RouterState, type SSEOutputSpec, type SuccessfulAPIResponse, type Through, WrappedError, create, isNodeLikeDev };
+export { type AnyQuery, type AnyRoute, AnySchemaFor, BaseSchema, BaseSchemaDef, type ExtractRouteParams, type GetContext, type InferRoutes, type JSONOutputSpec, JSONValue$1 as JSONValue, type KaitoConfig, KaitoError, KaitoHead, type KaitoMethod, KaitoRequest, type MaybePromise, type OutputSpec, type Route, type RouteRunData, Router, type RouterState, type SSEOutputSpec, type Through, WrappedError, create, isNodeLikeDev };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as OpenAPI from 'openapi3-ts/oas31';
-import { JSONValue, 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';
+import { JSONValue as JSONValue$1, AnySchemaFor, BaseSchema, BaseSchemaDef } 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 {
@@ -29,6 +29,11 @@ declare class KaitoRequest {
     get request(): Request;
 }
 
+type JSONPrimitive = string | number | boolean | null;
+type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+
 /**
  * This class is merely a wrapper around a `Headers` object and a status code.
  * It's used while the router is executing a route to store any mutations to the status
@@ -67,7 +72,7 @@ declare class KaitoHead {
      * @param body The Kaito JSON format to be sent as the response body
      * @returns A Response instance, ready to be sent
      */
-    toResponse<T>(body: APIResponse<T>): Response;
+    toResponse<T extends JSONValue>(data: T): Response;
     /**
      * Whether this KaitoHead instance has been touched/modified
      */
@@ -97,18 +102,39 @@ declare class Router<ContextFrom, ContextTo, RequiredParams extends string, Rout
         params: Record<string, string>;
     };
     serve: () => (request: Request, ...args: Input) => Promise<Response>;
+    /**
+     * Create a `/openapi.json` route on this router.
+     *
+     * Any routes defined AFTER this method call will NOT be included in the
+     * file. This is because all methods in Kaito are immutable, so there's no
+     * way for the router to know about routes that were created in the future
+     * on another router.
+     *
+     * @example
+     * ```ts
+     * router.get("/", () => "hey").openapi({
+     * 	info: {
+     * 		title: "My API",
+     * 		version: "1.0.0",
+     * 	},
+     * });
+     * ```
+     *
+     * @param options Options object
+     * @returns
+     */
     openapi: ({ info, servers, }: {
         info: OpenAPI.InfoObject;
         servers?: Partial<Record<(`https://` | `http://`) | ({} & string), string>>;
     }) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, never, Response, "/openapi.json", RequiredParams, "GET", {}, never>, Input>;
     private readonly method;
-    readonly get: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, "body" | "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, Input>;
-    readonly post: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, Input>;
-    readonly put: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, Input>;
-    readonly patch: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, Input>;
-    readonly delete: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, Input>;
-    readonly head: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, Input>;
-    readonly options: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, Input>;
+    readonly get: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, "body" | "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "GET", Query, Body>, Input>;
+    readonly post: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "POST", Query, Body>, Input>;
+    readonly put: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PUT", Query, Body>, Input>;
+    readonly patch: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "PATCH", Query, Body>, Input>;
+    readonly delete: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "DELETE", Query, Body>, Input>;
+    readonly head: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "HEAD", Query, Body>, Input>;
+    readonly options: <Path extends string, ResultInput = never, ResultOutput = ResultInput, Query extends AnyQuery = {}, Body extends JSONValue$1 = never>(path: Path, route: ((data: RouteRunData<RequiredParams | ExtractRouteParams<Path>, ContextTo, Query, Body>) => ResultOutput | Promise<ResultOutput>) | Omit<Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, "path" | "method" | "router">) => Router<ContextFrom, ContextTo, RequiredParams, Routes | Route<ContextFrom, ContextTo, Input, ResultInput, ResultOutput, Path, RequiredParams, "OPTIONS", Query, Body>, Input>;
     through: <NextContext>(through: (context: ContextTo, params: Record<RequiredParams, string>) => MaybePromise<NextContext>) => Router<ContextFrom, NextContext, RequiredParams, Routes, Input>;
 }
 
@@ -122,22 +148,18 @@ type AnyQuery = {
     [key in string]: any;
 };
 type Through<From, To, RequiredParams extends string> = (context: From, params: Record<RequiredParams, string>) => Promise<To>;
-type SSEOutputSpec<Result extends JSONValue> = {
+type SSEOutputSpec<Result extends JSONValue$1> = {
     type: 'sse';
     schema: AnySchemaFor<Result>;
     description?: string | undefined;
 };
-type JSONOutputSpec<ResultInput, ResultOutput extends JSONValue> = {
+type JSONOutputSpec<ResultInput, ResultOutput extends JSONValue$1> = {
     type: 'json';
     schema: BaseSchema<ResultOutput, ResultInput, BaseSchemaDef<ResultOutput>>;
     description?: string | undefined;
 };
-type OutputSpec<ResultInput, ResultOutput> = ResultInput extends KaitoSSEResponse<infer R> ? SSEOutputSpec<Extract<R, JSONValue>> & {
-    description?: string;
-} : JSONOutputSpec<ResultOutput, Extract<ResultInput, JSONValue>> & {
-    description?: string;
-};
-type Route<ContextFrom, ContextTo, RouterInput extends readonly unknown[], ResultInput, ResultOutput, Path extends string, AdditionalParams extends string, Method extends KaitoMethod, Query extends Record<string, JSONValue>, Body extends JSONValue> = {
+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?: {
         [Key in keyof Query]: AnySchemaFor<Query[Key]>;
@@ -154,16 +176,6 @@ type AnyRoute = Route<any, any, any, any, any, any, any, any, any, any>;
  * A helper to check if the environment is Node.js-like and the `NODE_ENV` environment variable is set to `'development'`
  */
 declare const isNodeLikeDev: boolean;
-type ErroredAPIResponse = {
-    success: false;
-    data: null;
-    message: string;
-};
-type SuccessfulAPIResponse<T> = {
-    success: true;
-    data: T;
-};
-type APIResponse<T> = ErroredAPIResponse | SuccessfulAPIResponse<T>;
 type MaybePromise<T> = T | Promise<T>;
 type KaitoMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
 type ExtractRouteParams<T extends string> = string extends T ? string : T extends `${string}:${infer Param}/${infer Rest}` ? Param | ExtractRouteParams<Rest> : T extends `${string}:${infer Param}` ? Param : never;
@@ -260,4 +272,4 @@ interface KaitoConfig<ContextFrom, Input extends readonly unknown[]> {
  */
 declare const create: <Context = null, Input extends readonly unknown[] = []>(config?: KaitoConfig<Context, Input>) => Router<Context, Context, never, never, Input>;
 
-export { type APIResponse, type AnyQuery, type AnyRoute, AnySchemaFor, BaseSchema, BaseSchemaDef, type ErroredAPIResponse, type ExtractRouteParams, type GetContext, type InferRoutes, type JSONOutputSpec, JSONValue, type KaitoConfig, KaitoError, KaitoHead, type KaitoMethod, KaitoRequest, type MaybePromise, type OutputSpec, type Route, type RouteRunData, Router, type RouterState, type SSEOutputSpec, type SuccessfulAPIResponse, type Through, WrappedError, create, isNodeLikeDev };
+export { type AnyQuery, type AnyRoute, AnySchemaFor, BaseSchema, BaseSchemaDef, type ExtractRouteParams, type GetContext, type InferRoutes, type JSONOutputSpec, JSONValue$1 as JSONValue, type KaitoConfig, KaitoError, KaitoHead, type KaitoMethod, KaitoRequest, type MaybePromise, type OutputSpec, type Route, type RouteRunData, Router, type RouterState, type SSEOutputSpec, type Through, WrappedError, create, isNodeLikeDev };

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";
@@ -72,14 +74,14 @@ var KaitoHead = class {
    * @param body The Kaito JSON format to be sent as the response body
    * @returns A Response instance, ready to be sent
    */
-  toResponse(body) {
+  toResponse(data) {
     const init = {
       status: this.#status
     };
     if (this.#headers) {
       init.headers = this.#headers;
     }
-    return Response.json(body, init);
+    return Response.json(data, init);
   }
   /**
    * Whether this KaitoHead instance has been touched/modified
@@ -214,12 +216,7 @@ var Router = class _Router {
       const method = req.method;
       const { route, params: rawParams } = findRoute(method, url.pathname);
       if (!route) {
-        const body = {
-          success: false,
-          data: null,
-          message: `Cannot ${method} ${url.pathname}`
-        };
-        return Response.json(body, { status: 404 });
+        return Response.json({ message: `Cannot ${method} ${url.pathname}` }, { status: 404 });
       }
       const request = new KaitoRequest(url, req);
       const head = new KaitoHead();
@@ -257,44 +254,30 @@ var Router = class _Router {
             );
           }
           const parsed = route.openapi.schema.serialize(result);
-          return head.toResponse({
-            success: true,
-            data: parsed
-          });
+          return head.toResponse(parsed);
         }
-        return head.toResponse({
-          success: true,
-          data: result
-        });
+        return head.toResponse(result);
       } catch (e) {
         const error = WrappedError.maybe(e);
         if (error instanceof KaitoError) {
           return head.status(error.status).toResponse({
-            success: false,
-            data: null,
             message: error.message
           });
         }
         if (!this.#state.config.onError) {
           return head.status(500).toResponse({
-            success: false,
-            data: null,
             message: "Internal Server Error"
           });
         }
         try {
           const { status, message } = await this.#state.config.onError(error, request);
           return head.status(status).toResponse({
-            success: false,
-            data: null,
             message
           });
         } catch (e2) {
           console.error("[Kaito] Failed to handle error inside `.onError()`, returning 500 and Internal Server Error");
           console.error(e2);
           return head.status(500).toResponse({
-            success: false,
-            data: null,
             message: "Internal Server Error"
           });
         }
@@ -323,6 +306,27 @@ var Router = class _Router {
       return response;
     };
   };
+  /**
+   * Create a `/openapi.json` route on this router.
+   *
+   * Any routes defined AFTER this method call will NOT be included in the
+   * file. This is because all methods in Kaito are immutable, so there's no
+   * way for the router to know about routes that were created in the future
+   * on another router.
+   *
+   * @example
+   * ```ts
+   * router.get("/", () => "hey").openapi({
+   * 	info: {
+   * 		title: "My API",
+   * 		version: "1.0.0",
+   * 	},
+   * });
+   * ```
+   *
+   * @param options Options object
+   * @returns
+   */
   openapi = ({
     info,
     servers
@@ -385,10 +389,7 @@ var Router = class _Router {
             description: route.openapi?.description ?? "Successful response",
             content: {
               [contentType]: {
-                schema: k.object({
-                  success: k.literal(true),
-                  data: route.openapi.schema
-                }).toOpenAPI()
+                schema: route.openapi.schema.toOpenAPI()
               }
             }
           }
@@ -448,11 +449,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.24",
+  "version": "4.0.0-beta.26",
   "author": "Alistair Smith <hi@alistair.sh>",
   "repository": "https://github.com/kaito-http/kaito",
   "dependencies": {