Methods signature update

README update

README.md

@@ -141,7 +141,8 @@ class TestHandler implements HandlerInterface
 }
 ```
 
-### 
+- All handlers must implement [HandlerInterface](src/Http/HandlerInterface.php)
+- A handler is a middleware, handler is just a fancy name given to it.
 
 ### [Example](example)
 

src/Http/Handler.php

@@ -23,6 +23,12 @@ class Handler
     protected ResponseInterface $response;
 
 
+    /**
+     * Handler constructor.
+     * @param array $handlers
+     * @param ResponseInterface $response
+     * @throws InvalidArgumentException
+     */
     public function __construct(array $handlers, ResponseInterface $response)
     {
         $this->response = $response;

src/Http/HandlerInterface.php

@@ -5,12 +5,16 @@
 
 
 use Nette\Utils\JsonException;
+use Throwable;
 
 interface HandlerInterface
 {
     /**
+     * This serves like react's __invoke magic method,
+     * it will be called when request reach this handler
      * @param ResponseInterface $response
      * @throws JsonException
+     * @throws Throwable
      */
     public function handle(ResponseInterface $response): void;
 }

src/Http/Middleware.php

@@ -18,6 +18,7 @@ class Middleware
     /**
      * Middleware constructor.
      * @param HandlerInterface ...$handler
+     * @throws InvalidArgumentException
      */
     public function __construct(...$handler)
     {
@@ -32,6 +33,7 @@ public function __construct(...$handler)
      * @param ServerRequestInterface $request
      * @return PromiseInterface
      * @throws JsonException
+     * @throws InvalidArgumentException
      */
     public function __invoke(ServerRequestInterface $request): PromiseInterface
     {