@aglyn/plugins-ai 1.0.0-beta.143

package/src/lib/components/billing-ai-top-users.component.js

@@ -0,0 +1,304 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ 'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { aiAddonName, countCsvDataRows } from "@aglyn/aglyn";
+import { pluginDocsHelp } from "@aglyn/aglyn/app-utils/docs-help";
+import { mdiOpenInNew } from "@aglyn/shared-data-mdi";
+import { CardDisplay } from "@aglyn/shared-ui-jsx";
+import { ListRowActions, ListTable, listActionsColumn } from "@aglyn/shared-ui-jsx/components/list-table.component";
+import { TABLE_ROW_HEIGHT } from "@aglyn/shared-ui-jsx/const/table-pagination";
+import { useSnackbar } from "@aglyn/shared-ui-snackstack";
+import { authorizedFetch } from "@aglyn/shared-util-http/authorized-token";
+import { useUser } from "@aglyn/tenant-feature-instance";
+import { Alert, Button, MenuItem, Stack, TextField, Typography } from "@mui/material";
+import { buildRoute, Route } from "@aglyn/aglyn/app-utils/console-routes";
+import { useRouter } from "next/navigation";
+import { useCallback, useMemo, useState } from "react";
+import { topAiUsageKinds } from "../model/ai-usage-by-user.js";
+import { useOrgAiUsage } from "./use-org-ai-usage.js";
+import { AI_USAGE_EXPORT_ROWS_HEADER, aiUsageMonthLabel, formatAiUsageShare } from "../usage/ai-usage-wire.js";
+/**
+ * WHO IS GENERATING WHAT (AGL-2928) — the per-person table beneath the
+ * credit meter on Billing → Usage.
+ *
+ * The meter above says how much of the pool the workspace has drawn; this
+ * says who drew it. Each row is one member's month: credits, their share of
+ * the workspace's spend, requests, and how often the gate refused them. A
+ * month picker walks the retention window, and the file button hands the
+ * same month to a spreadsheet through the streamed export.
+ *
+ * ## The file is checked, not trusted
+ *
+ * The route promises its row count in a header taken before the first row
+ * is written. A stream that dies halfway yields a well-formed shorter file,
+ * so a body with fewer rows than promised is refused rather than saved.
+ *
+ * The copy stays descriptive on purpose — who, how much, on which site — and
+ * never characterizes what the numbers mean about a person.
+ */ export function BillingAiTopUsersComponent(props) {
+    var _ref;
+    var _usage_data;
+    const { orgId, orgSlug } = props;
+    const { data: user } = useUser();
+    const { enqueueSnackbar } = useSnackbar();
+    const [month, setMonth] = useState(undefined);
+    const [exporting, setExporting] = useState(false);
+    const usage = useOrgAiUsage(orgId, {
+        month
+    });
+    const router = useRouter();
+    const name = aiAddonName();
+    const handleExport = useCallback(async ()=>{
+        if (!orgId || exporting) return;
+        setExporting(true);
+        try {
+            var _response_headers_get;
+            const params = new URLSearchParams({
+                orgId,
+                month: usage.month,
+                format: 'csv'
+            });
+            const response = await authorizedFetch(user, `/api/ai/usage?${params.toString()}`);
+            if (!response.ok) {
+                var _ref;
+                const failure = await response.json().catch(()=>({}));
+                throw new Error((_ref = failure == null ? void 0 : failure.error) != null ? _ref : 'Export failed');
+            }
+            const text = await response.text();
+            const promised = Number((_response_headers_get = response.headers.get(AI_USAGE_EXPORT_ROWS_HEADER)) != null ? _response_headers_get : '');
+            const received = countCsvDataRows(text);
+            if (Number.isFinite(promised) && received < promised) {
+                enqueueSnackbar(`Export incomplete — ${received} of ${promised} rows arrived. ` + 'Nothing was saved; try again.', {
+                    variant: 'error'
+                });
+                return;
+            }
+            const url = URL.createObjectURL(new Blob([
+                text
+            ], {
+                type: 'text/csv'
+            }));
+            const anchor = document.createElement('a');
+            anchor.href = url;
+            anchor.download = `ai-usage-${usage.month}.csv`;
+            anchor.click();
+            URL.revokeObjectURL(url);
+        } catch (error) {
+            enqueueSnackbar(error instanceof Error ? error.message : 'Export failed', {
+                variant: 'error'
+            });
+        } finally{
+            setExporting(false);
+        }
+    }, [
+        orgId,
+        exporting,
+        usage.month,
+        user,
+        enqueueSnackbar
+    ]);
+    const rows = (_ref = (_usage_data = usage.data) == null ? void 0 : _usage_data.rows) != null ? _ref : [];
+    const memberHref = useCallback((uid)=>buildRoute(Route.MANAGE_TEAM_MEMBER, {
+            orgSlug,
+            uid
+        }), [
+        orgSlug
+    ]);
+    /*
+   * One row per member, and the whole month is in hand, so the grid pages,
+   * sorts and searches it itself. The row opens the member's page, which is
+   * where the split by site and by kind lives.
+   */ const columns = useMemo(()=>[
+            {
+                field: 'name',
+                headerName: 'Member',
+                flex: 1,
+                minWidth: 220,
+                renderCell: ({ row })=>/*#__PURE__*/ _jsxs(Stack, {
+                        sx: {
+                            minWidth: 0
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx(Typography, {
+                                variant: "body2",
+                                noWrap: true,
+                                title: row.name,
+                                children: row.name
+                            }),
+                            row.email && row.email !== row.name ? /*#__PURE__*/ _jsx(Typography, {
+                                variant: "caption",
+                                color: "text.secondary",
+                                noWrap: true,
+                                children: row.email
+                            }) : null
+                        ]
+                    })
+            },
+            {
+                field: 'credits',
+                headerName: 'Credits',
+                type: 'number',
+                align: 'right',
+                headerAlign: 'right',
+                width: 110,
+                valueFormatter: (value)=>value.toLocaleString()
+            },
+            {
+                field: 'share',
+                headerName: 'Share',
+                type: 'number',
+                align: 'right',
+                headerAlign: 'right',
+                width: 90,
+                valueFormatter: (value)=>formatAiUsageShare(value)
+            },
+            {
+                field: 'requests',
+                headerName: 'Requests',
+                type: 'number',
+                align: 'right',
+                headerAlign: 'right',
+                width: 110,
+                valueFormatter: (value)=>value.toLocaleString()
+            },
+            {
+                field: 'refusals',
+                headerName: 'Refusals',
+                type: 'number',
+                align: 'right',
+                headerAlign: 'right',
+                width: 110,
+                valueFormatter: (value)=>value.toLocaleString()
+            },
+            {
+                field: 'mostly',
+                headerName: 'Mostly',
+                flex: 1,
+                minWidth: 160,
+                sortable: false,
+                valueGetter: (_value, row)=>topAiUsageKinds(row.byKind, 2).map((entry)=>entry.kind).join(', ') || '—'
+            },
+            listActionsColumn((row)=>/*#__PURE__*/ _jsx(ListRowActions, {
+                    label: row.name,
+                    quick: {
+                        icon: mdiOpenInNew.path,
+                        label: 'View member',
+                        to: memberHref(row.uid)
+                    },
+                    items: []
+                }))
+        ], [
+        memberHref
+    ]);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1.5,
+        children: [
+            /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                children: `Who is generating what, per site: each member's ${name} credits for the month and their share of the workspace's spend. Open a member for the split by site and by kind.`
+            }),
+            /*#__PURE__*/ _jsxs(Stack, {
+                direction: "row",
+                spacing: 1,
+                sx: {
+                    alignItems: 'center',
+                    flexWrap: 'wrap',
+                    rowGap: 1
+                },
+                children: [
+                    /*#__PURE__*/ _jsx(TextField, {
+                        select: true,
+                        size: "small",
+                        label: "Month",
+                        value: usage.month,
+                        onChange: (event)=>setMonth(event.target.value),
+                        sx: {
+                            minWidth: 180
+                        },
+                        children: usage.months.map((key)=>/*#__PURE__*/ _jsx(MenuItem, {
+                                value: key,
+                                children: aiUsageMonthLabel(key)
+                            }, key))
+                    }),
+                    /*#__PURE__*/ _jsx(Button, {
+                        size: "small",
+                        disabled: exporting || usage.status !== 'ready' || rows.length === 0,
+                        onClick: ()=>void handleExport(),
+                        children: exporting ? 'Exporting…' : 'Export CSV'
+                    }),
+                    usage.data ? /*#__PURE__*/ _jsx(Typography, {
+                        variant: "caption",
+                        color: "text.secondary",
+                        children: `${usage.data.orgCredits.toLocaleString()} credits drawn by the workspace in ${aiUsageMonthLabel(usage.month)}`
+                    }) : null
+                ]
+            }),
+            usage.status === 'refused' ? /*#__PURE__*/ _jsx(Alert, {
+                severity: "info",
+                children: 'Seeing who used AI credits requires the View billing permission.'
+            }) : usage.status === 'error' ? /*#__PURE__*/ _jsx(Alert, {
+                severity: "warning",
+                children: 'Could not read this month’s per-member usage — a failed read, not zero usage.'
+            }) : usage.status === 'loading' && !usage.data ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                children: 'Loading…'
+            }) : rows.length === 0 ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                color: "text.secondary",
+                children: `No ${name} usage attributed to a member in ${aiUsageMonthLabel(usage.month)}.`
+            }) : /*#__PURE__*/ _jsx(ListTable, {
+                rows: rows,
+                columns: columns,
+                getRowId: (row)=>row.uid,
+                rowHeight: TABLE_ROW_HEIGHT,
+                onOpen: (uid)=>router.push(memberHref(uid))
+            }, usage.month)
+        ]
+    });
+}
+BillingAiTopUsersComponent.displayName = 'BillingAiTopUsersComponent';
+/**
+ * The card on Billing → Usage, through the `orgBillingUsage` zone: its own
+ * band beneath the meters, full width, because it is a table of people rather
+ * than a gauge. Registered with `billing.view`, so a manager without it sees
+ * no card rather than a refusal.
+ */ export function AiTopUsersCard(props) {
+    var _ref;
+    var _props_org;
+    return /*#__PURE__*/ _jsx("div", {
+        id: "ai-usage-by-member",
+        children: /*#__PURE__*/ _jsx(CardDisplay, {
+            header: 'Who is generating what',
+            help: pluginDocsHelp('billing', {
+                anchor: '#who-is-generating-what',
+                excerpt: 'Each member’s AI credits for a month, their share of the ' + 'workspace’s spend, requests and refusals — with a month picker ' + 'and a CSV export.'
+            }),
+            contentGutterX: true,
+            contentGutterY: true,
+            children: /*#__PURE__*/ _jsx(BillingAiTopUsersComponent, {
+                orgId: props.orgId,
+                orgSlug: (_ref = (_props_org = props.org) == null ? void 0 : _props_org.slug) != null ? _ref : ''
+            })
+        })
+    });
+}
+AiTopUsersCard.displayName = 'AiTopUsersCard';
+export default BillingAiTopUsersComponent;
+
+//# sourceMappingURL=billing-ai-top-users.component.js.map

package/src/lib/components/billing-ai-top-users.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/ai/src/lib/components/billing-ai-top-users.component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n'use client'\n\nimport { aiAddonName, countCsvDataRows } from '@aglyn/aglyn'\nimport { pluginDocsHelp } from '@aglyn/aglyn/app-utils/docs-help'\nimport { mdiOpenInNew } from '@aglyn/shared-data-mdi'\nimport { CardDisplay } from '@aglyn/shared-ui-jsx'\nimport {\n  ListRowActions,\n  ListTable,\n  listActionsColumn,\n} from '@aglyn/shared-ui-jsx/components/list-table.component'\nimport { TABLE_ROW_HEIGHT } from '@aglyn/shared-ui-jsx/const/table-pagination'\nimport { useSnackbar } from '@aglyn/shared-ui-snackstack'\nimport { authorizedFetch } from '@aglyn/shared-util-http/authorized-token'\nimport { useUser } from '@aglyn/tenant-feature-instance'\nimport {\n  Alert,\n  Button,\n  MenuItem,\n  Stack,\n  TextField,\n  Typography,\n} from '@mui/material'\nimport type { GridColDef } from '@mui/x-data-grid'\nimport { buildRoute, Route } from '@aglyn/aglyn/app-utils/console-routes'\nimport { useRouter } from 'next/navigation'\nimport { useCallback, useMemo, useState } from 'react'\nimport { topAiUsageKinds } from '../model/ai-usage-by-user'\nimport { useOrgAiUsage } from './use-org-ai-usage'\nimport {\n  AI_USAGE_EXPORT_ROWS_HEADER,\n  aiUsageMonthLabel,\n  formatAiUsageShare,\n  type OrgAiUsageRowWire,\n} from '../usage/ai-usage-wire'\n\nexport interface BillingAiTopUsersProps {\n  orgId: string | undefined\n  /** The org's slug, for the links into each person's page. */\n  orgSlug: string\n}\n\n/**\n * WHO IS GENERATING WHAT (AGL-2928) — the per-person table beneath the\n * credit meter on Billing → Usage.\n *\n * The meter above says how much of the pool the workspace has drawn; this\n * says who drew it. Each row is one member's month: credits, their share of\n * the workspace's spend, requests, and how often the gate refused them. A\n * month picker walks the retention window, and the file button hands the\n * same month to a spreadsheet through the streamed export.\n *\n * ## The file is checked, not trusted\n *\n * The route promises its row count in a header taken before the first row\n * is written. A stream that dies halfway yields a well-formed shorter file,\n * so a body with fewer rows than promised is refused rather than saved.\n *\n * The copy stays descriptive on purpose — who, how much, on which site — and\n * never characterizes what the numbers mean about a person.\n */\nexport function BillingAiTopUsersComponent(props: BillingAiTopUsersProps) {\n  const { orgId, orgSlug } = props\n  const { data: user } = useUser()\n  const { enqueueSnackbar } = useSnackbar()\n  const [month, setMonth] = useState<string | undefined>(undefined)\n  const [exporting, setExporting] = useState(false)\n  const usage = useOrgAiUsage(orgId, { month })\n  const router = useRouter()\n  const name = aiAddonName()\n\n  const handleExport = useCallback(async () => {\n    if (!orgId || exporting) return\n    setExporting(true)\n    try {\n      const params = new URLSearchParams({ orgId, month: usage.month, format: 'csv' })\n      const response = await authorizedFetch(\n        user,\n        `/api/ai/usage?${params.toString()}`,\n      )\n      if (!response.ok) {\n        const failure = await response.json().catch(() => ({}))\n        throw new Error(failure?.error ?? 'Export failed')\n      }\n      const text = await response.text()\n      const promised = Number(response.headers.get(AI_USAGE_EXPORT_ROWS_HEADER) ?? '')\n      const received = countCsvDataRows(text)\n      if (Number.isFinite(promised) && received < promised) {\n        enqueueSnackbar(\n          `Export incomplete — ${received} of ${promised} rows arrived. ` +\n            'Nothing was saved; try again.',\n          { variant: 'error' },\n        )\n        return\n      }\n      const url = URL.createObjectURL(new Blob([text], { type: 'text/csv' }))\n      const anchor = document.createElement('a')\n      anchor.href = url\n      anchor.download = `ai-usage-${usage.month}.csv`\n      anchor.click()\n      URL.revokeObjectURL(url)\n    } catch (error) {\n      enqueueSnackbar(error instanceof Error ? error.message : 'Export failed', {\n        variant: 'error',\n      })\n    } finally {\n      setExporting(false)\n    }\n  }, [orgId, exporting, usage.month, user, enqueueSnackbar])\n\n  const rows = usage.data?.rows ?? []\n  const memberHref = useCallback(\n    (uid: string) => buildRoute(Route.MANAGE_TEAM_MEMBER, { orgSlug, uid }),\n    [orgSlug],\n  )\n\n  /*\n   * One row per member, and the whole month is in hand, so the grid pages,\n   * sorts and searches it itself. The row opens the member's page, which is\n   * where the split by site and by kind lives.\n   */\n  const columns = useMemo<GridColDef<OrgAiUsageRowWire>[]>(\n    () => [\n      {\n        field: 'name',\n        headerName: 'Member',\n        flex: 1,\n        minWidth: 220,\n        renderCell: ({ row }) => (\n          <Stack sx={{ minWidth: 0 }}>\n            <Typography variant=\"body2\" noWrap title={row.name}>\n              {row.name}\n            </Typography>\n            {row.email && row.email !== row.name ? (\n              <Typography variant=\"caption\" color=\"text.secondary\" noWrap>\n                {row.email}\n              </Typography>\n            ) : null}\n          </Stack>\n        ),\n      },\n      {\n        field: 'credits',\n        headerName: 'Credits',\n        type: 'number',\n        align: 'right',\n        headerAlign: 'right',\n        width: 110,\n        valueFormatter: (value: number) => value.toLocaleString(),\n      },\n      {\n        field: 'share',\n        headerName: 'Share',\n        type: 'number',\n        align: 'right',\n        headerAlign: 'right',\n        width: 90,\n        valueFormatter: (value: number) => formatAiUsageShare(value),\n      },\n      {\n        field: 'requests',\n        headerName: 'Requests',\n        type: 'number',\n        align: 'right',\n        headerAlign: 'right',\n        width: 110,\n        valueFormatter: (value: number) => value.toLocaleString(),\n      },\n      {\n        field: 'refusals',\n        headerName: 'Refusals',\n        type: 'number',\n        align: 'right',\n        headerAlign: 'right',\n        width: 110,\n        valueFormatter: (value: number) => value.toLocaleString(),\n      },\n      {\n        field: 'mostly',\n        headerName: 'Mostly',\n        flex: 1,\n        minWidth: 160,\n        sortable: false,\n        valueGetter: (_value, row) =>\n          topAiUsageKinds(row.byKind, 2)\n            .map((entry) => entry.kind)\n            .join(', ') || '—',\n      },\n      listActionsColumn((row: OrgAiUsageRowWire) => (\n        <ListRowActions\n          label={row.name}\n          quick={{\n            icon: mdiOpenInNew.path,\n            label: 'View member',\n            to: memberHref(row.uid),\n          }}\n          items={[]}\n        />\n      )),\n    ],\n    [memberHref],\n  )\n\n  return (\n    <Stack spacing={1.5}>\n      <Typography variant=\"body2\" color=\"text.secondary\">\n        {`Who is generating what, per site: each member's ${name} credits for the month and their share of the workspace's spend. Open a member for the split by site and by kind.`}\n      </Typography>\n      <Stack direction=\"row\" spacing={1} sx={{ alignItems: 'center', flexWrap: 'wrap', rowGap: 1 }}>\n        <TextField\n          select\n          size=\"small\"\n          label=\"Month\"\n          value={usage.month}\n          onChange={(event) => setMonth(event.target.value)}\n          sx={{ minWidth: 180 }}\n        >\n          {usage.months.map((key) => (\n            <MenuItem key={key} value={key}>\n              {aiUsageMonthLabel(key)}\n            </MenuItem>\n          ))}\n        </TextField>\n        <Button\n          size=\"small\"\n          disabled={exporting || usage.status !== 'ready' || rows.length === 0}\n          onClick={() => void handleExport()}\n        >\n          {exporting ? 'Exporting…' : 'Export CSV'}\n        </Button>\n        {usage.data ? (\n          <Typography variant=\"caption\" color=\"text.secondary\">\n            {`${usage.data.orgCredits.toLocaleString()} credits drawn by the workspace in ${aiUsageMonthLabel(usage.month)}`}\n          </Typography>\n        ) : null}\n      </Stack>\n      {usage.status === 'refused' ? (\n        <Alert severity=\"info\">\n          {'Seeing who used AI credits requires the View billing permission.'}\n        </Alert>\n      ) : usage.status === 'error' ? (\n        <Alert severity=\"warning\">\n          {'Could not read this month’s per-member usage — a failed read, not zero usage.'}\n        </Alert>\n      ) : usage.status === 'loading' && !usage.data ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {'Loading…'}\n        </Typography>\n      ) : rows.length === 0 ? (\n        <Typography variant=\"body2\" color=\"text.secondary\">\n          {`No ${name} usage attributed to a member in ${aiUsageMonthLabel(usage.month)}.`}\n        </Typography>\n      ) : (\n        <ListTable\n          // Another month is another list: it opens on its first page.\n          key={usage.month}\n          rows={rows}\n          columns={columns}\n          getRowId={(row: OrgAiUsageRowWire) => row.uid}\n          rowHeight={TABLE_ROW_HEIGHT}\n          onOpen={(uid) => router.push(memberHref(uid))}\n        />\n      )}\n    </Stack>\n  )\n}\nBillingAiTopUsersComponent.displayName = 'BillingAiTopUsersComponent'\n\n/**\n * The card on Billing → Usage, through the `orgBillingUsage` zone: its own\n * band beneath the meters, full width, because it is a table of people rather\n * than a gauge. Registered with `billing.view`, so a manager without it sees\n * no card rather than a refusal.\n */\nexport function AiTopUsersCard(props: { orgId?: string; org?: { slug?: string } | null }) {\n  return (\n    <div id=\"ai-usage-by-member\">\n      <CardDisplay\n        header={'Who is generating what'}\n        help={pluginDocsHelp('billing', {\n          anchor: '#who-is-generating-what',\n          excerpt:\n            'Each member’s AI credits for a month, their share of the ' +\n            'workspace’s spend, requests and refusals — with a month picker ' +\n            'and a CSV export.',\n        })}\n        contentGutterX\n        contentGutterY\n      >\n        <BillingAiTopUsersComponent orgId={props.orgId} orgSlug={props.org?.slug ?? ''} />\n      </CardDisplay>\n    </div>\n  )\n}\nAiTopUsersCard.displayName = 'AiTopUsersCard'\n\nexport default BillingAiTopUsersComponent\n"],"names":["aiAddonName","countCsvDataRows","pluginDocsHelp","mdiOpenInNew","CardDisplay","ListRowActions","ListTable","listActionsColumn","TABLE_ROW_HEIGHT","useSnackbar","authorizedFetch","useUser","Alert","Button","MenuItem","Stack","TextField","Typography","buildRoute","Route","useRouter","useCallback","useMemo","useState","topAiUsageKinds","useOrgAiUsage","AI_USAGE_EXPORT_ROWS_HEADER","aiUsageMonthLabel","formatAiUsageShare","BillingAiTopUsersComponent","props","usage","orgId","orgSlug","data","user","enqueueSnackbar","month","setMonth","undefined","exporting","setExporting","router","name","handleExport","response","params","URLSearchParams","format","toString","ok","failure","json","catch","Error","error","text","promised","Number","headers","get","received","isFinite","variant","url","URL","createObjectURL","Blob","type","anchor","document","createElement","href","download","click","revokeObjectURL","message","rows","memberHref","uid","MANAGE_TEAM_MEMBER","columns","field","headerName","flex","minWidth","renderCell","row","sx","noWrap","title","email","color","align","headerAlign","width","valueFormatter","value","toLocaleString","sortable","valueGetter","_value","byKind","map","entry","kind","join","label","quick","icon","path","to","items","spacing","direction","alignItems","flexWrap","rowGap","select","size","onChange","event","target","months","key","disabled","status","length","onClick","orgCredits","severity","getRowId","rowHeight","onOpen","push","displayName","AiTopUsersCard","div","id","header","help","excerpt","contentGutterX","contentGutterY","org","slug"],"mappings":"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"}

package/src/lib/components/billing-assist-overage-card.component.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export interface BillingAssistOverageCardProps {
+    orgId?: string | null;
+    /** billing.manage: the switch acts; view-only otherwise. */
+    canManage: boolean;
+}
+/**
+ * The org's own controls on AI assist spend: the hard cap at the band
+ * (AGL-2653) and the dollar ceiling on overage (AGL-2898).
+ *
+ * ## What this card is
+ *
+ * Credits past a plan's included assist band are SOLD by default, at the
+ * plan's per-1,000 rate, the way storage past its band bills by default. This
+ * card offers the two controls a customer has over that: a switch that makes
+ * the band a wall, so the assistant refuses there and nothing past it is ever
+ * billed; and, with the switch off, a monthly ceiling in dollars on the
+ * overage the org will buy before the assistant stops. Both are optional and
+ * unset unless chosen — the storage cap's siblings, for the same reason a
+ * ceiling on metered spend is the END USER's control, offered rather than
+ * imposed.
+ *
+ * ## Why a switch AND a number
+ *
+ * The switch answers "sell past the band at all?" and needs no figure: the
+ * band is the plan's, and a second band here would drift from it. The
+ * ceiling answers "and if so, how much?", which is a figure only the customer
+ * can name — it is a bound on THEIR invoice, not a quantity the plan sold.
+ * The ceiling is offered only while the switch is off, because past a wall
+ * there is no overage to bound.
+ *
+ * ## Why the switch is edited here and enforced there
+ *
+ * The route owns every refusal: a plan that sells no overage, a value that
+ * is not a boolean, a missing permission. This card sends the boolean and
+ * renders the route's own answer rather than pre-validating against constants
+ * that would then be a second source of truth. The rate it quotes arrives on
+ * the same payload, so what the card says the overage costs is what the
+ * invoice bills.
+ *
+ * ## Why turning it OFF is confirmed and turning it ON is not
+ *
+ * Off is the direction that can raise a bill, so it asks; on never raises
+ * one, so it is a plain click. Off is also always available, on any plan and
+ * from any state — an org that wants the sale back must not have to argue
+ * with a precondition.
+ */
+/**
+ * The card as the Billing → Usage page's plugin band mounts it (AGL-2939):
+ * the overage controls under the heading and help the page used to draw
+ * around them.
+ */
+export default function BillingAssistOverageCard(props: BillingAssistOverageCardProps): import("react").JSX.Element;
+export declare function BillingAssistOverageControls({ orgId, canManage, }: BillingAssistOverageCardProps): import("react").JSX.Element;