@seatlayer/js 0.40.0 → 0.42.0

package/dist/index.d.cts

@@ -603,6 +603,21 @@ interface SeatingChartOptions {
      */
     onSelectedObjectUnavailable?: (event: SelectedObjectUnavailableEvent) => void;
     onError?: (err: unknown) => void;
+    /**
+     * What the BUYER sees when the chart cannot load.
+     *
+     * `'message'` (the default) renders a plain, styleable notice with a Try
+     * again button. This used to be silent unconditionally: `render()` returned
+     * with an EMPTY mounted div and only `onError` fired, so a host that had not
+     * wired `onError` — or had wired it to a logger — showed buyers a blank
+     * rectangle where the seat map belongs, on the host's own domain, which
+     * reads as a broken website rather than a temporary fault. `SeatPicker` has
+     * always failed loud with a retry; this is the embed class catching up.
+     *
+     * `'none'` restores the silent behaviour for hosts that render their own
+     * failure UI from `onError`.
+     */
+    errorDisplay?: 'message' | 'none';
     /**
      * Multi-floor charts only: fires when the buyer taps a deck in the stacked
      * 3D view, after the picker switches to that floor — lets the host page sync
@@ -624,6 +639,7 @@ declare class SeatingChart {
     private mount;
     private hostEl;
     private rendered;
+    private retryBtn;
     private mode_;
     private tipEl;
     private tipPos;
@@ -768,6 +784,13 @@ declare class SeatingChart {
      * true when a fresh bearer is held; the realtime feed restarts with it.
      */
     refreshAccess(): Promise<boolean>;
+    /**
+     * The visible failure state. Deliberately inline-styled and dependency-free:
+     * this renders on a stranger's website, where our stylesheet may not have
+     * loaded (the chart fetch just failed) and where inheriting the host's own
+     * styles is likelier to produce something unreadable than something on-brand.
+     */
+    private showLoadFailure;
     destroy(): void;
 }
 
@@ -1274,17 +1297,33 @@ interface SeatPickerOptions {
      * 1. It needs the widget's own transport. A host-supplied `transport` owns its
      *    credentials and its backend, so hosted checkout stays off there (with one
      *    console warning) rather than reaching past it to api.seatlayer.io.
-     * 2. WHERE A HOSTED GATEWAY RETURNS THE BUYER IS THE SERVER'S CHOICE. The
-     *    checkout session's return URL is built from the deployment's own allowed
-     *    origins, so a buyer paying by card from an embed on your domain comes back
-     *    to SeatLayer's buyer page and is confirmed THERE, not in this widget. The
-     *    widget resumes in place only when it is mounted on a page that actually
-     *    receives `?order=…&status=success` (a page on an allowed origin, and the
-     *    in-page gateways, which never navigate away at all). Until the server
-     *    accepts a caller-supplied return URL, treat a card payment from a
-     *    third-party embed as "the buyer finishes on our page".
+     * 2. WHERE A HOSTED GATEWAY RETURNS THE BUYER is settled by {@link returnUrl}
+     *    and by the organizer. Without one — or from an origin the organizer has
+     *    not declared — the buyer comes back to SeatLayer's own buyer page and is
+     *    confirmed THERE, not in this widget. Declare the embedding site under
+     *    Embed domains in the dashboard and pass `returnUrl`, and the buyer
+     *    returns to your page instead. In-page gateways never navigate away at
+     *    all, so they are unaffected either way.
      */
     checkout?: 'handoff' | 'hosted';
+    /**
+     * Where a redirecting gateway should send the buyer back to, for
+     * `checkout: 'hosted'`.
+     *
+     * The server keeps this URL verbatim — path and query included — and only
+     * stamps `?order=…&status=success|cancelled` onto it, so point it at
+     * whichever of YOUR pages should confirm the purchase (often just
+     * `window.location.href`). Mount a picker on that page and it resumes in
+     * place from those parameters.
+     *
+     * It is validated, not trusted: the organizer declares their embed origins
+     * in the dashboard, and an undeclared origin is ignored rather than
+     * refused — the sale still completes, the buyer just finishes on
+     * SeatLayer's page. Supplying a URL therefore cannot authorize it, which is
+     * what stops a copied snippet from redirecting a paid buyer anywhere it
+     * likes.
+     */
+    returnUrl?: string;
     /**
      * Buyer pressed the CTA and the hold succeeded — hand off to YOUR checkout.
      * `hold` and `seats` are the legacy args (unchanged since 0.6). `handoff` (P4)
@@ -3537,6 +3576,17 @@ declare class ChannelsMode {
     private stagedDoneTimer;
     private lastSelectionCount;
     private lastCounts;
+    /** The markup currently in the rail. An identical repaint is skipped, which is
+     *  what keeps the organizer's scroll position (and open <select>) alive. */
+    private railHtml;
+    /**
+     * The `assignmentVersion` the allocation map was built from. Walking every
+     * allocation page is the expensive half of a refresh and the server already
+     * tells us, in the channels response, whether ANY seat moved. Unchanged
+     * version, unchanged allocation — so the walk is skipped entirely.
+     */
+    private allocationVersion;
+    private onVisibility;
     constructor(host: ChannelsModeHost, capabilities: ChannelsCapabilities);
     /** Called when the cockpit switches into Channels mode. */
     enter(): void;
@@ -3612,6 +3662,22 @@ declare class ChannelsMode {
     /** Set by the cockpit so a view switch can re-arm canvas selection. */
     onInteractionChange?: () => void;
     private loadPreview;
+    /**
+     * Replace the rail's markup — but only when it actually differs, and never at
+     * the cost of where the organizer had scrolled to.
+     *
+     * The rail repaints on a clock, on every selection change and after every
+     * mutation. Rewriting `innerHTML` each time resets `scrollTop`, which is
+     * exactly what "the rail gets stuck" was: scroll down to Create channel, the
+     * poll ticks, and the list snaps back to the top under the cursor. So skip the
+     * write when the markup is byte-identical, and restore the offset when it is
+     * not.
+     *
+     * Returns whether the DOM was rewritten. Callers must only re-wire listeners
+     * when it was — a skipped paint keeps the old nodes AND their listeners, so
+     * re-wiring would double every handler.
+     */
+    private setRailHtml;
     paintRail(): void;
     private viewSegmentHtml;
     private mapNavigationHtml;
@@ -3620,6 +3686,24 @@ declare class ChannelsMode {
     private listRailHtml;
     private selectionRailHtml;
     private detailRailHtml;
+    /**
+     * "Distribute" — how the seats in this channel actually reach a buyer.
+     *
+     * This replaced a four-value "access intent" picker (none / internal /
+     * hosted_link / server). Two of those values did nothing anywhere: no buyer or
+     * inventory path reads `access_intent`, so `none` and `internal` were labels an
+     * organizer could set and then wait forever for something to happen. A third,
+     * `hosted_link`, is not the organizer's to choose at all — the server sets it
+     * when a buyer link is created and clears it when the last live one is revoked.
+     *
+     * So this is two ACTIONS, not a setting: create a buyer link, or point the
+     * channel at a website integration. Both of them do something the moment they
+     * are pressed. A legacy row still carrying `none` or `internal` renders the
+     * neutral "not distributed yet" state with both actions offered — the stored
+     * value is left alone (it is organizer-declared metadata and the API that
+     * writes it is unchanged), it simply no longer has a control of its own.
+     */
+    private distributeHtml;
     /**
      * Read the status projection for the open channel. Never paints — the caller
      * decides when the rail repaints, so a poll-driven reload does not fight a
@@ -3628,12 +3712,16 @@ declare class ChannelsMode {
      */
     private loadLinks;
     /**
-     * The hosted-link section of the detail panel.
+     * The buyer-link status section of the detail panel.
      *
      * STATUS ONLY, by design (comp 06 `hosted`): label, state, expiry,
      * redemptions, seats per buyer, live sessions. There is no Copy control here
      * and no field to hang one on — the URL was shown once at creation and cannot
      * be produced again. Rotation is the recovery path, and it says so.
+     *
+     * Creating a link is the Distribute card's action, not this section's, so a
+     * channel with no links renders nothing here rather than an empty heading and
+     * a second button saying the same thing.
      */
     private hostedLinksHtml;
     private linkCardHtml;
@@ -3667,6 +3755,14 @@ declare class ChannelsMode {
     private showApplied;
     private shakeStaged;
     private renderRenameDialog;
+    /**
+     * "Get embed code" — mark the channel as reached through the organizer's own
+     * backend. The write itself is `setChannelAccessIntent(…, 'server')`, the same
+     * API the old picker called; the difference is that it is now a deliberate
+     * action with a consequence the organizer is told about, rather than one of
+     * four dropdown values with no observable effect.
+     */
+    private chooseWebsiteIntegration;
     private setAccessIntent;
     private togglePause;
     private renderArchiveDialog;

package/dist/index.d.ts

@@ -603,6 +603,21 @@ interface SeatingChartOptions {
      */
     onSelectedObjectUnavailable?: (event: SelectedObjectUnavailableEvent) => void;
     onError?: (err: unknown) => void;
+    /**
+     * What the BUYER sees when the chart cannot load.
+     *
+     * `'message'` (the default) renders a plain, styleable notice with a Try
+     * again button. This used to be silent unconditionally: `render()` returned
+     * with an EMPTY mounted div and only `onError` fired, so a host that had not
+     * wired `onError` — or had wired it to a logger — showed buyers a blank
+     * rectangle where the seat map belongs, on the host's own domain, which
+     * reads as a broken website rather than a temporary fault. `SeatPicker` has
+     * always failed loud with a retry; this is the embed class catching up.
+     *
+     * `'none'` restores the silent behaviour for hosts that render their own
+     * failure UI from `onError`.
+     */
+    errorDisplay?: 'message' | 'none';
     /**
      * Multi-floor charts only: fires when the buyer taps a deck in the stacked
      * 3D view, after the picker switches to that floor — lets the host page sync
@@ -624,6 +639,7 @@ declare class SeatingChart {
     private mount;
     private hostEl;
     private rendered;
+    private retryBtn;
     private mode_;
     private tipEl;
     private tipPos;
@@ -768,6 +784,13 @@ declare class SeatingChart {
      * true when a fresh bearer is held; the realtime feed restarts with it.
      */
     refreshAccess(): Promise<boolean>;
+    /**
+     * The visible failure state. Deliberately inline-styled and dependency-free:
+     * this renders on a stranger's website, where our stylesheet may not have
+     * loaded (the chart fetch just failed) and where inheriting the host's own
+     * styles is likelier to produce something unreadable than something on-brand.
+     */
+    private showLoadFailure;
     destroy(): void;
 }
 
@@ -1274,17 +1297,33 @@ interface SeatPickerOptions {
      * 1. It needs the widget's own transport. A host-supplied `transport` owns its
      *    credentials and its backend, so hosted checkout stays off there (with one
      *    console warning) rather than reaching past it to api.seatlayer.io.
-     * 2. WHERE A HOSTED GATEWAY RETURNS THE BUYER IS THE SERVER'S CHOICE. The
-     *    checkout session's return URL is built from the deployment's own allowed
-     *    origins, so a buyer paying by card from an embed on your domain comes back
-     *    to SeatLayer's buyer page and is confirmed THERE, not in this widget. The
-     *    widget resumes in place only when it is mounted on a page that actually
-     *    receives `?order=…&status=success` (a page on an allowed origin, and the
-     *    in-page gateways, which never navigate away at all). Until the server
-     *    accepts a caller-supplied return URL, treat a card payment from a
-     *    third-party embed as "the buyer finishes on our page".
+     * 2. WHERE A HOSTED GATEWAY RETURNS THE BUYER is settled by {@link returnUrl}
+     *    and by the organizer. Without one — or from an origin the organizer has
+     *    not declared — the buyer comes back to SeatLayer's own buyer page and is
+     *    confirmed THERE, not in this widget. Declare the embedding site under
+     *    Embed domains in the dashboard and pass `returnUrl`, and the buyer
+     *    returns to your page instead. In-page gateways never navigate away at
+     *    all, so they are unaffected either way.
      */
     checkout?: 'handoff' | 'hosted';
+    /**
+     * Where a redirecting gateway should send the buyer back to, for
+     * `checkout: 'hosted'`.
+     *
+     * The server keeps this URL verbatim — path and query included — and only
+     * stamps `?order=…&status=success|cancelled` onto it, so point it at
+     * whichever of YOUR pages should confirm the purchase (often just
+     * `window.location.href`). Mount a picker on that page and it resumes in
+     * place from those parameters.
+     *
+     * It is validated, not trusted: the organizer declares their embed origins
+     * in the dashboard, and an undeclared origin is ignored rather than
+     * refused — the sale still completes, the buyer just finishes on
+     * SeatLayer's page. Supplying a URL therefore cannot authorize it, which is
+     * what stops a copied snippet from redirecting a paid buyer anywhere it
+     * likes.
+     */
+    returnUrl?: string;
     /**
      * Buyer pressed the CTA and the hold succeeded — hand off to YOUR checkout.
      * `hold` and `seats` are the legacy args (unchanged since 0.6). `handoff` (P4)
@@ -3537,6 +3576,17 @@ declare class ChannelsMode {
     private stagedDoneTimer;
     private lastSelectionCount;
     private lastCounts;
+    /** The markup currently in the rail. An identical repaint is skipped, which is
+     *  what keeps the organizer's scroll position (and open <select>) alive. */
+    private railHtml;
+    /**
+     * The `assignmentVersion` the allocation map was built from. Walking every
+     * allocation page is the expensive half of a refresh and the server already
+     * tells us, in the channels response, whether ANY seat moved. Unchanged
+     * version, unchanged allocation — so the walk is skipped entirely.
+     */
+    private allocationVersion;
+    private onVisibility;
     constructor(host: ChannelsModeHost, capabilities: ChannelsCapabilities);
     /** Called when the cockpit switches into Channels mode. */
     enter(): void;
@@ -3612,6 +3662,22 @@ declare class ChannelsMode {
     /** Set by the cockpit so a view switch can re-arm canvas selection. */
     onInteractionChange?: () => void;
     private loadPreview;
+    /**
+     * Replace the rail's markup — but only when it actually differs, and never at
+     * the cost of where the organizer had scrolled to.
+     *
+     * The rail repaints on a clock, on every selection change and after every
+     * mutation. Rewriting `innerHTML` each time resets `scrollTop`, which is
+     * exactly what "the rail gets stuck" was: scroll down to Create channel, the
+     * poll ticks, and the list snaps back to the top under the cursor. So skip the
+     * write when the markup is byte-identical, and restore the offset when it is
+     * not.
+     *
+     * Returns whether the DOM was rewritten. Callers must only re-wire listeners
+     * when it was — a skipped paint keeps the old nodes AND their listeners, so
+     * re-wiring would double every handler.
+     */
+    private setRailHtml;
     paintRail(): void;
     private viewSegmentHtml;
     private mapNavigationHtml;
@@ -3620,6 +3686,24 @@ declare class ChannelsMode {
     private listRailHtml;
     private selectionRailHtml;
     private detailRailHtml;
+    /**
+     * "Distribute" — how the seats in this channel actually reach a buyer.
+     *
+     * This replaced a four-value "access intent" picker (none / internal /
+     * hosted_link / server). Two of those values did nothing anywhere: no buyer or
+     * inventory path reads `access_intent`, so `none` and `internal` were labels an
+     * organizer could set and then wait forever for something to happen. A third,
+     * `hosted_link`, is not the organizer's to choose at all — the server sets it
+     * when a buyer link is created and clears it when the last live one is revoked.
+     *
+     * So this is two ACTIONS, not a setting: create a buyer link, or point the
+     * channel at a website integration. Both of them do something the moment they
+     * are pressed. A legacy row still carrying `none` or `internal` renders the
+     * neutral "not distributed yet" state with both actions offered — the stored
+     * value is left alone (it is organizer-declared metadata and the API that
+     * writes it is unchanged), it simply no longer has a control of its own.
+     */
+    private distributeHtml;
     /**
      * Read the status projection for the open channel. Never paints — the caller
      * decides when the rail repaints, so a poll-driven reload does not fight a
@@ -3628,12 +3712,16 @@ declare class ChannelsMode {
      */
     private loadLinks;
     /**
-     * The hosted-link section of the detail panel.
+     * The buyer-link status section of the detail panel.
      *
      * STATUS ONLY, by design (comp 06 `hosted`): label, state, expiry,
      * redemptions, seats per buyer, live sessions. There is no Copy control here
      * and no field to hang one on — the URL was shown once at creation and cannot
      * be produced again. Rotation is the recovery path, and it says so.
+     *
+     * Creating a link is the Distribute card's action, not this section's, so a
+     * channel with no links renders nothing here rather than an empty heading and
+     * a second button saying the same thing.
      */
     private hostedLinksHtml;
     private linkCardHtml;
@@ -3667,6 +3755,14 @@ declare class ChannelsMode {
     private showApplied;
     private shakeStaged;
     private renderRenameDialog;
+    /**
+     * "Get embed code" — mark the channel as reached through the organizer's own
+     * backend. The write itself is `setChannelAccessIntent(…, 'server')`, the same
+     * API the old picker called; the difference is that it is now a deliberate
+     * action with a consequence the organizer is told about, rather than one of
+     * four dropdown values with no observable effect.
+     */
+    private chooseWebsiteIntegration;
     private setAccessIntent;
     private togglePause;
     private renderArchiveDialog;