Merge pull request #5 from zepgram/develop

[v2.0.0] add missing phpdoc for apiPool
zepgram · Feb 19, 2024 · 3ea4ad6 · 3ea4ad6
2 parents 0710701 + 21f76b0
commit 3ea4ad6
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 1 deletion.
diff --git a/Service/ApiPool.php b/Service/ApiPool.php
@@ -16,6 +16,7 @@
 namespace Zepgram\Rest\Service;
 
 use ReflectionClass;
+use ReflectionException;
 use Zepgram\Rest\Exception\Technical\LogicException;
 use Zepgram\Rest\Model\RequestAdapter;
 
@@ -26,9 +27,17 @@ public function __construct(
     ) {
     }
 
+    /**
+     * @inheirtDoc
+     */
     public function execute(string $adapterName, array $rawData = []): mixed
     {
-        $requestAdapterName = new ReflectionClass($adapterName);
+        try {
+            $requestAdapterName = new ReflectionClass($adapterName);
+        } catch (ReflectionException $e) {
+            throw new LogicException(__($adapterName . ' must be an instance of RequestAdapter'), $e);
+        }
+
         if (!$requestAdapterName->isSubclassOf(RequestAdapter::class)) {
             throw new LogicException(__($requestAdapterName . ' must be an instance of RequestAdapter'));
         }

diff --git a/Service/ApiPoolInterface.php b/Service/ApiPoolInterface.php
@@ -15,12 +15,23 @@
 
 namespace Zepgram\Rest\Service;
 
+use Zepgram\Rest\Exception\ExternalException;
+use Zepgram\Rest\Exception\InternalException;
+use Zepgram\Rest\Exception\Technical\InvalidContractException;
+use Zepgram\Rest\Exception\Technical\LogicException;
+use Zepgram\Rest\Exception\Technical\MissingBaseUriException;
+
 interface ApiPoolInterface
 {
     /**
      * @param string $adapterName
      * @param array $rawData
      * @return mixed
+     * @throws InternalException
+     * @throws InvalidContractException
+     * @throws LogicException
+     * @throws MissingBaseUriException
+     * @throws ExternalException
      */
     public function execute(string $adapterName, array $rawData = []): mixed;
 }