@aws-sdk/client-translate 3.438.0 → 3.441.0

package/dist-cjs/models/models_0.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TranslateDocumentResponseFilterSensitiveLog = exports.TranslatedDocumentFilterSensitiveLog = exports.TranslateDocumentRequestFilterSensitiveLog = exports.DocumentFilterSensitiveLog = exports.ImportTerminologyRequestFilterSensitiveLog = exports.TerminologyDataFilterSensitiveLog = exports.TextSizeLimitExceededException = exports.DetectedLanguageLowConfidenceException = exports.ServiceUnavailableException = exports.UnsupportedLanguagePairException = exports.InvalidFilterException = exports.UnsupportedDisplayLanguageCodeException = exports.DisplayLanguageCode = exports.MergeStrategy = exports.Directionality = exports.TerminologyDataFormat = exports.Profanity = exports.Formality = exports.JobStatus = exports.ResourceNotFoundException = exports.TooManyTagsException = exports.TooManyRequestsException = exports.LimitExceededException = exports.InvalidRequestException = exports.InvalidParameterValueException = exports.InternalServerException = exports.ParallelDataStatus = exports.ParallelDataFormat = exports.EncryptionKeyType = exports.ConflictException = exports.ConcurrentModificationException = void 0;
+exports.TranslateDocumentResponseFilterSensitiveLog = exports.TranslatedDocumentFilterSensitiveLog = exports.TranslateDocumentRequestFilterSensitiveLog = exports.DocumentFilterSensitiveLog = exports.ImportTerminologyRequestFilterSensitiveLog = exports.TerminologyDataFilterSensitiveLog = exports.TextSizeLimitExceededException = exports.DetectedLanguageLowConfidenceException = exports.ServiceUnavailableException = exports.UnsupportedLanguagePairException = exports.InvalidFilterException = exports.UnsupportedDisplayLanguageCodeException = exports.DisplayLanguageCode = exports.MergeStrategy = exports.Directionality = exports.TerminologyDataFormat = exports.Profanity = exports.Formality = exports.Brevity = exports.JobStatus = exports.ResourceNotFoundException = exports.TooManyTagsException = exports.TooManyRequestsException = exports.LimitExceededException = exports.InvalidRequestException = exports.InvalidParameterValueException = exports.InternalServerException = exports.ParallelDataStatus = exports.ParallelDataFormat = exports.EncryptionKeyType = exports.ConflictException = exports.ConcurrentModificationException = void 0;
 const smithy_client_1 = require("@smithy/smithy-client");
 const TranslateServiceException_1 = require("./TranslateServiceException");
 class ConcurrentModificationException extends TranslateServiceException_1.TranslateServiceException {
@@ -153,6 +153,9 @@ exports.JobStatus = {
     STOP_REQUESTED: "STOP_REQUESTED",
     SUBMITTED: "SUBMITTED",
 };
+exports.Brevity = {
+    ON: "ON",
+};
 exports.Formality = {
     FORMAL: "FORMAL",
     INFORMAL: "INFORMAL",

package/dist-es/models/models_0.js

@@ -141,6 +141,9 @@ export const JobStatus = {
     STOP_REQUESTED: "STOP_REQUESTED",
     SUBMITTED: "SUBMITTED",
 };
+export const Brevity = {
+    ON: "ON",
+};
 export const Formality = {
     FORMAL: "FORMAL",
     INFORMAL: "INFORMAL",

package/dist-types/commands/CreateParallelDataCommand.d.ts

@@ -37,8 +37,8 @@ export interface CreateParallelDataCommandOutput extends CreateParallelDataRespo
  *   Name: "STRING_VALUE", // required
  *   Description: "STRING_VALUE",
  *   ParallelDataConfig: { // ParallelDataConfig
- *     S3Uri: "STRING_VALUE", // required
- *     Format: "TSV" || "CSV" || "TMX", // required
+ *     S3Uri: "STRING_VALUE",
+ *     Format: "TSV" || "CSV" || "TMX",
  *   },
  *   EncryptionKey: { // EncryptionKey
  *     Type: "KMS", // required

package/dist-types/commands/DescribeTextTranslationJobCommand.d.ts

@@ -74,6 +74,7 @@ export interface DescribeTextTranslationJobCommandOutput extends DescribeTextTra
  * //     Settings: { // TranslationSettings
  * //       Formality: "FORMAL" || "INFORMAL",
  * //       Profanity: "MASK",
+ * //       Brevity: "ON",
  * //     },
  * //   },
  * // };

package/dist-types/commands/GetParallelDataCommand.d.ts

@@ -46,8 +46,8 @@ export interface GetParallelDataCommandOutput extends GetParallelDataResponse, _
  * //       "STRING_VALUE",
  * //     ],
  * //     ParallelDataConfig: { // ParallelDataConfig
- * //       S3Uri: "STRING_VALUE", // required
- * //       Format: "TSV" || "CSV" || "TMX", // required
+ * //       S3Uri: "STRING_VALUE",
+ * //       Format: "TSV" || "CSV" || "TMX",
  * //     },
  * //     Message: "STRING_VALUE",
  * //     ImportedDataSize: Number("long"),

package/dist-types/commands/ListParallelDataCommand.d.ts

@@ -48,8 +48,8 @@ export interface ListParallelDataCommandOutput extends ListParallelDataResponse,
  * //         "STRING_VALUE",
  * //       ],
  * //       ParallelDataConfig: { // ParallelDataConfig
- * //         S3Uri: "STRING_VALUE", // required
- * //         Format: "TSV" || "CSV" || "TMX", // required
+ * //         S3Uri: "STRING_VALUE",
+ * //         Format: "TSV" || "CSV" || "TMX",
  * //       },
  * //       Message: "STRING_VALUE",
  * //       ImportedDataSize: Number("long"),

package/dist-types/commands/ListTextTranslationJobsCommand.d.ts

@@ -81,6 +81,7 @@ export interface ListTextTranslationJobsCommandOutput extends ListTextTranslatio
  * //       Settings: { // TranslationSettings
  * //         Formality: "FORMAL" || "INFORMAL",
  * //         Profanity: "MASK",
+ * //         Brevity: "ON",
  * //       },
  * //     },
  * //   ],

package/dist-types/commands/StartTextTranslationJobCommand.d.ts

@@ -66,6 +66,7 @@ export interface StartTextTranslationJobCommandOutput extends StartTextTranslati
  *   Settings: { // TranslationSettings
  *     Formality: "FORMAL" || "INFORMAL",
  *     Profanity: "MASK",
+ *     Brevity: "ON",
  *   },
  * };
  * const command = new StartTextTranslationJobCommand(input);

package/dist-types/commands/TranslateDocumentCommand.d.ts

@@ -24,14 +24,12 @@ export interface TranslateDocumentCommandOutput extends TranslateDocumentRespons
 /**
  * @public
  * <p>Translates the input document from the source language to the target language.
- *       This synchronous operation supports plain text or HTML for the input document.
+ *       This synchronous operation supports text, HTML, or Word documents as the input document.
  *
  *       <code>TranslateDocument</code> supports translations from English to any supported language,
  *       and from any supported language to English. Therefore, specify either the source language code
  *       or the target language code as “en” (English).
  *     </p>
- *          <p>
- *             <code>TranslateDocument</code> does not support language auto-detection. </p>
  *          <p> If you set the <code>Formality</code> parameter, the request will fail if the target language does
  *        not support formality. For a list of target languages that support formality, see
  *        <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-formality.html">Setting formality</a>.
@@ -55,6 +53,7 @@ export interface TranslateDocumentCommandOutput extends TranslateDocumentRespons
  *   Settings: { // TranslationSettings
  *     Formality: "FORMAL" || "INFORMAL",
  *     Profanity: "MASK",
+ *     Brevity: "ON",
  *   },
  * };
  * const command = new TranslateDocumentCommand(input);
@@ -79,6 +78,7 @@ export interface TranslateDocumentCommandOutput extends TranslateDocumentRespons
  * //   AppliedSettings: { // TranslationSettings
  * //     Formality: "FORMAL" || "INFORMAL",
  * //     Profanity: "MASK",
+ * //     Brevity: "ON",
  * //   },
  * // };
  *

package/dist-types/commands/TranslateTextCommand.d.ts

@@ -41,6 +41,7 @@ export interface TranslateTextCommandOutput extends TranslateTextResponse, __Met
  *   Settings: { // TranslationSettings
  *     Formality: "FORMAL" || "INFORMAL",
  *     Profanity: "MASK",
+ *     Brevity: "ON",
  *   },
  * };
  * const command = new TranslateTextCommand(input);
@@ -63,6 +64,7 @@ export interface TranslateTextCommandOutput extends TranslateTextResponse, __Met
  * //   AppliedSettings: { // TranslationSettings
  * //     Formality: "FORMAL" || "INFORMAL",
  * //     Profanity: "MASK",
+ * //     Brevity: "ON",
  * //   },
  * // };
  *

package/dist-types/commands/UpdateParallelDataCommand.d.ts

@@ -35,8 +35,8 @@ export interface UpdateParallelDataCommandOutput extends UpdateParallelDataRespo
  *   Name: "STRING_VALUE", // required
  *   Description: "STRING_VALUE",
  *   ParallelDataConfig: { // ParallelDataConfig
- *     S3Uri: "STRING_VALUE", // required
- *     Format: "TSV" || "CSV" || "TMX", // required
+ *     S3Uri: "STRING_VALUE",
+ *     Format: "TSV" || "CSV" || "TMX",
  *   },
  *   ClientToken: "STRING_VALUE", // required
  * };

package/dist-types/models/models_0.d.ts

@@ -115,12 +115,12 @@ export interface ParallelDataConfig {
      * <p>The URI of the Amazon S3 folder that contains the parallel data input file. The folder
      *       must be in the same Region as the API endpoint you are calling.</p>
      */
-    S3Uri: string | undefined;
+    S3Uri?: string;
     /**
      * @public
      * <p>The format of the parallel data input file.</p>
      */
-    Format: ParallelDataFormat | undefined;
+    Format?: ParallelDataFormat;
 }
 /**
  * @public
@@ -468,6 +468,17 @@ export interface OutputDataConfig {
      */
     EncryptionKey?: EncryptionKey;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const Brevity: {
+    readonly ON: "ON";
+};
+/**
+ * @public
+ */
+export type Brevity = (typeof Brevity)[keyof typeof Brevity];
 /**
  * @public
  * @enum
@@ -493,13 +504,24 @@ export declare const Profanity: {
 export type Profanity = (typeof Profanity)[keyof typeof Profanity];
 /**
  * @public
- * <p>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.</p>
+ * <p>Settings to configure your translation output. You can configure the following options:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Brevity: reduces the length of the translation output for most translations. Available for
+ *             <code>TranslateText</code> only.</p>
+ *             </li>
+ *             <li>
+ *                <p>Formality: sets the formality level of the translation output.</p>
+ *             </li>
+ *             <li>
+ *                <p>Profanity: masks profane words and phrases in the translation output.</p>
+ *             </li>
+ *          </ul>
  */
 export interface TranslationSettings {
     /**
      * @public
-     * <p>You can optionally specify the desired level of formality for translations
+     * <p>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 <a href="https://en.wikipedia.org/wiki/Register_(sociolinguistics)">register</a>) in the
      *       translation output.  You can set the value to informal or formal. If you don't specify a value for
@@ -513,7 +535,7 @@ export interface TranslationSettings {
     Formality?: Formality;
     /**
      * @public
-     * <p>Enable the profanity setting if you want Amazon Translate to mask profane words and
+     * <p>You can enable the profanity setting if you want to mask profane words and
      *       phrases in your translation output.</p>
      *          <p>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
@@ -527,6 +549,17 @@ export interface TranslationSettings {
      *       language.</p>
      */
     Profanity?: Profanity;
+    /**
+     * @public
+     * <p>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.</p>
+     *          <p>If you turn on brevity for a translation request with an unsupported language pair, the
+     *       translation proceeds with the brevity setting turned off.</p>
+     *          <p>For the language pairs that brevity supports, see <a href="https://docs.aws.amazon.com/translate/latest/dg/customizing-translations-brevity">Using brevity</a> in the
+     *       Amazon Translate Developer Guide.</p>
+     */
+    Brevity?: Brevity;
 }
 /**
  * @public
@@ -1464,8 +1497,18 @@ export interface StartTextTranslationJobRequest {
     ClientToken?: string;
     /**
      * @public
-     * <p>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.</p>
+     * <p>Settings to configure your translation output. You can configure the following options:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Brevity: not supported.</p>
+     *             </li>
+     *             <li>
+     *                <p>Formality: sets the formality level of the output text.</p>
+     *             </li>
+     *             <li>
+     *                <p>Profanity: masks profane words and phrases in your translation output.</p>
+     *             </li>
+     *          </ul>
      */
     Settings?: TranslationSettings;
 }
@@ -1664,10 +1707,16 @@ export interface TranslateDocumentRequest {
     TerminologyNames?: string[];
     /**
      * @public
-     * <p>The language code for the language of the source text. Do not use <code>auto</code>, because
-     *       <code>TranslateDocument</code> does not support language auto-detection.
-     *       For a list of supported language codes, see
+     * <p>The language code for the language of the source text. For a list of supported language codes, see
      *       <a href="https://docs.aws.amazon.com/translate/latest/dg/what-is-languages.html">Supported languages</a>.</p>
+     *          <p>To have Amazon Translate determine the source language of your text, you can specify
+     *       <code>auto</code> in the <code>SourceLanguageCode</code> field. If you specify
+     *       <code>auto</code>, Amazon Translate will call <a href="https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-general.html">Amazon
+     *         Comprehend</a> to determine the source language.</p>
+     *          <note>
+     *             <p>If you specify <code>auto</code>, you must send the <code>TranslateDocument</code> request in a region that supports
+     *       Amazon Comprehend. Otherwise, the request returns an error indicating that autodetect is not supported. </p>
+     *          </note>
      */
     SourceLanguageCode: string | undefined;
     /**
@@ -1679,8 +1728,18 @@ export interface TranslateDocumentRequest {
     TargetLanguageCode: string | undefined;
     /**
      * @public
-     * <p>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.</p>
+     * <p>Settings to configure your translation output. You can configure the following options:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Brevity: not supported.</p>
+     *             </li>
+     *             <li>
+     *                <p>Formality: sets the formality level of the output text.</p>
+     *             </li>
+     *             <li>
+     *                <p>Profanity: masks profane words and phrases in your translation output.</p>
+     *             </li>
+     *          </ul>
      */
     Settings?: TranslationSettings;
 }
@@ -1722,8 +1781,19 @@ export interface TranslateDocumentResponse {
     AppliedTerminologies?: AppliedTerminology[];
     /**
      * @public
-     * <p>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.</p>
+     * <p>Settings to configure your translation output. You can configure the following options:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Brevity: reduces the length of the translation output for most translations. Available for
+     *             <code>TranslateText</code> only.</p>
+     *             </li>
+     *             <li>
+     *                <p>Formality: sets the formality level of the translation output.</p>
+     *             </li>
+     *             <li>
+     *                <p>Profanity: masks profane words and phrases in the translation output.</p>
+     *             </li>
+     *          </ul>
      */
     AppliedSettings?: TranslationSettings;
 }
@@ -1804,8 +1874,18 @@ export interface TranslateTextRequest {
     TargetLanguageCode: string | undefined;
     /**
      * @public
-     * <p>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.</p>
+     * <p>Settings to configure your translation output. You can configure the following options:</p>
+     *          <ul>
+     *             <li>
+     *                <p>Brevity: reduces the length of the translated output for most translations.</p>
+     *             </li>
+     *             <li>
+     *                <p>Formality: sets the formality level of the output text.</p>
+     *             </li>
+     *             <li>
+     *                <p>Profanity: masks profane words and phrases in your translation output.</p>
+     *             </li>
+     *          </ul>
      */
     Settings?: TranslationSettings;
 }

package/dist-types/ts3.4/models/models_0.d.ts

@@ -42,8 +42,8 @@ export declare const ParallelDataFormat: {
 export type ParallelDataFormat =
   (typeof ParallelDataFormat)[keyof typeof ParallelDataFormat];
 export interface ParallelDataConfig {
-  S3Uri: string | undefined;
-  Format: ParallelDataFormat | undefined;
+  S3Uri?: string;
+  Format?: ParallelDataFormat;
 }
 export interface Tag {
   Key: string | undefined;
@@ -162,6 +162,10 @@ export interface OutputDataConfig {
   S3Uri: string | undefined;
   EncryptionKey?: EncryptionKey;
 }
+export declare const Brevity: {
+  readonly ON: "ON";
+};
+export type Brevity = (typeof Brevity)[keyof typeof Brevity];
 export declare const Formality: {
   readonly FORMAL: "FORMAL";
   readonly INFORMAL: "INFORMAL";
@@ -174,6 +178,7 @@ export type Profanity = (typeof Profanity)[keyof typeof Profanity];
 export interface TranslationSettings {
   Formality?: Formality;
   Profanity?: Profanity;
+  Brevity?: Brevity;
 }
 export interface TextTranslationJobProperties {
   JobId?: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-translate",
   "description": "AWS SDK for JavaScript Translate Client for Node.js, Browser and React Native",
-  "version": "3.438.0",
+  "version": "3.441.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,9 +21,9 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.438.0",
-    "@aws-sdk/core": "3.436.0",
-    "@aws-sdk/credential-provider-node": "3.438.0",
+    "@aws-sdk/client-sts": "3.441.0",
+    "@aws-sdk/core": "3.441.0",
+    "@aws-sdk/credential-provider-node": "3.441.0",
     "@aws-sdk/middleware-host-header": "3.433.0",
     "@aws-sdk/middleware-logger": "3.433.0",
     "@aws-sdk/middleware-recursion-detection": "3.433.0",