@yxw007/translate 0.3.2 → 0.4.0

package/dist/browser/index.umd.js

@@ -1,4 +1,4 @@
-// translate v0.3.2 Copyright (c) 2025 Potter<aa4790139@gmail.com> and contributors
+// translate v0.4.0 Copyright (c) 2025 Potter<aa4790139@gmail.com> and contributors
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('fs/promises'), require('fs'), require('path'), require('@aws-sdk/client-translate'), require('crypto')) :
     typeof define === 'function' && define.amd ? define(['exports', 'fs/promises', 'fs', 'path', '@aws-sdk/client-translate', 'crypto'], factory) :
@@ -13,6 +13,14 @@
             Error.captureStackTrace(this, this.constructor);
         }
     }
+    class CheckLanguageError extends Error {
+        region;
+        constructor(region, message) {
+            super(message);
+            this.region = region;
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
     const OPEN_AI_MODELS = [
         "o1-preview",
         "o1-preview-2024-09-12",
@@ -198,7 +206,7 @@
         return total > max_character_num;
     }
 
-    function google(options) {
+    function google$1(options) {
         const base = "https://translate.googleapis.com/translate_a/single";
         return {
             name: "google",
@@ -227,13 +235,29 @@
                 }
                 return translations;
             },
+            async checkLanguage(text) {
+                const url = `${base}?client=gtx&sl=auto&tl=en&dt=t&q=${encodeURI(text)}`;
+                const res = await fetch(url);
+                if (!res.ok) {
+                    throw await throwResponseError(this.name, res);
+                }
+                const body = await res.json();
+                if (!body || body.length < 3) {
+                    throw new CheckLanguageError(this.name, "Check language fail! No result returned");
+                }
+                const detectedLanguage = body[2];
+                if (!detectedLanguage) {
+                    throw new CheckLanguageError(this.name, "Check language fail! Language not detected");
+                }
+                return detectedLanguage;
+            },
         };
     }
 
     /**
      * Azure translate documentation: https://learn.microsoft.com/zh-cn/azure/ai-services/translator/reference/v3-0-translate
      */
-    function azure$1(options) {
+    function azure$2(options) {
         const { key, region } = options;
         const name = "azure";
         const checkOptions = () => {
@@ -266,7 +290,7 @@
                 }
                 const bodyRes = await res.json();
                 if (bodyRes.error) {
-                    throw new TranslationError(this.name, `Translate fail ! code: ${bodyRes.error.code}, message: ${bodyRes.error.message}`);
+                    throw new TranslationError(this.name, `Translate fail ! code: ${bodyRes.error.code}, message: ${bodyRes.error.message} \n Go to https://learn.microsoft.com/zh-cn/azure/ai-services/translator/text-translation/reference/v3/translate view details`);
                 }
                 const body = bodyRes;
                 if (!body || body.length === 0) {
@@ -281,10 +305,35 @@
                 }
                 return translations;
             },
+            async checkLanguage(text) {
+                checkOptions();
+                const detectUrl = "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0";
+                const res = await fetch(detectUrl, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json; charset=UTF-8",
+                        "Ocp-Apim-Subscription-Key": key,
+                        "Ocp-Apim-Subscription-Region": region,
+                    },
+                    body: JSON.stringify([{ Text: text }]),
+                });
+                if (!res.ok) {
+                    throw await throwResponseError(this.name, res);
+                }
+                const response = await res.json();
+                if (!response || !Array.isArray(response) || response.length === 0) {
+                    throw new TranslationError(this.name, "Check language fail! No result returned");
+                }
+                const detection = response[0];
+                if (!detection.language) {
+                    throw new TranslationError(this.name, "Check language fail! Language not detected");
+                }
+                return detection.language;
+            },
         };
     }
 
-    function amazon$1(options) {
+    function amazon$2(options) {
         const { region, accessKeyId, secretAccessKey } = options;
         const name = "amazon";
         const checkOptions = () => {
@@ -315,6 +364,28 @@
                 }
                 return translations;
             },
+            async checkLanguage(text) {
+                checkOptions();
+                const translateClient = new clientTranslate.TranslateClient({
+                    region: region,
+                    credentials: { accessKeyId, secretAccessKey },
+                });
+                const command = new clientTranslate.TranslateTextCommand({
+                    SourceLanguageCode: "auto",
+                    TargetLanguageCode: "en",
+                    Text: text,
+                });
+                try {
+                    const response = await translateClient.send(command);
+                    if (!response.SourceLanguageCode) {
+                        throw new TranslationError(name, "Check language fail! Source language not detected");
+                    }
+                    return response.SourceLanguageCode;
+                }
+                catch (error) {
+                    throw new TranslationError(name, `Check language fail! ${error.message || error}`);
+                }
+            },
         };
     }
 
@@ -1441,7 +1512,7 @@
     var md5Exports = md5$1.exports;
     var md5 = /*@__PURE__*/getDefaultExportFromCjs(md5Exports);
 
-    function baidu$1(options) {
+    function baidu$2(options) {
         const { appId, secretKey } = options;
         const url = "https://fanyi-api.baidu.com/api/trans/vip/fieldtranslate";
         const name = "baidu";
@@ -1482,7 +1553,7 @@
                 }
                 const data = await res.json();
                 if (!data || data.error_code || !data.trans_result || data.trans_result.length === 0) {
-                    throw new TranslationError(this.name, `Translate fail ! error_code:${data.error_code}, error_msg: ${data.error_msg}`);
+                    throw new TranslationError(this.name, `Translate fail ! error_code:${data.error_code}, error_msg: ${data.error_msg} \n Go to https://fanyi-api.baidu.com/product/123 view details`);
                 }
                 const translations = [];
                 for (const translation of data.trans_result) {
@@ -1492,10 +1563,35 @@
                 }
                 return translations;
             },
+            async checkLanguage(text) {
+                checkOptions();
+                const salt = Date.now();
+                const sign = md5(`${appId}${text}${salt}${secretKey}`).toString();
+                const body = new URLSearchParams();
+                body.append("q", text);
+                body.append("appid", appId);
+                body.append("salt", salt.toString());
+                body.append("sign", sign);
+                const res = await fetch("https://fanyi-api.baidu.com/api/trans/vip/language", {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/x-www-form-urlencoded",
+                    },
+                    body: body.toString(),
+                });
+                if (!res.ok) {
+                    throw await throwResponseError(this.name, res);
+                }
+                const response = await res.json();
+                if (!response || response.error_code != 0) {
+                    throw new CheckLanguageError(this.name, `Check language fail ! error_code:${response.error_code}, error_msg: ${response.error_msg} \n Go to https://fanyi-api.baidu.com/product/143 view details`);
+                }
+                return response.data.src;
+            },
         };
     }
 
-    function deepl$2(options) {
+    function deepl$3(options) {
         const { key } = options;
         const name = "deepl";
         const checkOptions = () => {
@@ -1542,6 +1638,39 @@
                 const translations = body.map((t) => t.text);
                 return translations;
             },
+            async checkLanguage(text) {
+                checkOptions();
+                const res = await fetch(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json; charset=UTF-8",
+                        Authorization: `DeepL-Auth-Key ${key}`,
+                        Accept: "*/*",
+                        Host: "api-free.deepl.com",
+                        Connection: "keep-alive",
+                    },
+                    body: JSON.stringify({
+                        text: [text],
+                        target_lang: "EN",
+                    }),
+                });
+                if (!res.ok) {
+                    throw await throwResponseError(this.name, res);
+                }
+                const bodyRes = await res.json();
+                if (bodyRes.error) {
+                    throw new CheckLanguageError(this.name, `Check language fail ! code: ${bodyRes.error.code}, message: ${bodyRes.error.message}`);
+                }
+                const body = bodyRes.translations;
+                if (!body || body.length === 0) {
+                    throw new CheckLanguageError(this.name, "Check language fail! No result returned");
+                }
+                const detectedLanguage = body[0].detected_source_language;
+                if (!detectedLanguage) {
+                    throw new CheckLanguageError(this.name, "Check language fail! Language not detected");
+                }
+                return detectedLanguage;
+            },
         };
     }
 
@@ -1676,7 +1805,7 @@
             headers["X-TC-Region"] = region;
         return headers;
     }
-    function tencent$2(options) {
+    function tencent$3(options) {
         const { secretId, secretKey, region = "ap-guangzhou" } = options;
         const name = "tencent";
         const host = "tmt.tencentcloudapi.com";
@@ -1724,7 +1853,7 @@
                     }
                     const data = await res.json();
                     if (data.Response?.Error) {
-                        throw new TranslationError(name, `Tencent translate fail: ${data.Response.Error.Code}, ${data.Response.Error.Message}`);
+                        throw new TranslationError(name, `Tencent translate fail: ${data.Response.Error.Code}, ${data.Response.Error.Message} \n Go to https://cloud.tencent.com/document/product/551/15619 view details`);
                     }
                     const translatedResults = data.Response?.TargetText.split("\n") ?? [];
                     if (!Array.isArray(translatedResults) || translatedResults.length === 0) {
@@ -1738,20 +1867,63 @@
                     throw new TranslationError(name, `Translation failed: ${error}`);
                 }
             },
+            async checkLanguage(text) {
+                checkOptions();
+                const payloadObj = {
+                    Text: text,
+                    ProjectId: 0,
+                };
+                const payload = JSON.stringify(payloadObj);
+                const headers = buildAuthorization({
+                    secretId,
+                    secretKey,
+                    service,
+                    host,
+                    payload,
+                    httpRequestMethod: "POST",
+                    action: "LanguageDetect",
+                    apiVersion,
+                    region,
+                });
+                try {
+                    const res = await fetch(endpoint, {
+                        method: "POST",
+                        headers,
+                        body: payload,
+                    });
+                    if (!res.ok) {
+                        throw new CheckLanguageError(name, `HTTP ${res.status}: ${await res.text()}`);
+                    }
+                    const data = await res.json();
+                    if (data.Response?.Error) {
+                        throw new CheckLanguageError(name, `Tencent language detect fail: ${data.Response.Error.Code}, ${data.Response.Error.Message} \n Go to https://cloud.tencent.com/document/product/551/15620 view details`);
+                    }
+                    const detectedLanguage = data.Response?.Lang;
+                    if (!detectedLanguage) {
+                        throw new CheckLanguageError(name, "Language detect fail! No result returned");
+                    }
+                    return detectedLanguage;
+                }
+                catch (error) {
+                    if (error instanceof CheckLanguageError)
+                        throw error;
+                    throw new CheckLanguageError(name, `Language detection failed: ${error}`);
+                }
+            },
         };
     }
 
     const engines = {
-        google,
-        azure: azure$1,
-        amazon: amazon$1,
-        baidu: baidu$1,
-        deepl: deepl$2,
+        google: google$1,
+        azure: azure$2,
+        amazon: amazon$2,
+        baidu: baidu$2,
+        deepl: deepl$3,
         openai: openai$1,
-        tencent: tencent$2,
+        tencent: tencent$3,
     };
 
-    var azure = {
+    var azure$1 = {
         Afrikaans: "af",
         Albanian: "sq",
         Amharic: "am",
@@ -2135,7 +2307,7 @@
         Zulu: "zu",
     };
 
-    var baidu = {
+    var baidu$1 = {
         Achinese: "ach",
         Afrikaans: "afr",
         Akan: "aka",
@@ -2346,7 +2518,7 @@
         Zulu: "zul",
     };
 
-    var deepl$1 = {
+    var deepl$2 = {
         English: "en",
         Bulgarian: "bg",
         Chinese: "zh",
@@ -2382,7 +2554,7 @@
         Ukrainian: "uk",
     };
 
-    var tencent$1 = {
+    var tencent$2 = {
         Auto: "auto",
         Chinese: "zh",
         TraditionalChinese: "zh-TW",
@@ -2404,7 +2576,7 @@
         Hindi: "hi",
     };
 
-    var amazon = {
+    var amazon$1 = {
         Afrikaans: "af",
         Albanian: "sq",
         Amharic: "am",
@@ -2483,16 +2655,16 @@
     };
 
     const originLanguages = {
-        azure: azure,
+        azure: azure$1,
         google: openai,
-        baidu: baidu,
-        deepl: deepl$1,
-        amazon: amazon,
+        baidu: baidu$1,
+        deepl: deepl$2,
+        amazon: amazon$1,
         openai: openai,
-        tencent: tencent$1,
+        tencent: tencent$2,
     };
 
-    var deepl = {
+    var deepl$1 = {
         "American English": "en-US",
         "Brazilian Portuguese": "pt-BR",
         "British English": "en-GB",
@@ -2531,7 +2703,7 @@
         Ukrainian: "uk",
     };
 
-    var tencent = {
+    var tencent$1 = {
         "Simplified Chinese": "zh",
         "Traditional Chinese": "zh-TW",
         English: "en",
@@ -2553,13 +2725,197 @@
     };
 
     const targetLanguages = {
-        azure: azure,
+        azure: azure$1,
         google: openai,
-        baidu: baidu,
-        deepl: deepl,
-        amazon: amazon,
+        baidu: baidu$1,
+        deepl: deepl$1,
+        amazon: amazon$1,
         openai: openai,
+        tencent: tencent$1,
+    };
+
+    var baidu = {
+        Chinese: "zh",
+        English: "en",
+        Japanese: "jp",
+        Korean: "kor",
+        Thai: "th",
+        Russian: "ru",
+    };
+
+    var tencent = {
+        Chinese: "zh",
+        English: "en",
+        Japanese: "jp",
+        Korean: "kr",
+        German: "de",
+        French: "fr",
+        Spanish: "es",
+        Italian: "it",
+        Turkish: "tr",
+        Russian: "ru",
+        Portuguese: "pt",
+        Vietnamese: "vi",
+        Indonesian: "id",
+        Malay: "ms",
+        Thai: "th",
+    };
+
+    var azure = {
+        Arabic: "ar",
+        Bengali: "bn",
+        Bulgarian: "bg",
+        Catalan: "ca",
+        Chinese: "zh-Hans",
+        "Chinese (Traditional)": "zh-Hant",
+        Croatian: "hr",
+        Czech: "cs",
+        Danish: "da",
+        Dutch: "nl",
+        English: "en",
+        Finnish: "fi",
+        French: "fr",
+        German: "de",
+        Greek: "el",
+        Hebrew: "he",
+        Hindi: "hi",
+        Hungarian: "hu",
+        Indonesian: "id",
+        Italian: "it",
+        Japanese: "ja",
+        Korean: "ko",
+        Malay: "ms",
+        "Norwegian Bokmål": "nb",
+        Persian: "fa",
+        Polish: "pl",
+        "Portugal (Brazil)": "pt",
+        Romanian: "ro",
+        Russian: "ru",
+        Slovak: "sk",
+        Spanish: "es",
+        Swedish: "sv",
+        Thai: "th",
+        Turkish: "tr",
+        Ukrainian: "uk",
+        Urdu: "ur",
+        Vietnamese: "vi",
+    };
+
+    var amazon = {
+        Arabic: "ar",
+        Bengali: "bn",
+        Bulgarian: "bg",
+        Catalan: "ca",
+        Chinese: "zh-Hans",
+        "Chinese (Traditional)": "zh-Hant",
+        Croatian: "hr",
+        Czech: "cs",
+        Danish: "da",
+        Dutch: "nl",
+        English: "en",
+        Finnish: "fi",
+        French: "fr",
+        German: "de",
+        Greek: "el",
+        Hebrew: "he",
+        Hindi: "hi",
+        Hungarian: "hu",
+        Indonesian: "id",
+        Italian: "it",
+        Japanese: "ja",
+        Korean: "ko",
+        Malay: "ms",
+        Persian: "fa",
+        Polish: "pl",
+        "Portugal (Brazil)": "pt",
+        Romanian: "ro",
+        Russian: "ru",
+        Slovak: "sk",
+        Spanish: "es",
+        Swedish: "sv",
+        Thai: "th",
+        Turkish: "tr",
+        Ukrainian: "uk",
+        Urdu: "ur",
+        Vietnamese: "vi",
+    };
+
+    var deepl = {
+        "American English": "en",
+        Bulgarian: "bg",
+        Chinese: "zh",
+        Czech: "cs",
+        Danish: "da",
+        Dutch: "nl",
+        Estonian: "et",
+        Finnish: "fi",
+        French: "fr",
+        German: "de",
+        Greek: "el",
+        Hungarian: "hu",
+        Icelandic: "is",
+        Indonesian: "id",
+        Irish: "ga",
+        Italian: "it",
+        Japanese: "ja",
+        Korean: "ko",
+        Latvian: "lv",
+        Lithuanian: "lt",
+        Maltese: "mt",
+        Norwegian: "nb",
+        Polish: "pl",
+        Portuguese: "pt",
+        Romanian: "ro",
+        Russian: "ru",
+        Slovak: "sk",
+        Slovenian: "sl",
+        Spanish: "es",
+        Swedish: "sv",
+        Turkish: "tr",
+        Ukrainian: "uk",
+    };
+
+    var google = {
+        English: "en",
+        Bulgarian: "bg",
+        Chinese: "zh-cn",
+        Czech: "cs",
+        Danish: "da",
+        Dutch: "nl",
+        Estonian: "et",
+        Finnish: "fi",
+        French: "fr",
+        German: "de",
+        Greek: "el",
+        Hungarian: "hu",
+        Icelandic: "is",
+        Indonesian: "id",
+        Irish: "ga",
+        Italian: "it",
+        Japanese: "ja",
+        Korean: "ko",
+        Latvian: "lv",
+        Lithuanian: "lt",
+        Maltese: "mt",
+        Polish: "pl",
+        Portuguese: "pt",
+        Romanian: "ro",
+        Russian: "ru",
+        Slovak: "sk",
+        Slovenian: "sl",
+        Spanish: "es",
+        Swedish: "sv",
+        Turkish: "tr",
+        Ukrainian: "uk",
+    };
+
+    const checkLanguages = {
+        baidu: baidu,
         tencent: tencent,
+        azure: azure,
+        amazon: amazon,
+        deepl: deepl,
+        google: google,
     };
 
     function normalFromLanguage(from, engine) {
@@ -2640,6 +2996,42 @@
             }
             this.engines.delete(engineName);
         }
+        isSupportCheckLanguage(engineName) {
+            if (!engineName || !this.engines.has(engineName)) {
+                logger.warn("Engine name is required or not found");
+                return false;
+            }
+            const engine = this.engines.get(engineName);
+            if (!engine) {
+                logger.warn(`Engine ${engineName} not found`);
+                return false;
+            }
+            return !!engine.checkLanguage;
+        }
+        async checkLanguage(text, options) {
+            const { engine = "google", max_character_num = defaultMaxCharacterNum } = options;
+            if (!this.engines.has(engine)) {
+                throw new CheckLanguageError(appName, `Engine ${engine} not found`);
+            }
+            const engineInstance = this.engines.get(engine);
+            if (!engineInstance) {
+                throw new CheckLanguageError(appName, `Engine ${engine} is null`);
+            }
+            if (!engineInstance.checkLanguage) {
+                throw new CheckLanguageError(appName, `Engine ${engine} does not support checkLanguage method`);
+            }
+            const sample = max_character_num > 0 ? text.substring(0, max_character_num) : text;
+            if (sample.length <= 0) {
+                throw new TranslationError(appName, "Text is empty or too short to check language");
+            }
+            return engineInstance
+                .checkLanguage(sample)
+                .then((r) => r)
+                .catch((e) => {
+                logger.error(`${appName} Failed to check language for text: \n${getGapLine()}\n${text}\n${getGapLine()}\n error: ${getErrorMessages(e)}`);
+                throw e;
+            });
+        }
         async translate(text, options) {
             const { engine = "google", cache_time = 60 * 1000 } = options;
             let { from = "auto", to } = options;
@@ -2651,7 +3043,7 @@
             }
             const engineInstance = this.engines.get(engine);
             if (!engineInstance) {
-                throw new TranslationError(appName, `Engine ${engine} not found`);
+                throw new TranslationError(appName, `Engine ${engine} is null`);
             }
             if (!from) {
                 throw new TranslationError(appName, `Invalid origin language ${from}`);
@@ -2739,12 +3131,18 @@
     };
 
     exports.Cache = Cache;
+    exports.CheckLanguageError = CheckLanguageError;
     exports.OPEN_AI_MODELS = OPEN_AI_MODELS;
     exports.TranslationError = TranslationError;
     exports.Translator = Translator;
+    exports.checkLanguages = checkLanguages;
     exports.default = index;
     exports.engines = engines;
     exports.getLanguage = getLanguage;
+    exports.normalFromLanguage = normalFromLanguage;
+    exports.normalToLanguage = normalToLanguage;
+    exports.originLanguages = originLanguages;
+    exports.targetLanguages = targetLanguages;
     exports.translator = translator;
 
     Object.defineProperty(exports, '__esModule', { value: true });