/** * 遊客本機統計:未登入時存這台瀏覽器;與帳號的權威統計分離、不互相污染。 * * applyRunToStats 是「不碰 localStorage 的純聚合函式」(與後端 applyRun 規則相同), * 把 I/O 與邏輯分開 → 聚合與相容兜底都能用單元測試保護(web 端這份是獨立實作,server 測試不覆蓋)。 */ import type { RunSummary } from "@wcg/battle-core"; import type { OnlineRunReport, RunRecord, UserStats } from "./api.js"; export const GUEST_STATS_KEY = "wcg.guestStats"; export function emptyStats(): UserStats { return { plays: 0, clears: 0, peakAtk: 0, peakDef: 0, maxReachedStage: 0, maxStageByMode: {}, totalTurns: 0, classPlays: {}, recentClasses: [], runs: [] }; } /** 「敵人×難度」統計 key:normal=campaign;hard=加 :hard;insane=加 :extreme。與後端 stageModeKey 一致。 */ export function stageModeKey(campaign: string, hardMode?: boolean, extreme?: boolean): string { if (extreme) return `${campaign}:extreme`; return hardMode ? `${campaign}:hard` : campaign; } /** 把一場 RunSummary 聚合進統計(純函式;規則與後端 applyRun 相同)。 */ export function applyRunToStats(prevIn: UserStats, s: RunSummary, nowIso: string): UserStats { // 與後端 applyRun 一致:先用 emptyStats() 補齊舊資料可能缺的欄位(recentClasses/runs/…),避免 spread undefined。 const prev = { ...emptyStats(), ...prevIn }; return { plays: prev.plays + 1, clears: prev.clears + (s.cleared ? 1 : 0), peakAtk: Math.max(prev.peakAtk, s.peakAtk), peakDef: Math.max(prev.peakDef, s.peakDef), maxReachedStage: s.cleared ? prev.maxReachedStage : Math.max(prev.maxReachedStage, s.reachedStage), // 各敵人×難度的最高 Stage(含破關),普通/困難分開累積。 maxStageByMode: (() => { const prevStage = prev.maxStageByMode ?? {}; const k = stageModeKey(s.campaign, s.hardMode, s.extreme); return { ...prevStage, [k]: Math.max(prevStage[k] ?? 0, s.reachedStage) }; })(), totalTurns: prev.totalTurns + s.turns, // 動態累加:以 classType 為 key 累加 → 日後新增職業不必改這裡。 classPlays: { ...prev.classPlays, [s.classType]: (prev.classPlays[s.classType] ?? 0) + 1 }, // 最近 100 場職業(環形緩衝,最新在尾)→ 算「前 100 場最常使用職業」。 recentClasses: [...prev.recentClasses, s.classType].slice(-100), // 逐場紀錄(只留最近 100 場)→ 統計頁「遊玩紀錄」彈窗。 runs: [...(prev.runs ?? []), { ...s, at: nowIso }].slice(-100), lastPlayedAt: nowIso, }; } /** 讀遊客統計;以 emptyStats 兜底:舊版本缺欄位(如新加的 totalTurns)→ 補預設、不會是 undefined。 */ export function loadGuestStats(): UserStats { try { const raw = localStorage.getItem(GUEST_STATS_KEY); if (raw) { const parsed: unknown = JSON.parse(raw); // 僅接受純物件(防被竄改成陣列/字串/null 時 spread 出畸形 stats)。 if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) { return { ...emptyStats(), ...(parsed as Partial) }; } } } catch { /* localStorage 不可用 / 壞 JSON → 用預設 */ } return emptyStats(); } /** 聚合一場戰績到遊客統計並寫回本機。 */ export function saveGuestStats(s: RunSummary): UserStats { const next = applyRunToStats(loadGuestStats(), s, new Date().toISOString()); try { localStorage.setItem(GUEST_STATS_KEY, JSON.stringify(next)); } catch { /* 容量/隱私模式 → 略過 */ } return next; } /** 把一場連線(pvp/pve)結果聚合進統計:只進逐場紀錄與職業計數,不污染單人關卡/峰值聚合(與後端 applyOnlineRun 規則相同)。 */ export function applyOnlineRunToStats(prevIn: UserStats, o: OnlineRunReport, nowIso: string): UserStats { const prev = { ...emptyStats(), ...prevIn }; const rec: RunRecord = { at: nowIso, kind: o.kind, classType: o.classType, cleared: o.cleared, enemyName: o.enemyName }; return { ...prev, classPlays: { ...prev.classPlays, [o.classType]: (prev.classPlays[o.classType] ?? 0) + 1 }, recentClasses: [...prev.recentClasses, o.classType].slice(-100), runs: [...(prev.runs ?? []), rec].slice(-100), lastPlayedAt: nowIso, }; } /** 聚合一場連線戰績到遊客統計並寫回本機。 */ export function saveGuestOnlineRun(o: OnlineRunReport): UserStats { const next = applyOnlineRunToStats(loadGuestStats(), o, new Date().toISOString()); try { localStorage.setItem(GUEST_STATS_KEY, JSON.stringify(next)); } catch { /* 略過 */ } return next; }