VAPI-2823 Implement BRTC Endpoints API with models, controllers, and tests

.github/workflows/test.yml

@@ -35,6 +35,8 @@ jobs:
         BW_ACCOUNT_ID: ${{ secrets.BW_ACCOUNT_ID }}
         BW_USERNAME: ${{ secrets.BW_USERNAME }}
         BW_PASSWORD: ${{ secrets.BW_PASSWORD }}
+        BW_CLIENT_ID: ${{ secrets.BW_CLIENT_ID }}
+        BW_CLIENT_SECRET: ${{ secrets.BW_CLIENT_SECRET }}
         BW_VOICE_APPLICATION_ID: ${{ secrets.BW_VOICE_APPLICATION_ID }}
         BW_MESSAGING_APPLICATION_ID: ${{ secrets.BW_MESSAGING_APPLICATION_ID }}
         BW_NUMBER: ${{ secrets.BW_NUMBER }}

.gitignore

@@ -4,3 +4,4 @@ composer.lock
 .phpunit.result.cache
 composer.phar
 .idea
+.env*

src/Controllers/BaseController.php

@@ -82,37 +82,9 @@ protected function validateResponse(HttpResponse $response, HttpContext $_httpCo
      */
     protected function configureAuth(&$headers, $authType)
     {
-        if (!empty($this->config->getAccessToken()) && 
-            (empty($this->config->getAccessTokenExpiration()) || 
-            $this->config->getAccessTokenExpiration() > time() + 60)
-        ) {
-            $headers['Authorization'] = 'Bearer ' . $this->config->getAccessToken();
-            return;
-        }
-
-        if (!empty($this->config->getClientId()) && !empty($this->config->getClientSecret())) {
-            $_tokenUrl = 'https://api.bandwidth.com/api/v1/oauth2/token';
-            $_tokenHeaders = array (
-                'User-Agent'    => BaseController::USER_AGENT,
-                'Content-Type'  => 'application/x-www-form-urlencoded',
-                'Authorization' => 'Basic ' . base64_encode(
-                    $this->config->getClientId() . ':' . $this->config->getClientSecret()
-                )
-            );
-            $_tokenBody = Request\Body::Form([
-                'grant_type' => 'client_credentials'
-            ]);
-            $response = Request::post($_tokenUrl, $_tokenHeaders, $_tokenBody);
-            $this->config->setAccessToken($response->body->access_token);
-            $this->config->setAccessTokenExpiration(time() + $response->body->expires_in);
-            $headers['Authorization'] = 'Bearer ' . $this->config->getAccessToken();
-
-            return;
-        }
-
         $username = '';
         $password = '';
-        
+
         switch ($authType) {
             case 'messaging':
                 $username = $this->config->getMessagingBasicAuthUserName();
@@ -135,7 +107,44 @@ protected function configureAuth(&$headers, $authType)
                 $password = $this->config->getMultiFactorAuthBasicAuthPassword();
                 break;
         }
-        
+
         Request::auth($username, $password);
     }
+
+    /**
+     * Configure OAuth2 Bearer auth for BRTC endpoints using client credentials.
+     * Sets the Authorization header directly to avoid conflicts with Unirest's
+     * global Request::auth() state.
+     *
+     * @param array $headers The headers for the request (passed by reference)
+     */
+    protected function configureOAuth2Auth(&$headers)
+    {
+        // Clear any global state set by prior configureAuth() calls so
+        // Unirest doesn't interfere with the token request.
+        Request::auth('', '');
+        Request::clearDefaultHeaders();
+        $response = Request::post(
+            'https://api.bandwidth.com/api/v1/oauth2/token',
+            [
+                'Content-Type'  => 'application/x-www-form-urlencoded',
+                'Authorization' => 'Basic ' . base64_encode(
+                    $this->config->getClientId() . ':' . $this->config->getClientSecret()
+                ),
+            ],
+            \Unirest\Request\Body::Form(['grant_type' => 'client_credentials'])
+        );
+
+        if ($response->code < 200 || $response->code > 299 || !isset($response->body->access_token)) {
+            throw new \RuntimeException(
+                "OAuth2 token request failed | status: {$response->code} | response: {$response->raw_body}"
+            );
+        }
+
+        $this->config->setAccessToken($response->body->access_token);
+        $this->config->setAccessTokenExpiration(time() + $response->body->expires_in);
+
+        $headers['Authorization'] = 'Bearer ' . $response->body->access_token;
+    }
+
 }

src/Voice/Bxml/Connect.php

@@ -0,0 +1,54 @@
+<?php
+/**
+ * Connect.php
+ *
+ * Implementation of the BXML Connect verb for BRTC endpoints
+ *
+ * @copyright Bandwidth INC
+ */
+
+namespace BandwidthLib\Voice\Bxml;
+
+use DOMDocument;
+use DOMElement;
+
+require_once "Verb.php";
+
+class Connect extends Verb {
+    /**
+     * @var array
+     */
+    private $endpoints;
+
+    /**
+     * @param array $endpoints Array of Endpoint objects
+     */
+    public function __construct(array $endpoints = []) {
+        $this->endpoints = $endpoints;
+    }
+
+    /**
+     * Add an Endpoint to the Connect verb
+     *
+     * @param Endpoint $endpoint
+     * @return $this
+     */
+    public function addEndpoint(Endpoint $endpoint): Connect {
+        $this->endpoints[] = $endpoint;
+        return $this;
+    }
+
+    /**
+     * Converts the Connect verb into a DOMElement
+     *
+     * @param DOMDocument $doc
+     * @return DOMElement
+     */
+    public function toBxml(DOMDocument $doc): DOMElement {
+        $element = $doc->createElement("Connect");
+        foreach ($this->endpoints as $endpoint) {
+            $element->appendChild($endpoint->toBxml($doc));
+        }
+        return $element;
+    }
+}

src/Voice/Bxml/Endpoint.php

@@ -0,0 +1,41 @@
+<?php
+/**
+ * Endpoint.php
+ *
+ * Implementation of the BXML Endpoint verb for BRTC endpoints
+ *
+ * @copyright Bandwidth INC
+ */
+
+namespace BandwidthLib\Voice\Bxml;
+
+use DOMDocument;
+use DOMElement;
+
+require_once "Verb.php";
+
+class Endpoint extends Verb {
+    /**
+     * @var string
+     */
+    private $id;
+
+    /**
+     * @param string $id The endpointId to connect to
+     */
+    public function __construct(string $id) {
+        $this->id = $id;
+    }
+
+    /**
+     * Converts the Endpoint verb into a DOMElement
+     *
+     * @param DOMDocument $doc
+     * @return DOMElement
+     */
+    public function toBxml(DOMDocument $doc): DOMElement {
+        $element = $doc->createElement("Endpoint");
+        $element->setAttribute("id", $this->id);
+        return $element;
+    }
+}