@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.
Files changed (3) hide show
  1. package/README.md +74 -29
  2. package/dist/README.md +74 -29
  3. 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`: fixed-inclusion Season selection and
31
- returning-holder intent with the `seatlayer-season-picker` selector.
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
- ### Fixed renewable Season
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`, and put `<seatlayer-seating-chart
384
- event="ev_…">` on screen inside a block with a definite height. That is a
385
- complete interactive seating chart with live availability; the
386
- [seat-picker documentation](https://docs.seatlayer.io/buyer-sdk/seat-picker/)
387
- covers inputs, outputs, holds, and checkout in depth.
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 and no stylesheet of
393
- its own. Its render loop and pointer handlers are created outside the Angular
394
- zone and re-enter it only to emit, so a running chart does not schedule change
395
- detection on every frame. If you would rather embed the buyer picker in an iframe,
396
- `attachPickerFrame` is exported for that.
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
- When a buyer commits to a selection, `holdSelection()` 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.
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. Nothing in this package takes a payment. The browser hands your code a
410
- `holdId` and priced line items, your backend charges through whatever provider
411
- you already use, and it then books the hold through the
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
- You can explore a live seating chart in the browser at the
417
- [buyer seat-map demo](https://app.seatlayer.io/demo/play/grand-theatre) with no
418
- account. Rendering your own venue needs an event key, because the chart and its
419
- availability are served by the SeatLayer API: create a free test event for
420
- that, which books no real inventory.
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 render in native iOS, Android, Flutter, or
432
- React Native apps.
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
- interactive venue view available through `SeatPickerWidget` in supported browsers.
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`: fixed-inclusion Season selection and
31
- returning-holder intent with the `seatlayer-season-picker` selector.
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
- ### Fixed renewable Season
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`, and put `<seatlayer-seating-chart
384
- event="ev_…">` on screen inside a block with a definite height. That is a
385
- complete interactive seating chart with live availability; the
386
- [seat-picker documentation](https://docs.seatlayer.io/buyer-sdk/seat-picker/)
387
- covers inputs, outputs, holds, and checkout in depth.
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 and no stylesheet of
393
- its own. Its render loop and pointer handlers are created outside the Angular
394
- zone and re-enter it only to emit, so a running chart does not schedule change
395
- detection on every frame. If you would rather embed the buyer picker in an iframe,
396
- `attachPickerFrame` is exported for that.
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
- When a buyer commits to a selection, `holdSelection()` 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.
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. Nothing in this package takes a payment. The browser hands your code a
410
- `holdId` and priced line items, your backend charges through whatever provider
411
- you already use, and it then books the hold through the
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
- You can explore a live seating chart in the browser at the
417
- [buyer seat-map demo](https://app.seatlayer.io/demo/play/grand-theatre) with no
418
- account. Rendering your own venue needs an event key, because the chart and its
419
- availability are served by the SeatLayer API: create a free test event for
420
- that, which books no real inventory.
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 render in native iOS, Android, Flutter, or
432
- React Native apps.
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
- interactive venue view available through `SeatPickerWidget` in supported browsers.
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.112.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.112.0",
40
- "@seatlayer/js": "0.112.0",
39
+ "@seatlayer/core": "0.113.0",
40
+ "@seatlayer/js": "0.113.0",
41
41
  "tslib": "^2.8.1"
42
42
  },
43
43
  "peerDependencies": {