File size: 12,257 Bytes
9e15897 85f794d 9e15897 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 | 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>;
}
|