@seatlayer/js 0.88.0 → 0.89.0

package/dist/index.d.cts

@@ -478,6 +478,78 @@ interface ControllerSinkOptions {
 }
 declare function createControllerSink(controller: PickerControllerLike, options?: ControllerSinkOptions): RealtimeSink;
 
+/**
+ * The booking form inside the hosted-checkout card: a name, email or phone for
+ * each ticket, and the organizer's own questions, rendered from the
+ * `bookingForm` that `GET /pub/events/:key/payment-options` already carries.
+ *
+ * Built into the standalone `seatlayer-checkout.mjs` asset with the card, so it
+ * follows the card's rule: NO RUNTIME IMPORTS. Everything it needs — the ticket
+ * keys, the translator, the buyer's own details — arrives as arguments.
+ *
+ * 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.
+ */
+/** Organizer setting for one attendee detail. */
+type AttendeeFieldMode = 'off' | 'optional' | 'required';
+type BookingQuestionType = 'text' | 'textarea' | 'number' | 'select' | 'multiselect' | 'checkbox' | 'date' | 'email' | 'phone';
+interface BookingQuestionOption {
+    id: string;
+    label: string;
+}
+/** One organizer question. Public payloads carry active questions only. */
+interface BookingQuestion {
+    id: string;
+    position: number;
+    label: string;
+    helpText: string | null;
+    type: BookingQuestionType;
+    /** Present for `select` and `multiselect`. */
+    options: BookingQuestionOption[] | null;
+    required: boolean;
+    /** `order` is asked once per booking; `ticket` inside every ticket's block. */
+    scope: 'order' | 'ticket';
+    /** Who later sees the answer. Staff-only questions are still asked. */
+    visibility: 'buyer' | 'staff';
+    archived: boolean;
+    /** Organizer reads only. */
+    hasAnswers?: boolean;
+}
+/** What `payment-options` says the checkout must ask. */
+interface BookingForm {
+    attendeeName: AttendeeFieldMode;
+    attendeeEmail: AttendeeFieldMode;
+    attendeePhone: AttendeeFieldMode;
+    questions: BookingQuestion[];
+    /** Organizer reads only. */
+    revision?: number;
+}
+/** One ticket's attendee, keyed by the server's ticket key. */
+interface CheckoutAttendee {
+    ticketKey: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+type CheckoutAnswerValue = string | number | boolean | string[];
+/** One answer. `ticketKey` is set for ticket-scope questions only. */
+interface CheckoutAnswer {
+    questionId: string;
+    ticketKey?: string;
+    value: CheckoutAnswerValue;
+}
+type BookingFieldErrorCode = 'required' | 'invalid' | 'too_long';
+/**
+ * One field the server refused (`422 booking_form_incomplete`). `key` is
+ * `attendeeName` | `attendeeEmail` | `attendeePhone` | `question:<id>`.
+ */
+interface BookingFormFieldError {
+    key: string;
+    ticketKey?: string;
+    code: BookingFieldErrorCode;
+}
+
 /**
  * Minimal client for the browser embed surface of workers/api (the `/pub/*`
  * routes). Platform events bind this client to a buyer access context; Managed
@@ -516,14 +588,26 @@ declare class ApiError extends Error {
     /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */
     reason?: string;
     /**
-     * Seconds the server asked the caller to wait, off a 429's `Retry-After`.
+     * Seconds the server asked the caller to wait, off a 429's or a 503's
+     * `Retry-After`.
      *
-     * Present ONLY on a rate-limit error, and it is the server's number — never a
-     * guess. A widget that catches this can say "try again in N seconds" instead
-     * of rendering the blank map a swallowed 429 used to produce.
+     * Present ONLY on a rate-limit or maintenance error, and it is the server's
+     * number — never a guess. A widget that catches this can say "try again in
+     * N minutes" instead of rendering the blank map a swallowed 429 used to
+     * produce, or the "seats were just taken" a maintenance 503 used to become.
      */
     retryAfterS?: number;
-    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number);
+    /**
+     * Operator-written buyer copy that arrived with a maintenance 503 (the API's
+     * `notice`). Shown verbatim when present; absent, the widget uses its own
+     * localised wording built from `retryAfterS`.
+     */
+    notice?: string;
+    /** `422 booking_form_incomplete`: the fields the server refused, for inline errors. */
+    fields?: BookingFormFieldError[];
+    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string, details?: {
+        fields?: BookingFormFieldError[];
+    });
 }
 interface HoldResult {
     holdId: string;
@@ -531,6 +615,35 @@ interface HoldResult {
     /** The held seats with the buyer's chosen ticket tier per seat (present on hold). */
     seats?: PickerSeat[];
     items?: HoldLineItem[];
+    /**
+     * One key per guest this hold admits, in issuance order: a seat, booth or
+     * individually sold chair is its label; a general-admission place (its own
+     * inventory unit) is `"<label>#1"`; a whole table admitting q places is
+     * `"<label>#1"` … `"<label>#q"`. The booking form keys attendees and ticket
+     * answers by it. Keys and GA unit labels are internal: never show them.
+     * Absent from older servers.
+     */
+    ticketKeys?: string[];
+    /** Per key: its label, and which guest of how many it is. */
+    ticketKeyDetails?: TicketKeyDetail[];
+    /**
+     * True when the server answered a retried hold attempt with the hold that
+     * attempt already created. Same `holdId` and `expiresAt`; `items` come back
+     * sorted by label with their committed prices.
+     */
+    replayed?: boolean;
+}
+/**
+ * One guest's ticket key. `label` is the inventory label and may be internal
+ * (a GA place); `displayLabel` is what a buyer may see. `unitIndex` and
+ * `quantity` number the guests of one ticket admitting several places.
+ */
+interface TicketKeyDetail {
+    ticketKey: string;
+    label: string;
+    unitIndex: number;
+    quantity: number;
+    displayLabel?: string;
 }
 /** Browser-safe active-hold projection returned by the resume endpoint. */
 interface ResumedHoldResult extends HoldResult {
@@ -544,6 +657,10 @@ interface BestAvailableResult {
     seats?: PickerSeat[];
     items?: HoldResult['items'];
     zoneId?: string;
+    /** See {@link HoldResult.ticketKeys}. */
+    ticketKeys?: string[];
+    /** See {@link HoldResult.ticketKeyDetails}. */
+    ticketKeyDetails?: TicketKeyDetail[];
 }
 /** A gateway the organizer can be connected to. */
 type PaymentProviderName = 'stripe' | 'razorpay';
@@ -570,6 +687,14 @@ interface PaymentOptionsResult {
     providers: PaymentProviderName[];
     currency: string | null;
     reason?: PaymentOptionsReason | null;
+    /**
+     * Whether the event charges. `'free'` comes with an empty `providers` list
+     * and `reason: null`: nothing is missing, the booking simply has no payment
+     * step. Absent from older servers, which only ever meant `'paid'`.
+     */
+    bookingMode?: 'paid' | 'free';
+    /** What hosted checkout must ask: attendee details and active questions. */
+    bookingForm?: BookingForm | null;
 }
 /** A started payment. Exactly one of the two handoffs comes back. */
 interface CheckoutSessionResult {
@@ -581,6 +706,16 @@ interface CheckoutSessionResult {
     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,
+     * so there is no handoff to follow. Read the order's status for the receipt.
+     */
+    status?: 'confirmed';
+    /** Buyer-facing order number, on a booking confirmed without payment. */
+    orderNumber?: string;
+    /** Hosted confirmation page path, on a booking confirmed without payment. */
+    confirmationUrl?: string;
 }
 /** An order's state while its gateway webhook is in flight. */
 interface OrderStatusResult {
@@ -595,6 +730,8 @@ interface OrderStatusResult {
     startsAt?: number | null;
     tickets?: Array<{
         label: string;
+        /** What a buyer may call the ticket; `label` can be an internal inventory label. */
+        displayLabel?: string | null;
         token: string;
         status: 'issued' | 'checked_in' | 'void';
         checkedInAt: number | null;
@@ -3272,6 +3409,40 @@ interface WebMcpRegistration {
 /** What `PickerController.render()` reports back about the loaded event. */
 type PickerRenderInfo = NonNullable<Awaited<ReturnType<PickerController['render']>>>;
 
+/**
+ * Hosted checkout — the payment step, as a module nobody downloads until a
+ * buyer actually asks to pay.
+ *
+ * This is the whole of what `checkout: 'hosted'` adds to SeatPicker: a card
+ * that collects an email, starts a payment against `POST /pub/events/:key/
+ * checkout`, hands off to the gateway, and waits for the webhook to land. It is
+ * a straight port of the panel our own buyer page has shipped since hosted
+ * checkout existed (`src/pages/CheckoutPanel.tsx`), with React and the app's
+ * shared api client taken out.
+ *
+ * IT IMPORTS NOTHING AT RUNTIME. Not `@seatlayer/core`, not `./api`, not even a
+ * type from `./SeatPicker` — every input arrives through {@link CheckoutMount},
+ * including the two API calls, which arrive as functions. That is not
+ * fastidiousness: this file is built as a standalone CDN asset
+ * (`seatlayer-checkout.mjs`), and a single value import from the engine would
+ * pull a second copy of it into that asset and undo the point of splitting.
+ * The one exception is `./hostedCheckoutForm`, the booking form, which lives
+ * in that same asset under the same rule.
+ *
+ * Three states, one card, because they are the same moment in the buyer's
+ * journey and share every pixel of chrome:
+ *
+ *   pay          a live hold — collect an email and START a payment
+ *   resume       back from a hosted gateway page — the hold and its line items
+ *                are gone with the old document, so this can only WAIT on the
+ *                order id restored from tab storage. It must never offer
+ *                to start a second payment for a purchase that may have already
+ *                succeeded.
+ *   unavailable  the event cannot take money here, and the buyer is holding
+ *                seats. Say which of the three reasons it is, because two of
+ *                them give opposite advice.
+ */
+
 /** What `GET /pub/orders/:id/status` returns while the webhook is in flight. */
 interface CheckoutOrderStatus {
     orderId: string;
@@ -3282,6 +3453,8 @@ interface CheckoutOrderStatus {
     seatCount: number;
     tickets?: Array<{
         label: string;
+        /** What a buyer may call the ticket; the inventory label can be internal. */
+        displayLabel?: string | null;
         token: string;
         status: 'issued' | 'checked_in' | 'void';
         checkedInAt: number | null;
@@ -5480,4 +5653,4 @@ interface AttachPickerFrameOptions {
  */
 declare function attachPickerFrame(iframe: HTMLIFrameElement, opts?: AttachPickerFrameOptions): () => void;
 
-export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAudience, type SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCategoryPrice, type SeasonCheckoutHandoff, type SeasonCheckoutMode, type SeasonCheckoutRequest, type SeasonCheckoutSession, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, type SeasonPackagePrices, SeasonPicker, type SeasonPickerOptions, type SeasonPrices, type SeasonPublicRefusalReason, type SeasonPublicSession, SeasonPublicSessionRefused, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPrewarmOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, prewarmSeatPicker, shortOperationReference, ticketOfferPrices };
+export { ApiError, type AttachPickerFrameOptions, type AttendeeFieldMode, type BestAvailableResult, type BookingForm, type BookingFormFieldError, type BookingQuestion, type BookingQuestionType, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutAnswer, type CheckoutAttendee, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAudience, type SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCategoryPrice, type SeasonCheckoutHandoff, type SeasonCheckoutMode, type SeasonCheckoutRequest, type SeasonCheckoutSession, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, type SeasonPackagePrices, SeasonPicker, type SeasonPickerOptions, type SeasonPrices, type SeasonPublicRefusalReason, type SeasonPublicSession, SeasonPublicSessionRefused, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPrewarmOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketKeyDetail, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, prewarmSeatPicker, shortOperationReference, ticketOfferPrices };

package/dist/index.d.ts

@@ -478,6 +478,78 @@ interface ControllerSinkOptions {
 }
 declare function createControllerSink(controller: PickerControllerLike, options?: ControllerSinkOptions): RealtimeSink;
 
+/**
+ * The booking form inside the hosted-checkout card: a name, email or phone for
+ * each ticket, and the organizer's own questions, rendered from the
+ * `bookingForm` that `GET /pub/events/:key/payment-options` already carries.
+ *
+ * Built into the standalone `seatlayer-checkout.mjs` asset with the card, so it
+ * follows the card's rule: NO RUNTIME IMPORTS. Everything it needs — the ticket
+ * keys, the translator, the buyer's own details — arrives as arguments.
+ *
+ * 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.
+ */
+/** Organizer setting for one attendee detail. */
+type AttendeeFieldMode = 'off' | 'optional' | 'required';
+type BookingQuestionType = 'text' | 'textarea' | 'number' | 'select' | 'multiselect' | 'checkbox' | 'date' | 'email' | 'phone';
+interface BookingQuestionOption {
+    id: string;
+    label: string;
+}
+/** One organizer question. Public payloads carry active questions only. */
+interface BookingQuestion {
+    id: string;
+    position: number;
+    label: string;
+    helpText: string | null;
+    type: BookingQuestionType;
+    /** Present for `select` and `multiselect`. */
+    options: BookingQuestionOption[] | null;
+    required: boolean;
+    /** `order` is asked once per booking; `ticket` inside every ticket's block. */
+    scope: 'order' | 'ticket';
+    /** Who later sees the answer. Staff-only questions are still asked. */
+    visibility: 'buyer' | 'staff';
+    archived: boolean;
+    /** Organizer reads only. */
+    hasAnswers?: boolean;
+}
+/** What `payment-options` says the checkout must ask. */
+interface BookingForm {
+    attendeeName: AttendeeFieldMode;
+    attendeeEmail: AttendeeFieldMode;
+    attendeePhone: AttendeeFieldMode;
+    questions: BookingQuestion[];
+    /** Organizer reads only. */
+    revision?: number;
+}
+/** One ticket's attendee, keyed by the server's ticket key. */
+interface CheckoutAttendee {
+    ticketKey: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+type CheckoutAnswerValue = string | number | boolean | string[];
+/** One answer. `ticketKey` is set for ticket-scope questions only. */
+interface CheckoutAnswer {
+    questionId: string;
+    ticketKey?: string;
+    value: CheckoutAnswerValue;
+}
+type BookingFieldErrorCode = 'required' | 'invalid' | 'too_long';
+/**
+ * One field the server refused (`422 booking_form_incomplete`). `key` is
+ * `attendeeName` | `attendeeEmail` | `attendeePhone` | `question:<id>`.
+ */
+interface BookingFormFieldError {
+    key: string;
+    ticketKey?: string;
+    code: BookingFieldErrorCode;
+}
+
 /**
  * Minimal client for the browser embed surface of workers/api (the `/pub/*`
  * routes). Platform events bind this client to a buyer access context; Managed
@@ -516,14 +588,26 @@ declare class ApiError extends Error {
     /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */
     reason?: string;
     /**
-     * Seconds the server asked the caller to wait, off a 429's `Retry-After`.
+     * Seconds the server asked the caller to wait, off a 429's or a 503's
+     * `Retry-After`.
      *
-     * Present ONLY on a rate-limit error, and it is the server's number — never a
-     * guess. A widget that catches this can say "try again in N seconds" instead
-     * of rendering the blank map a swallowed 429 used to produce.
+     * Present ONLY on a rate-limit or maintenance error, and it is the server's
+     * number — never a guess. A widget that catches this can say "try again in
+     * N minutes" instead of rendering the blank map a swallowed 429 used to
+     * produce, or the "seats were just taken" a maintenance 503 used to become.
      */
     retryAfterS?: number;
-    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number);
+    /**
+     * Operator-written buyer copy that arrived with a maintenance 503 (the API's
+     * `notice`). Shown verbatim when present; absent, the widget uses its own
+     * localised wording built from `retryAfterS`.
+     */
+    notice?: string;
+    /** `422 booking_form_incomplete`: the fields the server refused, for inline errors. */
+    fields?: BookingFormFieldError[];
+    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string, details?: {
+        fields?: BookingFormFieldError[];
+    });
 }
 interface HoldResult {
     holdId: string;
@@ -531,6 +615,35 @@ interface HoldResult {
     /** The held seats with the buyer's chosen ticket tier per seat (present on hold). */
     seats?: PickerSeat[];
     items?: HoldLineItem[];
+    /**
+     * One key per guest this hold admits, in issuance order: a seat, booth or
+     * individually sold chair is its label; a general-admission place (its own
+     * inventory unit) is `"<label>#1"`; a whole table admitting q places is
+     * `"<label>#1"` … `"<label>#q"`. The booking form keys attendees and ticket
+     * answers by it. Keys and GA unit labels are internal: never show them.
+     * Absent from older servers.
+     */
+    ticketKeys?: string[];
+    /** Per key: its label, and which guest of how many it is. */
+    ticketKeyDetails?: TicketKeyDetail[];
+    /**
+     * True when the server answered a retried hold attempt with the hold that
+     * attempt already created. Same `holdId` and `expiresAt`; `items` come back
+     * sorted by label with their committed prices.
+     */
+    replayed?: boolean;
+}
+/**
+ * One guest's ticket key. `label` is the inventory label and may be internal
+ * (a GA place); `displayLabel` is what a buyer may see. `unitIndex` and
+ * `quantity` number the guests of one ticket admitting several places.
+ */
+interface TicketKeyDetail {
+    ticketKey: string;
+    label: string;
+    unitIndex: number;
+    quantity: number;
+    displayLabel?: string;
 }
 /** Browser-safe active-hold projection returned by the resume endpoint. */
 interface ResumedHoldResult extends HoldResult {
@@ -544,6 +657,10 @@ interface BestAvailableResult {
     seats?: PickerSeat[];
     items?: HoldResult['items'];
     zoneId?: string;
+    /** See {@link HoldResult.ticketKeys}. */
+    ticketKeys?: string[];
+    /** See {@link HoldResult.ticketKeyDetails}. */
+    ticketKeyDetails?: TicketKeyDetail[];
 }
 /** A gateway the organizer can be connected to. */
 type PaymentProviderName = 'stripe' | 'razorpay';
@@ -570,6 +687,14 @@ interface PaymentOptionsResult {
     providers: PaymentProviderName[];
     currency: string | null;
     reason?: PaymentOptionsReason | null;
+    /**
+     * Whether the event charges. `'free'` comes with an empty `providers` list
+     * and `reason: null`: nothing is missing, the booking simply has no payment
+     * step. Absent from older servers, which only ever meant `'paid'`.
+     */
+    bookingMode?: 'paid' | 'free';
+    /** What hosted checkout must ask: attendee details and active questions. */
+    bookingForm?: BookingForm | null;
 }
 /** A started payment. Exactly one of the two handoffs comes back. */
 interface CheckoutSessionResult {
@@ -581,6 +706,16 @@ interface CheckoutSessionResult {
     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,
+     * so there is no handoff to follow. Read the order's status for the receipt.
+     */
+    status?: 'confirmed';
+    /** Buyer-facing order number, on a booking confirmed without payment. */
+    orderNumber?: string;
+    /** Hosted confirmation page path, on a booking confirmed without payment. */
+    confirmationUrl?: string;
 }
 /** An order's state while its gateway webhook is in flight. */
 interface OrderStatusResult {
@@ -595,6 +730,8 @@ interface OrderStatusResult {
     startsAt?: number | null;
     tickets?: Array<{
         label: string;
+        /** What a buyer may call the ticket; `label` can be an internal inventory label. */
+        displayLabel?: string | null;
         token: string;
         status: 'issued' | 'checked_in' | 'void';
         checkedInAt: number | null;
@@ -3272,6 +3409,40 @@ interface WebMcpRegistration {
 /** What `PickerController.render()` reports back about the loaded event. */
 type PickerRenderInfo = NonNullable<Awaited<ReturnType<PickerController['render']>>>;
 
+/**
+ * Hosted checkout — the payment step, as a module nobody downloads until a
+ * buyer actually asks to pay.
+ *
+ * This is the whole of what `checkout: 'hosted'` adds to SeatPicker: a card
+ * that collects an email, starts a payment against `POST /pub/events/:key/
+ * checkout`, hands off to the gateway, and waits for the webhook to land. It is
+ * a straight port of the panel our own buyer page has shipped since hosted
+ * checkout existed (`src/pages/CheckoutPanel.tsx`), with React and the app's
+ * shared api client taken out.
+ *
+ * IT IMPORTS NOTHING AT RUNTIME. Not `@seatlayer/core`, not `./api`, not even a
+ * type from `./SeatPicker` — every input arrives through {@link CheckoutMount},
+ * including the two API calls, which arrive as functions. That is not
+ * fastidiousness: this file is built as a standalone CDN asset
+ * (`seatlayer-checkout.mjs`), and a single value import from the engine would
+ * pull a second copy of it into that asset and undo the point of splitting.
+ * The one exception is `./hostedCheckoutForm`, the booking form, which lives
+ * in that same asset under the same rule.
+ *
+ * Three states, one card, because they are the same moment in the buyer's
+ * journey and share every pixel of chrome:
+ *
+ *   pay          a live hold — collect an email and START a payment
+ *   resume       back from a hosted gateway page — the hold and its line items
+ *                are gone with the old document, so this can only WAIT on the
+ *                order id restored from tab storage. It must never offer
+ *                to start a second payment for a purchase that may have already
+ *                succeeded.
+ *   unavailable  the event cannot take money here, and the buyer is holding
+ *                seats. Say which of the three reasons it is, because two of
+ *                them give opposite advice.
+ */
+
 /** What `GET /pub/orders/:id/status` returns while the webhook is in flight. */
 interface CheckoutOrderStatus {
     orderId: string;
@@ -3282,6 +3453,8 @@ interface CheckoutOrderStatus {
     seatCount: number;
     tickets?: Array<{
         label: string;
+        /** What a buyer may call the ticket; the inventory label can be internal. */
+        displayLabel?: string | null;
         token: string;
         status: 'issued' | 'checked_in' | 'void';
         checkedInAt: number | null;
@@ -5480,4 +5653,4 @@ interface AttachPickerFrameOptions {
  */
 declare function attachPickerFrame(iframe: HTMLIFrameElement, opts?: AttachPickerFrameOptions): () => void;
 
-export { ApiError, type AttachPickerFrameOptions, type BestAvailableResult, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAudience, type SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCategoryPrice, type SeasonCheckoutHandoff, type SeasonCheckoutMode, type SeasonCheckoutRequest, type SeasonCheckoutSession, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, type SeasonPackagePrices, SeasonPicker, type SeasonPickerOptions, type SeasonPrices, type SeasonPublicRefusalReason, type SeasonPublicSession, SeasonPublicSessionRefused, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPrewarmOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, prewarmSeatPicker, shortOperationReference, ticketOfferPrices };
+export { ApiError, type AttachPickerFrameOptions, type AttendeeFieldMode, type BestAvailableResult, type BookingForm, type BookingFormFieldError, type BookingQuestion, type BookingQuestionType, BuyerAccessContext, type BuyerAccessExpiredEvent, type BuyerAccessRefreshReason, type BuyerAccessToken, type BuyerAccessTokenProvider, BuyerAccessUnavailableError, type BuyerAccessUnavailableEvent, type BuyerAccessUnavailableReason, BuyerRealtimeClient, type BuyerRealtimeOptions, type CheckoutAnswer, type CheckoutAttendee, type CheckoutHandoff, type CheckoutLineItem, type CheckoutSessionResult, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type GAPromptRequest, type GaPromptTier, type HoldConflict, type HoldLineItem, type HoldResult, type OrderStatusResult, type PaymentOptionsReason, type PaymentOptionsResult, type PaymentProviderName, type PerformanceGroupAvailability, type PerformanceGroupCheckoutHandoff, type PerformanceGroupDescriptor, PerformanceGroupDestroyedError, type PerformanceGroupHold, type PerformanceGroupHoldAllocation, type PerformanceGroupOperationEvent, type PerformanceGroupOperationState, PerformanceGroupPicker, type PerformanceGroupPickerOptions, type PerformanceGroupRecoveryState, type PerformanceGroupSeatAllocation, type PerformanceGroupSelectionMode, type PerformanceGroupStatusEvent, type Projection, type PubApiOptions, type RealtimeSink, type ResumedHoldResult, SEATING_CHART_CALLBACK_PROPS, SEATING_CHART_HANDLE_METHODS, SEATING_CHART_IDENTITY_PROPS, SEATING_CHART_VALUE_PROPS, type SaleState, SeasonApiError, type SeasonAudience, type SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCategoryPrice, type SeasonCheckoutHandoff, type SeasonCheckoutMode, type SeasonCheckoutRequest, type SeasonCheckoutSession, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, type SeasonPackagePrices, SeasonPicker, type SeasonPickerOptions, type SeasonPrices, type SeasonPublicRefusalReason, type SeasonPublicSession, SeasonPublicSessionRefused, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPrewarmOptions, type SeatPickerPricing, type SeatPickerTheme, type SeatPickerWebMcpOptions, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartSeatViewInfo, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, ThemeMode, type TicketKeyDetail, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, prewarmSeatPicker, shortOperationReference, ticketOfferPrices };