Add plugin client builder

Author: Taluu

src/PluginClientBuilder.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Http\Client\Common;
+
+use Http\Client\HttpAsyncClient;
+use Psr\Http\Client\ClientInterface;
+
+/**
+ * Build an instance of a PluginClient with a dynamic list of plugins.
+ *
+ * @author Baptiste Clavié <[email protected]>
+ */
+final class PluginClientBuilder
+{
+    /** @var Plugin[][] */
+    private $plugins = [];
+
+    public function addPlugin(Plugin $plugin, int $priority = 0): self
+    {
+        $this->plugins[$priority][] = $plugin;
+
+        return $this;
+    }
+
+    /**
+     * @param ClientInterface | HttpAsyncClient $client
+     */
+    public function createClient($client, array $options = []): PluginClient
+    {
+        if (!$client instanceof ClientInterface && !$client instanceof HttpAsyncClient) {
+            throw new \RuntimeException('You must provide a valid http client');
+        }
+
+        $plugins = $this->plugins;
+
+        if (count($plugins) > 0) {
+            krsort($plugins);
+            $plugins = array_merge(...$plugins);
+        }
+
+        return new PluginClient(
+            $client,
+            array_values($plugins),
+            $options
+        );
+    }
+}