@kubb/plugin-fetch 5.5.0-canary.20260924T110844 → 5.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-fetch",
-  "version": "5.5.0-canary.20260924T110844",
+  "version": "5.5.0",
   "description": "Generate a slim, type-safe HTTP client with Kubb based on the native Fetch api.",
   "keywords": [
     "api-client",
@@ -65,17 +65,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/plugin-ts": "^5.1.0-canary.20260924T110844",
-    "@kubb/plugin-zod": "^5.3.0-canary.20260924T110844"
+    "@kubb/plugin-ts": "^5.0.2",
+    "@kubb/plugin-zod": "^5.2.1"
   },
   "devDependencies": {
-    "@internals/client": "0.1.0-canary.20260924T110844",
-    "@internals/shared": "0.1.0-canary.20260924T110844",
-    "kubb": "^5.3.13",
+    "@internals/client": "0.0.0",
+    "@internals/shared": "0.0.0",
+    "kubb": "^5.3.14",
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
-    "kubb": "^5.3.13"
+    "kubb": "^5.3.14"
   },
   "engines": {
     "node": ">=22"

package/src/plugin.ts

@@ -1,5 +1,5 @@
 import path from 'node:path'
-import { createSdkGenerator, defaultMacros, resolverClient } from '@internals/client'
+import { createSdkGenerator, defaultMacros, resolverClient, runtimeTemplate } from '@internals/client'
 import { createGroupConfig } from '@internals/shared'
 import { definePlugin, Resolver } from 'kubb/kit'
 import { pluginTsName } from '@kubb/plugin-ts'
@@ -43,6 +43,7 @@ export const pluginFetch = definePlugin<PluginFetch>((options) => {
     include,
     override = [],
     baseURL,
+    throwOnErrorDefault = true,
     validator = false,
     returnType = 'full',
     group,
@@ -57,6 +58,7 @@ export const pluginFetch = definePlugin<PluginFetch>((options) => {
     override,
     group: createGroupConfig(group),
     baseURL,
+    throwOnErrorDefault,
     validator,
     returnType,
     sdk: sdk ? { mode: sdk.mode ?? 'tag', name: sdk.name } : undefined,
@@ -93,7 +95,8 @@ export const pluginFetch = definePlugin<PluginFetch>((options) => {
         ctx.injectFile({
           baseName: 'client.ts',
           path: path.resolve(root, '.kubb/client.ts'),
-          copy: fetchClientTemplatePath,
+          // Keep sources empty so the barrel exports the whole runtime module.
+          banner: runtimeTemplate(fetchClientTemplatePath, ctx.config),
           footer: baseURLExpression ? `client.setConfig({ baseURL: ${baseURLExpression} })` : undefined,
         })
 

package/templates/fetch.ts

@@ -1,6 +1,6 @@
-import { applyHeaderStyles, defaultBodySerializer, defaultPathSerializer, defaultQuerySerializer, isDefaultJsonBody, serializeCookies } from './serializers'
-import type { HeadersInit, PathParamStyle, PathSerializer, RequestBody, Serializers, Styles } from './serializers'
-import { ParseError, type StandardSchemaValidator, validateStandardSchema } from './standardSchema'
+import { applyHeaderStyles, defaultBodySerializer, defaultPathSerializer, defaultQuerySerializer, isDefaultJsonBody, serializeCookies } from './serializers.ts'
+import type { HeadersInit, PathParamStyle, PathSerializer, RequestBody, Serializers, Styles } from './serializers.ts'
+import { ParseError, type StandardSchemaValidator, validateStandardSchema } from './standardSchema.ts'
 
 /**
  * HTTP status codes treated as a success, everything else is an error.
@@ -109,21 +109,16 @@ export function withUnwrap<T extends { data: unknown; error: unknown }>(promise:
 }
 
 /**
- * The shape a generated operation returns when `returnType: 'data'` is set: the bare success body
- * once `throwOnError` (on by default) narrows away the error branch, falling back to the full
- * `RequestResult` when a call sets `throwOnError: false` and still needs `error` to discriminate a
- * failed response.
+ * The shape a generated operation returns with `returnType: 'data'`: the success body when
+ * `throwOnError` is true, or the full `RequestResult` when it is false.
  */
 export type UnwrappedResult<TResponses, ThrowOnError extends boolean = true, TRequest = Request, TResponse = Response> = ThrowOnError extends true
   ? RequestResult<TResponses, true, TRequest, TResponse>['data']
   : RequestResult<TResponses, ThrowOnError, TRequest, TResponse>
 
 /**
- * Narrows a resolved call down to its success body once `throwOnError` (on by default) rules out
- * the error branch, the same default the runtime itself applies. Falls back to the full result for
- * a call that sets `throwOnError: false`, since that path still needs `error` to discriminate a
- * failed response. Backs `returnType: 'data'`, mirroring how `toEventStream` centralizes the
- * post-processing for `text/event-stream` operations.
+ * Returns the success body when `throwOnError` is true, or the full result when it is false.
+ * Backs generated operations with `returnType: 'data'`.
  */
 export function unwrapResult<T extends { data: unknown; error: unknown }>(promise: Promise<T>, throwOnError: boolean | undefined): Promise<T | T['data']> {
   return promise.then((result) => ((throwOnError ?? true) ? result.data : result))
@@ -317,25 +312,25 @@ export type CallResult<TRequest = Request, TResponse = Response> = {
   response: TResponse
 }
 
-export type InterceptorFn<T> = (value: T) => T | Promise<T>
+export type InterceptorFn<T, TContext = never> = (value: T, context?: TContext) => T | Promise<T>
 
 /**
  * A single interceptor channel with a transport-agnostic `use` / `eject` / `update` API.
  */
-export type InterceptorStack<T> = {
-  use: (fn: InterceptorFn<T>) => number
+export type InterceptorStack<T, TContext = never> = {
+  use: (fn: InterceptorFn<T, TContext>) => number
   eject: (id: number) => void
-  update: (id: number, fn: InterceptorFn<T>) => void
-  run: (value: T) => Promise<T>
+  update: (id: number, fn: InterceptorFn<T, TContext>) => void
+  run: (value: T, context?: TContext) => Promise<T>
 }
 
 /**
  * The three interceptor channels every client instance exposes.
  */
 export type Interceptors<TRequest = Request, TResponse = Response> = {
-  request: InterceptorStack<ResolvedRequest>
-  response: InterceptorStack<TransportResult<unknown, TRequest, TResponse>>
-  error: InterceptorStack<ResponseError<unknown, TRequest, TResponse>>
+  request: InterceptorStack<ResolvedRequest, RequestConfig<unknown, TRequest, TResponse>>
+  response: InterceptorStack<TransportResult<unknown, TRequest, TResponse>, RequestConfig<unknown, TRequest, TResponse>>
+  error: InterceptorStack<ResponseError<unknown, TRequest, TResponse>, RequestConfig<unknown, TRequest, TResponse>>
 }
 
 /**
@@ -426,8 +421,8 @@ function serializeUrl({
 /**
  * Creates a transport-agnostic interceptor channel that runs interceptors in registration order.
  */
-export function createInterceptorStack<T>(): InterceptorStack<T> {
-  let entries: Array<{ id: number; fn: InterceptorFn<T> }> = []
+export function createInterceptorStack<T, TContext = never>(): InterceptorStack<T, TContext> {
+  let entries: Array<{ id: number; fn: InterceptorFn<T, TContext> }> = []
   let counter = 0
   return {
     use(fn) {
@@ -442,10 +437,10 @@ export function createInterceptorStack<T>(): InterceptorStack<T> {
       const entry = entries.find((item) => item.id === id)
       if (entry) entry.fn = fn
     },
-    async run(value) {
+    async run(value, context) {
       let result = value
       for (const entry of entries) {
-        result = await entry.fn(result)
+        result = await entry.fn(result, context)
       }
       return result
     },
@@ -640,6 +635,7 @@ async function settleResult<TRequest, TResponse>({
   validator,
   onValidationError,
   errorInterceptors,
+  requestConfig,
 }: {
   result: TransportResult<unknown, TRequest, TResponse>
   request: ResolvedRequest
@@ -647,7 +643,8 @@ async function settleResult<TRequest, TResponse>({
   throwOnError: boolean
   validator: { response?: Validator; error?: Validator } | undefined
   onValidationError: ValidationErrorHandler | undefined
-  errorInterceptors: InterceptorStack<ResponseError<unknown, TRequest, TResponse>>
+  errorInterceptors: InterceptorStack<ResponseError<unknown, TRequest, TResponse>, RequestConfig<unknown, TRequest, TResponse>>
+  requestConfig: RequestConfig<unknown, TRequest, TResponse>
 }): Promise<CallResult<TRequest, TResponse>> {
   const isSuccess = result.status >= 200 && result.status < 300
   const contentType = result.contentType ?? getResponseContentType(result.headers)
@@ -684,7 +681,7 @@ async function settleResult<TRequest, TResponse>({
       request: result.request,
       response: result.response,
     })
-    await errorInterceptors.run(responseError)
+    await errorInterceptors.run(responseError, requestConfig)
     throw responseError
   }
   return { status: result.status, data: undefined, error, contentType, request: result.request, response: result.response }
@@ -700,17 +697,17 @@ export function createClientCore<TRequest = Request, TResponse = Response>(
   let config: ClientConfig<TRequest, TResponse> = { ...initialConfig }
 
   const interceptors: Interceptors<TRequest, TResponse> = {
-    request: createInterceptorStack<ResolvedRequest>(),
-    response: createInterceptorStack<TransportResult<unknown, TRequest, TResponse>>(),
-    error: createInterceptorStack<ResponseError<unknown, TRequest, TResponse>>(),
+    request: createInterceptorStack<ResolvedRequest, RequestConfig<unknown, TRequest, TResponse>>(),
+    response: createInterceptorStack<TransportResult<unknown, TRequest, TResponse>, RequestConfig<unknown, TRequest, TResponse>>(),
+    error: createInterceptorStack<ResponseError<unknown, TRequest, TResponse>, RequestConfig<unknown, TRequest, TResponse>>(),
   }
 
   const client = (async <TBody = unknown>(requestConfig: RequestConfig<TBody, TRequest, TResponse>): Promise<CallResult<TRequest, TResponse>> => {
     const transport = requestConfig.transport ?? config.transport ?? defaultTransport
     const { request, codecs } = await resolveRequest({ config, requestConfig })
 
-    const resolvedRequest = await interceptors.request.run(request)
-    const result = await interceptors.response.run(await transport(resolvedRequest))
+    const resolvedRequest = await interceptors.request.run(request, requestConfig)
+    const result = await interceptors.response.run(await transport(resolvedRequest), requestConfig)
 
     return settleResult({
       result,
@@ -720,6 +717,7 @@ export function createClientCore<TRequest = Request, TResponse = Response>(
       validator: requestConfig.validator,
       onValidationError: requestConfig.onValidationError ?? config.onValidationError,
       errorInterceptors: interceptors.error,
+      requestConfig,
     })
   }) as ClientInstance<TRequest, TResponse>