Edu/apps/parent-portal/src/hooks/useChildGrades.test.tsx

// useChildGrades Hook 单测
// 依据：02-architecture-design.md §4.2 GraphQL 接入
// 覆盖：无 currentChildId 暂停 / 加载态 / 成功返回 / subject 过滤 / 错误态

import {
  describe,
  it,
  expect,
  beforeAll,
  afterAll,
  afterEach,
  beforeEach,
} from "vitest";
import { renderHook, waitFor, cleanup } from "@testing-library/react";
import {
  Provider as UrqlProvider,
  Client,
  cacheExchange,
  fetchExchange,
} from "urql";
import { graphql, HttpResponse } from "msw";
import type { ReactNode } from "react";
import { server } from "@/test/mocks/server";
import { useChildStore } from "@/store/child-store";
import { useChildGrades } from "./useChildGrades";

function createTestClient(): Client {
  return new Client({
    url: "/api/v1/parent/v1/graphql",
    exchanges: [cacheExchange, fetchExchange],
    fetchOptions: { headers: { "X-Requested-With": "XMLHttpRequest" } },
  });
}

function renderUseChildGrades(subject?: string) {
  const client = createTestClient();
  const wrapper = ({ children }: { children: ReactNode }) => (
    <UrqlProvider value={client}>{children}</UrqlProvider>
  );
  return renderHook(() => useChildGrades(subject), { wrapper });
}

beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
afterEach(() => {
  cleanup();
  server.resetHandlers();
});
afterAll(() => server.close());

beforeEach(() => {
  localStorage.clear();
  useChildStore.setState({
    children: [],
    currentChildId: null,
    isLoading: false,
  });
});

describe("useChildGrades", () => {
  it("无 currentChildId 时暂停查询，返回空数组", () => {
    const { result } = renderUseChildGrades();
    expect(result.current.grades).toEqual([]);
    expect(result.current.loading).toBe(false);
    expect(result.current.error).toBeUndefined();
  });

  it("有 currentChildId 时加载成功返回成绩列表", async () => {
    useChildStore.setState({ currentChildId: "student-001" });
    const { result } = renderUseChildGrades();
    await waitFor(() => {
      expect(result.current.grades.length).toBeGreaterThan(0);
    });
    expect(result.current.grades).toHaveLength(4);
    expect(result.current.grades[0]!.subject).toBe("数学");
    expect(result.current.grades[0]!.gradeLevel).toBe("A");
    expect(result.current.loading).toBe(false);
    expect(result.current.error).toBeUndefined();
  });

  it("加载中 loading 为 true", () => {
    useChildStore.setState({ currentChildId: "student-001" });
    const { result } = renderUseChildGrades();
    expect(result.current.loading).toBe(true);
  });

  it("传入 subject 时变量携带 subject", async () => {
    useChildStore.setState({ currentChildId: "student-001" });
    let capturedVars: unknown = null;
    server.resetHandlers(
      graphql.query("ChildGrades", ({ variables }) => {
        capturedVars = variables;
        return HttpResponse.json({
          data: {
            childGrades: [
              {
                examId: "exam-001",
                examName: "期中数学测验",
                examDate: "2026-03-15T09:00:00Z",
                subject: "数学",
                studentScore: 92,
                classAverage: 78,
                classMax: 100,
                classMin: 45,
                gradeLevel: "A",
              },
            ],
          },
        });
      }),
    );

    const { result } = renderUseChildGrades("数学");
    await waitFor(() => {
      expect(result.current.grades).toHaveLength(1);
    });
    expect(capturedVars).toEqual({
      childId: "student-001",
      subject: "数学",
    });
  });

  it("未传 subject 时变量 subject 为 null", async () => {
    useChildStore.setState({ currentChildId: "student-001" });
    let capturedVars: unknown = null;
    server.resetHandlers(
      graphql.query("ChildGrades", ({ variables }) => {
        capturedVars = variables;
        return HttpResponse.json({ data: { childGrades: [] } });
      }),
    );

    const { result } = renderUseChildGrades();
    await waitFor(() => {
      expect(result.current.loading).toBe(false);
    });
    expect(capturedVars).toEqual({
      childId: "student-001",
      subject: null,
    });
    expect(result.current.grades).toEqual([]);
  });

  it("GraphQL 返回错误时透传 error", async () => {
    useChildStore.setState({ currentChildId: "student-001" });
    server.resetHandlers(
      graphql.query("ChildGrades", () =>
        HttpResponse.json(
          { errors: [{ message: "成绩查询失败" }] },
          { status: 200 },
        ),
      ),
    );

    const { result } = renderUseChildGrades();
    await waitFor(() => {
      expect(result.current.error).toBeDefined();
    });
    expect(result.current.grades).toEqual([]);
    expect(result.current.error?.message).toContain("成绩查询失败");
  });
});