@seatlayer/js 0.80.2 → 0.81.0

package/dist/index.d.ts

@@ -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;
     /**
@@ -1747,7 +1764,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
@@ -3222,6 +3243,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;
@@ -3320,6 +3361,8 @@ declare class SeatPicker implements GaPromptPicker {
     private bookedEl;
     /** The blocking "your seats were released" dialog, while it is up. */
     private holdExpiredEl;
+    /** True once the dialog's own availability read has landed; Start again then pulses off it. */
+    private holdExpiredFresh;
     /** What that hold actually held, captured before the state was cleared. */
     private holdExpiredUnits;
     /** @internal Pending GA units per (area, tier) — see pickerGaPrompt.ts. */
@@ -3368,15 +3411,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;
@@ -3686,7 +3720,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;
@@ -4365,6 +4407,13 @@ declare class SeatPicker implements GaPromptPicker {
      * stale, so the picker stops until they have acknowledged it.
      */
     private showHoldExpired;
+    /**
+     * "Select them again": the seats the refresh still calls free go straight
+     * back into a new hold, through the same path the tab-regain note uses —
+     * select, then the CTA, which secures and hands off exactly as a first
+     * pick would. The dialog's other state goes the way Start again takes it.
+     */
+    private recoverAfterHoldExpiry;
     private dismissHoldExpired;
     /**
      * "Start again": put the picker back to the state it would have been in had
@@ -4789,6 +4838,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;
@@ -4797,7 +4864,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<{
@@ -4848,6 +4917,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';
@@ -4891,6 +5010,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;
@@ -4927,7 +5083,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;
 }
@@ -4946,6 +5116,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.
  *
@@ -4986,4 +5200,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 };