@kubb/plugin-zod 5.1.0-canary.20260824T123003 → 5.1.0

package/dist/index.d.ts

@@ -276,7 +276,9 @@ type ResolverZod = Resolver & {
      */
     body(node: ast.OperationNode): string;
     /**
-     * Resolves the name for the collection of all operation responses.
+     * Resolves the name for the per-status record of all operation responses. Only meaningful when
+     * `inferred: true`, since the schema and type this name points to are generated only in that
+     * case. Generated clients key their `RequestResult` on the inferred type.
      *
      * @example Responses collection names
      * `resolver.response.responses(node) // → 'listPetsResponsesSchema'`

package/dist/index.js

@@ -145,6 +145,62 @@ function buildOptionsSchema(node, resolver) {
 		})]
 	});
 }
+/**
+* The schema a status occupies in the `<Name>Responses` record. A status that documents several
+* content types becomes a `{ contentType; data }` union so the runtime can surface the negotiated type
+* on `result.parsed`, while the standalone `<Name>StatusNNN` alias stays the plain body union that the
+* query hooks and `result.data` use.
+*/
+function buildResponseRecordEntry(node, res, resolver) {
+	const statusName = resolver.response.status(node, res.statusCode);
+	const variants = (res.content ?? []).filter((entry) => entry.schema);
+	if (variants.length <= 1) return ast.factory.createSchema({
+		type: "ref",
+		name: statusName
+	});
+	return ast.factory.createSchema({
+		type: "union",
+		members: resolveContentTypeVariants(variants, statusName).map((variant) => ast.factory.createSchema({
+			type: "object",
+			primitive: "object",
+			properties: [ast.factory.createProperty({
+				name: "contentType",
+				required: true,
+				schema: ast.factory.createSchema({
+					type: "enum",
+					enumValues: [variant.contentType]
+				})
+			}), ast.factory.createProperty({
+				name: "data",
+				required: true,
+				schema: ast.factory.createSchema({
+					type: "ref",
+					name: variant.name
+				})
+			})]
+		}))
+	});
+}
+/**
+* Builds the per-status `<Name>Responses` record for an operation, referencing the already-resolved
+* `<Name>StatusNNN` names. Shared by `@kubb/plugin-ts`'s `Responses` type and `@kubb/plugin-zod`'s
+* inferred responses schema, so both emit the same shape from the same inputs.
+*
+* Always emits the keyed record, even when an operation declares no responses. An operation with no
+* responses renders as an empty object, which keeps every consumer's import (for example the axios
+* SDK's `RequestResult<XResponses>`) resolvable instead of pointing at a missing export.
+*/
+function buildResponses(node, resolver) {
+	return ast.factory.createSchema({
+		type: "object",
+		primitive: "object",
+		properties: node.responses.map((res) => ast.factory.createProperty({
+			name: String(res.statusCode),
+			required: true,
+			schema: buildResponseRecordEntry(node, res, resolver)
+		}))
+	});
+}
 function getStatusCodeNumber(statusCode) {
 	const code = Number(statusCode);
 	return Number.isNaN(code) ? null : code;
@@ -1869,6 +1925,10 @@ const zodGenerator = defineGenerator({
 			name: resolver.name(`${node.operationId} Options`),
 			direction: "input"
 		}) : null;
+		const responsesSchema = inferred ? renderSchemaEntry({
+			schema: buildResponses(node, resolver),
+			name: resolver.response.responses(node)
+		}) : null;
 		return /* @__PURE__ */ jsxs(File, {
 			baseName: meta.file.baseName,
 			path: meta.file.path,
@@ -1901,7 +1961,8 @@ const zodGenerator = defineGenerator({
 				errorUnionSchema,
 				requestSchema,
 				paramGroupSchemas,
-				optionsSchema
+				optionsSchema,
+				responsesSchema
 			]
 		});
 	}