trailer_vote-api 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3eeb024b539fc6f3d91d8b8b7b0856ace8176c2f
-  data.tar.gz: 824f168e749e1adfd15dad052391d94a07543543
+  metadata.gz: b341c5f1af4fab01aaa581d934e82ca906802831
+  data.tar.gz: 84d7734f7f69b71c192436a6c990926f0849ec5d
 SHA512:
-  metadata.gz: 2c6249c188cab7e34fa49506fd9b96fb40a7d28d98356a124b77ef60ef1f452e3122aff23e7d7decce052a731621cd3c43bdfba90346e782db92a90e3162db0c
-  data.tar.gz: b43f3f1c5bb2d5b81ff61f248d1bdc343e198520f1dfce694afbae6b5208f74c0a0e9db389625b6810bd02212423da4de5348840fb1cfdc0fc26e4b35dcf76e1
+  metadata.gz: 46a655c726b94de729886ce610e6d0271ec75622a712656a680b5dd410a0519a07ae354cffb40f2b0df62e07561e17a65bf3b14dbeb8ac197897445257776904
+  data.tar.gz: 359f30bbb77df6eaf57617c5cd3007bc6b67156f35099281857f97eab8e5a92f0633e259105511d6dd6a88bb9d50e67dbfc8bba9c028b9710d08e89d96afb91a

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+# 0.7.0
+
+- Guards network errors during all API calls
+- Add `NetworkError` and the subclasses `TimeoutError`, `ConnectionError`
+- Add `back` links to most API calls
+- Add `MediaTypeUnknown` error for decoding (and encoding) unknown media types
+- Add `application/json` fallback support for hostile server responses
+- Add `text/html` fallback support
+- Fix a bug with a missing `product` attribute
+- Fix an unsupported media type causing `ErrorsResponse` to break
+
 # 0.6.1
 
 - Always coerce body into string first because `Oj` might choke on chunked body.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    trailer_vote-api (0.6.1)
+    trailer_vote-api (0.7.0)
       http (>= 3.3.0, < 4.x)
       oj (>= 3.6, < 4.x)
       trailer_vote-media_types (>= 0.6.1, < 1)

data/lib/trailer_vote/api.rb

@@ -7,6 +7,7 @@ HTTP_KLAZZ = HTTP.use(:auto_inflate)
 
 require 'trailer_vote/api/version'
 require 'trailer_vote/api/type_registry'
+require 'trailer_vote/api/fallback_content_types'
 require 'trailer_vote/api/errors'
 require 'trailer_vote/api/configuration'
 

data/lib/trailer_vote/api/autoload.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'trailer_vote/api'
+
 require 'trailer_vote/api/place'
 require 'trailer_vote/api/place/create'
 require 'trailer_vote/api/place/find'
@@ -8,8 +9,11 @@ require 'trailer_vote/api/product'
 require 'trailer_vote/api/product/create'
 require 'trailer_vote/api/product/find'
 require 'trailer_vote/api/product/lookup'
+require 'trailer_vote/api/product/image'
 require 'trailer_vote/api/product/image/create'
 require 'trailer_vote/api/product/image/find'
+require 'trailer_vote/api/product/place'
 require 'trailer_vote/api/product/place/link'
+require 'trailer_vote/api/product/video'
 require 'trailer_vote/api/product/video/create'
 require 'trailer_vote/api/product/video/find'

data/lib/trailer_vote/api/composable/common.rb

@@ -13,6 +13,10 @@ module TrailerVote
           end
         end
 
+        # Execute the call (and all dependent calls)
+        #
+        # @see #forward_klazz
+        # @see #redirect_klazz
         def call(**_opts)
           raise format('Missing implementation of #args in %<name>s', self.class.name)
         end
@@ -23,14 +27,40 @@ module TrailerVote
           configuration.client
         end
 
+        # Class used to branch forward to in case of a HTTP 307 or 308.
+        #
+        # @see #branch
+        # @see #forward
+        #
+        # @private
+        # @return [Class]
         def forward_klazz
           self.class
         end
 
+        # Class used to branch redirect to in case of a HTTP 200, 201, 204, 301, 302, 303 or 304.
+        #
+        # When the status does not allow for redirecting, instead sends the retrieved result to the redirected class.
+        #
+        # @see #branch
+        # @see #redirect
+        #
+        # @private
+        # @return [Class]
         def redirect_klazz
           self.class
         end
 
+        def guard_network_errors
+          yield
+        rescue HTTP::ConnectionError => err
+          raise ConnectionError, err
+        rescue HTTP::TimeoutError => err
+          raise TimeoutError, err
+        rescue HTTP::Error => err
+          raise NetworkError, err
+        end
+
         def branch(result, data: nil)
           raise_on_error(result)
           forward(result, data: data) || redirect(result)

data/lib/trailer_vote/api/composable/get.rb

@@ -14,23 +14,35 @@ module TrailerVote
           end
         end
 
+        # Return the {Links} for the result
+        # @return [Links] the links
         def links
           # TODO: or headers
           @links ||= Links.new(data['_links'])
         end
 
+        # Decode the result via {TypeRegistry}. This also takes care of MediaTypes validation.
+        #
+        # @see #decode
+        # @return [Hash, Array] the decoded response
         def to_h
           @to_h ||= TrailerVote::Api.decode(call.result)
         end
 
+        # Return the HTTP status
+        # @return [Numeric] the HTTP status
         def to_i
           call.result.status
         end
 
+        # Return the ETag value
+        # @return [String, NilClass] the etag or nil
         def etag
           call.result[Headers::ETAG]
         end
 
+        # Return the decoded result inner object
+        # @return [Object] the inner object
         def data
           raise format('Missing implementation of #data in %<name>s', self.class.name)
         end

data/lib/trailer_vote/api/configuration.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'trailer_vote/media_types'
 require 'trailer_vote/api/composable/get'
 
 module TrailerVote
@@ -34,8 +35,9 @@ module TrailerVote
 
       def call(url: resolve_url)
         return self if ok? || !url
-        merge(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
-        # TODO: result.raise_for_status
+        guard_network_errors do
+          merge(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+        end
       end
 
       private

data/lib/trailer_vote/api/errors.rb

@@ -1,9 +1,15 @@
 # frozen_string_literal: true
 
+require 'trailer_vote/media_types'
+
 module TrailerVote
   module Api
 
     class Error < RuntimeError; end
+    class UnknownMediaType < Error; end
+    class NetworkError < Error; end
+    class ConnectionError < NetworkError; end
+    class TimeoutError < NetworkError; end
 
     class EncodeError < Error
       def initialize(media_type:, source:)
@@ -47,7 +53,7 @@ module TrailerVote
 
       def data
         @data ||= TrailerVote::Api.decode(result)
-      rescue DecodeError
+      rescue DecodeError, UnknownMediaType
         # noinspection RubyStringKeysInHashInspection
         @data = { 'errors' => [{ 'message': result.status.reason }] }
       end

data/lib/trailer_vote/api/fallback_content_types.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'oj'
+require 'trailer_vote/api/type_registry'
+
+module TrailerVote
+  module Api
+    module JsonTypeAdapter
+      module_function
+
+      def encode(obj)
+        Oj.dump(obj, mode: :compat)
+      rescue Oj::Error => err
+        raise EncodeError.new(media_type: 'application/json', source: err)
+      end
+
+      def decode(obj)
+        Oj.load(obj, mode: :strict)
+      rescue Oj::Error => err
+        raise DecodeError.new(media_type: 'application/json', source: err)
+      end
+    end
+  end
+end
+
+TrailerVote::Api::TypeRegistry['application/json'] = TrailerVote::Api::JsonTypeAdapter
+TrailerVote::Api::TypeRegistry.shortcut('application/json', :json)
+TrailerVote::Api::TypeRegistry.shortcut('application/json', 'text/json')
+
+module TrailerVote
+  module Api
+    module HtmlTypeAdapter
+      module_function
+
+      def encode(obj)
+        return obj if obj.is_a?(String)
+        raise EncodeError.new(
+          media_type: 'text/html',
+          source: ArgumentError.new('HTML must be passed in as a HTML string')
+        )
+      end
+
+      def decode(str)
+        str
+      end
+    end
+  end
+end
+
+TrailerVote::Api::TypeRegistry['text/html'] = TrailerVote::Api::HtmlTypeAdapter

data/lib/trailer_vote/api/links.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module TrailerVote
   module Api
     class Links

data/lib/trailer_vote/api/place.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'trailer_vote/media_types'
 require 'trailer_vote/api/configuration'
 
 module TrailerVote
@@ -9,6 +10,10 @@ module TrailerVote
         self.configuration = configuration
       end
 
+      def back
+        configuration
+      end
+
       private
 
       attr_accessor :configuration

data/lib/trailer_vote/api/place/create.rb

@@ -8,6 +8,8 @@ module TrailerVote
   module Api
     class Place
       class Find
+
+        # @return [TrailerVote::Api::Place::Create] the api to create a child place
         def create
           Create.new(configuration: configuration, place: self)
         end
@@ -22,20 +24,36 @@ module TrailerVote
 
         ACCEPT = [SUCCESS.to_s, FAILURE.to_s(0.1)].join(', ').freeze
 
+        # @private
         def initialize(configuration:, place:)
           self.configuration = configuration
           self.place = place
         end
 
+        # @return [TrailerVote::Api::Place::Find] the found place
+        def back
+          place
+        end
+
+        # Create a place
+        #
+        # @see https://www.rubydoc.info/gems/trailer_vote-media_types/TrailerVote/MediaTypes/Place TrailerVote::MediaTypes::Place
+        #
+        # @param [String, Hash] data the data conform to the Place media type
+        # @param [String] url (#resolve_url result) the url to post to
+        #
+        # @return [TrailerVote::Api::Place::Find]
         def call(data:, url: resolve_url)
-          body = encode(data)
-          branch(
-            resolve_client.headers(
-              Headers::ACCEPT => ACCEPT,
-              Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
-            ).post(url, body: body),
-            data: data
-          )
+          guard_network_errors do
+            body = encode(data)
+            branch(
+              resolve_client.headers(
+                Headers::ACCEPT => ACCEPT,
+                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
+              ).post(url, body: body),
+              data: data
+            )
+          end
         end
 
         private

data/lib/trailer_vote/api/place/find.rb

@@ -6,6 +6,8 @@ require 'trailer_vote/api/place'
 module TrailerVote
   module Api
     class Configuration
+
+      # @return [TrailerVote::Api::Place::Find] the root place attached to the credentials
       def place
         Place::Find.new(configuration: self)
       end
@@ -25,10 +27,18 @@ module TrailerVote
           self.result = result
         end
 
+        # @return [TrailerVote::Api::Configuration, TrailerVote::Api::Place::Create]
+        def back
+          backtrack = result
+          backtrack = result.back while backtrack&.is_a?(self.class)
+          backtrack || configuration
+        end
+
         def call(url: resolve_url)
-          puts url
           return self if ok? || !url
-          branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+          guard_network_errors do
+            branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+          end
         end
 
         def resolve_url

data/lib/trailer_vote/api/product.rb

@@ -1,13 +1,17 @@
 # frozen_string_literal: true
 
+require 'trailer_vote/media_types'
 require 'trailer_vote/api/configuration'
 
 module TrailerVote
   module Api
     class Configuration
+      # @return [TrailerVote::Api::Product] api to deal with products
       def product
         Product.new(configuration: self)
       end
+
+      alias products product
     end
 
     class Product
@@ -15,6 +19,10 @@ module TrailerVote
         self.configuration = configuration
       end
 
+      def back
+        configuration
+      end
+
       private
 
       attr_accessor :configuration

data/lib/trailer_vote/api/product/create.rb

@@ -8,7 +8,7 @@ require 'trailer_vote/api/product/find'
 module TrailerVote
   module Api
     class Product
-
+      # @return [TrailerVote::Api::Product::Create] api to create a new product
       def create
         Create.new(configuration: configuration)
       end
@@ -26,15 +26,22 @@ module TrailerVote
           self.configuration = configuration
         end
 
+        # @return [TrailerVote::Api::Product] api to deal with products
+        def back
+          configuration.product
+        end
+
         def call(data:, url: resolve_url)
           body = encode(data)
-          branch(
-            resolve_client.headers(
-              Headers::ACCEPT => ACCEPT,
-              Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
-            ).post(url, body: body),
-            data: data
-          )
+          guard_network_errors do
+            branch(
+              resolve_client.headers(
+                Headers::ACCEPT => ACCEPT,
+                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
+              ).post(url, body: body),
+              data: data
+            )
+          end
         end
 
         private

data/lib/trailer_vote/api/product/find.rb

@@ -6,7 +6,12 @@ require 'trailer_vote/api/product'
 module TrailerVote
   module Api
     class Product
-
+      # @param [TrailerVote::Api::Product::Find,
+      #   TrailerVote::Api::Product::Create,
+      #   TrailerVote::Api::Product::Update,
+      #   TrailerVote::Api::Product::Lookup,
+      #   NilClass] result the found product
+      # @return [TrailerVote::Api::Product::Find] api to deal with a found product
       def find(result: nil)
         Find.new(configuration: configuration, result: result)
       end
@@ -23,9 +28,22 @@ module TrailerVote
           self.result = result
         end
 
+        # @return [TrailerVote::Api::Product::Find,
+        #   TrailerVote::Api::Product::Create,
+        #   TrailerVote::Api::Product::Update,
+        #   TrailerVote::Api::Product::Lookup,
+        #   NilClass] return the api that yielded this
+        def back
+          backtrack = result
+          backtrack = result.back while backtrack&.is_a?(self.class)
+          backtrack
+        end
+
         def call(url: nil, data: nil)
           return self if ok? || !url
-          branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url), data: data)
+          guard_network_errors do
+            branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url), data: data)
+          end
         end
 
         def data

data/lib/trailer_vote/api/product/image.rb

@@ -7,11 +7,13 @@ module TrailerVote
   module Api
     class Product
       class Find
+        # @return [TrailerVote::Api::Product::Image] api to deal with a product's images
         def image
           Image.new(configuration: configuration, product: self)
         end
 
         alias product_image image
+        alias images image
       end
 
       class Image
@@ -20,6 +22,11 @@ module TrailerVote
           self.product = product
         end
 
+        # @return [TrailerVote::Api::Product::Find] api to deal with a found product
+        def back
+          product
+        end
+
         private
 
         attr_accessor :configuration, :product

data/lib/trailer_vote/api/product/image/create.rb

@@ -9,6 +9,8 @@ module TrailerVote
   module Api
     class Product
       class Image
+
+        # @return [TrailerVote::Api::Product::Image::Create] the api to create an image for the current +product+
         def create
           Create.new(configuration: configuration, product: product)
         end
@@ -27,15 +29,30 @@ module TrailerVote
             self.product = product
           end
 
+          # @return [TrailerVote::Api::Product::Image] the api to deal with the current +product+ images
+          def back
+            product.image
+          end
+
+          # Create the image
+          #
+          # @see https://www.rubydoc.info/gems/trailer_vote-media_types/TrailerVote/MediaTypes/ProductImage TrailerVote::MediaTypes::ProductImage
+          #
+          # @param [String] url (#resolve_url result) the url to post to
+          # @param [Hash] data the image data
+          #
+          # @return [TrailerVote::Api::Product::Image::Find]
           def call(data:, url: resolve_url)
             body = encode(data)
-            branch(
-              resolve_client.headers(
-                Headers::ACCEPT => ACCEPT,
-                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
-              ).post(url, body: body),
-              data: data
-            )
+            guard_network_errors do
+              branch(
+                resolve_client.headers(
+                  Headers::ACCEPT => ACCEPT,
+                  Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
+                ).post(url, body: body),
+                data: data
+              )
+            end
           end
 
           private

data/lib/trailer_vote/api/product/image/find.rb

@@ -7,6 +7,12 @@ module TrailerVote
   module Api
     class Product
       class Image
+
+        # @param [TrailerVote::Api::Product::Image::Find,
+        #   TrailerVote::Api::Product::Image::Create,
+        #   TrailerVote::Api::Product::Image::Urls::Traverse,
+        #   NilClass] result the found image, or nil
+        # @return [TrailerVote::Api::Product::Image::Find] the api to deal with the found image
         def find(result: nil)
           Find.new(configuration: configuration, result: result)
         end
@@ -24,6 +30,15 @@ module TrailerVote
             self.result = result
           end
 
+          # @return [TrailerVote::Api::Product::Image::Create,
+          #   TrailerVote::Api::Product::Image::Urls::Traverse,
+          #   NilClass] return the api that yielded this
+          def back
+            backtrack = result
+            backtrack = result.back while backtrack&.is_a?(self.class)
+            backtrack
+          end
+
           def call(url: nil)
             return self if ok? || !url
             branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))

data/lib/trailer_vote/api/product/image/urls.rb

@@ -7,6 +7,8 @@ module TrailerVote
   module Api
     class Product
       class Image
+
+        # @return [TrailerVote::Api::Product::Image::Urls] the api to get the image urls for the current product
         def urls
           Urls.new(configuration: configuration, product: product)
         end
@@ -25,9 +27,16 @@ module TrailerVote
             self.result = result
           end
 
+          # @return [TrailerVote::Api::Product::Image] the api to deal with a product's images
+          def back
+            product.image
+          end
+
           def call(url: resolve_url)
             return self if ok? || !url
-            branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+            guard_network_errors do
+              branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+            end
           end
 
           def data

data/lib/trailer_vote/api/product/lookup.rb

@@ -7,8 +7,17 @@ require 'trailer_vote/api/product/find'
 
 module TrailerVote
   module Api
+
+    class Configuration
+      # @return [TrailerVote::Api::Product::Lookup] api to deal with looking up a product
+      def product_lookup
+        product.lookup
+      end
+    end
+
     class Product
 
+      # @return [TrailerVote::Api::Product::Lookup] api to deal with looking up a product
       def lookup
         Lookup.new(configuration: configuration)
       end
@@ -49,15 +58,22 @@ module TrailerVote
           self.configuration = configuration
         end
 
+        # @return [TrailerVote::Api::Product] api to deal with products
+        def back
+          configuration.product
+        end
+
         def call(data:, url: resolve_url)
           body = encode(data)
-          branch(
-            resolve_client.headers(
-              Headers::ACCEPT => ACCEPT,
-              Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
-            ).post(url, body: body),
-            data: data
-          )
+          guard_network_errors do
+            branch(
+              resolve_client.headers(
+                Headers::ACCEPT => ACCEPT,
+                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
+              ).post(url, body: body),
+              data: data
+            )
+          end
         end
 
         private

data/lib/trailer_vote/api/product/place.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'trailer_vote/media_types'
+
 require 'trailer_vote/api/product'
 require 'trailer_vote/api/product/find'
 
@@ -7,11 +9,13 @@ module TrailerVote
   module Api
     class Product
       class Find
+        # @return [TrailerVote::Api::Place] api to deal with a product's places
         def place
           Place.new(configuration: configuration, product: self)
         end
 
         alias product_place place
+        alias places place
       end
 
       class Place
@@ -20,6 +24,11 @@ module TrailerVote
           self.product = product
         end
 
+        # @return [TrailerVote::Api::Place::Find] api to deal with a found product
+        def back
+          product
+        end
+
         private
 
         attr_accessor :configuration, :product

data/lib/trailer_vote/api/product/place/link.rb

@@ -9,6 +9,8 @@ module TrailerVote
   module Api
     class Product
       class Place
+
+        # @return [TrailerVote::Api::Product::Place::Link] api to link a place to the current +product+
         def link
           Link.new(configuration: configuration, product: product)
         end
@@ -27,19 +29,28 @@ module TrailerVote
             self.product = product
           end
 
+          # @return [TrailerVote::Api::Product::Place] the api to deal with the product places
+          def back
+            product.place
+          end
+
           def call(data:, url: resolve_url)
             body = encode(data)
-            branch(
-              resolve_client.headers(
-                Headers::ACCEPT => ACCEPT,
-                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
-              ).post(url, body: body),
-              data: data
-            )
+            guard_network_errors do
+              branch(
+                resolve_client.headers(
+                  Headers::ACCEPT => ACCEPT,
+                  Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
+                ).post(url, body: body),
+                data: data
+              )
+            end
           end
 
           private
 
+          attr_accessor :product
+
           def resolve_url
             product.links.places
           end

data/lib/trailer_vote/api/product/update.rb

@@ -9,6 +9,7 @@ module TrailerVote
   module Api
     class Product
       class Find
+        # @return [TrailerVote::Api::Product::Update] api to deal with a updating a found product
         def update
           Update.new(configuration: configuration, product: self)
         end
@@ -28,16 +29,23 @@ module TrailerVote
           self.product = product
         end
 
+        # @return [TrailerVote::Api::Product::Find] api to deal with a found product
+        def back
+          product
+        end
+
         def call(data:, url: resolve_url, etag: resolve_etag)
           body = encode(data)
-          branch(
-            resolve_client.headers(
-              Headers::ACCEPT => ACCEPT,
-              Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}",
-              Headers::IF_MATCH => etag
-            ).put(url, body: body),
-            data: data
-          )
+          guard_network_errors do
+            branch(
+              resolve_client.headers(
+                Headers::ACCEPT => ACCEPT,
+                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}",
+                Headers::IF_MATCH => etag
+              ).put(url, body: body),
+              data: data
+            )
+          end
         end
 
         private

data/lib/trailer_vote/api/product/video.rb

@@ -7,11 +7,13 @@ module TrailerVote
   module Api
     class Product
       class Find
+        # @return [TrailerVote::Api::Product::Video] api to deal with a product's videos
         def video
           Video.new(configuration: configuration, product: self)
         end
 
         alias product_video video
+        alias videos video
       end
 
       class Video
@@ -20,6 +22,11 @@ module TrailerVote
           self.product = product
         end
 
+        # @return [TrailerVote::Api::Product::Find] api to deal with a found product
+        def back
+          product
+        end
+
         private
 
         attr_accessor :configuration, :product

data/lib/trailer_vote/api/product/video/create.rb

@@ -27,15 +27,29 @@ module TrailerVote
             self.product = product
           end
 
+          def back
+            product.video
+          end
+
+          # Create the image
+          #
+          # @see https://www.rubydoc.info/gems/trailer_vote-media_types/TrailerVote/MediaTypes/ProductImage TrailerVote::MediaTypes::ProductImage
+          #
+          # @param [String] url (#resolve_url result) the url to post to
+          # @param [Hash] data the image data
+          #
+          # @return [TrailerVote::Api::Product::Video::Find]
           def call(data:, url: resolve_url)
             body = encode(data)
-            branch(
-              resolve_client.headers(
-                Headers::ACCEPT => ACCEPT,
-                Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
-              ).post(url, body: body),
-              data: data
-            )
+            guard_network_errors do
+              branch(
+                resolve_client.headers(
+                  Headers::ACCEPT => ACCEPT,
+                  Headers::CONTENT_TYPE => "#{CONTENT}; charset=#{body.encoding.name}"
+                ).post(url, body: body),
+                data: data
+              )
+            end
           end
 
           private

data/lib/trailer_vote/api/product/video/find.rb

@@ -7,6 +7,12 @@ module TrailerVote
   module Api
     class Product
       class Video
+
+        # @param [TrailerVote::Api::Product::Video::Find,
+        #   TrailerVote::Api::Product::Video::Create,
+        #   TrailerVote::Api::Product::Video::Urls::Traverse,
+        #   NilClass] result the found video, or nil
+        # @return [TrailerVote::Api::Product::Video::Find] the api to deal with the found video
         def find(result: nil)
           Find.new(configuration: configuration, result: result)
         end
@@ -24,9 +30,20 @@ module TrailerVote
             self.result = result
           end
 
+          # @return [TrailerVote::Api::Product::Video::Create,
+          #   TrailerVote::Api::Product::Video::Urls::Traverse,
+          #   NilClass] return the api that yielded this
+          def back
+            backtrack = result
+            backtrack = result.back while backtrack&.is_a?(self.class)
+            backtrack
+          end
+
           def call(url: nil)
             return self if ok? || !url
-            branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+            guard_network_errors do
+              branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+            end
           end
 
           def data

data/lib/trailer_vote/api/product/video/urls.rb

@@ -7,6 +7,8 @@ module TrailerVote
   module Api
     class Product
       class Video
+
+        # @return [TrailerVote::Api::Product::Video::Urls] the api to get the video urls for the current product
         def urls
           Urls.new(configuration: configuration, product: product)
         end
@@ -25,9 +27,16 @@ module TrailerVote
             self.result = result
           end
 
+          # @return [TrailerVote::Api::Product::Video] the api to deal with a product's videos
+          def back
+            product.video
+          end
+
           def call(url: resolve_url)
             return self if ok? || !url
-            branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+            guard_network_errors do
+              branch(resolve_client.headers(Headers::ACCEPT => ACCEPT).get(url))
+            end
           end
 
           def data

data/lib/trailer_vote/api/type_registry.rb

@@ -19,6 +19,8 @@ module TrailerVote
 
       def [](key)
         registry.fetch(key) { registry.fetch(registry_shortcuts.fetch(key)) }
+      rescue KeyError
+        raise UnknownMediaType, format('Unknown media type %<type>s', type: key)
       end
 
       def []=(key, value)

data/lib/trailer_vote/api/version.rb

@@ -2,6 +2,6 @@
 
 module TrailerVote
   module Api
-    VERSION = '0.6.1'
+    VERSION = '0.7.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trailer_vote-api
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Derk-Jan Karrenbeld
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-07 00:00:00.000000000 Z
+date: 2018-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -204,6 +204,7 @@ files:
 - lib/trailer_vote/api/composable/get.rb
 - lib/trailer_vote/api/configuration.rb
 - lib/trailer_vote/api/errors.rb
+- lib/trailer_vote/api/fallback_content_types.rb
 - lib/trailer_vote/api/links.rb
 - lib/trailer_vote/api/place.rb
 - lib/trailer_vote/api/place/create.rb