milestone 30: overview as a dashboard, explicit health contract, period aggregations

admin/src/lib/api.ts

@@ -33,11 +33,13 @@ import type {
 	SettingsEnvelope,
 	SettingsPatch,
 	SourceStatus,
+	StatsClients,
+	StatsRoutes,
 	StatsTimeseries,
 	StatsTotals,
+	StatsTypes,
 	Upstream,
 	UpstreamEcho,
-	UpstreamHealth,
 	UpstreamInput,
 	Version,
 } from "@/lib/types";
@@ -122,13 +124,14 @@ export const liveQueriesUrl = "/api/queries/live";
 export const getStats = (period?: Period): Promise<StatsTotals> => request(`/api/stats${qs({ period })}`);
 export const getStatsTimeseries = (period?: Period): Promise<StatsTimeseries> =>
 	request(`/api/stats/timeseries${qs({ period })}`);
+export const getStatsTypes = (period?: Period): Promise<StatsTypes> => request(`/api/stats/types${qs({ period })}`);
+export const getStatsRoutes = (period?: Period): Promise<StatsRoutes> => request(`/api/stats/routes${qs({ period })}`);
+export const getStatsClients = (period?: Period): Promise<StatsClients> =>
+	request(`/api/stats/clients${qs({ period })}`);
 
 export const getLookup = (domain: string, groupId?: number): Promise<LookupResult> =>
 	request(`/api/lookup${qs({ domain, group_id: groupId })}`);
 
-export const getUpstreamHealth = (period?: Period): Promise<UpstreamHealth> =>
-	request(`/api/upstream/health${qs({ period })}`);
-
 // Diagnostics
 
 export const getDiagnostics = (filter: DiagnosticsFilter = {}): Promise<DiagnosticsPage> =>
@@ -235,6 +238,11 @@ export const deleteUpstream = (id: number): Promise<void> => request(`/api/upstr
 
 // Pause + settings
 
+/**
+ * The pause state on its own. Protection is read from `/api/health` everywhere
+ * the interface shows it — one source, one story — so this is left for the live
+ * stream's session probe, which wants the cheapest authenticated GET there is.
+ */
 export const getPause = (): Promise<PauseState> => request("/api/pause");
 export const postPause = (body: PausePost): Promise<PauseState> => request("/api/pause", { method: "POST", body });