77 lines
2.2 KiB
PHP
77 lines
2.2 KiB
PHP
<?php
|
|
|
|
namespace Pterodactyl\Transformers\Api\Client;
|
|
|
|
use Pterodactyl\Models\User;
|
|
use Webmozart\Assert\Assert;
|
|
use Pterodactyl\Models\Server;
|
|
use Illuminate\Container\Container;
|
|
use Pterodactyl\Exceptions\Transformer\InvalidTransformerLevelException;
|
|
use Pterodactyl\Transformers\Api\Application\BaseTransformer as BaseApplicationTransformer;
|
|
|
|
abstract class BaseClientTransformer extends BaseApplicationTransformer
|
|
{
|
|
/**
|
|
* @var \Pterodactyl\Models\User
|
|
*/
|
|
private $user;
|
|
|
|
/**
|
|
* Return the user model of the user requesting this transformation.
|
|
*
|
|
* @return \Pterodactyl\Models\User
|
|
*/
|
|
public function getUser(): User
|
|
{
|
|
return $this->user;
|
|
}
|
|
|
|
/**
|
|
* Set the user model of the user requesting this transformation.
|
|
*
|
|
* @param \Pterodactyl\Models\User $user
|
|
*/
|
|
public function setUser(User $user)
|
|
{
|
|
$this->user = $user;
|
|
}
|
|
|
|
/**
|
|
* Determine if the API key loaded onto the transformer has permission
|
|
* to access a different resource. This is used when including other
|
|
* models on a transformation request.
|
|
*
|
|
* @param string $ability
|
|
* @param \Pterodactyl\Models\Server $server
|
|
* @return bool
|
|
*/
|
|
protected function authorize(string $ability, Server $server = null): bool
|
|
{
|
|
Assert::isInstanceOf($server, Server::class);
|
|
|
|
return $this->getUser()->can($ability, [$server]);
|
|
}
|
|
|
|
/**
|
|
* Create a new instance of the transformer and pass along the currently
|
|
* set API key.
|
|
*
|
|
* @param string $abstract
|
|
* @param array $parameters
|
|
* @return self
|
|
*
|
|
* @throws \Pterodactyl\Exceptions\Transformer\InvalidTransformerLevelException
|
|
*/
|
|
protected function makeTransformer(string $abstract, array $parameters = [])
|
|
{
|
|
/** @var \Pterodactyl\Transformers\Api\Application\BaseTransformer $transformer */
|
|
$transformer = Container::getInstance()->makeWith($abstract, $parameters);
|
|
$transformer->setKey($this->getKey());
|
|
|
|
if (! $transformer instanceof self) {
|
|
throw new InvalidTransformerLevelException('Calls to ' . __METHOD__ . ' must return a transformer that is an instance of ' . __CLASS__);
|
|
}
|
|
|
|
return $transformer;
|
|
}
|
|
}
|