SeatManager reference

SeatManager is the complete operator SDK surface. It mounts a native canvas and control rails in your document, subscribes to live state, and sends private actions with an event-scoped manage token.

import { SeatManager } from "@seatlayer/js/manager";

const room = new SeatManager({
  container: "#control-room",
  eventKey: "ev_9f3a",
  token,
});

await room.render();

Constructor options

type SeatManagerMode =
  | "view"
  | "inspect"
  | "select"
  | "filterSections"
  | "block"
  | "sections"
  | "categories"
  | "tables"
  | "channels";

view is the read-only live/static event view. select is a read-only custom-operation tool, while filterSections frames one public section label for host-owned reporting. None of those tools mutates inventory. categories and tables make event-only changes and are hidden unless their dedicated capabilities are declared.

The toolbar presents these in three labelled groups, so an operator can tell at a glance what a tab will do:

Each rail repeats that scope as a badge next to its title (Read-only, This event only, Your app).

Use tools to hide what a surface does not need — a dashboard that never consumes onSelectionChange should not show a Select tab that leads nowhere:

new SeatManager({
  container: "#room",
  eventKey: "ev_123",
  token: manageToken,
  capabilities: ["event:view", "event:block", "event:categories:manage"],
  // Watch + Manage only. The whole "Host tools" group disappears.
  tools: ["view", "inspect", "block", "sections", "categories"],
});

tools is a filter, never a grant: a mode whose capability is missing stays hidden however it is listed, and any refused mode falls back to view.

Callbacks

Methods

Event-only category and table controls

setCategory() changes the event snapshot and current free inventory pricing; it does not edit the reusable chart. Existing hold and booking line-item price snapshots remain immutable.

setTableBooking() changes inventory identity, so SeatManager reloads the authoritative event chart after success. The server refuses the operation when any affected table unit is held, booked, or blocked, or when changing labels would drop a private-channel assignment. Variable occupancy bounds must fit the physical table capacity. These controls require inventory model 2.

boxBook() exists as a compatibility stub in current package declarations. Do not call it. Use the server-side box-book route.

Tallies

interface SeatManagerTallies {
  free: number;
  held: number;
  booked: number;
  blocked: number;
  total: number;
  capacityPct: number;
  sellThroughPct: number;
  grossRevenue: number;
  revenueStatus: "loading" | "current" | "stale";
  currency: string;
}

capacityPct is booked divided by total capacity. sellThroughPct is booked divided by capacity excluding blocked inventory. grossRevenue and revenue are legacy SDK field names. They come from authenticated configured-price snapshots captured with booked inventory and should be labelled booked value in a Platform product. They are never reconstructed from the current list price, but they also do not prove the amount charged, settled, or refunded in your commerce system.

Control-room snapshot

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;
  };
  activity?: ControlRoomActivityEntry[];
  event: {
    key: string;
    name: string;
    seatTotal: number;
    currency?: string;
  };
}

Section metrics include section and zone identity plus total, free, held, booked, not-for-sale, and configured booked-value snapshots.

Action results

interface SeatManagerActionResult {
  action:
    | "block"
    | "unblock"
    | "unblockAll"
    | "cancelBooking"
    | "setHoldTtl"
    | "setCategory"
    | "setTableBooking";
  labels: string[];
  count: number;
}

Errors from permission, conflict, expiry, and transport failures reach onError and reject the relevant promise. Do not infer success from an optimistic repaint.

ManageApi

ManageApi is the lower-level transport for custom operator interfaces:

import { ManageApi } from "@seatlayer/js/manager";

const api = new ManageApi("https://api.seatlayer.io", token);
const report = await api.report(eventKey);
const rules = await api.availability(eventKey);

It provides chart, objects, socketUrl, block, unblock, unblockAll, unbook, setCategory, setTableBooking, setHoldTtl, availability, setAvailability, report, controlRoom, log, and reportCsv. reportCsv() returns a Blob because a Bearer token cannot be attached to a plain download link.

Lifecycle

Call render() before imperative methods. Call destroy() on route changes, component unmount, logout, and event switching. Reuse setToken() for rotation rather than reconstructing the board.

See the control-room guide and manage-session security model.