HummingBirdAnimeClient/src/AnimeClient/API/Anilist/ListItem.php

125 lines
3.0 KiB
PHP
Raw Normal View History

<?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
*
2020-12-10 17:06:50 -05:00
* PHP version 7.4+
*
* @package HummingbirdAnimeClient
* @author Timothy J. Warren <tim@timshomepage.net>
2021-01-13 01:52:03 -05:00
* @copyright 2015 - 2021 Timothy J. Warren
* @license http://www.opensource.org/licenses/mit-license.html MIT License
2020-12-10 17:06:50 -05:00
* @version 5.2
* @link https://git.timshomepage.net/timw4mail/HummingBirdAnimeClient
*/
namespace Aviat\AnimeClient\API\Anilist;
2020-03-11 16:26:17 -04:00
use Amp\Http\Client\Request;
use Aviat\AnimeClient\API\AbstractListItem;
2018-09-26 22:31:04 -04:00
use Aviat\AnimeClient\API\Enum\AnimeWatchingStatus\Anilist as AnilistStatus;
use Aviat\AnimeClient\API\Mapping\AnimeWatchingStatus;
use Aviat\AnimeClient\Types\FormItemData;
/**
* CRUD operations for MAL list items
*/
final class ListItem extends AbstractListItem {
2020-08-06 09:39:12 -04:00
use RequestBuilderTrait;
/**
2018-09-26 22:31:04 -04:00
* Create a minimal list item
*
* @param array $data
* @return Request
*/
public function create(array $data): Request
{
$checkedData = Types\MediaListEntry::check($data);
return $this->requestBuilder->mutateRequest('CreateMediaListEntry', $checkedData);
}
2018-09-26 22:31:04 -04:00
/**
* Create a fleshed-out list item
*
* @param array $data
* @return Request
*/
public function createFull(array $data): Request
{
$checkedData = Types\MediaListEntry::check($data);
return $this->requestBuilder->mutateRequest('CreateFullMediaListEntry', $checkedData);
2018-09-26 22:31:04 -04:00
}
/**
* Delete a list item
*
* @param string $id
* @param string $type
* @return Request
*/
public function delete(string $id, string $type = 'anime'): Request
{
return $this->requestBuilder->mutateRequest('DeleteMediaListEntry', ['id' => $id]);
}
/**
* Get the data for a list item
*
* @param string $id
* @return array
*/
public function get(string $id): array
{
return $this->requestBuilder->runQuery('MediaListItem', ['id' => $id]);
}
/**
* Increase the progress on the medium by 1
*
* @param string $id
* @param FormItemData $data
* @return Request
*/
public function increment(string $id, FormItemData $data): Request
{
$checkedData = Types\MediaListEntry::check([
'id' => $id,
'progress' => $data->progress,
]);
return $this->requestBuilder->mutateRequest('IncrementMediaListEntry', $checkedData);
}
/**
* Update a list item
*
* @param string $id
* @param FormItemData $data
* @return Request
*/
public function update(string $id, FormItemData $data): Request
2018-10-01 13:03:48 -04:00
{
$notes = $data->notes ?? '';
$progress = (int)$data->progress;
$private = (bool)$data->private;
$rating = $data->ratingTwenty;
$status = ($data->reconsuming === TRUE)
? AnilistStatus::REPEATING
: AnimeWatchingStatus::KITSU_TO_ANILIST[$data->status];
2018-10-01 13:03:48 -04:00
$updateData = Types\MediaListEntry::check([
2018-09-26 22:31:04 -04:00
'id' => (int)$id,
'status' => $status,
2018-10-01 13:03:48 -04:00
'score' => $rating * 5,
'progress' => $progress,
'repeat' => (int)$data['reconsumeCount'],
2018-09-26 22:31:04 -04:00
'private' => $private,
'notes' => $notes,
]);
2018-09-26 22:31:04 -04:00
return $this->requestBuilder->mutateRequest('UpdateMediaListEntry', $updateData);
}
}