Match Timeline Adapter (Mr. Doge SDK)

1import type { MatchDetail, TimelineEvent } from "@mrdoge/protocol"
2import type { MatchTimelineEntry, MatchTimelineProps } from "@/registry/mrdoge-ui/match-timeline/match-timeline"
3 
4// Soccer only. classify() and the phase labels below use soccer's own
5// event/phase sysnames. Other sports just get zero entries for now.
6 
7// Matched by prefix. Lower-tier competitions report goals/cards without
8// a named player ("GoalWithoutScorer" vs "GoalWithScorer"). "GoalWith"
9// specifically, not "GoalKick" (a real, different event).
10function classify(type: string): "goal" | "own-goal" | "yellow-card" | "red-card" | "penalty" | null {
11  if (type === "OwnGoal") return "own-goal"
12  if (type.startsWith("GoalWith")) return "goal"
13  if (type.startsWith("YellowCard")) return "yellow-card"
14  if (type.startsWith("RedCard")) return "red-card"
15  if (type === "PenaltyKick") return "penalty"
16  return null
17}
18 
19function toTimeLabel(event: TimelineEvent): string | undefined {
20  return event.captions[0] ? `${event.captions[0]}'` : undefined
21}
22 
23// clock.phase/display/displayLong only update on backend event triggers
24// and can go stale. StartOfSecondHalf (tracked below) is the reliable
25// "2nd half started" signal; elapsedSeconds is only a last-resort
26// fallback for matches with no events to check at all.
27const SOCCER_PHASE_LABEL: Record<string, string> = {
28  SOCCER_MATCH_FIRST_HALF: "1st Half",
29  SOCCER_MATCH_SECOND_HALF: "2nd Half",
30  SOCCER_MATCH_EXTRA_FIRST_HALF: "Extra Time - 1st Half",
31  SOCCER_MATCH_EXTRA_SECOND_HALF: "Extra Time - 2nd Half",
32  SOCCER_MATCH_PENALTIES: "Penalties",
33}
34// Only reached when there's no StartOfSecondHalf event to trust.
35// Deliberately wide, since real 1st-half stoppage rarely approaches it.
36const FIRST_HALF_ELAPSED_CUTOFF_SECONDS = 70 * 60
37const SECOND_HALF_ELAPSED_CEILING_SECONDS = 115 * 60
38 
39function phaseLabelFromElapsedSeconds(elapsedSeconds: number | null | undefined): string | undefined {
40  if (elapsedSeconds == null) return undefined
41  if (elapsedSeconds <= FIRST_HALF_ELAPSED_CUTOFF_SECONDS) return "1st Half"
42  if (elapsedSeconds <= SECOND_HALF_ELAPSED_CEILING_SECONDS) return "2nd Half"
43  return undefined
44}
45 
46type ClockLike = {
47  phase: string | null
48  state?: string | null
49  display: string | null
50  displayLong: string | null
51  elapsedSeconds?: number | null
52} | null | undefined
53 
54function toLivePhaseLabel(clock: ClockLike, secondHalfStarted: boolean): string {
55  // elapsedSeconds is null during intermission. Trust the backend's
56// … truncated