File size: 5,328 Bytes
1302ebc
 
 
 
 
 
 
 
 
67057ab
1302ebc
 
 
 
 
 
 
 
 
 
 
93ae949
1302ebc
 
 
 
93ae949
 
 
 
 
 
 
 
 
 
 
1302ebc
 
 
 
 
 
758be85
67057ab
 
1302ebc
 
 
 
 
 
 
 
 
 
 
 
 
 
758be85
67057ab
 
 
 
 
 
 
1302ebc
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
758be85
67057ab
 
1302ebc
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
/**
 * 單場戰績回報 → 後端權威重播 → 算 RunSummary。
 *
 * 不信任 client 送來的任何數值:只收「seed + 動作序列 + 該場設定」,用引擎 replay 重跑,
 * 再以 summarizeRun 權威算出 ATK/DEF/破關/Stage(與鬼影重播同等級防偽)。
 */
import {
  replay,
  summarizeRun,
  validateExtremeDeck,
  CLASS_INIT,
  MAX_LEVEL,
  SANCTUS_MAX_LEVEL,
  RULE_VERSION,
  CARDS_HASH,
  type Action,
  type Campaign,
  type ClassType,
  type RunSummary,
} from "@wcg/battle-core";
import { intInRange, validateActions } from "./ghostService.js";
import type { OnlineRunInput } from "./userRepository.js";

/** 合法職業集合由 battle-core 的 CLASS_INIT 派生 → 新增職業時這個輸入驗證點不必改。 */
const VALID_CLASSES = new Set<string>(Object.keys(CLASS_INIT));

/** 連線(pvp/pve)戰績的形態驗證+淨化(後端無法重播 → 採信,但仍限職業合法與名稱長度)。回 null=非法。 */
export function parseOnlineRun(body: unknown): OnlineRunInput | null {
  if (typeof body !== "object" || body === null) return null;
  const r = body as Record<string, unknown>;
  if (r.kind !== "pvp" && r.kind !== "pve") return null;
  if (typeof r.classType !== "string" || !VALID_CLASSES.has(r.classType)) return null;
  if (typeof r.cleared !== "boolean") return null;
  if (typeof r.enemyName !== "string" || r.enemyName.length < 1 || r.enemyName.length > 40) return null;
  return { kind: r.kind, classType: r.classType as ClassType, cleared: r.cleared, enemyName: r.enemyName.slice(0, 40) };
}

export interface RunReport {
  seed: number;
  actions: Action[];
  classType: ClassType;
  campaign: Campaign;
  maxLevel: number;
  hardMode?: boolean;
  extreme?: boolean; // 極難(insane):重播須帶;且須附自組牌組
  deckOverride?: number[]; // 極難自組 30 張牌(重播洗牌須一致)
  ruleVersion: string;
  cardsHash: string;
}

/** 驗證回報 body 形態;回錯誤訊息或 null(通過)。 */
export function validateRunReport(body: unknown): string | null {
  if (typeof body !== "object" || body === null) return "body 必須是物件";
  const r = body as Record<string, unknown>;
  if (!intInRange(r.seed, -0x80000000, 0xffffffff)) return "seed 必須是整數";
  const actErr = validateActions(r.actions);
  if (actErr) return actErr;
  if (typeof r.classType !== "string" || !VALID_CLASSES.has(r.classType)) return "classType 非法";
  if (r.campaign !== "slime" && r.campaign !== "sanctus") return "campaign 非法";
  if (!intInRange(r.maxLevel, 1, 99)) return "maxLevel 超出範圍";
  if (r.hardMode !== undefined && typeof r.hardMode !== "boolean") return "hardMode 非法";
  if (r.extreme !== undefined && typeof r.extreme !== "boolean") return "extreme 非法";
  // 極難:必須附「合法的自組 30 張牌」(張數/稀有度上限/副本上限/單職業,validateExtremeDeck 權威把關);非極難則不得帶 deckOverride。
  if (r.extreme === true) {
    if (!Array.isArray(r.deckOverride) || !validateExtremeDeck(r.deckOverride as number[], r.classType as ClassType)) return "deckOverride 非法(極難須附合法 30 張牌組)";
  } else if (r.deckOverride !== undefined) {
    return "非極難不得帶 deckOverride";
  }
  if (typeof r.ruleVersion !== "string" || r.ruleVersion.length < 1 || r.ruleVersion.length > 32) return "缺/非法 ruleVersion";
  if (typeof r.cardsHash !== "string" || r.cardsHash.length < 1 || r.cardsHash.length > 64) return "缺/非法 cardsHash";
  return null;
}

export type RunResult =
  | { status: "ok"; summary: RunSummary }
  | { status: "version-mismatch" } // client 規則版本與 server 不同 → 不聚合(請玩家重新整理更新)
  | { status: "invalid"; reason: string };

/** 該 campaign 的正式最後一關(除錯用的縮短關卡數不算正式破關)。 */
function officialMaxLevel(campaign: Campaign): number {
  return campaign === "sanctus" ? SANCTUS_MAX_LEVEL : MAX_LEVEL;
}

/** 權威處理一份(已通過形態驗證的)回報。 */
export function processRunReport(report: RunReport): RunResult {
  if (report.ruleVersion !== RULE_VERSION || report.cardsHash !== CARDS_HASH) {
    return { status: "version-mismatch" };
  }
  let final;
  try {
    final = replay(report.seed, report.actions, {
      classType: report.classType,
      campaign: report.campaign,
      maxLevel: report.maxLevel,
      hardMode: report.hardMode, // 困難會多消費 rng → 不帶會重播失準(戰績算錯/判 invalid)
      extreme: report.extreme, // 極難:影響數值/迴避/必殺技;deckOverride 決定洗牌
      deckOverride: report.extreme ? report.deckOverride : undefined,
    });
  } catch (e) {
    return { status: "invalid", reason: `replay-error: ${(e as Error).message}` };
  }
  if (final.phase !== "VICTORY" && final.phase !== "GAME_OVER") {
    return { status: "invalid", reason: "該場尚未結束(phase 非 VICTORY/GAME_OVER)" };
  }
  const summary = summarizeRun(final);
  // 防除錯灌水:縮短關卡數(maxLevel 非正式值)的場次,plays/peak 仍記,但不算「過關」。
  const cleared = summary.cleared && report.maxLevel === officialMaxLevel(report.campaign);
  return { status: "ok", summary: { ...summary, cleared } };
}