<?php
/**
 * This file is part of the Tmdb PHP API created by Michael Roterman.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @package Tmdb
 * @author Michael Roterman <michael@wtfz.net>
 * @copyright (c) 2013, Michael Roterman
 * @version 0.0.1
 */
namespace Tmdb\Repository;

use Tmdb\Factory\KeywordFactory;
use Tmdb\Model\Collection\ResultCollection;
use Tmdb\Model\Keyword;

/**
 * Class KeywordRepository
 * @package Tmdb\Repository
 * @see http://docs.themoviedb.apiary.io/#keywords
 */
class KeywordRepository extends AbstractRepository
{
    /**
     * Get the basic information for a specific keyword id.
     *
     * @param $id
     * @param  array   $parameters
     * @param  array   $headers
     * @return Keyword
     */
    public function load($id, array $parameters = array(), array $headers = array())
    {
        return $this->getFactory()->create(
            $this->getApi()->getKeyword($id, $parameters, $headers)
        );
    }

    /**
     * Get the list of movies for a particular keyword by id.
     * By default, only movies with 10 or more votes are included.
     *
     * @param $id
     * @param  array                      $parameters
     * @param  array                      $headers
     * @return ResultCollection|Keyword[]
     */
    public function getMovies($id, array $parameters = array(), array $headers = array())
    {
        return $this->getFactory()->createResultCollection(
            $this->getApi()->getMovies($id, $parameters, $headers),
            'createMovie'
        );
    }

    /**
     * Return the related API class
     *
     * @return \Tmdb\Api\Keywords
     */
    public function getApi()
    {
        return $this->getClient()->getKeywordsApi();
    }

    /**
     * @return KeywordFactory
     */
    public function getFactory()
    {
        return new KeywordFactory();
    }
}