hono-openapi 0.3.0 → 0.4.0

package/arktype.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("@hono/arktype-validator"),r=require("./toOpenAPISchema.cjs"),a=require("./utils.cjs");function t(e){return{builder:async a=>({schema:await r.convert(e.toJsonSchema())}),validator:r=>{e(r)}}}require("json-schema-walker"),exports.resolver=t,exports.validator=function(r,o,i){const s=e.arktypeValidator(r,o,i);return Object.assign(s,{[a.uniqueSymbol]:{resolver:async e=>a.generateValidatorDocs(r,await t(o).builder(e))}})};

package/arktype.d.ts

@@ -0,0 +1 @@
+export type * from "./src/arktype.js";

package/arktype.js

@@ -0,0 +1 @@
+import{arktypeValidator as a}from"@hono/arktype-validator";import{c as o}from"./toOpenAPISchema.js";import{u as r,g as t}from"./utils.js";import"json-schema-walker";function s(a){return{builder:async r=>({schema:await o(a.toJsonSchema())}),validator:o=>{a(o)}}}function e(o,e,i){const n=a(o,e,i);return Object.assign(n,{[r]:{resolver:async a=>t(o,await s(e).builder(a))}})}export{s as resolver,e as validator};

package/effect.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("@hono/effect-validator"),r=require("effect"),a=require("./toOpenAPISchema.cjs"),t=require("./utils.cjs");function i(e){return{builder:async t=>({schema:await a.convert(r.JSONSchema.make(e))}),validator:async a=>{await r.Schema.decodeUnknownPromise(e)(a)}}}require("json-schema-walker"),exports.resolver=i,exports.validator=function(r,a){const o=e.effectValidator(r,a);return Object.assign(o,{[t.uniqueSymbol]:{resolver:async e=>t.generateValidatorDocs(r,await i(a).builder(e))}})};

package/effect.d.ts

@@ -0,0 +1 @@
+export type * from "./src/effect.js";

package/effect.js

@@ -0,0 +1 @@
+import{effectValidator as o}from"@hono/effect-validator";import{JSONSchema as a,Schema as r}from"effect";import{c as e}from"./toOpenAPISchema.js";import{u as t,g as i}from"./utils.js";import"json-schema-walker";function n(o){return{builder:async r=>({schema:await e(a.make(o))}),validator:async a=>{await r.decodeUnknownPromise(o)(a)}}}function s(a,r){const e=o(a,r);return Object.assign(e,{[t]:{resolver:async o=>i(a,await n(r).builder(o))}})}export{n as resolver,s as validator};

package/index.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("hono/http-exception"),t=require("./utils.cjs");const n=["GET","PUT","POST","DELETE","OPTIONS","HEAD","PATCH","TRACE"],s=e=>e.charAt(0).toUpperCase()+e.slice(1),o=(e,t)=>{let n=e;if("/"===t)return`${n}Index`;for(const e of t.split("/"))123===e.charCodeAt(0)?n+=`By${s(e.slice(1,-1))}`:n+=s(e);return n};function c({path:e,method:t,data:n,schema:s}){e=(e=>e.split("/").map((e=>{let t=e;return t.startsWith(":")&&(t=t.slice(1,t.length),t.endsWith("?")&&(t=t.slice(0,-1)),t=`{${t}}`),t})).join("/"))(e);const c=t.toLowerCase();s[e]={...s[e]?s[e]:{},[c]:{responses:{},...s[e]?.[c]??{},operationId:o(c,e),...n}}}function i(e,{excludeStaticFile:t=!0,exclude:n=[]}){const s={};for(const[o,c]of Object.entries(e))if(!(n.some((e=>"string"==typeof e?o===e:e.test(o)))||o.includes("*")||t&&o.includes("."))){for(const e of Object.keys(c)){const t=c[e];if(o.includes("{")){t.parameters||(t.parameters=[]);const e=o.split("/").filter((e=>e.startsWith("{")&&!t.parameters.find((t=>"path"===t.in&&t.name===e.slice(1,e.length-1)))));for(const n of e){const e=n.slice(1,n.length-1),s=t.parameters.findIndex((t=>"param"===t.in&&t.name===e));-1!==s?t.parameters[s].in="path":t.parameters.push({schema:{type:"string"},in:"path",name:e,required:!0})}}t.responses||(t.responses={200:{}})}s[o]=c}return s}async function a(e,{documentation:s={},excludeStaticFile:o=!0,exclude:a=[],excludeMethods:r=["OPTIONS"],excludeTags:p=[],defaultOptions:l}={documentation:{},excludeStaticFile:!0,exclude:[],excludeMethods:["OPTIONS"],excludeTags:[]},{version:d="3.1.0",components:m={}}={version:"3.1.0",components:{}},u){const h={version:d,components:m},f={};for(const s of e.routes){if(!(t.uniqueSymbol in s.handler))continue;if(r.includes(s.method))continue;if(!1===n.includes(s.method)&&"ALL"!==s.method)continue;const{resolver:e,metadata:o={}}=s.handler[t.uniqueSymbol],i=l?.[s.method],{docs:a,components:p}=await e({...h,...o},i);if(h.components={...h.components,...p??{}},"ALL"===s.method)for(const e of n)c({path:s.path,data:a,method:e,schema:f});else c({method:s.method,path:s.path,data:a,schema:f})}for(const e in f)for(const t in f[e]){const n=f[e][t]?.hide;n&&("boolean"==typeof n?n:u&&n(u))&&delete f[e][t]}return{openapi:h.version,...{...s,tags:s.tags?.filter((e=>!p?.includes(e?.name))),info:{title:"Hono Documentation",description:"Development documentation",version:"0.0.0",...s.info},paths:{...i(f,{excludeStaticFile:o,exclude:Array.isArray(a)?a:[a]}),...s.paths},components:{...s.components,schemas:{...h.components,...s.components?.schemas}}}}}exports.describeRoute=function(n){const{validateResponse:s,...o}=n;return Object.assign((async(t,o)=>{if(await o(),s&&n.responses){const s=t.res.status,o=t.res.headers.get("content-type");if(s&&o){const c=n.responses[s];if(c&&"content"in c&&c.content){const n=o.split(";")[0],s=c.content[n];if(s?.schema&&"validator"in s.schema)try{let e;if("application/json"===n?e=await t.res.json():"text/plain"===n&&(e=await t.res.text()),!e)throw new Error("No data to validate!");await s.schema.validator(e)}catch(t){throw new e.HTTPException(400,{message:"Response validation failed!"})}}}}}),{[t.uniqueSymbol]:{resolver:(e,t)=>async function(e,t,n={}){let s={};const o={...n,...t,responses:{...n?.responses,...t.responses}};for(const t of Object.keys(o.responses)){const n=o.responses[t];if(n&&"content"in n)for(const t of Object.keys(n.content??{})){const o=n.content?.[t];if(o&&(o.schema&&"builder"in o.schema)){const t=await o.schema.builder(e);o.schema=t.schema,t.components&&(s={...s,...t.components})}}}return{docs:o,components:s}}(e,o,t)}})},exports.generateSpecs=a,exports.openAPISpecs=function(e,t){const n={version:"3.1.0",components:{}};let s=null;return async o=>(s||(s=await a(e,t,n,o)),o.json(s))};

package/index.d.ts

@@ -0,0 +1 @@
+export type * from "./src/index.js";

package/index.js

@@ -0,0 +1 @@
+import{HTTPException as e}from"hono/http-exception";import{u as t}from"./utils.js";function n(n){const{validateResponse:s,...o}=n;return Object.assign((async(t,o)=>{if(await o(),s&&n.responses){const s=t.res.status,o=t.res.headers.get("content-type");if(s&&o){const c=n.responses[s];if(c&&"content"in c&&c.content){const n=o.split(";")[0],s=c.content[n];if(s?.schema&&"validator"in s.schema)try{let e;if("application/json"===n?e=await t.res.json():"text/plain"===n&&(e=await t.res.text()),!e)throw new Error("No data to validate!");await s.schema.validator(e)}catch(t){throw new e(400,{message:"Response validation failed!"})}}}}}),{[t]:{resolver:(e,t)=>async function(e,t,n={}){let s={};const o={...n,...t,responses:{...n?.responses,...t.responses}};for(const t of Object.keys(o.responses)){const n=o.responses[t];if(n&&"content"in n)for(const t of Object.keys(n.content??{})){const o=n.content?.[t];if(o&&(o.schema&&"builder"in o.schema)){const t=await o.schema.builder(e);o.schema=t.schema,t.components&&(s={...s,...t.components})}}}return{docs:o,components:s}}(e,o,t)}})}const s=["GET","PUT","POST","DELETE","OPTIONS","HEAD","PATCH","TRACE"],o=e=>e.charAt(0).toUpperCase()+e.slice(1),c=(e,t)=>{let n=e;if("/"===t)return`${n}Index`;for(const e of t.split("/"))123===e.charCodeAt(0)?n+=`By${o(e.slice(1,-1))}`:n+=o(e);return n};function a({path:e,method:t,data:n,schema:s}){e=(e=>e.split("/").map((e=>{let t=e;return t.startsWith(":")&&(t=t.slice(1,t.length),t.endsWith("?")&&(t=t.slice(0,-1)),t=`{${t}}`),t})).join("/"))(e);const o=t.toLowerCase();s[e]={...s[e]?s[e]:{},[o]:{responses:{},...s[e]?.[o]??{},operationId:c(o,e),...n}}}function i(e,{excludeStaticFile:t=!0,exclude:n=[]}){const s={};for(const[o,c]of Object.entries(e))if(!(n.some((e=>"string"==typeof e?o===e:e.test(o)))||o.includes("*")||t&&o.includes("."))){for(const e of Object.keys(c)){const t=c[e];if(o.includes("{")){t.parameters||(t.parameters=[]);const e=o.split("/").filter((e=>e.startsWith("{")&&!t.parameters.find((t=>"path"===t.in&&t.name===e.slice(1,e.length-1)))));for(const n of e){const e=n.slice(1,n.length-1),s=t.parameters.findIndex((t=>"param"===t.in&&t.name===e));-1!==s?t.parameters[s].in="path":t.parameters.push({schema:{type:"string"},in:"path",name:e,required:!0})}}t.responses||(t.responses={200:{}})}s[o]=c}return s}function r(e,t){const n={version:"3.1.0",components:{}};let s=null;return async o=>(s||(s=await p(e,t,n,o)),o.json(s))}async function p(e,{documentation:n={},excludeStaticFile:o=!0,exclude:c=[],excludeMethods:r=["OPTIONS"],excludeTags:p=[],defaultOptions:l}={documentation:{},excludeStaticFile:!0,exclude:[],excludeMethods:["OPTIONS"],excludeTags:[]},{version:d="3.1.0",components:m={}}={version:"3.1.0",components:{}},h){const f={version:d,components:m},u={};for(const n of e.routes){if(!(t in n.handler))continue;if(r.includes(n.method))continue;if(!1===s.includes(n.method)&&"ALL"!==n.method)continue;const{resolver:e,metadata:o={}}=n.handler[t],c=l?.[n.method],{docs:i,components:p}=await e({...f,...o},c);if(f.components={...f.components,...p??{}},"ALL"===n.method)for(const e of s)a({path:n.path,data:i,method:e,schema:u});else a({method:n.method,path:n.path,data:i,schema:u})}for(const e in u)for(const t in u[e]){const n=u[e][t]?.hide;n&&("boolean"==typeof n?n:h&&n(h))&&delete u[e][t]}return{openapi:f.version,...{...n,tags:n.tags?.filter((e=>!p?.includes(e?.name))),info:{title:"Hono Documentation",description:"Development documentation",version:"0.0.0",...n.info},paths:{...i(u,{excludeStaticFile:o,exclude:Array.isArray(c)?c:[c]}),...n.paths},components:{...n.components,schemas:{...f.components,...n.components?.schemas}}}}}export{n as describeRoute,p as generateSpecs,r as openAPISpecs};

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "hono-openapi",
   "description": "OpenAPI schema generator for Hono",
-  "version": "0.3.0",
+  "version": "0.4.0",
+  "types": "./index.d.ts",
+  "main": "./index.js",
+  "type": "module",
   "license": "MIT",
   "keywords": [
     "hono",
@@ -27,15 +30,15 @@
   "dependencies": {
     "json-schema-walker": "^2.0.0"
   },
-  "optionalDependencies": {
+  "peerDependencies": {
     "@hono/arktype-validator": "^2.0.0",
     "@hono/effect-validator": "^1.2.0",
-    "@hono/typebox-validator": "^0.2.6",
+    "@hono/typebox-validator": "^0.2.0 || ^0.3.0",
     "@hono/valibot-validator": "^0.5.1",
     "@hono/zod-validator": "^0.4.1",
     "@sinclair/typebox": "^0.34.9",
     "@valibot/to-json-schema": "^1.0.0-beta.3",
-    "arktype": "2.0.0-rc.25",
+    "arktype": "^2.0.0-rc.25",
     "effect": "^3.11.3",
     "hono": "^4.6.13",
     "openapi-types": "^12.1.3",
@@ -43,74 +46,116 @@
     "zod": "^3.23.8",
     "zod-openapi": "^4.0.0"
   },
+  "peerDependenciesMeta": {
+    "@hono/arktype-validator": {
+      "optional": true
+    },
+    "@hono/effect-validator": {
+      "optional": true
+    },
+    "@hono/typebox-validator": {
+      "optional": true
+    },
+    "@hono/valibot-validator": {
+      "optional": true
+    },
+    "@hono/zod-validator": {
+      "optional": true
+    },
+    "@sinclair/typebox": {
+      "optional": true
+    },
+    "@valibot/to-json-schema": {
+      "optional": true
+    },
+    "arktype": {
+      "optional": true
+    },
+    "effect": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    },
+    "openapi-types": {
+      "optional": true
+    },
+    "valibot": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "zod-openapi": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@apidevtools/json-schema-ref-parser": "^11.7.2",
+    "@apidevtools/json-schema-ref-parser": "^11.7.3",
     "@rollup/plugin-terser": "^0.4.4",
     "@types/json-schema": "^7.0.15"
   },
   "exports": {
     ".": {
       "import": {
-        "default": "./index.esm.js",
-        "types": "./index.esm.d.ts"
+        "types": "./index.d.ts",
+        "default": "./index.js"
       },
       "require": {
-        "default": "./index.cjs.js",
-        "types": "./index.cjs.d.ts"
+        "types": "./index.d.cts",
+        "default": "./index.cjs"
       }
     },
     "./zod": {
       "import": {
-        "default": "./zod.esm.js",
-        "types": "./zod.esm.d.ts"
+        "types": "./zod.d.ts",
+        "default": "./zod.js"
       },
       "require": {
-        "default": "./zod.cjs.js",
-        "types": "./zod.cjs.d.ts"
+        "types": "./zod.d.cts",
+        "default": "./zod.cjs"
       }
     },
     "./valibot": {
       "import": {
-        "default": "./valibot.esm.js",
-        "types": "./valibot.esm.d.ts"
+        "types": "./valibot.d.ts",
+        "default": "./valibot.js"
       },
       "require": {
-        "default": "./valibot.cjs.js",
-        "types": "./valibot.cjs.d.ts"
+        "types": "./valibot.d.cts",
+        "default": "./valibot.cjs"
       }
     },
     "./typebox": {
       "import": {
-        "default": "./typebox.esm.js",
-        "types": "./typebox.esm.d.ts"
+        "types": "./typebox.d.ts",
+        "default": "./typebox.js"
       },
       "require": {
-        "default": "./typebox.cjs.js",
-        "types": "./typebox.cjs.d.ts"
+        "types": "./typebox.d.cts",
+        "default": "./typebox.cjs"
       }
     },
     "./arktype": {
       "import": {
-        "default": "./arktype.esm.js",
-        "types": "./arktype.esm.d.ts"
+        "types": "./arktype.d.ts",
+        "default": "./arktype.js"
       },
       "require": {
-        "default": "./arktype.cjs.js",
-        "types": "./arktype.cjs.d.ts"
+        "types": "./arktype.d.cts",
+        "default": "./arktype.cjs"
       }
     },
     "./effect": {
       "import": {
-        "default": "./effect.esm.js",
-        "types": "./effect.esm.d.ts"
+        "types": "./effect.d.ts",
+        "default": "./effect.js"
       },
       "require": {
-        "default": "./effect.cjs.js",
-        "types": "./effect.cjs.d.ts"
+        "types": "./effect.d.cts",
+        "default": "./effect.cjs"
       }
     }
   },
-  "module": "./index.esm.js",
-  "main": "./index.cjs.js",
-  "types": "./index.esm.d.ts"
+  "module": "./index.esm.js"
 }

package/src/arktype.d.ts

@@ -1,8 +1,20 @@
 import { type Hook } from "@hono/arktype-validator";
 import type { Type } from "arktype";
 import type { Env, MiddlewareHandler, ValidationTargets } from "hono";
-import type { HasUndefined, ResolverResult } from "./types";
+import type { HasUndefined, ResolverResult } from "./types.js";
+/**
+ * Generate a resolver for an Arktype schema
+ * @param schema Arktype schema
+ * @returns Resolver result
+ */
 export declare function resolver<T extends Type>(schema: T): ResolverResult;
+/**
+ * Create a validator middleware
+ * @param target Target for validation
+ * @param schema Arktype schema
+ * @param hook Hook for validation
+ * @returns Middleware handler
+ */
 export declare function validator<T extends Type, Target extends keyof ValidationTargets, E extends Env, P extends string, I = T["inferIn"], O = T["infer"], V extends {
     in: HasUndefined<I> extends true ? {
         [K in Target]?: I;

package/src/effect.d.ts

@@ -1,7 +1,18 @@
 import { Schema } from "effect";
 import type { Env, Input as HonoInput, MiddlewareHandler, ValidationTargets } from "hono";
-import type { HasUndefined, ResolverResult } from "./types";
+import type { HasUndefined, ResolverResult } from "./types.js";
+/**
+ * Generate a resolver for an Effect schema
+ * @param schema Effect schema
+ * @returns Resolver result
+ */
 export declare function resolver<Type, Context>(schema: Schema.Schema<Type, Context, never>): ResolverResult;
+/**
+ * Create a validator middleware
+ * @param target Target for validation
+ * @param schema Effect schema
+ * @returns Middleware handler
+ */
 export declare function validator<Type, Context, Target extends keyof ValidationTargets, E extends Env, P extends string, In = Schema.Schema<Type, Context, never>["Encoded"], Out = Schema.Schema<Type, Context, never>["Type"], I extends HonoInput = {
     in: HasUndefined<In> extends true ? {
         [K in Target]?: K extends "json" ? In : HasUndefined<keyof ValidationTargets[K]> extends true ? {

package/src/helper.d.ts

@@ -1,5 +1,5 @@
 import type { OpenAPIV3 } from "openapi-types";
-import type { OpenAPIRoute } from "./types";
+import type { OpenAPIRoute } from "./types.js";
 export declare const ALLOWED_METHODS: readonly ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 export declare const toOpenAPIPath: (path: string) => string;
 export declare const capitalize: (word: string) => string;

package/src/index.d.ts

@@ -1,3 +1,3 @@
-export { describeRoute } from "./route";
-export { openAPISpecs } from "./openapi";
-export type * from "./types";
+export { describeRoute } from "./route.js";
+export { openAPISpecs, generateSpecs } from "./openapi.js";
+export type * from "./types.js";

package/src/openapi.d.ts

@@ -1,4 +1,201 @@
 import type { Context, Env, Hono, Input, Schema } from "hono";
-import type { BlankSchema } from "hono/types";
-import type { OpenApiSpecsOptions } from "./types";
-export declare function openAPISpecs<E extends Env = Env, P extends string = string, I extends Input = Input, S extends Schema = BlankSchema>(hono: Hono<E, S, P>, { documentation, excludeStaticFile, exclude, excludeMethods, excludeTags, }?: OpenApiSpecsOptions): (c: Context<E, P, I>) => Promise<any>;
+import type { BlankEnv, BlankInput, BlankSchema, MiddlewareHandler } from "hono/types";
+import type { OpenAPIV3 } from "openapi-types";
+import type { OpenAPIRouteHandlerConfig, OpenApiSpecsOptions } from "./types.js";
+/**
+ * Route handler for OpenAPI specs
+ * @param hono Instance of Hono
+ * @param options Options for generating OpenAPI specs
+ * @returns Middleware handler for OpenAPI specs
+ */
+export declare function openAPISpecs<E extends Env = BlankEnv, P extends string = string, I extends Input = BlankInput, S extends Schema = BlankSchema>(hono: Hono<E, S, P>, options?: OpenApiSpecsOptions): MiddlewareHandler<E, P, I>;
+/**
+ * Generate OpenAPI specs for the given Hono instance
+ * @param hono Instance of Hono
+ * @param options Options for generating OpenAPI specs
+ * @param config Configuration for OpenAPI route handler
+ * @param Context Route context for hiding routes
+ * @returns OpenAPI specs
+ */
+export declare function generateSpecs<E extends Env = BlankEnv, P extends string = string, I extends Input = BlankInput, S extends Schema = BlankSchema>(hono: Hono<E, S, P>, { documentation, excludeStaticFile, exclude, excludeMethods, excludeTags, defaultOptions, }?: OpenApiSpecsOptions, { version, components }?: OpenAPIRouteHandlerConfig, c?: Context<E, P, I>): Promise<{
+    tags: OpenAPIV3.TagObject[] | undefined;
+    info: {
+        title: string;
+        description: string;
+        termsOfService?: string;
+        contact?: OpenAPIV3.ContactObject;
+        license?: OpenAPIV3.LicenseObject;
+        version: string;
+    };
+    paths: {
+        [x: string]: ({
+            $ref?: string;
+            summary?: string;
+            description?: string;
+            servers?: OpenAPIV3.ServerObject[];
+            parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+        } & {
+            get?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+            put?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+            post?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+            delete?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+            options?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+            head?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+            patch?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+            trace?: {
+                tags?: string[];
+                summary?: string;
+                description?: string;
+                externalDocs?: OpenAPIV3.ExternalDocumentationObject;
+                operationId?: string;
+                parameters?: (OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject)[];
+                requestBody?: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+                responses: OpenAPIV3.ResponsesObject;
+                callbacks?: {
+                    [callback: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+                };
+                deprecated?: boolean;
+                security?: OpenAPIV3.SecurityRequirementObject[];
+                servers?: OpenAPIV3.ServerObject[];
+            } | undefined;
+        }) | undefined;
+    };
+    components: {
+        schemas: {
+            [x: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject;
+        };
+        responses?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.ResponseObject;
+        };
+        parameters?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.ParameterObject;
+        };
+        examples?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.ExampleObject;
+        };
+        requestBodies?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject;
+        };
+        headers?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.HeaderObject;
+        };
+        securitySchemes?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.SecuritySchemeObject;
+        };
+        links?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.LinkObject;
+        };
+        callbacks?: {
+            [key: string]: OpenAPIV3.ReferenceObject | OpenAPIV3.CallbackObject;
+        };
+    };
+    openapi: string;
+    servers?: OpenAPIV3.ServerObject[] | undefined;
+    security?: OpenAPIV3.SecurityRequirementObject[] | undefined;
+    externalDocs?: OpenAPIV3.ExternalDocumentationObject | undefined;
+}>;

package/src/route.d.ts

@@ -1,3 +1,43 @@
-import type { Env, Input, MiddlewareHandler } from "hono/types";
-import type { DescribeRouteOptions } from "./types";
-export declare function describeRoute<E extends Env = Env, P extends string = string, I extends Input = Input>(specs: DescribeRouteOptions<E, P, I>): MiddlewareHandler<E, P, I>;
+import type { MiddlewareHandler } from "hono/types";
+import type { DescribeRouteOptions, OpenAPIRouteHandlerConfig } from "./types.js";
+/**
+ * Describe a route with OpenAPI specs.
+ * @param specs Options for describing a route
+ * @returns Middleware handler
+ */
+export declare function describeRoute(specs: DescribeRouteOptions): MiddlewareHandler;
+/**
+ * Generate OpenAPI specs for the given route
+ * @param config Route handler configuration
+ * @param docs Route description in OpenAPI specs
+ * @param defaultOptions Default options for describing a route
+ */
+export declare function generateRouteSpecs(config: OpenAPIRouteHandlerConfig, docs: DescribeRouteOptions, defaultOptions?: DescribeRouteOptions): Promise<{
+    docs: {
+        responses: {
+            [x: string]: import("openapi-types").OpenAPIV3.ReferenceObject | (import("openapi-types").OpenAPIV3.ResponseObject & {
+                content?: {
+                    [key: string]: Omit<import("openapi-types").OpenAPIV3.MediaTypeObject, "schema"> & {
+                        schema?: import("openapi-types").OpenAPIV3.ReferenceObject | import("openapi-types").OpenAPIV3.SchemaObject | import("./types.js").ResolverResult;
+                    };
+                };
+            });
+        };
+        tags?: string[];
+        summary?: string;
+        description?: string;
+        externalDocs?: import("openapi-types").OpenAPIV3.ExternalDocumentationObject;
+        operationId?: string;
+        parameters?: (import("openapi-types").OpenAPIV3.ReferenceObject | import("openapi-types").OpenAPIV3.ParameterObject)[];
+        requestBody?: import("openapi-types").OpenAPIV3.ReferenceObject | import("openapi-types").OpenAPIV3.RequestBodyObject;
+        callbacks?: {
+            [callback: string]: import("openapi-types").OpenAPIV3.ReferenceObject | import("openapi-types").OpenAPIV3.CallbackObject;
+        };
+        deprecated?: boolean;
+        security?: import("openapi-types").OpenAPIV3.SecurityRequirementObject[];
+        servers?: import("openapi-types").OpenAPIV3.ServerObject[];
+        hide?: boolean | (<E extends import("hono").Env = import("hono").Env, P extends string = string, I extends import("hono").Input = import("hono/types").BlankInput>(c: import("hono").Context<E, P, I>) => boolean);
+        validateResponse?: boolean;
+    };
+    components: {};
+}>;

package/src/{toOpenAPISchema/types.d.ts → toOpenAPISchema.d.ts}

@@ -1,4 +1,6 @@
 import type { JSONSchema, ParserOptions } from "@apidevtools/json-schema-ref-parser";
+import type { JSONSchema4 } from "json-schema";
+import type { OpenAPIV3 } from "openapi-types";
 export type addPrefixToObject = {
     [K in keyof JSONSchema as `x-${K}`]: JSONSchema[K];
 };
@@ -15,4 +17,5 @@ export type SchemaType = ExtendedJSONSchema & {
     nullable?: boolean;
 };
 export type SchemaTypeKeys = keyof SchemaType;
-export {};
+declare const convert: <T extends object = JSONSchema4>(schema: T, options?: Options) => Promise<OpenAPIV3.Document>;
+export default convert;

package/src/typebox.d.ts

@@ -1,8 +1,20 @@
 import { type Hook } from "@hono/typebox-validator";
 import type { Static, TSchema } from "@sinclair/typebox";
 import type { Env, MiddlewareHandler, ValidationTargets } from "hono";
-import type { ResolverResult } from "./types";
+import type { ResolverResult } from "./types.js";
+/**
+ * Generate a resolver for a TypeBox schema
+ * @param schema TypeBox schema
+ * @returns Resolver result
+ */
 export declare function resolver<T extends TSchema>(schema: T): ResolverResult;
+/**
+ * Create a validator middleware
+ * @param target Target for validation
+ * @param schema TypeBox schema
+ * @param hook Hook for validation
+ * @returns Middleware handler
+ */
 export declare function validator<T extends TSchema, Target extends keyof ValidationTargets, E extends Env, P extends string, V extends {
     in: {
         [K in Target]: Static<T>;

package/src/types.d.ts

@@ -1,7 +1,7 @@
 import type { Context, Env, Input } from "hono";
 import type { BlankInput } from "hono/types";
 import type { OpenAPIV3 } from "openapi-types";
-import type { ALLOWED_METHODS } from "./helper";
+import type { ALLOWED_METHODS } from "./helper.js";
 export type HasUndefined<T> = undefined extends T ? true : false;
 export type PromiseOr<T> = T | Promise<T>;
 export type OpenAPIRouteHandlerConfig = {
@@ -18,20 +18,19 @@ export type ResolverResult = {
     validator: (values: unknown) => PromiseOr<void>;
 };
 export type HandlerResponse = {
-    resolver: (config: OpenAPIRouteHandlerConfig) => PromiseOr<{
+    resolver: (config: OpenAPIRouteHandlerConfig, defaultOptions?: DescribeRouteOptions) => PromiseOr<{
         docs: OpenAPIV3.OperationObject;
         components?: OpenAPIV3.ComponentsObject["schemas"];
     }>;
     metadata?: Record<string, unknown>;
 };
-export type DescribeRouteOptions<E extends Env = Env, P extends string = string, I extends Input = BlankInput> = Omit<OpenAPIV3.OperationObject, "responses" | "requestBody" | "parameters"> & {
+export type DescribeRouteOptions = Omit<OpenAPIV3.OperationObject, "responses"> & {
     /**
      * Pass `true` to hide route from OpenAPI/swagger document
      */
-    hide?: boolean | ((c: Context<E, P, I>) => boolean);
+    hide?: boolean | (<E extends Env = Env, P extends string = string, I extends Input = BlankInput>(c: Context<E, P, I>) => boolean);
     /**
      * Validate response of the route
-     * @experimental
      */
     validateResponse?: boolean;
     /**
@@ -79,4 +78,8 @@ export type OpenApiSpecsOptions = {
      * Exclude tags from OpenAPI
      */
     excludeTags?: string[];
+    /**
+     * Default options for `describeRoute` method
+     */
+    defaultOptions?: Partial<Record<(typeof ALLOWED_METHODS)[number] | "ALL", DescribeRouteOptions>>;
 };

package/src/utils.d.ts

@@ -1,6 +1,6 @@
 import type { ValidationTargets } from "hono";
 import type { OpenAPIV3 } from "openapi-types";
-import type { ResolverResult } from "./types";
+import type { ResolverResult } from "./types.js";
 export declare const uniqueSymbol: unique symbol;
 export declare function generateValidatorDocs<Target extends keyof ValidationTargets>(target: Target, _result: ReturnType<ResolverResult["builder"]>): Promise<{
     docs: Pick<{

package/src/valibot.d.ts

@@ -1,8 +1,20 @@
 import { type Hook } from "@hono/valibot-validator";
 import type { Env, Input as HonoInput, MiddlewareHandler, ValidationTargets } from "hono";
 import { type BaseIssue, type BaseSchema, type GenericSchema, type GenericSchemaAsync, type InferInput, type InferOutput } from "valibot";
-import type { HasUndefined, ResolverResult } from "./types";
+import type { HasUndefined, ResolverResult } from "./types.js";
+/**
+ * Generate a resolver for a Valibot schema
+ * @param schema Valibot schema
+ * @returns Resolver result
+ */
 export declare function resolver<T extends BaseSchema<unknown, unknown, BaseIssue<unknown>>>(schema: T): ResolverResult;
+/**
+ * Create a validator middleware
+ * @param target Target for validation
+ * @param schema Valibot schema
+ * @param hook Hook for validation
+ * @returns Middleware handler
+ */
 export declare function validator<T extends GenericSchema | GenericSchemaAsync, Target extends keyof ValidationTargets, E extends Env, P extends string, In = InferInput<T>, Out = InferOutput<T>, I extends HonoInput = {
     in: HasUndefined<In> extends true ? {
         [K in Target]?: K extends "json" ? In : HasUndefined<keyof ValidationTargets[K]> extends true ? {

package/src/zod.d.ts

@@ -1,8 +1,20 @@
 import { type Hook } from "@hono/zod-validator";
 import type { Env, Input, MiddlewareHandler, ValidationTargets } from "hono";
 import type { ZodSchema, z } from "zod";
-import type { HasUndefined, ResolverResult } from "./types";
+import type { HasUndefined, ResolverResult } from "./types.js";
+/**
+ * Generate a resolver for a Zod schema
+ * @param schema Zod schema
+ * @returns Resolver result
+ */
 export declare function resolver<T extends ZodSchema>(schema: T): ResolverResult;
+/**
+ * Create a validator middleware
+ * @param target Target for validation
+ * @param schema Zod schema
+ * @param hook Hook for validation
+ * @returns Middleware handler
+ */
 export declare function validator<T extends ZodSchema, Target extends keyof ValidationTargets, E extends Env, P extends string, In = z.input<T>, Out = z.output<T>, I extends Input = {
     in: HasUndefined<In> extends true ? {
         [K in Target]?: In extends ValidationTargets[K] ? In : {

package/typebox.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("@hono/typebox-validator"),r=require("@sinclair/typebox/value"),a=require("./toOpenAPISchema.cjs"),t=require("./utils.cjs");function i(e){return{builder:async r=>({schema:await a.convert(e)}),validator:a=>{r.Value.Parse(e,a)}}}require("json-schema-walker"),exports.resolver=i,exports.validator=function(r,a,o){const s=e.tbValidator(r,a,o);return Object.assign(s,{[t.uniqueSymbol]:{resolver:async e=>t.generateValidatorDocs(r,await i(a).builder(e))}})};

package/typebox.d.ts

@@ -0,0 +1 @@
+export type * from "./src/typebox.js";

package/typebox.js

@@ -0,0 +1 @@
+import{tbValidator as r}from"@hono/typebox-validator";import{Value as o}from"@sinclair/typebox/value";import{c as a}from"./toOpenAPISchema.js";import{u as t,g as e}from"./utils.js";import"json-schema-walker";function i(r){return{builder:async o=>({schema:await a(r)}),validator:a=>{o.Parse(r,a)}}}function s(o,a,s){const n=r(o,a,s);return Object.assign(n,{[t]:{resolver:async r=>e(o,await i(a).builder(r))}})}export{i as resolver,s as validator};

package/valibot.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("@hono/valibot-validator"),r=require("@valibot/to-json-schema"),a=require("valibot"),t=require("./toOpenAPISchema.cjs"),o=require("./utils.cjs");function i(e){return{builder:async a=>({schema:await t.convert(r.toJsonSchema(e))}),validator:async r=>{await a.parseAsync(e,r)}}}require("json-schema-walker"),exports.resolver=i,exports.validator=function(r,a,t){const s=e.vValidator(r,a,t);return Object.assign(s,{[o.uniqueSymbol]:{resolver:async e=>o.generateValidatorDocs(r,await i(a).builder(e))}})};

package/valibot.d.ts

@@ -0,0 +1 @@
+export type * from "./src/valibot.js";

package/valibot.js

@@ -0,0 +1 @@
+import{vValidator as o}from"@hono/valibot-validator";import{toJsonSchema as a}from"@valibot/to-json-schema";import{parseAsync as t}from"valibot";import{c as r}from"./toOpenAPISchema.js";import{u as i,g as s}from"./utils.js";import"json-schema-walker";function m(o){return{builder:async t=>({schema:await r(a(o))}),validator:async a=>{await t(o,a)}}}function n(a,t,r){const n=o(a,t,r);return Object.assign(n,{[i]:{resolver:async o=>s(a,await m(t).builder(o))}})}export{m as resolver,n as validator};

package/zod.cjs

@@ -0,0 +1 @@
+"use strict";var e=require("@hono/zod-validator"),r=require("zod-openapi"),a=require("./utils.cjs");function t(e){return{builder:a=>{const{version:t,...o}=a??{};return r.createSchema(e,a?{openapi:t,...o}:void 0)},validator:e.parse}}exports.resolver=t,exports.validator=function(r,o,i){const n=e.zValidator(r,o,i);return Object.assign(n,{[a.uniqueSymbol]:{resolver:async e=>a.generateValidatorDocs(r,await t(o).builder(e)),metadata:{schemaType:"input"}}})};

package/zod.d.ts

@@ -0,0 +1 @@
+export type * from "./src/zod.js";

package/zod.js

@@ -0,0 +1 @@
+import{zValidator as o}from"@hono/zod-validator";import{createSchema as r}from"zod-openapi";import{u as t,g as a}from"./utils.js";function i(o){return{builder:t=>{const{version:a,...i}=t??{};return r(o,t?{openapi:a,...i}:void 0)},validator:o.parse}}function e(r,e,n){const s=o(r,e,n);return Object.assign(s,{[t]:{resolver:async o=>a(r,await i(e).builder(o)),metadata:{schemaType:"input"}}})}export{i as resolver,e as validator};

package/arktype.cjs.js

@@ -1 +0,0 @@
-"use strict";var e=require("@hono/arktype-validator"),r=require("./index.cjs2.js"),a=require("./utils.cjs.js");function t(e){return{builder:async a=>({schema:await r.convert(e.toJsonSchema())}),validator:r=>{e(r)}}}require("json-schema-walker"),exports.resolver=t,exports.validator=function(r,s,i){const o=e.arktypeValidator(r,s,i);return Object.assign(o,{[a.uniqueSymbol]:{resolver:async e=>a.generateValidatorDocs(r,await t(s).builder(e))}})};

package/arktype.esm.d.ts

@@ -1 +0,0 @@
-export * from "./src/arktype";

package/arktype.esm.js

@@ -1 +0,0 @@
-import{arktypeValidator as r}from"@hono/arktype-validator";import{c as a}from"./index.esm2.js";import{u as o,g as s}from"./utils.esm.js";import"json-schema-walker";function t(r){return{builder:async o=>({schema:await a(r.toJsonSchema())}),validator:a=>{r(a)}}}function e(a,e,i){const n=r(a,e,i);return Object.assign(n,{[o]:{resolver:async r=>s(a,await t(e).builder(r))}})}export{t as resolver,e as validator};

package/effect.cjs.js

@@ -1 +0,0 @@
-"use strict";var e=require("@hono/effect-validator"),r=require("effect"),a=require("./index.cjs2.js"),t=require("./utils.cjs.js");function i(e){return{builder:async t=>({schema:await a.convert(r.JSONSchema.make(e))}),validator:async a=>{await r.Schema.decodeUnknownPromise(e)(a)}}}require("json-schema-walker"),exports.resolver=i,exports.validator=function(r,a){const s=e.effectValidator(r,a);return Object.assign(s,{[t.uniqueSymbol]:{resolver:async e=>t.generateValidatorDocs(r,await i(a).builder(e))}})};

package/effect.esm.d.ts

@@ -1 +0,0 @@
-export * from "./src/effect";

package/effect.esm.js

@@ -1 +0,0 @@
-import{effectValidator as e}from"@hono/effect-validator";import{JSONSchema as o,Schema as r}from"effect";import{c as a}from"./index.esm2.js";import{u as t,g as s}from"./utils.esm.js";import"json-schema-walker";function i(e){return{builder:async r=>({schema:await a(o.make(e))}),validator:async o=>{await r.decodeUnknownPromise(e)(o)}}}function n(o,r){const a=e(o,r);return Object.assign(a,{[t]:{resolver:async e=>s(o,await i(r).builder(e))}})}export{i as resolver,n as validator};

package/index.cjs.js

@@ -1 +0,0 @@
-"use strict";var e=require("hono/http-exception"),t=require("./utils.cjs.js");const n=["GET","PUT","POST","DELETE","OPTIONS","HEAD","PATCH","TRACE"],s=e=>e.charAt(0).toUpperCase()+e.slice(1),o=(e,t)=>{let n=e;if("/"===t)return`${n}Index`;for(const e of t.split("/"))123===e.charCodeAt(0)?n+=`By${s(e.slice(1,-1))}`:n+=s(e);return n};function c({path:e,method:t,data:n,schema:s}){e=(e=>e.split("/").map((e=>{let t=e;return t.startsWith(":")&&(t=t.slice(1,t.length),t.endsWith("?")&&(t=t.slice(0,-1)),t=`{${t}}`),t})).join("/"))(e);const c=t.toLowerCase();s[e]={...s[e]?s[e]:{},[c]:{responses:{},...s[e]?.[c]??{},operationId:o(c,e),...n}}}function i(e,{excludeStaticFile:t=!0,exclude:n=[]}){const s={};for(const[o,c]of Object.entries(e))if(!(n.some((e=>"string"==typeof e?o===e:e.test(o)))||o.includes("*")||t&&o.includes("."))){for(const e of Object.keys(c)){const t=c[e];if(o.includes("{")){t.parameters||(t.parameters=[]);const e=o.split("/").filter((e=>e.startsWith("{")&&!t.parameters.find((t=>"path"===t.in&&t.name===e.slice(1,e.length-1)))));for(const n of e){const e=n.slice(1,n.length-1),s=t.parameters.findIndex((t=>"param"===t.in&&t.name===e));-1!==s?t.parameters[s].in="path":t.parameters.push(n)}}t.responses||(t.responses={200:{}})}s[o]=c}return s}exports.describeRoute=function(n){return Object.assign((async(t,s)=>{if(await s(),n.validateResponse&&n.responses){const s=t.res.status,o=t.res.headers.get("content-type");if(s&&o){const c=n.responses[s];if(c&&"content"in c&&c.content){const n=o.split(";")[0],s=c.content[n];if(s?.schema&&"validator"in s.schema)try{let e;if("application/json"===n?e=await t.res.json():"text/plain"===n&&(e=await t.res.text()),!e)throw new Error("No data to validate!");await s.schema.validator(e)}catch(t){throw new e.HTTPException(400,{message:"Response validation failed!"})}}}}}),{[t.uniqueSymbol]:{resolver:async e=>{const t={...n};let s={};if(t.responses)for(const n of Object.keys(t.responses)){const o=t.responses[n];if(!o||"content"in o)for(const t of Object.keys(o.content??{})){const n=o.content?.[t];if(n&&(n.schema&&"builder"in n.schema)){const t=await n.schema.builder(e);n.schema=t.schema,t.components&&(s={...s,...t.components})}}}return{docs:t,components:s}}}})},exports.openAPISpecs=function(e,{documentation:s={},excludeStaticFile:o=!0,exclude:a=[],excludeMethods:r=["OPTIONS"],excludeTags:l=[]}={documentation:{},excludeStaticFile:!0,exclude:[],excludeMethods:["OPTIONS"],excludeTags:[]}){const p={version:"3.1.0",components:{}},d={};let u=null;return async m=>{if(u)return m.json(u);for(const s of e.routes){if(!(t.uniqueSymbol in s.handler))continue;if(r.includes(s.method))continue;if(!1===n.includes(s.method)&&"ALL"!==s.method)continue;const{resolver:e,metadata:o={}}=s.handler[t.uniqueSymbol],{docs:i,components:a}=await e({...p,...o});if(p.components={...p.components,...a??{}},"ALL"===s.method)for(const e of n)c({path:s.path,data:i,method:e,schema:d});else c({method:s.method,path:s.path,data:i,schema:d})}for(const e in d)for(const t in d[e]){const n=d[e][t]?.hide;n&&("boolean"==typeof n?n:n(m))&&delete d[e][t]}return u={openapi:p.version,...{...s,tags:s.tags?.filter((e=>!l?.includes(e?.name))),info:{title:"Hono Documentation",description:"Development documentation",version:"0.0.0",...s.info},paths:{...i(d,{excludeStaticFile:o,exclude:Array.isArray(a)?a:[a]}),...s.paths},components:{...s.components,schemas:{...p.components,...s.components?.schemas}}}},m.json(u)}};

package/index.esm.d.ts

@@ -1 +0,0 @@
-export * from "./src/index";

package/index.esm.js

@@ -1 +0,0 @@
-import{HTTPException as e}from"hono/http-exception";import{u as t}from"./utils.esm.js";function n(n){return Object.assign((async(t,s)=>{if(await s(),n.validateResponse&&n.responses){const s=t.res.status,o=t.res.headers.get("content-type");if(s&&o){const c=n.responses[s];if(c&&"content"in c&&c.content){const n=o.split(";")[0],s=c.content[n];if(s?.schema&&"validator"in s.schema)try{let e;if("application/json"===n?e=await t.res.json():"text/plain"===n&&(e=await t.res.text()),!e)throw new Error("No data to validate!");await s.schema.validator(e)}catch(t){throw new e(400,{message:"Response validation failed!"})}}}}}),{[t]:{resolver:async e=>{const t={...n};let s={};if(t.responses)for(const n of Object.keys(t.responses)){const o=t.responses[n];if(!o||"content"in o)for(const t of Object.keys(o.content??{})){const n=o.content?.[t];if(n&&(n.schema&&"builder"in n.schema)){const t=await n.schema.builder(e);n.schema=t.schema,t.components&&(s={...s,...t.components})}}}return{docs:t,components:s}}}})}const s=["GET","PUT","POST","DELETE","OPTIONS","HEAD","PATCH","TRACE"],o=e=>e.charAt(0).toUpperCase()+e.slice(1),c=(e,t)=>{let n=e;if("/"===t)return`${n}Index`;for(const e of t.split("/"))123===e.charCodeAt(0)?n+=`By${o(e.slice(1,-1))}`:n+=o(e);return n};function a({path:e,method:t,data:n,schema:s}){e=(e=>e.split("/").map((e=>{let t=e;return t.startsWith(":")&&(t=t.slice(1,t.length),t.endsWith("?")&&(t=t.slice(0,-1)),t=`{${t}}`),t})).join("/"))(e);const o=t.toLowerCase();s[e]={...s[e]?s[e]:{},[o]:{responses:{},...s[e]?.[o]??{},operationId:c(o,e),...n}}}function i(e,{excludeStaticFile:t=!0,exclude:n=[]}){const s={};for(const[o,c]of Object.entries(e))if(!(n.some((e=>"string"==typeof e?o===e:e.test(o)))||o.includes("*")||t&&o.includes("."))){for(const e of Object.keys(c)){const t=c[e];if(o.includes("{")){t.parameters||(t.parameters=[]);const e=o.split("/").filter((e=>e.startsWith("{")&&!t.parameters.find((t=>"path"===t.in&&t.name===e.slice(1,e.length-1)))));for(const n of e){const e=n.slice(1,n.length-1),s=t.parameters.findIndex((t=>"param"===t.in&&t.name===e));-1!==s?t.parameters[s].in="path":t.parameters.push(n)}}t.responses||(t.responses={200:{}})}s[o]=c}return s}function r(e,{documentation:n={},excludeStaticFile:o=!0,exclude:c=[],excludeMethods:r=["OPTIONS"],excludeTags:l=[]}={documentation:{},excludeStaticFile:!0,exclude:[],excludeMethods:["OPTIONS"],excludeTags:[]}){const p={version:"3.1.0",components:{}},d={};let m=null;return async h=>{if(m)return h.json(m);for(const n of e.routes){if(!(t in n.handler))continue;if(r.includes(n.method))continue;if(!1===s.includes(n.method)&&"ALL"!==n.method)continue;const{resolver:e,metadata:o={}}=n.handler[t],{docs:c,components:i}=await e({...p,...o});if(p.components={...p.components,...i??{}},"ALL"===n.method)for(const e of s)a({path:n.path,data:c,method:e,schema:d});else a({method:n.method,path:n.path,data:c,schema:d})}for(const e in d)for(const t in d[e]){const n=d[e][t]?.hide;n&&("boolean"==typeof n?n:n(h))&&delete d[e][t]}return m={openapi:p.version,...{...n,tags:n.tags?.filter((e=>!l?.includes(e?.name))),info:{title:"Hono Documentation",description:"Development documentation",version:"0.0.0",...n.info},paths:{...i(d,{excludeStaticFile:o,exclude:Array.isArray(c)?c:[c]}),...n.paths},components:{...n.components,schemas:{...p.components,...n.components?.schemas}}}},h.json(m)}}export{n as describeRoute,r as openAPISpecs};

package/src/toOpenAPISchema/const.d.ts

@@ -1 +0,0 @@
-export declare const allowedKeywords: string[];

package/src/toOpenAPISchema/index.d.ts

@@ -1,5 +0,0 @@
-import type { JSONSchema4 } from "json-schema";
-import type { OpenAPIV3 } from "openapi-types";
-import type { Options } from "./types";
-declare const convert: <T extends object = JSONSchema4>(schema: T, options?: Options) => Promise<OpenAPIV3.Document>;
-export default convert;

package/typebox.cjs.js

@@ -1 +0,0 @@
-"use strict";var e=require("@hono/typebox-validator"),r=require("./index.cjs2.js"),a=require("@sinclair/typebox/value"),i=require("./utils.cjs.js");function t(e){return{builder:async a=>({schema:await r.convert(e)}),validator:r=>{a.Value.Parse(e,r)}}}require("json-schema-walker"),exports.resolver=t,exports.validator=function(r,a,s){const o=e.tbValidator(r,a,s);return Object.assign(o,{[i.uniqueSymbol]:{resolver:async e=>i.generateValidatorDocs(r,await t(a).builder(e))}})};

package/typebox.esm.d.ts

@@ -1 +0,0 @@
-export * from "./src/typebox";

package/typebox.esm.js

@@ -1 +0,0 @@
-import{tbValidator as r}from"@hono/typebox-validator";import{c as o}from"./index.esm2.js";import{Value as a}from"@sinclair/typebox/value";import{u as s,g as t}from"./utils.esm.js";import"json-schema-walker";function e(r){return{builder:async a=>({schema:await o(r)}),validator:o=>{a.Parse(r,o)}}}function i(o,a,i){const n=r(o,a,i);return Object.assign(n,{[s]:{resolver:async r=>t(o,await e(a).builder(r))}})}export{e as resolver,i as validator};

package/valibot.cjs.js

@@ -1 +0,0 @@
-"use strict";var e=require("@hono/valibot-validator"),r=require("./index.cjs2.js"),a=require("@valibot/to-json-schema"),i=require("valibot"),s=require("./utils.cjs.js");function t(e){return{builder:async i=>({schema:await r.convert(a.toJsonSchema(e))}),validator:async r=>{await i.parseAsync(e,r)}}}require("json-schema-walker"),exports.resolver=t,exports.validator=function(r,a,i){const o=e.vValidator(r,a,i);return Object.assign(o,{[s.uniqueSymbol]:{resolver:async e=>s.generateValidatorDocs(r,await t(a).builder(e))}})};

package/valibot.esm.d.ts

@@ -1 +0,0 @@
-export * from "./src/valibot";

package/valibot.esm.js

@@ -1 +0,0 @@
-import{vValidator as o}from"@hono/valibot-validator";import{c as a}from"./index.esm2.js";import{toJsonSchema as r}from"@valibot/to-json-schema";import{parseAsync as t}from"valibot";import{u as i,g as s}from"./utils.esm.js";import"json-schema-walker";function m(o){return{builder:async t=>({schema:await a(r(o))}),validator:async a=>{await t(o,a)}}}function e(a,r,t){const e=o(a,r,t);return Object.assign(e,{[i]:{resolver:async o=>s(a,await m(r).builder(o))}})}export{m as resolver,e as validator};

package/zod.cjs.js

@@ -1 +0,0 @@
-"use strict";var e=require("@hono/zod-validator"),r=require("zod-openapi"),a=require("./utils.cjs.js");function t(e){return{builder:a=>{const{version:t,...o}=a??{};return r.createSchema(e,a?{openapi:t,...o}:void 0)},validator:e.parse}}exports.resolver=t,exports.validator=function(r,o,i){const n=e.zValidator(r,o,i);return Object.assign(n,{[a.uniqueSymbol]:{resolver:async e=>a.generateValidatorDocs(r,await t(o).builder(e)),metadata:{schemaType:"input"}}})};

package/zod.esm.d.ts

@@ -1 +0,0 @@
-export * from "./src/zod";

package/zod.esm.js

@@ -1 +0,0 @@
-import{zValidator as o}from"@hono/zod-validator";import{createSchema as r}from"zod-openapi";import{u as t,g as a}from"./utils.esm.js";function e(o){return{builder:t=>{const{version:a,...e}=t??{};return r(o,t?{openapi:a,...e}:void 0)},validator:o.parse}}function i(r,i,n){const s=o(r,i,n);return Object.assign(s,{[t]:{resolver:async o=>a(r,await e(i).builder(o)),metadata:{schemaType:"input"}}})}export{e as resolver,i as validator};