Update generated code (#1599)

update generated code

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.283.13"
+        "${LATEST}": "3.283.16"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {

src/Service/Translate/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Added support for Brevity translation settings feature.
+
 ### Changed
 
 - Allow passing explicit null values for optional fields of input objects

src/Service/Translate/src/Enum/Brevity.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace AsyncAws\Translate\Enum;
+
+final class Brevity
+{
+    public const ON = 'ON';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::ON => true,
+        ][$value]);
+    }
+}

src/Service/Translate/src/Input/TranslateTextRequest.php

@@ -6,7 +6,9 @@
 use AsyncAws\Core\Input;
 use AsyncAws\Core\Request;
 use AsyncAws\Core\Stream\StreamFactory;
+use AsyncAws\Translate\Enum\Brevity;
 use AsyncAws\Translate\Enum\Formality;
+use AsyncAws\Translate\Enum\Profanity;
 use AsyncAws\Translate\ValueObject\TranslationSettings;
 
 final class TranslateTextRequest extends Input
@@ -68,8 +70,11 @@ final class TranslateTextRequest extends Input
     private $targetLanguageCode;
 
     /**
-     * Settings to configure your translation output, including the option to set the formality level of the output text and
-     * the option to mask profane words and phrases.
+     * Settings to configure your translation output. You can configure the following options:.
+     *
+     * - Brevity: reduces the length of the translated output for most translations.
+     * - Formality: sets the formality level of the output text.
+     * - Profanity: masks profane words and phrases in your translation output.
      *
      * @var TranslationSettings|null
      */

src/Service/Translate/src/Result/TranslateTextResponse.php

@@ -141,6 +141,7 @@ private function populateResultTranslationSettings(array $json): TranslationSett
         return new TranslationSettings([
             'Formality' => isset($json['Formality']) ? (string) $json['Formality'] : null,
             'Profanity' => isset($json['Profanity']) ? (string) $json['Profanity'] : null,
+            'Brevity' => isset($json['Brevity']) ? (string) $json['Brevity'] : null,
         ]);
     }
 }

src/Service/Translate/src/ValueObject/TranslationSettings.php

@@ -3,20 +3,24 @@
 namespace AsyncAws\Translate\ValueObject;
 
 use AsyncAws\Core\Exception\InvalidArgument;
+use AsyncAws\Translate\Enum\Brevity;
 use AsyncAws\Translate\Enum\Formality;
 use AsyncAws\Translate\Enum\Profanity;
 
 /**
- * Settings to configure your translation output, including the option to set the formality level of the output text and
- * the option to mask profane words and phrases.
+ * Settings to configure your translation output. You can configure the following options:.
+ *
+ * - Brevity: reduces the length of the translation output for most translations. Available for `TranslateText` only.
+ * - Formality: sets the formality level of the translation output.
+ * - Profanity: masks profane words and phrases in the translation output.
  */
 final class TranslationSettings
 {
     /**
-     * You can optionally specify the desired level of formality for translations to supported target languages. The
-     * formality setting controls the level of formal language usage (also known as register [^1]) in the translation
-     * output. You can set the value to informal or formal. If you don't specify a value for formality, or if the target
-     * language doesn't support formality, the translation will ignore the formality setting.
+     * You can specify the desired level of formality for translations to supported target languages. The formality setting
+     * controls the level of formal language usage (also known as register [^1]) in the translation output. You can set the
+     * value to informal or formal. If you don't specify a value for formality, or if the target language doesn't support
+     * formality, the translation will ignore the formality setting.
      *
      * If you specify multiple target languages for the job, translate ignores the formality setting for any unsupported
      * target language.
@@ -32,8 +36,7 @@ final class TranslationSettings
     private $formality;
 
     /**
-     * Enable the profanity setting if you want Amazon Translate to mask profane words and phrases in your translation
-     * output.
+     * You can enable the profanity setting if you want to mask profane words and phrases in your translation output.
      *
      * To mask profane words and phrases, Amazon Translate replaces them with the grawlix string “?$#@$“. This
      * 5-character sequence is used for each profane word or phrase, regardless of the length or number of words.
@@ -51,29 +54,55 @@ final class TranslationSettings
      */
     private $profanity;
 
+    /**
+     * When you turn on brevity, Amazon Translate reduces the length of the translation output for most translations (when
+     * compared with the same translation with brevity turned off). By default, brevity is turned off.
+     *
+     * If you turn on brevity for a translation request with an unsupported language pair, the translation proceeds with the
+     * brevity setting turned off.
+     *
+     * For the language pairs that brevity supports, see Using brevity [^1] in the Amazon Translate Developer Guide.
+     *
+     * [^1]: https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-brevity
+     *
+     * @var Brevity::*|null
+     */
+    private $brevity;
+
     /**
      * @param array{
      *   Formality?: null|Formality::*,
      *   Profanity?: null|Profanity::*,
+     *   Brevity?: null|Brevity::*,
      * } $input
      */
     public function __construct(array $input)
     {
         $this->formality = $input['Formality'] ?? null;
         $this->profanity = $input['Profanity'] ?? null;
+        $this->brevity = $input['Brevity'] ?? null;
     }
 
     /**
      * @param array{
      *   Formality?: null|Formality::*,
      *   Profanity?: null|Profanity::*,
+     *   Brevity?: null|Brevity::*,
      * }|TranslationSettings $input
      */
     public static function create($input): self
     {
         return $input instanceof self ? $input : new self($input);
     }
 
+    /**
+     * @return Brevity::*|null
+     */
+    public function getBrevity(): ?string
+    {
+        return $this->brevity;
+    }
+
     /**
      * @return Formality::*|null
      */
@@ -108,6 +137,12 @@ public function requestBody(): array
             }
             $payload['Profanity'] = $v;
         }
+        if (null !== $v = $this->brevity) {
+            if (!Brevity::exists($v)) {
+                throw new InvalidArgument(sprintf('Invalid parameter "Brevity" for "%s". The value "%s" is not a valid "Brevity".', __CLASS__, $v));
+            }
+            $payload['Brevity'] = $v;
+        }
 
         return $payload;
     }