chatrix 1.0.0.pre → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f4d840405e59e950232bf4a82a906c7395d3c581
-  data.tar.gz: 26d630e954f5cc66b8bdd9dd5f01132ef6ca84af
+  metadata.gz: d46105489cd9f2748b15ea3a650893af40baad6d
+  data.tar.gz: 03d5bc731429c298f6e1d3367efab623c3d34549
 SHA512:
-  metadata.gz: bd3aa274eb0b3da53e24f8cfb95b354025513a421fd094172a912791de0962e171f9817906bb811bdc125047f415173c78a612ca7f9179bc1fc34ed710cf9e51
-  data.tar.gz: 61275fb3232b31c24b3e0d215107655ecbd65d4836b04d97b3d8c6a79c7896100428f59a509eb1e27c863597c08dc2455e265e75d53b7543b67ef48cecb39306
+  metadata.gz: 6bd7b7098a58b632bf67e48cd5d4b7ae4685bcbb53c8876a7a210a3450980221f247b931803f434198c111d943f42cdd9d1b5d5aca7ee2b1ac88048277e9b619
+  data.tar.gz: 5a26a6d99f8d66905a50de48062eddd6880b176c7ca3ac61fbc574964651980d847ac25f9457d4c4775b7e04ff20832d31904bd7ef86d789b9310080db580723

data/.gitignore

@@ -165,3 +165,6 @@ GitHub.sublime-settings
 ### Custom rules ###
 # Ignore access token file
 access_token.txt
+
+# Ignore API dumps
+dumps/

data/.travis.yml

@@ -5,4 +5,10 @@ language: ruby
 rvm:
   - 2.3.1
 
+bundler_args: --without development doc
+
 before_install: gem install bundler -v 1.12.5
+
+addons:
+  code_climate:
+    repo_token: 97786ceac8f7388a6ac89408a63f98454678567c780deef82377f8e66b9f7cd6

data/Gemfile

@@ -2,3 +2,22 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in ratrix.gemspec
 gemspec
+
+group :development do
+  gem 'pry', '~> 0.10'
+end
+
+group :test do
+  gem 'rake', '~> 11.0'
+  gem 'rspec', '~> 3.0'
+  gem 'codeclimate-test-reporter', '~> 0.5', require: false
+end
+
+group :development, :test do
+  gem 'rubocop', '~> 0.40.0'
+end
+
+group :doc do
+  gem 'yard', '~> 0.8'
+  gem 'redcarpet', '~> 3.3'
+end

data/README.md

@@ -1,6 +1,13 @@
 chatrix
 =======
 
+[![Gem version][gem-badge-img]][gem-badge]
+[![Dependency status][gemnasium-img]][gemnasium]
+[![Build status][travis-img]][travis]
+[![Code climate][cc-img]][cc]
+[![Coverage][coverage-img]][coverage]
+[![Inline docs][inch-img]][inch]
+
 A Ruby implementation of the [Matrix][matrix] API.
 
 ## License
@@ -27,9 +34,10 @@ Or install it yourself as:
     $ gem install chatrix
 
 ## Usage
-
+### Using the API class `Chatrix::Matrix`
 This implementation is currently very basic and exposes all the endpoints
-in the `Matrix` class. Example usage:
+in the `Matrix` class and some sub-classes available as attributes on the
+main `Matrix` class. Example usage:
 
 ```ruby
 # Uses the standard matrix.org homeserver
@@ -37,14 +45,65 @@ api = Chatrix::Matrix.new 'my secret token'
 
 # Join may raise ForbiddenError if client does not have permission
 # to join the room
-if id = api.join '#myroom:myserver.org'
-  api.send_message id, 'Hello everyone!'
+if id = api.rooms.actions.join '#myroom:myserver.org'
+  api.rooms.actions.send_message id, 'Hello everyone!'
 end
 ```
 
 Currently there is no asynchronous calls or built-in handling of
 rate-limiting.
 
+All of the available endpoints *should* be available, if there are some
+missing that are not deprecated in the official API docs, please open an
+issue about it or add them yourself and submit a PR!
+
+### Using the client class `Chatrix::Client`
+The client class works as a wrapper around the raw API calls to make working
+with the API a little easier. It uses the [`wisper`][wisper] gem to broadcast
+state changes.
+
+```ruby
+# When setting up with an access token, there is no way to obtain your own
+# user ID through the API, so it has to be supplied manually.
+client = Chatrix::Client.new 'my token', 'my user id'
+
+# This will spawn a new thread that continously syncs against the homeserver
+# to check for new events. It can be stopped by calling Client#stop_syncing.
+client.start_syncing
+
+# Set up a listener for when a message arrives
+client.on(:room_message) do |room, message|
+  puts "(#{room}) #{message.sender}: #{message.body}"
+end
+
+# We can also listen to messages in a specific room by subscribing to the
+# timeline of that room.
+myroom = client.get_room '#myroom:myserver.org'
+myroom.timeline.on(:message) do |room, message|
+  # Reply with a "Pong!" if someone sends a message starting
+  # with the word "ping", but don't reply to ourselves.
+  if message.body.match(/^\bping\b/i) && message.sender != client.me
+    room.messaging.send_message 'Pong!'
+  end
+end
+
+# Permissions and room actions can be used with relative ease.
+myroom.timeline.on(:message) do |room, message|
+  if message.body.match(/^!kickme$/i) && message.sender != client.me
+    if room.state.permissions.can? message.sender, :kick
+      room.admin.kick message.sender, 'They asked for it'
+    else
+      room.messaging.send_message "You do not have kick privileges, #{message.sender}"
+    end
+  end
+end
+```
+
+When subscribing to an event, make sure to
+[not return inside the block][no-return-blocks].
+
+*The client is currently a WIP.*
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies.
@@ -61,3 +120,19 @@ Bug reports and pull requests are welcome on [GitHub][issues].
 [issues]: https://github.com/Sharparam/chatrix/issues
 [matrix]: http://matrix.org
 [license-url]: http://opensource.org/licenses/MIT
+
+[gem-badge]: https://badge.fury.io/rb/chatrix
+[gem-badge-img]: https://badge.fury.io/rb/chatrix.svg
+[gemnasium]: https://gemnasium.com/github.com/Sharparam/chatrix
+[gemnasium-img]: https://gemnasium.com/badges/github.com/Sharparam/chatrix.svg
+[travis]: https://travis-ci.org/Sharparam/chatrix
+[travis-img]: https://travis-ci.org/Sharparam/chatrix.svg?branch=master
+[cc]: https://codeclimate.com/github/Sharparam/chatrix
+[cc-img]: https://codeclimate.com/github/Sharparam/chatrix/badges/gpa.svg
+[coverage]: https://codeclimate.com/github/Sharparam/chatrix/coverage
+[coverage-img]: https://codeclimate.com/github/Sharparam/chatrix/badges/coverage.svg
+[inch]: http://inch-ci.org/github/Sharparam/chatrix
+[inch-img]: http://inch-ci.org/github/Sharparam/chatrix.svg?branch=master
+
+[wisper]: https://github.com/krisleech/wisper
+[no-return-blocks]: http://product.reverb.com/2015/02/28/the-strange-case-of-wisper-and-ruby-blocks-behaving-like-procs/

data/chatrix.gemspec

@@ -23,12 +23,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_runtime_dependency 'httparty', '~> 0.13'
+  spec.add_runtime_dependency 'wisper', '~> 1.6'
 
   spec.add_development_dependency 'bundler', '~> 1.12'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec', '~> 3.0'
-  spec.add_development_dependency 'pry', '~> 0.10'
-  spec.add_development_dependency 'yard', '~> 0.8'
-  spec.add_development_dependency 'redcarpet', '~> 3.3'
-  spec.add_development_dependency 'rubocop', '~> 0.40.0'
 end

data/lib/chatrix.rb

@@ -1,6 +1,7 @@
 require 'chatrix/version'
 require 'chatrix/errors'
 require 'chatrix/matrix'
+require 'chatrix/client'
 
 # Encapsulates all gem functionality.
 module Chatrix

data/lib/chatrix/api/api_component.rb

@@ -0,0 +1,21 @@
+module Chatrix
+  module Api
+    # Wraps a matrix instance for use in calling API endpoints.
+    class ApiComponent
+      # Initializes a new ApiComponent instance.
+      def initialize(matrix)
+        @matrix = matrix
+      end
+
+      protected
+
+      # Makes an API request using the underlying Matrix instance.
+      # @param args Parameters to pass to Matrix#make_request.
+      # @yield (see Matrix#make_request)
+      # @return (see Matrix#make_request)
+      def make_request(*args, &block)
+        @matrix.make_request(*args, &block)
+      end
+    end
+  end
+end

data/lib/chatrix/api/media.rb

@@ -0,0 +1,67 @@
+module Chatrix
+  module Api
+    # Contains methods for accessing the media endpoints of a server.
+    class Media < ApiComponent
+      # API path for media operations.
+      #
+      # Because for some reason this one is different.
+      MEDIA_PATH = '/_matrix/media/r0'.freeze
+
+      # Initializes a new Media instance.
+      # @param matrix [Matrix] The matrix API instance.
+      def initialize(matrix)
+        super
+        @media_uri = @matrix.homeserver + MEDIA_PATH
+      end
+
+      # Download media from the server.
+      # @param server [String] The server component of an `mxc://` URL.
+      # @param id [String] The media ID of the `mxc://` URL (the path).
+      # @return [HTTParty::Response] The HTTParty response object for the
+      #   request. Use the response object to inspect the returned data.
+      def download(server, id)
+        make_request(
+          :get,
+          "/download/#{server}/#{id}",
+          headers: { 'Accept' => '*/*' },
+          base: @media_uri
+        )
+      end
+
+      # Download the thumbnail for a media resource.
+      # @param server [String] The server component of an `mxc://` URL.
+      # @param id [String] The media ID of the `mxc://` URL (the path).
+      # @param width [Fixnum] Desired width of the thumbnail.
+      # @param height [Fixnum] Desired height of the thumbnail.
+      # @param method ['scale', 'crop'] Desired resizing method.
+      # @return [HTTParty::Response] The HTTParty response object for the
+      #   request. Use the response object to inspect the returned data.
+      def get_thumbnail(server, id, width, height, method = 'scale')
+        make_request(
+          :get,
+          "/thumbnail/#{server}/#{id}",
+          headers: { 'Accept' => 'image/jpeg, image/png' },
+          params: { width: width, height: height, method: method },
+          base: @media_uri
+        )
+      end
+
+      # Uploads a new media file to the server.
+      # @param type [String] The `Content-Type` of the media being uploaded.
+      # @param path [String] Path to a file to upload.
+      # @return [String] The MXC URL for the uploaded object (`mxc://...`).
+      def upload(type, path)
+        File.open(path, 'r') do |file|
+          make_request(
+            :post, '/upload',
+            headers: {
+              'Content-Type' => type, 'Content-Length' => file.size.to_s,
+              'Transfer-Encoding' => 'chunked'
+            },
+            content: file, base: @media_uri
+          )['content_uri']
+        end
+      end
+    end
+  end
+end

data/lib/chatrix/api/push.rb

@@ -0,0 +1,107 @@
+module Chatrix
+  module Api
+    # Contains methods for accessing the "push" endpoints on the server.
+    #
+    # Refer to the official documentation for more information about these.
+    class Push < ApiComponent
+      # Get all active pushers for the current user.
+      # @return [Hash] A list of pushers for the user.
+      def pushers
+        make_request(:get, '/pushers').parsed_response
+      end
+
+      # Add, remove, or modify pushers for the current user.
+      # @param pusher [Hash] Pusher information.
+      # @return [Boolean] `true` if the operation was carried out successfully,
+      #   otherwise `false`.
+      def modify_pusher(pusher)
+        make_request(:post, '/pushers/set', content: pusher).code == 200
+      end
+
+      # Gets all the push rules defined for this user, optionally limited
+      # to a specific scope.
+      # @param scope [String,nil] If set, only rules within that scope will
+      #   be returned.
+      # @return [Hash] A list of push rules for the user.
+      def get_rules(scope = nil)
+        path = scope ? "/pushrules/#{scope}" : '/pushrules'
+        make_request(:get, path).parsed_response
+      end
+
+      # Gets a specific rule.
+      #
+      # @param scope [String] The scope to access.
+      # @param kind [String] The kind of rule.
+      # @param id [String] The rule to get.
+      # @return [Hash] Details about the rule.
+      def get_rule(scope, kind, id)
+        make_request(:get, "/pushrules/#{scope}/#{kind}/#{id}").parsed_response
+      end
+
+      # Deletes a push rule.
+      #
+      # @param (see #get_rule)
+      # @param id [String] The rule ID to delete.
+      # @return [Boolean] `true` if the rule was deleted successfully,
+      #   otherwise `false`.
+      def delete_rule(scope, kind, id)
+        make_request(:delete, "/pushrules/#{scope}/#{kind}/#{id}").code == 200
+      end
+
+      # Adds or change a push rule.
+      #
+      # @param (see #get_rule)
+      # @param id [String] The rule to add or change.
+      # @param opts [Hash{Symbol => String}] Additional options to pass in
+      #   the query string. Note that only one of the options should be set.
+      #
+      # @option opts [String] :before Add this rule as the next-most
+      #   important rule with respect to the rule specified here.
+      # @option opts [String] :after Add this rule as the next-less
+      #   important rule with respect to the rule specified here.
+      #
+      # @return [Boolean] `true` if the operation was carried out successfully,
+      #   otherwise `false`.
+      def add_rule(scope, kind, id, rule, opts = {})
+        path = "/pushrules/#{scope}/#{kind}/#{id}"
+        make_request(:put, path, params: opts, content: rule).code == 200
+      end
+
+      # Sets or modifies the actions for a rule.
+      #
+      # @param (see #get_rule)
+      # @param id [String] The rule ID to modify actions for.
+      # @param actions [Hash] Actions to perform when the conditions for
+      #   this rule are met.
+      # @return [Boolean] `true` if the actions were modified successfully,
+      #   otherwise `false`.
+      def set_actions(scope, kind, id, actions)
+        path = "/pushrules/#{scope}/#{kind}/#{id}/actions"
+        make_request(:put, path, content: actions).code == 200
+      end
+
+      # Sets the enabled state of a rule, the default is to enable it.
+      #
+      # @param (see #get_rule)
+      # @param id [String] The rule ID to modify the enable state for.
+      # @param enabled [Boolean] Whether to enable or disable the rule.
+      # @return [Boolean] `true` if the state was modified successfully,
+      #   otherwise `false`.
+      def enable(scope, kind, id, enabled = true)
+        path = "/pushrules/#{scope}/#{kind}/#{id}/actions"
+        make_request(:put, path, content: { enabled: enabled }).code == 200
+      end
+
+      # Disable a push rule.
+      # This is essentially an alias for #enable with the last parameter
+      # as `false`.
+      #
+      # @param (see #get_rule)
+      # @param id [String] The rule ID to disable.
+      # @return [Boolean] `true` if the rule was disabled, otherwise `false`.
+      def disable(scope, kind, id)
+        enable(scope, kind, id, false)
+      end
+    end
+  end
+end

data/lib/chatrix/api/room_actions.rb

@@ -0,0 +1,267 @@
+module Chatrix
+  module Api
+    # Contains methods for performing actions on rooms.
+    class RoomActions < ApiComponent
+      # Initializes a new RoomActions instance.
+      # @param matrix [Matrix] The matrix API instance.
+      def initialize(matrix)
+        super
+        @transaction_id = 0
+      end
+
+      # Creates a new room on the server.
+      #
+      # @param data [Hash] Additional data to send when creating the room.
+      #   None of these are required when creating a new room.
+      #
+      # @option data [Array<String>] :invite A list of user IDs to invite
+      #   when the room has been created.
+      # @option data [String] :name A custom name to give the room.
+      # @option data ['public', 'private'] :visibility The visibility to
+      #   create the room with.
+      # @option data [Array<Hash>] :invite_3pid A list of third-party
+      #   ID objects to invite to the room.
+      # @option data [String] :topic A topic to set for the room.
+      # @option data ['public_chat', 'trusted_private_chat', 'private_chat']
+      #   :preset Sets various state events based on a preset.
+      #
+      #    * **`private_chat`**: `join_rules` is `invite`,
+      #      `history_visibility` is `shared`.
+      #    * **`trusted_private_chat`**: `join_rules` is `invite`,
+      #      `history_visibility` is `shared`, all invited users get the
+      #      same power level as the room creator.
+      #    * **`public_chat`**: `join_rules` is `public`,
+      #      `history_visibility` is `shared`.
+      # @option data [Hash{String => Object}] :creation_content Additional data
+      #   to add to the `'m.room.create'` content.
+      # @option data [Array<Hash>] :initial_state A list of state events to
+      #   set in the room.
+      # @option data [String] :room_alias_name The **localpart** of the alias
+      #   to sets for this room. The localpart is the part of the alias
+      #   between the "`#`" sign and the "`:host.tld`" ending part. In the
+      #   alias `#hello:world.org`, the "`hello`" part is the localpart.
+      #
+      # @return [String] the ID of the created room.
+      #
+      # @example Create a room with an alias, name, and invited user
+      #   id = create(
+      #     room_alias_name: 'foobar',
+      #     name: 'Foo Bar Baz!',
+      #     invite: ['@silly:example.org']
+      #   )
+      #
+      #   puts "Room #{id} created!"
+      def create(data = {})
+        make_request(:post, '/createRoom', content: data)['room_id']
+      end
+
+      # Joins a room on the homeserver.
+      #
+      # @param room [String] The room to join.
+      # @param third_party_signed [Hash,nil] If provided, the homeserver must
+      #   verify that it matches a pending `m.room.third_party_invite` event in
+      #   the room, and perform key validity checking if required by the event.
+      # @return [String] The ID of the room that was joined is returned.
+      def join(room, third_party_signed = nil)
+        if third_party_signed
+          make_request(
+            :post,
+            "/join/#{room}",
+            content: { third_party_signed: third_party_signed }
+          )['room_id']
+        else
+          make_request(:post, "/join/#{room}")['room_id']
+        end
+      end
+
+      # @overload invite(room, user)
+      #   Invites a user to a room by ID.
+      #   @param room [String] The room to invite the user to.
+      #   @param user [String] The user ID to send the invite to.
+      #   @return [Boolean] `true` if the user was successfully invited,
+      #     otherwise `false`.
+      # @overload invite(room, data)
+      #   Invites a user to a room by their 3PID information.
+      #   @param room [String] The room to invite the user to.
+      #   @param data [Hash] 3PID info for the user.
+      #   @return [Boolean] `true` if the user was successfully invited,
+      #     otherwise `false`.
+      def invite(room, data)
+        data = { user_id: data } if data.is_a? String
+        make_request(:post, "/rooms/#{room}/invite", content: data).code == 200
+      end
+
+      # Leaves a room (but does not forget about it).
+      #
+      # @param room [String] The room to leave.
+      # @return [Boolean] `true` if the room was left successfully,
+      #   otherwise `false`.
+      def leave(room)
+        make_request(:post, "/rooms/#{room}/leave").code == 200
+      end
+
+      # Forgets about a room.
+      #
+      # @param room [String] The room to forget about.
+      # @return [Boolean] `true` if the room was forgotten successfully,
+      #   otherwise `false`.
+      def forget(room)
+        make_request(:post, "/rooms/#{room}/forget").code == 200
+      end
+
+      # Kicks a user from a room.
+      #
+      # This does not ban the user, they can rejoin unless the room is
+      # invite-only, in which case they need a new invite to join back.
+      #
+      # @param room [String] The room to kick the user from.
+      # @param user [String] The user to kick.
+      # @param reason [String] The reason for the kick.
+      # @return [Boolean] `true` if the user was successfully kicked,
+      #   otherwise `false`.
+      #
+      # @example Kicking an annoying user
+      #   kick('#fun:matrix.org', '@anon:4chan.org', 'Bad cropping')
+      def kick(room, user, reason)
+        make_request(
+          :post,
+          "/rooms/#{room}/kick",
+          content: { reason: reason, user_id: user }
+        ).code == 200
+      end
+
+      # Kicks and bans a user from a room.
+      #
+      # @param room [String] The room to ban the user from.
+      # @param user [String] The user to ban.
+      # @param reason [String] Reason why the ban was made.
+      # @return [Boolean] `true` if the ban was carried out successfully,
+      #   otherwise `false`.
+      #
+      # @example Banning a spammer
+      #   ban('#haven:matrix.org', '@spammer:spam.com', 'Spamming the room')
+      def ban(room, user, reason)
+        make_request(
+          :post,
+          "/rooms/#{room}/ban",
+          content: { reason: reason, user_id: user }
+        ).code == 200
+      end
+
+      # Unbans a user from a room.
+      #
+      # @param room [String] The room to unban the user from.
+      # @param user [String] The user to unban.
+      # @return [Boolean] `true` if the user was successfully unbanned,
+      #   otherwise `false`.
+      def unban(room, user)
+        make_request(:post, "/rooms/#{room}/unban", content: { user_id: user })
+          .code == 200
+      end
+
+      # Sends a message object to a room.
+      #
+      # @param room [String] The room to send to.
+      # @param content [Hash] The message content to send.
+      # @param type [String] The type of message to send.
+      # @return [String] The event ID of the sent message is returned.
+      # @see #send_message_type
+      # @see #send_message
+      # @see #send_emote
+      # @see #send_notice
+      # @see #send_html
+      def send_message_raw(room, content, type = 'm.room.message')
+        make_request(
+          :put,
+          "/rooms/#{room}/send/#{type}/#{@transaction_id += 1}",
+          content: content
+        )['event_id']
+      end
+
+      # A helper method to send a simple message construct.
+      #
+      # @param room [String] The room to send the message to.
+      # @param content [String] The message to send.
+      # @param type [String] The type of message this is.
+      #   For example: `'m.text'`, `'m.notice'`, `'m.emote'`.
+      # @return (see #send_message_raw)
+      def send_message(room, content, type = 'm.text')
+        send_message_raw room, msgtype: type, body: content
+      end
+
+      # Sends a message formatted using HTML markup.
+      #
+      # The `body` field in the content will have the HTML stripped out, and is
+      # usually presented in clients that don't support the formatting.
+      #
+      # The `formatted_body` field in the content will contain the actual HTML
+      # formatted message (as passed to the `html` parameter).
+      #
+      # @param room [String] The room to send to.
+      # @param html [String] The HTML formatted text to send.
+      # @return (see #send_message_raw)
+      #
+      # @example Sending an HTML message
+      #   send_html('#html:matrix.org',
+      #             '<strong>Hello</strong> <em>world</em>!')
+      def send_html(room, html)
+        send_message_raw(
+          room,
+          msgtype: 'm.text',
+          format: 'org.matrix.custom.html',
+          body: html.gsub(%r{</?[^>]*?>}, ''), # TODO: Make this better
+          formatted_body: html
+        )
+      end
+
+      # Sends a message to the server informing it about a user having started
+      # or stopped typing.
+      #
+      # @param room [String] The affected room.
+      # @param user [String] The user that started or stopped typing.
+      # @param typing [Boolean] Whether the user is typing.
+      # @param duration [Fixnum] How long the user will be typing for
+      #   (in milliseconds).
+      # @return [Boolean] `true` if the message sent successfully, otherwise
+      #   `false`.
+      def send_typing(room, user, typing = true, duration = 30_000)
+        make_request(
+          :put,
+          "/rooms/#{room}/typing/#{user}",
+          content: { typingState: { typing: typing, timeout: duration } }
+        ).code == 200
+      end
+
+      # Updates the marker for the given receipt type to point to the
+      # specified event.
+      #
+      # @param room [String] The room to update the receipt in.
+      # @param event [String] The new event to point the receipt to.
+      # @param type [String] The receipt type to update.
+      # @param data [Hash] Any additional data to attach to `content`.
+      # @return [Boolean] `true` if the receipt was successfully updated,
+      #   otherwise `false`.
+      def set_receipt(room, event, type = 'm.read', data = {})
+        make_request(
+          :post,
+          "/rooms/#{room}/receipt/#{type}/#{event}",
+          content: data
+        ).code == 200
+      end
+
+      # Redacts a room event from the server.
+      #
+      # @param room [String] The room to redact the event from.
+      # @param event [String] The event to redact.
+      # @param reason [String] The reason for redacting the event.
+      # @return [String] The ID for the redaction event.
+      def redact(room, event, reason)
+        make_request(
+          :put,
+          "/rooms/#{room}/redact/#{event}/#{@transaction_id += 1}",
+          content: { reason: reason }
+        )['event_id']
+      end
+    end
+  end
+end