feat(mcp): подготовить сервер и доступ к приёмке

lib/fmt-rate.ts

@@ -0,0 +1,52 @@
+/** Формат скорости: Кбит/с при < 1 Мбит/с, иначе Мбит/с / Гбит/с. */
+export function fmtRate(v: number | null | undefined): string {
+  if (v == null) return "—"
+  if (!Number.isFinite(v) || v <= 0) return "0 Кбит/с"
+  if (v < 0.0005) return "<1 Кбит/с"
+  if (v >= 1000) return `${(v / 1000).toFixed(2)} Гбит/с`
+  if (v < 1) return `${Math.round(v * 1000)} Кбит/с`
+  if (v < 10) return `${v.toFixed(2)} Мбит/с`
+  if (v < 100) return `${v.toFixed(1)} Мбит/с`
+  return `${Math.round(v)} Мбит/с`
+}
+
+const binaryFormatter = new Intl.NumberFormat("ru-RU", { maximumFractionDigits: 2 })
+/** Traffic API volumeUnit=GiB: preserve binary units and never format positive bytes as zero. */
+export function fmtGiB(v: number | null | undefined): string {
+  if (v == null || !Number.isFinite(v) || v < 0) return "—"
+  const bytes = v * 1024 ** 3
+  if (!Number.isFinite(bytes)) return "—"
+  if (bytes === 0) return "0 Б"
+  if (bytes < 1) return "<1 Б"
+  const units = ["Б", "КиБ", "МиБ", "ГиБ", "ТиБ", "ПиБ"]
+  const index = Math.min(units.length - 1, Math.floor(Math.log(bytes) / Math.log(1024)))
+  return `${binaryFormatter.format(bytes / 1024 ** index)} ${units[index]}`
+}
+
+export function formatBytes(n: number): string {
+  if (!Number.isFinite(n) || n <= 0) return "0 Б"
+  if (n >= 1_000_000_000_000) return `${(n / 1_000_000_000_000).toFixed(2)} ТБ`
+  if (n >= 1_000_000_000) return `${(n / 1_000_000_000).toFixed(2)} ГБ`
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)} МБ`
+  if (n >= 1000) return `${(n / 1000).toFixed(1)} КБ`
+  return `${Math.round(n)} Б`
+}
+
+/** API bitrate is bits/s; fmtRate expects Мбит/с. */
+export function fmtBps(bps: number): string {
+  return fmtRate(bps / 1_000_000)
+}
+
+export const TRAFFIC_RANGE_MINUTES: Record<string, number> = {
+  "5m": 5,
+  "15m": 15,
+  "1h": 60,
+  "4h": 240,
+  "24h": 1440,
+}
+
+export function formatRangeAgo(minutesAgo: number): string {
+  if (minutesAgo <= 0) return "сейчас"
+  if (minutesAgo < 60) return `−${minutesAgo}м`
+  return `−${Math.round(minutesAgo / 60)}ч`
+}