From e8abb3879b84cc40f43f23f14e6881b36ef5b5a0 Mon Sep 17 00:00:00 2001
From: Roussetos Karafyllakis <35-roussks@users.noreply.git.upmind.io>
Date: Wed, 8 Jan 2025 12:34:50 +0200
Subject: [PATCH] Minor docblock updates and remove not used imports

---
 src/Webuzo/Api.php                | 45 ++++++++++++++++---------------
 src/Webuzo/Data/Configuration.php |  6 ++---
 src/Webuzo/Provider.php           | 27 +++++--------------
 3 files changed, 33 insertions(+), 45 deletions(-)

diff --git a/src/Webuzo/Api.php b/src/Webuzo/Api.php
index 7d8fb3d..ec4fcdd 100644
--- a/src/Webuzo/Api.php
+++ b/src/Webuzo/Api.php
@@ -4,12 +4,9 @@
 
 namespace Upmind\ProvisionProviders\SharedHosting\Webuzo;
 
-use Illuminate\Support\Arr;
+use JsonException;
 use Upmind\ProvisionBase\Helper;
 use GuzzleHttp\Client;
-use RuntimeException;
-use Illuminate\Support\Str;
-use Upmind\ProvisionProviders\SharedHosting\Data\AccountInfo;
 use Upmind\ProvisionProviders\SharedHosting\Data\CreateParams;
 use Upmind\ProvisionProviders\SharedHosting\Data\UnitsConsumed;
 use Upmind\ProvisionProviders\SharedHosting\Data\UsageData;
@@ -19,7 +16,6 @@
 class Api
 {
     private Configuration $configuration;
-
     protected Client $client;
 
     public function __construct(Client $client, Configuration $configuration)
@@ -36,11 +32,10 @@ public function makeRequest(
         string  $command,
         ?array  $body = null,
         ?string $method = 'POST'
-    ): ?array
-    {
+    ): ?array {
         $requestParams = [];
 
-        if ($command == 'sso') {
+        if ($command === 'sso') {
             $requestParams['query']['loginAs'] = $body['username'];
             $requestParams['query']['noip'] = 1;
         }
@@ -104,6 +99,10 @@ private function getResponseErrorMessage(array $response): ?string
         return null;
     }
 
+    /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
+     */
     public function createAccount(CreateParams $params, string $username, bool $asReseller): void
     {
         $password = $params->password ?: Helper::generatePassword();
@@ -126,8 +125,8 @@ public function createAccount(CreateParams $params, string $username, bool $asRe
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function getAccountData(string $username): array
     {
@@ -170,8 +169,8 @@ public function getUserDetails(string $username): ?array
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function getAccountUsage(string $username): UsageData
     {
@@ -179,22 +178,22 @@ public function getAccountUsage(string $username): UsageData
 
         $disk = UnitsConsumed::create()
             ->setUsed((int)$account['disk']['used_bytes'] / (1024 * 1024))
-            ->setLimit(($account['disk']['limit_bytes'] == 0 || $account['disk']['limit_bytes'] == 'unlimited')
+            ->setLimit(($account['disk']['limit_bytes'] == 0 || $account['disk']['limit_bytes'] === 'unlimited')
                 ? null : (int)$account['disk']['limit_bytes'] / (1024 * 1024));
 
         $bandwidth = UnitsConsumed::create()
             ->setUsed((int)$account['bandwidth']['used_bytes'] / (1024 * 1024))
-            ->setLimit(($account['bandwidth']['limit_bytes'] == 0 || $account['bandwidth']['limit_bytes'] == 'unlimited')
+            ->setLimit(($account['bandwidth']['limit_bytes'] == 0 || $account['bandwidth']['limit_bytes'] === 'unlimited')
                 ? null : (int)$account['bandwidth']['limit_bytes'] / (1024 * 1024));
 
         $inodes = UnitsConsumed::create()
             ->setUsed((int)$account['inode']['used'])
-            ->setLimit($account['inode']['limit'] == 'unlimited'
+            ->setLimit($account['inode']['limit'] === 'unlimited'
                 ? null : (int)$account['inode']['limit']);
 
         $mailboxes = UnitsConsumed::create()
             ->setUsed((int)$account['email_account']['used'])
-            ->setLimit($account['email_account']['limit'] == 'unlimited'
+            ->setLimit($account['email_account']['limit'] === 'unlimited'
                 ? null : (int)$account['email_account']['limit']);
 
         return UsageData::create()
@@ -205,8 +204,8 @@ public function getAccountUsage(string $username): UsageData
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function suspendAccount(string $username): void
     {
@@ -218,8 +217,8 @@ public function suspendAccount(string $username): void
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function unsuspendAccount(string $username): void
     {
@@ -231,8 +230,8 @@ public function unsuspendAccount(string $username): void
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function deleteAccount(string $username): void
     {
@@ -244,8 +243,8 @@ public function deleteAccount(string $username): void
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function updatePackage(string $username, string $package): void
     {
@@ -264,8 +263,8 @@ public function updatePackage(string $username, string $package): void
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function updatePassword(string $username, string $password): void
     {
@@ -286,8 +285,8 @@ public function updatePassword(string $username, string $password): void
     }
 
     /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \RuntimeException
      */
     public function getLoginUrl(string $username): string
     {
@@ -300,7 +299,11 @@ public function getLoginUrl(string $username): string
         return $response['done']['url'];
     }
 
-    public function setReseller(string $username, int $isReseller)
+    /**
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
+     */
+    public function setReseller(string $username, int $isReseller): void
     {
         $account = $this->getUserDetails($username);
 
diff --git a/src/Webuzo/Data/Configuration.php b/src/Webuzo/Data/Configuration.php
index e6ebba4..c5f4b2b 100644
--- a/src/Webuzo/Data/Configuration.php
+++ b/src/Webuzo/Data/Configuration.php
@@ -10,9 +10,9 @@
 /**
  * Webuzo API credentials.
  * @property-read string $hostname API hostname
- * @property-read string $api_key API key
- * @property-read string $username Username
- * @property-read string $password Password
+ * @property-read string|null $api_key API key
+ * @property-read string|null $username Username
+ * @property-read string|null $password Password
  */
 class Configuration extends DataSet
 {
diff --git a/src/Webuzo/Provider.php b/src/Webuzo/Provider.php
index 47f6052..9d9556a 100644
--- a/src/Webuzo/Provider.php
+++ b/src/Webuzo/Provider.php
@@ -5,9 +5,7 @@
 namespace Upmind\ProvisionProviders\SharedHosting\Webuzo;
 
 use GuzzleHttp\Client;
-use Carbon\Carbon;
 use Throwable;
-use Upmind\ProvisionBase\Exception\ProvisionFunctionError;
 use Upmind\ProvisionBase\Provider\Contract\ProviderInterface;
 use Upmind\ProvisionBase\Provider\DataSet\AboutData;
 use Upmind\ProvisionProviders\SharedHosting\Category;
@@ -32,15 +30,8 @@ class Provider extends Category implements ProviderInterface
 {
     protected const MAX_USERNAME_LENGTH = 10;
 
-    /**
-     * @var Configuration
-     */
-    protected $configuration;
-
-    /**
-     * @var Api|null
-     */
-    protected $api;
+    protected Configuration $configuration;
+    protected ?Api $api = null;
 
     public function __construct(Configuration $configuration)
     {
@@ -63,7 +54,6 @@ public static function aboutProvider(): AboutData
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function create(CreateParams $params): AccountInfo
     {
@@ -109,7 +99,6 @@ protected function _getInfo(string $username, string $message): AccountInfo
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function getInfo(AccountUsername $params): AccountInfo
     {
@@ -122,7 +111,6 @@ public function getInfo(AccountUsername $params): AccountInfo
     /**
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function getUsage(AccountUsername $params): AccountUsage
     {
@@ -137,7 +125,6 @@ public function getUsage(AccountUsername $params): AccountUsage
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function getLoginUrl(GetLoginUrlParams $params): LoginUrl
     {
@@ -156,7 +143,6 @@ public function getLoginUrl(GetLoginUrlParams $params): LoginUrl
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function changePassword(ChangePasswordParams $params): EmptyResult
     {
@@ -170,7 +156,6 @@ public function changePassword(ChangePasswordParams $params): EmptyResult
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function changePackage(ChangePackageParams $params): AccountInfo
     {
@@ -187,7 +172,6 @@ public function changePackage(ChangePackageParams $params): AccountInfo
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function suspend(SuspendParams $params): AccountInfo
     {
@@ -201,7 +185,6 @@ public function suspend(SuspendParams $params): AccountInfo
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function unSuspend(AccountUsername $params): AccountInfo
     {
@@ -215,7 +198,6 @@ public function unSuspend(AccountUsername $params): AccountInfo
      *
      * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
-     * @throws \Throwable
      */
     public function terminate(AccountUsername $params): EmptyResult
     {
@@ -227,6 +209,7 @@ public function terminate(AccountUsername $params): EmptyResult
     /**
      * @inheritDoc
      *
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
      */
     public function grantReseller(GrantResellerParams $params): ResellerPrivileges
@@ -241,6 +224,7 @@ public function grantReseller(GrantResellerParams $params): ResellerPrivileges
     /**
      * @inheritDoc
      *
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
      */
     public function revokeReseller(AccountUsername $params): ResellerPrivileges
@@ -255,6 +239,7 @@ public function revokeReseller(AccountUsername $params): ResellerPrivileges
     /**
      * @return no-return
      *
+     * @throws \GuzzleHttp\Exception\GuzzleException
      * @throws \Upmind\ProvisionBase\Exception\ProvisionFunctionError
      * @throws \Throwable
      */
@@ -272,7 +257,7 @@ protected function api(): Api
 
         $auth = '';
 
-        if (isset($this->configuration->username) && isset($this->configuration->password)) {
+        if (isset($this->configuration->username, $this->configuration->password)) {
             $auth = $this->configuration->username . ':' . $this->configuration->password . '@';
         }