DiAL/tests/server/checker/runner/http/expect.test.ts

import { describe, expect, test } from "bun:test";

import type { RawKeyedExpectations } from "../../../../../src/server/checker/expect/types";

import { checkHeaderExpectations } from "../../../../../src/server/checker/expect/headers";
import { resolveKeyedExpectations } from "../../../../../src/server/checker/expect/keyed";
import { checkStatusCode } from "../../../../../src/server/checker/expect/status";

function checkHeaders(headers: Record<string, unknown>, raw?: RawKeyedExpectations) {
  return checkHeaderExpectations(headers, resolveKeyedExpectations(raw));
}

describe("checkHeaders", () => {
  test("未配置 headers expect 时匹配成功", () => {
    const result = checkHeaders({});
    expect(result.matched).toBe(true);
    expect(result.failure).toBeNull();
  });

  test("字符串格式按等值匹配", () => {
    const headers = { "content-type": "application/json", "x-api": "v1" };

    expect(checkHeaders(headers, { "content-type": "application/json" }).matched).toBe(true);
    expect(checkHeaders(headers, { "content-type": "text/html" }).matched).toBe(false);
  });

  test("header 名称按小写响应头匹配", () => {
    const headers = { "content-type": "application/json" };

    expect(checkHeaders(headers, { "Content-Type": "application/json" }).matched).toBe(true);
  });

  test("操作符格式匹配", () => {
    const headers = { "content-type": "application/json" };

    expect(checkHeaders(headers, { "content-type": { contains: "json" } }).matched).toBe(true);
    expect(checkHeaders(headers, { "content-type": { regex: "^application/" } }).matched).toBe(true);
    expect(checkHeaders(headers, { "content-type": { contains: "xml" } }).matched).toBe(false);
  });

  test("缺失 header 默认返回失败", () => {
    const result = checkHeaders({}, { "x-missing": "value" });

    expect(result.matched).toBe(false);
    expect(result.failure!.phase).toBe("headers");
    expect(result.failure!.kind).toBe("mismatch");
  });

  test("缺失 header 且 exists=false 时匹配成功", () => {
    const result = checkHeaders({}, { "x-missing": { exists: false } });

    expect(result.matched).toBe(true);
    expect(result.failure).toBeNull();
  });
});

describe("checkStatusCode 范围匹配", () => {
  test("无 expect 配置时默认 status [200] 可由调用方使用 checkStatusCode 表达", () => {
    const result = checkStatusCode(200, [200]);
    expect(result.matched).toBe(true);
    expect(result.failure).toBeNull();
  });

  test("status 不匹配返回 phase=status 的失败", () => {
    const result = checkStatusCode(503, [200]);
    expect(result.matched).toBe(false);
    expect(result.failure!.phase).toBe("status");
    expect(result.failure!.expected).toEqual([200]);
    expect(result.failure!.actual).toBe(503);
  });

  test("2xx 范围匹配 200", () => {
    expect(checkStatusCode(200, ["2xx"]).matched).toBe(true);
  });

  test("2xx 范围匹配 204", () => {
    expect(checkStatusCode(204, ["2xx"]).matched).toBe(true);
  });

  test("2xx 范围不匹配 301", () => {
    expect(checkStatusCode(301, ["2xx"]).matched).toBe(false);
  });

  test("5xx 范围匹配 503", () => {
    expect(checkStatusCode(503, ["5xx"]).matched).toBe(true);
  });

  test("混合精确值与范围模式命中精确值", () => {
    expect(checkStatusCode(301, ["2xx", 301]).matched).toBe(true);
  });

  test("混合精确值与范围模式命中范围", () => {
    expect(checkStatusCode(204, ["2xx", 301]).matched).toBe(true);
  });

  test("混合模式都不匹配", () => {
    expect(checkStatusCode(404, ["2xx", 301]).matched).toBe(false);
  });

  test("纯精确值仍正常工作", () => {
    expect(checkStatusCode(200, [200, 201]).matched).toBe(true);
    expect(checkStatusCode(404, [200, 201]).matched).toBe(false);
  });

  test("1xx 范围匹配 101", () => {
    expect(checkStatusCode(101, ["1xx"]).matched).toBe(true);
  });

  test("3xx 范围匹配 301", () => {
    expect(checkStatusCode(301, ["3xx"]).matched).toBe(true);
  });

  test("4xx 范围匹配 404", () => {
    expect(checkStatusCode(404, ["4xx"]).matched).toBe(true);
  });
});