@kubb/plugin-msw 5.0.11 → 5.0.13

package/dist/index.cjs

@@ -158,7 +158,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.0.11";
+var version = "5.0.13";
 //#endregion
 //#region src/generators/handlersGenerator.ts
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { Exclude, Group, Include, Output, OutputOptions, Override, PluginFactoryOptions, Resolver, ResolverPatch, ast } from "kubb/kit";
+import { Exclude, Group, Include, Output, OutputOptions, Override, PluginType, Resolver, ResolverPatch, ast } from "kubb/kit";
 //#region src/types.d.ts
 /**
  * Resolver for MSW that provides naming methods for handler functions.
@@ -78,7 +78,7 @@ type ResolvedOptions = {
   handlers: boolean;
   resolver: ResolverMsw;
 };
-type PluginMsw = PluginFactoryOptions<'plugin-msw', Options, ResolvedOptions, ResolverMsw>;
+type PluginMsw = PluginType<'plugin-msw', Options, ResolvedOptions, ResolverMsw>;
 declare global {
   namespace Kubb {
     interface PluginRegistry {

package/dist/index.js

@@ -154,7 +154,7 @@ var compatibility = {
 };
 //#endregion
 //#region package.json
-var version = "5.0.11";
+var version = "5.0.13";
 //#endregion
 //#region src/generators/handlersGenerator.ts
 /**

package/docs/options.md

@@ -62,7 +62,7 @@ Default value. Returns the data you pass to the handler, typed with the `@kubb/p
 :::
 
 :::field{name="'faker'"}
-Falls back to a value generated by `@kubb/plugin-faker` when `data` is missing or falsy, such as `0`, `false`, or `''`. Register `pluginFaker()` alongside this plugin.
+Falls back to a value generated by `@kubb/plugin-faker` when `data` is `undefined` or `null`. Other falsy values, such as `0`, `false`, or `''`, are sent as the response body. Register `pluginFaker()` alongside this plugin.
 :::
 
 ::
@@ -72,7 +72,7 @@ export function getPetHandler(data?: GetPetQueryResponse | ((info: Parameters<Pa
   return http.get('/pet/:petId', function handler(info) {
     if (typeof data === 'function') return data(info)
 
-    return new Response(JSON.stringify(data || createGetPetQueryResponse(data)), {
+    return new Response(JSON.stringify(data ?? createGetPetQueryResponse(data)), {
       status: 200,
       headers: { 'Content-Type': 'application/json' },
     })

package/docs/overview.md

@@ -1,14 +1,14 @@
 # MSW
 
-Generates typed MSW request handlers from your OpenAPI spec, one per operation. Use them to mock the API in tests and during local development.
+The MSW plugin generates a typed MSW request handler for each operation in your OpenAPI spec.
 
-Each handler returns the data you pass to it. With `parser: 'faker'`, it falls back to mock data from `@kubb/plugin-faker` when you pass none.
+Each handler returns the data you pass to it. With `parser: 'faker'`, a handler called without data returns mock data from `@kubb/plugin-faker`. Only operations with a success response schema get mock data.
 
 ## Setup
 
-- Add `@kubb/plugin-ts`.
-- Add `@kubb/plugin-faker` when you set `parser: 'faker'`. The default `data` parser does not need it.
-- Install MSW v2 or higher in the app that uses the generated code.
+- Add `@kubb/plugin-ts` for the request and response types.
+- Add `@kubb/plugin-faker` when you set `parser: 'faker'`, and install `@faker-js/faker` v10. The default `data` parser does not need it.
+- Install `msw` v2 in the app that uses the generated code.
 
 ## Options worth knowing
 
@@ -16,8 +16,12 @@ Each handler returns the data you pass to it. With `parser: 'faker'`, it falls b
 - `handlers` writes a `handlers.ts` file that exports every handler, ready to spread into `setupServer` or `setupWorker`.
 - `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.
+
 ## Example
 
+The config below generates one handler per operation and a `handlers.ts` file that exports them all.
+
 ```typescript [kubb.config.ts]
 import { defineConfig } from 'kubb/config'
 import { pluginTs } from '@kubb/plugin-ts'
@@ -32,9 +36,3 @@ export default defineConfig({
   ],
 })
 ```
-
-## See also
-
-- [MSW](https://mswjs.io/)
-- [@kubb/plugin-ts](https://kubb.dev/extensions/kubb-labs/plugin-ts)
-- [@kubb/plugin-faker](https://kubb.dev/extensions/kubb-labs/plugin-faker)

package/kubb-extension.json

@@ -17,7 +17,8 @@
       "github": "stijnvanhulle"
     }
   ],
-  "dependencies": ["plugin-ts", "plugin-faker"],
+  "dependencies": ["plugin-ts"],
+  "optionalDependencies": ["plugin-faker"],
   "compatibility": {
     "kubb": ">=5.8.3",
     "node": ">=22"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-msw",
-  "version": "5.0.11",
+  "version": "5.0.13",
   "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",
@@ -80,17 +80,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/plugin-faker": "^5.1.4",
-    "@kubb/plugin-ts": "^5.0.9"
+    "@kubb/plugin-faker": "^5.1.6",
+    "@kubb/plugin-ts": "^5.0.11"
   },
   "devDependencies": {
     "@internals/shared": "0.0.0",
     "@internals/utils": "0.0.0",
-    "kubb": "^5.8.3",
+    "kubb": "^5.9.2",
     "msw": "^2.15.0"
   },
   "peerDependencies": {
-    "kubb": "^5.8.3",
+    "kubb": "^5.9.2",
     "msw": "^2.0.0"
   },
   "peerDependenciesMeta": {