@oh-my-pi/omp-stats 18.3.5 → 18.4.1

package/src/client/routes/CostsRoute.tsx

@@ -1,252 +1,424 @@
-import type { Plugin } from "chart.js";
+import "./costs.css";
 import { useMemo, useState } from "react";
-import { Bar, Line } from "react-chartjs-2";
 import { getCostDashboardStats } from "../api";
+import { Chart, type ChartSeries, Legend, ShareBar, useHiddenSeries } from "../charts";
+import { buildModelColorLookup, modelKey, OTHER_COLOR, SERIES_COLORS } from "../data/colors";
+import { formatCost, formatEstimatedCost, formatInteger, formatPercent } from "../data/formatters";
+import { useQuery } from "../data/query";
+import { bucketAxis, rangeMeta } from "../data/range";
+import { densify, pivotSeries } from "../data/series";
+import { buildCostSummary, type CostComponents, type CostModelRow, type CostSummaryView } from "../data/view-models";
+import type { CostDashboardStats, TimeRange } from "../types";
 import {
-	barDatasetStyle,
-	buildAggregateTimeSeries,
-	buildSharedPlugins,
-	buildSharedScales,
-	buildTopNByModelSeries,
-	CHART_THEMES,
-	lineDatasetStyle,
-	MODEL_COLORS,
-	styleDatasets,
-} from "../components/chart-shared";
-import { formatCost, formatEstimatedCost } from "../data/formatters";
-import { useResource } from "../data/useResource";
-import { buildCostSummary } from "../data/view-models";
-import type { CostTimeSeriesPoint, TimeRange } from "../types";
-import { AsyncBoundary, Panel, SegmentedControl } from "../ui";
-import { useSystemTheme } from "../useSystemTheme";
+	Card,
+	ChartSkeleton,
+	type Column,
+	EmptyState,
+	LabelCell,
+	MeterCell,
+	PageHeader,
+	QueryView,
+	Segmented,
+	Skeleton,
+	Stat,
+	StatGrid,
+	Swatch,
+	Table,
+	TableSkeleton,
+} from "../ui";
 
 export interface CostsRouteProps {
 	active: boolean;
 	range: TimeRange;
-	refreshTrigger: number;
 }
 
-export function CostsRoute({ active, range, refreshTrigger }: CostsRouteProps) {
-	const {
-		data: costStats,
-		error,
-		loading,
-	} = useResource(["costs", range, refreshTrigger], signal => getCostDashboardStats(range, signal), {
-		pollMs: 30000,
-		enabled: active,
-	});
+type SplitMode = "model" | "component";
 
-	return (
-		<div className="stats-route-container space-y-6">
-			<AsyncBoundary loading={loading} error={error} data={costStats}>
-				{costStats && (
-					<>
-						<CostOverviewPanel costSeries={costStats.costSeries} />
-						<CostTrendPanel costSeries={costStats.costSeries} />
-					</>
-				)}
-			</AsyncBoundary>
-		</div>
-	);
-}
+const SPLIT_OPTIONS = [
+	{ value: "model" as const, label: "By model" },
+	{ value: "component" as const, label: "By component" },
+];
 
-function CostOverviewPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }) {
-	const summary = useMemo(() => buildCostSummary(costSeries), [costSeries]);
+/** Models stacked individually in the daily chart; the rest fold into "Other". */
+const MODEL_LIMIT = 6;
 
-	const cards = [
-		{
-			label: "API-equivalent estimate",
-			value: formatEstimatedCost(summary.totalCost, summary.unpricedRequests),
-			sub:
-				summary.unpricedRequests > 0
-					? `Excludes ${summary.unpricedRequests.toLocaleString()} unpriced subscription request${summary.unpricedRequests === 1 ? "" : "s"}`
-					: undefined,
-		},
-		{
-			label: "Average estimate / Day",
-			value: formatEstimatedCost(summary.avgDailyCost, summary.unpricedRequests),
-		},
-		{
-			label: "Top Model",
-			value: summary.topModelName || "—",
-			sub: summary.topModelName ? `API-equivalent estimate: ${formatCost(summary.topModelCost)}` : undefined,
-		},
-	];
+/** The cost series is bucketed by UTC day on the server. */
+const DAY_MS = 86_400_000;
+
+const COMPONENTS = [
+	{ key: "costInput", label: "Input", color: "#5b8cff" },
+	{ key: "costOutput", label: "Output", color: "var(--chart-secondary)" },
+	{ key: "costCacheRead", label: "Cache read", color: "var(--chart-primary)" },
+	{ key: "costCacheWrite", label: "Cache write", color: "#f5b54a" },
+] as const satisfies readonly { key: keyof CostComponents; label: string; color: string }[];
+
+const UTC_DAY = new Intl.DateTimeFormat(undefined, { month: "short", day: "numeric", timeZone: "UTC" });
+const UTC_DAY_LONG = new Intl.DateTimeFormat(undefined, {
+	weekday: "short",
+	month: "short",
+	day: "numeric",
+	year: "numeric",
+	timeZone: "UTC",
+});
+
+export function CostsRoute({ active, range }: CostsRouteProps) {
+	const query = useQuery(["costs", range], () => getCostDashboardStats(range), { enabled: active });
+	const meta = rangeMeta(range);
+	const [split, setSplit] = useState<SplitMode>("model");
+	const [hidden, toggleSeries] = useHiddenSeries();
+	const view = useMemo(() => (query.data ? buildCostsView(query.data, range) : null), [query.data, range]);
+	const isEmpty = (data: CostDashboardStats) => data.costSeries.length === 0;
+	const empty = <EmptyState title="No usage in this range" hint="Pick a wider range in the top bar." />;
 
 	return (
-		<div className="grid grid-cols-1 md:grid-cols-3 gap-4">
-			{cards.map(card => (
-				<Panel key={card.label} className="stats-cost-overview-card py-4 px-5">
-					<p className="text-xs stats-text-muted mb-1 font-medium uppercase tracking-wider">{card.label}</p>
-					<p className="text-2xl font-bold stats-text-primary truncate" title={card.value}>
-						{card.value}
-					</p>
-					{card.sub && <p className="text-xs stats-text-muted mt-1 font-medium">{card.sub}</p>}
-				</Panel>
-			))}
+		<div className="page">
+			<PageHeader
+				title="Costs"
+				description={`What ${meta.windowLabel} of usage would cost at public API rates. Subscription usage without a public price is counted as unpriced, not free.`}
+			/>
+
+			<QueryView
+				query={query}
+				skeleton={<Skeleton height={112} style={{ borderRadius: 12 }} />}
+				isEmpty={isEmpty}
+				empty={empty}
+			>
+				{() => view && <CostStats view={view} stale={query.stale} />}
+			</QueryView>
+
+			<div className="grid grid-main-side">
+				<Card
+					index={1}
+					title="Daily estimate"
+					description={
+						split === "model" ? "Per UTC day, stacked by model" : "Per UTC day, stacked by billing component"
+					}
+					actions={
+						<Segmented
+							size="sm"
+							options={SPLIT_OPTIONS}
+							value={split}
+							onChange={setSplit}
+							aria-label="Split by"
+						/>
+					}
+					stale={query.stale}
+				>
+					<QueryView query={query} skeleton={<ChartSkeleton height={280} />} isEmpty={isEmpty} empty={empty}>
+						{() => {
+							if (!view) return null;
+							const series = split === "model" ? view.modelSeries : view.componentSeries;
+							return (
+								<div className="stack" style={{ gap: 12 }}>
+									<Chart
+										slots={view.buckets.length}
+										tickLabel={i => UTC_DAY.format(view.buckets[i])}
+										tooltipTitle={i => UTC_DAY_LONG.format(view.buckets[i])}
+										series={series}
+										hidden={hidden}
+										height={280}
+										format={v => formatCost(v, Number.isInteger(v) ? 0 : 2)}
+										formatTooltip={v => formatCost(v)}
+										emptyLabel="No priced usage in this range"
+										tooltipExtra={i =>
+											view.unpricedPerDay[i] > 0 ? (
+												<div className="chart-tooltip-row chart-tooltip-total">
+													<span className="chart-tooltip-label">Unpriced requests</span>
+													<span className="chart-tooltip-value">
+														{formatInteger(view.unpricedPerDay[i])}
+													</span>
+												</div>
+											) : null
+										}
+									/>
+									<Legend
+										items={series.map(s => ({
+											key: s.key,
+											label: s.label,
+											color: s.color,
+											value: formatCost(sum(s.values)),
+										}))}
+										hidden={hidden}
+										onToggle={toggleSeries}
+									/>
+								</div>
+							);
+						}}
+					</QueryView>
+				</Card>
+
+				<Card index={2} title="Where it went" description="Estimate by billing component" stale={query.stale}>
+					<QueryView query={query} skeleton={<ChartSkeleton height={280} />} isEmpty={isEmpty} empty={empty}>
+						{() => view && <ComponentBreakdown summary={view.summary} />}
+					</QueryView>
+				</Card>
+			</div>
+
+			<Card
+				index={3}
+				title="By model"
+				description="Estimate per model with its input, output and cache split"
+				stale={query.stale}
+				flush
+			>
+				<QueryView query={query} skeleton={<TableSkeleton rows={8} />} isEmpty={isEmpty} empty={empty}>
+					{() =>
+						view && (
+							<Table
+								rows={view.summary.models}
+								rowKey={row => row.key}
+								columns={buildCostColumns(view)}
+								initialSort={{ key: "cost", dir: "desc" }}
+								limit={20}
+							/>
+						)
+					}
+				</QueryView>
+			</Card>
 		</div>
 	);
 }
 
-const BAR_LABEL_COLORS = {
-	dark: "rgba(248, 250, 252, 0.7)",
-	light: "rgba(15, 23, 42, 0.6)",
-} as const;
+interface CostsView {
+	summary: CostSummaryView;
+	/** Chart color of each individually plotted model; the rest share "Other" gray. */
+	swatches: Map<string, string>;
+	buckets: number[];
+	dailyTotals: number[];
+	unpricedPerDay: number[];
+	modelSeries: ChartSeries[];
+	componentSeries: ChartSeries[];
+	maxModelCost: number;
+}
 
-// Inline Chart.js plugin to draw cost value above bars
-function makeBarLabelPlugin(color: string): Plugin<"bar"> {
+function buildCostsView(data: CostDashboardStats, range: TimeRange): CostsView {
+	const points = data.costSeries;
+	const summary = buildCostSummary(points);
+	const colors = buildModelColorLookup(
+		summary.models.map(m => ({ model: m.model, provider: m.provider, totalRequests: m.requests })),
+	);
+	const byKey = new Map(summary.models.map(m => [m.key, m]));
+	const buckets = bucketAxis(
+		range,
+		points.map(p => p.timestamp),
+		DAY_MS,
+	);
+	// Zero slots become gaps so the tooltip lists only what was spent that day.
+	const modelSeries = pivotSeries(points, {
+		buckets,
+		key: p => modelKey(p.model, p.provider),
+		label: key => byKey.get(key)?.model ?? key,
+		value: p => p.cost,
+		limit: MODEL_LIMIT,
+		colors,
+	}).map(s => ({ ...s, values: s.values.map(v => v || null) }));
+	// Colors follow request rank (shared with the Models page); the top models by
+	// cost can include ranks that wrap onto the same hue, so recolor repeats.
+	const used = new Set<string>();
+	for (const s of modelSeries) {
+		if (s.key === "__other__") continue;
+		if (used.has(s.color)) s.color = SERIES_COLORS.find(c => !used.has(c)) ?? s.color;
+		used.add(s.color);
+	}
 	return {
-		id: "costBarLabels",
-		afterDatasetsDraw(chart) {
-			const { ctx } = chart;
-			const dataset = chart.data.datasets[0];
-			if (!dataset) return;
-			const meta = chart.getDatasetMeta(0);
-			ctx.save();
-			ctx.font = "11px system-ui, sans-serif";
-			ctx.fillStyle = color;
-			ctx.textAlign = "center";
-			ctx.textBaseline = "bottom";
-			for (const bar of meta.data) {
-				// Accessing Chart.js internal parsed coordinates via unknown cast
-				const value = (bar as unknown as { $context: { parsed: { y: number } } }).$context.parsed.y;
-				if (!value) continue;
-				const label = `$${Math.round(value)}`;
-				// Accessing internal getProps for positioning via unknown cast
-				const { x, y } = bar.getProps(["x", "y"], true) as {
-					x: number;
-					y: number;
-				};
-				ctx.fillText(label, x, y - 3);
-			}
-			ctx.restore();
-		},
+		summary,
+		swatches: new Map(modelSeries.filter(s => s.key !== "__other__").map(s => [s.key, s.color])),
+		buckets,
+		dailyTotals: densify(points, buckets, p => p.cost),
+		unpricedPerDay: densify(points, buckets, p => p.unpricedRequests),
+		modelSeries,
+		componentSeries: COMPONENTS.map(c => ({
+			key: c.key,
+			label: c.label,
+			color: c.color,
+			values: densify(points, buckets, p => p[c.key]).map(v => v || null),
+		})),
+		maxModelCost: summary.models[0]?.cost ?? 0,
 	};
 }
 
-function CostTrendPanel({ costSeries }: { costSeries: CostTimeSeriesPoint[] }) {
-	const [byModel, setByModel] = useState(false);
-	const theme = useSystemTheme();
-	const chartTheme = CHART_THEMES[theme];
-	const unpricedRequests = useMemo(
-		() => costSeries.reduce((sum, point) => sum + point.unpricedRequests, 0),
-		[costSeries],
+function CostStats({ view, stale }: { view: CostsView; stale: boolean }) {
+	const { summary } = view;
+	const pricedRequests = summary.requests - summary.unpricedRequests;
+	const top = summary.topModel;
+	return (
+		<div data-stale={stale}>
+			<StatGrid min={180}>
+				<Stat
+					label="API-equivalent estimate"
+					title="What this usage would cost at public API rates"
+					value={formatEstimatedCost(summary.totalCost, summary.unpricedRequests)}
+					hint={`${formatInteger(summary.requests)} requests`}
+					spark={view.dailyTotals}
+					sparkColor="var(--chart-secondary)"
+				/>
+				<Stat
+					label="Average per day"
+					title="Estimate ÷ days with any usage"
+					value={formatEstimatedCost(summary.avgDailyCost, summary.unpricedRequests)}
+					hint={`over ${formatInteger(summary.activeDays)} active day${summary.activeDays === 1 ? "" : "s"}`}
+				/>
+				<Stat
+					label="Top model"
+					title={top ? `${top.model} (${top.provider})` : undefined}
+					value={top ? top.model : "–"}
+					hint={top ? `${formatCost(top.cost)} · ${formatPercent(top.share)} of estimate` : "Nothing priced yet"}
+				/>
+				<Stat
+					label="Per priced request"
+					title="Estimate ÷ requests that have a public price"
+					value={pricedRequests > 0 ? formatUnitCost(summary.totalCost / pricedRequests) : "–"}
+					hint={`${formatInteger(pricedRequests)} priced`}
+				/>
+				<Stat
+					label="Unpriced requests"
+					title="Subscription usage with no public-equivalent price; excluded from the estimate"
+					value={formatInteger(summary.unpricedRequests)}
+					hint={summary.unpricedRequests > 0 ? "excluded from the estimate" : "all usage priced"}
+				/>
+			</StatGrid>
+		</div>
 	);
+}
 
-	const chartData = useMemo(() => {
-		if (byModel) {
-			return buildTopNByModelSeries<CostTimeSeriesPoint, { total: number }>(costSeries, {
-				rankWeight: point => point.cost,
-				initBucket: () => ({ total: 0 }),
-				accumulate: (bucket, point) => {
-					bucket.total += point.cost;
-				},
-				bucketToValue: bucket => bucket.total,
-			});
-		}
-		return buildAggregateTimeSeries<CostTimeSeriesPoint, { total: number }>(costSeries, "API-equivalent estimate", {
-			initBucket: () => ({ total: 0 }),
-			accumulate: (bucket, point) => {
-				bucket.total += point.cost;
-			},
-			bucketToValue: bucket => bucket.total,
-		});
-	}, [costSeries, byModel]);
-
-	const sharedPlugins = useMemo(() => {
-		return buildSharedPlugins({
-			chartTheme,
-			showLegend: byModel,
-			defaultLabel: "API-equivalent estimate",
-			formatValue: v => `$${v.toFixed(2)}`,
-			footer: items => {
-				if (!byModel || items.length < 2) return undefined;
-				const total = items.reduce((sum, item) => sum + (item.parsed.y ?? 0), 0);
-				return `Total: $${total.toFixed(2)}`;
-			},
-		});
-	}, [chartTheme, byModel]);
-
-	const { sharedScaleBase, yScale } = useMemo(() => {
-		return buildSharedScales({
-			chartTheme,
-			formatY: v => `$${Math.round(v)}`,
-		});
-	}, [chartTheme]);
-
-	const barLabelPlugin = useMemo(() => {
-		return makeBarLabelPlugin(BAR_LABEL_COLORS[theme]);
-	}, [theme]);
-
-	const lineData = useMemo(() => {
-		if (!byModel) return null;
-		return {
-			labels: chartData.labels,
-			datasets: styleDatasets(chartData, i => lineDatasetStyle(MODEL_COLORS[i % MODEL_COLORS.length])),
-		};
-	}, [chartData, byModel]);
-
-	const lineOptions = useMemo(() => {
-		return {
-			responsive: true,
-			maintainAspectRatio: false,
-			interaction: { mode: "index" as const, intersect: false },
-			plugins: sharedPlugins,
-			scales: { x: sharedScaleBase, y: yScale },
-		};
-	}, [sharedPlugins, sharedScaleBase, yScale]);
-
-	const barData = useMemo(() => {
-		if (byModel) return null;
-		return {
-			labels: chartData.labels,
-			datasets: styleDatasets(chartData, i => barDatasetStyle(MODEL_COLORS[i % MODEL_COLORS.length])),
-		};
-	}, [chartData, byModel]);
-
-	const barOptions = useMemo(() => {
-		return {
-			responsive: true,
-			maintainAspectRatio: false,
-			interaction: { mode: "index" as const, intersect: false },
-			plugins: {
-				...sharedPlugins,
-				costBarLabels: {},
-			},
-			scales: {
-				x: { ...sharedScaleBase, stacked: true },
-				y: { ...yScale, stacked: true },
-			},
-			layout: { padding: { top: 24 } },
-		};
-	}, [sharedPlugins, sharedScaleBase, yScale]);
-
-	const toggleOptions = [
-		{ value: false, label: "All Models" },
-		{ value: true, label: "By Model" },
-	];
-
+function ComponentBreakdown({ summary }: { summary: CostSummaryView }) {
 	return (
-		<Panel
-			title="Daily API-equivalent estimate"
-			subtitle={
-				unpricedRequests > 0
-					? `Public API rate-card value over time; excludes ${unpricedRequests.toLocaleString()} unpriced subscription request${unpricedRequests === 1 ? "" : "s"}`
-					: "Public API rate-card value over time"
-			}
-			actions={<SegmentedControl options={toggleOptions} value={byModel} onChange={setByModel} />}
-		>
-			<div className="h-[300px]">
-				{chartData.labels.length === 0 ? (
-					<div className="h-full flex items-center justify-center text-stats-muted text-sm">
-						No API-equivalent estimate data available
+		<div className="stack" style={{ gap: 14 }}>
+			<ShareBar
+				height={10}
+				segments={COMPONENTS.map(c => ({ key: c.key, label: c.label, value: summary[c.key], color: c.color }))}
+			/>
+			<div className="costs-components">
+				{COMPONENTS.map(c => (
+					<div key={c.key} className="costs-component-row">
+						<span className="row">
+							<Swatch color={c.color} />
+							{c.label}
+						</span>
+						<span className="num">{formatCost(summary[c.key])}</span>
+						<span className="num dim costs-component-share">
+							{summary.totalCost > 0 ? formatPercent(summary[c.key] / summary.totalCost) : "–"}
+						</span>
 					</div>
-				) : byModel && lineData ? (
-					<Line data={lineData} options={lineOptions} />
-				) : barData ? (
-					<Bar data={barData} options={barOptions} plugins={[barLabelPlugin]} />
-				) : null}
+				))}
+				<div className="costs-component-row costs-component-total">
+					<span>Total</span>
+					<span className="num">{formatEstimatedCost(summary.totalCost, summary.unpricedRequests)}</span>
+					<span className="costs-component-share" />
+				</div>
 			</div>
-		</Panel>
+			{summary.unpricedRequests > 0 && (
+				<p className="micro dim">
+					{formatInteger(summary.unpricedRequests)} unpriced subscription request
+					{summary.unpricedRequests === 1 ? " is" : "s are"} not included.
+				</p>
+			)}
+		</div>
 	);
 }
+
+function buildCostColumns(view: CostsView): Column<CostModelRow>[] {
+	const componentColumns: Column<CostModelRow>[] = COMPONENTS.map(c => ({
+		key: c.key,
+		header: c.label,
+		align: "right",
+		sort: row => row[c.key],
+		render: row => <span className="num">{formatCost(row[c.key])}</span>,
+	}));
+	return [
+		{
+			key: "model",
+			header: "Model",
+			sort: row => row.model,
+			render: row => (
+				<LabelCell
+					lead={<Swatch color={view.swatches.get(row.key) ?? OTHER_COLOR} />}
+					primary={<span className="mono">{row.model}</span>}
+					secondary={row.provider}
+				/>
+			),
+		},
+		{
+			key: "requests",
+			header: "Requests",
+			align: "right",
+			sort: row => row.requests,
+			render: row => <span className="num">{formatInteger(row.requests)}</span>,
+		},
+		{
+			key: "cost",
+			header: "Estimate",
+			title: "API-equivalent estimate at public rates",
+			align: "right",
+			sort: row => row.cost,
+			render: row => (
+				<MeterCell
+					value={row.cost}
+					max={view.maxModelCost}
+					display={formatEstimatedCost(row.cost, row.unpricedRequests)}
+					color={view.swatches.get(row.key) ?? OTHER_COLOR}
+				/>
+			),
+		},
+		{
+			key: "share",
+			header: "Share",
+			align: "right",
+			sort: row => row.share,
+			render: row => <span className="num muted">{row.cost > 0 ? formatPercent(row.share) : "–"}</span>,
+		},
+		{
+			key: "split",
+			header: "Split",
+			title: "Input · output · cache read · cache write",
+			width: 150,
+			render: row =>
+				row.cost > 0 ? (
+					<ShareBar
+						segments={COMPONENTS.map(c => ({ key: c.key, label: c.label, value: row[c.key], color: c.color }))}
+					/>
+				) : (
+					<span className="dim">–</span>
+				),
+		},
+		...componentColumns,
+		{
+			key: "perRequest",
+			header: "Per request",
+			title: "Estimate ÷ priced requests",
+			align: "right",
+			sort: row => (row.requests > row.unpricedRequests ? row.cost / (row.requests - row.unpricedRequests) : -1),
+			render: row => (
+				<span className="num">
+					{row.requests > row.unpricedRequests
+						? formatUnitCost(row.cost / (row.requests - row.unpricedRequests))
+						: "–"}
+				</span>
+			),
+		},
+		{
+			key: "unpriced",
+			header: "Unpriced",
+			title: "Requests with no public-equivalent price",
+			align: "right",
+			sort: row => row.unpricedRequests,
+			render: row =>
+				row.unpricedRequests > 0 ? (
+					<span className="num tone-warn">{formatInteger(row.unpricedRequests)}</span>
+				) : (
+					<span className="num dim">–</span>
+				),
+		},
+	];
+}
+
+/** Per-request cost; amounts below the 4-digit precision read as a bound instead of "$0.0000". */
+function formatUnitCost(value: number): string {
+	return value > 0 && value < 0.0001 ? "<$0.0001" : formatCost(value);
+}
+
+function sum(values: readonly (number | null)[]): number {
+	let total = 0;
+	for (const v of values) total += v ?? 0;
+	return total;
+}