bliss-client 1.2.0

data/lib/bliss-client.rb

@@ -0,0 +1 @@
+require 'bliss/client'

data/lib/bliss/client.rb

@@ -0,0 +1,97 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'typhoeus/adapters/faraday'
+require 'virtus'
+require 'active_model'
+
+require_relative 'client/version'
+require_relative 'client/validation'
+require_relative 'client/item'
+require_relative 'client/address'
+require_relative 'client/order'
+require_relative 'client/size'
+require_relative 'client/article'
+require_relative 'client/style'
+require_relative 'client/color'
+require_relative 'client/program'
+require_relative 'client/look_item'
+require_relative 'client/look'
+require_relative 'client/collection'
+
+module Bliss
+  module Client
+    module_function
+
+    ADAPTER = :typhoeus
+    API_VERSION = ENV['BLISS_API_VERSION'] || 'v1'
+    TOKEN_PATH = '/oauth/token'
+
+    def connection
+      @connection = nil if test?
+
+      @connection ||= Faraday.new(url: api_url) do |f|
+        f.request :oauth2, token unless skip_auth?
+        f.request :json
+        f.response :json, content_type: /\bjson$/
+        if debug?
+          f.response :logger
+        end
+        f.adapter ADAPTER
+      end
+    end
+
+    def token
+      # Fetch the token every time when testing, so that VCR can expect this
+      # request to happen.
+      @token = nil if test?
+
+      @token ||= begin
+        connection = Faraday.new(url: server) do |f|
+          f.request :json
+          f.response :json, content_type: /\bjson$/
+          if debug?
+            f.response :logger
+          end
+          f.adapter ADAPTER
+        end
+
+        response = connection.post(
+          TOKEN_PATH,
+          grant_type: 'client_credentials',
+          client_id: client_id,
+          client_secret: client_secret
+        )
+
+        response.body.fetch('access_token')
+      end
+    end
+
+    def api_url
+      "#{server}/api/#{API_VERSION}"
+    end
+
+    def server
+      ENV['BLISS_SERVER']
+    end
+
+    def client_id
+      ENV['BLISS_CLIENT_ID']
+    end
+
+    def client_secret
+      ENV['BLISS_CLIENT_SECRET']
+    end
+
+    def debug?
+      ENV['BLISS_CLIENT_DEBUG']
+    end
+
+    def test?
+      ENV['BLISS_CLIENT_ENV'] == 'test'
+    end
+
+    def skip_auth?
+      ENV['BLISS_CLIENT_SKIP_AUTH'] == 'true'
+    end
+  end
+end

data/lib/bliss/client/address.rb

@@ -0,0 +1,21 @@
+module Bliss
+  module Client
+    class Address
+      include Virtus.value_object
+      include Validation
+
+      values do
+        attribute :salutation, String
+        attribute :line_1, String
+        attribute :line_2, String
+        attribute :line_3, String
+        attribute :zip_code, String
+        attribute :city, String
+        attribute :country_iso3, String
+      end
+
+      validates_presence_of :salutation, :line_1, :zip_code, :city,
+        :country_iso3
+    end
+  end
+end

data/lib/bliss/client/article.rb

@@ -0,0 +1,17 @@
+module Bliss
+  module Client
+    class Article
+      include Virtus.model
+
+      attribute :id, Integer
+      attribute :ean, String
+      attribute :color_name, String
+      attribute :size_name, String
+      attribute :style_name, String
+      attribute :legacy_id, Integer
+      attribute :color_id, Integer
+      attribute :size_id, Integer
+      attribute :style_id, Integer
+    end
+  end
+end

data/lib/bliss/client/collection.rb

@@ -0,0 +1,86 @@
+module Bliss
+  module Client
+    class Collection
+      include Virtus.model
+
+      attribute :id, Integer
+      attribute :name, String
+      attribute :year, Integer
+      attribute :season, Integer
+      attribute :men, Boolean
+
+      attribute :programs, Array[Program]
+
+      def self.all
+        response = Client.connection.get('collections')
+        if response.success?
+          response.body.map { |attr| new attr }
+        else
+          raise JSON.parse(response.body).fetch('message')
+        end
+      end
+
+      # Fetch collections and their children.
+      #
+      # @param [Array<Integer>] ids The ids of the collections to fetch
+      # @param [Hash] options
+      # @option options [Boolean] (false) :include_programs Whether to fetch
+      #   programs for each collection
+      # @option options [Boolean] (false) :include_colors Whether to fetch
+      #   colors for each program
+      # @option options [Boolean] (false) :include_styles Whether to fetch
+      #   styles for each program
+      # @option options [Boolean] (false) :include_articles Whether to fetch
+      #   articles for each style
+      # @option options [Boolean] (false) :include_prices Whether to fetch
+      #   prices for each style
+      #
+      # @return [Array<Collection>]
+      #
+      # @example Fetch collections 88 and 90 with programs, styles and prices
+      #   collections = Bliss::Client::Collection.find(
+      #     [88, 90],
+      #     include_programs: true,
+      #     include_styles: true,
+      #     include_prices: true
+      #   )
+      #
+      def self.find(ids, options = {})
+        options = {
+          include_programs: false,
+          include_styles: false,
+          include_articles: false,
+          include_colors: false,
+          include_prices: false
+        }.merge(options)
+
+        c = Client.connection
+        responses_hash = {}
+
+        c.in_parallel do
+          ids.each do |id|
+            responses_hash[id] = c.get("collections/#{id}", options)
+          end
+        end
+
+        responses = responses_hash.values
+
+        if (failed_response = responses.find { |r| !r.success? })
+          raise JSON.parse(failed_response.body).fetch('message')
+        end
+
+        responses.map { |r| new r.body }
+      end
+
+      # @return [Array<Look>] All keylooks for this collection
+      def keylooks
+        @keylooks ||= Look.for_collection(id, type: :keylook)
+      end
+
+      # @return [Array<Look>] All studiolooks for this collection
+      def studiolooks
+        @studiolooks ||= Look.for_collection(id, type: :studiolook)
+      end
+    end
+  end
+end

data/lib/bliss/client/color.rb

@@ -0,0 +1,12 @@
+module Bliss
+  module Client
+    class Color
+      include Virtus.model
+
+      attribute :id, Integer
+      attribute :name, String
+      attribute :rank, Integer
+      attribute :program_id, Integer
+    end
+  end
+end

data/lib/bliss/client/item.rb

@@ -0,0 +1,16 @@
+module Bliss
+  module Client
+    class Item
+      include Virtus.model
+      include Validation
+
+      attribute :article_id, Integer
+      attribute :price_value, BigDecimal
+      attribute :price_currency, String
+      attribute :quantity, Integer
+
+      validates_presence_of :article_id, :price_value, :price_currency,
+        :quantity
+    end
+  end
+end

data/lib/bliss/client/look.rb

@@ -0,0 +1,63 @@
+module Bliss
+  module Client
+    class Look
+      include Virtus.model
+
+      attribute :id, Integer
+      attribute :number, String
+      attribute :photo, String
+      attribute :collection_id, Integer
+      attribute :descriptions, Hash
+
+      attribute :items, Array[LookItem]
+
+      RESOURCES = {
+        keylook: 'keylooks',
+        studiolook: 'studiolooks'
+      }
+
+      # Fetch looks for a collection.
+      #
+      # @param [Integer] collection_id The id of the collection
+      # @param [Hash] args
+      # @option args [Symbol] :type Which kind of look to fetch; either
+      #   :keylook or :studiolook
+      #
+      # @return [Array<Look>]
+      #
+      # @example Fetch all keylooks for the collection with id 88
+      #   Bliss::Client::Look.for_collection(88, type: :keylook)
+      #
+      def self.for_collection(collection_id, args)
+        resource = RESOURCES.fetch(args.fetch(:type).to_sym)
+        url = "collections/#{collection_id}/#{resource}"
+
+        response = Client.connection.get url
+
+        if response.success?
+          response.body.map { |attr| new attr }
+        else
+          raise JSON.parse(response.body).fetch('message')
+        end
+      end
+
+      # Get description in language.
+      #
+      # @param [Symbol] language ISO 639-1 two-letter languange code
+      # @return [String] description of this look in the requested language
+      #
+      # @example Get English description
+      #   look.description(:en) # => "Super trendy-wendy look combining yada..."
+      def description(language)
+        descriptions.fetch(language.to_s.downcase)
+      rescue KeyError
+        raise ArgumentError, %{
+          No description found in language: "#{language}".
+
+          Make sure "#{language}" is a valid ISO 639-1 two-letter code.
+          See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+        }
+      end
+    end
+  end
+end

data/lib/bliss/client/look_item.rb

@@ -0,0 +1,12 @@
+module Bliss
+  module Client
+    class LookItem
+      include Virtus.model
+
+      attribute :style_description, String
+      attribute :color_name, String
+      attribute :style_id, Integer
+      attribute :color_id, Integer
+    end
+  end
+end

data/lib/bliss/client/order.rb

@@ -0,0 +1,52 @@
+module Bliss
+  module Client
+    class Order
+      include Virtus.model
+      include Validation
+
+      attribute :id, Integer
+      attribute :type, String
+      attribute :items, Array[Item]
+      attribute :delivery_address, Address
+      attribute :remote_id, Integer
+      attribute :blizzard_customer_id, Integer
+      attribute :created_at, DateTime
+
+      validates_presence_of :type, :items, :delivery_address,
+        :remote_id, :blizzard_customer_id
+
+      def self.create(attributes)
+        order = new(attributes)
+        order.create
+        order
+      end
+
+      def create
+        validate!
+
+        response = Client.connection.post(
+          'orders',
+          blizzard_customer_id: blizzard_customer_id,
+          type: type,
+          items: items.map(&:attributes),
+          delivery_address: delivery_address.attributes,
+          remote_id: remote_id
+        )
+
+        if response.success?
+          body = response.body
+          self.id = body.fetch('id')
+          self.created_at = body.fetch('created_at')
+        else
+          raise JSON.parse(response.body).fetch('message')
+        end
+      end
+
+      def validate!
+        super
+        items.each &:validate!
+        delivery_address.validate!
+      end
+    end
+  end
+end

data/lib/bliss/client/program.rb

@@ -0,0 +1,14 @@
+module Bliss
+  module Client
+    class Program
+      include Virtus.model
+
+      attribute :id, Integer
+      attribute :name, String
+      attribute :collection_id, Integer
+
+      attribute :colors, Array[Color]
+      attribute :styles, Array[Style]
+    end
+  end
+end

data/lib/bliss/client/size.rb

@@ -0,0 +1,33 @@
+module Bliss
+  module Client
+    class Size
+      include Virtus.value_object
+
+      values do
+        attribute :id
+        attribute :name
+        attribute :rank
+      end
+
+      def self.all
+        @all ||= begin
+          response = Client.connection.get('sizes')
+          if response.success?
+            body = response.body
+            body.map { |attr| new attr }
+          else
+            raise JSON.parse(response.body).fetch('message')
+          end
+        end
+      end
+
+      def self.find(id)
+        all.find { |size| size.id == id }
+      end
+
+      def to_s
+        "#{rank} | #{name}"
+      end
+    end
+  end
+end

data/lib/bliss/client/style.rb

@@ -0,0 +1,77 @@
+require 'bigdecimal'
+
+module Bliss
+  module Client
+    class Style
+      include Virtus.model
+
+      attribute :id, Integer
+      attribute :number, String
+      attribute :name, String
+      attribute :treatment, String
+      attribute :form, String
+      attribute :quality, String
+      attribute :category, String
+      attribute :collection_id, Integer
+      attribute :program_id, Integer
+      attribute :prices, Hash
+
+      attribute :articles, Array[Article]
+
+      # @return [BigDecimal] the current purchase (aka wholesale) price, i.e.
+      #   the price the stores pay to buy this style from NILE
+      #
+      # @param [Symbol] currency either :eur or :chf, can also be strings
+      #   e.g. 'CHF'
+      def purchase_price(currency)
+        BigDecimal.new prices_for_currency(currency).
+          fetch('current_purchase_price')
+      end
+
+      # @return [BigDecimal] the current sales (aka retail) price, i.e. the
+      #   price the customers pay to buy this style from a store/webshop
+      #
+      # @param [Symbol] currency either :eur or :chf, can also be strings
+      #   e.g. 'CHF'
+      def sales_price(currency)
+        BigDecimal.new prices_for_currency(currency).
+          fetch('current_sales_price')
+      end
+
+      # @return [BigDecimal] the first unreduced price stores paid to purchase
+      #   this style from NILE
+      #
+      # @param [Symbol] currency either :eur or :chf, can also be strings
+      #   e.g. 'CHF'
+      def original_purchase_price(currency)
+        BigDecimal.new prices_for_currency(currency).
+          fetch('first_purchase_price')
+      end
+
+      # @return [BigDecimal] the first unreduced price customers paid to purchase
+      #   this style from a store/webshop
+      #
+      # @param [Symbol] currency either :eur or :chf, can also be strings
+      #   e.g. 'CHF'
+      def original_sales_price(currency)
+        BigDecimal.new prices_for_currency(currency).
+          fetch('first_sales_price')
+      end
+
+      # @return [Boolean] whether this style is sold for a reduced price for
+      #   the currency
+      #
+      # @param [Symbol] currency either :eur or :chf, can also be strings
+      #   e.g. 'CHF'
+      def discounted?(currency)
+        prices_for_currency(currency).fetch('current_price_rank').to_i > 1
+      end
+
+      private
+
+      def prices_for_currency(currency)
+        prices.fetch(currency.to_s.upcase)
+      end
+    end
+  end
+end