@kubb/plugin-mcp 5.5.3 → 5.5.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +3 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/docs/guides/server.md +103 -12
- package/docs/options.md +23 -43
- package/docs/overview.md +37 -10
- package/kubb-extension.json +1 -1
- package/package.json +4 -4
package/dist/index.cjs
CHANGED
|
@@ -344,7 +344,7 @@ function McpHandler({ name, clientName, node, resolver, returnType = "full" }) {
|
|
|
344
344
|
content: [
|
|
345
345
|
{
|
|
346
346
|
type: 'text',
|
|
347
|
-
text: JSON.stringify(${body})
|
|
347
|
+
text: JSON.stringify(${body}) ?? ''
|
|
348
348
|
}
|
|
349
349
|
],
|
|
350
350
|
structuredContent: { data: ${body} }
|
|
@@ -1003,11 +1003,11 @@ const serverGenerator = (0, _kubb_kit.defineGenerator)({
|
|
|
1003
1003
|
});
|
|
1004
1004
|
// kubb-extension.json
|
|
1005
1005
|
var compatibility = {
|
|
1006
|
-
"kubb": ">=5.
|
|
1006
|
+
"kubb": ">=5.19.0",
|
|
1007
1007
|
"node": ">=22.22"
|
|
1008
1008
|
};
|
|
1009
1009
|
// package.json
|
|
1010
|
-
var version = "5.5.
|
|
1010
|
+
var version = "5.5.4";
|
|
1011
1011
|
// src/resolvers/resolverMcp.ts
|
|
1012
1012
|
/**
|
|
1013
1013
|
* Default resolver used by `@kubb/plugin-mcp`. Decides the names and file
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","names":["posix","ast","File","Function","File","Function","text","Const","Diagnostics","path","pluginZodName","pluginTsName","Diagnostics","defineGenerator","jsxRenderer","ast","File","defineGenerator","jsxRenderer","pluginZodName","path","ast","File","createResolver","casing","defineExtension","pluginTsName","pluginZodName","Resolver","useConfig"],"sources":["../../../internals/utils/src/fs.ts","../../../internals/utils/src/strings.ts","../../../internals/shared/src/operation.ts","../../../internals/shared/src/resolver.ts","../src/components/McpHandler.tsx","../src/components/Server.tsx","../../../internals/client/src/resolveClient.ts","../../../internals/client/src/resolveClientOperation.ts","../../../internals/client/src/resolveOperationTypes.ts","../src/generators/mcpGenerator.tsx","../src/generators/serverGenerator.tsx","../kubb-extension.json","../package.json","../src/resolvers/resolverMcp.ts","../src/plugin.ts"],"sourcesContent":["import { posix } from 'node:path'\nimport { casing } from '@kubb/kit'\nfunction toSlash(p: string): string {\n if (p.startsWith('\\\\\\\\?\\\\')) return p\n return p.replaceAll('\\\\', '/')\n}\n\n/**\n * Returns the relative path from `rootDir` to `filePath`, always using forward slashes\n * and prefixed with `./` when not already traversing upward.\n *\n * @example\n * ```ts\n * getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'\n * getRelativePath('/src/components', '/src/utils/helpers.ts') // '../utils/helpers.ts'\n * ```\n */\nexport function getRelativePath(rootDir: string, filePath: string): string {\n const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath))\n\n return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Builds a nested file path from a dotted name. Splits on dots that precede a letter\n * (so version numbers embedded in operationIds like `v2025.0` stay intact), camelCases\n * every earlier segment, applies `caseLast` to the final segment, and joins with `/`.\n *\n * Empty segments are dropped before joining. They arise when the name starts with a dot\n * followed by a letter (e.g. `..Schema` splits into `['..', 'Schema']` and `'..'` cases to\n * an empty string). Without this a leading `/` would form, which `path.resolve` reads as an\n * absolute path, letting generated files escape the configured output directory.\n *\n * @example Nested path from a dotted name\n * `toFilePath('pet.petId') // 'pet/petId'`\n *\n * @example PascalCase the final segment\n * `toFilePath('pet.Pet', pascalCase) // 'pet/Pet'`\n *\n * @example Suffix applied to the final segment only\n * `toFilePath('tag.tag', (part) => camelCase(part, { suffix: 'schema' })) // 'tag/tagSchema'`\n */\nexport function toFilePath(name: string, caseLast: (part: string) => string = casing.camel): string {\n const parts = name.split(/\\.(?=[a-zA-Z])/)\n return parts\n .map((part, i) => (i === parts.length - 1 ? caseLast(part) : casing.camel(part)))\n .filter(Boolean)\n .join('/')\n}\n","import { text } from '@kubb/kit'\n\n// `\\p{`, `\\P{` or `\\u{` behind an odd number of backslashes, or a character outside the BMP: both need the `u` flag.\nconst NEEDS_UNICODE = /(?<!\\\\)(?:\\\\\\\\)*\\\\[pPu]\\{|[\\u{10000}-\\u{10FFFF}]/u\n// Escapes the `u` flag accepts. `\\-` only counts inside a class.\nconst KEPT_ESCAPE = /[A-Za-z0-9^$\\\\.*+?()[\\]{}|/]/\n\n/**\n * Drops the backslash from escapes that the `u` flag rejects: an escaped punctuation character that is\n * not a syntax character, and `\\-` outside a class. Both match the same character without the backslash.\n */\nfunction dropIdentityEscapes(pattern: string): string {\n let inClass = false\n\n return pattern.replace(/\\\\(.)|[[\\]]/gs, (match, escaped?: string) => {\n if (escaped === undefined) {\n inClass = match === '['\n return match\n }\n\n return KEPT_ESCAPE.test(escaped) || (escaped === '-' && inClass) ? match : escaped\n })\n}\n\n/**\n * Builds the `RegExp` for a pattern, adding the `u` flag when it uses `\\p{...}`, `\\P{...}` or `\\u{...}`, or\n * holds a character outside the BMP. A pattern that is not valid under `u` keeps the flags it came with.\n */\nfunction toRegExp(pattern: string, flags: string | undefined): RegExp {\n if (flags?.includes('u') || !NEEDS_UNICODE.test(pattern)) return new RegExp(pattern, flags)\n\n try {\n return new RegExp(dropIdentityEscapes(pattern), `${flags ?? ''}u`)\n } catch {\n return new RegExp(pattern, flags)\n }\n}\n\n/**\n * Converts a pattern string into a `new RegExp(...)` constructor call or a regex literal string.\n * Inline flags expressed as a `^(?im)` prefix are extracted and applied to the resulting expression.\n * Pass `null` as the second argument to emit a `/pattern/flags` literal instead.\n *\n * @example\n * ```ts\n * toRegExpString('^(?im)foo') // 'new RegExp(\"^foo\", \"im\")'\n * toRegExpString('^(?im)foo', null) // '/^foo/im'\n * ```\n */\nexport function toRegExpString(pattern: string, func: string | null = 'RegExp'): string {\n const raw = text.unquote(pattern)\n\n const match = raw.match(/^\\^(\\(\\?([igmsuy]+)\\))/i)\n const replacementTarget = match?.[1] ?? ''\n const matchedFlags = match?.[2]\n const cleaned = raw\n .replace(/^\\\\?\\//, '')\n .replace(/\\\\?\\/$/, '')\n .replace(replacementTarget, '')\n\n const { source, flags } = toRegExp(cleaned, matchedFlags)\n\n if (func === null) return `/${source}/${flags}`\n\n return `new ${func}(${JSON.stringify(source)}${flags ? `, ${JSON.stringify(flags)}` : ''})`\n}\n\n/**\n * Renders a dotted path or string array as an optional-chaining accessor expression rooted at\n * `accessor`. Returns `null` for an empty path.\n *\n * @example\n * ```ts\n * getNestedAccessor('pagination.next.id', 'lastPage')\n * // \"lastPage?.['pagination']?.['next']?.['id']\"\n * ```\n */\nexport function getNestedAccessor(param: string | Array<string>, accessor: string): string | null {\n const parts = Array.isArray(param) ? param : param.split('.')\n if (parts.length === 0 || (parts.length === 1 && parts[0] === '')) return null\n return `${accessor}?.['${`${parts.join(\"']?.['\")}']`}`\n}\n\n/**\n * Escapes an `@` at the start of a line, so a multi-line description can't start a new JSDoc tag.\n * Editors render `\\@` as `@` in hovers.\n *\n * @example\n * ```ts\n * jsDocEscape('intro\\n@example value') // 'intro\\n\\\\@example value'\n * ```\n */\nexport function jsDocEscape(input: unknown): string {\n return `${input}`.replace(/^(\\s*)@/gm, '$1\\\\@')\n}\n","import { jsDocEscape } from '@internals/utils'\nimport { ast, type Group, type Memo, type Output, type Resolver, type ResolverFileParams } from '@kubb/kit'\n\n/**\n * Builds the `ResolverFileParams` every operation generator passes to\n * `resolver.file`: a file named `name`, tagged by the operation's first\n * tag (or `'default'`), at the operation's path. Centralizes the entry object\n * that was repeated at dozens of call sites across the client and query plugins.\n *\n * @example\n * ```ts\n * resolver.file(operationFileEntry(node, node.operationId), { root, output, group })\n * ```\n */\nexport function operationFileEntry(node: ast.OperationNode, name: string, extname: ResolverFileParams['extname'] = '.ts'): ResolverFileParams {\n return {\n name,\n extname,\n tag: node.tags[0] ?? 'default',\n path: node.path,\n }\n}\n\n/**\n * Resolves the file a schema-emitting plugin (`plugin-ts`, `plugin-zod`, `plugin-faker`) writes\n * `node` to, cached in `ctx.memo` under the resolver's plugin name and the\n * operation. The plugin itself and every plugin that imports from it call this, so they all get\n * the same path.\n *\n * When that path matches the file of a component schema in `ctx.driver.inputNode`, ignoring case, the file name\n * gets an `Operation` suffix: operation `point` goes to `PointOperation.ts` next to schema `Point.ts`.\n * Otherwise the two merge into one file, or overwrite each other on a case-insensitive file system.\n * Only the file name changes. The declarations keep their names.\n *\n * @example Resolve `plugin-ts`'s file for the current operation\n * ```ts\n * const fileTs = resolveOperationFile({ ctx, node, resolver: tsResolver, root, output })\n * ```\n */\nexport function resolveOperationFile(options: {\n ctx: { memo: Memo; driver: { inputNode?: { schemas: ReadonlyArray<ast.SchemaNode> } | null } }\n node: ast.OperationNode\n resolver: Pick<Resolver, 'file' | 'pluginName'>\n root: string\n output: Output\n group?: Group | null\n}): ast.FileNode {\n const { ctx, node, resolver, root, output } = options\n const { memo } = ctx\n const location = { root, output, group: options.group ?? undefined }\n\n return memo(`${resolver.pluginName}:operationFile:${node.operationId}`, () => {\n const schemaPaths = memo(\n `${resolver.pluginName}:schemaFilePaths`,\n () =>\n new Set(\n (ctx.driver.inputNode?.schemas ?? []).flatMap((schema) =>\n schema.name ? [resolver.file({ name: schema.name, extname: '.ts', ...location }).path.toLowerCase()] : [],\n ),\n ),\n )\n let file = resolver.file({ ...operationFileEntry(node, node.operationId), ...location })\n\n for (let name = `${node.operationId}Operation`; schemaPaths.has(file.path.toLowerCase()); name += 'Operation') {\n const next = resolver.file({ ...operationFileEntry(node, name), ...location })\n // A single-file output holds every declaration on purpose, so a new name changes nothing.\n if (next.path === file.path) break\n file = next\n }\n\n return file\n })\n}\n\nexport type ContentTypeInfo = {\n contentTypes: string[]\n isMultipleContentTypes: boolean\n contentTypeUnion: string\n defaultContentType: string\n hasFormData: boolean\n}\n\nexport type RequestConfigResolver = {\n response: {\n body(node: ast.OperationNode): string\n }\n}\n\nexport type ResponseStatusNameResolver = {\n response: {\n status(node: ast.OperationNode, statusCode: ast.StatusCode): string\n }\n}\n\nexport type ResponseNameResolver = ResponseStatusNameResolver & {\n response: {\n response(node: ast.OperationNode): string\n }\n}\n\nexport type OperationTypeNameResolver = RequestConfigResolver &\n ResponseNameResolver & {\n param: {\n path(node: ast.OperationNode, param: ast.ParameterNode): string\n query(node: ast.OperationNode, param: ast.ParameterNode): string\n headers(node: ast.OperationNode, param: ast.ParameterNode): string\n cookies(node: ast.OperationNode, param: ast.ParameterNode): string\n }\n }\n\nexport type BuildOperationCommentsOptions = {\n splitLines?: boolean\n}\n\nexport type ResolveOperationTypeNameOptions = {\n responseStatusNames?: boolean | 'error'\n exclude?: ReadonlyArray<string | undefined>\n order?: 'params-first' | 'body-response-first'\n /**\n * Include the individual `Path`/`Query`/`Headers` group type names. Set to `false` for clients\n * that reference the grouped `Options` type instead of the per-group types.\n */\n includeParams?: boolean\n}\n\n/**\n * The operation's method and path as plain text, such as `` `GET /pet/{petId}` ``. A path is not a valid `{@link}` target.\n */\nfunction getOperationRequestLine(node: ast.OperationNode): string | null {\n return ast.http.isOperation(node) && node.path ? `\\`${node.method.toUpperCase()} ${node.path}\\`` : null\n}\n\n/**\n * Derives the shared `ContentTypeInfo` shape from a list of content types, tracking whether several\n * are present and the union, default, and form-data flags the client uses to pick one.\n */\nfunction buildContentTypeInfo(contentTypes: string[]): ContentTypeInfo {\n const isMultipleContentTypes = contentTypes.length > 1\n\n return {\n contentTypes,\n isMultipleContentTypes,\n contentTypeUnion: isMultipleContentTypes ? contentTypes.map((ct) => JSON.stringify(ct)).join(' | ') : '',\n defaultContentType: contentTypes[0] ?? 'application/json',\n hasFormData: contentTypes.some((ct) => ct === 'multipart/form-data'),\n }\n}\n\nexport function getContentTypeInfo(node: ast.OperationNode): ContentTypeInfo {\n return buildContentTypeInfo(node.requestBody?.content?.map((e) => e.contentType) ?? [])\n}\n\n/**\n * The request-body counterpart for the primary success response: the content types it documents and\n * whether several are present, so the client can let a caller pick which one to accept.\n */\nexport function getResponseContentTypeInfo(node: ast.OperationNode): ContentTypeInfo {\n return buildContentTypeInfo(ast.http.responses.findPrimary(node)?.content?.map((e) => e.contentType) ?? [])\n}\n\ntype ResponseType = 'blob' | 'text' | 'stream'\n\ntype ResponseContentEntry = { contentType: string; schema?: ast.SchemaNode | null; stream?: ast.ContentNode['stream'] }\n\n/**\n * How an operation streams its primary success response item by item, when that response declares one content type:\n * - `'event'` for `text/event-stream` whose `itemSchema` types the whole event with its own `event` and `data`\n * - `'data'` for `text/event-stream` typed by its payload only\n * - `'line'` for JSON Lines, one parsed JSON value per line\n *\n * Returns `null` for any other response, and for a response that also declares another content type, which stays a normal\n * call with its query hooks.\n */\nexport function getEventStream(node: ast.OperationNode): 'event' | 'data' | 'line' | null {\n const content = ast.http.responses.findPrimary(node)?.content ?? []\n if (content.length !== 1) return null\n const entry = content[0]!\n const framing = getStreamFraming(entry)\n if (framing === 'events') return entry.stream?.shape ?? 'data'\n return framing === 'lines' ? 'line' : null\n}\n\n/**\n * How a content entry is framed as a stream: `'events'` for Server-Sent Events, `'lines'` for JSON Lines.\n */\nexport function getStreamFraming(entry: Pick<ast.ContentNode, 'contentType' | 'stream'>): 'events' | 'lines' | undefined {\n if (ast.mediaType.getBase(entry) === 'text/event-stream') return 'events'\n // `multipart/mixed` with an `itemSchema` also has `stream`, but it is a stream of parts, not of JSON values.\n return entry.stream && ast.mediaType.isStream(entry) ? 'lines' : undefined\n}\n\n/**\n * Whether an operation streams its primary success response, as Server-Sent Events or JSON Lines. The client generator uses\n * this to return a typed stream of items instead of a one-shot `RequestResult`.\n */\nexport function isEventStream(node: ast.OperationNode): boolean {\n return getEventStream(node) !== null\n}\n\n// A stream without a schema is a `blob` with a string primitive, so it keeps the JSON-parse default.\nfunction isTextSchema(schema: ast.SchemaNode | null | undefined): boolean {\n if (!schema) return false\n const resolved = ast.ref.getSchema(schema)\n return resolved.type !== 'blob' && resolved.primitive === 'string'\n}\n\n/**\n * Whether an operation streams Server-Sent Events whose `data` the document types as a string, so the client keeps each\n * `data` as text instead of JSON-parsing it. With an event-shaped `itemSchema` where only some events type `data` as a\n * string, it returns the names of those events, or `false` when one of them has no fixed name.\n */\nexport function hasTextEventData(node: ast.OperationNode): boolean | Array<string> {\n const shape = getEventStream(node)\n const entry = ast.http.responses.findPrimary(node)?.content?.[0]\n if (!entry || (shape !== 'data' && shape !== 'event')) return false\n if (shape === 'data') return isTextSchema(entry.stream?.schema ?? entry.schema)\n\n const item = entry.stream?.schema ? ast.ref.getSchema(entry.stream.schema) : undefined\n if (!item) return false\n const events = item.type === 'union' ? (ast.schema.narrow(item, 'union')?.members ?? []) : [item]\n // A discriminator makes each event an intersection of its `$ref` and the pinned `event`, so every part is read.\n const propertySchemas = (event: ast.SchemaNode, propertyName: string) => ast.schema.findProperties({ node: event, propertyName }).map(({ schema }) => schema)\n const textEvents = events.filter((event) => {\n const dataSchemas = propertySchemas(event, 'data')\n return dataSchemas.length > 0 && dataSchemas.every(isTextSchema)\n })\n if (textEvents.length === events.length) return events.length > 0\n\n const eventNames = textEvents.map((event) => propertySchemas(event, 'event').flatMap((schema) => ast.schema.getLiterals(ast.ref.getSchema(schema))))\n return eventNames.length > 0 && eventNames.every((values) => values.length > 0) && [...new Set(eventNames.flat().map(String))]\n}\n\n/**\n * Whether the primary success response offers `text/event-stream`, alone or next to other content types. The client asks\n * for the stream by default and ships the `sse.ts` runtime, so a mixed response can be read as events too.\n */\nexport function hasEventStreamContent(node: ast.OperationNode): boolean {\n const entries = ast.http.responses.findPrimary(node)?.content ?? []\n // Next to another type, a stream without a schema gets no typed variant, so it keeps the plain call.\n return entries.some((entry) => getStreamFraming(entry) === 'events' && (entries.length === 1 || Boolean(entry.schema)))\n}\n\n/**\n * Whether a success response offers a stream media type next to other content types. The client returns that variant's\n * body as a `ReadableStream`, so the stream runtime is registered and a hook's data type includes the stream.\n */\nexport function hasStreamVariant(node: ast.OperationNode): boolean {\n return ast.http.responses.filterSuccess(node).some((response) => {\n const variants = (response.content ?? []).filter((entry) => entry.schema)\n return variants.length > 1 && variants.some((entry) => ast.mediaType.isStream(entry))\n })\n}\n\nconst formContentTypes = ['multipart/form-data', 'application/x-www-form-urlencoded'] as const\n\n/**\n * The form media types the operation's request body offers, `multipart/form-data` and `application/x-www-form-urlencoded`,\n * which the client needs a handler for.\n */\nexport function getFormContentTypes(node: ast.OperationNode): Array<(typeof formContentTypes)[number]> {\n const request = new Set((node.requestBody?.content ?? []).map((entry) => ast.mediaType.getBase(entry)))\n return formContentTypes.filter((contentType) => request.has(contentType))\n}\n\n/**\n * Parser for one response content entry.\n *\n * JSON stays unset so the runtime detects it. `text/event-stream` and JSON Lines are streams. A binary schema\n * (`format: binary` / `contentMediaType`) is a blob even when the media type is not a well-known\n * binary type. Other `text/*` is text, and `application/octet-stream`, `application/pdf`,\n * `image/*`, `audio/*`, and `video/*` are blobs.\n */\nfunction responseTypeForContent(entry: ResponseContentEntry): ResponseType | undefined {\n const baseType = ast.mediaType.getBase(entry)\n if (!baseType) return undefined\n if (getStreamFraming(entry)) return 'stream'\n if (ast.mediaType.isJson(baseType)) return undefined\n if (entry.schema?.type === 'blob') return 'blob'\n if (baseType.startsWith('text/')) return 'text'\n if (isBinaryContentType(baseType)) return 'blob'\n return undefined\n}\n\nfunction isBinaryContentType(baseType: string): boolean {\n return baseType === 'application/octet-stream' || baseType === 'application/pdf' || /^(image|audio|video)\\//.test(baseType)\n}\n\n/**\n * Maps a content type to the PascalCase suffix used to name per-content-type variants\n * (e.g. `application/json` → `Json`, `application/xml` → `Xml`, `multipart/form-data` → `FormData`).\n */\nfunction getContentTypeSuffix(contentType: string): string {\n // Keeps the original case, unlike ast.mediaType.getBase, so generated names stay stable.\n const baseType = contentType.split(';')[0]!.trim()\n if (baseType === 'application/json') return 'Json'\n if (baseType === 'multipart/form-data') return 'FormData'\n if (baseType === 'application/x-www-form-urlencoded') return 'FormUrlEncoded'\n const subtype = baseType.split('/').pop() ?? baseType\n const parts = subtype.split(/[^a-zA-Z0-9]+/).filter(Boolean)\n if (parts.length === 0) return 'Unknown'\n return parts.map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('')\n}\n\n/**\n * Appends a content-type suffix to a base name, keeping a trailing `Data` segment last\n * (e.g. `AddPetData` + `Json` → `AddPetJsonData`, `AddPetStatus200` + `Xml` → `AddPetStatus200Xml`).\n */\nexport function getPerContentTypeName(baseName: string, suffix: string): string {\n if (baseName.endsWith('Data')) {\n return suffix.endsWith('Data') ? baseName.slice(0, -4) + suffix : `${baseName.slice(0, -4)}${suffix}Data`\n }\n return baseName + suffix\n}\n\nexport type ContentVariantInput = { contentType: string; schema?: ast.SchemaNode | null; keysToOmit?: Array<string> | null }\nexport type ContentVariant = { name: string; suffix: string; schema: ast.SchemaNode; keysToOmit?: Array<string> | null; contentType: string }\n\n/**\n * Returns the entry with the schema of the value the client returns: `string` for a body read as text, such as `Pet` on\n * `application/xml`, and `blob` for `image/*`, `audio/*`, `video/*`, PDF, and octet-stream. A binary schema elsewhere is a `Blob`\n * only through `parseAs: 'blob'`, which needs every entry in `entries` binary. JSON, vendor (`application/vnd.*`), stream,\n * schemaless, and wildcard entries keep their schema. `entries` is the response's full list of content types.\n */\nexport function toResponseContent<T extends ContentVariantInput & ResponseContentEntry>(entry: T, entries: ReadonlyArray<ResponseContentEntry> = [entry]): T {\n const { contentType, schema } = entry\n if (!schema || entry.stream) return entry\n\n const baseType = ast.mediaType.getBase(contentType)\n const resolved = ast.ref.getSchema(schema)\n if (isBinaryContentType(baseType)) {\n return resolved.type === 'blob' ? entry : { ...entry, schema: ast.factory.createSchema({ type: 'blob' }), keysToOmit: null }\n }\n const isPlainMediaType = Boolean(baseType) && !ast.mediaType.isJson(baseType) && !baseType.includes('*')\n if (resolved.type === 'blob') {\n // shortcut: an error response never gets `parseAs`, so a lone binary schema there reads as text too but stays `Blob`.\n const readsAsText = isPlainMediaType && !entries.every((item) => item.schema?.type === 'blob')\n return readsAsText ? { ...entry, schema: ast.factory.createSchema({ type: 'string' }), keysToOmit: null } : entry\n }\n if (resolved.primitive === 'string') return entry\n\n const responseType = responseTypeForContent(entry)\n // A response without a body, such as a 405, has no schema to read. Only `text/*` is always text.\n if (responseType !== 'text' && (resolved.type === 'unknown' || resolved.type === 'any' || resolved.type === 'void')) return entry\n const isVendorJson = /^[^/]+\\/vnd\\./.test(baseType) && !/(xml|yaml|yml|csv)$/.test(baseType)\n const isText = responseType === 'text' || (!responseType && isPlainMediaType && !isVendorJson)\n\n return isText ? { ...entry, schema: ast.factory.createSchema({ type: 'string' }), keysToOmit: null } : entry\n}\n\n/**\n * Resolves per-content-type variant names for a set of content entries, deduplicating suffix\n * collisions with a numeric counter. Entries without a schema are skipped. The returned `suffix` is\n * the final (possibly counter-augmented) value, so callers can derive parallel names in another\n * namespace (e.g. plugin-faker deriving the matching plugin-ts type name).\n */\nexport function resolveContentTypeVariants(entries: Array<ContentVariantInput>, baseName: string): Array<ContentVariant> {\n const usedNames = new Set<string>()\n return entries\n .filter((entry) => entry.schema)\n .map((entry) => {\n const baseSuffix = getContentTypeSuffix(entry.contentType)\n let suffix = baseSuffix\n let name = getPerContentTypeName(baseName, suffix)\n let counter = 2\n while (usedNames.has(name)) {\n suffix = `${baseSuffix}${counter++}`\n name = getPerContentTypeName(baseName, suffix)\n }\n usedNames.add(name)\n return { name, suffix, schema: entry.schema!, keysToOmit: entry.keysToOmit, contentType: entry.contentType }\n })\n}\n\n/**\n * Builds the `client?:` option type shared by the generated query hooks (`useQuery`,\n * `useInfiniteQuery`, `useSWR`, ...): `RequestConfig` minus what the\n * hook fills in, which is every request group and `throwOnError`. Unlike {@link buildRequestConfigType},\n * it never narrows `contentType`: query hooks wrap GET operations, which carry no request body to select\n * a content type for.\n */\nexport function buildClientOptionType(options: { omit?: Array<string> } = {}): string {\n const keys = [...requestGroupOrder, 'url', ...(options.omit ?? []), 'throwOnError']\n return `Partial<Omit<RequestConfig, ${keys.map((key) => `'${key}'`).join(' | ')}>>`\n}\n\n/**\n * The `client?:` option type of a mutation hook. When the operation has a request content type choice,\n * the mutation variables carry `contentType`, so the config leaves it out. Otherwise the ambiguous side is\n * narrowed to the operation's media types; a single-type side has nothing to pick, so it stays baked in the\n * generated call.\n */\nexport function buildRequestConfigType(node: ast.OperationNode): string {\n if (hasRequestContentTypeChoice(node)) {\n return buildClientOptionType({ omit: ['contentType'] })\n }\n\n const request = getContentTypeInfo(node)\n const response = getResponseContentTypeInfo(node)\n const members = [\n request.isMultipleContentTypes ? `request?: ${request.contentTypeUnion}` : null,\n response.isMultipleContentTypes ? `response?: ${response.contentTypeUnion}` : null,\n ].filter(Boolean)\n\n const base = buildClientOptionType()\n return members.length ? `${base} & { contentType?: { ${members.join('; ')} } }` : base\n}\n\n/** The grouped request options, in the order generated signatures and calls list them. */\nexport const requestGroupOrder = ['path', 'query', 'body', 'headers', 'cookies'] as const\n\nexport type RequestGroups = {\n path: boolean\n query: boolean\n body: boolean\n headers: boolean\n cookies: boolean\n}\n\n/**\n * Which of the grouped request options an operation carries.\n */\nexport function getRequestGroups(node: ast.OperationNode): RequestGroups {\n const { path, query, header, cookie } = ast.http.groupParameters(node)\n return {\n path: path.length > 0,\n query: query.length > 0,\n body: Boolean(ast.http.requestBody.getSchema(node)),\n headers: header.length > 0,\n cookies: cookie.length > 0,\n }\n}\n\nexport type RequestGroupOptionality = {\n groups: RequestGroups\n hasRequiredPath: boolean\n hasRequiredQuery: boolean\n hasRequiredHeader: boolean\n /**\n * Whether the grouped request parameter can default to `{}`. True only when no group carries a\n * required member, so every member is safe to omit.\n */\n isOptional: boolean\n}\n\n/**\n * Resolves which grouped request options an operation carries together with whether each group\n * holds a required member. The grouped parameter stays optional only when nothing inside it is\n * required, matching the generated `RequestConfig` type.\n */\nexport function getRequestGroupOptionality(node: ast.OperationNode): RequestGroupOptionality {\n const groups = getRequestGroups(node)\n const { path, query, header } = ast.http.groupParameters(node)\n const hasRequiredPath = path.some((param) => param.required)\n const hasRequiredQuery = query.some((param) => param.required)\n const hasRequiredHeader = header.some((param) => param.required)\n\n return {\n groups,\n hasRequiredPath,\n hasRequiredQuery,\n hasRequiredHeader,\n // `cookies` never makes the parameter required: a browser sends its cookies itself and cannot set a `Cookie` header.\n isOptional: !hasRequiredPath && !hasRequiredQuery && !hasRequiredHeader && !(groups.body && node.requestBody?.required === true),\n }\n}\n\nexport type RequestOptionsNameResolver = RequestConfigResolver & {\n response: {\n options(node: ast.OperationNode): string\n }\n}\n\n/**\n * Builds the grouped `{ path, query, body, headers, cookies }` parameter for a generated client\n * function, typed from the operation's `Options` (minus `url`). Only the groups the\n * operation actually has are destructured. The trailing `config` parameter carries the\n * runtime `RequestConfig` overrides plus `client`.\n */\nexport function buildRequestParamsSignature(\n node: ast.OperationNode,\n resolver: RequestOptionsNameResolver,\n options: { isConfigurable?: boolean } = {},\n): { signature: string; groups: RequestGroups; names: Array<keyof RequestGroups> } {\n const { isConfigurable = true } = options\n const { groups, isOptional } = getRequestGroupOptionality(node)\n\n const names = requestGroupOrder.filter((key) => groups[key])\n\n // These callers never carry the `contentType` that several media types require.\n const optionsType = hasRequestContentTypeChoice(node)\n ? `Pick<${resolver.response.options(node)}, ${names.map((name) => `'${name}'`).join(' | ')}>`\n : resolver.response.options(node)\n const firstParam = names.length > 0 ? `{ ${names.join(', ')} }: ${optionsType}${isOptional ? ' = {}' : ''}` : null\n const configParam = isConfigurable ? `config: ${buildRequestConfigType(node)} = {}` : null\n\n return {\n signature: [firstParam, configParam].filter(Boolean).join(', '),\n groups,\n names,\n }\n}\n\nexport function buildOperationComments(node: ast.OperationNode, options: BuildOperationCommentsOptions = {}): Array<string> {\n const { splitLines = false } = options\n // The request line leads: free text after a block tag would belong to that tag.\n const comments = [\n getOperationRequestLine(node),\n node.description && `@description ${node.description}`,\n node.summary && `@summary ${node.summary}`,\n node.deprecated && '@deprecated',\n node.externalDocs && `@see ${jsDocEscape([node.externalDocs.url, node.externalDocs.description].filter(Boolean).join(' '))}`,\n ]\n\n const filteredComments = comments.filter((comment): comment is string => Boolean(comment))\n\n if (!splitLines) {\n return filteredComments\n }\n\n return filteredComments.flatMap((text) => text.split(/\\r?\\n/).map((line) => line.trim())).filter((comment): comment is string => Boolean(comment))\n}\n\n/**\n * Whether the operation declares more than one request media type with a schema, so a caller must pick one on `contentType`.\n */\nexport function hasRequestContentTypeChoice(node: ast.OperationNode): boolean {\n return (node.requestBody?.content ?? []).filter((entry) => entry.schema).length > 1\n}\n\n/**\n * Casts a call argument to the client's parameter type; a `'plain'` client is non-generic.\n */\nexport function castToClientOptions(callArg: string, clientName: string, returnType: 'full' | 'data' | 'plain' = 'full'): string {\n return `${callArg} as Parameters<typeof ${clientName}${returnType === 'plain' ? '' : '<true>'}>[0]`\n}\n\n/**\n * Builds the combined `{ body, path, query, headers, cookies }` options object schema for an operation,\n * referencing the already-resolved body and grouped param names. `cookies` appears only on an operation\n * with a cookie parameter, and stays optional because a browser sends its cookies itself. Shared by `@kubb/plugin-ts`'s\n * `Options` type and `@kubb/plugin-zod`'s inferred options schema, so both printers emit the same shape from the same inputs.\n * `primitive: 'object'` is a no-op for the TS printer and tells the Zod printer to emit `z.object(…)` rather\n * than a record.\n */\nexport function buildOptionsSchema(node: ast.OperationNode, resolver: OperationTypeNameResolver, { pairContentTypes = false } = {}): ast.SchemaNode {\n const { path, query, header, cookie } = ast.http.groupParameters(node)\n const hasBody = Boolean(ast.http.requestBody.getSchema(node))\n const createNever = () => ast.factory.createSchema({ type: 'never', primitive: undefined, optional: true })\n const groups = [\n { name: 'path', params: path, resolve: resolver.param.path },\n { name: 'query', params: query, resolve: resolver.param.query },\n { name: 'headers', params: header, resolve: resolver.param.headers },\n { name: 'cookies', params: cookie, resolve: resolver.param.cookies },\n ] as const\n\n const createOptions = (body: ast.SchemaNode, extra: Array<ast.PropertyNode> = []) =>\n // NOTE(v5-stable): the fields were renamed from the legacy beta shape\n // (`data`/`pathParams`/`queryParams`/`headerParams`) to `body`/`path`/`query`/`headers` so the\n // type matches the runtime client. Drop this note once v5 leaves beta.\n ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n deprecated: node.deprecated,\n properties: [\n ast.factory.createProperty({ name: 'body', required: hasBody && node.requestBody?.required === true, schema: body }),\n ...groups\n .filter(({ name, params }) => name !== 'cookies' || params.length > 0)\n .map(({ name, params, resolve }) => {\n const required = name !== 'cookies' && params.some((param) => param.required)\n\n return ast.factory.createProperty({\n name,\n required,\n schema:\n params.length > 0\n ? ast.factory.createSchema({ type: 'ref', name: resolve.call(resolver.param, node, params[0]!), optional: !required })\n : createNever(),\n })\n }),\n ...extra,\n ],\n })\n\n const variants =\n pairContentTypes && hasRequestContentTypeChoice(node) ? resolveContentTypeVariants(node.requestBody?.content ?? [], resolver.response.body(node)) : []\n if (variants.length < 2) {\n return createOptions(hasBody ? ast.factory.createSchema({ type: 'ref', name: resolver.response.body(node) }) : createNever())\n }\n\n // The first media type is the runtime default, so only the others must pass `contentType`. A bare string sets the\n // request content type at runtime, so it is accepted next to the `{ request }` form.\n return ast.factory.createSchema({\n type: 'union',\n members: variants.map((variant, index) => {\n const contentType = ast.factory.createSchema({ type: 'enum', enumValues: [variant.contentType] })\n\n return createOptions(ast.factory.createSchema({ type: 'ref', name: variant.name }), [\n ast.factory.createProperty({\n name: 'contentType',\n required: index > 0,\n schema: ast.factory.createSchema({\n type: 'union',\n members: [\n contentType,\n ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n properties: [ast.factory.createProperty({ name: 'request', required: true, schema: contentType })],\n }),\n ],\n }),\n }),\n ])\n }),\n })\n}\n\n/**\n * The schema a status occupies in the `<Name>Responses` record. A status that documents several\n * content types becomes a `{ contentType; data }` union so the runtime can surface the negotiated type\n * on `result.parsed`, while the standalone `<Name>StatusNNN` alias stays the plain body union that the\n * query hooks and `result.data` use. With `streamData`, the stream variant of a 2xx status holds that schema, since the\n * client returns its body unread.\n */\nfunction buildResponseRecordEntry(\n node: ast.OperationNode,\n res: ast.ResponseNode,\n resolver: ResponseStatusNameResolver,\n streamData: ast.SchemaNode | undefined,\n): ast.SchemaNode {\n const statusName = resolver.response.status(node, res.statusCode)\n const variants = (res.content ?? []).filter((entry) => entry.schema)\n if (variants.length <= 1) {\n return ast.factory.createSchema({ type: 'ref', name: statusName })\n }\n\n return ast.factory.createSchema({\n type: 'union',\n members: resolveContentTypeVariants(variants, statusName).map((variant) =>\n ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n properties: [\n ast.factory.createProperty({\n name: 'contentType',\n required: true,\n // The runtime reports the bare media type, without parameters such as `charset` or `profile`.\n schema: ast.factory.createSchema({ type: 'enum', enumValues: [ast.mediaType.getBase(variant)] }),\n }),\n ast.factory.createProperty({\n name: 'data',\n required: true,\n schema:\n streamData && ast.http.status.isSuccess(res) && ast.mediaType.isStream(variant)\n ? streamData\n : ast.factory.createSchema({ type: 'ref', name: variant.name }),\n }),\n ],\n }),\n ),\n })\n}\n\n/**\n * Builds the per-status `<Name>Responses` record for an operation, referencing the already-resolved\n * `<Name>StatusNNN` names. Shared by `@kubb/plugin-ts`'s `Responses` type and `@kubb/plugin-zod`'s\n * inferred responses schema, so both emit the same shape from the same inputs.\n *\n * Always emits the keyed record, even when an operation declares no responses. An operation with no\n * responses renders as an empty object, which keeps every consumer's import (for example the axios\n * SDK's `RequestResult<XResponses>`) resolvable instead of pointing at a missing export.\n *\n * `streamData` is the type of a stream variant's `data`, such as a `ReadableStream<Uint8Array>` reference.\n */\nexport function buildResponses(\n node: ast.OperationNode,\n resolver: ResponseStatusNameResolver,\n { streamData }: { streamData?: ast.SchemaNode } = {},\n): ast.SchemaNode {\n return ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n properties: node.responses.map((res) =>\n ast.factory.createProperty({\n name: String(res.statusCode),\n required: true,\n schema: buildResponseRecordEntry(node, res, resolver, streamData),\n }),\n ),\n })\n}\n\nexport function resolveErrorNames(node: ast.OperationNode, resolver: ResponseStatusNameResolver): string[] {\n return ast.http.responses.filterError(node).map((response) => resolver.response.status(node, response.statusCode))\n}\n\nexport function resolveSuccessNames(node: ast.OperationNode, resolver: ResponseStatusNameResolver): string[] {\n return ast.http.responses.filterSuccess(node).map((response) => resolver.response.status(node, response.statusCode))\n}\n\nexport function resolveStatusCodeNames(node: ast.OperationNode, resolver: ResponseStatusNameResolver): string[] {\n return node.responses.map((response) => resolver.response.status(node, response.statusCode))\n}\n\n/**\n * Lists the type names an operation's types file declares, computed once per resolver and `options` so every\n * dependent reads the same list.\n */\nexport function resolveOperationTypeNames(\n node: ast.OperationNode,\n resolver: OperationTypeNameResolver & Pick<Resolver, 'memo'>,\n options: ResolveOperationTypeNameOptions = {},\n): string[] {\n const key = `${node.operationId}\\0${options.order ?? ''}\\0${options.responseStatusNames ?? ''}\\0${options.includeParams === false ? 'noparams' : ''}\\0${(options.exclude ?? []).join(',')}`\n return resolver.memo(`operationTypeNames:${key}`, () => {\n const { path, query, header, cookie } = ast.http.groupParameters(node)\n const responseStatusNames =\n options.responseStatusNames === 'error'\n ? resolveErrorNames(node, resolver)\n : options.responseStatusNames === false\n ? []\n : resolveStatusCodeNames(node, resolver)\n const exclude = new Set(options.exclude ?? [])\n const paramNames =\n options.includeParams === false\n ? []\n : [\n ...path.map((param) => resolver.param.path(node, param)),\n ...query.map((param) => resolver.param.query(node, param)),\n ...header.map((param) => resolver.param.headers(node, param)),\n ...cookie.map((param) => resolver.param.cookies(node, param)),\n ]\n const bodyAndResponseNames = [ast.http.requestBody.getSchema(node) ? resolver.response.body(node) : null, resolver.response.response(node)]\n const names =\n options.order === 'body-response-first'\n ? [...bodyAndResponseNames, ...paramNames, ...responseStatusNames]\n : [...paramNames, ...bodyAndResponseNames, ...responseStatusNames]\n\n return names.filter((name): name is string => Boolean(name) && !exclude.has(name as string))\n })\n}\n\nexport function resolveResponseTypes(node: ast.OperationNode, resolver: ResponseNameResolver): Array<[statusCode: number | 'default', typeName: string]> {\n const types: Array<[number | 'default', string]> = []\n\n for (const response of node.responses) {\n if (response.statusCode === 'default') {\n types.push(['default', resolver.response.response(node)])\n continue\n }\n\n const code = Number(response.statusCode)\n if (Number.isNaN(code)) {\n continue\n }\n\n types.push([code, ast.http.status.isSuccess(code) ? resolver.response.response(node) : resolver.response.status(node, response.statusCode)])\n }\n\n return types\n}\n","import { ensureValidVarName, toFilePath } from '@internals/utils'\nimport { ast, casing } from '@kubb/kit'\nimport type { GeneratorContext, Resolver, ResolverFile } from '@kubb/kit'\n\n/**\n * The shared top-level `name` of the operation plugins, computed once per operation name and build.\n */\nexport function resolveOperationName(this: Resolver, name: string): string {\n return this.memo(`operation:${name}`, () => ensureValidVarName(casing.camel(name)))\n}\n\n/**\n * Builds the allocation key for a declaration an operation owns. `scope` names which declaration\n * it is, so two of them never share an allocation even when a custom resolver gives both the same\n * name. Leave `scope` empty for the operation's own declaration.\n *\n * The key starts from the operation's input `pointer`, which macros keep, so a plugin whose macro\n * rewrites the method or path still resolves another plugin's names for the same operation.\n *\n * @example\n * ```ts\n * resolver.resolveName({ key: operationKey(node, 'response', 'status', 404), name })\n * ```\n */\nexport function operationKey(node: ast.OperationNode, ...scope: Array<string | number>): Array<string | undefined> {\n const source = node.pointer ? [node.pointer] : [node.method, node.path]\n return ['operation', ...source, ...scope.map(String)]\n}\n\n/**\n * The `param` namespace shared by the schema-producing plugins (ts, zod, faker):\n * per-parameter names plus the grouped `Path`/`Query`/`Headers`/`Cookies` names, all routed\n * through the plugin's top-level `name` casing.\n */\nexport type OperationParamResolver = {\n name(this: Resolver, node: ast.OperationNode, param: ast.ParameterNode): string\n path(this: Resolver, node: ast.OperationNode): string\n query(this: Resolver, node: ast.OperationNode): string\n headers(this: Resolver, node: ast.OperationNode): string\n cookies(this: Resolver, node: ast.OperationNode): string\n}\n\n/**\n * The `response` namespace shared by the schema-producing plugins: per-status,\n * body, and combined response names, all routed through the plugin's top-level\n * `name` casing.\n */\nexport type OperationResponseResolver = {\n status(this: Resolver, node: ast.OperationNode, statusCode: ast.StatusCode): string\n /**\n * Name of the headers a response declares, such as `ListPetsStatus200Headers`.\n */\n headers(this: Resolver, node: ast.OperationNode, statusCode: ast.StatusCode): string\n body(this: Resolver, node: ast.OperationNode): string\n responses(this: Resolver, node: ast.OperationNode): string\n response(this: Resolver, node: ast.OperationNode): string\n}\n\n/**\n * Builds the shared `param` namespace. Spread the result into `createResolver`\n * and override individual methods next to it when a plugin deviates.\n *\n * @example\n * ```ts\n * createResolver<PluginTs>({ param: createOperationParamResolver(), ... })\n * ```\n */\nexport function createOperationParamResolver(): OperationParamResolver {\n return {\n name(node, param) {\n const name = this.name(`${node.operationId} ${param.in} ${param.name}`)\n return this.resolveName({ key: operationKey(node, 'param', 'name', param.in, param.name), name })\n },\n path(node) {\n const name = this.name(`${node.operationId} Path`)\n return this.resolveName({ key: operationKey(node, 'param', 'path'), name })\n },\n query(node) {\n const name = this.name(`${node.operationId} Query`)\n return this.resolveName({ key: operationKey(node, 'param', 'query'), name })\n },\n headers(node) {\n const name = this.name(`${node.operationId} Headers`)\n return this.resolveName({ key: operationKey(node, 'param', 'headers'), name })\n },\n cookies(node) {\n const name = this.name(`${node.operationId} Cookies`)\n return this.resolveName({ key: operationKey(node, 'param', 'cookies'), name })\n },\n }\n}\n\n/**\n * Builds the shared `response` namespace. Spread the result into\n * `createResolver` and add plugin-specific methods (`options`, `error`) next\n * to it.\n *\n * @example\n * ```ts\n * createResolver<PluginTs>({ response: { ...createOperationResponseResolver(), options(node) {...} }, ... })\n * ```\n */\nexport function createOperationResponseResolver(): OperationResponseResolver {\n return {\n status(node, statusCode) {\n const name = this.name(`${node.operationId} Status ${statusCode}`)\n return this.resolveName({ key: operationKey(node, 'response', 'status', statusCode), name })\n },\n headers(node, statusCode) {\n const name = this.name(`${node.operationId} Status ${statusCode} Headers`)\n return this.resolveName({ key: operationKey(node, 'response', 'headers', statusCode), name })\n },\n body(node) {\n const name = this.name(`${node.operationId} Body`)\n return this.resolveName({ key: operationKey(node, 'response', 'body'), name })\n },\n responses(node) {\n const name = this.name(`${node.operationId} Responses`)\n return this.resolveName({ key: operationKey(node, 'response', 'responses'), name })\n },\n response(node) {\n const name = this.name(`${node.operationId} Response`)\n return this.resolveName({ key: operationKey(node, 'response', 'response'), name })\n },\n }\n}\n\n/**\n * Builds a resolver `file` override whose base name runs every path segment\n * through `toFilePath`, casing the final segment with `caseLast`.\n *\n * @example\n * ```ts\n * createResolver<PluginTs>({ file: createCasedFile(pascalCase), ... })\n * ```\n */\nexport function createCasedFile(caseLast: (part: string) => string): ResolverFile {\n return {\n baseName({ name, extname }) {\n return this.memo(`file:${name}\\0${extname}`, (): ast.FileNode['baseName'] => `${toFilePath(name, caseLast)}${extname}`)\n },\n }\n}\n\ntype SchemaIndexContext = Pick<GeneratorContext, 'memo' | 'driver'>\n\n/**\n * Names of the schemas in a circular reference chain, computed once per build.\n */\nexport function getCircularNames(ctx: SchemaIndexContext): ReadonlySet<string> {\n return ctx.memo('circularNames:set', () => ast.graph.getCircularNames(ctx.driver.inputNode?.schemas ?? []))\n}\n\n/**\n * Names of the schemas whose type is `enum`, computed once per build.\n */\nexport function getEnumNames(ctx: SchemaIndexContext): ReadonlySet<string> {\n return ctx.memo(\n 'enumNames:set',\n () => new Set((ctx.driver.inputNode?.schemas ?? []).flatMap((schema) => (schema.type === 'enum' && schema.name ? [schema.name] : []))),\n )\n}\n\ndeclare global {\n namespace Kubb {\n interface MemoRegistry {\n operation: string\n file: ast.FileNode['baseName']\n operationTypeNames: Array<string>\n }\n }\n}\n","import { buildOperationComments, buildRequestParamsSignature, castToClientOptions, hasRequestContentTypeChoice } from '@internals/shared'\nimport type { ast } from '@kubb/kit'\nimport type { ResolverTs } from '@kubb/plugin-ts'\nimport { File, Function } from '@kubb/renderer-jsx'\nimport type { KubbReactNode } from '@kubb/renderer-jsx'\n\ntype Props = {\n /**\n * Name of the handler function.\n */\n name: string\n /**\n * Name of the contract client `<op>` the handler calls.\n */\n clientName: string\n /**\n * AST operation node.\n */\n node: ast.HttpOperationNode\n /**\n * TypeScript resolver for resolving param/data/response type names.\n */\n resolver: ResolverTs\n /**\n * The registered client plugin's `returnType`, read by the caller off `resolveClientOperation`.\n */\n returnType?: 'full' | 'data' | 'plain'\n}\n\nexport function McpHandler({ name, clientName, node, resolver, returnType = 'full' }: Props): KubbReactNode {\n const { signature, names: callArgs } = buildRequestParamsSignature(node, resolver, { isConfigurable: false })\n const paramsSignature = [signature, 'ctx: ServerContext'].filter(Boolean).join(', ')\n\n // Forward the grouped config and MCP cancellation signal through the contract client. `throwOnError: true`\n // pins the result shape, since `throwOnErrorDefault: false` would otherwise resolve to the full result.\n const callConfig = `{ ${[...callArgs, 'signal: ctx.mcpReq.signal', 'throwOnError: true'].join(', ')} }`\n // Tool arguments carry no media type, so the call takes the client's default one.\n const callArg = hasRequestContentTypeChoice(node) ? castToClientOptions(callConfig, clientName, returnType) : callConfig\n const body = returnType === 'data' ? 'res' : 'res.data'\n\n const callToolResult = `return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(${body})\n }\n ],\n structuredContent: { data: ${body} }\n}`\n\n return (\n <File.Source name={name} isExportable isIndexable>\n <Function\n name={name}\n async\n export\n params={paramsSignature}\n JSDoc={{\n comments: buildOperationComments(node),\n }}\n returnType={'CallToolResult'}\n >\n {`const res = await ${clientName}(${callArg})`}\n <br />\n {callToolResult}\n </Function>\n </File.Source>\n )\n}\n","import type { ast } from '@kubb/kit'\nimport { text } from '@kubb/kit'\nimport { Const, File, Function } from '@kubb/renderer-jsx'\nimport type { KubbReactNode } from '@kubb/renderer-jsx'\n\ntype ZodParam = {\n name: string\n schemaName: string\n}\n\n/**\n * Composes individual param schemas into `z.object({ ... })`.\n */\nconst zodObject = (params: Array<ZodParam>) => `z.object({ ${params.map((p) => `${JSON.stringify(p.name)}: ${p.schemaName}`).join(', ')} })`\n\ntype Props = {\n /**\n * Human-readable server name passed to `new McpServer({ name })`.\n */\n serverName: string\n /**\n * Semantic version string passed to `new McpServer({ version })`.\n */\n serverVersion: string\n /**\n * Operations to register as MCP tools, each carrying its handler,\n * zod schema, and AST node metadata.\n */\n operations: Array<{\n tool: {\n name: string\n title?: string\n description: string\n }\n mcp: {\n name: string\n file: ast.FileNode\n }\n zod: {\n pathParams: Array<ZodParam>\n /**\n * Query params — individual schemas to compose into `z.object({ ... })`, or the name of the grouped query schema.\n */\n queryParams?: Array<ZodParam> | string | null\n /**\n * Header params — individual schemas to compose into `z.object({ ... })`.\n */\n headerParams?: Array<ZodParam> | null\n /**\n * The cookie params, each a schema to compose into `z.object({ ... })`.\n */\n cookieParams?: Array<ZodParam> | null\n requestName?: string | null\n responseName?: string | null\n }\n }>\n}\n\nexport function Server({ serverName, serverVersion, operations }: Props): KubbReactNode {\n const registrations = operations\n .map(({ tool, mcp, zod }) => {\n // Group params into the same `{ path, query, headers, cookies, body }` shape the contract `<op>`\n // expects, so the MCP tool input mirrors every other client consumer.\n const entries: Array<{ key: string; value: string }> = []\n\n if (zod.pathParams.length) {\n entries.push({ key: 'path', value: zodObject(zod.pathParams) })\n }\n\n if (zod.queryParams) {\n entries.push({ key: 'query', value: typeof zod.queryParams === 'string' ? zod.queryParams : zodObject(zod.queryParams) })\n }\n\n if (zod.headerParams) {\n entries.push({ key: 'headers', value: zodObject(zod.headerParams) })\n }\n\n if (zod.cookieParams) {\n entries.push({ key: 'cookies', value: zodObject(zod.cookieParams) })\n }\n\n if (zod.requestName) {\n entries.push({ key: 'body', value: zod.requestName })\n }\n\n const destructured = `{ ${entries.map((e) => e.key).join(', ')} }`\n const inputSchema = entries.length ? `toolSchema(z.object({ ${entries.map((e) => `${e.key}: ${e.value}`).join(', ')} }))` : null\n const outputSchema = zod.responseName\n\n const config = [\n tool.title ? `title: ${JSON.stringify(tool.title)}` : null,\n `description: ${JSON.stringify(tool.description)}`,\n outputSchema ? `outputSchema: toolSchema(z.object({ data: ${outputSchema} }))` : null,\n ]\n .filter(Boolean)\n .join(',\\n ')\n\n if (inputSchema) {\n return `\nserver.registerTool(${JSON.stringify(tool.name)}, {\n ${config},\n inputSchema: ${inputSchema},\n}, async (${destructured}, ctx) => {\n return ${mcp.name}(${destructured}, ctx)\n})\n`\n }\n\n return `\nserver.registerTool(${JSON.stringify(tool.name)}, {\n ${config},\n}, async (ctx) => {\n return ${mcp.name}(ctx)\n})\n`\n })\n .filter(Boolean)\n .join('')\n\n return (\n <>\n <File.Source name=\"toolSchema\">\n <Function\n name=\"toolSchema\"\n generics=\"T extends z.ZodType\"\n params=\"schema: T\"\n JSDoc={{\n comments: [\n 'Converts with `unrepresentable: \"any\"`, because a `bigint` or `Blob` in one tool schema fails every `tools/list` request.',\n 'A `bigint` is listed as an `int64` integer and a `Blob` as an unconstrained value.',\n ],\n }}\n >\n {`const standard = schema['~standard']\nconst convert = (io: 'input' | 'output') => (options: Parameters<typeof standard.jsonSchema.input>[0]) =>\n standard.jsonSchema[io]({\n ...options,\n libraryOptions: {\n unrepresentable: 'any',\n override: ({ zodSchema, jsonSchema }: { zodSchema: z.core.$ZodType; jsonSchema: Record<string, unknown> }) => {\n if (zodSchema._zod.def.type === 'bigint') {\n jsonSchema.type = 'integer'\n jsonSchema.format = 'int64'\n }\n },\n },\n })\n\nreturn { '~standard': { ...standard, jsonSchema: { input: convert('input'), output: convert('output') } } }`}\n </Function>\n </File.Source>\n\n <File.Source name=\"getServer\" isExportable isIndexable>\n <Function name=\"getServer\" export>\n {`const server = new McpServer({\n name: ${text.quote(serverName)},\n version: ${text.quote(serverVersion)},\n})\n${registrations}\nreturn server`}\n </Function>\n </File.Source>\n\n <File.Source name=\"server\" isExportable isIndexable>\n <Const name={'server'} export>\n {'getServer()'}\n </Const>\n </File.Source>\n\n <File.Source name=\"startServer\" isExportable isIndexable>\n <Function name=\"startServer\" async export>\n {`return serveStdio(getServer, {\n onerror: (error) => console.error('MCP server error:', error),\n })`}\n </Function>\n </File.Source>\n </>\n )\n}\n","/**\n * Resolves which client plugin a consumer (react-query, vue-query, swr, mcp) should call for an\n * operation, shared so the selection rules and diagnostics stay in one place.\n *\n * Every client runtime lives in a dedicated client plugin, so a consumer always calls a registered\n * contract client plugin (plugin-fetch, plugin-axios, or plugin-client) and never emits its own\n * inline client:\n *\n * - `contract` — a registered contract client plugin owns the `<op>` functions and the consumer\n * imports and calls them.\n * - `error` — no client plugin is registered, several are registered without a selector, the\n * requested one is missing, or `client` is not a known selector.\n *\n * The `client` string selects explicitly (`'fetch'` / `'axios'` / `'client'`); when it is unset a\n * lone registered contract client plugin is picked up automatically.\n */\n\nimport { Diagnostics } from '@kubb/kit'\n\n// Canonical plugin names. They mirror the `pluginFetchName` / `pluginAxiosName` / `pluginClientName`\n// consts the plugins export, kept as literals so this internal needs no plugin install deps.\nconst pluginFetchName = 'plugin-fetch'\nconst pluginAxiosName = 'plugin-axios'\nconst pluginClientName = 'plugin-client'\n\n/**\n * The client selector accepted by a consumer's `client` option. Each calls a registered contract\n * client plugin.\n */\nexport type ClientSelector = 'fetch' | 'axios' | 'client'\n\n/**\n * The resolved client strategy stored in a consumer plugin's options: the generated code always\n * imports and calls a registered contract client plugin's `<op>`. The client runtime lives in\n * plugin-axios / plugin-fetch, so nothing is bundled by the consumer.\n */\nexport type ResolvedContractClient = { kind: 'contract'; pluginName: string }\n\n/**\n * The outcome of {@link resolveClient}.\n *\n * - `contract` names the contract client plugin whose `<op>` functions the consumer imports.\n * - `error` carries a setup diagnostic: its code, what is wrong, and how to fix it.\n */\nexport type ResolveClientResult =\n | ResolvedContractClient\n | { kind: 'error'; code: typeof Diagnostics.code.missingDependency | typeof Diagnostics.code.invalidPluginOptions; message: string; help: string }\n\nconst selectorToPlugin: Record<ClientSelector, string> = {\n fetch: pluginFetchName,\n axios: pluginAxiosName,\n client: pluginClientName,\n}\n\n// Every contract client plugin, in auto-detect priority order.\nconst contractPlugins = [pluginFetchName, pluginAxiosName, pluginClientName] as const\n\n/**\n * Applies the `client` resolution rules. See the module comment for the strategy shape.\n *\n * @example\n * ```ts\n * resolveClient({ client: 'fetch', pluginNames: ['plugin-ts', 'plugin-fetch'] })\n * // { kind: 'contract', pluginName: 'plugin-fetch' }\n * ```\n *\n * @example\n * ```ts\n * resolveClient({ client: undefined, pluginNames: ['plugin-ts'] })\n * // { kind: 'error', code: 'KUBB_MISSING_DEPENDENCY', message: 'No client plugin is registered.', help: 'Add …' }\n * ```\n */\nexport function resolveClient(options: { client: ClientSelector | undefined; pluginNames: ReadonlyArray<string> }): ResolveClientResult {\n const { client, pluginNames } = options\n const has = (name: string) => pluginNames.includes(name)\n\n if (client === 'fetch' || client === 'axios' || client === 'client') {\n const pluginName = selectorToPlugin[client]\n if (!has(pluginName)) {\n return {\n kind: 'error',\n code: Diagnostics.code.missingDependency,\n message: `\\`client: '${client}'\\` is set but \\`@kubb/plugin-${client}\\` is not registered in \\`plugins\\`.`,\n help: `Add \\`@kubb/plugin-${client}\\` to \\`plugins\\`, or drop \\`client\\` to use a different client plugin.`,\n }\n }\n return { kind: 'contract', pluginName }\n }\n\n // A JS config bypasses the `ClientSelector` type, so reject unknown selectors instead of auto-detecting.\n if (client !== undefined) {\n return {\n kind: 'error',\n code: Diagnostics.code.invalidPluginOptions,\n message: `Option \\`client\\` is ${typeof client === 'string' ? `'${client}'` : String(client)}, but it must be one of 'fetch', 'axios', 'client'.`,\n help: 'Set `client` to one of those values, or drop it to use the registered client plugin.',\n }\n }\n\n // `client` unset: auto-detect a lone registered contract client plugin.\n const registered = contractPlugins.filter(has)\n if (registered.length === 1) {\n return { kind: 'contract', pluginName: registered[0]! }\n }\n if (registered.length > 1) {\n return {\n kind: 'error',\n code: Diagnostics.code.invalidPluginOptions,\n message: `Multiple client plugins are registered (${registered.map((name) => `\\`@kubb/${name}\\``).join(', ')}) and \\`client\\` is not set.`,\n help: \"Set `client: 'fetch' | 'axios' | 'client'` to choose which client the hooks call, or register a single client plugin.\",\n }\n }\n\n return {\n kind: 'error',\n code: Diagnostics.code.missingDependency,\n message: 'No client plugin is registered.',\n help: 'Add `@kubb/plugin-fetch`, `@kubb/plugin-axios`, or `@kubb/plugin-client` to `plugins` so the generated code has an HTTP client to call.',\n }\n}\n\n/**\n * Resolves the contract client during a consumer plugin's setup hook.\n * It extracts the plugin names from the raw `plugins` config and applies {@link resolveClient}.\n * On a misconfiguration it throws a config diagnostic tagged with `plugin`, so every consumer\n * fails fast with the same message.\n */\nexport function resolveContractClient(options: {\n plugin: string\n client: ClientSelector | undefined\n plugins?: ReadonlyArray<unknown>\n}): ResolvedContractClient {\n const { plugin, client, plugins = [] } = options\n const pluginNames = plugins.map((plugin) => (plugin as { name?: string }).name).filter((name): name is string => Boolean(name))\n const resolved = resolveClient({ client, pluginNames })\n if (resolved.kind === 'error') {\n const { code, message, help } = resolved\n throw new Diagnostics.Error({ code, severity: 'error', message, help, location: { kind: 'config' }, plugin })\n }\n return resolved\n}\n","import path from 'node:path'\nimport { operationFileEntry, operationKey } from '@internals/shared'\nimport type { ast, Exclude, Group, Include, Memo, Output, Override, Resolver } from '@kubb/kit'\n\n/**\n * Shape of the value a generated operation function resolves to.\n * - `'full'`: the complete `{ status, data, error, contentType, request, response }` result.\n * - `'data'`: the bare success body when `throwOnError` is true, or the full result when it is false\n * so callers can inspect `error`.\n * - `'plain'`: the client's own promise typed as `RequestResult`, with no `withUnwrap` / `unwrapResult`\n * helper. Backs `@kubb/plugin-client`.\n */\nexport type ReturnTypeOption = 'full' | 'data' | 'plain'\n\n/**\n * The resolved contract `<op>` for one operation: the generated function name, the file it lives in,\n * the client module path (where `RequestConfig` / `ResponseErrorConfig` come from), and the\n * registered client plugin's `returnType`.\n *\n * `clientPath` is the absolute `.kubb/client.ts` path for plugin-fetch / plugin-axios, or\n * plugin-client's `importPath`: a relative one is resolved against the `<op>` file to an absolute\n * path, a package name or alias is kept verbatim. `clientPathIsFile` tells a consumer whether to\n * make it relative to the importing file.\n */\nexport type ClientOperation = {\n name: string\n path: string\n clientPath: string\n clientPathIsFile: boolean\n returnType: ReturnTypeOption\n /**\n * Whether the client's results carry the declared response headers. A custom `importPath` client keeps untyped headers.\n */\n typedHeaders: boolean\n}\n\n/**\n * The client plugin options a dependent reads, including the filters that scope them per operation.\n */\ntype ClientPluginOptions = {\n output?: Output\n group?: Group | null\n returnType?: ReturnTypeOption\n importPath?: string\n exclude?: Array<Exclude>\n include?: Array<Include>\n override?: Array<Override<Omit<ClientPluginOptions, 'override'>>>\n}\n\nfunction isRelativeImport(importPath: string): boolean {\n return importPath.startsWith('.')\n}\n\n// plugin-client resolves a relative `importPath` from its `<op>` file, so do the same here.\nfunction resolveImportPath(options: { importPath: string; operationFile: string }): string {\n const { importPath, operationFile } = options\n return isRelativeImport(importPath) ? path.resolve(path.dirname(operationFile), importPath) : importPath\n}\n\n/**\n * Resolves the contract client `<op>` a consumer (query hook, MCP handler) imports, by looking up\n * the registered contract client plugin's resolver and output. Works for any contract client plugin\n * (plugin-fetch, plugin-axios, or plugin-client). Returns `null` when no contract plugin is in play (the inline\n * path), or when the client plugin's `exclude` / `include` leaves this operation out, since it then\n * emits no `<op>` to import. plugin-fetch / plugin-axios inject `.kubb/client.ts` at the global\n * output root, the same path consumers read `RequestConfig` / `ResponseErrorConfig` from.\n * With plugin-client they come from the user's `importPath` module instead.\n *\n * The result is cached in `memo` (the build's `ctx.memo`) under the client plugin's name and the operation,\n * so several dependents reading the same client plugin for one operation in a single pass\n * (react-query's query/mutation/infinite generators, vue-query, swr, the MCP handler, ...) share\n * one computed result instead of each re-deriving the name and path.\n *\n * `returnType`, `output`, and `group` are the client plugin's options for this operation, after its\n * `override` entries, the same resolution its own generator sees. A dependent's generated call body\n * and import path therefore match the `<op>` actually emitted, even when an `override` changes it.\n */\nexport function resolveClientOperation(options: {\n clientPlugin: { pluginName: string } | null\n driver: {\n getPlugin: (name: string) => { options?: ClientPluginOptions } | undefined\n getResolver: (name: string) => Resolver\n }\n node: ast.OperationNode\n root: string\n output: Output\n memo: Memo\n}): ClientOperation | null {\n const { clientPlugin, driver, node, root, output, memo } = options\n if (!clientPlugin) return null\n\n return memo(`${clientPlugin.pluginName}:clientOperation:${node.operationId}`, () => {\n const resolver = driver.getResolver(clientPlugin.pluginName)\n const pluginOptions = driver.getPlugin(clientPlugin.pluginName)?.options ?? {}\n const { exclude, include, override } = pluginOptions\n const hasOperationOptions = Boolean(exclude?.length || include?.length || override?.length)\n // Kubb's resolver always has `default`; the fallback keeps partial or custom resolvers working.\n const operationOptions =\n hasOperationOptions && resolver.default ? resolver.default.options(node, { options: pluginOptions, exclude, include, override }) : pluginOptions\n if (!operationOptions) return null\n\n const file = resolver.file({\n ...operationFileEntry(node, node.operationId),\n root,\n output: operationOptions.output ?? output,\n group: operationOptions.group ?? undefined,\n })\n\n const { importPath } = operationOptions\n const name = resolver.name(node.operationId)\n\n return {\n name: resolver.resolveName({ key: operationKey(node), name }),\n path: file.path,\n clientPath: importPath === undefined ? path.resolve(root, '.kubb/client.ts') : resolveImportPath({ importPath, operationFile: file.path }),\n clientPathIsFile: importPath === undefined || isRelativeImport(importPath),\n returnType: operationOptions.returnType ?? 'full',\n typedHeaders: importPath === undefined,\n }\n })\n}\n","import { type ast, Diagnostics, type GeneratorContext, type Group, type Output } from '@kubb/kit'\nimport { pluginTsName, type ResolverTs } from '@kubb/plugin-ts'\nimport type { PluginZod, ResolverZod } from '@kubb/plugin-zod'\n\n// A type-only import: the query plugins bundle this file but do not depend on @kubb/plugin-zod.\nconst pluginZodName = 'plugin-zod' satisfies PluginZod['name']\n\ntype GeneratorDriver = GeneratorContext['driver']\n\n/**\n * The per-operation type names a generated client references: the grouped input, the per-status\n * responses record its `RequestResult` is keyed on, and the headers each response declares.\n */\nexport type OperationTypeNames = {\n response: {\n /**\n * Resolves the name of the operation's grouped `{ body, path, query, headers, cookies }` input type.\n */\n options(node: ast.OperationNode): string\n /**\n * Resolves the name of the operation's per-status responses record type.\n */\n responses(node: ast.OperationNode): string\n /**\n * Resolves the name of the type of the headers one response declares. Left out, results keep untyped headers.\n */\n headers?(node: ast.OperationNode, statusCode: ast.StatusCode): string\n }\n}\n\nfunction getResponseHeadersEntries({ node, types }: { node: ast.OperationNode; types: OperationTypeNames }): Array<[ast.StatusCode, string]> {\n const resolve = types.response.headers\n if (!resolve) return []\n return node.responses\n .filter((response) => response.headers?.length)\n .map((response) => [response.statusCode, resolve.call(types.response, node, response.statusCode)])\n}\n\n/**\n * The headers type argument of `RequestResult`, such as `{ '200': LoginUserStatus200Headers }`, or `null` when no response declares headers.\n */\nexport function buildResponseHeadersType({ node, types }: { node: ast.OperationNode; types: OperationTypeNames }): string | null {\n const entries = getResponseHeadersEntries({ node, types }).map(([statusCode, name]) => `'${statusCode}': ${name}`)\n return entries.length ? `{ ${entries.join('; ')} }` : null\n}\n\n/**\n * A runtime result type, such as `RequestResult`, in its `WithHeaders` form when `headers` is set.\n */\nexport function resultTypeName(name: string, headers: boolean): string {\n return headers ? `${name}WithHeaders` : name\n}\n\n/**\n * A runtime result type with its arguments, such as `RequestResultWithHeaders<Responses, Headers, ThrowOnError>`.\n */\nexport function buildResultTypeRef(name: string, responses: string, headers: string | null, rest: Array<string | null> = []): string {\n return `${resultTypeName(name, headers !== null)}<${[responses, headers, ...rest].filter(Boolean).join(', ')}>`\n}\n\n/**\n * The names of the headers types `buildResponseHeadersType` references, for the file's imports.\n */\nexport function getResponseHeadersTypeNames({ node, types }: { node: ast.OperationNode; types: OperationTypeNames }): Array<string> {\n return getResponseHeadersEntries({ node, types }).map(([, name]) => name)\n}\n\n/**\n * Where a generated client sources its operation types, plus the resolver and output the file\n * declaring them is resolved with.\n */\nexport type OperationTypeSource = OperationTypeNames & {\n /**\n * `plugin-ts` shaped resolver of the plugin supplying the names, also used to resolve the file they are exported from.\n */\n resolver: ResolverTs\n /**\n * The supplying plugin's own `output`, when it configured one.\n */\n output: Output | undefined\n /**\n * The supplying plugin's own `group`, when it configured one.\n */\n group: Group | undefined\n}\n\n/**\n * A `plugin-ts` shaped resolver whose operation type names point at the types `pluginZod({ inferred })`\n * exports next to each schema, so code written against `plugin-ts` names picks up the zod types.\n */\nfunction toZodTypeResolver(resolver: ResolverZod): ResolverTs {\n const type = (name: string) => resolver.schema.type(name)\n\n return {\n ...resolver,\n // Class methods, so a spread drops them. `file` reads private fields, and `memo` gets its own key\n // space so these type names never share an entry with the zod names.\n file: resolver.file.bind(resolver),\n memo: (key: string, compute: () => unknown) => resolver.memo(`zodTypes:${key}`, compute),\n param: {\n name: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.name(node, p)),\n path: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.path(node, p)),\n query: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.query(node, p)),\n headers: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.headers(node, p)),\n cookies: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.cookies(node, p)),\n },\n response: {\n body: (node: ast.OperationNode) => type(resolver.response.body(node)),\n status: (node: ast.OperationNode, statusCode: ast.StatusCode) => type(resolver.response.status(node, statusCode)),\n response: (node: ast.OperationNode) => type(resolver.response.response(node)),\n responses: (node: ast.OperationNode) => type(resolver.response.responses(node)),\n headers: (node: ast.OperationNode, statusCode: ast.StatusCode) => type(resolver.response.headers(node, statusCode)),\n options: (node: ast.OperationNode) => resolver.response.options(node),\n },\n } as unknown as ResolverTs\n}\n\n/**\n * Picks the plugin generated clients, query hooks, and MCP handlers take their operation types from.\n *\n * `pluginZod({ inferred: 'codec' })` wins, so a codec param takes its domain value. Otherwise `plugin-ts`\n * wins when it is in the pipeline, and without it any `pluginZod({ inferred })`. Throws\n * `KUBB_MISSING_DEPENDENCY` for `pluginName` when neither is available.\n *\n * @example\n * ```ts\n * const types = resolveOperationTypes(ctx.driver, ctx.plugin.name)\n * types.response.options(node) // 'GetPetByIdOptions', or 'GetPetByIdOptionsSchemaType' from zod\n * ```\n */\nexport function resolveOperationTypes(driver: GeneratorDriver, pluginName: string): OperationTypeSource {\n return driver.memo(`operationTypes:${pluginName}`, () => {\n const pluginTs = driver.getPlugin(pluginTsName)\n const pluginZod = driver.getPlugin(pluginZodName)\n\n if (pluginTs && pluginZod?.options?.inferred !== 'codec') {\n const resolver = driver.getResolver(pluginTsName)\n return { response: resolver.response, resolver, output: pluginTs.options?.output, group: pluginTs.options?.group ?? undefined }\n }\n\n if (!pluginZod?.options?.inferred) {\n throw new Diagnostics.Error({\n code: Diagnostics.code.missingDependency,\n severity: 'error',\n message: `Plugin \"${pluginName}\" has no source for operation types.`,\n help: `Add \\`pluginTs()\\` before \"${pluginName}\", or add \\`pluginZod({ inferred: true })\\`.`,\n location: { kind: 'config' },\n plugin: pluginName,\n })\n }\n\n const resolver = toZodTypeResolver(driver.getResolver(pluginZodName))\n return { response: resolver.response, resolver, output: pluginZod.options.output, group: pluginZod.options.group ?? undefined }\n })\n}\n\ndeclare global {\n namespace Kubb {\n interface MemoRegistry {\n operationTypes: OperationTypeSource\n /**\n * Nests every key the zod-backed `ResolverTs` memoizes, so it holds each of their value types.\n */\n zodTypes: unknown\n }\n }\n}\n","import { resolveClientOperation, resolveOperationTypes } from '@internals/client'\nimport { hasStreamVariant, isEventStream, operationFileEntry, resolveOperationFile } from '@internals/shared'\nimport { ast, defineGenerator } from '@kubb/kit'\nimport { File, jsxRenderer } from '@kubb/renderer-jsx'\nimport { McpHandler } from '../components/McpHandler.tsx'\nimport type { PluginMcp } from '../types.ts'\n\n/**\n * Built-in operation generator for `@kubb/plugin-mcp`. Emits one MCP tool\n * handler per OpenAPI operation. The handler takes the grouped `{ path, query,\n * headers, body }` config and forwards it to the registered client plugin's\n * (`@kubb/plugin-axios` / `@kubb/plugin-fetch`) `<op>` function.\n */\nexport const mcpGenerator = defineGenerator<PluginMcp>({\n name: 'mcp',\n renderer: jsxRenderer,\n operation(node, ctx) {\n if (!ast.http.isOperation(node)) return null\n // A stream has no single JSON body to return as tool output, like the query plugins skip it.\n if (isEventStream(node) || hasStreamVariant(node)) return null\n const { resolver, driver, root, config } = ctx\n const { output, client, group } = ctx.options\n\n const types = resolveOperationTypes(driver, resolver.pluginName)\n const tsResolver = types.resolver\n\n // The registered contract client plugin owns the `<op>` the handler imports and calls.\n const contractOp = resolveClientOperation({ clientPlugin: { pluginName: client.pluginName }, driver, node, root, output, memo: ctx.memo })\n if (!contractOp) {\n return null\n }\n\n // The handler signature references the grouped `<Name>Options`.\n const optionsName = tsResolver.response.options(node)\n\n const meta = {\n name: resolver.handler.name(node),\n file: resolver.file({ ...operationFileEntry(node, node.operationId), root, output, group: group ?? undefined }),\n fileTs: resolveOperationFile({\n ctx,\n node,\n resolver: tsResolver,\n root,\n output: types.output ?? output,\n group: types.group,\n }),\n } as const\n\n return (\n <File\n baseName={meta.file.baseName}\n path={meta.file.path}\n meta={meta.file.meta}\n banner={resolver.default.banner(ctx.meta, { output, config, file: { path: meta.file.path, baseName: meta.file.baseName } })}\n footer={resolver.default.footer(ctx.meta, { output, config, file: { path: meta.file.path, baseName: meta.file.baseName } })}\n >\n {meta.fileTs && optionsName && <File.Import name={[optionsName]} root={meta.file.path} path={meta.fileTs.path} isTypeOnly />}\n <File.Import name={['CallToolResult', 'ServerContext']} path={'@modelcontextprotocol/server'} isTypeOnly />\n\n <File.Import name={[contractOp.name]} root={meta.file.path} path={contractOp.path} />\n\n <McpHandler name={meta.name} clientName={contractOp.name} node={node} resolver={tsResolver} returnType={contractOp.returnType} />\n </File>\n )\n },\n})\n","import path from 'node:path'\nimport { hasStreamVariant, isEventStream, operationFileEntry, resolveOperationFile } from '@internals/shared'\nimport { getRelativePath } from '@internals/utils'\nimport { ast, defineGenerator } from '@kubb/kit'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { File, jsxRenderer } from '@kubb/renderer-jsx'\nimport { Server } from '../components/Server.tsx'\nimport type { PluginMcp } from '../types.ts'\n\n/**\n * Default v5 server generator for `@kubb/plugin-mcp`.\n *\n * Uses individual zod schemas for each param (e.g. `createPetsPathUuidSchema`, `createPetsQueryOffsetSchema`)\n * and `resolveResponseStatusName` for per-status response schemas.\n * Query and header params are composed into `z.object({ ... })` from individual schemas.\n */\nexport const serverGenerator = defineGenerator<PluginMcp>({\n name: 'operations',\n renderer: jsxRenderer,\n operations(nodes, ctx) {\n const { config, resolver, plugin, driver, root } = ctx\n const { output, group } = ctx.options\n\n const pluginZod = ctx.requirePlugin(pluginZodName)\n\n const zodResolver = driver.getResolver(pluginZodName)\n\n const fileAt = <TName extends `${string}.${string}`>(baseName: TName) => ({\n baseName,\n path: path.resolve(root, output.path, baseName),\n meta: { pluginName: plugin.name },\n })\n const serverFile = fileAt('server.ts')\n const startFile = fileAt('start.ts')\n const jsonFile = fileAt('.mcp.json')\n\n // MCP clients spawn the command from their own working directory, usually the project root,\n // so `args` points at `start.ts` relative to `config.root` instead of the `.mcp.json` folder.\n const mcpConfig = {\n mcpServers: {\n [ctx.meta.title || 'server']: {\n type: 'stdio',\n command: 'npx',\n args: ['tsx', getRelativePath(path.resolve(config.root), startFile.path)],\n },\n },\n }\n\n // `mcpGenerator` emits no handler for a stream operation, so it gets no tool either.\n const operationsMapped = nodes\n .filter(ast.http.isOperation)\n .filter((node) => !isEventStream(node) && !hasStreamVariant(node))\n .map((node) => {\n const { path: pathParams, query: queryParams, header: headerParams, cookie: cookieParams } = ast.http.groupParameters(node)\n\n const mcpFile = resolver.file({ ...operationFileEntry(node, node.operationId), root, output, group: group ?? undefined })\n const zodFile = resolveOperationFile({\n ctx,\n node,\n resolver: zodResolver,\n root,\n output: pluginZod.options?.output ?? output,\n group: pluginZod.options?.group ?? undefined,\n })\n\n const requestName = ast.http.requestBody.getSchema(node) ? zodResolver.response.body(node) : null\n const successStatus = ast.http.responses.findPrimary(node)?.statusCode\n const responseName = successStatus ? zodResolver.response.status(node, successStatus) : null\n\n const resolveParams = (params: typeof pathParams) => params.map((p) => ({ name: p.name, schemaName: zodResolver.param.name(node, p) }))\n const resolveOptional = (params: typeof pathParams) => (params.length ? resolveParams(params) : null)\n\n return {\n tool: {\n name: node.operationId,\n title: node.summary || undefined,\n description: node.description || `Make a ${node.method.toUpperCase()} request to ${node.path}`,\n },\n mcp: {\n name: resolver.handler.name(node),\n file: mcpFile,\n },\n zod: {\n pathParams: resolveParams(pathParams),\n queryParams: resolveOptional(queryParams),\n headerParams: resolveOptional(headerParams),\n cookieParams: resolveOptional(cookieParams),\n requestName,\n responseName,\n file: zodFile,\n },\n }\n })\n\n const imports = operationsMapped.flatMap(({ mcp, zod }) => {\n const zodNames = [\n ...zod.pathParams.map((p) => p.schemaName),\n ...(typeof zod.queryParams === 'string' ? [zod.queryParams] : (zod.queryParams ?? []).map((p) => p.schemaName)),\n ...(zod.headerParams ?? []).map((p) => p.schemaName),\n ...(zod.cookieParams ?? []).map((p) => p.schemaName),\n zod.requestName,\n zod.responseName,\n ].filter((name): name is string => Boolean(name))\n\n const uniqueNames = [...new Set(zodNames)].sort()\n\n return [\n <File.Import key={mcp.name} name={[mcp.name]} root={serverFile.path} path={mcp.file.path} />,\n uniqueNames.length > 0 && <File.Import key={`zod-${mcp.name}`} name={uniqueNames} root={serverFile.path} path={zod.file.path} />,\n ].filter(Boolean)\n })\n\n return (\n <>\n <File\n baseName={serverFile.baseName}\n path={serverFile.path}\n meta={serverFile.meta}\n banner={resolver.default.banner(ctx.meta, { output, config, file: { path: serverFile.path, baseName: serverFile.baseName } })}\n footer={resolver.default.footer(ctx.meta, { output, config, file: { path: serverFile.path, baseName: serverFile.baseName } })}\n >\n <File.Import name={['McpServer']} path={'@modelcontextprotocol/server'} />\n <File.Import name={['serveStdio']} path={'@modelcontextprotocol/server/stdio'} />\n <File.Import name={['z']} path={'zod'} />\n\n {imports}\n <Server serverName={ctx.meta.title ?? 'server'} serverVersion={ctx.meta.version ?? '0.0.0'} operations={operationsMapped} />\n </File>\n\n <File\n baseName={startFile.baseName}\n path={startFile.path}\n meta={startFile.meta}\n banner={resolver.default.banner(ctx.meta, { output, config, file: { path: startFile.path, baseName: startFile.baseName } })}\n footer={resolver.default.footer(ctx.meta, { output, config, file: { path: startFile.path, baseName: startFile.baseName } })}\n >\n <File.Import name={['startServer']} root={startFile.path} path={serverFile.path} />\n {/* Not indexable: barrels must not re-export this entry, importing it starts the server. */}\n <File.Source name=\"start\">{'void startServer()'}</File.Source>\n </File>\n\n <File baseName={jsonFile.baseName} path={jsonFile.path} meta={jsonFile.meta}>\n <File.Source name=\"server\">{`${JSON.stringify(mcpConfig, null, 2)}\\n`}</File.Source>\n </File>\n </>\n )\n },\n})\n","","","import { operationKey } from '@internals/shared'\nimport { casing, createResolver } from '@kubb/kit'\nimport type { PluginMcp } from '../types.ts'\n\n/**\n * Default resolver used by `@kubb/plugin-mcp`. Decides the names and file\n * paths for every generated MCP tool handler. Function names get a `Handler`\n * suffix so an operation `addPet` becomes `addPetHandler`.\n *\n * @example Resolve a handler name\n * ```ts\n * import { resolverMcp } from '@kubb/plugin-mcp'\n *\n * resolverMcp.name('addPet') // 'addPetHandler'\n * ```\n */\nexport const resolverMcp = createResolver<PluginMcp>({\n pluginName: 'plugin-mcp',\n name(name) {\n return this.memo(`name:${name}`, () => casing.camel(name, { suffix: 'handler' }))\n },\n handler: {\n name(node) {\n const name = this.name(node.operationId)\n return this.resolveName({ key: operationKey(node, 'handler', 'name'), name })\n },\n },\n})\n","import { resolveContractClient } from '@internals/client'\nimport { addGenerator, defineExtension, Resolver, setMacros, setResolver, useConfig } from '@kubb/kit'\nimport { compatibility } from '../kubb-extension.json'\nimport { version } from '../package.json'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mcpGenerator } from './generators/mcpGenerator.tsx'\nimport { serverGenerator } from './generators/serverGenerator.tsx'\nimport { resolverMcp } from './resolvers/resolverMcp.ts'\nimport type { PluginMcp, ResolverMcp } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-mcp`. Used for driver lookups and\n * cross-plugin dependency references.\n */\nexport const pluginMcpName = 'plugin-mcp' satisfies PluginMcp['name']\n\n/**\n * Generates a Model Context Protocol (MCP) server from an OpenAPI spec. Every\n * operation becomes a typed MCP tool that AI assistants (Claude Desktop, Claude\n * Code, MCP-compatible clients) can call directly. Each handler calls a contract\n * client `<op>` from a registered `@kubb/plugin-axios` or `@kubb/plugin-fetch`.\n * Next to the handlers it writes `server.ts`, a `start.ts` entry that serves the\n * tools over stdio, and a `.mcp.json` that runs `start.ts` with `tsx`.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb/config'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginZod } from '@kubb/plugin-zod'\n * import { pluginFetch } from '@kubb/plugin-fetch'\n * import { pluginMcp } from '@kubb/plugin-mcp'\n *\n * export default defineConfig({\n * input: './petStore.yaml',\n * output: { path: './src/gen' },\n * plugins: [\n * pluginTs(),\n * pluginZod(),\n * pluginFetch({ baseURL: 'https://petstore.swagger.io/v2' }),\n * pluginMcp({ output: { path: 'mcp' } }),\n * ],\n * })\n * ```\n */\nexport const pluginMcp = defineExtension<PluginMcp>({\n kind: 'plugin',\n meta: { name: pluginMcpName, version, compatibility },\n dependencies: { [pluginTsName]: { optional: true }, [pluginZodName]: {} },\n setup(options) {\n const {\n output = { path: 'mcp', barrel: { type: 'named' } },\n group,\n exclude = [],\n include,\n override = [],\n client,\n resolver: userResolver,\n macros: userMacros,\n } = options\n\n const resolver = userResolver ? Resolver.merge<ResolverMcp>(resolverMcp, userResolver) : resolverMcp\n\n setResolver(resolver)\n if (userMacros?.length) {\n setMacros(userMacros)\n }\n addGenerator(mcpGenerator, serverGenerator)\n\n return {\n output,\n exclude,\n include,\n override,\n group: group ?? null,\n client: resolveContractClient({ plugin: pluginMcpName, client, plugins: useConfig().plugins }),\n resolver,\n }\n },\n})\n\nexport default pluginMcp\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.cjs","names":["posix","ast","File","Function","File","Function","text","Const","Diagnostics","path","pluginZodName","pluginTsName","Diagnostics","defineGenerator","jsxRenderer","ast","File","defineGenerator","jsxRenderer","pluginZodName","path","ast","File","createResolver","casing","defineExtension","pluginTsName","pluginZodName","Resolver","useConfig"],"sources":["../../../internals/utils/src/fs.ts","../../../internals/utils/src/strings.ts","../../../internals/shared/src/operation.ts","../../../internals/shared/src/resolver.ts","../src/components/McpHandler.tsx","../src/components/Server.tsx","../../../internals/client/src/resolveClient.ts","../../../internals/client/src/resolveClientOperation.ts","../../../internals/client/src/resolveOperationTypes.ts","../src/generators/mcpGenerator.tsx","../src/generators/serverGenerator.tsx","../kubb-extension.json","../package.json","../src/resolvers/resolverMcp.ts","../src/plugin.ts"],"sourcesContent":["import { posix } from 'node:path'\nimport { casing } from '@kubb/kit'\nfunction toSlash(p: string): string {\n if (p.startsWith('\\\\\\\\?\\\\')) return p\n return p.replaceAll('\\\\', '/')\n}\n\n/**\n * Returns the relative path from `rootDir` to `filePath`, always using forward slashes\n * and prefixed with `./` when not already traversing upward.\n *\n * @example\n * ```ts\n * getRelativePath('/src/components', '/src/components/Button.tsx') // './Button.tsx'\n * getRelativePath('/src/components', '/src/utils/helpers.ts') // '../utils/helpers.ts'\n * ```\n */\nexport function getRelativePath(rootDir: string, filePath: string): string {\n const relativePath = posix.relative(toSlash(rootDir), toSlash(filePath))\n\n return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Builds a nested file path from a dotted name. Splits on dots that precede a letter\n * (so version numbers embedded in operationIds like `v2025.0` stay intact), camelCases\n * every earlier segment, applies `caseLast` to the final segment, and joins with `/`.\n *\n * Empty segments are dropped before joining. They arise when the name starts with a dot\n * followed by a letter (e.g. `..Schema` splits into `['..', 'Schema']` and `'..'` cases to\n * an empty string). Without this a leading `/` would form, which `path.resolve` reads as an\n * absolute path, letting generated files escape the configured output directory.\n *\n * @example Nested path from a dotted name\n * `toFilePath('pet.petId') // 'pet/petId'`\n *\n * @example PascalCase the final segment\n * `toFilePath('pet.Pet', pascalCase) // 'pet/Pet'`\n *\n * @example Suffix applied to the final segment only\n * `toFilePath('tag.tag', (part) => camelCase(part, { suffix: 'schema' })) // 'tag/tagSchema'`\n */\nexport function toFilePath(name: string, caseLast: (part: string) => string = casing.camel): string {\n const parts = name.split(/\\.(?=[a-zA-Z])/)\n return parts\n .map((part, i) => (i === parts.length - 1 ? caseLast(part) : casing.camel(part)))\n .filter(Boolean)\n .join('/')\n}\n","import { text } from '@kubb/kit'\n\n// `\\p{`, `\\P{` or `\\u{` behind an odd number of backslashes, or a character outside the BMP: both need the `u` flag.\nconst NEEDS_UNICODE = /(?<!\\\\)(?:\\\\\\\\)*\\\\[pPu]\\{|[\\u{10000}-\\u{10FFFF}]/u\n// Escapes the `u` flag accepts. `\\-` only counts inside a class.\nconst KEPT_ESCAPE = /[A-Za-z0-9^$\\\\.*+?()[\\]{}|/]/\n\n/**\n * Drops the backslash from escapes that the `u` flag rejects: an escaped punctuation character that is\n * not a syntax character, and `\\-` outside a class. Both match the same character without the backslash.\n */\nfunction dropIdentityEscapes(pattern: string): string {\n let inClass = false\n\n return pattern.replace(/\\\\(.)|[[\\]]/gs, (match, escaped?: string) => {\n if (escaped === undefined) {\n inClass = match === '['\n return match\n }\n\n return KEPT_ESCAPE.test(escaped) || (escaped === '-' && inClass) ? match : escaped\n })\n}\n\n/**\n * Builds the `RegExp` for a pattern, adding the `u` flag when it uses `\\p{...}`, `\\P{...}` or `\\u{...}`, or\n * holds a character outside the BMP. A pattern that is not valid under `u` keeps the flags it came with.\n */\nfunction toRegExp(pattern: string, flags: string | undefined): RegExp {\n if (flags?.includes('u') || !NEEDS_UNICODE.test(pattern)) return new RegExp(pattern, flags)\n\n try {\n return new RegExp(dropIdentityEscapes(pattern), `${flags ?? ''}u`)\n } catch {\n return new RegExp(pattern, flags)\n }\n}\n\n/**\n * Converts a pattern string into a `new RegExp(...)` constructor call or a regex literal string.\n * Inline flags expressed as a `^(?im)` prefix are extracted and applied to the resulting expression.\n * Pass `null` as the second argument to emit a `/pattern/flags` literal instead.\n *\n * @example\n * ```ts\n * toRegExpString('^(?im)foo') // 'new RegExp(\"^foo\", \"im\")'\n * toRegExpString('^(?im)foo', null) // '/^foo/im'\n * ```\n */\nexport function toRegExpString(pattern: string, func: string | null = 'RegExp'): string {\n const raw = text.unquote(pattern)\n\n const match = raw.match(/^\\^(\\(\\?([igmsuy]+)\\))/i)\n const replacementTarget = match?.[1] ?? ''\n const matchedFlags = match?.[2]\n const cleaned = raw\n .replace(/^\\\\?\\//, '')\n .replace(/\\\\?\\/$/, '')\n .replace(replacementTarget, '')\n\n const { source, flags } = toRegExp(cleaned, matchedFlags)\n\n if (func === null) return `/${source}/${flags}`\n\n return `new ${func}(${JSON.stringify(source)}${flags ? `, ${JSON.stringify(flags)}` : ''})`\n}\n\n/**\n * Renders a dotted path or string array as an optional-chaining accessor expression rooted at\n * `accessor`. Returns `null` for an empty path.\n *\n * @example\n * ```ts\n * getNestedAccessor('pagination.next.id', 'lastPage')\n * // \"lastPage?.['pagination']?.['next']?.['id']\"\n * ```\n */\nexport function getNestedAccessor(param: string | Array<string>, accessor: string): string | null {\n const parts = Array.isArray(param) ? param : param.split('.')\n if (parts.length === 0 || (parts.length === 1 && parts[0] === '')) return null\n return `${accessor}?.['${`${parts.join(\"']?.['\")}']`}`\n}\n\n/**\n * Escapes an `@` at the start of a line, so a multi-line description can't start a new JSDoc tag.\n * Editors render `\\@` as `@` in hovers.\n *\n * @example\n * ```ts\n * jsDocEscape('intro\\n@example value') // 'intro\\n\\\\@example value'\n * ```\n */\nexport function jsDocEscape(input: unknown): string {\n return `${input}`.replace(/^(\\s*)@/gm, '$1\\\\@')\n}\n","import { jsDocEscape } from '@internals/utils'\nimport { ast, type Group, type Memo, type Output, type Resolver, type ResolverFileParams } from '@kubb/kit'\n\n/**\n * Builds the `ResolverFileParams` every operation generator passes to\n * `resolver.file`: a file named `name`, tagged by the operation's first\n * tag (or `'default'`), at the operation's path. Centralizes the entry object\n * that was repeated at dozens of call sites across the client and query plugins.\n *\n * @example\n * ```ts\n * resolver.file(operationFileEntry(node, node.operationId), { root, output, group })\n * ```\n */\nexport function operationFileEntry(node: ast.OperationNode, name: string, extname: ResolverFileParams['extname'] = '.ts'): ResolverFileParams {\n return {\n name,\n extname,\n tag: node.tags[0] ?? 'default',\n path: node.path,\n }\n}\n\n/**\n * Resolves the file a schema-emitting plugin (`plugin-ts`, `plugin-zod`, `plugin-faker`) writes\n * `node` to, cached in `ctx.memo` under the resolver's plugin name and the\n * operation. The plugin itself and every plugin that imports from it call this, so they all get\n * the same path.\n *\n * When that path matches the file of a component schema in `ctx.driver.inputNode`, ignoring case, the file name\n * gets an `Operation` suffix: operation `point` goes to `PointOperation.ts` next to schema `Point.ts`.\n * Otherwise the two merge into one file, or overwrite each other on a case-insensitive file system.\n * Only the file name changes. The declarations keep their names.\n *\n * @example Resolve `plugin-ts`'s file for the current operation\n * ```ts\n * const fileTs = resolveOperationFile({ ctx, node, resolver: tsResolver, root, output })\n * ```\n */\nexport function resolveOperationFile(options: {\n ctx: { memo: Memo; driver: { inputNode?: { schemas: ReadonlyArray<ast.SchemaNode> } | null } }\n node: ast.OperationNode\n resolver: Pick<Resolver, 'file' | 'pluginName'>\n root: string\n output: Output\n group?: Group | null\n}): ast.FileNode {\n const { ctx, node, resolver, root, output } = options\n const { memo } = ctx\n const location = { root, output, group: options.group ?? undefined }\n\n return memo(`${resolver.pluginName}:operationFile:${node.operationId}`, () => {\n const schemaPaths = memo(\n `${resolver.pluginName}:schemaFilePaths`,\n () =>\n new Set(\n (ctx.driver.inputNode?.schemas ?? []).flatMap((schema) =>\n schema.name ? [resolver.file({ name: schema.name, extname: '.ts', ...location }).path.toLowerCase()] : [],\n ),\n ),\n )\n let file = resolver.file({ ...operationFileEntry(node, node.operationId), ...location })\n\n for (let name = `${node.operationId}Operation`; schemaPaths.has(file.path.toLowerCase()); name += 'Operation') {\n const next = resolver.file({ ...operationFileEntry(node, name), ...location })\n // A single-file output holds every declaration on purpose, so a new name changes nothing.\n if (next.path === file.path) break\n file = next\n }\n\n return file\n })\n}\n\nexport type ContentTypeInfo = {\n contentTypes: string[]\n isMultipleContentTypes: boolean\n contentTypeUnion: string\n defaultContentType: string\n hasFormData: boolean\n}\n\nexport type RequestConfigResolver = {\n response: {\n body(node: ast.OperationNode): string\n }\n}\n\nexport type ResponseStatusNameResolver = {\n response: {\n status(node: ast.OperationNode, statusCode: ast.StatusCode): string\n }\n}\n\nexport type ResponseNameResolver = ResponseStatusNameResolver & {\n response: {\n response(node: ast.OperationNode): string\n }\n}\n\nexport type OperationTypeNameResolver = RequestConfigResolver &\n ResponseNameResolver & {\n param: {\n path(node: ast.OperationNode, param: ast.ParameterNode): string\n query(node: ast.OperationNode, param: ast.ParameterNode): string\n headers(node: ast.OperationNode, param: ast.ParameterNode): string\n cookies(node: ast.OperationNode, param: ast.ParameterNode): string\n }\n }\n\nexport type BuildOperationCommentsOptions = {\n splitLines?: boolean\n}\n\nexport type ResolveOperationTypeNameOptions = {\n responseStatusNames?: boolean | 'error'\n exclude?: ReadonlyArray<string | undefined>\n order?: 'params-first' | 'body-response-first'\n /**\n * Include the individual `Path`/`Query`/`Headers` group type names. Set to `false` for clients\n * that reference the grouped `Options` type instead of the per-group types.\n */\n includeParams?: boolean\n}\n\n/**\n * The operation's method and path as plain text, such as `` `GET /pet/{petId}` ``. A path is not a valid `{@link}` target.\n */\nfunction getOperationRequestLine(node: ast.OperationNode): string | null {\n return ast.http.isOperation(node) && node.path ? `\\`${node.method.toUpperCase()} ${node.path}\\`` : null\n}\n\n/**\n * Derives the shared `ContentTypeInfo` shape from a list of content types, tracking whether several\n * are present and the union, default, and form-data flags the client uses to pick one.\n */\nfunction buildContentTypeInfo(contentTypes: string[]): ContentTypeInfo {\n const isMultipleContentTypes = contentTypes.length > 1\n\n return {\n contentTypes,\n isMultipleContentTypes,\n contentTypeUnion: isMultipleContentTypes ? contentTypes.map((ct) => JSON.stringify(ct)).join(' | ') : '',\n defaultContentType: contentTypes[0] ?? 'application/json',\n hasFormData: contentTypes.some((ct) => ct === 'multipart/form-data'),\n }\n}\n\nexport function getContentTypeInfo(node: ast.OperationNode): ContentTypeInfo {\n return buildContentTypeInfo(node.requestBody?.content?.map((e) => e.contentType) ?? [])\n}\n\n/**\n * The request-body counterpart for the primary success response: the content types it documents and\n * whether several are present, so the client can let a caller pick which one to accept.\n */\nexport function getResponseContentTypeInfo(node: ast.OperationNode): ContentTypeInfo {\n return buildContentTypeInfo(ast.http.responses.findPrimary(node)?.content?.map((e) => e.contentType) ?? [])\n}\n\ntype ResponseType = 'blob' | 'text' | 'stream'\n\ntype ResponseContentEntry = { contentType: string; schema?: ast.SchemaNode | null; stream?: ast.ContentNode['stream'] }\n\n/**\n * How an operation streams its primary success response item by item, when that response declares one content type:\n * - `'event'` for `text/event-stream` whose `itemSchema` types the whole event with its own `event` and `data`\n * - `'data'` for `text/event-stream` typed by its payload only\n * - `'line'` for JSON Lines, one parsed JSON value per line\n *\n * Returns `null` for any other response, and for a response that also declares another content type, which stays a normal\n * call with its query hooks.\n */\nexport function getEventStream(node: ast.OperationNode): 'event' | 'data' | 'line' | null {\n const content = ast.http.responses.findPrimary(node)?.content ?? []\n if (content.length !== 1) return null\n const entry = content[0]!\n const framing = getStreamFraming(entry)\n if (framing === 'events') return entry.stream?.shape ?? 'data'\n return framing === 'lines' ? 'line' : null\n}\n\n/**\n * How a content entry is framed as a stream: `'events'` for Server-Sent Events, `'lines'` for JSON Lines.\n */\nexport function getStreamFraming(entry: Pick<ast.ContentNode, 'contentType' | 'stream'>): 'events' | 'lines' | undefined {\n if (ast.mediaType.getBase(entry) === 'text/event-stream') return 'events'\n // `multipart/mixed` with an `itemSchema` also has `stream`, but it is a stream of parts, not of JSON values.\n return entry.stream && ast.mediaType.isStream(entry) ? 'lines' : undefined\n}\n\n/**\n * Whether an operation streams its primary success response, as Server-Sent Events or JSON Lines. The client generator uses\n * this to return a typed stream of items instead of a one-shot `RequestResult`.\n */\nexport function isEventStream(node: ast.OperationNode): boolean {\n return getEventStream(node) !== null\n}\n\n// A stream without a schema is a `blob` with a string primitive, so it keeps the JSON-parse default.\nfunction isTextSchema(schema: ast.SchemaNode | null | undefined): boolean {\n if (!schema) return false\n const resolved = ast.ref.getSchema(schema)\n return resolved.type !== 'blob' && resolved.primitive === 'string'\n}\n\n/**\n * Whether an operation streams Server-Sent Events whose `data` the document types as a string, so the client keeps each\n * `data` as text instead of JSON-parsing it. With an event-shaped `itemSchema` where only some events type `data` as a\n * string, it returns the names of those events, or `false` when one of them has no fixed name.\n */\nexport function hasTextEventData(node: ast.OperationNode): boolean | Array<string> {\n const shape = getEventStream(node)\n const entry = ast.http.responses.findPrimary(node)?.content?.[0]\n if (!entry || (shape !== 'data' && shape !== 'event')) return false\n if (shape === 'data') return isTextSchema(entry.stream?.schema ?? entry.schema)\n\n const item = entry.stream?.schema ? ast.ref.getSchema(entry.stream.schema) : undefined\n if (!item) return false\n const events = item.type === 'union' ? (ast.schema.narrow(item, 'union')?.members ?? []) : [item]\n // A discriminator makes each event an intersection of its `$ref` and the pinned `event`, so every part is read.\n const propertySchemas = (event: ast.SchemaNode, propertyName: string) => ast.schema.findProperties({ node: event, propertyName }).map(({ schema }) => schema)\n const textEvents = events.filter((event) => {\n const dataSchemas = propertySchemas(event, 'data')\n return dataSchemas.length > 0 && dataSchemas.every(isTextSchema)\n })\n if (textEvents.length === events.length) return events.length > 0\n\n const eventNames = textEvents.map((event) => propertySchemas(event, 'event').flatMap((schema) => ast.schema.getLiterals(ast.ref.getSchema(schema))))\n return eventNames.length > 0 && eventNames.every((values) => values.length > 0) && [...new Set(eventNames.flat().map(String))]\n}\n\n/**\n * Whether the primary success response offers `text/event-stream`, alone or next to other content types. The client asks\n * for the stream by default and ships the `sse.ts` runtime, so a mixed response can be read as events too.\n */\nexport function hasEventStreamContent(node: ast.OperationNode): boolean {\n const entries = ast.http.responses.findPrimary(node)?.content ?? []\n // Next to another type, a stream without a schema gets no typed variant, so it keeps the plain call.\n return entries.some((entry) => getStreamFraming(entry) === 'events' && (entries.length === 1 || Boolean(entry.schema)))\n}\n\n/**\n * Whether a success response offers a stream media type next to other content types. The client returns that variant's\n * body as a `ReadableStream`, so the stream runtime is registered and a hook's data type includes the stream.\n */\nexport function hasStreamVariant(node: ast.OperationNode): boolean {\n return ast.http.responses.filterSuccess(node).some((response) => {\n const variants = (response.content ?? []).filter((entry) => entry.schema)\n return variants.length > 1 && variants.some((entry) => ast.mediaType.isStream(entry))\n })\n}\n\nconst formContentTypes = ['multipart/form-data', 'application/x-www-form-urlencoded'] as const\n\n/**\n * The form media types the operation's request body offers, `multipart/form-data` and `application/x-www-form-urlencoded`,\n * which the client needs a handler for.\n */\nexport function getFormContentTypes(node: ast.OperationNode): Array<(typeof formContentTypes)[number]> {\n const request = new Set((node.requestBody?.content ?? []).map((entry) => ast.mediaType.getBase(entry)))\n return formContentTypes.filter((contentType) => request.has(contentType))\n}\n\n/**\n * Parser for one response content entry.\n *\n * JSON stays unset so the runtime detects it. `text/event-stream` and JSON Lines are streams. A binary schema\n * (`format: binary` / `contentMediaType`) is a blob even when the media type is not a well-known\n * binary type. Other `text/*` is text, and `application/octet-stream`, `application/pdf`,\n * `image/*`, `audio/*`, and `video/*` are blobs.\n */\nfunction responseTypeForContent(entry: ResponseContentEntry): ResponseType | undefined {\n const baseType = ast.mediaType.getBase(entry)\n if (!baseType) return undefined\n if (getStreamFraming(entry)) return 'stream'\n if (ast.mediaType.isJson(baseType)) return undefined\n if (entry.schema?.type === 'blob') return 'blob'\n if (baseType.startsWith('text/')) return 'text'\n if (isBinaryContentType(baseType)) return 'blob'\n return undefined\n}\n\nfunction isBinaryContentType(baseType: string): boolean {\n return baseType === 'application/octet-stream' || baseType === 'application/pdf' || /^(image|audio|video)\\//.test(baseType)\n}\n\n/**\n * Maps a content type to the PascalCase suffix used to name per-content-type variants\n * (e.g. `application/json` → `Json`, `application/xml` → `Xml`, `multipart/form-data` → `FormData`).\n */\nfunction getContentTypeSuffix(contentType: string): string {\n // Keeps the original case, unlike ast.mediaType.getBase, so generated names stay stable.\n const baseType = contentType.split(';')[0]!.trim()\n if (baseType === 'application/json') return 'Json'\n if (baseType === 'multipart/form-data') return 'FormData'\n if (baseType === 'application/x-www-form-urlencoded') return 'FormUrlEncoded'\n const subtype = baseType.split('/').pop() ?? baseType\n const parts = subtype.split(/[^a-zA-Z0-9]+/).filter(Boolean)\n if (parts.length === 0) return 'Unknown'\n return parts.map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join('')\n}\n\n/**\n * Appends a content-type suffix to a base name, keeping a trailing `Data` segment last\n * (e.g. `AddPetData` + `Json` → `AddPetJsonData`, `AddPetStatus200` + `Xml` → `AddPetStatus200Xml`).\n */\nexport function getPerContentTypeName(baseName: string, suffix: string): string {\n if (baseName.endsWith('Data')) {\n return suffix.endsWith('Data') ? baseName.slice(0, -4) + suffix : `${baseName.slice(0, -4)}${suffix}Data`\n }\n return baseName + suffix\n}\n\nexport type ContentVariantInput = { contentType: string; schema?: ast.SchemaNode | null; keysToOmit?: Array<string> | null }\nexport type ContentVariant = { name: string; suffix: string; schema: ast.SchemaNode; keysToOmit?: Array<string> | null; contentType: string }\n\n/**\n * Returns the entry with the schema of the value the client returns: `string` for a body read as text, such as `Pet` on\n * `application/xml`, and `blob` for `image/*`, `audio/*`, `video/*`, PDF, and octet-stream. A binary schema elsewhere is a `Blob`\n * only through `parseAs: 'blob'`, which needs every entry in `entries` binary. JSON, vendor (`application/vnd.*`), stream,\n * schemaless, and wildcard entries keep their schema. `entries` is the response's full list of content types.\n */\nexport function toResponseContent<T extends ContentVariantInput & ResponseContentEntry>(entry: T, entries: ReadonlyArray<ResponseContentEntry> = [entry]): T {\n const { contentType, schema } = entry\n if (!schema || entry.stream) return entry\n\n const baseType = ast.mediaType.getBase(contentType)\n const resolved = ast.ref.getSchema(schema)\n if (isBinaryContentType(baseType)) {\n return resolved.type === 'blob' ? entry : { ...entry, schema: ast.factory.createSchema({ type: 'blob' }), keysToOmit: null }\n }\n const isPlainMediaType = Boolean(baseType) && !ast.mediaType.isJson(baseType) && !baseType.includes('*')\n if (resolved.type === 'blob') {\n // shortcut: an error response never gets `parseAs`, so a lone binary schema there reads as text too but stays `Blob`.\n const readsAsText = isPlainMediaType && !entries.every((item) => item.schema?.type === 'blob')\n return readsAsText ? { ...entry, schema: ast.factory.createSchema({ type: 'string' }), keysToOmit: null } : entry\n }\n if (resolved.primitive === 'string') return entry\n\n const responseType = responseTypeForContent(entry)\n // A response without a body, such as a 405, has no schema to read. Only `text/*` is always text.\n if (responseType !== 'text' && (resolved.type === 'unknown' || resolved.type === 'any' || resolved.type === 'void')) return entry\n const isVendorJson = /^[^/]+\\/vnd\\./.test(baseType) && !/(xml|yaml|yml|csv)$/.test(baseType)\n const isText = responseType === 'text' || (!responseType && isPlainMediaType && !isVendorJson)\n\n return isText ? { ...entry, schema: ast.factory.createSchema({ type: 'string' }), keysToOmit: null } : entry\n}\n\n/**\n * Resolves per-content-type variant names for a set of content entries, deduplicating suffix\n * collisions with a numeric counter. Entries without a schema are skipped. The returned `suffix` is\n * the final (possibly counter-augmented) value, so callers can derive parallel names in another\n * namespace (e.g. plugin-faker deriving the matching plugin-ts type name).\n */\nexport function resolveContentTypeVariants(entries: Array<ContentVariantInput>, baseName: string): Array<ContentVariant> {\n const usedNames = new Set<string>()\n return entries\n .filter((entry) => entry.schema)\n .map((entry) => {\n const baseSuffix = getContentTypeSuffix(entry.contentType)\n let suffix = baseSuffix\n let name = getPerContentTypeName(baseName, suffix)\n let counter = 2\n while (usedNames.has(name)) {\n suffix = `${baseSuffix}${counter++}`\n name = getPerContentTypeName(baseName, suffix)\n }\n usedNames.add(name)\n return { name, suffix, schema: entry.schema!, keysToOmit: entry.keysToOmit, contentType: entry.contentType }\n })\n}\n\n/**\n * Builds the `client?:` option type shared by the generated query hooks (`useQuery`,\n * `useInfiniteQuery`, `useSWR`, ...): `RequestConfig` minus what the\n * hook fills in, which is every request group and `throwOnError`. Unlike {@link buildRequestConfigType},\n * it never narrows `contentType`: query hooks wrap GET operations, which carry no request body to select\n * a content type for.\n */\nexport function buildClientOptionType(options: { omit?: Array<string> } = {}): string {\n const keys = [...requestGroupOrder, 'url', ...(options.omit ?? []), 'throwOnError']\n return `Partial<Omit<RequestConfig, ${keys.map((key) => `'${key}'`).join(' | ')}>>`\n}\n\n/**\n * The `client?:` option type of a mutation hook. When the operation has a request content type choice,\n * the mutation variables carry `contentType`, so the config leaves it out. Otherwise the ambiguous side is\n * narrowed to the operation's media types; a single-type side has nothing to pick, so it stays baked in the\n * generated call.\n */\nexport function buildRequestConfigType(node: ast.OperationNode): string {\n if (hasRequestContentTypeChoice(node)) {\n return buildClientOptionType({ omit: ['contentType'] })\n }\n\n const request = getContentTypeInfo(node)\n const response = getResponseContentTypeInfo(node)\n const members = [\n request.isMultipleContentTypes ? `request?: ${request.contentTypeUnion}` : null,\n response.isMultipleContentTypes ? `response?: ${response.contentTypeUnion}` : null,\n ].filter(Boolean)\n\n const base = buildClientOptionType()\n return members.length ? `${base} & { contentType?: { ${members.join('; ')} } }` : base\n}\n\n/** The grouped request options, in the order generated signatures and calls list them. */\nexport const requestGroupOrder = ['path', 'query', 'body', 'headers', 'cookies'] as const\n\nexport type RequestGroups = {\n path: boolean\n query: boolean\n body: boolean\n headers: boolean\n cookies: boolean\n}\n\n/**\n * Which of the grouped request options an operation carries.\n */\nexport function getRequestGroups(node: ast.OperationNode): RequestGroups {\n const { path, query, header, cookie } = ast.http.groupParameters(node)\n return {\n path: path.length > 0,\n query: query.length > 0,\n body: Boolean(ast.http.requestBody.getSchema(node)),\n headers: header.length > 0,\n cookies: cookie.length > 0,\n }\n}\n\nexport type RequestGroupOptionality = {\n groups: RequestGroups\n hasRequiredPath: boolean\n hasRequiredQuery: boolean\n hasRequiredHeader: boolean\n /**\n * Whether the grouped request parameter can default to `{}`. True only when no group carries a\n * required member, so every member is safe to omit.\n */\n isOptional: boolean\n}\n\n/**\n * Resolves which grouped request options an operation carries together with whether each group\n * holds a required member. The grouped parameter stays optional only when nothing inside it is\n * required, matching the generated `RequestConfig` type.\n */\nexport function getRequestGroupOptionality(node: ast.OperationNode): RequestGroupOptionality {\n const groups = getRequestGroups(node)\n const { path, query, header } = ast.http.groupParameters(node)\n const hasRequiredPath = path.some((param) => param.required)\n const hasRequiredQuery = query.some((param) => param.required)\n const hasRequiredHeader = header.some((param) => param.required)\n\n return {\n groups,\n hasRequiredPath,\n hasRequiredQuery,\n hasRequiredHeader,\n // `cookies` never makes the parameter required: a browser sends its cookies itself and cannot set a `Cookie` header.\n isOptional: !hasRequiredPath && !hasRequiredQuery && !hasRequiredHeader && !(groups.body && node.requestBody?.required === true),\n }\n}\n\nexport type RequestOptionsNameResolver = RequestConfigResolver & {\n response: {\n options(node: ast.OperationNode): string\n }\n}\n\n/**\n * Builds the grouped `{ path, query, body, headers, cookies }` parameter for a generated client\n * function, typed from the operation's `Options` (minus `url`). Only the groups the\n * operation actually has are destructured. The trailing `config` parameter carries the\n * runtime `RequestConfig` overrides plus `client`.\n */\nexport function buildRequestParamsSignature(\n node: ast.OperationNode,\n resolver: RequestOptionsNameResolver,\n options: { isConfigurable?: boolean } = {},\n): { signature: string; groups: RequestGroups; names: Array<keyof RequestGroups> } {\n const { isConfigurable = true } = options\n const { groups, isOptional } = getRequestGroupOptionality(node)\n\n const names = requestGroupOrder.filter((key) => groups[key])\n\n // These callers never carry the `contentType` that several media types require.\n const optionsType = hasRequestContentTypeChoice(node)\n ? `Pick<${resolver.response.options(node)}, ${names.map((name) => `'${name}'`).join(' | ')}>`\n : resolver.response.options(node)\n const firstParam = names.length > 0 ? `{ ${names.join(', ')} }: ${optionsType}${isOptional ? ' = {}' : ''}` : null\n const configParam = isConfigurable ? `config: ${buildRequestConfigType(node)} = {}` : null\n\n return {\n signature: [firstParam, configParam].filter(Boolean).join(', '),\n groups,\n names,\n }\n}\n\nexport function buildOperationComments(node: ast.OperationNode, options: BuildOperationCommentsOptions = {}): Array<string> {\n const { splitLines = false } = options\n // The request line leads: free text after a block tag would belong to that tag.\n const comments = [\n getOperationRequestLine(node),\n node.description && `@description ${node.description}`,\n node.summary && `@summary ${node.summary}`,\n node.deprecated && '@deprecated',\n node.externalDocs && `@see ${jsDocEscape([node.externalDocs.url, node.externalDocs.description].filter(Boolean).join(' '))}`,\n ]\n\n const filteredComments = comments.filter((comment): comment is string => Boolean(comment))\n\n if (!splitLines) {\n return filteredComments\n }\n\n return filteredComments.flatMap((text) => text.split(/\\r?\\n/).map((line) => line.trim())).filter((comment): comment is string => Boolean(comment))\n}\n\n/**\n * Whether the operation declares more than one request media type with a schema, so a caller must pick one on `contentType`.\n */\nexport function hasRequestContentTypeChoice(node: ast.OperationNode): boolean {\n return (node.requestBody?.content ?? []).filter((entry) => entry.schema).length > 1\n}\n\n/**\n * Casts a call argument to the client's parameter type; a `'plain'` client is non-generic.\n */\nexport function castToClientOptions(callArg: string, clientName: string, returnType: 'full' | 'data' | 'plain' = 'full'): string {\n return `${callArg} as Parameters<typeof ${clientName}${returnType === 'plain' ? '' : '<true>'}>[0]`\n}\n\n/**\n * Builds the combined `{ body, path, query, headers, cookies }` options object schema for an operation,\n * referencing the already-resolved body and grouped param names. `cookies` appears only on an operation\n * with a cookie parameter, and stays optional because a browser sends its cookies itself. Shared by `@kubb/plugin-ts`'s\n * `Options` type and `@kubb/plugin-zod`'s inferred options schema, so both printers emit the same shape from the same inputs.\n * `primitive: 'object'` is a no-op for the TS printer and tells the Zod printer to emit `z.object(…)` rather\n * than a record.\n */\nexport function buildOptionsSchema(node: ast.OperationNode, resolver: OperationTypeNameResolver, { pairContentTypes = false } = {}): ast.SchemaNode {\n const { path, query, header, cookie } = ast.http.groupParameters(node)\n const hasBody = Boolean(ast.http.requestBody.getSchema(node))\n const createNever = () => ast.factory.createSchema({ type: 'never', primitive: undefined, optional: true })\n const groups = [\n { name: 'path', params: path, resolve: resolver.param.path },\n { name: 'query', params: query, resolve: resolver.param.query },\n { name: 'headers', params: header, resolve: resolver.param.headers },\n { name: 'cookies', params: cookie, resolve: resolver.param.cookies },\n ] as const\n\n const createOptions = (body: ast.SchemaNode, extra: Array<ast.PropertyNode> = []) =>\n // NOTE(v5-stable): the fields were renamed from the legacy beta shape\n // (`data`/`pathParams`/`queryParams`/`headerParams`) to `body`/`path`/`query`/`headers` so the\n // type matches the runtime client. Drop this note once v5 leaves beta.\n ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n deprecated: node.deprecated,\n properties: [\n ast.factory.createProperty({ name: 'body', required: hasBody && node.requestBody?.required === true, schema: body }),\n ...groups\n .filter(({ name, params }) => name !== 'cookies' || params.length > 0)\n .map(({ name, params, resolve }) => {\n const required = name !== 'cookies' && params.some((param) => param.required)\n\n return ast.factory.createProperty({\n name,\n required,\n schema:\n params.length > 0\n ? ast.factory.createSchema({ type: 'ref', name: resolve.call(resolver.param, node, params[0]!), optional: !required })\n : createNever(),\n })\n }),\n ...extra,\n ],\n })\n\n const variants =\n pairContentTypes && hasRequestContentTypeChoice(node) ? resolveContentTypeVariants(node.requestBody?.content ?? [], resolver.response.body(node)) : []\n if (variants.length < 2) {\n return createOptions(hasBody ? ast.factory.createSchema({ type: 'ref', name: resolver.response.body(node) }) : createNever())\n }\n\n // The first media type is the runtime default, so only the others must pass `contentType`. A bare string sets the\n // request content type at runtime, so it is accepted next to the `{ request }` form.\n return ast.factory.createSchema({\n type: 'union',\n members: variants.map((variant, index) => {\n const contentType = ast.factory.createSchema({ type: 'enum', enumValues: [variant.contentType] })\n\n return createOptions(ast.factory.createSchema({ type: 'ref', name: variant.name }), [\n ast.factory.createProperty({\n name: 'contentType',\n required: index > 0,\n schema: ast.factory.createSchema({\n type: 'union',\n members: [\n contentType,\n ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n properties: [ast.factory.createProperty({ name: 'request', required: true, schema: contentType })],\n }),\n ],\n }),\n }),\n ])\n }),\n })\n}\n\n/**\n * The schema a status occupies in the `<Name>Responses` record. A status that documents several\n * content types becomes a `{ contentType; data }` union so the runtime can surface the negotiated type\n * on `result.parsed`, while the standalone `<Name>StatusNNN` alias stays the plain body union that the\n * query hooks and `result.data` use. With `streamData`, the stream variant of a 2xx status holds that schema, since the\n * client returns its body unread.\n */\nfunction buildResponseRecordEntry(\n node: ast.OperationNode,\n res: ast.ResponseNode,\n resolver: ResponseStatusNameResolver,\n streamData: ast.SchemaNode | undefined,\n): ast.SchemaNode {\n const statusName = resolver.response.status(node, res.statusCode)\n const variants = (res.content ?? []).filter((entry) => entry.schema)\n if (variants.length <= 1) {\n return ast.factory.createSchema({ type: 'ref', name: statusName })\n }\n\n return ast.factory.createSchema({\n type: 'union',\n members: resolveContentTypeVariants(variants, statusName).map((variant) =>\n ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n properties: [\n ast.factory.createProperty({\n name: 'contentType',\n required: true,\n // The runtime reports the bare media type, without parameters such as `charset` or `profile`.\n schema: ast.factory.createSchema({ type: 'enum', enumValues: [ast.mediaType.getBase(variant)] }),\n }),\n ast.factory.createProperty({\n name: 'data',\n required: true,\n schema:\n streamData && ast.http.status.isSuccess(res) && ast.mediaType.isStream(variant)\n ? streamData\n : ast.factory.createSchema({ type: 'ref', name: variant.name }),\n }),\n ],\n }),\n ),\n })\n}\n\n/**\n * Builds the per-status `<Name>Responses` record for an operation, referencing the already-resolved\n * `<Name>StatusNNN` names. Shared by `@kubb/plugin-ts`'s `Responses` type and `@kubb/plugin-zod`'s\n * inferred responses schema, so both emit the same shape from the same inputs.\n *\n * Always emits the keyed record, even when an operation declares no responses. An operation with no\n * responses renders as an empty object, which keeps every consumer's import (for example the axios\n * SDK's `RequestResult<XResponses>`) resolvable instead of pointing at a missing export.\n *\n * `streamData` is the type of a stream variant's `data`, such as a `ReadableStream<Uint8Array>` reference.\n */\nexport function buildResponses(\n node: ast.OperationNode,\n resolver: ResponseStatusNameResolver,\n { streamData }: { streamData?: ast.SchemaNode } = {},\n): ast.SchemaNode {\n return ast.factory.createSchema({\n type: 'object',\n primitive: 'object',\n properties: node.responses.map((res) =>\n ast.factory.createProperty({\n name: String(res.statusCode),\n required: true,\n schema: buildResponseRecordEntry(node, res, resolver, streamData),\n }),\n ),\n })\n}\n\nexport function resolveErrorNames(node: ast.OperationNode, resolver: ResponseStatusNameResolver): string[] {\n return ast.http.responses.filterError(node).map((response) => resolver.response.status(node, response.statusCode))\n}\n\nexport function resolveSuccessNames(node: ast.OperationNode, resolver: ResponseStatusNameResolver): string[] {\n return ast.http.responses.filterSuccess(node).map((response) => resolver.response.status(node, response.statusCode))\n}\n\nexport function resolveStatusCodeNames(node: ast.OperationNode, resolver: ResponseStatusNameResolver): string[] {\n return node.responses.map((response) => resolver.response.status(node, response.statusCode))\n}\n\n/**\n * Lists the type names an operation's types file declares, computed once per resolver and `options` so every\n * dependent reads the same list.\n */\nexport function resolveOperationTypeNames(\n node: ast.OperationNode,\n resolver: OperationTypeNameResolver & Pick<Resolver, 'memo'>,\n options: ResolveOperationTypeNameOptions = {},\n): string[] {\n const key = `${node.operationId}\\0${options.order ?? ''}\\0${options.responseStatusNames ?? ''}\\0${options.includeParams === false ? 'noparams' : ''}\\0${(options.exclude ?? []).join(',')}`\n return resolver.memo(`operationTypeNames:${key}`, () => {\n const { path, query, header, cookie } = ast.http.groupParameters(node)\n const responseStatusNames =\n options.responseStatusNames === 'error'\n ? resolveErrorNames(node, resolver)\n : options.responseStatusNames === false\n ? []\n : resolveStatusCodeNames(node, resolver)\n const exclude = new Set(options.exclude ?? [])\n const paramNames =\n options.includeParams === false\n ? []\n : [\n ...path.map((param) => resolver.param.path(node, param)),\n ...query.map((param) => resolver.param.query(node, param)),\n ...header.map((param) => resolver.param.headers(node, param)),\n ...cookie.map((param) => resolver.param.cookies(node, param)),\n ]\n const bodyAndResponseNames = [ast.http.requestBody.getSchema(node) ? resolver.response.body(node) : null, resolver.response.response(node)]\n const names =\n options.order === 'body-response-first'\n ? [...bodyAndResponseNames, ...paramNames, ...responseStatusNames]\n : [...paramNames, ...bodyAndResponseNames, ...responseStatusNames]\n\n return names.filter((name): name is string => Boolean(name) && !exclude.has(name as string))\n })\n}\n\nexport function resolveResponseTypes(node: ast.OperationNode, resolver: ResponseNameResolver): Array<[statusCode: number | 'default', typeName: string]> {\n const types: Array<[number | 'default', string]> = []\n\n for (const response of node.responses) {\n if (response.statusCode === 'default') {\n types.push(['default', resolver.response.response(node)])\n continue\n }\n\n const code = Number(response.statusCode)\n if (Number.isNaN(code)) {\n continue\n }\n\n types.push([code, ast.http.status.isSuccess(code) ? resolver.response.response(node) : resolver.response.status(node, response.statusCode)])\n }\n\n return types\n}\n","import { ensureValidVarName, toFilePath } from '@internals/utils'\nimport { ast, casing } from '@kubb/kit'\nimport type { GeneratorContext, Resolver, ResolverFile } from '@kubb/kit'\n\n/**\n * The shared top-level `name` of the operation plugins, computed once per operation name and build.\n */\nexport function resolveOperationName(this: Resolver, name: string): string {\n return this.memo(`operation:${name}`, () => ensureValidVarName(casing.camel(name)))\n}\n\n/**\n * Builds the allocation key for a declaration an operation owns. `scope` names which declaration\n * it is, so two of them never share an allocation even when a custom resolver gives both the same\n * name. Leave `scope` empty for the operation's own declaration.\n *\n * The key starts from the operation's input `pointer`, which macros keep, so a plugin whose macro\n * rewrites the method or path still resolves another plugin's names for the same operation.\n *\n * @example\n * ```ts\n * resolver.resolveName({ key: operationKey(node, 'response', 'status', 404), name })\n * ```\n */\nexport function operationKey(node: ast.OperationNode, ...scope: Array<string | number>): Array<string | undefined> {\n const source = node.pointer ? [node.pointer] : [node.method, node.path]\n return ['operation', ...source, ...scope.map(String)]\n}\n\n/**\n * The `param` namespace shared by the schema-producing plugins (ts, zod, faker):\n * per-parameter names plus the grouped `Path`/`Query`/`Headers`/`Cookies` names, all routed\n * through the plugin's top-level `name` casing.\n */\nexport type OperationParamResolver = {\n name(this: Resolver, node: ast.OperationNode, param: ast.ParameterNode): string\n path(this: Resolver, node: ast.OperationNode): string\n query(this: Resolver, node: ast.OperationNode): string\n headers(this: Resolver, node: ast.OperationNode): string\n cookies(this: Resolver, node: ast.OperationNode): string\n}\n\n/**\n * The `response` namespace shared by the schema-producing plugins: per-status,\n * body, and combined response names, all routed through the plugin's top-level\n * `name` casing.\n */\nexport type OperationResponseResolver = {\n status(this: Resolver, node: ast.OperationNode, statusCode: ast.StatusCode): string\n /**\n * Name of the headers a response declares, such as `ListPetsStatus200Headers`.\n */\n headers(this: Resolver, node: ast.OperationNode, statusCode: ast.StatusCode): string\n body(this: Resolver, node: ast.OperationNode): string\n responses(this: Resolver, node: ast.OperationNode): string\n response(this: Resolver, node: ast.OperationNode): string\n}\n\n/**\n * Builds the shared `param` namespace. Spread the result into `createResolver`\n * and override individual methods next to it when a plugin deviates.\n *\n * @example\n * ```ts\n * createResolver<PluginTs>({ param: createOperationParamResolver(), ... })\n * ```\n */\nexport function createOperationParamResolver(): OperationParamResolver {\n return {\n name(node, param) {\n const name = this.name(`${node.operationId} ${param.in} ${param.name}`)\n return this.resolveName({ key: operationKey(node, 'param', 'name', param.in, param.name), name })\n },\n path(node) {\n const name = this.name(`${node.operationId} Path`)\n return this.resolveName({ key: operationKey(node, 'param', 'path'), name })\n },\n query(node) {\n const name = this.name(`${node.operationId} Query`)\n return this.resolveName({ key: operationKey(node, 'param', 'query'), name })\n },\n headers(node) {\n const name = this.name(`${node.operationId} Headers`)\n return this.resolveName({ key: operationKey(node, 'param', 'headers'), name })\n },\n cookies(node) {\n const name = this.name(`${node.operationId} Cookies`)\n return this.resolveName({ key: operationKey(node, 'param', 'cookies'), name })\n },\n }\n}\n\n/**\n * Builds the shared `response` namespace. Spread the result into\n * `createResolver` and add plugin-specific methods (`options`, `error`) next\n * to it.\n *\n * @example\n * ```ts\n * createResolver<PluginTs>({ response: { ...createOperationResponseResolver(), options(node) {...} }, ... })\n * ```\n */\nexport function createOperationResponseResolver(): OperationResponseResolver {\n return {\n status(node, statusCode) {\n const name = this.name(`${node.operationId} Status ${statusCode}`)\n return this.resolveName({ key: operationKey(node, 'response', 'status', statusCode), name })\n },\n headers(node, statusCode) {\n const name = this.name(`${node.operationId} Status ${statusCode} Headers`)\n return this.resolveName({ key: operationKey(node, 'response', 'headers', statusCode), name })\n },\n body(node) {\n const name = this.name(`${node.operationId} Body`)\n return this.resolveName({ key: operationKey(node, 'response', 'body'), name })\n },\n responses(node) {\n const name = this.name(`${node.operationId} Responses`)\n return this.resolveName({ key: operationKey(node, 'response', 'responses'), name })\n },\n response(node) {\n const name = this.name(`${node.operationId} Response`)\n return this.resolveName({ key: operationKey(node, 'response', 'response'), name })\n },\n }\n}\n\n/**\n * Builds a resolver `file` override whose base name runs every path segment\n * through `toFilePath`, casing the final segment with `caseLast`.\n *\n * @example\n * ```ts\n * createResolver<PluginTs>({ file: createCasedFile(pascalCase), ... })\n * ```\n */\nexport function createCasedFile(caseLast: (part: string) => string): ResolverFile {\n return {\n baseName({ name, extname }) {\n return this.memo(`file:${name}\\0${extname}`, (): ast.FileNode['baseName'] => `${toFilePath(name, caseLast)}${extname}`)\n },\n }\n}\n\ntype SchemaIndexContext = Pick<GeneratorContext, 'memo' | 'driver'>\n\n/**\n * Names of the schemas in a circular reference chain, computed once per build.\n */\nexport function getCircularNames(ctx: SchemaIndexContext): ReadonlySet<string> {\n return ctx.memo('circularNames:set', () => ast.graph.getCircularNames(ctx.driver.inputNode?.schemas ?? []))\n}\n\n/**\n * Names of the schemas whose type is `enum`, computed once per build.\n */\nexport function getEnumNames(ctx: SchemaIndexContext): ReadonlySet<string> {\n return ctx.memo(\n 'enumNames:set',\n () => new Set((ctx.driver.inputNode?.schemas ?? []).flatMap((schema) => (schema.type === 'enum' && schema.name ? [schema.name] : []))),\n )\n}\n\ndeclare global {\n namespace Kubb {\n interface MemoRegistry {\n operation: string\n file: ast.FileNode['baseName']\n operationTypeNames: Array<string>\n }\n }\n}\n","import { buildOperationComments, buildRequestParamsSignature, castToClientOptions, hasRequestContentTypeChoice } from '@internals/shared'\nimport type { ast } from '@kubb/kit'\nimport type { ResolverTs } from '@kubb/plugin-ts'\nimport { File, Function } from '@kubb/renderer-jsx'\nimport type { KubbReactNode } from '@kubb/renderer-jsx'\n\ntype Props = {\n /**\n * Name of the handler function.\n */\n name: string\n /**\n * Name of the contract client `<op>` the handler calls.\n */\n clientName: string\n /**\n * AST operation node.\n */\n node: ast.HttpOperationNode\n /**\n * TypeScript resolver for resolving param/data/response type names.\n */\n resolver: ResolverTs\n /**\n * The registered client plugin's `returnType`, read by the caller off `resolveClientOperation`.\n */\n returnType?: 'full' | 'data' | 'plain'\n}\n\nexport function McpHandler({ name, clientName, node, resolver, returnType = 'full' }: Props): KubbReactNode {\n const { signature, names: callArgs } = buildRequestParamsSignature(node, resolver, { isConfigurable: false })\n const paramsSignature = [signature, 'ctx: ServerContext'].filter(Boolean).join(', ')\n\n // Forward the grouped config and MCP cancellation signal through the contract client. `throwOnError: true`\n // pins the result shape, since `throwOnErrorDefault: false` would otherwise resolve to the full result.\n const callConfig = `{ ${[...callArgs, 'signal: ctx.mcpReq.signal', 'throwOnError: true'].join(', ')} }`\n // Tool arguments carry no media type, so the call takes the client's default one.\n const callArg = hasRequestContentTypeChoice(node) ? castToClientOptions(callConfig, clientName, returnType) : callConfig\n const body = returnType === 'data' ? 'res' : 'res.data'\n\n const callToolResult = `return {\n content: [\n {\n type: 'text',\n text: JSON.stringify(${body}) ?? ''\n }\n ],\n structuredContent: { data: ${body} }\n}`\n\n return (\n <File.Source name={name} isExportable isIndexable>\n <Function\n name={name}\n async\n export\n params={paramsSignature}\n JSDoc={{\n comments: buildOperationComments(node),\n }}\n returnType={'CallToolResult'}\n >\n {`const res = await ${clientName}(${callArg})`}\n <br />\n {callToolResult}\n </Function>\n </File.Source>\n )\n}\n","import type { ast } from '@kubb/kit'\nimport { text } from '@kubb/kit'\nimport { Const, File, Function } from '@kubb/renderer-jsx'\nimport type { KubbReactNode } from '@kubb/renderer-jsx'\n\ntype ZodParam = {\n name: string\n schemaName: string\n}\n\n/**\n * Composes individual param schemas into `z.object({ ... })`.\n */\nconst zodObject = (params: Array<ZodParam>) => `z.object({ ${params.map((p) => `${JSON.stringify(p.name)}: ${p.schemaName}`).join(', ')} })`\n\ntype Props = {\n /**\n * Human-readable server name passed to `new McpServer({ name })`.\n */\n serverName: string\n /**\n * Semantic version string passed to `new McpServer({ version })`.\n */\n serverVersion: string\n /**\n * Operations to register as MCP tools, each carrying its handler,\n * zod schema, and AST node metadata.\n */\n operations: Array<{\n tool: {\n name: string\n title?: string\n description: string\n }\n mcp: {\n name: string\n file: ast.FileNode\n }\n zod: {\n pathParams: Array<ZodParam>\n /**\n * Query params — individual schemas to compose into `z.object({ ... })`, or the name of the grouped query schema.\n */\n queryParams?: Array<ZodParam> | string | null\n /**\n * Header params — individual schemas to compose into `z.object({ ... })`.\n */\n headerParams?: Array<ZodParam> | null\n /**\n * The cookie params, each a schema to compose into `z.object({ ... })`.\n */\n cookieParams?: Array<ZodParam> | null\n requestName?: string | null\n responseName?: string | null\n }\n }>\n}\n\nexport function Server({ serverName, serverVersion, operations }: Props): KubbReactNode {\n const registrations = operations\n .map(({ tool, mcp, zod }) => {\n // Group params into the same `{ path, query, headers, cookies, body }` shape the contract `<op>`\n // expects, so the MCP tool input mirrors every other client consumer.\n const entries: Array<{ key: string; value: string }> = []\n\n if (zod.pathParams.length) {\n entries.push({ key: 'path', value: zodObject(zod.pathParams) })\n }\n\n if (zod.queryParams) {\n entries.push({ key: 'query', value: typeof zod.queryParams === 'string' ? zod.queryParams : zodObject(zod.queryParams) })\n }\n\n if (zod.headerParams) {\n entries.push({ key: 'headers', value: zodObject(zod.headerParams) })\n }\n\n if (zod.cookieParams) {\n entries.push({ key: 'cookies', value: zodObject(zod.cookieParams) })\n }\n\n if (zod.requestName) {\n entries.push({ key: 'body', value: zod.requestName })\n }\n\n const destructured = `{ ${entries.map((e) => e.key).join(', ')} }`\n const inputSchema = entries.length ? `toolSchema(z.object({ ${entries.map((e) => `${e.key}: ${e.value}`).join(', ')} }))` : null\n const outputSchema = zod.responseName\n\n const config = [\n tool.title ? `title: ${JSON.stringify(tool.title)}` : null,\n `description: ${JSON.stringify(tool.description)}`,\n outputSchema ? `outputSchema: toolSchema(z.object({ data: ${outputSchema} }))` : null,\n ]\n .filter(Boolean)\n .join(',\\n ')\n\n if (inputSchema) {\n return `\nserver.registerTool(${JSON.stringify(tool.name)}, {\n ${config},\n inputSchema: ${inputSchema},\n}, async (${destructured}, ctx) => {\n return ${mcp.name}(${destructured}, ctx)\n})\n`\n }\n\n return `\nserver.registerTool(${JSON.stringify(tool.name)}, {\n ${config},\n}, async (ctx) => {\n return ${mcp.name}(ctx)\n})\n`\n })\n .filter(Boolean)\n .join('')\n\n return (\n <>\n <File.Source name=\"toolSchema\">\n <Function\n name=\"toolSchema\"\n generics=\"T extends z.ZodType\"\n params=\"schema: T\"\n JSDoc={{\n comments: [\n 'Converts with `unrepresentable: \"any\"`, because a `bigint` or `Blob` in one tool schema fails every `tools/list` request.',\n 'A `bigint` is listed as an `int64` integer and a `Blob` as an unconstrained value.',\n ],\n }}\n >\n {`const standard = schema['~standard']\nconst convert = (io: 'input' | 'output') => (options: Parameters<typeof standard.jsonSchema.input>[0]) =>\n standard.jsonSchema[io]({\n ...options,\n libraryOptions: {\n unrepresentable: 'any',\n override: ({ zodSchema, jsonSchema }: { zodSchema: z.core.$ZodType; jsonSchema: Record<string, unknown> }) => {\n if (zodSchema._zod.def.type === 'bigint') {\n jsonSchema.type = 'integer'\n jsonSchema.format = 'int64'\n }\n },\n },\n })\n\nreturn { '~standard': { ...standard, jsonSchema: { input: convert('input'), output: convert('output') } } }`}\n </Function>\n </File.Source>\n\n <File.Source name=\"getServer\" isExportable isIndexable>\n <Function name=\"getServer\" export>\n {`const server = new McpServer({\n name: ${text.quote(serverName)},\n version: ${text.quote(serverVersion)},\n})\n${registrations}\nreturn server`}\n </Function>\n </File.Source>\n\n <File.Source name=\"server\" isExportable isIndexable>\n <Const name={'server'} export>\n {'getServer()'}\n </Const>\n </File.Source>\n\n <File.Source name=\"startServer\" isExportable isIndexable>\n <Function name=\"startServer\" async export>\n {`return serveStdio(getServer, {\n onerror: (error) => console.error('MCP server error:', error),\n })`}\n </Function>\n </File.Source>\n </>\n )\n}\n","/**\n * Resolves which client plugin a consumer (react-query, vue-query, swr, mcp) should call for an\n * operation, shared so the selection rules and diagnostics stay in one place.\n *\n * Every client runtime lives in a dedicated client plugin, so a consumer always calls a registered\n * contract client plugin (plugin-fetch, plugin-axios, or plugin-client) and never emits its own\n * inline client:\n *\n * - `contract` — a registered contract client plugin owns the `<op>` functions and the consumer\n * imports and calls them.\n * - `error` — no client plugin is registered, several are registered without a selector, the\n * requested one is missing, or `client` is not a known selector.\n *\n * The `client` string selects explicitly (`'fetch'` / `'axios'` / `'client'`); when it is unset a\n * lone registered contract client plugin is picked up automatically.\n */\n\nimport { Diagnostics } from '@kubb/kit'\n\n// Canonical plugin names. They mirror the `pluginFetchName` / `pluginAxiosName` / `pluginClientName`\n// consts the plugins export, kept as literals so this internal needs no plugin install deps.\nconst pluginFetchName = 'plugin-fetch'\nconst pluginAxiosName = 'plugin-axios'\nconst pluginClientName = 'plugin-client'\n\n/**\n * The client selector accepted by a consumer's `client` option. Each calls a registered contract\n * client plugin.\n */\nexport type ClientSelector = 'fetch' | 'axios' | 'client'\n\n/**\n * The resolved client strategy stored in a consumer plugin's options: the generated code always\n * imports and calls a registered contract client plugin's `<op>`. The client runtime lives in\n * plugin-axios / plugin-fetch, so nothing is bundled by the consumer.\n */\nexport type ResolvedContractClient = { kind: 'contract'; pluginName: string }\n\n/**\n * The outcome of {@link resolveClient}.\n *\n * - `contract` names the contract client plugin whose `<op>` functions the consumer imports.\n * - `error` carries a setup diagnostic: its code, what is wrong, and how to fix it.\n */\nexport type ResolveClientResult =\n | ResolvedContractClient\n | { kind: 'error'; code: typeof Diagnostics.code.missingDependency | typeof Diagnostics.code.invalidPluginOptions; message: string; help: string }\n\nconst selectorToPlugin: Record<ClientSelector, string> = {\n fetch: pluginFetchName,\n axios: pluginAxiosName,\n client: pluginClientName,\n}\n\n// Every contract client plugin, in auto-detect priority order.\nconst contractPlugins = [pluginFetchName, pluginAxiosName, pluginClientName] as const\n\n/**\n * Applies the `client` resolution rules. See the module comment for the strategy shape.\n *\n * @example\n * ```ts\n * resolveClient({ client: 'fetch', pluginNames: ['plugin-ts', 'plugin-fetch'] })\n * // { kind: 'contract', pluginName: 'plugin-fetch' }\n * ```\n *\n * @example\n * ```ts\n * resolveClient({ client: undefined, pluginNames: ['plugin-ts'] })\n * // { kind: 'error', code: 'KUBB_MISSING_DEPENDENCY', message: 'No client plugin is registered.', help: 'Add …' }\n * ```\n */\nexport function resolveClient(options: { client: ClientSelector | undefined; pluginNames: ReadonlyArray<string> }): ResolveClientResult {\n const { client, pluginNames } = options\n const has = (name: string) => pluginNames.includes(name)\n\n if (client === 'fetch' || client === 'axios' || client === 'client') {\n const pluginName = selectorToPlugin[client]\n if (!has(pluginName)) {\n return {\n kind: 'error',\n code: Diagnostics.code.missingDependency,\n message: `\\`client: '${client}'\\` is set but \\`@kubb/plugin-${client}\\` is not registered in \\`plugins\\`.`,\n help: `Add \\`@kubb/plugin-${client}\\` to \\`plugins\\`, or drop \\`client\\` to use a different client plugin.`,\n }\n }\n return { kind: 'contract', pluginName }\n }\n\n // A JS config bypasses the `ClientSelector` type, so reject unknown selectors instead of auto-detecting.\n if (client !== undefined) {\n return {\n kind: 'error',\n code: Diagnostics.code.invalidPluginOptions,\n message: `Option \\`client\\` is ${typeof client === 'string' ? `'${client}'` : String(client)}, but it must be one of 'fetch', 'axios', 'client'.`,\n help: 'Set `client` to one of those values, or drop it to use the registered client plugin.',\n }\n }\n\n // `client` unset: auto-detect a lone registered contract client plugin.\n const registered = contractPlugins.filter(has)\n if (registered.length === 1) {\n return { kind: 'contract', pluginName: registered[0]! }\n }\n if (registered.length > 1) {\n return {\n kind: 'error',\n code: Diagnostics.code.invalidPluginOptions,\n message: `Multiple client plugins are registered (${registered.map((name) => `\\`@kubb/${name}\\``).join(', ')}) and \\`client\\` is not set.`,\n help: \"Set `client: 'fetch' | 'axios' | 'client'` to choose which client the hooks call, or register a single client plugin.\",\n }\n }\n\n return {\n kind: 'error',\n code: Diagnostics.code.missingDependency,\n message: 'No client plugin is registered.',\n help: 'Add `@kubb/plugin-fetch`, `@kubb/plugin-axios`, or `@kubb/plugin-client` to `plugins` so the generated code has an HTTP client to call.',\n }\n}\n\n/**\n * Resolves the contract client during a consumer plugin's setup hook.\n * It extracts the plugin names from the raw `plugins` config and applies {@link resolveClient}.\n * On a misconfiguration it throws a config diagnostic tagged with `plugin`, so every consumer\n * fails fast with the same message.\n */\nexport function resolveContractClient(options: {\n plugin: string\n client: ClientSelector | undefined\n plugins?: ReadonlyArray<unknown>\n}): ResolvedContractClient {\n const { plugin, client, plugins = [] } = options\n const pluginNames = plugins.map((plugin) => (plugin as { name?: string }).name).filter((name): name is string => Boolean(name))\n const resolved = resolveClient({ client, pluginNames })\n if (resolved.kind === 'error') {\n const { code, message, help } = resolved\n throw new Diagnostics.Error({ code, severity: 'error', message, help, location: { kind: 'config' }, plugin })\n }\n return resolved\n}\n","import path from 'node:path'\nimport { operationFileEntry, operationKey } from '@internals/shared'\nimport type { ast, Exclude, Group, Include, Memo, Output, Override, Resolver } from '@kubb/kit'\n\n/**\n * Shape of the value a generated operation function resolves to.\n * - `'full'`: the complete `{ status, data, error, contentType, request, response }` result.\n * - `'data'`: the bare success body when `throwOnError` is true, or the full result when it is false\n * so callers can inspect `error`.\n * - `'plain'`: the client's own promise typed as `RequestResult`, with no `withUnwrap` / `unwrapResult`\n * helper. Backs `@kubb/plugin-client`.\n */\nexport type ReturnTypeOption = 'full' | 'data' | 'plain'\n\n/**\n * The resolved contract `<op>` for one operation: the generated function name, the file it lives in,\n * the client module path (where `RequestConfig` / `ResponseErrorConfig` come from), and the\n * registered client plugin's `returnType`.\n *\n * `clientPath` is the absolute `.kubb/client.ts` path for plugin-fetch / plugin-axios, or\n * plugin-client's `importPath`: a relative one is resolved against the `<op>` file to an absolute\n * path, a package name or alias is kept verbatim. `clientPathIsFile` tells a consumer whether to\n * make it relative to the importing file.\n */\nexport type ClientOperation = {\n name: string\n path: string\n clientPath: string\n clientPathIsFile: boolean\n returnType: ReturnTypeOption\n /**\n * Whether the client's results carry the declared response headers. A custom `importPath` client keeps untyped headers.\n */\n typedHeaders: boolean\n}\n\n/**\n * The client plugin options a dependent reads, including the filters that scope them per operation.\n */\ntype ClientPluginOptions = {\n output?: Output\n group?: Group | null\n returnType?: ReturnTypeOption\n importPath?: string\n exclude?: Array<Exclude>\n include?: Array<Include>\n override?: Array<Override<Omit<ClientPluginOptions, 'override'>>>\n}\n\nfunction isRelativeImport(importPath: string): boolean {\n return importPath.startsWith('.')\n}\n\n// plugin-client resolves a relative `importPath` from its `<op>` file, so do the same here.\nfunction resolveImportPath(options: { importPath: string; operationFile: string }): string {\n const { importPath, operationFile } = options\n return isRelativeImport(importPath) ? path.resolve(path.dirname(operationFile), importPath) : importPath\n}\n\n/**\n * Resolves the contract client `<op>` a consumer (query hook, MCP handler) imports, by looking up\n * the registered contract client plugin's resolver and output. Works for any contract client plugin\n * (plugin-fetch, plugin-axios, or plugin-client). Returns `null` when no contract plugin is in play (the inline\n * path), or when the client plugin's `exclude` / `include` leaves this operation out, since it then\n * emits no `<op>` to import. plugin-fetch / plugin-axios inject `.kubb/client.ts` at the global\n * output root, the same path consumers read `RequestConfig` / `ResponseErrorConfig` from.\n * With plugin-client they come from the user's `importPath` module instead.\n *\n * The result is cached in `memo` (the build's `ctx.memo`) under the client plugin's name and the operation,\n * so several dependents reading the same client plugin for one operation in a single pass\n * (react-query's query/mutation/infinite generators, vue-query, swr, the MCP handler, ...) share\n * one computed result instead of each re-deriving the name and path.\n *\n * `returnType`, `output`, and `group` are the client plugin's options for this operation, after its\n * `override` entries, the same resolution its own generator sees. A dependent's generated call body\n * and import path therefore match the `<op>` actually emitted, even when an `override` changes it.\n */\nexport function resolveClientOperation(options: {\n clientPlugin: { pluginName: string } | null\n driver: {\n getPlugin: (name: string) => { options?: ClientPluginOptions } | undefined\n getResolver: (name: string) => Resolver\n }\n node: ast.OperationNode\n root: string\n output: Output\n memo: Memo\n}): ClientOperation | null {\n const { clientPlugin, driver, node, root, output, memo } = options\n if (!clientPlugin) return null\n\n return memo(`${clientPlugin.pluginName}:clientOperation:${node.operationId}`, () => {\n const resolver = driver.getResolver(clientPlugin.pluginName)\n const pluginOptions = driver.getPlugin(clientPlugin.pluginName)?.options ?? {}\n const { exclude, include, override } = pluginOptions\n const hasOperationOptions = Boolean(exclude?.length || include?.length || override?.length)\n // Kubb's resolver always has `default`; the fallback keeps partial or custom resolvers working.\n const operationOptions =\n hasOperationOptions && resolver.default ? resolver.default.options(node, { options: pluginOptions, exclude, include, override }) : pluginOptions\n if (!operationOptions) return null\n\n const file = resolver.file({\n ...operationFileEntry(node, node.operationId),\n root,\n output: operationOptions.output ?? output,\n group: operationOptions.group ?? undefined,\n })\n\n const { importPath } = operationOptions\n const name = resolver.name(node.operationId)\n\n return {\n name: resolver.resolveName({ key: operationKey(node), name }),\n path: file.path,\n clientPath: importPath === undefined ? path.resolve(root, '.kubb/client.ts') : resolveImportPath({ importPath, operationFile: file.path }),\n clientPathIsFile: importPath === undefined || isRelativeImport(importPath),\n returnType: operationOptions.returnType ?? 'full',\n typedHeaders: importPath === undefined,\n }\n })\n}\n","import { type ast, Diagnostics, type GeneratorContext, type Group, type Output } from '@kubb/kit'\nimport { pluginTsName, type ResolverTs } from '@kubb/plugin-ts'\nimport type { PluginZod, ResolverZod } from '@kubb/plugin-zod'\n\n// A type-only import: the query plugins bundle this file but do not depend on @kubb/plugin-zod.\nconst pluginZodName = 'plugin-zod' satisfies PluginZod['name']\n\ntype GeneratorDriver = GeneratorContext['driver']\n\n/**\n * The per-operation type names a generated client references: the grouped input, the per-status\n * responses record its `RequestResult` is keyed on, and the headers each response declares.\n */\nexport type OperationTypeNames = {\n response: {\n /**\n * Resolves the name of the operation's grouped `{ body, path, query, headers, cookies }` input type.\n */\n options(node: ast.OperationNode): string\n /**\n * Resolves the name of the operation's per-status responses record type.\n */\n responses(node: ast.OperationNode): string\n /**\n * Resolves the name of the type of the headers one response declares. Left out, results keep untyped headers.\n */\n headers?(node: ast.OperationNode, statusCode: ast.StatusCode): string\n }\n}\n\nfunction getResponseHeadersEntries({ node, types }: { node: ast.OperationNode; types: OperationTypeNames }): Array<[ast.StatusCode, string]> {\n const resolve = types.response.headers\n if (!resolve) return []\n return node.responses\n .filter((response) => response.headers?.length)\n .map((response) => [response.statusCode, resolve.call(types.response, node, response.statusCode)])\n}\n\n/**\n * The headers type argument of `RequestResult`, such as `{ '200': LoginUserStatus200Headers }`, or `null` when no response declares headers.\n */\nexport function buildResponseHeadersType({ node, types }: { node: ast.OperationNode; types: OperationTypeNames }): string | null {\n const entries = getResponseHeadersEntries({ node, types }).map(([statusCode, name]) => `'${statusCode}': ${name}`)\n return entries.length ? `{ ${entries.join('; ')} }` : null\n}\n\n/**\n * A runtime result type, such as `RequestResult`, in its `WithHeaders` form when `headers` is set.\n */\nexport function resultTypeName(name: string, headers: boolean): string {\n return headers ? `${name}WithHeaders` : name\n}\n\n/**\n * A runtime result type with its arguments, such as `RequestResultWithHeaders<Responses, Headers, ThrowOnError>`.\n */\nexport function buildResultTypeRef(name: string, responses: string, headers: string | null, rest: Array<string | null> = []): string {\n return `${resultTypeName(name, headers !== null)}<${[responses, headers, ...rest].filter(Boolean).join(', ')}>`\n}\n\n/**\n * The names of the headers types `buildResponseHeadersType` references, for the file's imports.\n */\nexport function getResponseHeadersTypeNames({ node, types }: { node: ast.OperationNode; types: OperationTypeNames }): Array<string> {\n return getResponseHeadersEntries({ node, types }).map(([, name]) => name)\n}\n\n/**\n * Where a generated client sources its operation types, plus the resolver and output the file\n * declaring them is resolved with.\n */\nexport type OperationTypeSource = OperationTypeNames & {\n /**\n * `plugin-ts` shaped resolver of the plugin supplying the names, also used to resolve the file they are exported from.\n */\n resolver: ResolverTs\n /**\n * The supplying plugin's own `output`, when it configured one.\n */\n output: Output | undefined\n /**\n * The supplying plugin's own `group`, when it configured one.\n */\n group: Group | undefined\n}\n\n/**\n * A `plugin-ts` shaped resolver whose operation type names point at the types `pluginZod({ inferred })`\n * exports next to each schema, so code written against `plugin-ts` names picks up the zod types.\n */\nfunction toZodTypeResolver(resolver: ResolverZod): ResolverTs {\n const type = (name: string) => resolver.schema.type(name)\n\n return {\n ...resolver,\n // Class methods, so a spread drops them. `file` reads private fields, and `memo` gets its own key\n // space so these type names never share an entry with the zod names.\n file: resolver.file.bind(resolver),\n memo: (key: string, compute: () => unknown) => resolver.memo(`zodTypes:${key}`, compute),\n param: {\n name: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.name(node, p)),\n path: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.path(node, p)),\n query: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.query(node, p)),\n headers: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.headers(node, p)),\n cookies: (node: ast.OperationNode, p: ast.ParameterNode) => type(resolver.param.cookies(node, p)),\n },\n response: {\n body: (node: ast.OperationNode) => type(resolver.response.body(node)),\n status: (node: ast.OperationNode, statusCode: ast.StatusCode) => type(resolver.response.status(node, statusCode)),\n response: (node: ast.OperationNode) => type(resolver.response.response(node)),\n responses: (node: ast.OperationNode) => type(resolver.response.responses(node)),\n headers: (node: ast.OperationNode, statusCode: ast.StatusCode) => type(resolver.response.headers(node, statusCode)),\n options: (node: ast.OperationNode) => resolver.response.options(node),\n },\n } as unknown as ResolverTs\n}\n\n/**\n * Picks the plugin generated clients, query hooks, and MCP handlers take their operation types from.\n *\n * `pluginZod({ inferred: 'codec' })` wins, so a codec param takes its domain value. Otherwise `plugin-ts`\n * wins when it is in the pipeline, and without it any `pluginZod({ inferred })`. Throws\n * `KUBB_MISSING_DEPENDENCY` for `pluginName` when neither is available.\n *\n * @example\n * ```ts\n * const types = resolveOperationTypes(ctx.driver, ctx.plugin.name)\n * types.response.options(node) // 'GetPetByIdOptions', or 'GetPetByIdOptionsSchemaType' from zod\n * ```\n */\nexport function resolveOperationTypes(driver: GeneratorDriver, pluginName: string): OperationTypeSource {\n return driver.memo(`operationTypes:${pluginName}`, () => {\n const pluginTs = driver.getPlugin(pluginTsName)\n const pluginZod = driver.getPlugin(pluginZodName)\n\n if (pluginTs && pluginZod?.options?.inferred !== 'codec') {\n const resolver = driver.getResolver(pluginTsName)\n return { response: resolver.response, resolver, output: pluginTs.options?.output, group: pluginTs.options?.group ?? undefined }\n }\n\n if (!pluginZod?.options?.inferred) {\n throw new Diagnostics.Error({\n code: Diagnostics.code.missingDependency,\n severity: 'error',\n message: `Plugin \"${pluginName}\" has no source for operation types.`,\n help: `Add \\`pluginTs()\\` before \"${pluginName}\", or add \\`pluginZod({ inferred: true })\\`.`,\n location: { kind: 'config' },\n plugin: pluginName,\n })\n }\n\n const resolver = toZodTypeResolver(driver.getResolver(pluginZodName))\n return { response: resolver.response, resolver, output: pluginZod.options.output, group: pluginZod.options.group ?? undefined }\n })\n}\n\ndeclare global {\n namespace Kubb {\n interface MemoRegistry {\n operationTypes: OperationTypeSource\n /**\n * Nests every key the zod-backed `ResolverTs` memoizes, so it holds each of their value types.\n */\n zodTypes: unknown\n }\n }\n}\n","import { resolveClientOperation, resolveOperationTypes } from '@internals/client'\nimport { hasStreamVariant, isEventStream, operationFileEntry, resolveOperationFile } from '@internals/shared'\nimport { ast, defineGenerator } from '@kubb/kit'\nimport { File, jsxRenderer } from '@kubb/renderer-jsx'\nimport { McpHandler } from '../components/McpHandler.tsx'\nimport type { PluginMcp } from '../types.ts'\n\n/**\n * Built-in operation generator for `@kubb/plugin-mcp`. Emits one MCP tool\n * handler per OpenAPI operation. The handler takes the grouped `{ path, query,\n * headers, body }` config and forwards it to the registered client plugin's\n * (`@kubb/plugin-axios` / `@kubb/plugin-fetch`) `<op>` function.\n */\nexport const mcpGenerator = defineGenerator<PluginMcp>({\n name: 'mcp',\n renderer: jsxRenderer,\n operation(node, ctx) {\n if (!ast.http.isOperation(node)) return null\n // A stream has no single JSON body to return as tool output, like the query plugins skip it.\n if (isEventStream(node) || hasStreamVariant(node)) return null\n const { resolver, driver, root, config } = ctx\n const { output, client, group } = ctx.options\n\n const types = resolveOperationTypes(driver, resolver.pluginName)\n const tsResolver = types.resolver\n\n // The registered contract client plugin owns the `<op>` the handler imports and calls.\n const contractOp = resolveClientOperation({ clientPlugin: { pluginName: client.pluginName }, driver, node, root, output, memo: ctx.memo })\n if (!contractOp) {\n return null\n }\n\n // The handler signature references the grouped `<Name>Options`.\n const optionsName = tsResolver.response.options(node)\n\n const meta = {\n name: resolver.handler.name(node),\n file: resolver.file({ ...operationFileEntry(node, node.operationId), root, output, group: group ?? undefined }),\n fileTs: resolveOperationFile({\n ctx,\n node,\n resolver: tsResolver,\n root,\n output: types.output ?? output,\n group: types.group,\n }),\n } as const\n\n return (\n <File\n baseName={meta.file.baseName}\n path={meta.file.path}\n meta={meta.file.meta}\n banner={resolver.default.banner(ctx.meta, { output, config, file: { path: meta.file.path, baseName: meta.file.baseName } })}\n footer={resolver.default.footer(ctx.meta, { output, config, file: { path: meta.file.path, baseName: meta.file.baseName } })}\n >\n {meta.fileTs && optionsName && <File.Import name={[optionsName]} root={meta.file.path} path={meta.fileTs.path} isTypeOnly />}\n <File.Import name={['CallToolResult', 'ServerContext']} path={'@modelcontextprotocol/server'} isTypeOnly />\n\n <File.Import name={[contractOp.name]} root={meta.file.path} path={contractOp.path} />\n\n <McpHandler name={meta.name} clientName={contractOp.name} node={node} resolver={tsResolver} returnType={contractOp.returnType} />\n </File>\n )\n },\n})\n","import path from 'node:path'\nimport { hasStreamVariant, isEventStream, operationFileEntry, resolveOperationFile } from '@internals/shared'\nimport { getRelativePath } from '@internals/utils'\nimport { ast, defineGenerator } from '@kubb/kit'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { File, jsxRenderer } from '@kubb/renderer-jsx'\nimport { Server } from '../components/Server.tsx'\nimport type { PluginMcp } from '../types.ts'\n\n/**\n * Default v5 server generator for `@kubb/plugin-mcp`.\n *\n * Uses individual zod schemas for each param (e.g. `createPetsPathUuidSchema`, `createPetsQueryOffsetSchema`)\n * and `resolveResponseStatusName` for per-status response schemas.\n * Query and header params are composed into `z.object({ ... })` from individual schemas.\n */\nexport const serverGenerator = defineGenerator<PluginMcp>({\n name: 'operations',\n renderer: jsxRenderer,\n operations(nodes, ctx) {\n const { config, resolver, plugin, driver, root } = ctx\n const { output, group } = ctx.options\n\n const pluginZod = ctx.requirePlugin(pluginZodName)\n\n const zodResolver = driver.getResolver(pluginZodName)\n\n const fileAt = <TName extends `${string}.${string}`>(baseName: TName) => ({\n baseName,\n path: path.resolve(root, output.path, baseName),\n meta: { pluginName: plugin.name },\n })\n const serverFile = fileAt('server.ts')\n const startFile = fileAt('start.ts')\n const jsonFile = fileAt('.mcp.json')\n\n // MCP clients spawn the command from their own working directory, usually the project root,\n // so `args` points at `start.ts` relative to `config.root` instead of the `.mcp.json` folder.\n const mcpConfig = {\n mcpServers: {\n [ctx.meta.title || 'server']: {\n type: 'stdio',\n command: 'npx',\n args: ['tsx', getRelativePath(path.resolve(config.root), startFile.path)],\n },\n },\n }\n\n // `mcpGenerator` emits no handler for a stream operation, so it gets no tool either.\n const operationsMapped = nodes\n .filter(ast.http.isOperation)\n .filter((node) => !isEventStream(node) && !hasStreamVariant(node))\n .map((node) => {\n const { path: pathParams, query: queryParams, header: headerParams, cookie: cookieParams } = ast.http.groupParameters(node)\n\n const mcpFile = resolver.file({ ...operationFileEntry(node, node.operationId), root, output, group: group ?? undefined })\n const zodFile = resolveOperationFile({\n ctx,\n node,\n resolver: zodResolver,\n root,\n output: pluginZod.options?.output ?? output,\n group: pluginZod.options?.group ?? undefined,\n })\n\n const requestName = ast.http.requestBody.getSchema(node) ? zodResolver.response.body(node) : null\n const successStatus = ast.http.responses.findPrimary(node)?.statusCode\n const responseName = successStatus ? zodResolver.response.status(node, successStatus) : null\n\n const resolveParams = (params: typeof pathParams) => params.map((p) => ({ name: p.name, schemaName: zodResolver.param.name(node, p) }))\n const resolveOptional = (params: typeof pathParams) => (params.length ? resolveParams(params) : null)\n\n return {\n tool: {\n name: node.operationId,\n title: node.summary || undefined,\n description: node.description || `Make a ${node.method.toUpperCase()} request to ${node.path}`,\n },\n mcp: {\n name: resolver.handler.name(node),\n file: mcpFile,\n },\n zod: {\n pathParams: resolveParams(pathParams),\n queryParams: resolveOptional(queryParams),\n headerParams: resolveOptional(headerParams),\n cookieParams: resolveOptional(cookieParams),\n requestName,\n responseName,\n file: zodFile,\n },\n }\n })\n\n const imports = operationsMapped.flatMap(({ mcp, zod }) => {\n const zodNames = [\n ...zod.pathParams.map((p) => p.schemaName),\n ...(typeof zod.queryParams === 'string' ? [zod.queryParams] : (zod.queryParams ?? []).map((p) => p.schemaName)),\n ...(zod.headerParams ?? []).map((p) => p.schemaName),\n ...(zod.cookieParams ?? []).map((p) => p.schemaName),\n zod.requestName,\n zod.responseName,\n ].filter((name): name is string => Boolean(name))\n\n const uniqueNames = [...new Set(zodNames)].sort()\n\n return [\n <File.Import key={mcp.name} name={[mcp.name]} root={serverFile.path} path={mcp.file.path} />,\n uniqueNames.length > 0 && <File.Import key={`zod-${mcp.name}`} name={uniqueNames} root={serverFile.path} path={zod.file.path} />,\n ].filter(Boolean)\n })\n\n return (\n <>\n <File\n baseName={serverFile.baseName}\n path={serverFile.path}\n meta={serverFile.meta}\n banner={resolver.default.banner(ctx.meta, { output, config, file: { path: serverFile.path, baseName: serverFile.baseName } })}\n footer={resolver.default.footer(ctx.meta, { output, config, file: { path: serverFile.path, baseName: serverFile.baseName } })}\n >\n <File.Import name={['McpServer']} path={'@modelcontextprotocol/server'} />\n <File.Import name={['serveStdio']} path={'@modelcontextprotocol/server/stdio'} />\n <File.Import name={['z']} path={'zod'} />\n\n {imports}\n <Server serverName={ctx.meta.title ?? 'server'} serverVersion={ctx.meta.version ?? '0.0.0'} operations={operationsMapped} />\n </File>\n\n <File\n baseName={startFile.baseName}\n path={startFile.path}\n meta={startFile.meta}\n banner={resolver.default.banner(ctx.meta, { output, config, file: { path: startFile.path, baseName: startFile.baseName } })}\n footer={resolver.default.footer(ctx.meta, { output, config, file: { path: startFile.path, baseName: startFile.baseName } })}\n >\n <File.Import name={['startServer']} root={startFile.path} path={serverFile.path} />\n {/* Not indexable: barrels must not re-export this entry, importing it starts the server. */}\n <File.Source name=\"start\">{'void startServer()'}</File.Source>\n </File>\n\n <File baseName={jsonFile.baseName} path={jsonFile.path} meta={jsonFile.meta}>\n <File.Source name=\"server\">{`${JSON.stringify(mcpConfig, null, 2)}\\n`}</File.Source>\n </File>\n </>\n )\n },\n})\n","","","import { operationKey } from '@internals/shared'\nimport { casing, createResolver } from '@kubb/kit'\nimport type { PluginMcp } from '../types.ts'\n\n/**\n * Default resolver used by `@kubb/plugin-mcp`. Decides the names and file\n * paths for every generated MCP tool handler. Function names get a `Handler`\n * suffix so an operation `addPet` becomes `addPetHandler`.\n *\n * @example Resolve a handler name\n * ```ts\n * import { resolverMcp } from '@kubb/plugin-mcp'\n *\n * resolverMcp.name('addPet') // 'addPetHandler'\n * ```\n */\nexport const resolverMcp = createResolver<PluginMcp>({\n pluginName: 'plugin-mcp',\n name(name) {\n return this.memo(`name:${name}`, () => casing.camel(name, { suffix: 'handler' }))\n },\n handler: {\n name(node) {\n const name = this.name(node.operationId)\n return this.resolveName({ key: operationKey(node, 'handler', 'name'), name })\n },\n },\n})\n","import { resolveContractClient } from '@internals/client'\nimport { addGenerator, defineExtension, Resolver, setMacros, setResolver, useConfig } from '@kubb/kit'\nimport { compatibility } from '../kubb-extension.json'\nimport { version } from '../package.json'\nimport { pluginTsName } from '@kubb/plugin-ts'\nimport { pluginZodName } from '@kubb/plugin-zod'\nimport { mcpGenerator } from './generators/mcpGenerator.tsx'\nimport { serverGenerator } from './generators/serverGenerator.tsx'\nimport { resolverMcp } from './resolvers/resolverMcp.ts'\nimport type { PluginMcp, ResolverMcp } from './types.ts'\n\n/**\n * Canonical plugin name for `@kubb/plugin-mcp`. Used for driver lookups and\n * cross-plugin dependency references.\n */\nexport const pluginMcpName = 'plugin-mcp' satisfies PluginMcp['name']\n\n/**\n * Generates a Model Context Protocol (MCP) server from an OpenAPI spec. Every\n * operation becomes a typed MCP tool that AI assistants (Claude Desktop, Claude\n * Code, MCP-compatible clients) can call directly. Each handler calls a contract\n * client `<op>` from a registered `@kubb/plugin-axios` or `@kubb/plugin-fetch`.\n * Next to the handlers it writes `server.ts`, a `start.ts` entry that serves the\n * tools over stdio, and a `.mcp.json` that runs `start.ts` with `tsx`.\n *\n * @example\n * ```ts\n * import { defineConfig } from 'kubb/config'\n * import { pluginTs } from '@kubb/plugin-ts'\n * import { pluginZod } from '@kubb/plugin-zod'\n * import { pluginFetch } from '@kubb/plugin-fetch'\n * import { pluginMcp } from '@kubb/plugin-mcp'\n *\n * export default defineConfig({\n * input: './petStore.yaml',\n * output: { path: './src/gen' },\n * plugins: [\n * pluginTs(),\n * pluginZod(),\n * pluginFetch({ baseURL: 'https://petstore.swagger.io/v2' }),\n * pluginMcp({ output: { path: 'mcp' } }),\n * ],\n * })\n * ```\n */\nexport const pluginMcp = defineExtension<PluginMcp>({\n kind: 'plugin',\n meta: { name: pluginMcpName, version, compatibility },\n dependencies: { [pluginTsName]: { optional: true }, [pluginZodName]: {} },\n setup(options) {\n const {\n output = { path: 'mcp', barrel: { type: 'named' } },\n group,\n exclude = [],\n include,\n override = [],\n client,\n resolver: userResolver,\n macros: userMacros,\n } = options\n\n const resolver = userResolver ? Resolver.merge<ResolverMcp>(resolverMcp, userResolver) : resolverMcp\n\n setResolver(resolver)\n if (userMacros?.length) {\n setMacros(userMacros)\n }\n addGenerator(mcpGenerator, serverGenerator)\n\n return {\n output,\n exclude,\n include,\n override,\n group: group ?? null,\n client: resolveContractClient({ plugin: pluginMcpName, client, plugins: useConfig().plugins }),\n resolver,\n }\n },\n})\n\nexport default pluginMcp\n"],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -318,7 +318,7 @@ function McpHandler({ name, clientName, node, resolver, returnType = "full" }) {
|
|
|
318
318
|
content: [
|
|
319
319
|
{
|
|
320
320
|
type: 'text',
|
|
321
|
-
text: JSON.stringify(${body})
|
|
321
|
+
text: JSON.stringify(${body}) ?? ''
|
|
322
322
|
}
|
|
323
323
|
],
|
|
324
324
|
structuredContent: { data: ${body} }
|
|
@@ -977,11 +977,11 @@ const serverGenerator = defineGenerator({
|
|
|
977
977
|
});
|
|
978
978
|
// kubb-extension.json
|
|
979
979
|
var compatibility = {
|
|
980
|
-
"kubb": ">=5.
|
|
980
|
+
"kubb": ">=5.19.0",
|
|
981
981
|
"node": ">=22.22"
|
|
982
982
|
};
|
|
983
983
|
// package.json
|
|
984
|
-
var version = "5.5.
|
|
984
|
+
var version = "5.5.4";
|
|
985
985
|
// src/resolvers/resolverMcp.ts
|
|
986
986
|
/**
|
|
987
987
|
* Default resolver used by `@kubb/plugin-mcp`. Decides the names and file
|