@kubb/plugin-mcp 5.3.1 → 5.3.3

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);
@@ -31,7 +30,7 @@ let kubb_jsx = require("kubb/jsx");
 let kubb_jsx_jsx_runtime = require("kubb/jsx/jsx-runtime");
 let _kubb_plugin_zod = require("@kubb/plugin-zod");
 let _kubb_plugin_ts = require("@kubb/plugin-ts");
-//#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
@@ -153,8 +152,9 @@ function buildRequestParamsSignature(node, resolver, options = {}) {
 		"body",
 		"headers"
 	].filter((key) => groups[key]);
+	const optionsType = hasRequestContentTypeChoice(node) ? `Pick<${resolver.response.options(node)}, ${names.map((name) => `'${name}'`).join(" | ")}>` : resolver.response.options(node);
 	return {
-		signature: [names.length > 0 ? `{ ${names.join(", ")} }: ${resolver.response.options(node)}${isOptional ? " = {}" : ""}` : null, isConfigurable ? `config: ${buildRequestConfigType(node)} = {}` : null].filter(Boolean).join(", "),
+		signature: [names.length > 0 ? `{ ${names.join(", ")} }: ${optionsType}${isOptional ? " = {}" : ""}` : null, isConfigurable ? `config: ${buildRequestConfigType(node)} = {}` : null].filter(Boolean).join(", "),
 		groups
 	};
 }
@@ -202,6 +202,22 @@ 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;
+}
+/**
+* Casts a call argument to the client's parameter type; a `'plain'` client is non-generic.
+*/
+function castToClientOptions(callArg, clientName, returnType = "full") {
+	return `${callArg} as Parameters<typeof ${clientName}${returnType === "plain" ? "" : "<true>"}>[0]`;
+}
 function getStatusCodeNumber(statusCode) {
 	const code = Number(statusCode);
 	return Number.isNaN(code) ? null : code;
@@ -219,8 +235,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)
@@ -257,8 +272,7 @@ function toCamelOrPascal(text, pascal) {
 function camelCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, false);
 }
-//#endregion
-//#region ../../internals/utils/src/fs.ts
+// ../../internals/utils/src/fs.ts
 function toSlash(p) {
 	if (p.startsWith("\\\\?\\")) return p;
 	return p.replaceAll("\\", "/");
@@ -277,8 +291,26 @@ function getRelativePath(rootDir, filePath) {
 	const relativePath = node_path.posix.relative(toSlash(rootDir), toSlash(filePath));
 	return relativePath.startsWith("../") ? relativePath : `./${relativePath}`;
 }
-//#endregion
-//#region ../../internals/shared/src/group.ts
+// ../../internals/shared/src/resolver.ts
+/**
+* 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:
@@ -308,8 +340,7 @@ function createGroupConfig(group) {
 		name: group.name ? group.name : defaultName
 	};
 }
-//#endregion
-//#region src/components/McpHandler.tsx
+// src/components/McpHandler.tsx
 const requestGroupOrder = [
 	"path",
 	"query",
@@ -324,6 +355,7 @@ function McpHandler({ name, clientName, node, resolver, returnType = "full" }) {
 		"signal: ctx.mcpReq.signal",
 		"throwOnError: true"
 	].join(", ")} }`;
+	const callArg = hasRequestContentTypeChoice(node) ? castToClientOptions(callConfig, clientName, returnType) : callConfig;
 	const body = returnType === "data" ? "res" : "res.data";
 	const callToolResult = `return {
   content: [
@@ -346,15 +378,14 @@ function McpHandler({ name, clientName, node, resolver, returnType = "full" }) {
 			JSDoc: { comments: buildOperationComments(node) },
 			returnType: "CallToolResult",
 			children: [
-				`const res = await ${clientName}(${callConfig})`,
+				`const res = await ${clientName}(${callArg})`,
 				/* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)("br", {}),
 				callToolResult
 			]
 		})
 	});
 }
-//#endregion
-//#region src/components/Server.tsx
+// src/components/Server.tsx
 /**
 * Composes individual param schemas into `z.object({ ... })`.
 */
@@ -443,8 +474,7 @@ return server`
 		})
 	] });
 }
-//#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.
@@ -510,8 +540,7 @@ function resolveOperationTypes(driver, pluginName) {
 		group: pluginZod.options.group ?? void 0
 	};
 }
-//#endregion
-//#region ../../internals/client/src/resolveClient.ts
+// ../../internals/client/src/resolveClient.ts
 /**
 * Resolves which client plugin a consumer (react-query, vue-query, swr, mcp) should call for an
 * operation, shared so the selection rules and diagnostics stay in one place.
@@ -621,8 +650,7 @@ function resolveContractClient(options) {
 	}
 	return resolved;
 }
-//#endregion
-//#region ../../internals/client/src/resolveClientOperation.ts
+// ../../internals/client/src/resolveClientOperation.ts
 function isRelativeImport(importPath) {
 	return importPath.startsWith(".");
 }
@@ -669,8 +697,12 @@ function resolveClientOperation(options) {
 			group: operationOptions.group ?? void 0
 		});
 		const { importPath } = operationOptions;
+		const name = resolver.name(node.operationId);
 		return {
-			name: resolver.name(node.operationId),
+			name: resolver.resolveName({
+				key: operationKey(node),
+				name
+			}),
 			path: file.path,
 			clientPath: importPath === void 0 ? node_path.default.resolve(root, ".kubb/client.ts") : resolveImportPath({
 				importPath,
@@ -681,8 +713,7 @@ function resolveClientOperation(options) {
 		};
 	});
 }
-//#endregion
-//#region src/generators/mcpGenerator.tsx
+// src/generators/mcpGenerator.tsx
 /**
 * Built-in operation generator for `@kubb/plugin-mcp`. Emits one MCP tool
 * handler per OpenAPI operation. The handler takes the grouped `{ path, query,
@@ -773,8 +804,7 @@ const mcpGenerator = (0, kubb_kit.defineGenerator)({
 		});
 	}
 });
-//#endregion
-//#region src/generators/serverGenerator.tsx
+// src/generators/serverGenerator.tsx
 /**
 * Default v5 server generator for `@kubb/plugin-mcp`.
 *
@@ -947,17 +977,14 @@ const serverGenerator = (0, kubb_kit.defineGenerator)({
 		] });
 	}
 });
-//#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.3.1";
-//#endregion
-//#region src/resolvers/resolverMcp.ts
+// package.json
+var version = "5.3.3";
+// src/resolvers/resolverMcp.ts
 /**
 * Default resolver used by `@kubb/plugin-mcp`. Decides the names and file
 * paths for every generated MCP tool handler. Function names get a `Handler`
@@ -976,11 +1003,14 @@ const resolverMcp = (0, kubb_kit.createResolver)({
 		return camelCase(name, { suffix: "handler" });
 	},
 	handler: { name(node) {
-		return this.name(node.operationId);
+		const name = this.name(node.operationId);
+		return this.resolveName({
+			key: operationKey(node, "handler", "name"),
+			name
+		});
 	} }
 });
-//#endregion
-//#region src/plugin.ts
+// src/plugin.ts
 /**
 * Canonical plugin name for `@kubb/plugin-mcp`. Used for driver lookups and
 * cross-plugin dependency references.
@@ -1049,7 +1079,6 @@ const pluginMcp = (0, kubb_kit.defineExtension)({
 		};
 	}
 });
-//#endregion
 exports.McpHandler = McpHandler;
 exports.Server = Server;
 exports.default = pluginMcp;