slack-ruby-client 3.1.0 → 3.3.0

data/lib/slack/web/api/helpers/files.rb

@@ -45,12 +45,12 @@ module Slack
 
             files_to_upload.each_with_index do |file, index|
               %i[filename content].each do |param|
-                raise ArgumentError, "Required argument :#{param} missing in file (#{index})" if file[param].nil?
+                raise ArgumentError, "required argument :`#{param}` missing in file (`#{index}`)" if file[param].nil?
               end
             end
 
             channel_params = %i[channel channels channel_id].map { |param| params[param] }.compact
-            raise ArgumentError, 'Only one of :channel, :channels, or :channel_id is required' if channel_params.size > 1
+            raise ArgumentError, 'only one of :channel, :channels, or :channel_id is required' if channel_params.size > 1
 
             complete_upload_request_params = params.slice(:initial_comment, :blocks, :thread_ts)
 

data/lib/slack/web/api/mixins/conversations.id.rb

@@ -7,6 +7,7 @@ module Slack
       module Mixins
         module Conversations
           include Ids
+
           #
           # This method returns a channel ID given a channel name.
           #
@@ -24,7 +25,7 @@ module Slack
           #   containing one or more of public_channel, private_channel, mpim, im
           def conversations_id(options = {})
             name = options[:channel]
-            raise ArgumentError, 'Required arguments :channel missing' if name.nil?
+            raise ArgumentError, 'required arguments :channel missing' if name.nil?
 
             id_for(
               key: :channel,

data/lib/slack/web/api/mixins/ids.id.rb

@@ -15,7 +15,9 @@ module Slack
               end
             end
 
-            raise Slack::Web::Api::Errors::SlackError, "#{key}_not_found"
+            error_message = "#{key}_not_found"
+            error_class = Slack::Web::Api::Errors::ERROR_CLASSES[error_message] || Slack::Web::Api::Errors::SlackError
+            raise error_class, error_message
           end
         end
       end

data/lib/slack/web/api/mixins/users.id.rb

@@ -7,6 +7,7 @@ module Slack
       module Mixins
         module Users
           include Ids
+
           #
           # This method returns a user ID given a user name.
           #
@@ -19,7 +20,7 @@ module Slack
           #   The page size used for users_list calls required to find the user's ID
           def users_id(options = {})
             name = options[:user]
-            raise ArgumentError, 'Required arguments :user missing' if name.nil?
+            raise ArgumentError, 'required arguments :user missing' if name.nil?
 
             id_for(
               key: :user,

data/lib/slack/web/api/mixins/users.search.rb

@@ -14,7 +14,7 @@ if defined?(Picky)
             #   Free-formed text to search for.
             def users_search(options = {})
               query = options[:user]
-              raise ArgumentError, 'Required arguments :user missing' if query.nil?
+              raise ArgumentError, 'required arguments :user missing' if query.nil?
 
               index = Picky::Index.new(:users) do
                 category :name

data/lib/slack/web/api/patches/files.default-filename.patch

@@ -0,0 +1,12 @@
+diff --git a/lib/slack/web/api/endpoints/files.rb b/lib/slack/web/api/endpoints/files.rb
+index 13a1889..9ce4894 100644
+--- a/lib/slack/web/api/endpoints/files.rb
++++ b/lib/slack/web/api/endpoints/files.rb
+@@ -192,6 +192,7 @@ module Slack
+           # @see https://api.slack.com/methods/files.upload
+           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/files/files.upload.json
+           def files_upload(options = {})
++            options = options.merge(filename: 'file') if options[:file] && !options[:filename]
+             post('files.upload', options)
+           end
+         end

data/lib/slack/web/api/templates/method.erb

@@ -40,8 +40,10 @@ module Slack
 <% data['arg_groups']&.each do |arg_group| %>
   <% next if arg_group['args'].size <= 1 %>
 <% arg_string = arg_group['args'].map { |arg_name| ":#{arg_name}" }.join(', ') %>
-<% if arg_group['mutually_exclusive'] %>
+<% if arg_group['mutually_exclusive'] && arg_group['required'] != false %>
             raise ArgumentError, 'Exactly one of <%= arg_string %> is required' unless <%= arg_group['args'].map { |arg_name| "options[:#{arg_name}].nil?" }.join(' ^ ') %>
+<% elsif arg_group['mutually_exclusive'] %>
+            raise ArgumentError, '<%= arg_string %> are mutually exclusive' if <%= arg_group['args'].map { |arg_name| "!options[:#{arg_name}].nil?" }.join(' && ') %>
 <% else %>
             raise ArgumentError, 'At least one of <%= arg_string %> is required' if <%= arg_group['args'].map { |arg_name| "options[:#{arg_name}].nil?"}.join(' && ') %>
 <% end %>

data/lib/slack/web/api/templates/method_spec.erb

@@ -5,6 +5,21 @@ require 'spec_helper'
 
 RSpec.describe Slack::Web::Api::Endpoints::<%= group.gsub(".", "_").camelize %> do
   let(:client) { Slack::Web::Client.new }
+<%
+  # Renders a Ruby literal as source code deterministically, regardless of the
+  # Ruby version used to run the generator (Hash#inspect's format for symbol
+  # keys changed in Ruby 3.4, which would otherwise cause spurious diffs).
+  ruby_literal = lambda do |val|
+    case val
+    when Hash
+      "{#{val.map { |k, v| "#{k}: #{ruby_literal.call(v)}" }.join(', ')}}"
+    when Array
+      "[#{val.map { |v| ruby_literal.call(v) }.join(', ')}]"
+    else
+      val.inspect
+    end
+  end
+%>
 <% names.sort.each_with_index do |(name, data), index| %>
 <% next if data['mixin'] %>
 <% group_required_params = data['arg_groups']&.map { |grp| grp['args'].first if grp['args'].size > 1 } || [] %>
@@ -21,23 +36,37 @@ RSpec.describe Slack::Web::Api::Endpoints::<%= group.gsub(".", "_").camelize %>
       expect { client.<%= method_name %><%= params_except_required.empty? ? '' : "(#{params_except_required})" %> }.to raise_error ArgumentError, /Required arguments :<%= arg_name %> missing/
     end
 <% end %>
+<% at_most_one_groups = data['arg_groups']&.select { |g| g['mutually_exclusive'] && g['required'] == false } || [] %>
 <% data['arg_groups']&.each do |arg_group| %>
     <% next if arg_group['args'].size <= 1 %>
+<% at_most_one = arg_group['mutually_exclusive'] && arg_group['required'] == false %>
+<% if at_most_one %>
+    it 'does not allow both <%= arg_group['args'].join(' and ') %>' do
+<% else %>
     it 'requires one of <%= arg_group['args'].join(', ') %>' do
+<% end %>
 <% params_except_required = example_params.reject { |name, _| arg_group['args'].include?(name)  }.map { |name, val| "#{name}: %q[#{val}]" }.join(', ') %>
+<% if at_most_one %>
+<% error_message = 'mutually exclusive' %>
+<% else %>
 <% error_message = arg_group['mutually_exclusive'] ? 'Exactly' : 'At least' %>
       expect { client.<%= method_name %><%= params_except_required.empty? ? '' : "(#{params_except_required})" %> }.to raise_error ArgumentError, /<%= error_message %> one of/
+<% end %>
 <% (1..arg_group['args'].length).each do |n| %>
 <% arg_group['args'].combination(n) do |names| %>
 <% params = names.map { |name| "#{name}: %q[#{data['args'][name]['example']}]" }.join(', ') %>
 <% params = "#{params}, #{params_except_required}" unless params_except_required.empty? %>
-<% if n == 1 || !arg_group['mutually_exclusive'] %>
+<% violates_at_most_one = at_most_one_groups.any? { |g| (names & g['args']).length > 1 } %>
+<% if violates_at_most_one %>
+
+      expect { client.<%= method_name %><%= "(#{params})" %> }.to raise_error ArgumentError, /mutually exclusive/
+<% elsif n == 1 || !arg_group['mutually_exclusive'] %>
 
       expect(client).to receive(:post).with('<%= group %>.<%= name %>', {<%= params %>})
       client.<%= method_name %><%= "(#{params})" %>
 <% else %>
 
-      expect { client.<%= method_name %><%= "(#{params})" %> }.to raise_error ArgumentError, /<%= error_message %> one of/
+      expect { client.<%= method_name %><%= "(#{params})" %> }.to raise_error ArgumentError, /<%= at_most_one ? error_message : "#{error_message} one of" %>/
 <% end %>
 <% end %>
 <% end %>
@@ -45,7 +74,7 @@ RSpec.describe Slack::Web::Api::Endpoints::<%= group.gsub(".", "_").camelize %>
 <% end %>
 <% if json_params.any? %>
 <% example_json_params = json_params.to_h { |name| [name, {data: ['data']}] } %>
-<% params = example_params.merge(example_json_params).map { |name, val| val = val.is_a?(String) ? "%q[#{val}]" : val; "#{name}: #{val}" }.join(', ') %>
+<% params = example_params.merge(example_json_params).map { |name, val| val = val.is_a?(String) ? "%q[#{val}]" : ruby_literal.call(val); "#{name}: #{val}" }.join(', ') %>
 <% expected_params = example_params.merge(example_json_params.transform_values { |v| JSON.dump(v) }).map { |name, val| val = "%q[#{val}]"; "#{name}: #{val}" }.join(', ') %>
     it 'encodes <%= json_params.join(', ') %> as json' do
       expect(client).to receive(:post).with('<%= group %>.<%= name %>', {<%= expected_params %>})

data/lib/slack/web/client.rb

@@ -14,10 +14,29 @@ module Slack
         Slack::Web::Config::ATTRIBUTES.each do |key|
           send("#{key}=", options.fetch(key, Slack::Web.config.send(key)))
         end
+
         @logger ||= Slack::Config.logger || Slack::Logger.default
         @token ||= Slack.config.token
       end
 
+      def with_response(&block)
+        raise ArgumentError, 'response callback block is required' unless block
+
+        with_callback(:@response_callbacks, block)
+      end
+
+      def with_request(&block)
+        raise ArgumentError, 'request callback block is required' unless block
+
+        with_callback(:@request_callbacks, block)
+      end
+
+      def with_error(&block)
+        raise ArgumentError, 'error callback block is required' unless block
+
+        with_callback(:@error_callbacks, block)
+      end
+
       class << self
         def configure
           block_given? ? yield(Config) : Config
@@ -27,6 +46,16 @@ module Slack
           Config
         end
       end
+
+      private
+
+      def with_callback(variable, block)
+        copy = dup
+        copy.instance_variable_set(:@connection, nil)
+        copy.instance_variable_set(:@options, nil)
+        copy.instance_variable_set(variable, Array(instance_variable_get(variable)) + [block])
+        copy
+      end
     end
   end
 end

data/lib/slack/web/faraday/request.rb

@@ -22,7 +22,14 @@ module Slack
         private
 
         def request(method, path, options)
-          response = connection.send(method) do |request|
+          response = perform_request(method, path, options)
+          Array(@response_callbacks).each { |callback| callback.call(response) }
+          response.body
+        end
+
+        def perform_request(method, path, options)
+          configuring_request = false
+          perform_http_request(method, -> { configuring_request }) do |request|
             case method
             when :get, :delete
               request.url(path, options)
@@ -34,9 +41,22 @@ module Slack
             request.headers['Authorization'] = "Bearer #{token}" if token
 
             request.options.merge!(options.delete(:request)) if options.key?(:request)
+            configuring_request = true
+            Array(@request_callbacks).each { |callback| callback.call(request) }
+            configuring_request = false
           end
-          response.body
+        rescue ::Faraday::Error => e
+          raise if configuring_request
+
+          Array(@error_callbacks).each { |callback| callback.call(e) }
+          raise
+        end
+
+        def perform_http_request(method, configuring_request, &block)
+          connection.send(method, &block)
         rescue ::Faraday::ParsingError => e
+          raise if configuring_request.call
+
           raise Slack::Web::Api::Errors::ParsingError, e.response
         end
       end

data/lib/tasks/web.rake

@@ -59,13 +59,16 @@ namespace :slack do
 
           unless ENV.key?('SKIP_PATCH')
             Dir.glob("lib/slack/web/api/patches/#{group}*.patch").sort.each do |patch|
-              puts "- patching #{patch}"
+              puts "#{' ' * 7}patching #{patch}"
               system("git apply #{patch}") || raise('failed to apply patch')
             end
           end
 
           # command
-          raise "Missing group #{group}" unless groups.key?(group)
+          unless groups.key?(group)
+            puts "#{' ' * 7}undocumented group #{group}"
+            groups[group] = { 'name' => group }
+          end
 
           rendered_command = command_template.result(group: groups[group], names: names)
           File.write "bin/commands/#{snaked_group}.rb", rendered_command

data/slack-ruby-client.gemspec

@@ -20,7 +20,6 @@ Gem::Specification.new do |s|
   s.add_dependency 'faraday', '>= 2.0.1'
   s.add_dependency 'faraday-mashify'
   s.add_dependency 'faraday-multipart'
-  s.add_dependency 'gli'
   s.add_dependency 'hashie'
   s.add_dependency 'logger'
   s.metadata['rubygems_mfa_required'] = 'true'

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: slack-ruby-client
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.3.0
 platform: ruby
 authors:
 - Daniel Doubrovkine
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-10-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -51,20 +52,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: gli
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: hashie
   requirement: !ruby/object:Gem::Requirement
@@ -93,6 +80,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+description:
 email: dblock@dblock.org
 executables:
 - slack
@@ -102,8 +90,10 @@ files:
 - ".coveralls.yml"
 - ".github/FUNDING.yml"
 - ".github/dependabot.yml"
+- ".github/prompts/changelog-entries.prompt.yml"
+- ".github/workflows/danger-comment.yml"
+- ".github/workflows/danger.yml"
 - ".github/workflows/lint.yml"
-- ".github/workflows/pr_lint.yml"
 - ".github/workflows/test.yml"
 - ".github/workflows/update_api.yml"
 - ".gitignore"
@@ -112,11 +102,11 @@ files:
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - ".ruby-version"
+- AGENTS.md
 - CHANGELOG.md
 - CONTRIBUTING.md
 - Dangerfile
 - Gemfile
-- Gemfile.danger
 - LICENSE.md
 - README.md
 - RELEASING.md
@@ -124,10 +114,14 @@ files:
 - SECURITY.md
 - UPGRADING.md
 - bin/commands/admin_analytics.rb
+- bin/commands/admin_analytics_messages.rb
 - bin/commands/admin_apps.rb
 - bin/commands/admin_apps_activities.rb
 - bin/commands/admin_apps_approved.rb
 - bin/commands/admin_apps_config.rb
+- bin/commands/admin_apps_mcp_servers.rb
+- bin/commands/admin_apps_mcp_servers_permissions.rb
+- bin/commands/admin_apps_permissions.rb
 - bin/commands/admin_apps_requests.rb
 - bin/commands/admin_apps_restricted.rb
 - bin/commands/admin_audit_anomaly_allow.rb
@@ -155,6 +149,7 @@ files:
 - bin/commands/admin_workflows_collaborators.rb
 - bin/commands/admin_workflows_permissions.rb
 - bin/commands/admin_workflows_triggers_types_permissions.rb
+- bin/commands/agents_sessions.rb
 - bin/commands/api.rb
 - bin/commands/apps.rb
 - bin/commands/apps_activities.rb
@@ -162,11 +157,15 @@ files:
 - bin/commands/apps_connections.rb
 - bin/commands/apps_datastore.rb
 - bin/commands/apps_event_authorizations.rb
+- bin/commands/apps_icon.rb
+- bin/commands/apps_managed_permissions.rb
 - bin/commands/apps_manifest.rb
+- bin/commands/apps_user_connection.rb
 - bin/commands/assistant_search.rb
 - bin/commands/assistant_threads.rb
 - bin/commands/auth.rb
 - bin/commands/auth_teams.rb
+- bin/commands/blocks.rb
 - bin/commands/bookmarks.rb
 - bin/commands/bots.rb
 - bin/commands/calls.rb
@@ -194,6 +193,7 @@ files:
 - bin/commands/migration.rb
 - bin/commands/oauth.rb
 - bin/commands/oauth_v2.rb
+- bin/commands/oauth_v2_user.rb
 - bin/commands/openid_connect.rb
 - bin/commands/pins.rb
 - bin/commands/reactions.rb
@@ -247,10 +247,14 @@ files:
 - lib/slack/version.rb
 - lib/slack/web/api/endpoints.rb
 - lib/slack/web/api/endpoints/admin_analytics.rb
+- lib/slack/web/api/endpoints/admin_analytics_messages.rb
 - lib/slack/web/api/endpoints/admin_apps.rb
 - lib/slack/web/api/endpoints/admin_apps_activities.rb
 - lib/slack/web/api/endpoints/admin_apps_approved.rb
 - lib/slack/web/api/endpoints/admin_apps_config.rb
+- lib/slack/web/api/endpoints/admin_apps_mcp_servers.rb
+- lib/slack/web/api/endpoints/admin_apps_mcp_servers_permissions.rb
+- lib/slack/web/api/endpoints/admin_apps_permissions.rb
 - lib/slack/web/api/endpoints/admin_apps_requests.rb
 - lib/slack/web/api/endpoints/admin_apps_restricted.rb
 - lib/slack/web/api/endpoints/admin_audit_anomaly_allow.rb
@@ -278,6 +282,7 @@ files:
 - lib/slack/web/api/endpoints/admin_workflows_collaborators.rb
 - lib/slack/web/api/endpoints/admin_workflows_permissions.rb
 - lib/slack/web/api/endpoints/admin_workflows_triggers_types_permissions.rb
+- lib/slack/web/api/endpoints/agents_sessions.rb
 - lib/slack/web/api/endpoints/api.rb
 - lib/slack/web/api/endpoints/apps.rb
 - lib/slack/web/api/endpoints/apps_activities.rb
@@ -285,11 +290,15 @@ files:
 - lib/slack/web/api/endpoints/apps_connections.rb
 - lib/slack/web/api/endpoints/apps_datastore.rb
 - lib/slack/web/api/endpoints/apps_event_authorizations.rb
+- lib/slack/web/api/endpoints/apps_icon.rb
+- lib/slack/web/api/endpoints/apps_managed_permissions.rb
 - lib/slack/web/api/endpoints/apps_manifest.rb
+- lib/slack/web/api/endpoints/apps_user_connection.rb
 - lib/slack/web/api/endpoints/assistant_search.rb
 - lib/slack/web/api/endpoints/assistant_threads.rb
 - lib/slack/web/api/endpoints/auth.rb
 - lib/slack/web/api/endpoints/auth_teams.rb
+- lib/slack/web/api/endpoints/blocks.rb
 - lib/slack/web/api/endpoints/bookmarks.rb
 - lib/slack/web/api/endpoints/bots.rb
 - lib/slack/web/api/endpoints/calls.rb
@@ -317,6 +326,7 @@ files:
 - lib/slack/web/api/endpoints/migration.rb
 - lib/slack/web/api/endpoints/oauth.rb
 - lib/slack/web/api/endpoints/oauth_v2.rb
+- lib/slack/web/api/endpoints/oauth_v2_user.rb
 - lib/slack/web/api/endpoints/openid_connect.rb
 - lib/slack/web/api/endpoints/pins.rb
 - lib/slack/web/api/endpoints/reactions.rb
@@ -360,6 +370,7 @@ files:
 - lib/slack/web/api/mixins/users.search.rb
 - lib/slack/web/api/options.rb
 - lib/slack/web/api/patches/.gitkeep
+- lib/slack/web/api/patches/files.default-filename.patch
 - lib/slack/web/api/schema/group.json
 - lib/slack/web/api/schema/method.json
 - lib/slack/web/api/templates/command.erb
@@ -387,6 +398,7 @@ licenses:
 metadata:
   rubygems_mfa_required: 'true'
   changelog_uri: https://github.com/slack-ruby/slack-ruby-client/blob/master/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -401,7 +413,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.5.16
+signing_key:
 specification_version: 4
 summary: Slack Web and RealTime API client.
 test_files: []

data/.github/workflows/pr_lint.yml

@@ -1,21 +0,0 @@
-name: PR Lint
-on: pull_request
-jobs:
-  danger:
-    name: Dangerfile
-    runs-on: ubuntu-latest
-    env:
-      BUNDLE_GEMFILE: ${{ github.workspace }}/Gemfile.danger
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-        with:
-          fetch-depth: 0
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          bundler-cache: true
-      - run: |
-          # Personal access token for dangerpr-bot - public, but base64 encoded to avoid tripping up GitHub
-          TOKEN=$(echo -n Z2hwX0xNQ3VmanBFeTBvYkZVTWh6NVNqVFFBOEUxU25abzBqRUVuaAo= | base64 --decode)
-          DANGER_GITHUB_API_TOKEN=$TOKEN bundle exec danger --verbose

data/Gemfile.danger

@@ -1,6 +0,0 @@
-source 'https://rubygems.org'
-
-group :test do
-  gem 'danger-toc', '~> 0.2.0', require: false
-  gem 'slack-ruby-danger', '~> 0.2.0', require: false
-end