layer-ruby 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c88bda03f993c0830bcdfa3e2c61bd70d6513fc5
-  data.tar.gz: 516ec66a994540689b597f06ea01d1fcd12a0b2c
+  metadata.gz: 0976249289a43645badaaadd9d3a67cb684938d2
+  data.tar.gz: bc136906bf91e1ae79cbd6423adec89dc06304ed
 SHA512:
-  metadata.gz: 96e3857ed7f52b85f5c9d7d21c1159b768b6dd94a4617ec4754ea9b0b1f7045e3127f91114a6818203e03df7d128cea744c44339cabccc583bb7e04f7b19196b
-  data.tar.gz: b838d08d8aa637d85f7d7f78eadff5467c7a924eea13b87cb3853e1aad00f828574e07929d0d4e5c8bc836f9b677de2481b79c2ee45504b8c87dd95f4099a5c3
+  metadata.gz: 0ad40b5dab203070617cae0a203d25f88e2944b36aba548afc0ad1ea2c5f068b66dff7145cc7c194a64227a50b487da0e2548569571853ead9852e35f72ba7af
+  data.tar.gz: 52d8129875fd24be068f90e60bd710a3c39734535aab61fce2c93261f2ac8a9c8ee36ac35a84fad431d0d116219037de0626b7860f995404929e35729ad2db1a

data/.travis.yml

@@ -1,4 +1,4 @@
 language: ruby
 rvm:
-  - 2.2.0
+  - 2.3.1
 before_install: gem install bundler -v 1.10.1

data/lib/layer.rb

@@ -6,11 +6,13 @@ require 'layer/operations'
 require 'layer/resource'
 require 'layer/resource_collection'
 require 'layer/relation_proxy'
+require 'layer/singleton_relation_proxy'
 require 'layer/conversation'
 require 'layer/content'
 require 'layer/message'
 require 'layer/user'
 require 'layer/block'
+require 'layer/identity'
 require 'layer/announcement'
 require 'layer/webhook'
 

data/lib/layer/client.rb

@@ -67,7 +67,6 @@ module Layer
       url = "https://api.layer.com#{url}" unless url.start_with?('https://api.layer.com')
 
       headers = {
-        'Accept' => 'application/vnd.layer+json; version=1.0',
         'Content-Type' => 'application/json',
         'If-None-Match' => SecureRandom.uuid
       }.merge(headers)

data/lib/layer/client/platform.rb

@@ -13,6 +13,7 @@ module Layer
 
       def request(method, url, payload = {}, headers = {})
         url = "https://api.layer.com/apps/#{app_id}#{url}" unless url.start_with?('https://api.layer.com')
+        headers['Accept'] ||= 'application/vnd.layer+json; version=1.1'
         headers['Authorization'] ||= "Bearer #{token}"
 
         super

data/lib/layer/client/rest.rb

@@ -25,6 +25,7 @@ module Layer
 
       def request(method, url, payload = {}, headers = {})
         url = "https://api.layer.com#{url}" unless url.start_with?('https://api.layer.com')
+        headers['Accept'] ||= 'application/vnd.layer+json; version=1.0'
         headers['Authorization'] ||= "Layer session-token=\"#{token}\""
 
         super

data/lib/layer/content.rb

@@ -9,8 +9,14 @@ module Layer
   #     ]
   #   })
   #
+  # @example
+  #   conversation = Layer::Conversation.find('layer-conversation-id-here')
+  #   content = conversation.contents.create('image/png', File.open('photo.png'))
+  #
+  #
   # @see https://developer.layer.com/docs/client/rest#rich-content Layer REST API documentation about rich content
-  # @!macro rest-api
+  # @see https://developer.layer.com/docs/platform/messages#rich-content Layer Platform API documentation about rich content
+  # @!macro various-apis
   class Content < Resource
     include Operations::Create
     include Operations::Find

data/lib/layer/conversation.rb

@@ -28,7 +28,7 @@ module Layer
     # @!parse extend Layer::Operations::Delete::ClassMethods
     # @!parse extend Layer::Operations::Destroy::ClassMethods
 
-    # Returns the converations messages
+    # Returns the conversations messages
     #
     # @return [Layer::RelationProxy] the conversation's messages
     # @!macro various-apis
@@ -36,6 +36,27 @@ module Layer
       RelationProxy.new(self, Message, [Operations::Create, Operations::Paginate, Operations::Find, Operations::Delete, Operations::Destroy])
     end
 
+    # Allows creating and finding of the conversation's rich content
+    #
+    # @return [Layer::RelationProxy] the conversation's rich content
+    # @!macro platform-api
+    def contents
+      RelationProxy.new(self, Content, [Operations::Create, Operations::Find]) do
+        def create(mime_type, file, client = self.client)
+          response = client.post(url, {}, {
+            'Upload-Content-Type' => mime_type,
+            'Upload-Content-Length' => file.size
+          })
+
+          attributes = response.merge('size' => file.size, 'mime_type' => mime_type)
+
+          Content.from_response(attributes, client).tap do |content|
+            content.upload(file)
+          end
+        end
+      end
+    end
+
     # Returns the conversations metadata
     #
     # @return [Layer::Patch::Hash] the metadata hash

data/lib/layer/identity.rb

@@ -0,0 +1,21 @@
+module Layer
+  # Managing user identity is also possible:
+  #
+  # @example
+  #   user = Layer::User.find('user_id')
+  #   user.identity # Returns user identity
+  #   user.identity.create({ first_name: 'Frodo', last_name: 'Baggins'}) # Creates new identity
+  #   user.identity.delete # Removes identity
+  #
+  # @see https://developer.layer.com/docs/platform#identity Layer Platform API Documentation about identity
+  # @!macro platform-api
+  class Identity < Resource
+    include Operations::Fetch
+    include Operations::Delete
+    include Operations::Patch
+
+    def self.url
+      '/identity'
+    end
+  end
+end

data/lib/layer/operations.rb

@@ -1,5 +1,6 @@
 require 'layer/operations/create'
 require 'layer/operations/find'
+require 'layer/operations/fetch'
 require 'layer/operations/list'
 require 'layer/operations/paginate'
 require 'layer/operations/delete'

data/lib/layer/operations/fetch.rb

@@ -0,0 +1,33 @@
+module Layer
+  module Operations
+    module Fetch
+
+      module ClassMethods
+        # Fetches the singular resource
+        #
+        # @param client [Layer::Client] the client to use to make this request
+        # @return [Layer::Resource] the found resource
+        # @raise [Layer::Exceptions::Exception] a subclass of Layer::Exceptions::Exception describing the error
+        def fetch(client = self.client)
+          response = client.get(url)
+          from_response(response, client)
+        end
+      end
+
+      # @!visibility private
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      # Reloads the resource
+      #
+      # @return [Layer::Resource] the resource itself
+      # @raise [Layer::Exceptions::Exception] a subclass of Layer::Exceptions::Exception describing the error
+      def reload
+        self.attributes = client.get(url)
+        self
+      end
+
+    end
+  end
+end

data/lib/layer/singleton_relation_proxy.rb

@@ -0,0 +1,29 @@
+module Layer
+  class SingletonRelationProxy < RelationProxy
+    include Operations::Fetch::ClassMethods
+    include Operations::Fetch
+
+    def respond_to_missing?(method, include_private = false)
+      resource.respond_to?(method, include_private) || super
+    end
+
+    def from_response(*args)
+      resource_type.from_response(*args)
+    end
+
+  private
+
+    def method_missing(method, *args, &block)
+      if resource.respond_to?(method)
+        resource.public_send(method, *args, &block)
+      else
+        super
+      end
+    end
+
+    def resource
+      @resource ||= fetch
+    end
+
+  end
+end

data/lib/layer/user.rb

@@ -5,6 +5,10 @@ module Layer
       from_response({ 'url' => "/users/#{id}" }, client)
     end
 
+    # Returns the users blocked by this user
+    #
+    # @return [Layer::RelationProxy] the users the user blocks
+    # @!macro platform-api
     def blocks
       RelationProxy.new(self, Block, [Operations::Create, Operations::List, Operations::Delete]) do
         def from_response(response, client)
@@ -19,5 +23,42 @@ module Layer
       end
     end
 
+    # Returns the identity object for this user
+    #
+    # @return [Layer::RelationProxy] identity object
+    # @!macro platform-api
+    def identity
+      SingletonRelationProxy.new(self, Layer::Identity) do
+        def from_response(response, client)
+          response['url'] ||= "#{base.url}#{resource_type.url}"
+          super
+        end
+
+        def create(attributes, client = self.client)
+          client.post(url, attributes)
+          fetch
+        end
+
+        def delete(client = self.client)
+          client.delete(url)
+        end
+      end
+    end
+
+    # Returns the user's conversations
+    #
+    # @return [Layer::RelationProxy] the user's conversations
+    # @!macro platform-api
+    def conversations
+      RelationProxy.new(self, Conversation, [Operations::List, Operations::Find])
+    end
+
+    # Returns the user's messages
+    #
+    # @return [Layer::RelationProxy] the user's messages
+    # @!macro platform-api
+    def messages
+      RelationProxy.new(self, Message, [Operations::Find])
+    end
   end
 end

data/lib/layer/version.rb

@@ -1,3 +1,3 @@
 module Layer
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

data/lib/layer/webhook.rb

@@ -1,13 +1,13 @@
 module Layer
   # @example
   #   webhook = Layer::Webhook.create({
-  #     target_config: { foo: :bar },
+  #     version: '1.0',
+  #     target_url: 'https://example.com/layer/webhook',
+  #     events: ['message.sent'],
   #     secret: 'my-secret',
-  #     event_types: ['message.sent'],
-  #     target_url: 'http://example.com/layer/webhook'
+  #     config: { foo: :bar }
   #   })
-  # @see https://gist.github.com/vtrehan/9ef1e16db5e74305ddf3 Layer Webhook documentation (Prerelease)
-  # @note This feature is still in beta at Layer. Please contact Layer to enable webhooks for your account.
+  # @see https://developer.layer.com/docs/webhooks/introduction
   #
   # @!macro platform-api
   class Webhook < Resource

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: layer-ruby
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Benedikt Deicke
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-02-02 00:00:00.000000000 Z
+date: 2016-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -109,11 +109,13 @@ files:
 - lib/layer/content.rb
 - lib/layer/conversation.rb
 - lib/layer/exceptions.rb
+- lib/layer/identity.rb
 - lib/layer/message.rb
 - lib/layer/operations.rb
 - lib/layer/operations/create.rb
 - lib/layer/operations/delete.rb
 - lib/layer/operations/destroy.rb
+- lib/layer/operations/fetch.rb
 - lib/layer/operations/find.rb
 - lib/layer/operations/list.rb
 - lib/layer/operations/paginate.rb
@@ -126,6 +128,7 @@ files:
 - lib/layer/resource.rb
 - lib/layer/resource_collection.rb
 - lib/layer/ruby.rb
+- lib/layer/singleton_relation_proxy.rb
 - lib/layer/user.rb
 - lib/layer/version.rb
 - lib/layer/webhook.rb
@@ -149,7 +152,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Ruby bindings for the Layer Platform API