Files
Homelab-manager/web/src/pages/Secrets.tsx
T
bobbanandClaude Sonnet 5.5 12e9fee7af Accessibility sweep: colours, links, targets and names
An axe-core check of 37 pages in both themes found and fixed low-contrast text
in the status colours (light) and tabs, pills and the info alert (dark),
in-sentence links with no underline, link targets under 24 px, selects with no
name and map nodes whose name did not start with their text. docs/ACCESSIBILITY.md
says what was found and how to run the check again.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-10 21:52:00 +01:00

475 lines
18 KiB
TypeScript

import { useEffect, useMemo, useState } from "react";
import { useSearchParams } from "react-router-dom";
import { api, type CurrentUser, type SecretInput, type SecretRecord, type SecretStatus } from "../api/client";
import { downloadCsv } from "../utils/csv";
import { formatDateTime } from "../utils/date";
import { readableError } from "../utils/errors";
import { useSortable } from "../hooks/useSortable";
import SortableTh from "../components/SortableTh";
import { usePagination } from "../hooks/usePagination";
import Pagination from "../components/Pagination";
import { useSelection } from "../hooks/useSelection";
import { confirmDialog } from "../utils/dialogs";
import { ErrorNotice } from "../components/Notice";
import { toast } from "../utils/toast";
import TableToolbar from "../components/TableToolbar";
import { EmptyRow, LoadingRow } from "../components/EmptyState";
const TYPE_LABELS: Record<SecretRecord["type"], string> = {
api_token: "API Token",
ssl_certificate: "SSL Certificate",
password: "Password",
generic: "Generic",
};
const STATUS_BADGE: Record<SecretStatus, string> = {
ok: "bg-green-lt text-green",
expiring: "bg-yellow-lt text-yellow",
expired: "bg-red-lt text-red",
never: "bg-secondary-lt text-secondary",
};
const STATUS_LABEL: Record<SecretStatus, string> = {
ok: "ok",
expiring: "expiring",
expired: "expired",
never: "no expiry",
};
const emptyForm: SecretInput = {
name: "",
type: "generic",
description: "",
expiryDate: "",
warnDays: 30,
notes: "",
checkHost: "",
checkPort: 443,
};
export default function Secrets({ user }: { user: CurrentUser }) {
const canEdit = user.role === "admin" || user.role === "operator";
const [secrets, setSecrets] = useState<SecretRecord[] | null>(null);
const [error, setError] = useState<string | null>(null);
const [searchParams] = useSearchParams();
const [search, setSearch] = useState(() => searchParams.get("q") ?? "");
const [statusFilter, setStatusFilter] = useState<"all" | SecretStatus>("all");
const [editingId, setEditingId] = useState<number | null>(null);
const [form, setForm] = useState<SecretInput>(emptyForm);
const [saving, setSaving] = useState(false);
const [neverExpires, setNeverExpires] = useState(false);
const selection = useSelection<number>();
const [bulkDeleting, setBulkDeleting] = useState(false);
const [checkingId, setCheckingId] = useState<number | null>(null);
function load() {
api.secrets
.list()
.then((res) => {
setSecrets(res.secrets);
// Deep-link from global search (?editId=) — jump straight to that secret's edit form.
const editId = Number(searchParams.get("editId"));
const target = res.secrets.find((s) => s.id === editId);
if (target && canEdit) startEdit(target);
})
.catch((err) => setError(String(err)));
}
useEffect(load, []);
const filtered = useMemo(() => {
if (!secrets) return [];
return secrets.filter((s) => {
if (statusFilter !== "all" && s.status !== statusFilter) return false;
const q = search.trim().toLowerCase();
if (!q) return true;
return s.name.toLowerCase().includes(q) || (s.description ?? "").toLowerCase().includes(q);
});
}, [secrets, search, statusFilter]);
function startEdit(s: SecretRecord) {
setEditingId(s.id);
setNeverExpires(s.expiryDate === null);
setForm({
name: s.name,
type: s.type,
description: s.description ?? "",
expiryDate: s.expiryDate ?? "",
warnDays: s.warnDays,
notes: s.notes ?? "",
checkHost: s.checkHost ?? "",
checkPort: s.checkPort ?? 443,
});
}
function cancelEdit() {
setEditingId(null);
setNeverExpires(false);
setForm(emptyForm);
}
async function submit(e: React.FormEvent) {
e.preventDefault();
setError(null);
setSaving(true);
try {
// A host only means something for a certificate; when one is set the date comes from the live cert, so it isn't sent.
const host = form.type === "ssl_certificate" ? (form.checkHost ?? "").trim() : "";
const payload: SecretInput = {
...form,
expiryDate: host ? undefined : neverExpires ? null : form.expiryDate,
checkHost: host || null,
checkPort: host ? form.checkPort || 443 : null,
};
if (editingId) {
await api.secrets.update(editingId, payload);
toast.success(`Saved ${form.name}.`);
} else {
await api.secrets.create(payload);
toast.success(`Added ${form.name}.`);
}
cancelEdit();
load();
} catch (err) {
setError(readableError(err));
} finally {
setSaving(false);
}
}
async function checkNow(s: SecretRecord) {
setError(null);
setCheckingId(s.id);
try {
const res = await api.secrets.checkTls(s.id);
if (!res.result.ok) setError(`Couldn't read the certificate for "${s.name}": ${res.result.error}`);
load();
} catch (err) {
setError(readableError(err));
} finally {
setCheckingId(null);
}
}
async function remove(s: SecretRecord) {
if (!(await confirmDialog({ title: "Delete secret", message: `Delete secret "${s.name}"?`, confirmLabel: "Delete", danger: true }))) return;
setError(null);
try {
await api.secrets.remove(s.id);
toast.success(`Deleted ${s.name}.`);
load();
} catch (err) {
setError(err instanceof Error ? err.message : String(err));
}
}
async function bulkDelete() {
const ids = Array.from(selection.selected);
if (ids.length === 0) return;
if (!(await confirmDialog({ title: "Delete secrets", message: `Delete ${ids.length} secret${ids.length !== 1 ? "s" : ""}?`, confirmLabel: "Delete", danger: true }))) return;
setError(null);
setBulkDeleting(true);
try {
const results = await Promise.allSettled(ids.map((id) => api.secrets.remove(id)));
const failed = results.filter((r) => r.status === "rejected").length;
if (failed > 0) setError(`${failed} of ${ids.length} deletions failed.`);
selection.clear();
load();
} finally {
setBulkDeleting(false);
}
}
const { sorted, sortKey, sortDir, requestSort } = useSortable(filtered);
const { pageItems, page, setPage, pageCount, totalCount } = usePagination(sorted);
function exportCsv() {
downloadCsv(
"secrets.csv",
["Name", "Type", "Description", "Expiry Date", "Warn Days", "Status", "Days Left", "Notes", "Monitored Host"],
(sorted ?? []).map((s) => [
s.name,
TYPE_LABELS[s.type],
s.description ?? "",
s.expiryDate ?? "never expires",
s.warnDays,
STATUS_LABEL[s.status],
s.daysLeft ?? "",
s.notes ?? "",
s.checkHost ? `${s.checkHost}:${s.checkPort ?? 443}` : "",
]),
);
}
const monitoredInForm = form.type === "ssl_certificate" && !!(form.checkHost ?? "").trim();
return (
<>
<h2 className="page-title mb-3">Secrets</h2>
<ErrorNotice error={error} />
{canEdit && (
<div className="card mb-3">
<div className="card-header">
<h3 className="card-title">{editingId ? "Edit secret" : "Add a secret"}</h3>
</div>
<form onSubmit={submit}>
<div className="card-body row g-3">
<div className="col-md-4">
<label className="form-label">Name</label>
<input
className="form-control"
required
value={form.name}
onChange={(e) => setForm({ ...form, name: e.target.value })}
/>
</div>
<div className="col-md-3">
<label className="form-label">Type</label>
<select
className="form-select"
value={form.type}
onChange={(e) => setForm({ ...form, type: e.target.value as SecretInput["type"] })}
>
{Object.entries(TYPE_LABELS).map(([value, label]) => (
<option key={value} value={value}>
{label}
</option>
))}
</select>
</div>
<div className="col-md-2">
<label className="form-label">Expiry date</label>
<input
type="date"
className="form-control"
required={!monitoredInForm && !neverExpires}
disabled={monitoredInForm || neverExpires}
value={neverExpires ? "" : (form.expiryDate ?? "")}
onChange={(e) => setForm({ ...form, expiryDate: e.target.value })}
/>
{monitoredInForm ? (
<div className="form-hint">Read from the live certificate.</div>
) : (
<label className="form-check mt-2 mb-0">
<input
type="checkbox"
className="form-check-input"
checked={neverExpires}
onChange={(e) => setNeverExpires(e.target.checked)}
/>
<span className="form-check-label">Never expires</span>
</label>
)}
</div>
{form.type === "ssl_certificate" && (
<>
<div className="col-md-4">
<label className="form-label">Auto-check host (optional)</label>
<input
className="form-control"
placeholder="nas.example.lan"
value={form.checkHost ?? ""}
onChange={(e) => setForm({ ...form, checkHost: e.target.value })}
/>
<div className="form-hint">Connects over TLS and reads the certificate's real expiry, checked daily.</div>
</div>
<div className="col-md-2">
<label className="form-label">Port</label>
<input
type="number"
min={1}
max={65535}
className="form-control"
disabled={!monitoredInForm}
value={form.checkPort ?? 443}
onChange={(e) => setForm({ ...form, checkPort: Number(e.target.value) })}
/>
</div>
</>
)}
<div className="col-md-3">
<label className="form-label">Warn (days before)</label>
<input
type="number"
min={0}
className="form-control"
disabled={neverExpires && !monitoredInForm}
value={form.warnDays}
onChange={(e) => setForm({ ...form, warnDays: Number(e.target.value) })}
/>
</div>
<div className="col-md-6">
<label className="form-label">Description</label>
<input
className="form-control"
value={form.description}
onChange={(e) => setForm({ ...form, description: e.target.value })}
/>
</div>
<div className="col-md-6">
<label className="form-label">Notes</label>
<input
className="form-control"
value={form.notes}
onChange={(e) => setForm({ ...form, notes: e.target.value })}
/>
</div>
</div>
<div className="card-footer d-flex gap-2">
<button type="submit" className="btn btn-primary" disabled={saving}>
{editingId ? "Save changes" : "Add secret"}
</button>
{editingId && (
<button type="button" className="btn" onClick={cancelEdit}>
Cancel
</button>
)}
</div>
</form>
</div>
)}
<div className="card">
<TableToolbar
search={search}
onSearch={setSearch}
placeholder="Search name or description…"
filters={
<select
className="form-select form-select-sm w-auto"
aria-label="Status"
value={statusFilter}
onChange={(e) => setStatusFilter(e.target.value as typeof statusFilter)}
>
<option value="all">All statuses</option>
<option value="ok">OK</option>
<option value="expiring">Expiring</option>
<option value="expired">Expired</option>
<option value="never">No expiry</option>
</select>
}
shown={filtered.length}
total={secrets?.length}
onExport={exportCsv}
/>
{canEdit && selection.count > 0 && (
<div className="card-header bg-blue-lt d-flex align-items-center gap-2">
<span>{selection.count} selected</span>
<button className="btn btn-sm btn-outline-danger" onClick={bulkDelete} disabled={bulkDeleting}>
{bulkDeleting ? "Deleting…" : "Delete selected"}
</button>
<button className="btn btn-sm btn-link" onClick={selection.clear}>
Clear selection
</button>
</div>
)}
<div className="table-responsive">
<table className="table table-vcenter card-table">
<thead>
<tr>
{canEdit && (
<th className="w-1">
<input
type="checkbox"
className="form-check-input m-0"
checked={(pageItems ?? []).length > 0 && (pageItems ?? []).every((s) => selection.isSelected(s.id))}
onChange={() => selection.toggleAll((pageItems ?? []).map((s) => s.id))}
/>
</th>
)}
<SortableTh<SecretRecord> label="Name" sortKeyName="name" activeKey={sortKey} direction={sortDir} onSort={requestSort} />
<SortableTh<SecretRecord> label="Type" sortKeyName="type" activeKey={sortKey} direction={sortDir} onSort={requestSort} />
<SortableTh<SecretRecord>
label="Expiry"
sortKeyName="expiryDate"
activeKey={sortKey}
direction={sortDir}
onSort={requestSort}
/>
<SortableTh<SecretRecord>
label="Days left"
sortKeyName="daysLeft"
activeKey={sortKey}
direction={sortDir}
onSort={requestSort}
/>
<SortableTh<SecretRecord> label="Status" sortKeyName="status" activeKey={sortKey} direction={sortDir} onSort={requestSort} />
<SortableTh<SecretRecord>
label="Description"
sortKeyName="description"
activeKey={sortKey}
direction={sortDir}
onSort={requestSort}
/>
{canEdit && <th className="w-1">Actions</th>}
</tr>
</thead>
<tbody>
{(pageItems ?? []).map((s) => (
<tr key={s.id}>
{canEdit && (
<td>
<input
type="checkbox"
className="form-check-input m-0"
checked={selection.isSelected(s.id)}
onChange={() => selection.toggle(s.id)}
/>
</td>
)}
<td>{s.name}</td>
<td>{TYPE_LABELS[s.type]}</td>
<td>
{s.expiryDate ?? <span className="text-secondary">Never</span>}
{s.checkHost && (
<span
className="badge bg-cyan-lt ms-2"
title={`Read from ${s.checkHost}:${s.checkPort ?? 443}${s.lastCheckedAt ? ` — checked ${formatDateTime(new Date(s.lastCheckedAt))}` : ""}`}
>
Auto
</span>
)}
{s.lastCheckError && (
<span className="badge bg-red-lt text-red ms-1" title={`${s.lastCheckError} — showing the last known date`}>
Check failed
</span>
)}
</td>
<td>{s.daysLeft === null ? "—" : s.daysLeft < 0 ? `${Math.abs(s.daysLeft)}d ago` : `${s.daysLeft}d`}</td>
<td>
<span className={`badge ${STATUS_BADGE[s.status]}`}>{STATUS_LABEL[s.status]}</span>
</td>
<td className="text-secondary">{s.description ?? "—"}</td>
{canEdit && (
<td>
<div className="btn-list flex-nowrap">
{s.checkHost && (
<button className="btn btn-sm" onClick={() => checkNow(s)} disabled={checkingId === s.id}>
{checkingId === s.id ? "Checking…" : "Check now"}
</button>
)}
<button className="btn btn-sm" onClick={() => startEdit(s)}>
Edit
</button>
<button className="btn btn-sm btn-outline-danger" onClick={() => remove(s)}>
Delete
</button>
</div>
</td>
)}
</tr>
))}
{secrets === null && <LoadingRow colSpan={canEdit ? 8 : 6} />}
{secrets !== null && (sorted ?? []).length === 0 && (
<EmptyRow colSpan={canEdit ? 8 : 6} title="No secrets tracked yet" hint="Track an API token, a certificate or a password that expires, and you are warned before it does. The form is at the top of this page." filtered={secrets && secrets.length > 0 ? () => { setSearch(""); setStatusFilter("all"); } : undefined} />
)}
</tbody>
</table>
</div>
<Pagination page={page} pageCount={pageCount} totalCount={totalCount} onPageChange={setPage} />
</div>
</>
);
}