Tumblr2.php

<?php
/**
 * Class Tumblr2
 *
 * @created      30.07.2023
 * @author       smiley <smiley@chillerlan.net>
 * @copyright    2023 smiley
 * @license      MIT
 */

namespace chillerlan\OAuth\Providers;

use chillerlan\OAuth\Core\{CSRFToken, OAuth2Provider, ProviderException, TokenRefresh};
use chillerlan\HTTP\Utils\MessageUtil;
use Psr\Http\Message\ResponseInterface;
use function sprintf;

/**
 * Tumblr OAuth2
 *
 * @see https://www.tumblr.com/docs/en/api/v2#oauth2-authorization
 */
class Tumblr2 extends OAuth2Provider implements CSRFToken, TokenRefresh{

	public const SCOPE_BASIC          = 'basic';
	public const SCOPE_WRITE          = 'write';
	public const SCOPE_OFFLINE_ACCESS = 'offline_access';

	protected array $defaultScopes = [
		self::SCOPE_BASIC,
		self::SCOPE_WRITE,
		self::SCOPE_OFFLINE_ACCESS,
	];

	protected string      $authURL        = 'https://www.tumblr.com/v2/oauth2/authorize';
	protected string      $accessTokenURL = 'https://www.tumblr.com/v2/oauth2/token';
	protected string      $apiURL         = 'https://api.tumblr.com';
	protected string|null $userRevokeURL  = 'https://www.tumblr.com/settings/apps';
	protected string|null $apiDocs        = 'https://www.tumblr.com/docs/en/api/v2';
	protected string|null $applicationURL = 'https://www.tumblr.com/oauth/apps';

	/**
	 * @inheritDoc
	 */
	public function me():ResponseInterface{
		$response = $this->request('/v2/user/info');
		$status   = $response->getStatusCode();

		if($status === 200){
			return $response;
		}

		$json = MessageUtil::decodeJSON($response);

		if(isset($json->meta, $json->meta->msg)){
			throw new ProviderException($json->meta->msg);
		}

		throw new ProviderException(sprintf('user info error HTTP/%s', $status));
	}

}