@seatlayer/js 0.100.0 → 0.102.0

package/dist/index.d.cts

@@ -633,9 +633,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 +835,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,10 +877,21 @@ 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';
+/** The pinned drag action a host can read back (native state decoders know these two). */
 type SeatingChartNavigationMode = 'orbit' | 'pan';
+/**
+ * What a host may ask a plain drag to do in 3D. `auto`, the default, turns the
+ * venue at the overview and moves the camera once the buyer has zoomed in;
+ * `orbit` and `pan` pin one action (a host's own Rotate / Move buttons).
+ */
+type SeatingChartNavigationRequest = SeatingChartNavigationMode | 'auto';
 /** What the 2D seat-view panorama is showing, and what it would say about it. */
 interface SeatingChartSeatViewInfo {
     seatId: string;
@@ -2454,6 +2485,12 @@ declare class SeatingChart {
     setPricing(pricing: {
         prices?: HostPrices;
     } | undefined): void;
+    /**
+     * The host's prices in the map's shape, so the seat hover card and the
+     * canvas labels print what the host charges, not the chart's own price.
+     * Undefined without host prices: the map then uses the chart's.
+     */
+    private hostPriceRanges;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
     /** Switch the 2D canvas projection.
@@ -2509,8 +2546,9 @@ declare class SeatingChart {
     getBuyerView(): SeatingChartBuyerView;
     /** Open an authored or chart-derived 360° view for one physical seat. */
     openSeatView(seatId: string): Promise<void>;
-    /** Explicit Rotate / Move control for native and custom picker chrome. */
-    setVenue3DNavigationMode(mode: SeatingChartNavigationMode): void;
+    /** Explicit Rotate / Move control for native and custom picker chrome;
+     *  `auto` (the default) turns at the overview and moves once zoomed in. */
+    setVenue3DNavigationMode(mode: SeatingChartNavigationRequest): void;
     /**
      * Enable or suppress all buyer input inside this chart without unmounting it.
      *
@@ -4583,7 +4621,15 @@ declare class SeatPicker implements GaPromptPicker {
     /** The read itself. Never rejects — see the catch. */
     private readOfferAvailability;
     /** @internal */ offerPrice(categoryKey: string | undefined, tierId?: string | null): TicketOfferPrice | null;
-    /** Keep authored regular prices out of canvas labels during matrix offers. */
+    /**
+     * Keep authored regular prices out of canvas labels during matrix offers,
+     * and out of them whenever the host prices the event itself.
+     *
+     * Left undefined, the map prints the chart's own category prices. A host
+     * that charges from its own catalogue (`pricing.prices`) then saw one price
+     * in the list and another on the seat's hover card: DKK 411 against DKK 55 on
+     * a DesiPass event (2026-09-25). The map now takes the list's answer.
+     */
     private mapPriceRanges;
     private syncMapPriceRanges;
     private applyChannelPricing;
@@ -5210,7 +5256,8 @@ 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. */
+    kind: 'idle' | 'pending' | 'recovery_failed' | 'sales_closed' | 'revision_changed' | 'checkout';
     message: string;
     /** The short operation reference from §12, when one applies. */
     reference?: string;
@@ -5235,6 +5282,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;
@@ -5329,7 +5390,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.
      *
@@ -5720,6 +5786,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

@@ -633,9 +633,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 +835,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,10 +877,21 @@ 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';
+/** The pinned drag action a host can read back (native state decoders know these two). */
 type SeatingChartNavigationMode = 'orbit' | 'pan';
+/**
+ * What a host may ask a plain drag to do in 3D. `auto`, the default, turns the
+ * venue at the overview and moves the camera once the buyer has zoomed in;
+ * `orbit` and `pan` pin one action (a host's own Rotate / Move buttons).
+ */
+type SeatingChartNavigationRequest = SeatingChartNavigationMode | 'auto';
 /** What the 2D seat-view panorama is showing, and what it would say about it. */
 interface SeatingChartSeatViewInfo {
     seatId: string;
@@ -2454,6 +2485,12 @@ declare class SeatingChart {
     setPricing(pricing: {
         prices?: HostPrices;
     } | undefined): void;
+    /**
+     * The host's prices in the map's shape, so the seat hover card and the
+     * canvas labels print what the host charges, not the chart's own price.
+     * Undefined without host prices: the map then uses the chart's.
+     */
+    private hostPriceRanges;
     /** Toggle colorblind-safe rendering at runtime (see options.colorblindSafe). */
     setColorblindSafe(on: boolean): void;
     /** Switch the 2D canvas projection.
@@ -2509,8 +2546,9 @@ declare class SeatingChart {
     getBuyerView(): SeatingChartBuyerView;
     /** Open an authored or chart-derived 360° view for one physical seat. */
     openSeatView(seatId: string): Promise<void>;
-    /** Explicit Rotate / Move control for native and custom picker chrome. */
-    setVenue3DNavigationMode(mode: SeatingChartNavigationMode): void;
+    /** Explicit Rotate / Move control for native and custom picker chrome;
+     *  `auto` (the default) turns at the overview and moves once zoomed in. */
+    setVenue3DNavigationMode(mode: SeatingChartNavigationRequest): void;
     /**
      * Enable or suppress all buyer input inside this chart without unmounting it.
      *
@@ -4583,7 +4621,15 @@ declare class SeatPicker implements GaPromptPicker {
     /** The read itself. Never rejects — see the catch. */
     private readOfferAvailability;
     /** @internal */ offerPrice(categoryKey: string | undefined, tierId?: string | null): TicketOfferPrice | null;
-    /** Keep authored regular prices out of canvas labels during matrix offers. */
+    /**
+     * Keep authored regular prices out of canvas labels during matrix offers,
+     * and out of them whenever the host prices the event itself.
+     *
+     * Left undefined, the map prints the chart's own category prices. A host
+     * that charges from its own catalogue (`pricing.prices`) then saw one price
+     * in the list and another on the seat's hover card: DKK 411 against DKK 55 on
+     * a DesiPass event (2026-09-25). The map now takes the list's answer.
+     */
     private mapPriceRanges;
     private syncMapPriceRanges;
     private applyChannelPricing;
@@ -5210,7 +5256,8 @@ 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. */
+    kind: 'idle' | 'pending' | 'recovery_failed' | 'sales_closed' | 'revision_changed' | 'checkout';
     message: string;
     /** The short operation reference from §12, when one applies. */
     reference?: string;
@@ -5235,6 +5282,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;
@@ -5329,7 +5390,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.
      *
@@ -5720,6 +5786,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;