@seatlayer/js 0.7.3 → 0.9.0

package/dist/index.d.cts

@@ -271,6 +271,40 @@ declare class EmbeddedDesigner {
  * so plain host CSS can restyle too.
  */
 
+/**
+ * Stable checkout-handoff contract (P4). Passed as the THIRD argument to
+ * `onCheckout(hold, seats, handoff)` — additive, so the legacy `(hold, seats)`
+ * shape used by DesiPass web-v2 (SDK 0.7.3+) is untouched. This is the object to
+ * build your order against: it is self-contained (holdId, expiry, currency, and
+ * per-line tier + price) and never changes shape across minor releases.
+ */
+interface CheckoutLineItem {
+    /** Seat label (or GA synthetic-unit label). */
+    label: string;
+    /** Chart object id (row/booth/GA area) the unit belongs to. */
+    objectId: string;
+    objectType: 'seat' | 'booth' | 'ga';
+    categoryKey: string;
+    /** Chosen ticket tier id (Adult/Child/…), or null when the category has no tiers. */
+    tierId: string | null;
+    /** Unit price in MAJOR currency units (e.g. 45 = 45.00). Server-authoritative. */
+    unitPrice: number;
+    /** ISO-4217, resolved server-side (per-event override → org → USD). */
+    currency: string;
+    quantity: number;
+}
+interface CheckoutHandoff {
+    /** Server hold id — pass this to YOUR book call. */
+    holdId: string;
+    /** Epoch ms the hold expires (after any extensions). */
+    expiresAt: number;
+    /** ISO-4217 currency for the whole order. */
+    currency: string;
+    /** Priced line items (tier + unit price + currency), server-authoritative. */
+    lineItems: CheckoutLineItem[];
+    /** Convenience total in major units (Σ unitPrice × quantity). */
+    total: number;
+}
 /** Host theme overrides — any subset; unset keys fall back to the org's chart theme, then defaults. */
 interface SeatPickerTheme {
     /** Brand accent (CTA, active chips, hold pill). */
@@ -324,11 +358,26 @@ interface SeatPickerOptions {
      * price · Add/Cancel) instead of adding straight to the tray. Default false.
      */
     confirmSelection?: boolean;
+    /**
+     * Offer a "View from seat" 360° preview (confirm popover + tray chips). The
+     * panorama is generated from the chart geometry, or the organizer's uploaded
+     * photo when a seat carries one. Default true; set false to hide the affordance.
+     */
+    seatView?: boolean;
     /**
      * Buyer pressed the CTA and the hold succeeded — hand off to YOUR checkout.
-     * The hold carries holdId, expiresAt, seat labels and priced line items.
+     * `hold` and `seats` are the legacy args (unchanged since 0.6). `handoff` (P4)
+     * is the stable, self-contained {@link CheckoutHandoff} to build your order
+     * against — holdId, expiry, currency and priced line items. Prefer it.
      */
-    onCheckout?: (hold: HoldResult, seats: PickerSeat[]) => void;
+    onCheckout?: (hold: HoldResult, seats: PickerSeat[], handoff: CheckoutHandoff) => void;
+    /**
+     * The held seats were BOOKED (P4) — your server completed payment and the
+     * booking landed over the realtime channel while the widget was still open.
+     * The widget shows a success state; use this to advance your own UI (receipt,
+     * redirect). Fires once per hold.
+     */
+    onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
     /** The open hold expired server-side (widget already reset itself). */
@@ -350,6 +399,14 @@ declare class SeatPicker {
     private toastTimer;
     private currency;
     private hold;
+    /** Latest server expiry for the open hold (moves on extend). */
+    private holdExpiresAt;
+    /** True once we handed off to checkout — arms booked-confirmation detection. */
+    private handedOff;
+    /** Guards single onBooked + single success overlay per hold. */
+    private bookedShown;
+    private extendEl;
+    private bookedEl;
     private gaQty;
     private tipEl;
     private tipPos;
@@ -359,6 +416,12 @@ declare class SeatPicker {
     private a11yFilter;
     private baQty;
     private baCat;
+    private rungsEl;
+    private floorsEl;
+    private secCardEl;
+    private viewEl;
+    private viewCleanup;
+    private allSeatsCache;
     private modalScrim;
     private prevFocus;
     private escHandler;
@@ -374,11 +437,34 @@ declare class SeatPicker {
     static open(options: Omit<SeatPickerOptions, 'container'>): Promise<SeatPicker>;
     constructor(options: SeatPickerOptions);
     render(): Promise<this>;
+    /** The "Need more time?" prompt shown in the hold's final EXTEND_PROMPT_MS. */
+    private buildExtendPrompt;
+    /** Success overlay + onBooked fire when the held seats settle to booked. */
+    private buildBookedOverlay;
+    /** Build the rung pills (charts with sections) and floor switcher (>1 floor). */
+    private buildArenaChrome;
+    /** Reflect the engine's current LOD rung onto the pill group. */
+    private syncRung;
+    /** Reflect the active floor onto the switcher rail. */
+    private syncFloors;
+    /** Show (or clear, on null) the tapped-section summary card. */
+    private showSectionCard;
     /** aria-live readout when keyboard focus lands on a seat. */
     private announceSeat;
     private showConfirm;
     private reanchorConfirm;
     private closeConfirm;
+    private seatViewEnabled;
+    /** Every bookable seat (cached) — neighbor heads for the generated panorama. */
+    private allSeats;
+    /**
+     * Open the drag-to-look-around 360° preview for a seat. Uses the organizer's
+     * uploaded photo (seat.viewUrl) when present, else a panorama generated from
+     * the chart geometry — the stage placed at this seat's true bearing + size.
+     * Zero extra dependencies: an equirectangular image panned with `repeat-x`.
+     */
+    private openSeatView;
+    private closeSeatView;
     private money;
     private syncPrices;
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
@@ -387,6 +473,21 @@ declare class SeatPicker {
     private handleCta;
     private startHoldTimer;
     private stopHoldTimer;
+    /** Show/refresh (or hide) the "Need more time?" prompt with the live seconds left. */
+    private setExtendPrompt;
+    private handleExtend;
+    /**
+     * Fire the booked-confirmation state once the buyer's held seats settle to
+     * booked. The controller clears its own hold the moment every held label reads
+     * 'booked' over the realtime channel (clearBookedHoldIfSettled), and this runs
+     * on the same onStatusChange — so `currentHold() === null` while we still hold
+     * a checkout handoff means "sold", not expired (expiry clears via onHoldExpired
+     * on a different path, which nulls this.hold first).
+     */
+    private detectBooked;
+    private showBooked;
+    /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
+    private buildHandoff;
     private toast;
     private placeTooltip;
     private updateTooltip;
@@ -396,4 +497,4 @@ declare class SeatPicker {
     destroy(): void;
 }
 
-export { ApiError, type BestAvailableResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };

package/dist/index.d.ts

@@ -271,6 +271,40 @@ declare class EmbeddedDesigner {
  * so plain host CSS can restyle too.
  */
 
+/**
+ * Stable checkout-handoff contract (P4). Passed as the THIRD argument to
+ * `onCheckout(hold, seats, handoff)` — additive, so the legacy `(hold, seats)`
+ * shape used by DesiPass web-v2 (SDK 0.7.3+) is untouched. This is the object to
+ * build your order against: it is self-contained (holdId, expiry, currency, and
+ * per-line tier + price) and never changes shape across minor releases.
+ */
+interface CheckoutLineItem {
+    /** Seat label (or GA synthetic-unit label). */
+    label: string;
+    /** Chart object id (row/booth/GA area) the unit belongs to. */
+    objectId: string;
+    objectType: 'seat' | 'booth' | 'ga';
+    categoryKey: string;
+    /** Chosen ticket tier id (Adult/Child/…), or null when the category has no tiers. */
+    tierId: string | null;
+    /** Unit price in MAJOR currency units (e.g. 45 = 45.00). Server-authoritative. */
+    unitPrice: number;
+    /** ISO-4217, resolved server-side (per-event override → org → USD). */
+    currency: string;
+    quantity: number;
+}
+interface CheckoutHandoff {
+    /** Server hold id — pass this to YOUR book call. */
+    holdId: string;
+    /** Epoch ms the hold expires (after any extensions). */
+    expiresAt: number;
+    /** ISO-4217 currency for the whole order. */
+    currency: string;
+    /** Priced line items (tier + unit price + currency), server-authoritative. */
+    lineItems: CheckoutLineItem[];
+    /** Convenience total in major units (Σ unitPrice × quantity). */
+    total: number;
+}
 /** Host theme overrides — any subset; unset keys fall back to the org's chart theme, then defaults. */
 interface SeatPickerTheme {
     /** Brand accent (CTA, active chips, hold pill). */
@@ -324,11 +358,26 @@ interface SeatPickerOptions {
      * price · Add/Cancel) instead of adding straight to the tray. Default false.
      */
     confirmSelection?: boolean;
+    /**
+     * Offer a "View from seat" 360° preview (confirm popover + tray chips). The
+     * panorama is generated from the chart geometry, or the organizer's uploaded
+     * photo when a seat carries one. Default true; set false to hide the affordance.
+     */
+    seatView?: boolean;
     /**
      * Buyer pressed the CTA and the hold succeeded — hand off to YOUR checkout.
-     * The hold carries holdId, expiresAt, seat labels and priced line items.
+     * `hold` and `seats` are the legacy args (unchanged since 0.6). `handoff` (P4)
+     * is the stable, self-contained {@link CheckoutHandoff} to build your order
+     * against — holdId, expiry, currency and priced line items. Prefer it.
      */
-    onCheckout?: (hold: HoldResult, seats: PickerSeat[]) => void;
+    onCheckout?: (hold: HoldResult, seats: PickerSeat[], handoff: CheckoutHandoff) => void;
+    /**
+     * The held seats were BOOKED (P4) — your server completed payment and the
+     * booking landed over the realtime channel while the widget was still open.
+     * The widget shows a success state; use this to advance your own UI (receipt,
+     * redirect). Fires once per hold.
+     */
+    onBooked?: (handoff: CheckoutHandoff) => void;
     /** Selection changed (tap or best-available). */
     onSelectionChange?: (seats: PickerSeat[]) => void;
     /** The open hold expired server-side (widget already reset itself). */
@@ -350,6 +399,14 @@ declare class SeatPicker {
     private toastTimer;
     private currency;
     private hold;
+    /** Latest server expiry for the open hold (moves on extend). */
+    private holdExpiresAt;
+    /** True once we handed off to checkout — arms booked-confirmation detection. */
+    private handedOff;
+    /** Guards single onBooked + single success overlay per hold. */
+    private bookedShown;
+    private extendEl;
+    private bookedEl;
     private gaQty;
     private tipEl;
     private tipPos;
@@ -359,6 +416,12 @@ declare class SeatPicker {
     private a11yFilter;
     private baQty;
     private baCat;
+    private rungsEl;
+    private floorsEl;
+    private secCardEl;
+    private viewEl;
+    private viewCleanup;
+    private allSeatsCache;
     private modalScrim;
     private prevFocus;
     private escHandler;
@@ -374,11 +437,34 @@ declare class SeatPicker {
     static open(options: Omit<SeatPickerOptions, 'container'>): Promise<SeatPicker>;
     constructor(options: SeatPickerOptions);
     render(): Promise<this>;
+    /** The "Need more time?" prompt shown in the hold's final EXTEND_PROMPT_MS. */
+    private buildExtendPrompt;
+    /** Success overlay + onBooked fire when the held seats settle to booked. */
+    private buildBookedOverlay;
+    /** Build the rung pills (charts with sections) and floor switcher (>1 floor). */
+    private buildArenaChrome;
+    /** Reflect the engine's current LOD rung onto the pill group. */
+    private syncRung;
+    /** Reflect the active floor onto the switcher rail. */
+    private syncFloors;
+    /** Show (or clear, on null) the tapped-section summary card. */
+    private showSectionCard;
     /** aria-live readout when keyboard focus lands on a seat. */
     private announceSeat;
     private showConfirm;
     private reanchorConfirm;
     private closeConfirm;
+    private seatViewEnabled;
+    /** Every bookable seat (cached) — neighbor heads for the generated panorama. */
+    private allSeats;
+    /**
+     * Open the drag-to-look-around 360° preview for a seat. Uses the organizer's
+     * uploaded photo (seat.viewUrl) when present, else a panorama generated from
+     * the chart geometry — the stage placed at this seat's true bearing + size.
+     * Zero extra dependencies: an equirectangular image panned with `repeat-x`.
+     */
+    private openSeatView;
+    private closeSeatView;
     private money;
     private syncPrices;
     /** A live delta took one of OUR selected (not yet held) seats — evict + tell the buyer. */
@@ -387,6 +473,21 @@ declare class SeatPicker {
     private handleCta;
     private startHoldTimer;
     private stopHoldTimer;
+    /** Show/refresh (or hide) the "Need more time?" prompt with the live seconds left. */
+    private setExtendPrompt;
+    private handleExtend;
+    /**
+     * Fire the booked-confirmation state once the buyer's held seats settle to
+     * booked. The controller clears its own hold the moment every held label reads
+     * 'booked' over the realtime channel (clearBookedHoldIfSettled), and this runs
+     * on the same onStatusChange — so `currentHold() === null` while we still hold
+     * a checkout handoff means "sold", not expired (expiry clears via onHoldExpired
+     * on a different path, which nulls this.hold first).
+     */
+    private detectBooked;
+    private showBooked;
+    /** Assemble the stable {@link CheckoutHandoff} from a hold's server line items. */
+    private buildHandoff;
     private toast;
     private placeTooltip;
     private updateTooltip;
@@ -396,4 +497,4 @@ declare class SeatPicker {
     destroy(): void;
 }
 
-export { ApiError, type BestAvailableResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };