refactor(admin): unify webui fetch/copy/format helpers; fix audit tab load and delete-group count

- apiFetch + shared needLogin (any 401 shows the login card) replaces six
  duplicated fetch/401/error-handling blocks in the admin composables
- useCopy composable: clipboard + execCommand fallback with timed reset,
  used by MembersPanel and WebhookPanel
- utils/format.ts (fmtTime/splitList/parseMatch) removes inline duplicates
  across SendLogs, AuditLog, RouteEditor and GroupEditor
- fix: load the audit log when the audit tab becomes active (client-side
  navigation never remounted the page, leaving the list empty on first visit)
- fix: fetch the real route count for a group before confirming deletion
  instead of reusing the currently open group's route list
This commit is contained in:
RhenCloud 2026-08-14 07:18:55 +08:00
parent c438fe96dc
commit e59b10f739
No known key found for this signature in database
GPG key ID: A574A617378C4E0B
16 changed files with 137 additions and 202 deletions

View file

@ -70,10 +70,6 @@ const emit = defineEmits<{
(e: "update:selectedGroupId", value: string): void; (e: "update:selectedGroupId", value: string): void;
}>(); }>();
function fmtTime(ts: number): string {
return new Date(ts).toLocaleString();
}
function refresh(): void { function refresh(): void {
emit("refresh"); emit("refresh");
} }

View file

@ -311,9 +311,18 @@ onMounted(() => {
} }
loadGroups(); loadGroups();
loadLogs(50, logFilterGroup.value || undefined); loadLogs(50, logFilterGroup.value || undefined);
if (view.value === "audit") loadAudit(50, auditFilterGroup.value || undefined);
}); });
// Tab switches are client-side navigations (no remount), so load the audit
// log whenever the audit view becomes active including direct deep links.
watch(
view,
(v) => {
if (v === "audit") loadAudit(50, auditFilterGroup.value || undefined);
},
{ immediate: true },
);
function switchView(next: "groups" | "logs" | "audit"): void { function switchView(next: "groups" | "logs" | "audit"): void {
const path = next === "groups" ? "/admin" : `/admin/${next}`; const path = next === "groups" ? "/admin" : `/admin/${next}`;
if (route.path !== path) router.replace(path); if (route.path !== path) router.replace(path);
@ -469,7 +478,17 @@ async function onSaveGroup(group: Group): Promise<void> {
} }
async function onDeleteGroup(group: Group): Promise<void> { async function onDeleteGroup(group: Group): Promise<void> {
const used = groupRoutes.value.filter((r) => r.groupId === group.id).length; // Fetch the real route count for this group instead of relying on the
// routes of whichever group happens to be open in the detail view.
let used = 0;
try {
const data = await apiFetch<{ routes?: Route[] }>(
`/admin/api/groups/${encodeURIComponent(group.id)}/routes`,
);
used = (data.routes ?? []).length;
} catch {
// Count is best-effort; proceed without the warning.
}
const warn = used ? t("confirm.deleteGroupWarn", { n: used }) : ""; const warn = used ? t("confirm.deleteGroupWarn", { n: used }) : "";
if (!window.confirm(t("confirm.deleteGroup", { name: group.name || group.id }) + warn)) return; if (!window.confirm(t("confirm.deleteGroup", { name: group.name || group.id }) + warn)) return;
try { try {

View file

@ -216,13 +216,6 @@ const form = reactive({
logTopicId: "", logTopicId: "",
}); });
function splitList(text: string): string[] {
return text
.split(",")
.map((s) => s.trim())
.filter(Boolean);
}
function toggleProvider(p: "github" | "gitea", e: Event): void { function toggleProvider(p: "github" | "gitea", e: Event): void {
const checked = (e.target as HTMLInputElement).checked; const checked = (e.target as HTMLInputElement).checked;
form.providers = checked form.providers = checked

View file

@ -72,7 +72,7 @@
<span class="role-pill" :class="inv.role">{{ t("roles." + inv.role) }}</span> <span class="role-pill" :class="inv.role">{{ t("roles." + inv.role) }}</span>
<span class="invite-exp">{{ fmtExp(inv.expiresAt) }}</span> <span class="invite-exp">{{ fmtExp(inv.expiresAt) }}</span>
<button class="btn btn-ghost btn-sm" @click="copyInvite(inv)"> <button class="btn btn-ghost btn-sm" @click="copyInvite(inv)">
{{ copiedToken === inv.token ? t("members.copied") : t("members.copyLink") }} {{ copied === inv.token ? t("members.copied") : t("members.copyLink") }}
</button> </button>
<button class="icon-btn danger" @click="revoke(inv)">{{ t("members.revoke") }}</button> <button class="icon-btn danger" @click="revoke(inv)">{{ t("members.revoke") }}</button>
</li> </li>
@ -101,8 +101,8 @@ const newLogin = ref("");
const newRole = ref<GroupRole>("admin"); const newRole = ref<GroupRole>("admin");
const inviteRole = ref<"admin" | "viewer">("admin"); const inviteRole = ref<"admin" | "viewer">("admin");
const inviting = ref(false); const inviting = ref(false);
const copiedToken = ref("");
const formError = ref(""); const formError = ref("");
const { copied, copy } = useCopy(2000);
watch( watch(
() => props.group, () => props.group,
@ -175,11 +175,7 @@ async function createInvite(): Promise<void> {
...invites.value, ...invites.value,
]; ];
} }
copyText(`${window.location.origin}${url}`); copy(`${window.location.origin}${url}`, token);
copiedToken.value = token;
window.setTimeout(() => {
copiedToken.value = "";
}, 2000);
await loadInvites(); await loadInvites();
} catch (err) { } catch (err) {
formError.value = err instanceof Error ? err.message : String(err); formError.value = err instanceof Error ? err.message : String(err);
@ -190,11 +186,7 @@ async function createInvite(): Promise<void> {
async function copyInvite(inv: GroupInvite): Promise<void> { async function copyInvite(inv: GroupInvite): Promise<void> {
const url = `${window.location.origin}/admin/invite?token=${inv.token}`; const url = `${window.location.origin}/admin/invite?token=${inv.token}`;
copyText(url); await copy(url, inv.token);
copiedToken.value = inv.token;
window.setTimeout(() => {
copiedToken.value = "";
}, 2000);
} }
async function revoke(inv: GroupInvite): Promise<void> { async function revoke(inv: GroupInvite): Promise<void> {
@ -206,19 +198,6 @@ async function revoke(inv: GroupInvite): Promise<void> {
} }
} }
async function copyText(text: string): Promise<void> {
try {
await navigator.clipboard.writeText(text);
} catch {
const ta = document.createElement("textarea");
ta.value = text;
document.body.appendChild(ta);
ta.select();
document.execCommand("copy");
document.body.removeChild(ta);
}
}
function shortToken(token: string): string { function shortToken(token: string): string {
return token.slice(0, 8) + "…"; return token.slice(0, 8) + "…";
} }

View file

@ -210,15 +210,6 @@ const form = reactive({
filters: [] as FilterForm[], filters: [] as FilterForm[],
}); });
function parseMatch(text: string): string | string[] | null {
const parts = text
.split(",")
.map((s) => s.trim())
.filter(Boolean);
if (!parts.length) return null;
return parts.length === 1 ? parts[0]! : parts;
}
function blankFilter(): FilterForm { function blankFilter(): FilterForm {
return { type: "event", match: "", exclude: false, matchText: "" }; return { type: "event", match: "", exclude: false, matchText: "" };
} }

View file

@ -137,10 +137,6 @@ const detailRows = computed(() => {
return rows; return rows;
}); });
function fmtTime(ts: number): string {
return new Date(ts).toLocaleString();
}
function refresh(): void { function refresh(): void {
emit("refresh"); emit("refresh");
} }

View file

@ -12,7 +12,7 @@
<span class="wh-label">{{ t("webhook.url") }}</span> <span class="wh-label">{{ t("webhook.url") }}</span>
<code class="wh-value">{{ info.url }}</code> <code class="wh-value">{{ info.url }}</code>
<button class="btn btn-ghost btn-sm" @click="copy(info.url, 'url')"> <button class="btn btn-ghost btn-sm" @click="copy(info.url, 'url')">
{{ copiedUrl ? t("webhook.copied") : t("webhook.copy") }} {{ copied === "url" ? t("webhook.copied") : t("webhook.copy") }}
</button> </button>
</div> </div>
@ -26,7 +26,7 @@
class="btn btn-ghost btn-sm" class="btn btn-ghost btn-sm"
@click="copy(info.secret!, 'secret')" @click="copy(info.secret!, 'secret')"
> >
{{ copiedSecret ? t("webhook.copied") : t("webhook.copy") }} {{ copied === "secret" ? t("webhook.copied") : t("webhook.copy") }}
</button> </button>
</div> </div>
<p v-if="info.hasSecret && !info.secret" class="hint">{{ t("webhook.secretHidden") }}</p> <p v-if="info.hasSecret && !info.secret" class="hint">{{ t("webhook.secretHidden") }}</p>
@ -68,10 +68,9 @@ const props = defineProps<{ groupId: string; canEdit: boolean }>();
const api = useWebhookApi(); const api = useWebhookApi();
const info = ref<GroupWebhookInfo | null>(null); const info = ref<GroupWebhookInfo | null>(null);
const copiedUrl = ref(false);
const copiedSecret = ref(false);
const busy = ref(false); const busy = ref(false);
const error = ref(""); const error = ref("");
const { copied, copy } = useCopy();
const maskedSecret = "••••••••••••••••"; const maskedSecret = "••••••••••••••••";
const customExample = [ const customExample = [
@ -112,7 +111,6 @@ async function onRegenerate(): Promise<void> {
error.value = ""; error.value = "";
try { try {
info.value = await api.regenerate(props.groupId); info.value = await api.regenerate(props.groupId);
copiedSecret.value = false;
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); error.value = err instanceof Error ? err.message : String(err);
} finally { } finally {
@ -132,23 +130,4 @@ async function onDisable(): Promise<void> {
busy.value = false; busy.value = false;
} }
} }
async function copy(text: string, which: "url" | "secret"): Promise<void> {
try {
await navigator.clipboard.writeText(text);
if (which === "url") {
copiedUrl.value = true;
window.setTimeout(() => {
copiedUrl.value = false;
}, 1500);
} else {
copiedSecret.value = true;
window.setTimeout(() => {
copiedSecret.value = false;
}, 1500);
}
} catch {
// ignore clipboard failures
}
}
</script> </script>

30
app/composables/useApi.ts Normal file
View file

@ -0,0 +1,30 @@
/**
* Shared "session expired" flag: any 401 from the admin API flips it and the
* console swaps to the login card. One source of truth for every composable.
*/
export function useAuthState() {
const needLogin = useState<boolean>("wh-need-login", () => false);
return { needLogin };
}
/**
* JSON fetch for same-origin admin API calls: sends credentials, treats 401
* as "not logged in" (flips the shared flag and throws), and surfaces the
* server's `{ error }` message on failure.
*/
export async function apiFetch<T>(path: string, init?: RequestInit): Promise<T> {
const res = await fetch(path, {
credentials: "same-origin",
...init,
headers: { accept: "application/json", ...(init?.headers ?? {}) },
});
if (res.status === 401) {
useAuthState().needLogin.value = true;
throw new Error("unauthorized");
}
if (!res.ok) {
const data = (await res.json().catch(() => ({}))) as { error?: string };
throw new Error(data.error ?? `HTTP ${res.status}`);
}
return (await res.json()) as T;
}

View file

@ -1,9 +1,9 @@
import type { AuditEntry } from "~/types"; import type { AuditEntry } from "~/types";
export function useAuditApi() { export function useAuditApi() {
const { needLogin } = useAuthState();
const entries = ref<AuditEntry[]>([]); const entries = ref<AuditEntry[]>([]);
const loading = ref(false); const loading = ref(false);
const needLogin = ref(false);
const error = ref(""); const error = ref("");
async function load(limit = 50, groupId?: string): Promise<void> { async function load(limit = 50, groupId?: string): Promise<void> {
@ -13,19 +13,10 @@ export function useAuditApi() {
try { try {
let url = `/admin/api/audit?limit=${limit}`; let url = `/admin/api/audit?limit=${limit}`;
if (groupId) url += `&groupId=${encodeURIComponent(groupId)}`; if (groupId) url += `&groupId=${encodeURIComponent(groupId)}`;
const res = await fetch(url, { const data = await apiFetch<{ audit?: AuditEntry[] }>(url);
headers: { accept: "application/json" },
credentials: "same-origin",
});
if (res.status === 401) {
needLogin.value = true;
return;
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = (await res.json()) as { audit?: AuditEntry[] };
entries.value = data.audit ?? []; entries.value = data.audit ?? [];
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); if (!needLogin.value) error.value = err instanceof Error ? err.message : String(err);
} finally { } finally {
loading.value = false; loading.value = false;
} }

View file

@ -0,0 +1,33 @@
/**
* Clipboard helper with execCommand fallback and a "just copied" flag keyed
* by whatever identifies the copied value (a token, "url", "secret", ...).
* The flag resets after `duration` ms.
*/
export function useCopy(duration = 1500) {
const copied = ref("");
async function copy(text: string, key: string): Promise<void> {
try {
await navigator.clipboard.writeText(text);
} catch {
try {
const ta = document.createElement("textarea");
ta.value = text;
ta.style.position = "fixed";
ta.style.opacity = "0";
document.body.appendChild(ta);
ta.select();
document.execCommand("copy");
document.body.removeChild(ta);
} catch {
return;
}
}
copied.value = key;
window.setTimeout(() => {
if (copied.value === key) copied.value = "";
}, duration);
}
return { copied, copy };
}

View file

@ -1,9 +1,9 @@
import type { Route } from "~/types"; import type { Route } from "~/types";
export function useGroupRoutesApi() { export function useGroupRoutesApi() {
const { needLogin } = useAuthState();
const routes = ref<Route[]>([]); const routes = ref<Route[]>([]);
const loading = ref(false); const loading = ref(false);
const needLogin = ref(false);
const error = ref(""); const error = ref("");
async function load(groupId: string): Promise<void> { async function load(groupId: string): Promise<void> {
@ -11,39 +11,22 @@ export function useGroupRoutesApi() {
error.value = ""; error.value = "";
needLogin.value = false; needLogin.value = false;
try { try {
const res = await fetch(`/admin/api/groups/${encodeURIComponent(groupId)}/routes`, { const data = await apiFetch<{ routes?: Route[] }>(
headers: { accept: "application/json" }, `/admin/api/groups/${encodeURIComponent(groupId)}/routes`,
credentials: "same-origin", );
});
if (res.status === 401) {
needLogin.value = true;
return;
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = (await res.json()) as { routes?: Route[] };
routes.value = data.routes ?? []; routes.value = data.routes ?? [];
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); if (!needLogin.value) error.value = err instanceof Error ? err.message : String(err);
} finally { } finally {
loading.value = false; loading.value = false;
} }
} }
async function save(groupId: string, next: Route[]): Promise<void> { async function save(groupId: string, next: Route[]): Promise<void> {
const res = await fetch(`/admin/api/groups/${encodeURIComponent(groupId)}/routes`, { await apiFetch(`/admin/api/groups/${encodeURIComponent(groupId)}/routes`, {
method: "PUT", method: "PUT",
headers: { "content-type": "application/json" },
credentials: "same-origin",
body: JSON.stringify({ routes: next }), body: JSON.stringify({ routes: next }),
}); });
if (res.status === 401) {
needLogin.value = true;
throw new Error("unauthorized");
}
if (!res.ok) {
const data = (await res.json().catch(() => ({}))) as { error?: string };
throw new Error(data.error ?? `HTTP ${res.status}`);
}
routes.value = next; routes.value = next;
} }

View file

@ -1,12 +1,12 @@
import type { Group, GroupRole } from "~/types"; import type { Group, GroupRole } from "~/types";
export function useGroupsApi() { export function useGroupsApi() {
const { needLogin } = useAuthState();
const groups = ref<Group[]>([]); const groups = ref<Group[]>([]);
const isSuper = ref(false); const isSuper = ref(false);
/** groupId → role of the signed-in user (absent for super admins). */ /** groupId → role of the signed-in user (absent for super admins). */
const roles = ref<Record<string, GroupRole>>({}); const roles = ref<Record<string, GroupRole>>({});
const loading = ref(false); const loading = ref(false);
const needLogin = ref(false);
const error = ref(""); const error = ref("");
function roleOf(groupId: string): GroupRole | undefined { function roleOf(groupId: string): GroupRole | undefined {
@ -28,64 +28,35 @@ export function useGroupsApi() {
error.value = ""; error.value = "";
needLogin.value = false; needLogin.value = false;
try { try {
const res = await fetch("/admin/api/groups", { const data = await apiFetch<{
headers: { accept: "application/json" },
credentials: "same-origin",
});
if (res.status === 401) {
needLogin.value = true;
return;
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = (await res.json()) as {
groups?: Group[]; groups?: Group[];
isSuper?: boolean; isSuper?: boolean;
roles?: Record<string, GroupRole>; roles?: Record<string, GroupRole>;
}; }>("/admin/api/groups");
groups.value = data.groups ?? []; groups.value = data.groups ?? [];
isSuper.value = data.isSuper ?? false; isSuper.value = data.isSuper ?? false;
roles.value = data.roles ?? {}; roles.value = data.roles ?? {};
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); if (!needLogin.value) error.value = err instanceof Error ? err.message : String(err);
} finally { } finally {
loading.value = false; loading.value = false;
} }
} }
async function save(next: Group[]): Promise<void> { async function save(next: Group[]): Promise<void> {
const res = await fetch("/admin/api/groups", { await apiFetch("/admin/api/groups", {
method: "PUT", method: "PUT",
headers: { "content-type": "application/json" },
credentials: "same-origin",
body: JSON.stringify({ groups: next }), body: JSON.stringify({ groups: next }),
}); });
if (res.status === 401) {
needLogin.value = true;
throw new Error("unauthorized");
}
if (!res.ok) {
const data = (await res.json().catch(() => ({}))) as { error?: string };
throw new Error(data.error ?? `HTTP ${res.status}`);
}
groups.value = next; groups.value = next;
} }
/** Rename a group; routes, webhook secret and invites follow automatically. */ /** Rename a group; routes, webhook secret and invites follow automatically. */
async function rename(oldId: string, newId: string): Promise<void> { async function rename(oldId: string, newId: string): Promise<void> {
const res = await fetch(`/admin/api/groups/${encodeURIComponent(oldId)}/rename`, { await apiFetch(`/admin/api/groups/${encodeURIComponent(oldId)}/rename`, {
method: "PUT", method: "PUT",
headers: { "content-type": "application/json" },
credentials: "same-origin",
body: JSON.stringify({ newId }), body: JSON.stringify({ newId }),
}); });
if (res.status === 401) {
needLogin.value = true;
throw new Error("unauthorized");
}
if (!res.ok) {
const data = (await res.json().catch(() => ({}))) as { error?: string };
throw new Error(data.error ?? `HTTP ${res.status}`);
}
} }
return { return {

View file

@ -8,17 +8,10 @@ export function useInvitesApi() {
loading.value = true; loading.value = true;
error.value = ""; error.value = "";
try { try {
const res = await fetch(`/admin/api/groups/${encodeURIComponent(groupId)}/invites`, { const data = await apiFetch<{ url?: string }>(
method: "POST", `/admin/api/groups/${encodeURIComponent(groupId)}/invites`,
headers: { "content-type": "application/json" }, { method: "POST", body: JSON.stringify({ role }) },
credentials: "same-origin", );
body: JSON.stringify({ role }),
});
if (!res.ok) {
const data = (await res.json().catch(() => ({}))) as { error?: string };
throw new Error(data.error ?? `HTTP ${res.status}`);
}
const data = (await res.json()) as { url?: string };
return data.url ?? ""; return data.url ?? "";
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); error.value = err instanceof Error ? err.message : String(err);
@ -32,12 +25,9 @@ export function useInvitesApi() {
loading.value = true; loading.value = true;
error.value = ""; error.value = "";
try { try {
const res = await fetch(`/admin/api/groups/${encodeURIComponent(groupId)}/invites`, { const data = await apiFetch<{ invites?: GroupInvite[] }>(
headers: { accept: "application/json" }, `/admin/api/groups/${encodeURIComponent(groupId)}/invites`,
credentials: "same-origin", );
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = (await res.json()) as { invites?: GroupInvite[] };
return data.invites ?? []; return data.invites ?? [];
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); error.value = err instanceof Error ? err.message : String(err);
@ -51,14 +41,7 @@ export function useInvitesApi() {
loading.value = true; loading.value = true;
error.value = ""; error.value = "";
try { try {
const res = await fetch(`/admin/api/invites/${encodeURIComponent(token)}`, { await apiFetch(`/admin/api/invites/${encodeURIComponent(token)}`, { method: "DELETE" });
method: "DELETE",
credentials: "same-origin",
});
if (!res.ok) {
const data = (await res.json().catch(() => ({}))) as { error?: string };
throw new Error(data.error ?? `HTTP ${res.status}`);
}
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); error.value = err instanceof Error ? err.message : String(err);
throw err; throw err;

View file

@ -1,9 +1,9 @@
import type { SendRecord } from "~/types"; import type { SendRecord } from "~/types";
export function useSendLogs() { export function useSendLogs() {
const { needLogin } = useAuthState();
const logs = ref<SendRecord[]>([]); const logs = ref<SendRecord[]>([]);
const loading = ref(false); const loading = ref(false);
const needLogin = ref(false);
const error = ref(""); const error = ref("");
async function load(limit = 50, groupId?: string): Promise<void> { async function load(limit = 50, groupId?: string): Promise<void> {
@ -13,35 +13,17 @@ export function useSendLogs() {
try { try {
let url = `/admin/api/logs?limit=${limit}`; let url = `/admin/api/logs?limit=${limit}`;
if (groupId) url += `&groupId=${encodeURIComponent(groupId)}`; if (groupId) url += `&groupId=${encodeURIComponent(groupId)}`;
const res = await fetch(url, { const data = await apiFetch<{ logs?: SendRecord[] }>(url);
headers: { accept: "application/json" },
credentials: "same-origin",
});
if (res.status === 401) {
needLogin.value = true;
return;
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = (await res.json()) as { logs?: SendRecord[] };
logs.value = data.logs ?? []; logs.value = data.logs ?? [];
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); if (!needLogin.value) error.value = err instanceof Error ? err.message : String(err);
} finally { } finally {
loading.value = false; loading.value = false;
} }
} }
async function loadById(id: number): Promise<SendRecord | null> { async function loadById(id: number): Promise<SendRecord | null> {
const res = await fetch(`/admin/api/logs/${id}`, { const data = await apiFetch<{ log?: SendRecord }>(`/admin/api/logs/${id}`);
headers: { accept: "application/json" },
credentials: "same-origin",
});
if (res.status === 401) {
needLogin.value = true;
return null;
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = (await res.json()) as { log?: SendRecord };
return data.log ?? null; return data.log ?? null;
} }

View file

@ -12,16 +12,7 @@ export function useWebhookApi() {
loading.value = true; loading.value = true;
error.value = ""; error.value = "";
try { try {
const res = await fetch(path, { return await apiFetch<T>(path, init);
headers: { accept: "application/json" },
credentials: "same-origin",
...init,
});
if (!res.ok) {
const data = (await res.json().catch(() => ({}))) as { error?: string };
throw new Error(data.error ?? `HTTP ${res.status}`);
}
return (await res.json()) as T;
} catch (err) { } catch (err) {
error.value = err instanceof Error ? err.message : String(err); error.value = err instanceof Error ? err.message : String(err);
throw err; throw err;

18
app/utils/format.ts Normal file
View file

@ -0,0 +1,18 @@
/** Split a comma-separated input into trimmed non-empty parts. */
export function splitList(text: string): string[] {
return text
.split(",")
.map((s) => s.trim())
.filter(Boolean);
}
/** Comma-separated filter match → single value, list, or null when empty. */
export function parseMatch(text: string): string | string[] | null {
const parts = splitList(text);
if (!parts.length) return null;
return parts.length === 1 ? parts[0]! : parts;
}
export function fmtTime(ts: number): string {
return new Date(ts).toLocaleString();
}