@kubb/plugin-client 5.0.0-beta.4 → 5.0.0-beta.42

package/package.json

@@ -1,23 +1,17 @@
 {
   "name": "@kubb/plugin-client",
-  "version": "5.0.0-beta.4",
-  "description": "API client generator plugin for Kubb, creating type-safe HTTP clients (Axios, Fetch) from OpenAPI specifications for making API requests.",
+  "version": "5.0.0-beta.42",
+  "description": "Generate type-safe HTTP clients from your OpenAPI specification. Supports Axios, Fetch, and custom client adapters with full TypeScript inference and zero boilerplate.",
   "keywords": [
     "api-client",
     "axios",
-    "code-generator",
+    "code-generation",
     "codegen",
     "fetch",
     "http-client",
     "kubb",
-    "oas",
     "openapi",
-    "plugins",
-    "rest-api",
-    "sdk-generator",
     "swagger",
-    "type-safe",
-    "type-safety",
     "typescript"
   ],
   "license": "MIT",
@@ -30,7 +24,6 @@
   "files": [
     "src",
     "dist",
-    "templates",
     "extension.yaml",
     "*.d.ts",
     "*.d.cts",
@@ -94,17 +87,18 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/core": "5.0.0-beta.4",
-    "@kubb/renderer-jsx": "5.0.0-beta.4",
-    "@kubb/plugin-ts": "5.0.0-beta.4",
-    "@kubb/plugin-zod": "5.0.0-beta.4"
+    "@kubb/core": "5.0.0-beta.42",
+    "@kubb/renderer-jsx": "5.0.0-beta.42",
+    "@kubb/plugin-ts": "5.0.0-beta.42",
+    "@kubb/plugin-zod": "5.0.0-beta.42"
   },
   "devDependencies": {
-    "axios": "^1.15.2",
+    "axios": "^1.16.1",
+    "@internals/shared": "0.0.0",
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.4",
+    "@kubb/renderer-jsx": "5.0.0-beta.42",
     "axios": "^1.7.2"
   },
   "peerDependenciesMeta": {
@@ -129,6 +123,7 @@
     "lint:fix": "oxlint --fix .",
     "release": "pnpm publish --no-git-check",
     "release:canary": "bash ../../.github/canary.sh && node ../../scripts/build.js canary && pnpm publish --no-git-check",
+    "release:stage": "pnpm stage publish --no-git-check",
     "start": "tsdown --watch",
     "test": "vitest --passWithNoTests",
     "typecheck": "tsc -p ./tsconfig.json --noEmit --emitDeclarationOnly false"

package/src/clients/axios.ts

@@ -4,6 +4,13 @@ import axios from 'axios'
 declare const AXIOS_BASE: string
 declare const AXIOS_HEADERS: string
 
+/**
+ * Header values may be objects (e.g. JSON-encoded headers like `X-Filter` in the Linode API).
+ * Non-string values are JSON-serialized before the request is sent.
+ */
+export type HeaderValue = string | number | boolean | null | undefined | object
+export type HeadersInit = Array<[string, HeaderValue]> | Record<string, HeaderValue>
+
 /**
  * Subset of AxiosRequestConfig
  */
@@ -16,8 +23,9 @@ export type RequestConfig<TData = unknown> = {
   responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'
   signal?: AbortSignal
   validateStatus?: (status: number) => boolean
-  headers?: AxiosRequestConfig['headers']
+  headers?: HeadersInit
   paramsSerializer?: AxiosRequestConfig['paramsSerializer']
+  contentType?: string
 }
 
 /**
@@ -55,22 +63,48 @@ export const mergeConfig = <T extends RequestConfig>(...configs: Array<Partial<T
       ...merged,
       ...config,
       headers: {
-        ...merged.headers,
-        ...config.headers,
+        ...(Array.isArray(merged.headers) ? Object.fromEntries(merged.headers) : merged.headers),
+        ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : config.headers),
       },
     }
   }, {})
 }
 
-export const axiosInstance = axios.create(getConfig())
+/**
+ * Serializes header values into the string form axios ultimately puts on the wire.
+ * Objects (including arrays) are JSON-stringified so spec-defined object headers like `X-Filter`
+ * are sent in their canonical JSON-string form rather than `[object Object]`.
+ */
+function serializeHeaders(headers: HeadersInit | undefined): Record<string, string> {
+  if (!headers) return {}
+  const entries = Array.isArray(headers) ? headers : Object.entries(headers)
+  const result: Record<string, string> = {}
+  for (const [key, value] of entries) {
+    if (value === undefined || value === null) continue
+    result[key] = typeof value === 'string' ? value : typeof value === 'object' ? JSON.stringify(value) : String(value)
+  }
+  return result
+}
+
+export const axiosInstance = axios.create(getConfig() as AxiosRequestConfig)
 
 export const client = async <TResponseData, TError = unknown, TRequestData = unknown>(
   config: RequestConfig<TRequestData>,
   _request?: unknown,
 ): Promise<ResponseConfig<TResponseData>> => {
-  return axiosInstance.request<TResponseData, ResponseConfig<TResponseData>>(mergeConfig(getConfig(), config)).catch((e: AxiosError<TError>) => {
-    throw e
-  })
+  const requestConfig = mergeConfig(getConfig(), config)
+  const { contentType, headers, ...axiosConfig } = requestConfig
+  return axiosInstance
+    .request<TResponseData, ResponseConfig<TResponseData>>({
+      ...axiosConfig,
+      headers: {
+        ...(contentType && contentType !== 'multipart/form-data' ? { 'Content-Type': contentType } : {}),
+        ...serializeHeaders(headers),
+      },
+    })
+    .catch((e: AxiosError<TError>) => {
+      throw e
+    })
 }
 
 client.getConfig = getConfig

package/src/clients/fetch.ts

@@ -3,6 +3,13 @@
  */
 export type RequestCredentials = 'omit' | 'same-origin' | 'include'
 
+/**
+ * Header values may be objects (e.g. JSON-encoded filter headers like `X-Filter`).
+ * Non-string values are JSON-serialized before the request is sent.
+ */
+export type HeaderValue = string | number | boolean | null | undefined | object
+export type HeadersInit = Array<[string, HeaderValue]> | Record<string, HeaderValue>
+
 /**
  * Subset of FetchRequestConfig
  */
@@ -14,8 +21,9 @@ export type RequestConfig<TData = unknown> = {
   data?: TData | FormData
   responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'
   signal?: AbortSignal
-  headers?: [string, string][] | Record<string, string>
+  headers?: HeadersInit
   credentials?: RequestCredentials
+  contentType?: string
 }
 
 /**
@@ -50,6 +58,93 @@ export const mergeConfig = <T extends RequestConfig>(...configs: Array<Partial<T
   }, {})
 }
 
+/**
+ * Serializes header values into the string form `fetch` expects.
+ * Objects (including arrays) are JSON-stringified so spec-defined object
+ * headers like `X-Filter` are sent in their canonical JSON-string form.
+ */
+function serializeHeaders(headers: HeadersInit | undefined): Record<string, string> {
+  if (!headers) return {}
+  const entries = Array.isArray(headers) ? headers : Object.entries(headers)
+  const result: Record<string, string> = {}
+  for (const [key, value] of entries) {
+    if (value === undefined || value === null) continue
+    result[key] = typeof value === 'string' ? value : typeof value === 'object' ? JSON.stringify(value) : String(value)
+  }
+  return result
+}
+
+/**
+ * Serializes the request body into the form `fetch` expects.
+ * `FormData`, `URLSearchParams`, `Blob`, `ArrayBuffer` and string bodies are passed through
+ * untouched. Plain objects are encoded as `URLSearchParams` for `application/x-www-form-urlencoded`
+ * and JSON-serialized otherwise.
+ */
+function serializeBody(data: unknown, contentType?: string): BodyInit | undefined {
+  if (data === undefined || data === null) return undefined
+  if (data instanceof FormData || data instanceof URLSearchParams || data instanceof Blob || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {
+    return data as BodyInit
+  }
+  if (typeof data === 'string') return data
+  if (contentType?.includes('application/x-www-form-urlencoded')) {
+    return new URLSearchParams(data as Record<string, string>)
+  }
+  return JSON.stringify(data)
+}
+
+/**
+ * Picks a `responseType` from a `Content-Type` header, or `undefined` when it is not recognized.
+ */
+function detectResponseType(contentType: string | null): RequestConfig['responseType'] {
+  if (!contentType) return undefined
+  if (contentType.includes('application/json') || contentType.includes('text/json')) return 'json'
+  if (contentType.includes('text/')) return 'text'
+  if (contentType.includes('image/') || contentType.includes('application/octet-stream')) return 'blob'
+  return undefined
+}
+
+/**
+ * Parses a `fetch` response body.
+ *
+ * - Empty responses (204/205/304 or no body) resolve to `{}`.
+ * - An explicit `responseType` (or one detected from the `Content-Type` header) forces the matching
+ *   `Response` method.
+ * - As a last resort the body is read as text and `JSON.parse`d, falling back to the raw text.
+ */
+async function parseResponse<TData>(response: Response, responseType?: RequestConfig['responseType']): Promise<TData> {
+  if ([204, 205, 304].includes(response.status) || !response.body) {
+    return {} as TData
+  }
+
+  switch (responseType ?? detectResponseType(response.headers.get('Content-Type'))) {
+    case 'text':
+    case 'document':
+      return (await response.text()) as TData
+    case 'blob':
+      return (await response.blob()) as TData
+    case 'arraybuffer':
+      return (await response.arrayBuffer()) as TData
+    case 'stream':
+      return response.body as TData
+    case 'json':
+      return (await response.json()) as TData
+  }
+
+  // Explicit but unrecognized responseType keeps the JSON default; otherwise read text and parse it.
+  if (responseType) {
+    return (await response.json()) as TData
+  }
+  const text = await response.text()
+  if (!text) {
+    return {} as TData
+  }
+  try {
+    return JSON.parse(text) as TData
+  } catch {
+    return text as TData
+  }
+}
+
 export type ResponseErrorConfig<TError = unknown> = TError
 
 export type Client = <TResponseData, _TError = unknown, TRequestData = unknown>(
@@ -77,18 +172,23 @@ export const client = async <TResponseData, _TError = unknown, RequestData = unk
     targetUrl += `?${normalizedParams}`
   }
 
-  const response = await fetch(targetUrl, {
+  const headers: Record<string, string> = {
+    ...(config.contentType && config.contentType !== 'multipart/form-data' ? { 'Content-Type': config.contentType } : {}),
+    ...serializeHeaders(config.headers),
+  }
+
+  const response = await globalThis.fetch(targetUrl, {
     credentials: config.credentials || 'same-origin',
     method: config.method?.toUpperCase(),
-    body: config.data instanceof FormData ? config.data : JSON.stringify(config.data),
+    body: serializeBody(config.data, headers['Content-Type'] ?? headers['content-type']),
     signal: config.signal,
-    headers: config.headers,
+    headers,
   })
 
-  const data = [204, 205, 304].includes(response.status) || !response.body ? {} : await response.json()
+  const data = await parseResponse<TResponseData>(response, config.responseType)
 
   return {
-    data: data as TResponseData,
+    data,
     status: response.status,
     statusText: response.statusText,
     headers: response.headers as Headers,

package/src/components/ClassClient.tsx

@@ -1,19 +1,20 @@
+import { buildOperationComments, getContentTypeInfo, getOperationParameters } from '@internals/shared'
 import { buildJSDoc, URLPath } from '@internals/utils'
-import type { ast } from '@kubb/core'
+import { ast } from '@kubb/core'
 import type { ResolverTs } from '@kubb/plugin-ts'
 import { functionPrinter } from '@kubb/plugin-ts'
 import type { ResolverZod } from '@kubb/plugin-zod'
 import { File } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
 import type { PluginClient } from '../types.ts'
-import { buildClassClientParams, buildFormDataLine, buildGenerics, buildHeaders, buildRequestDataLine, buildReturnStatement, getComments } from '../utils.ts'
-import { Client } from './Client.tsx'
+import { buildClassClientParams, buildFormDataLine, buildGenerics, buildHeaders, buildRequestDataLine, buildReturnStatement } from '../utils.ts'
+import { buildClientParamsNode } from './Client.tsx'
 
 type OperationData = {
   node: ast.OperationNode
   name: string
   tsResolver: ResolverTs
-  zodResolver?: ResolverZod
+  zodResolver?: ResolverZod | null
 }
 
 type Props = {
@@ -21,7 +22,7 @@ type Props = {
   isExportable?: boolean
   isIndexable?: boolean
   operations: Array<OperationData>
-  baseURL: string | undefined
+  baseURL: string | null | undefined
   dataReturnType: PluginClient['resolvedOptions']['dataReturnType']
   paramsCasing: PluginClient['resolvedOptions']['paramsCasing']
   paramsType: PluginClient['resolvedOptions']['pathParamsType']
@@ -34,8 +35,8 @@ type GenerateMethodProps = {
   node: ast.OperationNode
   name: string
   tsResolver: ResolverTs
-  zodResolver?: ResolverZod
-  baseURL: string | undefined
+  zodResolver?: ResolverZod | null
+  baseURL: string | null | undefined
   dataReturnType: PluginClient['resolvedOptions']['dataReturnType']
   parser: PluginClient['resolvedOptions']['parser'] | undefined
   paramsType: PluginClient['resolvedOptions']['paramsType']
@@ -57,26 +58,25 @@ function generateMethod({
   paramsCasing,
   pathParamsType,
 }: GenerateMethodProps): string {
+  if (!ast.isHttpOperationNode(node)) return ''
   const path = new URLPath(node.path, { casing: paramsCasing })
-  const contentType = node.requestBody?.content?.[0]?.contentType ?? 'application/json'
-  const isFormData = contentType === 'multipart/form-data'
-  const headerParamsName =
-    node.parameters.filter((p) => p.in === 'header').length > 0
-      ? tsResolver.resolveHeaderParamsName(node, node.parameters.filter((p) => p.in === 'header')[0]!)
-      : undefined
-  const headers = buildHeaders(contentType, !!headerParamsName)
+  const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node)
+  const isFormData = !isMultipleContentTypes && contentType === 'multipart/form-data'
+  const { header: headerParams } = getOperationParameters(node)
+  const headerParamsName = headerParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, headerParams[0]!) : null
+  const headers = isMultipleContentTypes ? (headerParamsName ? ['...headers'] : []) : buildHeaders(contentType, !!headerParamsName)
   const generics = buildGenerics(node, tsResolver)
-  const paramsNode = ClassClient.getParams({ paramsType, paramsCasing, pathParamsType, node, tsResolver, isConfigurable: true })
+  const paramsNode = buildClientParamsNode({ paramsType, paramsCasing, pathParamsType, node, tsResolver, isConfigurable: true })
   const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
-  const clientParams = buildClassClientParams({ node, path, baseURL, tsResolver, isFormData, headers })
-  const jsdoc = buildJSDoc(getComments(node))
+  const clientParams = buildClassClientParams({ node, path, baseURL, tsResolver, isFormData, isMultipleContentTypes, hasFormData, headers })
+  const jsdoc = buildJSDoc(buildOperationComments(node, { link: 'urlPath', linkPosition: 'beforeDeprecated', splitLines: true }))
 
   const requestDataLine = buildRequestDataLine({ parser, node, zodResolver })
-  const formDataLine = buildFormDataLine(isFormData, !!node.requestBody?.content?.[0]?.schema)
+  const formDataLine = buildFormDataLine(isFormData || (isMultipleContentTypes && hasFormData), !!node.requestBody?.content?.[0]?.schema)
   const returnStatement = buildReturnStatement({ dataReturnType, parser, node, zodResolver })
 
   const methodBody = [
-    'const { client: request = fetch, ...requestConfig } = mergeConfig(this.#config, config)',
+    `const { client: request = client, ${isMultipleContentTypes ? `contentType = ${JSON.stringify(contentType)}, ` : ''}...requestConfig } = mergeConfig(this.#config, config)`,
     '',
     requestDataLine,
     formDataLine,
@@ -135,4 +135,3 @@ ${methods.join('\n\n')}
     </File.Source>
   )
 }
-ClassClient.getParams = Client.getParams

package/src/components/Client.tsx

@@ -1,3 +1,12 @@
+import {
+  buildOperationComments,
+  buildParamsMapping,
+  buildRequestConfigType,
+  getContentTypeInfo,
+  getOperationParameters,
+  getResponseType,
+  resolveSuccessNames,
+} from '@internals/shared'
 import { isValidVarName, URLPath } from '@internals/utils'
 import { ast } from '@kubb/core'
 import type { ResolverTs } from '@kubb/plugin-ts'
@@ -7,8 +16,7 @@ import { File, Function } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
 import { createFunctionParams } from '../functionParams.ts'
 import type { PluginClient } from '../types.ts'
-import { buildParamsMapping, getComments } from '../utils.ts'
-import { Url } from './Url.tsx'
+import { buildUrlParamsNode } from './Url.tsx'
 
 type Props = {
   name: string
@@ -18,7 +26,7 @@ type Props = {
   isConfigurable?: boolean
   returnType?: string
 
-  baseURL: string | undefined
+  baseURL: string | null | undefined
   dataReturnType: PluginClient['resolvedOptions']['dataReturnType']
   paramsCasing: PluginClient['resolvedOptions']['paramsCasing']
   paramsType: PluginClient['resolvedOptions']['pathParamsType']
@@ -26,7 +34,7 @@ type Props = {
   parser: PluginClient['resolvedOptions']['parser'] | undefined
   node: ast.OperationNode
   tsResolver: ResolverTs
-  zodResolver?: ResolverZod
+  zodResolver?: ResolverZod | null
   children?: KubbReactNode
 }
 
@@ -41,26 +49,33 @@ type GetParamsProps = {
 
 const declarationPrinter = functionPrinter({ mode: 'declaration' })
 
-function getParams({ paramsType, paramsCasing, pathParamsType, node, tsResolver, isConfigurable }: GetParamsProps): ast.FunctionParametersNode {
-  const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : undefined
-
+export function buildClientParamsNode({
+  paramsType,
+  paramsCasing,
+  pathParamsType,
+  node,
+  tsResolver,
+  isConfigurable,
+}: GetParamsProps): ast.FunctionParametersNode {
   return ast.createOperationParams(node, {
     paramsType,
     pathParamsType: paramsType === 'object' ? 'object' : pathParamsType === 'object' ? 'object' : 'inline',
     paramsCasing,
     resolver: tsResolver,
-    extraParams: isConfigurable
-      ? [
-          ast.createFunctionParameter({
-            name: 'config',
-            type: ast.createParamsType({
-              variant: 'reference',
-              name: requestName ? `Partial<RequestConfig<${requestName}>> & { client?: Client }` : 'Partial<RequestConfig> & { client?: Client }',
+    extraParams: [
+      ...(isConfigurable
+        ? [
+            ast.createFunctionParameter({
+              name: 'config',
+              type: ast.createParamsType({
+                variant: 'reference',
+                name: buildRequestConfigType(node, tsResolver),
+              }),
+              default: '{}',
             }),
-            default: '{}',
-          }),
-        ]
-      : [],
+          ]
+        : []),
+    ],
   })
 }
 
@@ -82,28 +97,27 @@ export function Client({
   children,
   isConfigurable = true,
 }: Props): KubbReactNode {
+  if (!ast.isHttpOperationNode(node)) return null
   const path = new URLPath(node.path)
-  const contentType = node.requestBody?.content?.[0]?.contentType ?? 'application/json'
-  const isFormData = contentType === 'multipart/form-data'
+  const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node)
+  const isFormData = !isMultipleContentTypes && contentType === 'multipart/form-data'
+  const responseType = getResponseType(node)
 
-  const originalPathParams = node.parameters.filter((p) => p.in === 'path')
-  const casedPathParams = ast.caseParams(originalPathParams, paramsCasing)
-  const originalQueryParams = node.parameters.filter((p) => p.in === 'query')
-  const casedQueryParams = ast.caseParams(originalQueryParams, paramsCasing)
-  const originalHeaderParams = node.parameters.filter((p) => p.in === 'header')
-  const casedHeaderParams = ast.caseParams(originalHeaderParams, paramsCasing)
+  const { path: originalPathParams, query: originalQueryParams, header: originalHeaderParams } = getOperationParameters(node)
+  const { path: casedPathParams, query: casedQueryParams, header: casedHeaderParams } = getOperationParameters(node, { paramsCasing })
 
-  const pathParamsMapping = paramsCasing && !urlName ? buildParamsMapping(originalPathParams, casedPathParams) : undefined
-  const queryParamsMapping = paramsCasing ? buildParamsMapping(originalQueryParams, casedQueryParams) : undefined
-  const headerParamsMapping = paramsCasing ? buildParamsMapping(originalHeaderParams, casedHeaderParams) : undefined
+  const pathParamsMapping = paramsCasing && !urlName ? buildParamsMapping(originalPathParams, casedPathParams) : null
+  const queryParamsMapping = paramsCasing ? buildParamsMapping(originalQueryParams, casedQueryParams) : null
+  const headerParamsMapping = paramsCasing ? buildParamsMapping(originalHeaderParams, casedHeaderParams) : null
 
-  const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : undefined
-  const responseName = tsResolver.resolveResponseName(node)
-  const queryParamsName = originalQueryParams.length > 0 ? tsResolver.resolveQueryParamsName(node, originalQueryParams[0]!) : undefined
-  const headerParamsName = originalHeaderParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, originalHeaderParams[0]!) : undefined
+  const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : null
+  const successNames = resolveSuccessNames(node, tsResolver)
+  const responseName = successNames.length > 0 ? successNames.join(' | ') : tsResolver.resolveResponseName(node)
+  const queryParamsName = originalQueryParams.length > 0 ? tsResolver.resolveQueryParamsName(node, originalQueryParams[0]!) : null
+  const headerParamsName = originalHeaderParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, originalHeaderParams[0]!) : null
 
-  const zodResponseName = zodResolver && parser === 'zod' ? zodResolver.resolveResponseName?.(node) : undefined
-  const zodRequestName = zodResolver && parser === 'zod' && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : undefined
+  const zodResponseName = zodResolver && parser === 'zod' ? zodResolver.resolveResponseName?.(node) : null
+  const zodRequestName = zodResolver && parser === 'zod' && node.requestBody?.content?.[0]?.schema ? zodResolver.resolveDataName?.(node) : null
 
   const errorNames = node.responses
     .filter((r) => {
@@ -113,14 +127,14 @@ export function Client({
     .map((r) => tsResolver.resolveResponseStatusName(node, r.statusCode))
 
   const headers = [
-    contentType !== 'application/json' && contentType !== 'multipart/form-data' ? `'Content-Type': '${contentType}'` : undefined,
-    headerParamsName ? (headerParamsMapping ? '...mappedHeaders' : '...headers') : undefined,
+    !isMultipleContentTypes && contentType !== 'application/json' && contentType !== 'multipart/form-data' ? `'Content-Type': '${contentType}'` : null,
+    headerParamsName ? (headerParamsMapping ? '...mappedHeaders' : '...headers') : null,
   ].filter(Boolean)
 
   const TError = `ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(' | ') : 'Error'}>`
 
   const generics = [responseName, TError, requestName || 'unknown'].filter(Boolean)
-  const paramsNode = getParams({
+  const paramsNode = buildClientParamsNode({
     paramsType,
     paramsCasing,
     pathParamsType,
@@ -130,7 +144,7 @@ export function Client({
   })
   const paramsSignature = declarationPrinter.print(paramsNode) ?? ''
 
-  const urlParamsNode = Url.getParams({
+  const urlParamsNode = buildUrlParamsNode({
     paramsType,
     paramsCasing,
     pathParamsType,
@@ -155,23 +169,30 @@ export function Client({
             ? {
                 value: `\`${baseURL}\``,
               }
-            : undefined,
-        params: queryParamsName ? (queryParamsMapping ? { value: 'mappedParams' } : {}) : undefined,
+            : null,
+        params: queryParamsName ? (queryParamsMapping ? { value: 'mappedParams' } : {}) : null,
         data: requestName
           ? {
-              value: isFormData ? 'formData as FormData' : 'requestData',
+              value:
+                isMultipleContentTypes && hasFormData
+                  ? "contentType === 'multipart/form-data' ? formData as FormData : requestData"
+                  : isFormData
+                    ? 'formData as FormData'
+                    : 'requestData',
             }
-          : undefined,
+          : null,
+        contentType: isConfigurable && isMultipleContentTypes ? {} : null,
+        responseType: responseType ? { value: JSON.stringify(responseType) } : null,
         requestConfig: isConfigurable
           ? {
               mode: 'inlineSpread',
             }
-          : undefined,
+          : null,
         headers: headers.length
           ? {
               value: isConfigurable ? `{ ${headers.join(', ')}, ...requestConfig.headers }` : `{ ${headers.join(', ')} }`,
             }
-          : undefined,
+          : null,
       },
     },
   })
@@ -182,8 +203,8 @@ export function Client({
     <>
       {dataReturnType === 'full' && parser === 'zod' && zodResponseName && `return {...res, data: ${zodResponseName}.parse(res.data)}`}
       {dataReturnType === 'data' && parser === 'zod' && zodResponseName && `return ${zodResponseName}.parse(res.data)`}
-      {dataReturnType === 'full' && parser === 'client' && 'return res'}
-      {dataReturnType === 'data' && parser === 'client' && 'return res.data'}
+      {dataReturnType === 'full' && parser !== 'zod' && 'return res'}
+      {dataReturnType === 'data' && parser !== 'zod' && 'return res.data'}
     </>
   )
 
@@ -198,11 +219,13 @@ export function Client({
           export={isExportable}
           params={paramsSignature}
           JSDoc={{
-            comments: getComments(node),
+            comments: buildOperationComments(node, { link: 'urlPath', linkPosition: 'beforeDeprecated', splitLines: true }),
           }}
           returnType={returnType}
         >
-          {isConfigurable ? 'const { client: request = fetch, ...requestConfig } = config' : ''}
+          {isConfigurable
+            ? `const { client: request = client, ${isMultipleContentTypes ? `contentType = ${JSON.stringify(contentType)}, ` : ''}...requestConfig } = config`
+            : ''}
           <br />
           <br />
           {pathParamsMapping &&
@@ -236,11 +259,11 @@ export function Client({
           )}
           {parser === 'zod' && zodRequestName ? `const requestData = ${zodRequestName}.parse(data)` : requestName && 'const requestData = data'}
           <br />
-          {isFormData && requestName && 'const formData = buildFormData(requestData)'}
+          {(isFormData || (isMultipleContentTypes && hasFormData)) && requestName && 'const formData = buildFormData(requestData)'}
           <br />
           {isConfigurable
             ? `const res = await request<${generics.join(', ')}>(${clientParams.toCall()})`
-            : `const res = await fetch<${generics.join(', ')}>(${clientParams.toCall()})`}
+            : `const res = await client<${generics.join(', ')}>(${clientParams.toCall()})`}
           <br />
           {childrenElement}
         </Function>
@@ -248,5 +271,3 @@ export function Client({
     </>
   )
 }
-
-Client.getParams = getParams

package/src/components/Operations.tsx

@@ -1,5 +1,5 @@
 import { URLPath } from '@internals/utils'
-import type { ast } from '@kubb/core'
+import { ast } from '@kubb/core'
 import { Const, File } from '@kubb/renderer-jsx'
 import type { KubbReactNode } from '@kubb/renderer-jsx/types'
 
@@ -12,6 +12,7 @@ export function Operations({ name, nodes }: OperationsProps): KubbReactNode {
   const operationsObject: Record<string, { path: string; method: string }> = {}
 
   nodes.forEach((node) => {
+    if (!ast.isHttpOperationNode(node)) return
     operationsObject[node.operationId] = {
       path: new URLPath(node.path).URL,
       method: node.method.toLowerCase(),