DeepL machine translation

This adds support for DeepL machine translation. Both key types (commercial/free) are supported.

This also adds a `jenv` compatible `.java-version` file (using J14).

Author: zefixlluja

.java-version

@@ -0,0 +1 @@
+14.0

backend/app/src/main/kotlin/io/tolgee/api/v2/hateoas/machineTranslation/SuggestResultModel.kt

@@ -13,7 +13,8 @@ class SuggestResultModel(
     example = """
     {
       "GOOGLE": "This was translated by Google",
-      "AWS": "This was translated by AWS"
+      "AWS": "This was translated by AWS",
+      "DEEPL": "This was translated by DeepL"
     }
   """
   )

backend/data/src/main/kotlin/io/tolgee/component/machineTranslation/providers/DeeplTranslationProvider.kt

@@ -0,0 +1,109 @@
+package io.tolgee.component.machineTranslation.providers
+
+import com.fasterxml.jackson.annotation.JsonProperty
+import io.tolgee.configuration.tolgee.machineTranslation.DeeplMachineTranslationProperties
+import org.springframework.beans.factory.config.ConfigurableBeanFactory
+import org.springframework.context.annotation.Scope
+import org.springframework.http.HttpHeaders
+import org.springframework.http.MediaType
+import org.springframework.stereotype.Component
+import org.springframework.util.LinkedMultiValueMap
+import org.springframework.util.MultiValueMap
+import org.springframework.web.client.RestTemplate
+import org.springframework.web.client.postForEntity
+
+@Component
+@Scope(value = ConfigurableBeanFactory.SCOPE_SINGLETON)
+class DeeplTranslationProvider(
+    private val deeplMachineTranslationProperties: DeeplMachineTranslationProperties,
+    private val restTemplate: RestTemplate,
+) : AbstractMtValueProvider() {
+
+    override val isEnabled: Boolean
+        get() = !deeplMachineTranslationProperties.authKey.isNullOrEmpty()
+
+    override fun translateViaProvider(text: String, sourceTag: String, targetTag: String): String? {
+        val headers = HttpHeaders()
+        headers.contentType = MediaType.APPLICATION_FORM_URLENCODED
+
+        val requestBody: MultiValueMap<String, String> = LinkedMultiValueMap()
+        // Mandatory parameters
+        requestBody.add("auth_key", deeplMachineTranslationProperties.authKey)
+        requestBody.add("text", text)
+        requestBody.add("source_lang", sourceTag.uppercase())
+        requestBody.add("target_lang", targetTag.uppercase())
+        // Optional parameters
+        requestBody.add("formality", deeplMachineTranslationProperties.formality)
+
+        val response = restTemplate.postForEntity<DeeplResponse>(
+            apiEndpointFromKey(),
+            requestBody
+        )
+
+        return response.body?.translations?.first()?.text
+            ?: throw RuntimeException(response.toString())
+    }
+
+    /**
+     * Free API keys are identified by the ':fx' suffix, they also require a different endpoint.
+     */
+    private fun apiEndpointFromKey(): String {
+        if (deeplMachineTranslationProperties.authKey!!.endsWith(":fx")) {
+            return "https://api-free.deepl.com/v2/translate"
+        }
+        return "https://api.deepl.com/v2/translate"
+    }
+
+    /**
+     * Data structure for mapping the DeepL JSON response objects.
+     */
+    companion object {
+        class DeeplResponse {
+            @JsonProperty("translations")
+            var translations: List<DeeplTranslation>? = null
+        }
+
+        class DeeplTranslation {
+            @JsonProperty("detected_source_language")
+            var detectedSourceLanguage: String? = null
+
+            @JsonProperty("text")
+            var text: String? = null
+        }
+    }
+
+    override fun calculateProviderPrice(text: String): Int {
+        return text.length * 100
+    }
+
+    override val supportedLanguages = arrayOf(
+        "bg",
+        "cs",
+        "da",
+        "de",
+        "el",
+        "en",
+        "en-gb",
+        "en-us",
+        "es",
+        "et",
+        "fi",
+        "fr",
+        "hu",
+        "it",
+        "ja",
+        "lt",
+        "lv",
+        "nl",
+        "pl",
+        "pt",
+        "pt-pt",
+        "pt-br",
+        "ro",
+        "ru",
+        "sk",
+        "sl",
+        "sv",
+        "zh"
+    )
+}

backend/data/src/main/kotlin/io/tolgee/configuration/tolgee/machineTranslation/DeeplMachineTranslationProperties.kt

@@ -0,0 +1,11 @@
+package io.tolgee.configuration.tolgee.machineTranslation
+
+import org.springframework.boot.context.properties.ConfigurationProperties
+
+@ConfigurationProperties(prefix = "tolgee.machine-translation.deepl")
+open class DeeplMachineTranslationProperties(
+    override var defaultEnabled: Boolean = true,
+    override var defaultPrimary: Boolean = false,
+    var authKey: String? = null,
+    var formality: String = "default"
+) : MachineTranslationServiceProperties

backend/data/src/main/kotlin/io/tolgee/configuration/tolgee/machineTranslation/MachineTranslationProperties.kt

@@ -6,5 +6,6 @@ import org.springframework.boot.context.properties.ConfigurationProperties
 open class MachineTranslationProperties(
   var google: GoogleMachineTranslationProperties = GoogleMachineTranslationProperties(),
   var aws: AwsMachineTranslationProperties = AwsMachineTranslationProperties(),
+  var deepl: DeeplMachineTranslationProperties = DeeplMachineTranslationProperties(),
   var freeCreditsAmount: Long = -1,
 )

backend/data/src/main/kotlin/io/tolgee/constants/MtServiceType.kt

@@ -2,8 +2,10 @@ package io.tolgee.constants
 
 import io.tolgee.component.machineTranslation.MtValueProvider
 import io.tolgee.component.machineTranslation.providers.AwsMtValueProvider
+import io.tolgee.component.machineTranslation.providers.DeeplTranslationProvider
 import io.tolgee.component.machineTranslation.providers.GoogleTranslationProvider
 import io.tolgee.configuration.tolgee.machineTranslation.AwsMachineTranslationProperties
+import io.tolgee.configuration.tolgee.machineTranslation.DeeplMachineTranslationProperties
 import io.tolgee.configuration.tolgee.machineTranslation.GoogleMachineTranslationProperties
 import io.tolgee.configuration.tolgee.machineTranslation.MachineTranslationServiceProperties
 
@@ -12,5 +14,6 @@ enum class MtServiceType(
   val providerClass: Class<out MtValueProvider>
 ) {
   GOOGLE(GoogleMachineTranslationProperties::class.java, GoogleTranslationProvider::class.java),
-  AWS(AwsMachineTranslationProperties::class.java, AwsMtValueProvider::class.java);
+  AWS(AwsMachineTranslationProperties::class.java, AwsMtValueProvider::class.java),
+  DEEPL(DeeplMachineTranslationProperties::class.java, DeeplTranslationProvider::class.java);
 }

webapp/public/images/providers/deepl-logo.svg

@@ -42,6 +42,8 @@ export const LanguageRow: React.FC<Props> = ({ lang, providers, disabled }) => {
         return t('project_languages_primary_none', 'None');
       case 'GOOGLE':
         return 'Google';
+      case 'DEEPL':
+        return 'DeepL';
       default:
         return provider;
     }

webapp/src/views/projects/languages/MachineTranslation/LanguageRow.tsx

@@ -9,6 +9,8 @@ export const useProviderImg = () => {
         return '/images/providers/google-translate.svg';
       case 'AWS':
         return `/images/providers/aws-logo-${palette.mode}.svg`;
+      case 'DEEPL':
+        return `/images/providers/deepl-logo.svg`;
       default:
         return null;
     }