.

Author: kantord

docs/mocks.md

@@ -1,7 +1,7 @@
 MSW Auto-Mocker
 
 - Handlers: `src/mocks/handlers.ts` combines non-schema mocks and auto-generated mocks.
-- Non-schema mocks: add hand-written handlers in `src/mocks/customHandlers/index.ts`. These run before auto-generated handlers so they can replace or extend behavior when needed.
+- Non-schema mocks: add hand-written handlers in `src/mocks/customHandlers/index.ts`. These take precedence over schema-based mocks.
 - Auto-generated: `src/mocks/mocker.ts` reads `swagger.json` and creates fixtures under `src/mocks/fixtures` on first run.
 - Validation: Loaded fixtures are validated with Ajv; errors log to console.
 

src/mocks/customHandlers/index.ts

@@ -1,8 +1,7 @@
 import type { RequestHandler } from "msw";
 
 // Add non-schema, hand-written mocks here.
-// These are composed before the auto-generated handlers (handlers.ts),
-// so they can replace or extend behavior where needed.
+// These take precedence over the schema-based mocks.
 export const customHandlers: RequestHandler[] = [
   // Example override: customize one endpoint's payload
   // http.get("*/registry/v0.1/servers", () =>

src/mocks/fixtures/README.md

@@ -5,7 +5,7 @@ Fixtures are auto-generated on first run by the MSW Auto-Mocker.
 - You can edit these files to tailor responses for tests or local dev.
 
 Notes
-- Non-schema mocks in `src/mocks/customHandlers` run before auto-generated ones.
+- Non-schema mocks in `src/mocks/customHandlers` take precedence over schema-based mocks.
 - To re-generate a fixture, delete the file; it will be recreated on next request.
 - If your project exposes OpenAPI response types via `@api/types.gen`, you can
   enable type enforcement by setting `USE_TYPES_FOR_FIXTURES = true` in