@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.
- package/README.md +73 -31
- 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`:
|
|
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.
|
|
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
|
-
###
|
|
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
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
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>`
|
|
366
|
-
tree, with no iframe
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
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
|
-
|
|
375
|
-
|
|
376
|
-
|
|
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.
|
|
384
|
-
`holdId` and priced line items, your backend charges through
|
|
385
|
-
you already use,
|
|
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
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
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
|
|
406
|
-
|
|
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
|
-
|
|
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.
|
|
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.
|
|
78
|
-
"@seatlayer/js": "0.
|
|
77
|
+
"@seatlayer/core": "0.113.0",
|
|
78
|
+
"@seatlayer/js": "0.113.0"
|
|
79
79
|
},
|
|
80
80
|
"peerDependencies": {
|
|
81
81
|
"vue": ">=3.3.0"
|