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

package/dist/clients/fetch.cjs

@@ -37,6 +37,59 @@ function serializeHeaders(headers) {
 	}
 	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, contentType) {
+	if (data === void 0 || data === null) return void 0;
+	if (data instanceof FormData || data instanceof URLSearchParams || data instanceof Blob || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) return data;
+	if (typeof data === "string") return data;
+	if (contentType?.includes("application/x-www-form-urlencoded")) return new URLSearchParams(data);
+	return JSON.stringify(data);
+}
+/**
+* Picks a `responseType` from a `Content-Type` header, or `undefined` when it is not recognized.
+*/
+function detectResponseType(contentType) {
+	if (!contentType) return void 0;
+	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";
+}
+/**
+* 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(response, responseType) {
+	if ([
+		204,
+		205,
+		304
+	].includes(response.status) || !response.body) return {};
+	switch (responseType ?? detectResponseType(response.headers.get("Content-Type"))) {
+		case "text":
+		case "document": return await response.text();
+		case "blob": return await response.blob();
+		case "arraybuffer": return await response.arrayBuffer();
+		case "stream": return response.body;
+		case "json": return await response.json();
+	}
+	if (responseType) return await response.json();
+	const text = await response.text();
+	if (!text) return {};
+	try {
+		return JSON.parse(text);
+	} catch {
+		return text;
+	}
+}
 const client = async (paramsConfig, _request) => {
 	const normalizedParams = new URLSearchParams();
 	const config = mergeConfig(getConfig(), paramsConfig);
@@ -45,22 +98,19 @@ const client = async (paramsConfig, _request) => {
 	});
 	let targetUrl = [config.baseURL, config.url].filter(Boolean).join("");
 	if (config.params) targetUrl += `?${normalizedParams}`;
+	const headers = {
+		...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
 	});
 	return {
-		data: [
-			204,
-			205,
-			304
-		].includes(response.status) || !response.body ? {} : await response.json(),
+		data: await parseResponse(response, config.responseType),
 		status: response.status,
 		statusText: response.statusText,
 		headers: response.headers

package/dist/clients/fetch.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.cjs","names":[],"sources":["../../src/clients/fetch.ts"],"sourcesContent":["/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded filter headers like `X-Filter`).\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\n * headers like `X-Filter` are sent in their canonical JSON-string form.\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 = <TResponseData, _TError = unknown, TRequestData = unknown>(\n  config: RequestConfig<TRequestData>,\n  request?: unknown,\n) => Promise<ResponseConfig<TResponseData>>\n\nexport const client = async <TResponseData, _TError = unknown, RequestData = unknown>(\n  paramsConfig: RequestConfig<RequestData>,\n  _request?: unknown,\n): Promise<ResponseConfig<TResponseData>> => {\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 TResponseData,\n    status: response.status,\n    statusText: response.statusText,\n    headers: response.headers as Headers,\n  }\n}\n\nclient.getConfig = getConfig\nclient.setConfig = setConfig\n\nexport default client\n"],"mappings":";;;;;;AAsCA,IAAI,UAAkC,EAAE;AAExC,MAAa,kBAAkB;AAE/B,MAAa,aAAa,WAAmC;CAC3D,UAAU;CACV,OAAO,WAAW;;AAGpB,MAAa,eAAwC,GAAG,YAA2C;CACjG,OAAO,QAAQ,QAAoB,QAAQ,WAAW;EACpD,OAAO;GACL,GAAG;GACH,GAAG;GACH,SAAS;IACP,GAAI,MAAM,QAAQ,OAAO,QAAQ,GAAG,OAAO,YAAY,OAAO,QAAQ,GAAG,OAAO;IAChF,GAAI,MAAM,QAAQ,OAAO,QAAQ,GAAG,OAAO,YAAY,OAAO,QAAQ,GAAG,OAAO;IACjF;GACF;IACA,EAAE,CAAC;;;;;;;AAQR,SAAS,iBAAiB,SAA0D;CAClF,IAAI,CAAC,SAAS,OAAO,EAAE;CACvB,MAAM,UAAU,MAAM,QAAQ,QAAQ,GAAG,UAAU,OAAO,QAAQ,QAAQ;CAC1E,MAAM,SAAiC,EAAE;CACzC,KAAK,MAAM,CAAC,KAAK,UAAU,SAAS;EAClC,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAC3C,OAAO,OAAO,OAAO,UAAU,WAAW,QAAQ,OAAO,UAAU,WAAW,KAAK,UAAU,MAAM,GAAG,OAAO,MAAM;;CAErH,OAAO;;AAUT,MAAa,SAAS,OACpB,cACA,aAC2C;CAC3C,MAAM,mBAAmB,IAAI,iBAAiB;CAE9C,MAAM,SAAS,YAAY,WAAW,EAAE,aAAa;CAErD,OAAO,QAAQ,OAAO,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;EAC5D,IAAI,UAAU,KAAA,GACZ,iBAAiB,OAAO,KAAK,UAAU,OAAO,SAAS,MAAM,UAAU,CAAC;GAE1E;CAEF,IAAI,YAAY,CAAC,OAAO,SAAS,OAAO,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,GAAG;CAErE,IAAI,OAAO,QACT,aAAa,IAAI;CAGnB,MAAM,WAAW,MAAM,WAAW,MAAM,WAAW;EACjD,aAAa,OAAO,eAAe;EACnC,QAAQ,OAAO,QAAQ,aAAa;EACpC,MAAM,OAAO,gBAAgB,WAAW,OAAO,OAAO,KAAK,UAAU,OAAO,KAAK;EACjF,QAAQ,OAAO;EACf,SAAS;GACP,GAAI,OAAO,eAAe,OAAO,gBAAgB,wBAAwB,EAAE,gBAAgB,OAAO,aAAa,GAAG,EAAE;GACpH,GAAG,iBAAiB,OAAO,QAAQ;GACpC;EACF,CAAC;CAIF,OAAO;EACL,MAHW;GAAC;GAAK;GAAK;GAAI,CAAC,SAAS,SAAS,OAAO,IAAI,CAAC,SAAS,OAAO,EAAE,GAAG,MAAM,SAAS,MAAM;EAInG,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB,SAAS,SAAS;EACnB;;AAGH,OAAO,YAAY;AACnB,OAAO,YAAY"}
+{"version":3,"file":"fetch.cjs","names":[],"sources":["../../src/clients/fetch.ts"],"sourcesContent":["/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded filter headers like `X-Filter`).\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\n * headers like `X-Filter` are sent in their canonical JSON-string form.\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 = <TResponseData, _TError = unknown, TRequestData = unknown>(\n  config: RequestConfig<TRequestData>,\n  request?: unknown,\n) => Promise<ResponseConfig<TResponseData>>\n\nexport const client = async <TResponseData, _TError = unknown, RequestData = unknown>(\n  paramsConfig: RequestConfig<RequestData>,\n  _request?: unknown,\n): Promise<ResponseConfig<TResponseData>> => {\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<TResponseData>(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\nexport default client\n"],"mappings":";;;;;;AAsCA,IAAI,UAAkC,EAAE;AAExC,MAAa,kBAAkB;AAE/B,MAAa,aAAa,WAAmC;CAC3D,UAAU;CACV,OAAO,WAAW;;AAGpB,MAAa,eAAwC,GAAG,YAA2C;CACjG,OAAO,QAAQ,QAAoB,QAAQ,WAAW;EACpD,OAAO;GACL,GAAG;GACH,GAAG;GACH,SAAS;IACP,GAAI,MAAM,QAAQ,OAAO,QAAQ,GAAG,OAAO,YAAY,OAAO,QAAQ,GAAG,OAAO;IAChF,GAAI,MAAM,QAAQ,OAAO,QAAQ,GAAG,OAAO,YAAY,OAAO,QAAQ,GAAG,OAAO;IACjF;GACF;IACA,EAAE,CAAC;;;;;;;AAQR,SAAS,iBAAiB,SAA0D;CAClF,IAAI,CAAC,SAAS,OAAO,EAAE;CACvB,MAAM,UAAU,MAAM,QAAQ,QAAQ,GAAG,UAAU,OAAO,QAAQ,QAAQ;CAC1E,MAAM,SAAiC,EAAE;CACzC,KAAK,MAAM,CAAC,KAAK,UAAU,SAAS;EAClC,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAC3C,OAAO,OAAO,OAAO,UAAU,WAAW,QAAQ,OAAO,UAAU,WAAW,KAAK,UAAU,MAAM,GAAG,OAAO,MAAM;;CAErH,OAAO;;;;;;;;AAST,SAAS,cAAc,MAAe,aAA4C;CAChF,IAAI,SAAS,KAAA,KAAa,SAAS,MAAM,OAAO,KAAA;CAChD,IAAI,gBAAgB,YAAY,gBAAgB,mBAAmB,gBAAgB,QAAQ,gBAAgB,eAAe,YAAY,OAAO,KAAK,EAChJ,OAAO;CAET,IAAI,OAAO,SAAS,UAAU,OAAO;CACrC,IAAI,aAAa,SAAS,oCAAoC,EAC5D,OAAO,IAAI,gBAAgB,KAA+B;CAE5D,OAAO,KAAK,UAAU,KAAK;;;;;AAM7B,SAAS,mBAAmB,aAA2D;CACrF,IAAI,CAAC,aAAa,OAAO,KAAA;CACzB,IAAI,YAAY,SAAS,mBAAmB,IAAI,YAAY,SAAS,YAAY,EAAE,OAAO;CAC1F,IAAI,YAAY,SAAS,QAAQ,EAAE,OAAO;CAC1C,IAAI,YAAY,SAAS,SAAS,IAAI,YAAY,SAAS,2BAA2B,EAAE,OAAO;;;;;;;;;;AAYjG,eAAe,cAAqB,UAAoB,cAA8D;CACpH,IAAI;EAAC;EAAK;EAAK;EAAI,CAAC,SAAS,SAAS,OAAO,IAAI,CAAC,SAAS,MACzD,OAAO,EAAE;CAGX,QAAQ,gBAAgB,mBAAmB,SAAS,QAAQ,IAAI,eAAe,CAAC,EAAhF;EACE,KAAK;EACL,KAAK,YACH,OAAQ,MAAM,SAAS,MAAM;EAC/B,KAAK,QACH,OAAQ,MAAM,SAAS,MAAM;EAC/B,KAAK,eACH,OAAQ,MAAM,SAAS,aAAa;EACtC,KAAK,UACH,OAAO,SAAS;EAClB,KAAK,QACH,OAAQ,MAAM,SAAS,MAAM;;CAIjC,IAAI,cACF,OAAQ,MAAM,SAAS,MAAM;CAE/B,MAAM,OAAO,MAAM,SAAS,MAAM;CAClC,IAAI,CAAC,MACH,OAAO,EAAE;CAEX,IAAI;EACF,OAAO,KAAK,MAAM,KAAK;SACjB;EACN,OAAO;;;AAWX,MAAa,SAAS,OACpB,cACA,aAC2C;CAC3C,MAAM,mBAAmB,IAAI,iBAAiB;CAE9C,MAAM,SAAS,YAAY,WAAW,EAAE,aAAa;CAErD,OAAO,QAAQ,OAAO,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;EAC5D,IAAI,UAAU,KAAA,GACZ,iBAAiB,OAAO,KAAK,UAAU,OAAO,SAAS,MAAM,UAAU,CAAC;GAE1E;CAEF,IAAI,YAAY,CAAC,OAAO,SAAS,OAAO,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,GAAG;CAErE,IAAI,OAAO,QACT,aAAa,IAAI;CAGnB,MAAM,UAAkC;EACtC,GAAI,OAAO,eAAe,OAAO,gBAAgB,wBAAwB,EAAE,gBAAgB,OAAO,aAAa,GAAG,EAAE;EACpH,GAAG,iBAAiB,OAAO,QAAQ;EACpC;CAED,MAAM,WAAW,MAAM,WAAW,MAAM,WAAW;EACjD,aAAa,OAAO,eAAe;EACnC,QAAQ,OAAO,QAAQ,aAAa;EACpC,MAAM,cAAc,OAAO,MAAM,QAAQ,mBAAmB,QAAQ,gBAAgB;EACpF,QAAQ,OAAO;EACf;EACD,CAAC;CAIF,OAAO;EACL,MAAA,MAHiB,cAA6B,UAAU,OAAO,aAAa;EAI5E,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB,SAAS,SAAS;EACnB;;AAGH,OAAO,YAAY;AACnB,OAAO,YAAY"}

package/dist/clients/fetch.js

@@ -33,6 +33,59 @@ function serializeHeaders(headers) {
 	}
 	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, contentType) {
+	if (data === void 0 || data === null) return void 0;
+	if (data instanceof FormData || data instanceof URLSearchParams || data instanceof Blob || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) return data;
+	if (typeof data === "string") return data;
+	if (contentType?.includes("application/x-www-form-urlencoded")) return new URLSearchParams(data);
+	return JSON.stringify(data);
+}
+/**
+* Picks a `responseType` from a `Content-Type` header, or `undefined` when it is not recognized.
+*/
+function detectResponseType(contentType) {
+	if (!contentType) return void 0;
+	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";
+}
+/**
+* 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(response, responseType) {
+	if ([
+		204,
+		205,
+		304
+	].includes(response.status) || !response.body) return {};
+	switch (responseType ?? detectResponseType(response.headers.get("Content-Type"))) {
+		case "text":
+		case "document": return await response.text();
+		case "blob": return await response.blob();
+		case "arraybuffer": return await response.arrayBuffer();
+		case "stream": return response.body;
+		case "json": return await response.json();
+	}
+	if (responseType) return await response.json();
+	const text = await response.text();
+	if (!text) return {};
+	try {
+		return JSON.parse(text);
+	} catch {
+		return text;
+	}
+}
 const client = async (paramsConfig, _request) => {
 	const normalizedParams = new URLSearchParams();
 	const config = mergeConfig(getConfig(), paramsConfig);
@@ -41,22 +94,19 @@ const client = async (paramsConfig, _request) => {
 	});
 	let targetUrl = [config.baseURL, config.url].filter(Boolean).join("");
 	if (config.params) targetUrl += `?${normalizedParams}`;
+	const headers = {
+		...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
 	});
 	return {
-		data: [
-			204,
-			205,
-			304
-		].includes(response.status) || !response.body ? {} : await response.json(),
+		data: await parseResponse(response, config.responseType),
 		status: response.status,
 		statusText: response.statusText,
 		headers: response.headers

package/dist/clients/fetch.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.js","names":[],"sources":["../../src/clients/fetch.ts"],"sourcesContent":["/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded filter headers like `X-Filter`).\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\n * headers like `X-Filter` are sent in their canonical JSON-string form.\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 = <TResponseData, _TError = unknown, TRequestData = unknown>(\n  config: RequestConfig<TRequestData>,\n  request?: unknown,\n) => Promise<ResponseConfig<TResponseData>>\n\nexport const client = async <TResponseData, _TError = unknown, RequestData = unknown>(\n  paramsConfig: RequestConfig<RequestData>,\n  _request?: unknown,\n): Promise<ResponseConfig<TResponseData>> => {\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 TResponseData,\n    status: response.status,\n    statusText: response.statusText,\n    headers: response.headers as Headers,\n  }\n}\n\nclient.getConfig = getConfig\nclient.setConfig = setConfig\n\nexport default client\n"],"mappings":";;AAsCA,IAAI,UAAkC,EAAE;AAExC,MAAa,kBAAkB;AAE/B,MAAa,aAAa,WAAmC;CAC3D,UAAU;CACV,OAAO,WAAW;;AAGpB,MAAa,eAAwC,GAAG,YAA2C;CACjG,OAAO,QAAQ,QAAoB,QAAQ,WAAW;EACpD,OAAO;GACL,GAAG;GACH,GAAG;GACH,SAAS;IACP,GAAI,MAAM,QAAQ,OAAO,QAAQ,GAAG,OAAO,YAAY,OAAO,QAAQ,GAAG,OAAO;IAChF,GAAI,MAAM,QAAQ,OAAO,QAAQ,GAAG,OAAO,YAAY,OAAO,QAAQ,GAAG,OAAO;IACjF;GACF;IACA,EAAE,CAAC;;;;;;;AAQR,SAAS,iBAAiB,SAA0D;CAClF,IAAI,CAAC,SAAS,OAAO,EAAE;CACvB,MAAM,UAAU,MAAM,QAAQ,QAAQ,GAAG,UAAU,OAAO,QAAQ,QAAQ;CAC1E,MAAM,SAAiC,EAAE;CACzC,KAAK,MAAM,CAAC,KAAK,UAAU,SAAS;EAClC,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAC3C,OAAO,OAAO,OAAO,UAAU,WAAW,QAAQ,OAAO,UAAU,WAAW,KAAK,UAAU,MAAM,GAAG,OAAO,MAAM;;CAErH,OAAO;;AAUT,MAAa,SAAS,OACpB,cACA,aAC2C;CAC3C,MAAM,mBAAmB,IAAI,iBAAiB;CAE9C,MAAM,SAAS,YAAY,WAAW,EAAE,aAAa;CAErD,OAAO,QAAQ,OAAO,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,WAAW;EAC5D,IAAI,UAAU,KAAA,GACZ,iBAAiB,OAAO,KAAK,UAAU,OAAO,SAAS,MAAM,UAAU,CAAC;GAE1E;CAEF,IAAI,YAAY,CAAC,OAAO,SAAS,OAAO,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,GAAG;CAErE,IAAI,OAAO,QACT,aAAa,IAAI;CAGnB,MAAM,WAAW,MAAM,WAAW,MAAM,WAAW;EACjD,aAAa,OAAO,eAAe;EACnC,QAAQ,OAAO,QAAQ,aAAa;EACpC,MAAM,OAAO,gBAAgB,WAAW,OAAO,OAAO,KAAK,UAAU,OAAO,KAAK;EACjF,QAAQ,OAAO;EACf,SAAS;GACP,GAAI,OAAO,eAAe,OAAO,gBAAgB,wBAAwB,EAAE,gBAAgB,OAAO,aAAa,GAAG,EAAE;GACpH,GAAG,iBAAiB,OAAO,QAAQ;GACpC;EACF,CAAC;CAIF,OAAO;EACL,MAHW;GAAC;GAAK;GAAK;GAAI,CAAC,SAAS,SAAS,OAAO,IAAI,CAAC,SAAS,OAAO,EAAE,GAAG,MAAM,SAAS,MAAM;EAInG,QAAQ,SAAS;EACjB,YAAY,SAAS;EACrB,SAAS,SAAS;EACnB;;AAGH,OAAO,YAAY;AACnB,OAAO,YAAY"}
+{"version":3,"file":"fetch.js","names":[],"sources":["../../src/clients/fetch.ts"],"sourcesContent":["/**\n * RequestCredentials\n */\nexport type RequestCredentials = 'omit' | 'same-origin' | 'include'\n\n/**\n * Header values may be objects (e.g. JSON-encoded filter headers like `X-Filter`).\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\n * headers like `X-Filter` are sent in their canonical JSON-string form.\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 = <TResponseData, _TError = unknown, TRequestData = unknown>(\n  config: RequestConfig<TRequestData>,\n  request?: unknown,\n) => Promise<ResponseConfig<TResponseData>>\n\nexport const client = async <TResponseData, _TError = unknown, RequestData = unknown>(\n  paramsConfig: RequestConfig<RequestData>,\n  _request?: unknown,\n): Promise<ResponseConfig<TResponseData>> => {\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<TResponseData>(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\nexport default client\n"],"mappings":"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"}

package/dist/index.cjs

@@ -360,11 +360,30 @@ var URLPath = class {
 };
 //#endregion
 //#region ../../internals/shared/src/operation.ts
+/**
+* Builds the `ResolverFileParams` every operation generator passes to
+* `resolver.resolveFile`: a file named `name`, tagged by the operation's first
+* tag (or `'default'`), at the operation's path. Centralizes the entry object
+* that was repeated at dozens of call sites across the client and query plugins.
+*
+* @example
+* ```ts
+* resolver.resolveFile(operationFileEntry(node, node.operationId), { root, output, group })
+* ```
+*/
+function operationFileEntry(node, name, extname = ".ts") {
+	return {
+		name,
+		extname,
+		tag: node.tags[0] ?? "default",
+		path: node.path
+	};
+}
 function getOperationLink(node, link) {
 	if (!link) return null;
 	if (typeof link === "function") return link(node) ?? null;
 	if (link === "urlPath") return node.path ? `{@link ${new URLPath(node.path).URL}}` : null;
-	return `{@link ${node.path.replaceAll("{", ":").replaceAll("}", "")}}`;
+	return node.path ? `{@link ${node.path.replaceAll("{", ":").replaceAll("}", "")}}` : null;
 }
 function getContentTypeInfo(node) {
 	const contentTypes = node.requestBody?.content?.map((e) => e.contentType) ?? [];
@@ -377,6 +396,22 @@ function getContentTypeInfo(node) {
 		hasFormData: contentTypes.some((ct) => ct === "multipart/form-data")
 	};
 }
+/**
+* Derives the default `responseType` for an operation from its primary success response.
+*
+* Returns a value only when that response declares a single non-JSON content type — a binary type
+* (`application/octet-stream`, `application/pdf`, `image/*`, `audio/*`, `video/*`) maps to `'blob'`
+* and other `text/*` maps to `'text'`. Otherwise `undefined`, leaving the runtime client's
+* `Content-Type` auto-detection in charge.
+*/
+function getResponseType(node) {
+	const contentTypes = getPrimarySuccessResponse(node)?.content?.map((entry) => entry.contentType) ?? [];
+	if (contentTypes.length !== 1) return void 0;
+	const baseType = contentTypes[0].split(";")[0].trim().toLowerCase();
+	if (baseType === "application/json" || baseType.endsWith("+json") || baseType === "text/json") return void 0;
+	if (baseType.startsWith("text/")) return "text";
+	if (baseType === "application/octet-stream" || baseType === "application/pdf" || /^(image|audio|video)\//.test(baseType)) return "blob";
+}
 function buildRequestConfigType(node, resolver) {
 	const requestName = node.requestBody?.content?.[0]?.schema ? resolver.resolveDataName(node) : null;
 	const { isMultipleContentTypes, contentTypeUnion } = getContentTypeInfo(node);
@@ -420,6 +455,15 @@ function isErrorStatusCode(statusCode) {
 	const code = getStatusCodeNumber(statusCode);
 	return code !== null && code >= 400;
 }
+function getSuccessResponses(responses) {
+	return responses.filter((response) => isSuccessStatusCode(response.statusCode));
+}
+function getOperationSuccessResponses(node) {
+	return getSuccessResponses(node.responses);
+}
+function getPrimarySuccessResponse(node) {
+	return getOperationSuccessResponses(node)[0] ?? null;
+}
 function resolveErrorNames(node, resolver) {
 	return node.responses.filter((response) => isErrorStatusCode(response.statusCode)).map((response) => resolver.resolveResponseStatusName(node, response.statusCode));
 }
@@ -462,6 +506,39 @@ function resolveOperationTypeNames(node, resolver, options = {}) {
 	return result;
 }
 //#endregion
+//#region ../../internals/shared/src/group.ts
+/**
+* Builds the `group` config a Kubb plugin passes to `ctx.setOptions`, applying the
+* shared default naming so every plugin groups output consistently:
+*
+* - `path` groups use the second path segment (`/pet/findByStatus` → `pet`).
+* - other groups use `${camelCase(group)}${suffix}` (e.g. `petController`).
+*
+* Returns `null` when grouping is disabled, matching the per-plugin convention.
+*
+* @param group - The user-supplied group option, or `undefined` to disable grouping.
+* @param options.suffix - Appended to non-`path` group names, e.g. `'Controller'` or `'Requests'`.
+* @param options.honorName - When `true`, a user-provided `group.name` overrides the default namer.
+*
+* @example
+* ```ts
+* createGroupConfig(group, { suffix: 'Controller' })                  // plugin-ts, plugin-zod
+* createGroupConfig(group, { suffix: 'Controller', honorName: true }) // plugin-faker, plugin-client, …
+* createGroupConfig(group, { suffix: 'Requests', honorName: true })   // plugin-cypress, plugin-mcp
+* ```
+*/
+function createGroupConfig(group, options) {
+	if (!group) return null;
+	const defaultName = (ctx) => {
+		if (group.type === "path") return `${ctx.group.split("/")[1]}`;
+		return `${camelCase(ctx.group)}${options.suffix}`;
+	};
+	return {
+		...group,
+		name: options.honorName && group.name ? group.name : defaultName
+	};
+}
+//#endregion
 //#region ../../internals/shared/src/params.ts
 function buildParamsMapping(originalParams, mappedParams) {
 	const mapping = {};
@@ -553,6 +630,7 @@ function buildUrlParamsNode({ paramsType, paramsCasing, pathParamsType, node, ts
 	});
 }
 function Url({ name, isExportable = true, isIndexable = true, baseURL, paramsType, paramsCasing, pathParamsType, node, tsResolver }) {
+	if (!_kubb_core.ast.isHttpOperationNode(node)) return null;
 	const path = new URLPath(node.path);
 	const paramsNode = buildUrlParamsNode({
 		paramsType,
@@ -606,9 +684,11 @@ function buildClientParamsNode({ paramsType, paramsCasing, pathParamsType, node,
 	});
 }
 function Client({ name, isExportable = true, isIndexable = true, returnType, baseURL, dataReturnType, parser, paramsType, paramsCasing, pathParamsType, node, tsResolver, zodResolver, urlName, children, isConfigurable = true }) {
+	if (!_kubb_core.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 });
 	const pathParamsMapping = paramsCasing && !urlName ? buildParamsMapping(originalPathParams, casedPathParams) : null;
@@ -656,6 +736,7 @@ function Client({ name, isExportable = true, isIndexable = true, returnType, bas
 			params: queryParamsName ? queryParamsMapping ? { value: "mappedParams" } : {} : null,
 			data: requestName ? { value: isMultipleContentTypes && hasFormData ? "contentType === 'multipart/form-data' ? formData as FormData : requestData" : isFormData ? "formData as FormData" : "requestData" } : null,
 			contentType: isConfigurable && isMultipleContentTypes ? {} : null,
+			responseType: responseType ? { value: JSON.stringify(responseType) } : null,
 			requestConfig: isConfigurable ? { mode: "inlineSpread" } : null,
 			headers: headers.length ? { value: isConfigurable ? `{ ${headers.join(", ")}, ...requestConfig.headers }` : `{ ${headers.join(", ")} }` } : null
 		}
@@ -663,8 +744,8 @@ function Client({ name, isExportable = true, isIndexable = true, returnType, bas
 	const childrenElement = children ? children : /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [
 		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"
 	] });
 	return /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsxs)(_kubb_renderer_jsx_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)("br", {}), /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(_kubb_renderer_jsx.File.Source, {
 		name,
@@ -740,16 +821,18 @@ function buildClassClientParams({ node, path, baseURL, tsResolver, isFormData, i
 	const { query: queryParams } = getOperationParameters(node);
 	const queryParamsName = queryParams.length > 0 ? tsResolver.resolveQueryParamsName(node, queryParams[0]) : null;
 	const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : null;
+	const responseType = getResponseType(node);
 	return createFunctionParams({ config: {
 		mode: "object",
 		children: {
 			requestConfig: { mode: "inlineSpread" },
-			method: { value: JSON.stringify(node.method.toUpperCase()) },
+			method: { value: JSON.stringify(_kubb_core.ast.isHttpOperationNode(node) ? node.method.toUpperCase() : "") },
 			url: { value: path.template },
 			baseURL: baseURL ? { value: JSON.stringify(baseURL) } : null,
 			params: queryParamsName ? {} : null,
 			data: requestName ? { value: isMultipleContentTypes && hasFormData ? "contentType === 'multipart/form-data' ? formData as FormData : requestData" : isFormData ? "formData as FormData" : "requestData" } : null,
 			contentType: isMultipleContentTypes ? {} : null,
+			responseType: responseType ? { value: JSON.stringify(responseType) } : null,
 			headers: headers.length ? { value: `{ ${headers.join(", ")}, ...requestConfig.headers }` } : null
 		}
 	} });
@@ -779,13 +862,14 @@ function buildReturnStatement({ dataReturnType, parser, node, zodResolver }) {
 	const zodResponseName = zodResolver && parser === "zod" ? zodResolver.resolveResponseName?.(node) : null;
 	if (dataReturnType === "full" && parser === "zod" && zodResponseName) return `return {...res, data: ${zodResponseName}.parse(res.data)}`;
 	if (dataReturnType === "data" && parser === "zod" && zodResponseName) return `return ${zodResponseName}.parse(res.data)`;
-	if (dataReturnType === "full" && parser === "client") return "return res";
+	if (dataReturnType === "full" && parser !== "zod") return "return res";
 	return "return res.data";
 }
 //#endregion
 //#region src/components/ClassClient.tsx
 const declarationPrinter$1 = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 function generateMethod$1({ node, name, tsResolver, zodResolver, baseURL, dataReturnType, parser, paramsType, paramsCasing, pathParamsType }) {
+	if (!_kubb_core.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";
@@ -913,22 +997,12 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 		const pluginZod = parser === "zod" ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
 		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : null;
 		function buildOperationData(node) {
-			const typeFile = tsResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			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
-			}, {
+			const zodFile = zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginZod.options?.output ?? output,
 				group: pluginZod.options?.group ?? void 0
@@ -943,6 +1017,7 @@ const classClientGenerator = (0, _kubb_core.defineGenerator)({
 			};
 		}
 		const controllers = nodes.reduce((acc, operationNode) => {
+			if (!_kubb_core.ast.isHttpOperationNode(operationNode)) return acc;
 			const tag = operationNode.tags[0];
 			const groupName = tag ? group?.name?.({ group: camelCase(tag) }) ?? resolver.resolveGroupName(tag) : resolver.resolveGroupName("Client");
 			if (!tag && !group) {
@@ -1202,6 +1277,7 @@ const clientGenerator = (0, _kubb_core.defineGenerator)({
 	name: "client",
 	renderer: _kubb_renderer_jsx.jsxRendererSync,
 	operation(node, ctx) {
+		if (!_kubb_core.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;
@@ -1215,32 +1291,17 @@ const clientGenerator = (0, _kubb_core.defineGenerator)({
 		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
-			}, {
+			file: resolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output,
 				group: group ?? void 0
 			}),
-			fileTs: tsResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			fileTs: tsResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginTs.options?.output ?? output,
 				group: pluginTs.options?.group ?? void 0
 			}),
-			fileZod: zodResolver && pluginZod?.options ? zodResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			fileZod: zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginZod.options.output ?? output,
 				group: pluginZod.options?.group ?? void 0
@@ -1434,6 +1495,7 @@ const groupedClientGenerator = (0, _kubb_core.defineGenerator)({
 function Operations({ name, nodes }) {
 	const operationsObject = {};
 	nodes.forEach((node) => {
+		if (!_kubb_core.ast.isHttpOperationNode(node)) return;
 		operationsObject[node.operationId] = {
 			path: new URLPath(node.path).URL,
 			method: node.method.toLowerCase()
@@ -1495,7 +1557,7 @@ const operationsGenerator = (0, _kubb_core.defineGenerator)({
 			}),
 			children: /* @__PURE__ */ (0, _kubb_renderer_jsx_jsx_runtime.jsx)(Operations, {
 				name,
-				nodes
+				nodes: nodes.filter(_kubb_core.ast.isHttpOperationNode)
 			})
 		});
 	}
@@ -1504,6 +1566,7 @@ const operationsGenerator = (0, _kubb_core.defineGenerator)({
 //#region src/components/StaticClassClient.tsx
 const declarationPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
 function generateMethod({ node, name, tsResolver, zodResolver, baseURL, dataReturnType, parser, paramsType, paramsCasing, pathParamsType }) {
+	if (!_kubb_core.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";
@@ -1604,22 +1667,12 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 		const pluginZod = parser === "zod" ? driver.getPlugin(_kubb_plugin_zod.pluginZodName) : null;
 		const zodResolver = pluginZod ? driver.getResolver(_kubb_plugin_zod.pluginZodName) : null;
 		function buildOperationData(node) {
-			const typeFile = tsResolver.resolveFile({
-				name: node.operationId,
-				extname: ".ts",
-				tag: node.tags[0] ?? "default",
-				path: node.path
-			}, {
+			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
-			}, {
+			const zodFile = zodResolver && pluginZod?.options ? zodResolver.resolveFile(operationFileEntry(node, node.operationId), {
 				root,
 				output: pluginZod.options?.output ?? output,
 				group: pluginZod.options?.group ?? void 0
@@ -1634,6 +1687,7 @@ const staticClassClientGenerator = (0, _kubb_core.defineGenerator)({
 			};
 		}
 		const controllers = nodes.reduce((acc, operationNode) => {
+			if (!_kubb_core.ast.isHttpOperationNode(operationNode)) return acc;
 			const tag = operationNode.tags[0];
 			const groupName = tag ? group?.name?.({ group: camelCase(tag) }) ?? resolver.resolveGroupName(tag) : resolver.resolveGroupName("Client");
 			if (!tag && !group) {
@@ -1903,20 +1957,17 @@ const pluginClient = (0, _kubb_core.definePlugin)((options) => {
 	const { output = {
 		path: "clients",
 		barrelType: "named"
-	}, group, exclude = [], include, override = [], urlType = false, dataReturnType = "data", paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", operations = false, paramsCasing, clientType = options.sdk ? "class" : "function", parser = "client", client = "axios", importPath, bundle = false, sdk, baseURL, resolver: userResolver, transformer: userTransformer } = options;
+	}, group, exclude = [], include, override = [], urlType = false, dataReturnType = "data", paramsType = "inline", pathParamsType = paramsType === "object" ? "object" : options.pathParamsType || "inline", operations = false, paramsCasing, clientType = options.sdk ? "class" : "function", parser = false, client = "axios", importPath, bundle = false, sdk, baseURL, resolver: userResolver, transformer: userTransformer } = options;
 	const resolvedImportPath = importPath ?? (!bundle ? `@kubb/plugin-client/clients/${client}` : void 0);
 	const selectedGenerators = options.generators ?? [
 		clientType === "staticClass" ? staticClassClientGenerator : clientType === "class" ? classClientGenerator : clientGenerator,
 		group && clientType === "function" ? groupedClientGenerator : null,
 		operations ? operationsGenerator : null
 	].filter((x) => Boolean(x));
-	const groupConfig = group ? {
-		...group,
-		name: group.name ? group.name : (ctx) => {
-			if (group.type === "path") return `${ctx.group.split("/")[1]}`;
-			return `${camelCase(ctx.group)}Controller`;
-		}
-	} : null;
+	const groupConfig = createGroupConfig(group, {
+		suffix: "Controller",
+		honorName: true
+	});
 	return {
 		name: pluginClientName,
 		options,