@tribe-nest/forge 3.57.0 → 3.59.0

package/src/i18n/en.json

@@ -229,6 +229,7 @@
   "forge.bundle_confirmation.partial_body": "Your payment went through and part of your order is confirmed. We're still finishing the rest. It will arrive by email shortly, with nothing more to pay.",
   "forge.bundle_confirmation.partial_title": "Payment received",
   "forge.bundle_confirmation.return_to_checkout": "Return to checkout",
+  "forge.bundle_confirmation.seats_title": "Your seats",
   "forge.bundle_confirmation.summary_both": "Paid in one go. Your tickets are on their way by email, and your order is confirmed.",
   "forge.bundle_confirmation.summary_order": "Paid in one go. Your order is confirmed.",
   "forge.bundle_confirmation.summary_paid": "Paid in one go.",
@@ -236,6 +237,40 @@
   "forge.bundle_confirmation.tickets_emailed": "Tickets emailed to you",
   "forge.bundle_confirmation.title": "You're all set",
   "forge.bundle_confirmation.view_orders": "View your orders",
+  "forge.call_stage.breakouts.assign_auto": "Automatically",
+  "forge.call_stage.breakouts.assign_label": "Assign people",
+  "forge.call_stage.breakouts.assign_manual": "I will assign them",
+  "forge.call_stage.breakouts.assigned_not_arrived": "(on the way)",
+  "forge.call_stage.breakouts.button": "Rooms",
+  "forge.call_stage.breakouts.close_all": "Close all rooms",
+  "forge.call_stage.breakouts.close_cancel": "Keep them open",
+  "forge.call_stage.breakouts.close_confirm": "Close rooms",
+  "forge.call_stage.breakouts.close_confirm_body": "Everyone comes back to the main room and the rooms are closed.",
+  "forge.call_stage.breakouts.count_label": "Number of rooms",
+  "forge.call_stage.breakouts.create": "Create rooms",
+  "forge.call_stage.breakouts.create_title": "Breakout rooms",
+  "forge.call_stage.breakouts.current_marker": "You are here",
+  "forge.call_stage.breakouts.empty_room": "Nobody here yet",
+  "forge.call_stage.breakouts.error": "That did not work. Try again.",
+  "forge.call_stage.breakouts.help_attendee": "The host has split this call into smaller rooms. You are moved automatically, your camera and microphone stay as they are, and you come back to the main room when the host closes the rooms or when you press Return to main room.",
+  "forge.call_stage.breakouts.help_attendee_label": "What are breakout rooms?",
+  "forge.call_stage.breakouts.help_create": "Each room is a separate call under this one. With automatic assignment everyone here is spread evenly across the rooms and moved straight away; with manual assignment nobody moves until you pick a room for them. You can join any room yourself, and everyone comes back when you close the rooms.",
+  "forge.call_stage.breakouts.help_create_label": "What happens when I create rooms?",
+  "forge.call_stage.breakouts.help_join": "Join moves you into that room; the other rooms carry on without you. Picking a room beside somebody's name moves them, and a recording you start follows the room you are in.",
+  "forge.call_stage.breakouts.help_join_label": "How do I move between rooms?",
+  "forge.call_stage.breakouts.join": "Join",
+  "forge.call_stage.breakouts.loading": "Loading rooms…",
+  "forge.call_stage.breakouts.main_room": "Main room",
+  "forge.call_stage.breakouts.move_to_label": "Move {name} to a room",
+  "forge.call_stage.breakouts.participant_count": "{count} in this room",
+  "forge.call_stage.breakouts.return_to_main": "Return to main",
+  "forge.call_stage.breakouts.return_to_main_room": "Return to main room",
+  "forge.call_stage.breakouts.status_moving": "Moving you to {room}",
+  "forge.call_stage.breakouts.status_moving_detail": "Your camera and microphone stay as they are.",
+  "forge.call_stage.breakouts.status_returning": "Returning you to the main room",
+  "forge.call_stage.breakouts.tab": "Rooms",
+  "forge.call_stage.breakouts.you_are_in": "You are in {room}",
+  "forge.call_stage.breakouts.you_are_in_main": "You are in the main room",
   "forge.call_stage.camera_start": "Start camera",
   "forge.call_stage.camera_stop": "Stop camera",
   "forge.call_stage.chat": "Chat",
@@ -353,6 +388,7 @@
   "forge.cart.aria_remove_item": "Remove item",
   "forge.cart.aria_remove_tickets": "Remove tickets",
   "forge.cart.attached_to_tickets": "Added with your tickets",
+  "forge.cart.change_seats": "Change seats",
   "forge.cart.checkout": "Checkout",
   "forge.cart.empty_title": "Your cart is empty.",
   "forge.cart.gift_for": "Gift for {recipient_name} ({recipient_email})",
@@ -436,6 +472,10 @@
   "forge.checkout.rate_days": "({days} days)",
   "forge.checkout.rate_estimated_day": "Estimated {days} day",
   "forge.checkout.rate_estimated_days": "Estimated {days} days",
+  "forge.checkout.seats_conflict_action": "Choose other seats",
+  "forge.checkout.seats_conflict_body": "{seats} for {event_title} went to another buyer. Choose other seats to continue; the rest of your cart is unchanged.",
+  "forge.checkout.seats_conflict_title": "Some of your seats were just taken",
+  "forge.checkout.seats_label": "Seats: {seats}",
   "forge.checkout.shipping": "Shipping",
   "forge.checkout.shipping_address_title": "Shipping Address",
   "forge.checkout.shipping_options_title": "Shipping Options",
@@ -809,6 +849,17 @@
   "forge.event_detail.not_found": "Event not found.",
   "forge.event_detail.presale_only": "Tickets for this event are presale only.",
   "forge.event_detail.price_from_label": "From",
+  "forge.event_seat_picker.dismiss": "Dismiss",
+  "forge.event_seat_picker.empty": "There are no seats to choose from yet.",
+  "forge.event_seat_picker.help_body": "Tap a seat to choose it and tap it again to let it go. Pinch or scroll to zoom, drag to move around the map. Grey seats are not available. Best available picks the lowest seats together for you.",
+  "forge.event_seat_picker.help_label": "How do I choose seats?",
+  "forge.event_seat_picker.loading": "Loading the seat map",
+  "forge.event_seat_picker.max_reached": "You have the most seats allowed on {tier}.",
+  "forge.event_seat_picker.mix_blocked": "That seat can't be added to your current selection.",
+  "forge.event_seat_picker.seat_unavailable": "That seat is not available.",
+  "forge.event_seat_picker.seats_taken_body": "{seats} went to another buyer. Choose again from the seats still shown as available.",
+  "forge.event_seat_picker.seats_taken_title": "Some of your seats were just taken",
+  "forge.event_seat_picker.title": "Choose your seats",
   "forge.event_series_detail.date_count": "{count} dates",
   "forge.event_series_detail.date_count_range": "{count} dates · {first_date} to {last_date}",
   "forge.event_series_detail.location_online": "Online",
@@ -883,6 +934,11 @@
   "forge.event_tickets.pwyw_range_min_max": "(minimum {min}, up to {max})",
   "forge.event_tickets.remove_discount": "Remove discount",
   "forge.event_tickets.request_tickets": "Request tickets",
+  "forge.event_tickets.seat_best_available": "Best available",
+  "forge.event_tickets.seat_remove_aria": "Remove {seat}",
+  "forge.event_tickets.seats_left_one": "{count} seat left",
+  "forge.event_tickets.seats_left_other": "{count} seats left",
+  "forge.event_tickets.seats_title": "Your seats",
   "forge.event_tickets.select_option": "Select…",
   "forge.event_tickets.select_title": "Select Tickets",
   "forge.event_tickets.subtotal": "Subtotal",
@@ -1228,6 +1284,14 @@
   "forge.payment_link_payment.preparing_payment": "Preparing payment…",
   "forge.payment_link_payment.tax_added": "+ {tax_amount} tax",
   "forge.payment_link_payment.title": "Payment request",
+  "forge.phone_input.country_label": "Country",
+  "forge.phone_input.country_placeholder": "Select country",
+  "forge.phone_input.error_invalid": "That does not look like a valid number for the country selected",
+  "forge.phone_input.error_no_country": "Please select your country first",
+  "forge.phone_input.error_required": "Please enter a phone number",
+  "forge.phone_input.hint_no_country_code": "You can leave out the country code. The flag sets it for you.",
+  "forge.phone_input.placeholder_fallback": "Phone number",
+  "forge.phone_input.warning_landline": "This looks like a landline, so it may not receive text messages.",
   "forge.podcast_episode.next": "Next →",
   "forge.podcast_episode.not_found": "Episode not found.",
   "forge.podcast_episode.pause": "Pause",
@@ -1358,6 +1422,21 @@
   "forge.review_form.title_label": "Title",
   "forge.review_form.title_placeholder": "Sum it up in a few words",
   "forge.review_form.update_submit": "Update review",
+  "forge.seat_legend.aria_label": "Map key",
+  "forge.seat_legend.left_one": "{count} left",
+  "forge.seat_legend.left_other": "{count} left",
+  "forge.seat_legend.selected": "Selected",
+  "forge.seat_legend.sold_out": "Sold out",
+  "forge.seat_legend.unavailable": "Unavailable",
+  "forge.seat_map_canvas.accessible": "accessible seat",
+  "forge.seat_map_canvas.aria_label": "Seat map",
+  "forge.seat_map_canvas.fit": "Fit the whole map",
+  "forge.seat_map_canvas.general_admission": "General admission",
+  "forge.seat_map_canvas.status_available": "available",
+  "forge.seat_map_canvas.status_selected": "selected",
+  "forge.seat_map_canvas.status_unavailable": "unavailable",
+  "forge.seat_map_canvas.zoom_in": "Zoom in",
+  "forge.seat_map_canvas.zoom_out": "Zoom out",
   "forge.signup_form.accept_terms": "I accept the Terms and Privacy Policy",
   "forge.signup_form.code_label": "Verification code",
   "forge.signup_form.code_sent": "We emailed a 6-digit code to {email}. Enter it to finish creating your account.",

package/src/index.ts

@@ -148,6 +148,7 @@ export * from "./data/queries/useWebsiteAgent";
 export * from "./data/queries/useCurrencies";
 export * from "./data/queries/useChat";
 export * from "./data/queries/useCallChat";
+export * from "./data/queries/useCallBreakouts";
 export * from "./data/queries/useAnalytics";
 export * from "./data/queries/useCommunity";
 export * from "./data/queries/useReviews";

package/src/server/_tests/buildPwaHead.spec.ts

@@ -11,7 +11,7 @@
 //  - null/undefined siteConfig degradation (never throws)
 //  - the known client bug this fixes: apple-touch-icon is always emitted when an icon exists
 //
-// Source: packages/forge/src/server/pwa.ts. Spec: docs/pwa-custom-code-initiative.md.
+// Source: packages/forge/src/server/pwa.ts. Spec: docs/archive/shipped/pwa-custom-code-initiative.md.
 
 import { describe, it, expect } from "vitest";
 import { buildPwaHead } from "../pwa";

package/src/server/_tests/buildWebManifest.spec.ts

@@ -11,7 +11,7 @@
 //  - overrides (shortcuts) merge + precedence
 //  - determinism / idempotence (same input → identical output twice)
 //
-// Source: packages/forge/src/server/pwa.ts. Spec: docs/pwa-custom-code-initiative.md.
+// Source: packages/forge/src/server/pwa.ts. Spec: docs/archive/shipped/pwa-custom-code-initiative.md.
 
 import { describe, it, expect } from "vitest";
 import { buildWebManifest, type BuildWebManifestOptions } from "../pwa";

package/src/server/_tests/forgeServiceWorkerScript.spec.ts

@@ -13,7 +13,7 @@
 //    ({ title, body, type, url, profileId, channelId, spaceId, icon }) matches the
 //    client SW, plus offline-fallback + asset-cache + skipWaiting/clients.claim.
 //
-// Source: packages/forge/src/server/pwa.ts. Spec: docs/pwa-custom-code-initiative.md.
+// Source: packages/forge/src/server/pwa.ts. Spec: docs/archive/shipped/pwa-custom-code-initiative.md.
 
 import { describe, it, expect, vi } from "vitest";
 import { forgeServiceWorkerScript, FORGE_PWA_VERSION } from "../pwa";

package/src/server/index.ts

@@ -641,7 +641,7 @@ export function toPlainText(html?: string, max = 200): string | undefined {
   return text.length > max ? `${text.slice(0, max - 1).trimEnd()}…` : text;
 }
 
-// Platform access + events (docs/app-platform-access-initiative.md). SERVER ONLY —
+// Platform access + events (docs/archive/shipped/app-platform-access-initiative.md). SERVER ONLY —
 // the client carries the app's platform credential.
 export {
   createPlatformClient,

package/src/server/pwa.ts

@@ -8,7 +8,7 @@
 // only three thin route shells (`/manifest.webmanifest`, `/sw.js`, `/offline`)
 // that call these functions.
 //
-// See docs/pwa-custom-code-initiative.md (locked decisions).
+// See docs/archive/shipped/pwa-custom-code-initiative.md (locked decisions).
 
 import type { ContentDocument } from "../content/types";
 import type { SiteConfig } from "../data/queries/useWebsite";

package/src/types/models.ts

@@ -1297,6 +1297,16 @@ export interface IEvent {
    * than trusting its absence.
    */
   hasApprovalTiers?: boolean;
+  /**
+   * This event sells RESERVED seats from a bound seat map (seating wave 2).
+   *
+   * When true, `GET /public/events/:id/seating` returns the frozen layout and
+   * the per-seat availability, and a tier that has seats on that map requires
+   * `seats[ticketId]` on the order. Optional on the wire: an API build that
+   * predates seat maps sends nothing, and a renderer must treat absent as
+   * "general admission only", which is exactly what every event was before.
+   */
+  hasSeatMap?: boolean;
   media: IMedia[];
   slug: string;
   /**

package/src/ui/analytics/ForgeAnalytics.tsx

@@ -4,6 +4,7 @@ import { useSiteConfig } from "../../data/queries/useWebsite";
 import { initMetaPixelScoped, fireMetaEventSingle } from "../../utils/metaPixel";
 import { setCurrentPageEventId, isProfilePixelSuppressed } from "../../utils/analyticsBus";
 import { useCookieConsent } from "../headless/consent/useCookieConsent";
+import { createEngagementTracker, scrollDepthOf, type EngagementTracker } from "../../utils/engagementTracker";
 
 export interface ForgeAnalyticsProps {
   /**
@@ -58,6 +59,11 @@ function currentPage(): string {
   return window.location.pathname + window.location.search;
 }
 
+/** Engaged means the visitor can see the page and it has focus. */
+function isEngaged(): boolean {
+  return typeof document !== "undefined" && document.visibilityState === "visible" && document.hasFocus();
+}
+
 /**
  * Drop-in website analytics. Render once, high in the tree (inside
  * `ForgeProvider`), and it wires the site into the platform's analytics:
@@ -65,6 +71,8 @@ function currentPage(): string {
  * - Auto page views on every navigation → `POST /public/websites/track-event`,
  *   surfaced in the admin analytics dashboard (visits, pages, geo).
  * - Auto click tracking on links/buttons (opt out with `trackClicks={false}`).
+ * - Time on page and scroll depth, as `engagement` events (engaged time only:
+ *   visible and focused).
  * - Optional Meta Pixel: pass `metaPixelId` to init the pixel and mirror each
  *   page view as a Meta `PageView` (event-id matched for CAPI de-dup).
  *
@@ -95,8 +103,19 @@ export function ForgeAnalytics({
   // runs regardless but only stores a device session once the visitor turns
   // Performance on — otherwise it stays cookieless (backend derives the id).
   const storeSession = cookieless ? perfConsent : true;
-  const { track } = useTrackEvent({ storeSession });
+  const { track, trackBeacon } = useTrackEvent({ storeSession });
   const lastPage = useRef<string | null>(null);
+  // Time on page. Pings go by beacon: most are sent as the page is hidden or
+  // unloaded, which cancels an ordinary request.
+  const beaconRef = useRef(trackBeacon);
+  beaconRef.current = trackBeacon;
+  const engagement = useRef<EngagementTracker | null>(null);
+  if (engagement.current === null) {
+    engagement.current = createEngagementTracker({
+      now: () => Date.now(),
+      send: (ping) => beaconRef.current("engagement", ping),
+    });
+  }
 
   // Consent gates. The Meta Pixel always needs `marketing`. First-party analytics
   // needs `performance` — UNLESS it's cookieless (stores nothing without consent),
@@ -129,6 +148,10 @@ export function ForgeAnalytics({
       // can dedupe against the same page view.
       setCurrentPageEventId(eventId);
       if (firstPartyOn) {
+        // Close the previous page's time before this page view is recorded, so
+        // the ping lands on the page it measured.
+        engagement.current?.flush();
+        engagement.current?.start(currentPathname(), isEngaged());
         track("page_view", {
           // `pathname` (full resolved path) is what the admin "top pages" report
           // groups on; `page` keeps the query string for detail.
@@ -178,6 +201,37 @@ export function ForgeAnalytics({
     };
   }, [firstPartyOn, metaOn, pixelId, track]);
 
+  // Engagement: first-party only, like the page views it belongs to.
+  useEffect(() => {
+    const tracker = engagement.current;
+    if (!firstPartyOn || !tracker || typeof window === "undefined") return;
+
+    const pause = () => {
+      tracker.deactivate();
+      tracker.flush();
+    };
+    const resume = () => {
+      if (isEngaged()) tracker.activate();
+    };
+    const onVisibility = () => (document.visibilityState === "visible" ? resume() : pause());
+    const onScroll = () => tracker.scrolled(scrollDepthOf(document, window));
+
+    onScroll();
+    document.addEventListener("visibilitychange", onVisibility);
+    window.addEventListener("blur", pause);
+    window.addEventListener("focus", resume);
+    window.addEventListener("pagehide", pause);
+    window.addEventListener("scroll", onScroll, { passive: true });
+    return () => {
+      pause();
+      document.removeEventListener("visibilitychange", onVisibility);
+      window.removeEventListener("blur", pause);
+      window.removeEventListener("focus", resume);
+      window.removeEventListener("pagehide", pause);
+      window.removeEventListener("scroll", onScroll);
+    };
+  }, [firstPartyOn]);
+
   // Click tracking — first-party only, one delegated listener for the document.
   useEffect(() => {
     if (!firstPartyOn || !trackClicks || typeof document === "undefined") return;

package/src/ui/analytics/_tests/ForgeAnalytics.engagement.spec.tsx

@@ -0,0 +1,78 @@
+// @vitest-environment jsdom
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { render, act, cleanup } from "@testing-library/react";
+
+/**
+ * The wiring around the engagement tracker: which page a ping is attributed
+ * to, and which transport carries it. The ordering on an SPA navigation is the
+ * part that breaks quietly: send the ping after the new page view and every
+ * page's time lands on the page the visitor went to next.
+ */
+
+const calls: { via: "track" | "beacon"; eventType: string; data: Record<string, unknown> }[] = [];
+
+vi.mock("../../../data/queries/useAnalytics", () => ({
+  newEventId: () => "evt",
+  useTrackEvent: () => ({
+    track: (eventType: string, data: Record<string, unknown>) => calls.push({ via: "track", eventType, data }),
+    trackBeacon: (eventType: string, data: Record<string, unknown>) => calls.push({ via: "beacon", eventType, data }),
+  }),
+}));
+vi.mock("../../../data/queries/useWebsite", () => ({ useSiteConfig: () => ({ data: undefined }) }));
+vi.mock("../../headless/consent/useCookieConsent", () => ({
+  useCookieConsent: () => ({ performance: true, marketing: false }),
+}));
+
+import { ForgeAnalytics } from "../ForgeAnalytics";
+
+describe("<ForgeAnalytics /> engagement", () => {
+  beforeEach(() => {
+    calls.length = 0;
+    vi.useFakeTimers({ toFake: ["Date"] });
+    vi.setSystemTime(0);
+    vi.spyOn(document, "hasFocus").mockReturnValue(true);
+    window.history.replaceState({}, "", "/first");
+  });
+
+  afterEach(() => {
+    cleanup();
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+  });
+
+  const events = () => calls.map((c) => [c.via, c.eventType, c.data.pathname, c.data.engagedMs]);
+
+  it("flushes the old page's time by beacon BEFORE the next page view", () => {
+    render(<ForgeAnalytics trackClicks={false} />);
+    vi.setSystemTime(7000);
+    act(() => window.history.pushState({}, "", "/second"));
+
+    expect(events()).toEqual([
+      ["track", "page_view", "/first", undefined],
+      ["beacon", "engagement", "/first", 7000],
+      ["track", "page_view", "/second", undefined],
+    ]);
+  });
+
+  it("sends a ping when the window loses focus, and stops the clock until it returns", () => {
+    render(<ForgeAnalytics trackClicks={false} />);
+    vi.setSystemTime(4000);
+    act(() => void window.dispatchEvent(new Event("blur")));
+    vi.setSystemTime(100_000);
+    act(() => void window.dispatchEvent(new Event("focus")));
+    vi.setSystemTime(103_000);
+    act(() => void window.dispatchEvent(new Event("pagehide")));
+
+    expect(events().filter((e) => e[1] === "engagement")).toEqual([
+      ["beacon", "engagement", "/first", 4000],
+      ["beacon", "engagement", "/first", 3000],
+    ]);
+  });
+
+  it("records nothing, pings included, when disabled", () => {
+    render(<ForgeAnalytics enabled={false} />);
+    vi.setSystemTime(10_000);
+    act(() => void window.dispatchEvent(new Event("pagehide")));
+    expect(calls).toEqual([]);
+  });
+});

package/src/ui/headless/checkout/_tests/bundleCoupon.spec.ts

@@ -69,7 +69,9 @@ describe("bundleCouponSummary — applying", () => {
   it("claims no payment when the bundle had no intent to replace", () => {
     // A bundle that has not reached start-payment yet: the client's own
     // start-payment will pick the new figure up, so nothing may supersede it.
-    const next = bundleCouponSummary(answer({ paymentSecret: "", paymentId: "", chargedAmount: 0, chargedCurrency: "" }));
+    const next = bundleCouponSummary(
+      answer({ paymentSecret: "", paymentId: "", chargedAmount: 0, chargedCurrency: "" }),
+    );
 
     expect(next.paymentUpdate).toBeNull();
     expect(next.chargedTotal).toBeNull();

package/src/ui/headless/checkout/_tests/cartResume.spec.ts

@@ -103,16 +103,12 @@ describe("resumeLineToCartItem", () => {
   it("should keep an add-on bound to the event it hangs off", () => {
     // Without this the rebuilt bundle has an add-on with no base and the server
     // refuses the whole checkout, with nothing on screen explaining why.
-    const item = resumeLineToCartItem(
-      productLine({ attachedTo: { type: "event", entityId: "event-1" } }),
-    );
+    const item = resumeLineToCartItem(productLine({ attachedTo: { type: "event", entityId: "event-1" } }));
     expect(item?.attachedTo).toEqual({ type: "event", entityId: "event-1" });
   });
 
   it("should carry the chosen variant's options so the cart can name it", () => {
-    expect(resumeLineToCartItem(productLine())?.options).toEqual([
-      { axis: "Size", value: "L", swatchHex: null },
-    ]);
+    expect(resumeLineToCartItem(productLine())?.options).toEqual([{ axis: "Size", value: "L", swatchHex: null }]);
   });
 
   it("should refuse a line with no variant rather than invent one", () => {
@@ -192,10 +188,7 @@ describe("partitionResumeLines", () => {
       title: "Tour poster",
       attachedTo: { type: "event", entityId: "event-1" },
     });
-    const parts = partitionResumeLines([
-      ticketLine({ available: false, unavailableReason: "sold_out" }),
-      poster,
-    ]);
+    const parts = partitionResumeLines([ticketLine({ available: false, unavailableReason: "sold_out" }), poster]);
 
     expect(parts.restoredLines).toEqual([]);
     expect(parts.droppedLines).toEqual([poster]);

package/src/ui/headless/checkout/_tests/seatConflict.spec.ts

@@ -0,0 +1,187 @@
+import { describe, it, expect } from "vitest";
+import { pruneSeatsFromTicketItem, type TicketCartItem } from "../../../../contexts/CartContext";
+import { cartToCheckoutLines } from "../../../../data/queries/useCheckouts";
+import {
+  cartHasSeatedLines,
+  findSeatConflict,
+  seatedLinesOf,
+  seatsTakenConflict,
+  seatsTakenIdsOf,
+} from "../seatConflict";
+import { buildLayout, buildSeating, seatAt, STALLS_TIER, GA_TIER } from "../../event/_tests/seatingFixture";
+
+/**
+ * Reserved seats riding in the bundle cart (seating wave 2, docs §12): what
+ * the cart line carries, what the create body sends, how a conflict is found
+ * and how the line is pruned. Pure, so no provider tree.
+ */
+
+const seating = buildSeating(buildLayout());
+const a1 = seatAt(seating, "Stalls", "A", "1");
+const a2 = seatAt(seating, "Stalls", "A", "2");
+
+const line = (overrides: Partial<TicketCartItem> = {}): TicketCartItem => ({
+  eventId: "ev-seated",
+  eventSlug: "seated-show",
+  eventTitle: "Seated show",
+  tickets: { [STALLS_TIER]: 2, [GA_TIER]: 1 },
+  ticketMeta: {
+    [STALLS_TIER]: {
+      title: "Stalls",
+      price: 40,
+      seatIds: [a1, a2],
+      seats: [
+        { id: a1, label: "Stalls · Row A · Seat 1" },
+        { id: a2, label: "Stalls · Row A · Seat 2" },
+      ],
+    },
+    [GA_TIER]: { title: "Standing", price: 20 },
+  },
+  bookingFee: null,
+  ...overrides,
+});
+
+describe("cartToCheckoutLines with seats", () => {
+  it("puts the seat ids on the seated tier's line and nothing on the GA line", () => {
+    const lines = cartToCheckoutLines([], [line()]);
+    expect(lines).toEqual([
+      {
+        type: "event_ticket",
+        eventId: "ev-seated",
+        ticketId: STALLS_TIER,
+        quantity: 2,
+        price: 40,
+        seatIds: [a1, a2],
+        title: "Stalls",
+        coverImage: undefined,
+      },
+      {
+        type: "event_ticket",
+        eventId: "ev-seated",
+        ticketId: GA_TIER,
+        quantity: 1,
+        price: 20,
+        title: "Standing",
+        coverImage: undefined,
+      },
+    ]);
+    expect(lines[1]).not.toHaveProperty("seatIds");
+  });
+});
+
+describe("seatedLinesOf / cartHasSeatedLines", () => {
+  it("names only the tiers that carry seats and are still in the selection", () => {
+    expect(seatedLinesOf(line())).toEqual([{ ticketId: STALLS_TIER, seatIds: [a1, a2] }]);
+    expect(cartHasSeatedLines([line()])).toBe(true);
+    expect(cartHasSeatedLines([line({ tickets: { [GA_TIER]: 1 } })])).toBe(false);
+    const plain = line({ tickets: { [GA_TIER]: 1 }, ticketMeta: { [GA_TIER]: { title: "Standing", price: 20 } } });
+    expect(cartHasSeatedLines([plain])).toBe(false);
+  });
+});
+
+describe("findSeatConflict", () => {
+  it("is null while every seat still reads available", () => {
+    expect(findSeatConflict(line(), seating)).toBeNull();
+  });
+
+  it("names a seat that no longer reads available, with the cart's label", () => {
+    const taken = buildSeating(buildLayout(), ["Stalls/A/2"]);
+    expect(findSeatConflict(line(), taken)).toEqual({
+      eventId: "ev-seated",
+      eventSlug: "seated-show",
+      eventTitle: "Seated show",
+      seatIds: [a2],
+      labels: ["Stalls · Row A · Seat 2"],
+    });
+  });
+
+  it("treats a seat the read no longer lists as gone, labelled from the read when the cart has no label", () => {
+    const rebound = { ...seating, seats: seating.seats.filter((s) => s.id !== a1) };
+    const noLabels = line({
+      ticketMeta: { [STALLS_TIER]: { title: "Stalls", price: 40, seatIds: [a1, a2] } },
+    });
+    const conflict = findSeatConflict(noLabels, rebound);
+    expect(conflict?.seatIds).toEqual([a1]);
+    // Not in the read either, so the id is the last resort.
+    expect(conflict?.labels).toEqual([a1]);
+    const stillListed = findSeatConflict(noLabels, buildSeating(buildLayout(), ["Stalls/A/1"]));
+    expect(stillListed?.labels).toEqual(["Stalls · Row A · Seat 1"]);
+  });
+
+  it("is null when the event has no map any more: the server decides", () => {
+    expect(findSeatConflict(line(), null)).toBeNull();
+    expect(findSeatConflict(line(), undefined)).toBeNull();
+  });
+});
+
+describe("seatsTakenIdsOf", () => {
+  const err = (status: number, data: unknown) => ({ response: { status, data } });
+
+  it("reads the ids off a 409 SEATS_TAKEN", () => {
+    expect(seatsTakenIdsOf(err(409, { code: "SEATS_TAKEN", details: { eventSeatIds: [a1] } }))).toEqual([a1]);
+    // The code alone, with no ids: still a seat conflict, to be re-read.
+    expect(seatsTakenIdsOf(err(409, { code: "SEATS_TAKEN" }))).toEqual([]);
+  });
+
+  it("is null for every other refusal, including another 409", () => {
+    expect(seatsTakenIdsOf(err(409, { code: "INVENTORY_HOLD_EXPIRED" }))).toBeNull();
+    expect(seatsTakenIdsOf(err(400, { code: "seats_required", details: { eventSeatIds: [a1] } }))).toBeNull();
+    expect(seatsTakenIdsOf(new Error("network"))).toBeNull();
+    expect(seatsTakenIdsOf(undefined)).toBeNull();
+  });
+});
+
+describe("seatsTakenConflict", () => {
+  it("attributes the named seats to the event whose line holds them", () => {
+    const other = line({ eventId: "ev-other", eventSlug: "other", eventTitle: "Other", tickets: { [GA_TIER]: 1 } });
+    expect(seatsTakenConflict([other, line()], [a2, "es-unknown"])).toEqual({
+      eventId: "ev-seated",
+      eventSlug: "seated-show",
+      eventTitle: "Seated show",
+      seatIds: [a2],
+      labels: ["Stalls · Row A · Seat 2"],
+    });
+  });
+
+  it("is null when no line holds any of the ids", () => {
+    expect(seatsTakenConflict([line()], ["es-unknown"])).toBeNull();
+    expect(seatsTakenConflict([line()], [])).toBeNull();
+  });
+});
+
+describe("pruneSeatsFromTicketItem", () => {
+  it("takes the seats out of their tier, shrinking its quantity, and leaves the GA tier alone", () => {
+    expect(pruneSeatsFromTicketItem(line(), [a2])).toEqual(
+      line({
+        tickets: { [STALLS_TIER]: 1, [GA_TIER]: 1 },
+        ticketMeta: {
+          [STALLS_TIER]: {
+            title: "Stalls",
+            price: 40,
+            seatIds: [a1],
+            seats: [{ id: a1, label: "Stalls · Row A · Seat 1" }],
+          },
+          [GA_TIER]: { title: "Standing", price: 20 },
+        },
+      }),
+    );
+  });
+
+  it("drops a tier left with no seat, and keeps the event while another tier remains", () => {
+    const pruned = pruneSeatsFromTicketItem(line(), [a1, a2]);
+    expect(pruned?.tickets).toEqual({ [GA_TIER]: 1 });
+    expect(pruned?.ticketMeta).toEqual({ [GA_TIER]: { title: "Standing", price: 20 } });
+  });
+
+  it("returns null when nothing is left, so the event leaves the cart", () => {
+    const seatedOnly = line({
+      tickets: { [STALLS_TIER]: 2 },
+      ticketMeta: { [STALLS_TIER]: line().ticketMeta[STALLS_TIER]! },
+    });
+    expect(pruneSeatsFromTicketItem(seatedOnly, [a1, a2])).toBeNull();
+  });
+
+  it("never substitutes: an id it does not hold changes nothing", () => {
+    expect(pruneSeatsFromTicketItem(line(), ["es-unknown"])).toEqual(line());
+  });
+});

package/src/ui/headless/checkout/_tests/useCartResume.spec.tsx

@@ -140,10 +140,7 @@ describe("useCartResume: an add-on never lands without its ticket", () => {
     // The basket this used to build is one the server refuses outright: an
     // add-on with no base. The buyer reached the payment screen, was turned
     // away, and nothing on the page ever named the poster as the reason.
-    const { result } = await resume([
-      ticketLine({ available: false, unavailableReason: "sold_out" }),
-      addon,
-    ]);
+    const { result } = await resume([ticketLine({ available: false, unavailableReason: "sold_out" }), addon]);
 
     // Nothing survived, so nothing is written to the basket at all. Before the
     // fix this was called with the poster as its only item.
@@ -152,16 +149,11 @@ describe("useCartResume: an add-on never lands without its ticket", () => {
   });
 
   it("tells the buyer the add-on was left out rather than dropping it silently", async () => {
-    const { result } = await resume([
-      ticketLine({ available: false, unavailableReason: "sold_out" }),
-      addon,
-    ]);
+    const { result } = await resume([ticketLine({ available: false, unavailableReason: "sold_out" }), addon]);
 
     expect(result.current.droppedLines.map((line) => line.title)).toEqual(["Tour poster"]);
     // Not smuggled into the server's own list: nothing about it is unavailable.
-    expect(result.current.unavailableLines.map((line) => line.title)).toEqual([
-      "General Admission",
-    ]);
+    expect(result.current.unavailableLines.map((line) => line.title)).toEqual(["General Admission"]);
   });
 
   it("leaves an orphaned add-on out of the count and the subtotal", async () => {