import type { WeeklyDocument, WeeklyTransport } from './qaWeeklyDrafts' import { validPeriodInput } from './qaPeriodInput' import { getPayload, QARequestError } from './qaOps' import type { WeeklyWriteRequest, WeeklyPrefillRequest } from './qaWeeklyDrafts' const invalid = (): never => { throw Error('草稿响应无效,未展示或标记为已保存') } export function parseWeeklyDocument(value: unknown, week: string): WeeklyDocument { if (!value || typeof value !== 'object' || Array.isArray(value)) return invalid() const v = value as Record if ( v.week !== week || !validPeriodInput('week', week) || typeof v.revision !== 'number' || !Number.isSafeInteger(v.revision) || v.revision < 0 || typeof v.markdown !== 'string' || new TextEncoder().encode(v.markdown).length > 256 * 1024 || !v.seed || typeof v.seed !== 'object' || Array.isArray(v.seed) ) return invalid() if (v.revision === 0) { if (v.markdown !== '' || v.updated_at !== null || Object.keys(v.seed).length) return invalid() } else if (typeof v.updated_at !== 'string' || !Number.isFinite(Date.parse(v.updated_at))) return invalid() return { week, revision: v.revision, markdown: v.markdown, seed: v.seed as Record, updated_at: v.updated_at as string | null, } } const endpoint = (week: string) => `/api/v1/qa-ops/master/weekly-drafts/${encodeURIComponent(week)}` async function read(week: string) { return parseWeeklyDocument(await getPayload(endpoint(week)), week) } async function save(week: string, q: WeeklyWriteRequest | WeeklyPrefillRequest, prefill: boolean) { const raw = await getPayload(endpoint(week) + (prefill ? '/prefill' : ''), undefined, { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-Governance-Action': 'qa-weekly-draft' }, body: JSON.stringify(q), }) if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return invalid() const receipt = raw as Record, draft = parseWeeklyDocument(receipt.draft, week) if ( typeof receipt.replayed !== 'boolean' || draft.revision !== q.base_revision + 1 || (!prefill && draft.markdown !== (q as WeeklyWriteRequest).markdown) ) return invalid() const current = await read(week) if (current.revision !== draft.revision || current.markdown !== draft.markdown) throw new QARequestError('本周草稿在保存后又发生变化;你的文字仍保留,请核对服务器版本', 409) return current } export const weeklyTransport: WeeklyTransport = { read, write: (week, q) => save(week, q, false), prefill: (week, q) => save(week, q, true), }