@seatlayer/angular 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 +74 -29
- package/dist/README.md +74 -29
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -27,8 +27,9 @@ also re-exports the plain JavaScript `SeatPickerWidget` class and the
|
|
|
27
27
|
|
|
28
28
|
- `SeatLayerSeatingChartComponent`: one standalone Angular component with the
|
|
29
29
|
`seatlayer-seating-chart` selector.
|
|
30
|
-
- `SeatLayerSeasonPickerComponent`:
|
|
31
|
-
|
|
30
|
+
- `SeatLayerSeasonPickerComponent`: season tickets, with the
|
|
31
|
+
`seatlayer-season-picker` selector. The buyer picks a seat once and holds it
|
|
32
|
+
on every date of the season; returning holders can say they will renew.
|
|
32
33
|
- `SeatLayerSeatManagerComponent`: the organizer control room, for dashboards
|
|
33
34
|
that monitor and block live inventory, with the `seatlayer-seat-manager`
|
|
34
35
|
selector. It lives on its own entry, `@seatlayer/angular/manager`, so a buyer
|
|
@@ -52,6 +53,21 @@ npm install @seatlayer/angular
|
|
|
52
53
|
|
|
53
54
|
The component is **standalone**: import it directly, no NgModule needed.
|
|
54
55
|
|
|
56
|
+
## Upgrading to 0.113.0
|
|
57
|
+
|
|
58
|
+
Nothing needs a code change, and no type changed. What a buyer sees:
|
|
59
|
+
|
|
60
|
+
- **A short server stall heals on its own.** A hold, release or resume that
|
|
61
|
+
gets no answer is sent again (at most three tries, seven seconds of waiting),
|
|
62
|
+
and the map's first load tries again for up to about 30 seconds while the
|
|
63
|
+
picker says it is taking longer. A real outage still ends on the same panel
|
|
64
|
+
and Try again button, only later.
|
|
65
|
+
- **"Check your connection and try again."** A hold or best-available that
|
|
66
|
+
still gets no answer says this and keeps the selection, where it used to say
|
|
67
|
+
the seats were taken.
|
|
68
|
+
- **One version of the SDK.** If your app also installs `@seatlayer/js`
|
|
69
|
+
itself, move it to 0.113.0 as well.
|
|
70
|
+
|
|
55
71
|
## Upgrading to 0.112.0
|
|
56
72
|
|
|
57
73
|
Nothing needs a code change, and nothing changes for a page that already works.
|
|
@@ -143,7 +159,7 @@ hold. These tools do not take payment or book seats. See the
|
|
|
143
159
|
[buyer WebMCP seat-selection guide](https://docs.seatlayer.io/buyer-sdk/webmcp-agent-tools/)
|
|
144
160
|
for the full contract and iframe origin controls.
|
|
145
161
|
|
|
146
|
-
###
|
|
162
|
+
### Season tickets: the same seat on every date
|
|
147
163
|
|
|
148
164
|
```html
|
|
149
165
|
<seatlayer-season-picker
|
|
@@ -377,63 +393,92 @@ and holds come from the SeatLayer API at runtime.
|
|
|
377
393
|
|
|
378
394
|
## Frequently asked questions
|
|
379
395
|
|
|
396
|
+
### Which Angular seating chart component can I use?
|
|
397
|
+
|
|
398
|
+
`@seatlayer/angular` gives you a standalone seat map component
|
|
399
|
+
(`SeatLayerSeatingChartComponent`) and a ready buyer modal (`SeatPickerWidget`),
|
|
400
|
+
with seat holds, best available, season tickets and, on every plan, a 3D view
|
|
401
|
+
from each seat for venues up to 60,000 seats. A 200,000-seat stadium chart is
|
|
402
|
+
ready in 1.95 s on desktop, and the same charts run in React, Vue, iOS,
|
|
403
|
+
Android, Flutter and React Native. You pay only for sold seats, and your own
|
|
404
|
+
server and payment provider keep the order and the money.
|
|
405
|
+
|
|
380
406
|
### How do I add a seat map to an Angular app?
|
|
381
407
|
|
|
382
408
|
Install `@seatlayer/angular`, import the standalone
|
|
383
|
-
`SeatLayerSeatingChartComponent
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
409
|
+
`SeatLayerSeatingChartComponent` and put `<seatlayer-seating-chart>` in a block
|
|
410
|
+
with a definite height: you get a live seat map with seat holds, best available
|
|
411
|
+
and the 3D view from each seat on charts up to 60,000 seats. For the ready buyer
|
|
412
|
+
modal with its priced tray, hold timer and checkout hand-off, call
|
|
413
|
+
`SeatPickerWidget.open()`. Call `holdSelection()` from your own button and
|
|
414
|
+
handle `(hold)`; your server then books the hold.
|
|
388
415
|
|
|
389
416
|
### Is this a real Angular component or an iframe?
|
|
390
417
|
|
|
391
418
|
`SeatLayerSeatingChartComponent` is a real standalone Angular component whose
|
|
392
|
-
template is a plain `<div>` in your own tree, with no iframe
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
419
|
+
template is a plain `<div>` in your own tree, with no iframe. Its render loop
|
|
420
|
+
and pointer handlers run outside the Angular zone and re-enter it only to emit,
|
|
421
|
+
so a running chart does not trigger change detection on every frame. If you
|
|
422
|
+
would rather embed the buyer picker in an iframe, `attachPickerFrame` is
|
|
423
|
+
exported for that.
|
|
397
424
|
|
|
398
425
|
### How do temporary seat holds work?
|
|
399
426
|
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
427
|
+
In the SeatLayer picker, a buyer's seats are held when they go to checkout;
|
|
428
|
+
with the bare chart, your code calls `holdSelection()`, which reserves that
|
|
429
|
+
inventory against concurrent buyers for a limited checkout window and returns
|
|
430
|
+
an opaque `holdId`. The hold lapses on its own if checkout never completes.
|
|
403
431
|
`(holdExpired)` tells the app to return the buyer to the map, and
|
|
404
432
|
`resumeHold()` restores it after a same-tab checkout navigation or a reload.
|
|
405
433
|
This is what prevents double-selling without locking seats forever.
|
|
406
434
|
|
|
407
435
|
### Can I use my own payment provider?
|
|
408
436
|
|
|
409
|
-
Yes.
|
|
410
|
-
`holdId` and priced line items, your backend charges through
|
|
411
|
-
you already use,
|
|
412
|
-
[server-side checkout flow](https://docs.seatlayer.io/buyer-sdk/holds-and-checkout/).
|
|
437
|
+
Yes. By default nothing in this package takes a payment. The browser hands your
|
|
438
|
+
code a `holdId` and priced line items, and your backend charges through the
|
|
439
|
+
provider you already use, then books the hold.
|
|
413
440
|
|
|
414
441
|
### Can I evaluate it without a SeatLayer account?
|
|
415
442
|
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
443
|
+
Yes. The live Grand Theatre demo runs in your browser with no account. To show
|
|
444
|
+
your own venue you need an event key, and test mode is free with no time limit
|
|
445
|
+
and no card: test events, holds and webhooks work like production and use no
|
|
446
|
+
credits.
|
|
447
|
+
|
|
448
|
+
### How much does the SeatLayer SDK cost?
|
|
449
|
+
|
|
450
|
+
Building and testing is free, and going live costs $0. You pay one credit per
|
|
451
|
+
sold seat: the first 100 sold seats each month are free, then 10¢ down to 5¢ a
|
|
452
|
+
seat, with no subscription, and credits you buy never expire. Browsing the map,
|
|
453
|
+
holds and the 3D view never use a credit.
|
|
454
|
+
|
|
455
|
+
### Can I sell season tickets with it?
|
|
456
|
+
|
|
457
|
+
Yes. `SeatLayerSeasonPickerComponent` (`<seatlayer-season-picker>`) holds the
|
|
458
|
+
same seat on every date of a season in one step, with best available across
|
|
459
|
+
every date and a price type such as adult or child for each seat, and returning
|
|
460
|
+
holders can tell you they will renew. The hand-off
|
|
461
|
+
carries no price; by default your server applies the package price and books
|
|
462
|
+
it, and the opt-in `checkout: 'hosted'` takes the payment through SeatLayer's
|
|
463
|
+
checkout instead, into the organizer's own payment account. It is in `@seatlayer/angular` 0.72.0 and newer.
|
|
421
464
|
|
|
422
465
|
## Continue your Angular integration
|
|
423
466
|
|
|
424
467
|
- [Follow the buyer SDK installation guide](https://docs.seatlayer.io/buyer-sdk/install/)
|
|
425
468
|
for the full browser integration, options, and events.
|
|
469
|
+
- [Read the seat picker documentation](https://docs.seatlayer.io/buyer-sdk/seat-picker/)
|
|
470
|
+
for inputs, outputs, holds, and checkout in depth.
|
|
426
471
|
- [Connect seat holds to secure server-side checkout](https://docs.seatlayer.io/buyer-sdk/holds-and-checkout/)
|
|
427
472
|
without putting booking credentials in the browser.
|
|
428
473
|
- [Run the complete checkout example](https://docs.seatlayer.io/examples/complete-checkout/)
|
|
429
474
|
to connect a buyer hold id to payment and idempotent booking.
|
|
430
475
|
- [Compare SeatLayer's mobile seat map SDKs](https://docs.seatlayer.io/buyer-sdk/mobile/)
|
|
431
|
-
when the same event also has to
|
|
432
|
-
|
|
476
|
+
when the same event also has to appear in your iOS, Android, Flutter or React
|
|
477
|
+
Native app.
|
|
433
478
|
- [Use the separate `@seatlayer/js` EmbeddedDesigner API](https://docs.seatlayer.io/platform/embedded-designer/)
|
|
434
479
|
when organizers need hosted chart editing inside an Angular product.
|
|
435
|
-
- [Explore the 3D seating chart](https://seatlayer.io/3d-seat-map/) for the
|
|
436
|
-
|
|
480
|
+
- [Explore the 3D seating chart](https://seatlayer.io/3d-seat-map/) for the 3D
|
|
481
|
+
venue and the view from each seat, which `SeatLayerSeatingChartComponent`, the Season picker and `SeatPickerWidget` all offer in supported browsers. 3D is offered for venues up to 60,000 seats.
|
|
437
482
|
- [Point AI coding agents at the SeatLayer docs index](https://docs.seatlayer.io/llms.txt)
|
|
438
483
|
(`llms.txt`) for an agent-readable map of the documentation.
|
|
439
484
|
|
package/dist/README.md
CHANGED
|
@@ -27,8 +27,9 @@ also re-exports the plain JavaScript `SeatPickerWidget` class and the
|
|
|
27
27
|
|
|
28
28
|
- `SeatLayerSeatingChartComponent`: one standalone Angular component with the
|
|
29
29
|
`seatlayer-seating-chart` selector.
|
|
30
|
-
- `SeatLayerSeasonPickerComponent`:
|
|
31
|
-
|
|
30
|
+
- `SeatLayerSeasonPickerComponent`: season tickets, with the
|
|
31
|
+
`seatlayer-season-picker` selector. The buyer picks a seat once and holds it
|
|
32
|
+
on every date of the season; returning holders can say they will renew.
|
|
32
33
|
- `SeatLayerSeatManagerComponent`: the organizer control room, for dashboards
|
|
33
34
|
that monitor and block live inventory, with the `seatlayer-seat-manager`
|
|
34
35
|
selector. It lives on its own entry, `@seatlayer/angular/manager`, so a buyer
|
|
@@ -52,6 +53,21 @@ npm install @seatlayer/angular
|
|
|
52
53
|
|
|
53
54
|
The component is **standalone**: import it directly, no NgModule needed.
|
|
54
55
|
|
|
56
|
+
## Upgrading to 0.113.0
|
|
57
|
+
|
|
58
|
+
Nothing needs a code change, and no type changed. What a buyer sees:
|
|
59
|
+
|
|
60
|
+
- **A short server stall heals on its own.** A hold, release or resume that
|
|
61
|
+
gets no answer is sent again (at most three tries, seven seconds of waiting),
|
|
62
|
+
and the map's first load tries again for up to about 30 seconds while the
|
|
63
|
+
picker says it is taking longer. A real outage still ends on the same panel
|
|
64
|
+
and Try again button, only later.
|
|
65
|
+
- **"Check your connection and try again."** A hold or best-available that
|
|
66
|
+
still gets no answer says this and keeps the selection, where it used to say
|
|
67
|
+
the seats were taken.
|
|
68
|
+
- **One version of the SDK.** If your app also installs `@seatlayer/js`
|
|
69
|
+
itself, move it to 0.113.0 as well.
|
|
70
|
+
|
|
55
71
|
## Upgrading to 0.112.0
|
|
56
72
|
|
|
57
73
|
Nothing needs a code change, and nothing changes for a page that already works.
|
|
@@ -143,7 +159,7 @@ hold. These tools do not take payment or book seats. See the
|
|
|
143
159
|
[buyer WebMCP seat-selection guide](https://docs.seatlayer.io/buyer-sdk/webmcp-agent-tools/)
|
|
144
160
|
for the full contract and iframe origin controls.
|
|
145
161
|
|
|
146
|
-
###
|
|
162
|
+
### Season tickets: the same seat on every date
|
|
147
163
|
|
|
148
164
|
```html
|
|
149
165
|
<seatlayer-season-picker
|
|
@@ -377,63 +393,92 @@ and holds come from the SeatLayer API at runtime.
|
|
|
377
393
|
|
|
378
394
|
## Frequently asked questions
|
|
379
395
|
|
|
396
|
+
### Which Angular seating chart component can I use?
|
|
397
|
+
|
|
398
|
+
`@seatlayer/angular` gives you a standalone seat map component
|
|
399
|
+
(`SeatLayerSeatingChartComponent`) and a ready buyer modal (`SeatPickerWidget`),
|
|
400
|
+
with seat holds, best available, season tickets and, on every plan, a 3D view
|
|
401
|
+
from each seat for venues up to 60,000 seats. A 200,000-seat stadium chart is
|
|
402
|
+
ready in 1.95 s on desktop, and the same charts run in React, Vue, iOS,
|
|
403
|
+
Android, Flutter and React Native. You pay only for sold seats, and your own
|
|
404
|
+
server and payment provider keep the order and the money.
|
|
405
|
+
|
|
380
406
|
### How do I add a seat map to an Angular app?
|
|
381
407
|
|
|
382
408
|
Install `@seatlayer/angular`, import the standalone
|
|
383
|
-
`SeatLayerSeatingChartComponent
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
409
|
+
`SeatLayerSeatingChartComponent` and put `<seatlayer-seating-chart>` in a block
|
|
410
|
+
with a definite height: you get a live seat map with seat holds, best available
|
|
411
|
+
and the 3D view from each seat on charts up to 60,000 seats. For the ready buyer
|
|
412
|
+
modal with its priced tray, hold timer and checkout hand-off, call
|
|
413
|
+
`SeatPickerWidget.open()`. Call `holdSelection()` from your own button and
|
|
414
|
+
handle `(hold)`; your server then books the hold.
|
|
388
415
|
|
|
389
416
|
### Is this a real Angular component or an iframe?
|
|
390
417
|
|
|
391
418
|
`SeatLayerSeatingChartComponent` is a real standalone Angular component whose
|
|
392
|
-
template is a plain `<div>` in your own tree, with no iframe
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
419
|
+
template is a plain `<div>` in your own tree, with no iframe. Its render loop
|
|
420
|
+
and pointer handlers run outside the Angular zone and re-enter it only to emit,
|
|
421
|
+
so a running chart does not trigger change detection on every frame. If you
|
|
422
|
+
would rather embed the buyer picker in an iframe, `attachPickerFrame` is
|
|
423
|
+
exported for that.
|
|
397
424
|
|
|
398
425
|
### How do temporary seat holds work?
|
|
399
426
|
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
427
|
+
In the SeatLayer picker, a buyer's seats are held when they go to checkout;
|
|
428
|
+
with the bare chart, your code calls `holdSelection()`, which reserves that
|
|
429
|
+
inventory against concurrent buyers for a limited checkout window and returns
|
|
430
|
+
an opaque `holdId`. The hold lapses on its own if checkout never completes.
|
|
403
431
|
`(holdExpired)` tells the app to return the buyer to the map, and
|
|
404
432
|
`resumeHold()` restores it after a same-tab checkout navigation or a reload.
|
|
405
433
|
This is what prevents double-selling without locking seats forever.
|
|
406
434
|
|
|
407
435
|
### Can I use my own payment provider?
|
|
408
436
|
|
|
409
|
-
Yes.
|
|
410
|
-
`holdId` and priced line items, your backend charges through
|
|
411
|
-
you already use,
|
|
412
|
-
[server-side checkout flow](https://docs.seatlayer.io/buyer-sdk/holds-and-checkout/).
|
|
437
|
+
Yes. By default nothing in this package takes a payment. The browser hands your
|
|
438
|
+
code a `holdId` and priced line items, and your backend charges through the
|
|
439
|
+
provider you already use, then books the hold.
|
|
413
440
|
|
|
414
441
|
### Can I evaluate it without a SeatLayer account?
|
|
415
442
|
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
443
|
+
Yes. The live Grand Theatre demo runs in your browser with no account. To show
|
|
444
|
+
your own venue you need an event key, and test mode is free with no time limit
|
|
445
|
+
and no card: test events, holds and webhooks work like production and use no
|
|
446
|
+
credits.
|
|
447
|
+
|
|
448
|
+
### How much does the SeatLayer SDK cost?
|
|
449
|
+
|
|
450
|
+
Building and testing is free, and going live costs $0. You pay one credit per
|
|
451
|
+
sold seat: the first 100 sold seats each month are free, then 10¢ down to 5¢ a
|
|
452
|
+
seat, with no subscription, and credits you buy never expire. Browsing the map,
|
|
453
|
+
holds and the 3D view never use a credit.
|
|
454
|
+
|
|
455
|
+
### Can I sell season tickets with it?
|
|
456
|
+
|
|
457
|
+
Yes. `SeatLayerSeasonPickerComponent` (`<seatlayer-season-picker>`) holds the
|
|
458
|
+
same seat on every date of a season in one step, with best available across
|
|
459
|
+
every date and a price type such as adult or child for each seat, and returning
|
|
460
|
+
holders can tell you they will renew. The hand-off
|
|
461
|
+
carries no price; by default your server applies the package price and books
|
|
462
|
+
it, and the opt-in `checkout: 'hosted'` takes the payment through SeatLayer's
|
|
463
|
+
checkout instead, into the organizer's own payment account. It is in `@seatlayer/angular` 0.72.0 and newer.
|
|
421
464
|
|
|
422
465
|
## Continue your Angular integration
|
|
423
466
|
|
|
424
467
|
- [Follow the buyer SDK installation guide](https://docs.seatlayer.io/buyer-sdk/install/)
|
|
425
468
|
for the full browser integration, options, and events.
|
|
469
|
+
- [Read the seat picker documentation](https://docs.seatlayer.io/buyer-sdk/seat-picker/)
|
|
470
|
+
for inputs, outputs, holds, and checkout in depth.
|
|
426
471
|
- [Connect seat holds to secure server-side checkout](https://docs.seatlayer.io/buyer-sdk/holds-and-checkout/)
|
|
427
472
|
without putting booking credentials in the browser.
|
|
428
473
|
- [Run the complete checkout example](https://docs.seatlayer.io/examples/complete-checkout/)
|
|
429
474
|
to connect a buyer hold id to payment and idempotent booking.
|
|
430
475
|
- [Compare SeatLayer's mobile seat map SDKs](https://docs.seatlayer.io/buyer-sdk/mobile/)
|
|
431
|
-
when the same event also has to
|
|
432
|
-
|
|
476
|
+
when the same event also has to appear in your iOS, Android, Flutter or React
|
|
477
|
+
Native app.
|
|
433
478
|
- [Use the separate `@seatlayer/js` EmbeddedDesigner API](https://docs.seatlayer.io/platform/embedded-designer/)
|
|
434
479
|
when organizers need hosted chart editing inside an Angular product.
|
|
435
|
-
- [Explore the 3D seating chart](https://seatlayer.io/3d-seat-map/) for the
|
|
436
|
-
|
|
480
|
+
- [Explore the 3D seating chart](https://seatlayer.io/3d-seat-map/) for the 3D
|
|
481
|
+
venue and the view from each seat, which `SeatLayerSeatingChartComponent`, the Season picker and `SeatPickerWidget` all offer in supported browsers. 3D is offered for venues up to 60,000 seats.
|
|
437
482
|
- [Point AI coding agents at the SeatLayer docs index](https://docs.seatlayer.io/llms.txt)
|
|
438
483
|
(`llms.txt`) for an agent-readable map of the documentation.
|
|
439
484
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@seatlayer/angular",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.113.0",
|
|
4
4
|
"description": "SeatLayer's official Angular 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": {
|
|
@@ -36,8 +36,8 @@
|
|
|
36
36
|
"typescript"
|
|
37
37
|
],
|
|
38
38
|
"dependencies": {
|
|
39
|
-
"@seatlayer/core": "0.
|
|
40
|
-
"@seatlayer/js": "0.
|
|
39
|
+
"@seatlayer/core": "0.113.0",
|
|
40
|
+
"@seatlayer/js": "0.113.0",
|
|
41
41
|
"tslib": "^2.8.1"
|
|
42
42
|
},
|
|
43
43
|
"peerDependencies": {
|