slack-ruby-client 0.16.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46bfdecfe74d4f64a551519516ce706fbd50d7e8f512df2f10cf991f4c3d153a
-  data.tar.gz: 8f8330671c68f4937026b7bf211eb623a5a4f03ac704fb2465c5ad70833ce610
+  metadata.gz: 568ad92dd27f6edd04fc00905af2a928c9f03f2d08105637b9ffc9f01319eaa3
+  data.tar.gz: 579f9004c9b1b9e3608bb2b59e55f0d09f0dbcba6761ad8035e367d4b9f06f4f
 SHA512:
-  metadata.gz: b4eca0d30990e29c93ec5e2063cdfb7c9cbc9e0f4c23fe566b64af1c23dd2bc3dc2690937b43f9fb771035425fde4d023c29180592b01513a2d8a3ac4731511b
-  data.tar.gz: ca8c4a73812d77fe3b8bef823b2b7b1fa890c8efdab14a0bfa9094b5c171632f0ce33fb79493fc8444a21605397b63a38f4e890b1736afd74cfd14117a4dddcb
+  metadata.gz: ab4943fb7a0bf3e1a75141943ee97324dfded3c6e5d691fc1ffa939c43c82f105f4763fed7496f45a1bf1b2b119ffeefa272df484d0e46bcb6f000cbd0906a78
+  data.tar.gz: '0857c64cf4544b3c0b744662ba38f94daad70b38069334a7b59beb4cf0999a47c9ec19e225a899f01e9cfd6c2336823e26b97ba0fce1ebbd498585952fec305d'

data/CHANGELOG.md

@@ -1,9 +1,17 @@
+### 0.17.0 (2021/03/07)
+
+* [#370](https://github.com/slack-ruby/slack-ruby-client/pull/370): Removed deprecated `im_`, `mpim_`, `channels_`, and `groups_` methods - [@dblock](https://github.com/dblock).
+* [#368](https://github.com/slack-ruby/slack-ruby-client/pull/368): Removed `admin_conversations_whitelist` and `admin_conversations_disconnectShared` - [@dblock](https://github.com/dblock).
+* [#359](https://github.com/slack-ruby/slack-ruby-client/pull/359): Handle non-JSON 500 errors - [@agrobbin](https://github.com/agrobbin).
+* [#360](https://github.com/slack-ruby/slack-ruby-client/pull/360): Remove faye-websocket from the concurrency detection error message - [@dblock](https://github.com/dblock).
+* [#369](https://github.com/slack-ruby/slack-ruby-client/pull/369): Support rack requests in `Slack::Events::Request` - [@wedgex](https://github.com/wedgex).
+
 ### 0.16.0 (2021/01/24)
 
-* [#350](https://github.com/slack-ruby/slack-ruby-client/pull/350): Handle server errors such as timouts & non-json responses (see [Upgrading to 0.16.0](UPGRADING.md#upgrading-to--0160)) - [@ojab](https://github.com/ojab).
+* [#350](https://github.com/slack-ruby/slack-ruby-client/pull/350): Handle server errors such as timeouts & non-JSON responses - [@ojab](https://github.com/ojab).
 * [#354](https://github.com/slack-ruby/slack-ruby-client/pull/354): Rewind body after checking request signature - [@sunny](https://github.com/sunny).
-* [#355](https://github.com/slack-ruby/slack-ruby-client/pull/355), [#357](https://github.com/slack-ruby/slack-ruby-client/pull/357): Removed celluloid and faye-websocket support - [@wasabigeek](https://github.com/wasabigeek).
-* [#356](https://github.com/slack-ruby/slack-ruby-client/pull/356): Added `admin_apps_clearResolution`, `admin_conversations_getCustomRetention`, `admin_conversations_removeCustomRetention`, `admin_conversations_setCustomRetention` and `admin_users_session_list` endpoints - [@dblock](https://github.com/dblock).
+* [#355](https://github.com/slack-ruby/slack-ruby-client/pull/355), [#357](https://github.com/slack-ruby/slack-ruby-client/pull/357): Removed `celluloid-io` and `faye-websocket` support - [@wasabigeek](https://github.com/wasabigeek).
+* [#356](https://github.com/slack-ruby/slack-ruby-client/pull/356): Added `admin_apps_clearResolution`, `admin_conversations_getCustomRetention`, `admin_conversations_removeCustomRetention`, `admin_conversations_setCustomRetention`, `admin_users_session_list` and `auth_teams_list` endpoints - [@dblock](https://github.com/dblock).
 * [#348](https://github.com/slack-ruby/slack-ruby-client/pull/348): Added `admin_conversations_archive`, `admin_conversations_convertToPrivate`, `admin_conversations_create`, `admin_conversations_delete`, `admin_conversations_disconnectShared`, `admin_conversations_getConversationPrefs`, `admin_conversations_getTeams`, `admin_conversations_invite`, `admin_conversations_rename`, `admin_conversations_search`, `admin_conversations_setConversationPrefs`, `admin_conversations_unarchive`, `admin_conversations_ekm_listOriginalConnectedChannelInfo`, `admin_users_session_invalidate`, `apps_event_authorizations_list`, `conversations_mark`, `workflows_stepCompleted`, `workflows_stepFailed` and `workflows_updateStep` endpoints - [@wasabigeek](https://github.com/wasabigeek).
 
 ### 0.15.1 (2020/9/3)

data/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2015-2019 Daniel Doubrovkine, Artsy and Contributors
+Copyright (c) 2015-2021 Daniel Doubrovkine, Artsy and Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -70,7 +70,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.16.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client, 0.17.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -150,10 +150,10 @@ See a fully working example in [examples/hi_web](examples/hi_web/hi.rb).
 
 ##### List Channels
 
-List channels with [channels_list](https://api.slack.com/methods/channels.list).
+List channels with [conversations_list](https://api.slack.com/methods/conversations.list).
 
 ```ruby
-channels = client.channels_list.channels
+channels = client.conversations_list.channels
 
 general_channel = channels.detect { |c| c.name == 'general' }
 ```
@@ -175,14 +175,14 @@ client.files_upload(
 
 ##### Get Channel Info
 
-You can use a channel ID or name (prefixed with `#`) in all functions that take a `:channel` argument. Lookup by name is not supported by the Slack API and the `channels_id` method called invokes `channels_list` in order to locate the channel ID.
+You can use a channel ID or name (prefixed with `#`) in all functions that take a `:channel` argument. Lookup by name is not supported by the Slack API and the `channels_id` method called invokes `conversations_list` in order to locate the channel ID.
 
 ```ruby
-client.channels_info(channel: 'C04KB5X4D') # calls channels_info
+client.conversations_info(channel: 'C04KB5X4D') # calls conversations_info
 ```
 
 ```ruby
-client.channels_info(channel: '#general') # calls channels_list followed by channels_info
+client.conversations_info(channel: '#general') # calls conversations_list followed by conversations_info
 ```
 
 ##### Get User Info
@@ -243,7 +243,7 @@ adapter             | Optional HTTP adapter to use, defaults to `Faraday.default
 You can also pass request options, including `timeout` and `open_timeout` into individual calls.
 
 ```ruby
-client.channels_list(request: { timeout: 180 })
+client.conversations_list(request: { timeout: 180 })
 ```
 
 You can also control what proxy options are used by modifying the `http_proxy` environment variable per [Net::HTTP's documentation](https://docs.ruby-lang.org/en/2.0.0/Net/HTTP.html#class-Net::HTTP-label-Proxies).
@@ -646,6 +646,6 @@ See [CONTRIBUTING](CONTRIBUTING.md).
 
 ## Copyright and License
 
-Copyright (c) 2015-2019, [Daniel Doubrovkine](https://twitter.com/dblockdotorg), [Artsy](https://www.artsy.net) and [Contributors](CHANGELOG.md).
+Copyright (c) 2015-2021, [Daniel Doubrovkine](https://twitter.com/dblockdotorg), [Artsy](https://www.artsy.net) and [Contributors](CHANGELOG.md).
 
 This project is licensed under the [MIT License](LICENSE.md).

data/bin/commands.rb

@@ -10,7 +10,6 @@ require 'commands/admin_barriers'
 require 'commands/admin_conversations'
 require 'commands/admin_conversations_ekm'
 require 'commands/admin_conversations_restrictAccess'
-require 'commands/admin_conversations_whitelist'
 require 'commands/admin_emoji'
 require 'commands/admin_inviteRequests'
 require 'commands/admin_inviteRequests_approved'

data/bin/commands/admin_analytics.rb

@@ -6,8 +6,9 @@ command 'admin_analytics' do |g|
   g.desc 'Retrieve analytics data for a given date, presented as a compressed JSON file'
   g.long_desc %( Retrieve analytics data for a given date, presented as a compressed JSON file )
   g.command 'getFile' do |c|
-    c.flag 'type', desc: 'The type of analytics to retrieve. The options are currently limited to member.'
+    c.flag 'type', desc: 'The type of analytics to retrieve. The options are currently limited to member (for grid member analytics) and public_channel (for public channel analytics).'
     c.flag 'date', desc: 'Date to retrieve the analytics data for, expressed as YYYY-MM-DD in UTC.'
+    c.flag 'metadata_only', desc: 'Retrieve metadata for the type of analytics indicated. Can be used only with type set to public_channel analytics. See detail below. Omit the date parameter when using this argument.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.admin_analytics_getFile(options))
     end

data/bin/commands/admin_conversations.rb

@@ -43,16 +43,6 @@ command 'admin_conversations' do |g|
     end
   end
 
-  g.desc 'Disconnect a connected channel from one or more workspaces.'
-  g.long_desc %( Disconnect a connected channel from one or more workspaces. )
-  g.command 'disconnectShared' do |c|
-    c.flag 'channel_id', desc: 'The channel to be disconnected from some workspaces.'
-    c.flag 'leaving_team_ids', desc: 'The team to be removed from the channel. Currently only a single team id can be specified.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_conversations_disconnectShared(options))
-    end
-  end
-
   g.desc 'Get conversation preferences for a public or private channel.'
   g.long_desc %( Get conversation preferences for a public or private channel. )
   g.command 'getConversationPrefs' do |c|

data/bin/commands/admin_teams.rb

@@ -6,7 +6,7 @@ command 'admin_teams' do |g|
   g.desc 'Create an Enterprise team.'
   g.long_desc %( Create an Enterprise team. )
   g.command 'create' do |c|
-    c.flag 'team_domain', desc: 'Team domain (for example, slacksoftballteam).'
+    c.flag 'team_domain', desc: 'Team domain (for example, slacksoftballteam). Domains are limited to 21 characters.'
     c.flag 'team_name', desc: 'Team name (for example, Slack Softball Team).'
     c.flag 'team_description', desc: 'Description for the team.'
     c.flag 'team_discoverability', desc: "Who can join the team. A team's discoverability can be open, closed, invite_only, or unlisted."

data/bin/commands/channels.rb

@@ -3,26 +3,6 @@
 
 desc "Get info on your team's Slack channels, create or archive channels, invite users, set the topic and purpose, and mark a channel as read."
 command 'channels' do |g|
-  g.desc 'Archives a channel.'
-  g.long_desc %( Archives a channel. )
-  g.command 'archive' do |c|
-    c.flag 'channel', desc: 'Channel to archive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_archive(options))
-    end
-  end
-
-  g.desc 'Creates a channel.'
-  g.long_desc %( Creates a channel. )
-  g.command 'create' do |c|
-    c.flag 'name', desc: 'Name of channel to create.'
-    c.flag 'team_id', desc: 'encoded team id to create the channel in, required if org token is used.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_create(options))
-    end
-  end
-
   g.desc 'Delete a channel (undocumented)'
   g.long_desc %( Delete a channel )
   g.command 'delete' do |c|
@@ -32,19 +12,6 @@ command 'channels' do |g|
     end
   end
 
-  g.desc 'Fetches history of messages and events from a channel.'
-  g.long_desc %( Fetches history of messages and events from a channel. )
-  g.command 'history' do |c|
-    c.flag 'channel', desc: 'Channel to fetch history for.'
-    c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
-    c.flag 'latest', desc: 'End of time range of messages to include in results.'
-    c.flag 'oldest', desc: 'Start of time range of messages to include in results.'
-    c.flag 'unreads', desc: 'Include unread_count_display in the output?.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_history(options))
-    end
-  end
-
   g.desc 'This method returns the ID of a team channel.'
   g.long_desc %( This method returns the ID of a team channel. )
   g.command 'id' do |c|
@@ -53,128 +20,4 @@ command 'channels' do |g|
       puts JSON.dump($client.channels_id(options))
     end
   end
-
-  g.desc 'Gets information about a channel.'
-  g.long_desc %( Gets information about a channel. )
-  g.command 'info' do |c|
-    c.flag 'channel', desc: 'Channel to get info on.'
-    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this channel. Defaults to false.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_info(options))
-    end
-  end
-
-  g.desc 'Invites a user to a channel.'
-  g.long_desc %( Invites a user to a channel. )
-  g.command 'invite' do |c|
-    c.flag 'channel', desc: 'Channel to invite user to.'
-    c.flag 'user', desc: 'User to invite to channel.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_invite(options))
-    end
-  end
-
-  g.desc 'Joins a channel, creating it if needed.'
-  g.long_desc %( Joins a channel, creating it if needed. )
-  g.command 'join' do |c|
-    c.flag 'name', desc: 'Name of channel to join.'
-    c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_join(options))
-    end
-  end
-
-  g.desc 'Removes a user from a channel.'
-  g.long_desc %( Removes a user from a channel. )
-  g.command 'kick' do |c|
-    c.flag 'channel', desc: 'Channel to remove user from.'
-    c.flag 'user', desc: 'User to remove from channel.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_kick(options))
-    end
-  end
-
-  g.desc 'Leaves a channel.'
-  g.long_desc %( Leaves a channel. )
-  g.command 'leave' do |c|
-    c.flag 'channel', desc: 'Channel to leave.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_leave(options))
-    end
-  end
-
-  g.desc 'Lists all channels in a Slack team.'
-  g.long_desc %( Lists all channels in a Slack team. )
-  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: 'Exclude archived channels from the list.'
-    c.flag 'exclude_members', desc: 'Exclude the members collection from each channel.'
-    c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the users list hasn't been reached."
-    c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_list(options))
-    end
-  end
-
-  g.desc 'Sets the read cursor in a channel.'
-  g.long_desc %( Sets the read cursor in a channel. )
-  g.command 'mark' do |c|
-    c.flag 'channel', desc: 'Channel or conversation to set the read cursor for.'
-    c.flag 'ts', desc: 'Unique identifier of message you want marked as most recently seen in this conversation.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_mark(options))
-    end
-  end
-
-  g.desc 'Renames a channel.'
-  g.long_desc %( Renames a channel. )
-  g.command 'rename' do |c|
-    c.flag 'channel', desc: 'Channel to rename.'
-    c.flag 'name', desc: 'New name for channel.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_rename(options))
-    end
-  end
-
-  g.desc 'Retrieve a thread of messages posted to a channel'
-  g.long_desc %( Retrieve a thread of messages posted to a channel )
-  g.command 'replies' do |c|
-    c.flag 'channel', desc: 'Channel to fetch thread from.'
-    c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_replies(options))
-    end
-  end
-
-  g.desc 'Sets the purpose for a channel.'
-  g.long_desc %( Sets the purpose for a channel. )
-  g.command 'setPurpose' do |c|
-    c.flag 'channel', desc: 'Channel to set the purpose of.'
-    c.flag 'purpose', desc: 'The new purpose.'
-    c.flag 'name_tagging', desc: 'if it is true, treat this like a message and not an unescaped thing.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_setPurpose(options))
-    end
-  end
-
-  g.desc 'Sets the topic for a channel.'
-  g.long_desc %( Sets the topic for a channel. )
-  g.command 'setTopic' do |c|
-    c.flag 'channel', desc: 'Channel to set the topic of.'
-    c.flag 'topic', desc: 'The new topic.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_setTopic(options))
-    end
-  end
-
-  g.desc 'Unarchives a channel.'
-  g.long_desc %( Unarchives a channel. )
-  g.command 'unarchive' do |c|
-    c.flag 'channel', desc: 'Channel to unarchive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.channels_unarchive(options))
-    end
-  end
 end

data/bin/commands/chat.rb

@@ -80,20 +80,21 @@ command 'chat' do |g|
   g.long_desc %( Sends a message to a channel. )
   g.command 'postMessage' do |c|
     c.flag 'channel', desc: 'Channel, private group, or IM channel to send message to. Can be an encoded ID, or a name. See below for more details.'
-    c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
-    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below. This argument may not be used with newer bot tokens.'
+    c.flag 'as_user', desc: 'Pass true to post the message as the authed user, instead of as a bot. Defaults to false. See authorship below.'
     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. See authorship below. Use with bot tokens requires chat:write.customize.'
-    c.flag 'icon_url', desc: 'URL to an image to use as the icon for this message. See authorship below. Use with bot tokens requires chat:write.customize.'
+    c.flag 'draft_id', desc: 'The id of the draft associated with the message.'
+    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 'mrkdwn', desc: 'Disable Slack markup parsing by setting to false. Enabled by default.'
     c.flag 'parse', desc: 'Change how messages are treated. Defaults to none. See below.'
     c.flag 'reply_broadcast', desc: 'Used in conjunction with thread_ts and indicates whether reply should be made visible to everyone in the channel or conversation. Defaults to false.'
+    c.flag 'text', desc: 'How this field works and whether it is required depends on other fields you use in your API call. See below for more detail.'
     c.flag 'thread_ts', desc: "Provide another message's ts value to make this message a reply. Avoid using a reply's ts value; use its parent instead."
     c.flag 'unfurl_links', desc: 'Pass true to enable unfurling of primarily text-based content.'
     c.flag 'unfurl_media', desc: 'Pass false to disable unfurling of media content.'
-    c.flag 'username', desc: "Set your bot's user name. See authorship below. Use with bot tokens requires chat:write.customize."
+    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_postMessage(options))
     end
@@ -125,7 +126,8 @@ command 'chat' do |g|
     c.flag 'channel', desc: 'Channel ID of the message.'
     c.flag 'ts', desc: 'Timestamp of the message to add unfurl behavior to.'
     c.flag 'unfurls', desc: 'URL-encoded JSON map with keys set to URLs featured in the the message, pointing to their unfurl blocks or message attachments.'
-    c.flag 'user_auth_message', desc: 'Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
+    c.flag 'user_auth_blocks', desc: 'Provide a JSON based array of structured blocks presented as URL-encoded string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior.'
+    c.flag 'user_auth_message', desc: 'Provide a simply-formatted string to send as an ephemeral message to the user as invitation to authenticate further and enable full unfurling behavior. Provides two buttons, Not now or Never ask me again.'
     c.flag 'user_auth_required', desc: 'Set to true or 1 to indicate the user must install your Slack app to trigger unfurls for this domain.'
     c.flag 'user_auth_url', desc: 'Send users to this custom URL where they will complete authentication in your app to fully trigger unfurling. Value should be properly URL-encoded.'
     c.action do |_global_options, options, _args|

data/bin/commands/conversations.rb

@@ -101,7 +101,7 @@ command 'conversations' do |g|
     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.'
     c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached. Must be an integer no larger than 1000."
-    c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
+    c.flag 'team_id', desc: 'encoded team id to list channels in, required if token belongs to org-wide app.'
     c.flag 'types', desc: 'Mix and match channel types by providing a comma-separated list of any combination of public_channel, private_channel, mpim, im.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.conversations_list(options))
@@ -154,7 +154,7 @@ command 'conversations' do |g|
   g.long_desc %( Retrieve a thread of messages posted to a conversation )
   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. ts must be the timestamp of an existing message with 0 or more replies. If there are no replies then just the single message referenced by ts will return - it is just an ordinary, unthreaded message."
+    c.flag 'ts', desc: "Unique identifier of either a thread's parent message or a message in the thread. ts must be the timestamp of an existing message with 0 or more replies. If there are no replies then just the single message referenced by ts will return - it is just an ordinary, unthreaded message."
     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 'inclusive', desc: 'Include messages with latest or oldest timestamp in results only when either timestamp is specified.'
     c.flag 'latest', desc: 'End of time range of messages to include in results.'

data/bin/commands/dnd.rb

@@ -22,6 +22,7 @@ command 'dnd' do |g|
   g.desc "Retrieves a user's current Do Not Disturb status."
   g.long_desc %( Retrieves a user's current Do Not Disturb status. )
   g.command 'info' do |c|
+    c.flag 'team_id', desc: 'Encoded team id where passed in user param belongs, required if org token is used. If no user param is passed, then a team which has access to the app should be passed.'
     c.flag 'user', desc: 'User to fetch status for (defaults to current user).'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.dnd_info(options))
@@ -41,6 +42,7 @@ command 'dnd' do |g|
   g.long_desc %( Retrieves the Do Not Disturb status for up to 50 users on a team. )
   g.command 'teamInfo' do |c|
     c.flag 'users', desc: 'Comma-separated list of users to fetch Do Not Disturb status for.'
+    c.flag 'team_id', desc: 'Encoded team id where passed in users belong, required if org token is used.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.dnd_teamInfo(options))
     end

data/bin/commands/groups.rb

@@ -3,48 +3,6 @@
 
 desc "Get info on your team's private channels."
 command 'groups' do |g|
-  g.desc 'Archives a private channel.'
-  g.long_desc %( Archives a private channel. )
-  g.command 'archive' do |c|
-    c.flag 'channel', desc: 'Private channel to archive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_archive(options))
-    end
-  end
-
-  g.desc 'Creates a private channel.'
-  g.long_desc %( Creates a private channel. )
-  g.command 'create' do |c|
-    c.flag 'name', desc: 'Name of private channel to create.'
-    c.flag 'team_id', desc: 'encoded team id to create the channel in, required if org token is used.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_create(options))
-    end
-  end
-
-  g.desc 'Clones and archives a private channel.'
-  g.long_desc %( Clones and archives a private channel. )
-  g.command 'createChild' do |c|
-    c.flag 'channel', desc: 'Private channel to clone and archive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_createChild(options))
-    end
-  end
-
-  g.desc 'Fetches history of messages and events from a private channel.'
-  g.long_desc %( Fetches history of messages and events from a private channel. )
-  g.command 'history' do |c|
-    c.flag 'channel', desc: 'Private channel to fetch history for.'
-    c.flag 'inclusive', desc: 'Include messages with latest or oldest timestamp in results.'
-    c.flag 'latest', desc: 'End of time range of messages to include in results.'
-    c.flag 'oldest', desc: 'Start of time range of messages to include in results.'
-    c.flag 'unreads', desc: 'Include unread_count_display in the output?.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_history(options))
-    end
-  end
-
   g.desc 'This method returns the ID of a group.'
   g.long_desc %( This method returns the ID of a group. )
   g.command 'id' do |c|
@@ -53,125 +11,4 @@ command 'groups' do |g|
       puts JSON.dump($client.groups_id(options))
     end
   end
-
-  g.desc 'Gets information about a private channel.'
-  g.long_desc %( Gets information about a private channel. )
-  g.command 'info' do |c|
-    c.flag 'channel', desc: 'Private channel to get info on.'
-    c.flag 'include_locale', desc: 'Set this to true to receive the locale for this group. Defaults to false.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_info(options))
-    end
-  end
-
-  g.desc 'Invites a user to a private channel.'
-  g.long_desc %( Invites a user to a private channel. )
-  g.command 'invite' do |c|
-    c.flag 'channel', desc: 'Private channel to invite user to.'
-    c.flag 'user', desc: 'User to invite.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_invite(options))
-    end
-  end
-
-  g.desc 'Removes a user from a private channel.'
-  g.long_desc %( Removes a user from a private channel. )
-  g.command 'kick' do |c|
-    c.flag 'channel', desc: 'Private channel to remove user from.'
-    c.flag 'user', desc: 'User to remove from private channel.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_kick(options))
-    end
-  end
-
-  g.desc 'Leaves a private channel.'
-  g.long_desc %( Leaves a private channel. )
-  g.command 'leave' do |c|
-    c.flag 'channel', desc: 'Private channel to leave.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_leave(options))
-    end
-  end
-
-  g.desc 'Lists private channels that the calling user has access to.'
-  g.long_desc %( Lists private channels that the calling user has access to. )
-  g.command 'list' do |c|
-    c.flag 'cursor', desc: "Parameter for pagination. Set cursor equal to the next_cursor attribute returned by the previous request's response_metadata. This parameter is optional, but pagination is mandatory: the default value simply fetches the first 'page' of the collection. See pagination for more details."
-    c.flag 'exclude_archived', desc: "Don't return archived private channels."
-    c.flag 'exclude_members', desc: 'Exclude the members from each group.'
-    c.flag 'limit', desc: "The maximum number of items to return. Fewer than the requested number of items may be returned, even if the end of the list hasn't been reached."
-    c.flag 'team_id', desc: 'encoded team id to list channels in, required if org token is used.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_list(options))
-    end
-  end
-
-  g.desc 'Sets the read cursor in a private channel.'
-  g.long_desc %( Sets the read cursor in a private channel. )
-  g.command 'mark' do |c|
-    c.flag 'channel', desc: 'Channel or conversation to set the read cursor for.'
-    c.flag 'ts', desc: 'Unique identifier of message you want marked as most recently seen in this conversation.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_mark(options))
-    end
-  end
-
-  g.desc 'Opens a private channel.'
-  g.long_desc %( Opens a private channel. )
-  g.command 'open' do |c|
-    c.flag 'channel', desc: 'Private channel to open.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_open(options))
-    end
-  end
-
-  g.desc 'Renames a private channel.'
-  g.long_desc %( Renames a private channel. )
-  g.command 'rename' do |c|
-    c.flag 'channel', desc: 'Private channel to rename.'
-    c.flag 'name', desc: 'New name for private channel.'
-    c.flag 'validate', desc: 'Whether to return errors on invalid channel name instead of modifying it to meet the specified criteria.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_rename(options))
-    end
-  end
-
-  g.desc 'Retrieve a thread of messages posted to a private channel'
-  g.long_desc %( Retrieve a thread of messages posted to a private channel )
-  g.command 'replies' do |c|
-    c.flag 'channel', desc: 'Private channel to fetch thread from.'
-    c.flag 'thread_ts', desc: "Unique identifier of a thread's parent message."
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_replies(options))
-    end
-  end
-
-  g.desc 'Sets the purpose for a private channel.'
-  g.long_desc %( Sets the purpose for a private channel. )
-  g.command 'setPurpose' do |c|
-    c.flag 'channel', desc: 'Private channel to set the purpose of.'
-    c.flag 'purpose', desc: 'The new purpose.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_setPurpose(options))
-    end
-  end
-
-  g.desc 'Sets the topic for a private channel.'
-  g.long_desc %( Sets the topic for a private channel. )
-  g.command 'setTopic' do |c|
-    c.flag 'channel', desc: 'Private channel to set the topic of.'
-    c.flag 'topic', desc: 'The new topic.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_setTopic(options))
-    end
-  end
-
-  g.desc 'Unarchives a private channel.'
-  g.long_desc %( Unarchives a private channel. )
-  g.command 'unarchive' do |c|
-    c.flag 'channel', desc: 'Private channel to unarchive.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.groups_unarchive(options))
-    end
-  end
 end