Add option to pass extra headers

Author: danmichaelo

config/alma.php

@@ -38,4 +38,14 @@
     */
     'baseUrl' => null,
 
+    /*
+    |--------------------------------------------------------------------------
+    | Extra request headers
+    |--------------------------------------------------------------------------
+    | An associated array of extra headers to be sent with each request.
+    */
+    'extraHeaders' => [
+        // 'x-proxy-auth' => 'custom proxy auth'
+    ],
+
 ];

src/Client.php

@@ -88,6 +88,9 @@ class Client
     /** @var float Number of seconds to sleep before retrying after a server error */
     public $sleepTimeOnServerError = 10;
 
+    /** @var array Extra request headers */
+    public $extraHeaders = [];
+
     /**
      * @var Conf
      */
@@ -118,6 +121,7 @@ class Client
      * @param ?RequestFactoryInterface $requestFactory
      * @param ?UriFactoryInterface     $uriFactory
      * @param ?string                  $baseUrl
+     * @param array                    $extraHeaders
      *
      * @throws \ErrorException
      */
@@ -128,7 +132,8 @@ public function __construct(
         HttpClientInterface $http = null,
         RequestFactoryInterface $requestFactory = null,
         UriFactoryInterface $uriFactory = null,
-        string $baseUrl = null
+        string $baseUrl = null,
+        array $extraHeaders = []
     ) {
         $this->http = new PluginClient(
             $http ?: HttpClient::client(),
@@ -148,6 +153,8 @@ public function __construct(
             $this->setRegion($region);
         }
 
+        $this->extraHeaders = $extraHeaders;
+
         $this->zone = $zone;
 
         $this->bibs = new Bibs($this);
@@ -163,7 +170,16 @@ public function __construct(
         $this->taskLists = new TaskLists($this);
 
         if ($zone == Zones::INSTITUTION) {
-            $this->nz = new self(null, $region, Zones::NETWORK, $this->http, $this->requestFactory, $this->uriFactory, $baseUrl);
+            $this->nz = new self(
+                null,
+                $region,
+                Zones::NETWORK,
+                $this->http,
+                $this->requestFactory,
+                $this->uriFactory,
+                $baseUrl,
+                $extraHeaders
+            );
         } elseif ($zone != Zones::NETWORK) {
             throw new AlmaClientException('Invalid zone name.');
         }
@@ -287,6 +303,9 @@ public function request(RequestInterface $request, $attempt = 1)
         if (!$this->key) {
             throw new AlmaClientException('No API key defined for ' . $this->zone);
         }
+        foreach ($this->extraHeaders as $key => $val) {
+            $request = $request->withHeader($key, $val);
+        }
 
         try {
             return $this->http->sendRequest($request);

src/Laravel/ServiceProvider.php

@@ -52,7 +52,8 @@ public function register()
                 isset($app[HttpClientInterface::class]) ? $app[HttpClientInterface::class] : null,
                 isset($app[RequestFactoryInterface::class]) ? $app[RequestFactoryInterface::class] : null,
                 isset($app[UriFactoryInterface::class]) ? $app[UriFactoryInterface::class] : null,
-                $app['config']->get('alma.baseUrl')
+                $app['config']->get('alma.baseUrl'),
+                $app['config']->get('alma.extraHeaders', [])
             );
 
             // Set network zone key, if any