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

// useChildCoursePlanDetail Hook 单测
// 依据：02-architecture-design.md §4.2 GraphQL 接入
// 覆盖：无 currentChildId / 无 planId 暂停 / 加载态 / 成功返回详情（含章节）/ 错误态 / 详情为 null

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 { useChildCoursePlanDetail } from "./useChildCoursePlanDetail";

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

function renderUseChildCoursePlanDetail(planId: string) {
  const client = createTestClient();
  const wrapper = ({ children }: { children: ReactNode }) => (
    <UrqlProvider value={client}>{children}</UrqlProvider>
  );
  return renderHook(() => useChildCoursePlanDetail(planId), { wrapper });
}

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

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

describe("useChildCoursePlanDetail", () => {
  it("无 currentChildId 时暂停查询，返回 null", () => {
    const { result } = renderUseChildCoursePlanDetail("cp-001");
    expect(result.current.coursePlan).toBeNull();
    expect(result.current.loading).toBe(false);
    expect(result.current.error).toBeUndefined();
  });

  it("无 planId 时暂停查询，返回 null", () => {
    useChildStore.setState({ currentChildId: "student-001" });
    const { result } = renderUseChildCoursePlanDetail("");
    expect(result.current.coursePlan).toBeNull();
    expect(result.current.loading).toBe(false);
    expect(result.current.error).toBeUndefined();
  });

  it("有 currentChildId 和 planId 时加载成功返回课程计划详情", async () => {
    useChildStore.setState({ currentChildId: "student-001" });
    const { result } = renderUseChildCoursePlanDetail("cp-001");
    await waitFor(() => {
      expect(result.current.coursePlan).not.toBeNull();
    });
    expect(result.current.coursePlan?.id).toBe("cp-001");
    expect(result.current.coursePlan?.title).toBe("初一数学下学期课程计划");
    expect(result.current.coursePlan?.chapters).toHaveLength(4);
    expect(result.current.coursePlan?.chapters[0]!.title).toBe(
      "第一章 一元二次方程",
    );
    expect(result.current.coursePlan?.chapters[0]!.sortOrder).toBe(1);
    expect(result.current.loading).toBe(false);
    expect(result.current.error).toBeUndefined();
  });

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

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

    const { result } = renderUseChildCoursePlanDetail("cp-001");
    await waitFor(() => {
      expect(result.current.error).toBeDefined();
    });
    expect(result.current.coursePlan).toBeNull();
    expect(result.current.error?.message).toContain("课程计划详情查询失败");
  });

  it("详情为 null 时返回 null", async () => {
    useChildStore.setState({ currentChildId: "student-001" });
    server.resetHandlers(
      graphql.query("ChildCoursePlanDetail", () =>
        HttpResponse.json({ data: { childCoursePlanDetail: null } }),
      ),
    );

    const { result } = renderUseChildCoursePlanDetail("not-exist");
    await waitFor(() => {
      expect(result.current.loading).toBe(false);
    });
    expect(result.current.coursePlan).toBeNull();
  });
});