seatlayer 0.5.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ab55cb5752c5ddc06db43cfb1653248cebf2b0bd6c8b06be7b308653ca7f5cf
-  data.tar.gz: 44ec1f8c5e9f9da17e76c7e5913d1d1929ed4ca8be31d2fed6d24fc9d8521fe9
+  metadata.gz: abe617b9eff9a2dbeb571b81e16f8d41096b4cb4d49f35a3461f03b292316a87
+  data.tar.gz: d901b82e10dd7194b726f7c3d4b8f2d642030a1458c42ae7a851b200a9b0ef9a
 SHA512:
-  metadata.gz: f1252c05e9535563f4459383151d4dd8b8d9699766fbbce0fe453f21e020b310fe6d315f176aa071b3282af1f390a9cc1fd78b3d1efbdbe12d8f67f71249375f
-  data.tar.gz: 11f5318bd9b583d2b818446569d7f6b33285966a5dd7544045a03e2dad82a3325c685b51ae290a754a60182c067122eb8bb0999c03b0fe3403919eb21cfd1178
+  metadata.gz: d12c27e2f846f0aca0f95e8cc064723f9ad5ff37a83c64a854529db34a4b4651865011e3634a4eacd48bed9214e8ee64e1bccf162db24ca21d020f035cd6f091
+  data.tar.gz: e764024fd33ae0ca89714490934a7bbac28a2527a0ccee40a1892b1d2292f6945deb575c28b69665f77fcb04dd2ba987b1ce80cdb0b512236a497386563ee9c3

data/CHANGELOG.md

@@ -1,6 +1,15 @@
 # Changelog
 
-## Unreleased
+## 0.6.1
+
+- Documentation only. Refreshes the README, adds frequently asked
+  questions, and aligns package metadata. No API or behaviour changes.
+
+## 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
 

data/README.md

@@ -1,11 +1,20 @@
-# SeatLayer Ruby SDK
+# SeatLayer Ruby Server SDK for Reserved Seating
 
 [![CI](https://github.com/seatlayer/seatlayer-ruby/actions/workflows/ci.yml/badge.svg)](https://github.com/seatlayer/seatlayer-ruby/actions/workflows/ci.yml)
 [![Gem](https://img.shields.io/gem/v/seatlayer.svg)](https://rubygems.org/gems/seatlayer)
 [![Ruby](https://img.shields.io/badge/Ruby-%E2%89%A53.0-CC342D.svg)](https://www.ruby-lang.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-111827.svg)](LICENSE)
 
-Official Ruby server SDK for the [SeatLayer](https://seatlayer.io) reserved-seating API.
+The official SeatLayer Ruby server SDK — the trusted side of a reserved-seating
+integration. Inspect what a hold really contains, price from server-owned seating-chart
+data, and book with a stable `booking_ref`, while managing charts, events, inventory,
+allocations, and webhooks through one typed ticketing API client.
+
+[`seatlayer` gem on RubyGems](https://rubygems.org/gems/seatlayer) ·
+[SeatLayer server SDK documentation](https://docs.seatlayer.io/server-sdk/install/) ·
+[SeatLayer reserved-seating platform](https://seatlayer.io/) ·
+[SeatLayer JavaScript seat map SDK](https://www.npmjs.com/package/@seatlayer/js) ·
+[Server API reference](https://docs.seatlayer.io/server-api/)
 
 > **Server-side only.** This gem authenticates with your secret key. Never load it anywhere a
 > ticket buyer can reach — browser surfaces get short-lived, origin-bound tokens that you mint here.
@@ -291,7 +300,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` |
@@ -316,32 +325,80 @@ Some API surface is intentionally unwrapped, not merely pending:
 None of these are reachable through `request` as a supported path either — they are excluded from
 the public manifest, not just from the wrapper.
 
-## Related resources
-
-- [Server SDK guide](https://docs.seatlayer.io/server-sdk/install/)
-- [Errors, retries and idempotency](https://docs.seatlayer.io/server-sdk/reliability/)
-- [Webhook verification](https://docs.seatlayer.io/server-sdk/webhooks/)
-- [Server API reference](https://docs.seatlayer.io/server-api/events/)
-- [OpenAPI description](https://docs.seatlayer.io/openapi.json)
-- [Agent-readable documentation](https://docs.seatlayer.io/llms.txt)
-- [SeatLayer GitHub organization](https://github.com/seatlayer)
+## Frequently asked questions
+
+### How do I book seats from Ruby?
+
+Create a client with your secret key, obtain a hold id — either from the buyer's
+browser session or by holding server-side — and call `inventory.book(event_key, hold_id: ..., booking_ref: ...)`.
+`booking_ref` is your own stable order id and is the join between SeatLayer
+inventory and your commercial order, so the same reference identifies the booking
+in Booking History and when you later cancel it. For phone orders, box office, and
+comps, `inventory.book_best_available` books outright with no browser involved.
+
+### What does the server SDK do compared with the buyer SDK?
+
+The buyer SDK runs where the ticket buyer is: it renders the interactive seating
+chart, handles seat selection, and creates temporary holds. This server SDK is the
+trusted side. It authenticates with your secret key, inspects what a hold actually
+contains, prices from server-owned data, and books. Never bundle the secret key
+into a browser or a mobile app — browser surfaces get short-lived, origin-bound
+tokens that you mint here.
+
+### How do temporary holds work server-side?
+
+A hold reserves seats against concurrent buyers for a limited window.
+`inventory.retrieve_hold(event_key, hold_id)` is the authoritative answer for what is held
+and at what price, so charge from its `items` rather than from anything the browser
+sent you. When an order runs longer than the checkout window, `inventory.extend_hold`
+renews the hold instead of releasing and re-holding, which would hand the seats to
+whoever is racing for them. Bookings carry the server's exact-selection plus
+`booking_ref` safeguard, but the SDK sends each booking once — reconcile an unknown
+outcome before trying again.
+
+### Can I use my own payment provider?
+
+Yes. SeatLayer never processes payment. Inspect the hold, compute the charge from
+the returned `items` and their authoritative `unitPrice` and `currency`, take the
+money through whichever provider you already use — Stripe, Adyen, Razorpay, or your
+own — and then book the hold with your order id as `booking_ref`. SeatLayer owns
+seating state, holds, booking concurrency, and the inventory ledger; your platform
+owns payments, commercial orders, tickets, delivery, and refunds.
+
+## Continue your Ruby integration
+
+- [Follow the SeatLayer server SDK guide](https://docs.seatlayer.io/server-sdk/install/)
+  for installation, authentication, and the full hold-to-booking flow.
+- [Handle errors, retries, and safe booking repeats](https://docs.seatlayer.io/server-sdk/reliability/)
+  before connecting a production order flow.
+- [Verify SeatLayer webhooks](https://docs.seatlayer.io/server-sdk/webhooks/)
+  to react to holds, expiry, and bookings on your server.
+- [Browse the SeatLayer server API reference](https://docs.seatlayer.io/server-api/events/)
+  for every endpoint behind this SDK.
+- [Generate clients from the SeatLayer OpenAPI description](https://docs.seatlayer.io/openapi.json)
+  or explore the raw API surface.
+- [Point AI coding agents at the SeatLayer docs index](https://docs.seatlayer.io/llms.txt)
+  (`llms.txt`) for an agent-readable map of the documentation.
+- [Explore every SeatLayer SDK on GitHub](https://github.com/seatlayer)
+  across web, mobile, and server.
 
 ### Other SeatLayer SDKs
 
-| Surface | Package |
-|---|---|
-| Browser (vanilla) | [`@seatlayer/js`](https://www.npmjs.com/package/@seatlayer/js) |
+| Surface | Package or source |
+| --- | --- |
+| JavaScript | [`@seatlayer/js`](https://www.npmjs.com/package/@seatlayer/js) |
 | React | [`@seatlayer/react`](https://www.npmjs.com/package/@seatlayer/react) |
 | React Native | [`@seatlayer/react-native`](https://www.npmjs.com/package/@seatlayer/react-native) |
 | iOS | [`seatlayer-ios`](https://github.com/seatlayer/seatlayer-ios) |
-| Android | [`seatlayer-android`](https://github.com/seatlayer/seatlayer-android) |
 | Flutter | [`seatlayer`](https://pub.dev/packages/seatlayer) |
+| Android | [`seatlayer-android`](https://github.com/seatlayer/seatlayer-android) |
 | Node.js (server) | [`@seatlayer/server`](https://www.npmjs.com/package/@seatlayer/server) |
 | Python (server) | [`seatlayer`](https://pypi.org/project/seatlayer/) |
 | PHP (server) | [`seatlayer/seatlayer-php`](https://packagist.org/packages/seatlayer/seatlayer-php) |
-| Java (server) | [`io.seatlayer:seatlayer-java`](https://central.sonatype.com/artifact/io.seatlayer/seatlayer-java/0.3.0) |
-| Go (server) | [`github.com/seatlayer/seatlayer-go`](https://pkg.go.dev/github.com/seatlayer/seatlayer-go) |
+| Ruby (server) | [`seatlayer`](https://rubygems.org/gems/seatlayer) (this package) |
 | .NET (server) | [`SeatLayer`](https://www.nuget.org/packages/SeatLayer) |
+| Java (server) | [`io.seatlayer:seatlayer-java`](https://central.sonatype.com/artifact/io.seatlayer/seatlayer-java) |
+| Go (server) | [`github.com/seatlayer/seatlayer-go`](https://pkg.go.dev/github.com/seatlayer/seatlayer-go) |
 
 ## Development
 

data/lib/seatlayer/channels.rb

@@ -63,7 +63,7 @@ module SeatLayer
     end
 
     # Explicit keywords document each security boundary carried by the token.
-    # rubocop:disable Metrics/ParameterLists
+    # rubocop:disable-next Metrics/ParameterLists
     def create_buyer_access_session(event_key, include_public:, allowed_origin:, channel_ids: nil,
                                     expires_in_seconds: nil, max_quantity: UNSET, buyer_ref: UNSET,
                                     partner_ref: UNSET, client_request_id: UNSET, idempotency_key: nil)
@@ -75,7 +75,6 @@ module SeatLayer
       @client.post("/v1/events/#{encode(event_key)}/buyer-access-sessions", body,
                    idempotency_key: idempotency_key)
     end
-    # rubocop:enable Metrics/ParameterLists
 
     def list_buyer_access_sessions(event_key, limit: nil)
       @client.get("/v1/events/#{encode(event_key)}/buyer-access-sessions",
@@ -88,7 +87,7 @@ module SeatLayer
 
     # The URL and capability in this response are revealed once. Persist them
     # immediately; this mutation is deliberately never retried automatically.
-    # rubocop:disable Metrics/ParameterLists
+    # rubocop:disable-next Metrics/ParameterLists
     def create_access_link(event_key, channel_id, label: UNSET, expires_at: nil,
                            max_redemptions: nil, max_quantity: nil,
                            session_ttl_seconds: nil, include_public: nil, reason: nil,
@@ -101,7 +100,6 @@ module SeatLayer
       @client.post(path(event_key, "/#{encode(channel_id)}/access-links"), body,
                    idempotency_key: idempotency_key)
     end
-    # rubocop:enable Metrics/ParameterLists
 
     # Status only: the API never returns a previously revealed capability.
     def list_access_links(event_key, channel_id)

data/lib/seatlayer/inventory.rb

@@ -186,7 +186,7 @@ module SeatLayer
     # Mint a designer token so an organiser can edit a chart inside your own UI.
     # Requires a chart id that already exists — create or copy one first.
     # Explicit keywords keep each security and feature-policy boundary visible.
-    # rubocop:disable Metrics/ParameterLists
+    # rubocop:disable-next Metrics/ParameterLists
     def create_designer_session(workspace_id:, chart_id:, allowed_origin:,
                                 authority: nil, can_publish: nil, mode: nil,
                                 safe_mode_options: nil, features: nil, expires_in_seconds: nil)
@@ -197,7 +197,6 @@ module SeatLayer
                        "expiresInSeconds" => expires_in_seconds })
       @client.post("/v1/designer/sessions", body)
     end
-    # rubocop:enable Metrics/ParameterLists
 
     def revoke_designer_session(session_id)
       @client.delete("/v1/designer/sessions/#{encode(session_id)}")

data/lib/seatlayer/resources.rb

@@ -175,7 +175,7 @@ module SeatLayer
       end
     end
 
-    # rubocop:disable Metrics/ParameterLists
+    # rubocop:disable-next Metrics/ParameterLists
     def create(chart_id:, name: nil, slug: nil, starts_at: UNSET, venue: UNSET,
                external_ref: UNSET, currency: UNSET, idempotency_key: nil,
                description: UNSET, ends_at: UNSET, timezone: UNSET, locale: UNSET,
@@ -190,12 +190,26 @@ module SeatLayer
         "/v1/events", body, idempotency_key: idempotency_key, retry_policy: :header_replay
       )
     end
-    # rubocop:enable Metrics/ParameterLists
 
     def retrieve(event_key)
       @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.5.0"
+  VERSION = "0.6.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: seatlayer
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.1
 platform: ruby
 authors:
 - SeatLayer
@@ -9,8 +9,9 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: 'Server-side Ruby client for SeatLayer: charts, events, holds, booking,
-  embed sessions and webhook verification, with idempotency and retries built in.'
+description: 'Server-side Ruby client for SeatLayer reserved seating: seating charts,
+  events, seat maps, holds, seat booking, embed sessions and webhook verification,
+  with idempotency and retries built in.'
 email:
 - hello@seatlayer.io
 executables: []