@kubb/plugin-axios 5.7.0-canary.20261016T084648 → 5.7.0

package/dist/index.cjs

@@ -1430,7 +1430,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.7.0-canary.20261016T084648";
+var version = "5.7.0";
 //#endregion
 //#region src/templates.ts
 /** Absolute path to the axios client template, copied into `.kubb/client.ts`. */

package/dist/index.js

@@ -1404,7 +1404,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.7.0-canary.20261016T084648";
+var version = "5.7.0";
 //#endregion
 //#region src/templates.ts
 /** Absolute path to the axios client template, copied into `.kubb/client.ts`. */

package/dist/templates/axios.d.ts

@@ -339,9 +339,15 @@ export declare function resolveAuth(params: {
   query: Record<string, unknown>;
 }): Promise<void>;
 /**
- * Builds the shared client core bound to an axios instance (defaulting to `axios.create()`), with `throwOnError` riding axios's `validateStatus`.
+ * Builds the shared client core bound to an axios instance (defaulting to `defaultTransport`, else `axios.create()`), with `throwOnError` riding axios's `validateStatus`.
  */
-export declare function createClientCore<TRequest = AxiosRequestConfig, TResponse = AxiosResponse>(options?: ClientConfig): ClientInstance<TRequest, TResponse>;
+export declare function createClientCore<TRequest = AxiosRequestConfig, TResponse = AxiosResponse>(options?: {
+  defaultTransport?: AxiosInstance;
+} & ClientConfig): ClientInstance<TRequest, TResponse>;
+/**
+ * The axios instance the generated `client` sends through. Register axios interceptors on it or reuse it inside your own transport.
+ */
+export declare const defaultTransport: AxiosInstance;
 /**
  * One decoded Server-Sent Event, with `data` parsed as JSON when valid and kept as the raw string otherwise.
  */

package/docs/guides/transport.md

@@ -2,7 +2,7 @@
 
 Set a transport at runtime to replace the network send. The client still builds URLs, serializes parameters, resolves authentication, and handles results.
 
-The transport is an `AxiosInstance`. The default is `axios.create()`, and you can replace it with your own pre-configured instance. Use interceptors for request headers or response logging.
+The transport is an `AxiosInstance`. The default is `defaultTransport`, an `axios.create()` instance exported from the generated client, and you can replace it with your own pre-configured instance. Use interceptors for request headers or response logging.
 
 ```typescript
 type ClientConfig = {
@@ -39,6 +39,22 @@ Every generated function now sends through your instance, so its timeout, header
 > [!NOTE]
 > Kubb sets `transformRequest`, `paramsSerializer`, and `validateStatus` on each request for its own serialization and `throwOnError` handling, so leave those fields alone. Set timeouts, retries, and interceptors on the instance. For one call, pass `options`, such as `{ timeout }` or `{ onUploadProgress }`, instead of building a new instance.
 
+## Use the default instance
+
+The generated client exports `defaultTransport`, the instance it sends through when no transport is set. Configure it directly to add tracing or headers without replacing the transport:
+
+```typescript
+import { defaultTransport } from './gen/.kubb/client'
+
+defaultTransport.defaults.timeout = 10_000
+defaultTransport.interceptors.request.use((config) => {
+  config.headers.set('traceparent', currentTraceparent())
+  return config
+})
+```
+
+Instances from `createClient()` get their own `axios.create()` and do not share these settings.
+
 ## Where to set it
 
 Use `client.setConfig({ transport })` for shared configuration, `createClient({ transport })` for an isolated instance, or pass `transport` on an operation to override it for one call.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-axios",
-  "version": "5.7.0-canary.20261016T084648",
+  "version": "5.7.0",
   "description": "Generate a slim, type-safe HTTP client with Kubb based on axios.",
   "keywords": [
     "api-client",
@@ -80,12 +80,12 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/plugin-ts": "^5.1.0-canary.20261016T084648",
-    "@kubb/plugin-zod": "^5.5.0-canary.20261016T084648"
+    "@kubb/plugin-ts": "^5.0.14",
+    "@kubb/plugin-zod": "^5.4.12"
   },
   "devDependencies": {
-    "@internals/client": "0.1.0-canary.20261016T084648",
-    "@internals/shared": "0.1.0-canary.20261016T084648",
+    "@internals/client": "0.0.0",
+    "@internals/shared": "0.0.0",
     "axios": "^1.20.0",
     "kubb": "^5.10.3",
     "typescript": "^6.0.3"

package/templates/axios.ts

@@ -723,11 +723,14 @@ async function settleResponse<TRequest, TResponse>({
 }
 
 /**
- * Builds the shared client core bound to an axios instance (defaulting to `axios.create()`), with `throwOnError` riding axios's `validateStatus`.
- */
-export function createClientCore<TRequest = AxiosRequestConfig, TResponse = AxiosResponse>(options: ClientConfig = {}): ClientInstance<TRequest, TResponse> {
-  let config: ClientConfig = { ...options }
-  const baseInstance = config.transport ?? axios.create()
+ * Builds the shared client core bound to an axios instance (defaulting to `defaultTransport`, else `axios.create()`), with `throwOnError` riding axios's `validateStatus`.
+ */
+export function createClientCore<TRequest = AxiosRequestConfig, TResponse = AxiosResponse>(
+  options: { defaultTransport?: AxiosInstance } & ClientConfig = {},
+): ClientInstance<TRequest, TResponse> {
+  const { defaultTransport, ...initialConfig } = options
+  let config: ClientConfig = initialConfig
+  const baseInstance = config.transport ?? defaultTransport ?? axios.create()
   let instance = baseInstance
   const requestContexts = new Map<number, RequestConfig<unknown, TRequest, TResponse>>()
   let requestContextId = 0
@@ -861,6 +864,11 @@ export function createClientCore<TRequest = AxiosRequestConfig, TResponse = Axio
   return client
 }
 
+/**
+ * The axios instance the generated `client` sends through. Register axios interceptors on it or reuse it inside your own transport.
+ */
+export const defaultTransport = axios.create()
+
 /**
  * One decoded Server-Sent Event, with `data` parsed as JSON when valid and kept as the raw string otherwise.
  */
@@ -963,6 +971,6 @@ export async function toEventStream<TData = unknown>(result: Promise<{ data: unk
   }
 }
 
-export const client = createClientCore()
+export const client = createClientCore({ defaultTransport })
 
 export const createClient = (config?: Parameters<typeof client.createClient>[0]) => client.createClient(config)