feat(Project): support external OAuth

Closes #474

Author: jenschude

src/Core/Builder/Update/ProjectActionBuilder.php

@@ -10,6 +10,7 @@
 use Commercetools\Core\Request\Project\Command\ProjectChangeMessagesConfigurationAction;
 use Commercetools\Core\Request\Project\Command\ProjectChangeMessagesEnabledAction;
 use Commercetools\Core\Request\Project\Command\ProjectChangeNameAction;
+use Commercetools\Core\Request\Project\Command\ProjectSetExternalOAuthAction;
 use Commercetools\Core\Request\Project\Command\ProjectSetShippingRateInputTypeAction;
 
 class ProjectActionBuilder
@@ -82,6 +83,17 @@ public function changeName($action = null)
         return $this;
     }
 
+    /**
+     * @link https://docs.commercetools.com/http-api-projects-project.html#set-externaloauth
+     * @param ProjectSetExternalOAuthAction|callable $action
+     * @return $this
+     */
+    public function setExternalOAuth($action = null)
+    {
+        $this->addAction($this->resolveAction(ProjectSetExternalOAuthAction::class, $action));
+        return $this;
+    }
+
     /**
      * @link https://docs.commercetools.com/http-api-projects-project.html#set-shippingrateinputtype
      * @param ProjectSetShippingRateInputTypeAction|callable $action

src/Core/Model/Project/ExternalOAuth.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Commercetools\Core\Model\Project;
+
+use Commercetools\Core\Model\Common\Context;
+use Commercetools\Core\Model\Common\JsonObject;
+use Commercetools\Core\Model\Common\LocalizedEnumCollection;
+
+/**
+ * @package Commercetools\Core\Model\Project
+ * @link https://docs.commercetools.com/http-api-projects-project.html#externaloauth
+ * @method string getUrl()
+ * @method ExternalOAuth setUrl(string $url = null)
+ * @method string getAuthorizationHeader()
+ * @method ExternalOAuth setAuthorizationHeader(string $authorizationHeader = null)
+ */
+class ExternalOAuth extends JsonObject
+{
+    public function fieldDefinitions()
+    {
+        return [
+            'url' => [static::TYPE => 'string'],
+            'authorizationHeader' => [static::TYPE => 'string']
+        ];
+    }
+}

src/Core/Model/Project/Project.php

@@ -34,6 +34,8 @@
  * @method Project setVersion(int $version = null)
  * @method ShippingRateInputType getShippingRateInputType()
  * @method Project setShippingRateInputType(ShippingRateInputType $shippingRateInputType = null)
+ * @method ExternalOAuth getExternalOAuth()
+ * @method Project setExternalOAuth(ExternalOAuth $externalOAuth = null)
  */
 class Project extends JsonObject
 {
@@ -55,7 +57,8 @@ public function fieldDefinitions()
                 static::DECORATOR => DateTimeDecorator::class
             ],
             'messages' => [static::TYPE => MessagesConfiguration::class],
-            'shippingRateInputType' => [static::TYPE => ShippingRateInputType::class]
+            'shippingRateInputType' => [static::TYPE => ShippingRateInputType::class],
+            'externalOAuth' => [static::TYPE => ExternalOAuth::class]
         ];
     }
 }

src/Core/Request/Project/Command/ProjectSetExternalOAuthAction.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace Commercetools\Core\Request\Project\Command;
+
+use Commercetools\Core\Model\Common\Context;
+use Commercetools\Core\Model\Project\ExternalOAuth;
+use Commercetools\Core\Request\AbstractAction;
+
+/**
+ * @package Commercetools\Core\Request\Project\Command
+ * @link https://docs.commercetools.com/http-api-projects-project.html#set-externaloauth
+ * @method string getAction()
+ * @method ProjectSetExternalOAuthAction setAction(string $action = null)
+ * @method ExternalOAuth getExternalOAuth()
+ * @method ProjectSetExternalOAuthAction setExternalOAuth(ExternalOAuth $externalOAuth = null)
+ */
+class ProjectSetExternalOAuthAction extends AbstractAction
+{
+    public function fieldDefinitions()
+    {
+        return [
+            'action' => [static::TYPE => 'string'],
+            'externalOAuth' => [static::TYPE => ExternalOAuth::class],
+        ];
+    }
+
+    /**
+     * @param array $data
+     * @param Context|callable $context
+     */
+    public function __construct(array $data = [], $context = null)
+    {
+        parent::__construct($data, $context);
+        $this->setAction('setExternalOAuth');
+    }
+
+    /**
+     * @param ExternalOAuth $externalOAuth
+     * @param Context|callable $context
+     * @return ProjectSetExternalOAuthAction
+     */
+    public static function ofExternalOAuth(ExternalOAuth $externalOAuth, $context = null)
+    {
+        return static::of($context)->setExternalOAuth($externalOAuth);
+    }
+}

tests/integration/Project/ProjectUpdateRequestTest.php

@@ -5,6 +5,8 @@
 
 namespace Commercetools\Core\IntegrationTests\Project;
 
+use Commercetools\Core\Builder\Request\RequestBuilder;
+use Commercetools\Core\Builder\Update\ActionBuilder;
 use Commercetools\Core\IntegrationTests\ApiTestCase;
 use Commercetools\Core\Model\Common\LocalizedEnum;
 use Commercetools\Core\Model\Common\LocalizedEnumCollection;
@@ -13,13 +15,15 @@
 use Commercetools\Core\Model\Project\CartClassificationType;
 use Commercetools\Core\Model\Project\CartScoreType;
 use Commercetools\Core\Model\Project\CartValueType;
+use Commercetools\Core\Model\Project\ExternalOAuth;
 use Commercetools\Core\Model\Project\Project;
 use Commercetools\Core\Request\Project\Command\ProjectChangeCountriesAction;
 use Commercetools\Core\Request\Project\Command\ProjectChangeCurrenciesAction;
 use Commercetools\Core\Request\Project\Command\ProjectChangeLanguagesAction;
 use Commercetools\Core\Request\Project\Command\ProjectChangeMessagesConfigurationAction;
 use Commercetools\Core\Request\Project\Command\ProjectChangeMessagesEnabledAction;
 use Commercetools\Core\Request\Project\Command\ProjectChangeNameAction;
+use Commercetools\Core\Request\Project\Command\ProjectSetExternalOAuthAction;
 use Commercetools\Core\Request\Project\Command\ProjectSetShippingRateInputTypeAction;
 use Commercetools\Core\Request\Project\ProjectGetRequest;
 use Commercetools\Core\Request\Project\ProjectUpdateRequest;
@@ -280,4 +284,39 @@ public function testSetShippingRateInputTypeCartClassification()
         $response = $request->executeWithClient($this->getClient());
         $this->assertFalse($response->isError());
     }
+
+    public function testExternalOAuth()
+    {
+        $request = ProjectGetRequest::of();
+        $response = $request->executeWithClient($this->getClient());
+        $project = $request->mapResponse($response);
+
+        $this->assertInstanceOf(Project::class, $project);
+
+        $request = RequestBuilder::of()->project()->update($project)->setActions(
+            ActionBuilder::of()->project()->setExternalOAuth(function (ProjectSetExternalOAuthAction $action) {
+                $action->setExternalOAuth(
+                    ExternalOAuth::of()->setUrl("https://localhost")
+                        ->setAuthorizationHeader("Bearer")
+                );
+                return $action;
+            })->getActions()
+        );
+        $response = $request->executeWithClient($this->getClient());
+        $result = $request->mapResponse($response);
+
+        $this->assertInstanceOf(Project::class, $result);
+        $this->assertInstanceOf(ExternalOAuth::class, $result->getExternalOAuth());
+        $this->assertNotSame("Bearer", $result->getExternalOAuth()->getAuthorizationHeader());
+
+        $request = RequestBuilder::of()->project()->update($result)->setActions(
+            ActionBuilder::of()->project()->setExternalOAuth(function (ProjectSetExternalOAuthAction $action) {
+                return $action;
+            })->getActions()
+        );
+        $response = $request->executeWithClient($this->getClient());
+        $result = $request->mapResponse($response);
+        $this->assertFalse($response->isError());
+        $this->assertNull($result->getExternalOAuth());
+    }
 }