hono-openapi 1.3.1 → 1.3.3

package/dist/index.cjs

@@ -6,6 +6,7 @@ var standardJson = require('@standard-community/standard-json');
 var standardOpenapi = require('@standard-community/standard-openapi');
 
 const uniqueSymbol = Symbol("openapi");
+const VALIDATION_MARKER = "__HonoOpenAPIValidator__";
 const ALLOWED_METHODS = [
   "GET",
   "PUT",
@@ -55,10 +56,12 @@ function mergeParameters(...params) {
   return Array.from(merged.values());
 }
 const specsByPathContext = /* @__PURE__ */ new Map();
-function getPathContext(path) {
+function getPathContext(path, pathContext) {
   const context = [];
-  for (const [key, data] of specsByPathContext) {
-    if (data && path.match(key)) {
+  for (const [key, data] of pathContext) {
+    if (!data) continue;
+    const prefix = key.endsWith("/*") ? key.slice(0, -2) : key;
+    if (path === prefix || path.startsWith(`${prefix}/`)) {
       context.push(data);
     }
   }
@@ -67,6 +70,19 @@ function getPathContext(path) {
 function clearSpecsContext() {
   specsByPathContext.clear();
 }
+function mergeRequestBodies(previous, current) {
+  if (!previous || !current || "$ref" in previous || "$ref" in current) {
+    return current;
+  }
+  return {
+    ...previous,
+    ...current,
+    content: {
+      ...previous.content,
+      ...current.content
+    }
+  };
+}
 function mergeSpecs(route, ...specs) {
   return specs.reduce(
     (prev, spec) => {
@@ -88,6 +104,11 @@ function mergeSpecs(route, ...specs) {
           } else {
             if (key === "parameters") {
               prev[key] = mergeParameters(prev[key], value);
+            } else if (key === "requestBody") {
+              prev.requestBody = mergeRequestBodies(
+                prev.requestBody,
+                value
+              );
             } else {
               prev[key] = {
                 ...prev[key],
@@ -106,30 +127,26 @@ function mergeSpecs(route, ...specs) {
     }
   );
 }
-function registerSchemaPath({
-  route,
-  specs,
-  paths
-}) {
+function registerSchemaPath({ route, specs, paths }, pathContext = specsByPathContext) {
   const path = toOpenAPIPath(route.path);
   const method = route.method.toLowerCase();
   if (method === "all") {
     if (!specs) return;
-    if (specsByPathContext.has(path)) {
-      const prev = specsByPathContext.get(path) ?? {};
-      specsByPathContext.set(path, mergeSpecs(route, prev, specs));
+    if (pathContext.has(path)) {
+      const prev = pathContext.get(path) ?? {};
+      pathContext.set(path, mergeSpecs(route, prev, specs));
     } else {
-      specsByPathContext.set(path, specs);
+      pathContext.set(path, specs);
     }
   } else {
-    const pathContext = getPathContext(path);
+    const context = getPathContext(path, pathContext);
     if (!(path in paths)) {
       paths[path] = {};
     }
     if (paths[path]) {
       paths[path][method] = mergeSpecs(
         route,
-        ...pathContext,
+        ...context,
         paths[path]?.[method],
         specs
       );
@@ -159,6 +176,8 @@ function removeExcludedPaths(paths, ctx) {
     for (const method of Object.keys(value)) {
       const schema = value[method];
       if (schema == null) continue;
+      const hasValidation = schema[VALIDATION_MARKER] === true;
+      delete schema[VALIDATION_MARKER];
       if (key.includes("{")) {
         schema.parameters = schema.parameters ? [...schema.parameters] : [];
         const pathParameters = key.split("/").filter(
@@ -198,6 +217,16 @@ function removeExcludedPaths(paths, ctx) {
           200: {}
         };
       }
+      if (hasValidation && ctx.options.defaultValidationErrorResponse !== false && !schema.responses["400"]) {
+        const errorResponse = ctx.options.defaultValidationErrorResponse;
+        if (typeof errorResponse === "object") {
+          schema.responses["400"] = structuredClone(errorResponse);
+        } else if (ctx.validationErrorResponse) {
+          schema.responses["400"] = structuredClone(
+            ctx.validationErrorResponse
+          );
+        }
+      }
     }
     const filteredValue = {};
     for (const method of Object.keys(value)) {
@@ -217,7 +246,27 @@ const DEFAULT_OPTIONS = {
   excludeStaticFile: true,
   exclude: [],
   excludeMethods: ["OPTIONS"],
-  excludeTags: []
+  excludeTags: [],
+  defaultValidationErrorResponse: true
+};
+const DEFAULT_VALIDATION_ERROR = {
+  description: "Validation Error",
+  content: {
+    "application/json": {
+      schema: {
+        type: "object",
+        properties: {
+          success: { type: "boolean", enum: [false] },
+          error: {
+            type: "array",
+            items: {}
+          },
+          data: {}
+        },
+        required: ["success", "error", "data"]
+      }
+    }
+  }
 };
 function openAPIRouteHandler(hono, options) {
   let specs;
@@ -234,10 +283,14 @@ async function generateSpecs(hono, options = DEFAULT_OPTIONS, c) {
     options: {
       ...DEFAULT_OPTIONS,
       ...options
-    }
+    },
+    validationErrorResponse: DEFAULT_VALIDATION_ERROR
   };
   const _documentation = ctx.options.documentation ?? {};
-  clearSpecsContext();
+  const documentation = {
+    ..._documentation,
+    components: _documentation.components && { ..._documentation.components }
+  };
   const paths = await generatePaths(hono, ctx);
   for (const path in paths) {
     for (const method in paths[path]) {
@@ -252,41 +305,48 @@ async function generateSpecs(hono, options = DEFAULT_OPTIONS, c) {
       }
     }
   }
-  const { components: resolvedDocComponents } = _documentation.components?.responses ? await resolveResponseSchemas(_documentation.components.responses) : { components: {} };
+  const resolvedDocumentation = documentation.components?.responses ? await resolveResponseSchemas(documentation.components.responses) : void 0;
+  if (resolvedDocumentation && documentation.components) {
+    documentation.components.responses = resolvedDocumentation.responses;
+  }
   const components = mergeComponentsObjects(
-    _documentation.components,
-    resolvedDocComponents,
+    documentation.components,
+    resolvedDocumentation?.components,
     ctx.components
   );
   return {
     openapi: "3.1.0",
-    ..._documentation,
-    tags: _documentation.tags?.filter(
+    ...documentation,
+    tags: documentation.tags?.filter(
       (tag) => !ctx.options.excludeTags?.includes(tag?.name)
     ),
     info: {
       title: "Hono Documentation",
       description: "Development documentation",
       version: "0.0.0",
-      ..._documentation.info
+      ...documentation.info
     },
     paths: {
       ...removeExcludedPaths(paths, ctx),
-      ..._documentation.paths
+      ...documentation.paths
     },
     components
   };
 }
 async function generatePaths(hono, ctx) {
   const paths = {};
+  const pathContext = /* @__PURE__ */ new Map();
   for (const route of hono.routes) {
     const middlewareHandler = handler.findTargetHandler(route.handler)[uniqueSymbol];
     if (!middlewareHandler) {
       if (ctx.options.includeEmptyPaths) {
-        registerSchemaPath({
-          route,
-          paths
-        });
+        registerSchemaPath(
+          {
+            route,
+            paths
+          },
+          pathContext
+        );
       }
       continue;
     }
@@ -302,14 +362,18 @@ async function generatePaths(hono, ctx) {
     const defaultOptionsForThisMethod = ctx.options.defaultOptions?.[routeMethod] && { ...ctx.options.defaultOptions[routeMethod] };
     const { schema: routeSpecs, components = {} } = await getSpec(
       middlewareHandler,
-      defaultOptionsForThisMethod
+      defaultOptionsForThisMethod,
+      ctx.components.parameters
     );
     ctx.components = mergeComponentsObjects(ctx.components, components);
-    registerSchemaPath({
-      route,
-      specs: routeSpecs,
-      paths
-    });
+    registerSchemaPath(
+      {
+        route,
+        specs: routeSpecs,
+        paths
+      },
+      pathContext
+    );
   }
   return paths;
 }
@@ -325,7 +389,7 @@ function getHiddenValue(options) {
   }
   return false;
 }
-async function getSpec(middlewareHandler, defaultOptions) {
+async function getSpec(middlewareHandler, defaultOptions, parameterComponents) {
   if ("spec" in middlewareHandler) {
     const tmp = {
       ...defaultOptions,
@@ -338,14 +402,29 @@ async function getSpec(middlewareHandler, defaultOptions) {
     let components = {};
     if (tmp.responses) {
       const resolved = await resolveResponseSchemas(tmp.responses);
+      tmp.responses = resolved.responses;
       components = resolved.components;
     }
+    if (tmp.requestBody && "content" in tmp.requestBody) {
+      const resolved = await resolveContentSchemas(tmp.requestBody.content);
+      tmp.requestBody = {
+        ...tmp.requestBody,
+        content: resolved.content
+      };
+      components = mergeComponentsObjects(components, resolved.components);
+    }
     return { schema: tmp, components };
   }
   const result = await middlewareHandler.toOpenAPISchema();
-  const docs = { ...defaultOptions };
+  liftSchemaDefs(result);
+  const docs = {
+    ...defaultOptions,
+    // Mark this operation as validator-derived so a default 400 validation
+    // error response can be auto-injected later (see removeExcludedPaths).
+    [VALIDATION_MARKER]: true
+  };
   if (middlewareHandler.target === "form" || middlewareHandler.target === "json") {
-    const media = middlewareHandler.options?.media ?? middlewareHandler.target === "json" ? "application/json" : "multipart/form-data";
+    const media = middlewareHandler.options?.media ?? (middlewareHandler.target === "json" ? "application/json" : "multipart/form-data");
     if (!docs.requestBody || !("content" in docs.requestBody) || !docs.requestBody.content) {
       docs.requestBody = {
         required: true,
@@ -367,65 +446,130 @@ async function getSpec(middlewareHandler, defaultOptions) {
       const pos = ref.split("/").pop();
       if (pos && result.components?.schemas?.[pos]) {
         const schema = result.components.schemas[pos];
-        const newParameters = generateParameters(
+        const generatedParameters = generateParameters(
           middlewareHandler.target,
-          schema
-        )[0];
-        if (!result.components.parameters) {
-          result.components.parameters = {};
+          schema,
+          result.components.schemas
+        );
+        const singleParameter = generatedParameters.length === 1 ? generatedParameters[0] : void 0;
+        const existingParameter = parameterComponents?.[pos];
+        if (singleParameter && (!existingParameter || "in" in existingParameter && existingParameter.in === singleParameter.in && existingParameter.name === singleParameter.name)) {
+          result.components.parameters ??= {};
+          result.components.parameters[pos] = singleParameter;
+          parameters.push({ $ref: `#/components/parameters/${pos}` });
+          delete result.components.schemas[pos];
+        } else {
+          parameters = generatedParameters;
         }
-        result.components.parameters[pos] = newParameters;
-        delete result.components.schemas[pos];
-        parameters.push({
-          $ref: `#/components/parameters/${pos}`
-        });
       }
     } else {
-      parameters = generateParameters(middlewareHandler.target, result.schema);
+      parameters = generateParameters(
+        middlewareHandler.target,
+        result.schema,
+        result.components?.schemas
+      );
     }
     docs.parameters = parameters;
   }
   return { schema: docs, components: result.components };
 }
-function generateParameters(target, schema) {
+function generateParameters(target, schema, schemas) {
   const parameters = [];
-  for (const [key, value] of Object.entries(schema.properties ?? {})) {
+  for (const [key, property] of collectParameterProperties(schema, schemas)) {
     const def = {
       in: target === "param" ? "path" : target,
       name: key,
-      // @ts-expect-error
-      schema: value
+      // @ts-expect-error ParameterObject uses the OpenAPI 3.0 schema type.
+      schema: property.schema
     };
-    const isRequired = schema.required?.includes(key);
-    if (isRequired) {
+    if (property.required) {
       def.required = true;
     }
     if (def.schema && "description" in def.schema && def.schema.description) {
       def.description = def.schema.description;
-      def.schema.description = void 0;
+      def.schema = { ...def.schema, description: void 0 };
     }
     parameters.push(def);
   }
   return parameters;
 }
-async function resolveResponseSchemas(responses) {
-  let components = {};
-  for (const key of Object.keys(responses)) {
-    const response = responses[key];
-    if (!response || !("content" in response)) continue;
-    for (const contentKey of Object.keys(response.content ?? {})) {
-      const raw = response.content?.[contentKey];
-      if (!raw) continue;
-      if (raw.schema && "toOpenAPISchema" in raw.schema) {
-        const result = await raw.schema.toOpenAPISchema();
-        raw.schema = result.schema;
-        if (result.components) {
-          components = mergeComponentsObjects(components, result.components);
+function collectParameterProperties(schema, schemas) {
+  const properties = /* @__PURE__ */ new Map();
+  const resolvingRefs = /* @__PURE__ */ new Set();
+  const collect = (current) => {
+    for (const [key, value] of Object.entries(current.properties ?? {})) {
+      const existing = properties.get(key);
+      properties.set(key, {
+        schema: existing ? { allOf: [existing.schema, value] } : value,
+        required: Boolean(current.required?.includes(key)) || existing?.required
+      });
+    }
+    for (const member of current.allOf ?? []) {
+      if ("$ref" in member) {
+        const prefix = "#/components/schemas/";
+        if (!member.$ref.startsWith(prefix)) continue;
+        const name = member.$ref.slice(prefix.length).replaceAll("~1", "/").replaceAll("~0", "~");
+        const referencedSchema = schemas?.[name];
+        if (referencedSchema && !resolvingRefs.has(name)) {
+          resolvingRefs.add(name);
+          collect(referencedSchema);
+          resolvingRefs.delete(name);
         }
+      } else {
+        collect(member);
+      }
+    }
+  };
+  collect(schema);
+  return properties;
+}
+async function resolveContentSchemas(content) {
+  let components = {};
+  const resolvedContent = {};
+  for (const [contentKey, raw] of Object.entries(content)) {
+    if (!raw) continue;
+    if (raw.schema && "toOpenAPISchema" in raw.schema) {
+      const result = await raw.schema.toOpenAPISchema();
+      liftSchemaDefs(result);
+      resolvedContent[contentKey] = {
+        ...raw,
+        schema: result.schema
+      };
+      if (result.components) {
+        components = mergeComponentsObjects(components, result.components);
       }
+    } else {
+      resolvedContent[contentKey] = raw;
     }
   }
-  return { responses, components };
+  return { content: resolvedContent, components };
+}
+async function resolveResponseSchemas(responses) {
+  let components = {};
+  const resolvedResponses = {};
+  for (const [key, response] of Object.entries(responses)) {
+    if (!response || !("content" in response) || !response.content) {
+      resolvedResponses[key] = response;
+      continue;
+    }
+    const resolved = await resolveContentSchemas(response.content);
+    resolvedResponses[key] = {
+      ...response,
+      content: resolved.content
+    };
+    components = mergeComponentsObjects(components, resolved.components);
+  }
+  return { responses: resolvedResponses, components };
+}
+function liftSchemaDefs(result) {
+  const defs = result.schema.$defs;
+  if (!defs || typeof defs !== "object") return;
+  result.components ??= {};
+  result.components.schemas = {
+    ...defs,
+    ...result.components.schemas
+  };
+  delete result.schema.$defs;
 }
 function mergeComponentsObjects(...components) {
   return components.reduce(
@@ -571,6 +715,7 @@ function describeResponse(handler, responses, options) {
 }
 
 exports.ALLOWED_METHODS = ALLOWED_METHODS;
+exports.VALIDATION_MARKER = VALIDATION_MARKER;
 exports.clearSpecsContext = clearSpecsContext;
 exports.describeResponse = describeResponse;
 exports.describeRoute = describeRoute;

package/dist/index.d.cts

@@ -1,72 +1,17 @@
 import * as openapi_types from 'openapi-types';
 import { OpenAPIV3_1 } from 'openapi-types';
+import * as hono from 'hono';
 import { Env, Input, Context, Next, MiddlewareHandler, ValidationTargets, Hono } from 'hono';
 import { TypedResponse, RouterRoute, ValidationTargets as ValidationTargets$1, BlankEnv, Input as Input$1, BlankInput, Schema, BlankSchema, MiddlewareHandler as MiddlewareHandler$1 } from 'hono/types';
 import { loadVendor as loadVendor$2, ToOpenAPISchemaContext } from '@standard-community/standard-openapi';
 import { Hook } from '@hono/standard-validator';
 import { loadVendor as loadVendor$1 } from '@standard-community/standard-json';
+import { StandardSchemaV1 } from '@standard-schema/spec';
 import { StatusCode } from 'hono/utils/http-status';
 import { JSONParsed } from 'hono/utils/types';
 import { InferInput } from 'hono/validator';
 import { JSONSchema7 } from 'json-schema';
 
-/** The Standard Schema interface. */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-    /** The Standard Schema properties. */
-    readonly "~standard": StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-    /** The Standard Schema properties interface. */
-    export interface Props<Input = unknown, Output = Input> {
-        /** The version number of the standard. */
-        readonly version: 1;
-        /** The vendor name of the schema library. */
-        readonly vendor: string;
-        /** Validates unknown input values. */
-        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
-        /** Inferred types associated with the schema. */
-        readonly types?: Types<Input, Output> | undefined;
-    }
-    /** The result interface of the validate function. */
-    export type Result<Output> = SuccessResult<Output> | FailureResult;
-    /** The result interface if validation succeeds. */
-    export interface SuccessResult<Output> {
-        /** The typed output value. */
-        readonly value: Output;
-        /** The non-existent issues. */
-        readonly issues?: undefined;
-    }
-    /** The result interface if validation fails. */
-    export interface FailureResult {
-        /** The issues of failed validation. */
-        readonly issues: ReadonlyArray<Issue>;
-    }
-    /** The issue interface of the failure output. */
-    export interface Issue {
-        /** The error message of the issue. */
-        readonly message: string;
-        /** The path of the issue, if any. */
-        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
-    }
-    /** The path segment interface of the issue. */
-    export interface PathSegment {
-        /** The key representing a path segment. */
-        readonly key: PropertyKey;
-    }
-    /** The Standard Schema types interface. */
-    export interface Types<Input = unknown, Output = Input> {
-        /** The input type of the schema. */
-        readonly input: Input;
-        /** The output type of the schema. */
-        readonly output: Output;
-    }
-    /** Infers the input type of a Standard Schema. */
-    export type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
-    /** Infers the output type of a Standard Schema. */
-    export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
-    export {  };
-}
-
 declare function loadVendor(vendor: string, fn: {
     toJSONSchema?: Parameters<typeof loadVendor$1>[1];
     toOpenAPISchema?: Parameters<typeof loadVendor$2>[1];
@@ -129,10 +74,31 @@ declare function describeResponse<E extends Env, P extends string, I extends Inp
  * The unique symbol for the middlewares, which makes it easier to identify them. Not meant to be used directly, unless you're creating a custom middleware.
  */
 declare const uniqueSymbol: unique symbol;
+/**
+ * Internal marker key set on an operation's spec when it is produced by a
+ * `validator()` middleware. It is used to decide whether to auto-inject the
+ * default 400 validation error response, and is stripped from the operation
+ * before the spec is emitted. Must be an enumerable string key so it survives
+ * the `Object.entries`-based merge in `mergeSpecs`.
+ */
+declare const VALIDATION_MARKER = "__HonoOpenAPIValidator__";
 declare const ALLOWED_METHODS: readonly ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 type AllowedMethods = (typeof ALLOWED_METHODS)[number];
 declare function clearSpecsContext(): void;
-declare function registerSchemaPath({ route, specs, paths, }: RegisterSchemaPathOptions): void;
+declare function registerSchemaPath({ route, specs, paths }: RegisterSchemaPathOptions, pathContext?: Map<string, Omit<OpenAPIV3_1.OperationObject<{}>, "operationId" | "requestBody" | "responses"> & {
+    operationId?: string | ((route: RouterRoute) => string);
+    requestBody?: OpenAPIV3_1.ReferenceObject | (Omit<OpenAPIV3_1.RequestBodyObject, "content"> & {
+        content: ContentWithResolver;
+    });
+    hide?: boolean | ((props: {
+        c?: hono.Context;
+        method: string;
+        path: string;
+    }) => boolean);
+    responses?: ResponsesWithResolver;
+} & {
+    operationId?: string | ((route: RouterRoute) => string);
+}>): void;
 declare function removeExcludedPaths(paths: OpenAPIV3_1.PathsObject, ctx: SpecContext): OpenAPIV3_1.PathsObject<{}, {}>;
 
 type PromiseOr<T> = T | Promise<T>;
@@ -155,13 +121,17 @@ type HandlerUniqueProperty = (ResolverReturnType & {
 type MediaTypeObjectWithResolver = Omit<OpenAPIV3_1.MediaTypeObject, "schema"> & {
     schema?: OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.SchemaObject | ResolverReturnType;
 };
+type ContentWithResolver = {
+    [media: string]: MediaTypeObjectWithResolver;
+};
 /**
  * A response object that accepts resolver() output in schema positions.
  */
 type ResponseObjectWithResolver = (Omit<OpenAPIV3_1.ResponseObject, "content"> & {
-    content?: {
-        [media: string]: MediaTypeObjectWithResolver;
-    };
+    content?: ContentWithResolver;
+}) | OpenAPIV3_1.ReferenceObject;
+type RequestBodyObjectWithResolver = (Omit<OpenAPIV3_1.RequestBodyObject, "content"> & {
+    content: ContentWithResolver;
 }) | OpenAPIV3_1.ReferenceObject;
 /**
  * A responses map that accepts resolver() output in schema positions.
@@ -214,10 +184,23 @@ type GenerateSpecOptions = {
      * Default options for `describeRoute` method
      */
     defaultOptions: Partial<Record<AllowedMethods | "ALL", DescribeRouteOptions>>;
+    /**
+     * Automatically include a 400 validation error response for routes
+     * that use `validator()`. Set to `false` to disable, `true` to use
+     * the built-in schema, or provide a custom `ResponseObject`.
+     *
+     * @default true
+     */
+    defaultValidationErrorResponse: boolean | OpenAPIV3_1.ResponseObject;
 };
 type OperationId = string | ((route: RouterRoute) => string);
-type DescribeRouteOptions = Omit<OpenAPIV3_1.OperationObject, "responses" | "operationId"> & {
+type DescribeRouteOptions = Omit<OpenAPIV3_1.OperationObject, "requestBody" | "responses" | "operationId"> & {
     operationId?: OperationId;
+    /**
+     * Request body metadata. `resolver()` values are converted to OpenAPI
+     * schemas while generating the document.
+     */
+    requestBody?: RequestBodyObjectWithResolver;
     /**
      * Pass `true` to hide route from OpenAPI/swagger document
      */
@@ -238,11 +221,12 @@ type RegisterSchemaPathOptions = {
     };
     paths: Partial<OpenAPIV3_1.PathsObject>;
 };
-type HaveDefaultValues = "documentation" | "excludeStaticFile" | "exclude" | "excludeMethods" | "excludeTags";
+type HaveDefaultValues = "documentation" | "excludeStaticFile" | "exclude" | "excludeMethods" | "excludeTags" | "defaultValidationErrorResponse";
 type SanitizedGenerateSpecOptions = Pick<GenerateSpecOptions, HaveDefaultValues> & Omit<Partial<GenerateSpecOptions>, HaveDefaultValues>;
 type SpecContext = {
     components: OpenAPIV3_1.ComponentsObject;
     options: SanitizedGenerateSpecOptions;
+    validationErrorResponse?: OpenAPIV3_1.ResponseObject;
 };
 
 /**
@@ -295,4 +279,4 @@ declare function generateSpecs<E extends Env = BlankEnv, P extends string = stri
     jsonSchemaDialect?: string;
 }>;
 
-export { ALLOWED_METHODS, type AllowedMethods, type DescribeRouteOptions, type GenerateSpecOptions, type HandlerUniqueProperty, type PromiseOr, type RegisterSchemaPathOptions, type ResolverReturnType, type ResponsesWithResolver, type SpecContext, clearSpecsContext, describeResponse, describeRoute, generateSpecs, loadVendor, openAPIRouteHandler, registerSchemaPath, removeExcludedPaths, resolver, uniqueSymbol, validator };
+export { ALLOWED_METHODS, type AllowedMethods, type ContentWithResolver, type DescribeRouteOptions, type GenerateSpecOptions, type HandlerUniqueProperty, type PromiseOr, type RegisterSchemaPathOptions, type ResolverReturnType, type ResponsesWithResolver, type SpecContext, VALIDATION_MARKER, clearSpecsContext, describeResponse, describeRoute, generateSpecs, loadVendor, openAPIRouteHandler, registerSchemaPath, removeExcludedPaths, resolver, uniqueSymbol, validator };

package/dist/index.d.ts

@@ -1,72 +1,17 @@
 import * as openapi_types from 'openapi-types';
 import { OpenAPIV3_1 } from 'openapi-types';
+import * as hono from 'hono';
 import { Env, Input, Context, Next, MiddlewareHandler, ValidationTargets, Hono } from 'hono';
 import { TypedResponse, RouterRoute, ValidationTargets as ValidationTargets$1, BlankEnv, Input as Input$1, BlankInput, Schema, BlankSchema, MiddlewareHandler as MiddlewareHandler$1 } from 'hono/types';
 import { loadVendor as loadVendor$2, ToOpenAPISchemaContext } from '@standard-community/standard-openapi';
 import { Hook } from '@hono/standard-validator';
 import { loadVendor as loadVendor$1 } from '@standard-community/standard-json';
+import { StandardSchemaV1 } from '@standard-schema/spec';
 import { StatusCode } from 'hono/utils/http-status';
 import { JSONParsed } from 'hono/utils/types';
 import { InferInput } from 'hono/validator';
 import { JSONSchema7 } from 'json-schema';
 
-/** The Standard Schema interface. */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-    /** The Standard Schema properties. */
-    readonly "~standard": StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-    /** The Standard Schema properties interface. */
-    export interface Props<Input = unknown, Output = Input> {
-        /** The version number of the standard. */
-        readonly version: 1;
-        /** The vendor name of the schema library. */
-        readonly vendor: string;
-        /** Validates unknown input values. */
-        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
-        /** Inferred types associated with the schema. */
-        readonly types?: Types<Input, Output> | undefined;
-    }
-    /** The result interface of the validate function. */
-    export type Result<Output> = SuccessResult<Output> | FailureResult;
-    /** The result interface if validation succeeds. */
-    export interface SuccessResult<Output> {
-        /** The typed output value. */
-        readonly value: Output;
-        /** The non-existent issues. */
-        readonly issues?: undefined;
-    }
-    /** The result interface if validation fails. */
-    export interface FailureResult {
-        /** The issues of failed validation. */
-        readonly issues: ReadonlyArray<Issue>;
-    }
-    /** The issue interface of the failure output. */
-    export interface Issue {
-        /** The error message of the issue. */
-        readonly message: string;
-        /** The path of the issue, if any. */
-        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
-    }
-    /** The path segment interface of the issue. */
-    export interface PathSegment {
-        /** The key representing a path segment. */
-        readonly key: PropertyKey;
-    }
-    /** The Standard Schema types interface. */
-    export interface Types<Input = unknown, Output = Input> {
-        /** The input type of the schema. */
-        readonly input: Input;
-        /** The output type of the schema. */
-        readonly output: Output;
-    }
-    /** Infers the input type of a Standard Schema. */
-    export type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
-    /** Infers the output type of a Standard Schema. */
-    export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
-    export {  };
-}
-
 declare function loadVendor(vendor: string, fn: {
     toJSONSchema?: Parameters<typeof loadVendor$1>[1];
     toOpenAPISchema?: Parameters<typeof loadVendor$2>[1];
@@ -129,10 +74,31 @@ declare function describeResponse<E extends Env, P extends string, I extends Inp
  * The unique symbol for the middlewares, which makes it easier to identify them. Not meant to be used directly, unless you're creating a custom middleware.
  */
 declare const uniqueSymbol: unique symbol;
+/**
+ * Internal marker key set on an operation's spec when it is produced by a
+ * `validator()` middleware. It is used to decide whether to auto-inject the
+ * default 400 validation error response, and is stripped from the operation
+ * before the spec is emitted. Must be an enumerable string key so it survives
+ * the `Object.entries`-based merge in `mergeSpecs`.
+ */
+declare const VALIDATION_MARKER = "__HonoOpenAPIValidator__";
 declare const ALLOWED_METHODS: readonly ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 type AllowedMethods = (typeof ALLOWED_METHODS)[number];
 declare function clearSpecsContext(): void;
-declare function registerSchemaPath({ route, specs, paths, }: RegisterSchemaPathOptions): void;
+declare function registerSchemaPath({ route, specs, paths }: RegisterSchemaPathOptions, pathContext?: Map<string, Omit<OpenAPIV3_1.OperationObject<{}>, "operationId" | "requestBody" | "responses"> & {
+    operationId?: string | ((route: RouterRoute) => string);
+    requestBody?: OpenAPIV3_1.ReferenceObject | (Omit<OpenAPIV3_1.RequestBodyObject, "content"> & {
+        content: ContentWithResolver;
+    });
+    hide?: boolean | ((props: {
+        c?: hono.Context;
+        method: string;
+        path: string;
+    }) => boolean);
+    responses?: ResponsesWithResolver;
+} & {
+    operationId?: string | ((route: RouterRoute) => string);
+}>): void;
 declare function removeExcludedPaths(paths: OpenAPIV3_1.PathsObject, ctx: SpecContext): OpenAPIV3_1.PathsObject<{}, {}>;
 
 type PromiseOr<T> = T | Promise<T>;
@@ -155,13 +121,17 @@ type HandlerUniqueProperty = (ResolverReturnType & {
 type MediaTypeObjectWithResolver = Omit<OpenAPIV3_1.MediaTypeObject, "schema"> & {
     schema?: OpenAPIV3_1.ReferenceObject | OpenAPIV3_1.SchemaObject | ResolverReturnType;
 };
+type ContentWithResolver = {
+    [media: string]: MediaTypeObjectWithResolver;
+};
 /**
  * A response object that accepts resolver() output in schema positions.
  */
 type ResponseObjectWithResolver = (Omit<OpenAPIV3_1.ResponseObject, "content"> & {
-    content?: {
-        [media: string]: MediaTypeObjectWithResolver;
-    };
+    content?: ContentWithResolver;
+}) | OpenAPIV3_1.ReferenceObject;
+type RequestBodyObjectWithResolver = (Omit<OpenAPIV3_1.RequestBodyObject, "content"> & {
+    content: ContentWithResolver;
 }) | OpenAPIV3_1.ReferenceObject;
 /**
  * A responses map that accepts resolver() output in schema positions.
@@ -214,10 +184,23 @@ type GenerateSpecOptions = {
      * Default options for `describeRoute` method
      */
     defaultOptions: Partial<Record<AllowedMethods | "ALL", DescribeRouteOptions>>;
+    /**
+     * Automatically include a 400 validation error response for routes
+     * that use `validator()`. Set to `false` to disable, `true` to use
+     * the built-in schema, or provide a custom `ResponseObject`.
+     *
+     * @default true
+     */
+    defaultValidationErrorResponse: boolean | OpenAPIV3_1.ResponseObject;
 };
 type OperationId = string | ((route: RouterRoute) => string);
-type DescribeRouteOptions = Omit<OpenAPIV3_1.OperationObject, "responses" | "operationId"> & {
+type DescribeRouteOptions = Omit<OpenAPIV3_1.OperationObject, "requestBody" | "responses" | "operationId"> & {
     operationId?: OperationId;
+    /**
+     * Request body metadata. `resolver()` values are converted to OpenAPI
+     * schemas while generating the document.
+     */
+    requestBody?: RequestBodyObjectWithResolver;
     /**
      * Pass `true` to hide route from OpenAPI/swagger document
      */
@@ -238,11 +221,12 @@ type RegisterSchemaPathOptions = {
     };
     paths: Partial<OpenAPIV3_1.PathsObject>;
 };
-type HaveDefaultValues = "documentation" | "excludeStaticFile" | "exclude" | "excludeMethods" | "excludeTags";
+type HaveDefaultValues = "documentation" | "excludeStaticFile" | "exclude" | "excludeMethods" | "excludeTags" | "defaultValidationErrorResponse";
 type SanitizedGenerateSpecOptions = Pick<GenerateSpecOptions, HaveDefaultValues> & Omit<Partial<GenerateSpecOptions>, HaveDefaultValues>;
 type SpecContext = {
     components: OpenAPIV3_1.ComponentsObject;
     options: SanitizedGenerateSpecOptions;
+    validationErrorResponse?: OpenAPIV3_1.ResponseObject;
 };
 
 /**
@@ -295,4 +279,4 @@ declare function generateSpecs<E extends Env = BlankEnv, P extends string = stri
     jsonSchemaDialect?: string;
 }>;
 
-export { ALLOWED_METHODS, type AllowedMethods, type DescribeRouteOptions, type GenerateSpecOptions, type HandlerUniqueProperty, type PromiseOr, type RegisterSchemaPathOptions, type ResolverReturnType, type ResponsesWithResolver, type SpecContext, clearSpecsContext, describeResponse, describeRoute, generateSpecs, loadVendor, openAPIRouteHandler, registerSchemaPath, removeExcludedPaths, resolver, uniqueSymbol, validator };
+export { ALLOWED_METHODS, type AllowedMethods, type ContentWithResolver, type DescribeRouteOptions, type GenerateSpecOptions, type HandlerUniqueProperty, type PromiseOr, type RegisterSchemaPathOptions, type ResolverReturnType, type ResponsesWithResolver, type SpecContext, VALIDATION_MARKER, clearSpecsContext, describeResponse, describeRoute, generateSpecs, loadVendor, openAPIRouteHandler, registerSchemaPath, removeExcludedPaths, resolver, uniqueSymbol, validator };

package/dist/index.js

@@ -4,6 +4,7 @@ import { loadVendor as loadVendor$1, toJsonSchema } from '@standard-community/st
 import { loadVendor as loadVendor$2, toOpenAPISchema } from '@standard-community/standard-openapi';
 
 const uniqueSymbol = Symbol("openapi");
+const VALIDATION_MARKER = "__HonoOpenAPIValidator__";
 const ALLOWED_METHODS = [
   "GET",
   "PUT",
@@ -53,10 +54,12 @@ function mergeParameters(...params) {
   return Array.from(merged.values());
 }
 const specsByPathContext = /* @__PURE__ */ new Map();
-function getPathContext(path) {
+function getPathContext(path, pathContext) {
   const context = [];
-  for (const [key, data] of specsByPathContext) {
-    if (data && path.match(key)) {
+  for (const [key, data] of pathContext) {
+    if (!data) continue;
+    const prefix = key.endsWith("/*") ? key.slice(0, -2) : key;
+    if (path === prefix || path.startsWith(`${prefix}/`)) {
       context.push(data);
     }
   }
@@ -65,6 +68,19 @@ function getPathContext(path) {
 function clearSpecsContext() {
   specsByPathContext.clear();
 }
+function mergeRequestBodies(previous, current) {
+  if (!previous || !current || "$ref" in previous || "$ref" in current) {
+    return current;
+  }
+  return {
+    ...previous,
+    ...current,
+    content: {
+      ...previous.content,
+      ...current.content
+    }
+  };
+}
 function mergeSpecs(route, ...specs) {
   return specs.reduce(
     (prev, spec) => {
@@ -86,6 +102,11 @@ function mergeSpecs(route, ...specs) {
           } else {
             if (key === "parameters") {
               prev[key] = mergeParameters(prev[key], value);
+            } else if (key === "requestBody") {
+              prev.requestBody = mergeRequestBodies(
+                prev.requestBody,
+                value
+              );
             } else {
               prev[key] = {
                 ...prev[key],
@@ -104,30 +125,26 @@ function mergeSpecs(route, ...specs) {
     }
   );
 }
-function registerSchemaPath({
-  route,
-  specs,
-  paths
-}) {
+function registerSchemaPath({ route, specs, paths }, pathContext = specsByPathContext) {
   const path = toOpenAPIPath(route.path);
   const method = route.method.toLowerCase();
   if (method === "all") {
     if (!specs) return;
-    if (specsByPathContext.has(path)) {
-      const prev = specsByPathContext.get(path) ?? {};
-      specsByPathContext.set(path, mergeSpecs(route, prev, specs));
+    if (pathContext.has(path)) {
+      const prev = pathContext.get(path) ?? {};
+      pathContext.set(path, mergeSpecs(route, prev, specs));
     } else {
-      specsByPathContext.set(path, specs);
+      pathContext.set(path, specs);
     }
   } else {
-    const pathContext = getPathContext(path);
+    const context = getPathContext(path, pathContext);
     if (!(path in paths)) {
       paths[path] = {};
     }
     if (paths[path]) {
       paths[path][method] = mergeSpecs(
         route,
-        ...pathContext,
+        ...context,
         paths[path]?.[method],
         specs
       );
@@ -157,6 +174,8 @@ function removeExcludedPaths(paths, ctx) {
     for (const method of Object.keys(value)) {
       const schema = value[method];
       if (schema == null) continue;
+      const hasValidation = schema[VALIDATION_MARKER] === true;
+      delete schema[VALIDATION_MARKER];
       if (key.includes("{")) {
         schema.parameters = schema.parameters ? [...schema.parameters] : [];
         const pathParameters = key.split("/").filter(
@@ -196,6 +215,16 @@ function removeExcludedPaths(paths, ctx) {
           200: {}
         };
       }
+      if (hasValidation && ctx.options.defaultValidationErrorResponse !== false && !schema.responses["400"]) {
+        const errorResponse = ctx.options.defaultValidationErrorResponse;
+        if (typeof errorResponse === "object") {
+          schema.responses["400"] = structuredClone(errorResponse);
+        } else if (ctx.validationErrorResponse) {
+          schema.responses["400"] = structuredClone(
+            ctx.validationErrorResponse
+          );
+        }
+      }
     }
     const filteredValue = {};
     for (const method of Object.keys(value)) {
@@ -215,7 +244,27 @@ const DEFAULT_OPTIONS = {
   excludeStaticFile: true,
   exclude: [],
   excludeMethods: ["OPTIONS"],
-  excludeTags: []
+  excludeTags: [],
+  defaultValidationErrorResponse: true
+};
+const DEFAULT_VALIDATION_ERROR = {
+  description: "Validation Error",
+  content: {
+    "application/json": {
+      schema: {
+        type: "object",
+        properties: {
+          success: { type: "boolean", enum: [false] },
+          error: {
+            type: "array",
+            items: {}
+          },
+          data: {}
+        },
+        required: ["success", "error", "data"]
+      }
+    }
+  }
 };
 function openAPIRouteHandler(hono, options) {
   let specs;
@@ -232,10 +281,14 @@ async function generateSpecs(hono, options = DEFAULT_OPTIONS, c) {
     options: {
       ...DEFAULT_OPTIONS,
       ...options
-    }
+    },
+    validationErrorResponse: DEFAULT_VALIDATION_ERROR
   };
   const _documentation = ctx.options.documentation ?? {};
-  clearSpecsContext();
+  const documentation = {
+    ..._documentation,
+    components: _documentation.components && { ..._documentation.components }
+  };
   const paths = await generatePaths(hono, ctx);
   for (const path in paths) {
     for (const method in paths[path]) {
@@ -250,41 +303,48 @@ async function generateSpecs(hono, options = DEFAULT_OPTIONS, c) {
       }
     }
   }
-  const { components: resolvedDocComponents } = _documentation.components?.responses ? await resolveResponseSchemas(_documentation.components.responses) : { components: {} };
+  const resolvedDocumentation = documentation.components?.responses ? await resolveResponseSchemas(documentation.components.responses) : void 0;
+  if (resolvedDocumentation && documentation.components) {
+    documentation.components.responses = resolvedDocumentation.responses;
+  }
   const components = mergeComponentsObjects(
-    _documentation.components,
-    resolvedDocComponents,
+    documentation.components,
+    resolvedDocumentation?.components,
     ctx.components
   );
   return {
     openapi: "3.1.0",
-    ..._documentation,
-    tags: _documentation.tags?.filter(
+    ...documentation,
+    tags: documentation.tags?.filter(
       (tag) => !ctx.options.excludeTags?.includes(tag?.name)
     ),
     info: {
       title: "Hono Documentation",
       description: "Development documentation",
       version: "0.0.0",
-      ..._documentation.info
+      ...documentation.info
     },
     paths: {
       ...removeExcludedPaths(paths, ctx),
-      ..._documentation.paths
+      ...documentation.paths
     },
     components
   };
 }
 async function generatePaths(hono, ctx) {
   const paths = {};
+  const pathContext = /* @__PURE__ */ new Map();
   for (const route of hono.routes) {
     const middlewareHandler = findTargetHandler(route.handler)[uniqueSymbol];
     if (!middlewareHandler) {
       if (ctx.options.includeEmptyPaths) {
-        registerSchemaPath({
-          route,
-          paths
-        });
+        registerSchemaPath(
+          {
+            route,
+            paths
+          },
+          pathContext
+        );
       }
       continue;
     }
@@ -300,14 +360,18 @@ async function generatePaths(hono, ctx) {
     const defaultOptionsForThisMethod = ctx.options.defaultOptions?.[routeMethod] && { ...ctx.options.defaultOptions[routeMethod] };
     const { schema: routeSpecs, components = {} } = await getSpec(
       middlewareHandler,
-      defaultOptionsForThisMethod
+      defaultOptionsForThisMethod,
+      ctx.components.parameters
     );
     ctx.components = mergeComponentsObjects(ctx.components, components);
-    registerSchemaPath({
-      route,
-      specs: routeSpecs,
-      paths
-    });
+    registerSchemaPath(
+      {
+        route,
+        specs: routeSpecs,
+        paths
+      },
+      pathContext
+    );
   }
   return paths;
 }
@@ -323,7 +387,7 @@ function getHiddenValue(options) {
   }
   return false;
 }
-async function getSpec(middlewareHandler, defaultOptions) {
+async function getSpec(middlewareHandler, defaultOptions, parameterComponents) {
   if ("spec" in middlewareHandler) {
     const tmp = {
       ...defaultOptions,
@@ -336,14 +400,29 @@ async function getSpec(middlewareHandler, defaultOptions) {
     let components = {};
     if (tmp.responses) {
       const resolved = await resolveResponseSchemas(tmp.responses);
+      tmp.responses = resolved.responses;
       components = resolved.components;
     }
+    if (tmp.requestBody && "content" in tmp.requestBody) {
+      const resolved = await resolveContentSchemas(tmp.requestBody.content);
+      tmp.requestBody = {
+        ...tmp.requestBody,
+        content: resolved.content
+      };
+      components = mergeComponentsObjects(components, resolved.components);
+    }
     return { schema: tmp, components };
   }
   const result = await middlewareHandler.toOpenAPISchema();
-  const docs = { ...defaultOptions };
+  liftSchemaDefs(result);
+  const docs = {
+    ...defaultOptions,
+    // Mark this operation as validator-derived so a default 400 validation
+    // error response can be auto-injected later (see removeExcludedPaths).
+    [VALIDATION_MARKER]: true
+  };
   if (middlewareHandler.target === "form" || middlewareHandler.target === "json") {
-    const media = middlewareHandler.options?.media ?? middlewareHandler.target === "json" ? "application/json" : "multipart/form-data";
+    const media = middlewareHandler.options?.media ?? (middlewareHandler.target === "json" ? "application/json" : "multipart/form-data");
     if (!docs.requestBody || !("content" in docs.requestBody) || !docs.requestBody.content) {
       docs.requestBody = {
         required: true,
@@ -365,65 +444,130 @@ async function getSpec(middlewareHandler, defaultOptions) {
       const pos = ref.split("/").pop();
       if (pos && result.components?.schemas?.[pos]) {
         const schema = result.components.schemas[pos];
-        const newParameters = generateParameters(
+        const generatedParameters = generateParameters(
           middlewareHandler.target,
-          schema
-        )[0];
-        if (!result.components.parameters) {
-          result.components.parameters = {};
+          schema,
+          result.components.schemas
+        );
+        const singleParameter = generatedParameters.length === 1 ? generatedParameters[0] : void 0;
+        const existingParameter = parameterComponents?.[pos];
+        if (singleParameter && (!existingParameter || "in" in existingParameter && existingParameter.in === singleParameter.in && existingParameter.name === singleParameter.name)) {
+          result.components.parameters ??= {};
+          result.components.parameters[pos] = singleParameter;
+          parameters.push({ $ref: `#/components/parameters/${pos}` });
+          delete result.components.schemas[pos];
+        } else {
+          parameters = generatedParameters;
         }
-        result.components.parameters[pos] = newParameters;
-        delete result.components.schemas[pos];
-        parameters.push({
-          $ref: `#/components/parameters/${pos}`
-        });
       }
     } else {
-      parameters = generateParameters(middlewareHandler.target, result.schema);
+      parameters = generateParameters(
+        middlewareHandler.target,
+        result.schema,
+        result.components?.schemas
+      );
     }
     docs.parameters = parameters;
   }
   return { schema: docs, components: result.components };
 }
-function generateParameters(target, schema) {
+function generateParameters(target, schema, schemas) {
   const parameters = [];
-  for (const [key, value] of Object.entries(schema.properties ?? {})) {
+  for (const [key, property] of collectParameterProperties(schema, schemas)) {
     const def = {
       in: target === "param" ? "path" : target,
       name: key,
-      // @ts-expect-error
-      schema: value
+      // @ts-expect-error ParameterObject uses the OpenAPI 3.0 schema type.
+      schema: property.schema
     };
-    const isRequired = schema.required?.includes(key);
-    if (isRequired) {
+    if (property.required) {
       def.required = true;
     }
     if (def.schema && "description" in def.schema && def.schema.description) {
       def.description = def.schema.description;
-      def.schema.description = void 0;
+      def.schema = { ...def.schema, description: void 0 };
     }
     parameters.push(def);
   }
   return parameters;
 }
-async function resolveResponseSchemas(responses) {
-  let components = {};
-  for (const key of Object.keys(responses)) {
-    const response = responses[key];
-    if (!response || !("content" in response)) continue;
-    for (const contentKey of Object.keys(response.content ?? {})) {
-      const raw = response.content?.[contentKey];
-      if (!raw) continue;
-      if (raw.schema && "toOpenAPISchema" in raw.schema) {
-        const result = await raw.schema.toOpenAPISchema();
-        raw.schema = result.schema;
-        if (result.components) {
-          components = mergeComponentsObjects(components, result.components);
+function collectParameterProperties(schema, schemas) {
+  const properties = /* @__PURE__ */ new Map();
+  const resolvingRefs = /* @__PURE__ */ new Set();
+  const collect = (current) => {
+    for (const [key, value] of Object.entries(current.properties ?? {})) {
+      const existing = properties.get(key);
+      properties.set(key, {
+        schema: existing ? { allOf: [existing.schema, value] } : value,
+        required: Boolean(current.required?.includes(key)) || existing?.required
+      });
+    }
+    for (const member of current.allOf ?? []) {
+      if ("$ref" in member) {
+        const prefix = "#/components/schemas/";
+        if (!member.$ref.startsWith(prefix)) continue;
+        const name = member.$ref.slice(prefix.length).replaceAll("~1", "/").replaceAll("~0", "~");
+        const referencedSchema = schemas?.[name];
+        if (referencedSchema && !resolvingRefs.has(name)) {
+          resolvingRefs.add(name);
+          collect(referencedSchema);
+          resolvingRefs.delete(name);
         }
+      } else {
+        collect(member);
+      }
+    }
+  };
+  collect(schema);
+  return properties;
+}
+async function resolveContentSchemas(content) {
+  let components = {};
+  const resolvedContent = {};
+  for (const [contentKey, raw] of Object.entries(content)) {
+    if (!raw) continue;
+    if (raw.schema && "toOpenAPISchema" in raw.schema) {
+      const result = await raw.schema.toOpenAPISchema();
+      liftSchemaDefs(result);
+      resolvedContent[contentKey] = {
+        ...raw,
+        schema: result.schema
+      };
+      if (result.components) {
+        components = mergeComponentsObjects(components, result.components);
       }
+    } else {
+      resolvedContent[contentKey] = raw;
     }
   }
-  return { responses, components };
+  return { content: resolvedContent, components };
+}
+async function resolveResponseSchemas(responses) {
+  let components = {};
+  const resolvedResponses = {};
+  for (const [key, response] of Object.entries(responses)) {
+    if (!response || !("content" in response) || !response.content) {
+      resolvedResponses[key] = response;
+      continue;
+    }
+    const resolved = await resolveContentSchemas(response.content);
+    resolvedResponses[key] = {
+      ...response,
+      content: resolved.content
+    };
+    components = mergeComponentsObjects(components, resolved.components);
+  }
+  return { responses: resolvedResponses, components };
+}
+function liftSchemaDefs(result) {
+  const defs = result.schema.$defs;
+  if (!defs || typeof defs !== "object") return;
+  result.components ??= {};
+  result.components.schemas = {
+    ...defs,
+    ...result.components.schemas
+  };
+  delete result.schema.$defs;
 }
 function mergeComponentsObjects(...components) {
   return components.reduce(
@@ -568,4 +712,4 @@ function describeResponse(handler, responses, options) {
   });
 }
 
-export { ALLOWED_METHODS, clearSpecsContext, describeResponse, describeRoute, generateSpecs, loadVendor, openAPIRouteHandler, registerSchemaPath, removeExcludedPaths, resolver, uniqueSymbol, validator };
+export { ALLOWED_METHODS, VALIDATION_MARKER, clearSpecsContext, describeResponse, describeRoute, generateSpecs, loadVendor, openAPIRouteHandler, registerSchemaPath, removeExcludedPaths, resolver, uniqueSymbol, validator };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hono-openapi",
   "description": "OpenAPI schema generator for Hono",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -40,28 +40,22 @@
       "default": "./dist/index.cjs"
     }
   },
-  "peerDependencies": {
-    "@hono/standard-validator": "^0.2.0",
+  "dependencies": {
+    "@hono/standard-validator": "^0.4.0",
     "@standard-community/standard-json": "^0.3.5",
     "@standard-community/standard-openapi": "^0.2.9",
+    "@standard-schema/spec": "^1.0.0",
     "@types/json-schema": "^7.0.15",
-    "hono": "^4.11.2",
     "openapi-types": "^12.1.3"
   },
-  "peerDependenciesMeta": {
-    "@hono/standard-validator": {
-      "optional": true
-    },
-    "hono": {
-      "optional": true
-    }
+  "peerDependencies": {
+    "hono": "^4.11.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.0.6",
-    "@standard-schema/spec": "^1.0.0",
     "@valibot/to-json-schema": "^1.3.0",
     "arktype": "^2.1.22",
-    "effect": "^3.17.13",
+    "effect": "^3.17.14",
     "husky": "^9.1.7",
     "is-ci": "^4.1.0",
     "nano-staged": "^0.8.0",