docs: fixes and improvements

Author: andrepimpao

README.md

@@ -13,7 +13,7 @@ A library for creating SDKs in PHP with support for:
 - Event listeners;
 - ...and more.
 
-All methods are public for full end user hackability 🔥.
+All methods are public for full hackability 🔥.
 
 ## Requirements
 
@@ -527,7 +527,7 @@ Event listeners are then executed from the highest priority to the lowest:
 
 ```php
 use ProgrammatorDev\Api\Api;
-use ProgrammatorDev\Api\Event\PostRequestEvent;
+use ProgrammatorDev\Api\Event\ResponseContentsEvent;
 
 class YourApi extends Api
 {
@@ -538,13 +538,13 @@ class YourApi extends Api
 
         // executed last (lower priority)
         $this->addResponseContentsListener(
-            listener: function(PostRequestEvent $event) { ... }, 
+            listener: function(ResponseContentsEvent $event) { ... }, 
             priority: 0
         );
 
         // executed first (higher priority)
         $this->addResponseContentsListener(
-            listener: function(PostRequestEvent $event) { ... }, 
+            listener: function(ResponseContentsEvent $event) { ... }, 
             priority: 10
         ); 
     }
@@ -558,21 +558,21 @@ For that, you can use the `stopPropagation()` method:
 
 ```php
 use ProgrammatorDev\Api\Api;
-use ProgrammatorDev\Api\Event\PostRequestEvent;
+use ProgrammatorDev\Api\Event\ResponseContentsEvent;
 
 class YourApi extends Api
 {
     public function __construct() 
     {
-        $this->addResponseContentsListener(function(PostRequestEvent $event) {
+        $this->addResponseContentsListener(function(ResponseContentsEvent $event) {
             // stop propagation so future listeners of this event will not be called
             $event->stopPropagation();
         });
 
         // this listener will not be called
-        $this->addResponseContentsListener(function(PostRequestEvent $event) { 
+        $this->addResponseContentsListener(function(ResponseContentsEvent $event) { 
             // ...
-         }); 
+        }); 
     }
 }
 ```
@@ -849,11 +849,11 @@ class YourApi extends Api
     {
         parent::__construct();
 
-        $this->configureOptions($options);
+        $this->options = $this->configureOptions($options);
         $this->configureApi();
     }
 
-    private function configureOptions(array $options): void
+    private function configureOptions(array $options): array
     {
         // set defaults values, if none were provided
         $this->optionsResolver->setDefault('timezone', 'UTC');
@@ -867,8 +867,8 @@ class YourApi extends Api
         $this->optionsResolver->setAllowedValues('timezone', \DateTimeZone::listIdentifiers());
         $this->optionsResolver->setAllowedValues('language', ['en', 'pt']);
 
-        // resolve and set to options property
-        $this->options = $this->optionsResolver->resolve($options);
+        // return resolved options
+        return $this->optionsResolver->resolve($options);
     }
 
     private function configureApi(): void

src/Api.php

@@ -102,16 +102,22 @@ public function request(
     private function configurePlugins(): void
     {
         // https://docs.php-http.org/en/latest/plugins/content-type.html
-        $this->clientBuilder->addPlugin(new ContentTypePlugin(), 40);
+        $this->clientBuilder->addPlugin(
+            plugin: new ContentTypePlugin(),
+            priority: 40
+        );
 
         // https://docs.php-http.org/en/latest/plugins/content-length.html
-        $this->clientBuilder->addPlugin(new ContentLengthPlugin(), 32);
+        $this->clientBuilder->addPlugin(
+            plugin: new ContentLengthPlugin(),
+            priority: 32
+        );
 
         // https://docs.php-http.org/en/latest/message/authentication.html
         if ($this->authentication) {
             $this->clientBuilder->addPlugin(
-                new AuthenticationPlugin($this->authentication),
-                24
+                plugin: new AuthenticationPlugin($this->authentication),
+                priority: 24
             );
         }
 
@@ -129,23 +135,23 @@ private function configurePlugins(): void
             }
 
             $this->clientBuilder->addPlugin(
-                new CachePlugin(
+                plugin: new CachePlugin(
                     $this->cacheBuilder->getPool(),
                     $this->clientBuilder->getStreamFactory(),
                     $cacheOptions
                 ),
-                16
+                priority: 16
             );
         }
 
         // https://docs.php-http.org/en/latest/plugins/logger.html
         if ($this->loggerBuilder) {
             $this->clientBuilder->addPlugin(
-                new LoggerPlugin(
+                plugin: new LoggerPlugin(
                     $this->loggerBuilder->getLogger(),
                     $this->loggerBuilder->getFormatter()
                 ),
-                8
+                priority: 8
             );
         }
     }