@seatlayer/js 0.25.0 → 0.26.0

package/dist/index.cjs

@@ -58,7 +58,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;
 }
@@ -131,6 +137,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;
@@ -184,6 +191,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");
@@ -257,6 +265,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();
@@ -264,17 +285,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);
@@ -291,23 +344,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()` /
@@ -368,6 +429,7 @@ var SeatingChart = class {
     this.hostEl = null;
     this.mount = null;
     this.rendered = false;
+    this.mode_ = null;
   }
 };