@kubb/plugin-zod 5.1.0-canary.20260824T161545 → 5.1.1

package/dist/index.cjs

@@ -155,6 +155,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 kubb_kit.ast.factory.createSchema({
+		type: "ref",
+		name: statusName
+	});
+	return kubb_kit.ast.factory.createSchema({
+		type: "union",
+		members: resolveContentTypeVariants(variants, statusName).map((variant) => kubb_kit.ast.factory.createSchema({
+			type: "object",
+			primitive: "object",
+			properties: [kubb_kit.ast.factory.createProperty({
+				name: "contentType",
+				required: true,
+				schema: kubb_kit.ast.factory.createSchema({
+					type: "enum",
+					enumValues: [variant.contentType]
+				})
+			}), kubb_kit.ast.factory.createProperty({
+				name: "data",
+				required: true,
+				schema: kubb_kit.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 kubb_kit.ast.factory.createSchema({
+		type: "object",
+		primitive: "object",
+		properties: node.responses.map((res) => kubb_kit.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;
@@ -733,68 +789,6 @@ function shouldCoerce(coercion, type) {
 	return !!coercion[type];
 }
 /**
-* Registered codecs, checked in order.
-*/
-const codecs = [{
-	matches(node) {
-		return node.type === "date" && node.representation === "date";
-	},
-	decode(node) {
-		return node.format === "date" ? "z.iso.date().transform((value) => new Date(value))" : "z.iso.datetime().transform((value) => new Date(value))";
-	},
-	encode(node) {
-		return node.format === "date" ? "z.date().transform((value) => value.toISOString().slice(0, 10))" : "z.date().transform((value) => value.toISOString())";
-	}
-}];
-/**
-* Returns the codec for this node, or `undefined` when the node needs no
-* encode/decode (its wire and runtime types match).
-*/
-function getCodec(node) {
-	if (!node) return void 0;
-	return codecs.find((codec) => codec.matches(node));
-}
-/**
-* Returns `true` when the node itself is encoded/decoded by a codec.
-*/
-function hasCodec(node) {
-	return getCodec(node) !== void 0;
-}
-/**
-* Returns `true` when the schema transitively contains a codec node —
-* a value whose runtime type differs from its wire type (see {@link hasCodec}),
-* so it must be decoded (response) or encoded (request) at the validation boundary.
-* `$ref`s are followed via their resolved schema; a `seen` set guards cycles.
-*/
-function containsCodec(node, seen = /* @__PURE__ */ new Set()) {
-	if (!node) return false;
-	if (hasCodec(node)) return true;
-	if (node.type === "ref") {
-		if (!node.ref) return false;
-		const refName = (0, kubb_kit.extractRefName)(node.ref);
-		if (refName) {
-			if (seen.has(refName)) return false;
-			seen.add(refName);
-		}
-		const resolved = (0, kubb_kit.syncSchemaRef)(node);
-		if (resolved.type === "ref") return false;
-		return containsCodec(resolved, seen);
-	}
-	const children = [];
-	if ("properties" in node && node.properties) children.push(...node.properties.map((prop) => prop.schema));
-	if ("items" in node && node.items) children.push(...node.items);
-	if ("members" in node && node.members) children.push(...node.members);
-	if ("additionalProperties" in node && node.additionalProperties && node.additionalProperties !== true) children.push(node.additionalProperties);
-	return children.some((child) => containsCodec(child, seen));
-}
-/**
-* Collects the names of `$ref` schemas that transitively contain a codec, so the generator can route
-* them to their input (encode) variant.
-*/
-function collectCodecRefNames(node) {
-	return kubb_kit.ast.collectSync(node, { schema: (n) => n.type === "ref" && n.ref && containsCodec(n) ? kubb_kit.ast.resolveRefName(n) ?? void 0 : void 0 });
-}
-/**
 * Whether the node is a plain inline object whose shape can be lifted into an `.extend({ … })`
 * argument. A catchall, `patternProperties`, or a nullable/optional wrapper cannot, so those stay
 * on `.and(…)`.
@@ -1107,6 +1101,168 @@ function buildZodObjectShape(ctx, node) {
 	}));
 }
 /**
+* Types the direction probe skips. They delegate to their children rather than reading
+* `direction` themselves, so {@link containsDirectionalNode} walks into the children instead.
+*/
+const CONTAINER_TYPES = /* @__PURE__ */ new Set([
+	"object",
+	"array",
+	"tuple",
+	"union",
+	"intersection",
+	"ref"
+]);
+/**
+* Runs the node's effective handler (a `printer.nodes` override, else the built-in) once per
+* direction and reports whether the two disagree. That difference is what makes a component
+* need an `${name}InputSchema` variant.
+*/
+function variesByDirection({ node, printerOptions }) {
+	if (CONTAINER_TYPES.has(node.type)) return false;
+	const handler = printerOptions.nodes?.[node.type] ?? scalarNodes[node.type];
+	if (!handler) return false;
+	const call = (direction) => {
+		const context = {
+			options: {
+				...printerOptions,
+				direction
+			},
+			transform: () => null,
+			base: () => null
+		};
+		return handler.call(context, node);
+	};
+	return call("decode") !== call("encode");
+}
+/**
+* Whether the schema transitively contains a node that prints differently per direction, so it
+* must decode on responses and encode on requests. Follows `$ref`s through their resolved
+* schema, with `seen` guarding cycles.
+*/
+function containsDirectionalNode({ node, printerOptions, seen = /* @__PURE__ */ new Set() }) {
+	if (!node) return false;
+	if (node.type === "ref") {
+		if (!node.ref) return false;
+		const refName = (0, kubb_kit.extractRefName)(node.ref);
+		if (refName) {
+			if (seen.has(refName)) return false;
+			seen.add(refName);
+		}
+		const resolved = (0, kubb_kit.syncSchemaRef)(node);
+		if (resolved.type === "ref") return false;
+		return containsDirectionalNode({
+			node: resolved,
+			printerOptions,
+			seen
+		});
+	}
+	if (variesByDirection({
+		node,
+		printerOptions
+	})) return true;
+	const children = [];
+	if ("properties" in node && node.properties) children.push(...node.properties.map((prop) => prop.schema));
+	if ("items" in node && node.items) children.push(...node.items);
+	if ("members" in node && node.members) children.push(...node.members);
+	if ("additionalProperties" in node && node.additionalProperties && node.additionalProperties !== true) children.push(node.additionalProperties);
+	return children.some((child) => containsDirectionalNode({
+		node: child,
+		printerOptions,
+		seen
+	}));
+}
+/**
+* Names of the `$ref` schemas the generator should route to their input (encode) variant.
+*/
+function collectDirectionalRefNames({ node, printerOptions }) {
+	return kubb_kit.ast.collectSync(node, { schema: (n) => n.type === "ref" && n.ref && containsDirectionalNode({
+		node: n,
+		printerOptions
+	}) ? kubb_kit.ast.resolveRefName(n) ?? void 0 : void 0 });
+}
+/**
+* Handlers that never recurse into children, so {@link variesByDirection} can call one directly
+* to probe both directions without building a printer.
+*
+* `date` is the built-in two-way conversion, decoding `string → Date` on responses and encoding
+* back on requests, keeping `date` and `date-time` precision apart. Only `representation: 'date'`
+* fields convert; ISO-string fields print `z.iso.date()` either way. A `printer.nodes.date`
+* override replaces the whole handler, direction branch included.
+*/
+const scalarNodes = {
+	any: () => "z.any()",
+	unknown: () => "z.unknown()",
+	void: () => "z.void()",
+	never: () => "z.never()",
+	boolean: () => "z.boolean()",
+	null: () => "z.null()",
+	string(node) {
+		const base = shouldCoerce(this.options.coercion, "strings") ? "z.coerce.string()" : "z.string()";
+		const pattern = node.pattern ?? integerFormatPattern(node.format);
+		return `${base}${lengthConstraints({
+			...node,
+			pattern,
+			regexType: this.options.regexType
+		})}`;
+	},
+	number(node) {
+		return `${shouldCoerce(this.options.coercion, "numbers") ? "z.coerce.number()" : "z.number()"}${numberConstraints(node)}`;
+	},
+	integer(node) {
+		return `${shouldCoerce(this.options.coercion, "numbers") ? "z.coerce.number().int()" : "z.int()"}${numberConstraints(node)}`;
+	},
+	bigint() {
+		return "z.coerce.bigint()";
+	},
+	date(node) {
+		if (node.representation !== "date") return "z.iso.date()";
+		if (this.options.direction === "encode") return node.format === "date" ? "z.date().transform((value) => value.toISOString().slice(0, 10))" : "z.date().transform((value) => value.toISOString())";
+		const decoded = node.format === "date" ? "z.iso.date().transform((value) => new Date(value))" : "z.iso.datetime().transform((value) => new Date(value))";
+		return shouldCoerce(this.options.coercion, "dates") ? "z.coerce.date()" : decoded;
+	},
+	datetime(node) {
+		const offset = node.offset || this.options.dateType === "stringOffset";
+		const local = node.local || this.options.dateType === "stringLocal";
+		if (offset) return "z.iso.datetime({ offset: true })";
+		if (local) return "z.iso.datetime({ local: true })";
+		return "z.iso.datetime()";
+	},
+	time(node) {
+		if (node.representation === "string") return "z.iso.time()";
+		return shouldCoerce(this.options.coercion, "dates") ? "z.coerce.date()" : "z.date()";
+	},
+	uuid(node) {
+		return `${this.options.guidType === "guid" ? "z.guid()" : "z.uuid()"}${lengthConstraints({
+			...node,
+			regexType: this.options.regexType
+		})}`;
+	},
+	email(node) {
+		return `z.email()${lengthConstraints({
+			...node,
+			regexType: this.options.regexType
+		})}`;
+	},
+	url(node) {
+		return `z.url()${lengthConstraints({
+			...node,
+			regexType: this.options.regexType
+		})}`;
+	},
+	ipv4: () => "z.ipv4()",
+	ipv6: () => "z.ipv6()",
+	blob: () => "z.instanceof(File)",
+	enum(node) {
+		const nonNullValues = (node.namedEnumValues?.map((v) => v.value) ?? node.enumValues ?? []).filter((v) => v !== null);
+		if (node.namedEnumValues?.length) {
+			const literals = nonNullValues.map((v) => `z.literal(${formatLiteral(v)})`);
+			if (literals.length === 1) return literals[0];
+			return `z.union([${literals.join(", ")}])`;
+		}
+		return buildEnum(nonNullValues);
+	}
+};
+/**
 * Zod v4 printer built with `definePrinter`.
 *
 * Converts a `SchemaNode` AST into a Zod v4 code string using the chainable API
@@ -1124,84 +1280,15 @@ const printerZod = kubb_kit.ast.createPrinter((options) => {
 		name: "zod",
 		options,
 		nodes: {
-			any: () => "z.any()",
-			unknown: () => "z.unknown()",
-			void: () => "z.void()",
-			never: () => "z.never()",
-			boolean: () => "z.boolean()",
-			null: () => "z.null()",
-			string(node) {
-				const base = shouldCoerce(this.options.coercion, "strings") ? "z.coerce.string()" : "z.string()";
-				const pattern = node.pattern ?? integerFormatPattern(node.format);
-				return `${base}${lengthConstraints({
-					...node,
-					pattern,
-					regexType: this.options.regexType
-				})}`;
-			},
-			number(node) {
-				return `${shouldCoerce(this.options.coercion, "numbers") ? "z.coerce.number()" : "z.number()"}${numberConstraints(node)}`;
-			},
-			integer(node) {
-				return `${shouldCoerce(this.options.coercion, "numbers") ? "z.coerce.number().int()" : "z.int()"}${numberConstraints(node)}`;
-			},
-			bigint() {
-				return shouldCoerce(this.options.coercion, "numbers") ? "z.coerce.bigint()" : "z.bigint()";
-			},
-			date(node) {
-				const codec = getCodec(node);
-				if (codec) {
-					if (this.options.direction === "input") return codec.encode(node);
-					return shouldCoerce(this.options.coercion, "dates") ? "z.coerce.date()" : codec.decode(node);
-				}
-				return "z.iso.date()";
-			},
-			datetime(node) {
-				const offset = node.offset || this.options.dateType === "stringOffset";
-				const local = node.local || this.options.dateType === "stringLocal";
-				if (offset) return "z.iso.datetime({ offset: true })";
-				if (local) return "z.iso.datetime({ local: true })";
-				return "z.iso.datetime()";
-			},
-			time(node) {
-				if (node.representation === "string") return "z.iso.time()";
-				return shouldCoerce(this.options.coercion, "dates") ? "z.coerce.date()" : "z.date()";
-			},
-			uuid(node) {
-				return `${this.options.guidType === "guid" ? "z.guid()" : "z.uuid()"}${lengthConstraints({
-					...node,
-					regexType: this.options.regexType
-				})}`;
-			},
-			email(node) {
-				return `z.email()${lengthConstraints({
-					...node,
-					regexType: this.options.regexType
-				})}`;
-			},
-			url(node) {
-				return `z.url()${lengthConstraints({
-					...node,
-					regexType: this.options.regexType
-				})}`;
-			},
-			ipv4: () => "z.ipv4()",
-			ipv6: () => "z.ipv6()",
-			blob: () => "z.instanceof(File)",
-			enum(node) {
-				const nonNullValues = (node.namedEnumValues?.map((v) => v.value) ?? node.enumValues ?? []).filter((v) => v !== null);
-				if (node.namedEnumValues?.length) {
-					const literals = nonNullValues.map((v) => `z.literal(${formatLiteral(v)})`);
-					if (literals.length === 1) return literals[0];
-					return `z.union([${literals.join(", ")}])`;
-				}
-				return buildEnum(nonNullValues);
-			},
+			...scalarNodes,
 			ref(node) {
 				if (!node.name) return null;
 				const refName = kubb_kit.ast.resolveRefName(node);
 				if (!refName) return null;
-				const useInputVariant = node.ref != null && this.options.direction === "input" && containsCodec(node);
+				const useInputVariant = node.ref != null && this.options.direction === "encode" && containsDirectionalNode({
+					node,
+					printerOptions: this.options
+				});
 				const resolvedName = node.ref ? useInputVariant ? this.options.resolver?.schema.inputName(refName) ?? refName : this.options.resolver?.name(refName) ?? refName : node.name;
 				if (node.ref && this.options.cyclicSchemas?.has(refName)) return `z.lazy(() => ${resolvedName})`;
 				return resolvedName;
@@ -1385,7 +1472,7 @@ const printerZodMini = kubb_kit.ast.createPrinter((options) => {
 				return `z.int()${numberChecksMini(node)}`;
 			},
 			bigint(node) {
-				return `z.bigint()${numberChecksMini(node)}`;
+				return `z.coerce.bigint()${numberChecksMini(node)}`;
 			},
 			date(node) {
 				if (node.representation === "string") return "z.iso.date()";
@@ -1528,29 +1615,28 @@ const printerZodMini = kubb_kit.ast.createPrinter((options) => {
 const zodPrinterCache = /* @__PURE__ */ new WeakMap();
 const zodMiniPrinterCache = /* @__PURE__ */ new WeakMap();
 /**
-* Returns the cached `output`/`input` direction printers for a resolver, building them on
-* first use. The `input` printer encodes `Date → string` for request bodies, and `output` decodes
-* `string → Date` for responses. Schemas without `dateType: 'date'` fields print identically.
+* Cached printer per direction for a resolver, built on first use. Schemas holding nothing that
+* converts print the same either way.
 */
 function getStdPrinters(resolver, params) {
 	const cached = zodPrinterCache.get(resolver);
 	if (cached && cached.coercion === params.coercion && cached.guidType === params.guidType && cached.regexType === params.regexType && cached.dateType === params.dateType && cached.nodes === params.nodes) return {
-		output: cached.output,
-		input: cached.input
+		decode: cached.decode,
+		encode: cached.encode
 	};
-	const output = printerZod({
+	const decode = printerZod({
 		...params,
 		resolver,
-		direction: "output"
+		direction: "decode"
 	});
-	const input = printerZod({
+	const encode = printerZod({
 		...params,
 		resolver,
-		direction: "input"
+		direction: "encode"
 	});
 	zodPrinterCache.set(resolver, {
-		output,
-		input,
+		decode,
+		encode,
 		coercion: params.coercion,
 		guidType: params.guidType,
 		regexType: params.regexType,
@@ -1558,8 +1644,8 @@ function getStdPrinters(resolver, params) {
 		nodes: params.nodes
 	});
 	return {
-		output,
-		input
+		decode,
+		encode
 	};
 }
 function getMiniPrinter(resolver, params) {
@@ -1593,15 +1679,30 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 		if (!node.name) return;
 		const isZodImport = ZOD_NAMESPACE_IMPORTS.has(importPath);
 		const cyclicSchemas = new Set(ctx.meta.circularNames);
-		const hasCodec = !mini && containsCodec(node);
-		const codecRefNames = new Set(hasCodec ? collectCodecRefNames(node) : []);
+		const printerOptions = {
+			coercion,
+			guidType,
+			regexType,
+			dateType,
+			resolver,
+			cyclicSchemas,
+			nodes: printer?.nodes
+		};
+		const hasDirectionalNode = !mini && containsDirectionalNode({
+			node,
+			printerOptions
+		});
+		const directionalRefNames = new Set(hasDirectionalNode ? collectDirectionalRefNames({
+			node,
+			printerOptions
+		}) : []);
 		const importEntries = resolver.imports({
 			node,
 			root,
 			output,
 			group: group ?? void 0
 		});
-		const inputImportEntries = hasCodec ? [...codecRefNames].map((schemaName) => ({
+		const inputImportEntries = hasDirectionalNode ? [...directionalRefNames].map((schemaName) => ({
 			name: [resolver.schema.inputName(schemaName)],
 			path: resolver.file({
 				name: schemaName,
@@ -1642,7 +1743,7 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 			regexType,
 			cyclicSchemas,
 			nodes: printer?.nodes
-		}) : stdPrinters.output;
+		}) : stdPrinters.decode;
 		return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx.File, {
 			baseName: meta.file.baseName,
 			path: meta.file.path,
@@ -1685,10 +1786,10 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 					inferTypeName,
 					cyclic: cyclicSchemas.has(node.name)
 				}),
-				hasCodec && stdPrinters && /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(Zod, {
+				hasDirectionalNode && stdPrinters && /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(Zod, {
 					name: resolver.schema.inputName(node.name),
 					node,
-					printer: stdPrinters.input,
+					printer: stdPrinters.encode,
 					inferTypeName: inferred ? resolver.schema.inputTypeName(node.name) : null,
 					cyclic: cyclicSchemas.has(node.name)
 				})
@@ -1711,16 +1812,28 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 			group: group ?? void 0
 		}) };
 		const cyclicSchemas = new Set(ctx.meta.circularNames);
-		function renderSchemaEntry({ schema, name, keysToOmit, direction = "output" }) {
+		const printerOptions = {
+			coercion,
+			guidType,
+			regexType,
+			dateType,
+			resolver,
+			cyclicSchemas,
+			nodes: printer?.nodes
+		};
+		function renderSchemaEntry({ schema, name, keysToOmit, direction = "decode" }) {
 			if (!schema) return null;
 			const inferTypeName = inferred ? resolver.schema.type(name) : null;
-			const codecRefNames = direction === "input" && !mini ? new Set(collectCodecRefNames(schema)) : null;
+			const directionalRefNames = direction === "encode" && !mini ? new Set(collectDirectionalRefNames({
+				node: schema,
+				printerOptions
+			})) : null;
 			const imports = resolver.imports({
 				node: schema,
 				root,
 				output,
 				group: group ?? void 0,
-				name: (schemaName) => codecRefNames?.has(schemaName) ? resolver.schema.inputName(schemaName) : resolver.name(schemaName)
+				name: (schemaName) => directionalRefNames?.has(schemaName) ? resolver.schema.inputName(schemaName) : resolver.name(schemaName)
 			});
 			const schemaPrinter = mini ? keysToOmit?.length ? printerZodMini({
 				guidType,
@@ -1809,7 +1922,7 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 		const paramSchemas = node.parameters.map((param) => renderSchemaEntry({
 			schema: param.schema,
 			name: resolver.param.name(node, param),
-			direction: "input"
+			direction: "encode"
 		}));
 		const responseSchemas = node.responses.map((res) => {
 			const variants = (res.content ?? []).filter((entry) => entry.schema);
@@ -1847,13 +1960,13 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 					},
 					name: resolver.response.body(node),
 					keysToOmit: entry.keysToOmit,
-					direction: "input"
+					direction: "encode"
 				});
 			}
 			return buildContentTypeVariants(requestBodyContent, resolver.response.body(node), (schema) => ({
 				...schema,
 				description: node.requestBody.description ?? schema.description
-			}), "input");
+			}), "encode");
 		})();
 		const { path, query, header } = getOperationParameters(node);
 		const paramGroupSchemas = inferred ? [
@@ -1872,12 +1985,16 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 		].filter(({ params }) => params.length > 0).map(({ kind, params }) => renderSchemaEntry({
 			schema: buildGroupedParamsSchema({ params }),
 			name: resolver.param[kind](node, params[0]),
-			direction: "input"
+			direction: "encode"
 		})) : [];
 		const optionsSchema = inferred ? renderSchemaEntry({
 			schema: buildOptionsSchema(node, resolver),
 			name: resolver.name(`${node.operationId} Options`),
-			direction: "input"
+			direction: "encode"
+		}) : null;
+		const responsesSchema = inferred ? renderSchemaEntry({
+			schema: buildResponses(node, resolver),
+			name: resolver.response.responses(node)
 		}) : null;
 		return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx.File, {
 			baseName: meta.file.baseName,
@@ -1911,7 +2028,8 @@ const zodGenerator = (0, kubb_kit.defineGenerator)({
 				errorUnionSchema,
 				requestSchema,
 				paramGroupSchemas,
-				optionsSchema
+				optionsSchema,
+				responsesSchema
 			]
 		});
 	}