@seatlayer/js 0.80.3 → 0.82.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, AccessibilityType, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AccessibleSectionStep, AvailabilityRefreshOutcome, PickerController, ExpandedSeat, TableSelectionDetails, SeatStatus } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerMapTheme, PickerTransport, PickerSelectionValidator, RendererViewMode, PickerSelectionValidity, ChartTheme, AccessibilityType, FloorLabelStyle, LodRung, SectionSummary, PickerAccessNeed, SeatHoverDetails, AccessibleSectionStep, AvailabilityRefreshOutcome, PickerController, ExpandedSeat, TableSelectionDetails } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 import { T as ThemeMode } from './channelsMode-goczEzyt.js';
 export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, U as InventoryBookingObject, V as InventoryBookingState, W as InventoryBookingsPage, X as InventoryBookingsQuery, Y as LogEntry, Z as LogPage, _ as ManageApi, $ as ManageApiError, a0 as ReportByStatus, a1 as ReportCategoryMeta, a2 as ReportCategoryRow, a3 as ReportResult, a4 as SeatManager, a5 as SeatManagerActionResult, a6 as SeatManagerActivity, a7 as SeatManagerCapability, a8 as SeatManagerConnection, a9 as SeatManagerFilteredSection, aa as SeatManagerMode, ab as SeatManagerOptions, ac as SeatManagerSelectionValidity, ad as SeatManagerTallies, ae as SelectionSourceRow } from './channelsMode-goczEzyt.js';
@@ -89,7 +89,24 @@ type BuyerAccessUnavailableReason =
 /** The host's token provider threw or returned nothing usable. */
  | 'provider_failed'
 /** A one-shot `buyerAccessToken` lapsed and no provider was configured. */
- | 'no_token';
+ | 'no_token'
+/**
+ * 403 `audience_not_public`: this Season is embed-only, so an anonymous
+ * browser session cannot be minted for it. The organizer has to open the
+ * Season to the public before a tokenless embed can sell it.
+ */
+ | 'audience_not_public'
+/**
+ * 403 `sales_not_open`: the Season exists and is public, but its sales state
+ * is not open yet (or is paused, or has ended). Nothing is misconfigured and
+ * the same request may succeed later, so this one is retryable.
+ */
+ | 'sales_not_open'
+/**
+ * 403 `origin_not_allowed`: the browser's Origin is not among the embed
+ * domains the organizer declared for this Season's account.
+ */
+ | 'origin_not_allowed';
 /** The access session expired. Carries whether the refresh recovered it. */
 interface BuyerAccessExpiredEvent {
     reason: BuyerAccessRefreshReason;
@@ -1108,9 +1125,9 @@ interface SeatPickerOptions {
      */
     referral?: string;
     /**
-     * Hide the "Powered by SeatLayer" attribution badge in the side panel foot.
-     * The chart theme's own `hideBadge` flag (paid orgs) also hides it — the badge
-     * is shown only when BOTH this option and the theme flag are unset/false.
+     * @deprecated No effect since 0.81: the badge follows the account's
+     * white-label entitlement, which the server applies to the served chart.
+     * Accepted and ignored so existing embeds keep type-checking.
      */
     hideBadge?: boolean;
     /**
@@ -1509,6 +1526,15 @@ interface SeatingChartPickerState {
         rung: LodRung;
         /** True only when one semantic zoom-out step can reveal more of the venue. */
         canZoomOut: boolean;
+        /**
+         * Is the camera exactly at the whole-venue fit? Present only when the
+         * renderer can answer; a host that reads `canZoomOut` alone re-creates the
+         * dead "−" between the fit and the seats rung (web fix, 2026-09-05), so a
+         * native host should dim its "−"/"fit" controls on THIS, when present.
+         */
+        atVenueFit?: boolean;
+        /** False only at the zoom ceiling. Present only when the renderer can answer. */
+        canZoomIn?: boolean;
         focusedSectionId: string | null;
         focusedSection: SectionSummary | null;
         viewMode: RendererViewMode;
@@ -1747,7 +1773,11 @@ interface SeatingChartOptions {
     seatTooltip?: boolean;
     /** Internal hosted-runtime control. Defaults true for direct web embeds. */
     showTestModeIndicator?: boolean;
-    /** Internal hosted-runtime control. Defaults true, subject to white-label entitlement. */
+    /**
+     * @deprecated No effect since 0.81: the badge follows the account's
+     * white-label entitlement, which the server applies to the served chart.
+     * Accepted and ignored.
+     */
     showAttribution?: boolean;
     /**
      * Seat hover with everything a popover needs (category label/color, resolved
@@ -2690,9 +2720,11 @@ declare class EmbeddedDesigner {
 /**
  * pickerLegend — the two places the picker explains its colours.
  *
- * The price LIST (`.sl-price-row`) is the detail view: colour, name, how many
- * are left, the offer name, the exact price or spread. It lives in the side
- * panel on desktop and behind a disclosure inside the bottom sheet on a phone.
+ * The price LIST (`.sl-price-row`) is the detail view: colour, name, the offer
+ * name, the exact price or spread. (It no longer prints how many are left —
+ * owner call 2026-09-05 — though it still reads the count to dim a sold-out
+ * row.) It lives in the side panel on desktop and behind a disclosure inside
+ * the bottom sheet on a phone.
  *
  * The price RAIL (`.sl-rc`) is the phone's always-visible legend: colour and
  * price, nothing else, pinned above the map. It exists because on a narrow
@@ -3222,6 +3254,26 @@ interface WebMcpRegistration {
 /** What `PickerController.render()` reports back about the loaded event. */
 type PickerRenderInfo = NonNullable<Awaited<ReturnType<PickerController['render']>>>;
 
+/** What `GET /pub/orders/:id/status` returns while the webhook is in flight. */
+interface CheckoutOrderStatus {
+    orderId: string;
+    status: string;
+    totalMinor: number;
+    currency: string;
+    amountFormatted: string;
+    seatCount: number;
+    tickets?: Array<{
+        label: string;
+        token: string;
+        status: 'issued' | 'checked_in' | 'void';
+        checkedInAt: number | null;
+    }>;
+    /** Hosted ticket page — the durable re-entry point after the card closes. */
+    ticketUrl?: string;
+    /** Printable A4 PDF, up to three ticket cards per page. */
+    pdfUrl?: string;
+}
+
 declare class SeatPicker implements GaPromptPicker {
     /** @internal Read by pickerGaPrompt for the `onGAPrompt` host hook. */
     readonly opts: SeatPickerOptions;
@@ -3370,15 +3422,6 @@ declare class SeatPicker implements GaPromptPicker {
     private baZone;
     /** "★ Best seats" premium quick-pick toggle — biases best-available to premium seats. */
     private baPremium;
-    /**
-     * The buyer re-opened the best-seats form with seats already in the cart
-     * ("I picked one, actually find us three together"). The card normally
-     * yields this space to the ticket chips the moment anything is selected —
-     * which removed the accelerator at exactly the moment a one-handed phone
-     * buyer wants it. Cleared when the cart empties, a hold lands, or the
-     * buyer backs out.
-     */
-    private baReopen;
     private bestAvailableConfirm;
     /** Event sales window is closed (read-only load state / live close). */
     /** @internal */ salesClosed: boolean;
@@ -3562,6 +3605,24 @@ declare class SeatPicker implements GaPromptPicker {
     /** @internal */ webMcpHost(holds: boolean): WebMcpHost;
     /** Wire host chrome after the skeleton exists and before the renderer owns its map host. */
     private wireBuyerShell;
+    /**
+     * Open or collapse the phone sheet, and say so.
+     *
+     * The one place `data-sheet` is written together with the chevron's
+     * `aria-expanded` and its label: the two used to drift, and a chevron that
+     * says "Open ticket panel" over an open panel is worse than no label at all.
+     *
+     * @internal
+     */
+    setSheetOpen(open: boolean): void;
+    /**
+     * The empty phone cart's way in to the best-seats form.
+     *
+     * Still a FORM, not a verb: it reveals quantity/type/zone and picks nothing
+     * for anyone. Opening the sheet is not the same as arriving at the card
+     * either — on a short phone the tray can open scrolled past it.
+     */
+    private openBestSeatsForm;
     /**
      * Put the phone sheet back to its peek.
      *
@@ -3603,8 +3664,13 @@ declare class SeatPicker implements GaPromptPicker {
     setPanelCollapsed(collapsed: boolean): void;
     /** Idempotent DOM apply, also run on every layout flip (inert must lift on narrow). */
     private applyPanelCollapsed;
-    /** Build the ♿ menu (filter + limited view + palette) into the map's
-     *  bottom-left corner. The menu owns its own state machine; see the module. */
+    /**
+     * Build the ♿ menu (filter + limited view + palette) as the TOP DISC of the
+     * right-hand control column (owner call 2026-09-06). It used to stand alone
+     * in the map's bottom-left corner, which is the minimap's corner, and read
+     * as a stray control facing a stack of them. The menu owns its own state
+     * machine and docks itself first in the column; see the module.
+     */
     private buildAccessibilityMenu;
     /**
      * Jump to the seats rung when a dimming filter turns on — the dimming only
@@ -3688,7 +3754,15 @@ declare class SeatPicker implements GaPromptPicker {
      */
     private setSalesClosed;
     private applySalesClosed;
-    /** The badge is hidden when the host opts out OR the org's theme sets hideBadge. */
+    /**
+     * The badge follows the SERVED chart theme, and nothing else.
+     *
+     * The API writes `theme.hideBadge` from the owning account's white-label
+     * entitlement on every buyer-facing document, so this one flag is the whole
+     * answer. The host's own `hideBadge` option is deliberately NOT consulted:
+     * an un-entitled embed could otherwise strip the attribution by passing a
+     * boolean. It stays in the option type for compatibility, inert.
+     */
     private badgeHidden;
     /** Attribution badge in the side-panel foot (Gap 7). Hidden per host/theme. */
     private buildBadge;
@@ -3769,18 +3843,20 @@ declare class SeatPicker implements GaPromptPicker {
     /** Reflect the engine's current LOD rung onto the pill group. */
     /** @internal */ syncRung(): void;
     /**
-     * The phone's ONE map control, and whether it still has anywhere to go.
+     * The phone's back-out controls, and whether they still have anywhere to go.
      *
-     * On narrow the "fit to screen" disc is gone (CSS) and "−" is the whole
-     * back-out story: one tap to the section the buyer drilled into, one more to
-     * the whole venue. The ladder itself is `mapZoomOutStep`; this only dresses
-     * it, and only on narrow — the wide layout keeps its "+", "−" and ⛶ exactly
-     * as they were.
+     * On narrow the corner carries "+", "−" and the fit disc (owner call
+     * 2026-09-05). "−" is the ladder — one tap to the section the buyer drilled
+     * into, one more to the whole venue — and the fit disc is that last step on
+     * its own. The ladder itself is `mapZoomOutStep`; this only dresses it, and
+     * only on narrow: wide keeps "+" and "−" undimmed and never shows the disc.
      *
-     * DIMMED, NOT GONE. The control used to appear only once the buyer was deep
+     * DIMMED, NOT GONE. The controls used to appear only once the buyer was deep
      * enough to be lost, so the corner grew and shrank a button underneath their
      * thumb. A control that stays put and plainly cannot be pressed says "you
-     * are already looking at everything" without moving the target.
+     * are already looking at everything" without moving the target — as long as
+     * it dims only when that is TRUE, which is why the reading is the engine's
+     * fit pose and not a guess from whether seats happen to be on screen.
      */
     private syncMapStepBack;
     /** @internal */ syncProjection(): void;
@@ -3949,8 +4025,6 @@ declare class SeatPicker implements GaPromptPicker {
     /** @internal */ scheduleFit(): void;
     private fitTranslatedRows;
     private emitSelectionValidity;
-    /** Paint the bottom-sheet's collapsed one-liner (pickerTray.ts builds it). */
-    /** @internal */ renderPeek(count: number, total: number, pendingCount: number, bump?: boolean): void;
     /**
      * Release one buyer-visible held LINE. That is one label for a seat, and every
      * unit label behind a grouped GA line — a buyer who presses × on
@@ -3986,6 +4060,29 @@ declare class SeatPicker implements GaPromptPicker {
     private showBooked;
     /** Take the confirmation down and give the map back. The booking stands. */
     private dismissBooked;
+    /**
+     * The seats are BOUGHT. Put the picker back to the state a buyer who has
+     * just arrived would find.
+     *
+     * "Back to map" used to take down the overlay and nothing else, and what it
+     * uncovered was the cart that had paid for the booking: the same tickets
+     * still listed (with padlocks, because the labels now read `booked`), the
+     * same total in the footer, and a CTA frozen on "Opening secure checkout…"
+     * with its spinner — a control that could never finish, over a hold that no
+     * longer existed. The seats still painted as the buyer's own selection, ✕ on
+     * a row did nothing (there is no hold left to release from), and any seat
+     * added next was totalled together with tickets that were already paid for.
+     *
+     * A settled hold is not a hold, so everything that was showing one goes: the
+     * hold and its handoff, the session's remembered hold id, the timer, the
+     * selection behind the cart (which is what repaints those seats as inert
+     * `booked` rather than as picks), the GA quantities, and the CTA phase.
+     * `showBooked` has already fired `onBooked` and stopped the timer — this is
+     * about the surface it left standing, and it runs on the way OUT of the
+     * overlay, so a host that navigates away on `onBooked` (DesiPass) never
+     * reaches it.
+     */
+    private resetAfterBooking;
     /**
      * A Performance Group hold settled, told to us by the WRAPPER rather than by
      * a socket (§8: this surface has no realtime feed). `detectBooked` waits for
@@ -4065,18 +4162,10 @@ declare class SeatPicker implements GaPromptPicker {
      * group whose wrapper did not supply the nights.
      */
     private nightStripFor;
-    /**
-     * Why a tapped seat cannot be taken, or '' when it can.
-     *
-     * Only the PRESS path asks for this — a mouse already has the status tag and
-     * a card that follows the pointer, so a sentence under every hover would be
-     * noise. A partly-available group seat is excluded: its night strip already
-     * names the exact nights that block it, and "already booked" would flatly
-     * contradict the row underneath saying it is free on Friday.
-     */
-    private unavailableReason;
     private unpinTooltip;
     private handleMapPointerDown;
+    /** Close every open ⓘ popover, except `keep`. */
+    private closeInfoPops;
     private updateTooltip;
     /**
      * Push the wrapper's current seat marks at the renderer.
@@ -4265,8 +4354,6 @@ declare class SeatPicker implements GaPromptPicker {
     /** @internal */ seatViewFor3d(seatId: string): Promise<SeatView | null>;
     /** @internal */ onView3dSeatPick(seatId: string): void;
     /** @internal */ seatViewCaption(seatId: string): string;
-    /** @internal */ showUnavailable3dSeat(seat: ExpandedSeat, visualState: SeatState3D, status: Exclude<SeatStatus, 'free'>): void;
-    /** @internal */ dismissUnavailable3dSeat(): void;
     private saveView3dComparisonSeat;
     /** @internal */ clearView3dComparison(): void;
     /** @internal */ view3dComparisonSnapshot(seatId: string): {
@@ -4798,6 +4885,24 @@ declare class PerformanceGroupPicker {
 }
 
 type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'expire_pending' | 'booking_pending' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
+/**
+ * Who may open this Season in a browser.
+ *
+ * `public` is the only value an anonymous, tokenless embed can mint a session
+ * for; every other value needs a bearer minted by the organizer's own backend.
+ */
+type SeasonAudience = 'private' | 'embed_only' | 'discoverable' | 'public';
+/**
+ * Who takes the buyer's money.
+ *
+ *   'seatlayer'  the Season is sold through SeatLayer's hosted checkout, so the
+ *                widget may run `checkout: 'hosted'` end to end.
+ *   'server'     the organizer's own backend prices and charges the package;
+ *                the widget hands off and never asks for money.
+ *   null         the organizer has not chosen yet (or the worker predates the
+ *                field), which reads exactly like `'server'`.
+ */
+type SeasonCheckoutMode = 'seatlayer' | 'server';
 interface SeasonDescriptor {
     key: string;
     name: string;
@@ -4806,7 +4911,9 @@ interface SeasonDescriptor {
     currency: string;
     venue: string;
     timezone: string | null;
-    audience: 'private' | 'embed_only' | 'discoverable';
+    audience: SeasonAudience;
+    /** Absent on a worker that predates hosted Season checkout; read as `null`. */
+    checkoutMode?: SeasonCheckoutMode | null;
     planActivationId: string;
     occurrenceCount: number;
     occurrences: Array<{
@@ -4857,6 +4964,56 @@ interface SeasonCheckoutHandoff {
         state: string;
     }>;
 }
+/**
+ * One category's package price, for one package.
+ *
+ * `unitPrice` is an integer in the currency's MINOR unit, like every other
+ * money field the API returns, and it is the price of the whole package for one
+ * seat — not a per-performance price. Rendering divides by the currency's own
+ * exponent (`fromMinorUnits`), never by a hardcoded 100.
+ */
+interface SeasonCategoryPrice {
+    categoryKey: string;
+    unitPrice: number;
+}
+interface SeasonPackagePrices {
+    planKey: string;
+    name: string;
+    prices: SeasonCategoryPrice[];
+}
+/**
+ * Server-authored package prices for this Season.
+ *
+ * When this is present it OUTRANKS the host-authored `offer` copy: the server
+ * is the only party that can price what the buyer will actually be charged, so
+ * a display-only `priceLabel` must never sit in front of it.
+ */
+interface SeasonPrices {
+    currency: string;
+    packages: SeasonPackagePrices[];
+}
+/**
+ * A started Season payment. Identical in shape to the Event hosted checkout's
+ * response (`POST /pub/events/:key/checkout`) so the same card, the same
+ * gateway handoff and the same order polling serve both.
+ */
+interface SeasonCheckoutSession {
+    orderId: string;
+    totalMinor: number;
+    currency: string;
+    expiresAt: number;
+    /** Hosted gateway page — navigate to it. */
+    redirectUrl?: string;
+    /** In-page modal gateway — open it without leaving the page. */
+    clientPayload?: Record<string, unknown>;
+}
+interface SeasonCheckoutRequest {
+    operationId: string;
+    buyerEmail: string;
+    buyerName?: string;
+    provider?: string;
+    returnUrl?: string;
+}
 interface SeasonRenewalIntent {
     offerId: string;
     state: 'intent_received';
@@ -4900,6 +5057,43 @@ interface SeasonPickerOptions {
     container: string | HTMLElement;
     season: string;
     apiBase?: string;
+    /**
+     * Publishable account key (`pk_live_…` / `pk_test_…`), accepted for parity
+     * with `SeatPicker`'s `publicKey` so one embed snippet shape covers
+     * Events and Seasons.
+     *
+     * It is NOT sent to the server and is not a credential: a public Season
+     * session is authorized by the Season key plus the browser's registered
+     * Origin. Supply it to name the account in your own source; omit it and a
+     * tokenless picker behaves identically.
+     */
+    publicKey?: string;
+    /**
+     * WHO TAKES THE MONEY once the package is held. Default `'handoff'`.
+     *
+     *   'handoff'  (default, and every Season integration that has ever existed)
+     *              {@link onContinue} fires with the opaque, price-free handoff
+     *              and YOUR server prices, charges and books it. Nothing about
+     *              this path changes and no payment code is downloaded.
+     *   'hosted'   the widget collects an email and takes the money through the
+     *              gateway the ORGANIZER connected, on their account, against
+     *              `POST /pub/seasons/:key/checkout`. One order, one ticket per
+     *              performance. {@link onContinue} still fires, so a host that
+     *              only wants to observe the moment keeps working.
+     *
+     * A Season the organizer priced on their own backend reports
+     * `checkoutMode: 'server'`; asking for `'hosted'` there stays on `'handoff'`
+     * rather than starting a payment SeatLayer cannot complete.
+     */
+    checkout?: 'handoff' | 'hosted';
+    /**
+     * Where a redirecting gateway sends the buyer back to, for
+     * `checkout: 'hosted'`. Same rules as the Event picker's `returnUrl`: the
+     * server keeps the path and query, adds only `seatlayer_checkout=…`, and
+     * ignores an origin the organizer has not declared — so supplying a URL
+     * cannot authorize it.
+     */
+    returnUrl?: string;
     buyerAccessTokenProvider?: BuyerAccessTokenProvider;
     buyerAccessToken?: string | BuyerAccessToken;
     initialOperationId?: string;
@@ -4936,7 +5130,21 @@ interface SeasonPickerOptions {
     onHoldExpired?: () => void;
     onRenewalIntent?: (intent: SeasonRenewalIntent) => void;
     onAccessExpired?: (event: BuyerAccessExpiredEvent) => void;
+    /**
+     * Private inventory is unavailable, and refreshing will not fix it.
+     *
+     * A tokenless public embed reports the server's three Season refusals here
+     * with their own reasons — `audience_not_public`, `sales_not_open`,
+     * `origin_not_allowed` — rather than collapsing them into `provider_failed`,
+     * because the three call for three different answers from the organizer.
+     */
     onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
+    /**
+     * `checkout: 'hosted'` only — the gateway's webhook landed and the Season
+     * order is PAID. The one signal a host with no backend of its own can build
+     * a receipt from.
+     */
+    onOrderConfirmed?: (order: CheckoutOrderStatus) => void;
     onStatusChange?: (event: SeasonStatusEvent) => void;
     onError?: (error: unknown) => void;
 }
@@ -4955,6 +5163,50 @@ declare class SeasonPicker {
     destroy(): void;
 }
 
+/**
+ * The anonymous Season buyer session — how a page with no backend at all can
+ * put a Season on sale.
+ *
+ * Until now every `SeasonPicker` needed a `bss_` bearer minted by the
+ * organizer's own server with their secret key, which meant only a developer
+ * could embed a Season. `POST /pub/seasons/:key/sessions` removes that step: it
+ * takes no credential, checks the Season is public, its sales are open and the
+ * browser's Origin is one the organizer declared, and hands back an ordinary
+ * Season buyer bearer. Every existing `/pub/seasons/:key/*` call then works
+ * unchanged — this module mints and renews the bearer and does nothing else.
+ *
+ * A publishable `pk_…` key is NOT sent here. It is accepted by the picker for
+ * parity with `SeatPicker` (one snippet shape across surfaces) and to name the
+ * account in a host's own source, but the Season key plus the registered Origin
+ * are what the server actually verifies, so putting a key on the wire would add
+ * a value to leak without adding a check.
+ *
+ * WHAT MAKES THIS SAFE TO BE ANONYMOUS: the session it mints is Public-sale
+ * only. It can never select a private channel or a renewal allocation — that
+ * still needs `buyerAccessTokenProvider` with the organizer's own scope — and
+ * an explicit host token always takes precedence over this path.
+ */
+
+/** The three ways the server refuses to mint an anonymous Season session. */
+type SeasonPublicRefusalReason = 'audience_not_public' | 'sales_not_open' | 'origin_not_allowed';
+/** What `POST /pub/seasons/:key/sessions` returns. */
+interface SeasonPublicSession {
+    token: string;
+    expiresAt: number;
+    seasonKey: string;
+    planActivationIds: string[];
+}
+/**
+ * Thrown when the server refuses to mint. Carries the machine reason and
+ * nothing else — no origin, no account, no audience detail — because the
+ * refusal is reported to an anonymous browser.
+ */
+declare class SeasonPublicSessionRefused extends Error {
+    readonly reason: SeasonPublicRefusalReason;
+    readonly status: number;
+    constructor(reason: SeasonPublicRefusalReason, status: number);
+}
+
 /**
  * Host-side helper for embedding the SeatLayer picker as an iframe.
  *
@@ -4995,4 +5247,4 @@ interface AttachPickerFrameOptions {
  */
 declare function attachPickerFrame(iframe: HTMLIFrameElement, opts?: AttachPickerFrameOptions): () => void;
 
-export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };
+export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAudience, type SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCategoryPrice, type SeasonCheckoutHandoff, type SeasonCheckoutMode, type SeasonCheckoutRequest, type SeasonCheckoutSession, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, type SeasonPackagePrices, SeasonPicker, type SeasonPickerOptions, type SeasonPrices, type SeasonPublicRefusalReason, type SeasonPublicSession, SeasonPublicSessionRefused, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };