loopable / web /src /apps /amazon-operator /WastedSpend.tsx
fsanyoto's picture
Deploy AIOS web (React glide grid + FastAPI slice)
85f794d verified
Raw History Blame Contribute Delete
12.3 kB
import { useCallback, useEffect, useRef, useState } from "react";
import type { HTMLAttributes } from "react";
import { API_V1, CREDENTIALS } from "../../apiContract";
import { ModeIcon, useOverlayLayer } from "../../customer-grid/seam";
import "../../styles/sdlc81/operator-wasted.css";
interface Term {
id: string; term: string; spend: number; clicks: number; campaign_id: string; campaign?: string;
ad_type: string; profile_id: string; connection_id?: string; ad_group_id: string;
outcome: { status: string; cause: string | null } | null;
}
interface Group {
id: string; label: string; cost: number; term_count: number; reason: string | null; digest: string;
status: string; decided_by: string | null; decided_at: string | null;
terms: Term[]; terms_cursor: string | null;
}
interface Report {
digest: string | null; state: string; reason: string | null; groups: Group[]; cursor: string | null;
total_spend: number | null; group_count: number; term_count: number; window_days?: number;
}
type Load = { phase: "loading" } | { phase: "error"; message: string; denied: boolean }
| { phase: "ready"; report: Report };
type GridHook = () => { selected: string; table: HTMLAttributes<HTMLTableElement> };
const money = (value: number | null) => value === null ? "Unavailable" : new Intl.NumberFormat(undefined,
{ minimumFractionDigits: 2, maximumFractionDigits: 2 }).format(value);
const statusLabel = (status: string) => ({ proposed: "Proposed", sending: "Sending", sent: "Sent",
refused: "Refused", partial: "Partly sent", unknown: "Outcome unknown" })[status] || status;
async function request(url: string, options: RequestInit = {}) {
const response = await fetch(url, { credentials: CREDENTIALS, ...options });
const body = await response.json().catch(() => null);
if (!response.ok) throw Object.assign(new Error(body?.detail?.error?.message || "Wasted spend could not be loaded."),
{ denied: response.status === 403 || response.status === 404 });
return body;
}
function TermGrid({ group, useGridSelection }: { group: Group; useGridSelection: GridHook }) {
const grid = useGridSelection();
return <div className="ao-grid-viewport"><table {...grid.table} className="ao-table ao-wasted-terms" aria-label="Negative terms grid">
<thead><tr><th scope="col">#</th><th scope="col">Term</th><th scope="col">Spend</th><th scope="col">Clicks</th>
<th scope="col">Campaign</th><th scope="col">Ad group</th><th scope="col">Profile</th>
<th scope="col">Match type</th><th scope="col">Outcome</th></tr></thead>
<tbody>{group.terms.map((term, index) => <tr className="ao-row" key={term.id} data-row-id={term.id}
aria-selected={grid.selected === term.id}>
<td className="ao-grid-marker">{index + 1}</td><td>{term.term}</td><td className="is-num">{money(term.spend)}</td>
<td className="is-num">{term.clicks}</td><td>{term.campaign || term.campaign_id}<small>{term.campaign_id}</small></td>
<td>{term.ad_group_id}</td><td>{term.profile_id || "Unavailable"}<small>{term.ad_type}</small>
{term.connection_id && <small>{term.connection_id}</small>}</td>
<td>Negative exact</td><td data-outcome={term.outcome?.status}>
{statusLabel(term.outcome?.status || "proposed")}{term.outcome?.cause && <small>{term.outcome.cause}</small>}</td>
</tr>)}</tbody>
</table></div>;
}
function GroupDetail({ initial, endpoint, useGridSelection, onClose }: {
initial: Group; endpoint: (params: Record<string, string>) => string; useGridSelection: GridHook; onClose: () => void;
}) {
const [group, setGroup] = useState(initial);
const [busy, setBusy] = useState(false), [error, setError] = useState("");
const panel = useRef<HTMLElement | null>(null);
const alive = useRef(true);
useEffect(() => { alive.current = true; return () => { alive.current = false; }; }, []);
useOverlayLayer({ panelRef: panel, onDismiss: onClose, dismissOnOutside: false, trapFocus: true, restoreFocus: true });
const more = async () => {
if (!group.terms_cursor || busy) return;
setBusy(true); setError("");
try {
const report: Report = await request(endpoint({ group_id: group.id, terms_cursor: group.terms_cursor }));
const next = report.groups[0];
if (!next || next.digest !== group.digest) throw new Error("These groups changed. Close details and reload wasted spend.");
if (alive.current) setGroup({ ...next, terms: [...group.terms, ...next.terms] });
} catch (reason) {
if (alive.current) setError(reason instanceof Error ? reason.message : "Terms could not be loaded.");
} finally { if (alive.current) setBusy(false); }
};
return <aside ref={panel} role="dialog" aria-modal="true" aria-label="Wasted spend group"
className="ao-drawer ao-wasted-detail" data-surface="operator-wasted-detail">
<div className="ao-drawer-head"><h2 className="ao-drawer-title">{group.label}</h2>
<button type="button" className="ao-button is-quiet" onClick={onClose}>Close</button></div>
<p>{money(group.cost)} spend 路 {group.term_count} {group.term_count === 1 ? "term" : "terms"} 路 Negative exact</p>
<p role="status">{statusLabel(group.status)}{group.decided_by && ` by ${group.decided_by}`}</p>
{group.reason && <p>{group.reason}</p>}
<TermGrid group={group} useGridSelection={useGridSelection} />
{error && <p className="ao-error" role="alert">{error}</p>}
{group.terms_cursor && <button type="button" className="ao-button is-quiet" disabled={busy} onClick={() => void more()}>
{busy ? "Loading terms" : "More terms"}</button>}
</aside>;
}
export default function WastedSpend({ appId, editable, useGridSelection, onDecided }: {
appId: string; editable: boolean; useGridSelection: GridHook; onDecided: () => void;
}) {
const [load, setLoad] = useState<Load>({ phase: "loading" });
const [attempt, setAttempt] = useState(0), [cursors, setCursors] = useState<(string | null)[]>([null]);
const [opened, setOpened] = useState<Group | null>(null), [sending, setSending] = useState("");
const [error, setError] = useState("");
const pending = useRef(false), alive = useRef(true);
const grid = useGridSelection();
useEffect(() => { alive.current = true; return () => { alive.current = false; }; }, []);
const endpoint = useCallback((params: Record<string, string> = {}) =>
`${API_V1}/app-kinds/amazon_operator/wasted?${new URLSearchParams({ app: appId, limit: "50", ...params })}`, [appId]);
const cursor = cursors[cursors.length - 1];
useEffect(() => {
const controller = new AbortController();
setLoad({ phase: "loading" });
void request(endpoint(cursor ? { cursor } : {}), { signal: controller.signal }).then((report: Report) => {
if (!report || !Array.isArray(report.groups)) throw new Error("Wasted spend is unavailable.");
if (!controller.signal.aborted) setLoad({ phase: "ready", report });
}).catch((reason: unknown) => {
if (!controller.signal.aborted) setLoad({ phase: "error", message: reason instanceof Error ? reason.message
: "Wasted spend could not be loaded.", denied: (reason as { denied?: boolean })?.denied === true });
});
return () => controller.abort();
}, [endpoint, cursor, attempt]);
const approve = async (group: Group) => {
if (!editable || pending.current || group.status !== "proposed") return;
pending.current = true; setSending(group.id); setError("");
try {
await request(`${API_V1}/app-kinds/amazon_operator/wasted/${encodeURIComponent(group.id)}/approve?${new URLSearchParams({ app: appId })}`,
{ method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ digest: group.digest }) });
} catch (reason) {
if (alive.current) setError(reason instanceof Error ? reason.message : "Approval outcome is unavailable. Reload wasted spend.");
} finally {
pending.current = false;
if (alive.current) { setSending(""); setAttempt((value) => value + 1); onDecided(); }
}
};
return <section className="ao-view ao-grid-shell ao-wasted" data-surface="operator-wasted-spend" aria-busy={!!sending}>
<div className="ao-grid-toolbar"><span className="ao-grid-view"><ModeIcon mode="grid" />Grid view</span>
<span>Wasted spend</span><button className="ao-button is-quiet" type="button" disabled={!!sending}
onClick={() => { setCursors([null]); setAttempt((value) => value + 1); }}>Reload</button></div>
{error && <p className="ao-error" role="alert">{error}</p>}
{load.phase === "loading" ? <div className="ao-empty" role="status" aria-label="Loading wasted spend">
<span className="lp-spin lp-spin--lg" aria-hidden="true" /></div>
: load.phase === "error" ? <p className="ao-error" role="alert">{load.denied ? "You do not have access to wasted spend." : load.message}</p>
: <>
<div className="ao-bar ao-wasted-summary"><strong>{money(load.report.total_spend)}</strong><span>Wasted spend</span>
<span>{load.report.term_count} {load.report.term_count === 1 ? "term" : "terms"} 路 {load.report.group_count} {load.report.group_count === 1 ? "group" : "groups"}</span>
{load.report.window_days && <span>{load.report.window_days} {load.report.window_days === 1 ? "day" : "days"}</span>}</div>
{load.report.reason && <p role="status">{load.report.reason}</p>}
{!load.report.groups.length ? <p className="ao-empty" role="status">{load.report.state === "empty"
? "No wasted spend" : load.report.reason || "No wasted spend"}</p>
: <div className="ao-grid-viewport"><table {...grid.table} className="ao-table ao-wasted-grid" aria-label="Wasted spend grid">
<thead><tr><th scope="col">#</th><th scope="col">Group</th><th scope="col">Spend</th><th scope="col">Terms</th>
<th scope="col">Proposed negatives</th><th scope="col">Match type</th><th scope="col">Outcome</th>
{editable && <th scope="col">Approval</th>}</tr></thead>
<tbody>{load.report.groups.map((group, index) => <tr className="ao-row" key={group.id} data-row-id={group.id}
aria-selected={grid.selected === group.id} data-status={group.status}>
<td className="ao-grid-marker">{(cursors.length - 1) * 50 + index + 1}</td><td><button type="button"
className="ao-open" onClick={() => setOpened(group)}>{group.label}</button></td>
<td className="is-num">{money(group.cost)}</td><td className="is-num">{group.term_count}</td>
<td><button type="button" className="ao-link ao-wasted-preview" onClick={() => setOpened(group)}
title="View every term, campaign and ad group">{group.terms.map((term) => term.term).join(", ")}</button></td>
<td>Negative exact</td><td><span>{statusLabel(group.status)}</span>{group.decided_by && <small>by {group.decided_by}</small>}
{group.terms.filter((term) => term.outcome && term.outcome.status !== "sent").map((term) =>
<small key={term.id} data-outcome={term.outcome!.status}>{term.term}: {term.outcome!.cause}</small>)}</td>
{editable && <td>{group.status === "proposed" && <button type="button" className="ao-button"
disabled={!!sending} onClick={() => void approve(group)}>{sending === group.id ? "Approving" : "Approve"}</button>}</td>}
</tr>)}</tbody>
</table></div>}
<nav className="ao-bar ao-grid-footer" aria-label="Wasted spend pages"><span>{load.report.group_count} {load.report.group_count === 1 ? "group" : "groups"}</span>
<button type="button" className="ao-button is-quiet" disabled={cursors.length < 2 || !!sending}
onClick={() => setCursors((values) => values.slice(0, -1))}>Previous</button>
<button type="button" className="ao-button is-quiet" disabled={!load.report.cursor || !!sending}
onClick={() => setCursors((values) => [...values, load.report.cursor])}>Next</button></nav>
</>}
{opened && <GroupDetail key={opened.id} initial={opened} endpoint={endpoint} useGridSelection={useGridSelection} onClose={() => setOpened(null)} />}
</section>;
}