@seatlayer/js 0.72.1 → 0.74.0

package/dist/index.d.cts

@@ -249,7 +249,8 @@ declare function createBuyerAccessContext(options: {
  *  - compact `{default, exceptions}` snapshot reconstruction;
  *  - `sv.<n>` resume, handling BOTH outcomes (a `resumed` delta or a full
  *    snapshot) on every reconnect;
- *  - close code 4401 as a typed access-revoked state, never a reconnect loop;
+ *  - close code 4401 distinguishes an expired session (refresh/reconnect) from
+ *    a genuinely revoked one (typed terminal state, never a reconnect loop);
  *  - liveness by ping/pong only. Silence is normal and carries no information
  *    (protocol doc §5) — a quiet socket is never treated as a dead one.
  */
@@ -306,7 +307,7 @@ interface BuyerRealtimeOptions {
     /** Mint a one-use ticket for THIS connection attempt. Returns null for the
      *  anonymous public case (no ticket needed). Throwing stops the client. */
     mintTicket?: () => Promise<SubscribeTicket | null>;
-    /** Typed access states. 4401 arrives here as `revoked`. */
+    /** Typed terminal access states. A 4401 `access_expired` close reconnects. */
     onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
     /** Test seam. Defaults to the global WebSocket. */
     socketFactory?: (url: string, protocols: string[]) => WebSocket;
@@ -1375,11 +1376,20 @@ interface SeatingChartPickerState {
         /** How the stacked view marks each level. */
         floorLabelStyle: FloorLabelStyle;
         rung: LodRung;
+        /** True only when one semantic zoom-out step can reveal more of the venue. */
+        canZoomOut: boolean;
         focusedSectionId: string | null;
         focusedSection: SectionSummary | null;
         viewMode: RendererViewMode;
         buyerView: SeatingChartBuyerView;
         view3dTargetSeatId: string | null;
+        /** Buyer-display identity for the current 3D camera target, selected or not. */
+        view3dTargetSeat: SelectedSeat | null;
+        /** Same-row neighbours in authored seat order, matching the web 3D stepper. */
+        view3dPreviousSeatId: string | null;
+        view3dNextSeatId: string | null;
+        /** Section framed by the 3D scene; separate from the 2D map focus. */
+        view3dFocusedSectionId: string | null;
         view3dNavigationMode: SeatingChartNavigationMode;
         colorblindSafe: boolean;
         /** Chrome the HOST draws over the map, in CSS px, echoed back so a native
@@ -1688,6 +1698,8 @@ declare class SeatingChart {
     private focusedSection_;
     /** Last rung already exposed to native chrome; raw camera frames stay in-canvas. */
     private lastReportedViewRung_;
+    /** Last semantic step-out state exposed to native chrome. */
+    private lastReportedCanZoomOut_;
     private accessState_;
     private tipEl;
     private tipPos;
@@ -1703,7 +1715,7 @@ declare class SeatingChart {
     /**
      * Camera x/y/scale is renderer-local and deliberately absent from the native
      * picker snapshot. Keep pan and pinch frames on the canvas; only a semantic
-     * rung transition needs to wake native chrome.
+     * rung or step-out transition needs to wake native chrome.
      */
     private handleViewChange;
     /** Record the current rung before publishing an explicit state mutation. */
@@ -3478,6 +3490,8 @@ declare class SeatPicker implements GaPromptPicker {
     /** Remove one server-held ticket while keeping the rest of the hold active. */
     removeHeldTicket(label: string): Promise<boolean>;
     bestAvailable(qty: number, categoryKey?: string, opts?: SeatPickerBestAvailableOptions): Promise<HoldResult | null>;
+    /** @internal Exact, throwing variant for composed SDK surfaces. */
+    bestAvailableOrThrow(qty: number, categoryKey?: string, opts?: SeatPickerBestAvailableOptions): Promise<HoldResult | null>;
     release(): Promise<void>;
     /**
      * Realtime for an access-scoped picker.
@@ -3915,7 +3929,7 @@ declare class PerformanceGroupPicker {
     private checkout;
 }
 
-type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
+type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'expire_pending' | 'booking_pending' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
 interface SeasonDescriptor {
     key: string;
     name: string;
@@ -3992,7 +4006,7 @@ declare class SeasonRecoveryTimeoutError extends Error {
 }
 
 interface SeasonStatusEvent {
-    kind: 'loading' | 'ready' | 'pending' | 'held' | 'released' | 'renewal_intent' | 'partial_terminal' | 'failed';
+    kind: 'loading' | 'ready' | 'pending' | 'held' | 'booked' | 'released' | 'renewal_intent' | 'partial_terminal' | 'failed';
     message: string;
     operationId?: string;
 }
@@ -4006,6 +4020,14 @@ interface SeasonOfferPresentation {
     benefits?: readonly string[];
     renewalLabel?: string;
 }
+interface SeasonBestAvailableOptions {
+    categoryKey?: string;
+    zoneId?: string;
+    /** Any-of accommodation filter, evaluated across every Event in the Plan. */
+    accessibility?: readonly AccessibilityType[];
+    /** Refuse scattered fallback when no contiguous block of `qty` exists. */
+    requireContiguous?: boolean;
+}
 interface SeasonPickerOptions {
     container: string | HTMLElement;
     season: string;
@@ -4055,6 +4077,7 @@ declare class SeasonPicker {
     constructor(options: SeasonPickerOptions);
     render(): Promise<this>;
     holdSameSeat(labels: readonly string[], operationId: string): Promise<SeasonCheckoutHandoff>;
+    holdBestAvailable(qty: number, operationId: string, options?: SeasonBestAvailableOptions): Promise<SeasonCheckoutHandoff>;
     restoreOperation(operationId: string): Promise<SeasonCheckoutHandoff | null>;
     release(releaseActionId: string): Promise<void>;
     createRenewalIntent(offerId: string): Promise<SeasonRenewalIntent>;
@@ -4103,4 +4126,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 SeasonAvailability, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, 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, shortOperationReference, ticketOfferPrices };
+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 SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, 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, shortOperationReference, ticketOfferPrices };

package/dist/index.d.ts

@@ -249,7 +249,8 @@ declare function createBuyerAccessContext(options: {
  *  - compact `{default, exceptions}` snapshot reconstruction;
  *  - `sv.<n>` resume, handling BOTH outcomes (a `resumed` delta or a full
  *    snapshot) on every reconnect;
- *  - close code 4401 as a typed access-revoked state, never a reconnect loop;
+ *  - close code 4401 distinguishes an expired session (refresh/reconnect) from
+ *    a genuinely revoked one (typed terminal state, never a reconnect loop);
  *  - liveness by ping/pong only. Silence is normal and carries no information
  *    (protocol doc §5) — a quiet socket is never treated as a dead one.
  */
@@ -306,7 +307,7 @@ interface BuyerRealtimeOptions {
     /** Mint a one-use ticket for THIS connection attempt. Returns null for the
      *  anonymous public case (no ticket needed). Throwing stops the client. */
     mintTicket?: () => Promise<SubscribeTicket | null>;
-    /** Typed access states. 4401 arrives here as `revoked`. */
+    /** Typed terminal access states. A 4401 `access_expired` close reconnects. */
     onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
     /** Test seam. Defaults to the global WebSocket. */
     socketFactory?: (url: string, protocols: string[]) => WebSocket;
@@ -1375,11 +1376,20 @@ interface SeatingChartPickerState {
         /** How the stacked view marks each level. */
         floorLabelStyle: FloorLabelStyle;
         rung: LodRung;
+        /** True only when one semantic zoom-out step can reveal more of the venue. */
+        canZoomOut: boolean;
         focusedSectionId: string | null;
         focusedSection: SectionSummary | null;
         viewMode: RendererViewMode;
         buyerView: SeatingChartBuyerView;
         view3dTargetSeatId: string | null;
+        /** Buyer-display identity for the current 3D camera target, selected or not. */
+        view3dTargetSeat: SelectedSeat | null;
+        /** Same-row neighbours in authored seat order, matching the web 3D stepper. */
+        view3dPreviousSeatId: string | null;
+        view3dNextSeatId: string | null;
+        /** Section framed by the 3D scene; separate from the 2D map focus. */
+        view3dFocusedSectionId: string | null;
         view3dNavigationMode: SeatingChartNavigationMode;
         colorblindSafe: boolean;
         /** Chrome the HOST draws over the map, in CSS px, echoed back so a native
@@ -1688,6 +1698,8 @@ declare class SeatingChart {
     private focusedSection_;
     /** Last rung already exposed to native chrome; raw camera frames stay in-canvas. */
     private lastReportedViewRung_;
+    /** Last semantic step-out state exposed to native chrome. */
+    private lastReportedCanZoomOut_;
     private accessState_;
     private tipEl;
     private tipPos;
@@ -1703,7 +1715,7 @@ declare class SeatingChart {
     /**
      * Camera x/y/scale is renderer-local and deliberately absent from the native
      * picker snapshot. Keep pan and pinch frames on the canvas; only a semantic
-     * rung transition needs to wake native chrome.
+     * rung or step-out transition needs to wake native chrome.
      */
     private handleViewChange;
     /** Record the current rung before publishing an explicit state mutation. */
@@ -3478,6 +3490,8 @@ declare class SeatPicker implements GaPromptPicker {
     /** Remove one server-held ticket while keeping the rest of the hold active. */
     removeHeldTicket(label: string): Promise<boolean>;
     bestAvailable(qty: number, categoryKey?: string, opts?: SeatPickerBestAvailableOptions): Promise<HoldResult | null>;
+    /** @internal Exact, throwing variant for composed SDK surfaces. */
+    bestAvailableOrThrow(qty: number, categoryKey?: string, opts?: SeatPickerBestAvailableOptions): Promise<HoldResult | null>;
     release(): Promise<void>;
     /**
      * Realtime for an access-scoped picker.
@@ -3915,7 +3929,7 @@ declare class PerformanceGroupPicker {
     private checkout;
 }
 
-type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
+type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'expire_pending' | 'booking_pending' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
 interface SeasonDescriptor {
     key: string;
     name: string;
@@ -3992,7 +4006,7 @@ declare class SeasonRecoveryTimeoutError extends Error {
 }
 
 interface SeasonStatusEvent {
-    kind: 'loading' | 'ready' | 'pending' | 'held' | 'released' | 'renewal_intent' | 'partial_terminal' | 'failed';
+    kind: 'loading' | 'ready' | 'pending' | 'held' | 'booked' | 'released' | 'renewal_intent' | 'partial_terminal' | 'failed';
     message: string;
     operationId?: string;
 }
@@ -4006,6 +4020,14 @@ interface SeasonOfferPresentation {
     benefits?: readonly string[];
     renewalLabel?: string;
 }
+interface SeasonBestAvailableOptions {
+    categoryKey?: string;
+    zoneId?: string;
+    /** Any-of accommodation filter, evaluated across every Event in the Plan. */
+    accessibility?: readonly AccessibilityType[];
+    /** Refuse scattered fallback when no contiguous block of `qty` exists. */
+    requireContiguous?: boolean;
+}
 interface SeasonPickerOptions {
     container: string | HTMLElement;
     season: string;
@@ -4055,6 +4077,7 @@ declare class SeasonPicker {
     constructor(options: SeasonPickerOptions);
     render(): Promise<this>;
     holdSameSeat(labels: readonly string[], operationId: string): Promise<SeasonCheckoutHandoff>;
+    holdBestAvailable(qty: number, operationId: string, options?: SeasonBestAvailableOptions): Promise<SeasonCheckoutHandoff>;
     restoreOperation(operationId: string): Promise<SeasonCheckoutHandoff | null>;
     release(releaseActionId: string): Promise<void>;
     createRenewalIntent(offerId: string): Promise<SeasonRenewalIntent>;
@@ -4103,4 +4126,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 SeasonAvailability, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, 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, shortOperationReference, ticketOfferPrices };
+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 SeasonAvailability, type SeasonBestAvailableOptions, type SeasonCheckoutHandoff, type SeasonDescriptor, type SeasonOfferPresentation, type SeasonOperation, type SeasonOperationState, SeasonPicker, type SeasonPickerOptions, SeasonRecoveryTimeoutError, type SeasonRenewalIntent, type SeasonStatusEvent, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, 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, shortOperationReference, ticketOfferPrices };