swallowkit 1.0.0-beta.4 → 1.0.0-beta.40

package/src/__tests__/machine.test.ts

@@ -0,0 +1,356 @@
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { EventEmitter } from "events";
+import * as childProcess from "child_process";
+import { runMachineCli } from "../machine";
+
+jest.mock("child_process", () => {
+  const actual = jest.requireActual<typeof import("child_process")>("child_process");
+  return {
+    ...actual,
+    spawn: jest.fn(),
+    spawnSync: jest.fn(),
+  };
+});
+
+const repoRoot = process.cwd();
+
+function writeFile(filePath: string, content: string): void {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, content, "utf-8");
+}
+
+function createModelSource(name: string): string {
+  return `import { z } from 'zod/v4';
+
+export const ${name} = z.object({
+  id: z.string(),
+  name: z.string().min(1),
+  createdAt: z.string().optional(),
+  updatedAt: z.string().optional(),
+});
+
+export type ${name} = z.infer<typeof ${name}>;
+
+export const displayName = '${name}';
+`;
+}
+
+function createProjectFixture(rootDir: string, options: { includeGeneratedArtifacts?: boolean; forbiddenBffDependency?: boolean } = {}): void {
+  writeFile(path.join(rootDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
+  writeFile(
+    path.join(rootDir, "swallowkit.config.js"),
+    `module.exports = {
+  database: {
+    connectionString: 'AccountEndpoint=https://example.local;',
+  },
+  backend: {
+    language: 'typescript',
+  },
+  api: {
+    endpoint: '/api/_swallowkit',
+  },
+};
+`
+  );
+  writeFile(path.join(rootDir, "shared", "package.json"), JSON.stringify({ name: "@sample-app/shared" }, null, 2));
+  writeFile(path.join(rootDir, "shared", "index.ts"), "export {};\n");
+  writeFile(path.join(rootDir, "shared", "models", "todo.ts"), createModelSource("Todo"));
+  fs.mkdirSync(path.join(rootDir, "node_modules"), { recursive: true });
+  fs.symlinkSync(
+    path.join(repoRoot, "node_modules", "zod"),
+    path.join(rootDir, "node_modules", "zod"),
+    "junction"
+  );
+
+  if (options.includeGeneratedArtifacts) {
+    writeFile(path.join(rootDir, "lib", "api", "call-function.ts"), "export function callFunction() {}\n");
+    writeFile(path.join(rootDir, "functions", "src", "todo.ts"), "export {};\n");
+    writeFile(path.join(rootDir, "app", "api", "todo", "route.ts"), "export async function GET() { return Response.json([]); }\n");
+    writeFile(path.join(rootDir, "app", "api", "todo", "[id]", "route.ts"), "export async function GET() { return Response.json({}); }\n");
+  }
+
+  if (options.forbiddenBffDependency) {
+    writeFile(
+      path.join(rootDir, "app", "api", "forbidden", "route.ts"),
+      "import { CosmosClient } from '@azure/cosmos';\nexport async function GET() { return Response.json({ ok: Boolean(CosmosClient) }); }\n"
+    );
+  }
+}
+
+function createCSharpScaffoldFixture(rootDir: string): void {
+  writeFile(path.join(rootDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
+  writeFile(
+    path.join(rootDir, "swallowkit.config.js"),
+    `module.exports = {
+  backend: {
+    language: 'csharp',
+  },
+  api: {
+    endpoint: '/api/_swallowkit',
+  },
+};
+`
+  );
+  writeFile(path.join(rootDir, "shared", "package.json"), JSON.stringify({ name: "@sample-app/shared" }, null, 2));
+  writeFile(path.join(rootDir, "shared", "index.ts"), "export {};\n");
+  writeFile(path.join(rootDir, "shared", "models", "estimate.ts"), createModelSource("Estimate"));
+  writeFile(path.join(rootDir, "shared", "models", "member.ts"), createModelSource("Member"));
+  writeFile(path.join(rootDir, "shared", "models", "team.ts"), createModelSource("Team"));
+  fs.mkdirSync(path.join(rootDir, "node_modules"), { recursive: true });
+  fs.symlinkSync(
+    path.join(repoRoot, "node_modules", "zod"),
+    path.join(rootDir, "node_modules", "zod"),
+    "junction"
+  );
+
+  writeFile(
+    path.join(rootDir, "functions", "Crud", "EstimateFunctions.cs"),
+    "namespace SwallowKit.Functions;\npublic sealed class EstimateFunctions { public void Approve() {} public void Submit() {} public void Remand() {} }\n"
+  );
+  writeFile(path.join(rootDir, "functions", "generated", "csharp-models", "README.md"), "keep generated readme\n");
+  writeFile(path.join(rootDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.csproj"), "<Project />\n");
+  writeFile(path.join(rootDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.sln"), "solution\n");
+  writeFile(
+    path.join(rootDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Member.cs"),
+    "// existing member\n"
+  );
+  writeFile(
+    path.join(rootDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Team.cs"),
+    "// existing team\n"
+  );
+}
+
+function mockSuccessfulSpawn() {
+  const spawnMock = childProcess.spawn as unknown as any;
+  spawnMock.mockImplementation(() => {
+    const child = new EventEmitter() as childProcess.ChildProcess;
+    process.nextTick(() => child.emit("close", 0));
+    return child;
+  });
+  return spawnMock;
+}
+
+function createFreshInitProjectFixture(rootDir: string, backendLanguage: "csharp" | "python" = "csharp"): void {
+  writeFile(path.join(rootDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
+  writeFile(
+    path.join(rootDir, "swallowkit.config.js"),
+    `module.exports = {
+  backend: {
+    language: '${backendLanguage}',
+  },
+  functions: {
+    baseUrl: process.env.BACKEND_FUNCTIONS_BASE_URL || process.env.FUNCTIONS_BASE_URL || 'http://localhost:7071',
+  },
+  deployment: {
+    resourceGroup: process.env.AZURE_RESOURCE_GROUP || '',
+    swaName: process.env.AZURE_SWA_NAME || '',
+  },
+};
+`
+  );
+  writeFile(path.join(rootDir, "shared", "package.json"), JSON.stringify({ name: "@sample-app/shared" }, null, 2));
+  writeFile(path.join(rootDir, "shared", "index.ts"), "export {};\n");
+  fs.mkdirSync(path.join(rootDir, "shared", "models"), { recursive: true });
+  writeFile(path.join(rootDir, "app", "api", "greet", "route.ts"), "export async function GET() { return Response.json({}); }\n");
+  writeFile(path.join(rootDir, "lib", "api", "backend.ts"), "export const api = {};\n");
+  fs.mkdirSync(path.join(rootDir, "functions"), { recursive: true });
+}
+
+async function runMachine(argv: string[]): Promise<{ response: any; exitCode: number }> {
+  const writes: string[] = [];
+  const originalWrite = process.stdout.write.bind(process.stdout);
+  const originalExitCode = process.exitCode;
+
+  (process.stdout.write as unknown as (chunk: string | Uint8Array) => boolean) = ((chunk: string | Uint8Array) => {
+    writes.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString("utf-8"));
+    return true;
+  }) as typeof process.stdout.write;
+
+  process.exitCode = 0;
+
+  try {
+    await runMachineCli(argv);
+    return {
+      response: JSON.parse(writes.join("")),
+      exitCode: process.exitCode || 0,
+    };
+  } finally {
+    process.stdout.write = originalWrite;
+    process.exitCode = originalExitCode;
+  }
+}
+
+describe("machine CLI", () => {
+  const originalCwd = process.cwd();
+  let tempDir: string;
+
+  beforeEach(() => {
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "swallowkit-machine-"));
+    process.chdir(tempDir);
+  });
+
+  afterEach(() => {
+    process.chdir(originalCwd);
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it("inspects SwallowKit project metadata as JSON", async () => {
+    createProjectFixture(tempDir, { includeGeneratedArtifacts: true });
+
+    const { response, exitCode } = await runMachine(["node", "swallowkit", "machine", "inspect", "project"]);
+
+    expect(exitCode).toBe(0);
+    expect(response.ok).toBe(true);
+    expect(response.command).toBe("inspect-project");
+    expect(response.data.manifest.entities[0].name).toBe("Todo");
+    expect(response.data.manifest.routes).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          name: "Todo-bff-list",
+          publicPath: "/api/todo",
+          exists: true,
+        }),
+      ])
+    );
+  });
+
+  it("validates forbidden BFF dependencies", async () => {
+    createProjectFixture(tempDir, {
+      includeGeneratedArtifacts: true,
+      forbiddenBffDependency: true,
+    });
+
+    const { response, exitCode } = await runMachine(["node", "swallowkit", "machine", "validate", "project"]);
+
+    expect(exitCode).toBe(0);
+    expect(response.ok).toBe(true);
+    expect(response.command).toBe("validate-project");
+    expect(response.data.violations).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          code: "forbidden-bff-dependency",
+          severity: "error",
+        }),
+      ])
+    );
+  });
+
+  it("does not report false positives for a fresh C# init project", async () => {
+    createFreshInitProjectFixture(tempDir, "csharp");
+
+    const { response, exitCode } = await runMachine(["node", "swallowkit", "machine", "validate", "project"]);
+
+    expect(exitCode).toBe(0);
+    expect(response.ok).toBe(true);
+    expect(response.command).toBe("validate-project");
+    expect(response.data.manifest.backendLanguage).toBe("csharp");
+    expect(response.data.manifest.configValidation.valid).toBe(true);
+    expect(response.data.violations).toEqual([]);
+  });
+
+  it("generates model templates through the machine interface", async () => {
+    writeFile(path.join(tempDir, "package.json"), JSON.stringify({ name: "sample-app" }, null, 2));
+    writeFile(
+      path.join(tempDir, "swallowkit.config.js"),
+      `module.exports = {
+  backend: { language: 'typescript' },
+  api: { endpoint: '/api/_swallowkit' },
+};
+`
+    );
+    fs.mkdirSync(path.join(tempDir, "node_modules"), { recursive: true });
+    fs.symlinkSync(
+      path.join(repoRoot, "node_modules", "zod"),
+      path.join(tempDir, "node_modules", "zod"),
+      "junction"
+    );
+    writeFile(path.join(tempDir, "shared", "index.ts"), "export {};\n");
+
+    const { response, exitCode } = await runMachine([
+      "node",
+      "swallowkit",
+      "machine",
+      "generate",
+      "model",
+      "Task",
+      "--overwrite",
+      "never",
+    ]);
+
+    expect(exitCode).toBe(0);
+    expect(response.ok).toBe(true);
+    expect(response.command).toBe("generate-model");
+    expect(response.data.createdFiles).toContain("shared/models/task.ts");
+    expect(fs.existsSync(path.join(tempDir, ".swallowkit", "project.json"))).toBe(true);
+  });
+
+  it("generates scaffold artifacts through the machine interface", async () => {
+    createProjectFixture(tempDir);
+
+    const { response, exitCode } = await runMachine([
+      "node",
+      "swallowkit",
+      "machine",
+      "generate",
+      "scaffold",
+      "todo",
+      "--api-only",
+    ]);
+
+    expect(exitCode).toBe(0);
+    expect(response.ok).toBe(true);
+    expect(response.command).toBe("generate-scaffold");
+    expect(response.data.createdFiles).toEqual(
+      expect.arrayContaining([
+        "app/api/todo/route.ts",
+        "app/api/todo/[id]/route.ts",
+        "functions/src/todo.ts",
+        "lib/api/call-function.ts",
+      ])
+    );
+    expect(fs.existsSync(path.join(tempDir, ".swallowkit", "project.json"))).toBe(true);
+  });
+
+  it("preserves C# custom Functions and shared generated assets when api-only scaffolding one model", async () => {
+    createCSharpScaffoldFixture(tempDir);
+    const spawnSyncMock = childProcess.spawnSync as unknown as any;
+    spawnSyncMock.mockReturnValue({ status: 0 });
+    const spawnMock = mockSuccessfulSpawn();
+
+    try {
+      const { response, exitCode } = await runMachine([
+        "node",
+        "swallowkit",
+        "machine",
+        "generate",
+        "scaffold",
+        "estimate",
+        "--api-only",
+      ]);
+
+      expect(exitCode).toBe(0);
+      expect(response.ok).toBe(true);
+      expect(response.command).toBe("generate-scaffold");
+      expect(response.data.createdFiles).toEqual(
+        expect.arrayContaining([
+          "functions/Crud/EstimateCrudFunctions.cs",
+          "app/api/estimate/route.ts",
+          "app/api/estimate/[id]/route.ts",
+        ])
+      );
+      expect(response.data.deletedFiles).toEqual([]);
+      expect(fs.readFileSync(path.join(tempDir, "functions", "Crud", "EstimateFunctions.cs"), "utf-8")).toContain("Approve");
+      expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "README.md"))).toBe(true);
+      expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.csproj"))).toBe(true);
+      expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "SwallowKitBackendModels.sln"))).toBe(true);
+      expect(fs.readFileSync(path.join(tempDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Member.cs"), "utf-8")).toBe("// existing member\n");
+      expect(fs.readFileSync(path.join(tempDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Team.cs"), "utf-8")).toBe("// existing team\n");
+      expect(fs.existsSync(path.join(tempDir, "functions", "generated", "csharp-models", "src", "SwallowKitBackendModels", "Model", "Estimate.cs"))).toBe(true);
+    } finally {
+      spawnMock.mockReset();
+      spawnSyncMock.mockReset();
+    }
+  });
+});

package/src/__tests__/mcp.test.ts

@@ -0,0 +1,124 @@
+import { spawn } from "child_process";
+import * as fs from "fs";
+import * as path from "path";
+import { buildSwallowKitToolDefinitions } from "../mcp";
+
+type MachineCliRunner = NonNullable<Parameters<typeof buildSwallowKitToolDefinitions>[0]>;
+const builtMcpEntrypoint = path.resolve(__dirname, "..", "..", "dist", "mcp", "index.js");
+const itWhenBuiltEntrypointExists = fs.existsSync(builtMcpEntrypoint) ? it : it.skip;
+
+describe("SwallowKit MCP tool definitions", () => {
+  it("delegates inspect_project to the machine CLI", async () => {
+    const runner = jest.fn(async (_args: Parameters<MachineCliRunner>[0]) => ({
+      stdout: JSON.stringify({
+        ok: true,
+        command: "inspect-project",
+        data: { manifestSource: "file" },
+      }),
+      stderr: "",
+      exitCode: 0,
+    }));
+
+    const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find((candidate) => candidate.name === "swallowkit_inspect_project");
+    expect(tool).toBeDefined();
+
+    const result = await tool!.handler({});
+    expect(runner).toHaveBeenCalledWith(["inspect", "project"]);
+    expect(JSON.parse(result.content[0].text)).toEqual({ manifestSource: "file" });
+  });
+
+  it("delegates scaffold_model with explicit args", async () => {
+    const runner = jest.fn(async (_args: Parameters<MachineCliRunner>[0]) => ({
+      stdout: JSON.stringify({
+        ok: true,
+        command: "generate-scaffold",
+        data: { createdFiles: ["functions/src/todo.ts"] },
+      }),
+      stderr: "",
+      exitCode: 0,
+    }));
+
+    const tool = buildSwallowKitToolDefinitions(runner as MachineCliRunner).find((candidate) => candidate.name === "swallowkit_scaffold_model");
+    expect(tool).toBeDefined();
+
+    const result = await tool!.handler({
+      model: "todo",
+      functionsDir: "functions",
+      apiDir: "app/api",
+      apiOnly: true,
+    });
+
+    expect(runner).toHaveBeenCalledWith([
+      "generate",
+      "scaffold",
+      "todo",
+      "--functions-dir",
+      "functions",
+      "--api-dir",
+      "app/api",
+      "--api-only",
+    ]);
+    expect(JSON.parse(result.content[0].text)).toEqual({ createdFiles: ["functions/src/todo.ts"] });
+  });
+
+  itWhenBuiltEntrypointExists("keeps the built MCP entrypoint alive long enough to complete the handshake", async () => {
+    await new Promise<void>((resolve, reject) => {
+      const child = spawn(process.execPath, [builtMcpEntrypoint], {
+        cwd: path.resolve(__dirname, "..", ".."),
+        stdio: ["pipe", "pipe", "pipe"],
+      });
+      let settled = false;
+      let expectedShutdown = false;
+      let stderr = "";
+
+      const finishResolve = () => {
+        if (!settled) {
+          settled = true;
+          resolve();
+        }
+      };
+
+      const finishReject = (error: Error) => {
+        if (!settled) {
+          settled = true;
+          reject(error);
+        }
+      };
+
+      const timer = setTimeout(() => {
+        expectedShutdown = true;
+        child.kill();
+      }, 1000);
+
+      child.stderr.on("data", (chunk) => {
+        stderr += chunk.toString();
+      });
+
+      child.on("error", (error) => {
+        clearTimeout(timer);
+        finishReject(error);
+      });
+
+      child.on("close", (code, signal) => {
+        clearTimeout(timer);
+
+        if (expectedShutdown) {
+          finishResolve();
+          return;
+        }
+
+        finishReject(
+          new Error(
+            `Built MCP entrypoint exited early with code ${code ?? "null"} and signal ${signal ?? "null"}${stderr ? `: ${stderr}` : ""}`
+          )
+        );
+      });
+    });
+  });
+
+  itWhenBuiltEntrypointExists("preserves a runtime dynamic execa import in the built MCP entrypoint", () => {
+    const source = fs.readFileSync(builtMcpEntrypoint, "utf8");
+    expect(source).toContain('new Function("specifier", "return import(specifier);")');
+    expect(source).not.toContain('require("execa")');
+  });
+});

package/src/__tests__/model-parser.test.ts

@@ -0,0 +1,52 @@
+import * as fs from "fs";
+import * as path from "path";
+import { parseModelFile } from "../core/scaffold/model-parser";
+
+describe("parseModelFile", () => {
+  it("preserves array and enum metadata for schemas with defaults", async () => {
+    const tempDir = fs.mkdtempSync(path.join(process.cwd(), ".tmp-model-parser-"));
+    const modelPath = path.join(tempDir, "product.ts");
+
+    try {
+      fs.writeFileSync(
+        modelPath,
+        `import { z } from 'zod/v4';
+
+export const Product = z.object({
+  id: z.string(),
+  name: z.string().min(1),
+  price: z.number().min(0),
+  tags: z.array(z.string()).default([]),
+  status: z.enum(['draft', 'active', 'archived']).default('draft'),
+  createdAt: z.string().optional(),
+  updatedAt: z.string().optional(),
+});
+
+export type Product = z.infer<typeof Product>;
+`,
+        "utf-8"
+      );
+
+      const model = await parseModelFile(modelPath);
+      expect(model.fields).toEqual(
+        expect.arrayContaining([
+          expect.objectContaining({
+            name: "tags",
+            type: "string",
+            isArray: true,
+            isOptional: true,
+          }),
+          expect.objectContaining({
+            name: "status",
+            type: "string",
+            isArray: false,
+            isOptional: true,
+            enumValues: ["draft", "active", "archived"],
+          }),
+        ])
+      );
+    } finally {
+      fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+  });
+});

package/src/__tests__/nextjs-generator.test.ts

@@ -0,0 +1,97 @@
+import {
+  generateBFFCallFunction,
+  generateCompactBFFRoutes,
+} from "../core/scaffold/nextjs-generator";
+import { createBasicModelInfo } from "./fixtures";
+
+describe("generateBFFCallFunction", () => {
+  it("generates call function helper code", () => {
+    const code = generateBFFCallFunction();
+    expect(code).toMatchSnapshot();
+  });
+
+  it("includes getFunctionsBaseUrl helper", () => {
+    const code = generateBFFCallFunction();
+    expect(code).toContain("getFunctionsBaseUrl");
+    expect(code).toContain("BACKEND_FUNCTIONS_BASE_URL");
+  });
+
+  it("includes callFunction export", () => {
+    const code = generateBFFCallFunction();
+    expect(code).toContain("export async function callFunction");
+  });
+
+  it("includes z.ZodSchema typings", () => {
+    const code = generateBFFCallFunction();
+    expect(code).toContain("z.ZodSchema");
+  });
+});
+
+describe("generateCompactBFFRoutes", () => {
+  it("generates list and detail routes", () => {
+    const model = createBasicModelInfo();
+    const routes = generateCompactBFFRoutes(model, "@myapp/shared");
+
+    expect(routes.listRoute).toMatchSnapshot();
+    expect(routes.detailRoute).toMatchSnapshot();
+  });
+
+  it("imports the correct schema", () => {
+    const model = createBasicModelInfo();
+    const routes = generateCompactBFFRoutes(model, "@myapp/shared");
+
+    expect(routes.listRoute).toContain(
+      "import { todoSchema } from '@myapp/shared'"
+    );
+    expect(routes.detailRoute).toContain(
+      "import { todoSchema } from '@myapp/shared'"
+    );
+  });
+
+  it("uses correct API paths (camelCase)", () => {
+    const model = createBasicModelInfo();
+    const routes = generateCompactBFFRoutes(model, "@myapp/shared");
+
+    expect(routes.listRoute).toContain("path: '/api/todo'");
+    expect(routes.detailRoute).toContain("/api/todo/");
+  });
+
+  it("list route has GET and POST handlers", () => {
+    const model = createBasicModelInfo();
+    const routes = generateCompactBFFRoutes(model, "@myapp/shared");
+
+    expect(routes.listRoute).toContain("export async function GET()");
+    expect(routes.listRoute).toContain("export async function POST(");
+  });
+
+  it("detail route has GET, PUT, and DELETE handlers", () => {
+    const model = createBasicModelInfo();
+    const routes = generateCompactBFFRoutes(model, "@myapp/shared");
+
+    expect(routes.detailRoute).toContain("export async function GET(");
+    expect(routes.detailRoute).toContain("export async function PUT(");
+    expect(routes.detailRoute).toContain("export async function DELETE(");
+  });
+
+  it("creates InputSchema that omits managed fields", () => {
+    const model = createBasicModelInfo();
+    const routes = generateCompactBFFRoutes(model, "@myapp/shared");
+
+    expect(routes.listRoute).toContain(
+      "todoSchema.omit({ id: true, createdAt: true, updatedAt: true })"
+    );
+  });
+
+  it("handles multi-word model names", () => {
+    const model = createBasicModelInfo({
+      name: "BlogPost",
+      schemaName: "blogPostSchema",
+    });
+    const routes = generateCompactBFFRoutes(model, "@myapp/shared");
+
+    expect(routes.listRoute).toContain("path: '/api/blogPost'");
+    expect(routes.listRoute).toContain(
+      "import { blogPostSchema } from '@myapp/shared'"
+    );
+  });
+});

package/src/__tests__/openapi-generator.test.ts

@@ -0,0 +1,43 @@
+import { generateOpenApiDocument } from "../core/scaffold/openapi-generator";
+import { createBasicModelInfo } from "./fixtures";
+
+describe("generateOpenApiDocument", () => {
+  it("emits an OpenAPI document for the root model", () => {
+    const model = createBasicModelInfo();
+    const document = JSON.parse(generateOpenApiDocument([model], model));
+
+    expect(document.openapi).toBe("3.0.3");
+    expect(document.components.schemas.Todo.properties.title.type).toBe("string");
+    expect(document.paths["/api/todo"].post.requestBody.content["application/json"].schema.$ref)
+      .toBe("#/components/schemas/Todo");
+  });
+
+  it("emits nested schema references when present", () => {
+    const todo = createBasicModelInfo({
+      fields: [
+        { name: "id", type: "string", isOptional: false, isArray: false },
+        { name: "title", type: "string", isOptional: false, isArray: false },
+        {
+          name: "category",
+          type: "object",
+          isOptional: false,
+          isArray: false,
+          isNestedSchema: true,
+          nestedModelName: "Category",
+        },
+      ],
+    });
+    const category = createBasicModelInfo({
+      name: "Category",
+      schemaName: "categorySchema",
+      fields: [
+        { name: "id", type: "string", isOptional: false, isArray: false },
+        { name: "name", type: "string", isOptional: false, isArray: false },
+      ],
+    });
+
+    const document = JSON.parse(generateOpenApiDocument([todo, category], todo));
+    expect(document.components.schemas.Todo.properties.category.$ref).toBe("#/components/schemas/Category");
+    expect(document.components.schemas.Category.properties.name.type).toBe("string");
+  });
+});