seatlayer 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6aa9b6c1e8985b0f261f5e0bf7743148a2fcf5dc3c9f9585b482d78e24b492a5
-  data.tar.gz: 70b5fb6fd1f3eb7cbed9d80917a7e1ef56d212c1bafb924e97a961878e71e906
+  metadata.gz: 0d51f4f004070a397c4ac39e08f183df2c8a72dca70c35ce1ef61042d247b30c
+  data.tar.gz: a37f6748bf6d656ee1b5daa4902609678bf039992766c9fa9dce7742e4ee47f8
 SHA512:
-  metadata.gz: 21ab307cdbc1676e6d463c3bb990ebe886f5d38906b988d129d1f5a722c4199ffeb80938b582e3d7b906fe287b9ea5a190dda5043200f27f569fc0c2d2aab7f1
-  data.tar.gz: d4d261bb2e9240a49bf373fd9faa63896fac970f9fb7a9f5c7583becce1c26a445f45ff623115463e833587f0a58be1762990864dba1066139c384d62d85005e
+  metadata.gz: 25dfd25bc366329bb38f52f59522dde781225df50fcfe5b6c523e9b7af3ab54d16aa22b6c6ea022b8e65d5e98b1a8dcbabd04c3716026cc257918c0fa3b9ce73
+  data.tar.gz: 98af014bd435e3f5ee7233c5b3c8feeb9b4ed950e9df55b5c1be4ec1dc94506657cb83c0149202c9421bbf223efb760ad15fb713ea88797222326b435236f41c

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.0 — 2026-08-12
+
+- Added the `channels` resource for allocation management, access previews,
+  channel reporting, and origin-bound buyer access sessions.
+- Added inventory booking lifecycle reads and channel-aware hold/book options.
+- Require a non-empty stable booking reference for booking, unbooking, and
+  booking-detail reads.
+- Expanded registry, documentation, and agent-discovery links in the README.
+
 ## 0.1.0 — 2026-08-04
 
 First public release: RubyGems `seatlayer`.

data/README.md

@@ -74,6 +74,27 @@ client.inventory.book_best_available(event_key, qty: 2, booking_ref: "phone-1183
 client.inventory.box_office_book(event_key, labels: ["A-1", "A-2"], booking_ref: "comp-14")
 ```
 
+## Private and partner sales
+
+Channels split event inventory into explicit allocations. A channel id is
+reporting/routing metadata, not browser authority. Authenticate the buyer in
+your backend and mint a short-lived token restricted to the event, origin, and
+allowed allocations:
+
+```ruby
+access = client.channels.create_buyer_access_session(
+  event_key,
+  channel_ids: ["chn_partner_a"],
+  include_public: false,
+  allowed_origin: "https://tickets.example"
+)
+# Return access["token"] to the in-memory buyerAccessTokenProvider only.
+```
+
+Never log or persist the returned `bse_…` bearer. Allocation setup, previews,
+pause/archive controls, audit-safe session listing, and channel reports are on
+`client.channels`.
+
 ## Listing and pagination
 
 `list` returns one page plus a `nextCursor`. `list_all` pages for you and returns a lazy
@@ -243,7 +264,8 @@ 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` |
 | `events` | `list` `list_all` `create` `retrieve` `update` `delete` `update_chart` `close` `reopen` `archive` `retrieve_hold_ttl` `update_hold_ttl` `retrieve_report` `retrieve_log` |
-| `inventory` | `hold` `hold_best_available` `book_best_available` `extend_hold` `retrieve_hold` `release` `book` `box_office_book` `unbook` `block` `unblock` `unblock_all` `retrieve_availability` `update_availability` |
+| `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` |
 | `sessions` | `create_manage_session` `revoke_manage_session` `create_designer_session` `revoke_designer_session` |
 | `webhooks` | `list` `create` `update` `delete` `list_deliveries` |
 | `workspaces` | `list` `create` `retrieve` `update` |
@@ -273,24 +295,25 @@ the public manifest, not just from the wrapper.
 - [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)
 
 ### Other SeatLayer SDKs
 
 | Surface | Package |
 |---|---|
-| Browser (vanilla) | [`@seatlayer/js`](https://github.com/seatlayer/seatlayer-sdk) |
-| React | [`@seatlayer/react`](https://github.com/seatlayer/seatlayer-sdk) |
-| React Native | [`@seatlayer/react-native`](https://github.com/seatlayer/seatlayer-react-native) |
+| Browser (vanilla) | [`@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_flutter`](https://github.com/seatlayer/seatlayer-flutter) |
-| Node.js (server) | [`@seatlayer/server`](https://github.com/seatlayer/seatlayer-node) |
-| Python (server) | [`seatlayer`](https://github.com/seatlayer/seatlayer-python) |
-| PHP (server) | [`seatlayer/seatlayer-php`](https://github.com/seatlayer/seatlayer-php) |
-| Java (server) | [`io.seatlayer:seatlayer-java`](https://github.com/seatlayer/seatlayer-java) |
-| Go (server) | [`github.com/seatlayer/seatlayer-go`](https://github.com/seatlayer/seatlayer-go) |
-| .NET (server) | [`SeatLayer`](https://github.com/seatlayer/seatlayer-dotnet) |
+| Flutter | [`seatlayer`](https://pub.dev/packages/seatlayer) |
+| 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.1.0) |
+| Go (server) | [`github.com/seatlayer/seatlayer-go`](https://pkg.go.dev/github.com/seatlayer/seatlayer-go) |
+| .NET (server) | [`SeatLayer`](https://www.nuget.org/packages/SeatLayer) |
 
 ## Development
 

data/lib/seatlayer/channels.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module SeatLayer
+  # Private allocations, reporting, and origin-bound buyer access.
+  class Channels < Resource
+    def list_channels(event_key, include_archived: false)
+      query = include_archived ? { "includeArchived" => "1" } : nil
+      @client.get(path(event_key), query)
+    end
+
+    def create_channel(event_key, name:, color: nil, marker: nil, external_ref: nil,
+                       access_intent: nil, reason: nil, idempotency_key: nil)
+      body = compact({ "name" => name, "color" => color, "marker" => marker,
+                       "externalRef" => external_ref, "accessIntent" => access_intent,
+                       "reason" => reason })
+      @client.post(path(event_key), body, idempotency_key: idempotency_key)
+    end
+
+    def update_channel(event_key, channel_id, name: nil, access_intent: nil,
+                       acknowledge_live_access: nil, reason: nil)
+      body = compact({ "name" => name, "accessIntent" => access_intent,
+                       "acknowledgeLiveAccess" => acknowledge_live_access, "reason" => reason })
+      @client.patch(path(event_key, "/#{encode(channel_id)}"), body)
+    end
+
+    def update_assignments(event_key, labels:, assignment_version:, target_channel_id: nil,
+                           reason: nil, idempotency_key: nil)
+      body = compact({ "targetChannelId" => target_channel_id, "labels" => labels,
+                       "assignmentVersion" => assignment_version, "reason" => reason })
+      body["targetChannelId"] = nil if target_channel_id.nil?
+      @client.post(path(event_key, "/assignments"), body, idempotency_key: idempotency_key)
+    end
+
+    def list_allocation(event_key, after_label: nil, limit: nil)
+      @client.get(path(event_key, "/allocation"), compact({ "afterLabel" => after_label, "limit" => limit }))
+    end
+
+    def retrieve_access_preview(event_key, channel_ids: nil, include_public: nil)
+      include_public_value = if include_public.nil?
+                               nil
+                             else
+                               include_public ? "1" : "0"
+                             end
+      query = compact({ "channelIds" => channel_ids&.join(","),
+                        "includePublic" => include_public_value })
+      @client.get(path(event_key, "/preview"), query)
+    end
+
+    def retrieve_report(event_key) = @client.get(path(event_key, "/report"))
+
+    def pause(event_key, channel_id, reason: nil)
+      @client.post(path(event_key, "/#{encode(channel_id)}/pause"), compact({ "reason" => reason }))
+    end
+
+    def unpause(event_key, channel_id, reason: nil)
+      @client.post(path(event_key, "/#{encode(channel_id)}/unpause"), compact({ "reason" => reason }))
+    end
+
+    def archive(event_key, channel_id, destination:, reason: nil)
+      body = compact({ "reason" => reason })
+      body["destination"] = destination
+      @client.post(path(event_key, "/#{encode(channel_id)}/archive"), body)
+    end
+
+    # Explicit keywords document each security boundary carried by the token.
+    # rubocop:disable Metrics/ParameterLists
+    def create_buyer_access_session(event_key, include_public:, allowed_origin:, channel_ids: nil,
+                                    expires_in_seconds: nil, max_quantity: nil, buyer_ref: nil,
+                                    partner_ref: nil, client_request_id: nil, idempotency_key: nil)
+      body = compact({ "channelIds" => channel_ids, "includePublic" => include_public,
+                       "allowedOrigin" => allowed_origin, "expiresInSeconds" => expires_in_seconds,
+                       "maxQuantity" => max_quantity, "buyerRef" => buyer_ref,
+                       "partnerRef" => partner_ref, "clientRequestId" => client_request_id })
+      @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, state: nil, limit: nil, cursor: nil)
+      @client.get("/v1/events/#{encode(event_key)}/buyer-access-sessions",
+                  compact({ "state" => state, "limit" => limit, "cursor" => cursor }))
+    end
+
+    def revoke_buyer_access_session(event_key, session_id)
+      @client.delete("/v1/events/#{encode(event_key)}/buyer-access-sessions/#{encode(session_id)}")
+    end
+
+    private
+
+    def path(event_key, suffix = "") = "/v1/events/#{encode(event_key)}/channels#{suffix}"
+  end
+end

data/lib/seatlayer/inventory.rb

@@ -11,10 +11,16 @@ module SeatLayer
   # Never price from what the browser tells you. +retrieve_hold+ is the
   # authoritative answer, which is why it is a separate call.
   class Inventory < Resource
+    # Explicit keywords keep allocation authority visible at every sale call.
+    # rubocop:disable Metrics/ParameterLists
     def hold(event_key, labels: nil, selections: nil, ttl_ms: nil,
-             replace_hold_id: nil, idempotency_key: nil)
+             replace_hold_id: nil, channel_ids: nil, ignore_channel_restrictions: nil,
+             reason: nil, idempotency_key: nil)
       body = compact({ "labels" => labels, "selections" => selections,
-                       "ttlMs" => ttl_ms, "replaceHoldId" => replace_hold_id })
+                       "ttlMs" => ttl_ms, "replaceHoldId" => replace_hold_id,
+                       "channelIds" => channel_ids,
+                       "ignoreChannelRestrictions" => ignore_channel_restrictions,
+                       "reason" => reason })
       @client.post(path(event_key, "/hold"), body, idempotency_key: idempotency_key)
     end
 
@@ -24,9 +30,13 @@ module SeatLayer
     # order get the same answer for the same inventory. A +qty+ above the server
     # cap is clamped, not rejected.
     def hold_best_available(event_key, qty:, category_key: nil, zone_id: nil,
-                            ttl_ms: nil, idempotency_key: nil)
+                            ttl_ms: nil, channel_ids: nil, ignore_channel_restrictions: nil,
+                            reason: nil, idempotency_key: nil)
       body = compact({ "qty" => qty, "categoryKey" => category_key,
-                       "zoneId" => zone_id, "ttlMs" => ttl_ms })
+                       "zoneId" => zone_id, "ttlMs" => ttl_ms,
+                       "channelIds" => channel_ids,
+                       "ignoreChannelRestrictions" => ignore_channel_restrictions,
+                       "reason" => reason })
       @client.post(path(event_key, "/best-available"), body, idempotency_key: idempotency_key)
     end
 
@@ -35,11 +45,16 @@ module SeatLayer
     # Prefer this over hold-then-book when payment is already taken: a failure
     # between two calls would strand inventory until the TTL expired.
     def book_best_available(event_key, qty:, booking_ref:, category_key: nil,
-                            zone_id: nil, idempotency_key: nil)
-      body = compact({ "qty" => qty, "bookingRef" => booking_ref,
-                       "categoryKey" => category_key, "zoneId" => zone_id })
+                            zone_id: nil, channel_ids: nil, ignore_channel_restrictions: nil,
+                            reason: nil, idempotency_key: nil)
+      body = compact({ "qty" => qty, "bookingRef" => normalise_booking_ref(booking_ref),
+                       "categoryKey" => category_key, "zoneId" => zone_id,
+                       "channelIds" => channel_ids,
+                       "ignoreChannelRestrictions" => ignore_channel_restrictions,
+                       "reason" => reason })
       @client.post(path(event_key, "/best-available-book"), body, idempotency_key: idempotency_key)
     end
+    # rubocop:enable Metrics/ParameterLists
 
     # Push an active hold's expiry out by a fresh window before it lapses.
     #
@@ -60,20 +75,26 @@ module SeatLayer
       @client.post(path(event_key, "/release"), { "labels" => labels, "holdId" => hold_id })
     end
 
-    def book(event_key, hold_id: nil, labels: nil, booking_ref: nil, idempotency_key: nil)
-      body = compact({ "holdId" => hold_id, "labels" => labels, "bookingRef" => booking_ref })
+    def book(event_key, hold_id: nil, labels: nil, booking_ref: nil, channel_ids: nil,
+             ignore_channel_restrictions: nil, reason: nil, idempotency_key: nil)
+      body = compact({ "holdId" => hold_id, "labels" => labels,
+                       "bookingRef" => normalise_booking_ref(booking_ref),
+                       "channelIds" => channel_ids,
+                       "ignoreChannelRestrictions" => ignore_channel_restrictions,
+                       "reason" => reason })
       @client.post(path(event_key, "/book"), body, idempotency_key: idempotency_key)
     end
 
     def box_office_book(event_key, labels:, booking_ref:, idempotency_key: nil)
       @client.post(path(event_key, "/box-book"),
-                   { "labels" => labels, "bookingRef" => booking_ref },
+                   { "labels" => labels, "bookingRef" => normalise_booking_ref(booking_ref) },
                    idempotency_key: idempotency_key)
     end
 
     # Reverse a booking. Requires a key with cancel authority.
-    def unbook(event_key, labels:)
-      @client.post(path(event_key, "/unbook"), { "labels" => labels })
+    def unbook(event_key, labels:, booking_ref:)
+      @client.post(path(event_key, "/unbook"),
+                   { "labels" => labels, "bookingRef" => normalise_booking_ref(booking_ref) })
     end
 
     # Hold inventory back from sale (house seats, production holds).
@@ -97,11 +118,28 @@ module SeatLayer
       @client.post(path(event_key, "/availability"), fields)
     end
 
+    # One page of inventory booking lifecycles, newest first.
+    def list_bookings(event_key, query: nil, state: nil, limit: nil, cursor: nil)
+      @client.get(path(event_key, "/bookings"),
+                  compact({ "q" => query, "state" => state, "limit" => limit, "cursor" => cursor }))
+    end
+
+    def retrieve_booking(event_key, booking_ref)
+      @client.get(path(event_key, "/bookings/#{encode(normalise_booking_ref(booking_ref))}"))
+    end
+
     private
 
     def path(event_key, suffix)
       "/v1/events/#{encode(event_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
 
   # Short-lived, origin-bound browser tokens.

data/lib/seatlayer/version.rb

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

data/lib/seatlayer.rb

@@ -5,6 +5,7 @@ require_relative "seatlayer/errors"
 require_relative "seatlayer/http_client"
 require_relative "seatlayer/resources"
 require_relative "seatlayer/inventory"
+require_relative "seatlayer/channels"
 require_relative "seatlayer/webhook"
 
 # Official Ruby server SDK for the SeatLayer reserved-seating API.
@@ -18,7 +19,7 @@ require_relative "seatlayer/webhook"
 module SeatLayer
   # The SeatLayer client.
   class Client
-    attr_reader :charts, :events, :inventory, :sessions, :webhooks, :workspaces
+    attr_reader :charts, :events, :inventory, :channels, :sessions, :webhooks, :workspaces
 
     def initialize(secret_key, base_url: HTTPClient::DEFAULT_BASE_URL,
                    max_retries: HTTPClient::DEFAULT_MAX_RETRIES,
@@ -29,6 +30,7 @@ module SeatLayer
       @charts = Charts.new(@http)
       @events = Events.new(@http)
       @inventory = Inventory.new(@http)
+      @channels = Channels.new(@http)
       @sessions = Sessions.new(@http)
       @webhooks = Webhooks.new(@http)
       @workspaces = Workspaces.new(@http)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: seatlayer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - SeatLayer
@@ -21,6 +21,7 @@ files:
 - LICENSE
 - README.md
 - lib/seatlayer.rb
+- lib/seatlayer/channels.rb
 - lib/seatlayer/errors.rb
 - lib/seatlayer/http_client.rb
 - lib/seatlayer/inventory.rb