@kubb/plugin-client 6.1.0-canary.20261109T175349 → 6.1.0-canary.20261109T175913

package/dist/templates/client.d.ts

@@ -1,2 +1,2 @@
-import { M as SuccessOf, m as DataShape, n as NativeRequest, r as NativeResponse, t as NativeOptions, w as RequestResult, x as Options } from "../client-D0IfSe5q.js";
+import { M as SuccessOf, m as DataShape, n as NativeRequest, r as NativeResponse, t as NativeOptions, w as RequestResult, x as Options } from "../client-DaI8VaEz.js";
 export { type DataShape, NativeOptions, NativeRequest, NativeResponse, type Options, type RequestResult, type SuccessOf };

package/dist/templates/core.d.ts

@@ -1,3 +1,3 @@
 import { a as ValidateOption, o as ValidationErrorContext, s as ValidationErrorHandler } from "../standardSchema-B2AxHwZB.js";
-import { $ as unwrapResult, A as ResultByStatus, B as UnwrappedResult, C as RequestCredentials, D as ResponseErrorConfig, E as ResponseError, F as SuccessVariant, G as getHeader, H as Validator, I as ToStatusNumber, J as parseJsonOrText, K as getResponseContentType, L as Transport, M as SuccessOf, N as SuccessResultUnion, O as ResponseType, P as SuccessStatusCode, Q as toRequestInit, R as TransportResult, S as RequestConfig, T as ResolvedRequest, U as createClientCore, V as UrlConfig, W as createInterceptorStack, X as resolveAuth, Y as readResponse, Z as resolveResponseType, _ as ErrorOf, a as AuthResolver, b as Interceptors, c as ClientConfig, d as ContentBodySerializer, et as withUnwrap, f as ContentType, g as EmptyErrorBody, h as Deserializer, i as Auth, j as ResultUnion, k as ResponseTypeMap, l as ClientInstance, m as DataShape, o as AuthToken, p as DataOf, q as isStreamed, s as CallResult, u as Codec, v as InterceptorFn, w as RequestResult, x as Options, y as InterceptorStack, z as Unwrappable } from "../client-D0IfSe5q.js";
+import { $ as unwrapResult, A as ResultByStatus, B as UnwrappedResult, C as RequestCredentials, D as ResponseErrorConfig, E as ResponseError, F as SuccessVariant, G as getHeader, H as Validator, I as ToStatusNumber, J as parseJsonOrText, K as getResponseContentType, L as Transport, M as SuccessOf, N as SuccessResultUnion, O as ResponseType, P as SuccessStatusCode, Q as toRequestInit, R as TransportResult, S as RequestConfig, T as ResolvedRequest, U as createClientCore, V as UrlConfig, W as createInterceptorStack, X as resolveAuth, Y as readResponse, Z as resolveResponseType, _ as ErrorOf, a as AuthResolver, b as Interceptors, c as ClientConfig, d as ContentBodySerializer, et as withUnwrap, f as ContentType, g as EmptyErrorBody, h as Deserializer, i as Auth, j as ResultUnion, k as ResponseTypeMap, l as ClientInstance, m as DataShape, o as AuthToken, p as DataOf, q as isStreamed, s as CallResult, u as Codec, v as InterceptorFn, w as RequestResult, x as Options, y as InterceptorStack, z as Unwrappable } from "../client-DaI8VaEz.js";
 export { Auth, AuthResolver, AuthToken, CallResult, ClientConfig, ClientInstance, Codec, ContentBodySerializer, ContentType, DataOf, DataShape, Deserializer, EmptyErrorBody, ErrorOf, InterceptorFn, InterceptorStack, Interceptors, Options, RequestConfig, RequestCredentials, RequestResult, ResolvedRequest, ResponseError, ResponseErrorConfig, ResponseType, ResponseTypeMap, ResultByStatus, ResultUnion, SuccessOf, SuccessResultUnion, SuccessStatusCode, SuccessVariant, ToStatusNumber, Transport, TransportResult, Unwrappable, UnwrappedResult, UrlConfig, type ValidateOption, type ValidationErrorContext, type ValidationErrorHandler, Validator, createClientCore, createInterceptorStack, getHeader, getResponseContentType, isStreamed, parseJsonOrText, readResponse, resolveAuth, resolveResponseType, toRequestInit, unwrapResult, withUnwrap };

package/dist/templates/sse.d.ts

@@ -1,5 +1,5 @@
 import { a as ValidateOption, i as StandardSchemaValidator, s as ValidationErrorHandler } from "../standardSchema-B2AxHwZB.js";
-import { M as SuccessOf, m as DataShape, n as NativeRequest, r as NativeResponse, w as RequestResult, x as Options } from "../client-D0IfSe5q.js";
+import { M as SuccessOf, m as DataShape, n as NativeRequest, r as NativeResponse, w as RequestResult, x as Options } from "../client-DaI8VaEz.js";
 /**
  * One decoded Server-Sent Event. `data` is parsed as JSON when valid and kept as the raw string otherwise,
  * `event` is `message` when the server sent no `event` field, and `id` is the last event ID the stream has set.

package/docs/guides/validate-requests-and-responses.md

@@ -29,11 +29,13 @@ Each generated call now includes the schemas:
 request({
   method: 'POST',
   url: '/pet',
-  validator: { response: addPetResponseSchema, error: addPetErrorSchema, errorStatus: [405] },
   ...config,
+  validator: { response: addPetResponseSchema, error: { 405: addPetStatus405Schema }, ...config.validator },
 })
 ```
 
+A `validator` passed on one call is merged per key, so `validator: { request }` adds a request schema and keeps the generated response schema. A per-call `error` replaces the generated error map as a whole.
+
 Add a `validator` field to your `RequestConfig`, then run the schemas in `client`. Zod schemas follow [Standard Schema](https://standardschema.dev), so `~standard.validate` works with any compatible library:
 
 ```typescript [src/client.ts]
@@ -42,7 +44,7 @@ type Schema = { '~standard': { validate: (value: unknown) => Result | Promise<Re
 
 export type RequestConfig = {
   // ...
-  validator?: { request?: Schema; response?: Schema; error?: Schema; errorStatus?: Array<number | string> }
+  validator?: { request?: Schema; response?: Schema; error?: Schema | Record<string, Schema> }
 }
 
 // inside client(), after reading the body
@@ -53,7 +55,7 @@ const validatedBody = result && 'value' in result ? result.value : body
 
 Return `validatedBody` as `data`, so a schema that transforms the value takes effect. Without a response schema, `validatedBody` is the original `body`.
 
-`errorStatus` lists the statuses `error` covers. Skip `error` for any other status.
+`error` is keyed by status, such as `{ 404: schema, '5XX': schema, default: schema }`. Pick the exact status, then its range, then `default`, and skip validation when none matches.
 
 Set `validator: { request: 'zod' }` or `{ response: 'zod' }` to pass one direction only. Without `pluginZod()` in the plugins list, generation stops with an error.
 
@@ -65,12 +67,13 @@ With `validator: { params: 'zod' }`, each call also passes the schemas for its p
 request({
   method: 'PUT',
   url: '/events/{day}',
+  ...config,
   validator: {
     path: putEventPathSchema,
     query: putEventQuerySchema,
     headers: toHeadersStandardSchema(putEventHeadersSchema, putEventHeadersSchema.shape),
+    ...config.validator,
   },
-  ...config,
 })
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-client",
-  "version": "6.1.0-canary.20261109T175349",
+  "version": "6.1.0-canary.20261109T175913",
   "description": "Generate typed API operations against your own client module.",
   "keywords": [
     "api-client",
@@ -62,13 +62,13 @@
   },
   "dependencies": {
     "@kubb/kit": "^5.16.1",
-    "@kubb/plugin-ts": "^5.5.0-canary.20261109T175348",
-    "@kubb/plugin-zod": "^5.9.0-canary.20261109T175348",
+    "@kubb/plugin-ts": "^5.5.0-canary.20261109T175913",
+    "@kubb/plugin-zod": "^5.9.0-canary.20261109T175913",
     "@kubb/renderer-jsx": "^5.16.1"
   },
   "devDependencies": {
-    "@internals/client": "0.1.0-canary.20261109T175348",
-    "@internals/shared": "0.1.0-canary.20261109T175348",
+    "@internals/client": "0.1.0-canary.20261109T175913",
+    "@internals/shared": "0.1.0-canary.20261109T175913",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {},

package/templates/core.ts

@@ -226,7 +226,7 @@ export type RequestConfig<TBody = unknown, TRequest = NativeRequest, TResponse =
   transport?: Transport<TRequest, TResponse>
   serializer?: Serializers
   codecs?: Record<string, Codec>
-  /** `errorStatus` lists the statuses `error` covers, such as `[404, '5XX']`. Without it, `error` checks every non-2xx body. */
+  /** `error` takes one validator for every non-2xx body, or a map by status such as `{ 404: schema, '5XX': schema, default: schema }`. */
   validator?: {
     request?: Validator
     path?: Validator
@@ -234,8 +234,7 @@ export type RequestConfig<TBody = unknown, TRequest = NativeRequest, TResponse =
     headers?: Validator
     cookies?: Validator
     response?: Validator
-    error?: Validator
-    errorStatus?: Array<number | string>
+    error?: Validator | Record<string, Validator>
   }
   onValidationError?: ValidationErrorHandler
   validate?: ValidateOption
@@ -627,9 +626,11 @@ export async function readResponse<TRequest, TResponse extends Response>(
   }
 }
 
-/** Returns `true` when `statuses` is unset or lists `status`, directly or by a range key such as `'5XX'`. */
-function coversStatus(statuses: ReadonlyArray<number | string> | undefined, status: number): boolean {
-  return !statuses || statuses.some((code) => [String(status), `${String(status)[0]}XX`].includes(String(code).toUpperCase()))
+/** Picks the error validator for `status`: the exact status, then its range such as `5XX`, then `default`. */
+function pickErrorValidator(error: Validator | Record<string, Validator> | undefined, status: number): Validator | undefined {
+  if (!error || '~standard' in error) return error as Validator | undefined
+  const range = Object.keys(error).find((key) => key.toUpperCase() === `${String(status)[0]}XX`)
+  return error[String(status)] ?? (range ? error[range] : undefined) ?? error.default
 }
 
 /**
@@ -828,10 +829,9 @@ export function createClientCore<TRequest = NativeRequest, TResponse = NativeRes
     // A streamed success body is validated event by event in `toEventStream`, not as a whole. A JSON answer to a streamed call is a whole body.
     const streaming = isSuccess && resolveResponseType(resolvedRequest.responseType, contentType) === 'stream' && isStreamed(decoded)
     // An error body is validated only when the call returns it. A call that throws keeps its `ResponseError`.
-    const declared = isSuccess || coversStatus(validator?.errorStatus, result.status)
-    const validatesBody = isValidationEnabled(validate, direction) && !streaming && declared && (isSuccess || !throwOnError)
+    const validatesBody = isValidationEnabled(validate, direction) && !streaming && (isSuccess || !throwOnError)
     const data = await runValidator({
-      validator: validatesBody ? validator?.[direction] : undefined,
+      validator: validatesBody ? (isSuccess ? validator?.response : pickErrorValidator(validator?.error, result.status)) : undefined,
       value: decoded,
       context: { direction, source: 'body', method: resolvedRequest.method, url: resolvedRequest.url, status: result.status },
       onValidationError,