@seatlayer/js 0.25.0 → 0.26.0

package/dist/index.d.cts

@@ -18,7 +18,7 @@ interface HoldConflict {
 interface HoldLineItem {
     label: string;
     objectId: string;
-    objectType: 'seat' | 'booth' | 'ga';
+    objectType: 'seat' | 'booth' | 'ga' | 'table';
     categoryKey: string;
     tierId: string | null;
     /** Price in major currency units (for example 45 means $45.00). */
@@ -151,6 +151,7 @@ declare class SeatingChart {
     private mount;
     private hostEl;
     private rendered;
+    private mode_;
     private tipEl;
     private tipPos;
     private onTipMove;
@@ -168,14 +169,47 @@ declare class SeatingChart {
     private buildBadge;
     private placeTooltip;
     private updateTooltip;
+    /**
+     * Whether the SERVED event is a live or a test event (`sk_test_` keys create
+     * test events, which never book real inventory). `null` before render()
+     * resolves — the mode comes from the server with the chart, not from options.
+     *
+     * The widget already surfaces this visually with the test-mode ribbon; this
+     * getter is for hosts that draw their own chrome — notably a native WebView
+     * wrapper, which must be able to tell an integrator that the build they are
+     * about to ship is pointed at a test event.
+     */
+    getMode(): 'live' | 'test' | null;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
     /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */
     hold(options?: {
         ttlMs?: number;
     }): Promise<HoldResult | null>;
+    /**
+     * @internal Like {@link hold} but RE-THROWS the structured API error (409
+     * `reason`/`code` + `conflicts`) instead of swallowing it into `onError` +
+     * `null`. The native WebView host adapter needs the throw so it can answer the
+     * originating command with a correlated error carrying the SPECIFIC reason
+     * (`sold_out` vs `not_enough_together`); the public method above keeps the
+     * catch-and-onError contract that direct web consumers rely on. Not a stable
+     * part of the embed API.
+     */
+    holdOrThrow(options?: {
+        ttlMs?: number;
+    }): Promise<HoldResult | null>;
     /** Restore an active hold by its opaque id without extending its expiry. */
     resumeHold(holdId: string): Promise<HoldResult | null>;
+    /** @internal Throwing variant of {@link resumeHold} for the native host adapter. See {@link holdOrThrow}. */
+    resumeHoldOrThrow(holdId: string): Promise<HoldResult | null>;
+    /**
+     * Push the OPEN hold's expiry out ("need more time?"). Resolves the refreshed
+     * hold, or `null` when there is nothing held or the server refused (the hold
+     * is gone, already expired, or at its renewal cap) — refusal is a normal
+     * outcome, not an error, so the host decides the copy. The client-side expiry
+     * timer is re-armed to match, so `onHoldExpired` won't fire early.
+     */
+    extendHold(ttlMs?: number): Promise<HoldResult | null>;
     /** Current active hold known to this chart, if any. */
     getCurrentHold(): HoldResult | null;
     getGAAreas(): GAAreaAvailability[];
@@ -183,8 +217,15 @@ declare class SeatingChart {
         tierId?: string | null;
         ttlMs?: number;
     }): Promise<HoldResult | null>;
+    /** @internal Throwing variant of {@link holdGA} for the native host adapter. See {@link holdOrThrow}. */
+    holdGAOrThrow(areaId: string, qty: number, options?: {
+        tierId?: string | null;
+        ttlMs?: number;
+    }): Promise<HoldResult | null>;
     /** Ask the server for the `qty` best free seats and hold them atomically. */
     bestAvailable(qty: number, categoryKey?: string): Promise<BestAvailableResult | null>;
+    /** @internal Throwing variant of {@link bestAvailable} for the native host adapter. See {@link holdOrThrow}. */
+    bestAvailableOrThrow(qty: number, categoryKey?: string): Promise<BestAvailableResult | null>;
     /**
      * Choose a ticket tier for a selected seat (e.g. Adult → Child). The seat's
      * available `tiers` are on each `SelectedSeat` from `getSelection()` /
@@ -488,11 +529,11 @@ declare class EmbeddedDesigner {
  * per-line tier + price) and never changes shape across minor releases.
  */
 interface CheckoutLineItem {
-    /** Seat label (or GA synthetic-unit label). */
+    /** Seat, table-group, or GA synthetic-unit label. */
     label: string;
     /** Chart object id (row/booth/GA area) the unit belongs to. */
     objectId: string;
-    objectType: 'seat' | 'booth' | 'ga';
+    objectType: 'seat' | 'booth' | 'ga' | 'table';
     categoryKey: string;
     /** Chosen ticket tier id (Adult/Child/…), or null when the category has no tiers. */
     tierId: string | null;

package/dist/index.d.ts

@@ -18,7 +18,7 @@ interface HoldConflict {
 interface HoldLineItem {
     label: string;
     objectId: string;
-    objectType: 'seat' | 'booth' | 'ga';
+    objectType: 'seat' | 'booth' | 'ga' | 'table';
     categoryKey: string;
     tierId: string | null;
     /** Price in major currency units (for example 45 means $45.00). */
@@ -151,6 +151,7 @@ declare class SeatingChart {
     private mount;
     private hostEl;
     private rendered;
+    private mode_;
     private tipEl;
     private tipPos;
     private onTipMove;
@@ -168,14 +169,47 @@ declare class SeatingChart {
     private buildBadge;
     private placeTooltip;
     private updateTooltip;
+    /**
+     * Whether the SERVED event is a live or a test event (`sk_test_` keys create
+     * test events, which never book real inventory). `null` before render()
+     * resolves — the mode comes from the server with the chart, not from options.
+     *
+     * The widget already surfaces this visually with the test-mode ribbon; this
+     * getter is for hosts that draw their own chrome — notably a native WebView
+     * wrapper, which must be able to tell an integrator that the build they are
+     * about to ship is pointed at a test event.
+     */
+    getMode(): 'live' | 'test' | null;
     /** Current selection with prices resolved from the chart categories. */
     getSelection(): SelectedSeat[];
     /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */
     hold(options?: {
         ttlMs?: number;
     }): Promise<HoldResult | null>;
+    /**
+     * @internal Like {@link hold} but RE-THROWS the structured API error (409
+     * `reason`/`code` + `conflicts`) instead of swallowing it into `onError` +
+     * `null`. The native WebView host adapter needs the throw so it can answer the
+     * originating command with a correlated error carrying the SPECIFIC reason
+     * (`sold_out` vs `not_enough_together`); the public method above keeps the
+     * catch-and-onError contract that direct web consumers rely on. Not a stable
+     * part of the embed API.
+     */
+    holdOrThrow(options?: {
+        ttlMs?: number;
+    }): Promise<HoldResult | null>;
     /** Restore an active hold by its opaque id without extending its expiry. */
     resumeHold(holdId: string): Promise<HoldResult | null>;
+    /** @internal Throwing variant of {@link resumeHold} for the native host adapter. See {@link holdOrThrow}. */
+    resumeHoldOrThrow(holdId: string): Promise<HoldResult | null>;
+    /**
+     * Push the OPEN hold's expiry out ("need more time?"). Resolves the refreshed
+     * hold, or `null` when there is nothing held or the server refused (the hold
+     * is gone, already expired, or at its renewal cap) — refusal is a normal
+     * outcome, not an error, so the host decides the copy. The client-side expiry
+     * timer is re-armed to match, so `onHoldExpired` won't fire early.
+     */
+    extendHold(ttlMs?: number): Promise<HoldResult | null>;
     /** Current active hold known to this chart, if any. */
     getCurrentHold(): HoldResult | null;
     getGAAreas(): GAAreaAvailability[];
@@ -183,8 +217,15 @@ declare class SeatingChart {
         tierId?: string | null;
         ttlMs?: number;
     }): Promise<HoldResult | null>;
+    /** @internal Throwing variant of {@link holdGA} for the native host adapter. See {@link holdOrThrow}. */
+    holdGAOrThrow(areaId: string, qty: number, options?: {
+        tierId?: string | null;
+        ttlMs?: number;
+    }): Promise<HoldResult | null>;
     /** Ask the server for the `qty` best free seats and hold them atomically. */
     bestAvailable(qty: number, categoryKey?: string): Promise<BestAvailableResult | null>;
+    /** @internal Throwing variant of {@link bestAvailable} for the native host adapter. See {@link holdOrThrow}. */
+    bestAvailableOrThrow(qty: number, categoryKey?: string): Promise<BestAvailableResult | null>;
     /**
      * Choose a ticket tier for a selected seat (e.g. Adult → Child). The seat's
      * available `tiers` are on each `SelectedSeat` from `getSelection()` /
@@ -488,11 +529,11 @@ declare class EmbeddedDesigner {
  * per-line tier + price) and never changes shape across minor releases.
  */
 interface CheckoutLineItem {
-    /** Seat label (or GA synthetic-unit label). */
+    /** Seat, table-group, or GA synthetic-unit label. */
     label: string;
     /** Chart object id (row/booth/GA area) the unit belongs to. */
     objectId: string;
-    objectType: 'seat' | 'booth' | 'ga';
+    objectType: 'seat' | 'booth' | 'ga' | 'table';
     categoryKey: string;
     /** Chosen ticket tier id (Adult/Child/…), or null when the category has no tiers. */
     tierId: string | null;

package/dist/index.js

@@ -25,7 +25,13 @@ async function request(base, path, init = {}) {
   const data = isJson ? await res.json().catch(() => null) : null;
   if (!res.ok) {
     const err = data;
-    throw new ApiError(res.status, err?.error ?? `request_failed_${res.status}`, err?.code, err?.conflicts, err?.reason);
+    throw new ApiError(
+      res.status,
+      err?.error ?? `request_failed_${res.status}`,
+      err?.code ?? err?.error,
+      err?.conflicts,
+      err?.reason
+    );
   }
   return data;
 }
@@ -98,6 +104,7 @@ var SeatingChart = class {
     this.mount = null;
     this.hostEl = null;
     this.rendered = false;
+    this.mode_ = null;
     this.tipEl = null;
     this.tipPos = { x: 0, y: 0 };
     this.onTipMove = null;
@@ -151,6 +158,7 @@ var SeatingChart = class {
       this.rendered = false;
       return this;
     }
+    this.mode_ = info.mode === "test" ? "test" : "live";
     if (this.opts.seatTooltip !== false) {
       const tip = document.createElement("div");
       tip.setAttribute("role", "tooltip");
@@ -224,6 +232,19 @@ var SeatingChart = class {
     this.tipEl.style.display = "block";
     this.placeTooltip();
   }
+  /**
+   * Whether the SERVED event is a live or a test event (`sk_test_` keys create
+   * test events, which never book real inventory). `null` before render()
+   * resolves — the mode comes from the server with the chart, not from options.
+   *
+   * The widget already surfaces this visually with the test-mode ribbon; this
+   * getter is for hosts that draw their own chrome — notably a native WebView
+   * wrapper, which must be able to tell an integrator that the build they are
+   * about to ship is pointed at a test event.
+   */
+  getMode() {
+    return this.mode_;
+  }
   /** Current selection with prices resolved from the chart categories. */
   getSelection() {
     return this.controller.getSelection();
@@ -231,17 +252,49 @@ var SeatingChart = class {
   /** Hold the current selection. Resolves the hold, or null on a 409 conflict. */
   async hold(options = {}) {
     try {
-      const h = await this.controller.hold(void 0, options.ttlMs);
-      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats, items: h.items } : null;
+      return await this.holdOrThrow(options);
     } catch (err) {
       this.opts.onError?.(err);
       return null;
     }
   }
+  /**
+   * @internal Like {@link hold} but RE-THROWS the structured API error (409
+   * `reason`/`code` + `conflicts`) instead of swallowing it into `onError` +
+   * `null`. The native WebView host adapter needs the throw so it can answer the
+   * originating command with a correlated error carrying the SPECIFIC reason
+   * (`sold_out` vs `not_enough_together`); the public method above keeps the
+   * catch-and-onError contract that direct web consumers rely on. Not a stable
+   * part of the embed API.
+   */
+  async holdOrThrow(options = {}) {
+    const h = await this.controller.hold(void 0, options.ttlMs);
+    return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats, items: h.items } : null;
+  }
   /** Restore an active hold by its opaque id without extending its expiry. */
   async resumeHold(holdId) {
     try {
-      const h = await this.controller.resumeHold(holdId);
+      return await this.resumeHoldOrThrow(holdId);
+    } catch (err) {
+      this.opts.onError?.(err);
+      return null;
+    }
+  }
+  /** @internal Throwing variant of {@link resumeHold} for the native host adapter. See {@link holdOrThrow}. */
+  async resumeHoldOrThrow(holdId) {
+    const h = await this.controller.resumeHold(holdId);
+    return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats, items: h.items } : null;
+  }
+  /**
+   * Push the OPEN hold's expiry out ("need more time?"). Resolves the refreshed
+   * hold, or `null` when there is nothing held or the server refused (the hold
+   * is gone, already expired, or at its renewal cap) — refusal is a normal
+   * outcome, not an error, so the host decides the copy. The client-side expiry
+   * timer is re-armed to match, so `onHoldExpired` won't fire early.
+   */
+  async extendHold(ttlMs) {
+    try {
+      const h = await this.controller.extendHold(ttlMs);
       return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats, items: h.items } : null;
     } catch (err) {
       this.opts.onError?.(err);
@@ -258,23 +311,31 @@ var SeatingChart = class {
   }
   async holdGA(areaId, qty, options = {}) {
     try {
-      const h = await this.controller.holdGA(areaId, qty, options);
-      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats, items: h.items } : null;
+      return await this.holdGAOrThrow(areaId, qty, options);
     } catch (err) {
       this.opts.onError?.(err);
       return null;
     }
   }
+  /** @internal Throwing variant of {@link holdGA} for the native host adapter. See {@link holdOrThrow}. */
+  async holdGAOrThrow(areaId, qty, options = {}) {
+    const h = await this.controller.holdGA(areaId, qty, options);
+    return h ? { holdId: h.holdId, expiresAt: h.expiresAt, seats: h.seats, items: h.items } : null;
+  }
   /** Ask the server for the `qty` best free seats and hold them atomically. */
   async bestAvailable(qty, categoryKey) {
     try {
-      const h = await this.controller.bestAvailable(qty, categoryKey);
-      return h ? { holdId: h.holdId, expiresAt: h.expiresAt, labels: h.labels, seats: h.seats, items: h.items } : null;
+      return await this.bestAvailableOrThrow(qty, categoryKey);
     } catch (err) {
       this.opts.onError?.(err);
       return null;
     }
   }
+  /** @internal Throwing variant of {@link bestAvailable} for the native host adapter. See {@link holdOrThrow}. */
+  async bestAvailableOrThrow(qty, categoryKey) {
+    const h = await this.controller.bestAvailable(qty, categoryKey);
+    return h ? { holdId: h.holdId, expiresAt: h.expiresAt, labels: h.labels, seats: h.seats, items: h.items } : null;
+  }
   /**
    * Choose a ticket tier for a selected seat (e.g. Adult → Child). The seat's
    * available `tiers` are on each `SelectedSeat` from `getSelection()` /
@@ -335,6 +396,7 @@ var SeatingChart = class {
     this.hostEl = null;
     this.mount = null;
     this.rendered = false;
+    this.mode_ = null;
   }
 };