@seatlayer/js 0.47.1 → 0.47.2

package/dist/index.d.cts

@@ -1069,6 +1069,59 @@ declare class EmbeddedDesigner {
     private handleMessage;
 }
 
+/**
+ * Buyer-safe ticket-offer availability shared by the canonical picker and the
+ * hosted event-page templates.
+ *
+ * This module intentionally owns the wire parser. A hosted page, iframe, popup
+ * and SDK mount must refuse or accept the same payload; duplicating this reader
+ * is how one surface eventually prints a price another surface will not charge.
+ */
+type SaleState = 'on-sale' | 'low' | 'sold-out' | 'presale' | 'closed';
+interface TicketOfferSummary {
+    /** Legacy ordering fields kept for older page templates and payloads. */
+    index: number;
+    count: number;
+    /** Units currently available at this offer price; null means unlimited. */
+    remaining: number | null;
+    /** Buyer-facing fields added by the offers UX. Absent on older workers. */
+    id?: string;
+    name?: string;
+    categoryKey?: string | null;
+    startsAt?: number | null;
+    endsAt?: number | null;
+}
+interface TicketOfferPrice {
+    categoryKey: string;
+    /** Major units. What a hold on this category is charged right now. */
+    price: number;
+    /** Major units, or null. Printed only when genuinely higher. */
+    previousPrice: number | null;
+    /** Offer provenance for the price row. Absent on older workers. */
+    offerId?: string;
+    offerName?: string;
+    remaining?: number | null;
+    startsAt?: number | null;
+    endsAt?: number | null;
+}
+interface TicketOfferAvailability {
+    state: SaleState;
+    /** Currently advertised offer price, in minor units. */
+    fromPrice: number | null;
+    previousPrice: number | null;
+    currency: string | null;
+    /** The highest-priority active buy offer, when one exists. */
+    release: TicketOfferSummary | null;
+    /** The next scheduled price offer. It does not close ordinary ticket sales. */
+    upcoming: TicketOfferSummary | null;
+    /** Server-resolved active offer prices by category, in major units. */
+    prices: TicketOfferPrice[];
+}
+/** Parse a public offer payload without repairing a half-understood price. */
+declare function parseTicketOfferAvailability(body: unknown): TicketOfferAvailability | null;
+/** Translate the server-resolved category map into SeatPicker pricing. */
+declare function ticketOfferPrices(availability: TicketOfferAvailability | null): Record<string, number>;
+
 /**
  * SeatPicker — the full buyer experience as a widget.
  *
@@ -1298,6 +1351,12 @@ interface SeatPickerOptions {
      * fall back to the chart price.
      */
     pricing?: SeatPickerPricing;
+    /**
+     * Fires when the server-resolved active offer changes. Hosted event pages use
+     * this to keep their headline, sticky bar and the canonical picker on the
+     * same live fact. The picker remains fully functional when it is omitted.
+     */
+    onOfferAvailabilityChange?: (availability: TicketOfferAvailability | null) => void;
     /** Hold TTL in ms passed to hold(); server clamps to its own limits. */
     holdTtlMs?: number;
     /**
@@ -1472,6 +1531,8 @@ declare class SeatPicker {
     private readonly apiBase;
     private readonly controller;
     private readonly maxTickets;
+    /** Original host pricing, kept separate from live server offer overrides. */
+    private readonly hostPricing;
     private root;
     private mapHost;
     private rendered;
@@ -1482,9 +1543,16 @@ declare class SeatPicker {
     private ro;
     private holdTimer;
     private toastTimer;
+    private offerRefreshTimer;
+    /** Armed only when the offer schedule has a known future transition (or as a
+     * bounded retry after a failed read) — never a fixed-cadence poll. */
+    private offerBoundaryTimer;
+    private offerVisibilityHandler;
     /** Short-lived UI motion timers; all are cancelled on destroy. */
     private motionTimers;
     private currency;
+    private eventTimezone;
+    private offerAvailability;
     private hold;
     /** Latest server expiry for the open hold (moves on extend). */
     private holdExpiresAt;
@@ -1855,6 +1923,28 @@ declare class SeatPicker {
     private openSeatView;
     private closeSeatView;
     private money;
+    /**
+     * Sleep until the offer schedule's next known transition, then re-read.
+     *
+     * A far-away boundary is capped: the wake re-reads, learns the (unchanged)
+     * schedule, and re-arms — so a picker left open for days still tracks an
+     * organizer's schedule edits at a cost of one request every few hours. No
+     * future transition means no timer at all; an event with no releases does
+     * zero background traffic. A wake in a hidden tab fetches nothing — the
+     * visibilitychange handler owns catching that tab up.
+     */
+    private scheduleOfferBoundary;
+    /** Debounce the no-store offer read behind a burst of seat-status frames. */
+    private scheduleOfferRefresh;
+    /**
+     * Pull the server's resolved answer. A failed refresh keeps the last truthful
+     * answer: flashing back to a chart price while checkout still charges an
+     * offer is worse than a temporarily stale remaining count.
+     */
+    private refreshOfferAvailability;
+    private offerPrice;
+    /** The compact current/upcoming offer card above Ticket prices. */
+    private syncOffer;
     /**
      * The price the buyer will actually pay for a category (+tier): the host's
      * `pricing` override when present, else the chart's stored price. Every
@@ -2799,4 +2889,4 @@ declare class ChannelsMode {
     handleBack(): boolean;
 }
 
-export { AccessLinkReveal, AccessLinkStatusRecord, ApiError, AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, ChannelAccessIntent, ChannelAllocationPage, ChannelListResult, ChannelPreviewProjection, ChannelRecord, ChannelSeatStatus, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsRowView, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, attachPickerFrame, bucketRowsHtml, createBuyerAccessContext, createControllerSink };
+export { AccessLinkReveal, AccessLinkStatusRecord, ApiError, AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, ChannelAccessIntent, ChannelAllocationPage, ChannelListResult, ChannelPreviewProjection, ChannelRecord, ChannelSeatStatus, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsRowView, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, type SaleState, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bucketRowsHtml, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, ticketOfferPrices };

package/dist/index.d.ts

@@ -1069,6 +1069,59 @@ declare class EmbeddedDesigner {
     private handleMessage;
 }
 
+/**
+ * Buyer-safe ticket-offer availability shared by the canonical picker and the
+ * hosted event-page templates.
+ *
+ * This module intentionally owns the wire parser. A hosted page, iframe, popup
+ * and SDK mount must refuse or accept the same payload; duplicating this reader
+ * is how one surface eventually prints a price another surface will not charge.
+ */
+type SaleState = 'on-sale' | 'low' | 'sold-out' | 'presale' | 'closed';
+interface TicketOfferSummary {
+    /** Legacy ordering fields kept for older page templates and payloads. */
+    index: number;
+    count: number;
+    /** Units currently available at this offer price; null means unlimited. */
+    remaining: number | null;
+    /** Buyer-facing fields added by the offers UX. Absent on older workers. */
+    id?: string;
+    name?: string;
+    categoryKey?: string | null;
+    startsAt?: number | null;
+    endsAt?: number | null;
+}
+interface TicketOfferPrice {
+    categoryKey: string;
+    /** Major units. What a hold on this category is charged right now. */
+    price: number;
+    /** Major units, or null. Printed only when genuinely higher. */
+    previousPrice: number | null;
+    /** Offer provenance for the price row. Absent on older workers. */
+    offerId?: string;
+    offerName?: string;
+    remaining?: number | null;
+    startsAt?: number | null;
+    endsAt?: number | null;
+}
+interface TicketOfferAvailability {
+    state: SaleState;
+    /** Currently advertised offer price, in minor units. */
+    fromPrice: number | null;
+    previousPrice: number | null;
+    currency: string | null;
+    /** The highest-priority active buy offer, when one exists. */
+    release: TicketOfferSummary | null;
+    /** The next scheduled price offer. It does not close ordinary ticket sales. */
+    upcoming: TicketOfferSummary | null;
+    /** Server-resolved active offer prices by category, in major units. */
+    prices: TicketOfferPrice[];
+}
+/** Parse a public offer payload without repairing a half-understood price. */
+declare function parseTicketOfferAvailability(body: unknown): TicketOfferAvailability | null;
+/** Translate the server-resolved category map into SeatPicker pricing. */
+declare function ticketOfferPrices(availability: TicketOfferAvailability | null): Record<string, number>;
+
 /**
  * SeatPicker — the full buyer experience as a widget.
  *
@@ -1298,6 +1351,12 @@ interface SeatPickerOptions {
      * fall back to the chart price.
      */
     pricing?: SeatPickerPricing;
+    /**
+     * Fires when the server-resolved active offer changes. Hosted event pages use
+     * this to keep their headline, sticky bar and the canonical picker on the
+     * same live fact. The picker remains fully functional when it is omitted.
+     */
+    onOfferAvailabilityChange?: (availability: TicketOfferAvailability | null) => void;
     /** Hold TTL in ms passed to hold(); server clamps to its own limits. */
     holdTtlMs?: number;
     /**
@@ -1472,6 +1531,8 @@ declare class SeatPicker {
     private readonly apiBase;
     private readonly controller;
     private readonly maxTickets;
+    /** Original host pricing, kept separate from live server offer overrides. */
+    private readonly hostPricing;
     private root;
     private mapHost;
     private rendered;
@@ -1482,9 +1543,16 @@ declare class SeatPicker {
     private ro;
     private holdTimer;
     private toastTimer;
+    private offerRefreshTimer;
+    /** Armed only when the offer schedule has a known future transition (or as a
+     * bounded retry after a failed read) — never a fixed-cadence poll. */
+    private offerBoundaryTimer;
+    private offerVisibilityHandler;
     /** Short-lived UI motion timers; all are cancelled on destroy. */
     private motionTimers;
     private currency;
+    private eventTimezone;
+    private offerAvailability;
     private hold;
     /** Latest server expiry for the open hold (moves on extend). */
     private holdExpiresAt;
@@ -1855,6 +1923,28 @@ declare class SeatPicker {
     private openSeatView;
     private closeSeatView;
     private money;
+    /**
+     * Sleep until the offer schedule's next known transition, then re-read.
+     *
+     * A far-away boundary is capped: the wake re-reads, learns the (unchanged)
+     * schedule, and re-arms — so a picker left open for days still tracks an
+     * organizer's schedule edits at a cost of one request every few hours. No
+     * future transition means no timer at all; an event with no releases does
+     * zero background traffic. A wake in a hidden tab fetches nothing — the
+     * visibilitychange handler owns catching that tab up.
+     */
+    private scheduleOfferBoundary;
+    /** Debounce the no-store offer read behind a burst of seat-status frames. */
+    private scheduleOfferRefresh;
+    /**
+     * Pull the server's resolved answer. A failed refresh keeps the last truthful
+     * answer: flashing back to a chart price while checkout still charges an
+     * offer is worse than a temporarily stale remaining count.
+     */
+    private refreshOfferAvailability;
+    private offerPrice;
+    /** The compact current/upcoming offer card above Ticket prices. */
+    private syncOffer;
     /**
      * The price the buyer will actually pay for a category (+tier): the host's
      * `pricing` override when present, else the chart's stored price. Every
@@ -2799,4 +2889,4 @@ declare class ChannelsMode {
     handleBack(): boolean;
 }
 
-export { AccessLinkReveal, AccessLinkStatusRecord, ApiError, AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, ChannelAccessIntent, ChannelAllocationPage, ChannelListResult, ChannelPreviewProjection, ChannelRecord, ChannelSeatStatus, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsRowView, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, attachPickerFrame, bucketRowsHtml, createBuyerAccessContext, createControllerSink };
+export { AccessLinkReveal, AccessLinkStatusRecord, ApiError, AssignmentResult, type AttachPickerFrameOptions, type BestAvailableResult, BucketRow, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, ChannelAccessIntent, ChannelAllocationPage, ChannelListResult, ChannelPreviewProjection, ChannelRecord, ChannelSeatStatus, type ChannelsCapabilities, type ChannelsClient, ChannelsMode, type ChannelsModeHost, type ChannelsRowView, type ChannelsSeatView, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, type SaleState, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bucketRowsHtml, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, ticketOfferPrices };