@seatlayer/js 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -622,6 +622,8 @@ interface ReportCategoryRow {
     held: number;
     booked: number;
     not_for_sale: number;
+    /** Exact sum of booked unit_price snapshots, in major currency units. */
+    bookedRevenue: number;
 }
 interface ReportCategoryMeta {
     key: string;
@@ -633,6 +635,7 @@ interface ReportResult {
     report: {
         byStatus: ReportByStatus;
         byCategory: ReportCategoryRow[];
+        bySection?: ControlRoomSectionMetric[];
     };
     event: {
         key: string;
@@ -642,6 +645,51 @@ interface ReportResult {
     };
     categories: ReportCategoryMeta[];
 }
+interface ControlRoomSectionMetric {
+    sectionId: string;
+    sectionLabel: string;
+    zoneId: string | null;
+    total: number;
+    free: number;
+    held: number;
+    booked: number;
+    not_for_sale: number;
+    bookedRevenue: number;
+}
+interface ControlRoomSnapshot {
+    version: number;
+    currency: string;
+    totals: {
+        free: number;
+        held: number;
+        booked: number;
+        blocked: number;
+    };
+    revenue: {
+        gross: number;
+        bySection: ControlRoomSectionMetric[];
+    };
+    velocity: {
+        windowMinutes: number;
+        bySection: Array<{
+            sectionId: string;
+            netBooked: number;
+            grossRevenue: number;
+            previousNetBooked: number;
+            trend: 'rising' | 'steady' | 'cooling';
+        }>;
+    };
+    presence: {
+        shoppingSessions: number;
+        activeHolds: number;
+    };
+    event: {
+        key: string;
+        name: string;
+        seatTotal: number;
+        currency?: string;
+    };
+}
 interface LogEntry {
     id: number;
     at: number;
@@ -719,6 +767,7 @@ declare class ManageApi {
         holdTtlMs: number | null;
     }>;
     report(key: string): Promise<ReportResult>;
+    controlRoom(key: string, windowMinutes?: number): Promise<ControlRoomSnapshot>;
     log(key: string, opts?: {
         limit?: number;
         before?: number;
@@ -734,22 +783,23 @@ declare class ManageApi {
  * Productizes the SeatLayer dashboard's ManageEventPage into a framework-
  * agnostic class (mirrors how SeatPicker productized the buyer flow). It mounts
  * the shared engine in `manageMode`, subscribes to the event's realtime channel
- * and drives two M1 modes on one canvas:
+ * and drives three control-room tools on one persistent canvas:
  *
  *   - **view**  — a live board: realtime seat repaint (flash on hold/book),
  *                 live KPI tallies + gross revenue, and a streaming activity
  *                 feed derived from the delta stream + audit log. Read-only.
+ *   - **inspect** — select one seat to read its live inventory context.
  *   - **block** — bulk-first block/unblock: marquee-drag, ⌘A select-all,
  *                 whole-category / whole-section select, single-seat fallback →
  *                 one batched block/unblock (optimistic, reconciled by the WS),
- *                 timed auto-release, and cancel-a-booking.
+ *                 and timed auto-release.
  *
  * Auth: reads (chart/objects/WS) are public; writes/reports carry a Bearer
  * event-scoped manage token (`mse_…`) or a tenant secret key (`sk_…`) via
  * {@link ManageApi}. Box office + Sections + full Reports UI are M2/M3.
  */
 
-type SeatManagerMode = 'view' | 'block';
+type SeatManagerMode = 'view' | 'inspect' | 'block';
 /** DO seat status — 'blocked' has no engine analogue (→ 'not_for_sale'). */
 type DoStatus = 'free' | 'held' | 'booked' | 'blocked';
 /** Live KPI snapshot pushed to `onTallies` on every state change. */
@@ -764,8 +814,10 @@ interface SeatManagerTallies {
     capacityPct: number;
     /** booked / (total − blocked), 0–100 — sell-through of sellable inventory. */
     sellThroughPct: number;
-    /** Σ price(booked seat), major units. */
+    /** Exact Σ booked unit_price snapshots from the authenticated report. */
     grossRevenue: number;
+    /** Revenue is never reconstructed from chart list price. */
+    revenueStatus: 'loading' | 'current' | 'stale';
     /** ISO-4217 currency for grossRevenue. */
     currency: string;
 }
@@ -774,6 +826,9 @@ interface SeatManagerActivity {
     id: string;
     at: number;
     label: string;
+    /** Full labels affected by this one backend/realtime operation. */
+    labels: string[];
+    count: number;
     /** Human verb: held / booked / released / blocked / unblocked. */
     verb: string;
     status: DoStatus;
@@ -793,6 +848,8 @@ interface SeatManagerOptions {
     eventKey: string;
     /** Bearer manage token — event-scoped `mse_…` or a tenant secret `sk_…`. */
     token: string;
+    /** Absolute token expiry (epoch ms). Enables proactive in-place rotation. */
+    tokenExpiresAt?: number;
     /** Initial mode. Default 'view'. */
     mode?: SeatManagerMode;
     /** ISO-4217 fallback currency for revenue (chart/event currency wins). */
@@ -809,6 +866,17 @@ interface SeatManagerOptions {
     onReady?: () => void;
     /** Live KPI tallies changed. */
     onTallies?: (tallies: SeatManagerTallies) => void;
+    /** A grouped live/audit activity item arrived. */
+    onActivity?: (activity: SeatManagerActivity) => void;
+    /** Exact private control-room projection changed. */
+    onControlRoom?: (snapshot: ControlRoomSnapshot) => void;
+    /** Called before token expiry. The manager swaps the result without remounting. */
+    onTokenRefresh?: () => Promise<{
+        token: string;
+        expiresAt: number;
+    }>;
+    /** Tool/mode changed from inside the shared cockpit. */
+    onModeChange?: (mode: SeatManagerMode) => void;
     /** Block-mode selection changed (marquee / ⌘A / category / section / tap). */
     onSelectionChange?: (seats: ExpandedSeat[]) => void;
     /** A block/unblock/cancel action completed successfully. */
@@ -831,8 +899,14 @@ declare class SeatManager {
     private labelToSeat;
     private allIds;
     private status;
-    private priceByCat;
     private currency;
+    private authoritativeGrossRevenue;
+    private revenueStatus;
+    private revenueRequest;
+    private revenueRefreshTimer;
+    private controlRoomSnapshot;
+    private trendWindowMinutes;
+    private heatEnabled;
     private ws;
     private reconnectTimer;
     private attempt;
@@ -842,10 +916,31 @@ declare class SeatManager {
     private feedTimer;
     private toastTimer;
     private releaseAt;
+    private layoutObserver;
+    private tokenExpiresAt;
+    private tokenRefreshTimer;
+    private tokenRefreshInFlight;
+    private sectionByObject;
+    private sectionLabelById;
+    private lastSyncedAt;
+    private readonly onFullscreenChange;
+    private readonly onKeyDown;
     constructor(options: SeatManagerOptions);
     /** Build the DOM, load the chart, subscribe to realtime, mount the board. */
     render(): Promise<this>;
     setMode(mode: SeatManagerMode): void;
+    /** Toggle the normalized sales-velocity outline overlay without changing seat colors. */
+    setHeatOverlay(enabled: boolean): void;
+    /** Change the current-vs-previous sales window and refresh the private projection. */
+    setTrendWindow(windowMinutes: number): Promise<ControlRoomSnapshot>;
+    enterFullscreen(): Promise<void>;
+    exitFullscreen(): Promise<void>;
+    isFullscreen(): boolean;
+    private toggleFullscreen;
+    /** Rotate the delegated credential without rebuilding DOM, canvas or socket. */
+    setToken(token: string, expiresAt?: number): void;
+    private scheduleTokenRefresh;
+    private rotateToken;
     /** Bulk block the given labels (or the current selection when omitted). */
     block(labels?: string[], opts?: {
         releaseAt?: number;
@@ -861,6 +956,7 @@ declare class SeatManager {
     clearSelection(): void;
     getSelection(): ExpandedSeat[];
     getReport(): Promise<ReportResult>;
+    getControlRoomSnapshot(windowMinutes?: number): Promise<ControlRoomSnapshot>;
     getLog(opts?: {
         limit?: number;
         before?: number;
@@ -874,6 +970,8 @@ declare class SeatManager {
     zoomToFit(): void;
     destroy(): void;
     private buildRenderer;
+    private updateRendererInteraction;
+    private handleSeatSelect;
     private repaintAll;
     private connect;
     private scheduleReconnect;
@@ -885,6 +983,9 @@ declare class SeatManager {
     /** Keep the canvas painting on hidden/occluded tabs (war-room second monitor). */
     private afterPaint;
     private flash;
+    private applyReportRevenue;
+    private refreshControlRoom;
+    private scheduleRevenueRefresh;
     private recomputeTallies;
     private verbFor;
     private pushActivity;
@@ -893,19 +994,25 @@ declare class SeatManager {
     private selectionLabels;
     private syncSelection;
     private buildChrome;
+    private updateContainerLayout;
     private sectionOptions;
     private buildSectionOptions;
     private paintModeTabs;
+    private paintHeatButton;
+    private paintFullscreenButton;
+    private paintTrendWindow;
     private setLive;
     private updateZoomHint;
     private paintKpis;
     private paintRail;
     private renderViewRail;
+    private paintMonitorInsights;
+    private applyHeatOverlay;
+    private renderInspectRail;
     private paintLegend;
     private paintFeed;
     private renderBlockRail;
     private selectCategory;
-    private promptCancel;
     private paintSelBar;
     private done;
     private toastOk;
@@ -914,4 +1021,4 @@ declare class SeatManager {
     private fail;
 }
 
-export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, type ControlRoomSectionMetric, type ControlRoomSnapshot, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };

package/dist/index.d.ts

@@ -622,6 +622,8 @@ interface ReportCategoryRow {
     held: number;
     booked: number;
     not_for_sale: number;
+    /** Exact sum of booked unit_price snapshots, in major currency units. */
+    bookedRevenue: number;
 }
 interface ReportCategoryMeta {
     key: string;
@@ -633,6 +635,7 @@ interface ReportResult {
     report: {
         byStatus: ReportByStatus;
         byCategory: ReportCategoryRow[];
+        bySection?: ControlRoomSectionMetric[];
     };
     event: {
         key: string;
@@ -642,6 +645,51 @@ interface ReportResult {
     };
     categories: ReportCategoryMeta[];
 }
+interface ControlRoomSectionMetric {
+    sectionId: string;
+    sectionLabel: string;
+    zoneId: string | null;
+    total: number;
+    free: number;
+    held: number;
+    booked: number;
+    not_for_sale: number;
+    bookedRevenue: number;
+}
+interface ControlRoomSnapshot {
+    version: number;
+    currency: string;
+    totals: {
+        free: number;
+        held: number;
+        booked: number;
+        blocked: number;
+    };
+    revenue: {
+        gross: number;
+        bySection: ControlRoomSectionMetric[];
+    };
+    velocity: {
+        windowMinutes: number;
+        bySection: Array<{
+            sectionId: string;
+            netBooked: number;
+            grossRevenue: number;
+            previousNetBooked: number;
+            trend: 'rising' | 'steady' | 'cooling';
+        }>;
+    };
+    presence: {
+        shoppingSessions: number;
+        activeHolds: number;
+    };
+    event: {
+        key: string;
+        name: string;
+        seatTotal: number;
+        currency?: string;
+    };
+}
 interface LogEntry {
     id: number;
     at: number;
@@ -719,6 +767,7 @@ declare class ManageApi {
         holdTtlMs: number | null;
     }>;
     report(key: string): Promise<ReportResult>;
+    controlRoom(key: string, windowMinutes?: number): Promise<ControlRoomSnapshot>;
     log(key: string, opts?: {
         limit?: number;
         before?: number;
@@ -734,22 +783,23 @@ declare class ManageApi {
  * Productizes the SeatLayer dashboard's ManageEventPage into a framework-
  * agnostic class (mirrors how SeatPicker productized the buyer flow). It mounts
  * the shared engine in `manageMode`, subscribes to the event's realtime channel
- * and drives two M1 modes on one canvas:
+ * and drives three control-room tools on one persistent canvas:
  *
  *   - **view**  — a live board: realtime seat repaint (flash on hold/book),
  *                 live KPI tallies + gross revenue, and a streaming activity
  *                 feed derived from the delta stream + audit log. Read-only.
+ *   - **inspect** — select one seat to read its live inventory context.
  *   - **block** — bulk-first block/unblock: marquee-drag, ⌘A select-all,
  *                 whole-category / whole-section select, single-seat fallback →
  *                 one batched block/unblock (optimistic, reconciled by the WS),
- *                 timed auto-release, and cancel-a-booking.
+ *                 and timed auto-release.
  *
  * Auth: reads (chart/objects/WS) are public; writes/reports carry a Bearer
  * event-scoped manage token (`mse_…`) or a tenant secret key (`sk_…`) via
  * {@link ManageApi}. Box office + Sections + full Reports UI are M2/M3.
  */
 
-type SeatManagerMode = 'view' | 'block';
+type SeatManagerMode = 'view' | 'inspect' | 'block';
 /** DO seat status — 'blocked' has no engine analogue (→ 'not_for_sale'). */
 type DoStatus = 'free' | 'held' | 'booked' | 'blocked';
 /** Live KPI snapshot pushed to `onTallies` on every state change. */
@@ -764,8 +814,10 @@ interface SeatManagerTallies {
     capacityPct: number;
     /** booked / (total − blocked), 0–100 — sell-through of sellable inventory. */
     sellThroughPct: number;
-    /** Σ price(booked seat), major units. */
+    /** Exact Σ booked unit_price snapshots from the authenticated report. */
     grossRevenue: number;
+    /** Revenue is never reconstructed from chart list price. */
+    revenueStatus: 'loading' | 'current' | 'stale';
     /** ISO-4217 currency for grossRevenue. */
     currency: string;
 }
@@ -774,6 +826,9 @@ interface SeatManagerActivity {
     id: string;
     at: number;
     label: string;
+    /** Full labels affected by this one backend/realtime operation. */
+    labels: string[];
+    count: number;
     /** Human verb: held / booked / released / blocked / unblocked. */
     verb: string;
     status: DoStatus;
@@ -793,6 +848,8 @@ interface SeatManagerOptions {
     eventKey: string;
     /** Bearer manage token — event-scoped `mse_…` or a tenant secret `sk_…`. */
     token: string;
+    /** Absolute token expiry (epoch ms). Enables proactive in-place rotation. */
+    tokenExpiresAt?: number;
     /** Initial mode. Default 'view'. */
     mode?: SeatManagerMode;
     /** ISO-4217 fallback currency for revenue (chart/event currency wins). */
@@ -809,6 +866,17 @@ interface SeatManagerOptions {
     onReady?: () => void;
     /** Live KPI tallies changed. */
     onTallies?: (tallies: SeatManagerTallies) => void;
+    /** A grouped live/audit activity item arrived. */
+    onActivity?: (activity: SeatManagerActivity) => void;
+    /** Exact private control-room projection changed. */
+    onControlRoom?: (snapshot: ControlRoomSnapshot) => void;
+    /** Called before token expiry. The manager swaps the result without remounting. */
+    onTokenRefresh?: () => Promise<{
+        token: string;
+        expiresAt: number;
+    }>;
+    /** Tool/mode changed from inside the shared cockpit. */
+    onModeChange?: (mode: SeatManagerMode) => void;
     /** Block-mode selection changed (marquee / ⌘A / category / section / tap). */
     onSelectionChange?: (seats: ExpandedSeat[]) => void;
     /** A block/unblock/cancel action completed successfully. */
@@ -831,8 +899,14 @@ declare class SeatManager {
     private labelToSeat;
     private allIds;
     private status;
-    private priceByCat;
     private currency;
+    private authoritativeGrossRevenue;
+    private revenueStatus;
+    private revenueRequest;
+    private revenueRefreshTimer;
+    private controlRoomSnapshot;
+    private trendWindowMinutes;
+    private heatEnabled;
     private ws;
     private reconnectTimer;
     private attempt;
@@ -842,10 +916,31 @@ declare class SeatManager {
     private feedTimer;
     private toastTimer;
     private releaseAt;
+    private layoutObserver;
+    private tokenExpiresAt;
+    private tokenRefreshTimer;
+    private tokenRefreshInFlight;
+    private sectionByObject;
+    private sectionLabelById;
+    private lastSyncedAt;
+    private readonly onFullscreenChange;
+    private readonly onKeyDown;
     constructor(options: SeatManagerOptions);
     /** Build the DOM, load the chart, subscribe to realtime, mount the board. */
     render(): Promise<this>;
     setMode(mode: SeatManagerMode): void;
+    /** Toggle the normalized sales-velocity outline overlay without changing seat colors. */
+    setHeatOverlay(enabled: boolean): void;
+    /** Change the current-vs-previous sales window and refresh the private projection. */
+    setTrendWindow(windowMinutes: number): Promise<ControlRoomSnapshot>;
+    enterFullscreen(): Promise<void>;
+    exitFullscreen(): Promise<void>;
+    isFullscreen(): boolean;
+    private toggleFullscreen;
+    /** Rotate the delegated credential without rebuilding DOM, canvas or socket. */
+    setToken(token: string, expiresAt?: number): void;
+    private scheduleTokenRefresh;
+    private rotateToken;
     /** Bulk block the given labels (or the current selection when omitted). */
     block(labels?: string[], opts?: {
         releaseAt?: number;
@@ -861,6 +956,7 @@ declare class SeatManager {
     clearSelection(): void;
     getSelection(): ExpandedSeat[];
     getReport(): Promise<ReportResult>;
+    getControlRoomSnapshot(windowMinutes?: number): Promise<ControlRoomSnapshot>;
     getLog(opts?: {
         limit?: number;
         before?: number;
@@ -874,6 +970,8 @@ declare class SeatManager {
     zoomToFit(): void;
     destroy(): void;
     private buildRenderer;
+    private updateRendererInteraction;
+    private handleSeatSelect;
     private repaintAll;
     private connect;
     private scheduleReconnect;
@@ -885,6 +983,9 @@ declare class SeatManager {
     /** Keep the canvas painting on hidden/occluded tabs (war-room second monitor). */
     private afterPaint;
     private flash;
+    private applyReportRevenue;
+    private refreshControlRoom;
+    private scheduleRevenueRefresh;
     private recomputeTallies;
     private verbFor;
     private pushActivity;
@@ -893,19 +994,25 @@ declare class SeatManager {
     private selectionLabels;
     private syncSelection;
     private buildChrome;
+    private updateContainerLayout;
     private sectionOptions;
     private buildSectionOptions;
     private paintModeTabs;
+    private paintHeatButton;
+    private paintFullscreenButton;
+    private paintTrendWindow;
     private setLive;
     private updateZoomHint;
     private paintKpis;
     private paintRail;
     private renderViewRail;
+    private paintMonitorInsights;
+    private applyHeatOverlay;
+    private renderInspectRail;
     private paintLegend;
     private paintFeed;
     private renderBlockRail;
     private selectCategory;
-    private promptCancel;
     private paintSelBar;
     private done;
     private toastOk;
@@ -914,4 +1021,4 @@ declare class SeatManager {
     private fail;
 }
 
-export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };
+export { ApiError, type BestAvailableResult, type CheckoutHandoff, type CheckoutLineItem, type ControlRoomSectionMetric, type ControlRoomSnapshot, EmbeddedDesigner, type EmbeddedDesignerEventType, type EmbeddedDesignerMessage, type EmbeddedDesignerOptions, type GAAreaAvailability, type HoldConflict, type HoldLineItem, type HoldResult, type LogEntry, type LogPage, ManageApi, ManageApiError, type ReportByStatus, type ReportCategoryMeta, type ReportCategoryRow, type ReportResult, SeatManager, type SeatManagerActionResult, type SeatManagerActivity, type SeatManagerMode, type SeatManagerOptions, type SeatManagerTallies, SeatPicker, type SeatPickerOptions, type SeatPickerTheme, SeatingChart, type SeatingChartOptions, type SelectedSeat };