2018-08-10 20:10:19 -04:00
|
|
|
<?php declare(strict_types=1);
|
|
|
|
/**
|
|
|
|
* Hummingbird Anime List Client
|
|
|
|
*
|
2018-08-22 13:48:27 -04:00
|
|
|
* An API client for Kitsu to manage anime and manga watch lists
|
2018-08-10 20:10:19 -04:00
|
|
|
*
|
|
|
|
* PHP version 7
|
|
|
|
*
|
|
|
|
* @package HummingbirdAnimeClient
|
|
|
|
* @author Timothy J. Warren <tim@timshomepage.net>
|
|
|
|
* @copyright 2015 - 2018 Timothy J. Warren
|
|
|
|
* @license http://www.opensource.org/licenses/mit-license.html MIT License
|
|
|
|
* @version 4.0
|
|
|
|
* @link https://git.timshomepage.net/timw4mail/HummingBirdAnimeClient
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace Aviat\AnimeClient\API\Anilist;
|
|
|
|
|
2018-08-15 08:51:37 -04:00
|
|
|
use Amp\Artax\Request;
|
|
|
|
use Aviat\AnimeClient\API\Mapping\{AnimeWatchingStatus, MangaReadingStatus};
|
|
|
|
use Aviat\AnimeClient\Types\FormItem;
|
|
|
|
|
2018-08-10 20:10:19 -04:00
|
|
|
/**
|
|
|
|
* Anilist API Model
|
|
|
|
*/
|
2018-08-15 08:51:37 -04:00
|
|
|
final class Model
|
|
|
|
{
|
|
|
|
use AnilistTrait;
|
|
|
|
/**
|
|
|
|
* @var ListItem
|
|
|
|
*/
|
|
|
|
private $listItem;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor
|
|
|
|
*
|
|
|
|
* @param ListItem $listItem
|
|
|
|
*/
|
|
|
|
public function __construct(ListItem $listItem)
|
|
|
|
{
|
|
|
|
$this->listItem = $listItem;
|
|
|
|
}
|
|
|
|
|
|
|
|
// -------------------------------------------------------------------------
|
|
|
|
// ! Generic API calls
|
|
|
|
// -------------------------------------------------------------------------
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a list item
|
|
|
|
*
|
|
|
|
* @param array $data
|
|
|
|
* @param string $type
|
|
|
|
* @return Request
|
|
|
|
*/
|
|
|
|
public function createListItem(array $data, string $type = 'anime'): Request
|
|
|
|
{
|
|
|
|
$createData = [];
|
|
|
|
|
2018-09-20 16:08:46 -04:00
|
|
|
$mediaId = $this->getMediaIdFromMalId($data['mal_id'], strtoupper($type));
|
2018-09-20 10:41:28 -04:00
|
|
|
|
2018-08-15 08:51:37 -04:00
|
|
|
if ($type === 'anime') {
|
|
|
|
$createData = [
|
2018-09-20 10:41:28 -04:00
|
|
|
'id' => $mediaId,
|
|
|
|
'status' => AnimeWatchingStatus::KITSU_TO_ANILIST[$data['status']],
|
2018-08-15 08:51:37 -04:00
|
|
|
];
|
|
|
|
} elseif ($type === 'manga') {
|
|
|
|
$createData = [
|
2018-09-20 10:41:28 -04:00
|
|
|
'id' => $mediaId,
|
|
|
|
'status' => MangaReadingStatus::KITSU_TO_ANILIST[$data['status']],
|
2018-08-15 08:51:37 -04:00
|
|
|
];
|
|
|
|
}
|
|
|
|
|
|
|
|
return $this->listItem->create($createData, $type);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the data for a specific list item, generally for editing
|
|
|
|
*
|
2018-09-20 10:41:28 -04:00
|
|
|
* @param string $malId - The unique identifier of that list item
|
2018-08-15 08:51:37 -04:00
|
|
|
* @return mixed
|
|
|
|
*/
|
2018-09-20 10:41:28 -04:00
|
|
|
public function getListItem(string $malId): array
|
2018-08-15 08:51:37 -04:00
|
|
|
{
|
2018-09-20 10:41:28 -04:00
|
|
|
$id = $this->getListIdFromMalId($malId);
|
2018-09-20 16:08:46 -04:00
|
|
|
|
|
|
|
$data = $this->listItem->get($id)['data'];
|
|
|
|
|
|
|
|
return ($data !== null)
|
|
|
|
? $data['MediaList']
|
|
|
|
: [];
|
2018-09-20 10:41:28 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Increase the watch count for the current list item
|
|
|
|
*
|
|
|
|
* @param FormItem $data
|
|
|
|
* @return Request
|
|
|
|
*/
|
|
|
|
public function incrementListItem(FormItem $data): Request
|
|
|
|
{
|
|
|
|
$id = $this->getListIdFromMalId($data['mal_id']);
|
|
|
|
|
|
|
|
return $this->listItem->increment($id, $data['data']);
|
2018-08-15 08:51:37 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Modify a list item
|
|
|
|
*
|
|
|
|
* @param FormItem $data
|
|
|
|
* @return Request
|
|
|
|
*/
|
|
|
|
public function updateListItem(FormItem $data): Request
|
|
|
|
{
|
2018-09-20 10:41:28 -04:00
|
|
|
$id = $this->getListIdFromMalId($data['mal_id']);
|
|
|
|
|
|
|
|
return $this->listItem->update($id, $data['data']);
|
2018-08-15 08:51:37 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Remove a list item
|
|
|
|
*
|
2018-09-20 16:08:46 -04:00
|
|
|
* @param string $malId - The id of the list item to remove
|
2018-08-15 08:51:37 -04:00
|
|
|
* @return Request
|
|
|
|
*/
|
2018-09-20 16:08:46 -04:00
|
|
|
public function deleteListItem(string $malId): Request
|
2018-08-15 08:51:37 -04:00
|
|
|
{
|
2018-09-20 16:08:46 -04:00
|
|
|
$item_id = $this->getListIdFromMalId($malId);
|
|
|
|
|
|
|
|
return $this->listItem->delete($item_id);
|
2018-08-15 08:51:37 -04:00
|
|
|
}
|
2018-09-20 10:41:28 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the id of the specific list entry from the malId
|
|
|
|
*
|
|
|
|
* @param string $malId
|
|
|
|
* @return string
|
|
|
|
*/
|
2018-09-20 16:08:46 -04:00
|
|
|
public function getListIdFromMalId(string $malId): ?string
|
2018-09-20 10:41:28 -04:00
|
|
|
{
|
|
|
|
$info = $this->runQuery('ListItemIdByMalId', ['id' => $malId]);
|
2018-09-20 16:08:46 -04:00
|
|
|
return (string)$info['data']['Media']['mediaListEntry']['id'] ?? NULL;
|
2018-09-20 10:41:28 -04:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the Anilist media id from the malId
|
|
|
|
*
|
|
|
|
* @param string $malId
|
|
|
|
* @param string $type
|
2018-09-20 16:08:46 -04:00
|
|
|
* @return string
|
2018-09-20 10:41:28 -04:00
|
|
|
*/
|
2018-09-20 16:08:46 -04:00
|
|
|
private function getMediaIdFromMalId(string $malId, string $type = 'ANIME'): ?string
|
2018-09-20 10:41:28 -04:00
|
|
|
{
|
2018-09-20 16:08:46 -04:00
|
|
|
$info = $this->runQuery('MediaIdByMalId', [
|
2018-09-20 10:41:28 -04:00
|
|
|
'id' => $malId,
|
|
|
|
'type' => $type
|
|
|
|
]);
|
2018-09-20 16:08:46 -04:00
|
|
|
|
|
|
|
return (string)$info['data']['Media']['id'];
|
2018-09-20 10:41:28 -04:00
|
|
|
}
|
2018-08-10 20:10:19 -04:00
|
|
|
}
|