tracker-tracker/src/lib/tracker-status.ts at refs/heads/patch-2 · bitglows/tracker-tracker · GitHub

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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
// src/lib/tracker-status.ts
//
// Functions: getPauseState, getTrackerHealth, getHealthBadgeVariant, getHealthLabel, getHealthDescription, getHealthPulseDot
//
// Single source of truth for tracker health status — type, derivation logic,
// and all visual mappings (PulseDot status, Badge variant, labels, descriptions).

import type { BadgeVariant } from "@/components/ui/Badge"
import type { PulseDotStatus } from "@/components/ui/PulseDot"
import type { TrackerSummary } from "@/types/api"

type TrackerHealth =
  | "healthy"
  | "warning"
  | "critical"
  | "error"
  | "paused"
  | "paused-user"
  | "offline"

interface HealthMeta {
  label: string
  description: string
  pulseDot: PulseDotStatus
  badge: BadgeVariant
}

const HEALTH_META: Record<TrackerHealth, HealthMeta> = {
  healthy: {
    label: "Healthy",
    description: "Ratio \u2265 2.0 \u2014 healthy buffer",
    pulseDot: "healthy",
    badge: "accent",
  },
  warning: {
    label: "Warning",
    description: "Ratio 1.0\u20132.0 or zero active seeds",
    pulseDot: "warning",
    badge: "warn",
  },
  critical: {
    label: "Critical",
    description: "Ratio < 1.0 \u2014 needs seeding",
    pulseDot: "critical",
    badge: "danger",
  },
  paused: {
    label: "Paused",
    description: "Polling paused after consecutive failures",
    pulseDot: "paused",
    badge: "danger",
  },
  "paused-user": {
    label: "Paused",
    description: "Automated polling paused by user",
    pulseDot: "paused-user",
    badge: "warn",
  },
  error: {
    label: "Error",
    description: "Last poll returned an error",
    pulseDot: "error",
    badge: "danger",
  },
  offline: {
    label: "Offline",
    description: "No data available",
    pulseDot: "offline",
    badge: "default",
  },
}

type PauseState = { isPaused: false } | { isPaused: true; reason: "user" | "failure"; since: Date }

function getPauseState(tracker: {
  pausedAt?: Date | string | null
  userPausedAt?: Date | string | null
}): PauseState {
  const userPaused = tracker.userPausedAt ? new Date(tracker.userPausedAt) : null
  const autoPaused = tracker.pausedAt ? new Date(tracker.pausedAt) : null

  if (userPaused) return { isPaused: true, reason: "user", since: userPaused }
  if (autoPaused) return { isPaused: true, reason: "failure", since: autoPaused }
  return { isPaused: false }
}

function getTrackerHealth(tracker: TrackerSummary): TrackerHealth {
  const pause = getPauseState(tracker)
  if (pause.isPaused) return pause.reason === "failure" ? "paused" : "paused-user"
  if (tracker.lastError) return "error"
  if (!tracker.latestStats) return "offline"
  const { ratio, seedingCount } = tracker.latestStats
  if (ratio === null) return "offline"

  // Warned by tracker is always critical — potential ban risk
  if (tracker.latestStats?.warned === true) return "critical"

  let status: TrackerHealth
  if (ratio >= 2) status = "healthy"
  else if (ratio >= 1) status = "warning"
  else status = "critical"

  if (seedingCount === 0 && status === "healthy") status = "warning"

  return status
}

function getHealthBadgeVariant(status: TrackerHealth): BadgeVariant {
  return HEALTH_META[status].badge
}

function getHealthLabel(status: TrackerHealth): string {
  return HEALTH_META[status].label
}

function getHealthDescription(status: TrackerHealth): string {
  return HEALTH_META[status].description
}

function getHealthPulseDot(status: TrackerHealth): PulseDotStatus {
  return HEALTH_META[status].pulseDot
}

export type { PauseState, TrackerHealth }
export {
  getHealthBadgeVariant,
  getHealthDescription,
  getHealthLabel,
  getHealthPulseDot,
  getPauseState,
  getTrackerHealth,
}