add PutRepositoryTriggers to CodeCommit client (#1308)

* add PutRepositoryTriggers to CodeCommit client

* fix docs copy/pasta

* phpstan knows what's best

* phpstan doesn't know best

* ignore this, phpstan

Co-authored-by: Neal Brooks <neali82@gmail.com>

Author: nealio82

src/CodeCommitClient.php

@@ -22,15 +22,31 @@
 use AsyncAws\CodeCommit\Exception\InvalidMaxResultsException;
 use AsyncAws\CodeCommit\Exception\InvalidPathException;
 use AsyncAws\CodeCommit\Exception\InvalidRepositoryNameException;
+use AsyncAws\CodeCommit\Exception\InvalidRepositoryTriggerBranchNameException;
+use AsyncAws\CodeCommit\Exception\InvalidRepositoryTriggerCustomDataException;
+use AsyncAws\CodeCommit\Exception\InvalidRepositoryTriggerDestinationArnException;
+use AsyncAws\CodeCommit\Exception\InvalidRepositoryTriggerEventsException;
+use AsyncAws\CodeCommit\Exception\InvalidRepositoryTriggerNameException;
+use AsyncAws\CodeCommit\Exception\InvalidRepositoryTriggerRegionException;
+use AsyncAws\CodeCommit\Exception\MaximumBranchesExceededException;
+use AsyncAws\CodeCommit\Exception\MaximumRepositoryTriggersExceededException;
 use AsyncAws\CodeCommit\Exception\PathDoesNotExistException;
 use AsyncAws\CodeCommit\Exception\RepositoryDoesNotExistException;
 use AsyncAws\CodeCommit\Exception\RepositoryNameRequiredException;
+use AsyncAws\CodeCommit\Exception\RepositoryTriggerBranchNameListRequiredException;
+use AsyncAws\CodeCommit\Exception\RepositoryTriggerDestinationArnRequiredException;
+use AsyncAws\CodeCommit\Exception\RepositoryTriggerEventsListRequiredException;
+use AsyncAws\CodeCommit\Exception\RepositoryTriggerNameRequiredException;
+use AsyncAws\CodeCommit\Exception\RepositoryTriggersListRequiredException;
 use AsyncAws\CodeCommit\Input\GetBlobInput;
 use AsyncAws\CodeCommit\Input\GetBranchInput;
 use AsyncAws\CodeCommit\Input\GetDifferencesInput;
+use AsyncAws\CodeCommit\Input\PutRepositoryTriggersInput;
 use AsyncAws\CodeCommit\Result\GetBlobOutput;
 use AsyncAws\CodeCommit\Result\GetBranchOutput;
 use AsyncAws\CodeCommit\Result\GetDifferencesOutput;
+use AsyncAws\CodeCommit\Result\PutRepositoryTriggersOutput;
+use AsyncAws\CodeCommit\ValueObject\RepositoryTrigger;
 use AsyncAws\Core\AbstractApi;
 use AsyncAws\Core\AwsError\AwsErrorFactoryInterface;
 use AsyncAws\Core\AwsError\JsonRpcAwsErrorFactory;
@@ -189,6 +205,70 @@ public function getDifferences($input): GetDifferencesOutput
         return new GetDifferencesOutput($response, $this, $input);
     }
 
+    /**
+     * Replaces all triggers for a repository. Used to create or delete triggers.
+     *
+     * @see https://docs.aws.amazon.com/codecommit/latest/APIReference/API_PutRepositoryTriggers.html
+     * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-codecommit-2015-04-13.html#putrepositorytriggers
+     *
+     * @param array{
+     *   repositoryName: string,
+     *   triggers: RepositoryTrigger[],
+     *   @region?: string,
+     * }|PutRepositoryTriggersInput $input
+     *
+     * @throws RepositoryDoesNotExistException
+     * @throws RepositoryNameRequiredException
+     * @throws InvalidRepositoryNameException
+     * @throws RepositoryTriggersListRequiredException
+     * @throws MaximumRepositoryTriggersExceededException
+     * @throws InvalidRepositoryTriggerNameException
+     * @throws InvalidRepositoryTriggerDestinationArnException
+     * @throws InvalidRepositoryTriggerRegionException
+     * @throws InvalidRepositoryTriggerCustomDataException
+     * @throws MaximumBranchesExceededException
+     * @throws InvalidRepositoryTriggerBranchNameException
+     * @throws InvalidRepositoryTriggerEventsException
+     * @throws RepositoryTriggerNameRequiredException
+     * @throws RepositoryTriggerDestinationArnRequiredException
+     * @throws RepositoryTriggerBranchNameListRequiredException
+     * @throws RepositoryTriggerEventsListRequiredException
+     * @throws EncryptionIntegrityChecksFailedException
+     * @throws EncryptionKeyAccessDeniedException
+     * @throws EncryptionKeyDisabledException
+     * @throws EncryptionKeyNotFoundException
+     * @throws EncryptionKeyUnavailableException
+     */
+    public function putRepositoryTriggers($input): PutRepositoryTriggersOutput
+    {
+        $input = PutRepositoryTriggersInput::create($input);
+        $response = $this->getResponse($input->request(), new RequestContext(['operation' => 'PutRepositoryTriggers', 'region' => $input->getRegion(), 'exceptionMapping' => [
+            'RepositoryDoesNotExistException' => RepositoryDoesNotExistException::class,
+            'RepositoryNameRequiredException' => RepositoryNameRequiredException::class,
+            'InvalidRepositoryNameException' => InvalidRepositoryNameException::class,
+            'RepositoryTriggersListRequiredException' => RepositoryTriggersListRequiredException::class,
+            'MaximumRepositoryTriggersExceededException' => MaximumRepositoryTriggersExceededException::class,
+            'InvalidRepositoryTriggerNameException' => InvalidRepositoryTriggerNameException::class,
+            'InvalidRepositoryTriggerDestinationArnException' => InvalidRepositoryTriggerDestinationArnException::class,
+            'InvalidRepositoryTriggerRegionException' => InvalidRepositoryTriggerRegionException::class,
+            'InvalidRepositoryTriggerCustomDataException' => InvalidRepositoryTriggerCustomDataException::class,
+            'MaximumBranchesExceededException' => MaximumBranchesExceededException::class,
+            'InvalidRepositoryTriggerBranchNameException' => InvalidRepositoryTriggerBranchNameException::class,
+            'InvalidRepositoryTriggerEventsException' => InvalidRepositoryTriggerEventsException::class,
+            'RepositoryTriggerNameRequiredException' => RepositoryTriggerNameRequiredException::class,
+            'RepositoryTriggerDestinationArnRequiredException' => RepositoryTriggerDestinationArnRequiredException::class,
+            'RepositoryTriggerBranchNameListRequiredException' => RepositoryTriggerBranchNameListRequiredException::class,
+            'RepositoryTriggerEventsListRequiredException' => RepositoryTriggerEventsListRequiredException::class,
+            'EncryptionIntegrityChecksFailedException' => EncryptionIntegrityChecksFailedException::class,
+            'EncryptionKeyAccessDeniedException' => EncryptionKeyAccessDeniedException::class,
+            'EncryptionKeyDisabledException' => EncryptionKeyDisabledException::class,
+            'EncryptionKeyNotFoundException' => EncryptionKeyNotFoundException::class,
+            'EncryptionKeyUnavailableException' => EncryptionKeyUnavailableException::class,
+        ]]));
+
+        return new PutRepositoryTriggersOutput($response);
+    }
+
     protected function getAwsErrorFactory(): AwsErrorFactoryInterface
     {
         return new JsonRpcAwsErrorFactory();

src/Enum/RepositoryTriggerEventEnum.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Enum;
+
+final class RepositoryTriggerEventEnum
+{
+    public const ALL = 'all';
+    public const CREATE_REFERENCE = 'createReference';
+    public const DELETE_REFERENCE = 'deleteReference';
+    public const UPDATE_REFERENCE = 'updateReference';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::ALL => true,
+            self::CREATE_REFERENCE => true,
+            self::DELETE_REFERENCE => true,
+            self::UPDATE_REFERENCE => true,
+        ][$value]);
+    }
+}

src/Exception/InvalidRepositoryTriggerBranchNameException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * One or more branch names specified for the trigger is not valid.
+ */
+final class InvalidRepositoryTriggerBranchNameException extends ClientException
+{
+}

src/Exception/InvalidRepositoryTriggerCustomDataException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The custom data provided for the trigger is not valid.
+ */
+final class InvalidRepositoryTriggerCustomDataException extends ClientException
+{
+}

src/Exception/InvalidRepositoryTriggerDestinationArnException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The Amazon Resource Name (ARN) for the trigger is not valid for the specified destination. The most common reason for
+ * this error is that the ARN does not meet the requirements for the service type.
+ */
+final class InvalidRepositoryTriggerDestinationArnException extends ClientException
+{
+}

src/Exception/InvalidRepositoryTriggerEventsException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * One or more events specified for the trigger is not valid. Check to make sure that all events specified match the
+ * requirements for allowed events.
+ */
+final class InvalidRepositoryTriggerEventsException extends ClientException
+{
+}

src/Exception/InvalidRepositoryTriggerNameException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The name of the trigger is not valid.
+ */
+final class InvalidRepositoryTriggerNameException extends ClientException
+{
+}

src/Exception/InvalidRepositoryTriggerRegionException.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The AWS Region for the trigger target does not match the AWS Region for the repository. Triggers must be created in
+ * the same Region as the target for the trigger.
+ */
+final class InvalidRepositoryTriggerRegionException extends ClientException
+{
+}

src/Exception/MaximumBranchesExceededException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The number of branches for the trigger was exceeded.
+ */
+final class MaximumBranchesExceededException extends ClientException
+{
+}

src/Exception/MaximumRepositoryTriggersExceededException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The number of triggers allowed for the repository was exceeded.
+ */
+final class MaximumRepositoryTriggersExceededException extends ClientException
+{
+}

src/Exception/RepositoryTriggerBranchNameListRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * At least one branch name is required, but was not specified in the trigger configuration.
+ */
+final class RepositoryTriggerBranchNameListRequiredException extends ClientException
+{
+}

src/Exception/RepositoryTriggerDestinationArnRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * A destination ARN for the target service for the trigger is required, but was not specified.
+ */
+final class RepositoryTriggerDestinationArnRequiredException extends ClientException
+{
+}

src/Exception/RepositoryTriggerEventsListRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * At least one event for the trigger is required, but was not specified.
+ */
+final class RepositoryTriggerEventsListRequiredException extends ClientException
+{
+}

src/Exception/RepositoryTriggerNameRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * A name for the trigger is required, but was not specified.
+ */
+final class RepositoryTriggerNameRequiredException extends ClientException
+{
+}

src/Exception/RepositoryTriggersListRequiredException.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\CodeCommit\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The list of triggers for the repository is required, but was not specified.
+ */
+final class RepositoryTriggersListRequiredException extends ClientException
+{
+}