slack-ruby-client 1.0.0 → 2.1.0

data/README.md

@@ -2,7 +2,8 @@ Slack Ruby Client
 =================
 
 [![Gem Version](https://badge.fury.io/rb/slack-ruby-client.svg)](http://badge.fury.io/rb/slack-ruby-client)
-[![Build Status](https://app.travis-ci.com/slack-ruby/slack-ruby-client.svg?branch=master)](https://app.travis-ci.com/slack-ruby/slack-ruby-client)
+[![Integration Tests](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/integration_test.yml/badge.svg?branch=master)](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/integration_test.yml)
+[![Tests](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/slack-ruby/slack-ruby-client/actions/workflows/test.yml)
 [![Code Climate](https://codeclimate.com/github/slack-ruby/slack-ruby-client/badges/gpa.svg)](https://codeclimate.com/github/slack-ruby/slack-ruby-client)
 
 A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messaging](https://api.slack.com/rtm) and [Events](https://api.slack.com/events-api) APIs. Comes with a handy command-line client, too. If you are not familiar with these concepts, you might want to watch [this video](http://code.dblock.org/2016/03/11/your-first-slack-bot-service-video.html).
@@ -17,7 +18,7 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
 - [Usage](#usage)
   - [Create a New Bot Integration](#create-a-new-bot-integration)
   - [OAuth Code Grant](#oauth-code-grant)
-  - [Using the Legacy API Token](#using-the-legacy-api-token)
+  - [Using an API Token](#using-an-api-token)
   - [Global Settings](#global-settings)
   - [Web Client](#web-client)
     - [Web Client Examples](#web-client-examples)
@@ -37,14 +38,13 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
       - [Rate Limiting](#rate-limiting)
       - [Other Errors](#other-errors)
   - [RealTime Client](#realtime-client)
-    - [Slack::RealTime::Stores::Store](#slackrealtimestoresstore)
-    - [Slack::RealTime::Stores::Starter](#slackrealtimestoresstarter)
-  - [Configuring Slack::RealTime::Client](#configuring-slackrealtimeclient)
-    - [Caveats](#caveats)
-      - [websocket_ping](#websocket_ping)
-  - [Connection Methods](#connection-methods)
+    - [Configuring Slack::RealTime::Client](#configuring-slackrealtimeclient)
+      - [Caveats](#caveats)
+        - [websocket_ping](#websocket_ping)
+    - [RealTime Store](#realtime-store)
+      - [Slack::RealTime::Stores::Starter](#slackrealtimestoresstarter)
+      - [Slack::RealTime::Stores::Store](#slackrealtimestoresstore)
   - [Combining RealTime and Web Clients](#combining-realtime-and-web-clients)
-  - [Large Team Considerations](#large-team-considerations)
     - [Concurrency](#concurrency)
       - [Async](#async)
   - [Events API](#events-api)
@@ -54,10 +54,11 @@ A Ruby client for the Slack [Web](https://api.slack.com/web), [RealTime Messagin
   - [Command-Line Client](#command-line-client)
     - [Authenticate with Slack](#authenticate-with-slack)
     - [Send a Message](#send-a-message)
-    - [Get Channel Id](#get-channel-id)
     - [Get Channel Info](#get-channel-info-1)
     - [List Users](#list-users)
+- [Enterprise Support](#enterprise-support)
 - [History](#history)
+- [Security](#security)
 - [Contributing](#contributing)
 - [Copyright and License](#copyright-and-license)
 
@@ -70,7 +71,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, v1.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client, v2.1.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -100,9 +101,9 @@ To integrate your bot with Slack, you must first create a new [Slack App](https:
 
 Once created, go to the app's Basic Info tab and grab the Client ID and Client Secret.  You'll need these in order complete an [OAuth code grant flow](https://api.slack.com/docs/oauth#flow) as described at [slack-ruby-bot-server](https://github.com/slack-ruby/slack-ruby-bot-server).
 
-### Using the Legacy API Token
+### Using an API Token
 
-Although OAuth is recommended, you can still [generate a legacy API token](https://api.slack.com/custom-integrations/legacy-tokens) for your app and use it for some interactions.
+Although OAuth is recommended, you can also [generate an API token](https://api.slack.com/tutorials/tracks/getting-a-token) for your app and use it for some interactions.
 
 ```ruby
 Slack.configure do |config|
@@ -175,7 +176,7 @@ 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 `conversations_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. This invocation can have a cost if you have many Slack channels. In this scenario, we encourage you to use channel id.
 
 ```ruby
 client.conversations_info(channel: 'C04KB5X4D') # calls conversations_info
@@ -373,32 +374,7 @@ You can send a ping with `ping`.
 client.ping
 ```
 
-By default, the RealTime client exposes and maintains a local store with the properties of [rtm.start](https://api.slack.com/methods/rtm.start) upon a successful connection.
-
-property | description
----------|-------------------------------------------------------------------------------------------------
-url      | A WebSocket Message Server URL.
-self     | The authenticated bot user.
-team     | Details on the authenticated user's team.
-users    | A hash of user objects by user ID.
-channels | A hash of channel objects, one for every channel visible to the authenticated user.
-groups   | A hash of group objects, one for every group the authenticated user is in.
-ims      | A hash of IM objects, one for every direct message channel visible to the authenticated user.
-bots     | Details of the integrations set up on this team.
-
-It also tracks changes, such as users being renamed, added or deleted, therefore `client.users` is always up-to-date.
-
-Tracking with a local store can be disabled with `Slack::RealTime::Client.new(store_class: nil)`. Other stores are also available.
-
-#### Slack::RealTime::Stores::Store
-
-The default store that tracks all changes. By default the client will be connected using `rtm_start`.
-
-#### Slack::RealTime::Stores::Starter
-
-A smaller store that only stores and tracks information about the bot user, but not channels, users, groups, ims or bots. By default the client will be connected using `rtm_connect`.
-
-### Configuring Slack::RealTime::Client
+#### Configuring Slack::RealTime::Client
 
 You can configure the RealTime client either globally or via the initializer.
 
@@ -419,20 +395,21 @@ setting         | description
 token           | Slack API token.
 websocket_ping  | How long the socket can be idle before sending a ping message to confirm it's still connected, default is 30.
 websocket_proxy | Connect via proxy, include `:origin` and `:headers`.
-store_class     | Local store class name, default is an in-memory `Slack::RealTime::Stores::Store`.
-start_method    | Optional start method, either `:rtm_start` or `:rtm_connect`.
-start_options   | Options to pass into `rtm.start` or `rtm.connect`, default is `{ request: { timeout: 180 } }`.
+start_options   | Options to pass to `rtm.connect`, default is `{ request: { timeout: 180 } }`.
+store_class     | Local store class, default is an in-memory `Slack::RealTime::Stores::Starter`.
+store_options   | Options to initialize the store, default is `{}`.
 logger          | Optional `Logger` instance that logs RealTime requests and socket data.
 
-Note that the RealTime client uses a Web client to obtain the WebSocket URL via [rtm.start](https://api.slack.com/methods/rtm.start) or [rtm.connect](https://api.slack.com/methods/rtm.connect). While `token` and `logger` options are passed down from the RealTime client, you may also configure Web client options via `Slack::Web::Client.configure` as described above.
+Note that the RealTime client uses a Web client to obtain the WebSocket URL via [rtm.connect](https://api.slack.com/methods/rtm.connect). While `token` and `logger` options are passed down from the RealTime client, you may also configure Web client options via `Slack::Web::Client.configure` as described above.
 
-See a fully working example in [examples/hi_real_time](examples/hi_real_time/hi.rb).
+See a fully working example in [examples/hi_real_time_and_web](examples/hi_real_time_and_web/hi.rb).
+
+![](examples/hi_real_time_and_web/hi.gif)
 
-![](examples/hi_real_time/hi.gif)
+##### Caveats
 
-#### Caveats
+###### `websocket_ping`
 
-##### `websocket_ping`
 This setting determines how long the socket can be idle before sending a ping message to confirm it's still connected.
 
 It's important to note that if a ping message was sent and no response was received within the amount of time specified in `websocket_ping` the client will attempt to reestablish it's connection to the message server.
@@ -441,15 +418,54 @@ Note that the ping may take between `websocket_ping` and `websocket_ping * 3/2`
 
 To disable this feature set `websocket_ping` to 0.
 
-### Connection Methods
+#### RealTime Store
 
-The RealTime client uses either [rtm.start](https://api.slack.com/methods/rtm.start) or [rtm.connect](https://api.slack.com/methods/rtm.connect) to open a connection. The former retrieves a lot of team information while the latter only serves connection purposes and is preferred. You should let the library choose the right method for you based on the `store_class` used and override this behavior with `start_method` when necessary.
+The RealTime client exposes and maintains a local store upon successful connection.
+Event hooks keep the store's cached data up-to-date.
 
+Tracking with a local store can be disabled with `Slack::RealTime::Client.new(store_class: nil)`.
+
+##### `Slack::RealTime::Stores::Starter`
+
+A small store that only caches and tracks data returned in the [rtm.connect](https://api.slack.com/methods/rtm.connect#examples) response.
+This store provides `self` and `team` for accessing the limited data about the authenticated user and its workspace, but does not cache other users or bots, channels, or direct messages.
+
+##### `Slack::RealTime::Stores::Store`
+
+A more complete store that tracks most changes visible to the authenticated user.
+
+You can see all of the cache types in the table below (each is a hash indexed by its objects' `id`).
+
+Cache              | Description
+-------------------|-------------------------------------------------------------------------------------------------
+`teams`            | Workspaces (teams). Will likely contain only one `team`.
+`users`            | All [user](https://api.slack.com/types/user) objects, including `self`.
+`bots`             | All [bot users](https://api.slack.com/bot-users) (from Slack Apps and legacy custom integrations).
+`public_channels`  | Public [conversation](https://api.slack.com/types/conversation) objects.
+`private_channels` | Private [conversation](https://api.slack.com/types/conversation) and [group](https://api.slack.com/types/group) objects with the authenticated user as a member.
+`ims`              | Visible [im](https://api.slack.com/types/im) objects, direct message channels with the authenticated user.
+`mpims`            | Visible [mpim](https://api.slack.com/types/mpim) objects, multiparty direct message channels that include the authenticated user.
+
+By default, none of these caches are initialized with data beyond what is returned from [rtm.connect](https://api.slack.com/methods/rtm.connect#examples), same as [Slack::RealTime::Stores::Starter](#slackrealtimestoresstarter).
+When configured, this store initializes its caches by making additional calls to Web API methods upon successful connection to the RTM API (i.e. "hello" message).
+
+Configure by specifying which caches to fetch:
 ```ruby
 Slack::RealTime::Client.configure do |config|
-  config.start_method = :rtm_start
+  config.store_class = Slack::RealTime::Stores::Store
+  config.store_options = { caches: %i[teams users public_channels private_channels ims] }
 end
 ```
+or with the `:all` option:
+```ruby
+Slack::RealTime::Client.configure do |config|
+  config.store_class = Slack::RealTime::Stores::Store
+  config.store_options = { caches: :all }
+end
+```
+
+Note: For `teams`, this makes a single call to `team.info`, while for `users` and all conversation-like types, this makes paginated calls to `users.list` and `conversations.list` respectively.
+Only `bots` requires a separate call for every bot user, so may be slow if your workplace has a lot of bot users.
 
 ### Combining RealTime and Web Clients
 
@@ -474,23 +490,6 @@ See a fully working example in [examples/hi_real_time_and_web](examples/hi_real_
 
 ![](examples/hi_real_time_and_web/hi.gif)
 
-### Large Team Considerations
-
-The `rtm.start` call downloads a large amount of data. For large teams, consider reducing the amount of unnecessary data downloaded with `start_options`. You may also want to increase the default timeout of 180 seconds.
-
-```ruby
-Slack::RealTime::Client.configure do |config|
-  # Return timestamp only for latest message object of each channel.
-  config.start_options[:simple_latest] = true
-  # Skip unread counts for each channel.
-  config.start_options[:no_unreads] = true
-  # Increase request timeout to 6 minutes.
-  config.start_options[:request][:timeout] = 360
-end
-```
-
-See [#134](https://github.com/slack-ruby/slack-ruby-client/issues/134) for a discussion on this topic.
-
 #### Concurrency
 
 `Slack::RealTime::Client` needs help from a concurrency library and supports [Async](https://github.com/socketry/async).
@@ -604,17 +603,10 @@ $ slack chat postMessage --text="hello world" --channel="#general"
 {"ok":true,"channel":"...","ts":"...","message":{"text":"hello world","username":"bot","type":"message","subtype":"bot_message","ts":"..."}}
 ```
 
-#### Get Channel Id
-
-```
-$ slack channels id --channel=#general
-{"ok":true,"channel":{"id":"C04KB5X4D"}}
-```
-
 #### Get Channel Info
 
 ```
-$ slack channels info --channel=#general
+$ slack conversations info --channel=#general
 {"ok":true,"channel":{"id":"C04KB5X4D","name":"general", ...}}
 ```
 
@@ -636,10 +628,20 @@ $ slack users list | jq '.members | map({(.id): .name})'
 
 See `slack help` for a complete command-line reference.
 
+## Enterprise Support
+
+Available as part of the Tidelift Subscription.
+
+The maintainers of slack-ruby-client are working with Tidelift to deliver commercial support and maintenance. Save time, reduce risk, and improve code health, while paying the maintainers of slack-ruby-client. Click [here](https://tidelift.com/subscription/request-a-demo?utm_source=rubygems-slack-ruby-client&utm_medium=referral&utm_campaign=enterprise) for more details.
+
 ## History
 
 This gem is based on [slack-ruby-gem](https://github.com/aki017/slack-ruby-gem), but it more clearly separates the Web and RTM APIs, is more thoroughly tested and is in active development.
 
+## Security
+
+See [SECURITY](SECURITY.md).
+
 ## Contributing
 
 See [CONTRIBUTING](CONTRIBUTING.md).

data/RELEASING.md

@@ -11,7 +11,7 @@ bundle install
 rake
 ```
 
-Check that the last build succeeded in [Travis CI](https://app.travis-ci.com/github/slack-ruby/slack-ruby-client) for all supported platforms.
+Check that the last build succeeded in [GitHub Actions](https://github.com/slack-ruby/slack-ruby-client/actions) for all supported platforms.
 
 Change "Next" in [CHANGELOG.md](CHANGELOG.md) to the current date.
 
@@ -21,7 +21,7 @@ Change "Next" in [CHANGELOG.md](CHANGELOG.md) to the current date.
 
 Remove the line with "Your contribution here.", since there will be no more contributions to this release.
 
-In the "Stable Release" section of the README, change `**next**` to `**stable**` so users know that they are reading the documentation for a released version.
+In the "Stable Release" section of the README, change `**next**` to `**stable**` and add the version number so users know that they are reading the documentation for a released version.
 
 ```
 ## Stable Release

data/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Supported Versions
+
+Version 2.0 or newer is currently supported.
+
+## Reporting a Vulnerability
+
+Tidelift acts as the security contact for this open-source project. To make a report, please email the security team at [security@tidelift.com](mailto:security@tidelift.com). Please do not create a public GitHub issue. See [tidelift.com/security](https://tidelift.com/security) for details and more options.

data/UPGRADING.md

@@ -1,6 +1,34 @@
 Upgrading Slack-Ruby-Client
 ===========================
 
+### Upgrading to >= 2.0.0
+
+[#416](https://github.com/slack-ruby/slack-ruby-client/pull/416) Removes default values for Faraday's SSL settings `ca_file` and `ca_path`.
+
+If you previously relied on `OpenSSL::X509::DEFAULT_CERT_FILE` or `OpenSSL::X509::DEFAULT_CERT_DIR` to set these values you must now do so explicitly. E.g.:
+
+```ruby
+Slack::Web::Client.configure do |config|
+  config.ca_file = OpenSSL::X509::DEFAULT_CERT_FILE
+  config.ca_path = OpenSSL::X509::DEFAULT_CERT_DIR
+end
+```
+
+or
+
+```ruby
+client = Slack::Web::Client.new(ca_file: OpenSSL::X509::DEFAULT_CERT_FILE, ca_path: OpenSSL::X509::DEFAULT_CERT_DIR)
+```
+
+#### RealTime Stores
+
+Slack has deprecated the `rtm.start` method and [replaced its response](https://api.slack.com/changelog/2021-10-rtm-start-to-stop) with that of `rtm.connect`, so it has been removed from the library along with the `start_method` configuration ([#419](https://github.com/slack-ruby/slack-ruby-client/pull/419)) and `Slack::RealTime::Stores::Starter` is now the default store.
+If your app still relies on the old `rtm.start` behavior, you can achieve a similar result with `Slack::RealTime::Stores::Store`, which initializes itself using Web API methods (see [README](README.md#slackrealtimestoresstore)).
+
+The names of the Store caches `channels` and `groups` have been changed to `public_channels` and `private_channels` to reflect their true meaning.
+This is consistent with the [Slack Web API](https://api.slack.com/methods/conversations.list#arg_types), although [event types for private channels](https://api.slack.com/events?query=group) still use the term `group`.
+In both cases, private channels consist of both [conversation types](https://api.slack.com/types/conversation) (`id: 'C...'', is_channel: true, is_group: false, is_private: true`) and [group types](https://api.slack.com/types/group) (`id: 'G...', is_channel: false, is_group: true, is_private: true`) depending whether the object was created before or after March 2021.
+
 ### Upgrading to >= 1.0.0
 
 #### Deprecated Methods

data/bin/commands/admin_analytics.rb

@@ -1,16 +1,22 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'AdminAnalytics methods.'
-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 (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))
+module Slack
+  module Cli
+    class App
+      desc 'AdminAnalytics methods.'
+      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 (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. Required unless metadata_only is set to true.'
+          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
+        end
+      end
     end
   end
 end

data/bin/commands/admin_apps.rb

@@ -1,51 +1,57 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'AdminApps methods.'
-command 'admin_apps' do |g|
-  g.desc 'Approve an app for installation on a workspace.'
-  g.long_desc %( Approve an app for installation on a workspace. )
-  g.command 'approve' do |c|
-    c.flag 'app_id', desc: 'The id of the app to approve.'
-    c.flag 'enterprise_id', desc: 'The ID of the enterprise to approve the app on.'
-    c.flag 'request_id', desc: 'The id of the request to approve.'
-    c.flag 'team_id', desc: 'The ID of the workspace to approve the app on.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_apps_approve(options))
-    end
-  end
+module Slack
+  module Cli
+    class App
+      desc 'AdminApps methods.'
+      command 'admin_apps' do |g|
+        g.desc 'Approve an app for installation on a workspace.'
+        g.long_desc %( Approve an app for installation on a workspace. )
+        g.command 'approve' do |c|
+          c.flag 'app_id', desc: 'The id of the app to approve.'
+          c.flag 'enterprise_id', desc: 'The ID of the enterprise to approve the app on.'
+          c.flag 'request_id', desc: 'The id of the request to approve.'
+          c.flag 'team_id', desc: 'The ID of the workspace to approve the app on.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_approve(options))
+          end
+        end
 
-  g.desc 'Clear an app resolution'
-  g.long_desc %( Clear an app resolution )
-  g.command 'clearResolution' do |c|
-    c.flag 'app_id', desc: 'The id of the app whose resolution you want to clear/undo.'
-    c.flag 'enterprise_id', desc: 'The enterprise to clear the app resolution from.'
-    c.flag 'team_id', desc: 'The workspace to clear the app resolution from.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_apps_clearResolution(options))
-    end
-  end
+        g.desc 'Clear an app resolution'
+        g.long_desc %( Clear an app resolution )
+        g.command 'clearResolution' do |c|
+          c.flag 'app_id', desc: 'The id of the app whose resolution you want to clear/undo.'
+          c.flag 'enterprise_id', desc: 'The enterprise to clear the app resolution from.'
+          c.flag 'team_id', desc: 'The workspace to clear the app resolution from.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_clearResolution(options))
+          end
+        end
 
-  g.desc 'Restrict an app for installation on a workspace.'
-  g.long_desc %( Restrict an app for installation on a workspace. )
-  g.command 'restrict' do |c|
-    c.flag 'app_id', desc: 'The id of the app to restrict.'
-    c.flag 'enterprise_id', desc: 'The ID of the enterprise to approve the app on.'
-    c.flag 'request_id', desc: 'The id of the request to restrict.'
-    c.flag 'team_id', desc: 'The ID of the workspace to approve the app on.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_apps_restrict(options))
-    end
-  end
+        g.desc 'Restrict an app for installation on a workspace.'
+        g.long_desc %( Restrict an app for installation on a workspace. )
+        g.command 'restrict' do |c|
+          c.flag 'app_id', desc: 'The id of the app to restrict.'
+          c.flag 'enterprise_id', desc: 'The ID of the enterprise to approve the app on.'
+          c.flag 'request_id', desc: 'The id of the request to restrict.'
+          c.flag 'team_id', desc: 'The ID of the workspace to approve the app on.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_restrict(options))
+          end
+        end
 
-  g.desc 'Uninstall an app from one or many workspaces, or an entire enterprise organization.'
-  g.long_desc %( Uninstall an app from one or many workspaces, or an entire enterprise organization. )
-  g.command 'uninstall' do |c|
-    c.flag 'app_id', desc: 'The ID of the app to uninstall.'
-    c.flag 'enterprise_id', desc: 'The enterprise to completely uninstall the application from (across all workspaces). With an org-level token, this or team_ids is required.'
-    c.flag 'team_ids', desc: 'IDs of the teams to uninstall from (max 100). With an org-level token, this or enterprise_id is required.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_apps_uninstall(options))
+        g.desc 'Uninstall an app from one or many workspaces, or an entire enterprise organization.'
+        g.long_desc %( Uninstall an app from one or many workspaces, or an entire enterprise organization. )
+        g.command 'uninstall' do |c|
+          c.flag 'app_id', desc: 'The ID of the app to uninstall.'
+          c.flag 'enterprise_id', desc: 'The enterprise to completely uninstall the application from (across all workspaces). With an org-level token, this or team_ids is required.'
+          c.flag 'team_ids', desc: 'IDs of the teams to uninstall from (max 100). With an org-level token, this or enterprise_id is required.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_uninstall(options))
+          end
+        end
+      end
     end
   end
 end

data/bin/commands/admin_apps_approved.rb

@@ -1,17 +1,23 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'AdminAppsApproved methods.'
-command 'admin_apps_approved' do |g|
-  g.desc 'List approved apps for an org or workspace.'
-  g.long_desc %( List approved apps for an org or workspace. )
-  g.command 'list' do |c|
-    c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
-    c.flag 'enterprise_id', desc: '.'
-    c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
-    c.flag 'team_id', desc: '.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_apps_approved_list(options))
+module Slack
+  module Cli
+    class App
+      desc 'AdminAppsApproved methods.'
+      command 'admin_apps_approved' do |g|
+        g.desc 'List approved apps for an org or workspace.'
+        g.long_desc %( List approved apps for an org or workspace. )
+        g.command 'list' do |c|
+          c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'enterprise_id', desc: '.'
+          c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
+          c.flag 'team_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_approved_list(options))
+          end
+        end
+      end
     end
   end
 end

data/bin/commands/admin_apps_requests.rb

@@ -1,17 +1,34 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'AdminAppsRequests methods.'
-command 'admin_apps_requests' do |g|
-  g.desc 'List app requests for a team/workspace.'
-  g.long_desc %( List app requests for a team/workspace. )
-  g.command 'list' do |c|
-    c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
-    c.flag 'enterprise_id', desc: '.'
-    c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
-    c.flag 'team_id', desc: '.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_apps_requests_list(options))
+module Slack
+  module Cli
+    class App
+      desc 'AdminAppsRequests methods.'
+      command 'admin_apps_requests' do |g|
+        g.desc 'Cancel app request for team'
+        g.long_desc %( Cancel app request for team )
+        g.command 'cancel' do |c|
+          c.flag 'request_id', desc: 'The id of the request to cancel.'
+          c.flag 'enterprise_id', desc: 'The ID of the enterprise where this request belongs.'
+          c.flag 'team_id', desc: 'The ID of the workspace where this request belongs.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_requests_cancel(options))
+          end
+        end
+
+        g.desc 'List app requests for a team/workspace.'
+        g.long_desc %( List app requests for a team/workspace. )
+        g.command 'list' do |c|
+          c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'enterprise_id', desc: '.'
+          c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
+          c.flag 'team_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_requests_list(options))
+          end
+        end
+      end
     end
   end
 end

data/bin/commands/admin_apps_restricted.rb

@@ -1,17 +1,23 @@
 # frozen_string_literal: true
 # This file was auto-generated by lib/tasks/web.rake
 
-desc 'AdminAppsRestricted methods.'
-command 'admin_apps_restricted' do |g|
-  g.desc 'List restricted apps for an org or workspace.'
-  g.long_desc %( List restricted apps for an org or workspace. )
-  g.command 'list' do |c|
-    c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
-    c.flag 'enterprise_id', desc: '.'
-    c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
-    c.flag 'team_id', desc: '.'
-    c.action do |_global_options, options, _args|
-      puts JSON.dump($client.admin_apps_restricted_list(options))
+module Slack
+  module Cli
+    class App
+      desc 'AdminAppsRestricted methods.'
+      command 'admin_apps_restricted' do |g|
+        g.desc 'List restricted apps for an org or workspace.'
+        g.long_desc %( List restricted apps for an org or workspace. )
+        g.command 'list' do |c|
+          c.flag 'cursor', desc: 'Set cursor to next_cursor returned by the previous call to list items in the next page.'
+          c.flag 'enterprise_id', desc: '.'
+          c.flag 'limit', desc: 'The maximum number of items to return. Must be between 1 - 1000 both inclusive.'
+          c.flag 'team_id', desc: '.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_apps_restricted_list(options))
+          end
+        end
+      end
     end
   end
 end

data/bin/commands/admin_audit_anomaly_allow.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+# This file was auto-generated by lib/tasks/web.rake
+
+module Slack
+  module Cli
+    class App
+      desc 'AdminAuditAnomalyAllow methods.'
+      command 'admin_audit_anomaly_allow' do |g|
+        g.desc 'API to allow enterprise grid admins to read the allow list of IP blocks and ASNs from the enterprise configuration.'
+        g.long_desc %( API to allow enterprise grid admins to read the allow list of IP blocks and ASNs from the enterprise configuration. )
+        g.command 'getItem' do |c|
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_audit_anomaly_allow_getItem(options))
+          end
+        end
+
+        g.desc 'API to allow enterprise grid admins to write/overwrite the allow list of IP blocks and ASNs from the enterprise configuration.'
+        g.long_desc %( API to allow enterprise grid admins to write/overwrite the allow list of IP blocks and ASNs from the enterprise configuration. )
+        g.command 'updateItem' do |c|
+          c.flag 'trusted_asns', desc: 'allow list of Autonomous System Numbers (ASN) in the enterprise grid configuarion.'
+          c.flag 'trusted_cidr', desc: 'allow list of IPv4 addressses using cidr notation in the enterprise grid configuarion.'
+          c.action do |_global_options, options, _args|
+            puts JSON.dump(@client.admin_audit_anomaly_allow_updateItem(options))
+          end
+        end
+      end
+    end
+  end
+end