Repository Public
1"use client";2import Link from "next/link";3import { useQueryClient } from "@tanstack/react-query";4import { usePathname, useRouter, useSearchParams } from "next/navigation";5import { Suspense, useEffect, useMemo, useRef, useState } from "react";6import { apiPost, type Schemas } from "@/api/client";7import { ApiError } from "@/api/errors";8import { invalidatePaths, useApiList, useApiQuery } from "@/api/query";9import { useI18n } from "@/i18n";10import { usePref } from "@/lib/prefs";11import { Page, RequirePermission } from "@/shell/AppShell";12import { useSession } from "@/shell/session";13import { Banner, Button, Checkbox, Count, DataStamp, DataTable, Dialog, EmptyState, ErrorState, LinkButton, LoadMore, Segmented, SelectField, SkeletonRows, Sparkline, Tag, TextField, Unmeasured, useErrorMessage, useToast, type Column } from "@/ui";14import { COMPARE_MAX, COMPARE_MIN, DEFAULT_FILTERS, SORT_KEYS, activeFilterCount, distinct, filtersToQuery, filtersToSearch, parseFilters, parseTags, type NodeFilters, type SortKey } from "./logic";15import { HeadlinePct, LastContact, NodeState } from "./parts";1617type Node = Schemas["Node"];1819export function NodesScreen() {20 return (21 <RequirePermission permission="nodes.read">22 <Suspense fallback={null}>23 <NodesInner />24 </Suspense>25 </RequirePermission>26 );27}2829function NodesInner() {30 const { t, tn } = useI18n();31 const router = useRouter();32 const pathname = usePathname();33 const params = useSearchParams();34 const session = useSession();35 const filters = useMemo(() => parseFilters(params), [params]);36 const [view, setView] = usePref<"table" | "grid">("nodes.view", "table");37 const [selected, setSelected] = useState<Set<string>>(new Set());38 const [creating, setCreating] = useState(false);3940 const apply = (patch: Partial<NodeFilters>) => router.replace(`${pathname}${filtersToSearch({ ...filters, ...patch })}`, { scroll: false });4142 // search box: local text, pushed to the URL after a short pause43 const [text, setText] = useState(filters.q);44 const lastPushed = useRef(filters.q);45 useEffect(() => {46 if (text.trim() === lastPushed.current) return;47 const id = window.setTimeout(() => {48 lastPushed.current = text.trim();49 router.replace(`${pathname}${filtersToSearch({ ...parseFilters(new URLSearchParams(window.location.search)), q: text })}`, { scroll: false });50 }, 300);51 return () => window.clearTimeout(id);52 }, [text, pathname, router]);5354 const list = useApiList("/nodes", { query: filtersToQuery(filters) }, { refetchInterval: 60_000 });55 const nodes = list.items;56 const sites = distinct(nodes.map((n) => n.site), filters.site);57 const roles = distinct(nodes.map((n) => n.role), filters.role);58 const tags = distinct(nodes.flatMap((n) => n.tags), filters.tag);59 const active = activeFilterCount(filters);60 const opt = (values: string[], all: string) => [{ value: "", label: all }, ...values.map((v) => ({ value: v, label: v }))];6162 const toggle = (id: string, on: boolean) => {63 const next = new Set(selected);64 if (on) next.add(id);65 else next.delete(id);66 setSelected(next);67 };68 const canCompare = selected.size >= COMPARE_MIN && selected.size <= COMPARE_MAX;6970 const columns: Column<Node>[] = [71 { id: "state", header: t("common.state"), cell: (n) => <span data-testid={`node-row-${n.alias}`}><NodeState node={n} /></span>, shrink: true },72 { id: "alias", header: t("nodes.col.alias"), cell: (n) => <Link href={`/nodes/${n.id}`} className="rowlink mono">{n.alias}</Link> },73 { id: "kind", header: t("nodes.col.kind"), cell: (n) => t(`states.nodeKind.${n.kind}`), hide: "md" },74 { id: "site", header: t("nodes.col.site"), cell: (n) => n.site || <span className="faint">{t("nodes.unset")}</span>, hide: "md" },75 { id: "role", header: t("nodes.col.role"), cell: (n) => n.role || <span className="faint">{t("nodes.unset")}</span>, hide: "md" },76 { id: "tags", header: t("nodes.col.tags"), cell: (n) => (n.tags.length ? <span className="nodes-tags">{n.tags.map((x) => <Tag key={x}>{x}</Tag>)}</span> : <span className="faint">{t("nodes.unset")}</span>), hide: "md" },77 { id: "chip", header: t("nodes.col.hardware"), cell: (n) => (n.chip || n.model ? <span className="truncate">{[n.chip, n.model].filter(Boolean).join(" · ")}</span> : <Unmeasured availability="not_observed" />), hide: "md" },78 { id: "cpu", header: t("nodes.col.cpu"), cell: (n) => <HeadlinePct value={n.headline?.cpu_usage_pct} label={t("nodes.col.cpu")} /> },79 { id: "load", header: t("nodes.col.load"), align: "right", cell: (n) => (n.headline?.load1 === undefined ? <Unmeasured availability="not_observed" /> : <NodeLoad value={n.headline.load1} />), hide: "sm" },80 { id: "mem", header: t("nodes.col.memory"), cell: (n) => <HeadlinePct value={n.headline?.mem_used_pct} label={t("nodes.col.memory")} />, hide: "sm" },81 { id: "disk", header: t("nodes.col.disk"), cell: (n) => <HeadlinePct value={n.headline?.disk_used_pct} label={t("nodes.col.disk")} />, hide: "md" },82 { id: "alerts", header: t("nodes.col.alerts"), align: "right", cell: (n) => (n.open_alerts === undefined ? <Unmeasured availability="not_observed" /> : n.open_alerts > 0 ? <Link href={`/alerts?node_id=${n.id}`} aria-label={tn("nodes.openAlerts", n.open_alerts)}><Count value={n.open_alerts} tone="warning" /></Link> : <span className="faint num">0</span>), hide: "sm" },83 { id: "seen", header: t("nodes.col.lastContact"), cell: (n) => <LastContact at={n.last_seen_at} /> },84 { id: "agent", header: t("nodes.col.agent"), cell: (n) => (n.agent_version ? n.agent_version : <span className="faint">{t("nodes.noAgent")}</span>), mono: true, hide: "md" },85 ];8687 const emptyAll = list.ready && nodes.length === 0 && active === 0;8889 return (90 <Page91 title={t("nodes.title")}92 sub={t("nodes.sub")}93 actions={94 <>95 <DataStamp at={list.updatedAt || undefined} />96 {session.can("nodes.write") ? <Button icon="plus" onClick={() => setCreating(true)} data-testid="nodes-register">{t("nodes.register.open")}</Button> : null}97 </>98 }99 >100 <div data-testid="screen-nodes" className="stack-lg">101 <div className="nodes-filters" role="search" aria-label={t("nodes.filters.label")}>102 <TextField label={t("nodes.filters.search")} hideLabel placeholder={t("nodes.filters.search")} icon="search" type="search" value={text} onChange={setText} data-testid="nodes-search" />103 <SelectField label={t("nodes.col.site")} value={filters.site} onChange={(site) => apply({ site })} options={opt(sites, t("nodes.filters.allSites"))} />104 <SelectField label={t("nodes.col.role")} value={filters.role} onChange={(role) => apply({ role })} options={opt(roles, t("nodes.filters.allRoles"))} />105 <SelectField label={t("nodes.col.tags")} value={filters.tag} onChange={(tag) => apply({ tag })} options={opt(tags, t("nodes.filters.allTags"))} />106 <SelectField label={t("nodes.col.kind")} value={filters.kind} onChange={(kind) => apply({ kind })} options={[{ value: "", label: t("nodes.filters.allKinds") }, { value: "mac", label: t("states.nodeKind.mac") }, { value: "linux", label: t("states.nodeKind.linux") }, { value: "nas", label: t("states.nodeKind.nas") }]} />107 <SelectField label={t("nodes.filters.freshness")} value={filters.freshness} onChange={(freshness) => apply({ freshness })} options={[{ value: "", label: t("nodes.filters.anyFreshness") }, { value: "fresh", label: t("states.freshness.fresh") }, { value: "stale", label: t("states.freshness.stale") }, { value: "offline", label: t("states.freshness.offline") }]} data-testid="nodes-filter-freshness" />108 <SelectField label={t("nodes.filters.maintenance")} value={filters.maintenance} onChange={(maintenance) => apply({ maintenance })} options={[{ value: "", label: t("common.all") }, { value: "true", label: t("nodes.filters.inMaintenance") }, { value: "false", label: t("nodes.filters.notInMaintenance") }]} />109 <SelectField label={t("nodes.filters.sort")} value={filters.sort} onChange={(sort) => apply({ sort })} options={SORT_KEYS.map((k: SortKey) => ({ value: k, label: t(`nodes.sort.${k}`) }))} data-testid="nodes-sort" />110 <div className="mcc-field">111 <span className="mcc-label" aria-hidden="true">{t("nodes.filters.order")}</span>112 <Segmented label={t("nodes.filters.order")} value={filters.order} onChange={(order) => apply({ order })} options={[{ value: "asc", label: t("nodes.filters.asc"), icon: "sort-asc" }, { value: "desc", label: t("nodes.filters.desc"), icon: "sort-desc" }]} />113 </div>114 <Checkbox label={t("nodes.filters.retired")} checked={filters.retired} onChange={(retired) => apply({ retired })} />115 </div>116117 <div className="row-between nodes-bar">118 <div className="row-wrap" role="status" aria-live="polite">119 <span className="muted" data-testid="nodes-count">{list.ready ? tn("nodes.count", nodes.length) : t("common.loading")}{list.hasMore ? ` ${t("nodes.morePages")}` : ""}</span>120 {active > 0 ? <Button size="sm" variant="ghost" icon="close" onClick={() => { setText(""); lastPushed.current = ""; apply({ ...DEFAULT_FILTERS, sort: filters.sort, order: filters.order }); }}>{tn("nodes.filters.clear", active)}</Button> : null}121 {selected.size > 0 ? <span>{tn("nodes.selected", selected.size)}</span> : null}122 </div>123 <div className="row-wrap">124 {selected.size > 0 ? <Button size="sm" variant="ghost" onClick={() => setSelected(new Set())}>{t("nodes.clearSelection")}</Button> : null}125 <Button icon="chart" variant={canCompare ? "primary" : "secondary"} disabled={!canCompare} aria-describedby="nodes-compare-hint" onClick={() => router.push(`/nodes/compare?ids=${[...selected].join(",")}`)} data-testid="nodes-compare">{t("nodes.compare.open")}</Button>126 <span id="nodes-compare-hint" className="sr-only">{t("nodes.compare.hint", { min: COMPARE_MIN, max: COMPARE_MAX })}</span>127 <Segmented label={t("nodes.view.label")} value={view} onChange={setView} options={[{ value: "table", label: t("nodes.view.table"), icon: "table" }, { value: "grid", label: t("nodes.view.grid"), icon: "grid" }]} />128 </div>129 </div>130 {selected.size > COMPARE_MAX ? <Banner tone="warning">{t("nodes.compare.hint", { min: COMPARE_MIN, max: COMPARE_MAX })}</Banner> : null}131132 {list.error && !list.ready ? <ErrorState error={list.error} onRetry={list.refetch} /> : null}133 {list.error && list.ready ? <Banner tone="stale">{t("ui.stale.refetchFailed")}</Banner> : null}134 {!list.ready && !list.error ? <SkeletonRows rows={8} /> : null}135 {emptyAll ? (136 <EmptyState icon="nodes" title={t("nodes.empty.title")}137 actions={<>138 {session.can("agents.manage") ? <LinkButton href="/settings/agents" variant="primary" icon="plus">{t("nodes.empty.enroll")}</LinkButton> : null}139 {session.can("nodes.write") ? <Button onClick={() => setCreating(true)}>{t("nodes.register.open")}</Button> : null}140 </>}>141 {t("nodes.empty.body")} {session.can("agents.manage") ? "" : t("nodes.empty.askAdmin")}142 </EmptyState>143 ) : null}144 {list.ready && !emptyAll ? (145 view === "table" ? (146 <DataTable caption={t("nodes.title")} columns={columns} rows={nodes} rowKey={(n) => n.id} selected={selected} onSelectedChange={setSelected} selectLabel={(n) => t("nodes.select", { alias: n.alias })} empty={<span className="muted" data-testid="nodes-no-match">{t("nodes.noMatch")}</span>} />147 ) : nodes.length === 0 ? (148 <EmptyState compact icon="filter" title={t("nodes.noMatch")} />149 ) : (150 <ul className="nodes-grid" aria-label={t("nodes.title")}>151 {nodes.map((n) => <NodeCard key={n.id} node={n} spark={nodes.length <= 60} selected={selected.has(n.id)} onSelect={(on) => toggle(n.id, on)} />)}152 </ul>153 )154 ) : null}155 <LoadMore hasMore={list.hasMore} loading={list.loadingMore} onMore={list.loadMore} />156 </div>157 {creating ? <RegisterDialog onClose={() => setCreating(false)} /> : null}158 </Page>159 );160}161162function NodeLoad({ value }: { value: number }) {163 const { fmt } = useI18n();164 return <span className="num">{fmt.number(value, 2)}</span>;165}166167function NodeCard({ node: n, spark, selected, onSelect }: { node: Node; spark: boolean; selected: boolean; onSelect: (on: boolean) => void }) {168 const { t, fmt } = useI18n();169 return (170 <li className="nodes-card" data-testid={`node-card-${n.alias}`} data-selected={selected}>171 <div className="row-between">172 <Link href={`/nodes/${n.id}`} className="nodes-card-alias mono">{n.alias}</Link>173 <Checkbox label={<span className="sr-only">{t("nodes.select", { alias: n.alias })}</span>} checked={selected} onChange={onSelect} />174 </div>175 <NodeState node={n} subtle />176 <div className="muted truncate">{[n.chip, n.model].filter(Boolean).join(" · ") || t(`states.nodeKind.${n.kind}`)}{n.site ? ` · ${n.site}` : ""}</div>177 {spark ? <CpuSpark id={n.id} alias={n.alias} /> : null}178 <dl className="nodes-card-metrics">179 <div><dt className="caps">{t("nodes.col.cpu")}</dt><dd><HeadlinePct value={n.headline?.cpu_usage_pct} label={t("nodes.col.cpu")} /></dd></div>180 <div><dt className="caps">{t("nodes.col.memory")}</dt><dd><HeadlinePct value={n.headline?.mem_used_pct} label={t("nodes.col.memory")} /></dd></div>181 <div><dt className="caps">{t("nodes.col.load")}</dt><dd>{n.headline?.load1 === undefined ? <Unmeasured availability="not_observed" /> : <span className="num">{fmt.number(n.headline.load1, 2)}</span>}</dd></div>182 <div><dt className="caps">{t("nodes.col.lastContact")}</dt><dd><LastContact at={n.last_seen_at} /></dd></div>183 </dl>184 </li>185 );186}187188/** CPU usage of the last hour as a sparkline (grid view only; one light request per card, cached a minute). */189function CpuSpark({ id, alias }: { id: string; alias: string }) {190 const { t } = useI18n();191 const q = useApiQuery("/nodes/{id}/metrics", { path: { id }, query: { metrics: ["cpu.usage"] } }, { staleTime: 60_000, refetchInterval: 120_000 });192 const points = q.data?.series[0]?.points ?? [];193 if (q.isError || (q.data && points.length < 2)) return <div className="nodes-card-spark"><Unmeasured availability={q.error?.notImplemented ? "unavailable" : "not_observed"} reason={t("nodes.sparkNone")} /></div>;194 return <div className="nodes-card-spark"><Sparkline points={points} label={t("nodes.sparkLabel", { alias })} min={0} max={100} /></div>;195}196197function RegisterDialog({ onClose }: { onClose: () => void }) {198 const { t } = useI18n();199 const qc = useQueryClient();200 const toast = useToast();201 const explain = useErrorMessage();202 const router = useRouter();203 const [alias, setAlias] = useState("");204 const [kind, setKind] = useState<Schemas["NodeKind"]>("mac");205 const [site, setSite] = useState("");206 const [role, setRole] = useState("");207 const [environment, setEnvironment] = useState("");208 const [tags, setTags] = useState("");209 const [busy, setBusy] = useState(false);210 const [aliasError, setAliasError] = useState<string | undefined>();211 const [failure, setFailure] = useState<string | null>(null);212213 const submit = async () => {214 if (alias.trim() === "") { setAliasError(t("ui.schema.required", { limit: "" })); return; }215 setBusy(true);216 setAliasError(undefined);217 setFailure(null);218 try {219 const tagList = parseTags(tags);220 const node = await apiPost("/nodes", { body: { alias: alias.trim(), kind, ...(site.trim() ? { site: site.trim() } : {}), ...(role.trim() ? { role: role.trim() } : {}), ...(environment.trim() ? { environment: environment.trim() } : {}), ...(tagList.length ? { tags: tagList } : {}) } });221 toast({ tone: "ok", title: t("nodes.register.done", { alias: node.alias }) });222 await invalidatePaths(qc, "/nodes", "/cluster/overview");223 onClose();224 router.push(`/nodes/${node.id}`);225 } catch (e) {226 setBusy(false);227 if (e instanceof ApiError && e.code === "conflict") setAliasError(t("nodes.register.aliasTaken"));228 else { const m = explain(e); setFailure([m.title, m.detail].filter(Boolean).join(" — ")); }229 }230 };231 return (232 <Dialog open onClose={onClose} title={t("nodes.register.title")} description={t("nodes.register.body")} dismissable={!busy}233 footer={<><Button onClick={onClose} disabled={busy}>{t("common.cancel")}</Button><Button variant="primary" loading={busy} onClick={() => void submit()} data-testid="nodes-register-submit">{t("nodes.register.submit")}</Button></>}>234 <form className="mcc-form" onSubmit={(e) => { e.preventDefault(); void submit(); }}>235 <div className="mcc-form-row">236 <TextField label={t("nodes.col.alias")} required mono value={alias} onChange={setAlias} error={aliasError} autoCapitalize="none" spellCheck={false} maxLength={64} />237 <SelectField label={t("nodes.col.kind")} value={kind} onChange={setKind} options={[{ value: "mac", label: t("states.nodeKind.mac") }, { value: "linux", label: t("states.nodeKind.linux") }, { value: "nas", label: t("states.nodeKind.nas") }]} />238 </div>239 <div className="mcc-form-row">240 <TextField label={t("nodes.col.site")} value={site} onChange={setSite} maxLength={64} />241 <TextField label={t("nodes.col.role")} value={role} onChange={setRole} maxLength={64} />242 </div>243 <div className="mcc-form-row">244 <TextField label={t("nodes.field.environment")} value={environment} onChange={setEnvironment} maxLength={32} />245 <TextField label={t("nodes.col.tags")} hint={t("nodes.field.tagsHint")} value={tags} onChange={setTags} mono />246 </div>247 {failure ? <Banner tone="critical" role="alert">{failure}</Banner> : null}248 </form>249 </Dialog>250 );251}252