@seatlayer/js 0.87.0 → 0.88.1

package/dist/index.d.cts

@@ -516,14 +516,22 @@ declare class ApiError extends Error {
     /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */
     reason?: string;
     /**
-     * Seconds the server asked the caller to wait, off a 429's `Retry-After`.
+     * Seconds the server asked the caller to wait, off a 429's or a 503's
+     * `Retry-After`.
      *
-     * Present ONLY on a rate-limit error, and it is the server's number — never a
-     * guess. A widget that catches this can say "try again in N seconds" instead
-     * of rendering the blank map a swallowed 429 used to produce.
+     * Present ONLY on a rate-limit or maintenance error, and it is the server's
+     * number — never a guess. A widget that catches this can say "try again in
+     * N minutes" instead of rendering the blank map a swallowed 429 used to
+     * produce, or the "seats were just taken" a maintenance 503 used to become.
      */
     retryAfterS?: number;
-    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number);
+    /**
+     * Operator-written buyer copy that arrived with a maintenance 503 (the API's
+     * `notice`). Shown verbatim when present; absent, the widget uses its own
+     * localised wording built from `retryAfterS`.
+     */
+    notice?: string;
+    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string);
 }
 interface HoldResult {
     holdId: string;
@@ -1192,6 +1200,16 @@ interface SeatPickerOptions {
      * owns hold persistence and supplies initialHoldId itself.
      */
     restoreHold?: boolean;
+    /**
+     * What happens to an active hold when the picker is closed or destroyed
+     * before checkout. `'release'` (default) frees the seats on the server at
+     * once. `'keep'` leaves the hold running for its remaining time and, with
+     * `restoreHold`, resumes it the next time this event's picker mounts, so a
+     * buyer who closes the map by accident finds their seats still held. The
+     * buyer can still give seats back with the remove control on each ticket,
+     * and the hold expires on its own timer.
+     */
+    holdOnClose?: 'release' | 'keep';
     /**
      * Render the real chart and live seat statuses without allowing selection,
      * holds or checkout. This is for venue previews and pre-sale Website pages;

package/dist/index.d.ts

@@ -516,14 +516,22 @@ declare class ApiError extends Error {
     /** Present when best-available 409s ('not_enough_together' | 'sold_out'). */
     reason?: string;
     /**
-     * Seconds the server asked the caller to wait, off a 429's `Retry-After`.
+     * Seconds the server asked the caller to wait, off a 429's or a 503's
+     * `Retry-After`.
      *
-     * Present ONLY on a rate-limit error, and it is the server's number — never a
-     * guess. A widget that catches this can say "try again in N seconds" instead
-     * of rendering the blank map a swallowed 429 used to produce.
+     * Present ONLY on a rate-limit or maintenance error, and it is the server's
+     * number — never a guess. A widget that catches this can say "try again in
+     * N minutes" instead of rendering the blank map a swallowed 429 used to
+     * produce, or the "seats were just taken" a maintenance 503 used to become.
      */
     retryAfterS?: number;
-    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number);
+    /**
+     * Operator-written buyer copy that arrived with a maintenance 503 (the API's
+     * `notice`). Shown verbatim when present; absent, the widget uses its own
+     * localised wording built from `retryAfterS`.
+     */
+    notice?: string;
+    constructor(status: number, message: string, code?: string, conflicts?: HoldConflict[], reason?: string, retryAfterS?: number, notice?: string);
 }
 interface HoldResult {
     holdId: string;
@@ -1192,6 +1200,16 @@ interface SeatPickerOptions {
      * owns hold persistence and supplies initialHoldId itself.
      */
     restoreHold?: boolean;
+    /**
+     * What happens to an active hold when the picker is closed or destroyed
+     * before checkout. `'release'` (default) frees the seats on the server at
+     * once. `'keep'` leaves the hold running for its remaining time and, with
+     * `restoreHold`, resumes it the next time this event's picker mounts, so a
+     * buyer who closes the map by accident finds their seats still held. The
+     * buyer can still give seats back with the remove control on each ticket,
+     * and the hold expires on its own timer.
+     */
+    holdOnClose?: 'release' | 'keep';
     /**
      * Render the real chart and live seat statuses without allowing selection,
      * holds or checkout. This is for venue previews and pre-sale Website pages;