@seatlayer/js 0.54.0 → 0.56.0

package/README.md

@@ -64,6 +64,13 @@ presence, exact configured booked value, booking velocity, and a clearly explain
 Block mode exposes explicit multi-select category state and a searchable,
 section-filtered blocked-inventory list, so an organizer can put specific seats
 back on sale without resetting the entire event.
+Select mode supports host-owned custom operations with initial/programmatic
+selection, availability policy, maximum and exact-count rules, and validity
+callbacks. Capability-gated Categories and Tables modes update the event
+snapshot without editing the reusable chart; table identity changes are refused
+while affected inventory is held, booked, or blocked.
+Filter Sections groups duplicate public labels, frames their combined inventory,
+and reports the matched sections to host-owned back-office views.
 
 ```js
 import { SeatManager } from '@seatlayer/js/manager';
@@ -216,11 +223,18 @@ designer.mount();
 ## API
 
 `new SeatingChart(options)` — options: `container` (selector or element, required),
-`event` (key, required), `apiBase?`, `maxSelection?` (default 10), `onSelectionChange?`,
-`onHold?`, `onHoldRestored?`, `onError?`.
-
-Methods: `render()`, `getSelection()`, `hold()`, `bestAvailable(qty, categoryKey?)`,
-`resumeHold(holdId)`, `getCurrentHold()`, `releaseLabels(labels)`, `release()`, `destroy()`.
+`event` (key, required), `apiBase?`, `maxSelection?` (default 10),
+`selectedObjects?`, `selectableObjects?`, `numberOfPlacesToSelect?`,
+`onSelectionChange?`, `onSelectionValidityChange?`, `onHold?`,
+`onHoldRestored?`, `onError?`.
+
+Selection methods: `getSelection()`, `selectObjects()`, `deselectObjects()`,
+`clearSelection()`, `selectCategories()`, `deselectCategories()`,
+`setSelectableObjects()`, `setMaxSelection()`, `getSelectionValidity()`.
+
+Lifecycle/hold methods: `render()`, `hold()`, `bestAvailable(qty, categoryKey?)`,
+`resumeHold(holdId)`, `getCurrentHold()`, `releaseLabels(labels)`, `release()`,
+`destroy()`.
 
 The full `SeatPicker` automatically restores an active hold after same-tab
 checkout navigation and lets the buyer remove individual held tickets. Set

package/dist/{channelsMode-BX7s9bUl.d.cts → channelsMode-CFxx1jp3.d.cts}

@@ -1,4 +1,4 @@
-import { ChartDoc, AvailabilityRule, ChartTheme, ExpandedSeat } from '@seatlayer/core';
+import { ChartDoc, AvailabilityRule, ExpandedSeat, ChartTheme } from '@seatlayer/core';
 
 /**
  * Sales-channel planning — the pure, DOM-free half of Channels mode.
@@ -70,6 +70,16 @@ interface ChannelRecord {
     archivedAt: number | null;
     counts: ChannelCounts;
     access?: ChannelAccessSummary | null;
+    /** Sparse per-category/tier buyer prices. Missing on pre-0.56 workers. */
+    priceOverrides?: ChannelPriceOverride[];
+    /** Optimistic-concurrency token for price edits. */
+    pricingVersion?: number;
+}
+interface ChannelPriceOverride {
+    categoryKey: string;
+    tierId: string | null;
+    /** Major currency units, matching chart category/tier prices. */
+    price: number;
 }
 interface PublicSaleChannel {
     /** `'public'` on every shipped worker; typed loosely so an older build that
@@ -608,6 +618,21 @@ interface LogPage {
     entries: LogEntry[];
     nextBefore: number | null;
 }
+interface EventCategoryAssignmentResult {
+    ok: true;
+    changed: boolean;
+    labels: string[];
+    categoryKey: string;
+    revision: number;
+}
+type EventTableBookingMode = 'individual' | 'whole' | 'variable';
+interface EventTableBookingResult {
+    ok: true;
+    changed: boolean;
+    tableIds: string[];
+    mode: EventTableBookingMode;
+    revision: number;
+}
 /** Platform/SDK inventory history — deliberately unrelated to commerce Orders. */
 type InventoryBookingState = 'booked' | 'partially_cancelled' | 'cancelled';
 interface InventoryBookingObject {
@@ -775,6 +800,7 @@ interface PubChartResult {
         startsAt?: number | null;
         currency?: string;
         mode?: string;
+        inventoryModelVersion?: 1 | 2;
     };
     doc: ChartDoc;
 }
@@ -852,6 +878,16 @@ declare class ManageApi {
         ok: true;
         holdTtlMs: number | null;
     }>;
+    /** Assign an event-only category to inventory labels. Existing transaction
+     * snapshots retain their original configured value; future selection uses
+     * the new category. Requires `event:categories:manage`. */
+    setCategory(key: string, labels: string[], categoryKey: string): Promise<EventCategoryAssignmentResult>;
+    /** Change event-only table booking identity. The server refuses tables with
+     * held/booked/blocked inventory or channel assignments that would be lost. */
+    setTableBooking(key: string, tableIds: string[], mode: EventTableBookingMode, bounds?: {
+        minOccupancy?: number;
+        maxOccupancy?: number;
+    }): Promise<EventTableBookingResult>;
     /** Inventory lifecycle by stable integrator bookingRef. Absent on Managed. */
     bookings(key: string, query?: InventoryBookingsQuery): Promise<InventoryBookingsPage>;
     /** Exact configured-value snapshot plus book/replay/cancellation audit. */
@@ -904,6 +940,11 @@ declare class ManageApi {
         ok: true;
         channel: ChannelRecord;
     }>;
+    /** Replace a channel's sparse category/tier prices with optimistic concurrency. */
+    updateChannelPricing(key: string, channelId: string, priceOverrides: ChannelPriceOverride[], expectedPricingVersion: number): Promise<{
+        ok: true;
+        channel: ChannelRecord;
+    }>;
     setChannelPaused(key: string, channelId: string, paused: boolean): Promise<{
         ok: true;
         channel: ChannelRecord;
@@ -1054,7 +1095,7 @@ declare class ManageApi {
  * nothing here emits a byte of runtime JavaScript.
  */
 
-type SeatManagerMode = 'view' | 'inspect' | 'block' | 'sections' | 'channels';
+type SeatManagerMode = 'view' | 'inspect' | 'select' | 'filterSections' | 'block' | 'sections' | 'categories' | 'tables' | 'channels';
 /** Short-lived, event-scoped browser credential minted by a trusted backend. */
 type EventScopedManageToken = `mse_${string}`;
 /**
@@ -1063,7 +1104,7 @@ type EventScopedManageToken = `mse_${string}`;
  * view without `event:channels:manage` ⇒ read-only inspection with every
  * mutation control absent, not merely disabled.
  */
-type SeatManagerCapability = 'event:view' | 'event:block' | 'event:cancel' | 'event:reports' | 'event:channels:view' | 'event:channels:manage';
+type SeatManagerCapability = 'event:view' | 'event:block' | 'event:categories:manage' | 'event:tables:manage' | 'event:cancel' | 'event:reports' | 'event:channels:view' | 'event:channels:manage';
 /** 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. */
@@ -1106,10 +1147,25 @@ interface SeatManagerActivity {
 }
 /** Fired after a successful organizer action, for host toasts/telemetry. */
 interface SeatManagerActionResult {
-    action: 'block' | 'unblock' | 'unblockAll' | 'cancelBooking' | 'setHoldTtl';
+    action: 'block' | 'unblock' | 'unblockAll' | 'cancelBooking' | 'setHoldTtl' | 'setCategory' | 'setTableBooking';
     labels: string[];
     count: number;
 }
+/** Exact-count state for the read-only custom Select tool. */
+interface SeatManagerSelectionValidity {
+    isValid: boolean;
+    count: number;
+    required: number;
+    remaining: number;
+    objects: ExpandedSeat[];
+}
+/** One section matched by the read-only Filter Sections tool. */
+interface SeatManagerFilteredSection {
+    id: string;
+    label: string;
+    seatCount: number;
+    zone?: string;
+}
 interface SeatManagerOptions {
     /** CSS selector or element to mount into. */
     container: string | HTMLElement;
@@ -1126,6 +1182,21 @@ interface SeatManagerOptions {
     tokenExpiresAt?: number;
     /** Initial mode. Default 'view'. */
     mode?: SeatManagerMode;
+    /** Public labels to preselect after live inventory has loaded in Select mode. */
+    selectedObjects?: string[];
+    /**
+     * Labels that remain selectable even when `unavailableObjectsSelectable` is
+     * false. This is an exception list, matching Event Manager Select semantics.
+     */
+    selectableObjects?: string[];
+    /** Allow held, booked, and blocked objects in Select mode. Default true. */
+    unavailableObjectsSelectable?: boolean;
+    /** Maximum objects selectable in the custom Select tool. */
+    maxSelectedObjects?: number;
+    /** Require exactly this many objects and cap selection at that count. */
+    numberOfPlacesToSelect?: number;
+    /** Final per-object Select-mode policy; overrides the default decision. */
+    isObjectSelectable?: (object: ExpandedSeat, defaultValue: boolean) => boolean;
     /**
      * The capability set this token was minted with. Supply it whenever you mint
      * an `mse_…` grant — it is the only way the widget can know a delegated token
@@ -1167,6 +1238,20 @@ interface SeatManagerOptions {
     onFollowLiveChange?: (enabled: boolean) => void;
     /** Block-mode selection changed (marquee / ⌘A / category / section / tap). */
     onSelectionChange?: (seats: ExpandedSeat[]) => void;
+    /** One object entered the custom Select-mode selection. */
+    onObjectSelected?: (object: ExpandedSeat) => void;
+    /** One object left the custom Select-mode selection. */
+    onObjectDeselected?: (object: ExpandedSeat) => void;
+    /** Exact-count Select-mode state after every selection change. */
+    onSelectionValidityChange?: (state: SeatManagerSelectionValidity) => void;
+    /** Exact-count Select-mode state transitioned to valid. */
+    onSelectionValid?: (state: SeatManagerSelectionValidity) => void;
+    /** Exact-count Select-mode state transitioned to invalid. */
+    onSelectionInvalid?: (state: SeatManagerSelectionValidity) => void;
+    /** A Select-mode attempt reached the active exact/max cap. */
+    onSelectionLimit?: (max: number) => void;
+    /** Filter Sections changed by map interaction or an imperative method. */
+    onFilteredSectionChange?: (sections: SeatManagerFilteredSection[]) => void;
     /** A block/unblock/cancel action completed successfully. */
     onActionComplete?: (result: SeatManagerActionResult) => void;
     /**
@@ -1230,6 +1315,11 @@ declare class SeatManager {
     private renderer;
     private doc;
     private mode;
+    private inventoryModelVersion;
+    private selectableObjectLabels;
+    private lastSelectionLabels;
+    private selectionWasValid;
+    private initialSelectionApplied;
     private labelToId;
     private labelToSeat;
     private allIds;
@@ -1300,6 +1390,7 @@ declare class SeatManager {
     private sectionByObject;
     private sectionLabelById;
     private sectionsBase;
+    private filteredSectionLabel;
     private availabilityRules;
     private effectiveHidden;
     private effectiveClosed;
@@ -1326,6 +1417,9 @@ declare class SeatManager {
      */
     private channels;
     private channelCaps;
+    private categoryCanManage;
+    private tableCanManage;
+    private tableBookingSaving;
     /** Supersedes an async capability probe after token/capability rotation. */
     private channelCapabilityResolution;
     /** In-flight `import('./channelsMode')`, so concurrent entries load once. */
@@ -1334,6 +1428,7 @@ declare class SeatManager {
     private readonly onKeyDown;
     private readonly onRailClick;
     constructor(options: SeatManagerOptions);
+    private assertSelectionOptions;
     /** Build the DOM, load the chart, subscribe to realtime, mount the board. */
     render(): Promise<this>;
     setMode(mode: SeatManagerMode): void;
@@ -1407,9 +1502,43 @@ declare class SeatManager {
     unblockAll(): Promise<void>;
     /** Cancel bookings (BOOKED → free), guarded by the original booking ref. */
     cancelBooking(labels: string[], bookingRef: string): Promise<void>;
+    /** Assign an event-only category to labels or the current manager selection. */
+    setCategory(categoryKey: string, labels?: string[]): Promise<void>;
+    /** Change event-only table booking identity, then reload authoritative
+     * geometry/inventory because individual chairs and grouped tables use
+     * different labels. */
+    setTableBooking(tableIds: string[], mode: EventTableBookingMode, bounds?: {
+        minOccupancy?: number;
+        maxOccupancy?: number;
+    }): Promise<void>;
+    private reloadEventChart;
     selectAll(): ExpandedSeat[];
     selectSection(sectionId: string): ExpandedSeat[];
+    /** Filter every section whose public label matches, then frame their union. */
+    setFilteredSection(label: string): SeatManagerFilteredSection[];
+    /** Clear section filtering and restore the full event frame. */
+    clearFilteredSection(): void;
+    getFilteredSections(): SeatManagerFilteredSection[];
     selectByLabels(labels: string[]): ExpandedSeat[];
+    /** Select custom-operation objects by public inventory label. */
+    selectObjects(labels: string[]): ExpandedSeat[];
+    /** Deselect custom-operation objects by public inventory label. */
+    deselectObjects(labels: string[]): ExpandedSeat[];
+    /** Select every eligible object in the named chart categories. */
+    selectCategories(keys: string[]): ExpandedSeat[];
+    /** Deselect every selected object in the named chart categories. */
+    deselectCategories(keys: string[]): ExpandedSeat[];
+    /** Replace the unavailable-object exception list without remounting. */
+    setSelectableObjects(labels: string[]): void;
+    /** Change whether unavailable inventory participates in custom selection. */
+    setUnavailableObjectsSelectable(enabled: boolean): void;
+    /** Replace the final per-object selection predicate. */
+    setObjectSelectable(predicate: SeatManagerOptions['isObjectSelectable']): void;
+    /** Change the custom Select-mode cap without remounting. */
+    setMaxSelectedObjects(max: number | undefined): void;
+    /** Change or clear the exact custom-selection requirement. */
+    setNumberOfPlacesToSelect(required: number | undefined): void;
+    getSelectionValidity(): SeatManagerSelectionValidity | null;
     clearSelection(): void;
     getSelection(): ExpandedSeat[];
     getReport(): Promise<ReportResult>;
@@ -1553,11 +1682,18 @@ declare class SeatManager {
     private pushActivity;
     private seedFeed;
     private startFeedClock;
+    private selectionCap;
+    private canSelectObject;
+    private applyInitialSelection;
+    private trimSelectionToCap;
+    private reconcileSelectPolicy;
     private selectionLabels;
     private syncSelection;
     private buildChrome;
     private updateContainerLayout;
     private sectionOptions;
+    private filterableSections;
+    private applyFilteredSectionCanvas;
     private buildSectionOptions;
     private paintModeTabs;
     private paintFollowLiveButton;
@@ -1576,6 +1712,12 @@ declare class SeatManager {
     private presenceCounts;
     private paintMonitorInsights;
     private applyHeatOverlay;
+    private renderSelectRail;
+    private paintSelectSelection;
+    private renderFilterSectionsRail;
+    private renderCategoriesRail;
+    private paintCategorySelection;
+    private renderTablesRail;
     private renderInspectRail;
     /** Pull the organizer's availability rules (event:view). Called on load and on
      *  every WS (re)connect, mirroring how the other panels re-hydrate. `closed` is
@@ -1674,6 +1816,12 @@ interface ChannelsClient {
         ok: true;
         channel: ChannelRecord;
     }>;
+    /** Replace the sparse channel price map. Optional for custom clients built
+     *  against an older manager contract; the editor is absent when omitted. */
+    updateChannelPricing?(key: string, channelId: string, priceOverrides: ChannelPriceOverride[], expectedPricingVersion: number): Promise<{
+        ok: true;
+        channel: ChannelRecord;
+    }>;
     setChannelPaused(key: string, channelId: string, paused: boolean): Promise<{
         ok: true;
         channel: ChannelRecord;
@@ -1759,6 +1907,12 @@ interface ChannelsModeHost {
         key: string;
         label: string;
         color?: string;
+        price?: number;
+        tiers?: Array<{
+            id: string;
+            name: string;
+            price: number;
+        }>;
     }>;
     labelsInCategory(key: string): string[];
     sectionOfLabel(label: string): {
@@ -2115,6 +2269,9 @@ declare class ChannelsMode {
      */
     private renderMenuDialog;
     private renderRenameDialog;
+    /** Sparse channel pricing: blank means inherit the event's category/tier price. */
+    private renderPricingDialog;
+    private saveChannelPricing;
     /**
      * "Use a website or app" — declare the channel's route as `server`.
      *
@@ -2238,4 +2395,4 @@ declare class ChannelsMode {
     handleBack(): boolean;
 }
 
-export { type ReportResult as $, type AccessIntentForbidsDetails as A, type BucketRow as B, type ChannelAccessIntent as C, type ChannelsClient as D, ChannelsMode as E, type ChannelsModeHost as F, type ChannelsRowView as G, type ChannelsSeatView as H, type ControlRoomActivityEntry as I, type ControlRoomSectionMetric as J, type ControlRoomSnapshot as K, type EventScopedManageToken as L, type IntentSwitchBlockedDetails as M, type InventoryBooking as N, type InventoryBookingActivity as O, type InventoryBookingDetail as P, type InventoryBookingObject as Q, type InventoryBookingState as R, type InventoryBookingsPage as S, type InventoryBookingsQuery as T, type LogEntry as U, type LogPage as V, ManageApi as W, ManageApiError as X, type ReportByStatus as Y, type ReportCategoryMeta as Z, type ReportCategoryRow as _, type AccessLinkRecord as a, SeatManager as a0, type SeatManagerActionResult as a1, type SeatManagerActivity as a2, type SeatManagerCapability as a3, type SeatManagerConnection as a4, type SeatManagerMode as a5, type SeatManagerOptions as a6, type SeatManagerTallies as a7, type SelectionSourceRow as a8, ACCESS_LINK_DEFAULTS as a9, PUBLIC_CHANNEL_ID as aa, PUBLIC_CHANNEL_NAME as ab, accessIntentDescription as ac, accessIntentLabel as ad, accessLine as ae, accessLinkBadge as af, accessLinkErrorCopy as ag, accessLinkIsLive as ah, accessLinkPolicyLines as ai, bucketRows as aj, dropReviewRows as ak, intentForbidsCopy as al, intentSwitchBlockedCopy as am, isPublicChannelId as an, markerLetter as ao, markerOf as ap, mutationCount as aq, needsMoveConfirmation as ar, planAssignment as as, retryAfterCopy as at, selectionSources as au, stateBadge as av, suggestMarker as aw, type AccessLinkReveal as b, type AccessLinkState as c, type AccessLinkStatus as d, type AccessLinkStatusRecord as e, type ArchiveBlockedDetails as f, type AssignmentBuckets as g, type AssignmentDropDetails as h, type AssignmentResult as i, type ChannelAccessSummary as j, type ChannelAllocationPage as k, type ChannelAttribution as l, type ChannelAuditEntry as m, type ChannelAuditPage as n, type ChannelCounts as o, type ChannelListResult as p, type ChannelPreviewProjection as q, type ChannelRecord as r, type ChannelReport as s, type ChannelReportLinkRecord as t, type ChannelReportLinkReveal as u, type ChannelReportResult as v, type ChannelReportRow as w, type ChannelSeatStatus as x, type ChannelState as y, type ChannelsCapabilities as z };
+export { type ReportByStatus as $, type AccessIntentForbidsDetails as A, type BucketRow as B, type ChannelAccessIntent as C, type ChannelsClient as D, ChannelsMode as E, type ChannelsModeHost as F, type ChannelsRowView as G, type ChannelsSeatView as H, type ControlRoomActivityEntry as I, type ControlRoomSectionMetric as J, type ControlRoomSnapshot as K, type EventCategoryAssignmentResult as L, type EventScopedManageToken as M, type EventTableBookingMode as N, type EventTableBookingResult as O, type IntentSwitchBlockedDetails as P, type InventoryBooking as Q, type InventoryBookingActivity as R, type InventoryBookingDetail as S, type InventoryBookingObject as T, type InventoryBookingState as U, type InventoryBookingsPage as V, type InventoryBookingsQuery as W, type LogEntry as X, type LogPage as Y, ManageApi as Z, ManageApiError as _, type AccessLinkRecord as a, type ReportCategoryMeta as a0, type ReportCategoryRow as a1, type ReportResult as a2, SeatManager as a3, type SeatManagerActionResult as a4, type SeatManagerActivity as a5, type SeatManagerCapability as a6, type SeatManagerConnection as a7, type SeatManagerFilteredSection as a8, type SeatManagerMode as a9, stateBadge as aA, suggestMarker as aB, type SeatManagerOptions as aa, type SeatManagerSelectionValidity as ab, type SeatManagerTallies as ac, type SelectionSourceRow as ad, ACCESS_LINK_DEFAULTS as ae, PUBLIC_CHANNEL_ID as af, PUBLIC_CHANNEL_NAME as ag, accessIntentDescription as ah, accessIntentLabel as ai, accessLine as aj, accessLinkBadge as ak, accessLinkErrorCopy as al, accessLinkIsLive as am, accessLinkPolicyLines as an, bucketRows as ao, dropReviewRows as ap, intentForbidsCopy as aq, intentSwitchBlockedCopy as ar, isPublicChannelId as as, markerLetter as at, markerOf as au, mutationCount as av, needsMoveConfirmation as aw, planAssignment as ax, retryAfterCopy as ay, selectionSources as az, type AccessLinkReveal as b, type AccessLinkState as c, type AccessLinkStatus as d, type AccessLinkStatusRecord as e, type ArchiveBlockedDetails as f, type AssignmentBuckets as g, type AssignmentDropDetails as h, type AssignmentResult as i, type ChannelAccessSummary as j, type ChannelAllocationPage as k, type ChannelAttribution as l, type ChannelAuditEntry as m, type ChannelAuditPage as n, type ChannelCounts as o, type ChannelListResult as p, type ChannelPreviewProjection as q, type ChannelRecord as r, type ChannelReport as s, type ChannelReportLinkRecord as t, type ChannelReportLinkReveal as u, type ChannelReportResult as v, type ChannelReportRow as w, type ChannelSeatStatus as x, type ChannelState as y, type ChannelsCapabilities as z };