Scoreboard/web/src/admin/tests/athlete-purge-api.test.ts

import { test } from 'node:test'
import assert from 'node:assert/strict'

/**
 * 运动员「彻底删除」的前端契约：方法 / 路径 + `?purge=1`，以及失败时服务端那句话的传递。
 *
 * 服务端的原文（例如 404「运动员不存在」）一旦被换成「操作失败」现场就只能靠猜；
 * 而 404 又是「人员已不在」的真实回答，绝不能降级成示例数据假装删掉了。
 */

interface Captured {
  url?: string
  method?: string
  headers?: Record<string, string>
}

function jsonResponse(body: unknown, status = 200): Response {
  return new Response(JSON.stringify(body), {
    status,
    headers: { 'Content-Type': 'application/json' },
  })
}

let reply: () => Response = () => jsonResponse({ ok: true, data: null })
let lastRequest: Captured = {}

// 必须在导入被测模块之前装好：ApiClient 在构造时就把当时的 fetch 绑进实例，
// 之后再替换 globalThis.fetch 对它无效。所以这里装一个固定函数，每个用例只换回复。
globalThis.fetch = (async (input: unknown, init?: RequestInit) => {
  lastRequest = {
    url: String(input),
    method: init?.method ?? 'GET',
    headers: (init?.headers ?? {}) as Record<string, string>,
  }
  return reply()
}) as typeof fetch

function respondWith(response: () => Response): void {
  lastRequest = {}
  reply = response
}

const { ApiError, adminApi, mockMode, SAMPLE_DATA_BLOCKED } = await import('../api/client')
const { baseDataApi, baseDataFallback } = await import('../components/baseData/baseDataApi')

test('彻底删除走 DELETE /api/athletes/{id}?purge=1', async () => {
  respondWith(() => jsonResponse({ ok: true, data: null }))

  await adminApi.purgeAthlete(7)

  assert.equal(lastRequest.url, '/api/athletes/7?purge=1')
  assert.equal(lastRequest.method, 'DELETE')
})

// 字段名与服务端 athletePurge 一致；页面提示语要靠它说清「删了什么、重算了哪些小项」。
test('成功响应带统计时，客户端拿到删除规模与重算小项', async () => {
  respondWith(() =>
    jsonResponse({
      ok: true,
      data: { deletedEntries: 1, deletedResults: 1, deletedLedger: 2, deletedBreaks: 0, recomputedEvents: [1] },
    }),
  )

  const result = await adminApi.purgeAthlete(7)

  assert.deepEqual(result, {
    deletedEntries: 1,
    deletedResults: 1,
    deletedLedger: 2,
    deletedBreaks: 0,
    recomputedEvents: [1],
  })
})

// 删除在服务端已经提交、不可回滚：统计缺失时也只能按 0 报，不能冒出 undefined 或报成失败。
test('服务端没带统计时按 0 / 空数组兜底', async () => {
  respondWith(() => jsonResponse({ ok: true, data: null }))

  const result = await adminApi.purgeAthlete(7)

  assert.deepEqual(result, {
    deletedEntries: 0,
    deletedResults: 0,
    deletedLedger: 0,
    deletedBreaks: 0,
    recomputedEvents: [],
  })
})

// 服务端中间件要求已登录的写请求带 X-CSRF-Token，漏掉就是 403，删不掉还看不出原因。
test('彻底删除带上 CSRF 双提交 Cookie 的请求头', async () => {
  respondWith(() => jsonResponse({ ok: true, data: null }))
  const globalWithDocument = globalThis as { document?: unknown }
  globalWithDocument.document = { cookie: 'csrf_token=token-123' }
  try {
    await adminApi.purgeAthlete(1)
  } finally {
    delete globalWithDocument.document
  }

  assert.equal(lastRequest.headers?.['X-CSRF-Token'], 'token-123')
})

test('失败时不吞错误：服务端那句原文原样带出', async () => {
  respondWith(() =>
    jsonResponse({ ok: false, error: { code: 'INTERNAL', message: '服务端异常' } }, 500),
  )

  await assert.rejects(
    () => adminApi.purgeAthlete(7),
    (error: unknown) => {
      assert.ok(error instanceof ApiError)
      assert.equal(error.status, 500)
      assert.equal(error.code, 'INTERNAL')
      assert.equal(error.message, '服务端异常')
      return true
    },
  )
})

// 页面调用的是 baseDataApi 这一层：权限 / 服务端错误都是真实回答，不能降级成示例数据假装删掉了。
test('基础数据层把服务端错误原样抛给页面，不降级成示例数据', async () => {
  baseDataFallback.value = false
  respondWith(() =>
    jsonResponse({ ok: false, error: { code: 'FORBIDDEN', message: '需要管理员权限' } }, 403),
  )

  await assert.rejects(() => baseDataApi.athletes.purge(7), (error: Error) =>
    error.message.includes('需要管理员权限'),
  )
  assert.equal(baseDataFallback.value, false, '不应切到示例数据')
})

// 404 是「人员已经被别人删掉」这种真实回答，不是「接口未实现」：
// 一旦降级到示例数据，页面会把「根本没删掉」提示成「已彻底删除」。
test('purge 收到 404 时不降级，错误原样抛给页面', async () => {
  baseDataFallback.value = false
  respondWith(() =>
    jsonResponse({ ok: false, error: { code: 'VALIDATION_FAILED', message: '运动员不存在' } }, 404),
  )

  await assert.rejects(
    () => baseDataApi.athletes.purge(7),
    (error: unknown) => {
      assert.ok(error instanceof ApiError)
      assert.equal(error.status, 404)
      assert.equal(error.message, '运动员不存在')
      return true
    },
  )
  assert.equal(baseDataFallback.value, false, '不应切到示例数据')
})

// 对照组：同组的软删除 remove 行为不变，404 仍按「接口未实现」降级到示例数据。
// 示例数据里 id=1001 存在，能删掉就说明确实走了 mock 分支，而不是把 404 抛了出来。
test('remove 的 404 仍降级到示例数据（既有行为未受影响）', async () => {
  baseDataFallback.value = false
  respondWith(() =>
    jsonResponse({ ok: false, error: { code: 'VALIDATION_FAILED', message: '运动员不存在' } }, 404),
  )

  await baseDataApi.athletes.remove(1001)

  assert.equal(baseDataFallback.value, true)
})

// 后端整体连不上时不再降级示例数据：内存里「删掉」会让操作员以为人真被删了，
// 恢复连接后这些人又会全部回来。必须给出可识别的「未提交」结果（SAMPLE_DATA_BLOCKED）。
test('后端不可用时彻底删除被阻断：不降级示例数据、不返回假成功', async () => {
  baseDataFallback.value = false
  mockMode.value = false
  respondWith(() => {
    throw new TypeError('fetch failed')
  })

  await assert.rejects(
    () => baseDataApi.athletes.purge(1002),
    (error: unknown) => {
      assert.ok(error instanceof ApiError)
      assert.equal(error.code, SAMPLE_DATA_BLOCKED)
      assert.match(error.message, /示例数据/)
      return true
    },
  )
  assert.equal(baseDataFallback.value, true, '写请求撞上后端不可达后，页面应切到示例数据标记')
})