@kubb/plugin-axios 5.10.0-canary.20261025T201031 → 5.10.0

package/dist/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -23,7 +23,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let kubb_kit = require("kubb/kit");
 let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
@@ -32,7 +31,7 @@ let kubb_jsx = require("kubb/jsx");
 let _kubb_plugin_ts = require("@kubb/plugin-ts");
 let kubb_jsx_jsx_runtime = require("kubb/jsx/jsx-runtime");
 let node_url = require("node:url");
-//#region ../../internals/shared/src/operation.ts
+// ../../internals/shared/src/operation.ts
 /**
 * Builds the `ResolverFileParams` every operation generator passes to
 * `resolver.file`: a file named `name`, tagged by the operation's first
@@ -210,6 +209,16 @@ function getOperationParameters(node) {
 	operationParameterGroupsByNode.set(node, groups);
 	return groups;
 }
+/**
+* Builds the combined `{ body, path, query, headers }` options object schema for an operation,
+* referencing the already-resolved body and grouped param names. Shared by `@kubb/plugin-ts`'s
+* `Options` type and `@kubb/plugin-zod`'s inferred options schema, so both printers emit the same
+* shape from the same inputs. `primitive: 'object'` is a no-op for the TS printer and tells the Zod
+* printer to emit `z.object(…)` rather than a record.
+*/
+function hasRequestContentTypeChoice(node) {
+	return (node.requestBody?.content ?? []).filter((entry) => entry.schema).length > 1;
+}
 function getStatusCodeNumber(statusCode) {
 	const code = Number(statusCode);
 	return Number.isNaN(code) ? null : code;
@@ -227,8 +236,7 @@ function getOperationSuccessResponses(node) {
 function getPrimarySuccessResponse(node) {
 	return getOperationSuccessResponses(node)[0] ?? null;
 }
-//#endregion
-//#region ../../internals/utils/src/casing.ts
+// ../../internals/utils/src/casing.ts
 /**
 * Shared implementation for camelCase and PascalCase conversion.
 * Splits on common word boundaries (spaces, hyphens, underscores, dots, slashes, colons)
@@ -277,8 +285,7 @@ function camelCase(text, { prefix = "", suffix = "" } = {}) {
 function pascalCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true);
 }
-//#endregion
-//#region ../../internals/utils/src/reserved.ts
+// ../../internals/utils/src/reserved.ts
 /**
 * JavaScript and Java reserved words.
 * @link https://github.com/jonschlinkert/reserved/blob/master/index.js
@@ -286,6 +293,7 @@ function pascalCase(text, { prefix = "", suffix = "" } = {}) {
 const reservedWords = /* @__PURE__ */ new Set([
 	"abstract",
 	"arguments",
+	"await",
 	"boolean",
 	"break",
 	"byte",
@@ -416,8 +424,7 @@ function ensureValidVarName(name) {
 function isIdentifier(name) {
 	return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
 }
-//#endregion
-//#region ../../internals/utils/src/codegen.ts
+// ../../internals/utils/src/codegen.ts
 /**
 * Builds a JSDoc comment block from an array of lines. Returns `fallback` when there are no
 * comments.
@@ -433,8 +440,29 @@ function buildJSDoc(comments, options = {}) {
 	if (comments.length === 0) return fallback;
 	return `/**\n${comments.map((c) => `${indent}${c}`).join("\n")}\n   */${suffix}`;
 }
-//#endregion
-//#region ../../internals/shared/src/group.ts
+// ../../internals/shared/src/resolver.ts
+function resolveOperationName(name) {
+	return ensureValidVarName(camelCase(name));
+}
+/**
+* Builds the allocation key for a declaration an operation owns. `scope` names which declaration
+* it is, so two of them never share an allocation even when a custom resolver gives both the same
+* name. Leave `scope` empty for the operation's own declaration.
+*
+* @example
+* ```ts
+* resolver.resolveName({ key: operationKey(node, 'response', 'status', 404), name })
+* ```
+*/
+function operationKey(node, ...scope) {
+	return [
+		"operation",
+		node.method,
+		node.path,
+		...scope.map(String)
+	];
+}
+// ../../internals/shared/src/group.ts
 /**
 * Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the
 * shared default naming so every plugin groups output consistently:
@@ -464,8 +492,7 @@ function createGroupConfig(group) {
 		name: group.name ? group.name : defaultName
 	};
 }
-//#endregion
-//#region ../../internals/client/src/builders/validatorOptions.ts
+// ../../internals/client/src/builders/validatorOptions.ts
 /**
 * Returns `true` when any direction of the validator uses zod (used for dependency checks).
 */
@@ -508,8 +535,7 @@ function buildZodErrorParse(node, zodResolver) {
 	if (!node.responses.some((res) => !isSuccessStatusCode(res.statusCode) && res.content?.some((entry) => entry.schema))) return null;
 	return zodResolver.response.error?.(node) || null;
 }
-//#endregion
-//#region ../../internals/client/src/builders/security.ts
+// ../../internals/client/src/builders/security.ts
 function serializeAuth(auth) {
 	const parts = [`type: '${auth.type}'`];
 	if (auth.scheme) parts.push(`scheme: '${auth.scheme}'`);
@@ -580,8 +606,7 @@ function buildSecurityMetadata({ security }) {
 	if (!security?.length) return null;
 	return `[${security.map(serializeAuth).join(", ")}]`;
 }
-//#endregion
-//#region ../../internals/client/src/builders/validator.ts
+// ../../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
@@ -623,17 +648,16 @@ 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
+// ../../internals/client/src/builders/contentType.ts
 /**
-* Builds the `contentType` entry baked into the call config, or `null` for the JSON default.
+* Builds the `contentType` entry baked into the call config, or `null` without a request body.
 *
 * `merge` is `true` when the generated function must destructure `contentType` from `options` and
 * merge it over the baked request default, because the caller can also pick a response content type.
 */
 function buildContentType({ node }) {
 	const { defaultContentType } = getContentTypeInfo(node);
-	const requestContentType = Boolean(node.requestBody?.content?.[0]?.schema) && defaultContentType !== "application/json" ? defaultContentType : null;
+	const requestContentType = Boolean(node.requestBody?.content?.[0]?.schema) ? defaultContentType : null;
 	if (!requestContentType) return {
 		literal: null,
 		merge: false
@@ -644,8 +668,7 @@ function buildContentType({ node }) {
 		literal: merge ? `contentType: { request: '${requestContentType}', ...(typeof contentType === 'string' ? { request: contentType } : contentType) }` : `contentType: { request: '${requestContentType}' }`
 	};
 }
-//#endregion
-//#region ../../internals/client/src/builders/generics.ts
+// ../../internals/client/src/builders/generics.ts
 /**
 * Builds the `RequestResult` generic arguments for one operation: the per-status responses record
 * plus the per-call `ThrowOnError` flag. `SuccessOf` / `ErrorOf` split the record inside the
@@ -676,8 +699,7 @@ function buildResultType({ node, types, returnType }) {
 	if (returnType === "plain") return `Promise<RequestResult<${generics}>>`;
 	return `Unwrappable<RequestResult<${generics}>>`;
 }
-//#endregion
-//#region ../../internals/client/src/builders/returnStatement.ts
+// ../../internals/client/src/builders/returnStatement.ts
 /**
 * Builds the return statement of a generated operation function. With the default
 * `returnType: 'full'` the runtime call already resolves to `{ data, error, request, response }`.
@@ -701,22 +723,22 @@ function buildResultType({ node, types, returnType }) {
 * `return request({ method: 'POST', url: '/pet', ...config }) as Promise<RequestResult<AddPetResponses, ThrowOnError>>`
 */
 function buildReturnStatement({ node, types, callConfig, returnType, throwOnErrorDefault }) {
-	if (returnType === "data") return `return unwrapResult(request(${callConfig}), config.throwOnError ?? ${throwOnErrorDefault}) as ${buildResultType({
+	const request = returnType !== "plain" && hasRequestContentTypeChoice(node) ? `request<${types.response.options(node)}['body']>` : "request";
+	if (returnType === "data") return `return unwrapResult(${request}(${callConfig}), config.throwOnError ?? ${throwOnErrorDefault}) as ${buildResultType({
 		node,
 		types,
 		returnType
 	})}`;
-	if (returnType === "plain") return `return request(${callConfig}) as Promise<RequestResult<${buildRequestResultGenerics({
+	if (returnType === "plain") return `return ${request}(${callConfig}) as Promise<RequestResult<${buildRequestResultGenerics({
 		node,
 		types
 	})}>>`;
-	return `return withUnwrap(request(${callConfig}) as Promise<RequestResult<${buildRequestResultGenerics({
+	return `return withUnwrap(${request}(${callConfig}) as Promise<RequestResult<${buildRequestResultGenerics({
 		node,
 		types
 	})}>>)`;
 }
-//#endregion
-//#region ../../internals/client/src/builders/signature.ts
+// ../../internals/client/src/builders/signature.ts
 const declarationPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 /**
 * Builds the grouped-options signature for one operation: a single `options` object whose `TData`
@@ -744,8 +766,7 @@ function buildGroupedOptionsSignature({ node, types, returnType, throwOnErrorDef
 		generics: [`ThrowOnError extends boolean = ${throwOnErrorDefault}`]
 	};
 }
-//#endregion
-//#region ../../internals/client/src/builders/styles.ts
+// ../../internals/client/src/builders/styles.ts
 /**
 * Renders a parameter name as an object-literal key, quoted when it is not a bare identifier. Every
 * location keeps the spec name: the runtime looks path styles up by the `{name}` placeholder in the
@@ -817,8 +838,7 @@ function buildStyles({ node }) {
 	const entries = [...Object.keys(groups).filter((location) => groups[location].length > 0).map((location) => `${location}: { ${groups[location].join(", ")} }`), serializeBodyEncoding(node)].filter(Boolean);
 	return entries.length > 0 ? `{ ${entries.join(", ")} }` : null;
 }
-//#endregion
-//#region ../../internals/client/src/components/Operation.tsx
+// ../../internals/client/src/components/Operation.tsx
 /**
 * Renders one client operation: the grouped `<Name>Request` type and the function that forwards a
 * single `options` object to the resolved client and returns the `Unwrappable<RequestResult>`. The
@@ -895,8 +915,7 @@ function Operation({ name, node, types, zodResolver, validator, returnType, thro
 		})
 	});
 }
-//#endregion
-//#region ../../internals/client/src/resolveOperationTypes.ts
+// ../../internals/client/src/resolveOperationTypes.ts
 /**
 * A `plugin-ts` shaped resolver whose operation type names point at the types `pluginZod({ inferred })`
 * exports next to each schema, so code written against `plugin-ts` names picks up the zod types.
@@ -962,8 +981,7 @@ function resolveOperationTypes(driver, pluginName) {
 		group: pluginZod.options.group ?? void 0
 	};
 }
-//#endregion
-//#region ../../internals/client/src/generators/clientGenerator.tsx
+// ../../internals/client/src/generators/clientGenerator.tsx
 /**
 * Builds the built-in per-operation generator shared by the client plugins (`@kubb/plugin-fetch`,
 * `@kubb/plugin-axios`). Emits one async function per OpenAPI operation using the shared
@@ -990,8 +1008,12 @@ function createClientGenerator(name, resolveClientPath) {
 				zodResolver
 			});
 			const importedZodNames = validatorHooks.importedZodNames;
+			const operationName = resolver.name(node.operationId);
 			const meta = {
-				name: resolver.name(node.operationId),
+				name: resolver.resolveName({
+					key: operationKey(node),
+					name: operationName
+				}),
 				file: resolver.file({
 					...operationFileEntry(node, node.operationId),
 					root,
@@ -1106,8 +1128,7 @@ function createClientGenerator(name, resolveClientPath) {
 		}
 	});
 }
-//#endregion
-//#region ../../internals/client/src/components/SdkClient.tsx
+// ../../internals/client/src/components/SdkClient.tsx
 /**
 * Builds the call config literal forwarded to the contract client; the `throwOnError` fallback is applied after the `...config` spread.
 */
@@ -1197,8 +1218,7 @@ function SdkClient({ name, operations, returnType, throwOnErrorDefault }) {
 		children: classCode
 	});
 }
-//#endregion
-//#region ../../internals/client/src/components/SdkFacade.tsx
+// ../../internals/client/src/components/SdkFacade.tsx
 /**
 * Renders a composed root SDK class that instantiates every tag client from one shared config, so
 * `new PetStore({ baseURL }).petClient.getPetById(...)` reaches an operation through a single entry
@@ -1221,8 +1241,7 @@ function SdkFacade({ name, members }) {
 		children: classCode
 	});
 }
-//#endregion
-//#region ../../internals/client/src/generators/sdkGenerator.tsx
+// ../../internals/client/src/generators/sdkGenerator.tsx
 function resolveTypeImportNames(node, types) {
 	return [types.response.options(node), types.response.responses(node)];
 }
@@ -1259,9 +1278,13 @@ function buildControllers(nodes, ctx, types) {
 			validator,
 			zodResolver
 		}) : null;
+		const name = resolver.name(node.operationId);
 		return {
 			node,
-			name: resolver.name(node.operationId),
+			name: resolver.resolveName({
+				key: operationKey(node),
+				name
+			}),
 			types,
 			typeFile,
 			zodFile,
@@ -1474,19 +1497,17 @@ function createSdkGenerator() {
 		}
 	});
 }
-//#endregion
-//#region ../../internals/client/src/macros.ts
+// ../../internals/client/src/macros.ts
 /**
 * Macros the client plugins apply by default, ahead of any user macros. `macroSimplifyUnion`
 * drops union members a broader scalar already covers, keeping the generated response and error
 * unions tidy. A plugin wires them with `ctx.setMacros([...defaultMacros, ...userMacros])`.
 */
 const defaultMacros = [kubb_kit.macroSimplifyUnion];
-//#endregion
-//#region ../../internals/client/src/resolver.ts
+// ../../internals/client/src/resolver.ts
 /**
-* Default resolver shared by the client plugins. Functions and files inherit the built-in camelCase
-* `name` and `file`; classes and tag groups use PascalCase.
+* Default resolver shared by the client plugins. Functions use safe camelCase identifiers and
+* files inherit the built-in casing; classes and tag groups use PascalCase.
 *
 * @example
 * ```ts
@@ -1496,6 +1517,7 @@ const defaultMacros = [kubb_kit.macroSimplifyUnion];
 */
 const resolverClient = (0, kubb_kit.createResolver)({
 	pluginName: "plugin-contract-client",
+	name: resolveOperationName,
 	className(name) {
 		return ensureValidVarName(pascalCase(name));
 	},
@@ -1506,25 +1528,21 @@ const resolverClient = (0, kubb_kit.createResolver)({
 		return ensureValidVarName(camelCase(name));
 	}
 });
-//#endregion
-//#region src/generators/clientGenerator.tsx
+// src/generators/clientGenerator.tsx
 /**
 * Built-in operation generator for `@kubb/plugin-axios`. Emits one async function per OpenAPI
 * operation using the shared `Operation` component: a grouped `<Name>Request` type and a function
 * that forwards a single `options` object to the bundled `client` and returns the `RequestResult`.
 */
 const clientGenerator = createClientGenerator("axios");
-//#endregion
-//#region kubb-extension.json
+// kubb-extension.json
 var compatibility = {
-	"kubb": ">=5.8.3",
+	"kubb": ">=5.14.6",
 	"node": ">=22.22"
 };
-//#endregion
-//#region package.json
-var version = "5.10.0-canary.20261025T201031";
-//#endregion
-//#region src/templates.ts
+// package.json
+var version = "5.10.0";
+// src/templates.ts
 /** Absolute path to the axios client template, copied into `.kubb/client.ts`. */
 const axiosClientTemplatePath = (0, node_url.fileURLToPath)(new URL("../templates/axios.ts", require("url").pathToFileURL(__filename).href));
 /** Absolute path to the axios serializers template, copied into `.kubb/serializers.ts`. */
@@ -1534,8 +1552,7 @@ const axiosSerializersTemplatePath = (0, node_url.fileURLToPath)(new URL("../tem
 * emit the helper into the generated `.kubb/standardSchema.ts` verbatim.
 */
 const standardSchemaTemplatePath = (0, node_url.fileURLToPath)(new URL("../templates/standardSchema.ts", require("url").pathToFileURL(__filename).href));
-//#endregion
-//#region src/plugin.ts
+// src/plugin.ts
 /**
 * Canonical plugin name for `@kubb/plugin-axios`. Used for driver lookups and cross-plugin
 * dependency references.
@@ -1620,7 +1637,6 @@ const pluginAxios = (0, kubb_kit.defineExtension)({
 		return resolved;
 	}
 });
-//#endregion
 exports.clientGenerator = clientGenerator;
 exports.default = pluginAxios;
 exports.pluginAxios = pluginAxios;