test: add auto mocker

Author: kantord

__tests__/auto-mocker-smoke.test.ts

@@ -0,0 +1,19 @@
+import fs from "fs";
+import path from "path";
+import { expect, test } from "vitest";
+
+const FIXTURE_FILE = path.join(
+  process.cwd(),
+  "src/mocks/fixtures/registry_info/get.ts",
+);
+
+test("auto-mocker generates fixture and serves JSON", async () => {
+  // Call an endpoint present in swagger.json
+  const res = await fetch("http://localhost/api/v0/registry/info");
+  expect(res.ok).toBe(true);
+  const data = await res.json();
+  expect(typeof data).toBe("object");
+
+  // Fixture file should exist after first call
+  expect(fs.existsSync(FIXTURE_FILE)).toBe(true);
+});

__tests__/msw-example.test.ts

@@ -1,16 +1,15 @@
 import { HttpResponse, http } from "msw";
-import { setupServer } from "msw/node";
-import { afterAll, afterEach, beforeAll, expect, test } from "vitest";
+import { beforeEach, expect, test } from "vitest";
+import { server } from "@/mocks/node";
 
-const server = setupServer(
-  http.get("https://api.example.com/greet", () =>
-    HttpResponse.json({ message: "hello from msw" }),
-  ),
-);
-
-beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
-afterEach(() => server.resetHandlers());
-afterAll(() => server.close());
+beforeEach(() => {
+  server.resetHandlers();
+  server.use(
+    http.get("https://api.example.com/greet", () =>
+      HttpResponse.json({ message: "hello from msw" }),
+    ),
+  );
+});
 
 test("fetches mocked data from MSW handler", async () => {
   const res = await fetch("https://api.example.com/greet");

docs/mocks.md

@@ -0,0 +1,17 @@
+MSW Auto‑Mocker
+
+- Handlers: `src/mocks/handlers.ts` combines custom and auto‑generated.
+- Custom: add overrides in `src/mocks/customHandlers/index.ts`.
+- Auto‑gen: `src/mocks/mocker.ts` reads `swagger.json` and creates fixtures in `src/mocks/fixtures` on first run.
+- Validation: Loaded fixtures are validated with Ajv; errors log to console.
+
+Usage
+- Vitest: already wired via `src/mocks/test.setup.ts`. Run `pnpm test`.
+- Browser dev (optional): import and call `startWorker()` from `src/mocks/browser.ts` in your app's dev entry.
+
+Regeneration
+- Delete a fixture file or run with `AUTO_MOCKER_FORCE=1` to re-generate.
+
+Types (optional)
+- If you expose OpenAPI response types under `@api/types.gen`, set `USE_TYPES_FOR_FIXTURES = true` in `src/mocks/mocker.ts` to add a `satisfies` clause in generated fixtures.
+

package.json

@@ -22,6 +22,8 @@
     "better-auth": "1.4.0-beta.21",
     "class-variance-authority": "0.7.1",
     "clsx": "2.1.1",
+    "ajv": "^8.17.1",
+    "json-schema-faker": "^0.5.6",
     "msw": "^2.12.2",
     "next": "16.0.3",
     "react": "19.2.0",

pnpm-lock.yaml

@@ -0,0 +1,9 @@
+import type { RestHandler } from "msw";
+import { setupWorker } from "msw/browser";
+import { handlers } from "./handlers";
+
+export const worker = setupWorker(...(handlers as RestHandler[]));
+
+export async function startWorker() {
+  await worker.start({ onUnhandledRequest: "bypass" });
+}