# Result
  #     STANDARD RESPONSE
  # 
  # array Albums
  # Album
  #   integer id
  #   string Key
  #   string Title
  #   struct Category
  #   string id
  #   string Name
  #   struct SubCategory
  #   string id
  #   string Name
  #
  #     HEAVY RESPONSE
  #   
  # array Albums
  # Album
  #   integer id
  #   string Key
  #   string Title
  #   struct Category
  #     string id
  #     string Name
  #   struct SubCategory
  #     string id
  #     string Name
  #   string Description
  #   string Keywords
  #   boolean Geography (owner)
  #   integer Position
  #   struct Hightlight (owner)
  #     string id
  #   integer ImageCount
  #   string LastUpdated
  #   boolean Header (owner, power & pro only)
  #   boolean Clean (owner)
  #   boolean EXIF (owner)
  #   boolean Filenames (owner)
  #   struct Template (owner)
  #     string id
  #   string SortMethod (owner)
  #   boolean SortDirection (owner)
  #   string Password (owner)
  #   string PasswordHint (owner)
  #   boolean Public (owner)
  #   boolean WorldSearchable (owner)
  #   boolean SmugSearchable (owner)
  #   boolean External (owner)
  #   boolean Protected (owner, power & pro only)
  #   boolean Watermarking (owner, pro only)
  #   struct Watermark (owner, pro only)
  #     string id
  #   boolean HideOwner (owner)
  #   boolean Larges (owner, pro only)
  #   boolean XLarges (owner, pro only)
  #   boolean X2Larges (owner)
  #   boolean X3Larges (owner)
  #   boolean Originals (owner)
  #   boolean CanRank (owner)
  #   boolean FriendEdit (owner)
  #   boolean FamilyEdit (owner)
  #   boolean Comments (owner)
  #   boolean Share (owner)
  #   boolean Printable (owner)
  #   int ColorCorrection (owner)
  #   boolean DefaultColor (owner, pro only)  deprecated
  #   integer ProofDays (owner, pro only)
  #   string Backprinting (owner, pro only)
  #   float UnsharpAmount (owner, power & pro only)
  #   float UnsharpRadius (owner, power & pro only)
  #   float UnsharpThreshold (owner, power & pro only)
  #   float UnsharpSigma (owner, power & pro only)
  #   struct Community (owner)
  #     string id
#  
#  Created by Zac Kleinpeter on 2009-04-28.
#  Copyright 2009 Cajun Country. All rights reserved.
# 
class Smile::Album < Smile::Base

  class << self
    def from_json( json, session_id )
      result = JSON.parse( json )
      result["Albums"].map do |album_upcase|
        album = upper_hash_to_lower_hash( album_upcase )
        
        album.merge!( :album_id => album["id"] )
        
        a = Smile::Album.new( album )
        a.session_id = session_id
        a
      end
    end
    
    # This will pull a single album from the smugmug
    #
    # * SessionID - string. ( by default if logged in)
    # * AlbumID - string.
    # * Password - string (optional).
    # * SitePassword - string (optional).
    # * AlbumKey - string.
    # 
    def find( options={} )
      params = default_params.merge(
          :method => 'smugmug.albums.getInfo'
      )
      
      params.merge!( options ) if( options )
      
      json = RestClient.post Smile::Base::BASE, params
      
      album_upper = JSON.parse(json)
      album = upper_hash_to_lower_hash( album_upper['Album'] )
      album.merge!( :album_id => album["id"] )
      
      a = Smile::Album.new( album )
      a.session_id = session_id
      a
    end
  end

  # This will pull all the photos for a given album
  # * SessionID - string. ( by default if logged in)
  # * AlbumID - integer.
  # * Heavy - boolean (optional).
  # * Password - string (optional).
  # * SitePassword - string (optional).
  # * AlbumKey - string.
  def photos( options=nil )
    params = default_params.merge(
        :method => 'smugmug.images.get',
        :AlbumID => album_id,
        :AlbumKey => key,
        :Heavy => 1
    )

    params.merge!( options ) if( options )
    
    json = RestClient.post BASE, params
    Smile::Photo.from_json( json, session_id )
  end
  
  # * integer AlbumID
  # * integer Month
  # * integer Year
  # * boolean Heavy (optional)
  def stats( options =nil )
    params = default_params.merge( 
      :method => 'smugmug.albums.getStats',
      :AlbumID => album_id,
      :month => Date.today.month,
      :year => Date.today.year
    )
    
    params.merge!( options ) if( options )
    
    json = RestClient.post Smile::Base::BASE, params
    
    json = JSON.parse( json )
    raise json["message"] if json["stat"] == 'fail'
      
    image = upper_hash_to_lower_hash( json['Album'] )
    OpenStruct.new( hash )
  end
  
  def add( payload, options={} )
    if( File.exists?( payload ) )
    RestClient.put BASE, payload,
      :content_length => File.size( payload ),
      :content_md5 => '?',
      :x_smug_sessionid => session_id,
      :x_smug_version => VERSION,
      :x_smug_albumid => album_id,
      :x_smug_filename => File.basename( payload ),
      :x_smug_caption => options[:caption],
      :x_smug_keywords => options[:keywords],
      :x_smug_latitude => options[:latitude],
      :x_smug_longitude => options[:longitude],
      :x_smug_altitude => options[:altitude]
    else
      Exception.new( "Cannot find file #{payload}." )
    end
  end
  
  def category
    ['category']
  end
end