* @copyright 2015 - 2020 Timothy J. Warren * @license http://www.opensource.org/licenses/mit-license.html MIT License * @version 5 * @link https://git.timshomepage.net/timw4mail/HummingBirdAnimeClient */ namespace Aviat\AnimeClient\API\Kitsu; use Aviat\AnimeClient\Enum\EventType; use function in_array; use const PHP_SAPI; use const Aviat\AnimeClient\SESSION_SEGMENT; use function Amp\Promise\wait; use function Aviat\AnimeClient\getResponse; use Amp\Http\Client\Request; use Amp\Http\Client\Response; use Aviat\AnimeClient\API\{FailedResponseException, Kitsu as K}; use Aviat\Ion\Event; use Aviat\Ion\Json; use Aviat\Ion\JsonException; use Throwable; trait KitsuTrait { /** * The request builder for the Kitsu API * @var KitsuRequestBuilder */ protected KitsuRequestBuilder $requestBuilder; /** * Set the request builder object * * @param KitsuRequestBuilder $requestBuilder * @return self */ public function setRequestBuilder($requestBuilder): self { $this->requestBuilder = $requestBuilder; return $this; } /** * Create a request object * * @param string $type * @param string $url * @param array $options * @return Request */ public function setUpRequest(string $type, string $url, array $options = []): Request { $request = $this->requestBuilder->newRequest($type, $url); $sessionSegment = $this->getContainer() ->get('session') ->getSegment(SESSION_SEGMENT); $cache = $this->getContainer()->get('cache'); $cacheItem = $cache->getItem(K::AUTH_TOKEN_CACHE_KEY); $token = null; if (PHP_SAPI === 'cli' && $cacheItem->isHit()) { $token = $cacheItem->get(); } else if ($url !== K::AUTH_URL && $sessionSegment->get('auth_token') !== NULL) { $token = $sessionSegment->get('auth_token'); if ( ! (empty($token) || $cacheItem->isHit())) { $cacheItem->set($token); $cacheItem->save(); } } if ($token !== NULL) { $request = $request->setAuth('bearer', $token); } if (array_key_exists('form_params', $options)) { $request = $request->setFormFields($options['form_params']); } if (array_key_exists('query', $options)) { $request = $request->setQuery($options['query']); } if (array_key_exists('body', $options)) { $request = $request->setJsonBody($options['body']); } if (array_key_exists('headers', $options)) { $request = $request->setHeaders($options['headers']); } return $request->getFullRequest(); } /** * Make a request * * @param string $type * @param string $url * @param array $options * @return Response * @throws Throwable */ private function getResponse(string $type, string $url, array $options = []): Response { $logger = NULL; if ($this->getContainer()) { $logger = $this->container->getLogger('kitsu-request'); } $request = $this->setUpRequest($type, $url, $options); $response = getResponse($request); if ($logger) { $logger->debug('Kitsu API Response', [ 'response_status' => $response->getStatus(), 'request_headers' => $response->getOriginalRequest()->getHeaders(), 'response_headers' => $response->getHeaders() ]); } return $response; } /** * Make a request * * @param string $type * @param string $url * @param array $options * @throws JsonException * @throws FailedResponseException * @throws Throwable * @return array */ private function request(string $type, string $url, array $options = []): array { $logger = NULL; if ($this->getContainer()) { $logger = $this->container->getLogger('kitsu-request'); } $response = $this->getResponse($type, $url, $options); $statusCode = $response->getStatus(); // Check for requests that are unauthorized if ($statusCode === 401 || $statusCode === 403) { Event::emit(EventType::UNAUTHORIZED); } // Any other type of failed request if ($statusCode > 299 || $statusCode < 200) { if ($logger) { $logger->warning('Non 2xx response for api call', (array)$response); } throw new FailedResponseException('Failed to get the proper response from the API'); } try { return Json::decode(wait($response->getBody()->buffer())); } catch (JsonException $e) { print_r($e); die(); } } /** * Remove some boilerplate for get requests * * @param mixed ...$args * @throws Throwable * @return array */ protected function getRequest(...$args): array { return $this->request('GET', ...$args); } /** * Remove some boilerplate for patch requests * * @param mixed ...$args * @throws Throwable * @return array */ protected function patchRequest(...$args): array { return $this->request('PATCH', ...$args); } /** * Remove some boilerplate for post requests * * @param mixed ...$args * @throws Throwable * @return array */ protected function postRequest(...$args): array { $logger = NULL; if ($this->getContainer()) { $logger = $this->container->getLogger('kitsu-request'); } $response = $this->getResponse('POST', ...$args); $validResponseCodes = [200, 201]; if ( ! in_array($response->getStatus(), $validResponseCodes, TRUE) && $logger) { $logger->warning('Non 201 response for POST api call', $response->getBody()); } return JSON::decode(wait($response->getBody()->buffer()), TRUE); } /** * Remove some boilerplate for delete requests * * @param mixed ...$args * @throws Throwable * @return bool */ protected function deleteRequest(...$args): bool { $response = $this->getResponse('DELETE', ...$args); return ($response->getStatus() === 204); } }