import { createServer, type Server } from "node:http"; import { afterEach, describe, expect, it, vi } from "vitest"; import type { McpRuntimeConfig } from "./config.js"; import type { McpReadinessReport } from "./readiness.js"; import { createMcpRequestHandler } from "./request-handler.js"; const config: McpRuntimeConfig = { nodeEnv: "test", revision: "request-handler-test-revision", listen: { host: "127.0.0.1", port: 0 }, apiKeys: { allowLegacyPlaintextFallback: false }, oauth: { resourceUrl: "https://mcp.example.invalid", authorizationServerUrl: "https://app.example.invalid", }, audit: {}, security: { allowedHosts: [], allowedOrigins: [] }, }; const servers: Server[] = []; afterEach(async () => { await Promise.all( servers.splice(0).map( (server) => new Promise((resolve, reject) => { server.close((error) => (error ? reject(error) : resolve())); }), ), ); }); describe("MCP request handler", () => { it("returns a redacted, non-cacheable 503 and logs an outage once", async () => { const warn = vi.fn(); const diagnostics = { database: "DATABASE_READINESS_FAILED", } as const; const report: McpReadinessReport = { ready: false, checks: { database: "error", redis: "ok" }, diagnostics, }; const handler = createMcpRequestHandler(config, { checkReadiness: vi.fn(async () => report), handleRequest: vi.fn(), logger: { warn, error: vi.fn() }, }); const baseUrl = await listen(handler); const first = await fetch(`${baseUrl}/readyz`); const second = await fetch(`${baseUrl}/readyz`); const body = await first.json(); expect(first.status).toBe(503); expect(first.headers.get("cache-control")).toBe("no-store"); expect(body).toEqual({ status: "not_ready", service: "mcp", revision: config.revision, checks: { database: "error", redis: "ok" }, error: { code: "dependency_unavailable", message: "A required dependency is unavailable.", }, }); expect(JSON.stringify(body)).not.toContain("DATABASE_READINESS_FAILED"); expect(second.status).toBe(503); await second.text(); expect(warn).toHaveBeenCalledTimes(1); }); }); async function listen( handler: ReturnType, ): Promise { const server = createServer(handler); servers.push(server); await new Promise((resolve, reject) => { server.once("error", reject); server.listen(0, "127.0.0.1", resolve); }); const address = server.address(); if (!address || typeof address === "string") { throw new Error("MCP request-handler test server did not expose a TCP port"); } return `http://127.0.0.1:${address.port}`; }