Download web/src/apps/amazon-operator/AppView.tsx from fsanyoto/loopable: direct link, hf CLI and curl.
- Browser
- Download file 117 kB
-
https://huggingface.co/spaces/fsanyoto/loopable/resolve/9291c0100f4e7b8da2efcbbf1ebdea72ee1663e7/web/src/apps/amazon-operator/AppView.tsx
- Command line
-
hf download hf://spaces/fsanyoto/loopable@9291c0100f4e7b8da2efcbbf1ebdea72ee1663e7/web/src/apps/amazon-operator/AppView.tsx
-
curl -L -o AppView.tsx https://huggingface.co/spaces/fsanyoto/loopable/resolve/9291c0100f4e7b8da2efcbbf1ebdea72ee1663e7/web/src/apps/amazon-operator/AppView.tsx
117 kB
import { Fragment, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
import type { ComponentType, KeyboardEvent, MouseEvent, FocusEvent } from "react";
import { Columns, Funnel, SortAscending, SquaresFour } from "@phosphor-icons/react";
import { ModeIcon } from "../../customer-grid/seam";
import { FieldsHidePanel, FilterBuilderPanel, GroupBuilder, Popover, SortBuilder,
createFilterRule, runPipeline } from "../../filter-kit";
import type { Field, FilterTree, Row, SortSpec } from "../../filter-kit";
import { API_V1, CREDENTIALS, currentTenant, UNAUTHORIZED_EVENT } from "../../apiContract";
import { useEscapeClose } from "../../ui/useEscapeClose";
import AdsOverview, { OperatorDashboardContext } from "./AdsOverview";
import type { OperatorTab } from "./AdsOverview";
import { operatorDashboardAdapter } from "./DashboardAdapter";
import WastedSpend from "./WastedSpend";
import "../../styles/sdlc79/amazon-operator.css";
import "../../styles/sdlc81/operator-results.css";
import "../../styles/sdlc81/ads-schedule.css";
import "../../styles/sdlc81/ads-change-log.css";
// SortBuilder's "Rows shown" rules (.cg-top-n) live in Table's sheet. Never move this import into
// filter-kit/index.ts: that chunk loads before MapView's sheets and flips Table's .cg-map-zone cursor.
import "../../styles/wave45/data-applications.css";
// S79-T17 (C2, C4, R18): the Amazon operator App screen. The dispatcher draws the App frame, so this view
// draws only the Today batch, History and the item drawer. No chat panel exists here (R18).
// S79-T18 (C7): Today also lists the items other Apps posted. A decision on one goes back to its App.
export interface OperatorApplication {
id: string;
name?: string;
capabilities?: Record<string, boolean>;
}
export interface Proposal {
id: string;
status: string;
adType: string;
campaign: string;
sku: string;
asin: string;
kind: string;
/** The posting App's name and its action, on an App inbox item only. */
app: string;
action: string;
change: string;
currentValue: number | string | null;
proposedValue: number | string | null;
valueChange: number | string | null;
valueUnit: string;
valuesReason: string;
currency: string;
added: string;
planLink: string;
shipFrom: string;
prepOwner: string;
reason: string;
gate: string;
day: string;
dataDate: string;
spend: number | null;
decidedBy: string;
decidedAt: string;
note: string;
cause: string;
/** A skipped or unknown row's cause from the last approve, shown muted. */
notice?: string;
/** The removal snapshot a person reviews in the drawer before approving (S82-T56). */
review?: RemovalReview | null;
}
interface ReviewedRemoval { reviewed: unknown; validateOnly: boolean }
interface RemovalReview extends ReviewedRemoval {
/** Sent back unchanged on approve, so the source App checks the numbers its person saw. */
reviewed: unknown;
canSubmit: boolean;
fate: string;
units: number | null;
sellable: number | null;
unitCost: number | null;
currency: string;
arithmetic: Record<string, unknown> | null;
shipTo: Record<string, unknown> | null;
}
interface Held { adType: string; campaign: string; sku: string; asin: string; reason: string }
interface Page { total: number; open: number; offset: number; cursor: string | null }
interface TodayScreen { dataDate: string; items: Proposal[]; appItems: Proposal[]; held: Held[]; canEdit: boolean;
pages: { items: Page; apps: Page; held: Page }; withheldCount: number }
interface HistoryPage { items: Proposal[]; cursor: string | null; total: number | null; withheldCount: number }
interface ResultMetrics { profit: number | null; acos: number | null }
interface ResultWindow {
days: number;
availableOn: string;
waiting: boolean;
reason: string;
before: ResultMetrics | null;
after: ResultMetrics | null;
}
interface ChangeResults {
windows: ResultWindow[];
undo: { available: boolean; reason: string; item: Proposal | null };
budgetSpend: { cost: number | null; basis: string; reason: string } | null;
}
type Load<T> = { phase: "loading" } | { phase: "error"; message: string } | { phase: "ready"; value: T };
const AD_TAGS: Record<string, string> = { sp: "SP", sb: "SB", sd: "SD" };
/** The `kind` of an App inbox item. */
const APP_KIND = "app";
const HISTORY_PAGE = 50;
const HISTORY_FILTERS = [
["", "All"], ["proposed", "Open"], ["sent", "Sent"], ["approved", "Approved"], ["refused", "Refused"],
["dismissed", "Dismissed"],
] as const;
const text = (value: unknown) => (typeof value === "string" ? value : "");
const num = (value: unknown) => (typeof value === "number" && Number.isFinite(value) ? value : null);
const scalar = (value: unknown): number | string | null => num(value) ?? (text(value) || null);
const addressText = (value: unknown) => typeof value === "string" ? value
: value && typeof value === "object" && !Array.isArray(value)
? Object.values(value).map(text).filter(Boolean).join(", ") : "";
export interface OperatorColumnSpec {
key: string;
label: string;
width: number;
/** QI33 must retain these optional fields behind Fields on the initial view. */
defaultHidden?: boolean;
kind?: "product" | "value" | "change" | "decision" | "date" | "link" | "status";
}
// R6 keeps the references' content order inside the shared Grid's product-first contract.
export const OPERATOR_TODAY_COLUMNS = [
{ key: "product", label: "Product", width: 168, kind: "product" },
{ key: "current_value", label: "Current value", width: 84, kind: "value" },
{ key: "proposed_value", label: "Proposed value", width: 84, kind: "value" },
{ key: "value_change", label: "Change", width: 88, kind: "change" },
{ key: "decision", label: "Decision", width: 144, kind: "decision" },
{ key: "first_seen", label: "Added", width: 80, kind: "date" },
{ key: "reason", label: "Reason", width: 184 },
{ key: "campaign", label: "Campaign", width: 160, defaultHidden: true },
{ key: "gate", label: "Gate", width: 160, defaultHidden: true },
{ key: "spend", label: "Spend", width: 112, kind: "value", defaultHidden: true },
] as const satisfies readonly OperatorColumnSpec[];
export const OPERATOR_APP_COLUMNS = [
...OPERATOR_TODAY_COLUMNS.slice(0, 7),
{ key: "action", label: "Action", width: 224, defaultHidden: true },
{ key: "plan_link", label: "Plan", width: 160, kind: "link", defaultHidden: true },
{ key: "ship_from", label: "Ship from", width: 240, defaultHidden: true },
{ key: "prep_owner", label: "Prep owner", width: 112, defaultHidden: true },
{ key: "app", label: "App", width: 160, defaultHidden: true },
] as const satisfies readonly OperatorColumnSpec[];
export const OPERATOR_HISTORY_COLUMNS = [
{ key: "product", label: "Product", width: 180, kind: "product" },
{ key: "day", label: "Date", width: 96, kind: "date" },
{ key: "campaign", label: "Campaign or App", width: 160 },
{ key: "current_value", label: "Old value", width: 112, kind: "value" },
{ key: "proposed_value", label: "New value", width: 112, kind: "value" },
{ key: "value_change", label: "Change", width: 112, kind: "change" },
{ key: "source", label: "Source", width: 160 },
{ key: "decision", label: "Decision", width: 112, kind: "status" },
{ key: "outcome", label: "Outcome", width: 200 },
] as const satisfies readonly OperatorColumnSpec[];
export const OPERATOR_CHANGE_LOG_COLUMNS = [
{ key: "product", label: "Product", width: 168, kind: "product" },
{ key: "at", label: "Date", width: 132, kind: "date" },
{ key: "operation", label: "Change type", width: 80 },
{ key: "old_value", label: "Old value", width: 88, kind: "value" },
{ key: "new_value", label: "New value", width: 88, kind: "value" },
{ key: "value_change", label: "Change", width: 96, kind: "change" },
// QI33 shows the recorded approver below Source while Changed by is hidden.
{ key: "source", label: "Source", width: 216 },
{ key: "approver", label: "Changed by", width: 160, defaultHidden: true },
{ key: "campaign", label: "Campaign", width: 160, defaultHidden: true },
{ key: "account", label: "Account", width: 160, defaultHidden: true },
{ key: "status", label: "Outcome", width: 176, kind: "status", defaultHidden: true },
{ key: "currency", label: "Currency", width: 112, defaultHidden: true },
] as const satisfies readonly OperatorColumnSpec[];
const defaultHiddenColumns = (columns: readonly OperatorColumnSpec[]) =>
columns.filter(column => column.defaultHidden).map(column => column.key);
const gridWidth = (columns: readonly OperatorColumnSpec[], hidden: readonly string[], markers = 0) =>
columns.reduce((width, column) => width + (hidden.includes(column.key) ? 0 : column.width), markers * 32);
function ColumnHeaders({ columns, sized = false }: { columns: readonly OperatorColumnSpec[]; sized?: boolean }) {
return <>{columns.map(column => <th key={column.key} scope="col" data-field={column.key}
style={sized ? { width: column.width } : undefined}
className={column.kind === "value" || column.kind === "change" ? "is-num" : undefined}>
{column.label}</th>)}</>;
}
async function readJson(response: Response, fallback: string): Promise<unknown> {
const body: unknown = await response.json().catch(() => null);
if (response.ok) return body;
const error = (body as { detail?: { error?: { message?: unknown } } } | null)?.detail?.error;
throw new Error(text(error?.message) || fallback);
}
function parseProposal(raw: unknown): Proposal | null {
const row = (raw ?? {}) as Record<string, unknown>;
const id = text(row.id);
if (!id) return null;
return {
id, status: text(row.status) || "proposed", adType: text(row.ad_type), campaign: text(row.campaign)
|| text(row.campaign_id), sku: text(row.sku), asin: text(row.asin), kind: text(row.kind),
app: text(row.app), action: text(row.action), change: text(row.change), reason: text(row.reason), gate: text(row.gate), day: text(row.day),
currentValue: scalar(row.current_value), proposedValue: scalar(row.proposed_value), valueChange: scalar(row.value_change),
valueUnit: text(row.value_unit), valuesReason: text(row.values_reason), currency: text(row.currency),
added: text(row.first_seen) || text(row.firstSeen), planLink: text(row.plan_link), shipFrom: addressText(row.ship_from),
prepOwner: text(row.prep_owner),
dataDate: text(row.data_date), spend: num(row.spend), decidedBy: text(row.decided_by),
decidedAt: text(row.decided_at), note: text(row.note), cause: text(row.cause), review: parseReview(row.review),
};
}
function parseReview(raw: unknown): RemovalReview | null {
if (!raw || typeof raw !== "object") return null;
const row = raw as Record<string, unknown>;
if (row.reviewed === undefined || row.reviewed === null || row.reviewed === "") return null;
const record = (value: unknown) => (value && typeof value === "object" && !Array.isArray(value)
? value as Record<string, unknown> : null);
return { reviewed: row.reviewed, validateOnly: row.validateOnly !== false,
canSubmit: row.canSubmit === true,
fate: text(row.fate), units: num(row.units), sellable: num(row.sellable),
unitCost: num(row.unitCost), currency: text(row.currency), arithmetic: record(row.arithmetic),
shipTo: record(row.shipTo) };
}
/** The drawer lines for a removal: fate, quantities, the cost arithmetic and the typed ship-to. */
function reviewFacts(review: RemovalReview): [string, string][] {
const amount = (value: unknown) => {
const figure = num(value);
return figure === null ? "" : `${money(figure)}${review.currency ? " " + review.currency : ""}`;
};
const sums = review.arithmetic ?? {};
const units = num(review.units);
const sellable = num(review.sellable);
const shipTo = Object.values(review.shipTo ?? {}).map(text).filter(Boolean).join(", ");
return [
["Fate", review.fate], ["Units", units === null ? "" : units.toLocaleString()],
["Sellable units", sellable === null ? "" : sellable.toLocaleString()],
["Unit cost", amount(review.unitCost)], ["Recoverable value", amount(sums.recoverableValue)],
["Removal fee", amount(sums.removalFee)], ["Freight", amount(sums.freight)],
["Return cost", amount(sums.returnCost)], ["Rule", text(sums.rule)],
["Ship to", review.fate === "Return" ? shipTo || "No ship to address" : shipTo],
];
}
const proposals = (raw: unknown) => (Array.isArray(raw) ? raw : [])
.map(parseProposal).filter((row): row is Proposal => row !== null);
function parseToday(raw: unknown): TodayScreen {
const body = (raw ?? {}) as Record<string, unknown>;
const pages = (body.pages ?? {}) as Record<string, unknown>;
const page = (key: string): Page => {
const row = (pages[key] ?? {}) as Record<string, unknown>;
return { total: num(row.total) ?? 0, open: num(row.open) ?? 0, offset: num(row.offset) ?? 0,
cursor: text(row.cursor) || null };
};
return {
dataDate: text(body.dataDate),
items: proposals(body.items),
appItems: proposals(body.appItems),
held: (Array.isArray(body.held) ? body.held : []).map((item) => {
const row = (item ?? {}) as Record<string, unknown>;
return { adType: text(row.ad_type), campaign: text(row.campaign) || text(row.campaign_id), sku: text(row.sku),
asin: text(row.asin), reason: text(row.reason) };
}).filter((row) => row.reason),
canEdit: body.canEdit === true,
withheldCount: num(body.withheldCount) ?? 0,
pages: { items: page("items"), apps: page("apps"), held: page("held") },
};
}
function parseHistory(raw: unknown): HistoryPage {
const body = (raw ?? {}) as Record<string, unknown>;
return { items: proposals(body.items), cursor: text(body.cursor) || null, total: num(body.total),
withheldCount: num(body.withheldCount) ?? 0 };
}
function WithheldItems({ count }: { count: number }) {
return count > 0 ? <p className="ao-undo-notice" role="status" data-surface="operator-source-wall">
{count} items need access you do not have
</p> : null;
}
function parseResults(raw: unknown, proposalId: string): ChangeResults {
const body = (raw ?? {}) as Record<string, unknown>;
const rawWindows = body.windows;
if (body.proposal_id !== proposalId || !Array.isArray(rawWindows)) throw new Error("Results are unavailable.");
const metrics = (raw: unknown): ResultMetrics | null => {
if (!raw || typeof raw !== "object") return null;
const row = raw as Record<string, unknown>;
return { profit: num(row.ad_profit_after_cogs), acos: num(row.acos) };
};
const windows = [7, 14].map((days) => {
const row = rawWindows.find((value: Record<string, unknown> | null) => value?.days === days);
if (!row || !text(row.available_on) || !["waiting", "ready", "partial"].includes(row.state)) {
throw new Error("Results are unavailable.");
}
return { days, availableOn: text(row.available_on), waiting: row.state === "waiting", reason: text(row.reason),
before: metrics(row.before), after: metrics(row.after) };
});
const undo = (body.undo ?? {}) as Record<string, unknown>;
const spend = body.budget_spend as Record<string, unknown> | null | undefined;
return { windows, undo: { available: undo.available === true, reason: text(undo.reason), item: parseProposal(undo.item) },
budgetSpend: spend ? { cost: num(spend.ad_cost), basis: text(spend.basis), reason: text(spend.reason) } : null };
}
/** "October 21" from an ISO day. The day is a calendar date, so it is read in UTC. */
function dayWords(iso: string, month: "long" | "short" = "long") {
const date = new Date(iso.length === 10 ? iso + "T00:00:00Z" : iso);
return Number.isNaN(date.getTime()) ? iso
: date.toLocaleDateString(undefined, { month, day: "numeric", timeZone: "UTC" });
}
const money = (value: number | null) => (value === null ? "Not held"
: value.toLocaleString(undefined, { minimumFractionDigits: 2, maximumFractionDigits: 2 }));
const recordedValue = (value: unknown) => value == null ? "Not recorded"
: typeof value === "number" ? money(value) : String(value);
export function operatorValueText(value: number | string | null, unit: string, currency: string,
reason = "Value not recorded", signed = false): string {
if (value === null) return reason || "Value not recorded";
if (typeof value === "string") return value;
const amount = (signed && value > 0 ? "+" : "") + (unit === "currency" ? money(value) : value.toLocaleString());
return unit === "currency" ? `${amount} ${currency || "(Currency not recorded)"}`
: `${amount} ${unit || "(Unit not recorded)"}`;
}
const proposalValue = (row: Proposal, field: "currentValue" | "proposedValue" | "valueChange") =>
operatorValueText(row[field], row.valueUnit, row.currency, row.valuesReason, field === "valueChange");
function ValueCells({ row }: { row: Proposal }) {
return <>
<td className="ao-c-value is-num" data-field="current_value">{proposalValue(row, "currentValue")}</td>
<td className="ao-c-value is-num" data-field="proposed_value">{proposalValue(row, "proposedValue")}</td>
<td className={`ao-c-value ao-c-delta is-num${typeof row.valueChange === "number"
? row.valueChange > 0 ? " is-up" : row.valueChange < 0 ? " is-down" : "" : ""}`}
data-field="value_change">{proposalValue(row, "valueChange")}</td>
</>;
}
function ProductCell({ row, onOpen }: { row: Proposal; onOpen: (row: Proposal) => void }) {
return <td className="ao-c-product" data-field="product">
<span className="ao-product-picture" role="img" aria-label="Product image not supplied" />
<span className="ao-product-copy"><button type="button" className="ao-open" onClick={() => onOpen(row)}
title={row.sku || row.asin || "Product not recorded"}>{row.sku || row.asin || "Product not recorded"}</button>
<small>{row.asin || row.sku || "No SKU or ASIN"}</small></span>
</td>;
}
function PlanLink({ value }: { value: string }) {
let safe = false;
try { safe = new URL(value).protocol === "https:"; } catch { /* Missing links stay plain. */ }
return safe ? <a className="ao-link" href={value} target="_blank" rel="noopener noreferrer">View plan</a>
: <span>{value ? "Plan link unavailable" : "Plan link not supplied"}</span>;
}
const isOpen = (row: Proposal) => row.status === "proposed";
/** The plain decision word for a proposal's status. */
export function decisionLabel(status: string): string {
if (status === "proposed") return "Open";
if (status === "dismissed") return "Dismissed";
if (status === "stale") return "No longer open";
return "Approved";
}
/** The outcome of a decided proposal: its words and whether it is a refusal. */
export function outcomeOf(row: Pick<Proposal, "status" | "cause" | "note" | "kind">):
{ label: string; refused: boolean } | null {
if (row.status === "sent") return { label: "Sent", refused: false };
if (row.status === "refused") return { label: row.cause || "Refused", refused: true };
if (row.status === "approved") return { label: row.kind === APP_KIND ? "Approved" : "Sending", refused: false };
if (row.status === "dismissed") return { label: "Dismissed", refused: false };
if (row.status === "stale") return { label: row.cause || "No longer open in its App", refused: false };
return null;
}
function AdTag({ adType }: { adType: string }) {
const tag = AD_TAGS[adType] ?? adType.toUpperCase();
return tag ? <span className="ao-tag">{tag}</span> : null;
}
function Outcome({ row }: { row: Proposal }) {
const outcome = outcomeOf(row);
return <>
{outcome && <span className={outcome.refused ? "ao-result is-refused"
: row.status === "stale" ? "ao-result is-notice" : `ao-result is-${row.status}`}>
{outcome.label}</span>}
{row.status === "dismissed" && row.note && <span className="ao-result is-notice">{row.note}</span>}
{row.status === "proposed" && row.cause && <span className="ao-result is-notice">{row.cause}</span>}
{row.notice && <span className="ao-result is-notice">{row.notice}</span>}
</>;
}
function Skeleton() {
return <div className="ao-skeleton-rows" aria-busy="true" aria-label="Loading">
<div className="ao-skeleton" /><div className="ao-skeleton" /><div className="ao-skeleton" />
</div>;
}
interface SearchProps { search: string; onSearch: (value: string) => void }
type TodayGroup = "items" | "apps" | "held";
const emptyFilters = (): FilterTree => ({ conj: "and", nodes: [] });
export const operatorFields = (columns: readonly (readonly [string, string])[]): Field[] =>
columns.map(([key, label]) => ({ key, label, source: "overlay",
type: ["current_value", "proposed_value", "value_change", "spend"].includes(key) ? "currency" : "text" }));
const TODAY_FIELDS = OPERATOR_TODAY_COLUMNS.filter(column => column.key !== "product" && column.key !== "decision")
.map(column => [column.key, column.label] as const);
const HISTORY_FIELDS = OPERATOR_HISTORY_COLUMNS.filter(column => column.key !== "product")
.map(column => [column.key, column.label] as const);
function FieldControls({ fields, hidden, onHidden }: {
fields: Field[]; hidden: string[]; onHidden: (keys: string[]) => void;
}) {
return <Popover label="Fields" icon={<Columns size={16} aria-hidden="true" />} active={hidden.length > 0} wide>
{() => fields.length === 0 ? <div className="cg-pop-body cg-builder-empty">No fields to show</div>
: <FieldsHidePanel fields={fields} hidden={new Set(hidden)}
onToggle={(key) => onHidden(hidden.includes(key) ? hidden.filter(field => field !== key) : [...hidden, key])}
onShowAll={() => onHidden([])} onHideAll={() => onHidden(fields.map(field => field.key))} />}
</Popover>;
}
/** Presentation controls never receive a record writer. Sorting applies to the current cursor page. */
function GridControls({ fields, hidden, onHidden, sorts, onSorts, filters, onFilters, search, onSearch }: SearchProps & {
fields: Field[]; hidden: string[]; onHidden: (keys: string[]) => void;
sorts: SortSpec; onSorts: (sorts: SortSpec) => void; filters: FilterTree; onFilters: (filters: FilterTree) => void;
}) {
return <>
<FieldControls fields={fields} hidden={hidden} onHidden={onHidden} />
<Popover label="Sort" icon={<SortAscending size={16} aria-hidden="true" />} active={sorts.length > 0} tone="sort" wide>
{() => <div role="group" aria-label="Sort current page"><SortBuilder fields={fields}
fieldByKey={new Map(fields.map(field => [field.key, field]))} sorts={sorts} onSorts={onSorts}
filters={filters} onFilters={onFilters} grouped={false} /></div>}
</Popover>
<label className="ao-grid-search">
<span className="ao-field-label">Search</span>
<input type="search" className="ao-input" aria-label="Search proposals" value={search}
onChange={(event) => onSearch(event.target.value)} />
</label>
</>;
}
export function sortProposals(rows: Proposal[], sorts: SortSpec, filters: FilterTree, fields: Field[], today = false) {
const rawRows: Row[] = rows.map((row, index) => ({ pid: index + 1, campaign: row.campaign || row.app,
sku: row.sku, reason: row.reason, gate: row.gate, spend: row.spend, first_seen: row.added, day: row.day,
current_value: row.currentValue, proposed_value: row.proposedValue, value_change: row.valueChange,
action: row.action || row.change, app: row.app, plan_link: row.planLink, ship_from: row.shipFrom,
prep_owner: row.prepOwner, source: row.decidedBy, decision: decisionLabel(row.status), outcome: outcomeOf(row)?.label,
status: today ? isOpen(row) ? "Open" : "Decided" : HISTORY_FILTERS.find(([value]) => value === row.status)?.[1] ?? row.status }));
return runPipeline({ rawRows, fields, sorts, filters: filters.nodes, filterConj: filters.conj,
search: "", groupBy: null, collapsed: new Set() }).visibleRows.flatMap(row =>
row.kind === "data" ? [rows[row.record.pid - 1]] : []);
}
/** Only a root AND status equality can use History's existing server status parameter. */
export function operatorHistoryStatus(filters: FilterTree): string {
if (filters.conj !== "and") return "";
const statuses = filters.nodes.filter(node => "op" in node && node.colId === "status" && node.op === "eq");
const rule = statuses.length === 1 ? statuses[0] : null;
return rule && "value" in rule ? HISTORY_FILTERS.find(([value, label]) =>
value && (value === rule.value || label === rule.value))?.[0] ?? "" : "";
}
/** Arrow keys move through cells. Enter opens details and Space changes only row selection. */
function useGridSelection() {
const [selected, setSelected] = useState("");
const select = (event: MouseEvent<HTMLTableElement> | FocusEvent<HTMLTableElement>) => {
const target = event.target as HTMLElement;
const row = target.closest<HTMLTableRowElement>("tr[data-row-id]");
if (row) setSelected(row.dataset.rowId || "");
if (event.type === "click" && !target.closest("button, input, select, summary, a")) {
const cell = target.closest<HTMLTableCellElement>("td");
if (cell) { cell.tabIndex = -1; cell.focus(); }
}
};
const onKeyDown = (event: KeyboardEvent<HTMLTableElement>) => {
const target = event.target as HTMLElement;
if (target.closest("button, input, select, summary, a, details")) return;
const rows = Array.from(event.currentTarget.tBodies[0]?.rows ?? []);
if (!rows.length) return;
const current = target.closest<HTMLTableCellElement>("td");
const rowIndex = Math.max(0, rows.findIndex((row) => row === current?.parentElement));
const row = rows[rowIndex];
const visibleCells = (row: HTMLTableRowElement) => Array.from(row.cells).filter((cell) => cell.getClientRects().length > 0);
const column = Math.max(0, visibleCells(row).findIndex((cell) => cell === current));
let nextRow = rowIndex;
let nextCol = column;
if (event.key === "ArrowDown") nextRow = Math.min(rows.length - 1, rowIndex + (current ? 1 : 0));
else if (event.key === "ArrowUp") nextRow = Math.max(0, rowIndex - 1);
else if (event.key === "ArrowRight") nextCol++;
else if (event.key === "ArrowLeft") nextCol--;
else if (event.key === "Home") { nextCol = 0; if (event.ctrlKey || event.metaKey) nextRow = 0; }
else if (event.key === "End") {
if (event.ctrlKey || event.metaKey) nextRow = rows.length - 1;
nextCol = visibleCells(rows[nextRow]).length - 1;
} else if (event.key === "Enter") {
row.querySelector<HTMLButtonElement>(".ao-open")?.click(); event.preventDefault(); return;
} else if (event.key === " ") {
const tick = row.querySelector<HTMLInputElement>(".ao-c-tick input:not(:disabled)");
if (tick) tick.click();
else setSelected((value) => value === row.dataset.rowId ? "" : row.dataset.rowId || "");
event.preventDefault(); return;
} else return;
event.preventDefault();
const cells = visibleCells(rows[nextRow]);
const cell = cells[Math.max(0, Math.min(cells.length - 1, nextCol))];
if (!cell) return;
cell.tabIndex = -1;
cell.focus();
cell.scrollIntoView({ block: "nearest", inline: "nearest" });
const viewport = event.currentTarget.closest<HTMLDivElement>(".ao-grid-viewport");
if (!viewport) return;
const style = getComputedStyle(cell);
if (style.position === "sticky" && (style.left !== "auto" || style.right !== "auto")) return;
// Native scrolling ignores cells frozen over the scrollport. Reserve their measured bounds.
const viewportRect = viewport.getBoundingClientRect();
const viewportLeft = viewportRect.left + viewport.clientLeft;
let left = Math.max(0, viewportLeft);
let right = Math.min(document.documentElement.clientWidth, viewportLeft + viewport.clientWidth);
for (const peer of cells) {
const pinned = getComputedStyle(peer);
if (pinned.position !== "sticky") continue;
const bounds = peer.getBoundingClientRect();
if (bounds.right <= left || bounds.left >= right) continue;
if (pinned.left !== "auto" && peer.cellIndex < cell.cellIndex) left = Math.max(left, bounds.right);
if (pinned.right !== "auto" && peer.cellIndex > cell.cellIndex) right = Math.min(right, bounds.left);
}
const available = right - left;
if (available <= 0) return;
const bounds = cell.getBoundingClientRect();
const start = bounds.left - left;
const end = bounds.right - right;
// An oversized cell keeps its visible portion, or aligns the nearest edge, without oscillating.
const delta = bounds.width <= available
? start < 0 ? start : end > 0 ? end : 0
: start > 0 ? start : end < 0 ? end : 0;
viewport.scrollLeft = Math.max(0, Math.min(viewport.scrollWidth - viewport.clientWidth, viewport.scrollLeft + delta));
};
return { selected, table: { role: "grid", tabIndex: 0, "aria-describedby": "ao-grid-help",
onKeyDown, onClick: select, onFocusCapture: select } };
}
function Failed({ message, onRetry }: { message: string; onRetry: () => void }) {
return <p className="ao-error" role="alert">{message}{" "}
<button type="button" className="ao-link" onClick={onRetry}>Retry</button></p>;
}
function Drawer({ row, onClose, onReviewed, editable, previousReview }: {
row: Proposal; onClose: () => void; onReviewed?: (id: string, reviewed: ReviewedRemoval) => void; editable: boolean;
previousReview?: ReviewedRemoval;
}) {
const panel = useRef<HTMLElement | null>(null);
const close = useRef<HTMLButtonElement | null>(null);
const [validateOnly, setValidateOnly] = useState(previousReview
&& JSON.stringify(previousReview.reviewed) === JSON.stringify(row.review?.reviewed)
? previousReview.validateOnly : row.review?.validateOnly !== false);
useEscapeClose(true, onClose, { container: () => panel.current });
useEffect(() => { close.current?.focus(); }, [row.id]);
// The snapshot shown here is the one an approve sends back, so a changed removal is refused, never sent.
const reviewed = row.review?.reviewed;
useEffect(() => {
if (reviewed !== undefined && row.status === "proposed" && editable)
onReviewed?.(row.id, { reviewed, validateOnly });
}, [row.id, row.status, reviewed, validateOnly, editable, onReviewed]);
const outcome = outcomeOf(row);
const facts: [string, string][] = [
...(row.review ? reviewFacts(row.review) : []),
["App", row.app], ["Campaign", row.campaign], ["Ad type", AD_TAGS[row.adType] ?? row.adType], ["SKU", row.sku],
["ASIN", row.asin], ["Action", row.action || row.change], ["Current value", proposalValue(row, "currentValue")],
["Proposed value", proposalValue(row, "proposedValue")], ["Change", row.change], ["Reason", row.reason], ["Gate", row.gate],
["Added", row.added ? dayWords(row.added) : ""], ["Ship from", row.shipFrom], ["Prep owner", row.prepOwner],
["Data date", row.dataDate ? dayWords(row.dataDate) : ""], ["Decision", decisionLabel(row.status)],
["Decided by", row.decidedBy], ["Note", row.note], ["Cause", row.cause],
];
return <aside ref={panel} className="ao-drawer" role="dialog" aria-label={row.review ? "Removal review" : "Proposal"}>
<div className="ao-drawer-head">
<h2 className="ao-drawer-title">{row.review ? "Removal review" : row.kind === APP_KIND ? "App proposal" : "Ad proposal"}</h2>
<button ref={close} type="button" className="ao-button is-quiet" onClick={onClose}>Close</button>
</div>
{row.review?.canSubmit && row.status === "proposed" && editable && <label className="ao-field">
<span className="ao-field-label">Removal mode</span>
<select className="ao-select" aria-label="Removal mode" value={String(validateOnly)}
onChange={event => setValidateOnly(event.target.value === "true")}>
<option value="true">Validate file</option><option value="false">Submit removal</option>
</select>
</label>}
<dl className="ao-facts">
{facts.filter(([, value]) => value).map(([label, value]) => <div key={label} className="ao-fact">
<dt>{label}</dt><dd className={row.review && ["Units", "Sellable units", "Unit cost", "Recoverable value",
"Removal fee", "Freight", "Return cost"].includes(label) ? "is-num" : undefined}>{value}</dd>
</div>)}
{row.kind === APP_KIND && <div className="ao-fact"><dt>Plan</dt><dd><PlanLink value={row.planLink} /></dd></div>}
{row.kind !== APP_KIND && <div className="ao-fact"><dt>Spend</dt><dd className="is-num">
{operatorValueText(row.spend, "currency", row.currency, "Spend not recorded")}</dd></div>}
{outcome && <div className="ao-fact"><dt>Outcome</dt>
<dd className={outcome.refused ? "is-refused" : undefined}>{outcome.label}</dd></div>}
</dl>
</aside>;
}
interface TodayProps extends SearchProps {
state: Load<TodayScreen>;
busy: boolean;
onPage: (section: "items" | "apps" | "held", offset: number) => void;
editable: boolean;
excluded: ReadonlySet<string>;
settled: ReadonlySet<string>;
sending: boolean;
decideError: string;
dismissing: Dismissing | null;
onToggle: (id: string) => void;
onToggleAll: (open: Proposal[], include: boolean) => void;
onApprove: (batch: Proposal[]) => void;
onDismissStart: (id: string | null) => void;
onDismissReason: (reason: string) => void;
onDismissCancel: () => void;
onDismiss: (ids: string[], reason: string) => void;
onOpen: (row: Proposal) => void;
onRetry: () => void;
}
/** An open reason field: one row's (id) or the ticked batch's (id null). */
interface Dismissing { id: string | null; reason: string }
function ReasonForm({ label, submitLabel, ready, value, busy, inline, onChange, onCancel, onSubmit }: {
label: string; submitLabel: string; ready: boolean; value: string; busy: boolean; inline: boolean;
onChange: (value: string) => void; onCancel: () => void; onSubmit: () => void;
}) {
return <form className={inline ? "ao-reason-form is-inline" : "ao-reason-form"}
onSubmit={(event) => { event.preventDefault(); if (value.trim() && ready && !busy) onSubmit(); }}>
<input className="ao-input" value={value} onChange={(event) => onChange(event.target.value)} autoFocus
placeholder="Reason" aria-label={label} disabled={busy} />
<span className="ao-reason-actions">
<button type="submit" className="ao-button" disabled={busy || !ready || !value.trim()}>{submitLabel}</button>
<button type="button" className="ao-button is-quiet" disabled={busy} onClick={onCancel}>Cancel</button>
</span>
</form>;
}
type RowProps = Pick<TodayProps, "editable" | "excluded" | "settled" | "sending" | "dismissing" | "onToggle"
| "onToggleAll" | "onApprove" | "onDismissStart" | "onDismissReason" | "onDismissCancel" | "onDismiss" | "onOpen">;
/** The select all tick for one group's open rows. */
function TickAll({ open, excluded, sending, label, onToggleAll }: {
open: Proposal[]; excluded: ReadonlySet<string>; sending: boolean; label: string;
onToggleAll: (open: Proposal[], include: boolean) => void;
}) {
const ticked = open.filter((row) => !excluded.has(row.id)).length;
const allIn = open.length > 0 && ticked === open.length;
return <label className="ao-tick-all">
<input type="checkbox" className="ao-check" checked={allIn} disabled={sending || open.length === 0}
ref={(node) => { if (node) node.indeterminate = ticked > 0 && !allIn; }}
onChange={() => onToggleAll(open, !allIn)} aria-label={label} />
<span className="ao-tick-all-label">Select all</span>
</label>;
}
/** One row's result in place, then its own Dismiss while it is open. */
function ResultCell({ row, live, props }: { row: Proposal; live: boolean; props: RowProps }) {
const { editable, sending, dismissing, onApprove, onDismissStart, onDismissReason, onDismissCancel, onDismiss } = props;
const what = row.change || row.action;
return <td className="ao-c-result" data-field="decision" aria-live="polite">
{live && <span className="ao-status" data-status={row.status}>Open</span>}
<Outcome row={row} />
{editable && live && <button type="button" className="ao-button" disabled={sending}
aria-label={`Approve ${what}`} onClick={() => onApprove([row])}>Approve</button>}
{editable && live && (dismissing?.id === row.id
? <ReasonForm label={`Reason to dismiss ${what}`} submitLabel="Dismiss" ready
value={dismissing.reason}
busy={sending} inline={false} onChange={onDismissReason} onCancel={onDismissCancel}
onSubmit={() => onDismiss([row.id], dismissing.reason)} />
: <button type="button" className="ao-dismiss-open" disabled={sending}
aria-label={`Dismiss ${what}`} onClick={() => onDismissStart(row.id)}>Dismiss</button>)}
</td>;
}
function rowClass(live: boolean, leaving: boolean) {
return leaving ? "ao-row is-settled" : live ? "ao-row" : "ao-row is-decided";
}
function AdTable({ items, props, offset, hidden }: { items: Proposal[]; props: RowProps; offset: number; hidden: string[] }) {
const { editable, excluded, settled, sending, onToggle, onToggleAll, onOpen } = props;
const grid = useGridSelection();
const open = items.filter(isOpen);
return <table {...grid.table} aria-label="Ad changes grid" className={editable ? "ao-table ao-today" : "ao-table ao-today is-readonly"}
style={{ width: gridWidth(OPERATOR_TODAY_COLUMNS, hidden, editable ? 2 : 1) }}>
<thead>
<tr>
<th scope="col" aria-label="Row">#</th>
{editable && <th scope="col" className="ao-c-tick">
<TickAll open={open} excluded={excluded} sending={sending} label="Select all ad changes"
onToggleAll={onToggleAll} />
</th>}
<ColumnHeaders columns={OPERATOR_TODAY_COLUMNS} sized />
</tr>
</thead>
<tbody>
{items.map((row, index) => {
const live = isOpen(row);
const leaving = settled.has(row.id);
return <tr key={row.id} data-row-id={row.id} aria-selected={grid.selected === row.id}
data-included={editable && live && !excluded.has(row.id) || undefined} className={rowClass(live, leaving)}
aria-busy={sending && live && !excluded.has(row.id) ? true : undefined}>
<td className="ao-grid-marker">{offset + index + 1}</td>
{editable && <td className="ao-c-tick">
{(live || leaving) && <input type="checkbox" className="ao-check" checked={live && !excluded.has(row.id)}
disabled={!live || sending} tabIndex={live ? undefined : -1} aria-hidden={live ? undefined : true}
onChange={() => onToggle(row.id)}
aria-label={`Include ${row.change} for ${row.sku || row.campaign}`} />}
</td>}
<ProductCell row={row} onOpen={onOpen} />
<ValueCells row={row} />
<ResultCell row={row} live={live} props={props} />
<td data-field="first_seen">{row.added ? dayWords(row.added, "short") : "Added date not recorded"}</td>
<td className="ao-c-reason" data-field="reason" title={row.reason}>{row.reason || "Reason not recorded"}</td>
<td className="ao-c-campaign" data-field="campaign">
<button type="button" className="ao-open" title={row.campaign} onClick={() => onOpen(row)}>{row.campaign}</button>
<AdTag adType={row.adType} />
</td>
<td className="ao-c-gate" data-field="gate" title={row.gate}>{row.gate}</td>
<td className="is-num" data-field="spend">{operatorValueText(row.spend, "currency", row.currency, "Spend not recorded")}</td>
</tr>;
})}
</tbody>
</table>;
}
/** Items the other Apps posted: App, SKU, action and reason. A stale row shows why and takes no tick. */
function AppTable({ items, props, offset, hidden }: { items: Proposal[]; props: RowProps; offset: number; hidden: string[] }) {
const { editable, excluded, settled, sending, onToggle, onToggleAll, onOpen } = props;
const grid = useGridSelection();
const open = items.filter(isOpen);
return <table {...grid.table} aria-label="App items grid" className={editable ? "ao-table ao-today ao-apps" : "ao-table ao-today ao-apps is-readonly"}
style={{ width: gridWidth(OPERATOR_APP_COLUMNS, hidden, editable ? 2 : 1) }}>
<thead>
<tr>
<th scope="col" aria-label="Row">#</th>
{editable && <th scope="col" className="ao-c-tick">
<TickAll open={open} excluded={excluded} sending={sending} label="Select all App items"
onToggleAll={onToggleAll} />
</th>}
<ColumnHeaders columns={OPERATOR_APP_COLUMNS} sized />
</tr>
</thead>
<tbody>
{items.map((row, index) => {
const live = isOpen(row);
const leaving = settled.has(row.id);
return <tr key={row.id} data-row-id={row.id} aria-selected={grid.selected === row.id}
data-included={editable && live && !excluded.has(row.id) || undefined} className={rowClass(live, leaving)}
aria-busy={sending && live && !excluded.has(row.id) ? true : undefined}>
<td className="ao-grid-marker">{offset + index + 1}</td>
{editable && <td className="ao-c-tick">
{(live || leaving) && <input type="checkbox" className="ao-check" checked={live && !excluded.has(row.id)}
disabled={!live || sending} tabIndex={live ? undefined : -1} aria-hidden={live ? undefined : true}
onChange={() => onToggle(row.id)}
aria-label={`Include ${row.action} for ${row.sku || row.app}`} />}
</td>}
<ProductCell row={row} onOpen={onOpen} />
<ValueCells row={row} />
<ResultCell row={row} live={live} props={props} />
<td data-field="first_seen">{row.added ? dayWords(row.added, "short") : "Added date not recorded"}</td>
<td className="ao-c-reason" data-field="reason" title={row.reason}>{row.reason || "Reason not recorded"}</td>
<td className="ao-c-action" data-field="action">{row.action}</td>
<td className="ao-c-plan" data-field="plan_link"><PlanLink value={row.planLink} /></td>
<td className="ao-c-address" data-field="ship_from">{row.shipFrom || "Ship from not supplied"}</td>
<td data-field="prep_owner">{row.prepOwner || "Prep owner not supplied"}</td>
<td className="ao-c-campaign" data-field="app">
<button type="button" className="ao-open" title={row.app} onClick={() => onOpen(row)}>{row.app}</button>
</td>
</tr>;
})}
</tbody>
</table>;
}
function HeldTable({ items, offset }: { items: Held[]; offset: number }) {
const grid = useGridSelection();
return <table {...grid.table} className="ao-table ao-held-grid" aria-label="Held grid">
<thead><tr><th scope="col" aria-label="Row">#</th><th scope="col">Campaign</th>
<th scope="col" data-field="sku">SKU</th><th scope="col" data-field="reason">Reason</th></tr></thead>
<tbody>{items.map((row, index) => {
const id = `${row.adType}:${row.campaign}:${row.sku || row.asin}:${index}`;
return <tr key={id} data-row-id={id} aria-selected={grid.selected === id} className="ao-row">
<td className="ao-grid-marker">{offset + index + 1}</td><td title={row.campaign}>{row.campaign}</td>
<td data-field="sku" title={row.sku || row.asin}>{row.sku || row.asin}</td>
<td data-field="reason" title={row.reason}>{row.reason}</td>
</tr>;
})}</tbody>
</table>;
}
function Pager({ label, page, count, busy, onPage }: {
label: string; page: Page; count: number; busy: boolean; onPage: (offset: number) => void;
}) {
return <nav className="ao-bar ao-grid-footer" aria-label={label} aria-busy={busy}>
<button type="button" className="ao-button is-quiet" disabled={busy || page.offset === 0}
onClick={() => { if (!busy && page.offset > 0) onPage(Math.max(0, page.offset - HISTORY_PAGE)); }}>Previous</button>
<span>{page.offset + (count ? 1 : 0)} to {page.offset + count} of {page.total}</span>
<button type="button" className="ao-button is-quiet" disabled={busy || !page.cursor}
onClick={() => { if (!busy && page.cursor) onPage(Number(page.cursor)); }}>Next</button>
</nav>;
}
function TodayPanel(props: TodayProps) {
const { state, editable, excluded, sending, decideError, dismissing, onApprove, onDismissStart,
onDismissReason, onDismissCancel, onDismiss, onRetry } = props;
const [group, setGroup] = useState<TodayGroup>("items");
const [hiddenByGroup, setHiddenByGroup] = useState<Record<TodayGroup, string[]>>(() => ({
items: defaultHiddenColumns(OPERATOR_TODAY_COLUMNS), apps: defaultHiddenColumns(OPERATOR_APP_COLUMNS), held: [],
}));
const hidden = hiddenByGroup[group];
const setHidden = (keys: string[]) => setHiddenByGroup(current => ({ ...current, [group]: keys }));
const [sorts, setSorts] = useState<SortSpec>([]);
const [filters, setFilters] = useState<FilterTree>(emptyFilters);
if (state.phase === "loading") return <Skeleton />;
if (state.phase === "error") return <Failed message={state.message} onRetry={onRetry} />;
const { items, appItems, held, dataDate, pages } = state.value;
const fields = operatorFields(group === "apps" ? OPERATOR_APP_COLUMNS
.filter(column => column.key !== "product" && column.key !== "decision").map(column => [column.key, column.label] as const)
: group === "held" ? [["sku", "SKU"], ["reason", "Reason"], ["campaign", "Campaign"]] : TODAY_FIELDS);
const statusField: Field = { key: "status", label: "Status", type: "select", source: "overlay", options: ["Open", "Decided"] };
const filterFields = [...fields, statusField];
const rows = sortProposals(group === "items" ? items : group === "apps" ? appItems : [], sorts, filters, filterFields, true);
const heldRows = runPipeline({ rawRows: held.map((row, index) => ({ ...row, pid: index + 1 })), fields,
sorts, filters: [], search: "", groupBy: null, collapsed: new Set() }).visibleRows.flatMap(row =>
row.kind === "data" ? [held[row.record.pid - 1]] : []);
const open = rows.filter(isOpen);
const batch = open.filter((row) => !excluded.has(row.id));
const count = group === "items" ? items.length : group === "apps" ? appItems.length : held.length;
const visibleCount = group === "held" ? heldRows.length : rows.length;
const pageLabels = { items: "Ad change pages", apps: "App item pages", held: "Held pages" };
return <div className="ao-view ao-grid-shell" data-surface="operator-today-grid" data-hidden={hidden.join(" ")}
aria-busy={props.busy}>
<WithheldItems count={state.value.withheldCount} />
<div className="ao-grid-toolbar">
<span className="ao-grid-view"><ModeIcon mode="grid" />Grid view</span>
<Popover label="Group" icon={<SquaresFour size={16} aria-hidden="true" />} active tone="group">
{() => <div role="group" aria-label="Today group"><GroupBuilder
fields={operatorFields([["items", `Ad changes (${pages.items.total})`],
["apps", `From your Apps (${pages.apps.total})`], ["held", `Held (${pages.held.total})`]])}
groupBy={group} allowUngrouped={false} readOnly={sending}
onGroupBy={key => { if (key === "items" || key === "apps" || key === "held") {
setGroup(key); onDismissCancel();
} }} /></div>}
</Popover>
<GridControls fields={fields} hidden={hidden} onHidden={setHidden} sorts={sorts} onSorts={setSorts}
filters={filters} onFilters={setFilters} search={props.search} onSearch={props.onSearch} />
{group !== "held" && <Popover label="Filter" icon={<Funnel size={16} aria-hidden="true" />} active={filters.nodes.length > 0} tone="filter" wide>
{() => <div role="group" aria-label="Filter current page"><FilterBuilderPanel fields={filterFields}
filters={filters} onChange={next => { setFilters(next); onDismissCancel(); }} /></div>}
</Popover>}
</div>
<div className="ao-bar ao-grid-decisions">
{dataDate && <span className="ao-date">Ads data for {dayWords(dataDate)}</span>}
{editable && open.length > 0 && <div className="ao-actions">
{dismissing && dismissing.id === null
? <ReasonForm label={`Reason to dismiss ${batch.length}`} submitLabel={`Dismiss ${batch.length}`}
ready={batch.length > 0} value={dismissing.reason}
busy={sending} inline onChange={onDismissReason} onCancel={onDismissCancel}
onSubmit={() => onDismiss(batch.map((row) => row.id), dismissing.reason)} />
: <button type="button" className="ao-button ao-dismiss-many" disabled={sending || batch.length === 0}
onClick={() => onDismissStart(null)}>{`Dismiss ${batch.length}`}</button>}
<button type="button" className="ao-button is-primary" disabled={sending || batch.length === 0}
onClick={() => onApprove(batch)}>{sending ? "Sending" : `Approve ${batch.length}`}</button>
</div>}
</div>
{decideError && <p className="ao-error" role="alert">{decideError}</p>}
<div className="ao-grid-viewport" key={group}>
{group === "items" ? <AdTable items={rows} props={props} offset={pages.items.offset} hidden={hidden} />
: group === "apps" ? <AppTable items={rows} props={props} offset={pages.apps.offset} hidden={hidden} />
: <HeldTable items={heldRows} offset={pages.held.offset} />}
{visibleCount === 0 && <p className="ao-empty" role="status">{group === "held" ? "No held items"
: filters.nodes.length === 0 ? "Nothing to change today" : "No matches on this page"}</p>}
</div>
<Pager label={pageLabels[group]} page={pages[group]} count={count} busy={props.busy || sending}
onPage={(offset) => props.onPage(group, offset)} />
</div>;
}
interface HistoryProps extends SearchProps {
state: Load<HistoryPage>;
filter: string;
loadingMore: boolean;
moreError: string;
onFilter: (status: string) => void;
offset: number;
onPage: (offset: number) => void;
onOpen: (row: Proposal) => void;
onRetry: () => void;
editable: boolean;
undoing: boolean;
resultUrl: (id: string) => string;
onUndo: (id: string) => Promise<void>;
onToday: () => void;
}
function SentResults({ row, editable, undoing, resultUrl, onUndo, onToday }: {
row: Proposal;
} & Pick<HistoryProps, "editable" | "undoing" | "resultUrl" | "onUndo" | "onToday">) {
const [state, setState] = useState<Load<ChangeResults>>({ phase: "loading" });
const [attempt, setAttempt] = useState(0);
const [undoError, setUndoError] = useState("");
const endpoint = resultUrl(row.id);
useEffect(() => {
const controller = new AbortController();
setState({ phase: "loading" });
void fetch(endpoint, { credentials: CREDENTIALS, signal: controller.signal })
.then((response) => readJson(response, "Results could not be loaded."))
.then((body) => { if (!controller.signal.aborted) setState({ phase: "ready", value: parseResults(body, row.id) }); })
.catch((reason: unknown) => {
if (!controller.signal.aborted) setState({ phase: "error", message: reason instanceof Error
? reason.message : "Results could not be loaded." });
});
return () => controller.abort();
}, [endpoint, row.id, attempt]);
const undo = async () => {
setUndoError("");
try { await onUndo(row.id); }
catch (reason) { setUndoError(reason instanceof Error ? reason.message : "Undo could not be added."); }
};
if (state.phase === "loading") return <td colSpan={10} className="ao-result-loading" aria-busy="true">Loading results</td>;
if (state.phase === "error") return <td colSpan={10}>
<Failed message={state.message} onRetry={() => setAttempt((n) => n + 1)} /></td>;
const report = state.value;
const profit = (value: number | null | undefined) => value == null ? "Unavailable" : money(value);
const acos = (value: number | null | undefined) => value == null ? "Unavailable" : `${money(value)}%`;
return <>
{report.windows.map((window) => window.waiting
? <td key={window.days} colSpan={4} data-result-window={window.days} className="ao-result-wait">
Result arrives {dayWords(window.availableOn)}
</td>
: <Fragment key={window.days}>
<td className="is-num" data-result-window={window.days} data-metric="profit-before"
aria-label={`${window.days} day profit after ads and COGS before: ${profit(window.before?.profit)}. ${window.reason}`}>
{profit(window.before?.profit)}</td>
<td className="is-num" data-result-window={window.days} data-metric="profit-after"
aria-label={`${window.days} day profit after ads and COGS after: ${profit(window.after?.profit)}. ${window.reason}`}>
{profit(window.after?.profit)}</td>
<td className="is-num" data-result-window={window.days} data-metric="acos-before"
aria-label={`${window.days} day ACoS before: ${acos(window.before?.acos)}. ${window.reason}`}>
{acos(window.before?.acos)}</td>
<td className="is-num" data-result-window={window.days} data-metric="acos-after"
aria-label={`${window.days} day ACoS after: ${acos(window.after?.acos)}. ${window.reason}`}>
{acos(window.after?.acos)}</td>
</Fragment>)}
<td className="ao-budget-spend is-num">
{report.budgetSpend ? <Popover label={profit(report.budgetSpend.cost)} icon={null}>
{() => report.budgetSpend && <div className="ao-grid-options ao-budget-detail">
<strong>Spend under changed budget</strong>
<p>{report.budgetSpend.basis}</p>
<p>Daily totals include send and Undo days. Past spend stays.</p>
{report.budgetSpend.reason && <p>{report.budgetSpend.reason}</p>}
</div>}
</Popover> : <span className="ao-result-note">Not applicable</span>}
</td>
<td className="ao-grid-undo">
{editable && report.undo.available && !report.undo.item && <button type="button" className="ao-button ao-undo"
disabled={undoing} aria-label={`Undo ${row.change}`} title="Add an Undo proposal to Today"
onClick={() => void undo()}>{undoing ? "Adding Undo" : "Undo"}</button>}
{report.undo.item && <span className="ao-result-note" role="status">
{report.undo.item.status === "proposed" ? "Undo is in Today" : `Undo: ${outcomeOf(report.undo.item)?.label || report.undo.item.status}`}
{editable && report.undo.item.status === "proposed" && <button type="button" className="ao-link" onClick={onToday}>View in Today</button>}
</span>}
{!report.undo.available && report.undo.reason && <span className="ao-result-note" title={report.undo.reason}>{report.undo.reason}</span>}
{undoError && <p className="ao-error" role="alert">{undoError}</p>}
</td>
</>;
}
function HistoryPanel({ state, filter, loadingMore, moreError, onFilter, offset, onPage, onOpen, onRetry,
editable, undoing, resultUrl, onUndo, onToday, search, onSearch }: HistoryProps) {
const [hidden, setHidden] = useState<string[]>([]);
const [sorts, setSorts] = useState<SortSpec>([]);
const [filters, setFilters] = useState<FilterTree>(() => ({ conj: "and", nodes: filter
? [createFilterRule({ colId: "status", op: "eq", value: HISTORY_FILTERS.find(([value]) => value === filter)?.[1] ?? filter })] : [] }));
const fields = operatorFields(HISTORY_FIELDS);
const filterFields: Field[] = [...fields, { key: "status", label: "Status", type: "select", source: "overlay",
options: HISTORY_FILTERS.filter(([value]) => value).map(([, label]) => label) }];
const grid = useGridSelection();
const rows = state.phase === "ready" ? sortProposals(state.value.items, sorts, filters, filterFields) : [];
return <div className="ao-view ao-grid-shell" data-surface="operator-history-grid" data-hidden={hidden.join(" ")}
aria-busy={loadingMore}>
{state.phase === "ready" && <WithheldItems count={state.value.withheldCount} />}
<div className="ao-grid-toolbar">
<span className="ao-grid-view"><ModeIcon mode="grid" />Grid view</span>
<GridControls fields={fields} hidden={hidden} onHidden={setHidden}
sorts={sorts} onSorts={setSorts} filters={filters} onFilters={setFilters} search={search} onSearch={onSearch} />
<Popover label={filter ? `Filter: ${HISTORY_FILTERS.find(([value]) => value === filter)?.[1]}` : "Filter"}
icon={<Funnel size={16} aria-hidden="true" />} active={filters.nodes.length > 0} tone="filter" wide>
{() => <div role="group" aria-label="History status"><FilterBuilderPanel fields={filterFields}
filters={filters} onChange={next => { setFilters(next); onFilter(operatorHistoryStatus(next)); }} /></div>}
</Popover>
</div>
{state.phase === "loading" && <Skeleton />}
{state.phase === "error" && <Failed message={state.message} onRetry={onRetry} />}
{state.phase === "ready" && <div className="ao-grid-viewport">
<table {...grid.table} aria-label="History grid" className="ao-table ao-history">
<thead>
<tr><th scope="col" aria-label="Row">#</th><ColumnHeaders columns={OPERATOR_HISTORY_COLUMNS} />
{filter === "sent" && <>
{[7, 14].map((days) => <Fragment key={days}>
<th scope="col" className="is-num ao-metric-head" title={`${days} day profit after ads and COGS before`}
aria-label={`${days} day profit after ads and COGS before`}>
{days}d profit<small>Before</small></th>
<th scope="col" className="is-num ao-metric-head" title={`${days} day profit after ads and COGS after`}
aria-label={`${days} day profit after ads and COGS after`}>
{days}d profit<small>After</small></th>
<th scope="col" className="is-num ao-metric-head">{days}d ACoS<small>Before</small></th>
<th scope="col" className="is-num ao-metric-head">{days}d ACoS<small>After</small></th>
</Fragment>)}
<th scope="col" className="is-num ao-spend-head" title="Spend under changed budget">Budget spend</th>
<th scope="col" className="ao-undo-head">Undo</th>
</>}
</tr>
</thead>
<tbody>
{rows.map((row, index) => <tr key={row.id} data-row-id={row.id} aria-selected={grid.selected === row.id}
className={filter === "sent" && row.status === "sent" && row.kind !== APP_KIND ? "ao-row ao-change-results" : "ao-row"}
data-surface={filter === "sent" && row.status === "sent" && row.kind !== APP_KIND ? "ads-change-result" : undefined}>
<td className="ao-grid-marker">{offset + index + 1}</td>
<ProductCell row={row} onOpen={onOpen} />
<td className="ao-c-day is-num" data-field="day">{dayWords(row.day, "short")}</td>
<td className="ao-c-campaign" data-field="campaign">
<button type="button" className="ao-open" title={row.campaign || row.app} onClick={() => onOpen(row)}>{row.campaign || row.app}</button>
<AdTag adType={row.adType} />
</td>
<ValueCells row={row} />
<td className="ao-c-source" data-field="source">{row.decidedBy || "Decision source not recorded"}</td>
<td className="ao-c-decision" data-field="decision">
<span className="ao-status" data-status={row.status}>
{decisionLabel(row.status)}</span>
</td>
<td className="ao-c-outcome" data-field="outcome"><Outcome row={row} /></td>
{filter === "sent" && (row.status === "sent" && row.kind !== APP_KIND
? <SentResults row={row} editable={editable} undoing={undoing} resultUrl={resultUrl}
onUndo={onUndo} onToday={onToday} />
: <td colSpan={10} className="ao-result-note">Not applicable</td>)}
</tr>)}
</tbody>
</table>
{rows.length === 0 && <p className="ao-empty" role="status">No proposals yet</p>}
</div>}
{moreError && state.phase === "ready" && <Failed message={moreError} onRetry={onRetry} />}
<Pager label="History pages" page={{ offset, total: state.phase === "ready" ? state.value.total ?? 0 : 0,
open: 0, cursor: state.phase === "ready" ? state.value.cursor : null }}
count={state.phase === "ready" ? state.value.items.length : 0} busy={loadingMore} onPage={onPage} />
</div>;
}
interface ScheduleCampaign { campaign_id: string; campaign: string; ad_type: string; connection_id: string; profile_id: string }
interface ScheduleCell {
weekday: number; day: string; hour: number; dates: string[]; reason: string | null;
spend: number | null; orders: number | null; sales: number | null; acos: number | null;
}
export interface ScheduleReport {
campaign_id: string; ad_type: string; connection_id: string; profile_id: string; start: string; end: string;
state: string; reason: string | null; timezone: string | null; currency: string | null;
attribution_window: string; source_table: string; grid: ScheduleCell[];
validation: { ok: boolean; detail: string; days: { date: string; ok: boolean; hourly_spend: number | null;
daily_spend: number | null; reasons: string[] }[] };
}
export interface ScheduleHeatmapProps {
label: string; unit: string; period: string;
series: { id: string; label: string; points: { x: string; value: number | null }[] }[];
}
/** Integrate binds the public viz/kit/charts Heatmap. */
export const OperatorScheduleKitContext = createContext<{ Heatmap: ComponentType<ScheduleHeatmapProps> } | null>(null);
const SCHEDULE_DAYS = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
const SCHEDULE_METRICS = [["spend", "Spend"], ["orders", "Orders"], ["acos", "ACoS"]] as const;
type ScheduleMetric = typeof SCHEDULE_METRICS[number][0];
const scheduleKey = (row: ScheduleCampaign) => JSON.stringify([row.ad_type, row.connection_id, row.profile_id, row.campaign_id]);
const scheduleValue = (value: number | null, metric: string) => value === null ? "Unavailable"
: value.toLocaleString(undefined, { maximumFractionDigits: metric === "orders" ? 0 : 2 }) + (metric === "acos" ? "%" : "");
const object = (value: unknown): Record<string, unknown> => value && typeof value === "object" && !Array.isArray(value)
? value as Record<string, unknown> : {};
const finiteMetric = (value: unknown) => value === null || typeof value === "number" && Number.isFinite(value);
export function parseScheduleReport(value: unknown, campaign: ScheduleCampaign, start: string, end: string): ScheduleReport {
const body = object(value), validation = object(body.validation);
const dates: string[] = [];
for (const day = new Date(`${start}T00:00:00Z`); day.toISOString().slice(0, 10) <= end; day.setUTCDate(day.getUTCDate() + 1)) {
dates.push(day.toISOString().slice(0, 10));
}
if (body.campaign_id !== campaign.campaign_id || body.ad_type !== "sp" || campaign.ad_type !== "sp"
|| body.connection_id !== campaign.connection_id || body.profile_id !== campaign.profile_id
|| body.start !== start || body.end !== end || body.attribution_window !== "14d"
|| body.source_table !== "amzn_ads_sp_hourly" || typeof validation.ok !== "boolean"
|| !["ready", "partial", "empty", "unavailable", "unsupported"].includes(text(body.state))
|| !Array.isArray(body.grid) || body.grid.length !== 168 || !Array.isArray(validation.days)
|| validation.days.length !== dates.length || !validation.days.every((raw, index) => {
const row = object(raw);
return row.date === dates[index] && typeof row.ok === "boolean" && finiteMetric(row.hourly_spend)
&& finiteMetric(row.daily_spend) && Array.isArray(row.reasons) && row.reasons.every(v => typeof v === "string");
}) || !body.grid.every((raw, index) => {
const row = object(raw), weekday = Math.floor(index / 24);
const selectedDates = dates.filter(date => (new Date(`${date}T00:00:00Z`).getUTCDay() + 6) % 7 === weekday);
return row.weekday === weekday && row.day === SCHEDULE_DAYS[weekday] && row.hour === index % 24
&& JSON.stringify(row.dates) === JSON.stringify(selectedDates)
&& (row.reason === null || typeof row.reason === "string")
&& ["spend", "orders", "sales", "acos"].every(key => finiteMetric(row[key]));
})) throw new Error("Schedule data is unavailable.");
return body as unknown as ScheduleReport;
}
function useScheduleRead(endpoint: string | null, attempt: number, surface = "Schedule"): Load<unknown> {
const tenant = currentTenant(), key = JSON.stringify([tenant, endpoint, attempt]);
const [state, setState] = useState<{ key: string; value: Load<unknown> } | null>(null);
useEffect(() => {
if (!endpoint) return;
let active = true;
const controller = new AbortController();
const timer = window.setTimeout(() => controller.abort(), 20000);
const clear = () => { active = false; controller.abort(); setState(null); };
const events = ["aios:tenant-changed", "aios:signed-out", UNAUTHORIZED_EVENT];
events.forEach(event => window.addEventListener(event, clear));
setState({ key, value: { phase: "loading" } });
void fetch(endpoint, { method: "GET", credentials: CREDENTIALS, cache: "no-store", signal: controller.signal })
.then(async response => {
if (!response.ok) throw new Error([401, 403, 404].includes(response.status)
? `No permission to view this ${surface}` : `${surface} could not be loaded`);
const value: unknown = await response.json();
if (active && tenant === currentTenant()) setState({ key, value: { phase: "ready", value } });
}).catch((error: unknown) => {
if (active && tenant === currentTenant()) setState({ key, value: { phase: "error",
message: error instanceof Error ? error.message : `${surface} could not be loaded` } });
}).finally(() => window.clearTimeout(timer));
return () => { active = false; controller.abort(); window.clearTimeout(timer);
events.forEach(event => window.removeEventListener(event, clear)); };
}, [endpoint, attempt, tenant, key, surface]);
return state?.key === key ? state.value : { phase: "loading" };
}
export function ScheduleFigures({ report, metric, Heatmap }: { report: ScheduleReport; metric: ScheduleMetric;
Heatmap?: ComponentType<ScheduleHeatmapProps> }) {
const ref = useRef<HTMLTableElement>(null);
const label = SCHEDULE_METRICS.find(([key]) => key === metric)![1];
const series = SCHEDULE_DAYS.map((day, weekday) => ({ id: String(weekday), label: day,
points: report.grid.filter(cell => cell.weekday === weekday).map(cell => ({
x: `${String(cell.hour).padStart(2, "0")}:00`, value: cell[metric] })) }));
const navigate = (event: KeyboardEvent<HTMLTableElement>) => {
const cells = Array.from(ref.current?.querySelectorAll<HTMLTableCellElement>("tbody td") ?? []);
const index = cells.indexOf(event.target as HTMLTableCellElement);
const jump = { ArrowRight: 1, ArrowLeft: -1, ArrowDown: 24, ArrowUp: -24 }[event.key];
if (jump === undefined && event.key !== "Home" && event.key !== "End") return;
event.preventDefault();
const next = cells[event.key === "Home" ? 0 : event.key === "End" ? cells.length - 1
: Math.max(0, Math.min(cells.length - 1, index < 0 ? 0 : index + jump!))];
next?.focus(); next?.scrollIntoView({ block: "nearest", inline: "nearest" });
};
return <div className="ao-schedule-figures">
<p className="ao-schedule-context">{report.start} to {report.end} · {report.timezone || "Timezone unavailable"}
{report.currency ? ` · ${report.currency}` : ""} · 14d attribution</p>
{report.reason && <p role="status">{report.reason}</p>}
{report.validation.ok && Heatmap ? <Heatmap label={`${label} by weekday and hour`} series={series}
unit={metric === "acos" ? "percent" : metric === "spend" ? report.currency || "money" : "count"}
period={`${report.start} to ${report.end}`} />
: <p role="status">{!report.validation.ok ? "Daily totals need review" : "Charts unavailable"}</p>}
<section className="ao-grid-shell ao-schedule-grid" data-surface="operator-schedule-grid">
<div className="ao-grid-toolbar"><span className="ao-grid-view"><ModeIcon mode="grid" />Grid view</span>
<span>{label}</span></div>
<div className="ao-grid-viewport"><table ref={ref} role="grid" tabIndex={0} onKeyDown={navigate}
className="ao-table" aria-label={`${label} by weekday and hour`}>
<thead><tr><th scope="col">Weekday</th>{Array.from({ length: 24 }, (_, hour) =>
<th key={hour} scope="col" className="is-num">{String(hour).padStart(2, "0")}:00</th>)}</tr></thead>
<tbody>{SCHEDULE_DAYS.map((day, weekday) => <tr key={day} className="ao-row"><th scope="row">{day}</th>
{report.grid.filter(cell => cell.weekday === weekday).map(cell => <td key={cell.hour} tabIndex={-1}
className="is-num" data-weekday={weekday} data-hour={cell.hour} data-metric={metric}
title={cell.reason || cell.dates.join(", ")}>{scheduleValue(cell[metric], metric)}</td>)}</tr>)}</tbody>
</table></div><div className="ao-grid-footer">Profile time · Missing cells stay unavailable</div>
</section>
<details data-surface="operator-schedule-validation"><summary>Daily validation</summary>
{report.validation.days.map(day => <p key={day.date} data-date={day.date} data-ok={day.ok}>
{day.date}: {scheduleValue(day.hourly_spend, "spend")} hourly / {scheduleValue(day.daily_spend, "spend")} daily.
{day.ok ? " Within 2%." : ` ${day.reasons.join(" ")}`}</p>)}
</details>
</div>;
}
function ScheduleRecords({ title, records, runs, editable, busy, onApprove, onSwitch }: {
title: string; records: Record<string, unknown>[]; runs?: boolean; editable: boolean; busy: boolean;
onApprove: (id: string) => void; onSwitch: (id: string, enabled: boolean) => void;
}) {
const grid = useGridSelection();
const display = (value: unknown) => typeof value === "number" && Number.isFinite(value)
? value.toLocaleString(undefined, { maximumFractionDigits: 2 }) : text(value) || "Unknown";
return <section className="ao-grid-shell ao-schedule-records" data-surface={runs ? "operator-schedule-runs" : "operator-schedule-records"}>
<div className="ao-grid-toolbar"><span>{title}</span><span>{records.length} on this page</span></div>
<div className="ao-grid-viewport"><table {...grid.table} className="ao-table" aria-label={title}>
<thead><tr><th scope="col">Campaign</th><th scope="col">Connection</th><th scope="col">Timing</th>
<th scope="col">Change</th><th scope="col">Approval</th><th scope="col">Status</th></tr></thead>
<tbody>{records.map(row => {
const id = text(row.id), rules = (Array.isArray(row.rules) ? row.rules : [row.rule]).map(object);
const weekdays = ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"];
const timing = rules.map(rule => `${weekdays[Number(rule.weekday)]} ${String(rule.hour).padStart(2, "0")}:00`).join(", ");
const change = rules[0]?.action === "set_bid" ? `Bid ${display(rules[0]?.value)}` : "Pause ads";
return <tr key={id} data-row-id={id} aria-selected={grid.selected === id} className="ao-row" data-status={runs ? text(row.status) : row.enabled ? "on" : "off"}>
<td title={text(row.campaign_id)}>{text(row.campaign_id)}</td>
<td title={`${text(row.connection_id)} / ${text(row.profile_id)}`}>{text(row.connection_id)} / {text(row.profile_id)}</td>
<td title={`${timing} ${text(row.timezone)}`}>{timing} {text(row.timezone)}</td>
<td title={runs ? `${display(row.previous_value)} to ${display(row.new_value)} · ${text(row.source)}` : change}>
{runs ? `${display(row.previous_value)} to ${display(row.new_value)}` : change}</td>
<td title={`${text(row.approved_by)} ${text(row.approved_at)}`}>{text(row.approved_by) || "Needs approval"}</td>
<td title={runs ? `${text(row.cause)} ${text(row.outcome_at) || text(row.claimed_at)}` : undefined}>
{runs ? <span>{text(row.status)} · {text(row.outcome_at) || text(row.claimed_at)}{row.cause ? ` · ${text(row.cause)}` : ""}</span>
: <><span>{row.enabled ? "On" : "Off"}</span>{editable && (!row.approved_by
? <button type="button" className="ao-button" disabled={busy} aria-label={`Approve schedule ${id}`}
onClick={() => onApprove(id)}>Approve once</button>
: <button type="button" className="ao-button" disabled={busy} aria-label={`Switch schedule ${id} ${row.enabled ? "off" : "on"}`}
onClick={() => onSwitch(id, !row.enabled)}>{row.enabled ? "Turn off" : "Turn on"}</button>)}</>}
</td>
</tr>;
})}</tbody>
</table></div>
{!records.length && <p className="ao-empty" role="status">{runs ? "No schedule runs yet" : "No schedules yet"}</p>}
</section>;
}
function ScheduleManager({ appId, campaign, canEdit }: { appId: string; campaign?: ScheduleCampaign; canEdit?: boolean }) {
const [attempt, setAttempt] = useState(0), [busy, setBusy] = useState(false), [message, setMessage] = useState("");
const [schedulePages, setSchedulePages] = useState<(string | null)[]>([null]);
const [runPages, setRunPages] = useState<(string | null)[]>([null]);
const [targetPages, setTargetPages] = useState<(string | null)[]>([null]);
const [action, setAction] = useState("set_bid"), [bid, setBid] = useState(""), [entity, setEntity] = useState("");
const [weekdays, setWeekdays] = useState<number[]>([]), [hours, setHours] = useState<number[]>([]);
const alive = useRef(true), pending = useRef(false), tenant = currentTenant();
useEffect(() => { alive.current = true; return () => { alive.current = false; }; }, []);
const endpoint = (path: string, extra: Record<string, string> = {}) => `${API_V1}/app-kinds/amazon_operator/${path}?`
+ new URLSearchParams({ app: appId, ...extra });
const schedules = useScheduleRead(endpoint("schedules", { ...(schedulePages.at(-1) ? { cursor: schedulePages.at(-1)! } : {}) }), attempt);
const runs = useScheduleRead(endpoint("schedule-runs", { ...(runPages.at(-1) ? { cursor: runPages.at(-1)! } : {}) }), attempt);
const targets = useScheduleRead(campaign ? endpoint("schedule-targets", { ...campaign, action,
...(targetPages.at(-1) ? { cursor: targetPages.at(-1)! } : {}) }) : null, attempt);
const body = schedules.phase === "ready" ? object(schedules.value) : {};
const runBody = runs.phase === "ready" ? object(runs.value) : {};
const targetBody = targets.phase === "ready" ? object(targets.value) : {};
const rows = (value: unknown) => (Array.isArray(value) ? value : []).map(object);
const editable = canEdit === true && body.canEdit === true;
const choices = rows(targetBody.items), selected = choices.find(row => JSON.stringify(row) === entity);
const mutate = async (path: string, method: string, payload?: unknown) => {
if (!editable || pending.current || tenant !== currentTenant()) return;
pending.current = true; setBusy(true); setMessage("");
const controller = new AbortController(), timer = window.setTimeout(() => controller.abort(), 20000);
try {
const response = await fetch(endpoint(path), { method, credentials: CREDENTIALS, signal: controller.signal,
headers: { "Content-Type": "application/json" }, ...(payload === undefined ? {} : { body: JSON.stringify(payload) }) });
if (!response.ok) throw new Error("The schedule could not be saved. Check its campaign and try again.");
if (alive.current && tenant === currentTenant()) { setAttempt(value => value + 1); setMessage("Saved"); }
} catch (error) {
if (alive.current && tenant === currentTenant()) setMessage(error instanceof Error ? error.message : "Schedule unavailable");
} finally { window.clearTimeout(timer); pending.current = false; if (alive.current) setBusy(false); }
};
const pageButtons = (label: string, page: Record<string, unknown>, stack: (string | null)[], set: (value: (string | null)[]) => void) =>
<nav className="ao-bar ao-grid-footer" aria-label={label}>
<button type="button" className="ao-button" disabled={busy || stack.length === 1} onClick={() => set(stack.slice(0, -1))}>Previous</button>
<button type="button" className="ao-button" disabled={busy || !text(page.cursor)} onClick={() => set([...stack, text(page.cursor)])}>Next</button>
</nav>;
return <section className="ao-schedule-manager" data-surface="operator-schedule-manager">
{schedules.phase === "loading" ? <span className="lp-spin lp-spin--lg" role="status" aria-label="Loading schedules" />
: schedules.phase === "error" ? <Failed message={schedules.message} onRetry={() => setAttempt(v => v + 1)} /> : <>
<div className="ao-bar"><h3>Schedules</h3>
<label className="ao-schedule-switch"><input type="checkbox" role="switch" aria-label="App schedules" checked={body.enabled === true}
disabled={!editable || busy} onChange={event => void mutate("schedule-switch", "PUT", { enabled: event.target.checked })} />
App schedules {body.enabled === true ? "on" : "off"}</label></div>
{!editable && <p role="status">View only</p>}
{editable && campaign && <form className="ao-schedule-form" data-surface="operator-schedule-create" onSubmit={event => {
event.preventDefault();
if (!selected || !weekdays.length || !hours.length) return;
const rules = weekdays.flatMap(weekday => hours.map(hour => ({ weekday, hour, action,
value: action === "set_bid" ? Number(bid) : "paused", ad_group_id: selected.ad_group_id,
...(action === "set_bid" ? { target_id: selected.target_id } : { ad_ids: [selected.ad_id] }) })));
void mutate("schedules", "POST", { ...campaign, rules });
}}>
<div className="ao-bar">
<label className="ao-field">Change<select className="ao-select" aria-label="Schedule action" value={action} disabled={busy}
onChange={event => { setAction(event.target.value); setEntity(""); setTargetPages([null]); }}>
<option value="set_bid">Set bid</option><option value="pause_ads">Pause ads</option></select></label>
<label className="ao-field">Target<select className="ao-select" aria-label="Schedule target" value={entity} disabled={busy || targets.phase !== "ready"}
onChange={event => setEntity(event.target.value)}><option value="">Choose target</option>
{choices.map(row => <option key={JSON.stringify(row)} value={JSON.stringify(row)}>
{text(row.ad_group_id)} / {text(row.target_id) || text(row.ad_id)}</option>)}</select></label>
{action === "set_bid" && <label className="ao-field">Bid<input className="ao-select" aria-label="Schedule bid" type="number" min="0.01" step="0.01"
required value={bid} disabled={busy} onChange={event => setBid(event.target.value)} /></label>}
</div>
{targets.phase === "error" && <Failed message={targets.message} onRetry={() => setAttempt(v => v + 1)} />}
{targets.phase === "ready" && pageButtons("Schedule target pages", targetBody, targetPages, value => { setTargetPages(value); setEntity(""); })}
<fieldset disabled={busy}><legend>Weekdays</legend><div className="ao-bar">
{["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"].map((label, value) =>
<label key={label}><input type="checkbox" checked={weekdays.includes(value)} onChange={event =>
setWeekdays(values => event.target.checked ? [...values, value] : values.filter(day => day !== value))} />{label}</label>)}
</div></fieldset>
<fieldset disabled={busy}><legend>Hours in Ads profile time</legend><div className="ao-schedule-hours">
{Array.from({ length: 24 }, (_, hour) => <label key={hour}><input type="checkbox" aria-label={`Hour ${hour}`} checked={hours.includes(hour)}
onChange={event => setHours(values => event.target.checked ? [...values, hour] : values.filter(value => value !== hour))} />
{String(hour).padStart(2, "0")}:00</label>)}
</div></fieldset>
<button type="submit" className="ao-button" disabled={busy || !selected || !weekdays.length || !hours.length || (action === "set_bid" && !(Number(bid) > 0))}>
Create schedule</button>
</form>}
<p role="status" aria-live="polite">{message}</p>
<ScheduleRecords title="Saved schedules" records={rows(body.items)} editable={editable} busy={busy}
onApprove={id => void mutate(`schedules/${id}/approve`, "POST")}
onSwitch={(id, enabled) => void mutate(`schedules/${id}/enabled`, "PUT", { enabled })} />
{pageButtons("Saved schedule pages", body, schedulePages, setSchedulePages)}
</>}
{runs.phase === "loading" ? <span className="lp-spin lp-spin--lg" role="status" aria-label="Loading schedule runs" />
: runs.phase === "error" ? <Failed message={runs.message} onRetry={() => setAttempt(v => v + 1)} /> : <>
<ScheduleRecords title="Schedule runs" records={rows(runBody.items)} runs editable={false} busy={busy} onApprove={() => {}} onSwitch={() => {}} />
{pageButtons("Schedule run pages", runBody, runPages, setRunPages)}
</>}
</section>;
}
export function SchedulePanel({ appId, end: fixedEnd, canEdit }: { appId: string; end?: string; canEdit?: boolean }) {
const kit = useContext(OperatorScheduleKitContext);
const [days, setDays] = useState(7), [attempt, setAttempt] = useState(0);
const [defaultEnd] = useState(() => new Date(Date.now() - 86400000).toISOString().slice(0, 10));
const end = fixedEnd ?? defaultEnd;
const first = new Date(`${end}T00:00:00Z`); first.setUTCDate(first.getUTCDate() - days + 1);
const start = first.toISOString().slice(0, 10);
const [cursors, setCursors] = useState<(string | null)[]>([null]);
const [chosen, setChosen] = useState("");
const [metric, setMetric] = useState<ScheduleMetric>("spend");
const endpoint = (path: string, extra: Record<string, string> = {}) => `${API_V1}/app-kinds/amazon_operator/${path}?`
+ new URLSearchParams({ app: appId, start, end, ...extra });
const campaigns = useScheduleRead(endpoint("overview", { limit: "50", sort: "campaign",
...(cursors.at(-1) ? { cursor: cursors.at(-1)! } : {}) }), attempt);
const page = campaigns.phase === "ready" ? object(object(campaigns.value).campaigns) : {};
const rows = (Array.isArray(page.items) ? page.items : []).map(object).filter(row => row.ad_type === "sp"
&& [row.campaign_id, row.connection_id, row.profile_id].every(value => typeof value === "string" && !!value)) as unknown as ScheduleCampaign[];
const campaign = rows.find(row => scheduleKey(row) === chosen) ?? rows[0];
const load = useScheduleRead(campaign ? endpoint("schedule-grid", { campaign_id: campaign.campaign_id,
ad_type: campaign.ad_type, connection_id: campaign.connection_id, profile_id: campaign.profile_id }) : null, attempt);
let report: ScheduleReport | null = null, invalid = false;
if (load.phase === "ready" && campaign) {
try { report = parseScheduleReport(load.value, campaign, start, end); } catch { invalid = true; }
}
const retry = () => setAttempt(value => value + 1);
return <section className="ao-schedule" data-surface="operator-schedule">
<div className="ao-bar ao-schedule-controls">
<label className="ao-field"><span>Period</span><select className="ao-select" aria-label="Schedule period" value={days}
onChange={event => { setDays(Number(event.target.value)); setCursors([null]); setChosen(""); }}>
{[7, 14, 30, 90].map(value => <option key={value} value={value}>Last {value} days</option>)}
</select></label>
<label className="ao-field ao-schedule-campaign"><span>Campaign</span><select className="ao-select" aria-label="Schedule campaign"
value={campaign ? scheduleKey(campaign) : ""} disabled={!rows.length}
onChange={event => setChosen(event.target.value)}>
{!rows.length && <option value="">No Sponsored Products campaigns on this page</option>}
{rows.map(row => <option key={scheduleKey(row)} value={scheduleKey(row)}>
{row.campaign || row.campaign_id} ({row.connection_id}, {row.profile_id})</option>)}
</select></label>
<label className="ao-field"><span>Metric</span><select className="ao-select" aria-label="Schedule metric" value={metric}
onChange={event => setMetric(event.target.value as ScheduleMetric)}>
{SCHEDULE_METRICS.map(([key, label]) => <option key={key} value={key}>{label}</option>)}
</select></label>
</div>
{campaigns.phase === "loading" ? <span className="lp-spin lp-spin--lg" role="status" aria-label="Loading campaigns" />
: campaigns.phase === "error" ? <Failed message={campaigns.message} onRetry={retry} />
: <>
<nav className="ao-bar" aria-label="Schedule campaign pages">
<button type="button" className="ao-button" disabled={cursors.length === 1}
onClick={() => { setCursors(stack => stack.slice(0, -1)); setChosen(""); }}>Previous</button>
<span>{num(page.total)?.toLocaleString() ?? "Unavailable"} campaigns</span>
<button type="button" className="ao-button" disabled={!text(page.cursor)}
onClick={() => { setCursors(stack => [...stack, text(page.cursor)]); setChosen(""); }}>Next</button>
</nav>
<ScheduleManager key={campaign ? scheduleKey(campaign) : appId} appId={appId} campaign={campaign} canEdit={canEdit} />
{!campaign ? <p role="status">Hourly data is available for Sponsored Products only.</p>
: load.phase === "loading" ? <span className="lp-spin lp-spin--lg" role="status" aria-label="Loading Schedule" />
: load.phase === "error" ? <Failed message={load.message} onRetry={retry} />
: invalid ? <Failed message="Schedule data is unavailable." onRetry={retry} />
: report && <ScheduleFigures report={report} metric={metric} Heatmap={kit?.Heatmap} />}
</>}
</section>;
}
const changeEndpoint = (appId: string, path: string, params: Record<string, string> = {}) =>
`${API_V1}/app-kinds/amazon_operator/${path}?${new URLSearchParams({ app: appId, ...params })}`;
const changeScope = (row: Record<string, unknown>): Record<string, string> => Object.fromEntries(
["connection_id", "profile_id", "ad_type", "campaign_id", "currency"].map(key => [key, text(row[key])]));
const changeKey = (row: Record<string, unknown>) => JSON.stringify(changeScope(row));
function ChangePageButtons({ label, pages, cursor, onPage, total, countNoun = "records" }: {
label: string; pages: string[]; cursor: string; onPage: (pages: string[]) => void; total?: number | null; countNoun?: string;
}) {
return <nav className="ao-bar ao-grid-footer" aria-label={label}>
<button type="button" className="ao-button" disabled={pages.length === 1}
onClick={() => onPage(pages.slice(0, -1))}>Previous</button>
<span>{total == null ? `Page ${pages.length}` : `${total.toLocaleString()} ${countNoun}`}</span>
<button type="button" className="ao-button" disabled={!cursor}
onClick={() => onPage([...pages, cursor])}>Next</button>
</nav>;
}
function useChangeCampaigns(appId: string, all: boolean) {
const [pages, setPages] = useState([""]), [chosen, setChosen] = useState("");
const [attempt, setAttempt] = useState(0);
const load = useScheduleRead(changeEndpoint(appId, "pacing-campaigns", { cursor: pages.at(-1)!, limit: "50" }), attempt, "campaign list");
const body = load.phase === "ready" ? object(load.value) : {};
const rows = (Array.isArray(body.items) ? body.items : []).map(object);
const campaign = rows.find(row => changeKey(row) === chosen) ?? (all ? undefined : rows[0]);
const controls = <>
<label className="ao-field ao-change-campaign">Campaign<select className="ao-select" aria-label="Change campaign"
value={campaign ? changeKey(campaign) : ""} disabled={!rows.length}
onChange={event => setChosen(event.target.value)}>
{all && <option value="">All campaigns</option>}
{!all && !rows.length && <option value="">No campaigns</option>}
{rows.map(row => <option key={changeKey(row)} value={changeKey(row)}>
{text(row.campaign) || text(row.campaign_id)} ({text(row.ad_type)}, {text(row.connection_id)}, {text(row.profile_id)}, {text(row.currency) || "Currency not recorded"})
</option>)}
</select></label>
{load.phase === "error" && <Failed message={load.message} onRetry={() => setAttempt(v => v + 1)} />}
{load.phase === "loading" && <span className="lp-spin" role="status" aria-label="Loading campaign filters" />}
<ChangePageButtons label="Change campaign pages" pages={pages} cursor={text(body.cursor)} total={num(body.total)} countNoun="campaigns"
onPage={value => { setPages(value); setChosen(""); }} />
</>;
return { campaign, controls, load };
}
const changeType = (operation: unknown) => ({ set_bid: "Bid", set_daily_budget: "Daily budget", pause_ads: "Pause",
enable_ads: "Enable", add_negative_keyword: "Negative exact" }[text(operation)] || "Change");
export function ChangeLogPanel({ appId }: { appId: string }) {
const { campaign, controls } = useChangeCampaigns(appId, true);
const [hidden, setHidden] = useState(() => defaultHiddenColumns(OPERATOR_CHANGE_LOG_COLUMNS));
const [source, setSource] = useState(""), [pages, setPages] = useState([""]), [attempt, setAttempt] = useState(0);
const scope = campaign ? changeScope(campaign) : {};
const identity = JSON.stringify([source, scope]);
const [pageIdentity, setPageIdentity] = useState(identity);
// A filter change never sends the preceding filter's cursor.
const currentPages = pageIdentity === identity ? pages : [""];
useEffect(() => { setPages([""]); setPageIdentity(identity); }, [identity]);
const load = useScheduleRead(changeEndpoint(appId, "change-log", { ...scope, source, limit: "50", cursor: currentPages.at(-1)! }), attempt, "change log");
const body = load.phase === "ready" ? object(load.value) : {};
const rows = (Array.isArray(body.items) ? body.items : []).map(object);
const grid = useGridSelection();
return <section className="ao-grid-shell ao-change-log" data-surface="operator-change-log" data-hidden={hidden.join(" ")}>
<div className="ao-grid-toolbar">
<span className="ao-grid-view"><ModeIcon mode="grid" size={16} />Grid view</span>
<FieldControls fields={operatorFields(OPERATOR_CHANGE_LOG_COLUMNS.filter(column => column.key !== "product")
.map(column => [column.key, column.label] as const))} hidden={hidden} onHidden={setHidden} />
<label className="ao-field">Source<select className="ao-select" aria-label="Change source" value={source}
onChange={event => setSource(event.target.value)}><option value="">All sources</option>
{["Inbox", "Undo", "Schedule", "Wasted spend"].map(value => <option key={value}>{value}</option>)}
</select></label>{controls}
</div>
{load.phase === "loading" ? <Skeleton /> : load.phase === "error"
? <Failed message={load.message} onRetry={() => setAttempt(v => v + 1)} /> : <>
<div className="ao-grid-viewport"><table {...grid.table} className="ao-table ao-change-table" aria-label="Ad change log"
style={{ width: gridWidth(OPERATOR_CHANGE_LOG_COLUMNS, hidden) }}>
<thead><tr><ColumnHeaders columns={OPERATOR_CHANGE_LOG_COLUMNS} sized /></tr></thead>
<tbody>{rows.map(row => <tr key={text(row.id)} data-row-id={text(row.id)} aria-selected={grid.selected === text(row.id)}>
<td className="ao-c-product" data-field="product">
<span className="ao-product-picture" role="img" aria-label="Product image not supplied" />
<span className="ao-product-copy">{text(row.sku) || text(row.asin) || "Product not recorded"}
<small>{text(row.asin) || text(row.sku) || "No SKU or ASIN"}</small></span>
</td>
<td data-field="at">{text(row.at) ? <time dateTime={text(row.at)}>{new Date(text(row.at)).toLocaleString(undefined, { timeZone: "UTC" })} UTC</time> : "Not recorded"}</td>
<td data-field="operation">{changeType(row.operation)}</td>
<td className="ao-c-value is-num" data-field="old_value">{operatorValueText(scalar(row.old_value), text(row.value_unit), text(row.currency), text(row.values_reason))}</td>
<td className="ao-c-value is-num" data-field="new_value">{operatorValueText(scalar(row.new_value), text(row.value_unit), text(row.currency), text(row.values_reason))}</td>
<td className={`ao-c-value ao-c-delta is-num${typeof row.value_change === "number"
? row.value_change > 0 ? " is-up" : row.value_change < 0 ? " is-down" : "" : ""}`} data-field="value_change">
{operatorValueText(scalar(row.value_change), text(row.value_unit), text(row.currency), text(row.values_reason), true)}</td>
<td data-field="source">{text(row.source) || "Source not recorded"}
<small>{text(row.approver) || "Decision source not recorded"}</small>
{text(row.evidence_table) && <small>{text(row.evidence_table)}</small>}</td>
<td data-field="approver">{text(row.approver) || "Decision source not recorded"}</td>
<td data-field="campaign">{text(row.campaign) || "Not recorded"}<small>{AD_TAGS[text(row.ad_type)] || "Ad type not recorded"}</small></td>
<td data-field="account">{row.binding_recorded === true ? <>{text(row.connection_id)}<small>{text(row.profile_id)}</small></> : "Not recorded"}</td>
<td data-field="status"><span className="ao-status" data-status={text(row.status)}>{row.status === "sent" ? "Sent" : row.status === "refused" ? "Refused" : "Unknown"}</span>
{text(row.cause) && <small>{text(row.cause)}</small>}</td><td data-field="currency">{text(row.currency) || "Not recorded"}</td>
</tr>)}</tbody>
</table>{!rows.length && <p className="ao-empty" role="status">No changes recorded</p>}</div>
<ChangePageButtons label="Change log pages" pages={currentPages} cursor={text(body.cursor)} total={num(body.total)} onPage={setPages} />
</>}
</section>;
}
interface PacingDay { date: string; budget: number | null; spend: number | null }
interface PacingReport { month: string; timezone: string; currency: string; days: PacingDay[];
recordedSpend: number | null; monthlySpend: number | null; monthlyBudget: number | null; budgetDays: number; spendDays: number }
function parsePacing(raw: unknown, campaign: Record<string, unknown>, month: string): PacingReport {
const row = object(raw), validation = object(row.validation);
if (validation.ok !== true || !text(row.timezone) || !text(row.currency) || !text(row.month)
|| (month && row.month !== month) || !Array.isArray(row.days)
|| Object.entries(changeScope(campaign)).some(([key, value]) => row[key] !== value)) {
throw new Error(text(validation.reason) || "Budget pacing could not be validated.");
}
return { month: text(row.month), timezone: text(row.timezone), currency: text(row.currency),
days: row.days.map(value => { const day = object(value); return { date: text(day.date), budget: num(day.budget), spend: num(day.spend) }; }),
recordedSpend: num(row.recorded_spend), monthlySpend: num(row.monthly_spend), monthlyBudget: num(row.monthly_budget),
budgetDays: num(row.budget_days) ?? 0, spendDays: num(row.spend_days) ?? 0 };
}
function PacingCalendar({ report }: { report: PacingReport }) {
const first = new Date(`${report.month}-01T00:00:00Z`);
const pad = (first.getUTCDay() + 6) % 7;
const label = first.toLocaleDateString(undefined, { month: "long", year: "numeric", timeZone: "UTC" });
return <>
<div className="ao-bar ao-pacing-heading"><h3>{label}</h3><span>{report.timezone} · {report.currency}</span></div>
<div className="ao-pacing-summary">
{[["Monthly budget", report.monthlyBudget], ["Monthly spend", report.monthlySpend], ["Recorded spend", report.recordedSpend]].map(([label, value]) =>
<div className="ao-pacing-kpi" key={String(label)}><span>{label}</span><strong>{typeof value === "number" ? money(value) : "Unavailable"}</strong></div>)}
</div>
<p className="ao-pacing-basis" role="status">{report.budgetDays} of {report.days.length} budgets recorded · {report.spendDays} of {report.days.length} spend days · Recorded spend ties to the selected Ads report</p>
<div className="ao-pacing-viewport"><div className="ao-pacing-calendar" role="table" aria-label={`${label} budget pacing`}>
<div className="ao-pacing-week" role="row">{["Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"].map(day =>
<div key={day} role="columnheader">{day}</div>)}</div>
{Array.from({ length: Math.ceil((pad + report.days.length) / 7) }, (_, week) =>
<div className="ao-pacing-week" role="row" key={week}>{Array.from({ length: 7 }, (_, weekday) => {
const day = report.days[week * 7 + weekday - pad];
return day ? <div role="cell" className="ao-pacing-day" data-date={day.date} key={weekday}>
<time dateTime={day.date}>{Number(day.date.slice(-2))}</time>
<span className="ao-pacing-budget">Budget <strong>{recordedValue(day.budget)}</strong></span>
<span className="ao-pacing-spend">Spend <strong>{day.spend == null ? "Unavailable" : money(day.spend)}</strong></span>
</div> : <div role="cell" className="ao-pacing-day is-empty" key={weekday} />;
})}</div>)}
</div></div>
</>;
}
export function BudgetPacingPanel({ appId }: { appId: string }) {
const { campaign, controls, load: campaigns } = useChangeCampaigns(appId, false);
const [month, setMonth] = useState(""), [monthPages, setMonthPages] = useState([""]), [attempt, setAttempt] = useState(0);
const scope = campaign ? changeScope(campaign) : null;
const identity = JSON.stringify(scope);
const [selectedIdentity, setSelectedIdentity] = useState(identity);
const selectedMonth = identity === selectedIdentity ? month : "";
const pages = identity === selectedIdentity ? monthPages : [""];
useEffect(() => { setMonth(""); setMonthPages([""]); setSelectedIdentity(identity); }, [identity]);
const months = useScheduleRead(scope ? changeEndpoint(appId, "pacing-months", { ...scope, cursor: pages.at(-1)!, limit: "12" }) : null, attempt, "month list");
const monthBody = months.phase === "ready" ? object(months.value) : {};
const available = Array.isArray(monthBody.items) ? monthBody.items.map(text) : [];
const load = useScheduleRead(scope ? changeEndpoint(appId, "budget-pacing", { ...scope, ...(selectedMonth ? { month: selectedMonth } : {}) }) : null, attempt, "budget pacing");
let report: PacingReport | null = null, error = "";
if (load.phase === "ready" && campaign) {
try { report = parsePacing(load.value, campaign, selectedMonth); } catch (cause) { error = cause instanceof Error ? cause.message : "Budget pacing is unavailable."; }
}
const shownMonth = selectedMonth || report?.month || text(monthBody.current_month);
return <section className="ao-budget-pacing" data-surface="operator-budget-pacing">
<div className="ao-grid-toolbar">{controls}
<label className="ao-field">Month<select className="ao-select" aria-label="Pacing month" value={shownMonth}
disabled={months.phase !== "ready"} onChange={event => setMonth(event.target.value)}>
{[...new Set([shownMonth, ...available])].filter(Boolean).map(value => <option key={value}>{value}</option>)}
</select></label>
<ChangePageButtons label="Pacing month pages" pages={pages} cursor={text(monthBody.cursor)}
onPage={value => { setMonthPages(value); setMonth(""); }} />
</div>
{months.phase === "error" && <Failed message={months.message} onRetry={() => setAttempt(v => v + 1)} />}
{campaigns.phase === "ready" && !campaign ? <p role="status">No campaign history is available</p>
: load.phase === "loading" ? <span className="lp-spin lp-spin--lg" role="status" aria-label="Loading budget pacing" />
: load.phase === "error" || error ? <Failed message={error || (load.phase === "error" ? load.message : "Budget pacing is unavailable.")}
onRetry={() => setAttempt(v => v + 1)} /> : report && <PacingCalendar report={report} />}
</section>;
}
function OperatorBody({ application, canEdit }: {
application: OperatorApplication; canEdit?: boolean;
}) {
const dashboardAdapter = useContext(OperatorDashboardContext);
const appId = application.id;
const url = useCallback((path: string, params: Record<string, string> = {}) => {
const query = new URLSearchParams({ app: appId, ...params });
return `${API_V1}/app-kinds/amazon_operator${path}?${query.toString()}`;
}, [appId]);
const [tab, setTab] = useState<OperatorTab>("today");
const [today, setToday] = useState<Load<TodayScreen>>({ phase: "loading" });
const [todayAttempt, setTodayAttempt] = useState(0);
const [todayBusy, setTodayBusy] = useState(false);
const [todayError, setTodayError] = useState("");
const [offsets, setOffsets] = useState({ items: 0, apps: 0, held: 0 });
const [historyOffset, setHistoryOffset] = useState(0);
const [search, setSearch] = useState("");
const [query, setQuery] = useState("");
const [history, setHistory] = useState<Load<HistoryPage>>({ phase: "loading" });
const [historyAttempt, setHistoryAttempt] = useState(0);
const [filter, setFilter] = useState("");
const [loadingMore, setLoadingMore] = useState(false);
const [moreError, setMoreError] = useState("");
const [excluded, setExcluded] = useState<Set<string>>(() => new Set());
const [settled, setSettled] = useState<Set<string>>(() => new Set());
const [sending, setSending] = useState(false);
const [decideError, setDecideError] = useState("");
const reviewedRemovals = useRef(new Map<string, ReviewedRemoval>());
const noteReviewed = useCallback((id: string, value: ReviewedRemoval) => { reviewedRemovals.current.set(id, value); }, []);
const [dismissing, setDismissing] = useState<Dismissing | null>(null);
const [undoing, setUndoing] = useState(false);
const undoPending = useRef(false);
const [undoNotice, setUndoNotice] = useState("");
const [opened, setOpened] = useState<{ row: Proposal; from: "today" | "history" } | null>(null);
const todayTab = useRef<HTMLButtonElement | null>(null);
const sharedTabStrip = useRef<HTMLDivElement | null>(null);
const focusTodayPending = useRef(false);
const opener = useRef<HTMLElement | null>(null);
const alive = useRef(true);
useEffect(() => { alive.current = true; return () => { alive.current = false; }; }, []);
useEffect(() => {
if (tab !== "today" || !focusTodayPending.current) return;
focusTodayPending.current = false;
// Shared tabs expose semantics, so focus the selected tab after Today commits.
sharedTabStrip.current?.querySelector<HTMLElement>('[role="tab"][aria-selected="true"]')?.focus();
}, [tab, todayAttempt]);
useEffect(() => {
if (search === query) return;
const timer = window.setTimeout(() => {
setQuery(search); setOffsets({ items: 0, apps: 0, held: 0 }); setHistoryOffset(0);
}, 250);
return () => window.clearTimeout(timer);
}, [search, query]);
useEffect(() => {
if (sending || dismissing || tab !== "today") return;
const timer = window.setInterval(() => setTodayAttempt((n) => n + 1), 30000);
return () => window.clearInterval(timer);
}, [sending, dismissing, tab]);
useEffect(() => { setSettled(new Set()); setExcluded(new Set()); }, [offsets, query]);
useEffect(() => {
const controller = new AbortController();
setTodayBusy(true);
setTodayError("");
void fetch(url("/today", { cursor: String(offsets.items), app_cursor: String(offsets.apps),
held_cursor: String(offsets.held), limit: String(HISTORY_PAGE), q: query }), { credentials: CREDENTIALS, signal: controller.signal })
.then((response) => readJson(response, "Today's proposals could not be loaded."))
.then((body) => { if (!controller.signal.aborted) setToday({ phase: "ready", value: parseToday(body) }); })
.catch((reason: unknown) => {
if (!controller.signal.aborted) {
const message = reason instanceof Error ? reason.message : "Today's proposals could not be loaded.";
setTodayError(message);
setToday((current) => current.phase === "ready" ? current : { phase: "error", message });
}
}).finally(() => { if (!controller.signal.aborted) setTodayBusy(false); });
return () => controller.abort();
}, [url, todayAttempt, offsets, query]);
useEffect(() => {
const controller = new AbortController();
setLoadingMore(true);
setMoreError("");
const params: Record<string, string> = { limit: String(HISTORY_PAGE), cursor: String(historyOffset), q: query };
if (filter) params.status = filter;
void fetch(url("/history", params), { credentials: CREDENTIALS, signal: controller.signal })
.then((response) => readJson(response, "History could not be loaded."))
.then((body) => { if (!controller.signal.aborted) setHistory({ phase: "ready", value: parseHistory(body) }); })
.catch((reason: unknown) => {
if (!controller.signal.aborted) {
const message = reason instanceof Error ? reason.message : "History could not be loaded.";
setMoreError(message);
setHistory((current) => current.phase === "ready" ? current : { phase: "error", message });
}
}).finally(() => { if (!controller.signal.aborted) setLoadingMore(false); });
return () => controller.abort();
}, [url, filter, historyAttempt, historyOffset, query]);
const screen = today.phase === "ready" ? today.value : null;
const editable = canEdit === true && screen?.canEdit === true;
const openCount = useMemo(() => (screen
? screen.pages.items.open + screen.pages.apps.open : null), [screen]);
const historyCount = history.phase === "ready"
? history.value.total ?? history.value.items.length : null;
const toggle = (id: string) => setExcluded((current) => {
const next = new Set(current);
if (next.has(id)) next.delete(id); else next.add(id);
return next;
});
const toggleAll = (open: Proposal[], include: boolean) => setExcluded((current) => {
const next = new Set(current);
for (const row of open) { if (include) next.delete(row.id); else next.add(row.id); }
return next;
});
/** Approve or dismiss ids as one decision. Each row then shows its own result in place. */
const decide = async (decision: "approve" | "dismiss", ids: string[], note = "") => {
if (!ids.length) return;
const fallback = decision === "approve" ? "The batch was not sent." : "The dismissal was not saved.";
setSending(true);
setDecideError("");
try {
const response = await fetch(url(`/${decision}`), {
method: "POST", credentials: CREDENTIALS, headers: { "Content-Type": "application/json" },
body: JSON.stringify(decision === "approve"
? { item_ids: ids, reviews: Object.fromEntries(ids.filter((id) => reviewedRemovals.current.has(id))
.map((id) => [id, reviewedRemovals.current.get(id)])) }
: { item_ids: ids, reason: note.trim() }),
});
const body = await readJson(response, fallback) as { rows?: unknown; withheldCount?: unknown } | null;
if ((num(body?.withheldCount) ?? 0) > 0) {
setTodayAttempt((count) => count + 1);
setHistoryAttempt((count) => count + 1);
setOpened(null);
throw new Error(`${num(body?.withheldCount)} items need access you do not have`);
}
const rows = new Map<string, Record<string, unknown>>();
for (const item of Array.isArray(body?.rows) ? body.rows : []) {
const row = (item ?? {}) as Record<string, unknown>;
if (text(row.id)) rows.set(text(row.id), row);
}
if (!alive.current) return;
// Each row keeps its place and shows its own result, so nothing in the table moves.
const settle = (item: Proposal): Proposal => {
const row = rows.get(item.id);
if (!row) return item;
const status = text(row.status);
if (status === "sent" || status === "refused" || status === "approved") {
return { ...item, status, cause: text(row.cause) };
}
if (status === "dismissed") return { ...item, status, note: note.trim() };
return { ...item, status: text(row.current) || item.status, notice: text(row.cause) || undefined };
};
setToday((current) => {
if (current.phase !== "ready") return current;
const items = current.value.items.map(settle);
const appItems = current.value.appItems.map(settle);
const pages = current.value.pages;
return { phase: "ready", value: { ...current.value, items, appItems, pages: {
...pages,
items: { ...pages.items, open: Math.max(0, pages.items.open
- current.value.items.filter(isOpen).length + items.filter(isOpen).length) },
apps: { ...pages.apps, open: Math.max(0, pages.apps.open
- current.value.appItems.filter(isOpen).length + appItems.filter(isOpen).length) },
} } };
});
setSettled((current) => new Set([...current, ...ids]));
setDismissing(null);
setHistoryAttempt((count) => count + 1);
} catch (reason) {
if (alive.current) setDecideError(reason instanceof Error ? reason.message : fallback);
} finally {
if (alive.current) setSending(false);
}
};
const showToday = () => {
focusTodayPending.current = true;
setSearch(""); setQuery(""); setOffsets({ items: 0, apps: 0, held: 0 });
setSettled(new Set()); setExcluded(new Set()); setDismissing(null); setOpened(null);
setToday({ phase: "loading" }); setTodayAttempt((count) => count + 1); setTab("today");
todayTab.current?.focus();
};
const proposeUndo = async (proposalId: string) => {
if (!editable || sending || undoPending.current) return;
undoPending.current = true;
setUndoing(true);
try {
const response = await fetch(url("/undo"), {
method: "POST", credentials: CREDENTIALS, headers: { "Content-Type": "application/json" },
body: JSON.stringify({ proposal_id: proposalId }),
});
const body = await readJson(response, "Undo could not be added.");
const item = parseProposal(body);
if (!item || item.status !== "proposed") throw new Error("Undo is no longer open. Refresh History.");
if (!alive.current) return;
setUndoNotice("Undo added to Today");
setHistoryAttempt((count) => count + 1);
showToday();
} finally {
undoPending.current = false;
if (alive.current) setUndoing(false);
}
};
const openRow = (row: Proposal, from: "today" | "history") => {
opener.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
setOpened({ row, from });
};
const closeRow = useCallback(() => {
setOpened(null);
opener.current?.focus();
}, []);
// A Today drawer reads the live row, so a result that lands while it is open shows there too.
const openedRow = !opened ? null : opened.from === "today"
? [...(screen?.items ?? []), ...(screen?.appItems ?? [])].find((row) => row.id === opened.row.id) ?? opened.row
: opened.row;
const tabs: [typeof tab, string, number | null][] = [["today", "Today", openCount], ["dashboard", "Dashboard", null], ["wasted", "Wasted spend", null], ["schedule", "Schedule", null], ["history", "History", historyCount], ["changes", "Change log", null], ["pacing", "Budget pacing", null]];
const AppTabs = dashboardAdapter?.AppTabs;
const changeTab = (key: OperatorTab) => { setTab(key); setOpened(null); };
const tabKeys = (event: KeyboardEvent<HTMLDivElement>) => {
const step = event.key === "ArrowRight" ? 1 : event.key === "ArrowLeft" ? -1 : 0;
if (!step && event.key !== "Home" && event.key !== "End") return;
event.preventDefault();
const index = event.key === "Home" ? 0 : event.key === "End" ? tabs.length - 1
: (tabs.findIndex(([key]) => key === tab) + step + tabs.length) % tabs.length;
changeTab(tabs[index][0]);
event.currentTarget.querySelectorAll<HTMLButtonElement>('[role="tab"]')[index]?.focus();
};
return <div className="ao-app">
<p id="ao-grid-help" className="ao-grid-help">Arrow keys move between cells. Enter opens proposal details.
Space selects a row. Tab reaches row actions. Escape closes a menu or details.</p>
<div className="ao-scroll">
{AppTabs ? <div ref={sharedTabStrip}><AppTabs tabs={tabs} value={tab} onChange={changeTab} /></div>
: <div className="ao-tabs" role="tablist" aria-label="Amazon operator" onKeyDown={tabKeys}>
{tabs.map(([key, label, count]) => <button key={key} ref={key === "today" ? todayTab : undefined}
type="button" role="tab" aria-selected={tab === key} tabIndex={tab === key ? 0 : -1}
id={`ao-tab-${appId}-${key}`} aria-controls={`ao-panel-${appId}`}
className={tab === key ? "ao-tab is-active" : "ao-tab"} onClick={() => changeTab(key)}>
{label}{count !== null && <span className="ao-count">{count}</span>}
</button>)}
</div>}
<div className="ao-body" role="tabpanel" id={`ao-panel-${appId}`} aria-label={tabs.find(([key]) => key === tab)?.[1]}>
{undoNotice && tab === "today" && <p className="ao-undo-notice" role="status">{undoNotice}</p>}
{todayError && tab === "today" && today.phase === "ready" && <Failed message={todayError} onRetry={() => setTodayAttempt((n) => n + 1)} />}
{tab === "dashboard" ? <AdsOverview key={appId} appId={appId} /> : tab === "today"
? <TodayPanel state={today} busy={todayBusy} search={search} onSearch={setSearch} onPage={(section, offset) => {
setOffsets((current) => ({ ...current, [section]: offset })); setDismissing(null);
}} editable={editable} excluded={excluded} settled={settled} sending={sending || todayBusy}
decideError={decideError} dismissing={dismissing} onToggle={toggle} onToggleAll={toggleAll}
onApprove={(batch) => void decide("approve", batch.map((row) => row.id))}
onDismissStart={(id) => setDismissing({ id, reason: "" })}
onDismissReason={(reason) => setDismissing((current) => current && { ...current, reason })}
onDismissCancel={() => setDismissing(null)}
onDismiss={(ids, reason) => void decide("dismiss", ids, reason)}
onOpen={(row) => openRow(row, "today")}
onRetry={() => setTodayAttempt((count) => count + 1)} />
: tab === "wasted" ? <WastedSpend key={appId} appId={appId} editable={editable} useGridSelection={useGridSelection}
onDecided={() => { setTodayAttempt((value) => value + 1); setHistoryAttempt((value) => value + 1); }} />
: tab === "schedule" ? <SchedulePanel key={appId} appId={appId} canEdit={editable} />
: tab === "changes" ? <ChangeLogPanel key={appId} appId={appId} />
: tab === "pacing" ? <BudgetPacingPanel key={appId} appId={appId} />
: <HistoryPanel state={history} filter={filter} loadingMore={loadingMore} moreError={moreError}
search={search} onSearch={setSearch}
editable={editable} undoing={undoing || sending} resultUrl={(id) => url("/results", { proposal_id: id })}
onUndo={proposeUndo} onToday={showToday}
offset={historyOffset} onFilter={(status) => { setFilter(status); setHistoryOffset(0); }}
onPage={setHistoryOffset} onOpen={(row) => openRow(row, "history")}
onRetry={() => setHistoryAttempt((count) => count + 1)} />}
</div>
</div>
{openedRow && <Drawer key={openedRow.id} row={openedRow} onClose={closeRow} onReviewed={noteReviewed} editable={editable}
previousReview={reviewedRemovals.current.get(openedRow.id)} />}
</div>;
}
export default function AmazonOperatorView({ application, canEdit }: {
application: OperatorApplication; canEdit?: boolean;
}) {
return <OperatorDashboardContext.Provider value={operatorDashboardAdapter}>
<OperatorBody key={application.id} application={application} canEdit={canEdit} />
</OperatorDashboardContext.Provider>;
}
import { Fragment, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
import type { ComponentType, KeyboardEvent, MouseEvent, FocusEvent } from "react";
import { Columns, Funnel, SortAscending, SquaresFour } from "@phosphor-icons/react";
import { ModeIcon } from "../../customer-grid/seam";
import { FieldsHidePanel, FilterBuilderPanel, GroupBuilder, Popover, SortBuilder,
createFilterRule, runPipeline } from "../../filter-kit";
import type { Field, FilterTree, Row, SortSpec } from "../../filter-kit";
import { API_V1, CREDENTIALS, currentTenant, UNAUTHORIZED_EVENT } from "../../apiContract";
import { useEscapeClose } from "../../ui/useEscapeClose";
import AdsOverview, { OperatorDashboardContext } from "./AdsOverview";
import type { OperatorTab } from "./AdsOverview";
import { operatorDashboardAdapter } from "./DashboardAdapter";
import WastedSpend from "./WastedSpend";
import "../../styles/sdlc79/amazon-operator.css";
import "../../styles/sdlc81/operator-results.css";
import "../../styles/sdlc81/ads-schedule.css";
import "../../styles/sdlc81/ads-change-log.css";
// SortBuilder's "Rows shown" rules (.cg-top-n) live in Table's sheet. Never move this import into
// filter-kit/index.ts: that chunk loads before MapView's sheets and flips Table's .cg-map-zone cursor.
import "../../styles/wave45/data-applications.css";
// S79-T17 (C2, C4, R18): the Amazon operator App screen. The dispatcher draws the App frame, so this view
// draws only the Today batch, History and the item drawer. No chat panel exists here (R18).
// S79-T18 (C7): Today also lists the items other Apps posted. A decision on one goes back to its App.
export interface OperatorApplication {
id: string;
name?: string;
capabilities?: Record<string, boolean>;
}
export interface Proposal {
id: string;
status: string;
adType: string;
campaign: string;
sku: string;
asin: string;
kind: string;
/** The posting App's name and its action, on an App inbox item only. */
app: string;
action: string;
change: string;
currentValue: number | string | null;
proposedValue: number | string | null;
valueChange: number | string | null;
valueUnit: string;
valuesReason: string;
currency: string;
added: string;
planLink: string;
shipFrom: string;
prepOwner: string;
reason: string;
gate: string;
day: string;
dataDate: string;
spend: number | null;
decidedBy: string;
decidedAt: string;
note: string;
cause: string;
/** A skipped or unknown row's cause from the last approve, shown muted. */
notice?: string;
/** The removal snapshot a person reviews in the drawer before approving (S82-T56). */
review?: RemovalReview | null;
}
interface ReviewedRemoval { reviewed: unknown; validateOnly: boolean }
interface RemovalReview extends ReviewedRemoval {
/** Sent back unchanged on approve, so the source App checks the numbers its person saw. */
reviewed: unknown;
canSubmit: boolean;
fate: string;
units: number | null;
sellable: number | null;
unitCost: number | null;
currency: string;
arithmetic: Record<string, unknown> | null;
shipTo: Record<string, unknown> | null;
}
interface Held { adType: string; campaign: string; sku: string; asin: string; reason: string }
interface Page { total: number; open: number; offset: number; cursor: string | null }
interface TodayScreen { dataDate: string; items: Proposal[]; appItems: Proposal[]; held: Held[]; canEdit: boolean;
pages: { items: Page; apps: Page; held: Page }; withheldCount: number }
interface HistoryPage { items: Proposal[]; cursor: string | null; total: number | null; withheldCount: number }
interface ResultMetrics { profit: number | null; acos: number | null }
interface ResultWindow {
days: number;
availableOn: string;
waiting: boolean;
reason: string;
before: ResultMetrics | null;
after: ResultMetrics | null;
}