Repository Public
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