stride 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d80671a3dbded76f91c18e695619655ce13d9c5f
-  data.tar.gz: '0038c0da7907c73851346844cdb4b4193c68cb33'
+  metadata.gz: aa8b67e12775bcb352e3dfe5d3559a5660886466
+  data.tar.gz: 6ce50f9338ad89bfb0afb17f829690765eb155aa
 SHA512:
-  metadata.gz: 6cf477a98e648f45c0c1a58db4e129390aeb11b790c58e869aa4c04a4fcdc969e6e5eedad59284a87c8062e117aacb88ad70a8e3c787cf39a3303fb7a6c96ef1
-  data.tar.gz: bbe022265510923399d63b67933ea84b48aa2a50c85433ed9d52a5ad6e46d09582d3ad7fff5bc95937c1f39aefccaa761de7698d21b4236feb1424cae1fe8021
+  metadata.gz: a943fe7c8dc7c1aa7de0dcbe12034f0573a63b7585e4c7bc0747fd1565e11dc3f3c8161d3e26d147b8a5afe2b14fcd341163b0a1cb93cf8ba054fa2c3894edc0
+  data.tar.gz: 895c2e375956d444995e033e1cdc61e8618a1ad66a2a6590178ec95d0985af3173179baa13cead0ca1afa4e4a9a05939c852e1b2d75c602cac745e238abae59b

data/.ruby-version

@@ -0,0 +1 @@
+2.3.1

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+## 0.1.1 (April 16, 2018)
+
+Support passing in a permanent room token to `Client` instead of relying on OAuth.
+
+## 0.1.0
+
+Initial release

data/README.md

@@ -1,8 +1,6 @@
 # Stride
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/stride`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+A ruby wrapper for Stride's API.
 
 ## Installation
 
@@ -20,9 +18,137 @@ Or install it yourself as:
 
     $ gem install stride
 
+## Configuration
+
+Add to an initializer:
+
+```ruby
+Stride.configure do |config|
+  config.client_id = "YOUR CLIENT ID"
+  config.client_secret = "YOUR CLIENT SECRET"
+end
+```
+
 ## Usage
 
-TODO: Write usage instructions here
+### Acquiring an access token
+
+This should be done for you in most cases, but if you need to acquire an access token from the Atlassian Identity API, you may do so:
+
+```ruby
+Stride::Token.fetch!
+```
+
+This returns a `Token` instance, which will have an `access_token` attribute.
+
+### Creating a client
+
+Send in the cloud_id and conversation_id:
+
+```ruby
+cloud_id = '911f7ab7-0581-4082-bed3-bad889ec4c91'
+conversation_id = '76987a29-b7d9-43c5-b071-7aab71d88a6b'
+
+client = Stride::Client.new(cloud_id, conversation_id)
+```
+
+This will rely on OAuth to get a token. If you've generated a room token
+[as described here](https://developer.atlassian.com/cloud/stride/security/authentication/),
+then you can pass that in as a third parameter when initializing the client:
+
+```ruby
+Stride::Client.new(cloud_id, conversation_id, access_token)
+```
+
+When you use this approach, the `client_id` and `client_secret` configuration
+are unnecessary.
+
+### Sending a message
+
+If there's a specific cloud and conversation you want to send to, you can send an arbitrary message using `Stride::Client#send_message`. Refer to the [Stride API documentation](https://developer.atlassian.com/cloud/stride/blocks/message-format/) for details on the message format.
+
+```ruby
+message_body = {
+  version: 1,
+  type: 'doc',
+  content: [
+    {
+      type: 'paragraph',
+      content: [
+        {
+          type: 'text',
+          text: 'I am the egg man, they are the egg men'
+        }
+      ]
+    }
+  ]
+}
+
+client.send_message(message_body)
+# => {"id"=>"5d6e39d3-ab1d-10e7-be03-02420aff0003"}
+```
+
+To send a plain text message as above, there's a convience method, `Stride::Client#send_text_message`:
+
+```ruby
+client.send_message('I am the egg man, they are the egg men')
+# => {"id"=>"5d6e39d3-ab1d-10e7-be03-02420aff0003"}
+```
+
+To send a message from Markdown:
+
+```ruby
+client.send_markdown_message('Oh hi [click here](https://bonus.ly)')
+```
+
+We use Atlassian's service for rendering Markdown to Atlassian Document Format (ADF).
+
+To send a user a message:
+
+```ruby
+client.send_user_message(user_id, 'Do you have any eggs?')
+
+client.send_user_markdown_message(user_id, 'Do you have *any* eggs?')
+```
+
+### User Details
+
+To get details about a user when you have the id:
+
+```ruby
+client.user(user_id)
+```
+
+This returns a `User` instance with the following attributes:
+`:id, :user_name, :active, :display_name, :emails, :meta, :photos`
+
+To get details about a conversation when you have the id:
+
+```ruby
+client.conversation
+```
+
+This returns a `Conversation` instance with the following attributes:
+`:cloud_id, :id, :name, :topic, :type, :created, :modified, :avatar_url, :privacy, :is_archived`
+
+To get the members of the conversation:
+
+```ruby
+client.conversation_roster.users
+```
+
+This will return an array of `User` instances for everyone in the conversation.
+
+### Bot Details
+
+To get information about your bot user, just call
+
+```ruby
+client.me
+```
+
+This will return a `Me` instance with the following attributes:
+`:account_id, :name, :email, :picture`
 
 ## Development
 

data/lib/stride.rb

@@ -1,5 +1,28 @@
-require "stride/version"
+require 'stride/version'
+require 'stride/configuration'
+require 'stride/atlassian_document_format_expander'
+require 'stride/base_request'
+require 'stride/authorized_request'
+require 'stride/token'
+require 'stride/message'
+require 'stride/user_message'
+require 'stride/text_message'
+require 'stride/client'
+require 'stride/installation'
+require 'stride/user'
+require 'stride/markdown_document'
+require 'stride/conversation'
+require 'stride/conversation_roster'
+require 'stride/bot_mention'
+require 'stride/me'
 
 module Stride
-  # Your code goes here...
+  class << self
+    attr_accessor :configuration
+  end
+
+  def self.configure
+    self.configuration ||= Configuration.new
+    yield(configuration)
+  end
 end

data/lib/stride/atlassian_document_format_expander.rb

@@ -0,0 +1,117 @@
+module Stride
+  class AtlassianDocumentFormatExpander
+    def initialize(initial_json)
+      self.initial_json = initial_json
+    end
+
+    def as_json
+      return initial_json unless initial_json.has_key?('content')
+
+      initial_json['content'] = ContentBlocks.new(initial_json['content']).as_json
+      initial_json
+    end
+
+    private
+
+    attr_accessor :initial_json
+
+    class ContentBlocks
+      def initialize(initial_json)
+        self.initial_json = initial_json
+      end
+
+      def as_json
+        wrapped_blocks.map(&:as_json).flatten
+      end
+
+      private
+
+      attr_accessor :initial_json
+
+      def wrapped_blocks
+        initial_json.map do |content_block_json|
+          if content_block_json.has_key?('content')
+            content_block_json['content'] = ContentBlocks.new(content_block_json['content']).as_json
+            content_block_json
+          else
+            ContentBlock.new(content_block_json)
+          end
+        end
+      end
+    end
+
+    class ContentBlock
+      MENTION_REGEX = /@@([a-zA-Z]+)\|([a-zA-Z0-9\-:]+)@@/
+      MENTION_REGEX_WITHOUT_GROUPS = /@@[a-zA-Z]+\|[a-zA-Z0-9\-:]+@@/
+
+      def initialize(initial_json)
+        self.initial_json = initial_json
+      end
+
+      def as_json
+        split? ? split_json : initial_json
+      end
+
+      private
+
+      attr_accessor :initial_json
+
+      def split?
+        initial_json.has_key?('text') && match_data.present?
+      end
+
+      def match_data
+        @match_data ||= initial_json['text'].match(MENTION_REGEX)
+      end
+
+      def split_json
+        split_blocks.map(&:as_json)
+      end
+
+      def split_blocks
+        return text_blocks_joined_by_mention_block if mention_in_middle?
+
+        if mention_at_beginning?
+          text_blocks_joined_by_mention_block.prepend mention_block
+        else
+          text_blocks_joined_by_mention_block << mention_block
+        end
+      end
+
+      def text_blocks_joined_by_mention_block
+        @text_blocks_joined_by_mention_block ||= text_blocks.each_with_object([]) do |text_block, all_blocks|
+          all_blocks << text_block
+          all_blocks << mention_block unless text_block == text_blocks.last
+        end.reject { |block| block.as_json['text'] == '' }
+      end
+
+      def mention_in_middle?
+        text_blocks_joined_by_mention_block.count > 1
+      end
+
+      def mention_at_beginning?
+        (initial_json['text'] =~ MENTION_REGEX_WITHOUT_GROUPS) == 0
+      end
+
+      def text_blocks
+        @text_blocks ||= initial_json['text'].split(MENTION_REGEX_WITHOUT_GROUPS).map do |text|
+          self.class.new({
+            "type" => "text",
+            "text" => text
+          })
+        end
+      end
+
+      def mention_block
+        @mention_block ||= self.class.new({
+          "type" => "mention",
+          "attrs" => {
+            "id"          => match_data[2],
+            "text"        => "@#{match_data[1]}",
+            "accessLevel" => "CONTAINER"
+          }
+        })
+      end
+    end
+  end
+end

data/lib/stride/authorized_request.rb

@@ -0,0 +1,14 @@
+module Stride
+  class AuthorizedRequest < BaseRequest
+    private
+
+    attr_accessor :access_token
+
+    def headers
+      {
+        authorization: "Bearer #{access_token}",
+        'content-type': 'application/json'
+      }
+    end
+  end
+end

data/lib/stride/base_request.rb

@@ -0,0 +1,52 @@
+module Stride
+  class BaseRequest
+    def json
+      if result.code =~ /20\d/
+        JSON.parse(result.body)
+      else
+        raise ApiFailure.new(error_message)
+      end
+    end
+
+    private
+
+    def result
+      @result ||= Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+        http.request(request)
+      end
+    end
+
+    def error_message
+      "Got a #{result.code} from Stride API: #{result.body}"
+    end
+
+    def request
+      request_class.new(uri).tap do |req|
+        req.body = params.to_json if params.any?
+        headers.each do |key, value|
+          req[key] = value
+        end
+      end
+    end
+
+    def request_class
+      Net::HTTP::Post
+    end
+
+    def uri
+      raise 'uri must be implemented per request'
+    end
+
+    def params
+      {}
+    end
+
+    def headers
+      {
+        'content-type' => 'application/json'
+      }
+    end
+  end
+
+  class ApiFailure < RuntimeError; end
+end

data/lib/stride/bot_mention.rb

@@ -0,0 +1,113 @@
+module Stride
+  class BotMention
+    def initialize(json)
+      self.json = json
+    end
+
+    def text
+      json['message']['text']
+    end
+
+    def text_without_mentions
+      content_blocks.select(&:text?).map(&:text).join.strip
+    end
+
+    def mentions
+      content_blocks.select(&:mention?)
+    end
+
+    def sender_id
+      json['sender']['id']
+    end
+
+    def conversation
+      Conversation.new(json['conversation'])
+    end
+
+    def text_with_mentions_as_user_ids
+      content_blocks.map { |block| block.respond_to?(:at_id) ? block.at_id : block.text }.join.strip
+    end
+
+    private
+
+    attr_accessor :json
+
+    def content_blocks
+      ContentBlock.wrap(content_json)
+    end
+
+    def content_json
+      content = json['message']['body']['content']
+      content.detect { |json| json['type'] == 'paragraph' } || content.first
+    end
+
+    class ContentBlock
+      def self.wrap(json)
+        json = json['content'] if json.has_key?('content')
+        json.map { |json_block| factory(json_block) }
+      end
+
+      def self.factory(json_block)
+        json_block['type'] == 'text' ? TextBlock.new(json_block) : MentionBlock.new(json_block)
+      end
+
+      def initialize(json)
+        self.json = json
+      end
+
+      def type
+        json['type']
+      end
+
+      def text?
+        false
+      end
+
+      def mention?
+        false
+      end
+
+      private
+
+      attr_accessor :json
+    end
+
+    class TextBlock < ContentBlock
+      def text
+        json['text']
+      end
+
+      def text?
+        true
+      end
+    end
+
+    class MentionBlock < ContentBlock
+      def text
+        attrs['text']
+      end
+
+      def id
+        attrs['id']
+      end
+
+      def access_level
+        attrs['accessLevel']
+      end
+
+      def mention?
+        true
+      end
+
+      def at_id
+        "@#{id}"
+      end
+
+      private
+
+      def attrs
+        json['attrs']
+      end
+    end
+  end
+end

data/lib/stride/client.rb

@@ -0,0 +1,66 @@
+module Stride
+  class Client
+    def initialize(cloud_id, conversation_id, permanent_token = nil)
+      self.cloud_id        = cloud_id
+      self.conversation_id = conversation_id
+      self.permanent_token = permanent_token
+    end
+
+    # `message_body` is a formatted message in JSON
+    # See: https://developer.atlassian.com/cloud/stride/blocks/message-format/
+    def send_message(message_body)
+      Message.new(access_token, cloud_id, conversation_id, message_body).send!
+    end
+
+    # Convenience method for sending a plain text message
+    def send_text_message(message_text)
+      TextMessage.new(access_token, cloud_id, conversation_id, message_text).send!
+    end
+
+    def send_user_message(user_id, message_body)
+      UserMessage.new(access_token, cloud_id, user_id, message_body).send!
+    end
+
+    def send_user_markdown_message(user_id, markdown)
+      send_user_message(user_id, MarkdownDocument.fetch!(access_token, markdown).as_json)
+    end
+
+    def send_markdown_message(markdown)
+      send_message(MarkdownDocument.fetch!(access_token, markdown).as_json)
+    end
+
+    def user(user_id)
+      User.fetch!(access_token, cloud_id, user_id)
+    end
+
+    def conversation
+      Conversation.fetch!(access_token, cloud_id, conversation_id)
+    end
+
+    def conversation_roster
+      ConversationRoster.fetch!(access_token, cloud_id, conversation_id)
+    end
+
+    def me
+      Me.fetch!(access_token)
+    end
+
+    private
+
+    attr_accessor :cloud_id, :conversation_id, :permanent_token
+
+    def access_token
+      permanent_token || token.access_token
+    end
+
+    def token
+      return @token if have_token?
+
+      @token = Token.fetch!
+    end
+
+    def have_token?
+      !@token.nil? && @token.unexpired?
+    end
+  end
+end

data/lib/stride/configuration.rb

@@ -0,0 +1,25 @@
+module Stride
+  class Configuration
+    attr_accessor :client_id, :client_secret, :production
+
+    def initialize
+      self.production = true
+    end
+
+    def api_base_url
+      production? ? 'https://api.atlassian.com' : 'https://api.stg.atlassian.com'
+    end
+
+    def api_audience
+      production? ? 'api.atlassian.com' : 'api.stg.atlassian.com'
+    end
+
+    def auth_api_base_url
+      production? ? 'https://auth.atlassian.com' : 'https://atlassian-account-stg.pus2.auth0.com'
+    end
+
+    def production?
+      !!production
+    end
+  end
+end

data/lib/stride/conversation.rb

@@ -0,0 +1,47 @@
+module Stride
+  class Conversation
+    attr_accessor :cloud_id, :id, :name, :topic, :type, :created, :modified,
+      :avatar_url, :privacy, :is_archived
+
+    def self.fetch!(access_token, cloud_id, conversation_id)
+      new(Request.new(access_token, cloud_id, conversation_id).json)
+    end
+
+    def initialize(json)
+      self.id          = json['id']
+      self.cloud_id    = json['cloudId']
+      self.name        = json['name']
+      self.topic       = json['topic']
+      self.type        = json['type']
+      self.created     = json['created']
+      self.modified    = json['modified']
+      self.avatar_url  = json['avatarUrl']
+      self.privacy     = json['privacy']
+      self.is_archived = json['isArchived']
+    end
+
+    private
+
+    class Request < AuthorizedRequest
+      def initialize(access_token, cloud_id, conversation_id)
+        self.access_token    = access_token
+        self.cloud_id        = cloud_id
+        self.conversation_id = conversation_id
+      end
+
+      private
+
+      attr_accessor :cloud_id, :conversation_id
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/site/#{cloud_id}/conversation/#{conversation_id}"
+        )
+      end
+
+      def request_class
+        Net::HTTP::Get
+      end
+    end
+  end
+end

data/lib/stride/conversation_roster.rb

@@ -0,0 +1,43 @@
+module Stride
+  class ConversationRoster
+    attr_accessor :access_token, :cloud_id, :ids
+
+    def self.fetch!(access_token, cloud_id, conversation_id)
+      new(access_token, cloud_id, Request.new(access_token, cloud_id, conversation_id).json)
+    end
+
+    def initialize(access_token, cloud_id, json)
+      self.access_token = access_token
+      self.cloud_id     = cloud_id
+      self.ids          = json['values']
+    end
+
+    def users
+      @users ||= ids.map { |id| User.fetch!(access_token, cloud_id, id) }
+    end
+
+    private
+
+    class Request < AuthorizedRequest
+      def initialize(access_token, cloud_id, conversation_id)
+        self.access_token    = access_token
+        self.cloud_id        = cloud_id
+        self.conversation_id = conversation_id
+      end
+
+      private
+
+      attr_accessor :cloud_id, :conversation_id
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/site/#{cloud_id}/conversation/#{conversation_id}/roster"
+        )
+      end
+
+      def request_class
+        Net::HTTP::Get
+      end
+    end
+  end
+end

data/lib/stride/installation.rb

@@ -0,0 +1,22 @@
+module Stride
+  class Installation
+    attr_accessor :key, :product_type, :cloud_id, :resource_type, :resource_id,
+      :event_type, :user_id, :oauth_client_id, :version
+
+    def self.parse(json_string)
+      new(JSON.parse(json_string))
+    end
+
+    def initialize(json)
+      self.key             = json['key']
+      self.product_type    = json['productType']
+      self.cloud_id        = json['cloudId']
+      self.resource_type   = json['resourceType']
+      self.resource_id     = json['resourceId']
+      self.event_type      = json['eventType']
+      self.user_id         = json['userId']
+      self.oauth_client_id = json['oauthClientId']
+      self.version         = json['version']
+    end
+  end
+end

data/lib/stride/markdown_document.rb

@@ -0,0 +1,42 @@
+module Stride
+  class MarkdownDocument
+    def initialize(request)
+      self.request = request
+    end
+
+    def self.fetch!(access_token, markdown)
+      new(Request.new(access_token, markdown))
+    end
+
+    def as_json
+      AtlassianDocumentFormatExpander.new(request.json).as_json
+    end
+
+    private
+
+    attr_accessor :request
+
+    class Request < AuthorizedRequest
+      def initialize(access_token, markdown)
+        self.access_token = access_token
+        self.markdown     = markdown
+      end
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/pf-editor-service/convert?from=markdown&to=adf"
+        )
+      end
+
+      def params
+        {
+          input: markdown
+        }
+      end
+
+      private
+
+      attr_accessor :markdown
+    end
+  end
+end

data/lib/stride/me.rb

@@ -0,0 +1,38 @@
+module Stride
+  class Me
+    attr_accessor :account_id, :name, :email, :picture
+
+    def self.fetch!(access_token)
+      new(MeRequest.new(access_token).json)
+    end
+
+    def initialize(json)
+      self.account_id = json['account_id']
+      self.name       = json['name']
+      self.email      = json['email']
+      self.picture    = json['picture']
+    end
+
+    private
+
+    class MeRequest < AuthorizedRequest
+      def initialize(access_token)
+        self.access_token = access_token
+      end
+
+      private
+
+      attr_accessor :cloud_id, :user_id
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/me"
+        )
+      end
+
+      def request_class
+        Net::HTTP::Get
+      end
+    end
+  end
+end

data/lib/stride/message.rb

@@ -0,0 +1,41 @@
+module Stride
+  class Message
+    def initialize(access_token, cloud_id, conversation_id, message_body)
+      self.access_token    = access_token
+      self.cloud_id        = cloud_id
+      self.conversation_id = conversation_id
+      self.message_body    = message_body
+    end
+
+    def send!
+      Request.new(access_token, cloud_id, conversation_id, message_body).json
+    end
+
+    private
+
+    attr_accessor :access_token, :cloud_id, :conversation_id, :message_body
+
+    class Request < AuthorizedRequest
+      def initialize(access_token, cloud_id, conversation_id, message_body)
+        self.access_token    = access_token
+        self.cloud_id        = cloud_id
+        self.conversation_id = conversation_id
+        self.message_body    = message_body
+      end
+
+      private
+
+      attr_accessor :cloud_id, :conversation_id, :message_body
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/site/#{cloud_id}/conversation/#{conversation_id}/message"
+        )
+      end
+
+      def params
+        message_body
+      end
+    end
+  end
+end

data/lib/stride/text_message.rb

@@ -0,0 +1,36 @@
+module Stride
+  class TextMessage
+    def initialize(access_token, cloud_id, conversation_id, message_text)
+      self.access_token    = access_token
+      self.cloud_id        = cloud_id
+      self.conversation_id = conversation_id
+      self.message_text    = message_text
+    end
+
+    def send!
+      Message.new(access_token, cloud_id, conversation_id, message_body).send!
+    end
+
+    private
+
+    attr_accessor :access_token, :cloud_id, :conversation_id, :message_text
+
+    def message_body
+      {
+        version: 1,
+        type: 'doc',
+        content: [
+          {
+            type: 'paragraph',
+            content: [
+              {
+                type: 'text',
+                text: message_text
+              }
+            ]
+          }
+        ]
+      }
+    end
+  end
+end

data/lib/stride/token.rb

@@ -0,0 +1,38 @@
+module Stride
+  class Token
+    attr_accessor :access_token, :refresh_time
+
+    def self.fetch!
+      new(Request.new.json)
+    end
+
+    def initialize(json)
+      self.access_token = json['access_token']
+      self.refresh_time = Time.now + json['expires_in']
+    end
+
+    def unexpired?
+      Time.now < refresh_time
+    end
+
+    private
+
+    class Request < BaseRequest
+
+      private
+
+      def uri
+        @uri ||= URI(Stride.configuration.auth_api_base_url + '/oauth/token')
+      end
+
+      def params
+        {
+          grant_type:    'client_credentials',
+          client_id:     Stride.configuration.client_id,
+          client_secret: Stride.configuration.client_secret,
+          audience:      Stride.configuration.api_audience
+        }
+      end
+    end
+  end
+end

data/lib/stride/user.rb

@@ -0,0 +1,59 @@
+module Stride
+  class User
+    attr_accessor :id, :user_name, :active, :display_name, :emails, :meta, :photos
+
+    def initialize(json)
+      self.id           = json['id']
+      self.user_name    = json['userName']
+      self.active       = json['active']
+      self.display_name = json['displayName']
+      self.emails       = json['emails'].map { |email| Email.new(email['value'], email['primary']) }
+      self.meta         = json['meta']
+      self.photos       = json['photos'].map { |photo| Photo.new(photo['value'], photo['primary']) }
+    end
+
+    def self.fetch!(access_token, cloud_id, user_id)
+      new(UserRequest.new(access_token, cloud_id, user_id).json)
+    end
+
+    def primary_email
+      emails.detect { |email| email.primary? }&.value
+    end
+
+    private
+
+    Email = Struct.new(:value, :primary) do
+      def primary?
+        primary
+      end
+    end
+
+    Photo = Struct.new(:url, :primary) do
+      def primary?
+        primary
+      end
+    end
+
+    class UserRequest < AuthorizedRequest
+      def initialize(access_token, cloud_id, user_id)
+        self.access_token = access_token
+        self.cloud_id     = cloud_id
+        self.user_id      = user_id
+      end
+
+      private
+
+      attr_accessor :cloud_id, :user_id
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/scim/site/#{cloud_id}/Users/#{user_id}"
+        )
+      end
+
+      def request_class
+        Net::HTTP::Get
+      end
+    end
+  end
+end

data/lib/stride/user_message.rb

@@ -0,0 +1,64 @@
+module Stride
+  class UserMessage
+    def initialize(access_token, cloud_id, user_id, message_body)
+      self.access_token = access_token
+      self.cloud_id     = cloud_id
+      self.user_id      = user_id
+      self.message_body = message_body
+    end
+
+    def send!
+      UserInstallationRequest.new(access_token, cloud_id, user_id).json
+      Request.new(access_token, cloud_id, user_id, message_body).json
+    end
+
+    private
+
+    attr_accessor :access_token, :cloud_id, :user_id, :message_body
+
+    class UserInstallationRequest < AuthorizedRequest
+      def initialize(access_token, cloud_id, user_id)
+        self.access_token = access_token
+        self.cloud_id     = cloud_id
+        self.user_id      = user_id
+      end
+
+      private
+
+      attr_accessor :cloud_id, :user_id
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/site/#{cloud_id}/conversation/user/#{user_id}"
+        )
+      end
+
+      def request_class
+        Net::HTTP::Get
+      end
+    end
+
+    class Request < AuthorizedRequest
+      def initialize(access_token, cloud_id, user_id, message_body)
+        self.access_token = access_token
+        self.cloud_id     = cloud_id
+        self.user_id      = user_id
+        self.message_body = message_body
+      end
+
+      private
+
+      attr_accessor :cloud_id, :user_id, :message_body
+
+      def uri
+        URI(
+          "#{Stride.configuration.api_base_url}/site/#{cloud_id}/conversation/user/#{user_id}/message"
+        )
+      end
+
+      def params
+        message_body
+      end
+    end
+  end
+end

data/lib/stride/version.rb

@@ -1,3 +1,3 @@
 module Stride
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/stride.gemspec

@@ -23,4 +23,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 1.15"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "activesupport"
+  spec.add_development_dependency "webmock"
+  spec.add_development_dependency "pry"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stride
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Jon Evans
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-10-04 00:00:00.000000000 Z
+date: 2018-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,6 +52,48 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - joncodes+github@gmail.com
@@ -61,7 +103,9 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".ruby-version"
 - ".travis.yml"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
@@ -70,6 +114,22 @@ files:
 - bin/console
 - bin/setup
 - lib/stride.rb
+- lib/stride/atlassian_document_format_expander.rb
+- lib/stride/authorized_request.rb
+- lib/stride/base_request.rb
+- lib/stride/bot_mention.rb
+- lib/stride/client.rb
+- lib/stride/configuration.rb
+- lib/stride/conversation.rb
+- lib/stride/conversation_roster.rb
+- lib/stride/installation.rb
+- lib/stride/markdown_document.rb
+- lib/stride/me.rb
+- lib/stride/message.rb
+- lib/stride/text_message.rb
+- lib/stride/token.rb
+- lib/stride/user.rb
+- lib/stride/user_message.rb
 - lib/stride/version.rb
 - stride.gemspec
 homepage: https://github.com/bonusly/stride
@@ -92,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Ruby wrapper for the Stride API