import { describe, expect, it } from "vitest"; import { readFailureEnvelope, readSuccessEnvelope, } from "../../src/adapters/http/backend-envelope.ts"; import { composeRuntimeSchemaCodecs, validateWithRuntimeSchemaRegistry, } from "../../src/contracts/schema-registry.ts"; describe("paired backend Envelope boundary", () => { it("rejects an invalid top-level envelope", () => { expect(readSuccessEnvelope({ success: true }).ok).toBe(false); expect( readSuccessEnvelope({ success: true, data: [], meta: {}, error: {} }).ok, ).toBe(false); expect(readFailureEnvelope({ success: false, meta: {} }).ok).toBe(false); }); it("reads data, and a dropped data key as null", () => { expect( readSuccessEnvelope({ success: true, data: [], meta: { requestId: "request-1", traceId: "trace-1" }, }), ).toEqual({ ok: true, value: [] }); expect(readSuccessEnvelope({ success: true, meta: {} })).toEqual({ ok: true, value: null, }); }); it("reads the failure error and refuses a code outside the backend grammar", () => { expect( readFailureEnvelope({ success: false, error: { code: "NOT_FOUND", category: "NOT_FOUND", retryable: false }, meta: {}, }), ).toEqual({ ok: true, value: { code: "NOT_FOUND", category: "NOT_FOUND", retryable: false }, }); expect( readFailureEnvelope({ success: false, error: { code: "not-a-code" }, meta: {} }).ok, ).toBe(false); }); }); describe("runtime schema codec contribution", () => { const codec = { schemaId: "Example", parse: (value: unknown) => ({ success: true as const, data: value }), }; it("resolves installed codecs and fails missing IDs closed", () => { const registry = composeRuntimeSchemaCodecs([{ Example: codec }]); expect(validateWithRuntimeSchemaRegistry("Example", 42, registry)).toEqual({ success: true, data: 42, }); expect( validateWithRuntimeSchemaRegistry("Missing", 42, registry), ).toMatchObject({ success: false, issues: [{ code: "SCHEMA_NOT_REGISTERED" }], }); }); it("bounds failure issues returned by an installed codec", () => { const noisyCodec = { schemaId: "Noisy", parse: () => ({ success: false as const, issues: [ { path: "p".repeat(121), code: "TOO_LONG_PATH" }, { path: "field", code: "C".repeat(81) }, ...Array.from({ length: 100 }, (_, index) => ({ path: `field.${index}`, code: "INVALID", })), ], }), }; const registry = composeRuntimeSchemaCodecs([{ Noisy: noisyCodec }]); const result = validateWithRuntimeSchemaRegistry("Noisy", {}, registry); expect(result.success).toBe(false); if (result.success) throw new Error("expected validation failure"); expect(result.issues).toHaveLength(50); expect(result.issues[0]).toEqual({ path: "field.0", code: "INVALID" }); }); it("rejects duplicate codec contributions", () => { expect(() => composeRuntimeSchemaCodecs([{ Example: codec }, { Example: codec }]), ).toThrow("duplicate runtime schema codec"); }); });