@seatlayer/js 0.101.0 → 0.103.0

package/dist/index.d.cts

@@ -224,8 +224,13 @@ declare class BuyerAccessContext {
     /**
      * Handle a 401/403 from a scoped call. Returns true when the caller should
      * retry the same request once with the refreshed bearer.
+     *
+     * `sentAuthorization` is the `Authorization` header the failed request
+     * carried. When the caller has it, the "did the refresh change anything"
+     * check below compares against exactly that bearer; without it, the bearer
+     * this context last issued stands in.
      */
-    handleFailure(status: number, code: string | undefined): Promise<boolean>;
+    handleFailure(status: number, code: string | undefined, sentAuthorization?: string | null): Promise<boolean>;
     /** Host-driven re-acquisition (after the buyer signs in again, say). */
     refresh(reason?: BuyerAccessRefreshReason): Promise<boolean>;
     /** Drop the bearer. Called on destroy so nothing outlives the widget. */
@@ -633,9 +638,22 @@ declare class ApiError extends Error {
      * contention. Absent when the server said nothing; never inferred here.
      */
     retryable?: boolean;
+    /**
+     * Why a 404 happened when the key itself shows it (`api_key_as_event_key`,
+     * `secret_key_as_event_key`, `example_event_key`): an API key or the docs'
+     * example pasted where the event key goes. Absent otherwise.
+     */
+    hint?: string;
+    /**
+     * The API's plain-language explanation for the developer, when it sent one.
+     * Not buyer copy: `message` stays the machine code callers already compare.
+     */
+    serverMessage?: string;
     constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string, details?: {
         fields?: BookingFormFieldError[];
         retryable?: boolean;
+        hint?: string;
+        serverMessage?: string;
     });
 }
 interface HoldResult {
@@ -822,6 +840,13 @@ interface GaPromptTier {
  */
 interface GAPromptRequest {
     area: PickerGAArea;
+    /**
+     * How the area sells: absent = per person; 'whole' = one party takes the
+     * whole area (min = max = its guests); 'variable' = one party picks a size in
+     * min–max. A box is ONE booking at ONE ticket type: confirm with a number, or
+     * a record naming a single tier.
+     */
+    bookingMode?: 'whole' | 'variable';
     /** Quantities already chosen here, per tier id (`''` for an untiered area). */
     selected: Record<string, number>;
     min: number;
@@ -857,6 +882,10 @@ interface GaPromptPicker {
     /** Tickets in the order right now, held + selected seats + every GA quantity. */
     totalTicketCount(): number;
     onGAPromptHook?: ((prompt: GAPromptRequest) => boolean | void) | undefined;
+    /** The buyer's access filter: with wheelchair on, an area offers only its wheelchair places. */
+    controller?: {
+        getAccessibilityFilter?(): readonly string[] | null;
+    };
 }
 
 type SeatingChartBuyerView = 'map' | 'venue3d';
@@ -5232,7 +5261,9 @@ interface PerformanceGroupCheckoutHandoff {
 }
 /** What the wrapper is showing the buyer right now, for host telemetry. */
 interface PerformanceGroupStatusEvent {
-    kind: 'idle' | 'pending' | 'recovery_failed' | 'sales_closed' | 'revision_changed';
+    /** `checkout`: the hosted checkout could not start; the seats stay held. */
+    /** `session_ended`: the buyer's session ended; the map stopped updating. */
+    kind: 'idle' | 'pending' | 'recovery_failed' | 'sales_closed' | 'revision_changed' | 'checkout' | 'session_ended';
     message: string;
     /** The short operation reference from §12, when one applies. */
     reference?: string;
@@ -5257,6 +5288,20 @@ interface PerformanceGroupPickerOptions {
      */
     allowSelectionModeSwitch?: boolean;
     apiBase?: string;
+    /**
+     * `'hosted'`: SeatLayer takes the money through the organizer's gateway (a
+     * same-seat run only) and {@link onCheckout} still fires. Default
+     * `'handoff'`. A run whose checkout the organizer's backend owns stays on
+     * the handoff. With no buyer token, the picker mints an anonymous
+     * public-sale session itself.
+     */
+    checkout?: 'handoff' | 'hosted';
+    /** Where a redirecting gateway returns to. Only a declared origin is kept. */
+    returnUrl?: string;
+    /** Default true. False hides the run's name, summary and dates, for a host page that shows them. */
+    header?: boolean;
+    /** `checkout: 'hosted'` only: the order is paid and the tickets are issued. */
+    onOrderConfirmed?: (order: CheckoutOrderStatus) => void;
     buyerAccessTokenProvider?: BuyerAccessTokenProvider;
     buyerAccessToken?: string | BuyerAccessToken;
     maxSelection?: number;
@@ -5351,7 +5396,12 @@ declare class PerformanceGroupPicker {
     private switchingMode;
     /** Latched at the first `booked`, so the callback and the copy fire once. */
     private booked;
+    private readonly hosted;
+    /** The anonymous session's real refusal, carried past `provider_failed`. */
+    private refusal;
     constructor(options: PerformanceGroupPickerOptions);
+    /** Who takes the money: `'hosted'` only once render() confirmed SeatLayer does. */
+    get checkoutMode(): 'handoff' | 'hosted';
     /**
      * The mode the buyer is ACTUALLY in.
      *
@@ -5491,6 +5541,12 @@ declare class PerformanceGroupPicker {
     private setInteractionLocked;
     private announce;
     private showStatus;
+    /**
+     * The availability poll stopped because the buyer's session ended. The map
+     * on screen is now stale, so the picker says that plainly, and the host is
+     * told through `onError` so it can offer a fresh session.
+     */
+    private sessionEnded;
     private clearStatus;
     private operationChanged;
     /**
@@ -5742,6 +5798,14 @@ interface SeasonPickerOptions {
     realtimePollMs?: number;
     fetch?: typeof fetch;
     offer?: SeasonOfferPresentation;
+    /**
+     * Show the picker's own season header: name, venue chips, package prices
+     * and dates. Defaults to true. Set it to false when the host page already
+     * shows those facts, so the buyer does not read them twice; the picker then
+     * starts at its step bar. The offer and benefits live in that header, so
+     * `offer` has no visible effect while it is hidden.
+     */
+    header?: boolean;
     maxSelection?: number;
     selectedObjects?: string[];
     selectableObjects?: string[] | null;

package/dist/index.d.ts

@@ -224,8 +224,13 @@ declare class BuyerAccessContext {
     /**
      * Handle a 401/403 from a scoped call. Returns true when the caller should
      * retry the same request once with the refreshed bearer.
+     *
+     * `sentAuthorization` is the `Authorization` header the failed request
+     * carried. When the caller has it, the "did the refresh change anything"
+     * check below compares against exactly that bearer; without it, the bearer
+     * this context last issued stands in.
      */
-    handleFailure(status: number, code: string | undefined): Promise<boolean>;
+    handleFailure(status: number, code: string | undefined, sentAuthorization?: string | null): Promise<boolean>;
     /** Host-driven re-acquisition (after the buyer signs in again, say). */
     refresh(reason?: BuyerAccessRefreshReason): Promise<boolean>;
     /** Drop the bearer. Called on destroy so nothing outlives the widget. */
@@ -633,9 +638,22 @@ declare class ApiError extends Error {
      * contention. Absent when the server said nothing; never inferred here.
      */
     retryable?: boolean;
+    /**
+     * Why a 404 happened when the key itself shows it (`api_key_as_event_key`,
+     * `secret_key_as_event_key`, `example_event_key`): an API key or the docs'
+     * example pasted where the event key goes. Absent otherwise.
+     */
+    hint?: string;
+    /**
+     * The API's plain-language explanation for the developer, when it sent one.
+     * Not buyer copy: `message` stays the machine code callers already compare.
+     */
+    serverMessage?: string;
     constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string, details?: {
         fields?: BookingFormFieldError[];
         retryable?: boolean;
+        hint?: string;
+        serverMessage?: string;
     });
 }
 interface HoldResult {
@@ -822,6 +840,13 @@ interface GaPromptTier {
  */
 interface GAPromptRequest {
     area: PickerGAArea;
+    /**
+     * How the area sells: absent = per person; 'whole' = one party takes the
+     * whole area (min = max = its guests); 'variable' = one party picks a size in
+     * min–max. A box is ONE booking at ONE ticket type: confirm with a number, or
+     * a record naming a single tier.
+     */
+    bookingMode?: 'whole' | 'variable';
     /** Quantities already chosen here, per tier id (`''` for an untiered area). */
     selected: Record<string, number>;
     min: number;
@@ -857,6 +882,10 @@ interface GaPromptPicker {
     /** Tickets in the order right now, held + selected seats + every GA quantity. */
     totalTicketCount(): number;
     onGAPromptHook?: ((prompt: GAPromptRequest) => boolean | void) | undefined;
+    /** The buyer's access filter: with wheelchair on, an area offers only its wheelchair places. */
+    controller?: {
+        getAccessibilityFilter?(): readonly string[] | null;
+    };
 }
 
 type SeatingChartBuyerView = 'map' | 'venue3d';
@@ -5232,7 +5261,9 @@ interface PerformanceGroupCheckoutHandoff {
 }
 /** What the wrapper is showing the buyer right now, for host telemetry. */
 interface PerformanceGroupStatusEvent {
-    kind: 'idle' | 'pending' | 'recovery_failed' | 'sales_closed' | 'revision_changed';
+    /** `checkout`: the hosted checkout could not start; the seats stay held. */
+    /** `session_ended`: the buyer's session ended; the map stopped updating. */
+    kind: 'idle' | 'pending' | 'recovery_failed' | 'sales_closed' | 'revision_changed' | 'checkout' | 'session_ended';
     message: string;
     /** The short operation reference from §12, when one applies. */
     reference?: string;
@@ -5257,6 +5288,20 @@ interface PerformanceGroupPickerOptions {
      */
     allowSelectionModeSwitch?: boolean;
     apiBase?: string;
+    /**
+     * `'hosted'`: SeatLayer takes the money through the organizer's gateway (a
+     * same-seat run only) and {@link onCheckout} still fires. Default
+     * `'handoff'`. A run whose checkout the organizer's backend owns stays on
+     * the handoff. With no buyer token, the picker mints an anonymous
+     * public-sale session itself.
+     */
+    checkout?: 'handoff' | 'hosted';
+    /** Where a redirecting gateway returns to. Only a declared origin is kept. */
+    returnUrl?: string;
+    /** Default true. False hides the run's name, summary and dates, for a host page that shows them. */
+    header?: boolean;
+    /** `checkout: 'hosted'` only: the order is paid and the tickets are issued. */
+    onOrderConfirmed?: (order: CheckoutOrderStatus) => void;
     buyerAccessTokenProvider?: BuyerAccessTokenProvider;
     buyerAccessToken?: string | BuyerAccessToken;
     maxSelection?: number;
@@ -5351,7 +5396,12 @@ declare class PerformanceGroupPicker {
     private switchingMode;
     /** Latched at the first `booked`, so the callback and the copy fire once. */
     private booked;
+    private readonly hosted;
+    /** The anonymous session's real refusal, carried past `provider_failed`. */
+    private refusal;
     constructor(options: PerformanceGroupPickerOptions);
+    /** Who takes the money: `'hosted'` only once render() confirmed SeatLayer does. */
+    get checkoutMode(): 'handoff' | 'hosted';
     /**
      * The mode the buyer is ACTUALLY in.
      *
@@ -5491,6 +5541,12 @@ declare class PerformanceGroupPicker {
     private setInteractionLocked;
     private announce;
     private showStatus;
+    /**
+     * The availability poll stopped because the buyer's session ended. The map
+     * on screen is now stale, so the picker says that plainly, and the host is
+     * told through `onError` so it can offer a fresh session.
+     */
+    private sessionEnded;
     private clearStatus;
     private operationChanged;
     /**
@@ -5742,6 +5798,14 @@ interface SeasonPickerOptions {
     realtimePollMs?: number;
     fetch?: typeof fetch;
     offer?: SeasonOfferPresentation;
+    /**
+     * Show the picker's own season header: name, venue chips, package prices
+     * and dates. Defaults to true. Set it to false when the host page already
+     * shows those facts, so the buyer does not read them twice; the picker then
+     * starts at its step bar. The offer and benefits live in that header, so
+     * `offer` has no visible effect while it is hidden.
+     */
+    header?: boolean;
     maxSelection?: number;
     selectedObjects?: string[];
     selectableObjects?: string[] | null;