@carlonicora/nextjs-jsonapi 2.4.0 → 2.5.0

package/dist/features/tokenusage/index.mjs

@@ -26,8 +26,8 @@ import {
   TableHeader,
   TableRow,
   usePageUrlGenerator
-} from "../../chunk-M2EGUO2F.mjs";
-import "../../chunk-3LVSA7IM.mjs";
+} from "../../chunk-G4YS52SO.mjs";
+import "../../chunk-DJWNNV52.mjs";
 import {
   AbstractService,
   EndpointCreator,
@@ -38,8 +38,14 @@ import {
   TokenUsageAdminSummaryModule,
   TokenUsageAdminTimeline,
   TokenUsageAdminTimelineModule,
-  cn
-} from "../../chunk-LCCRUWWY.mjs";
+  TokenUsageReportBreakdown,
+  TokenUsageReportSummary,
+  TokenUsageReportTimeline,
+  cn,
+  configureTokenUsage,
+  getTokenUsageCurrency,
+  tokenUsageModules
+} from "../../chunk-FS4RVV3K.mjs";
 import "../../chunk-AUXK7QSA.mjs";
 import "../../chunk-C7C7VY4F.mjs";
 import "../../chunk-E5YA5Z5X.mjs";
@@ -209,7 +215,8 @@ var TokenUsageAdminProvider = /* @__PURE__ */ __name(({
   initialCompanyId,
   initialFrom,
   initialTo,
-  topN = DEFAULT_TOP_N
+  topN = DEFAULT_TOP_N,
+  pageUrl = TOKEN_USAGE_ADMIN_PAGE_URL
 }) => {
   const t = useTranslations2();
   const generateUrl = usePageUrlGenerator();
@@ -281,7 +288,7 @@ var TokenUsageAdminProvider = /* @__PURE__ */ __name(({
   const breadcrumb = /* @__PURE__ */ __name(() => [
     {
       name: t("token_usage.admin.title"),
-      href: generateUrl({ page: TOKEN_USAGE_ADMIN_PAGE_URL })
+      href: generateUrl({ page: pageUrl })
     }
   ], "breadcrumb");
   const title = /* @__PURE__ */ __name(() => ({
@@ -342,37 +349,62 @@ var useTokenUsageAdmin = /* @__PURE__ */ __name(() => {
 
 // src/features/tokenusage/components/TokenUsageAdminContainer.tsx
 import { useTranslations as useTranslations7 } from "next-intl";
-import { useMemo as useMemo4 } from "react";
+import { useMemo as useMemo5 } from "react";
 
 // src/features/tokenusage/components/TokenUsageAdminTiles.tsx
 import { ArrowDownIcon, ArrowUpIcon } from "lucide-react";
 import { useTranslations as useTranslations3 } from "next-intl";
 
+// src/features/tokenusage/lib/formatters.ts
+import { useLocale } from "next-intl";
+import { useMemo as useMemo2 } from "react";
+function createUsageFormatters(locale, currency) {
+  const symbol = new Intl.NumberFormat(locale, { style: "currency", currency, currencyDisplay: "narrowSymbol" }).formatToParts(0).find((part) => part.type === "currency")?.value ?? currency;
+  const decimal = /* @__PURE__ */ __name((value, decimals) => value.toLocaleString(locale, { minimumFractionDigits: decimals, maximumFractionDigits: decimals }), "decimal");
+  const dayFormat = new Intl.DateTimeFormat(locale, { day: "numeric", month: "short", timeZone: "UTC" });
+  const monthFormat = new Intl.DateTimeFormat(locale, { month: "short", year: "numeric", timeZone: "UTC" });
+  const compactFormat = new Intl.NumberFormat(locale, { notation: "compact", maximumFractionDigits: 1 });
+  const collator = new Intl.Collator(locale);
+  return {
+    decimal,
+    metricValue(value, metric) {
+      if (metric === "cost") return `${symbol} ${decimal(value, 2)}`;
+      if (metric === "credits") return decimal(value, 1);
+      return decimal(value, 0);
+    },
+    currency(value, decimals) {
+      return `${symbol} ${decimal(value, decimals)}`;
+    },
+    percent(value, decimals = 1) {
+      return `${decimal(value, decimals)} %`;
+    },
+    compact(value) {
+      return compactFormat.format(value);
+    },
+    bucketDate(iso, granularity) {
+      const date = /* @__PURE__ */ new Date(`${iso}T00:00:00.000Z`);
+      return granularity === "month" ? monthFormat.format(date) : dayFormat.format(date);
+    },
+    compare(a, b) {
+      return collator.compare(a, b);
+    }
+  };
+}
+__name(createUsageFormatters, "createUsageFormatters");
+function useUsageFormatters() {
+  const locale = useLocale();
+  const currency = getTokenUsageCurrency();
+  return useMemo2(() => createUsageFormatters(locale, currency), [locale, currency]);
+}
+__name(useUsageFormatters, "useUsageFormatters");
+
 // src/features/tokenusage/lib/metrics.ts
-var LOCALE = "it-IT";
 function metricValue(row, metric) {
   if (metric === "cost") return row.cost;
   if (metric === "credits") return row.credits;
   return row.tokensIn + row.tokensOut;
 }
 __name(metricValue, "metricValue");
-function formatDecimal(value, decimals) {
-  return value.toLocaleString(LOCALE, {
-    minimumFractionDigits: decimals,
-    maximumFractionDigits: decimals
-  });
-}
-__name(formatDecimal, "formatDecimal");
-function formatMetricValue(value, metric) {
-  if (metric === "cost") return `\u20AC ${formatDecimal(value, 2)}`;
-  if (metric === "credits") return formatDecimal(value, 2);
-  return formatDecimal(value, 0);
-}
-__name(formatMetricValue, "formatMetricValue");
-function formatPercent(value, decimals = 1) {
-  return `${formatDecimal(value, decimals)} %`;
-}
-__name(formatPercent, "formatPercent");
 function cacheHitPercentage(cached, tokensIn) {
   if (!tokensIn) return 0;
   return cached / tokensIn * 100;
@@ -389,6 +421,7 @@ import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var ZERO = { cost: 0, credits: 0, tokensIn: 0, tokensOut: 0, cached: 0, calls: 0 };
 function TokenUsageAdminTiles({ summary, metric, singleCustomerMode }) {
   const t = useTranslations3();
+  const { decimal, metricValue: formatValue, currency, percent } = useUsageFormatters();
   const rowFor = /* @__PURE__ */ __name((scope, window) => summary.find((r) => r.scope === scope && r.window === window) ?? ZERO, "rowFor");
   const customerCurrent = rowFor("customer", "current");
   const customerPrevious = rowFor("customer", "previous");
@@ -405,9 +438,10 @@ function TokenUsageAdminTiles({ summary, metric, singleCustomerMode }) {
         {
           testId: "tile-customer",
           label: t("token_usage.admin.customer_spend"),
-          value: formatMetricValue(metricValue(customerCurrent, metric), metric),
+          value: formatValue(metricValue(customerCurrent, metric), metric),
           delta: percentageDelta(metricValue(customerCurrent, metric), metricValue(customerPrevious, metric)),
-          previousLabel: t("token_usage.admin.vs_previous")
+          previousLabel: t("token_usage.admin.vs_previous"),
+          decimal
         }
       ),
       !singleCustomerMode && /* @__PURE__ */ jsx3(
@@ -415,9 +449,10 @@ function TokenUsageAdminTiles({ summary, metric, singleCustomerMode }) {
         {
           testId: "tile-platform",
           label: t("token_usage.admin.platform_spend"),
-          value: formatMetricValue(metricValue(platformCurrent, metric), metric),
+          value: formatValue(metricValue(platformCurrent, metric), metric),
           delta: percentageDelta(metricValue(platformCurrent, metric), metricValue(platformPrevious, metric)),
-          previousLabel: t("token_usage.admin.vs_previous")
+          previousLabel: t("token_usage.admin.vs_previous"),
+          decimal
         }
       )
     ] }),
@@ -427,8 +462,9 @@ function TokenUsageAdminTiles({ summary, metric, singleCustomerMode }) {
         {
           testId: "tile-total",
           label: t("token_usage.admin.total_cost"),
-          value: formatMetricValue(metricValue(totalCurrent, metric), metric),
-          delta: percentageDelta(metricValue(totalCurrent, metric), metricValue(totalPrevious, metric))
+          value: formatValue(metricValue(totalCurrent, metric), metric),
+          delta: percentageDelta(metricValue(totalCurrent, metric), metricValue(totalPrevious, metric)),
+          decimal
         }
       ),
       /* @__PURE__ */ jsx3(
@@ -436,7 +472,8 @@ function TokenUsageAdminTiles({ summary, metric, singleCustomerMode }) {
         {
           testId: "tile-avg-per-call",
           label: t("token_usage.admin.avg_per_call"),
-          value: `\u20AC ${formatDecimal(averagePerCall, 4)}`
+          value: currency(averagePerCall, 4),
+          decimal
         }
       ),
       /* @__PURE__ */ jsx3(
@@ -444,7 +481,8 @@ function TokenUsageAdminTiles({ summary, metric, singleCustomerMode }) {
         {
           testId: "tile-cache-hit",
           label: t("token_usage.admin.cache_hit"),
-          value: formatPercent(cacheHit)
+          value: percent(cacheHit),
+          decimal
         }
       )
     ] })
@@ -456,13 +494,14 @@ function LeadTile({
   label,
   value,
   delta,
-  previousLabel
+  previousLabel,
+  decimal
 }) {
   return /* @__PURE__ */ jsx3(Card, { "data-testid": testId, children: /* @__PURE__ */ jsxs2(CardContent, { className: "grid gap-1", children: [
     /* @__PURE__ */ jsx3("span", { className: "text-muted-foreground text-xs", children: label }),
     /* @__PURE__ */ jsx3("span", { className: "text-primary text-xl font-semibold tabular-nums", children: value }),
     /* @__PURE__ */ jsxs2("span", { className: "flex items-center gap-1", children: [
-      /* @__PURE__ */ jsx3(Delta, { testId: `${testId}-delta`, delta }),
+      /* @__PURE__ */ jsx3(Delta, { testId: `${testId}-delta`, delta, decimal }),
       /* @__PURE__ */ jsx3("span", { className: "text-muted-foreground text-xs", children: previousLabel })
     ] })
   ] }) });
@@ -472,18 +511,23 @@ function SupportingTile({
   testId,
   label,
   value,
-  delta
+  delta,
+  decimal
 }) {
   return /* @__PURE__ */ jsx3(Card, { "data-testid": testId, size: "sm", children: /* @__PURE__ */ jsxs2(CardContent, { className: "grid gap-1", children: [
     /* @__PURE__ */ jsx3("span", { className: "text-muted-foreground text-xs", children: label }),
     /* @__PURE__ */ jsxs2("span", { className: "flex items-center gap-2", children: [
       /* @__PURE__ */ jsx3("span", { className: "text-sm font-medium tabular-nums", children: value }),
-      delta !== void 0 && /* @__PURE__ */ jsx3(Delta, { testId: `${testId}-delta`, delta })
+      delta !== void 0 && /* @__PURE__ */ jsx3(Delta, { testId: `${testId}-delta`, delta, decimal })
     ] })
   ] }) });
 }
 __name(SupportingTile, "SupportingTile");
-function Delta({ testId, delta }) {
+function Delta({
+  testId,
+  delta,
+  decimal
+}) {
   if (delta === void 0) {
     return /* @__PURE__ */ jsx3("span", { "data-testid": testId, className: "text-muted-foreground text-xs", children: "\u2014" });
   }
@@ -499,7 +543,7 @@ function Delta({ testId, delta }) {
       ),
       children: [
         /* @__PURE__ */ jsx3(Icon, { "aria-hidden": true, className: "size-3" }),
-        formatDecimal(Math.abs(delta), 0),
+        decimal(Math.abs(delta), 0),
         " %"
       ]
     }
@@ -510,13 +554,14 @@ __name(Delta, "Delta");
 // src/features/tokenusage/components/TokenUsageBreakdownTable.tsx
 import { ArrowDownIcon as ArrowDownIcon2, ArrowUpIcon as ArrowUpIcon2 } from "lucide-react";
 import { useTranslations as useTranslations4 } from "next-intl";
-import { useMemo as useMemo2, useState as useState2 } from "react";
+import { useMemo as useMemo3, useState as useState2 } from "react";
 import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 function TokenUsageBreakdownTable({ rows, metric }) {
   const t = useTranslations4();
+  const { decimal, metricValue: formatValue, percent, compare } = useUsageFormatters();
   const [sort, setSort] = useState2(void 0);
   const showActiveUsers = rows.some((row) => row.activeUsers !== void 0);
-  const total = useMemo2(() => rows.reduce((sum, row) => sum + metricValue(row, metric), 0), [rows, metric]);
+  const total = useMemo3(() => rows.reduce((sum, row) => sum + metricValue(row, metric), 0), [rows, metric]);
   const sortValue = /* @__PURE__ */ __name((row, key) => {
     switch (key) {
       case "label":
@@ -533,18 +578,18 @@ function TokenUsageBreakdownTable({ rows, metric }) {
         return row[key];
     }
   }, "sortValue");
-  const sortedRows = useMemo2(() => {
+  const sortedRows = useMemo3(() => {
     if (!sort) return rows;
     const factor = sort.direction === "desc" ? -1 : 1;
     return [...rows].sort((a, b) => {
       const left = sortValue(a, sort.key);
       const right = sortValue(b, sort.key);
       if (typeof left === "string" || typeof right === "string") {
-        return String(left).localeCompare(String(right), "it-IT") * factor;
+        return compare(String(left), String(right)) * factor;
       }
       return (left - right) * factor;
     });
-  }, [rows, sort, metric]);
+  }, [rows, sort, metric, compare]);
   const toggleSort = /* @__PURE__ */ __name((key) => setSort(
     (current) => current?.key === key ? { key, direction: current.direction === "desc" ? "asc" : "desc" } : { key, direction: "desc" }
   ), "toggleSort");
@@ -588,14 +633,14 @@ function TokenUsageBreakdownTable({ rows, metric }) {
         return /* @__PURE__ */ jsxs3(TableRow, { "data-testid": `breakdown-row-${row.id}`, children: [
           /* @__PURE__ */ jsx4(TableCell, { className: "text-xs", children: row.id === "other" ? t("token_usage.admin.other") : row.label }),
           /* @__PURE__ */ jsx4(TableCell, { className: "text-muted-foreground text-xs", children: row.sublabel ?? "" }),
-          showActiveUsers && /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: row.activeUsers === void 0 ? "" : formatDecimal(row.activeUsers, 0) }),
-          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatDecimal(row.calls, 0) }),
-          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatDecimal(row.tokensIn, 0) }),
-          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatDecimal(row.tokensOut, 0) }),
-          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatPercent(cacheHitPercentage(row.cached, row.tokensIn)) }),
-          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatMetricValue(row.cost, "cost") }),
-          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatMetricValue(row.credits, "credits") }),
-          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatPercent(share) })
+          showActiveUsers && /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: row.activeUsers === void 0 ? "" : decimal(row.activeUsers, 0) }),
+          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: decimal(row.calls, 0) }),
+          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: decimal(row.tokensIn, 0) }),
+          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: decimal(row.tokensOut, 0) }),
+          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: percent(cacheHitPercentage(row.cached, row.tokensIn)) }),
+          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatValue(row.cost, "cost") }),
+          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: formatValue(row.credits, "credits") }),
+          /* @__PURE__ */ jsx4(TableCell, { className: "text-right text-xs tabular-nums", children: percent(share) })
         ] }, row.id);
       }) })
     ] }) })
@@ -654,6 +699,7 @@ __name(seriesColor, "seriesColor");
 import { jsx as jsx5, jsxs as jsxs4 } from "react/jsx-runtime";
 function TokenUsageRankedBar({ rows, metric, emptyLabel, labelsAreOperationTypes = false }) {
   const t = useTranslations5();
+  const { metricValue: formatValue, percent } = useUsageFormatters();
   const renderLabel = /* @__PURE__ */ __name((row) => {
     if (row.id === "other") return t("token_usage.admin.other");
     if (!labelsAreOperationTypes) return row.label;
@@ -688,13 +734,13 @@ function TokenUsageRankedBar({ rows, metric, emptyLabel, labelsAreOperationTypes
           }
         ) })
       ] }),
-      /* @__PURE__ */ jsx5("span", { "data-testid": `ranked-value-${row.id}`, className: "text-right text-xs tabular-nums", children: formatMetricValue(value, metric) }),
+      /* @__PURE__ */ jsx5("span", { "data-testid": `ranked-value-${row.id}`, className: "text-right text-xs tabular-nums", children: formatValue(value, metric) }),
       /* @__PURE__ */ jsx5(
         "span",
         {
           "data-testid": `ranked-share-${row.id}`,
           className: "text-muted-foreground w-16 text-right text-xs tabular-nums",
-          children: formatPercent(share)
+          children: percent(share)
         }
       )
     ] }, row.id);
@@ -705,7 +751,7 @@ __name(TokenUsageRankedBar, "TokenUsageRankedBar");
 // src/features/tokenusage/components/TokenUsageTimelineChart.tsx
 import { useTranslations as useTranslations6 } from "next-intl";
 import { useTheme } from "next-themes";
-import { useMemo as useMemo3 } from "react";
+import { useMemo as useMemo4 } from "react";
 import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts";
 import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
 var OTHER_SERIES = "other";
@@ -732,13 +778,12 @@ var inferGranularity = /* @__PURE__ */ __name((buckets) => {
   if (smallestGap >= 7) return "week";
   return "day";
 }, "inferGranularity");
-var bucketFormatter = /* @__PURE__ */ __name((granularity) => granularity === "month" ? new Intl.DateTimeFormat("it-IT", { month: "short", year: "numeric", timeZone: "UTC" }) : new Intl.DateTimeFormat("it-IT", { day: "numeric", month: "short", timeZone: "UTC" }), "bucketFormatter");
-var compactNumber = new Intl.NumberFormat("it-IT", { notation: "compact", maximumFractionDigits: 1 });
 function TokenUsageTimelineChart({ rows, metric, stackBy, className }) {
   const t = useTranslations6();
+  const { compact, bucketDate, metricValue: formatValue } = useUsageFormatters();
   const { resolvedTheme } = useTheme();
   const mode = resolvedTheme === "dark" ? "dark" : "light";
-  const { chartData, seriesKeys } = useMemo3(() => {
+  const { chartData, seriesKeys } = useMemo4(() => {
     if (rows.length === 0) return { chartData: [], seriesKeys: [] };
     const totals = /* @__PURE__ */ new Map();
     for (const row of rows) totals.set(row.series, (totals.get(row.series) ?? 0) + metricValue2(row, metric));
@@ -766,7 +811,7 @@ function TokenUsageTimelineChart({ rows, metric, stackBy, className }) {
   const seriesLabel = /* @__PURE__ */ __name((series) => {
     if (series === OTHER_SERIES) {
       const key = "token_usage.series.other";
-      return t.has(key) ? t(key) : "Altro";
+      return t.has(key) ? t(key) : "Other";
     }
     if (stackBy === "company") return series;
     return operationLabel(
@@ -775,16 +820,15 @@ function TokenUsageTimelineChart({ rows, metric, stackBy, className }) {
       (key) => t.has(key)
     );
   }, "seriesLabel");
-  const chartConfig = useMemo3(
+  const chartConfig = useMemo4(
     () => Object.fromEntries(seriesKeys.map((series) => [series, { label: seriesLabel(series) }])),
     [seriesKeys, stackBy]
   );
   if (chartData.length === 0) {
     const key = "token_usage.timeline.empty";
-    return /* @__PURE__ */ jsx6("p", { className: className ? `text-muted-foreground text-sm ${className}` : "text-muted-foreground text-sm", children: t.has(key) ? t(key) : "Nessun dato nel periodo selezionato" });
+    return /* @__PURE__ */ jsx6("p", { className: className ? `text-muted-foreground text-sm ${className}` : "text-muted-foreground text-sm", children: t.has(key) ? t(key) : "No data in the selected period" });
   }
   const granularity = inferGranularity(chartData.map((entry) => entry.bucket));
-  const formatBucket = bucketFormatter(granularity);
   const seriesColorFor = /* @__PURE__ */ __name((series, index) => series === OTHER_SERIES ? OTHER_COLOR : seriesColor(index, mode), "seriesColorFor");
   return /* @__PURE__ */ jsxs5("div", { className, children: [
     /* @__PURE__ */ jsx6("span", { className: "sr-only", "data-testid": "timeline-data", children: JSON.stringify(chartData) }),
@@ -799,7 +843,7 @@ function TokenUsageTimelineChart({ rows, metric, stackBy, className }) {
           axisLine: false,
           tickMargin: 8,
           minTickGap: 16,
-          tickFormatter: (value) => formatBucket.format(/* @__PURE__ */ new Date(`${value}T00:00:00.000Z`))
+          tickFormatter: (value) => bucketDate(value, granularity)
         }
       ),
       /* @__PURE__ */ jsx6(
@@ -809,7 +853,7 @@ function TokenUsageTimelineChart({ rows, metric, stackBy, className }) {
           axisLine: false,
           tickMargin: 8,
           width: 48,
-          tickFormatter: (value) => compactNumber.format(value)
+          tickFormatter: (value) => compact(value)
         }
       ),
       /* @__PURE__ */ jsx6(
@@ -818,7 +862,9 @@ function TokenUsageTimelineChart({ rows, metric, stackBy, className }) {
           content: /* @__PURE__ */ jsx6(
             ChartTooltipContent,
             {
-              labelFormatter: (value) => formatBucket.format(/* @__PURE__ */ new Date(`${String(value)}T00:00:00.000Z`))
+              labelFormatter: (value) => bucketDate(String(value), granularity),
+              valueFormatter: (value) => formatValue(Number(value), metric),
+              hideZeroValues: true
             }
           )
         }
@@ -860,7 +906,12 @@ function TokenUsageAdminContainer() {
     isLoading,
     error
   } = useTokenUsageAdmin();
-  const stackByItems = useMemo4(
+  const platformIsEmpty = useMemo5(
+    () => summary.filter((row) => row.scope === "platform").every((row) => row.cost === 0 && row.credits === 0 && row.tokensIn === 0 && row.tokensOut === 0),
+    [summary]
+  );
+  const hidePlatform = singleCustomerMode || platformIsEmpty;
+  const stackByItems = useMemo5(
     () => ({
       scope: t("token_usage.admin.stack.scope"),
       type: t("token_usage.admin.stack.type"),
@@ -874,7 +925,7 @@ function TokenUsageAdminContainer() {
   if (isLoading) return /* @__PURE__ */ jsx7(RoundPageContainer, { fullWidth: true, forceHeader: true });
   const emptyLabel = t("token_usage.admin.no_data");
   return /* @__PURE__ */ jsx7(RoundPageContainer, { fullWidth: true, forceHeader: true, children: /* @__PURE__ */ jsxs6("div", { className: "flex w-full flex-col gap-4 p-4", children: [
-    /* @__PURE__ */ jsx7(TokenUsageAdminTiles, { summary, metric: filters.metric, singleCustomerMode }),
+    /* @__PURE__ */ jsx7(TokenUsageAdminTiles, { summary, metric: filters.metric, singleCustomerMode: hidePlatform }),
     /* @__PURE__ */ jsxs6(Card, { children: [
       /* @__PURE__ */ jsxs6(CardHeader, { children: [
         /* @__PURE__ */ jsx7(CardTitle, { children: t("token_usage.admin.usage_over_time") }),
@@ -908,7 +959,7 @@ function TokenUsageAdminContainer() {
         /* @__PURE__ */ jsx7(CardContent, { children: /* @__PURE__ */ jsx7(TokenUsageRankedBar, { rows: byUser, metric: filters.metric, emptyLabel }) })
       ] })
     ] }),
-    /* @__PURE__ */ jsxs6("div", { className: cn("grid gap-4", !singleCustomerMode && "md:grid-cols-2"), children: [
+    /* @__PURE__ */ jsxs6("div", { className: cn("grid gap-4", !hidePlatform && "md:grid-cols-2"), children: [
       /* @__PURE__ */ jsxs6(Card, { children: [
         /* @__PURE__ */ jsx7(CardHeader, { children: /* @__PURE__ */ jsx7(CardTitle, { children: t("token_usage.admin.customer_by_operation") }) }),
         /* @__PURE__ */ jsx7(CardContent, { children: /* @__PURE__ */ jsx7(
@@ -921,7 +972,7 @@ function TokenUsageAdminContainer() {
           }
         ) })
       ] }),
-      !singleCustomerMode && /* @__PURE__ */ jsxs6(Card, { children: [
+      !hidePlatform && /* @__PURE__ */ jsxs6(Card, { children: [
         /* @__PURE__ */ jsx7(CardHeader, { children: /* @__PURE__ */ jsx7(CardTitle, { children: t("token_usage.admin.platform_by_operation") }) }),
         /* @__PURE__ */ jsx7(CardContent, { children: /* @__PURE__ */ jsx7(
           TokenUsageRankedBar,
@@ -942,6 +993,49 @@ function TokenUsageAdminContainer() {
 }
 __name(TokenUsageAdminContainer, "TokenUsageAdminContainer");
 
+// src/features/tokenusage/data/TokenUsageReportService.ts
+function withFilters2(endpoint, filters) {
+  endpoint.addAdditionalParam("from", filters.from);
+  endpoint.addAdditionalParam("to", filters.to);
+  return endpoint;
+}
+__name(withFilters2, "withFilters");
+var TokenUsageReportService = class extends AbstractService {
+  static {
+    __name(this, "TokenUsageReportService");
+  }
+  /** Two rows: window "current" and "previous". */
+  static async getSummary(filters) {
+    const endpoint = withFilters2(new EndpointCreator({ endpoint: Modules.TokenUsageReportSummary }), filters);
+    return this.callApi({
+      type: Modules.TokenUsageReportSummary,
+      method: "GET" /* GET */,
+      endpoint: endpoint.generate()
+    });
+  }
+  static async getTimeline(params) {
+    const endpoint = withFilters2(new EndpointCreator({ endpoint: Modules.TokenUsageReportTimeline }), params);
+    endpoint.addAdditionalParam("granularity", params.granularity);
+    return this.callApi({
+      type: Modules.TokenUsageReportTimeline,
+      method: "GET" /* GET */,
+      endpoint: endpoint.generate()
+    });
+  }
+  static async getBreakdown(params) {
+    const endpoint = withFilters2(new EndpointCreator({ endpoint: Modules.TokenUsageReportBreakdown }), params);
+    endpoint.addAdditionalParam("dimension", params.dimension);
+    if (params.targetLabel) endpoint.addAdditionalParam("targetLabel", params.targetLabel);
+    endpoint.addAdditionalParam("metric", params.metric);
+    if (params.limit !== void 0) endpoint.addAdditionalParam("limit", String(params.limit));
+    return this.callApi({
+      type: Modules.TokenUsageReportBreakdown,
+      method: "GET" /* GET */,
+      endpoint: endpoint.generate()
+    });
+  }
+};
+
 // src/features/tokenusage/i18n-keys.ts
 var TOKEN_USAGE_ADMIN_I18N_KEYS = [
   // Page + KPI tiles
@@ -991,8 +1085,261 @@ var TOKEN_USAGE_ADMIN_I18N_KEYS = [
   "token_usage.series.other",
   "token_usage.timeline.empty"
 ];
+var TOKEN_USAGE_REPORT_I18N_KEYS = [
+  // Page + KPI tiles
+  "token_usage.report.title",
+  "token_usage.report.used_in_period",
+  "token_usage.report.vs_previous",
+  "token_usage.report.monthly_left",
+  "token_usage.report.extra_credits",
+  "token_usage.report.calls",
+  // Panel titles
+  "token_usage.report.usage_over_time",
+  "token_usage.report.by_operation",
+  // Shared states
+  "token_usage.report.no_data"
+];
+
+// src/features/tokenusage/contexts/TokenUsageReportContext.tsx
+import { useTranslations as useTranslations8 } from "next-intl";
+import { createContext as createContext2, useCallback as useCallback2, useContext as useContext2, useEffect as useEffect2, useMemo as useMemo6, useState as useState3 } from "react";
+
+// src/features/tokenusage/components/TokenUsageReportFilterBar.tsx
+import { jsx as jsx8 } from "react/jsx-runtime";
+function TokenUsageReportFilterBar({ onChange }) {
+  return /* @__PURE__ */ jsx8("div", { className: "flex flex-wrap items-center gap-2", children: /* @__PURE__ */ jsx8(
+    DateRangeSelector,
+    {
+      onDateChange: (range) => {
+        if (!range?.from || !range?.to) return;
+        onChange({ from: range.from.toISOString(), to: range.to.toISOString() });
+      }
+    }
+  ) });
+}
+__name(TokenUsageReportFilterBar, "TokenUsageReportFilterBar");
+
+// src/features/tokenusage/contexts/TokenUsageReportContext.tsx
+import { jsx as jsx9 } from "react/jsx-runtime";
+var TOKEN_USAGE_REPORT_PAGE_URL = "/tokenusage";
+var DEFAULT_TOP_N2 = 10;
+var REPORT_METRIC = "credits";
+var TokenUsageReportContext = createContext2(void 0);
+function defaultRange2() {
+  const now = /* @__PURE__ */ new Date();
+  const start = new Date(now.getFullYear(), now.getMonth(), 1, 0, 0, 0, 0);
+  return { from: start.toISOString(), to: now.toISOString() };
+}
+__name(defaultRange2, "defaultRange");
+var TokenUsageReportProvider = /* @__PURE__ */ __name(({
+  children,
+  targetLabel,
+  targetPanelTitleKey,
+  initialFrom,
+  initialTo,
+  topN = DEFAULT_TOP_N2,
+  pageUrl = TOKEN_USAGE_REPORT_PAGE_URL
+}) => {
+  const t = useTranslations8();
+  const generateUrl = usePageUrlGenerator();
+  const [filters, setFilterState] = useState3(() => {
+    const range = defaultRange2();
+    return { from: initialFrom ?? range.from, to: initialTo ?? range.to };
+  });
+  const [summary, setSummary] = useState3([]);
+  const [timeline, setTimeline] = useState3([]);
+  const [byOperation, setByOperation] = useState3([]);
+  const [byTarget, setByTarget] = useState3([]);
+  const [isLoading, setIsLoading] = useState3(true);
+  const [error, setError] = useState3(null);
+  const { from, to } = filters;
+  useEffect2(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    const base = { from, to };
+    Promise.all([
+      TokenUsageReportService.getSummary(base),
+      // granularity is pinned to "day": week/month bucketing buys nothing on the
+      // ranges a single tenant browses.
+      TokenUsageReportService.getTimeline({ ...base, granularity: "day" }),
+      TokenUsageReportService.getBreakdown({ ...base, dimension: "operation", metric: REPORT_METRIC, limit: topN }),
+      // No targetLabel means the host app never opted in, so the request is
+      // skipped entirely rather than issued and discarded.
+      targetLabel ? TokenUsageReportService.getBreakdown({
+        ...base,
+        dimension: "target",
+        targetLabel,
+        metric: REPORT_METRIC,
+        limit: topN
+      }) : Promise.resolve([])
+    ]).then(([nextSummary, nextTimeline, nextByOperation, nextByTarget]) => {
+      if (cancelled) return;
+      setSummary(nextSummary ?? []);
+      setTimeline(nextTimeline ?? []);
+      setByOperation(nextByOperation ?? []);
+      setByTarget(nextByTarget ?? []);
+    }).catch((err) => {
+      if (cancelled) return;
+      console.error("Failed to load token usage:", err);
+      setError(err instanceof Error ? err.message : String(err));
+    }).finally(() => {
+      if (cancelled) return;
+      setIsLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [from, to, targetLabel, topN]);
+  const setFilters = useCallback2((next) => {
+    setFilterState((prev) => ({ ...prev, ...next }));
+  }, []);
+  const breadcrumb = /* @__PURE__ */ __name(() => [
+    { name: t("token_usage.report.title"), href: generateUrl({ page: pageUrl }) }
+  ], "breadcrumb");
+  const title = /* @__PURE__ */ __name(() => ({
+    type: t("token_usage.report.title"),
+    functions: /* @__PURE__ */ jsx9(TokenUsageReportFilterBar, { onChange: setFilters }, "tokenUsageReportFilterBar")
+  }), "title");
+  const contextValue = useMemo6(
+    () => ({ summary, timeline, byOperation, byTarget, targetPanelTitleKey, filters, setFilters, isLoading, error }),
+    [summary, timeline, byOperation, byTarget, targetPanelTitleKey, filters, setFilters, isLoading, error]
+  );
+  return /* @__PURE__ */ jsx9(SharedProvider, { value: { breadcrumbs: breadcrumb(), title: title() }, children: /* @__PURE__ */ jsx9(TokenUsageReportContext.Provider, { value: contextValue, children }) });
+}, "TokenUsageReportProvider");
+var useTokenUsageReport = /* @__PURE__ */ __name(() => {
+  const ctx = useContext2(TokenUsageReportContext);
+  if (!ctx) {
+    throw new Error("useTokenUsageReport() called outside <TokenUsageReportProvider>.");
+  }
+  return ctx;
+}, "useTokenUsageReport");
+
+// src/features/tokenusage/components/TokenUsageReportContainer.tsx
+import { useTranslations as useTranslations10 } from "next-intl";
+
+// src/features/tokenusage/components/TokenUsageReportTiles.tsx
+import { ArrowDownIcon as ArrowDownIcon3, ArrowUpIcon as ArrowUpIcon3 } from "lucide-react";
+import { useTranslations as useTranslations9 } from "next-intl";
+import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
+var ZERO2 = { cost: 0, credits: 0, tokensIn: 0, tokensOut: 0, cached: 0, calls: 0 };
+function TokenUsageReportTiles({ summary, metric, balances }) {
+  const t = useTranslations9();
+  const { decimal, metricValue: formatValue } = useUsageFormatters();
+  const rowFor = /* @__PURE__ */ __name((window) => summary.find((row) => row.window === window) ?? ZERO2, "rowFor");
+  const current = rowFor("current");
+  const previous = rowFor("previous");
+  const monthlyPercentage = balances && balances.monthlyCredits > 0 ? balances.availableMonthlyCredits / balances.monthlyCredits * 100 : 0;
+  const monthlyColor = monthlyPercentage > 75 ? "text-success" : monthlyPercentage >= 5 ? "text-warning" : "text-destructive";
+  const whole = /* @__PURE__ */ __name((value) => decimal(Math.max(0, Math.floor(value)), 0), "whole");
+  return /* @__PURE__ */ jsxs7("div", { className: "grid gap-3", children: [
+    /* @__PURE__ */ jsx10(Card, { "data-testid": "tile-used", children: /* @__PURE__ */ jsxs7(CardContent, { className: "grid gap-1", children: [
+      /* @__PURE__ */ jsx10("span", { className: "text-muted-foreground text-xs", children: t("token_usage.report.used_in_period") }),
+      /* @__PURE__ */ jsx10("span", { className: "text-primary text-xl font-semibold tabular-nums", children: formatValue(metricValue(current, metric), metric) }),
+      /* @__PURE__ */ jsxs7("span", { className: "flex items-center gap-1", children: [
+        /* @__PURE__ */ jsx10(
+          Delta2,
+          {
+            testId: "tile-used-delta",
+            delta: percentageDelta(metricValue(current, metric), metricValue(previous, metric)),
+            decimal
+          }
+        ),
+        /* @__PURE__ */ jsx10("span", { className: "text-muted-foreground text-xs", children: t("token_usage.report.vs_previous") })
+      ] })
+    ] }) }),
+    /* @__PURE__ */ jsxs7("div", { className: "grid gap-3 sm:grid-cols-3", children: [
+      balances && /* @__PURE__ */ jsx10(Card, { "data-testid": "tile-monthly", size: "sm", children: /* @__PURE__ */ jsxs7(CardContent, { className: "grid gap-1", children: [
+        /* @__PURE__ */ jsx10("span", { className: "text-muted-foreground text-xs", children: t("token_usage.report.monthly_left") }),
+        /* @__PURE__ */ jsxs7("span", { className: "flex items-baseline gap-1", children: [
+          /* @__PURE__ */ jsx10("span", { "data-testid": "tile-monthly-value", className: cn("text-sm font-medium tabular-nums", monthlyColor), children: whole(balances.availableMonthlyCredits) }),
+          /* @__PURE__ */ jsxs7("span", { className: "text-muted-foreground text-xs tabular-nums", children: [
+            "/ ",
+            whole(balances.monthlyCredits)
+          ] })
+        ] })
+      ] }) }),
+      balances && /* @__PURE__ */ jsx10(Card, { "data-testid": "tile-extra", size: "sm", children: /* @__PURE__ */ jsxs7(CardContent, { className: "grid gap-1", children: [
+        /* @__PURE__ */ jsx10("span", { className: "text-muted-foreground text-xs", children: t("token_usage.report.extra_credits") }),
+        /* @__PURE__ */ jsx10("span", { className: "text-sm font-medium tabular-nums", children: whole(balances.availableExtraCredits) })
+      ] }) }),
+      /* @__PURE__ */ jsx10(Card, { "data-testid": "tile-calls", size: "sm", children: /* @__PURE__ */ jsxs7(CardContent, { className: "grid gap-1", children: [
+        /* @__PURE__ */ jsx10("span", { className: "text-muted-foreground text-xs", children: t("token_usage.report.calls") }),
+        /* @__PURE__ */ jsx10("span", { className: "text-sm font-medium tabular-nums", children: decimal(current.calls, 0) })
+      ] }) })
+    ] })
+  ] });
+}
+__name(TokenUsageReportTiles, "TokenUsageReportTiles");
+function Delta2({
+  testId,
+  delta,
+  decimal
+}) {
+  if (delta === void 0) {
+    return /* @__PURE__ */ jsx10("span", { "data-testid": testId, className: "text-muted-foreground text-xs", children: "\u2014" });
+  }
+  const increased = delta >= 0;
+  const Icon = increased ? ArrowUpIcon3 : ArrowDownIcon3;
+  return /* @__PURE__ */ jsxs7(
+    "span",
+    {
+      "data-testid": testId,
+      className: cn(
+        "inline-flex items-center gap-0.5 text-xs tabular-nums",
+        increased ? "text-warning" : "text-success"
+      ),
+      children: [
+        /* @__PURE__ */ jsx10(Icon, { "aria-hidden": true, className: "size-3" }),
+        decimal(Math.abs(delta), 0),
+        " %"
+      ]
+    }
+  );
+}
+__name(Delta2, "Delta");
+
+// src/features/tokenusage/components/TokenUsageReportContainer.tsx
+import { jsx as jsx11, jsxs as jsxs8 } from "react/jsx-runtime";
+function TokenUsageReportContainer({ balances = null }) {
+  const t = useTranslations10();
+  const { summary, timeline, byOperation, byTarget, isLoading, error, targetPanelTitleKey } = useTokenUsageReport();
+  if (error) {
+    return /* @__PURE__ */ jsx11(RoundPageContainer, { fullWidth: true, forceHeader: true, children: /* @__PURE__ */ jsx11("div", { className: "p-4", children: /* @__PURE__ */ jsx11(Card, { children: /* @__PURE__ */ jsx11(CardContent, { children: /* @__PURE__ */ jsx11("p", { className: "text-destructive text-xs/relaxed", children: error }) }) }) }) });
+  }
+  if (isLoading) return /* @__PURE__ */ jsx11(RoundPageContainer, { fullWidth: true, forceHeader: true });
+  const emptyLabel = t("token_usage.report.no_data");
+  const targetTitle = targetPanelTitleKey && byTarget.length > 0 ? t(targetPanelTitleKey) : void 0;
+  return /* @__PURE__ */ jsx11(RoundPageContainer, { fullWidth: true, forceHeader: true, children: /* @__PURE__ */ jsxs8("div", { className: "flex w-full flex-col gap-4 p-4", children: [
+    /* @__PURE__ */ jsx11(TokenUsageReportTiles, { summary, metric: "credits", balances }),
+    /* @__PURE__ */ jsxs8(Card, { children: [
+      /* @__PURE__ */ jsx11(CardHeader, { children: /* @__PURE__ */ jsx11(CardTitle, { children: t("token_usage.report.usage_over_time") }) }),
+      /* @__PURE__ */ jsx11(CardContent, { children: /* @__PURE__ */ jsx11(TokenUsageTimelineChart, { rows: timeline, metric: "credits", stackBy: "type" }) })
+    ] }),
+    /* @__PURE__ */ jsxs8("div", { className: cn("grid gap-4", targetTitle && "md:grid-cols-2"), children: [
+      /* @__PURE__ */ jsxs8(Card, { children: [
+        /* @__PURE__ */ jsx11(CardHeader, { children: /* @__PURE__ */ jsx11(CardTitle, { children: t("token_usage.report.by_operation") }) }),
+        /* @__PURE__ */ jsx11(CardContent, { children: /* @__PURE__ */ jsx11(
+          TokenUsageRankedBar,
+          {
+            rows: byOperation,
+            metric: "credits",
+            emptyLabel,
+            labelsAreOperationTypes: true
+          }
+        ) })
+      ] }),
+      targetTitle && /* @__PURE__ */ jsxs8(Card, { children: [
+        /* @__PURE__ */ jsx11(CardHeader, { children: /* @__PURE__ */ jsx11(CardTitle, { children: targetTitle }) }),
+        /* @__PURE__ */ jsx11(CardContent, { children: /* @__PURE__ */ jsx11(TokenUsageRankedBar, { rows: byTarget, metric: "credits", emptyLabel }) })
+      ] })
+    ] })
+  ] }) });
+}
+__name(TokenUsageReportContainer, "TokenUsageReportContainer");
 export {
   TOKEN_USAGE_ADMIN_I18N_KEYS,
+  TOKEN_USAGE_REPORT_I18N_KEYS,
   TokenUsageAdminBreakdown,
   TokenUsageAdminBreakdownModule,
   TokenUsageAdminContainer,
@@ -1006,7 +1353,21 @@ export {
   TokenUsageAdminTimelineModule,
   TokenUsageBreakdownTable,
   TokenUsageRankedBar,
+  TokenUsageReportBreakdown,
+  TokenUsageReportContainer,
+  TokenUsageReportFilterBar,
+  TokenUsageReportProvider,
+  TokenUsageReportService,
+  TokenUsageReportSummary,
+  TokenUsageReportTiles,
+  TokenUsageReportTimeline,
   TokenUsageTimelineChart,
-  useTokenUsageAdmin
+  configureTokenUsage,
+  createUsageFormatters,
+  getTokenUsageCurrency,
+  tokenUsageModules,
+  useTokenUsageAdmin,
+  useTokenUsageReport,
+  useUsageFormatters
 };
 //# sourceMappingURL=index.mjs.map