import { describe, expect, it } from "vitest"; import { parseApiDocument, validateOpenApi } from "../../src/core/parse"; import { createWorkspace, generateSchemaSample, resolveLocalReference, } from "../../src/core/refs"; describe("OpenAPI parsing and local references", () => { it("parses JSON and YAML and performs focused validation", () => { const json = parseApiDocument( '{"openapi":"3.0.3","info":{"title":"A","version":"1"},"paths":{}}', "api.json", ); const yaml = parseApiDocument( "openapi: 3.1.0\ninfo: { title: A, version: '1' }\npaths: {}\n", "api.yaml", ); expect(json.format).toBe("json"); expect(yaml.format).toBe("yaml"); expect(validateOpenApi(yaml).some((item) => item.level === "error")).toBe( false, ); }); it("rejects dangerous YAML keys and alias expansion", () => { expect(() => parseApiDocument("__proto__: { polluted: true }", "bad.yaml"), ).toThrow(/prohibited key/iu); const aliases = `x: &x [1, 2]\ny: [${Array.from({ length: 60 }, () => "*x").join(",")}]`; expect(() => parseApiDocument(aliases, "aliases.yaml")).toThrow(/alias/iu); }); it("resolves supplied relative files and refuses remote references", () => { const entry = parseApiDocument( "openapi: 3.1.0\ninfo: {title: A, version: '1'}\npaths: {}\ncomponents: { schemas: { Pet: { $ref: 'schemas.yaml#/Pet' } } }", "openapi.yaml", ); const schemas = parseApiDocument( "Pet: { type: object, properties: { name: { type: string } } }", "schemas.yaml", ); const workspace = createWorkspace(entry, [schemas]); expect( resolveLocalReference(workspace, "schemas.yaml#/Pet").value, ).toMatchObject({ type: "object" }); expect(() => resolveLocalReference(workspace, "https://example.test/schema.json"), ).toThrow(/disabled/iu); expect( validateOpenApi( parseApiDocument( "openapi: 3.1.0\ninfo: {title: A, version: '1'}\npaths: {}\nx: {$ref: 'https://bad.test/x'}", ), ), ).toContainEqual(expect.objectContaining({ level: "error" })); }); it("generates bounded samples and reports reference cycles", () => { const entry = parseApiDocument( '{"openapi":"3.1.0","info":{"title":"A","version":"1"},"paths":{},"components":{"schemas":{"Node":{"type":"object","properties":{"next":{"$ref":"#/components/schemas/Node"}}}}}}', "openapi.json", ); const workspace = createWorkspace(entry); const schema = resolveLocalReference( workspace, "#/components/schemas/Node", ).value; const sample = generateSchemaSample(workspace, schema); expect(sample.value).toMatchObject({ next: { next: { $cycle: "openapi.json#/components/schemas/Node" } }, }); expect(sample.notices[0]).toMatch(/cycle/iu); }); });