@jeffusion/bungee-core 5.3.2 → 5.4.1

package/dist/plugins/token-stats/ui/labels.ts

@@ -84,6 +84,8 @@ export type RankedModel = {
 export type TimeBucket = { startMs: number; total: number; parts: { id: string; tokens: number }[]; details: { id: string; tokens: number }[] };
 export type TimeSeries = { buckets: TimeBucket[]; models: string[]; maxTokens: number };
 export type TokenRange = '1h' | '12h' | '24h';
+export type TokenPageRange = 'day' | 'week' | 'month' | '1d' | '7d' | '30d';
+export type TokenStatsRange = TokenRange | TokenPageRange;
 export const OTHER_MODEL = '\0other';
 const RANGE_MS: Record<TokenRange, number> = { '1h': 3_600_000, '12h': 43_200_000, '24h': 86_400_000 };
 
@@ -98,6 +100,16 @@ export function cacheDetail(value: unknown): number | undefined {
   return amount !== undefined && amount > 0 ? amount : undefined;
 }
 
+/** Both cache read and cache write are subsets of input tokens. */
+export function formatCacheInputPercentage(value: unknown, row: UsageSnapshot): string {
+  const amount = tokenAmount(value);
+  const input = usagePresentation(row).input;
+  if (amount === undefined || input === undefined || input <= 0) return '—';
+  const percentage = amount / input * 100;
+  if (percentage > 0 && percentage < 0.01) return '<0.01%';
+  return `${new Intl.NumberFormat('en-US', { maximumFractionDigits: 2 }).format(percentage)}%`;
+}
+
 export function rankedModels(rows: readonly ModelUsageRow[]): RankedModel[] {
   return rows.map(row => {
     const usage = usagePresentation(row);
@@ -117,10 +129,16 @@ export function modelColorIndex(id: string): number {
 }
 
 /** Only counted tokens make a bar; empty buckets have no visible segments. */
-export function buildTimeSeries(rows: readonly ModelUsageRow[], range: TokenRange, bucketMs: number, nowMs: number): TimeSeries {
+export function buildTimeSeries(rows: readonly ModelUsageRow[], range: TokenStatsRange, bucketMs: number, nowMs: number, bucketStarts?: readonly number[]): TimeSeries {
   if (!Number.isSafeInteger(bucketMs) || bucketMs <= 0) return { buckets: [], models: [], maxTokens: 0 };
-  const first = Math.floor((nowMs - RANGE_MS[range]) / bucketMs) * bucketMs;
-  const last = Math.floor(nowMs / bucketMs) * bucketMs;
+  const starts = bucketStarts ? [...bucketStarts] : [];
+  if (!bucketStarts && range in RANGE_MS) {
+    const first = Math.floor((nowMs - RANGE_MS[range as TokenRange]) / bucketMs) * bucketMs;
+    const last = Math.floor(nowMs / bucketMs) * bucketMs;
+    for (let start = first; start <= last; start += bucketMs) starts.push(start);
+  }
+  if (!starts.length) return { buckets: [], models: [], maxTokens: 0 };
+  const first = starts[0]!, last = starts[starts.length - 1]!;
   const byBucket = new Map<number, Map<string, number>>();
   const totals = new Map<string, number>();
   for (const row of rows) {
@@ -137,7 +155,7 @@ export function buildTimeSeries(rows: readonly ModelUsageRow[], range: TokenRang
   const leading = named.slice(0, 4).map(([id]) => id);
   const models = [...leading, ...(totals.has('unknown') ? ['unknown'] : []), ...(named.length > 4 ? [OTHER_MODEL] : [])];
   const buckets: TimeBucket[] = [];
-  for (let startMs = first; startMs <= last; startMs += bucketMs) {
+  for (const startMs of starts) {
     const amounts = byBucket.get(startMs) ?? new Map<string, number>();
     const details = [...amounts].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
       .map(([id, tokens]) => ({ id, tokens }));

package/dist/plugins/token-stats/ui/overview-trends.ts

@@ -0,0 +1,33 @@
+import { bucketTrend } from '../../../packages/ui/src/components/dashboard/trends';
+import { usagePresentation } from './labels';
+import type { StatsResponse } from './stats-resource';
+
+export const OVERVIEW_METRICS = ['input', 'output', 'cost'] as const;
+export type OverviewMetric = typeof OVERVIEW_METRICS[number];
+export type OverviewTrend = { metric: OverviewMetric; percent: number | null; change: 'up' | 'down' | 'flat' | null; isNew: boolean };
+
+/** Compare adjacent completed server buckets. Missing traffic is zero; missing metering stays unknown. */
+export function overviewTrends(snapshot: StatsResponse | null): OverviewTrend[] {
+  const { asOfMs, bucketMs } = snapshot ?? {};
+  const valid = snapshot?.groupBy === 'time' && Number.isSafeInteger(asOfMs) && Number.isSafeInteger(bucketMs) && bucketMs! > 0;
+  const currentStart = valid ? Math.floor(asOfMs! / bucketMs!) * bucketMs! - bucketMs! : NaN;
+  return OVERVIEW_METRICS.map(metric => {
+    const amount = (start: number): number | null => {
+      if (!valid) return null;
+      const rows = snapshot!.data.filter(row => row.bucketStartMs === start);
+      let total = 0;
+      for (const row of rows) {
+        const value = metric === 'cost' ? row.estimatedCostUsd : usagePresentation(row)[metric];
+        if (value == null || !Number.isFinite(value) || value < 0) return null;
+        total += value;
+      }
+      return total;
+    };
+    const previous = amount(currentStart - bucketMs!), current = amount(currentStart);
+    const known = previous !== null && current !== null;
+    const percent = known ? bucketTrend([previous, current]) : null;
+    return { metric, percent: Number.isFinite(percent) ? percent : null,
+      change: !known ? null : current > previous ? 'up' : current < previous ? 'down' : 'flat',
+      isNew: known && previous === 0 && current > 0 };
+  });
+}

package/dist/plugins/token-stats/ui/stats-resource.ts

@@ -1,10 +1,13 @@
 import { writable } from 'svelte/store';
-import type { ModelUsageRow, TokenRange, UsageSnapshot } from './labels';
+import type { ModelUsageRow, TokenStatsRange, UsageSnapshot } from './labels';
 
 export type StatsResponse = UsageSnapshot & {
   groupBy: 'model' | 'time';
+  asOfMs?: number;
   estimatedCostUsd: number | null;
   bucketMs?: number;
+  bucketStarts?: number[];
+  bucketEndMs?: number;
   data: ModelUsageRow[];
 };
 export type StatsState = { data: StatsResponse | null; busy: boolean; error: string; refreshedAt: number };
@@ -49,4 +52,4 @@ export function createStatsResource(
 }
 
 export type StatsResource = ReturnType<typeof createStatsResource>;
-export type StatsRange = TokenRange;
+export type StatsRange = TokenStatsRange;

package/dist/plugins/token-stats/ui/stats.ts

@@ -3,11 +3,12 @@ import { createStatsResource, type StatsRange, type StatsResource, type StatsRes
 
 const resources = new Map<string, StatsResource>();
 export function getStatsResource(pluginName: string, range: StatsRange, groupBy: 'model' | 'time'): StatsResource {
-  const key = `${pluginName}:${range}:${groupBy}`;
+  const timeZone = ['day', 'week', 'month'].includes(range) ? Intl.DateTimeFormat().resolvedOptions().timeZone : undefined;
+  const key = `${pluginName}:${range}:${groupBy}:${timeZone ?? ''}`;
   let resource = resources.get(key);
   if (!resource) {
     resource = createStatsResource(signal => requestPluginControl<StatsResponse>(pluginName,
-      `/stats?range=${encodeURIComponent(range)}&groupBy=${groupBy}`, 'GET', undefined, signal),
+      `/stats?range=${encodeURIComponent(range)}&groupBy=${groupBy}${timeZone ? `&timeZone=${encodeURIComponent(timeZone)}` : ''}`, 'GET', undefined, signal),
     () => { if (resources.get(key) === resource) resources.delete(key); });
     resources.set(key, resource);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeffusion/bungee-core",
-  "version": "5.3.2",
+  "version": "5.4.1",
   "description": "Bungee reverse proxy core engine",
   "main": "./dist/main.js",
   "types": "./dist/main.d.ts",
@@ -12,7 +12,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@jeffusion/bungee-types": "^5.3.2",
+    "@jeffusion/bungee-types": "^5.4.1",
     "@types/lodash-es": "^4.17.12",
     "acorn": "^8.15.0",
     "canonicalize": "3.0.0",