test(typegen): add mock infrastructure for unit tests (#103)

## Summary
- Create layout metadata fixtures (`tests/fixtures/layout-metadata.ts`)
- Add mock fetch utility for mocking FM Data API calls (`tests/utils/mock-fetch.ts`)
- Move E2E tests requiring live FM server to `tests/e2e/`
- Create unit tests that use mocked metadata (11 tests)
- Update `vitest.config.ts` to exclude e2e tests by default
- Add `test:e2e` script for running E2E tests with doppler

## Test plan
- [x] `pnpm --filter @proofkit/typegen lint` passes
- [x] `pnpm --filter @proofkit/typegen typecheck` passes
- [x] `pnpm --filter @proofkit/typegen test` passes (11 unit tests)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Modernizes testing and docs across packages, separating fast unit tests from live E2E runs and adding reusable CLI/docs components.
> 
> - Testing: Add mock fetch utilities and recorded fixtures for `@proofkit/better-auth` and `@proofkit/fmdapi`; create layout metadata fixtures and unit tests in `@proofkit/typegen`; move live tests to `tests/e2e`; update `vitest.config.ts` to exclude E2E by default; add `test:e2e` scripts and Turbo pipeline
> - CI: Simplify `continuous-release.yml` test job to run unit tests only (remove Doppler/OIDC/E2E); keep build after tests
> - Tooling: Add `scripts/capture-responses.ts` to record FM API responses for mocks; add `vitest.config.ts` per package with E2E exclusion
> - Docs/UI: Introduce `PackageInstall` component and enhance `CliCommand` (new `packageName` prop); update MDX guides to use these components and stable package refs
> 
> <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 3e25bc9. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: eluce2

packages/typegen/package.json

@@ -8,8 +8,9 @@
     "dev": "pnpm build:watch",
     "dev:ui": "concurrently -n \"web,api\" -c \"cyan,magenta\" \"pnpm -C web dev\" \"pnpm run dev:api\"",
     "dev:api": "concurrently -n \"build,server\" -c \"cyan,magenta\" \"pnpm build:watch\" \"nodemon --watch dist/esm --delay 1 --exec 'node dist/esm/cli.js ui --port 3141 --no-open'\"",
-    "test": "doppler run -- vitest run",
+    "test": "vitest run",
     "test:watch": "vitest --watch",
+    "test:e2e": "doppler run -- vitest run tests/e2e",
     "typecheck": "tsc --noEmit",
     "build": "pnpm -C web build && pnpm vite build && node scripts/build-copy.js && publint --strict",
     "build:watch": "vite build --watch",

…/fmodata-preserve-customizations.test.ts …/fmodata-preserve-customizations.test.tspackages/typegen/tests/fmodata-preserve-customizations.test.ts renamed to packages/typegen/tests/e2e/fmodata-preserve-customizations.test.ts packages/typegen/tests/fmodata-preserve-customizations.test.ts renamed to packages/typegen/tests/e2e/fmodata-preserve-customizations.test.ts

@@ -2,8 +2,8 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { describe, expect, it } from "vitest";
-import { generateODataTypes } from "../src/fmodata/generateODataTypes";
-import type { ParsedMetadata } from "../src/fmodata/parseMetadata";
+import { generateODataTypes } from "../../src/fmodata/generateODataTypes";
+import type { ParsedMetadata } from "../../src/fmodata/parseMetadata";
 
 function makeMetadata({
   entitySetName,

…es/typegen/tests/fmodata-typegen.test.ts …ypegen/tests/e2e/fmodata-typegen.test.tspackages/typegen/tests/fmodata-typegen.test.ts renamed to packages/typegen/tests/e2e/fmodata-typegen.test.ts packages/typegen/tests/fmodata-typegen.test.ts renamed to packages/typegen/tests/e2e/fmodata-typegen.test.ts

@@ -2,11 +2,11 @@ import { execSync } from "node:child_process";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { generateODataTypes, parseMetadataFromFile } from "../src/fmodata";
-import type { FmodataConfig } from "../src/types";
+import { generateODataTypes, parseMetadataFromFile } from "../../src/fmodata";
+import type { FmodataConfig } from "../../src/types";
 
 // Helper to read fixture files
-const fixturesDir = path.resolve(__dirname, "fixtures");
+const fixturesDir = path.resolve(__dirname, "../fixtures");
 const outputDir = path.resolve(__dirname, "fmodata-output");
 
 /**
@@ -438,7 +438,7 @@ describe("fmodata typegen - snapshot tests", () => {
     await generateODataTypes(metadata, config);
 
     const content = await fs.readFile(path.join(outputDir, "Customers.ts"), "utf-8");
-    await expect(content).toMatchFileSnapshot(path.join(__dirname, "__snapshots__", "fmodata-customers.snap.ts"));
+    await expect(content).toMatchFileSnapshot(path.join(__dirname, "../__snapshots__", "fmodata-customers.snap.ts"));
   });
 
   it("generates expected Orders table output", async () => {
@@ -455,7 +455,7 @@ describe("fmodata typegen - snapshot tests", () => {
     await generateODataTypes(metadata, config);
 
     const content = await fs.readFile(path.join(outputDir, "Orders.ts"), "utf-8");
-    await expect(content).toMatchFileSnapshot(path.join(__dirname, "__snapshots__", "fmodata-orders.snap.ts"));
+    await expect(content).toMatchFileSnapshot(path.join(__dirname, "../__snapshots__", "fmodata-orders.snap.ts"));
   });
 
   it("generates expected index file output", async () => {
@@ -472,7 +472,7 @@ describe("fmodata typegen - snapshot tests", () => {
     await generateODataTypes(metadata, config);
 
     const content = await fs.readFile(path.join(outputDir, "index.ts"), "utf-8");
-    await expect(content).toMatchFileSnapshot(path.join(__dirname, "__snapshots__", "fmodata-index.snap.ts"));
+    await expect(content).toMatchFileSnapshot(path.join(__dirname, "../__snapshots__", "fmodata-index.snap.ts"));
   });
 
   it("generates expected output with all typeOverride transformations", async () => {
@@ -502,6 +502,8 @@ describe("fmodata typegen - snapshot tests", () => {
     await generateODataTypes(metadata, config);
 
     const content = await fs.readFile(path.join(outputDir, "Customers.ts"), "utf-8");
-    await expect(content).toMatchFileSnapshot(path.join(__dirname, "__snapshots__", "fmodata-type-overrides.snap.ts"));
+    await expect(content).toMatchFileSnapshot(
+      path.join(__dirname, "../__snapshots__", "fmodata-type-overrides.snap.ts"),
+    );
   });
 });