broadcast-ruby 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 046bdebddc0d68f63776039530a40783734df10ca736d3f8212f598f72927c12
-  data.tar.gz: 5f1e53c5af9d8654410849eaf485e3f45657e02fb30cb575254585e49eda88e6
+  metadata.gz: fb053f3cf4c48c55c7ea1f4726c73812de80e1a2dd97b0a80ba4bd4948e15a06
+  data.tar.gz: fadde8872a91a8570d8b538ccfb9a8ffeb7cec7e534a9b52d4a47d1eb720a692
 SHA512:
-  metadata.gz: 718ae1afd1950d245ae33084763e96fcc9c186ca56ebe6e4f44a8109b944bf8674d87ca9357ac9782c6ebac6ee4f8e46a6a92a86053c1dc73099c13fa5a1fb8d
-  data.tar.gz: d61a1d23973470942c06de04d732b01d0df32e3ab098f88ac7b82d68b68a142535de1ab93085f53cf0b18a4981f1c52b0d77c91c3217db2a566d774d9e0be10b
+  metadata.gz: cfad85e945cf6caf51a385121854be78858569d41e92f8bf4590394553717dc27d1beb378d8f7d189ab27188dbcab21d74041a2cae851d2c2d922838436b06e3
+  data.tar.gz: d9914cc148094332e3b666947ae496669587c4580119bd3aa47f9470337119223ea1a87c6714b96872c826dc27b45c9cf5a72fdd03993eeba3ac3011a6414005

data/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.12.0] - 2026-11-11
+
+### Added
+
+- `client.channels` (`client.discovery.channels`): the channels the token can reach, `GET /api/v1/channels`
+  (Broadcast 3.1). Every channel for an admin token, its own channel for a channel token, with `token_type`.
+
 ## [0.11.0] - 2026-11-07
 
 ### Removed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    broadcast-ruby (0.11.0)
+    broadcast-ruby (0.12.0)
       base64
 
 GEM
@@ -177,7 +177,7 @@ CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
   bigdecimal (4.0.1) sha256=8b07d3d065a9f921c80ceaea7c9d4ae596697295b584c296fe599dd0ad01c4a7
-  broadcast-ruby (0.11.0)
+  broadcast-ruby (0.12.0)
   builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
   concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a

data/README.md

@@ -2,7 +2,7 @@
 
 Official Ruby client for [Broadcast](https://sendbroadcast.net), the self-hosted email marketing platform.
 
-Works with any Broadcast instance — self-hosted or SaaS. Covers **104/104 API operations**, verified against the API's generated OpenAPI document.
+Works with any self-hosted Broadcast instance. Covers **123/123 API operations** of Broadcast 3.1, verified against the API's generated OpenAPI document.
 
 📖 **[Ruby SDK documentation](https://sendbroadcast.net/docs/ruby-sdk)** · [API reference](https://sendbroadcast.net/docs/api-authentication) · [All docs](https://sendbroadcast.net/docs)
 
@@ -1231,6 +1231,14 @@ client.with_channel(2) do
 end
 ```
 
+To find the channel ids, list the channels the token can reach (Broadcast 3.1 or later):
+
+```ruby
+client.channels['channels'].each do |channel|
+  client.with_channel(channel['id']) { client.subscribers.list }
+end
+```
+
 `with_channel` overrides the config-level value inside the block. Per-call `broadcast_channel_id:` always wins over both. The override is thread-local, so it's safe to share a `Client` instance across threads.
 
 ---

data/lib/broadcast/client.rb

@@ -81,6 +81,10 @@ module Broadcast
       discovery.openapi
     end
 
+    def channels
+      discovery.channels
+    end
+
     # --- Resource sub-clients ---
 
     def subscribers

data/lib/broadcast/resources/discovery.rb

@@ -19,6 +19,15 @@ module Broadcast
         get('/api/v1/status')
       end
 
+      # The channels this token can reach (Broadcast 3.1 or later): every
+      # channel for an admin token, its own channel for a channel token.
+      # Returns a Hash with `token_type` and `channels` (each `id`, `name`,
+      # `slug`, `active`). An admin token then names one with #with_channel or
+      # `broadcast_channel_id:`. A plugin developer token is refused.
+      def channels
+        get('/api/v1/channels')
+      end
+
       # Full capability manifest: platform version, token permissions, channel
       # status, the endpoint list the token can reach, rate limit, and usage tips.
       def prime

data/lib/broadcast/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Broadcast
-  VERSION = '0.11.0'
+  VERSION = '0.12.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: broadcast-ruby
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Simon Chiu