File size: 12,257 Bytes
f462120
 
 
8729c1d
f462120
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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>;
}