SPB Git

Repository Public

logic.ts 6.3 KB 155 lines typescript

1// Pure helpers of the Nodes screens (URL <-> filters, hardware formatting, compare selection, health strip).2import type { Schemas } from "@/api/client";34export const SORT_KEYS = ["alias", "site", "role", "last_seen", "cpu", "memory", "disk"] as const;5export type SortKey = (typeof SORT_KEYS)[number];6const KINDS = ["mac", "linux", "nas"] as const;7const FRESHNESS = ["fresh", "stale", "offline"] as const;89export interface NodeFilters {10  q: string;11  site: string;12  role: string;13  tag: string;14  kind: "" | Schemas["NodeKind"];15  freshness: "" | Schemas["Freshness"];16  maintenance: "" | "true" | "false";17  retired: boolean;18  sort: SortKey;19  order: "asc" | "desc";20}2122export const DEFAULT_FILTERS: NodeFilters = { q: "", site: "", role: "", tag: "", kind: "", freshness: "", maintenance: "", retired: false, sort: "alias", order: "asc" };2324const oneOf = <T extends string>(list: readonly T[], v: string | null): T | "" => (v !== null && (list as readonly string[]).includes(v) ? (v as T) : "");2526export function parseFilters(p: { get: (k: string) => string | null }): NodeFilters {27  const m = p.get("maintenance");28  return {29    q: (p.get("q") ?? "").slice(0, 100),30    site: p.get("site") ?? "",31    role: p.get("role") ?? "",32    tag: p.get("tag") ?? "",33    kind: oneOf(KINDS, p.get("kind")),34    freshness: oneOf(FRESHNESS, p.get("freshness")),35    maintenance: m === "true" || m === "false" ? m : "",36    retired: p.get("retired") === "true",37    sort: oneOf(SORT_KEYS, p.get("sort")) || "alias",38    order: p.get("order") === "desc" ? "desc" : "asc",39  };40}4142/** Query string of the filters; defaults are omitted so the plain `/nodes` URL stays clean. */43export function filtersToSearch(f: NodeFilters, extra: Record<string, string> = {}): string {44  const out = new URLSearchParams();45  if (f.q.trim()) out.set("q", f.q.trim());46  for (const k of ["site", "role", "tag", "kind", "freshness", "maintenance"] as const) if (f[k]) out.set(k, f[k]);47  if (f.retired) out.set("retired", "true");48  if (f.sort !== "alias") out.set("sort", f.sort);49  if (f.order !== "asc") out.set("order", f.order);50  for (const [k, v] of Object.entries(extra)) if (v) out.set(k, v);51  const s = out.toString();52  return s ? `?${s}` : "";53}5455export function activeFilterCount(f: NodeFilters): number {56  return [f.q.trim(), f.site, f.role, f.tag, f.kind, f.freshness, f.maintenance, f.retired ? "x" : ""].filter(Boolean).length;57}5859/** Parameters of GET /nodes for the filters. */60export function filtersToQuery(f: NodeFilters, limit = 100) {61  return {62    limit,63    sort: f.sort,64    order: f.order,65    ...(f.q.trim() ? { q: f.q.trim() } : {}),66    ...(f.site ? { site: f.site } : {}),67    ...(f.role ? { role: f.role } : {}),68    ...(f.tag ? { tag: f.tag } : {}),69    ...(f.kind ? { kind: f.kind } : {}),70    ...(f.freshness ? { freshness: f.freshness } : {}),71    ...(f.maintenance ? { maintenance: f.maintenance === "true" } : {}),72    ...(f.retired ? { retired: true } : {}),73  };74}7576/** Distinct non-empty values, sorted; the currently selected value is kept even if no loaded row carries it. */77export function distinct(values: readonly (string | undefined)[], keep = ""): string[] {78  const set = new Set(values.filter((v): v is string => !!v));79  if (keep) set.add(keep);80  return [...set].sort((a, b) => a.localeCompare(b, undefined, { numeric: true, sensitivity: "base" }));81}8283/** CPU performance levels by their reported names, in reported order: "Super 2 · Performance 4 · Efficiency 6". */84export function formatPerfLevels(levels: readonly Schemas["CpuPerfLevel"][]): string {85  return levels.map((l) => `${l.name} ${l.cores}`).join(" · ");86}8788export const COMPARE_MIN = 2;89export const COMPARE_MAX = 12;90const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;9192/** Node ids of `/nodes/compare?ids=a,b,c`: valid UUIDs only, de-duplicated, at most 12. */93export function parseCompareIds(raw: string | null): string[] {94  const out: string[] = [];95  for (const part of (raw ?? "").split(",")) {96    const id = part.trim().toLowerCase();97    if (UUID.test(id) && !out.includes(id)) out.push(id);98    if (out.length === COMPARE_MAX) break;99  }100  return out;101}102103export function parseTags(text: string): string[] {104  return [...new Set(text.split(/[,\s]+/).map((s) => s.trim()).filter(Boolean))];105}106107export type HealthState = Schemas["HealthBucket"]["state"];108/** Bar height (0–1) per health state: with the colour and the label, shape also tells states apart. */109export const HEALTH_LEVEL: Record<HealthState, number> = { up: 1, maintenance: 0.75, degraded: 0.6, down: 0.3, unknown: 0.12 };110111export interface StripRect {112  x: number;113  y: number;114  w: number;115  h: number;116  state: HealthState;117  index: number;118}119/** Geometry of the health strip in a `width`×`height` viewBox, proportional to bucket durations. */120export function healthStrip(buckets: readonly Schemas["HealthBucket"][], width: number, height: number): StripRect[] {121  if (buckets.length === 0) return [];122  const t0 = Date.parse(buckets[0]?.start ?? "");123  const t1 = Date.parse(buckets[buckets.length - 1]?.end ?? "");124  const span = t1 - t0;125  if (!Number.isFinite(span) || span <= 0) return [];126  return buckets.map((b, index) => {127    const x = ((Date.parse(b.start) - t0) / span) * width;128    const w = Math.max(0.5, ((Date.parse(b.end) - Date.parse(b.start)) / span) * width - 0.4);129    const h = Math.max(2, HEALTH_LEVEL[b.state] * height);130    return { x, y: height - h, w, h, state: b.state, index };131  });132}133134export function healthCounts(buckets: readonly Schemas["HealthBucket"][]): Record<HealthState, number> {135  const out: Record<HealthState, number> = { up: 0, degraded: 0, down: 0, maintenance: 0, unknown: 0 };136  for (const b of buckets) out[b.state]++;137  return out;138}139140/** Usage percentage of a volume, when both figures were observed. */141export function usedPct(used: number | undefined, total: number | undefined): number | undefined {142  return used === undefined || total === undefined || total <= 0 ? undefined : (used / total) * 100;143}144145/** Splits metric series by metric name, keeping API order inside each group. */146export function groupByMetric(series: readonly Schemas["MetricSeries"][]): Map<string, Schemas["MetricSeries"][]> {147  const out = new Map<string, Schemas["MetricSeries"][]>();148  for (const s of series) {149    const list = out.get(s.metric);150    if (list) list.push(s);151    else out.set(s.metric, [s]);152  }153  return out;154}155
Files main
Menu

Theme