@kubb/plugin-client 5.0.0-beta.25 → 5.0.0-beta.27

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

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/templates/clients/axios.source.ts
-const source = "import type { AxiosError, AxiosRequestConfig, AxiosResponse } from 'axios'\nimport axios from 'axios'\n\ndeclare const AXIOS_BASE: string\ndeclare const AXIOS_HEADERS: string\n\n/**\n * Subset of AxiosRequestConfig\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  validateStatus?: (status: number) => boolean\n  headers?: AxiosRequestConfig['headers']\n  contentType?: string\n}\n\n/**\n * Subset of AxiosResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: AxiosResponse['headers']\n}\n\nexport type ResponseErrorConfig<TError = unknown> = AxiosError<TError>\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nlet _config: Partial<RequestConfig> = {\n  baseURL: typeof AXIOS_BASE !== 'undefined' ? AXIOS_BASE : undefined,\n  headers: typeof AXIOS_HEADERS !== 'undefined' ? JSON.parse(AXIOS_HEADERS) : undefined,\n}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: 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        ...merged.headers,\n        ...config.headers,\n      },\n    }\n  }, {})\n}\n\nexport const axiosInstance = axios.create(getConfig())\n\nexport const fetch = async <TData, TError = unknown, TVariables = unknown>(\n  config: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const requestConfig = mergeConfig(getConfig(), config)\n  const { contentType, headers, ...axiosConfig } = requestConfig\n  return axiosInstance\n    .request<TData, ResponseConfig<TData>>({\n      ...axiosConfig,\n      headers: {\n        ...(contentType && contentType !== 'multipart/form-data' ? { 'Content-Type': contentType } : {}),\n        ...headers,\n      },\n    })\n    .catch((e: AxiosError<TError>) => {\n      throw e\n    })\n}\n\nfetch.getConfig = getConfig\nfetch.setConfig = setConfig\n";
+const source = "import type { AxiosError, AxiosRequestConfig, AxiosResponse } from 'axios'\nimport axios from 'axios'\n\ndeclare const AXIOS_BASE: string\ndeclare const AXIOS_HEADERS: string\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 AxiosRequestConfig\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  validateStatus?: (status: number) => boolean\n  headers?: HeadersInit\n  contentType?: string\n}\n\n/**\n * Subset of AxiosResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: AxiosResponse['headers']\n}\n\nexport type ResponseErrorConfig<TError = unknown> = AxiosError<TError>\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nlet _config: Partial<RequestConfig> = {\n  baseURL: typeof AXIOS_BASE !== 'undefined' ? AXIOS_BASE : undefined,\n  headers: typeof AXIOS_HEADERS !== 'undefined' ? JSON.parse(AXIOS_HEADERS) : undefined,\n}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: 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 `axios` ultimately puts on the wire.\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 const axiosInstance = axios.create(getConfig() as AxiosRequestConfig)\n\nexport const fetch = async <TData, TError = unknown, TVariables = unknown>(\n  config: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const requestConfig = mergeConfig(getConfig(), config)\n  const { contentType, headers, ...axiosConfig } = requestConfig\n  return axiosInstance\n    .request<TData, ResponseConfig<TData>>({\n      ...axiosConfig,\n      headers: {\n        ...(contentType && contentType !== 'multipart/form-data' ? { 'Content-Type': contentType } : {}),\n        ...serializeHeaders(headers),\n      },\n    })\n    .catch((e: AxiosError<TError>) => {\n      throw e\n    })\n}\n\nfetch.getConfig = getConfig\nfetch.setConfig = setConfig\n";
 //#endregion
 exports.source = source;
 

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

@@ -1,5 +1,5 @@
 //#region src/templates/clients/axios.source.ts
-const source = "import type { AxiosError, AxiosRequestConfig, AxiosResponse } from 'axios'\nimport axios from 'axios'\n\ndeclare const AXIOS_BASE: string\ndeclare const AXIOS_HEADERS: string\n\n/**\n * Subset of AxiosRequestConfig\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  validateStatus?: (status: number) => boolean\n  headers?: AxiosRequestConfig['headers']\n  contentType?: string\n}\n\n/**\n * Subset of AxiosResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: AxiosResponse['headers']\n}\n\nexport type ResponseErrorConfig<TError = unknown> = AxiosError<TError>\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nlet _config: Partial<RequestConfig> = {\n  baseURL: typeof AXIOS_BASE !== 'undefined' ? AXIOS_BASE : undefined,\n  headers: typeof AXIOS_HEADERS !== 'undefined' ? JSON.parse(AXIOS_HEADERS) : undefined,\n}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: 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        ...merged.headers,\n        ...config.headers,\n      },\n    }\n  }, {})\n}\n\nexport const axiosInstance = axios.create(getConfig())\n\nexport const fetch = async <TData, TError = unknown, TVariables = unknown>(\n  config: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const requestConfig = mergeConfig(getConfig(), config)\n  const { contentType, headers, ...axiosConfig } = requestConfig\n  return axiosInstance\n    .request<TData, ResponseConfig<TData>>({\n      ...axiosConfig,\n      headers: {\n        ...(contentType && contentType !== 'multipart/form-data' ? { 'Content-Type': contentType } : {}),\n        ...headers,\n      },\n    })\n    .catch((e: AxiosError<TError>) => {\n      throw e\n    })\n}\n\nfetch.getConfig = getConfig\nfetch.setConfig = setConfig\n";
+const source = "import type { AxiosError, AxiosRequestConfig, AxiosResponse } from 'axios'\nimport axios from 'axios'\n\ndeclare const AXIOS_BASE: string\ndeclare const AXIOS_HEADERS: string\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 AxiosRequestConfig\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  validateStatus?: (status: number) => boolean\n  headers?: HeadersInit\n  contentType?: string\n}\n\n/**\n * Subset of AxiosResponse\n */\nexport type ResponseConfig<TData = unknown> = {\n  data: TData\n  status: number\n  statusText: string\n  headers: AxiosResponse['headers']\n}\n\nexport type ResponseErrorConfig<TError = unknown> = AxiosError<TError>\n\nexport type Client = <TData, _TError = unknown, TVariables = unknown>(config: RequestConfig<TVariables>, request?: unknown) => Promise<ResponseConfig<TData>>\n\nlet _config: Partial<RequestConfig> = {\n  baseURL: typeof AXIOS_BASE !== 'undefined' ? AXIOS_BASE : undefined,\n  headers: typeof AXIOS_HEADERS !== 'undefined' ? JSON.parse(AXIOS_HEADERS) : undefined,\n}\n\nexport const getConfig = () => _config\n\nexport const setConfig = (config: 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 `axios` ultimately puts on the wire.\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 const axiosInstance = axios.create(getConfig() as AxiosRequestConfig)\n\nexport const fetch = async <TData, TError = unknown, TVariables = unknown>(\n  config: RequestConfig<TVariables>,\n  _request?: unknown,\n): Promise<ResponseConfig<TData>> => {\n  const requestConfig = mergeConfig(getConfig(), config)\n  const { contentType, headers, ...axiosConfig } = requestConfig\n  return axiosInstance\n    .request<TData, ResponseConfig<TData>>({\n      ...axiosConfig,\n      headers: {\n        ...(contentType && contentType !== 'multipart/form-data' ? { 'Content-Type': contentType } : {}),\n        ...serializeHeaders(headers),\n      },\n    })\n    .catch((e: AxiosError<TError>) => {\n      throw e\n    })\n}\n\nfetch.getConfig = getConfig\nfetch.setConfig = setConfig\n";
 //#endregion
 export { source };
 

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 * 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?: Array<[string, string]> | Record<string, string>\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\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 fetch = 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      ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : 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\nfetch.getConfig = getConfig\nfetch.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\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 fetch = 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\nfetch.getConfig = getConfig\nfetch.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 * 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?: Array<[string, string]> | Record<string, string>\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\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 fetch = 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      ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : 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\nfetch.getConfig = getConfig\nfetch.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\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 fetch = 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\nfetch.getConfig = getConfig\nfetch.setConfig = setConfig\n";
 //#endregion
 export { source };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-client",
-  "version": "5.0.0-beta.25",
+  "version": "5.0.0-beta.27",
   "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.25",
-    "@kubb/renderer-jsx": "5.0.0-beta.25",
-    "@kubb/plugin-ts": "5.0.0-beta.25",
-    "@kubb/plugin-zod": "5.0.0-beta.25"
+    "@kubb/core": "5.0.0-beta.27",
+    "@kubb/renderer-jsx": "5.0.0-beta.27",
+    "@kubb/plugin-ts": "5.0.0-beta.27",
+    "@kubb/plugin-zod": "5.0.0-beta.27"
   },
   "devDependencies": {
     "axios": "^1.16.1",
@@ -98,7 +98,7 @@
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.25",
+    "@kubb/renderer-jsx": "5.0.0-beta.27",
     "axios": "^1.7.2"
   },
   "peerDependenciesMeta": {

package/src/clients/axios.ts

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

package/src/clients/fetch.ts

@@ -3,6 +3,13 @@
  */
 export type RequestCredentials = 'omit' | 'same-origin' | 'include'
 
+/**
+ * Header values may be objects (e.g. JSON-encoded filter headers like `X-Filter`).
+ * Non-string values are JSON-serialized before the request is sent.
+ */
+export type HeaderValue = string | number | boolean | null | undefined | object
+export type HeadersInit = Array<[string, HeaderValue]> | Record<string, HeaderValue>
+
 /**
  * Subset of FetchRequestConfig
  */
@@ -14,7 +21,7 @@ export type RequestConfig<TData = unknown> = {
   data?: TData | FormData
   responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'
   signal?: AbortSignal
-  headers?: Array<[string, string]> | Record<string, string>
+  headers?: HeadersInit
   credentials?: RequestCredentials
   contentType?: string
 }
@@ -51,6 +58,22 @@ export const mergeConfig = <T extends RequestConfig>(...configs: Array<Partial<T
   }, {})
 }
 
+/**
+ * Serializes header values into the string form `fetch` expects.
+ * Objects (including arrays) are JSON-stringified so spec-defined object
+ * headers like `X-Filter` are sent in their canonical JSON-string form.
+ */
+function serializeHeaders(headers: HeadersInit | undefined): Record<string, string> {
+  if (!headers) return {}
+  const entries = Array.isArray(headers) ? headers : Object.entries(headers)
+  const result: Record<string, string> = {}
+  for (const [key, value] of entries) {
+    if (value === undefined || value === null) continue
+    result[key] = typeof value === 'string' ? value : typeof value === 'object' ? JSON.stringify(value) : String(value)
+  }
+  return result
+}
+
 export type ResponseErrorConfig<TError = unknown> = TError
 
 export type Client = <TResponseData, _TError = unknown, TRequestData = unknown>(
@@ -85,7 +108,7 @@ export const client = async <TResponseData, _TError = unknown, RequestData = unk
     signal: config.signal,
     headers: {
       ...(config.contentType && config.contentType !== 'multipart/form-data' ? { 'Content-Type': config.contentType } : {}),
-      ...(Array.isArray(config.headers) ? Object.fromEntries(config.headers) : config.headers),
+      ...serializeHeaders(config.headers),
     },
   })
 

package/src/components/Client.tsx

@@ -1,4 +1,11 @@
-import { buildOperationComments, buildParamsMapping, buildRequestConfigType, getContentTypeInfo, getOperationParameters } from '@internals/shared'
+import {
+  buildOperationComments,
+  buildParamsMapping,
+  buildRequestConfigType,
+  getContentTypeInfo,
+  getOperationParameters,
+  resolveSuccessNames,
+} from '@internals/shared'
 import { isValidVarName, URLPath } from '@internals/utils'
 import { ast } from '@kubb/core'
 import type { ResolverTs } from '@kubb/plugin-ts'
@@ -101,7 +108,8 @@ export function Client({
   const headerParamsMapping = paramsCasing ? buildParamsMapping(originalHeaderParams, casedHeaderParams) : null
 
   const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : null
-  const responseName = tsResolver.resolveResponseName(node)
+  const successNames = resolveSuccessNames(node, tsResolver)
+  const responseName = successNames.length > 0 ? successNames.join(' | ') : tsResolver.resolveResponseName(node)
   const queryParamsName = originalQueryParams.length > 0 ? tsResolver.resolveQueryParamsName(node, originalQueryParams[0]!) : null
   const headerParamsName = originalHeaderParams.length > 0 ? tsResolver.resolveHeaderParamsName(node, originalHeaderParams[0]!) : null
 

package/src/resolvers/resolverClient.ts

@@ -1,4 +1,4 @@
-import { camelCase, pascalCase } from '@internals/utils'
+import { camelCase, ensureValidVarName, pascalCase } from '@internals/utils'
 import { defineResolver } from '@kubb/core'
 import type { PluginClient } from '../types.ts'
 
@@ -20,7 +20,8 @@ export const resolverClient = defineResolver<PluginClient>(() => ({
   name: 'default',
   pluginName: 'plugin-client',
   default(name, type) {
-    return camelCase(name, { isFile: type === 'file' })
+    const resolved = camelCase(name, { isFile: type === 'file' })
+    return type === 'file' ? resolved : ensureValidVarName(resolved)
   },
   resolveName(name) {
     return this.default(name, 'function')
@@ -29,13 +30,13 @@ export const resolverClient = defineResolver<PluginClient>(() => ({
     return this.default(name, type)
   },
   resolveClassName(name) {
-    return pascalCase(name)
+    return ensureValidVarName(pascalCase(name))
   },
   resolveGroupName(name) {
-    return pascalCase(name)
+    return ensureValidVarName(pascalCase(name))
   },
   resolveClientPropertyName(name) {
-    return camelCase(name)
+    return ensureValidVarName(camelCase(name))
   },
   resolveUrlName(node) {
     const name = this.resolveName(node.operationId)

package/src/utils.ts

@@ -1,4 +1,4 @@
-import { getOperationParameters } from '@internals/shared'
+import { getOperationParameters, resolveSuccessNames } from '@internals/shared'
 import type { URLPath } from '@internals/utils'
 import type { ast } from '@kubb/core'
 import type { ResolverTs } from '@kubb/plugin-ts'
@@ -22,7 +22,8 @@ export function buildHeaders(contentType: string, hasHeaderParams: boolean): Arr
  * Includes response type, error type, and optional request type.
  */
 export function buildGenerics(node: ast.OperationNode, tsResolver: ResolverTs): Array<string> {
-  const responseName = tsResolver.resolveResponseName(node)
+  const successNames = resolveSuccessNames(node, tsResolver)
+  const responseName = successNames.length > 0 ? successNames.join(' | ') : tsResolver.resolveResponseName(node)
   const requestName = node.requestBody?.content?.[0]?.schema ? tsResolver.resolveDataName(node) : null
   const errorNames = node.responses.filter((r) => Number.parseInt(r.statusCode, 10) >= 400).map((r) => tsResolver.resolveResponseStatusName(node, r.statusCode))
   const TError = `ResponseErrorConfig<${errorNames.length > 0 ? errorNames.join(' | ') : 'Error'}>`