slack-ruby-client 0.15.0 → 1.0.0

data/bin/commands.rb

@@ -1,13 +1,16 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
+require 'commands/admin_analytics'
 require 'commands/admin_apps'
 require 'commands/admin_apps_approved'
 require 'commands/admin_apps_requests'
 require 'commands/admin_apps_restricted'
+require 'commands/admin_auth_policy'
+require 'commands/admin_barriers'
 require 'commands/admin_conversations'
+require 'commands/admin_conversations_ekm'
 require 'commands/admin_conversations_restrictAccess'
-require 'commands/admin_conversations_whitelist'
 require 'commands/admin_emoji'
 require 'commands/admin_inviteRequests'
 require 'commands/admin_inviteRequests_approved'
@@ -21,15 +24,14 @@ require 'commands/admin_users'
 require 'commands/admin_users_session'
 require 'commands/api'
 require 'commands/apps'
-require 'commands/apps_permissions'
-require 'commands/apps_permissions_resources'
-require 'commands/apps_permissions_scopes'
-require 'commands/apps_permissions_users'
+require 'commands/apps_connections'
+require 'commands/apps_event_authorizations'
+require 'commands/apps_manifest'
 require 'commands/auth'
+require 'commands/auth_teams'
 require 'commands/bots'
 require 'commands/calls'
 require 'commands/calls_participants'
-require 'commands/channels'
 require 'commands/chat'
 require 'commands/chat_scheduledMessages'
 require 'commands/conversations'
@@ -39,12 +41,10 @@ require 'commands/emoji'
 require 'commands/files'
 require 'commands/files_comments'
 require 'commands/files_remote'
-require 'commands/groups'
-require 'commands/im'
 require 'commands/migration'
-require 'commands/mpim'
 require 'commands/oauth'
 require 'commands/oauth_v2'
+require 'commands/openid_connect'
 require 'commands/pins'
 require 'commands/reactions'
 require 'commands/reminders'
@@ -52,7 +52,10 @@ require 'commands/rtm'
 require 'commands/search'
 require 'commands/stars'
 require 'commands/team'
+require 'commands/team_billing'
+require 'commands/team_preferences'
 require 'commands/team_profile'
+require 'commands/tooling_tokens'
 require 'commands/usergroups'
 require 'commands/usergroups_users'
 require 'commands/users'
@@ -60,3 +63,4 @@ require 'commands/users_admin'
 require 'commands/users_prefs'
 require 'commands/users_profile'
 require 'commands/views'
+require 'commands/workflows'

data/lib/slack/config.rb

@@ -3,8 +3,7 @@ module Slack
   module Config
     extend self
 
-    attr_accessor :token
-    attr_accessor :logger
+    attr_accessor :token, :logger
 
     def reset
       self.token = nil

data/lib/slack/events/request.rb

@@ -3,7 +3,9 @@ module Slack
   module Events
     class Request
       class MissingSigningSecret < StandardError; end
+
       class TimestampExpired < StandardError; end
+
       class InvalidSignature < StandardError; end
 
       attr_reader :http_request,
@@ -19,13 +21,13 @@ module Slack
 
       # Request timestamp.
       def timestamp
-        @timestamp ||= http_request.headers['X-Slack-Request-Timestamp']
+        @timestamp ||= http_request.get_header('HTTP_X_SLACK_REQUEST_TIMESTAMP')
       end
 
       # The signature is created by combining the signing secret with the body of the request
       # Slack is sending using a standard HMAC-SHA256 keyed hash.
       def signature
-        @signature ||= http_request.headers['X-Slack-Signature']
+        @signature ||= http_request.get_header('HTTP_X_SLACK_SIGNATURE')
       end
 
       # Signature version.
@@ -35,7 +37,11 @@ module Slack
 
       # Request body.
       def body
-        @body ||= http_request.body.read
+        @body ||= begin
+          body = http_request.body.read
+          http_request.body.rewind
+          body
+        end
       end
 
       # Returns true if the signature coming from Slack has expired.
@@ -47,7 +53,7 @@ module Slack
       def valid?
         raise MissingSigningSecret unless signing_secret
 
-        digest = OpenSSL::Digest::SHA256.new
+        digest = OpenSSL::Digest.new('SHA256')
         signature_basestring = [version, timestamp, body].join(':')
         hex_hash = OpenSSL::HMAC.hexdigest(digest, signing_secret, signature_basestring)
         computed_signature = [version, hex_hash].join('=')

data/lib/slack/real_time/client.rb

@@ -3,6 +3,7 @@ module Slack
   module RealTime
     class Client
       class ClientNotStartedError < StandardError; end
+
       class ClientAlreadyStartedError < StandardError; end
 
       include Api::MessageId
@@ -16,11 +17,7 @@ module Slack
         attr_accessor :events
       end
 
-      attr_accessor :web_client
-      attr_accessor :store
-      attr_accessor :url
-      attr_accessor(*Config::ATTRIBUTES)
-      attr_accessor :logger
+      attr_accessor :web_client, :store, :url, *Config::ATTRIBUTES
 
       protected :store_class, :store_class=
 
@@ -134,7 +131,7 @@ module Slack
       rescue Slack::Web::Api::Errors::SlackError => e
         # stop pinging if bot was uninstalled
         case e.message
-        when 'account_inactive', 'invalid_auth' then
+        when 'account_inactive', 'invalid_auth'
           logger.warn(to_s) { e.message }
           raise e
         end
@@ -202,6 +199,7 @@ module Slack
       end
 
       attr_reader :callbacks
+
       def socket_class
         concurrency::Socket
       end
@@ -251,6 +249,8 @@ module Slack
       end
 
       def run_handlers(type, data)
+        return unless store.class.events
+
         handlers = store.class.events[type.to_s]
         handlers&.each do |handler|
           store.instance_exec(data, &handler)

data/lib/slack/real_time/concurrency/async.rb

@@ -45,14 +45,12 @@ module Slack
                 @client_task&.stop
 
                 @client_task = task.async do |subtask|
-                  begin
-                    subtask.annotate "#{client} run-loop"
-                    client.run_loop
-                  rescue ::Async::Wrapper::Cancelled => e
-                    # Will get restarted by ping worker.
-                  rescue StandardError => e
-                    client.logger.error(subtask.to_s) { e.message }
-                  end
+                  subtask.annotate "#{client} run-loop"
+                  client.run_loop
+                rescue ::Async::Wrapper::Cancelled => e
+                # Will get restarted by ping worker.
+                rescue StandardError => e
+                  client.logger.error(subtask.to_s) { e.message }
                 end
 
                 @restart.wait

data/lib/slack/real_time/concurrency.rb

@@ -3,8 +3,6 @@ module Slack
   module RealTime
     module Concurrency
       autoload :Async, 'slack/real_time/concurrency/async'
-      autoload :Eventmachine, 'slack/real_time/concurrency/eventmachine'
-      autoload :Celluloid, 'slack/real_time/concurrency/celluloid'
     end
   end
 end

data/lib/slack/real_time/config.rb

@@ -17,7 +17,8 @@ module Slack
         logger
       ].freeze
 
-      attr_accessor(*Config::ATTRIBUTES)
+      attr_accessor(*Config::ATTRIBUTES - [:concurrency])
+      attr_writer :concurrency
 
       def reset
         self.websocket_ping = 30
@@ -37,19 +38,9 @@ module Slack
       private
 
       def detect_concurrency
-        %i[Async Eventmachine Celluloid].each do |concurrency|
-          begin
-            return Slack::RealTime::Concurrency.const_get(concurrency)
-          rescue LoadError, NameError
-            false # could not be loaded, missing dependencies
-          end
-        end
-
-        raise(
-          NoConcurrencyError,
-          'Missing concurrency. Add async-websocket, faye-websocket ' \
-          'or celluloid-io to your Gemfile.'
-        )
+        Slack::RealTime::Concurrency.const_get(:Async)
+      rescue LoadError, NameError
+        raise NoConcurrencyError, 'Missing concurrency. Add async-websocket to your Gemfile.'
       end
     end
 

data/lib/slack/real_time/socket.rb

@@ -2,8 +2,7 @@
 module Slack
   module RealTime
     class Socket
-      attr_accessor :url
-      attr_accessor :options
+      attr_accessor :url, :options
       attr_reader :driver
 
       def initialize(url, options = {})

data/lib/slack/real_time/stores/base.rb

@@ -8,12 +8,7 @@ module Slack
           attr_accessor :events
         end
 
-        attr_accessor :users
-        attr_accessor :bots
-        attr_accessor :channels
-        attr_accessor :groups
-        attr_accessor :teams
-        attr_accessor :ims
+        attr_accessor :users, :bots, :channels, :groups, :teams, :ims
 
         def self
           nil

data/lib/slack/real_time/stores/starter.rb

@@ -4,9 +4,7 @@ module Slack
     module Stores
       # Only stores initial information.
       class Starter < Base
-        attr_reader :self
-
-        attr_reader :team
+        attr_reader :self, :team
 
         def initialize(attrs)
           @team = Models::Team.new(attrs.team)
@@ -15,6 +13,11 @@ module Slack
 
         ### RealTime Events
 
+        # A shared channel invite was sent to a Slack user.
+        # @see https://api.slack.com/events/shared_channel_invite_received
+        # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/shared_channel_invite_received.json
+        # on :shared_channel_invite_received do |data|
+
         # An enterprise grid migration has started on an external workspace..
         # @see https://api.slack.com/events/external_org_migration_started
         # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/external_org_migration_started.json

data/lib/slack/real_time/stores/store.rb

@@ -55,6 +55,11 @@ module Slack
 
         ### RealTime Events
 
+        # A shared channel invite was sent to a Slack user.
+        # @see https://api.slack.com/events/shared_channel_invite_received
+        # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/shared_channel_invite_received.json
+        # on :shared_channel_invite_received do |data|
+
         # An enterprise grid migration has started on an external workspace..
         # @see https://api.slack.com/events/external_org_migration_started
         # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/external_org_migration_started.json

data/lib/slack/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Slack
-  VERSION = '0.15.0'
+  VERSION = '1.0.0'
 end

data/lib/slack/web/api/endpoints/admin_analytics.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminAnalytics
+          #
+          # Retrieve analytics data for a given date, presented as a compressed JSON file
+          #
+          # @option options [string] :type
+          #   The type of analytics to retrieve. The options are currently limited to member (for grid member analytics) and public_channel (for public channel analytics).
+          # @option options [date] :date
+          #   Date to retrieve the analytics data for, expressed as YYYY-MM-DD in UTC.
+          # @option options [boolean] :metadata_only
+          #   Retrieve metadata for the type of analytics indicated. Can be used only with type set to public_channel analytics. See detail below. Omit the date parameter when using this argument.
+          # @see https://api.slack.com/methods/admin.analytics.getFile
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.analytics/admin.analytics.getFile.json
+          def admin_analytics_getFile(options = {})
+            throw ArgumentError.new('Required arguments :type missing') if options[:type].nil?
+            post('admin.analytics.getFile', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/admin_apps.rb

@@ -9,32 +9,68 @@ module Slack
           #
           # Approve an app for installation on a workspace.
           #
-          # @option options [Object] :app_id
+          # @option options [string] :app_id
           #   The id of the app to approve.
-          # @option options [Object] :request_id
+          # @option options [Object] :enterprise_id
+          #   The ID of the enterprise to approve the app on.
+          # @option options [string] :request_id
           #   The id of the request to approve.
           # @option options [Object] :team_id
-          #   .
+          #   The ID of the workspace to approve the app on.
           # @see https://api.slack.com/methods/admin.apps.approve
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.apps/admin.apps.approve.json
           def admin_apps_approve(options = {})
             post('admin.apps.approve', options)
           end
 
+          #
+          # Clear an app resolution
+          #
+          # @option options [string] :app_id
+          #   The id of the app whose resolution you want to clear/undo.
+          # @option options [Object] :enterprise_id
+          #   The enterprise to clear the app resolution from.
+          # @option options [Object] :team_id
+          #   The workspace to clear the app resolution from.
+          # @see https://api.slack.com/methods/admin.apps.clearResolution
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.apps/admin.apps.clearResolution.json
+          def admin_apps_clearResolution(options = {})
+            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
+            post('admin.apps.clearResolution', options)
+          end
+
           #
           # Restrict an app for installation on a workspace.
           #
-          # @option options [Object] :app_id
+          # @option options [string] :app_id
           #   The id of the app to restrict.
-          # @option options [Object] :request_id
+          # @option options [Object] :enterprise_id
+          #   The ID of the enterprise to approve the app on.
+          # @option options [string] :request_id
           #   The id of the request to restrict.
           # @option options [Object] :team_id
-          #   .
+          #   The ID of the workspace to approve the app on.
           # @see https://api.slack.com/methods/admin.apps.restrict
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.apps/admin.apps.restrict.json
           def admin_apps_restrict(options = {})
             post('admin.apps.restrict', options)
           end
+
+          #
+          # Uninstall an app from one or many workspaces, or an entire enterprise organization.
+          #
+          # @option options [string] :app_id
+          #   The ID of the app to uninstall.
+          # @option options [string] :enterprise_id
+          #   The enterprise to completely uninstall the application from (across all workspaces). With an org-level token, this or team_ids is required.
+          # @option options [string] :team_ids
+          #   IDs of the teams to uninstall from (max 100). With an org-level token, this or enterprise_id is required.
+          # @see https://api.slack.com/methods/admin.apps.uninstall
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.apps/admin.apps.uninstall.json
+          def admin_apps_uninstall(options = {})
+            throw ArgumentError.new('Required arguments :app_id missing') if options[:app_id].nil?
+            post('admin.apps.uninstall', options)
+          end
         end
       end
     end

data/lib/slack/web/api/endpoints/admin_apps_approved.rb

@@ -9,11 +9,11 @@ module Slack
           #
           # List approved apps for an org or workspace.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @option options [Object] :enterprise_id
           #   .
-          # @option options [Object] :limit
+          # @option options [integer] :limit
           #   The maximum number of items to return. Must be between 1 - 1000 both inclusive.
           # @option options [Object] :team_id
           #   .

data/lib/slack/web/api/endpoints/admin_apps_requests.rb

@@ -9,9 +9,11 @@ module Slack
           #
           # List app requests for a team/workspace.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
-          # @option options [Object] :limit
+          # @option options [Object] :enterprise_id
+          #   .
+          # @option options [integer] :limit
           #   The maximum number of items to return. Must be between 1 - 1000 both inclusive.
           # @option options [Object] :team_id
           #   .

data/lib/slack/web/api/endpoints/admin_apps_restricted.rb

@@ -9,11 +9,11 @@ module Slack
           #
           # List restricted apps for an org or workspace.
           #
-          # @option options [Object] :cursor
+          # @option options [string] :cursor
           #   Set cursor to next_cursor returned by the previous call to list items in the next page.
           # @option options [Object] :enterprise_id
           #   .
-          # @option options [Object] :limit
+          # @option options [integer] :limit
           #   The maximum number of items to return. Must be between 1 - 1000 both inclusive.
           # @option options [Object] :team_id
           #   .

data/lib/slack/web/api/endpoints/admin_auth_policy.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminAuthPolicy
+          #
+          # Assign entities to a particular authentication policy.
+          #
+          # @option options [array] :entity_ids
+          #   Array of IDs to assign to the policy.
+          # @option options [Object] :entity_type
+          #   The type of entity to assign to the policy. Currently, USER is supported.
+          # @option options [string] :policy_name
+          #   The name of the authentication policy to assign the entities to. Currently, email_password is the only policy that may be used with this method.
+          # @see https://api.slack.com/methods/admin.auth.policy.assignEntities
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.auth.policy/admin.auth.policy.assignEntities.json
+          def admin_auth_policy_assignEntities(options = {})
+            throw ArgumentError.new('Required arguments :entity_ids missing') if options[:entity_ids].nil?
+            throw ArgumentError.new('Required arguments :entity_type missing') if options[:entity_type].nil?
+            throw ArgumentError.new('Required arguments :policy_name missing') if options[:policy_name].nil?
+            post('admin.auth.policy.assignEntities', options)
+          end
+
+          #
+          # Fetch all the entities assigned to a particular authentication policy by name.
+          #
+          # @option options [string] :policy_name
+          #   The name of the policy to fetch entities for. Currently, email_password is the only policy that may be used with this method.
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
+          # @option options [Object] :entity_type
+          #   The type of entity to assign to the policy. Currently, USER is supported.
+          # @option options [integer] :limit
+          #   The maximum number of items to return. Must be between 1 and 1000, both inclusive.
+          # @see https://api.slack.com/methods/admin.auth.policy.getEntities
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.auth.policy/admin.auth.policy.getEntities.json
+          def admin_auth_policy_getEntities(options = {})
+            throw ArgumentError.new('Required arguments :policy_name missing') if options[:policy_name].nil?
+            if block_given?
+              Pagination::Cursor.new(self, :admin_auth_policy_getEntities, options).each do |page|
+                yield page
+              end
+            else
+              post('admin.auth.policy.getEntities', options)
+            end
+          end
+
+          #
+          # Remove specified entities from a specified authentication policy.
+          #
+          # @option options [array] :entity_ids
+          #   Encoded IDs of the entities you'd like to remove from the policy.
+          # @option options [Object] :entity_type
+          #   The type of entity to assign to the policy. Currently, USER is supported.
+          # @option options [string] :policy_name
+          #   The name of the policy to remove entities from. Currently, email_password is the only policy that may be used with this method.
+          # @see https://api.slack.com/methods/admin.auth.policy.removeEntities
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.auth.policy/admin.auth.policy.removeEntities.json
+          def admin_auth_policy_removeEntities(options = {})
+            throw ArgumentError.new('Required arguments :entity_ids missing') if options[:entity_ids].nil?
+            throw ArgumentError.new('Required arguments :entity_type missing') if options[:entity_type].nil?
+            throw ArgumentError.new('Required arguments :policy_name missing') if options[:policy_name].nil?
+            post('admin.auth.policy.removeEntities', options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/slack/web/api/endpoints/admin_barriers.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminBarriers
+          #
+          # Create an Information Barrier
+          #
+          # @option options [array] :barriered_from_usergroup_ids
+          #   A list of IDP Groups ids that the primary usergroup is to be barriered from.
+          # @option options [Object] :primary_usergroup_id
+          #   The id of the primary IDP Group.
+          # @option options [array] :restricted_subjects
+          #   What kind of interactions are blocked by this barrier? For v1, we only support a list of all 3, eg im, mpim, call.
+          # @see https://api.slack.com/methods/admin.barriers.create
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.barriers/admin.barriers.create.json
+          def admin_barriers_create(options = {})
+            throw ArgumentError.new('Required arguments :barriered_from_usergroup_ids missing') if options[:barriered_from_usergroup_ids].nil?
+            throw ArgumentError.new('Required arguments :primary_usergroup_id missing') if options[:primary_usergroup_id].nil?
+            throw ArgumentError.new('Required arguments :restricted_subjects missing') if options[:restricted_subjects].nil?
+            post('admin.barriers.create', options)
+          end
+
+          #
+          # Delete an existing Information Barrier
+          #
+          # @option options [Object] :barrier_id
+          #   The ID of the barrier you're trying to delete.
+          # @see https://api.slack.com/methods/admin.barriers.delete
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.barriers/admin.barriers.delete.json
+          def admin_barriers_delete(options = {})
+            throw ArgumentError.new('Required arguments :barrier_id missing') if options[:barrier_id].nil?
+            post('admin.barriers.delete', options)
+          end
+
+          #
+          # Get all Information Barriers for your organization
+          #
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
+          # @option options [integer] :limit
+          #   The maximum number of items to return. Must be between 1 - 1000 both inclusive.
+          # @see https://api.slack.com/methods/admin.barriers.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.barriers/admin.barriers.list.json
+          def admin_barriers_list(options = {})
+            if block_given?
+              Pagination::Cursor.new(self, :admin_barriers_list, options).each do |page|
+                yield page
+              end
+            else
+              post('admin.barriers.list', options)
+            end
+          end
+
+          #
+          # Update an existing Information Barrier
+          #
+          # @option options [Object] :barrier_id
+          #   The ID of the barrier you're trying to modify.
+          # @option options [array] :barriered_from_usergroup_ids
+          #   A list of IDP Groups ids that the primary usergroup is to be barriered from.
+          # @option options [Object] :primary_usergroup_id
+          #   The id of the primary IDP Group.
+          # @option options [array] :restricted_subjects
+          #   What kind of interactions are blocked by this barrier? For v1, we only support a list of all 3, eg im, mpim, call.
+          # @see https://api.slack.com/methods/admin.barriers.update
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.barriers/admin.barriers.update.json
+          def admin_barriers_update(options = {})
+            throw ArgumentError.new('Required arguments :barrier_id missing') if options[:barrier_id].nil?
+            throw ArgumentError.new('Required arguments :barriered_from_usergroup_ids missing') if options[:barriered_from_usergroup_ids].nil?
+            throw ArgumentError.new('Required arguments :primary_usergroup_id missing') if options[:primary_usergroup_id].nil?
+            throw ArgumentError.new('Required arguments :restricted_subjects missing') if options[:restricted_subjects].nil?
+            post('admin.barriers.update', options)
+          end
+        end
+      end
+    end
+  end
+end