@kubb/plugin-client 5.0.0-beta.30 → 5.0.0-beta.33

package/dist/templates/clients/fetch.source.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/templates/clients/fetch.source.ts
-const source = "/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded headers like `X-Filter` in the Linode API).\n * Non-string values are JSON-serialized before the request is sent.\n */\nexport type HeaderValue = string | number | boolean | null | undefined | object\nexport type HeadersInit = Array<[string, HeaderValue]> | Record<string, HeaderValue>\n\n/**\n * Subset of FetchRequestConfig\n */\nexport type RequestConfig<TData = unknown> = {\n  baseURL?: string\n  url?: string\n  method?: 'GET' | 'PUT' | 'PATCH' | 'POST' | 'DELETE' | 'OPTIONS' | 'HEAD'\n  params?: unknown\n  data?: TData | FormData\n  responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'\n  signal?: AbortSignal\n  headers?: HeadersInit\n  credentials?: RequestCredentials\n  contentType?: string\n}\n\n/**\n * Subset of FetchResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nlet _config: Partial<RequestConfig> = {}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: Partial<RequestConfig>) => {\n  _config = config\n  return getConfig()\n}\n\nexport const mergeConfig = <T extends RequestConfig>(...configs: Array<Partial<T>>): Partial<T> => {\n  return configs.reduce<Partial<T>>((merged, config) => {\n    return {\n      ...merged,\n      ...config,\n      headers: {\n        ...(Array.isArray(merged.headers) ? Object.fromEntries(merged.headers) : merged.headers),\n        ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : config.headers),\n      },\n    }\n  }, {})\n}\n\n/**\n * Serializes header values into the string form `fetch` expects.\n * Objects (including arrays) are JSON-stringified so spec-defined object headers like `X-Filter`\n * are sent in their canonical JSON-string form rather than `[object Object]`.\n */\nfunction serializeHeaders(headers: HeadersInit | undefined): Record<string, string> {\n  if (!headers) return {}\n  const entries = Array.isArray(headers) ? headers : Object.entries(headers)\n  const result: Record<string, string> = {}\n  for (const [key, value] of entries) {\n    if (value === undefined || value === null) continue\n    result[key] = typeof value === 'string' ? value : typeof value === 'object' ? JSON.stringify(value) : String(value)\n  }\n  return result\n}\n\nexport type ResponseErrorConfig<TError = unknown> = TError\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nexport const client = async <TData, _TError = unknown, TVariables = unknown>(\n  paramsConfig: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const normalizedParams = new URLSearchParams()\n\n  const config = mergeConfig(getConfig(), paramsConfig)\n\n  Object.entries(config.params || {}).forEach(([key, value]) => {\n    if (value !== undefined) {\n      normalizedParams.append(key, value === null ? 'null' : value.toString())\n    }\n  })\n\n  let targetUrl = [config.baseURL, config.url].filter(Boolean).join('')\n\n  if (config.params) {\n    targetUrl += `?${normalizedParams}`\n  }\n\n  const response = await globalThis.fetch(targetUrl, {\n    credentials: config.credentials || 'same-origin',\n    method: config.method?.toUpperCase(),\n    body: config.data instanceof FormData ? config.data : JSON.stringify(config.data),\n    signal: config.signal,\n    headers: {\n      ...(config.contentType && config.contentType !== 'multipart/form-data' ? { 'Content-Type': config.contentType } : {}),\n      ...serializeHeaders(config.headers),\n    },\n  })\n\n  const data = [204, 205, 304].includes(response.status) || !response.body ? {} : await response.json()\n\n  return {\n    data: data as TData,\n    status: response.status,\n    statusText: response.statusText,\n    headers: response.headers as Headers,\n  }\n}\n\nclient.getConfig = getConfig\nclient.setConfig = setConfig\n";
+const source = "/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded headers like `X-Filter` in the Linode API).\n * Non-string values are JSON-serialized before the request is sent.\n */\nexport type HeaderValue = string | number | boolean | null | undefined | object\nexport type HeadersInit = Array<[string, HeaderValue]> | Record<string, HeaderValue>\n\n/**\n * Subset of FetchRequestConfig\n */\nexport type RequestConfig<TData = unknown> = {\n  baseURL?: string\n  url?: string\n  method?: 'GET' | 'PUT' | 'PATCH' | 'POST' | 'DELETE' | 'OPTIONS' | 'HEAD'\n  params?: unknown\n  data?: TData | FormData\n  responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'\n  signal?: AbortSignal\n  headers?: HeadersInit\n  credentials?: RequestCredentials\n  contentType?: string\n}\n\n/**\n * Subset of FetchResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nlet _config: Partial<RequestConfig> = {}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: Partial<RequestConfig>) => {\n  _config = config\n  return getConfig()\n}\n\nexport const mergeConfig = <T extends RequestConfig>(...configs: Array<Partial<T>>): Partial<T> => {\n  return configs.reduce<Partial<T>>((merged, config) => {\n    return {\n      ...merged,\n      ...config,\n      headers: {\n        ...(Array.isArray(merged.headers) ? Object.fromEntries(merged.headers) : merged.headers),\n        ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : config.headers),\n      },\n    }\n  }, {})\n}\n\n/**\n * Serializes header values into the string form `fetch` expects.\n * Objects (including arrays) are JSON-stringified so spec-defined object headers like `X-Filter`\n * are sent in their canonical JSON-string form rather than `[object Object]`.\n */\nfunction serializeHeaders(headers: HeadersInit | undefined): Record<string, string> {\n  if (!headers) return {}\n  const entries = Array.isArray(headers) ? headers : Object.entries(headers)\n  const result: Record<string, string> = {}\n  for (const [key, value] of entries) {\n    if (value === undefined || value === null) continue\n    result[key] = typeof value === 'string' ? value : typeof value === 'object' ? JSON.stringify(value) : String(value)\n  }\n  return result\n}\n\n/**\n * Serializes the request body into the form `fetch` expects.\n * `FormData`, `URLSearchParams`, `Blob`, `ArrayBuffer` and string bodies are passed through\n * untouched. Plain objects are encoded as `URLSearchParams` for `application/x-www-form-urlencoded`\n * and JSON-serialized otherwise.\n */\nfunction serializeBody(data: unknown, contentType?: string): BodyInit | undefined {\n  if (data === undefined || data === null) return undefined\n  if (data instanceof FormData || data instanceof URLSearchParams || data instanceof Blob || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {\n    return data as BodyInit\n  }\n  if (typeof data === 'string') return data\n  if (contentType?.includes('application/x-www-form-urlencoded')) {\n    return new URLSearchParams(data as Record<string, string>)\n  }\n  return JSON.stringify(data)\n}\n\n/**\n * Picks a `responseType` from a `Content-Type` header, or `undefined` when it is not recognized.\n */\nfunction detectResponseType(contentType: string | null): RequestConfig['responseType'] {\n  if (!contentType) return undefined\n  if (contentType.includes('application/json') || contentType.includes('text/json')) return 'json'\n  if (contentType.includes('text/')) return 'text'\n  if (contentType.includes('image/') || contentType.includes('application/octet-stream')) return 'blob'\n  return undefined\n}\n\n/**\n * Parses a `fetch` response body.\n *\n * - Empty responses (204/205/304 or no body) resolve to `{}`.\n * - An explicit `responseType` (or one detected from the `Content-Type` header) forces the matching\n *   `Response` method.\n * - As a last resort the body is read as text and `JSON.parse`d, falling back to the raw text.\n */\nasync function parseResponse<TData>(response: Response, responseType?: RequestConfig['responseType']): Promise<TData> {\n  if ([204, 205, 304].includes(response.status) || !response.body) {\n    return {} as TData\n  }\n\n  switch (responseType ?? detectResponseType(response.headers.get('Content-Type'))) {\n    case 'text':\n    case 'document':\n      return (await response.text()) as TData\n    case 'blob':\n      return (await response.blob()) as TData\n    case 'arraybuffer':\n      return (await response.arrayBuffer()) as TData\n    case 'stream':\n      return response.body as TData\n    case 'json':\n      return (await response.json()) as TData\n  }\n\n  // Explicit but unrecognized responseType keeps the JSON default; otherwise read text and parse it.\n  if (responseType) {\n    return (await response.json()) as TData\n  }\n  const text = await response.text()\n  if (!text) {\n    return {} as TData\n  }\n  try {\n    return JSON.parse(text) as TData\n  } catch {\n    return text as TData\n  }\n}\n\nexport type ResponseErrorConfig<TError = unknown> = TError\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nexport const client = async <TData, _TError = unknown, TVariables = unknown>(\n  paramsConfig: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const normalizedParams = new URLSearchParams()\n\n  const config = mergeConfig(getConfig(), paramsConfig)\n\n  Object.entries(config.params || {}).forEach(([key, value]) => {\n    if (value !== undefined) {\n      normalizedParams.append(key, value === null ? 'null' : value.toString())\n    }\n  })\n\n  let targetUrl = [config.baseURL, config.url].filter(Boolean).join('')\n\n  if (config.params) {\n    targetUrl += `?${normalizedParams}`\n  }\n\n  const headers: Record<string, string> = {\n    ...(config.contentType && config.contentType !== 'multipart/form-data' ? { 'Content-Type': config.contentType } : {}),\n    ...serializeHeaders(config.headers),\n  }\n\n  const response = await globalThis.fetch(targetUrl, {\n    credentials: config.credentials || 'same-origin',\n    method: config.method?.toUpperCase(),\n    body: serializeBody(config.data, headers['Content-Type'] ?? headers['content-type']),\n    signal: config.signal,\n    headers,\n  })\n\n  const data = await parseResponse<TData>(response, config.responseType)\n\n  return {\n    data,\n    status: response.status,\n    statusText: response.statusText,\n    headers: response.headers as Headers,\n  }\n}\n\nclient.getConfig = getConfig\nclient.setConfig = setConfig\n";
 //#endregion
 exports.source = source;
 

package/dist/templates/clients/fetch.source.js

@@ -1,5 +1,5 @@
 //#region src/templates/clients/fetch.source.ts
-const source = "/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded headers like `X-Filter` in the Linode API).\n * Non-string values are JSON-serialized before the request is sent.\n */\nexport type HeaderValue = string | number | boolean | null | undefined | object\nexport type HeadersInit = Array<[string, HeaderValue]> | Record<string, HeaderValue>\n\n/**\n * Subset of FetchRequestConfig\n */\nexport type RequestConfig<TData = unknown> = {\n  baseURL?: string\n  url?: string\n  method?: 'GET' | 'PUT' | 'PATCH' | 'POST' | 'DELETE' | 'OPTIONS' | 'HEAD'\n  params?: unknown\n  data?: TData | FormData\n  responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'\n  signal?: AbortSignal\n  headers?: HeadersInit\n  credentials?: RequestCredentials\n  contentType?: string\n}\n\n/**\n * Subset of FetchResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nlet _config: Partial<RequestConfig> = {}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: Partial<RequestConfig>) => {\n  _config = config\n  return getConfig()\n}\n\nexport const mergeConfig = <T extends RequestConfig>(...configs: Array<Partial<T>>): Partial<T> => {\n  return configs.reduce<Partial<T>>((merged, config) => {\n    return {\n      ...merged,\n      ...config,\n      headers: {\n        ...(Array.isArray(merged.headers) ? Object.fromEntries(merged.headers) : merged.headers),\n        ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : config.headers),\n      },\n    }\n  }, {})\n}\n\n/**\n * Serializes header values into the string form `fetch` expects.\n * Objects (including arrays) are JSON-stringified so spec-defined object headers like `X-Filter`\n * are sent in their canonical JSON-string form rather than `[object Object]`.\n */\nfunction serializeHeaders(headers: HeadersInit | undefined): Record<string, string> {\n  if (!headers) return {}\n  const entries = Array.isArray(headers) ? headers : Object.entries(headers)\n  const result: Record<string, string> = {}\n  for (const [key, value] of entries) {\n    if (value === undefined || value === null) continue\n    result[key] = typeof value === 'string' ? value : typeof value === 'object' ? JSON.stringify(value) : String(value)\n  }\n  return result\n}\n\nexport type ResponseErrorConfig<TError = unknown> = TError\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nexport const client = async <TData, _TError = unknown, TVariables = unknown>(\n  paramsConfig: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const normalizedParams = new URLSearchParams()\n\n  const config = mergeConfig(getConfig(), paramsConfig)\n\n  Object.entries(config.params || {}).forEach(([key, value]) => {\n    if (value !== undefined) {\n      normalizedParams.append(key, value === null ? 'null' : value.toString())\n    }\n  })\n\n  let targetUrl = [config.baseURL, config.url].filter(Boolean).join('')\n\n  if (config.params) {\n    targetUrl += `?${normalizedParams}`\n  }\n\n  const response = await globalThis.fetch(targetUrl, {\n    credentials: config.credentials || 'same-origin',\n    method: config.method?.toUpperCase(),\n    body: config.data instanceof FormData ? config.data : JSON.stringify(config.data),\n    signal: config.signal,\n    headers: {\n      ...(config.contentType && config.contentType !== 'multipart/form-data' ? { 'Content-Type': config.contentType } : {}),\n      ...serializeHeaders(config.headers),\n    },\n  })\n\n  const data = [204, 205, 304].includes(response.status) || !response.body ? {} : await response.json()\n\n  return {\n    data: data as TData,\n    status: response.status,\n    statusText: response.statusText,\n    headers: response.headers as Headers,\n  }\n}\n\nclient.getConfig = getConfig\nclient.setConfig = setConfig\n";
+const source = "/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded headers like `X-Filter` in the Linode API).\n * Non-string values are JSON-serialized before the request is sent.\n */\nexport type HeaderValue = string | number | boolean | null | undefined | object\nexport type HeadersInit = Array<[string, HeaderValue]> | Record<string, HeaderValue>\n\n/**\n * Subset of FetchRequestConfig\n */\nexport type RequestConfig<TData = unknown> = {\n  baseURL?: string\n  url?: string\n  method?: 'GET' | 'PUT' | 'PATCH' | 'POST' | 'DELETE' | 'OPTIONS' | 'HEAD'\n  params?: unknown\n  data?: TData | FormData\n  responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'\n  signal?: AbortSignal\n  headers?: HeadersInit\n  credentials?: RequestCredentials\n  contentType?: string\n}\n\n/**\n * Subset of FetchResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nlet _config: Partial<RequestConfig> = {}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: Partial<RequestConfig>) => {\n  _config = config\n  return getConfig()\n}\n\nexport const mergeConfig = <T extends RequestConfig>(...configs: Array<Partial<T>>): Partial<T> => {\n  return configs.reduce<Partial<T>>((merged, config) => {\n    return {\n      ...merged,\n      ...config,\n      headers: {\n        ...(Array.isArray(merged.headers) ? Object.fromEntries(merged.headers) : merged.headers),\n        ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : config.headers),\n      },\n    }\n  }, {})\n}\n\n/**\n * Serializes header values into the string form `fetch` expects.\n * Objects (including arrays) are JSON-stringified so spec-defined object headers like `X-Filter`\n * are sent in their canonical JSON-string form rather than `[object Object]`.\n */\nfunction serializeHeaders(headers: HeadersInit | undefined): Record<string, string> {\n  if (!headers) return {}\n  const entries = Array.isArray(headers) ? headers : Object.entries(headers)\n  const result: Record<string, string> = {}\n  for (const [key, value] of entries) {\n    if (value === undefined || value === null) continue\n    result[key] = typeof value === 'string' ? value : typeof value === 'object' ? JSON.stringify(value) : String(value)\n  }\n  return result\n}\n\n/**\n * Serializes the request body into the form `fetch` expects.\n * `FormData`, `URLSearchParams`, `Blob`, `ArrayBuffer` and string bodies are passed through\n * untouched. Plain objects are encoded as `URLSearchParams` for `application/x-www-form-urlencoded`\n * and JSON-serialized otherwise.\n */\nfunction serializeBody(data: unknown, contentType?: string): BodyInit | undefined {\n  if (data === undefined || data === null) return undefined\n  if (data instanceof FormData || data instanceof URLSearchParams || data instanceof Blob || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {\n    return data as BodyInit\n  }\n  if (typeof data === 'string') return data\n  if (contentType?.includes('application/x-www-form-urlencoded')) {\n    return new URLSearchParams(data as Record<string, string>)\n  }\n  return JSON.stringify(data)\n}\n\n/**\n * Picks a `responseType` from a `Content-Type` header, or `undefined` when it is not recognized.\n */\nfunction detectResponseType(contentType: string | null): RequestConfig['responseType'] {\n  if (!contentType) return undefined\n  if (contentType.includes('application/json') || contentType.includes('text/json')) return 'json'\n  if (contentType.includes('text/')) return 'text'\n  if (contentType.includes('image/') || contentType.includes('application/octet-stream')) return 'blob'\n  return undefined\n}\n\n/**\n * Parses a `fetch` response body.\n *\n * - Empty responses (204/205/304 or no body) resolve to `{}`.\n * - An explicit `responseType` (or one detected from the `Content-Type` header) forces the matching\n *   `Response` method.\n * - As a last resort the body is read as text and `JSON.parse`d, falling back to the raw text.\n */\nasync function parseResponse<TData>(response: Response, responseType?: RequestConfig['responseType']): Promise<TData> {\n  if ([204, 205, 304].includes(response.status) || !response.body) {\n    return {} as TData\n  }\n\n  switch (responseType ?? detectResponseType(response.headers.get('Content-Type'))) {\n    case 'text':\n    case 'document':\n      return (await response.text()) as TData\n    case 'blob':\n      return (await response.blob()) as TData\n    case 'arraybuffer':\n      return (await response.arrayBuffer()) as TData\n    case 'stream':\n      return response.body as TData\n    case 'json':\n      return (await response.json()) as TData\n  }\n\n  // Explicit but unrecognized responseType keeps the JSON default; otherwise read text and parse it.\n  if (responseType) {\n    return (await response.json()) as TData\n  }\n  const text = await response.text()\n  if (!text) {\n    return {} as TData\n  }\n  try {\n    return JSON.parse(text) as TData\n  } catch {\n    return text as TData\n  }\n}\n\nexport type ResponseErrorConfig<TError = unknown> = TError\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nexport const client = async <TData, _TError = unknown, TVariables = unknown>(\n  paramsConfig: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const normalizedParams = new URLSearchParams()\n\n  const config = mergeConfig(getConfig(), paramsConfig)\n\n  Object.entries(config.params || {}).forEach(([key, value]) => {\n    if (value !== undefined) {\n      normalizedParams.append(key, value === null ? 'null' : value.toString())\n    }\n  })\n\n  let targetUrl = [config.baseURL, config.url].filter(Boolean).join('')\n\n  if (config.params) {\n    targetUrl += `?${normalizedParams}`\n  }\n\n  const headers: Record<string, string> = {\n    ...(config.contentType && config.contentType !== 'multipart/form-data' ? { 'Content-Type': config.contentType } : {}),\n    ...serializeHeaders(config.headers),\n  }\n\n  const response = await globalThis.fetch(targetUrl, {\n    credentials: config.credentials || 'same-origin',\n    method: config.method?.toUpperCase(),\n    body: serializeBody(config.data, headers['Content-Type'] ?? headers['content-type']),\n    signal: config.signal,\n    headers,\n  })\n\n  const data = await parseResponse<TData>(response, config.responseType)\n\n  return {\n    data,\n    status: response.status,\n    statusText: response.statusText,\n    headers: response.headers as Headers,\n  }\n}\n\nclient.getConfig = getConfig\nclient.setConfig = setConfig\n";
 //#endregion
 export { source };
 

package/extension.yaml

@@ -315,31 +315,6 @@ options:
                       }),
                     ],
                   })
-  - name: contentType
-    type: "'application/json' | (string & {})"
-    required: false
-    description: |
-      Selects which request/response media type the generator reads from the OpenAPI spec.
-
-      When omitted, Kubb picks the first JSON-compatible media type it finds (`application/json`, `application/vnd.api+json`, anything ending in `+json`). Set this when your spec defines multiple media types for the same operation and you want a non-default one.
-    examples:
-      - name: JSON API media type
-        files:
-          - lang: typescript
-            twoslash: false
-            code: |
-              import { defineConfig } from 'kubb'
-              import { pluginTs } from '@kubb/plugin-ts'
-
-              export default defineConfig({
-                input: { path: './petStore.yaml' },
-                output: { path: './src/gen' },
-                plugins: [
-                  pluginTs({
-                    contentType: 'application/vnd.api+json',
-                  }),
-                ],
-              })
   - name: group
     type: Group
     required: false
@@ -710,13 +685,13 @@ options:
                 // ...
               }
   - name: parser
-    type: "'client' | 'zod'"
+    type: false | 'zod'
     required: false
-    default: "'client'"
+    default: 'false'
     description: |
       Runtime validator applied to the response body before it is returned to the caller.
 
-      - `'client'` (default) — no validation. The response is cast to the generated TypeScript type and returned as-is. Fastest path, trusts the API.
+      - `false` (default) — no validation. The client has no runtime parser; the response is cast to the generated TypeScript type and returned as-is. Fastest path, trusts the API.
       - `'zod'` — pipes the response through the Zod schema produced by `@kubb/plugin-zod`. Catches mismatches between spec and API at runtime, at the cost of a parse on every call.
 
       Use `'zod'` when you want a defensive boundary against drift between your OpenAPI spec and the live API. Requires `@kubb/plugin-zod` in the plugins list.
@@ -895,18 +870,18 @@ options:
 
               const petClient = new Pet()
               const pet = await petClient.getPetById({ petId: 1 })
-  - name: wrapper
+  - name: sdk
     type: '{ className: string }'
     required: false
     description: |
-      Generates a single top-level class that composes the per-tag client classes into one entry point. Only meaningful when `clientType: 'class'` (or `'staticClass'`) and `group: { type: 'tag' }` are also set.
+      Generates a single SDK class that composes the per-tag client classes into one entry point. Setting `sdk` automatically enables `clientType: 'class'`, so you only need to add `group: { type: 'tag' }` to split the clients per tag.
 
-      Use this when you want a single object to hand around your app (`api.pet.findById`, `api.user.login`) instead of importing each tag client separately.
+      Use this when you want a single object to hand around your app (`api.petController.findById`, `api.userController.login`) instead of importing each tag client separately.
     properties:
       - name: className
         type: string
         required: true
-        description: Name of the generated wrapper class — used as the export name and file name.
+        description: Name of the generated SDK class — used as the export name and file name.
         examples:
           - name: A composed PetStoreClient
             files:
@@ -925,9 +900,8 @@ options:
                       pluginTs(),
                       pluginClient({
                         output: { path: './clients' },
-                        clientType: 'class',
                         group: { type: 'tag' },
-                        wrapper: { className: 'PetStoreClient' },
+                        sdk: { className: 'PetStoreClient' },
                       }),
                     ],
                   })
@@ -936,19 +910,19 @@ options:
                 twoslash: false
                 code: |
                   import type { Client, RequestConfig } from './.kubb/client'
-                  import { Pet } from './petController/Pet'
-                  import { Store } from './storeController/Store'
-                  import { User } from './userController/User'
+                  import { petController } from './petController/petController'
+                  import { storeController } from './storeController/storeController'
+                  import { userController } from './userController/userController'
 
                   export class PetStoreClient {
-                    readonly pet: Pet
-                    readonly store: Store
-                    readonly user: User
+                    readonly petController: petController
+                    readonly storeController: storeController
+                    readonly userController: userController
 
                     constructor(config: Partial<RequestConfig> & { client?: Client } = {}) {
-                      this.pet = new Pet(config)
-                      this.store = new Store(config)
-                      this.user = new User(config)
+                      this.petController = new petController(config)
+                      this.storeController = new storeController(config)
+                      this.userController = new userController(config)
                     }
                   }
               - name: usage.ts
@@ -959,8 +933,8 @@ options:
 
                   const api = new PetStoreClient({ baseURL: 'https://petstore.swagger.io/v2' })
 
-                  const pets = await api.pet.findPetsByTags({ tags: ['available'] })
-                  const user = await api.user.getUserByName({ username: 'john' })
+                  const pets = await api.petController.findPetsByTags({ tags: ['available'] })
+                  const user = await api.userController.getUserByName({ username: 'john' })
   - name: bundle
     type: boolean
     required: false
@@ -1283,7 +1257,7 @@ examples:
                   },
                 },
                 operations: true,
-                parser: 'client',
+                parser: false,
                 exclude: [{ type: 'tag', pattern: 'store' }],
                 pathParamsType: 'object',
                 dataReturnType: 'full',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-client",
-  "version": "5.0.0-beta.30",
+  "version": "5.0.0-beta.33",
   "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",
@@ -87,10 +87,10 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/core": "5.0.0-beta.29",
-    "@kubb/renderer-jsx": "5.0.0-beta.29",
-    "@kubb/plugin-ts": "5.0.0-beta.30",
-    "@kubb/plugin-zod": "5.0.0-beta.30"
+    "@kubb/core": "5.0.0-beta.33",
+    "@kubb/renderer-jsx": "5.0.0-beta.33",
+    "@kubb/plugin-ts": "5.0.0-beta.33",
+    "@kubb/plugin-zod": "5.0.0-beta.33"
   },
   "devDependencies": {
     "axios": "^1.16.1",
@@ -98,7 +98,7 @@
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.29",
+    "@kubb/renderer-jsx": "5.0.0-beta.33",
     "axios": "^1.7.2"
   },
   "peerDependenciesMeta": {

package/src/clients/fetch.ts

@@ -74,6 +74,77 @@ function serializeHeaders(headers: HeadersInit | undefined): Record<string, stri
   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>(
@@ -101,21 +172,23 @@ export const client = async <TResponseData, _TError = unknown, RequestData = unk
     targetUrl += `?${normalizedParams}`
   }
 
+  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.contentType && config.contentType !== 'multipart/form-data' ? { 'Content-Type': config.contentType } : {}),
-      ...serializeHeaders(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,6 +1,6 @@
 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'
@@ -58,6 +58,7 @@ function generateMethod({
   paramsCasing,
   pathParamsType,
 }: GenerateMethodProps): string {
+  if (!ast.isHttpOperationNode(node)) return ''
   const path = new URLPath(node.path, { casing: paramsCasing })
   const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node)
   const isFormData = !isMultipleContentTypes && contentType === 'multipart/form-data'

package/src/components/Client.tsx

@@ -4,6 +4,7 @@ import {
   buildRequestConfigType,
   getContentTypeInfo,
   getOperationParameters,
+  getResponseType,
   resolveSuccessNames,
 } from '@internals/shared'
 import { isValidVarName, URLPath } from '@internals/utils'
@@ -96,9 +97,11 @@ export function Client({
   children,
   isConfigurable = true,
 }: Props): KubbReactNode {
+  if (!ast.isHttpOperationNode(node)) return null
   const path = new URLPath(node.path)
   const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node)
   const isFormData = !isMultipleContentTypes && contentType === 'multipart/form-data'
+  const responseType = getResponseType(node)
 
   const { path: originalPathParams, query: originalQueryParams, header: originalHeaderParams } = getOperationParameters(node)
   const { path: casedPathParams, query: casedQueryParams, header: casedHeaderParams } = getOperationParameters(node, { paramsCasing })
@@ -179,6 +182,7 @@ export function Client({
             }
           : null,
         contentType: isConfigurable && isMultipleContentTypes ? {} : null,
+        responseType: responseType ? { value: JSON.stringify(responseType) } : null,
         requestConfig: isConfigurable
           ? {
               mode: 'inlineSpread',
@@ -199,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'}
     </>
   )
 

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(),

package/src/components/StaticClassClient.tsx

@@ -1,6 +1,6 @@
 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'
@@ -58,6 +58,7 @@ function generateMethod({
   paramsCasing,
   pathParamsType,
 }: GenerateMethodProps): string {
+  if (!ast.isHttpOperationNode(node)) return ''
   const path = new URLPath(node.path, { casing: paramsCasing })
   const { defaultContentType: contentType, isMultipleContentTypes, hasFormData } = getContentTypeInfo(node)
   const isFormData = !isMultipleContentTypes && contentType === 'multipart/form-data'

package/src/components/Url.tsx

@@ -57,6 +57,7 @@ export function Url({
   node,
   tsResolver,
 }: Props): KubbReactNode {
+  if (!ast.isHttpOperationNode(node)) return null
   const path = new URLPath(node.path)
 
   const paramsNode = buildUrlParamsNode({

package/src/generators/classClientGenerator.tsx

@@ -1,8 +1,7 @@
 import path from 'node:path'
-import { resolveOperationTypeNames } from '@internals/shared'
+import { operationFileEntry, resolveOperationTypeNames } from '@internals/shared'
 import { camelCase } from '@internals/utils'
-import type { ast } from '@kubb/core'
-import { defineGenerator } from '@kubb/core'
+import { ast, defineGenerator } from '@kubb/core'
 import type { ResolverTs } from '@kubb/plugin-ts'
 import { pluginTsName } from '@kubb/plugin-ts'
 import type { ResolverZod } from '@kubb/plugin-zod'
@@ -62,16 +61,18 @@ export const classClientGenerator = defineGenerator<PluginClient>({
     const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null
 
     function buildOperationData(node: ast.OperationNode): OperationData {
-      const typeFile = tsResolver.resolveFile(
-        { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
-        { root, output: tsPluginOptions?.output ?? output, group: tsPluginOptions?.group },
-      )
+      const typeFile = tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
+        root,
+        output: tsPluginOptions?.output ?? output,
+        group: tsPluginOptions?.group,
+      })
       const zodFile =
         zodResolver && pluginZod?.options
-          ? zodResolver.resolveFile(
-              { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
-              { root, output: pluginZod.options?.output ?? output, group: pluginZod.options?.group ?? undefined },
-            )
+          ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
+              root,
+              output: pluginZod.options?.output ?? output,
+              group: pluginZod.options?.group ?? undefined,
+            })
           : null
 
       return {
@@ -85,6 +86,7 @@ export const classClientGenerator = defineGenerator<PluginClient>({
     }
 
     const controllers = nodes.reduce((acc, operationNode) => {
+      if (!ast.isHttpOperationNode(operationNode)) return acc
       const tag = operationNode.tags[0]
       const groupName = tag ? (group?.name?.({ group: camelCase(tag) }) ?? resolver.resolveGroupName(tag)) : resolver.resolveGroupName('Client')
 

package/src/generators/clientGenerator.tsx

@@ -1,6 +1,6 @@
 import path from 'node:path'
-import { resolveOperationTypeNames } from '@internals/shared'
-import { defineGenerator } from '@kubb/core'
+import { operationFileEntry, resolveOperationTypeNames } from '@internals/shared'
+import { ast, defineGenerator } from '@kubb/core'
 import { pluginTsName } from '@kubb/plugin-ts'
 import { pluginZodName } from '@kubb/plugin-zod'
 import { File, jsxRendererSync } from '@kubb/renderer-jsx'
@@ -17,6 +17,7 @@ export const clientGenerator = defineGenerator<PluginClient>({
   name: 'client',
   renderer: jsxRendererSync,
   operation(node, ctx) {
+    if (!ast.isHttpOperationNode(node)) return null
     const { config, driver, resolver, root } = ctx
     const { output, urlType, dataReturnType, paramsCasing, paramsType, pathParamsType, parser, importPath, group } = ctx.options
     const baseURL = ctx.options.baseURL ?? ctx.meta.baseURL
@@ -44,28 +45,19 @@ export const clientGenerator = defineGenerator<PluginClient>({
     const meta = {
       name: resolver.resolveName(node.operationId),
       urlName: resolver.resolveUrlName(node),
-      file: resolver.resolveFile(
-        { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
-        { root, output, group: group ?? undefined },
-      ),
-      fileTs: tsResolver.resolveFile(
-        { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
-        {
-          root,
-          output: pluginTs.options?.output ?? output,
-          group: pluginTs.options?.group ?? undefined,
-        },
-      ),
+      file: resolver.resolveFile(operationFileEntry(node, node.operationId), { root, output, group: group ?? undefined }),
+      fileTs: tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
+        root,
+        output: pluginTs.options?.output ?? output,
+        group: pluginTs.options?.group ?? undefined,
+      }),
       fileZod:
         zodResolver && pluginZod?.options
-          ? zodResolver.resolveFile(
-              { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
-              {
-                root,
-                output: pluginZod.options.output ?? output,
-                group: pluginZod.options?.group ?? undefined,
-              },
-            )
+          ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
+              root,
+              output: pluginZod.options.output ?? output,
+              group: pluginZod.options?.group ?? undefined,
+            })
           : null,
     } as const
 

package/src/generators/operationsGenerator.tsx

@@ -1,4 +1,4 @@
-import { defineGenerator } from '@kubb/core'
+import { ast, defineGenerator } from '@kubb/core'
 import { File, jsxRendererSync } from '@kubb/renderer-jsx'
 import { Operations } from '../components/Operations'
 import type { PluginClient } from '../types'
@@ -27,7 +27,7 @@ export const operationsGenerator = defineGenerator<PluginClient>({
         banner={resolver.resolveBanner(ctx.meta, { output, config, file: { path: file.path, baseName: file.baseName } })}
         footer={resolver.resolveFooter(ctx.meta, { output, config, file: { path: file.path, baseName: file.baseName } })}
       >
-        <Operations name={name} nodes={nodes} />
+        <Operations name={name} nodes={nodes.filter(ast.isHttpOperationNode)} />
       </File>
     )
   },

package/src/generators/staticClassClientGenerator.tsx

@@ -1,8 +1,7 @@
 import path from 'node:path'
-import { resolveOperationTypeNames } from '@internals/shared'
+import { operationFileEntry, resolveOperationTypeNames } from '@internals/shared'
 import { camelCase } from '@internals/utils'
-import type { ast } from '@kubb/core'
-import { defineGenerator } from '@kubb/core'
+import { ast, defineGenerator } from '@kubb/core'
 import type { ResolverTs } from '@kubb/plugin-ts'
 import { pluginTsName } from '@kubb/plugin-ts'
 import type { ResolverZod } from '@kubb/plugin-zod'
@@ -61,16 +60,18 @@ export const staticClassClientGenerator = defineGenerator<PluginClient>({
     const zodResolver = pluginZod ? driver.getResolver(pluginZodName) : null
 
     function buildOperationData(node: ast.OperationNode): OperationData {
-      const typeFile = tsResolver.resolveFile(
-        { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
-        { root, output: tsPluginOptions?.output ?? output, group: tsPluginOptions?.group },
-      )
+      const typeFile = tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
+        root,
+        output: tsPluginOptions?.output ?? output,
+        group: tsPluginOptions?.group,
+      })
       const zodFile =
         zodResolver && pluginZod?.options
-          ? zodResolver.resolveFile(
-              { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
-              { root, output: pluginZod.options?.output ?? output, group: pluginZod.options?.group ?? undefined },
-            )
+          ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
+              root,
+              output: pluginZod.options?.output ?? output,
+              group: pluginZod.options?.group ?? undefined,
+            })
           : null
 
       return {
@@ -84,6 +85,7 @@ export const staticClassClientGenerator = defineGenerator<PluginClient>({
     }
 
     const controllers = nodes.reduce((acc, operationNode) => {
+      if (!ast.isHttpOperationNode(operationNode)) return acc
       const tag = operationNode.tags[0]
       const groupName = tag ? (group?.name?.({ group: camelCase(tag) }) ?? resolver.resolveGroupName(tag)) : resolver.resolveGroupName('Client')
 

package/src/plugin.ts

@@ -1,7 +1,7 @@
 import path from 'node:path'
-import { camelCase } from '@internals/utils'
+import { createGroupConfig } from '@internals/shared'
 
-import { ast, definePlugin, type Group } from '@kubb/core'
+import { ast, definePlugin } from '@kubb/core'
 import { pluginTsName } from '@kubb/plugin-ts'
 import { pluginZodName } from '@kubb/plugin-zod'
 import { classClientGenerator } from './generators/classClientGenerator.tsx'
@@ -60,7 +60,7 @@ export const pluginClient = definePlugin<PluginClient>((options) => {
     operations = false,
     paramsCasing,
     clientType = options.sdk ? 'class' : 'function',
-    parser = 'client',
+    parser = false,
     client = 'axios',
     importPath,
     bundle = false,
@@ -80,19 +80,7 @@ export const pluginClient = definePlugin<PluginClient>((options) => {
       operations ? operationsGenerator : null,
     ].filter((x): x is NonNullable<typeof x> => Boolean(x))
 
-  const groupConfig = group
-    ? ({
-        ...group,
-        name: group.name
-          ? group.name
-          : (ctx: { group: string }) => {
-              if (group.type === 'path') {
-                return `${ctx.group.split('/')[1]}`
-              }
-              return `${camelCase(ctx.group)}Controller`
-            },
-      } satisfies Group)
-    : null
+  const groupConfig = createGroupConfig(group, { suffix: 'Controller', honorName: true })
 
   return {
     name: pluginClientName,