@seatlayer/js 0.95.1 → 0.97.0

package/dist/index.d.cts

@@ -502,6 +502,13 @@ declare function createControllerSink(controller: PickerControllerLike, options?
  * follows the card's rule: NO RUNTIME IMPORTS. Everything it needs — the ticket
  * keys, the translator, the buyer's own details — arrives as arguments.
  *
+ * Nothing is asked twice (docs/design/checkout-ux-2026-09-22 in the app repo):
+ * ticket 1 copies the buyer's own name and email and is shown as one line,
+ * "You · Asha", with a way to change it; a one-ticket order has no holder
+ * block at all; holder details that are all optional wait behind one line.
+ * What is SENT is unchanged — ticket 1's attendee still carries the buyer's
+ * name and email.
+ *
  * The server is the authority on every rule below (`booking_form_incomplete`).
  * These checks only exist so a buyer hears about a missing name next to the
  * field, before a round trip, in the same words the refusal would map to.
@@ -684,8 +691,8 @@ interface BestAvailableResult {
     /** See {@link HoldResult.ticketKeyDetails}. */
     ticketKeyDetails?: TicketKeyDetail[];
 }
-/** A gateway the organizer can be connected to. */
-type PaymentProviderName = 'stripe' | 'razorpay';
+/** A gateway the organizer can be connected to. Provider ids are server-owned. */
+type PaymentProviderName = string;
 /**
  * Why `payment-options` came back with an empty list.
  *
@@ -718,7 +725,7 @@ interface PaymentOptionsResult {
     /** What hosted checkout must ask: attendee details and active questions. */
     bookingForm?: BookingForm | null;
 }
-/** A started payment. Exactly one of the two handoffs comes back. */
+/** A started payment. Paid checkouts continue through one provider-neutral redirect. */
 interface CheckoutSessionResult {
     orderId: string;
     totalMinor: number;
@@ -726,8 +733,6 @@ interface CheckoutSessionResult {
     expiresAt: number;
     /** Hosted gateway page — navigate to it. */
     redirectUrl?: string;
-    /** In-page modal gateway — open it without leaving the page. */
-    clientPayload?: Record<string, unknown>;
     /**
      * `'confirmed'` when the booking needed no payment (a free event, or a hold
      * that sums to zero): the seats are already booked and the tickets issued,
@@ -836,6 +841,10 @@ interface GaPromptPicker {
     gaQty: GaQtyMap;
     maxTickets: number;
     salesClosed: boolean;
+    /** The closed-sales words for this event's state; absent on older hosts. */
+    closedWords?(): {
+        toast: string;
+    };
     gaPromptEl: HTMLDivElement | null;
     gaPromptReturnFocus: HTMLElement | null;
     gaAreasExpanded: boolean;
@@ -1013,6 +1022,13 @@ interface CheckoutLineItem {
     sectionLabel?: string;
     rowLabel?: string;
     seatNumber?: string;
+    /**
+     * Buyer-facing category name ("Standard") and ticket type ("Adult") for
+     * `categoryKey` / `tierId`, so an order summary need not look them up.
+     * Absent when the chart names neither (or on an older SDK).
+     */
+    categoryLabel?: string;
+    tierLabel?: string;
 }
 interface CheckoutHandoff {
     /** Server hold id — pass this to YOUR book call. */
@@ -3479,6 +3495,40 @@ interface WebMcpRegistration {
 /** What `PickerController.render()` reports back about the loaded event. */
 type PickerRenderInfo = NonNullable<Awaited<ReturnType<PickerController['render']>>>;
 
+/**
+ * pickerTray — the renderable pieces of the selection tray: the ticket-card
+ * identity grid, the card's icon rail, the best-available card, the tray's
+ * opening line, and the hold countdown copy.
+ *
+ * The mobile peek bar used to live here too — a one-liner that restated the
+ * count, the total and the way forward for a collapsed bottom sheet. The
+ * collapsed sheet now shows the SAME footer block the desktop panel has (owner
+ * call 2026-09-05), so there is one cart summary in the widget instead of two
+ * that had to be kept saying the same thing.
+ *
+ * These are pure: they take values and return strings. Bodies are verbatim from
+ * SeatPicker.ts; the only edits are that each value the closure used to read
+ * off `this` (or look up mid-body) is now a parameter, and `this.tf` is the
+ * `tfStatic` it always delegated to.
+ *
+ * NOT moved, deliberately: `syncTray` itself. It is ~350 lines of
+ * orchestration that touches about fifty-five SeatPicker members and WRITES a
+ * dozen of them (`baQty`, `baCat`, `baZone`, `baPremium`,
+ * `bestAvailableConfirm`, `gaQty`, `lastTrayKeys`, `lastTrayCount`,
+ * `lastTrayTotal`, `sideCollapsed`), wires fifteen event
+ * handlers that call back into the widget, and re-enters itself from nine of
+ * them. A host interface wide enough to carry that is the class with a layer of
+ * indirection bolted on — strictly worse than leaving the orchestration on the
+ * object it orchestrates. So the STRINGS moved and the wiring stayed.
+ */
+
+/** What every closed-sales surface says for one state: the pill, the button and the toast. */
+interface SalesClosedWords {
+    pill: string;
+    cta: string;
+    toast: string;
+}
+
 /**
  * Hosted checkout — the payment step, as a module nobody downloads until a
  * buyer actually asks to pay.
@@ -4176,6 +4226,8 @@ declare class SeatPicker implements GaPromptPicker {
      */
     /** @internal The host's GA prompt takeover, if it supplied one. */
     get onGAPromptHook(): SeatPickerOptions['onGAPrompt'];
+    /** @internal The closed-sales words for this event's own sales state. */
+    closedWords(): SalesClosedWords;
     /** @internal */ tf(key: string, fallback: string): string;
     /** Sold-out overlay — an informational state with no unavailable action. */
     private buildSoldoutOverlay;
@@ -5511,8 +5563,6 @@ interface SeasonCheckoutSession {
     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;

package/dist/index.d.ts

@@ -502,6 +502,13 @@ declare function createControllerSink(controller: PickerControllerLike, options?
  * follows the card's rule: NO RUNTIME IMPORTS. Everything it needs — the ticket
  * keys, the translator, the buyer's own details — arrives as arguments.
  *
+ * Nothing is asked twice (docs/design/checkout-ux-2026-09-22 in the app repo):
+ * ticket 1 copies the buyer's own name and email and is shown as one line,
+ * "You · Asha", with a way to change it; a one-ticket order has no holder
+ * block at all; holder details that are all optional wait behind one line.
+ * What is SENT is unchanged — ticket 1's attendee still carries the buyer's
+ * name and email.
+ *
  * The server is the authority on every rule below (`booking_form_incomplete`).
  * These checks only exist so a buyer hears about a missing name next to the
  * field, before a round trip, in the same words the refusal would map to.
@@ -684,8 +691,8 @@ interface BestAvailableResult {
     /** See {@link HoldResult.ticketKeyDetails}. */
     ticketKeyDetails?: TicketKeyDetail[];
 }
-/** A gateway the organizer can be connected to. */
-type PaymentProviderName = 'stripe' | 'razorpay';
+/** A gateway the organizer can be connected to. Provider ids are server-owned. */
+type PaymentProviderName = string;
 /**
  * Why `payment-options` came back with an empty list.
  *
@@ -718,7 +725,7 @@ interface PaymentOptionsResult {
     /** What hosted checkout must ask: attendee details and active questions. */
     bookingForm?: BookingForm | null;
 }
-/** A started payment. Exactly one of the two handoffs comes back. */
+/** A started payment. Paid checkouts continue through one provider-neutral redirect. */
 interface CheckoutSessionResult {
     orderId: string;
     totalMinor: number;
@@ -726,8 +733,6 @@ interface CheckoutSessionResult {
     expiresAt: number;
     /** Hosted gateway page — navigate to it. */
     redirectUrl?: string;
-    /** In-page modal gateway — open it without leaving the page. */
-    clientPayload?: Record<string, unknown>;
     /**
      * `'confirmed'` when the booking needed no payment (a free event, or a hold
      * that sums to zero): the seats are already booked and the tickets issued,
@@ -836,6 +841,10 @@ interface GaPromptPicker {
     gaQty: GaQtyMap;
     maxTickets: number;
     salesClosed: boolean;
+    /** The closed-sales words for this event's state; absent on older hosts. */
+    closedWords?(): {
+        toast: string;
+    };
     gaPromptEl: HTMLDivElement | null;
     gaPromptReturnFocus: HTMLElement | null;
     gaAreasExpanded: boolean;
@@ -1013,6 +1022,13 @@ interface CheckoutLineItem {
     sectionLabel?: string;
     rowLabel?: string;
     seatNumber?: string;
+    /**
+     * Buyer-facing category name ("Standard") and ticket type ("Adult") for
+     * `categoryKey` / `tierId`, so an order summary need not look them up.
+     * Absent when the chart names neither (or on an older SDK).
+     */
+    categoryLabel?: string;
+    tierLabel?: string;
 }
 interface CheckoutHandoff {
     /** Server hold id — pass this to YOUR book call. */
@@ -3479,6 +3495,40 @@ interface WebMcpRegistration {
 /** What `PickerController.render()` reports back about the loaded event. */
 type PickerRenderInfo = NonNullable<Awaited<ReturnType<PickerController['render']>>>;
 
+/**
+ * pickerTray — the renderable pieces of the selection tray: the ticket-card
+ * identity grid, the card's icon rail, the best-available card, the tray's
+ * opening line, and the hold countdown copy.
+ *
+ * The mobile peek bar used to live here too — a one-liner that restated the
+ * count, the total and the way forward for a collapsed bottom sheet. The
+ * collapsed sheet now shows the SAME footer block the desktop panel has (owner
+ * call 2026-09-05), so there is one cart summary in the widget instead of two
+ * that had to be kept saying the same thing.
+ *
+ * These are pure: they take values and return strings. Bodies are verbatim from
+ * SeatPicker.ts; the only edits are that each value the closure used to read
+ * off `this` (or look up mid-body) is now a parameter, and `this.tf` is the
+ * `tfStatic` it always delegated to.
+ *
+ * NOT moved, deliberately: `syncTray` itself. It is ~350 lines of
+ * orchestration that touches about fifty-five SeatPicker members and WRITES a
+ * dozen of them (`baQty`, `baCat`, `baZone`, `baPremium`,
+ * `bestAvailableConfirm`, `gaQty`, `lastTrayKeys`, `lastTrayCount`,
+ * `lastTrayTotal`, `sideCollapsed`), wires fifteen event
+ * handlers that call back into the widget, and re-enters itself from nine of
+ * them. A host interface wide enough to carry that is the class with a layer of
+ * indirection bolted on — strictly worse than leaving the orchestration on the
+ * object it orchestrates. So the STRINGS moved and the wiring stayed.
+ */
+
+/** What every closed-sales surface says for one state: the pill, the button and the toast. */
+interface SalesClosedWords {
+    pill: string;
+    cta: string;
+    toast: string;
+}
+
 /**
  * Hosted checkout — the payment step, as a module nobody downloads until a
  * buyer actually asks to pay.
@@ -4176,6 +4226,8 @@ declare class SeatPicker implements GaPromptPicker {
      */
     /** @internal The host's GA prompt takeover, if it supplied one. */
     get onGAPromptHook(): SeatPickerOptions['onGAPrompt'];
+    /** @internal The closed-sales words for this event's own sales state. */
+    closedWords(): SalesClosedWords;
     /** @internal */ tf(key: string, fallback: string): string;
     /** Sold-out overlay — an informational state with no unavailable action. */
     private buildSoldoutOverlay;
@@ -5511,8 +5563,6 @@ interface SeasonCheckoutSession {
     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;