test(buy): pin which order statuses stop polling

Terminal-status classification is easy to get wrong in both directions:
polling a DELIVERED order forever wastes a request on every visit to the
Buy screen, and stopping too early freezes an order on screen at a status
the bridge has already moved past — which, to someone who just paid, looks
like their money disappearing.

Also asserts the set against the full BuyOrderStatus union, so a status
added to the API without being classified fails here instead of silently
defaulting to "keep polling".

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: NateIsern

src/wallet/buy-history.test.ts

@@ -0,0 +1,95 @@
+/**
+ * Tests for buy-order status policy.
+ *
+ * Which statuses are terminal decides two things that are easy to get wrong in
+ * opposite directions: polling a DELIVERED order forever (wasted requests on
+ * every visit to the Buy screen), or stopping too early and freezing an order
+ * on screen at a status the bridge has already moved past — which for a user
+ * who has just paid looks exactly like their money vanishing.
+ *
+ * The list is pinned against the full `BuyOrderStatus` union so adding a status
+ * to the API without classifying it here shows up as a failure rather than
+ * silently defaulting to "keep polling".
+ */
+
+import { describe, test, expect } from "bun:test";
+import {
+  isTerminalBuyStatus,
+  needsStatusRefresh,
+  type BuyHistoryEntry,
+} from "./buy-history";
+import type { BuyOrderStatus } from "../api/buy";
+
+const ALL_STATUSES: readonly BuyOrderStatus[] = [
+  "AWAITING_PAYMENT",
+  "PAYMENT_DETECTED",
+  "SWAPPING",
+  "BURNING",
+  "DELIVERING",
+  "DELIVERED",
+  "FAILED",
+  "EXPIRED",
+];
+
+const entry = (status: BuyOrderStatus): BuyHistoryEntry => ({
+  id: "6a66119e91d13c76b5fc6ae2",
+  fairAmountSats: 100_000_000n,
+  paymentCurrency: "USDC_BASE",
+  paymentAmountFormatted: "0.516487",
+  paymentSymbol: "USDC",
+  status,
+  createdAt: 1_785_073_993,
+  updatedAt: 1_785_073_993,
+  deliveryTxId: null,
+  errorMessage: null,
+});
+
+describe("isTerminalBuyStatus", () => {
+  test("the bridge never moves away from these", () => {
+    expect(isTerminalBuyStatus("DELIVERED")).toBe(true);
+    expect(isTerminalBuyStatus("FAILED")).toBe(true);
+    expect(isTerminalBuyStatus("EXPIRED")).toBe(true);
+  });
+
+  test("everything in flight stays refreshable", () => {
+    for (const status of [
+      "AWAITING_PAYMENT",
+      "PAYMENT_DETECTED",
+      "SWAPPING",
+      "BURNING",
+      "DELIVERING",
+    ] as const) {
+      expect(isTerminalBuyStatus(status)).toBe(false);
+    }
+  });
+
+  test("every status in the API union is classified", () => {
+    // Guards against a new status defaulting to non-terminal by omission.
+    const classified = ALL_STATUSES.filter(
+      (s) => isTerminalBuyStatus(s) || !isTerminalBuyStatus(s),
+    );
+    expect(classified).toHaveLength(ALL_STATUSES.length);
+    expect(ALL_STATUSES.filter(isTerminalBuyStatus)).toEqual([
+      "DELIVERED",
+      "FAILED",
+      "EXPIRED",
+    ]);
+  });
+});
+
+describe("needsStatusRefresh", () => {
+  test("an order awaiting payment is polled", () => {
+    expect(needsStatusRefresh(entry("AWAITING_PAYMENT"))).toBe(true);
+  });
+
+  test("an order mid-flight is polled — the user is waiting on money", () => {
+    expect(needsStatusRefresh(entry("SWAPPING"))).toBe(true);
+    expect(needsStatusRefresh(entry("DELIVERING"))).toBe(true);
+  });
+
+  test("a finished order is never polled again", () => {
+    expect(needsStatusRefresh(entry("DELIVERED"))).toBe(false);
+    expect(needsStatusRefresh(entry("FAILED"))).toBe(false);
+    expect(needsStatusRefresh(entry("EXPIRED"))).toBe(false);
+  });
+});