feat: support glossaryIds and document styleRule/translationMemory options

Author: BriannaDelgado

.gitlab-ci.yml

@@ -3,7 +3,7 @@ include:
     - project: '${CI_PROJECT_NAMESPACE}/ci-libs-for-client-libraries'
       file:
           - '/${CI_PROJECT_NAME}/.gitlab-ci.yml'
-    - project: 'deepl/ops/ci-cd-infrastructure/gitlab-ci-lib'
+    - project: 'deepl-org/deepl/devex/gitlab-ci-lib'
       file:
           - '/templates/.secret-detection.yml'
           - '/templates/.gitlab-release.yml'

CHANGELOG.md

@@ -5,11 +5,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- Added support for using multiple glossaries in text and document translation
+  via the `glossaryIds` option (up to 5 glossary IDs) in `TranslateTextOptions`
+  and `DocumentTranslateOptions`.
+- Added support for style rules in document translation via the `styleRule`
+  option in `DocumentTranslateOptions`.
+- Added support for translation memories in document translation via the
+  `translationMemory` and `translationMemoryThreshold` options in
+  `DocumentTranslateOptions`.
+
 ### Fixed
 - The debug log helper no longer crashes when axios error fields return a non-primitive from `toString` or `Symbol.toPrimitive`.
 
 ### Security
-- Bumped `axios` to `~1.15.2` to address 13 high-severity advisories.
+- Bumped `axios` to `^1.19.0`, `form-data` to `^3.0.5`, and `adm-zip` to
+  `^0.6.0` to resolve high-severity npm audit advisories in production
+  dependencies.
 
 ## [1.27.0] - 2026-04-27
 ### Changed

README.md

@@ -175,6 +175,10 @@ console.log(await deeplClient.translateText('How are you?', null, 'de', { formal
 -   `glossary`: specifies a glossary to use with translation, either as a string
     containing the glossary ID, or a `MultilingualGlossaryInfo`/`GlossaryInfo` as returned by
     `getMultilingualGlossary()`/`getGlossary()`.
+-   `glossaryIds`: specifies up to 5 glossaries to use with translation, as an array of
+    glossary ID strings, `MultilingualGlossaryInfo`, or `GlossaryInfo` objects. Glossaries are
+    applied in the order given, with the first matching term taking precedence. Requires
+    `sourceLang` to be set, and cannot be combined with the singular `glossary` option.
 -   `styleRule`: specifies a style rule to use with translation, either as a string
     containing the style rule ID, or a `StyleRuleInfo` as returned by `getAllStyleRules()`.
 -   `translationMemory`: specifies a translation memory to use with translation,
@@ -278,7 +282,10 @@ directly:
 
 -   `formality`: same as in [Text translation options](#text-translation-options).
 -   `glossary`: same as in [Text translation options](#text-translation-options).
+-   `glossaryIds`: same as in [Text translation options](#text-translation-options).
 -   `styleRule`: same as in [Text translation options](#text-translation-options).
+-   `translationMemory`: same as in [Text translation options](#text-translation-options).
+-   `translationMemoryThreshold`: same as in [Text translation options](#text-translation-options).
 -   `filename`: if the input file is not provided as file path, this option is
     needed to specify the file extension.
 -   `extraRequestParameters`: same as in [Text translation options](#text-translation-options).

package-lock.json

@@ -20,9 +20,9 @@
     ],
     "dependencies": {
         "@types/node": ">=12.0",
-        "adm-zip": "^0.5.16",
-        "axios": "~1.15.2",
-        "form-data": "^3.0.4",
+        "adm-zip": "^0.6.0",
+        "axios": "^1.19.0",
+        "form-data": "^3.0.5",
         "loglevel": ">=1.6.2"
     },
     "devDependencies": {

package.json

@@ -43,6 +43,7 @@ import {
 import {
     appendTextsAndReturnIsSingular,
     validateAndAppendTextOptions,
+    appendStyleAndTranslationMemoryOptions,
     nonRegionalLanguageCode,
     buildURLSearchParams,
     isFreeAccountAuthKey,
@@ -246,6 +247,7 @@ export class Translator {
             options?.formality,
             options?.glossary,
             options?.extraRequestParameters,
+            options?.glossaryIds,
         );
         // Always send show_billed_characters=1, remove when the API default is changed to true
         data.append('show_billed_characters', '1');
@@ -618,7 +620,9 @@ export class Translator {
             options?.formality,
             options?.glossary,
             options?.extraRequestParameters,
+            options?.glossaryIds,
         );
+        appendStyleAndTranslationMemoryOptions(data, options ?? {});
         const { statusCode, content } = await this.httpClient.sendRequestWithBackoff<string>(
             'POST',
             '/v2/document',