feat: Build path/query/header OpenAPI parameters without

aklinker1 · aklinker1 · commit 4b011cd20c48 · 2026-01-30T13:37:03.000-06:00
`SchemaAdapter.parseParamsRecord`
diff --git a/docs/content/server/validation.md b/docs/content/server/validation.md
@@ -57,5 +57,4 @@ Create your own adapter implementing the [`SchemaAdapter` interface](https://jsr
 You need to implement 3 functions:
 
 1. `toJsonSchema` returns a JSON schema representation of the given schema.
-2. `parseParamsRecord` converts an object definition used for `path` and `query` parameters to `path`/`query` parameter definitions.
-3. `getMeta` returns metadata about the given schema.
+2. `getMeta` returns metadata about the given schema.
diff --git a/src/adapters/zod-schema-adapter.ts b/src/adapters/zod-schema-adapter.ts
@@ -23,21 +23,6 @@ export const zodSchemaAdapter: SchemaAdapter = {
     delete res.$schema;
     return res;
   },
-  parseParamsRecord: (params: any) => {
-    if (params?._zod?.def?.type !== "object")
-      throw Error(
-        "Query, params, and header schemas must be simple Zode objects defined with z.object({ ... })",
-      );
-
-    return Object.entries(params._zod.def.shape).map(
-      ([key, schema]: [string, any]) => ({
-        name: key,
-        schema,
-        optional: schema.safeParse(undefined).success,
-        ...z.globalRegistry.get(schema),
-      }),
-    );
-  },
   getMeta: (schema: any) => {
     return z.globalRegistry.get(schema);
   },
diff --git a/src/open-api.ts b/src/open-api.ts
@@ -1,14 +1,14 @@
+import type { StandardSchemaV1 } from "@standard-schema/spec";
 import type { OpenAPI } from "openapi-types";
-import type { App, BasePath, SchemaAdapter } from "./types";
 import type { CreateAppOptions } from "./app";
-import type { StandardSchemaV1 } from "@standard-schema/spec";
-import { getHttpStatusName } from "./status";
+import { getMeta } from "./meta";
 import {
   ErrorResponseJsonSchema,
   isZetaSchema,
   type ZetaSchema,
 } from "./schema";
-import { getMeta } from "./meta";
+import { getHttpStatusName } from "./status";
+import type { App, BasePath, SchemaAdapter } from "./types";
 
 export function buildOpenApiDocs(
   options: CreateAppOptions<any> | undefined,
@@ -146,19 +146,25 @@ export function buildScalarHtml(
 function mapParameters(
   adapter: SchemaAdapter,
   schema: StandardSchemaV1 | undefined,
-  _in: "query" | "path" | "header",
+  in_: "query" | "path" | "header",
 ): OpenAPI.Parameters {
   if (!schema) return [];
 
-  return adapter
-    .parseParamsRecord(schema)
-    .map(({ schema, optional, description, name }) => ({
+  const openApiSchema = adapter.toJsonSchema(schema);
+  if (openApiSchema.type !== "object")
+    throw Error(
+      `Param in ${in_} must have { "type": "object", ... }, but got ${JSON.stringify(openApiSchema, null, 2)}`,
+    );
+
+  return Object.entries(openApiSchema.properties).map(
+    ([name, def]: [string, any]) => ({
       name,
-      in: _in,
-      description,
-      schema: adapter.toJsonSchema(schema),
-      required: !optional,
-    }));
+      in: in_,
+      description: def.description,
+      schema: def,
+      required: !!openApiSchema.required?.includes(name),
+    }),
+  );
 }
 
 function buildResponse(
diff --git a/src/types.ts b/src/types.ts
@@ -1037,17 +1037,6 @@ export interface SchemaAdapter {
    * @returns The JSON schema.
    */
   toJsonSchema: (schema: any) => any;
-  /**
-   * Used to pull out the openapi parameters from a schema.
-   * @param schema The schema to parse.
-   * @returns An array of objects used to generate the OpenAPI docs.
-   */
-  parseParamsRecord: (schema: StandardSchemaV1) => Array<{
-    name: string;
-    optional: boolean;
-    schema: StandardSchemaV1;
-    description?: string;
-  }>;
   getMeta: (schema: StandardSchemaV1) => Record<string, any> | undefined;
 }
 
