@kubb/plugin-client 5.7.0-canary.20261024T172532 → 5.7.0

package/dist/index.cjs

@@ -454,7 +454,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.7.0-canary.20261024T172532";
+var version = "5.7.0";
 //#endregion
 //#region ../../internals/client/src/builders/validatorOptions.ts
 /**
@@ -463,7 +463,7 @@ var version = "5.7.0-canary.20261024T172532";
 function isValidatorEnabled(validator) {
 	if (!validator) return false;
 	if (validator === "zod") return true;
-	return Boolean(validator.request || validator.response);
+	return Boolean(validator.request || validator.params || validator.response);
 }
 /**
 * Returns `'zod'` when request body parsing is enabled, `null` otherwise. The string shorthand
@@ -474,6 +474,14 @@ function resolveRequestValidator(validator) {
 	return validator.request ?? null;
 }
 /**
+* Returns `'zod'` when path, query, and header params parsing is enabled, `null` otherwise. Only the
+* object form `{ params: 'zod' }` enables it.
+*/
+function resolveParamsValidator(validator) {
+	if (!validator || validator === "zod") return null;
+	return validator.params ?? null;
+}
+/**
 * Returns `'zod'` when response parsing is enabled, `null` otherwise. The string shorthand `'zod'`
 * maps to response parsing.
 */
@@ -492,36 +500,13 @@ function buildZodErrorParse(node, zodResolver) {
 	return zodResolver.response.error?.(node) || null;
 }
 //#endregion
-//#region ../../internals/client/src/builders/validator.ts
-/**
-* Builds the validator-hook references for one operation. Request validation runs before the send;
-* response validation runs on the success body only. Returns `null` references when the matching
-* direction is disabled or the schema is absent.
-*/
-function buildValidatorHooks({ node, validator, zodResolver }) {
-	const hasRequestBody = Boolean(node.requestBody?.content?.[0]?.schema);
-	const parsesResponse = zodResolver && resolveResponseValidator(validator) === "zod";
-	const response = parsesResponse ? zodResolver.response.response(node) || null : null;
-	const error = parsesResponse ? buildZodErrorParse(node, zodResolver) : null;
-	const request = zodResolver && resolveRequestValidator(validator) === "zod" && hasRequestBody ? zodResolver.response.body(node) || null : null;
-	return {
-		request,
-		response,
-		error,
-		importedZodNames: [
-			response,
-			error,
-			request
-		].filter((name) => Boolean(name))
-	};
-}
-//#endregion
 //#region ../../internals/client/src/builders/security.ts
 function serializeAuth(auth) {
 	const parts = [`type: '${auth.type}'`];
 	if (auth.scheme) parts.push(`scheme: '${auth.scheme}'`);
 	if (auth.name) parts.push(`name: '${auth.name}'`);
 	if (auth.in) parts.push(`in: '${auth.in}'`);
+	if (auth.scopes?.length) parts.push(`scopes: [${auth.scopes.map((scope) => `'${scope}'`).join(", ")}]`);
 	return `{ ${parts.join(", ")} }`;
 }
 /**
@@ -564,11 +549,14 @@ function getOperationSecurity({ document, method, path }) {
 	const definitions = document.components?.securitySchemes ?? {};
 	const security = [];
 	const seen = /* @__PURE__ */ new Set();
-	for (const requirement of requirements) for (const schemeName of Object.keys(requirement)) {
+	for (const requirement of requirements) for (const [schemeName, scopes] of Object.entries(requirement)) {
 		if (seen.has(schemeName)) continue;
 		seen.add(schemeName);
 		const auth = resolveSecurityScheme(definitions[schemeName]);
-		if (auth) security.push(auth);
+		if (auth) security.push(scopes.length ? {
+			...auth,
+			scopes
+		} : auth);
 	}
 	return security.length ? security : void 0;
 }
@@ -584,6 +572,49 @@ function buildSecurityMetadata({ security }) {
 	return `[${security.map(serializeAuth).join(", ")}]`;
 }
 //#endregion
+//#region ../../internals/client/src/builders/validator.ts
+/**
+* Builds the validator-hook references for one operation. Request body and params validation run before the send.
+* Response validation runs on the success body only. Returns `null` references when the matching
+* direction is disabled or the schema is absent.
+*/
+function buildValidatorHooks({ node, validator, zodResolver }) {
+	const hasRequestBody = Boolean(node.requestBody?.content?.[0]?.schema);
+	const parsesResponse = zodResolver && resolveResponseValidator(validator) === "zod";
+	const response = parsesResponse ? zodResolver.response.response(node) || null : null;
+	const error = parsesResponse ? buildZodErrorParse(node, zodResolver) : null;
+	const request = zodResolver && resolveRequestValidator(validator) === "zod" && hasRequestBody ? zodResolver.response.body(node) || null : null;
+	const paramGroups = getOperationParameters(node);
+	const resolveParamsName = (kind, params) => zodResolver && resolveParamsValidator(validator) === "zod" && params.length > 0 ? zodResolver.param[kind](node, params[0]) : null;
+	const path = resolveParamsName("path", paramGroups.path);
+	const query = resolveParamsName("query", paramGroups.query);
+	const headers = resolveParamsName("headers", paramGroups.header);
+	const importedZodNames = [
+		response,
+		error,
+		request,
+		path,
+		query,
+		headers
+	].filter((name) => Boolean(name));
+	return {
+		request,
+		path,
+		query,
+		headers: headers ? `toHeadersStandardSchema(${headers}, ${headers}.shape)` : null,
+		response,
+		error,
+		importedZodNames
+	};
+}
+/**
+* Prints the `validator: { … }` entry of a call config from the hooks named in `keys`, or `null` when none is set.
+*/
+function buildValidatorLiteral(hooks, keys) {
+	const entries = keys.flatMap((key) => hooks?.[key] ? [`${key}: ${hooks[key]}`] : []);
+	return entries.length ? `validator: { ${entries.join(", ")} }` : null;
+}
+//#endregion
 //#region ../../internals/client/src/builders/contentType.ts
 /**
 * Builds the `contentType` entry baked into the call config, or `null` for the JSON default.
@@ -788,12 +819,14 @@ function Operation({ name, node, types, zodResolver, validator, returnType, thro
 	const eventStream = isEventStream(node);
 	const responseType = getResponseType(node);
 	const responseTypeLiteral = responseType ? `responseType: '${responseType}'` : null;
-	const validatorEntries = [
-		validators.request ? `request: ${validators.request}` : null,
-		validators.response ? `response: ${validators.response}` : null,
-		validators.error ? `error: ${validators.error}` : null
-	].filter(Boolean);
-	const validatorLiteral = validatorEntries.length ? `validator: { ${validatorEntries.join(", ")} }` : null;
+	const validatorLiteral = buildValidatorLiteral(validators, [
+		"request",
+		"path",
+		"query",
+		"headers",
+		"response",
+		"error"
+	]);
 	const callConfig = `{ ${[
 		`method: '${node.method.toUpperCase()}'`,
 		`url: '${node.path}'`,
@@ -905,14 +938,15 @@ function createClientGenerator(name, resolveClientPath) {
 			const { config, driver, resolver, root } = ctx;
 			const { output, validator, returnType, throwOnErrorDefault, group } = ctx.options;
 			const types = resolveOperationTypes(driver, ctx.plugin.name);
-			const pluginZod = resolveResponseValidator(validator) === "zod" || resolveRequestValidator(validator) === "zod" ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
+			const pluginZod = isValidatorEnabled(validator) ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
 			const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : null;
 			const importedTypeNames = [types.response.options(node), types.response.responses(node)];
-			const importedZodNames = buildValidatorHooks({
+			const validatorHooks = buildValidatorHooks({
 				node,
 				validator,
 				zodResolver
-			}).importedZodNames;
+			});
+			const importedZodNames = validatorHooks.importedZodNames;
 			const meta = {
 				name: resolver.name(node.operationId),
 				file: resolver.file({
@@ -944,6 +978,7 @@ function createClientGenerator(name, resolveClientPath) {
 			const customClientPath = resolveClientPath?.(ctx.options, root);
 			const clientPath = customClientPath ?? node_path.default.resolve(root, ".kubb/client.ts");
 			const clientRoot = customClientPath === void 0 ? meta.file.path : void 0;
+			const standardSchemaPath = customClientPath ?? node_path.default.resolve(root, ".kubb/standardSchema.ts");
 			const eventStream = isEventStream(node);
 			const clientValueImports = (() => {
 				if (eventStream) return ["client", "toEventStream"];
@@ -1008,6 +1043,11 @@ function createClientGenerator(name, resolveClientPath) {
 						root: meta.file.path,
 						path: meta.fileZod.path
 					}),
+					validatorHooks.headers && /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Import, {
+						name: ["toHeadersStandardSchema"],
+						root: clientRoot,
+						path: standardSchemaPath
+					}),
 					/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(Operation, {
 						name: meta.name,
 						node,