import { describe, expect, it } from "@effect/vitest"; import { Effect, Option } from "effect"; import { extract } from "./extract"; import { parse } from "./parse"; describe("OpenAPI extract response bodies", () => { it.effect("extracts success responses declared with the wildcard 2XX status key", () => Effect.gen(function* () { // OpenAPI allows wildcard status keys like `2XX`; Microsoft Graph // declares every success response this way (no numeric 200/201 keys at // all), so the extractor must treat them as success responses. const doc = yield* parse( JSON.stringify({ openapi: "3.0.3", info: { title: "Wildcard", version: "1.0.0" }, servers: [{ url: "https://api.example.com" }], paths: { "/files/{id}": { get: { operationId: "downloadFile", parameters: [ { name: "id", in: "path", required: true, schema: { type: "string" } }, ], responses: { "2XX": { description: "File contents", content: { "application/octet-stream": { schema: { type: "string", format: "binary" }, }, }, }, "4XX": { description: "error" }, }, }, }, }, }), ); const result = yield* extract(doc); const operation = result.operations.find((op) => op.operationId === "downloadFile"); expect(operation).toBeDefined(); const responseBody = Option.getOrUndefined(operation!.responseBody); expect(responseBody).toBeDefined(); expect(responseBody!.contentType).toBe("application/octet-stream"); expect(Option.getOrUndefined(responseBody!.fileHint)?.kind).toBe("binaryResponse"); }), ); it.effect("prefers exact 2xx status codes over the 2XX wildcard", () => Effect.gen(function* () { const doc = yield* parse( JSON.stringify({ openapi: "3.0.3", info: { title: "Wildcard", version: "1.0.0" }, servers: [{ url: "https://api.example.com" }], paths: { "/things": { get: { operationId: "listThings", responses: { "2XX": { description: "Generic success", content: { "text/plain": { schema: { type: "string" } }, }, }, "200": { description: "Listed", content: { "application/json": { schema: { type: "object" } }, }, }, }, }, }, }, }), ); const result = yield* extract(doc); const operation = result.operations.find((op) => op.operationId === "listThings"); const responseBody = Option.getOrUndefined(operation!.responseBody); expect(responseBody?.contentType).toBe("application/json"); }), ); it.effect("wraps NDJSON response schemas in an array (the shape invoke returns)", () => Effect.gen(function* () { // NDJSON endpoints (e.g. Vercel's runtime-logs) declare the schema of // ONE line under application/stream+json; the invoke path returns an // array of parsed lines, so the advertised output schema must be that // array, not the per-line object. const lineSchema = { type: "object", properties: { level: { type: "string" }, message: { type: "string" } }, }; const doc = yield* parse( JSON.stringify({ openapi: "3.0.3", info: { title: "Logs", version: "1.0.0" }, servers: [{ url: "https://api.example.com" }], paths: { "/logs": { get: { operationId: "getRuntimeLogs", responses: { "200": { description: "Log lines", content: { "application/stream+json": { schema: lineSchema } }, }, }, }, }, }, }), ); const result = yield* extract(doc); const operation = result.operations.find((op) => op.operationId === "getRuntimeLogs"); const outputSchema = Option.getOrUndefined(operation!.outputSchema) as Record< string, unknown >; expect(outputSchema.type).toBe("array"); expect(outputSchema.items).toEqual(lineSchema); // The caveats (truncation, raw-text fallback) ride the description into // the compiled TypeScript preview. expect(outputSchema.description).toContain("NDJSON"); // The binding keeps the RAW per-line schema: invoke decodes the body // per line, and the serve path re-derives the array wrap from the // content type. const responseBody = Option.getOrUndefined(operation!.responseBody); expect(responseBody?.contentType).toBe("application/stream+json"); expect(Option.getOrUndefined(responseBody!.schema)).toEqual(lineSchema); }), ); it.effect("leaves plain JSON response schemas unwrapped", () => Effect.gen(function* () { const doc = yield* parse( JSON.stringify({ openapi: "3.0.3", info: { title: "Plain", version: "1.0.0" }, servers: [{ url: "https://api.example.com" }], paths: { "/thing": { get: { operationId: "getThing", responses: { "200": { description: "One thing", content: { "application/json": { schema: { type: "object", properties: { id: { type: "string" } } }, }, }, }, }, }, }, }, }), ); const result = yield* extract(doc); const operation = result.operations.find((op) => op.operationId === "getThing"); const outputSchema = Option.getOrUndefined(operation!.outputSchema) as Record< string, unknown >; expect(outputSchema.type).toBe("object"); }), ); });