@seatlayer/vue 0.112.0 → 0.113.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +73 -31
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -27,7 +27,8 @@ also re-exports the plain JavaScript `SeatPickerWidget` class and the
27
27
 
28
28
  - `SeatingChart`: one Vue 3 component wrapper (`SeatLayerSeatingChart`), written
29
29
  as a render function so no Vue compiler plugin is needed.
30
- - `SeasonPicker`: fixed-inclusion Season selection and returning-holder intent.
30
+ - `SeasonPicker`: season tickets. The buyer picks a seat once and holds it on
31
+ every date of the season; returning holders can say they will renew.
31
32
  - `SeatManager`: the organizer control room, for dashboards that monitor and
32
33
  block live inventory. It lives on its own entry, `@seatlayer/vue/manager`, so
33
34
  a buyer app never carries it.
@@ -48,9 +49,24 @@ also re-exports the plain JavaScript `SeatPickerWidget` class and the
48
49
  npm install @seatlayer/vue
49
50
  ```
50
51
 
52
+ ## Upgrading to 0.113.0
53
+
54
+ Nothing needs a code change, and no type changed. What a buyer sees:
55
+
56
+ - **A short server stall heals on its own.** A hold, release or resume that
57
+ gets no answer is sent again (at most three tries, seven seconds of waiting),
58
+ and the map's first load tries again for up to about 30 seconds while the
59
+ picker says it is taking longer. A real outage still ends on the same panel
60
+ and Try again button, only later.
61
+ - **"Check your connection and try again."** A hold or best-available that
62
+ still gets no answer says this and keeps the selection, where it used to say
63
+ the seats were taken.
64
+ - **One version of the SDK.** If your app also installs `@seatlayer/js`
65
+ itself, move it to 0.113.0 as well.
66
+
51
67
  ## Upgrading to 0.112.0
52
68
 
53
- Nothing needs a code change. Three things to know:
69
+ Nothing needs a code change. Four things to know:
54
70
 
55
71
  - **`SeatingChart` and `SeasonPicker` now honour `enable3D`, `enable3DCrowd`
56
72
  and `touchNavigation3D`.** Before 0.112.0 they were not props, so a value
@@ -100,7 +116,6 @@ async function checkout() {
100
116
  public-key="pk_live_your_publishable_key"
101
117
  style="width: 100%; height: 520px"
102
118
  @selection-change="onSelectionChange"
103
- @hold="({ holdId }) => bookOnYourServer(holdId)"
104
119
  />
105
120
  <button @click="checkout">Continue</button>
106
121
  </template>
@@ -144,7 +159,7 @@ hold. These tools do not take payment or book seats. See the
144
159
  [buyer WebMCP seat-selection guide](https://docs.seatlayer.io/buyer-sdk/webmcp-agent-tools/)
145
160
  for the full contract and iframe origin controls.
146
161
 
147
- ### Fixed renewable Season
162
+ ### Season tickets: the same seat on every date
148
163
 
149
164
  ```vue
150
165
  <SeasonPicker
@@ -352,62 +367,89 @@ availability, and holds come from the SeatLayer API at runtime.
352
367
 
353
368
  ## Frequently asked questions
354
369
 
370
+ ### Which Vue seating chart component can I use?
371
+
372
+ `@seatlayer/vue` gives you a live seat map (`SeatingChart`) and a ready buyer
373
+ modal (`SeatPickerWidget`), with seat holds, best available, season tickets
374
+ and, on every plan, a 3D view from each seat for venues up to 60,000 seats. A
375
+ 200,000-seat stadium chart is ready in 1.95 s on desktop, and the same charts
376
+ run in React, Angular, iOS, Android, Flutter and React Native. You pay only for
377
+ sold seats, and your own server and payment provider keep the order and the
378
+ money.
379
+
355
380
  ### How do I add a seat map to a Vue app?
356
381
 
357
- Install `@seatlayer/vue`, render `<SeatingChart event="ev_…" />` in a container
358
- with a definite height, and handle `@selection-change`. That is a complete
359
- interactive seating chart with live availability; the
360
- [seat-picker documentation](https://docs.seatlayer.io/buyer-sdk/seat-picker/)
361
- covers props, events, holds, and checkout in depth.
382
+ Install `@seatlayer/vue` and render `SeatingChart` for a live seat map inside
383
+ your own Vue UI, with seat holds, best available and the 3D view from each seat
384
+ on charts up to 60,000 seats. For the ready buyer modal with its priced tray,
385
+ hold timer and checkout hand-off, call `SeatPickerWidget.open()`. Give the
386
+ container a definite height, call `hold()` from your own button and handle
387
+ `@hold`; your server then books the hold.
362
388
 
363
389
  ### Is this a real Vue component or an iframe?
364
390
 
365
- `SeatingChart` is a Vue 3 component that renders a plain `<div>` into your own
366
- tree, with no iframe and no stylesheet of its own. It is written as a render
367
- function rather than a single-file component, so it needs no Vue compiler
368
- plugin. Use it on the client in Vite, Nuxt, or another Vue 3 bundler. If you
369
- would rather embed the buyer picker in an iframe, `attachPickerFrame` is
370
- exported for that.
391
+ `SeatingChart` is a Vue 3 component that renders into a plain `<div>` in your
392
+ own tree, with no iframe. It is written as a render function rather than a
393
+ single-file component, so it needs no Vue compiler plugin, and it runs on the
394
+ client in Vite, Nuxt or another Vue 3 bundler. If you would rather embed the
395
+ buyer picker in an iframe, `attachPickerFrame` is exported for that.
371
396
 
372
397
  ### How do temporary seat holds work?
373
398
 
374
- When a buyer commits to a selection, `hold()` reserves that inventory against
375
- concurrent buyers for a limited checkout window and returns an opaque `holdId`.
376
- The hold lapses on its own if checkout never completes. `@hold-expired` tells
399
+ In the SeatLayer picker, a buyer's seats are held when they go to checkout;
400
+ with the bare chart, your code calls `hold()`, which reserves that inventory
401
+ against concurrent buyers for a limited checkout window and returns an opaque
402
+ `holdId`. The hold lapses on its own if checkout never completes. `@hold-expired` tells
377
403
  the app to return the buyer to the map, and `resumeHold()` restores it after a
378
404
  same-tab checkout navigation or a reload. This is what prevents double-selling
379
405
  without locking seats forever.
380
406
 
381
407
  ### Can I use my own payment provider?
382
408
 
383
- Yes. Nothing in this package takes a payment. The browser hands your code a
384
- `holdId` and priced line items, your backend charges through whatever provider
385
- you already use, and it then books the hold through the
386
- [server-side checkout flow](https://docs.seatlayer.io/buyer-sdk/holds-and-checkout/).
409
+ Yes. By default nothing in this package takes a payment. The browser hands your
410
+ code a `holdId` and priced line items, and your backend charges through the
411
+ provider you already use, then books the hold.
387
412
 
388
413
  ### Can I evaluate it without a SeatLayer account?
389
414
 
390
- You can explore a live seating chart in the browser at the
391
- [buyer seat-map demo](https://app.seatlayer.io/demo/play/grand-theatre) with no
392
- account. Rendering your own venue needs an event key, because the chart and its
393
- availability are served by the SeatLayer API: create a free test event for
394
- that, which books no real inventory.
415
+ Yes. The live Grand Theatre demo runs in your browser with no account. To show
416
+ your own venue you need an event key, and test mode is free with no time limit
417
+ and no card: test events, holds and webhooks work like production and use no
418
+ credits.
419
+
420
+ ### How much does the SeatLayer SDK cost?
421
+
422
+ Building and testing is free, and going live costs $0. You pay one credit per
423
+ sold seat: the first 100 sold seats each month are free, then 10¢ down to 5¢ a
424
+ seat, with no subscription, and credits you buy never expire. Browsing the map,
425
+ holds and the 3D view never use a credit.
426
+
427
+ ### Can I sell season tickets with it?
428
+
429
+ Yes. `SeasonPicker` holds the same seat on every date of a season in one step,
430
+ with best available across every date and a price type such as adult or child
431
+ for each seat, and returning holders can tell you they will renew. The hand-off
432
+ carries no price; by default your server applies the package price and books
433
+ it, and the opt-in `checkout: 'hosted'` takes the payment through SeatLayer's
434
+ checkout instead, into the organizer's own payment account. `SeasonPicker` is in `@seatlayer/vue` 0.72.0 and newer.
395
435
 
396
436
  ## Continue your Vue integration
397
437
 
398
438
  - [Follow the buyer SDK installation guide](https://docs.seatlayer.io/buyer-sdk/install/)
399
439
  for the full browser integration, options, and events.
440
+ - [Read the seat picker documentation](https://docs.seatlayer.io/buyer-sdk/seat-picker/)
441
+ for props, events, holds, and checkout in depth.
400
442
  - [Connect seat holds to secure server-side checkout](https://docs.seatlayer.io/buyer-sdk/holds-and-checkout/)
401
443
  without putting booking credentials in the browser.
402
444
  - [Run the complete checkout example](https://docs.seatlayer.io/examples/complete-checkout/)
403
445
  to connect a buyer hold id to payment and idempotent booking.
404
446
  - [Compare SeatLayer's mobile seat map SDKs](https://docs.seatlayer.io/buyer-sdk/mobile/)
405
- when the same event also has to render in native iOS, Android, Flutter, or
406
- React Native apps.
447
+ when the same event also has to appear in your iOS, Android, Flutter or React
448
+ Native app.
407
449
  - [Use the separate `@seatlayer/js` EmbeddedDesigner API](https://docs.seatlayer.io/platform/embedded-designer/)
408
450
  when organizers need hosted chart editing inside a Vue product.
409
- - [Explore the 3D seating chart](https://seatlayer.io/3d-seat-map/) for the
410
- interactive venue view available through `SeatPickerWidget` in supported browsers.
451
+ - [Explore the 3D seating chart](https://seatlayer.io/3d-seat-map/) for the 3D
452
+ venue and the view from each seat, which `SeatingChart`, `SeasonPicker` and `SeatPickerWidget` all offer in supported browsers. 3D is offered for venues up to 60,000 seats.
411
453
  - [Point AI coding agents at the SeatLayer docs index](https://docs.seatlayer.io/llms.txt)
412
454
  (`llms.txt`) for an agent-readable map of the documentation.
413
455
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seatlayer/vue",
3
- "version": "0.112.0",
3
+ "version": "0.113.0",
4
4
  "description": "SeatLayer's official Vue seating chart and seat map SDK: live availability, seat selection, temporary holds, and a typed TypeScript API for ticketing apps.",
5
5
  "license": "MIT",
6
6
  "author": {
@@ -74,8 +74,8 @@
74
74
  "typescript"
75
75
  ],
76
76
  "dependencies": {
77
- "@seatlayer/core": "0.112.0",
78
- "@seatlayer/js": "0.112.0"
77
+ "@seatlayer/core": "0.113.0",
78
+ "@seatlayer/js": "0.113.0"
79
79
  },
80
80
  "peerDependencies": {
81
81
  "vue": ">=3.3.0"