@seatlayer/js 0.89.1 → 0.90.0

package/dist/index.d.cts

@@ -605,8 +605,15 @@ declare class ApiError extends Error {
     notice?: string;
     /** `422 booking_form_incomplete`: the fields the server refused, for inline errors. */
     fields?: BookingFormFieldError[];
+    /**
+     * The server's own statement that sending the identical request again is
+     * safe (`retryable: true` in the error body), for example a checkout that met
+     * contention. Absent when the server said nothing; never inferred here.
+     */
+    retryable?: boolean;
     constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string, details?: {
         fields?: BookingFormFieldError[];
+        retryable?: boolean;
     });
 }
 interface HoldResult {
@@ -1193,8 +1200,17 @@ interface SeatPickerOptions {
      * sections as soon as the chart lands and fills the seats in a section at a
      * time, nearest the viewport first; 'plain' builds the whole scene in one
      * step. Small charts are built in one step either way.
+     *
+     * 'viewport' is an opt-in mode for very large charts. It keeps the section
+     * overview light and builds seat graphics only for the visible or focused
+     * sections, retaining a bounded warm cache as the buyer moves. It applies to
+     * sectioned flat charts and is never selected automatically: the widget uses
+     * it only when this option is set to 'viewport'. Seat availability, search
+     * and selection still cover every seat. Because every seat is never built at
+     * once in this mode, `onSeatsRevealed` and the `chart_seats_revealed`
+     * analytics event do not fire.
      */
-    loadingReveal?: 'progressive' | 'plain';
+    loadingReveal?: 'progressive' | 'plain' | 'viewport';
     /** Initial map projection. Buyers now toggle **Map (flat 2D) + 3D** only; the
      * legacy `perspective` (2.5D) value is still ACCEPTED for source compatibility
      * but is deprecated — it is coerced to `flat` with a one-time console warning.
@@ -1259,7 +1275,9 @@ interface SeatPickerOptions {
      * rest arrive in idle slices. A host that needs "the whole venue is on
      * screen" waits for this rather than for `render()`. Fires exactly once per
      * chart, and never for a chart small enough to build in one step (there is
-     * nothing to wait for: `render()` already was that moment).
+     * nothing to wait for: `render()` already was that moment). It also never
+     * fires with `loadingReveal: 'viewport'`, where only the seats around the
+     * current view are built.
      */
     onSeatsRevealed?: () => void;
     /**
@@ -3991,6 +4009,10 @@ declare class SeatPicker implements GaPromptPicker {
     /** Elapsed since `render()` resolved, or undefined when it never did. */
     private sinceRenderResolved;
     /** @internal */ whenSeatsRevealed(run: () => void): void;
+    /** True only when the host opted into `loadingReveal: 'viewport'`. */
+    private viewportLoading;
+    /** Run queued seat work once, in order, each step fenced from the next. */
+    private drainSeatsRevealedWaiters;
     /** Keep returning buyers behind the veil until their hold is authoritative. */
     private restoreHoldForFirstPaint;
     /** Resume a redirect checkout from this tab's storage, never from the URL. */
@@ -5431,7 +5453,17 @@ interface SeasonRenewalIntent {
 declare class SeasonApiError extends Error {
     readonly code: string;
     readonly status: number;
-    constructor(code: string, status: number);
+    /** Seconds from a 503's `Retry-After`, when the server sent one. */
+    readonly retryAfterS?: number;
+    /** The server's `retryable` flag from the error body, when present. */
+    readonly retryable?: boolean;
+    /** The error body's `reason` (for example `maintenance_mode`), when present. */
+    readonly reason?: string;
+    constructor(code: string, status: number, details?: {
+        retryAfterS?: number;
+        retryable?: boolean;
+        reason?: string;
+    });
 }
 declare class SeasonRecoveryTimeoutError extends Error {
     readonly operationId: string;

package/dist/index.d.ts

@@ -605,8 +605,15 @@ declare class ApiError extends Error {
     notice?: string;
     /** `422 booking_form_incomplete`: the fields the server refused, for inline errors. */
     fields?: BookingFormFieldError[];
+    /**
+     * The server's own statement that sending the identical request again is
+     * safe (`retryable: true` in the error body), for example a checkout that met
+     * contention. Absent when the server said nothing; never inferred here.
+     */
+    retryable?: boolean;
     constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string, details?: {
         fields?: BookingFormFieldError[];
+        retryable?: boolean;
     });
 }
 interface HoldResult {
@@ -1193,8 +1200,17 @@ interface SeatPickerOptions {
      * sections as soon as the chart lands and fills the seats in a section at a
      * time, nearest the viewport first; 'plain' builds the whole scene in one
      * step. Small charts are built in one step either way.
+     *
+     * 'viewport' is an opt-in mode for very large charts. It keeps the section
+     * overview light and builds seat graphics only for the visible or focused
+     * sections, retaining a bounded warm cache as the buyer moves. It applies to
+     * sectioned flat charts and is never selected automatically: the widget uses
+     * it only when this option is set to 'viewport'. Seat availability, search
+     * and selection still cover every seat. Because every seat is never built at
+     * once in this mode, `onSeatsRevealed` and the `chart_seats_revealed`
+     * analytics event do not fire.
      */
-    loadingReveal?: 'progressive' | 'plain';
+    loadingReveal?: 'progressive' | 'plain' | 'viewport';
     /** Initial map projection. Buyers now toggle **Map (flat 2D) + 3D** only; the
      * legacy `perspective` (2.5D) value is still ACCEPTED for source compatibility
      * but is deprecated — it is coerced to `flat` with a one-time console warning.
@@ -1259,7 +1275,9 @@ interface SeatPickerOptions {
      * rest arrive in idle slices. A host that needs "the whole venue is on
      * screen" waits for this rather than for `render()`. Fires exactly once per
      * chart, and never for a chart small enough to build in one step (there is
-     * nothing to wait for: `render()` already was that moment).
+     * nothing to wait for: `render()` already was that moment). It also never
+     * fires with `loadingReveal: 'viewport'`, where only the seats around the
+     * current view are built.
      */
     onSeatsRevealed?: () => void;
     /**
@@ -3991,6 +4009,10 @@ declare class SeatPicker implements GaPromptPicker {
     /** Elapsed since `render()` resolved, or undefined when it never did. */
     private sinceRenderResolved;
     /** @internal */ whenSeatsRevealed(run: () => void): void;
+    /** True only when the host opted into `loadingReveal: 'viewport'`. */
+    private viewportLoading;
+    /** Run queued seat work once, in order, each step fenced from the next. */
+    private drainSeatsRevealedWaiters;
     /** Keep returning buyers behind the veil until their hold is authoritative. */
     private restoreHoldForFirstPaint;
     /** Resume a redirect checkout from this tab's storage, never from the URL. */
@@ -5431,7 +5453,17 @@ interface SeasonRenewalIntent {
 declare class SeasonApiError extends Error {
     readonly code: string;
     readonly status: number;
-    constructor(code: string, status: number);
+    /** Seconds from a 503's `Retry-After`, when the server sent one. */
+    readonly retryAfterS?: number;
+    /** The server's `retryable` flag from the error body, when present. */
+    readonly retryable?: boolean;
+    /** The error body's `reason` (for example `maintenance_mode`), when present. */
+    readonly reason?: string;
+    constructor(code: string, status: number, details?: {
+        retryAfterS?: number;
+        retryable?: boolean;
+        reason?: string;
+    });
 }
 declare class SeasonRecoveryTimeoutError extends Error {
     readonly operationId: string;