VACMS-4222: Refactor and add tests for BRD frontend build class. (#4231)

* Throws exception when we fail to retrieve the Jenkins API token.

* VACMS-4222: Refactor in progress, adds test class.

* Factors out BRD client stuff into a separate Jenkins-specific client class.

* Sneaks in PHPStan through the back door.

* Ugh, fine.

* Fixes some issues turned up by static analysis.

* Adds SystemsManagerClient service, refactors JenkinsClient further, adds embryonic test for JenkinsClient.

* Factors out build-time recording into a separate service.

* Adds BuildTimeRecorderTest and SystemsManagerClientTest.

* Factors out Jenkins-specific HTTP client and middleware generation and adds an overarching BRD environment plugin class test.

Author: ndouglas

composer.json

@@ -13,6 +13,7 @@
     },
     "require": {
         "alchemy/zippy": "^0.4.9",
+        "aws/aws-sdk-php": "^3.173",
         "bower-asset/blazy": "^1.8",
         "bower-asset/cropper": "^4.1",
         "bower-asset/dropzone": "^5.5",
@@ -135,6 +136,7 @@
         "http-interop/http-factory-guzzle": "^1.0",
         "knplabs/github-api": "^2.12.1",
         "michelf/php-markdown": "^1.8",
+        "mikey179/vfsstream": "^1.6",
         "mouf/nodejs-installer": "^1.0",
         "npm-asset/yarn": "1.21.1",
         "oomphinc/composer-installers-extender": "1.1.2",

composer.lock

@@ -0,0 +1,39 @@
+<?php
+
+namespace Drupal\va_gov_build_trigger\Exception;
+
+use GuzzleHttp\Psr7\Response;
+
+/**
+ * A wrapper for exceptions that occur in the Jenkins client.
+ */
+class JenkinsClientException extends \Exception {
+
+  /**
+   * The Jenkins build job URL.
+   *
+   * @var string
+   */
+  public $buildJobUrl;
+
+  /**
+   * Create with a response object.
+   *
+   * @param \GuzzleHttp\Psr7\Response $response
+   *   An error response.
+   * @param string $buildJobUrl
+   *   The build job URL.
+   *
+   * @return \Drupal\va_gov_build_trigger\Exception\JenkinsClientException
+   *   An exception of this class.
+   */
+  public static function createWithResponse(Response $response, string $buildJobUrl): JenkinsClientException {
+    $statusCode = $response->getStatusCode();
+    $reasonPhrase = $response->getReasonPhrase();
+    $message = "Site rebuild failed with status code {$statusCode} {$reasonPhrase} and URL {$buildJobUrl}.";
+    $result = new static($message);
+    $result->buildJobUrl = $buildJobUrl;
+    return $result;
+  }
+
+}