@seatlayer/js 0.86.13 → 0.88.0

package/README.md

@@ -89,6 +89,29 @@ together. Login, presale, partner, and channel inventory instead use
 backend; either explicit credential takes precedence over `publicKey`. Managed
 public/unlisted events retain anonymous event-key access and omit `publicKey`.
 
+### Prewarm on intent
+
+That bootstrap is the one round trip everything else waits behind, and a buyer
+signals the open before they make it. `SeatPicker.prewarm` (or the
+`prewarmSeatPicker` function export) starts it from a hover or a pointerdown,
+so the answer is already in flight when the picker mounts:
+
+```js
+import { SeatPicker } from '@seatlayer/js';
+
+const seating = { event: 'ev_9f3a', publicKey: 'pk_live_…' };
+button.addEventListener('pointerenter', () => SeatPicker.prewarm(seating));
+button.addEventListener('pointerdown', () => SeatPicker.prewarm(seating));
+button.addEventListener('click', () => SeatPicker.open({ ...seating }));
+```
+
+The page still makes exactly one bootstrap request: the picker's first read
+joins the one already in flight, or takes its completed answer. Calling it
+repeatedly is free, it never throws, and a prewarm that fails simply is not
+there when the picker mounts — the mount then behaves as it does without one.
+It applies to `publicKey` mounts; options carrying a custom `transport`,
+`buyerAccessToken` or `buyerAccessTokenProvider` are a no-op.
+
 ## Fixed Renewable Season
 
 `SeasonPicker` is supported in `@seatlayer/js` `0.72.0` and newer. It is an SDK
@@ -467,6 +490,9 @@ Lifecycle/hold methods: `render()`, `hold()`, `bestAvailable(qty, categoryKey?)`
 The full `SeatPicker` automatically restores an active hold after same-tab
 checkout navigation and lets the buyer remove individual held tickets. Set
 `restoreHold: false` and pass `initialHoldId` when your host owns persistence.
+Closing the picker before checkout releases an active hold; `holdOnClose: 'keep'`
+leaves it running for the rest of its window instead, so a buyer who dismissed
+the map by accident gets the same seats back on the next mount.
 
 The browser **holds**; your **server books** with a secret key. See
 [how the integration works](https://docs.seatlayer.io/start/how-it-works/).