mws-connect 0.0.1

data/lib/mws/apis/feeds/image_listing.rb

@@ -0,0 +1,44 @@
+require 'open-uri'
+
+module Mws::Apis::Feeds
+
+  class ImageListing
+
+    Type = Mws::Enum.for(
+      main: 'Main',
+      alt1: 'PT1',
+      alt2: 'PT2',
+      alt3: 'PT3',
+      alt4: 'PT4',
+      alt5: 'PT5'
+    )
+
+    attr_reader :sku, :url
+
+    Mws::Enum.sym_reader self, :type
+
+    def initialize(sku, url, type=nil)
+      raise Mws::Errors::ValidationError, 'SKU is required.' if sku.nil? or sku.strip.empty?
+      @sku = sku
+      raise Mws::Errors::ValidationError, 'URL must be an unsecured http address.' unless url =~ URI::regexp('http')
+      @url = url
+      @type = Type.for(type) || Type.MAIN
+    end
+
+    def ==(other)
+      return true if equal? other
+      return false unless other.class == self.class
+      sku == other.sku and url == other.url and type == other.type
+    end
+
+    def to_xml(name='ProductImage', parent=nil)
+      Mws::Serializer.tree name, parent do | xml | 
+        xml.SKU @sku
+        xml.ImageType @type.val
+        xml.ImageLocation @url
+      end
+    end
+
+  end
+
+end

data/lib/mws/apis/feeds/inventory.rb

@@ -0,0 +1,77 @@
+module Mws::Apis::Feeds
+
+  class Inventory
+
+    attr_reader :sku, :available, :quantity, :lookup, :fulfillment, :restock
+
+    def initialize(sku, options)
+      @sku = sku
+      @available = options[:available]
+      @quantity = options[:quantity]
+      @lookup = options[:lookup]
+      @fulfillment = Fulfillment.new(
+        options[:fulfillment_center],
+        options[:fulfillment_latency],
+        options[:fulfillment_type]
+      )
+      @restock = options[:restock]
+      validate
+    end
+
+    def to_xml(name='Inventory', parent=nil)
+      Mws::Serializer.tree name, parent do |xml| 
+        xml.SKU @sku
+        xml.FulfillmentCenterID @fulfillment.center unless @fulfillment.center.nil?
+        xml.Available @available unless @available.nil?
+        xml.Quantity @quantity unless @quantity.nil?
+        xml.Lookup @lookup unless @lookup.nil?
+        xml.RestockDate @restock.iso8601 unless @restock.nil?
+        xml.FulfillmentLatency @fulfillment.latency unless @fulfillment.latency.nil?
+        xml.SwitchFulfillmentTo Fulfillment::Type.for(@fulfillment.type).val unless @fulfillment.type.nil?
+      end
+    end
+
+    class Fulfillment
+
+      Type = Mws::Enum.for afn: 'AFN', mfn: 'MFN'
+
+      attr_reader :center, :latency
+
+      Mws::Enum.sym_reader self, :type
+
+      def initialize(center, latency, type)
+        @center = center
+        @latency = latency
+        unless @latency.nil? or (@latency.to_i == @latency and @latency > 0)
+          raise Mws::Errors::ValidationError.new('Fulfillment latency must be a whole number greater than zero.')
+        end
+        @type = Type.for(type)
+        raise Mws::Errors::ValidationError.new("Fulfillment type must be either 'AFN' or 'MFN'.") if type and @type.nil?
+      end
+
+    end
+
+    private
+
+    def validate
+      raise Mws::Errors::ValidationError.new('SKU is required.') if @sku.nil? or @sku.to_s.strip.empty?
+      unless [ @available, @quantity, @lookup ].compact.size == 1
+        raise Mws::Errors::ValidationError.new("One and only one of 'available', 'quantity' or 'lookup' must be specified.")
+      end
+      unless @available.nil? or [ true, false ].include? @available
+        raise Mws::Errors::ValidationError.new('Available must be either true or false.')
+      end
+      unless @quantity.nil? or (@quantity.to_i == @quantity and @quantity >= 0)
+        raise Mws::Errors::ValidationError.new('Quantity must be a whole number greater than or equal to zero.')
+      end
+      unless @lookup.nil? or [ true, false ].include? @lookup
+        raise Mws::Errors::ValidationError.new('Lookup must be either true or false.')
+      end
+      unless @restock.nil? or (@restock.respond_to? :iso8601 and Time.now < @restock)
+        raise Mws::Errors::ValidationError.new('Restock date must be in the future.')
+      end
+    end
+
+  end
+
+end

data/lib/mws/apis/feeds/measurement.rb

@@ -0,0 +1,32 @@
+module Mws::Apis::Feeds
+
+  class Measurement
+
+    attr_reader :amount
+
+    Mws::Enum.sym_reader self, :unit
+
+    def initialize(amount, unit)
+      @amount = amount
+      @unit = self.class.const_get(:Unit).for(unit)
+      raise Mws::Errors::ValidationError, "Invalid unit of measure '#{unit}'" if @unit.nil?
+      
+    end
+
+    def ==(other)
+      return true if equal? other
+      return false unless other.class == self.class
+      amount == other.amount and unit == other.unit
+    end
+
+    def to_xml(name=nil, parent=nil)
+      name ||= self.class.name.split('::').last
+      amount = @amount 
+      amount = '%.2f' % amount if amount.to_s =~ /\d*\.\d\d+/
+      Mws::Serializer.leaf name, parent, amount, unitOfMeasure: @unit.val
+    end
+
+  end
+
+end
+

data/lib/mws/apis/feeds/money.rb

@@ -0,0 +1,31 @@
+module Mws::Apis::Feeds
+
+  class Money < Measurement
+
+    Currency = Mws::Enum.for(
+      usd: 'USD', 
+      gbp: 'GBP', 
+      eur: 'EUR', 
+      jpy: 'JPY', 
+      cad: 'CAD', 
+      default: 'DEFAULT'
+    )
+
+    Unit = Currency
+
+    def initialize(amount, currency=nil)
+      raise Mws::Errors::ValidationError, "Invalid currency '#{currency}'" if currency and Currency.for(currency).nil?
+      super amount, currency || :usd
+    end
+
+    def currency
+      unit
+    end
+
+    def to_xml(name='Price', parent=nil)
+      Mws::Serializer.leaf name, parent, '%.2f' % @amount, currency: @unit.val
+    end
+
+  end
+
+end

data/lib/mws/apis/feeds/price_listing.rb

@@ -0,0 +1,48 @@
+require 'nokogiri'
+
+module Mws::Apis::Feeds
+
+  class PriceListing
+
+    attr_reader :sku, :currency, :base, :sale, :min
+
+    def initialize(sku, base, options={})
+      @sku = sku
+      @base = Money.new(base, options[:currency])
+      @currency =  @base.currency
+      @min = Money.new(options[:min], @currency) if options.include? :min
+      on_sale(options[:sale][:amount], options[:sale][:from], options[:sale][:to]) if options.include? :sale
+      validate
+    end
+
+    def on_sale(amount, from, to)
+      @sale = SalePrice.new Money.new(amount, @currency), from, to
+      validate
+      self
+    end
+
+    def to_xml(name='Price', parent=nil)
+      Mws::Serializer.tree name, parent do |xml| 
+        xml.SKU @sku
+        @base.to_xml 'StandardPrice', xml
+        @min.to_xml 'MAP', xml if @min
+        @sale.to_xml 'Sale', xml if @sale
+      end
+    end
+
+    private
+
+    def validate
+      if @min
+        unless @min.amount < @base.amount
+          raise Mws::Errors::ValidationError, "'Base Price' must be greater than 'Minimum Advertised Price'."
+        end
+        if @sale and @sale.price.amount <= @min.amount
+          raise Mws::Errors::ValidationError, "'Sale Price' must be greater than 'Minimum Advertised Price'."
+        end
+      end
+    end
+
+  end
+
+end

data/lib/mws/apis/feeds/product.rb

@@ -0,0 +1,173 @@
+module Mws::Apis::Feeds
+
+  class Product
+
+    CategorySerializer = Mws::Serializer.new ce: 'CE', fba: 'FBA', eu_compliance: 'EUCompliance'
+
+    attr_reader :sku, :description
+
+    attr_accessor :upc, :tax_code, :msrp, :brand, :manufacturer, :name, :description, :bullet_points
+    attr_accessor :item_dimensions, :package_dimensions, :package_weight, :shipping_weight
+    attr_accessor :category, :details
+
+    def initialize(sku, &block)
+      @sku = sku
+      @bullet_points = []
+      ProductBuilder.new(self).instance_eval &block if block_given?
+      raise Mws::Errors::ValidationError, 'Product must have a category when details are specified.' if @details and @category.nil?
+    end
+
+    def to_xml(name='Product', parent=nil)
+      Mws::Serializer.tree name, parent do |xml|
+        xml.SKU @sku
+        xml.StandardProductID {
+          xml.Type 'UPC'
+          xml.Value @upc
+        } unless @upc.nil?
+        xml.ProductTaxCode @tax_code unless @upc.nil?
+        xml.DescriptionData {
+          xml.Title @name unless @name.nil?
+          xml.Brand @brand  unless @brand.nil?
+          xml.Description @description  unless @description.nil?
+          bullet_points.each do | bullet_point |
+            xml.BulletPoint bullet_point
+          end
+          @item_dimensions.to_xml('ItemDimensions', xml) unless @item_dimensions.nil?
+          @package_dimensions.to_xml('PackageDimensions', xml) unless @item_dimensions.nil?
+
+          @package_weight.to_xml('PackageWeight', xml) unless @package_weight.nil?
+          @shipping_weight.to_xml('ShippingWeight', xml) unless @shipping_weight.nil?
+
+          @msrp.to_xml 'MSRP', xml unless @msrp.nil?
+
+          xml.Manufacturer @manufacturer unless @manufacturer.nil?
+        }
+
+        unless @details.nil?
+          xml.ProductData {
+            CategorySerializer.xml_for @category, {product_type: @details}, xml
+          }
+        end
+      end
+    end
+
+    class DelegatingBuilder
+
+      def initialize(delegate)
+        @delegate = delegate
+      end
+
+      def method_missing(method, *args, &block)
+        @delegate.send("#{method}=", *args, &block) if @delegate.respond_to? "#{method}="
+      end
+    end
+
+    class ProductBuilder < DelegatingBuilder
+
+      def initialize(product)
+        super product
+        @product = product
+      end
+
+      def msrp(amount, currency)
+        @product.msrp = Money.new amount, currency
+      end
+
+      def item_dimensions(&block)
+        @product.item_dimensions = Dimensions.new
+        DimensionsBuilder.new(@product.item_dimensions).instance_eval &block if block_given?
+      end
+
+      def package_dimensions(&block)
+        @product.package_dimensions = Dimensions.new
+        DimensionsBuilder.new(@product.package_dimensions).instance_eval &block if block_given?
+      end
+
+      def package_weight(value, unit=nil)
+        @product.package_weight = Weight.new(value, unit)
+      end
+
+      def shipping_weight(value, unit=nil)
+        @product.shipping_weight = Weight.new(value, unit)
+      end
+
+      def bullet_point(bullet_point)
+        @product.bullet_points << bullet_point
+      end
+
+      def details(details=nil, &block)
+        @product.details = details || {}
+        DetailBuilder.new(@product.details).instance_eval &block if block_given?
+      end
+
+    end
+
+    class Dimensions
+
+      attr_accessor :length, :width, :height, :weight
+
+      def to_xml(name='Dimensions', parent=nil)
+        Mws::Serializer.tree name, parent do |xml|
+          @length.to_xml 'Length', xml unless @length.nil?
+          @width.to_xml 'Width', xml unless @width.nil?
+          @height.to_xml 'Height', xml unless @height.nil?
+          @weight.to_xml 'Weight', xml unless @weight.nil?
+        end
+      end
+
+    end
+
+    class DimensionsBuilder
+
+      def initialize(dimensions)
+        @dimensions = dimensions
+      end
+
+      def length(value, unit=nil)
+        @dimensions.length = Distance.new(value, unit)
+      end
+
+      def width(value, unit=nil)
+        @dimensions.width = Distance.new(value, unit)
+      end
+
+      def height(value, unit=nil)
+        @dimensions.height = Distance.new(value, unit)
+      end
+
+      def weight(value, unit=nil)
+        @dimensions.weight = Weight.new(value, unit)
+      end
+    end
+
+    class DetailBuilder
+
+      def initialize(details)
+        @details = details
+      end
+
+      def as_distance(amount, unit=nil)
+        Distance.new amount, unit
+      end
+
+      def as_weight(amount, unit=nil)
+        Weight.new amount, unit
+      end
+
+      def as_money(amount, currency=nil)
+        Money.new amount, currency
+      end            
+
+      def method_missing(method, *args, &block)
+        if block_given?
+          @details[method] = {}
+          DetailBuilder.new(@details[method]).instance_eval(&block)
+        elsif args.length > 0
+          @details[method] = args[0]
+        end
+      end
+
+    end
+
+  end
+end

data/lib/mws/apis/feeds/sale_price.rb

@@ -0,0 +1,31 @@
+require 'nokogiri'
+
+module Mws::Apis::Feeds
+
+  class SalePrice
+
+    attr_reader :price, :from, :to
+
+    def initialize(price, from, to)
+      @price = price
+      @from = from
+      @to = to
+    end
+
+    def ==(other)
+      return true if equal? other
+      return false unless other.class == self.class
+      @price == other.price and @from == other.from and @to == other.to
+    end
+
+    def to_xml(name='Sale', parent=nil)
+      Mws::Serializer.tree name, parent do |xml|
+        xml.StartDate @from.iso8601
+        xml.EndDate @to.iso8601
+        price.to_xml 'SalePrice', xml
+      end
+    end
+
+  end
+
+end

data/lib/mws/apis/feeds/shipping.rb

@@ -0,0 +1,160 @@
+require 'nokogiri'
+
+module Mws::Apis::Feeds
+  
+  class Shipping
+
+    Region = Mws::Enum.for(
+      continental_us: 'Cont US',
+      us_protectorates: 'US Prot',
+      alaska_hawaii: 'Alaska Hawaii',
+      apo_fpo: 'APO/FPO',
+      canada: 'Canada',
+      europe: 'Europe',
+      asia: 'Asia',
+      other: 'Outside US, EU, CA, Asia'
+    )
+
+    Variant = Mws::Enum.for(
+      street: 'Street Addr', 
+      po_box: 'PO Box'
+    )
+
+    Speed = Mws::Enum.for(
+      standard: 'Std',
+      expedited: 'Exp',
+      two_day: 'Second',
+      one_day: 'Next'
+    )
+
+    attr_reader :sku
+
+    def initialize(sku, &block)
+      raise Mws::Errors::ValidationError.new('SKU is required.') if sku.nil? or sku.to_s.strip.empty?
+      @sku = sku
+      @options = []
+      Builder.new(self).instance_eval &block if block_given?
+    end
+
+    def options
+      @options.dup
+    end
+
+    def <<(option)
+      @options << option
+    end
+
+    def to_xml(name='Override', parent=nil)
+      Mws::Serializer.tree name, parent do |xml|
+        xml.SKU @sku
+        @options.each { |option| option.to_xml 'ShippingOverride', xml }
+      end
+    end
+
+    class Option
+
+      Mws::Enum.sym_reader self, :region, :speed, :variant
+
+      def initialize(region, speed=Speed.STANDARD, variant=nil)
+        @region = Region.for(region)
+        @speed = Speed.for(speed)
+        @variant = nil
+        if supports_variant?
+          @variant = Variant.for(variant) || Variant.STREET
+        end
+      end
+
+      def supports_variant?
+        [ Region.CONTINENTAL_US, Region.US_PROTECTORATES, Region.ALASKA_HAWAII, Region.APO_FPO ].include? @region
+      end
+
+      def to_s
+        return @speed.val if [ Speed.TWO_DAY, Speed.ONE_DAY ].include? @speed
+        [ @speed, @region, @variant ].compact.map { |it| it.val }.join ' '
+      end
+
+    end
+
+    class Restriction
+
+      attr_reader :option, :restricted
+
+      def initialize(option, restricted=true)
+        @option = option
+        @restricted = restricted
+      end
+
+      def to_xml(name='ShippingOverride', parent=nil)
+        Mws::Serializer.tree name, parent do |xml|
+          xml.ShipOption @option
+          xml.IsShippingRestricted @restricted
+        end
+      end
+
+    end
+
+    class Override
+
+      Type = Mws::Enum.for(
+        adjust: 'Additive', 
+        replace: 'Exclusive'
+      )
+
+      attr_reader :option, :amount
+
+      Mws::Enum.sym_reader self, :type
+
+      def initialize(option, type, amount)
+        @option = option
+        @type = Type.for(type)
+        @amount = amount
+      end
+
+      def to_xml(name='ShippingOverride', parent=nil)
+        Mws::Serializer.tree name, parent do |xml|
+          xml.ShipOption @option
+          xml.Type @type.val
+          @amount.to_xml 'ShipAmount', xml
+        end
+      end
+
+    end
+
+    class Builder
+
+      @target
+
+      def initialize(target)
+        @target = target
+      end
+
+      def restriction(restricted, region, speed, variant)
+        @target << Restriction.new(Option.new(region, speed, variant), restricted)
+      end
+
+      def restricted(region, speed, variant=nil)
+        restriction true, region, speed, variant
+      end
+
+      def unrestricted(region, speed, variant=nil)
+        restriction false, region, speed, variant
+      end
+
+      def override(type, amount, currency, region, speed, variant)
+        @target << Override.new(Option.new(region, speed, variant), type, 
+          Money.new(amount, currency))
+      end
+
+      def adjust(amount, currency, region, speed, variant=nil)
+        override :adjust, amount, currency, region, speed, variant
+      end
+
+      def replace(amount, currency, region, speed, variant=nil)
+        override :replace, amount, currency, region, speed, variant
+      end
+
+    end
+
+  end
+
+end