seatlayer 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7fdf50105cfef210f1afd2ae7073ce1b1da6c17a9ab3754204f3ebce145dcea7
-  data.tar.gz: 415f72edd18e2d97e603a563e2b33f4d920ae03f9e649e42bac287860cb4a3de
+  metadata.gz: a0ac6e36b23b34e28d914944c5a15cf08dabb40f9b31466740b4b04b99cec1c6
+  data.tar.gz: cabf4e47e42d39f2fe9f9ef0d001ff8043428702982f41d4c20f04f70cd333f9
 SHA512:
-  metadata.gz: ab1db651d6aafa3d2c2c238bc3ddab90d8c8d4c103bcd581fb34993e9aa25f0bc9028b8071cd992985d4ea641a03daa4b91349a3f1cafb815302ed0c6fdbb2c2
-  data.tar.gz: afc024d09db7ddeffc1fe399c04241e17f33a8fa52066d3372beae5032cd1cd08248214cea641a66a8c707919910f5d06e4ec766adbcd2bf12ed928b326dfff1
+  metadata.gz: eef04285447d411a1ab752e670136491716bc27284cbb5a825670ff9eca7d292de3ed473b842ce4c4a7af3925dd278353cb48683dd9029d371c03b11c76f30b0
+  data.tar.gz: f86eacb6d08d744362d0d84cc802720a4c5a04b9134b70950a1051cf4f4d1b3266744b356374895340b1c782a7fcc32e5b49a45e59e845a70bf84d0159cc6148

data/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-## Unreleased
+## 0.6.0 — 2026-08-23
+
+- Added exact immutable Event configuration binding reads and compare-and-set
+  attach/detach through `events.retrieve_configuration_binding` and
+  `events.update_configuration_binding`. Updates remain deliberately single-attempt.
+
+## 0.5.0 — 2026-08-21
+
+- Added `performance_groups`, the trusted server resource for fixed two-to-eight
+  performance runs. It creates and activates groups, mints one-time browser
+  access, retrieves authoritative group holds, and confirms bookings with
+  stable action and order references. Browser-only group routes remain outside
+  this secret-key SDK.
 
 - Added `templates.instantiate_template` and the ticket-release lifecycle on
   `events` (`list_ticket_releases`, `update_ticket_releases`, and

data/README.md

@@ -291,7 +291,7 @@ client.request("POST", "/v1/events/ev_1/some-new-route", body: { "qty" => 2 })
 | --- | --- |
 | `charts` | `list` `list_all` `create` `retrieve` `update` `delete` `copy` `archive` `unarchive` `publish` |
 | `templates` | `instantiate_template` |
-| `events` | `list` `list_all` `create` `retrieve` `update` `delete` `update_poster` `delete_poster` `update_chart` `close` `reopen` `archive` `retrieve_hold_ttl` `update_hold_ttl` `list_ticket_releases` `update_ticket_releases` `close_ticket_release` `retrieve_report` `retrieve_log` |
+| `events` | `list` `list_all` `create` `retrieve` `retrieve_configuration_binding` `update_configuration_binding` `update` `delete` `update_poster` `delete_poster` `update_chart` `close` `reopen` `archive` `retrieve_hold_ttl` `update_hold_ttl` `list_ticket_releases` `update_ticket_releases` `close_ticket_release` `retrieve_report` `retrieve_log` |
 | `inventory` | `hold` `hold_best_available` `book_best_available` `extend_hold` `retrieve_hold` `release` `book` `box_office_book` `unbook` `list_bookings` `retrieve_booking` `block` `unblock` `unblock_all` `retrieve_availability` `update_availability` |
 | `channels` | `list_channels` `create_channel` `update_channel` `update_assignments` `list_allocation` `retrieve_access_preview` `retrieve_report` `pause` `unpause` `archive` `create_buyer_access_session` `list_buyer_access_sessions` `revoke_buyer_access_session` `create_access_link` `list_access_links` `rotate_access_link` `revoke_access_link` |
 | `sessions` | `create_manage_session` `revoke_manage_session` `create_designer_session` `revoke_designer_session` |

data/lib/seatlayer/performance_groups.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module SeatLayer
+  # Fixed multi-performance runs. This is a secret-key surface: mint the
+  # browser token here, then give that token (never this client) to the
+  # PerformanceGroupPicker in the browser SDK.
+  class PerformanceGroups < Resource
+    # One page of fixed runs.
+    def list(workspace_id: nil, external_ref: nil, state: nil, limit: nil, cursor: nil)
+      @client.get("/v1/performance-groups", compact({ "workspaceId" => workspace_id,
+                                                      "externalRef" => external_ref,
+                                                      "state" => state, "limit" => limit,
+                                                      "cursor" => cursor }))
+    end
+
+    # Create a draft from two to eight compatible assigned-seat events. The
+    # server validates compatibility and exactly replays a request with the
+    # same idempotency key.
+    def create(name:, event_keys:, external_ref: UNSET, idempotency_key: nil)
+      body = { "name" => name, "eventKeys" => event_keys }
+      body.merge!(supplied({ "externalRef" => external_ref }))
+      @client.post("/v1/performance-groups", body, idempotency_key: idempotency_key,
+                                                   retry_policy: :header_replay)
+    end
+
+    def retrieve(performance_group_key)
+      @client.get(path(performance_group_key))
+    end
+
+    # Only a draft can be deleted. Activated runs retain their audit identity.
+    def delete(performance_group_key)
+      @client.delete(path(performance_group_key))
+    end
+
+    # Starts lifecycle coordination. When its response contains a non-terminal
+    # lifecycle operation, poll +retrieve_lifecycle+ until it completes.
+    def activate(performance_group_key, expected_revision:)
+      @client.post(path(performance_group_key, "/activate"),
+                   { "expectedRevision" => expected_revision })
+    end
+
+    # Stops new group sales. Poll +retrieve_lifecycle+ while the close remains pending.
+    def close(performance_group_key, expected_revision:)
+      @client.post(path(performance_group_key, "/close"),
+                   { "expectedRevision" => expected_revision })
+    end
+
+    def retrieve_lifecycle(performance_group_key, operation_id)
+      @client.get(path(performance_group_key, "/lifecycle/#{encode(operation_id)}"))
+    end
+
+    # Reveals a one-time, origin-bound browser bearer. It intentionally remains
+    # single-attempt: a retry could create a token whose only reveal is lost.
+    def create_buyer_access_session(performance_group_key, allowed_origin:, include_public:,
+                                    channel_ids_by_event: nil, expires_in_seconds: nil,
+                                    max_quantity: UNSET, buyer_ref: UNSET, partner_ref: UNSET)
+      body = compact({ "allowedOrigin" => allowed_origin, "includePublic" => include_public,
+                       "channelIdsByEvent" => channel_ids_by_event,
+                       "expiresInSeconds" => expires_in_seconds })
+      body.merge!(supplied({ "maxQuantity" => max_quantity, "buyerRef" => buyer_ref,
+                             "partnerRef" => partner_ref }))
+      @client.post(path(performance_group_key, "/buyer-access-sessions"), body)
+    end
+
+    # Token records only: the bearer value is never returned again.
+    def list_buyer_access_sessions(performance_group_key, limit: nil)
+      @client.get(path(performance_group_key, "/buyer-access-sessions"), { "limit" => limit })
+    end
+
+    def revoke_buyer_access_session(performance_group_key, session_id)
+      @client.delete(path(performance_group_key, "/buyer-access-sessions/#{encode(session_id)}"))
+    end
+
+    # Read the trusted server projection before charging; do not price from
+    # client input or the picker state.
+    def retrieve_hold(performance_group_key, operation_id)
+      @client.get(path(performance_group_key, "/holds/#{encode(operation_id)}"))
+    end
+
+    # Confirm external payment for a committed hold. Keep both identifiers
+    # stable, and poll +retrieve_booking+ if the response is +book_pending+.
+    def book_hold(performance_group_key, operation_id, book_action_id:, booking_ref:)
+      @client.post(path(performance_group_key, "/holds/#{encode(operation_id)}/book"),
+                   { "bookActionId" => book_action_id,
+                     "bookingRef" => normalise_booking_ref(booking_ref) })
+    end
+
+    def retrieve_booking(performance_group_key, action_id)
+      @client.get(path(performance_group_key, "/bookings/#{encode(action_id)}"))
+    end
+
+    private
+
+    def path(performance_group_key, suffix = "")
+      "/v1/performance-groups/#{encode(performance_group_key)}#{suffix}"
+    end
+
+    def normalise_booking_ref(booking_ref)
+      value = booking_ref&.strip
+      return value unless value.nil? || value.empty?
+
+      raise ArgumentError, "booking_ref is required and must be a non-empty stable reference"
+    end
+  end
+end

data/lib/seatlayer/resources.rb

@@ -196,6 +196,21 @@ module SeatLayer
       @client.get("/v1/events/#{encode(event_key)}")
     end
 
+    # Read the Event's exact immutable configuration selection and audit trail.
+    def retrieve_configuration_binding(event_key)
+      @client.get("/v1/events/#{encode(event_key)}/event-configuration")
+    end
+
+    # Attach an exact published configuration version, or pass +nil+ to detach.
+    # The expected revision prevents one administrator from silently overwriting
+    # another, and the mutation remains deliberately single-attempt.
+    def update_configuration_binding(event_key, expected_revision:, configuration:)
+      @client.put(
+        "/v1/events/#{encode(event_key)}/event-configuration",
+        { "expectedRevision" => expected_revision, "configuration" => configuration }
+      )
+    end
+
     def update(event_key, fields)
       @client.patch("/v1/events/#{encode(event_key)}", fields)
     end

data/lib/seatlayer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SeatLayer
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/lib/seatlayer.rb

@@ -6,6 +6,7 @@ require_relative "seatlayer/http_client"
 require_relative "seatlayer/resources"
 require_relative "seatlayer/inventory"
 require_relative "seatlayer/channels"
+require_relative "seatlayer/performance_groups"
 require_relative "seatlayer/webhook"
 
 # Official Ruby server SDK for the SeatLayer reserved-seating API.
@@ -19,7 +20,8 @@ require_relative "seatlayer/webhook"
 module SeatLayer
   # The SeatLayer client.
   class Client
-    attr_reader :charts, :events, :inventory, :channels, :sessions, :webhooks, :workspaces, :templates
+    attr_reader :charts, :events, :inventory, :channels, :performance_groups, :sessions,
+                :webhooks, :workspaces, :templates
 
     def initialize(secret_key, base_url: HTTPClient::DEFAULT_BASE_URL,
                    max_retries: HTTPClient::DEFAULT_MAX_RETRIES,
@@ -31,6 +33,7 @@ module SeatLayer
       @events = Events.new(@http)
       @inventory = Inventory.new(@http)
       @channels = Channels.new(@http)
+      @performance_groups = PerformanceGroups.new(@http)
       @sessions = Sessions.new(@http)
       @templates = Templates.new(@http)
       @webhooks = Webhooks.new(@http)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: seatlayer
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - SeatLayer
@@ -25,6 +25,7 @@ files:
 - lib/seatlayer/errors.rb
 - lib/seatlayer/http_client.rb
 - lib/seatlayer/inventory.rb
+- lib/seatlayer/performance_groups.rb
 - lib/seatlayer/resources.rb
 - lib/seatlayer/version.rb
 - lib/seatlayer/webhook.rb