@kubb/plugin-fetch 5.5.10 → 5.5.11

package/dist/index.cjs

@@ -1487,7 +1487,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.5.10";
+var version = "5.5.11";
 //#endregion
 //#region src/templates.ts
 /** Absolute path to the fetch client template, copied into `.kubb/client.ts`. */

package/dist/index.js

@@ -1461,7 +1461,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.5.10";
+var version = "5.5.11";
 //#endregion
 //#region src/templates.ts
 /** Absolute path to the fetch client template, copied into `.kubb/client.ts`. */

package/docs/options.md

@@ -11,7 +11,6 @@ Pass these options to `pluginFetch()`. Shared options link to [Shared plugin opt
 | [`baseURL`](#baseurl)                                                     | Base URL prepended to every request.                                   | None                                             |
 | [`throwOnErrorDefault`](#throwonerrordefault)                             | Default error behavior and return type for generated operations.       | `true`                                           |
 | [`validator`](#validator)                                                 | Validate request and response bodies with Zod.                         | `false`                                          |
-| [`comments`](#comments)                                                   | How much of each description reaches the JSDoc.                        | `'full'`                                         |
 | [`sdk`](#sdk)                                                             | Generate a class-based SDK instead of functions.                       | None                                             |
 | [`returnType`](#returntype)                                               | Shape of the value a generated call resolves to.                       | `'full'`                                         |
 | [`include`](https://kubb.dev/docs/5.x/reference/plugin-options#include)   | Keep only operations that match.                                       | None                                             |
@@ -90,32 +89,6 @@ export default defineConfig({
 })
 ```
 
-### comments
-
-Controls generated JSDoc.
-
-|          |                               |
-| -------- | ----------------------------- |
-| Type     | `'full' \| 'brief' \| 'none'` |
-| Required | `false`                       |
-| Default  | `'full'`                      |
-
-::field-group
-
-:::field{name="'full'"}
-Default value. Keeps complete descriptions and tags.
-:::
-
-:::field{name="'brief'"}
-Keeps the first sentence and other tags. Descriptions over 150 characters without a sentence ending are cut at the last word before 120.
-:::
-
-:::field{name="'none'"}
-Omits JSDoc but keeps the generated-by banner.
-:::
-
-::
-
 ### sdk
 
 Generates a class-based SDK. Each instance takes its own client config, so environments can use separate clients. Leave `sdk` unset to keep the standalone functions that query plugins call.

package/docs/overview.md

@@ -1,25 +1,29 @@
 # Fetch
 
-Generates a type-safe HTTP client based on the native Fetch API from your OpenAPI spec. Each operation becomes one async function with grouped `path`, `query`, `headers`, and `body` parameters and a result keyed by status code.
+The Fetch plugin turns each operation in your OpenAPI spec into a typed async function that sends the request with the native Fetch API. Each function takes grouped `path`, `query`, `headers`, and `body` parameters and returns a result keyed by status code.
 
-This plugin provides the client runtime. Query plugins such as `@kubb/plugin-react-query`, `@kubb/plugin-vue-query`, `@kubb/plugin-swr`, and `@kubb/plugin-mcp` call the functions it generates.
+The query plugins (`@kubb/plugin-react-query`, `@kubb/plugin-vue-query`, and `@kubb/plugin-swr`) and `@kubb/plugin-mcp` call these functions. The plugin also copies its runtime files (`client.ts`, `serializers.ts`, and `standardSchema.ts`) to `.kubb/` in the root output folder.
 
 ## Setup
 
-- Add `@kubb/plugin-ts` for the operation types. Without it, `@kubb/plugin-zod` with `inferred: true` supplies them.
-- Add `@kubb/plugin-zod` when you set `validator`.
-- No HTTP client package is needed.
+- Add `@kubb/plugin-ts` for the operation types, or `@kubb/plugin-zod` with `inferred: true`.
+- Add `@kubb/plugin-zod` when you set `validator`, and install `zod` v4. Without the plugin, `validator` does nothing.
+- No HTTP client package is needed. The generated code calls the global `fetch`.
 
 ## Options worth knowing
 
-- `baseURL` is prepended to every request.
-- `validator: 'zod'` validates request and response bodies with the schemas from `@kubb/plugin-zod`.
-- `sdk` generates a class-based SDK, grouped by tag or flat, instead of standalone functions. Query plugins need the standalone functions, so leave `sdk` unset when you use them.
-- `returnType: 'data'` makes a call resolve to the success body instead of the full result with status, data, and error.
-- `throwOnErrorDefault: false` returns documented error responses as values instead of throwing. A single call can still pass `throwOnError`.
+- `baseURL` is prepended to every request. The spec's `servers` URL is not used, so without `baseURL` you set one at runtime with `client.setConfig({ baseURL })`.
+- `validator: 'zod'` validates response bodies with the schemas from `@kubb/plugin-zod`. Use `{ request: 'zod', response: 'zod' }` to also validate request bodies.
+- `throwOnErrorDefault: false` returns non-2xx responses as values instead of throwing. A single call can still pass `throwOnError`.
+- `returnType: 'data'` makes a call resolve to the success body instead of the full result. With `throwOnError: false`, the call still returns the full result.
+- `sdk` generates a class-based SDK, grouped by tag or flat, instead of standalone functions. The query plugins and `@kubb/plugin-mcp` need the standalone functions, so leave `sdk` unset when you use them.
+
+See [Options](https://kubb.dev/extensions/kubb-labs/plugin-fetch/options) for every option and its default.
 
 ## Example
 
+The config below generates a Fetch client that sends every request to the Petstore API.
+
 ```typescript [kubb.config.ts]
 import { defineConfig } from 'kubb/config'
 import { pluginTs } from '@kubb/plugin-ts'
@@ -34,8 +38,3 @@ export default defineConfig({
   ],
 })
 ```
-
-## See also
-
-- [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)
-- [`@kubb/plugin-ts`](https://kubb.dev/extensions/kubb-labs/plugin-ts)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-fetch",
-  "version": "5.5.10",
+  "version": "5.5.11",
   "description": "Generate a slim, type-safe HTTP client with Kubb based on the native Fetch api.",
   "keywords": [
     "api-client",
@@ -68,8 +68,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/plugin-ts": "^5.0.9",
-    "@kubb/plugin-zod": "^5.4.7"
+    "@kubb/plugin-ts": "^5.0.10",
+    "@kubb/plugin-zod": "^5.4.8"
   },
   "devDependencies": {
     "@internals/client": "0.0.0",