slack-ruby-client 0.14.6 → 0.15.0

data/bin/commands/calls.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'Calls methods.'
+command 'calls' do |g|
+  g.desc 'Registers a new Call.'
+  g.long_desc %( Registers a new Call. )
+  g.command 'add' do |c|
+    c.flag 'external_unique_id', desc: 'An ID supplied by the 3rd-party Call provider. It must be unique across all Calls from that service.'
+    c.flag 'join_url', desc: 'The URL required for a client to join the Call.'
+    c.flag 'created_by', desc: '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.'
+    c.flag 'date_start', desc: 'Call start time in UTC UNIX timestamp format.'
+    c.flag 'desktop_app_join_url', desc: 'When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.'
+    c.flag 'external_display_id', desc: 'An optional, human-readable ID supplied by the 3rd-party Call provider. If supplied, this ID will be displayed in the Call object.'
+    c.flag 'title', desc: 'The name of the Call.'
+    c.flag 'users', desc: 'The list of users to register as participants in the Call. Read more on how to specify users here.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_add(options))
+    end
+  end
+
+  g.desc 'Ends a Call.'
+  g.long_desc %( Ends a Call. )
+  g.command 'end' do |c|
+    c.flag 'id', desc: 'id returned when registering the call using the calls.add method.'
+    c.flag 'duration', desc: 'Call duration in seconds.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_end(options))
+    end
+  end
+
+  g.desc 'Returns information about a Call.'
+  g.long_desc %( Returns information about a Call. )
+  g.command 'info' do |c|
+    c.flag 'id', desc: 'id of the Call returned by the calls.add method.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_info(options))
+    end
+  end
+
+  g.desc 'Updates information about a Call.'
+  g.long_desc %( Updates information about a Call. )
+  g.command 'update' do |c|
+    c.flag 'id', desc: 'id returned by the calls.add method.'
+    c.flag 'desktop_app_join_url', desc: 'When supplied, available Slack clients will attempt to directly launch the 3rd-party Call with this URL.'
+    c.flag 'join_url', desc: 'The URL required for a client to join the Call.'
+    c.flag 'title', desc: 'The name of the Call.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_update(options))
+    end
+  end
+end

data/bin/commands/calls_participants.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'CallsParticipants methods.'
+command 'calls_participants' do |g|
+  g.desc 'Registers new participants added to a Call.'
+  g.long_desc %( Registers new participants added to a Call. )
+  g.command 'add' do |c|
+    c.flag 'id', desc: 'id returned by the calls.add method.'
+    c.flag 'users', desc: 'The list of users to add as participants in the Call. Read more on how to specify users here.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_participants_add(options))
+    end
+  end
+
+  g.desc 'Registers participants removed from a Call.'
+  g.long_desc %( Registers participants removed from a Call. )
+  g.command 'remove' do |c|
+    c.flag 'id', desc: 'id returned by the calls.add method.'
+    c.flag 'users', desc: 'The list of users to remove as participants in the Call. Read more on how to specify users here.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.calls_participants_remove(options))
+    end
+  end
+end

data/bin/commands/chat.rb

@@ -137,13 +137,13 @@ command 'chat' do |g|
   g.long_desc %( Updates a message. )
   g.command 'update' do |c|
     c.flag 'channel', desc: 'Channel containing the message to be updated.'
-    c.flag 'text', desc: "New text for the message, using the default formatting rules. It's not required when presenting attachments."
     c.flag 'ts', desc: 'Timestamp of the message to be updated.'
     c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
-    c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text.'
-    c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
-    c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. See below.'
-    c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.'
+    c.flag 'attachments', desc: "A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text. If you don't include this field, the message's previous attachments will be retained. To remove previous attachments, include an empty array for this field."
+    c.flag 'blocks', desc: "A JSON-based array of structured blocks, presented as a URL-encoded string. If you don't include this field, the message's previous blocks will be retained. To remove previous blocks, include an empty array for this field."
+    c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, none.'
+    c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. Accepts either none or full. If you do not specify a value for this field, the original value set for the message will be overwritten with the default, client.'
+    c.flag 'text', desc: "New text for the message, using the default formatting rules. It's not required when presenting blocks or attachments."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_update(options))
     end

data/bin/commands/conversations.rb

@@ -26,7 +26,6 @@ command 'conversations' do |g|
   g.command 'create' do |c|
     c.flag 'name', desc: 'Name of the public or private channel to create.'
     c.flag 'is_private', desc: 'Create a private channel instead of a public one.'
-    c.flag 'user_ids', desc: 'Required for workspace apps. A list of between 1 and 30 human users that will be added to the newly-created conversation. This argument has no effect when used by classic Slack apps.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.conversations_create(options))
     end

data/lib/slack-ruby-client.rb

@@ -15,12 +15,12 @@ require 'json'
 require 'logger'
 begin
   require 'picky'
-rescue LoadError # rubocop:disable Lint/HandleExceptions
+rescue LoadError # rubocop:disable Lint/SuppressedException
   # ignore, only used in users_search
 end
 begin
   require 'openssl'
-rescue LoadError # rubocop:disable Lint/HandleExceptions
+rescue LoadError # rubocop:disable Lint/SuppressedException
   # Used in slack/web/config
 end
 require_relative 'slack/web/config'
@@ -37,8 +37,6 @@ require_relative 'slack/web/pagination/cursor'
 require_relative 'slack/web/client'
 
 # RealTime API
-require 'active_support'
-require 'active_support/core_ext'
 require_relative 'slack/real_time/concurrency'
 require_relative 'slack/real_time/socket'
 require_relative 'slack/real_time/api/message_id'

data/lib/slack/messages/message.rb

@@ -2,10 +2,6 @@
 module Slack
   module Messages
     class Message < Hashie::Mash
-      def presence
-        super['presence']
-      end
-
       def to_s
         keys.sort_by(&:to_s).map do |key|
           "#{key}=#{self[key]}"

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

@@ -114,9 +114,7 @@ module Slack
 
           def build_endpoint
             endpoint = ::Async::IO::Endpoint.tcp(addr, port)
-            if secure?
-              endpoint = ::Async::IO::SSLEndpoint.new(endpoint, ssl_context: build_ssl_context)
-            end
+            endpoint = ::Async::IO::SSLEndpoint.new(endpoint, ssl_context: build_ssl_context) if secure?
             endpoint
           end
 

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

@@ -8,9 +8,9 @@ module Slack
       module Eventmachine
         class Client < Faye::WebSocket::Client
           def initialize(url, protocols = nil, options = {})
-            @logger =
-              options.fetch(:logger) || Slack::RealTime::Config.logger || Slack::Config.logger
-            super url, protocols, options.except(:logger)
+            options = options.dup
+            @logger = options.delete(:logger) || Slack::RealTime::Config.logger || Slack::Config.logger
+            super url, protocols, options
           end
 
           def parse(data)

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

@@ -3,10 +3,6 @@ module Slack
   module RealTime
     module Models
       class Base < Hashie::Mash
-        def presence
-          super['presence']
-        end
-
         # see https://github.com/intridea/hashie/issues/394
         def log_built_in_message(*); end
       end

data/lib/slack/real_time/socket.rb

@@ -8,9 +8,9 @@ module Slack
 
       def initialize(url, options = {})
         @url = url
-        @options = options
+        @options = options.dup
         @driver = nil
-        @logger = options.delete(:logger) || Slack::RealTime::Config.logger || Slack::Config.logger
+        @logger = @options.delete(:logger) || Slack::RealTime::Config.logger || Slack::Config.logger
         @last_message_at = nil
       end
 

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

@@ -4,7 +4,9 @@ module Slack
     module Stores
       # Doesn't store anything.
       class Base
-        class_attribute :events
+        class << self
+          attr_accessor :events
+        end
 
         attr_accessor :users
         attr_accessor :bots

data/lib/slack/version.rb

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

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

@@ -6,6 +6,8 @@ require_relative 'endpoints/admin_apps_approved'
 require_relative 'endpoints/admin_apps_requests'
 require_relative 'endpoints/admin_apps_restricted'
 require_relative 'endpoints/admin_conversations'
+require_relative 'endpoints/admin_conversations_restrictAccess'
+require_relative 'endpoints/admin_conversations_whitelist'
 require_relative 'endpoints/admin_emoji'
 require_relative 'endpoints/admin_inviteRequests'
 require_relative 'endpoints/admin_inviteRequests_approved'
@@ -14,6 +16,7 @@ require_relative 'endpoints/admin_teams'
 require_relative 'endpoints/admin_teams_admins'
 require_relative 'endpoints/admin_teams_owners'
 require_relative 'endpoints/admin_teams_settings'
+require_relative 'endpoints/admin_usergroups'
 require_relative 'endpoints/admin_users'
 require_relative 'endpoints/admin_users_session'
 require_relative 'endpoints/api'
@@ -24,6 +27,8 @@ require_relative 'endpoints/apps_permissions_scopes'
 require_relative 'endpoints/apps_permissions_users'
 require_relative 'endpoints/auth'
 require_relative 'endpoints/bots'
+require_relative 'endpoints/calls'
+require_relative 'endpoints/calls_participants'
 require_relative 'endpoints/channels'
 require_relative 'endpoints/chat'
 require_relative 'endpoints/chat_scheduledMessages'
@@ -60,6 +65,7 @@ module Slack
   module Web
     module Api
       module Endpoints
+        include Slack::Web::Api::Mixins::Conversations
         include Slack::Web::Api::Mixins::Channels
         include Slack::Web::Api::Mixins::Users
         include Slack::Web::Api::Mixins::Groups
@@ -69,6 +75,8 @@ module Slack
         include AdminAppsRequests
         include AdminAppsRestricted
         include AdminConversations
+        include AdminConversationsRestrictaccess
+        include AdminConversationsWhitelist
         include AdminEmoji
         include AdminInviterequests
         include AdminInviterequestsApproved
@@ -77,6 +85,7 @@ module Slack
         include AdminTeamsAdmins
         include AdminTeamsOwners
         include AdminTeamsSettings
+        include AdminUsergroups
         include AdminUsers
         include AdminUsersSession
         include Api
@@ -87,6 +96,8 @@ module Slack
         include AppsPermissionsUsers
         include Auth
         include Bots
+        include Calls
+        include CallsParticipants
         include Channels
         include Chat
         include ChatScheduledmessages

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

@@ -14,7 +14,7 @@ module Slack
           # @option options [Object] :org_channel
           #   True if channel has to be converted to an org channel.
           # @option options [Object] :target_team_ids
-          #   The list of workspaces to which the channel should be shared. Not required if the channel is being shared orgwide. Example: ['T1234', 'T5678'].
+          #   A comma-separated list of workspaces to which the channel should be shared. Not required if the channel is being shared org-wide.
           # @option options [Object] :team_id
           #   The workspace to which the channel belongs. Omit this argument if the channel is a cross-workspace shared channel.
           # @see https://api.slack.com/methods/admin.conversations.setTeams

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

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminConversationsRestrictaccess
+          #
+          # Add an allowlist of IDP groups for accessing a channel
+          #
+          # @option options [Object] :channel_id
+          #   The channel to link this group to.
+          # @option options [Object] :group_id
+          #   The IDP Group ID to be an allowlist for the private channel.
+          # @option options [Object] :team_id
+          #   The workspace where the IDP Group and channel exist.
+          # @see https://api.slack.com/methods/admin.conversations.restrictAccess.addGroup
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations.restrictAccess/admin.conversations.restrictAccess.addGroup.json
+          def admin_conversations_restrictAccess_addGroup(options = {})
+            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            throw ArgumentError.new('Required arguments :group_id missing') if options[:group_id].nil?
+            post('admin.conversations.restrictAccess.addGroup', options)
+          end
+
+          #
+          # List all IDP Groups linked to a channel
+          #
+          # @option options [Object] :channel_id
+          #   .
+          # @option options [Object] :team_id
+          #   The workspace where the channele exists. This argument is required for channels only tied to one workspace, and optional for channels that are shared across an organization.
+          # @see https://api.slack.com/methods/admin.conversations.restrictAccess.listGroups
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations.restrictAccess/admin.conversations.restrictAccess.listGroups.json
+          def admin_conversations_restrictAccess_listGroups(options = {})
+            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            post('admin.conversations.restrictAccess.listGroups', options)
+          end
+
+          #
+          # Remove a linked IDP group linked from a private channel
+          #
+          # @option options [Object] :channel_id
+          #   The channel to remove the linked group from.
+          # @option options [Object] :group_id
+          #   The IDP Group ID to remove from the private channel.
+          # @option options [Object] :team_id
+          #   The workspace where the IDP Group and channel exist.
+          # @see https://api.slack.com/methods/admin.conversations.restrictAccess.removeGroup
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations.restrictAccess/admin.conversations.restrictAccess.removeGroup.json
+          def admin_conversations_restrictAccess_removeGroup(options = {})
+            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            throw ArgumentError.new('Required arguments :group_id missing') if options[:group_id].nil?
+            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
+            post('admin.conversations.restrictAccess.removeGroup', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminConversationsWhitelist
+          #
+          # Add an allowlist of IDP groups for accessing a channel
+          #
+          # @option options [Object] :channel_id
+          #   The channel to whitelist a group for.
+          # @option options [Object] :group_id
+          #   The IDP Group ID to whitelist for the private channel.
+          # @option options [Object] :team_id
+          #   The workspace where the IDP Group and channel exist.
+          # @see https://api.slack.com/methods/admin.conversations.whitelist.add
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations.whitelist/admin.conversations.whitelist.add.json
+          def admin_conversations_whitelist_add(options = {})
+            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            throw ArgumentError.new('Required arguments :group_id missing') if options[:group_id].nil?
+            logger.warn('admin.conversations.whitelist.add:  Alternative methods: .')
+            post('admin.conversations.whitelist.add', options)
+          end
+
+          #
+          # List all IDP Groups linked to a channel
+          #
+          # @option options [Object] :channel_id
+          #   .
+          # @option options [Object] :team_id
+          #   The workspace where the channele exists. This argument is required for channels only tied to one workspace, and optional for channels that are shared across an organization.
+          # @see https://api.slack.com/methods/admin.conversations.whitelist.listGroupsLinkedToChannel
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations.whitelist/admin.conversations.whitelist.listGroupsLinkedToChannel.json
+          def admin_conversations_whitelist_listGroupsLinkedToChannel(options = {})
+            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            logger.warn('admin.conversations.whitelist.listGroupsLinkedToChannel:  Alternative methods: .')
+            post('admin.conversations.whitelist.listGroupsLinkedToChannel', options)
+          end
+
+          #
+          # Remove an allowlisted IDP group linked to a private channel
+          #
+          # @option options [Object] :channel_id
+          #   The channel to remove a whitelisted group for.
+          # @option options [Object] :group_id
+          #   The IDP Group ID to remove from the private channel whitelist.
+          # @option options [Object] :team_id
+          #   The workspace where the IDP Group and channel exist.
+          # @see https://api.slack.com/methods/admin.conversations.whitelist.remove
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.conversations.whitelist/admin.conversations.whitelist.remove.json
+          def admin_conversations_whitelist_remove(options = {})
+            throw ArgumentError.new('Required arguments :channel_id missing') if options[:channel_id].nil?
+            throw ArgumentError.new('Required arguments :group_id missing') if options[:group_id].nil?
+            throw ArgumentError.new('Required arguments :team_id missing') if options[:team_id].nil?
+            logger.warn('admin.conversations.whitelist.remove:  Alternative methods: .')
+            post('admin.conversations.whitelist.remove', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminUsergroups
+          #
+          # Add one or more default channels to an IDP group.
+          #
+          # @option options [Object] :channel_ids
+          #   Comma separated string of channel IDs.
+          # @option options [Object] :usergroup_id
+          #   ID of the IDP group to add default channels for.
+          # @option options [Object] :team_id
+          #   The workspace to add default channels in.
+          # @see https://api.slack.com/methods/admin.usergroups.addChannels
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.addChannels.json
+          def admin_usergroups_addChannels(options = {})
+            throw ArgumentError.new('Required arguments :channel_ids missing') if options[:channel_ids].nil?
+            throw ArgumentError.new('Required arguments :usergroup_id missing') if options[:usergroup_id].nil?
+            post('admin.usergroups.addChannels', options)
+          end
+
+          #
+          # Associate one or more default workspaces with an organization-wide IDP group.
+          #
+          # @option options [Object] :team_ids
+          #   A comma separated list of encoded team (workspace) IDs. Each workspace MUST belong to the organization associated with the token.
+          # @option options [Object] :usergroup_id
+          #   An encoded usergroup (IDP Group) ID.
+          # @option options [Object] :auto_provision
+          #   When true, this method automatically creates new workspace accounts for the IDP group members.
+          # @see https://api.slack.com/methods/admin.usergroups.addTeams
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.addTeams.json
+          def admin_usergroups_addTeams(options = {})
+            throw ArgumentError.new('Required arguments :team_ids missing') if options[:team_ids].nil?
+            throw ArgumentError.new('Required arguments :usergroup_id missing') if options[:usergroup_id].nil?
+            post('admin.usergroups.addTeams', options)
+          end
+
+          #
+          # List the channels linked to an org-level IDP group (user group).
+          #
+          # @option options [Object] :usergroup_id
+          #   ID of the IDP group to list default channels for.
+          # @option options [Object] :include_num_members
+          #   Flag to include or exclude the count of members per channel.
+          # @option options [Object] :team_id
+          #   ID of the the workspace.
+          # @see https://api.slack.com/methods/admin.usergroups.listChannels
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.listChannels.json
+          def admin_usergroups_listChannels(options = {})
+            throw ArgumentError.new('Required arguments :usergroup_id missing') if options[:usergroup_id].nil?
+            post('admin.usergroups.listChannels', options)
+          end
+
+          #
+          # Remove one or more default channels from an org-level IDP group (user group).
+          #
+          # @option options [Object] :channel_ids
+          #   Comma-separated string of channel IDs.
+          # @option options [Object] :usergroup_id
+          #   ID of the IDP Group.
+          # @see https://api.slack.com/methods/admin.usergroups.removeChannels
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.usergroups/admin.usergroups.removeChannels.json
+          def admin_usergroups_removeChannels(options = {})
+            throw ArgumentError.new('Required arguments :channel_ids missing') if options[:channel_ids].nil?
+            throw ArgumentError.new('Required arguments :usergroup_id missing') if options[:usergroup_id].nil?
+            post('admin.usergroups.removeChannels', options)
+          end
+        end
+      end
+    end
+  end
+end