@kubb/plugin-msw 5.2.0 → 5.3.0-canary.20261023T192639

package/dist/index.cjs

@@ -155,7 +155,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.2.0";
+var version = "5.3.0-canary.20261023T192639";
 //#endregion
 //#region src/generators/handlersGenerator.ts
 /**

package/dist/index.js

@@ -151,7 +151,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.2.0";
+var version = "5.3.0-canary.20261023T192639";
 //#endregion
 //#region src/generators/handlersGenerator.ts
 /**

package/docs/guides/mock-api.md

@@ -83,3 +83,23 @@ export const worker = setupWorker(...handlers)
 ::
 
 Call `server.listen()` in your test setup, or `await worker.start()` in your browser entry.
+
+## Set the base URL at runtime
+
+The `baseURL` option is fixed when Kubb generates the handlers. When the host is only known at runtime, such as from your API client's config, call `createHandlers` with it:
+
+```typescript [test-server.ts]
+import { setupServer } from 'msw/node'
+import { createHandlers } from './src/gen/handlers/handlers'
+
+export const server = setupServer(...createHandlers({ baseURL: getBaseURL() }))
+```
+
+Each handler also takes `{ baseURL }` as its second argument, which overrides the configured one for that handler. Pass `undefined` as the first argument to keep the default response. This lets you mock two services that share a path:
+
+```typescript [test-server.ts]
+export const server = setupServer(
+  listPetsHandler(undefined, { baseURL: 'https://pets.example.com' }),
+  listPetsHandler(undefined, { baseURL: 'https://staging.example.com' }),
+)
+```

package/docs/options.md

@@ -21,7 +21,9 @@ Pass these options to `pluginMsw()`. Shared options link to [Shared plugin optio
 
 ### baseURL
 
-Base URL prepended to every handler's request. When omitted, no host is prepended and each handler matches the operation's relative path from the spec. Set it to point at a different environment than the spec.
+Base URL prepended to every handler's request. When omitted, no host is prepended and each handler matches the operation's relative path from the spec. Set it to point at a different environment than the spec. Leave off the trailing slash, because operation paths already start with `/`.
+
+A value with a template expression, such as `'${process.env.API_URL}'`, is evaluated when the handler is created. To set the base URL at runtime instead, pass `{ baseURL }` to a handler or to [`createHandlers`](#handlers).
 
 |          |          |
 | -------- | -------- |
@@ -30,7 +32,10 @@ Base URL prepended to every handler's request. When omitted, no host is prepende
 
 ### handlers
 
-Emits a `handlers.ts` file that re-exports every generated handler in operation order. Spread it into your MSW `setupServer(...handlers)` or `setupWorker(...handlers)` call.
+Emits a `handlers.ts` file with every generated handler in operation order. It exports two things:
+
+- `handlers`: the collection with the configured `baseURL`. Spread it into `setupServer(...handlers)` or `setupWorker(...handlers)`.
+- `createHandlers(options?)`: builds the same collection with a `baseURL` you pass at runtime.
 
 |          |           |
 | -------- | --------- |
@@ -42,7 +47,11 @@ Emits a `handlers.ts` file that re-exports every generated handler in operation
 import { getPetHandler } from './getPetHandler'
 import { addPetHandler } from './addPetHandler'
 
-export const handlers = [getPetHandler(), addPetHandler()] as const
+export function createHandlers(options?: { baseURL?: string }) {
+  return [getPetHandler(undefined, options), addPetHandler(undefined, options)] as const
+}
+
+export const handlers = createHandlers()
 ```
 
 ### parser

package/docs/overview.md

@@ -13,7 +13,7 @@ Each handler returns the data you pass to it. With `parser: 'faker'`, a handler
 ## Options worth knowing
 
 - `parser` sets where the response body comes from: `data` (default) or `faker`.
-- `handlers` writes a `handlers.ts` file that exports every handler, ready to spread into `setupServer` or `setupWorker`.
+- `handlers` writes a `handlers.ts` file that exports every handler, ready to spread into `setupServer` or `setupWorker`, plus `createHandlers({ baseURL })` to set the base URL at runtime.
 - `baseURL` is prepended to the path each handler matches.
 
 See [Options](https://kubb.dev/extensions/kubb-labs/plugin-msw/options) for every option and its default.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-msw",
-  "version": "5.2.0",
+  "version": "5.3.0-canary.20261023T192639",
   "description": "Generate Mock Service Worker (MSW) request handlers with Kubb. Intercept HTTP requests in the browser or Node.js for frontend development and testing.",
   "keywords": [
     "api-mocking",
@@ -85,12 +85,12 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/plugin-faker": "^5.1.10",
-    "@kubb/plugin-ts": "^5.0.15"
+    "@kubb/plugin-faker": "^5.2.0-canary.20261023T192638",
+    "@kubb/plugin-ts": "^5.1.0-canary.20261023T192638"
   },
   "devDependencies": {
-    "@internals/shared": "0.0.0",
-    "@internals/utils": "0.0.0",
+    "@internals/shared": "0.1.0-canary.20261023T192638",
+    "@internals/utils": "0.1.0-canary.20261023T192638",
     "@typescript/typescript6": "^6.0.2",
     "kubb": "^5.12.7",
     "msw": "^2.15.0"