@seatlayer/js 0.67.14 → 0.68.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PickerSeat, PickerGAArea, PickerSelectionValidator, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, PickerMapTheme, PickerTransport } from '@seatlayer/core';
+import { PickerSeat, PickerGAArea, PickerSelectionValidator, PickerMapTheme, RendererViewMode, SeatHoverDetails, PickerSelectionValidity, SectionSummary, ChartTheme, LodRung, PickerTransport } from '@seatlayer/core';
 export { ExpandedSeat, PickerMapTheme, PickerSelectionValidator, PickerSelectionValidity, PickerSelectionViolation, RendererViewMode, SeatHoverDetails } from '@seatlayer/core';
 export { A as AccessIntentForbidsDetails, a as AccessLinkRecord, b as AccessLinkReveal, c as AccessLinkState, d as AccessLinkStatus, e as AccessLinkStatusRecord, f as ArchiveBlockedDetails, g as AssignmentBuckets, h as AssignmentDropDetails, i as AssignmentResult, B as BucketRow, C as ChannelAccessIntent, j as ChannelAccessSummary, k as ChannelAllocationPage, l as ChannelAttribution, m as ChannelAuditEntry, n as ChannelAuditPage, o as ChannelCounts, p as ChannelListResult, q as ChannelPreviewProjection, r as ChannelRecord, s as ChannelReport, t as ChannelReportLinkRecord, u as ChannelReportLinkReveal, v as ChannelReportResult, w as ChannelReportRow, x as ChannelSeatStatus, y as ChannelState, z as ChannelsCapabilities, D as ChannelsClient, E as ChannelsMode, F as ChannelsModeHost, G as ChannelsRowView, H as ChannelsSeatView, I as ControlRoomActivityEntry, J as ControlRoomSectionMetric, K as ControlRoomSnapshot, L as EventCategoryAssignmentResult, M as EventScopedManageToken, N as EventTableBookingMode, O as EventTableBookingResult, P as IntentSwitchBlockedDetails, Q as InventoryBooking, R as InventoryBookingActivity, S as InventoryBookingDetail, T as InventoryBookingObject, U as InventoryBookingState, V as InventoryBookingsPage, W as InventoryBookingsQuery, X as LogEntry, Y as LogPage, Z as ManageApi, _ as ManageApiError, $ as ReportByStatus, a0 as ReportCategoryMeta, a1 as ReportCategoryRow, a2 as ReportResult, a3 as SeatManager, a4 as SeatManagerActionResult, a5 as SeatManagerActivity, a6 as SeatManagerCapability, a7 as SeatManagerConnection, a8 as SeatManagerFilteredSection, a9 as SeatManagerMode, aa as SeatManagerOptions, ab as SeatManagerSelectionValidity, ac as SeatManagerTallies, ad as SelectionSourceRow } from './channelsMode-2z9HBOAX.cjs';
 
@@ -76,6 +76,8 @@ type BuyerAccessUnavailableReason =
  | 'group_mismatch'
 /** 403 `buyer_access_mode_mismatch` (test bearer on a live event or v.v.). */
  | 'mode_mismatch'
+/** 403 `buyer_access_environment_mismatch` (session belongs to another environment). */
+ | 'environment_mismatch'
 /** 403 `channel_access_denied`. */
  | 'channel_denied'
 /** 422 `invalid_channel_scope` — an integration configuration error. */
@@ -642,6 +644,101 @@ interface GAAreaAvailability {
         price: number;
     }>;
 }
+/**
+ * Serializable state exposed to hosted native picker chrome. It deliberately
+ * contains buyer-display data only: never API keys, buyer-access bearers,
+ * provider callbacks, or the active hold id.
+ */
+interface SeatingChartPickerState {
+    event: {
+        key: string;
+        name: string;
+        venue: string | null;
+        startsAt: number | null;
+        timezone: string | null;
+        currency: string;
+        locale: string | null;
+        posterUrl: string | null;
+        mode: 'live' | 'test';
+        salesClosed: boolean;
+    };
+    branding: {
+        accent?: ChartTheme['accent'];
+        accentInk?: ChartTheme['accentInk'];
+        background?: ChartTheme['background'];
+        textColor?: ChartTheme['textColor'];
+        brandName?: ChartTheme['brandName'];
+        logoUrl?: ChartTheme['logoUrl'];
+        /** Native must render SeatLayer attribution when it owns chrome and this is true. */
+        attributionRequired: boolean;
+    };
+    features: {
+        ga: boolean;
+        tiers: boolean;
+        floors: boolean;
+        zones: boolean;
+        sections: boolean;
+        bestAvailable: boolean;
+        accessibilityFilter: boolean;
+        limitedViewFilter: boolean;
+    };
+    catalog: {
+        categories: Array<{
+            key: string;
+            label: string;
+            color: string;
+            price: number;
+            available: number;
+            tiers: Array<{
+                id: string;
+                name: string;
+                price: number;
+                currency?: string;
+            }>;
+        }>;
+        zones: Array<{
+            id: string;
+            label: string;
+            color?: string;
+        }>;
+        sections: Array<{
+            id: string;
+            label: string;
+            displayLabel?: string;
+            zoneId?: string;
+        }>;
+        gaAreas: GAAreaAvailability[];
+        bestAvailableZones: Array<{
+            id: string;
+            label: string;
+        }>;
+    };
+    map: {
+        floors: Array<{
+            id: string;
+            name: string;
+        }>;
+        activeFloorId: string | null;
+        rung: LodRung;
+        focusedSectionId: string | null;
+        focusedSection: SectionSummary | null;
+        viewMode: RendererViewMode;
+        colorblindSafe: boolean;
+        categoryFilter: string[] | null;
+        accessibilityFilter: string[] | null;
+        hideLimitedView: boolean;
+    };
+    selection: {
+        seats: SelectedSeat[];
+        validity: PickerSelectionValidity | null;
+        maxSelection: number;
+    };
+    access: {
+        configured: boolean;
+        status: 'public' | 'ready' | 'expired' | 'unavailable';
+        reason?: string;
+    };
+}
 interface SeatingChartOptions {
     /** CSS selector or an HTMLElement to render into. */
     container: string | HTMLElement;
@@ -649,9 +746,11 @@ interface SeatingChartOptions {
     event: string;
     /** API origin. Defaults to https://api.seatlayer.io. */
     apiBase?: string;
-    /** Reserved for future authenticated rendering — accepted + stored, not yet sent.
-     *  NOT the channel-access credential: a buyer access session is a different
-     *  thing with different authority, and uses the two options below. */
+    /**
+     * Publishable account key for direct Public-sale bootstrap of a Platform/SDK
+     * Event. It is never buyer identity and cannot request private inventory.
+     * An explicit buyer-access provider/token below always takes precedence.
+     */
     publicKey?: string;
     /**
      * Buyer access session provider — the recommended way to render private
@@ -714,6 +813,8 @@ interface SeatingChartOptions {
      * Toggleable later with setColorblindSafe().
      */
     colorblindSafe?: boolean;
+    /** Host-authoritative colors for the drawn canvas, separate from native chrome. */
+    mapTheme?: PickerMapTheme;
     /** Initial canvas projection.
      * @deprecated `'isometric'` and `'perspective'` are retired in favour of the
      * real 3D venue view (`setBuyerView('venue3d')`); they remain accepted for
@@ -725,6 +826,10 @@ interface SeatingChartOptions {
      * to draw your own popover from onSeatHover.
      */
     seatTooltip?: boolean;
+    /** Internal hosted-runtime control. Defaults true for direct web embeds. */
+    showTestModeIndicator?: boolean;
+    /** Internal hosted-runtime control. Defaults true, subject to white-label entitlement. */
+    showAttribution?: boolean;
     /**
      * Seat hover with everything a popover needs (category label/color, resolved
      * tier-aware price, live status, currency); null on hover-out. Fires whether
@@ -793,6 +898,16 @@ interface SeatingChartOptions {
      * its own floor UI (tabs, labels) with the map.
      */
     onDeckTap?: (floorId: string) => void;
+    /** Big-venue section focus state for host-owned navigation chrome. */
+    onSectionFocus?: (summary: SectionSummary | null) => void;
+    /** Availability changed after a live frame or explicit refresh. */
+    onStatusChange?: () => void;
+    /** The server closed sales for this event. */
+    onSalesClosed?: () => void;
+    /** A programmatic/native map-control action changed serializable map state. */
+    onMapStateChange?: () => void;
+    /** Pan/zoom/resize settled; useful for host overlays and native map controls. */
+    onViewChange?: () => void;
     /**
      * Non-blocking, localized selection advice — currently the orphan-seat hint
      * (the selection would strand a single free seat between taken neighbors).
@@ -803,7 +918,7 @@ interface SeatingChartOptions {
 declare class SeatingChart {
     private readonly opts;
     private readonly controller;
-    /** Reserved for future authenticated rendering — stored, not yet sent on any request. */
+    /** Publishable key used only by the public-only direct bootstrap path. */
     readonly publicKey?: string;
     private mount;
     private hostEl;
@@ -811,6 +926,14 @@ declare class SeatingChart {
     private eventLocale;
     private rendered;
     private mode_;
+    private eventInfo;
+    private maxSelection_;
+    private colorblindSafe_;
+    private categoryFilter_;
+    private accessibilityFilter_;
+    private hideLimitedView_;
+    private focusedSection_;
+    private accessState_;
     private tipEl;
     private tipPos;
     private onTipMove;
@@ -869,6 +992,22 @@ declare class SeatingChart {
      */
     setLocale(next: string | null | undefined): Promise<string>;
     getMode(): 'live' | 'test' | null;
+    /** Atomic, token-free display state for native-owned picker chrome. */
+    getPickerState(): SeatingChartPickerState;
+    getCategoryAvailability(): Record<string, number>;
+    getBestAvailableZones(): Array<{
+        id: string;
+        label: string;
+    }>;
+    getActiveFloorId(): string | null;
+    getRung(): LodRung;
+    getFocusedSection(): string | null;
+    focusSection(sectionId: string): void;
+    overview(): void;
+    setRung(rung: LodRung): void;
+    setCategoryFilter(categoryKeys: string[] | null, focus?: boolean): void;
+    setAccessibilityFilter(types: string[] | null): void;
+    setCommercialLimitedFilter(on: boolean): void;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
     /** Select free objects by engine id or public label. Returns newly selected objects. */
@@ -951,6 +1090,15 @@ declare class SeatingChart {
      * reverts to the default tier.
      */
     setSeatTier(seatId: string, tierId: string | null): void;
+    /** Confirm/update an unheld variable table's guest quantity locally. */
+    setTableQuantity(label: string, quantity: number): boolean;
+    /**
+     * Atomically replace an active variable-table hold with a new guest count.
+     * Returns null for an inapplicable/invalid quantity or a refused replacement.
+     */
+    replaceTableQuantity(label: string, quantity: number, ttlMs?: number): Promise<HoldResult | null>;
+    /** @internal Throwing variant used by the correlated native bridge. */
+    replaceTableQuantityOrThrow(label: string, quantity: number, ttlMs?: number): Promise<HoldResult | null>;
     /**
      * Floors of a multi-floor chart — `[{ id, name }]` (single-floor charts
      * return one entry; empty before render()). Pair with setFloor() to build a
@@ -990,6 +1138,8 @@ declare class SeatingChart {
      * and its own legacy frames. Nothing about the public path changes.
      */
     private startRealtime;
+    /** Re-read live inventory without remounting or dropping buyer state. */
+    refreshAvailability(): Promise<void>;
     /**
      * Re-acquire the buyer access session — call after your app has re-authorized
      * the buyer (a revoked session cannot be recovered any other way). Resolves
@@ -1628,9 +1778,16 @@ interface SeatPickerOptions {
      * SeatLayer dashboard's own transport) or a fully local mock (demos).
      */
     transport?: PickerTransport;
-    /** Reserved for future authenticated rendering. NOT the channel-access
-     *  credential — a buyer access session is a different thing with different
-     *  authority, and uses the two options below. */
+    /**
+     * Publishable account key (`pk_live_…` / `pk_test_…`) for a public
+     * Platform/SDK Event. With no explicit buyer-access token/provider, the SDK
+     * uses it to bootstrap one origin-bound, Public-sale-only session directly
+     * from SeatLayer and receives chart + inventory in the same request.
+     *
+     * This is not buyer identity and cannot request private channels. An explicit
+     * `buyerAccessTokenProvider` or `buyerAccessToken` below always takes
+     * precedence for login, presale, partner or other scoped inventory.
+     */
     publicKey?: string;
     /**
      * Buyer access session provider — the recommended way to show private channel
@@ -3230,6 +3387,115 @@ declare class PerformanceGroupPicker {
     private checkout;
 }
 
+type SeasonOperationState = 'preparing' | 'commit_pending' | 'committed' | 'abort_pending' | 'aborted' | 'partial_terminal' | 'expired' | 'booked';
+interface SeasonDescriptor {
+    key: string;
+    name: string;
+    edition: string | null;
+    mode: 'live' | 'test';
+    currency: string;
+    venue: string;
+    timezone: string | null;
+    audience: 'private' | 'embed_only' | 'discoverable';
+    planActivationId: string;
+    occurrenceCount: number;
+    occurrences: Array<{
+        position: number;
+        eventKey: string;
+        name: string;
+        startsAt: number | null;
+    }>;
+}
+interface SeasonAvailability {
+    seats: Record<string, 'free' | 'blocked'>;
+    partial: Record<string, string[]>;
+    revision: string;
+    comparisons: number;
+    freeCount: number;
+    blockedCount: number;
+}
+interface SeasonOperation {
+    operationId: string;
+    seasonId: string;
+    kind: string;
+    holdId: string;
+    expiresAt: number;
+    policy: 'fixed_inclusion_same_seat';
+    state: SeasonOperationState;
+    bookingRef: string | null;
+    location: string;
+    retryAfterSeconds: number;
+    allocations: Array<{
+        eventId: string;
+        state: string;
+    }>;
+}
+interface SeasonCheckoutHandoff {
+    seasonKey: string;
+    planActivationId: string;
+    operationId: string;
+    holdId: string;
+    expiresAt: number;
+    policy: 'fixed_inclusion_same_seat';
+    state: SeasonOperationState;
+    allocations: Array<{
+        eventKey: string;
+        state: string;
+    }>;
+}
+interface SeasonRenewalIntent {
+    offerId: string;
+    state: 'intent_received';
+    intentId: string;
+    receivedAt: number;
+}
+declare class SeasonApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(code: string, status: number);
+}
+declare class SeasonRecoveryTimeoutError extends Error {
+    readonly operationId: string;
+    constructor(operationId: string);
+}
+
+interface SeasonStatusEvent {
+    kind: 'loading' | 'ready' | 'pending' | 'held' | 'released' | 'renewal_intent' | 'partial_terminal' | 'failed';
+    message: string;
+    operationId?: string;
+}
+interface SeasonPickerOptions {
+    container: string | HTMLElement;
+    season: string;
+    apiBase?: string;
+    buyerAccessTokenProvider?: BuyerAccessTokenProvider;
+    buyerAccessToken?: string | BuyerAccessToken;
+    initialOperationId?: string;
+    recoveryTimeoutMs?: number;
+    fetch?: typeof fetch;
+    onHold?: (handoff: SeasonCheckoutHandoff) => void;
+    onHoldChange?: (handoff: SeasonCheckoutHandoff | null) => void;
+    onContinue?: (handoff: SeasonCheckoutHandoff) => void;
+    onRenewalIntent?: (intent: SeasonRenewalIntent) => void;
+    onAccessExpired?: (event: BuyerAccessExpiredEvent) => void;
+    onAccessUnavailable?: (event: BuyerAccessUnavailableEvent) => void;
+    onStatusChange?: (event: SeasonStatusEvent) => void;
+    onError?: (error: unknown) => void;
+}
+declare class SeasonPicker {
+    #private;
+    constructor(options: SeasonPickerOptions);
+    render(): Promise<this>;
+    holdSameSeat(labels: readonly string[], operationId: string): Promise<SeasonCheckoutHandoff>;
+    restoreOperation(operationId: string): Promise<SeasonCheckoutHandoff | null>;
+    release(releaseActionId: string): Promise<void>;
+    createRenewalIntent(offerId: string): Promise<SeasonRenewalIntent>;
+    getDescriptor(): SeasonDescriptor | null;
+    getAvailability(): SeasonAvailability | null;
+    getHandoff(): SeasonCheckoutHandoff | null;
+    destroy(): void;
+}
+
 /**
  * Host-side helper for embedding the SeatLayer picker as an iframe.
  *
@@ -3269,4 +3535,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, SeatPicker, type SeatPickerBestAvailableOptions, type SeatPickerBuyerView, type SeatPickerBuyerViewOptions, type SeatPickerOptions, type SeatPickerPricing, type SeatPickerTheme, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, 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 SeasonCheckoutHandoff, type SeasonDescriptor, 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, SeatingChart, type SeatingChartCallbackProp, type SeatingChartCallbacks, type SeatingChartHandle, type SeatingChartHandleMethod, type SeatingChartIdentityProp, type SeatingChartOptions, type SeatingChartValueProp, type SeatingChartValues, type SelectedObjectUnavailableEvent, type SelectedSeat, type StatusChange, type SubscribeTicket, type TicketOfferAvailability, type TicketOfferPrice, type TicketOfferSummary, attachPickerFrame, bindSeatingChartHandle, buildSeatingChartOptions, createBuyerAccessContext, createControllerSink, parseTicketOfferAvailability, shortOperationReference, ticketOfferPrices };