module Etsy

  # = Listing
  #
  # Represents a single Etsy listing.  Has the following attributes:
  #
  # [id] The unique identifier for this listing
  # [title] The title of this listing
  # [description] This listing's full description
  # [view_count] The number of times this listing has been viewed
  # [url] The full URL to this listing's detail page
  # [price] The price of this listing item
  # [currency] The currency that the seller is using for this listing item
  # [quantity] The number of items available for sale
  # [tags] An array of tags that the seller has used for this listing
  # [materials] Any array of materials that was used in the production of this item
  # [state] The current state of the item
  # [hue] The hue of the listing's primary image (HSV color).
  # [saturation] The saturation of the listing's primary image (HSV color).
  # [brightness] The value of the listing's primary image (HSV color).
  # [black_and_white?] True if the listing's primary image is in black & white.
  #
  # Additionally, the following queries on this item are available:
  #
  # [active?] Is this listing active?
  # [removed?] Has this listing been removed?
  # [sold_out?] Is this listing sold out?
  # [expired?] Has this listing expired?
  # [alchemy?] Is this listing an Alchemy item? (i.e. requested by an Etsy user)
  #
  class Listing

    include Etsy::Model

    STATES = %w(active removed sold_out expired alchemy)
    VALID_STATES = [:active, :expired, :inactive, :sold, :featured, :draft, :sold_out]

    attribute :id, :from => :listing_id
    attribute :view_count, :from => :views
    attribute :created, :from => :creation_tsz
    attribute :original_created, :from => :original_creation_tsz
    attribute :modified, :from => :last_modified_tsz
    attribute :currency, :from => :currency_code
    attribute :ending, :from => :ending_tsz
    attribute :shop_section, :from => :shop_section_id

    attributes :title, :description, :state, :url, :price, :quantity,
               :tags, :materials, :hue, :saturation, :brightness, :is_black_and_white,
               :featured_rank, :occasion, :num_favorers, :user_id,
               :shipping_template_id, :who_made, :when_made,
               :style, :category_path, :taxonomy_id, :taxonomy_attributes

    association :image, :from => 'Images'

    def transactions
      @transactions ||= Transaction.find_all_by_listing_id(id, oauth)
    end

    def receipts
      transactions.map{|t|t.receipt}
    end

    def self.create(options = {})
      options.merge!(:require_secure => true)
      post("/listings", options)
    end

    def self.update(listing, options = {})
      options.merge!(:require_secure => true)
      put("/listings/#{listing.id}", options)
    end

    def self.destroy(listing, options = {})
      options.merge!(:require_secure => true)
      delete("/listings/#{listing.id}", options)
    end

    # Retrieve one or more listings by ID:
    #
    #   Etsy::Listing.find(123)
    #
    # You can find multiple listings by passing an array of identifiers:
    #
    #   Etsy::Listing.find([123, 456])
    #
    def self.find(*identifiers_and_options)
      find_one_or_more('listings', identifiers_and_options)
    end

    # Retrieve listings for a given shop.
    # By default, pulls back the first 25 active listings.
    # Defaults can be overridden using :limit, :offset, and :state
    #
    # Available states are :active, :expired, :inactive, :sold, and :featured, :draft, :sold_out
    # where :featured is a subset of the others.
    #
    # options = {
    #   :state => :expired,
    #   :limit => 100,
    #   :offset => 100,
    #   :token => 'toke',
    #   :secret => 'secret'
    # }
    # Etsy::Listing.find_all_by_shop_id(123, options)
    #
    def self.find_all_by_shop_id(shop_id, options = {})
      state = options.delete(:state) || :active

      raise(ArgumentError, self.invalid_state_message(state)) unless valid?(state)

      if state == :sold
        sold_listings(shop_id, options)
      else
        get_all("/shops/#{shop_id}/listings/#{state}", options)
      end
    end

    # Retrieve active listings for a given category.
    # By default, pulls back the first 25 active listings.
    # Defaults can be overridden using :limit, :offset, and :state
    #
    # options = {
    #   :limit => 25,
    #   :offset => 100,
    #   :token => 'toke',
    #   :secret => 'secret'
    # }
    # Etsy::Listing.find_all_active_by_category("accessories", options)
    #
    def self.find_all_active_by_category(category, options = {})
      options[:category] = category
      get_all("/listings/active", options)
    end

    # The collection of images associated with this listing.
    #
    def images
      @images ||= listing_images
    end

    # The primary image for this listing.
    #
    def image
      images.first
    end

    # Listing category name
    #
    def category
      path = category_path.join('/')
      @category ||= Category.find(path)
    end

    # Returns the taxonomy defined attributes for the listing
    #
    def taxonomy_attributes(options={})
      options.merge!(:require_secure => true)
      self.class.get_all("/listings/#{id}/attributes", oauth.merge(options))
    end

    def variations(options={})
      options.merge!(:require_secure => true)
      self.class.get_all("/listings/#{id}/variations", oauth.merge(options))
    end

    # If these are your desired variations:
    # - Dimensions: 1 x 2 inches
    # - Dimensions: 2 x 4 inches
    #
    # Then you first have to find the property ID of the property you want to vary. Eg:
    #   Etsy::Variation::PropertySet.find_property_by_name("Dimensions").fetch("property_id")
    #
    # Then you can decide which options you want to set for this property.
    # Eg:
    #   Etsy::Variation::PropertySet.qualifying_properties_for_property("Dimension")
    # => [{
    #      "param"=>"dimensions_scale",
    #      "description"=>"Sizing Scale",
    #      "options"=>{
    #        "Inches" => 344,
    #        "Centimeters" => 345,
    #        "Other" => 346
    #      }
    #    }]
    #
    # Put it all together for a call to add_variations:

    #  property_id = Etsy::Variation::PropertySet.find_property_by_name("Dimensions").fetch("property_id")
    #  scale = Etsy::Variation::PropertySet.qualifying_properties_for_property("Dimensions").detect {|qp| qp.fetch("description") == "Sizing Scale"}
    #  my_listing.add_variations(
    #    :variations => [
    #      {"property_id" => property_id, "value" => "1 x 2", "is_available" => true, "price" => 1.23},
    #      {"property_id" => property_id, "value" => "2 x 4", "is_available" => true, "price" => 2.34}
    #    ],
    #    scale.fetch("param") => scale.fetch("options").fetch("Inches")
    #  )
    def add_variations(options)
      options[:variations] = JSON.dump(options.delete(:variations))
      options[:require_secure] = true
      self.class.post("/listings/#{id}/variations", options)
    end

    def update_variations(options)
      options[:variations] = JSON.dump(options.delete(:variations))
      options[:require_secure] = true
      self.class.put("/listings/#{id}/variations", options)
    end

    def black_and_white?
      is_black_and_white
    end

    STATES.each do |method_name|
      define_method "#{method_name}?" do
        state == method_name.sub('_', '')
      end
    end

    # Time that this listing was created
    #
    def created_at
      Time.at(created)
    end

    # Time that this listing was originally created
    def original_created_at
      Time.at(original_created)
    end

    # Time that this listing was last modified
    #
    def modified_at
      Time.at(modified)
    end

    # Time that this listing is ending (will be removed from store)
    #
    def ending_at
      Time.at(ending)
    end

    #Return a list of users who have favorited this listing
    #
    def admirers(options = {})
      options = options.merge(:access_token => token, :access_secret => secret) if (token && secret)
      favorite_listings = FavoriteListing.find_all_listings_favored_by(id, options)
      user_ids  = favorite_listings.map {|f| f.user_id }.uniq
      (user_ids.size > 0) ? Array(Etsy::User.find(user_ids, options)) : []
    end

    def is_supply
      !!@result.fetch("is_supply")
    end

    private

    def self.valid?(state)
      VALID_STATES.include?(state)
    end

    def self.invalid_state_message(state)
      "The state '#{state}' is invalid. Must be one of #{VALID_STATES.join(', ')}"
    end

    def self.sold_listings(shop_id, options = {})
      includes = options.delete(:includes)

      transactions = Transaction.find_all_by_shop_id(shop_id, options)
      listing_ids  = transactions.map {|t| t.listing_id }.uniq

      options = options.merge(:includes => includes) if includes
      (listing_ids.size > 0) ? Array(find(listing_ids, options)) : []
    end

    #Find all listings favored by a user
    #
    def self.find_all_user_favorite_listings(user_id, options = {})
      favorite_listings = FavoriteListing.find_all_user_favorite_listings(user_id, options)
      listing_ids  = favorite_listings.map {|f| f.listing_id }.uniq
      (listing_ids.size > 0) ? Array(find(listing_ids, options)) : []
    end

    #Find all listings that have been bought by a user
    #
    def self.bought_listings(user_id, options = {})
      includes = options.delete(:includes)

      transactions = Transaction.find_all_by_buyer_id(user_id, options)
      listing_ids  = transactions.map {|t| t.listing_id }.uniq

      options = options.merge(:includes => includes) if includes
      (listing_ids.size > 0) ? Array(find(listing_ids, options)) : []
    end

    private

    def oauth
      oauth = (token && secret) ? {:access_token => token, :access_secret => secret} : {}
    end

    def listing_images
      if result && result["Images"]
        result["Images"].map { |hash| Image.new(hash) }
      else
        Image.find_all_by_listing_id(id, oauth)
      end
    end
  end
end