slack-ruby-client 0.14.2 → 0.14.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 358de8d699475c86a5e79c8c96e082dd55b9f60fcb44ed806f62758c3e99479e
-  data.tar.gz: ae9bceefa9fef8950b823bcb6f6ff7023ca027a268022500a9e48d8d5aa28f85
+  metadata.gz: 52a5d3c9923ec690ce3051c29b1dbf352a51ddc767fe97b073e57d1475bc62c0
+  data.tar.gz: 573ca30fa89b54863b445bc4132382f9b2c7d9ec5054e24d0ca8998aed43d1d2
 SHA512:
-  metadata.gz: 03c79a47ba7b75a13ca37bb1a592faca4c3d6c4d1f53b34ba205a8587bb72b26a6d009fb22cb9a57b63e017dac6b05ef344f13b68f045b57679fd950e0ed686a
-  data.tar.gz: 1761adca1f3ab450cb630102ea77f293340815c9a7e6c17b6afcf0f1fd73172f79cef25e4f89905c134a5b171a4f247d4e733f4c551ca90c57c1519e8f851801
+  metadata.gz: 54c5b782b45afb9268adfe9511b622d28d9d1e17db1e3cbdec0ffc6490870ef8ce7c12b9d20f1f580991bae9824e32a803509fca7acd912ad0dd2b9ce193ffb4
+  data.tar.gz: 513a1fe8c32d952a9ac6c5a848e63ccfcd372616434f4aba62e00cdf107dea191c4bfa072acde577ca5df4f7aa29b86225419741a0f203bb73f92e488f443338

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2019-04-09 22:16:03 -0500 using RuboCop version 0.61.1.
+# on 2019-07-21 18:39:19 -0400 using RuboCop version 0.61.1.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -13,10 +13,11 @@ Lint/AssignmentInCondition:
     - 'lib/slack/real_time/concurrency/async.rb'
     - 'lib/slack/real_time/socket.rb'
 
-# Offense count: 4
+# Offense count: 5
 Lint/HandleExceptions:
   Exclude:
     - 'lib/slack-ruby-client.rb'
+    - 'lib/slack/real_time/concurrency/async.rb'
     - 'spec/slack/real_time/concurrency/celluloid_spec.rb'
     - 'spec/slack/real_time/concurrency/eventmachine_spec.rb'
 
@@ -50,7 +51,7 @@ Style/AccessModifierDeclarations:
     - 'lib/slack/real_time/concurrency/eventmachine.rb'
     - 'lib/slack/real_time/socket.rb'
 
-# Offense count: 154
+# Offense count: 155
 # Configuration parameters: AllowedVariables.
 Style/GlobalVars:
   Enabled: false

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+### 0.14.3 (2019/7/23)
+
+* [#279](https://github.com/slack-ruby/slack-ruby-client/pull/279): Prevent ping worker from dying on unexpected errors - [@dblock](https://github.com/dblock).
+* [#281](https://github.com/slack-ruby/slack-ruby-client/pull/281): Added `admin_users_session_reset` to Web API - [@dblock](https://github.com/dblock).
+* [#283](https://github.com/slack-ruby/slack-ruby-client/pull/283): Fail when used with incompatible async-websocket > 0.8.0 - [@dblock](https://github.com/dblock).
+* [#284](https://github.com/slack-ruby/slack-ruby-client/pull/284): Include team id, name and domain in log output - [@dblock](https://github.com/dblock).
+
 ### 0.14.2 (2019/4/12)
 
 * [#256](https://github.com/slack-ruby/slack-ruby-client/pull/256): Added support for specifying signing secrets on a per-request basis via optional parameters to the `Slack::Events::Request` constructor - [@gabrielmdeal](https://github.com/gabrielmdeal).

data/Gemfile

@@ -2,7 +2,14 @@ source 'http://rubygems.org'
 
 gemspec
 
-gem ENV['CONCURRENCY'], require: false if ENV.key?('CONCURRENCY')
+if ENV.key?('CONCURRENCY')
+  case ENV['CONCURRENCY']
+  when 'async-websocket'
+    gem 'async-websocket', '~> 0.8.0', require: false
+  else
+    gem ENV['CONCURRENCY'], require: false
+  end
+end
 
 group :test do
   gem 'danger-toc', '~> 0.1.3', require: false

data/README.md

@@ -66,7 +66,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
 
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-client, 0.14.2. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client, 0.14.3. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -79,7 +79,7 @@ gem 'slack-ruby-client'
 If you're going to be using the RealTime client, add either `async-websocket`, `eventmachine` and `faye-websocket` or `celluloid-io`. See below for more information about concurrency. We recommend you use `async-websocket`.
 
 ```
-gem 'async-websocket'
+gem 'async-websocket', '~> 0.8.0'
 ```
 
 Run `bundle install`.

data/UPGRADING.md

@@ -1,6 +1,16 @@
 Upgrading Slack-Ruby-Client
 ===========================
 
+### Upgrading to >= 0.14.0
+
+If you are using async-websocket, lock down its version to 0.8.0 as newer versions are currently incompatible.
+
+```
+gem 'async-websocket', '~> 0.8.0'
+```
+
+See [#282](https://github.com/slack-ruby/slack-ruby-client/issues/282) for more information.
+
 ### Upgrading to >= 0.13.0
 
 #### Recommended Async Library

data/bin/commands.rb

@@ -1,5 +1,6 @@
 # This file was auto-generated by lib/tasks/web.rake
 
+require 'commands/admin_users_session'
 require 'commands/api'
 require 'commands/apps'
 require 'commands/apps_permissions'

data/bin/commands/admin_users_session.rb

@@ -0,0 +1,15 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'AdminUsersSession methods.'
+command 'admin_users_session' do |g|
+  g.desc "This method wipes a user session, leaving the user unauthenticated. The user's Slack client will reset its local cache."
+  g.long_desc %( This method wipes a user session, leaving the user unauthenticated. The user's Slack client will reset its local cache. )
+  g.command 'reset' do |c|
+    c.flag 'user_id', desc: 'The ID of the user to wipe sessions for.'
+    c.flag 'mobile_only', desc: 'Only expire mobile sessions (default: false).'
+    c.flag 'web_only', desc: 'Only expire web sessions (default: false).'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.admin_users_session_reset(options))
+    end
+  end
+end

data/bin/commands/apps.rb

@@ -2,8 +2,8 @@
 
 desc 'Apps methods.'
 command 'apps' do |g|
-  g.desc 'This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app.'
-  g.long_desc %( This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app. )
+  g.desc 'This method uninstalls an app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of an app.'
+  g.long_desc %( This method uninstalls an app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of an app. )
   g.command 'uninstall' do |c|
     c.flag 'client_id', desc: 'Issued when you created your application.'
     c.flag 'client_secret', desc: 'Issued when you created your application.'

data/bin/commands/chat.rb

@@ -58,15 +58,18 @@ command 'chat' do |g|
   g.desc 'This method posts an ephemeral message, which is visible only to the assigned user in a specific public channel, private channel, or private conversation.'
   g.long_desc %( This method posts an ephemeral message, which is visible only to the assigned user in a specific public channel, private channel, or private conversation. )
   g.command 'postEphemeral' do |c|
+    c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
     c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.'
     c.flag 'text', desc: "Text of the message to send. See below for an explanation of formatting. This field is usually required, unless you're providing only attachments instead."
     c.flag 'user', desc: 'id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.'
     c.flag 'as_user', desc: 'Pass true to post the message as the authed user. Defaults to true if the chat:write:bot scope is not included. Otherwise, defaults to false.'
-    c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string.'
     c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
+    c.flag 'icon_emoji', desc: 'Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
+    c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.'
     c.flag 'link_names', desc: 'Find and link channel names and usernames.'
     c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
     c.flag 'thread_ts', desc: "Provide another message's ts value to post this message in a thread. Avoid using a reply's ts value; use its parent's value instead. Ephemeral messages in threads are only shown if there is already an active thread."
+    c.flag 'username', desc: "Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_postEphemeral(options))
     end

data/bin/commands/conversations.rb

@@ -2,8 +2,8 @@
 
 desc 'Conversations methods.'
 command 'conversations' do |g|
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This method archives a conversation. Not all types of conversations can be archived.'
+  g.long_desc %( This method archives a conversation. Not all types of conversations can be archived. )
   g.command 'archive' do |c|
     c.flag 'channel', desc: 'ID of conversation to archive.'
     c.action do |_global_options, options, _args|
@@ -11,8 +11,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method closes direct messages, multi-person or 1:1 or otherwise.'
+  g.long_desc %( This Conversations API method closes direct messages, multi-person or 1:1 or otherwise. )
   g.command 'close' do |c|
     c.flag 'channel', desc: 'Conversation to close.'
     c.action do |_global_options, options, _args|
@@ -20,8 +20,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'Create a public or private channel using this Conversations API method.'
+  g.long_desc %( Create a public or private channel using this Conversations API method. )
   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.'
@@ -31,8 +31,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This method returns a portion of message events from the specified conversation.'
+  g.long_desc %( This method returns a portion of message events from the specified conversation. )
   g.command 'history' do |c|
     c.flag 'channel', desc: 'Conversation ID to fetch history for.'
     c.flag 'cursor', desc: "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."
@@ -45,8 +45,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method returns information about a workspace conversation.'
+  g.long_desc %( This Conversations API method returns information about a workspace conversation. )
   g.command 'info' do |c|
     c.flag 'channel', desc: 'Conversation ID to learn more about.'
     c.flag 'include_locale', desc: 'Set this to true to receive the locale for this conversation. Defaults to false.'
@@ -56,8 +56,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method invites 1-30 users to a public or private channel. The calling user must be a member of the channel.'
+  g.long_desc %( This Conversations API method invites 1-30 users to a public or private channel. The calling user must be a member of the channel. )
   g.command 'invite' do |c|
     c.flag 'channel', desc: 'The ID of the public or private channel to invite user(s) to.'
     c.flag 'users', desc: 'A comma separated list of user IDs. Up to 30 users may be listed.'
@@ -66,8 +66,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method joins a user to an existing conversation.'
+  g.long_desc %( This Conversations API method joins a user to an existing conversation. )
   g.command 'join' do |c|
     c.flag 'channel', desc: 'ID of conversation to join.'
     c.action do |_global_options, options, _args|
@@ -75,8 +75,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method allows a user to remove another member from a channel.'
+  g.long_desc %( This Conversations API method allows a user to remove another member from a channel. )
   g.command 'kick' do |c|
     c.flag 'channel', desc: 'ID of conversation to remove user from.'
     c.flag 'user', desc: 'User ID to be removed.'
@@ -85,8 +85,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method makes like a tree and leaves a conversation.'
+  g.long_desc %( This Conversations API method makes like a tree and leaves a conversation. )
   g.command 'leave' do |c|
     c.flag 'channel', desc: 'Conversation to leave.'
     c.action do |_global_options, options, _args|
@@ -94,8 +94,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method returns a list of all channel-like conversations in a workspace. The "channels" returned depend on what the calling token has access to and the directives placed in the types parameter.'
+  g.long_desc %( This Conversations API method returns a list of all channel-like conversations in a workspace. The "channels" returned depend on what the calling token has access to and the directives placed in the types parameter. )
   g.command 'list' do |c|
     c.flag 'cursor', desc: "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."
     c.flag 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'
@@ -106,8 +106,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method returns a paginated list of members party to a conversation.'
+  g.long_desc %( This Conversations API method returns a paginated list of members party to a conversation. )
   g.command 'members' do |c|
     c.flag 'channel', desc: 'ID of the conversation to retrieve members for.'
     c.flag 'cursor', desc: "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."
@@ -117,8 +117,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method opens a multi-person direct message or just a 1:1 direct message.'
+  g.long_desc %( This Conversations API method opens a multi-person direct message or just a 1:1 direct message. )
   g.command 'open' do |c|
     c.flag 'channel', desc: "Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead."
     c.flag 'return_im', desc: 'Boolean, indicates you want the full IM channel definition in the response.'
@@ -128,8 +128,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This method renames a conversation. Some types of conversations cannot be renamed.'
+  g.long_desc %( This method renames a conversation. Some types of conversations cannot be renamed. )
   g.command 'rename' do |c|
     c.flag 'channel', desc: 'ID of conversation to rename.'
     c.flag 'name', desc: 'New name for conversation.'
@@ -138,8 +138,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This Conversations API method returns an entire thread (a message plus all the messages in reply to it), while conversations.history method returns only parent messages.'
+  g.long_desc %( This Conversations API method returns an entire thread (a message plus all the messages in reply to it), while conversations.history method returns only parent messages. )
   g.command 'replies' do |c|
     c.flag 'channel', desc: 'Conversation ID to fetch thread from.'
     c.flag 'ts', desc: "Unique identifier of a thread's parent message."
@@ -153,8 +153,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This method is used to change the purpose of a conversation. The calling user must be a member of the conversation. Not all conversation types may have a purpose set.'
+  g.long_desc %( This method is used to change the purpose of a conversation. The calling user must be a member of the conversation. Not all conversation types may have a purpose set. )
   g.command 'setPurpose' do |c|
     c.flag 'channel', desc: 'Conversation to set the purpose of.'
     c.flag 'purpose', desc: 'A new, specialer purpose.'
@@ -163,8 +163,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This method is used to change the topic of a conversation. The calling user must be a member of the conversation. Not all conversation types support a new topic.'
+  g.long_desc %( This method is used to change the topic of a conversation. The calling user must be a member of the conversation. Not all conversation types support a new topic. )
   g.command 'setTopic' do |c|
     c.flag 'channel', desc: 'Conversation to set the topic of.'
     c.flag 'topic', desc: 'The new topic string. Does not support formatting or linkification.'
@@ -173,8 +173,8 @@ command 'conversations' do |g|
     end
   end
 
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This method unarchives a conversation. The calling user is added to the conversation.'
+  g.long_desc %( This method unarchives a conversation. The calling user is added to the conversation. )
   g.command 'unarchive' do |c|
     c.flag 'channel', desc: 'ID of conversation to unarchive.'
     c.action do |_global_options, options, _args|

data/bin/commands/groups.rb

@@ -22,7 +22,7 @@ command 'groups' do |g|
   end
 
   g.desc 'This method takes an existing private channel and performs the following steps:'
-  g.long_desc %( This method takes an existing private channel and performs the following steps: )
+  g.long_desc %( This method takes an existing private channel and performs the following steps: - Renames the existing private channel (from "example" to "example-archived"). - Archives the existing private channel. - Creates a new private channel with the name of the existing private channel. - Adds all members of the existing private channel to the new private channel. )
   g.command 'createChild' do |c|
     c.flag 'channel', desc: 'Private channel to clone and archive.'
     c.action do |_global_options, options, _args|

data/bin/commands/pins.rb

@@ -2,8 +2,8 @@
 
 desc 'Pins methods.'
 command 'pins' do |g|
-  g.desc 'This method pins an item (file, file comment, channel message, or group message) to a particular channel.'
-  g.long_desc %( This method pins an item (file, file comment, channel message, or group message) to a particular channel. The channel argument is required and one of file, file_comment, or timestamp must also be specified. )
+  g.desc 'This method pins a channel message or group message to a particular channel.'
+  g.long_desc %( This method pins a channel message or group message to a particular channel. The channel argument is required and timestamp must also be specified. )
   g.command 'add' do |c|
     c.flag 'channel', desc: 'Channel to pin the item in.'
     c.flag 'file', desc: 'File to pin.'

data/bin/commands/team.rb

@@ -23,6 +23,7 @@ command 'team' do |g|
   g.desc 'This method provides information about your team.'
   g.long_desc %( This method provides information about your team. )
   g.command 'info' do |c|
+    c.flag 'team', desc: 'Team to get info on, if omitted, will return information about the current team. Will only return team that the authenticated token is allowed to see through external shared channels.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.team_info(options))
     end

data/bin/commands/users.rb

@@ -2,8 +2,8 @@
 
 desc 'Users methods.'
 command 'users' do |g|
-  g.desc "As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed."
-  g.long_desc %( As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed. )
+  g.desc 'This method helps answer questions like:'
+  g.long_desc %( This method helps answer questions like: - Which conversations am I a member of? - Which public channels is my bot user in? - Do I have any direct messages open with my friend Suzy? - Is my bot a member of any private channels? )
   g.command 'conversations' do |c|
     c.flag 'cursor', desc: "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."
     c.flag 'exclude_archived', desc: 'Set to true to exclude archived channels from the list.'

data/lib/slack/real_time/client.rb

@@ -82,18 +82,18 @@ module Slack
       def run_loop
         @socket.connect! do |driver|
           driver.on :open do |event|
-            logger.debug("#{self.class}##{__method__}") { event.class.name }
+            logger.debug("#{self}##{__method__}") { event.class.name }
             open(event)
             callback(event, :open)
           end
 
           driver.on :message do |event|
-            logger.debug("#{self.class}##{__method__}") { "#{event.class}, #{event.data}" }
+            logger.debug("#{self}##{__method__}") { "#{event.class}, #{event.data}" }
             dispatch(event)
           end
 
           driver.on :close do |event|
-            logger.debug("#{self.class}##{__method__}") { event.class.name }
+            logger.debug("#{self}##{__method__}") { event.class.name }
             callback(event, :close)
             close(event)
             callback(event, :closed)
@@ -127,17 +127,30 @@ module Slack
       def run_ping!
         return if keep_alive?
 
+        logger.warn(to_s) { 'is offline' }
+
         restart_async
+      rescue StandardError => e
+        # disregard all ping worker failures, keep pinging
+        logger.debug("#{self}##{__method__}") { e }
       end
 
       def run_ping?
         !websocket_ping.nil? && websocket_ping > 0
       end
 
+      def to_s
+        if store && store.team
+          "id=#{store.team.id}, name=#{store.team.name}, domain=#{store.team.domain}"
+        else
+          super
+        end
+      end
+
       protected
 
       def restart_async
-        logger.debug("#{self.class}##{__method__}")
+        logger.debug("#{self}##{__method__}")
         @socket.close
         start = web_client.send(rtm_start_method, start_options)
         data = Slack::Messages::Message.new(start)
@@ -183,7 +196,7 @@ module Slack
       def send_json(data)
         raise ClientNotStartedError unless started?
 
-        logger.debug("#{self.class}##{__method__}") { data }
+        logger.debug("#{self}##{__method__}") { data }
         @socket.send_data(data.to_json)
       end
 
@@ -204,7 +217,7 @@ module Slack
         end
         true
       rescue StandardError => e
-        logger.error e
+        logger.error("#{self}##{__method__}") { e }
         false
       end
 
@@ -216,11 +229,11 @@ module Slack
         return false unless type
 
         type = type.to_s
-        logger.debug("#{self.class}##{__method__}") { data.to_s }
+        logger.debug("#{self}##{__method__}") { data.to_s }
         run_handlers(type, data) if @store
         run_callbacks(type, data)
       rescue StandardError => e
-        logger.error e
+        logger.error("#{self}##{__method__}") { e }
         false
       end
 
@@ -232,7 +245,7 @@ module Slack
           end
         end
       rescue StandardError => e
-        logger.error e
+        logger.error("#{self}##{__method__}") { e }
         false
       end
 
@@ -245,7 +258,7 @@ module Slack
         end
         true
       rescue StandardError => e
-        logger.error e
+        logger.error("#{self}##{__method__}") { e }
         false
       end
     end

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

@@ -30,7 +30,7 @@ module Slack
 
               if client.run_ping?
                 @ping_task = task.async do |subtask|
-                  subtask.annotate 'client keep-alive'
+                  subtask.annotate "#{client} keep-alive"
 
                   # The timer task will naturally exit after the driver is set to nil.
                   while @restart
@@ -45,11 +45,12 @@ module Slack
 
                 @client_task = task.async do |subtask|
                   begin
-                    subtask.annotate 'client run-loop'
+                    subtask.annotate "#{client} run-loop"
                     client.run_loop
                   rescue ::Async::Wrapper::Cancelled => e
                     # Will get restarted by ping worker.
-                    client.logger.warn(subtask.to_s) { e.message }
+                  rescue StandardError => e
+                    client.logger.error(subtask.to_s) { e.message }
                   end
                 end
 
@@ -129,3 +130,5 @@ module Slack
     end
   end
 end
+
+raise "Incompatible version of async-websocket, #{Async::WebSocket::VERSION}, use \"gem 'async-websocket', '~> 0.8.0'\"." if Gem::Version.new(Async::WebSocket::VERSION) >= Gem::Version.new('0.9.0')

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

@@ -14,6 +14,16 @@ module Slack
 
         ### RealTime Events
 
+        # 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
+        # on :external_org_migration_started do |data|
+
+        # An enterprise grid migration has finished on an external workspace..
+        # @see https://api.slack.com/events/external_org_migration_finished
+        # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/external_org_migration_finished.json
+        # on :external_org_migration_finished do |data|
+
         # A private channel was deleted.
         # @see https://api.slack.com/events/group_deleted
         # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/group_deleted.json

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

@@ -64,6 +64,16 @@ module Slack
 
         ### RealTime Events
 
+        # 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
+        # on :external_org_migration_started do |data|
+
+        # An enterprise grid migration has finished on an external workspace..
+        # @see https://api.slack.com/events/external_org_migration_finished
+        # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/external_org_migration_finished.json
+        # on :external_org_migration_finished do |data|
+
         # A private channel was deleted.
         # @see https://api.slack.com/events/group_deleted
         # @see https://github.com/slack-ruby/slack-api-ref/blob/master/events/group_deleted.json

data/lib/slack/version.rb

@@ -1,3 +1,3 @@
 module Slack
-  VERSION = '0.14.2'.freeze
+  VERSION = '0.14.3'.freeze
 end

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

@@ -1,5 +1,6 @@
 # This file was auto-generated by lib/tasks/web.rake
 
+require_relative 'endpoints/admin_users_session'
 require_relative 'endpoints/api'
 require_relative 'endpoints/apps'
 require_relative 'endpoints/apps_permissions'
@@ -45,6 +46,7 @@ module Slack
         include Slack::Web::Api::Mixins::Users
         include Slack::Web::Api::Mixins::Groups
 
+        include AdminUsersSession
         include Api
         include Apps
         include AppsPermissions

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

@@ -0,0 +1,27 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Web
+    module Api
+      module Endpoints
+        module AdminUsersSession
+          #
+          # This method wipes a user session, leaving the user unauthenticated. The user's Slack client will reset its local cache.
+          #
+          # @option options [Object] :user_id
+          #   The ID of the user to wipe sessions for.
+          # @option options [Object] :mobile_only
+          #   Only expire mobile sessions (default: false).
+          # @option options [Object] :web_only
+          #   Only expire web sessions (default: false).
+          # @see https://api.slack.com/methods/admin.users.session.reset
+          # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/admin.users.session/admin.users.session.reset.json
+          def admin_users_session_reset(options = {})
+            throw ArgumentError.new('Required arguments :user_id missing') if options[:user_id].nil?
+            post('admin.users.session.reset', options)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Apps
           #
-          # This method uninstalls a workspace app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of a workspace app.
+          # This method uninstalls an app. Unlike auth.revoke, which revokes a single token, this method revokes all tokens associated with a single installation of an app.
           #
           # @option options [Object] :client_id
           #   Issued when you created your application.

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

@@ -93,6 +93,8 @@ module Slack
           #
           # This method posts an ephemeral message, which is visible only to the assigned user in a specific public channel, private channel, or private conversation.
           #
+          # @option options [Object] :attachments
+          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [channel] :channel
           #   Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name.
           # @option options [Object] :text
@@ -101,16 +103,20 @@ module Slack
           #   id of the user who will receive the ephemeral message. The user should be in the channel specified by the channel argument.
           # @option options [Object] :as_user
           #   Pass true to post the message as the authed user. Defaults to true if the chat:write:bot scope is not included. Otherwise, defaults to false.
-          # @option options [Object] :attachments
-          #   A JSON-based array of structured attachments, presented as a URL-encoded string.
           # @option options [Object] :blocks
           #   A JSON-based array of structured blocks, presented as a URL-encoded string.
+          # @option options [Object] :icon_emoji
+          #   Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
+          # @option options [Object] :icon_url
+          #   URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @option options [Object] :link_names
           #   Find and link channel names and usernames.
           # @option options [Object] :parse
           #   Change how messages are treated. Defaults to none. See below.
           # @option options [Object] :thread_ts
           #   Provide another message's ts value to post this message in a thread. Avoid using a reply's ts value; use its parent's value instead. Ephemeral messages in threads are only shown if there is already an active thread.
+          # @option options [Object] :username
+          #   Set your bot's user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
           # @see https://api.slack.com/methods/chat.postEphemeral
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
           def chat_postEphemeral(options = {})

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

@@ -6,7 +6,7 @@ module Slack
       module Endpoints
         module Conversations
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This method archives a conversation. Not all types of conversations can be archived.
           #
           # @option options [channel] :channel
           #   ID of conversation to archive.
@@ -19,7 +19,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method closes direct messages, multi-person or 1:1 or otherwise.
           #
           # @option options [channel] :channel
           #   Conversation to close.
@@ -32,7 +32,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # Create a public or private channel using this Conversations API method.
           #
           # @option options [Object] :name
           #   Name of the public or private channel to create.
@@ -48,7 +48,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This method returns a portion of message events from the specified conversation.
           #
           # @option options [channel] :channel
           #   Conversation ID to fetch history for.
@@ -77,7 +77,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method returns information about a workspace conversation.
           #
           # @option options [channel] :channel
           #   Conversation ID to learn more about.
@@ -94,7 +94,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method invites 1-30 users to a public or private channel. The calling user must be a member of the channel.
           #
           # @option options [channel] :channel
           #   The ID of the public or private channel to invite user(s) to.
@@ -110,7 +110,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method joins a user to an existing conversation.
           #
           # @option options [channel] :channel
           #   ID of conversation to join.
@@ -123,7 +123,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method allows a user to remove another member from a channel.
           #
           # @option options [channel] :channel
           #   ID of conversation to remove user from.
@@ -140,7 +140,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method makes like a tree and leaves a conversation.
           #
           # @option options [channel] :channel
           #   Conversation to leave.
@@ -153,7 +153,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method returns a list of all channel-like conversations in a workspace. The "channels" returned depend on what the calling token has access to and the directives placed in the types parameter.
           #
           # @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.
@@ -176,7 +176,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method returns a paginated list of members party to a conversation.
           #
           # @option options [channel] :channel
           #   ID of the conversation to retrieve members for.
@@ -199,7 +199,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method opens a multi-person direct message or just a 1:1 direct message.
           #
           # @option options [channel] :channel
           #   Resume a conversation by supplying an im or mpim's ID. Or provide the users field instead.
@@ -215,7 +215,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This method renames a conversation. Some types of conversations cannot be renamed.
           #
           # @option options [channel] :channel
           #   ID of conversation to rename.
@@ -231,7 +231,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This Conversations API method returns an entire thread (a message plus all the messages in reply to it), while conversations.history method returns only parent messages.
           #
           # @option options [channel] :channel
           #   Conversation ID to fetch thread from.
@@ -263,7 +263,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This method is used to change the purpose of a conversation. The calling user must be a member of the conversation. Not all conversation types may have a purpose set.
           #
           # @option options [channel] :channel
           #   Conversation to set the purpose of.
@@ -279,7 +279,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This method is used to change the topic of a conversation. The calling user must be a member of the conversation. Not all conversation types support a new topic.
           #
           # @option options [channel] :channel
           #   Conversation to set the topic of.
@@ -295,7 +295,7 @@ module Slack
           end
 
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This method unarchives a conversation. The calling user is added to the conversation.
           #
           # @option options [channel] :channel
           #   ID of conversation to unarchive.

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

@@ -55,6 +55,7 @@ module Slack
           # @see https://api.slack.com/methods/dnd.teamInfo
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/dnd/dnd.teamInfo.json
           def dnd_teamInfo(options = {})
+            throw ArgumentError.new('Required arguments :users missing') if options[:users].nil?
             post('dnd.teamInfo', options)
           end
         end

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

@@ -34,6 +34,10 @@ module Slack
 
           #
           # This method takes an existing private channel and performs the following steps:
+          # - Renames the existing private channel (from "example" to "example-archived").
+          # - Archives the existing private channel.
+          # - Creates a new private channel with the name of the existing private channel.
+          # - Adds all members of the existing private channel to the new private channel.
           #
           # @option options [group] :channel
           #   Private channel to clone and archive.

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

@@ -6,8 +6,8 @@ module Slack
       module Endpoints
         module Pins
           #
-          # This method pins an item (file, file comment, channel message, or group message) to a particular channel.
-          # The channel argument is required and one of file, file_comment, or timestamp must also be specified.
+          # This method pins a channel message or group message to a particular channel.
+          # The channel argument is required and timestamp must also be specified.
           #
           # @option options [channel] :channel
           #   Channel to pin the item in.

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

@@ -32,6 +32,8 @@ module Slack
           #
           # This method provides information about your team.
           #
+          # @option options [Object] :team
+          #   Team to get info on, if omitted, will return information about the current team. Will only return team that the authenticated token is allowed to see through external shared channels.
           # @see https://api.slack.com/methods/team.info
           # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/team/team.info.json
           def team_info(options = {})

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

@@ -6,7 +6,11 @@ module Slack
       module Endpoints
         module Users
           #
-          # As part of the Conversations API, this method's required scopes depend on the type of channel-like object you're working with. For classic Slack apps, a corresponding channels: scope is required when working with public channels, groups: for private channels, also the same rules are applied for im: and mpim:. For workspace apps, a conversations: scope is all that's needed.
+          # This method helps answer questions like:
+          # - Which conversations am I a member of?
+          # - Which public channels is my bot user in?
+          # - Do I have any direct messages open with my friend Suzy?
+          # - Is my bot a member of any private channels?
           #
           # @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.

data/lib/slack/web/api/patches/chat.5.postEphemeral-text-or-attachments.patch

@@ -1,10 +1,12 @@
-diff --git a/slack-ruby-client/lib/slack/web/api/endpoints/chat.rb b/slack-ruby-client-original/lib/slack/web/api/endpoints/chat.rb
-index 194419e..2ef5c65 100644
+diff --git a/lib/slack/web/api/endpoints/chat.rb b/lib/slack/web/api/endpoints/chat.rb
+index e1c409d..3b24fea 100644
 --- a/lib/slack/web/api/endpoints/chat.rb
 +++ b/lib/slack/web/api/endpoints/chat.rb
-@@ -93,7 +93,7 @@ module Slack
+@@ -120,9 +120,8 @@ module Slack
+           # @see https://api.slack.com/methods/chat.postEphemeral
            # @see https://github.com/slack-ruby/slack-api-ref/blob/master/methods/chat/chat.postEphemeral.json
            def chat_postEphemeral(options = {})
+-            throw ArgumentError.new('Required arguments :attachments missing') if options[:attachments].nil?
              throw ArgumentError.new('Required arguments :channel missing') if options[:channel].nil?
 -            throw ArgumentError.new('Required arguments :text missing') if options[:text].nil?
 +            throw ArgumentError.new('Required arguments :text or :attachments missing') if options[:text].nil? && options[:attachments].nil?

data/spec/slack/real_time/client_spec.rb

@@ -86,6 +86,9 @@ RSpec.describe Slack::RealTime::Client do
         it 'sets groups' do
           expect(client.groups.count).to eq 1
         end
+        it 'includes team name in to_s' do
+          expect(client.to_s).to eq "id=#{client.team.id}, name=#{client.team.name}, domain=#{client.team.domain}"
+        end
       end
       it 'uses web client to fetch url' do
         expect(client.web_client).to be_a Slack::Web::Client
@@ -148,6 +151,20 @@ RSpec.describe Slack::RealTime::Client do
           expect(socket).to receive(:restart_async)
           client.run_ping!
         end
+        [EOFError, Errno::ECONNRESET, Errno::EPIPE, Faraday::ClientError].each do |err|
+          context "raising #{err}" do
+            it 'does not terminate the ping worker' do
+              allow(socket).to receive(:time_since_last_message) { raise err }
+              expect(socket).to_not receive(:send_data)
+              client.run_ping!
+            end
+          end
+        end
+      end
+    end
+    describe 'to_s' do
+      it 'defaults to class instance' do
+        expect(client.to_s).to match(/^#<Slack::RealTime::Client:0x\h+>$/)
       end
     end
   end
@@ -190,6 +207,9 @@ RSpec.describe Slack::RealTime::Client do
         it 'no groups' do
           expect(client.groups).to be_nil
         end
+        it 'includes team name in to_s' do
+          expect(client.to_s).to eq "id=#{client.team.id}, name=#{client.team.name}, domain=#{client.team.domain}"
+        end
       end
       it 'uses web client to fetch url' do
         expect(client.web_client).to be_a Slack::Web::Client
@@ -242,6 +262,11 @@ RSpec.describe Slack::RealTime::Client do
     it 'team' do
       expect(client.team).to be nil
     end
+    describe 'to_s' do
+      it 'defaults to class instance' do
+        expect(client.to_s).to match(/^#<Slack::RealTime::Client:0x\h+>$/)
+      end
+    end
   end
   context 'client with defaults' do
     let(:client) { Slack::RealTime::Client.new }

data/spec/slack/web/api/endpoints/admin_users_session_spec.rb

@@ -0,0 +1,12 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+require 'spec_helper'
+
+RSpec.describe Slack::Web::Api::Endpoints::AdminUsersSession do
+  let(:client) { Slack::Web::Client.new }
+  context 'admin.users.session_reset' do
+    it 'requires user_id' do
+      expect { client.admin_users_session_reset }.to raise_error ArgumentError, /Required arguments :user_id missing/
+    end
+  end
+end

data/spec/slack/web/api/endpoints/dnd_spec.rb

@@ -9,4 +9,9 @@ RSpec.describe Slack::Web::Api::Endpoints::Dnd do
       expect { client.dnd_setSnooze }.to raise_error ArgumentError, /Required arguments :num_minutes missing/
     end
   end
+  context 'dnd_teamInfo' do
+    it 'requires users' do
+      expect { client.dnd_teamInfo }.to raise_error ArgumentError, /Required arguments :users missing/
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: slack-ruby-client
 version: !ruby/object:Gem::Version
-  version: 0.14.2
+  version: 0.14.3
 platform: ruby
 authors:
 - Daniel Doubrovkine
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-12 00:00:00.000000000 Z
+date: 2019-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -229,6 +229,7 @@ files:
 - Rakefile
 - UPGRADING.md
 - bin/commands.rb
+- bin/commands/admin_users_session.rb
 - bin/commands/api.rb
 - bin/commands/apps.rb
 - bin/commands/apps_permissions.rb
@@ -321,6 +322,7 @@ files:
 - lib/slack/real_time/stores/store.rb
 - lib/slack/version.rb
 - lib/slack/web/api/endpoints.rb
+- lib/slack/web/api/endpoints/admin_users_session.rb
 - lib/slack/web/api/endpoints/api.rb
 - lib/slack/web/api/endpoints/apps.rb
 - lib/slack/web/api/endpoints/apps_permissions.rb
@@ -434,6 +436,7 @@ files:
 - spec/slack/real_time/store_spec.rb
 - spec/slack/slack_spec.rb
 - spec/slack/version_spec.rb
+- spec/slack/web/api/endpoints/admin_users_session_spec.rb
 - spec/slack/web/api/endpoints/api_spec.rb
 - spec/slack/web/api/endpoints/apps_permissions_resources_spec.rb
 - spec/slack/web/api/endpoints/apps_permissions_scopes_spec.rb
@@ -505,8 +508,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Slack Web and RealTime API client.
@@ -546,6 +548,7 @@ test_files:
 - spec/slack/real_time/store_spec.rb
 - spec/slack/slack_spec.rb
 - spec/slack/version_spec.rb
+- spec/slack/web/api/endpoints/admin_users_session_spec.rb
 - spec/slack/web/api/endpoints/api_spec.rb
 - spec/slack/web/api/endpoints/apps_permissions_resources_spec.rb
 - spec/slack/web/api/endpoints/apps_permissions_scopes_spec.rb