@kubb/plugin-fetch 5.4.0-canary.20260910T114055 → 5.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-fetch",
-  "version": "5.4.0-canary.20260910T114055",
+  "version": "5.4.1",
   "description": "Generate a slim, type-safe HTTP client with Kubb based on the native Fetch api.",
   "keywords": [
     "api-client",
@@ -65,12 +65,12 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/plugin-ts": "^5.1.0-canary.20260910T114055",
-    "@kubb/plugin-zod": "^5.2.0-canary.20260910T114055"
+    "@kubb/plugin-ts": "^5.0.2",
+    "@kubb/plugin-zod": "^5.1.5"
   },
   "devDependencies": {
-    "@internals/client": "0.1.0-canary.20260910T114055",
-    "@internals/shared": "0.1.0-canary.20260910T114055",
+    "@internals/client": "0.0.0",
+    "@internals/shared": "0.0.0",
     "kubb": "^5.2.0",
     "typescript": "^6.0.3"
   },

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 { type StandardSchemaValidator, validateStandardSchema } from './standardSchema'
+import { ParseError, type StandardSchemaValidator, validateStandardSchema } from './standardSchema'
 
 /**
  * HTTP status codes treated as a success, everything else is an error.
@@ -170,6 +170,25 @@ export type ContentType = string | { request?: string; response?: string }
  */
 export type Validator<T = unknown> = StandardSchemaValidator<T>
 
+/**
+ * The failing body and the call it came from, handed to `onValidationError` alongside the `ParseError`.
+ * `direction` says which slot rejected it: the request body, the success body, or the error body.
+ */
+export type ValidationErrorContext = {
+  value: unknown
+  direction: 'request' | 'response' | 'error'
+  method?: string
+  url?: string
+  status?: number
+}
+
+/**
+ * Decides what a failed validation does. Returning nothing rethrows the `ParseError`; returning
+ * `{ value }` resolves the call with that value instead, so a drifted body can be reported and still
+ * delivered. The box keeps an explicit `{ value: undefined }` substitution distinct from declining.
+ */
+export type ValidationErrorHandler = (error: ParseError, context: ValidationErrorContext) => { value: unknown } | void | Promise<{ value: unknown } | void>
+
 /**
  * A resolved security scheme carried on each generated call's `security` array and passed to the `auth` resolver.
  */
@@ -202,12 +221,12 @@ export type RequestConfig<TBody = unknown, TRequest = Request, TResponse = Respo
   baseURL?: string
   url?: string
   method?: 'GET' | 'PUT' | 'PATCH' | 'POST' | 'DELETE' | 'OPTIONS' | 'HEAD'
-  path?: Record<string, unknown>
+  path?: unknown
   query?: unknown
   params?: unknown
-  cookies?: Record<string, unknown>
+  cookies?: unknown
   body?: TBody
-  headers?: HeadersInit
+  headers?: unknown
   styles?: Styles
   signal?: AbortSignal
   credentials?: RequestCredentials
@@ -220,6 +239,7 @@ export type RequestConfig<TBody = unknown, TRequest = Request, TResponse = Respo
   serializer?: Serializers
   codecs?: Record<string, Codec>
   validator?: { request?: Validator; response?: Validator; error?: Validator }
+  onValidationError?: ValidationErrorHandler
   security?: Array<Auth>
   auth?: AuthResolver
 }
@@ -249,6 +269,7 @@ export type ClientConfig<TRequest = Request, TResponse = Response> = {
   transport?: Transport<TRequest, TResponse>
   serializer?: Serializers
   codecs?: Record<string, Codec>
+  onValidationError?: ValidationErrorHandler
   auth?: AuthResolver
 }
 
@@ -463,9 +484,26 @@ export async function resolveAuth(params: {
   }
 }
 
-async function runValidator<T>(validator: Validator<T> | undefined, value: T): Promise<T> {
+async function runValidator<T>({
+  validator,
+  value,
+  context,
+  onValidationError,
+}: {
+  validator: Validator<T> | undefined
+  value: T
+  context: Omit<ValidationErrorContext, 'value'>
+  onValidationError: ValidationErrorHandler | undefined
+}): Promise<T> {
   if (!validator) return value
-  return validateStandardSchema(validator, value)
+  try {
+    return await validateStandardSchema(validator, value)
+  } catch (error) {
+    if (!onValidationError || !(error instanceof ParseError)) throw error
+    const handled = await onValidationError(error, { ...context, value })
+    if (!handled) throw error
+    return handled.value as T
+  }
 }
 
 /**
@@ -520,7 +558,7 @@ async function resolveRequest<TBody, TRequest, TResponse>({
   const { querySerializer, bodySerializer, pathSerializer } = resolveSerializers({ config, requestConfig })
   const codecs = { ...config.codecs, ...requestConfig.codecs }
 
-  const headers = mergeHeaders(config.headers, applyHeaderStyles(requestConfig.headers, requestConfig.styles?.header))
+  const headers = mergeHeaders(config.headers, applyHeaderStyles(requestConfig.headers as HeadersInit | undefined, requestConfig.styles?.header))
   const { request: requestContentTypeOption, response: responseContentType } = resolveContentType(requestConfig.contentType)
   const requestContentType = requestContentTypeOption ?? getHeader(headers, 'content-type')
   if (responseContentType && !hasHeader(headers, 'accept')) {
@@ -537,11 +575,16 @@ async function resolveRequest<TBody, TRequest, TResponse>({
   })
 
   if (requestConfig.cookies) {
-    const cookie = serializeCookies(requestConfig.cookies, requestConfig.styles?.cookie)
+    const cookie = serializeCookies(requestConfig.cookies as Record<string, unknown>, requestConfig.styles?.cookie)
     if (cookie) headers['Cookie'] = [headers['Cookie'], cookie].filter(Boolean).join('; ')
   }
 
-  const validatedBody = await runValidator(requestConfig.validator?.request, requestConfig.body)
+  const validatedBody = await runValidator({
+    validator: requestConfig.validator?.request,
+    value: requestConfig.body,
+    context: { direction: 'request', method: requestConfig.method, url: requestConfig.url },
+    onValidationError: requestConfig.onValidationError ?? config.onValidationError,
+  })
   const requestContentTypeBase = baseContentType(requestContentType)
   const contentCodec = requestContentTypeBase ? codecs[requestContentTypeBase] : undefined
   const usesDefaultBodySerializer = !contentCodec?.serialize && bodySerializer === defaultBodySerializer
@@ -561,7 +604,7 @@ async function resolveRequest<TBody, TRequest, TResponse>({
 
   const url = serializeUrl({
     parts: [requestConfig.baseURL ?? config.baseURL, requestConfig.url],
-    pathParams: requestConfig.path ?? {},
+    pathParams: (requestConfig.path ?? {}) as Record<string, unknown>,
     search: querySerializer(query, requestConfig.styles?.query),
     pathSerializer,
     pathStyles: requestConfig.styles?.path,
@@ -591,15 +634,19 @@ async function resolveRequest<TBody, TRequest, TResponse>({
  */
 async function settleResult<TRequest, TResponse>({
   result,
+  request,
   codecs,
   throwOnError,
   validator,
+  onValidationError,
   errorInterceptors,
 }: {
   result: TransportResult<unknown, TRequest, TResponse>
+  request: ResolvedRequest
   codecs: Record<string, Codec>
   throwOnError: boolean
   validator: { response?: Validator; error?: Validator } | undefined
+  onValidationError: ValidationErrorHandler | undefined
   errorInterceptors: InterceptorStack<ResponseError<unknown, TRequest, TResponse>>
 }): Promise<CallResult<TRequest, TResponse>> {
   const isSuccess = result.status >= 200 && result.status < 300
@@ -610,12 +657,24 @@ async function settleResult<TRequest, TResponse>({
     if (codec?.deserialize) decoded = await codec.deserialize(result.data, contentType)
   }
 
+  const validationContext = { method: request.method, url: request.url, status: result.status }
+
   if (isSuccess) {
-    const data = await runValidator(validator?.response, decoded)
+    const data = await runValidator({
+      validator: validator?.response,
+      value: decoded,
+      context: { direction: 'response', ...validationContext },
+      onValidationError,
+    })
     return { status: result.status, data, error: undefined, contentType, request: result.request, response: result.response }
   }
 
-  const error = await runValidator(validator?.error, decoded)
+  const error = await runValidator({
+    validator: validator?.error,
+    value: decoded,
+    context: { direction: 'error', ...validationContext },
+    onValidationError,
+  })
   if (throwOnError) {
     const responseError = new ResponseError({
       data: error,
@@ -655,9 +714,11 @@ export function createClientCore<TRequest = Request, TResponse = Response>(
 
     return settleResult({
       result,
+      request: resolvedRequest,
       codecs,
       throwOnError: requestConfig.throwOnError ?? config.throwOnError ?? true,
       validator: requestConfig.validator,
+      onValidationError: requestConfig.onValidationError ?? config.onValidationError,
       errorInterceptors: interceptors.error,
     })
   }) as ClientInstance<TRequest, TResponse>
@@ -672,7 +733,7 @@ export function createClientCore<TRequest = Request, TResponse = Response>(
     const query: Record<string, unknown> = { ...((requestConfig.query ?? requestConfig.params) as Record<string, unknown> | undefined) }
     return serializeUrl({
       parts: [requestConfig.baseURL ?? config.baseURL, requestConfig.url],
-      pathParams: requestConfig.path ?? {},
+      pathParams: (requestConfig.path ?? {}) as Record<string, unknown>,
       search: querySerializer(query, requestConfig.styles?.query),
       pathSerializer,
       pathStyles: requestConfig.styles?.path,