slack-ruby-client 0.7.2 → 1.0.0

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

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AppsPermissionsUsers
+          #
+          # Returns list of user grants and corresponding scopes this app has on a team.
+          #
+          # @option options [Object] :cursor
+          #   Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Default value fetches the first "page" of the collection. See pagination for more detail.
+          # @option options [Object] :limit
+          #   The maximum number of items to return.
+          # @see https://api.slack.com/methods/apps.permissions.users.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions.users/apps.permissions.users.list.json
+          def apps_permissions_users_list(options = {})
+            if block_given?
+              Pagination::Cursor.new(self, :apps_permissions_users_list, options).each do |page|
+                yield page
+              end
+            else
+              post('apps.permissions.users.list', options)
+            end
+          end
+
+          #
+          # Enables an app to trigger a permissions modal to grant an app access to a user access scope.
+          #
+          # @option options [Object] :scopes
+          #   A comma separated list of user scopes to request for.
+          # @option options [Object] :trigger_id
+          #   Token used to trigger the request.
+          # @option options [user] :user
+          #   The user this scope is being requested for.
+          # @see https://api.slack.com/methods/apps.permissions.users.request
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/apps.permissions.users/apps.permissions.users.request.json
+          def apps_permissions_users_request(options = {})
+            throw ArgumentError.new('Required arguments :scopes missing') if options[:scopes].nil?
+            throw ArgumentError.new('Required arguments :trigger_id missing') if options[:trigger_id].nil?
+            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
+            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
+            post('apps.permissions.users.request', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,10 +7,21 @@ module Slack
       module Endpoints
         module Auth
           #
-          # This method checks authentication and tells you who you are.
+          # Revokes a token.
+          #
+          # @option options [boolean] :test
+          #   Setting this parameter to 1 triggers a testing mode where the specified token will not actually be revoked.
+          # @see https://api.slack.com/methods/auth.revoke
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.revoke.json
+          def auth_revoke(options = {})
+            post('auth.revoke', options)
+          end
+
+          #
+          # Checks authentication & identity.
           #
           # @see https://api.slack.com/methods/auth.test
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/auth/auth.test.json
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth/auth.test.json
           def auth_test(options = {})
             post('auth.test', options)
           end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AuthTeams
+          #
+          # List the workspaces a token can access.
+          #
+          # @option options [string] :cursor
+          #   Set cursor to next_cursor returned by the previous call to list items in the next page.
+          # @option options [boolean] :include_icon
+          #   Whether to return icon paths for each workspace. An icon path represents a URI pointing to the image signifying the workspace.
+          # @option options [integer] :limit
+          #   The maximum number of workspaces to return. Must be a positive integer no larger than 1000.
+          # @see https://api.slack.com/methods/auth.teams.list
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/auth.teams/auth.teams.list.json
+          def auth_teams_list(options = {})
+            if block_given?
+              Pagination::Cursor.new(self, :auth_teams_list, options).each do |page|
+                yield page
+              end
+            else
+              post('auth.teams.list', options)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Bots
+          #
+          # Gets information about a bot user.
+          #
+          # @option options [user] :bot
+          #   Bot user to get info on.
+          # @option options [team] :team_id
+          #   encoded team id or enterprise id where the bot exists, required if org token is used.
+          # @see https://api.slack.com/methods/bots.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/bots/bots.info.json
+          def bots_info(options = {})
+            post('bots.info', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module Calls
+          #
+          # Registers a new Call.
+          #
+          # @option options [string] :external_unique_id
+          #   An ID supplied by the 3rd-party Call provider. It must be unique across all Calls from that service.
+          # @option options [string] :join_url
+          #   The URL required for a client to join the Call.
+          # @option options [string] :created_by
+          #   The valid Slack user ID of the user who created this Call. When this method is called with a user token, the created_by field is optional and defaults to the authed user of the token. Otherwise, the field is required.
+          # @option options [integer] :date_start
+          #   Call start time in UTC UNIX timestamp format.
+          # @option options [string] :desktop_app_join_url
+          #   When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.
+          # @option options [string] :external_display_id
+          #   An optional, human-readable ID supplied by the 3rd-party Call provider. If supplied, this ID will be displayed in the Call object.
+          # @option options [string] :title
+          #   The name of the Call.
+          # @option options [array] :users
+          #   The list of users to register as participants in the Call. Read more on how to specify users here.
+          # @see https://api.slack.com/methods/calls.add
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.add.json
+          def calls_add(options = {})
+            throw ArgumentError.new('Required arguments :external_unique_id missing') if options[:external_unique_id].nil?
+            throw ArgumentError.new('Required arguments :join_url missing') if options[:join_url].nil?
+            post('calls.add', options)
+          end
+
+          #
+          # Ends a Call.
+          #
+          # @option options [string] :id
+          #   id returned when registering the call using the calls.add method.
+          # @option options [integer] :duration
+          #   Call duration in seconds.
+          # @see https://api.slack.com/methods/calls.end
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.end.json
+          def calls_end(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            post('calls.end', options)
+          end
+
+          #
+          # Returns information about a Call.
+          #
+          # @option options [string] :id
+          #   id of the Call returned by the calls.add method.
+          # @see https://api.slack.com/methods/calls.info
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.info.json
+          def calls_info(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            post('calls.info', options)
+          end
+
+          #
+          # Updates information about a Call.
+          #
+          # @option options [string] :id
+          #   id returned by the calls.add method.
+          # @option options [string] :desktop_app_join_url
+          #   When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.
+          # @option options [string] :join_url
+          #   The URL required for a client to join the Call.
+          # @option options [string] :title
+          #   The name of the Call.
+          # @see https://api.slack.com/methods/calls.update
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls/calls.update.json
+          def calls_update(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            post('calls.update', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module CallsParticipants
+          #
+          # Registers new participants added to a Call.
+          #
+          # @option options [string] :id
+          #   id returned by the calls.add method.
+          # @option options [array] :users
+          #   The list of users to add as participants in the Call. Read more on how to specify users here.
+          # @see https://api.slack.com/methods/calls.participants.add
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls.participants/calls.participants.add.json
+          def calls_participants_add(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            post('calls.participants.add', options)
+          end
+
+          #
+          # Registers participants removed from a Call.
+          #
+          # @option options [string] :id
+          #   id returned by the calls.add method.
+          # @option options [array] :users
+          #   The list of users to remove as participants in the Call. Read more on how to specify users here.
+          # @see https://api.slack.com/methods/calls.participants.remove
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/calls.participants/calls.participants.remove.json
+          def calls_participants_remove(options = {})
+            throw ArgumentError.new('Required arguments :id missing') if options[:id].nil?
+            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
+            post('calls.participants.remove', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
 module Slack
@@ -6,210 +7,16 @@ module Slack
       module Endpoints
         module Channels
           #
-          # This method archives a channel.
+          # Delete a channel (undocumented)
           #
           # @option options [channel] :channel
-          #   Channel to archive.
-          # @see https://api.slack.com/methods/channels.archive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.archive.json
-          def channels_archive(options = {})
+          #   Channel to delete.
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/undocumented/channels/channels.delete.json
+          def channels_delete(options = {})
             throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.archive', options)
-          end
-
-          #
-          # This method is used to create a channel.
-          #
-          # @option options [Object] :name
-          #   Name of channel to create.
-          # @see https://api.slack.com/methods/channels.create
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.create.json
-          def channels_create(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            post('channels.create', options)
-          end
-
-          #
-          # This method returns a portion of message events from the specified channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to fetch history for.
-          # @option options [timestamp] :latest
-          #   End of time range of messages to include in results.
-          # @option options [timestamp] :oldest
-          #   Start of time range of messages to include in results.
-          # @option options [Object] :inclusive
-          #   Include messages with latest or oldest timestamp in results.
-          # @option options [Object] :unreads
-          #   Include unread_count_display in the output?.
-          # @see https://api.slack.com/methods/channels.history
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.history.json
-          def channels_history(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.history', options)
-          end
-
-          #
-          # This method returns information about a team channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to get info on.
-          # @see https://api.slack.com/methods/channels.info
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.info.json
-          def channels_info(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.info', options)
-          end
-
-          #
-          # This method is used to invite a user to a channel. The calling user must be a member of the channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to invite user to.
-          # @option options [user] :user
-          #   User to invite to channel.
-          # @see https://api.slack.com/methods/channels.invite
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.invite.json
-          def channels_invite(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('channels.invite', options)
-          end
-
-          #
-          # This method is used to join a channel. If the channel does not exist, it is
-          # created.
-          #
-          # @option options [Object] :name
-          #   Name of channel to join.
-          # @see https://api.slack.com/methods/channels.join
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.join.json
-          def channels_join(options = {})
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            post('channels.join', options)
-          end
-
-          #
-          # This method allows a user to remove another member from a team channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to remove user from.
-          # @option options [user] :user
-          #   User to remove from channel.
-          # @see https://api.slack.com/methods/channels.kick
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.kick.json
-          def channels_kick(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :user missing') if options[:user].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            options = options.merge(user: users_id(options)['user']['id']) if options[:user]
-            post('channels.kick', options)
-          end
-
-          #
-          # This method is used to leave a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to leave.
-          # @see https://api.slack.com/methods/channels.leave
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.leave.json
-          def channels_leave(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.leave', options)
-          end
-
-          #
-          # This method returns a list of all channels in the team. This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels. The number of (non-deactivated) members in each channel is also returned.
-          #
-          # @option options [Object] :exclude_archived
-          #   Don't return archived channels.
-          # @see https://api.slack.com/methods/channels.list
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.list.json
-          def channels_list(options = {})
-            post('channels.list', options)
-          end
-
-          #
-          # This method moves the read cursor in a channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set reading cursor in.
-          # @option options [timestamp] :ts
-          #   Timestamp of the most recently seen message.
-          # @see https://api.slack.com/methods/channels.mark
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.mark.json
-          def channels_mark(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :ts missing') if options[:ts].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.mark', options)
-          end
-
-          #
-          # This method renames a team channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to rename.
-          # @option options [Object] :name
-          #   New name for channel.
-          # @see https://api.slack.com/methods/channels.rename
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.rename.json
-          def channels_rename(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :name missing') if options[:name].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.rename', options)
-          end
-
-          #
-          # This method is used to change the purpose of a channel. The calling user must be a member of the channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set the purpose of.
-          # @option options [Object] :purpose
-          #   The new purpose.
-          # @see https://api.slack.com/methods/channels.setPurpose
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.setPurpose.json
-          def channels_setPurpose(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :purpose missing') if options[:purpose].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.setPurpose', options)
-          end
-
-          #
-          # This method is used to change the topic of a channel. The calling user must be a member of the channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to set the topic of.
-          # @option options [Object] :topic
-          #   The new topic.
-          # @see https://api.slack.com/methods/channels.setTopic
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.setTopic.json
-          def channels_setTopic(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            throw ArgumentError.new('Required arguments :topic missing') if options[:topic].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.setTopic', options)
-          end
-
-          #
-          # This method unarchives a channel. The calling user is added to the channel.
-          #
-          # @option options [channel] :channel
-          #   Channel to unarchive.
-          # @see https://api.slack.com/methods/channels.unarchive
-          # @see https://github.com/dblock/slack-api-ref/blob/master/methods/channels/channels.unarchive.json
-          def channels_unarchive(options = {})
-            throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
-            options = options.merge(channel: channels_id(options)['channel']['id']) if options[:channel]
-            post('channels.unarchive', options)
+            options = options.merge(channel: conversations_id(options)['channel']['id']) if options[:channel]
+            logger.warn('The channels.delete method is undocumented.')
+            post('channels.delete', options)
           end
         end
       end