feat: add booksApi client for the books backend

src/services/booksApi.test.ts

@@ -0,0 +1,94 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { createEmptyBook } from '../domain/teachingDesign'
+import * as booksApi from './booksApi'
+
+describe('booksApi', () => {
+  beforeEach(() => {
+    vi.stubGlobal('fetch', vi.fn())
+  })
+
+  afterEach(() => {
+    vi.unstubAllGlobals()
+  })
+
+  it('lists books', async () => {
+    const summaries = [{ id: 'b1', name: 'Web', updatedAt: '2026-01-01T00:00:00.000Z', lessonCount: 2 }]
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify(summaries), { status: 200 }))
+
+    await expect(booksApi.listBooks()).resolves.toEqual(summaries)
+    expect(fetch).toHaveBeenCalledWith('/api/books', expect.objectContaining({ headers: expect.any(Object) }))
+  })
+
+  it('creates a book', async () => {
+    const created = { id: 'b1', name: '新整本', updatedAt: '2026-01-01T00:00:00.000Z', data: createEmptyBook() }
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify(created), { status: 200 }))
+
+    await expect(booksApi.createBook('新整本')).resolves.toEqual(created)
+
+    const [, init] = vi.mocked(fetch).mock.calls[0]!
+    expect(init?.method).toBe('POST')
+    expect(JSON.parse(init?.body as string)).toEqual({ name: '新整本' })
+  })
+
+  it('gets a book', async () => {
+    const record = { id: 'b1', name: 'Web', updatedAt: '2026-01-01T00:00:00.000Z', data: createEmptyBook() }
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify(record), { status: 200 }))
+
+    await expect(booksApi.getBook('b1')).resolves.toEqual(record)
+    expect(fetch).toHaveBeenCalledWith('/api/books/b1', expect.objectContaining({ headers: expect.any(Object) }))
+  })
+
+  it('updates a book', async () => {
+    const meta = { id: 'b1', name: 'Web', updatedAt: '2026-01-02T00:00:00.000Z' }
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify(meta), { status: 200 }))
+
+    const data = createEmptyBook()
+    await expect(booksApi.updateBook('b1', data)).resolves.toEqual(meta)
+
+    const [, init] = vi.mocked(fetch).mock.calls[0]!
+    expect(init?.method).toBe('PUT')
+    expect(JSON.parse(init?.body as string)).toEqual({ data })
+  })
+
+  it('renames a book', async () => {
+    const meta = { id: 'b1', name: '新名称', updatedAt: '2026-01-01T00:00:00.000Z' }
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify(meta), { status: 200 }))
+
+    await expect(booksApi.renameBook('b1', '新名称')).resolves.toEqual(meta)
+
+    const [, init] = vi.mocked(fetch).mock.calls[0]!
+    expect(init?.method).toBe('PATCH')
+    expect(JSON.parse(init?.body as string)).toEqual({ name: '新名称' })
+  })
+
+  it('deletes a book', async () => {
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify({ ok: true }), { status: 200 }))
+
+    await expect(booksApi.deleteBook('b1')).resolves.toEqual({ ok: true })
+
+    const [, init] = vi.mocked(fetch).mock.calls[0]!
+    expect(init?.method).toBe('DELETE')
+  })
+
+  it('generates a lesson', async () => {
+    const result = { filename: 'css-flex.md', markdown: '# CSS 弹性布局 教学设计' }
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify(result), { status: 200 }))
+
+    await expect(booksApi.generateLesson('CSS 弹性布局')).resolves.toEqual(result)
+
+    const [, init] = vi.mocked(fetch).mock.calls[0]!
+    expect(JSON.parse(init?.body as string)).toEqual({ topic: 'CSS 弹性布局' })
+  })
+
+  it('throws the server error message on failure', async () => {
+    vi.mocked(fetch).mockResolvedValue(new Response(JSON.stringify({ error: '整本不存在。' }), { status: 404 }))
+
+    await expect(booksApi.getBook('missing')).rejects.toThrow('整本不存在。')
+  })
+
+  it('throws a generic error when the response has no error message', async () => {
+    vi.mocked(fetch).mockResolvedValue(new Response('', { status: 500 }))
+
+    await expect(booksApi.getBook('b1')).rejects.toThrow('请求失败（500）')
+  })
+})

src/services/booksApi.ts

@@ -0,0 +1,72 @@
+import type { TeachingBook } from '../domain/teachingDesign'
+
+export interface BookSummary {
+  id: string
+  name: string
+  updatedAt: string
+  lessonCount: number
+}
+
+export interface BookRecord {
+  id: string
+  name: string
+  updatedAt: string
+  data: TeachingBook
+}
+
+export interface BookMeta {
+  id: string
+  name: string
+  updatedAt: string
+}
+
+export interface GenerateResult {
+  filename: string
+  markdown: string
+}
+
+interface ErrorBody {
+  error?: string
+}
+
+async function request<T>(path: string, init?: RequestInit): Promise<T> {
+  const response = await fetch(path, {
+    ...init,
+    headers: { 'Content-Type': 'application/json', ...(init?.headers ?? {}) },
+  })
+
+  if (!response.ok) {
+    const body = (await response.json().catch(() => null)) as ErrorBody | null
+    throw new Error(body?.error ?? `请求失败（${response.status}）。`)
+  }
+
+  return response.json() as Promise<T>
+}
+
+export function listBooks(): Promise<BookSummary[]> {
+  return request('/api/books')
+}
+
+export function createBook(name: string): Promise<BookRecord> {
+  return request('/api/books', { method: 'POST', body: JSON.stringify({ name }) })
+}
+
+export function getBook(id: string): Promise<BookRecord> {
+  return request(`/api/books/${id}`)
+}
+
+export function updateBook(id: string, data: TeachingBook): Promise<BookMeta> {
+  return request(`/api/books/${id}`, { method: 'PUT', body: JSON.stringify({ data }) })
+}
+
+export function renameBook(id: string, name: string): Promise<BookMeta> {
+  return request(`/api/books/${id}`, { method: 'PATCH', body: JSON.stringify({ name }) })
+}
+
+export function deleteBook(id: string): Promise<{ ok: true }> {
+  return request(`/api/books/${id}`, { method: 'DELETE' })
+}
+
+export function generateLesson(topic: string): Promise<GenerateResult> {
+  return request('/api/generate', { method: 'POST', body: JSON.stringify({ topic }) })
+}