slack-ruby-client 0.13.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab472063785c95f073bf42b275abd64d6189eb81d93187710b0be994216af4c5
-  data.tar.gz: 3c3621f8dd346a3e6cb87510547b455493a95ba89e27fc8abf844d25a9b1bf88
+  metadata.gz: 41b05d465011510580551afbef311aa1df18063ca138248729182151b0338dc7
+  data.tar.gz: 8a38b38f90eb718d5c54cc7adf40384fa059d93deb82265b9bf29bcaf0de9ec1
 SHA512:
-  metadata.gz: 0aafa2c9b320423d1d60e6edfb7ab5683ce574a6cb6af8a5585be988ea87864e43fe2cea32a387c25716e699a5ff7cbcc353418151f89105d6427954fa24c0fb
-  data.tar.gz: 559cba90e5ab1906c035399b598a6279441696418c2c5d77ec2040aa6445e244a71c97d5f6d39dcd8c5ded21841e4c0bf1d3c05d2f02b066b233beb6524dc4bf
+  metadata.gz: a7781e6f5438b9b4684b99eec70180906b5cba1bd325ef03df3b8e4b40321b186b00ff96962ccc67c4923a3d560beea8859737fb9e18010b6c53a6e8c99b0bf0
+  data.tar.gz: 0dee1a1224b31a368176b7e5f7ebec109135c9b4f54ccb3827d6e4165a61d94e0a97ca06dfd1b87427494c287dd455ab598ee1b363703f3778756308ec486ccf

data/.rubocop.yml

@@ -15,4 +15,7 @@ Style/Documentation:
 Naming/MethodName:
   Enabled: false
 
+Style/ModuleFunction:
+  Enabled: false
+
 inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2018-08-27 13:29:57 +0200 using RuboCop version 0.58.2.
+# on 2019-01-19 17:37:31 -0500 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,6 +13,13 @@ Lint/HandleExceptions:
     - 'spec/slack/real_time/concurrency/celluloid_spec.rb'
     - 'spec/slack/real_time/concurrency/eventmachine_spec.rb'
 
+# Offense count: 1
+# Configuration parameters: ExpectMatchingDefinition, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+Naming/FileName:
+  Exclude:
+    - 'lib/slack-ruby-client.rb'
+
 # Offense count: 1
 # Configuration parameters: EnforcedStyleForLeadingUnderscores.
 # SupportedStylesForLeadingUnderscores: disallowed, required, optional
@@ -20,13 +27,6 @@ Naming/MemoizedInstanceVariableName:
   Exclude:
     - 'lib/slack/logger.rb'
 
-# Offense count: 2
-# Configuration parameters: MinNameLength, AllowNamesEndingInNumbers, AllowedNames, ForbiddenNames.
-# AllowedNames: io, id, to, by, on, in, at, ip
-Naming/UncommunicativeMethodParamName:
-  Exclude:
-    - 'spec/support/queue_with_timeout.rb'
-
 # Offense count: 1
 Security/Open:
   Exclude:
@@ -40,14 +40,7 @@ Style/AccessModifierDeclarations:
     - 'lib/slack/real_time/concurrency/eventmachine.rb'
     - 'lib/slack/real_time/socket.rb'
 
-# Offense count: 2
-# Cop supports --auto-correct.
-Style/ExpandPathArguments:
-  Exclude:
-    - 'bin/slack'
-    - 'slack-ruby-client.gemspec'
-
-# Offense count: 152
+# Offense count: 153
 # Configuration parameters: AllowedVariables.
 Style/GlobalVars:
   Enabled: false
@@ -64,23 +57,7 @@ Style/MixinUsage:
   Exclude:
     - 'bin/slack'
 
-# Offense count: 3
-# Cop supports --auto-correct.
-# Configuration parameters: EnforcedStyle.
-# SupportedStyles: module_function, extend_self
-Style/ModuleFunction:
-  Exclude:
-    - 'lib/slack/config.rb'
-    - 'lib/slack/real_time/config.rb'
-    - 'lib/slack/web/config.rb'
-
 # Offense count: 1
 Style/MultilineTernaryOperator:
   Exclude:
     - 'spec/support/real_time/connected_client.rb'
-
-# Offense count: 1
-# Cop supports --auto-correct.
-Style/RandomWithOffset:
-  Exclude:
-    - 'spec/integration/integration_spec.rb'

data/.travis.yml

@@ -3,9 +3,9 @@ language: ruby
 cache: bundler
 
 rvm:
-  - 2.2
-  - 2.3
-  - 2.5
+  - 2.3.8
+  - 2.5.3
+  - 2.6.0
   - ruby-head
   - jruby-head
 
@@ -18,7 +18,7 @@ matrix:
       env: CONCURRENCY=celluloid-io
     - rvm: 2.4.1
       env: CONCURRENCY=faye-websocket
-    - rvm: 2.5
+    - rvm: 2.5.3
       env: CONCURRENCY=async-websocket
   allow_failures:
     - rvm: ruby-head

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+### 0.14.0 (2019/2/25)
+
+* [#238](https://github.com/slack-ruby/slack-ruby-client/issues/238): Added `Slack::Events::Request#verify!` to check whether an event request is coming from Slack - [@dblock](https://github.com/dblock).
+* [#226](https://github.com/slack-ruby/slack-ruby-client/pull/226), [#232](https://github.com/slack-ruby/slack-ruby-client/pull/232), [#236](https://github.com/slack-ruby/slack-ruby-client/pull/236), [#234](https://github.com/slack-ruby/slack-ruby-client/pull/234): Added periodic ping that reconnects on failure - [@RodneyU215](https://github.com/RodneyU215), [@dblock](https://github.com/dblock), [@ioquatix](https://github.com/ioquatix).
+* [#242](https://github.com/slack-ruby/slack-ruby-client/pull/242): Added `thread_ts` option to `chat_postEphemeral` - [@dblock](https://github.com/dblock).
+* [#242](https://github.com/slack-ruby/slack-ruby-client/pull/242): Added `apps_uninstall` to Web API - [@dblock](https://github.com/dblock).
+* [#244](https://github.com/slack-ruby/slack-ruby-client/pull/244): Implementing #restart for the celluloid socket class - [@RodneyU215](https://github.com/RodneyU215).
+* [#246](https://github.com/slack-ruby/slack-ruby-client/pull/246): Added TOC to README and danger-toc - [@dblock](https://github.com/dblock).
+* [#253](https://github.com/slack-ruby/slack-ruby-client/pull/253): Support for Block Kit - [@JrmKrb](https://github.com/JrmKrb).
+
 ### 0.13.1 (2018/9/30)
 
 * [#228](https://github.com/slack-ruby/slack-ruby-client/pull/228): Replace `Thread` with `Actor` in Celluloid async support - [@dblock](https://github.com/dblock).

data/Dangerfile

@@ -1 +1,2 @@
 danger.import_dangerfile(gem: 'slack-ruby-danger')
+toc.check

data/Gemfile

@@ -4,9 +4,7 @@ gemspec
 
 gem ENV['CONCURRENCY'], require: false if ENV.key?('CONCURRENCY')
 
-gem 'activesupport', '~> 4.0'
-gem 'picky' unless RUBY_PLATFORM == 'java'
-
 group :test do
+  gem 'danger-toc', '~> 0.1.3', require: false
   gem 'slack-ruby-danger', '~> 0.1.0', require: false
 end

data/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2015-2016 Daniel Doubrovkine, Artsy and Contributors
+Copyright (c) 2015-2019 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

@@ -5,20 +5,68 @@ Slack Ruby Client
 [![Build Status](https://travis-ci.org/slack-ruby/slack-ruby-client.svg?branch=master)](https://travis-ci.org/slack-ruby/slack-ruby-client)
 [![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) and [RealTime Messaging](https://api.slack.com/rtm) 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).
+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).
 
 ![](slack.png)
 
+## Table of Contents
+
+- [Useful to Me?](#useful-to-me)
+- [Stable Release](#stable-release)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Create a New Bot Integration](#create-a-new-bot-integration)
+  - [Use the API Token](#use-the-api-token)
+  - [Global Settings](#global-settings)
+  - [Web Client](#web-client)
+    - [Test Auth](#test-auth)
+    - [Send Messages](#send-messages)
+    - [List Channels](#list-channels)
+    - [Upload a File](#upload-a-file)
+  - [Get Channel Info](#get-channel-info)
+  - [Get User Info](#get-user-info)
+  - [Search for a User](#search-for-a-user)
+    - [Other](#other)
+    - [Web Client Options](#web-client-options)
+    - [Pagination Support](#pagination-support)
+    - [Error Handling](#error-handling)
+  - [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)
+  - [Combining RealTime and Web Clients](#combining-realtime-and-web-clients)
+  - [Large Team Considerations](#large-team-considerations)
+    - [Concurrency](#concurrency)
+      - [Async](#async)
+      - [Faye::Websocket with Eventmachine](#fayewebsocket-with-eventmachine)
+      - [Celluloid](#celluloid)
+  - [Events API](#events-api)
+    - [Configuring Slack::Events](#configuring-slackevents)
+    - [Verifying the Request Signature](#verifying-the-request-signature)
+  - [Message Parsing](#message-parsing)
+  - [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)
+- [History](#history)
+- [Contributing](#contributing)
+- [Copyright and License](#copyright-and-license)
+
 ## Useful to Me?
 
-* This piece of the puzzle will help you send messages to Slack via the Web API and send and receive messages via the Real Time API.
-* If you're trying to respond to slash commands, just write a basic web application and use this library to call the Slack Web API.
-* If you're trying to build a Real Time bot, use [slack-ruby-bot](https://github.com/dblock/slack-ruby-bot), which uses this library.
-* If you're trying to roll out a full service with Slack button integration to multiple teams, check out [slack-ruby-bot-server](https://github.com/dblock/slack-ruby-bot-server), which is built on top of slack-ruby-bot, which uses this library.
+* This library will let you send messages to Slack via the Web API, send and receive messages via the Real Time Messaging API and facilitate integration with the Events API.
+* To respond to slash commands, interactive components or events, implement a web application using your favorite web framework and use this library to call the Slack Web API and to verify that events are coming from Slack.
+* To build a bot using the Real Time Messaging API, use [slack-ruby-bot](https://github.com/dblock/slack-ruby-bot), which uses this library.
+* To roll out a complete service using the Real Time Messaging API with Slack button integration to multiple teams, check out [slack-ruby-bot-server](https://github.com/dblock/slack-ruby-bot-server), which is built on top of slack-ruby-bot, which uses this library.
 
 ## Stable Release
 
-You're reading the documentation for the **stable** release of slack-ruby-client, 0.13.1. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
+You're reading the documentation for the **stable** release of slack-ruby-client, v0.14.0. See [UPGRADING](UPGRADING.md) when upgrading from an older version.
 
 ## Installation
 
@@ -235,9 +283,9 @@ end
 client.on :message do |data|
   case data.text
   when 'bot hi' then
-    client.message channel: data.channel, text: "Hi <@#{data.user}>!"
+    client.message(channel: data.channel, text: "Hi <@#{data.user}>!")
   when /^bot/ then
-    client.message channel: data.channel, text: "Sorry <@#{data.user}>, what?"
+    client.message(channel: data.channel, text: "Sorry <@#{data.user}>, what?")
   end
 end
 
@@ -308,7 +356,7 @@ The following settings are supported.
 setting         | description
 ----------------|-----------------------------------------------------------------------------------------------------
 token           | Slack API token.
-websocket_ping  | The number of seconds that indicates how often the WebSocket should send ping frames, default is 30.
+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`.
@@ -321,6 +369,15 @@ See a fully working example in [examples/hi_real_time](examples/hi_real_time/hi.
 
 ![](examples/hi_real_time/hi.gif)
 
+#### Caveats
+
+##### `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.
+
+To disable this feature; set `websocket_ping` to 0.
+
 ### Connection Methods
 
 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.
@@ -341,9 +398,9 @@ client = Slack::RealTime::Client.new
 client.on :message do |data|
   case data.text
   when 'bot hi' then
-    client.web_client.chat_postMessage channel: data.channel, text: "Hi <@#{data.user}>!"
+    client.web_client.chat_postMessage(channel: data.channel, text: "Hi <@#{data.user}>!")
   when /^bot/ then
-    client.web_client.chat_postMessage channel: data.channel, text: "Sorry <@#{data.user}>, what?"
+    client.web_client.chat_postMessage(channel: data.channel, text: "Sorry <@#{data.user}>, what?")
   end
 end
 
@@ -419,7 +476,37 @@ gem 'celluloid-io', require: ['celluloid/current', 'celluloid/io']
 
 See a fully working example in [examples/hi_real_time_async_celluloid](examples/hi_real_time_async_celluloid/hi.rb).
 
-Require
+### Events API
+
+This library provides limited support for the [Slack Events API](https://api.slack.com/events-api).
+
+#### Configuring Slack::Events
+
+You can configure Events support globally.
+
+```ruby
+Slack::Events.configure do |config|
+  config.signing_secret = 'secret'
+end
+```
+
+The following settings are supported.
+
+setting               | description
+----------------------|---------------------------------------------------------------------------------------------------
+signing_secret        | Slack signing secret, defaults is `ENV['SLACK_SIGNING_SECRET']`.
+signature_expires_in  | Signature expiration window in seconds, default is `300`.
+
+#### Verifying the Request Signature
+
+Slack signs its requests using a secret that's unique to your app. Verify incoming HTTP requests as follows.
+
+```ruby
+slack_request = Slack::Events::Request.new(http_request)
+slack_request.verify!
+```
+
+The `verify!` call may raise `Slack::Events::MissingSigningSecret`, `Slack::Events::InvalidSignature` or `Slack::Events::TimestampExpired` errors.
 
 ### Message Parsing
 
@@ -509,6 +596,6 @@ See [CONTRIBUTING](CONTRIBUTING.md).
 
 ## Copyright and License
 
-Copyright (c) 2015-2016, [Daniel Doubrovkine](https://twitter.com/dblockdotorg), [Artsy](https://www.artsy.net) and [Contributors](CHANGELOG.md).
+Copyright (c) 2015-2019, [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

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

data/bin/commands/apps.rb

@@ -0,0 +1,14 @@
+# This file was auto-generated by lib/tasks/web.rake
+
+desc 'Apps methods.'
+command 'apps' do |g|
+  g.desc 'Uninstalls your app from a workspace.'
+  g.long_desc %( Uninstalls your app from a workspace. )
+  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.'
+    c.action do |_global_options, options, _args|
+      puts JSON.dump($client.apps_uninstall(options))
+    end
+  end
+end

data/bin/commands/chat.rb

@@ -50,10 +50,12 @@ command 'chat' do |g|
     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 bot. Defaults to false.'
+    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 '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 make this message a reply. Avoid using a reply's ts value; use its parent instead."
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.chat_postEphemeral(options))
     end
@@ -66,6 +68,7 @@ command 'chat' do |g|
     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. Provide no more than 40,000 characters or risk truncation."
     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. 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.'
@@ -103,6 +106,7 @@ command 'chat' do |g|
     c.flag 'ts', desc: 'Timestamp of the message to be updated.'
     c.flag 'as_user', desc: 'Pass true to update the message as the authed user. Bot users in this context are considered authed users.'
     c.flag 'attachments', desc: 'A JSON-based array of structured attachments, presented as a URL-encoded string. This field is required when not presenting text.'
+    c.flag 'blocks', desc: 'A JSON-based array of structured blocks, presented as a URL-encoded string.'
     c.flag 'link_names', desc: 'Find and link channel names and usernames. Defaults to none. See below.'
     c.flag 'parse', desc: 'Change how messages are treated. Defaults to client, unlike chat.postMessage. See below.'
     c.action do |_global_options, options, _args|

data/bin/commands/conversations.rb

@@ -50,6 +50,7 @@ command 'conversations' do |g|
   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.'
+    c.flag 'include_num_members', desc: 'Set to true to include the member count for the specified conversation. Defaults to false.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.conversations_info(options))
     end

data/bin/commands/files.rb

@@ -40,17 +40,16 @@ command 'files' do |g|
     c.flag 'ts_from', desc: 'Filter files created after this timestamp (inclusive).'
     c.flag 'ts_to', desc: 'Filter files created before this timestamp (inclusive).'
     c.flag 'types', desc: 'Filter files by type:
+* `all` - All files
+* `spaces` - Posts
+* `snippets` - Snippets
+* `images` - Image files
+* `gdocs` - Google docs
+* `zips` - Zip files
+* `pdfs` - PDF files
 
-all - All files
-spaces - Posts
-snippets - Snippets
-images - Image files
-gdocs - Google docs
-zips - Zip files
-pdfs - PDF files
+You can pass multiple values in the types argument, like `types=spaces,snippets`.The default value is `all`, which does not filter the list.
 
-
-You can pass multiple values in the types argument, like types=spaces,snippets.The default value is all, which does not filter the list.
 .'
     c.flag 'user', desc: 'Filter files created by a single user.'
     c.action do |_global_options, options, _args|

data/bin/commands/reactions.rb

@@ -7,8 +7,8 @@ command 'reactions' do |g|
   g.command 'add' do |c|
     c.flag 'name', desc: 'Reaction (emoji) name.'
     c.flag 'channel', desc: 'Channel where the message to add reaction to was posted.'
-    c.flag 'file', desc: 'File to add reaction to.'
-    c.flag 'file_comment', desc: 'File comment to add reaction to.'
+    c.flag 'file', desc: "File to add reaction to. Now that file threads work the way you'd expect, this argument is deprecated. Specify the timestamp and channel of the message associated with a file instead."
+    c.flag 'file_comment', desc: "File comment to add reaction to. Now that file threads work the way you'd expect, this argument is deprecated. Specify the timestamp and channel of the message associated with a file instead."
     c.flag 'timestamp', desc: 'Timestamp of the message to add reaction to.'
     c.action do |_global_options, options, _args|
       puts JSON.dump($client.reactions_add(options))

data/bin/slack

@@ -46,7 +46,7 @@ pre do |global_options, _command, options, _args|
   true
 end
 
-$LOAD_PATH.push File.expand_path('..', __FILE__)
+$LOAD_PATH.push File.expand_path(__dir__)
 require 'commands'
 
 exit run(ARGV)

data/lib/slack-ruby-client.rb

@@ -47,3 +47,7 @@ require_relative 'slack/real_time/models'
 require_relative 'slack/real_time/stores'
 require_relative 'slack/real_time/config'
 require_relative 'slack/real_time/client'
+
+# Events API
+require_relative 'slack/events/config'
+require_relative 'slack/events/request'

data/lib/slack/events/config.rb

@@ -0,0 +1,31 @@
+module Slack
+  module Events
+    module Config
+      extend self
+
+      ATTRIBUTES = %i[
+        signing_secret
+        signature_expires_in
+      ].freeze
+
+      attr_accessor(*Config::ATTRIBUTES)
+
+      def reset
+        self.signing_secret = ENV['SLACK_SIGNING_SECRET']
+        self.signature_expires_in = 5 * 60
+      end
+    end
+
+    class << self
+      def configure
+        block_given? ? yield(Config) : Config
+      end
+
+      def config
+        Config
+      end
+    end
+  end
+end
+
+Slack::Events::Config.reset