@yxw007/translate 0.3.2 → 0.4.0

package/dist/node/index.cjs

@@ -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
 'use strict';
 
 Object.defineProperty(exports, '__esModule', { value: true });
@@ -17,6 +17,14 @@ class TranslationError extends Error {
         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",
@@ -202,7 +210,7 @@ function isOverMaxCharacterNum(text, max_character_num) {
     return total > max_character_num;
 }
 
-function google(options) {
+function google$1(options) {
     const base = "https://translate.googleapis.com/translate_a/single";
     return {
         name: "google",
@@ -231,13 +239,29 @@ function google(options) {
             }
             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 = () => {
@@ -270,7 +294,7 @@ function azure$1(options) {
             }
             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) {
@@ -285,10 +309,35 @@ function azure$1(options) {
             }
             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 = () => {
@@ -319,6 +368,28 @@ function amazon$1(options) {
             }
             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}`);
+            }
+        },
     };
 }
 
@@ -1411,7 +1482,7 @@ function requireCore () {
 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";
@@ -1452,7 +1523,7 @@ function baidu$1(options) {
             }
             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) {
@@ -1462,10 +1533,35 @@ function baidu$1(options) {
             }
             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 = () => {
@@ -1512,6 +1608,39 @@ function deepl$2(options) {
             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;
+        },
     };
 }
 
@@ -1646,7 +1775,7 @@ function buildAuthorization({ secretId, secretKey, service, host, payload, httpR
         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";
@@ -1694,7 +1823,7 @@ function tencent$2(options) {
                 }
                 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) {
@@ -1708,20 +1837,63 @@ function tencent$2(options) {
                 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",
@@ -2105,7 +2277,7 @@ var openai = {
     Zulu: "zu",
 };
 
-var baidu = {
+var baidu$1 = {
     Achinese: "ach",
     Afrikaans: "afr",
     Akan: "aka",
@@ -2316,7 +2488,7 @@ var baidu = {
     Zulu: "zul",
 };
 
-var deepl$1 = {
+var deepl$2 = {
     English: "en",
     Bulgarian: "bg",
     Chinese: "zh",
@@ -2352,7 +2524,7 @@ var deepl$1 = {
     Ukrainian: "uk",
 };
 
-var tencent$1 = {
+var tencent$2 = {
     Auto: "auto",
     Chinese: "zh",
     TraditionalChinese: "zh-TW",
@@ -2374,7 +2546,7 @@ var tencent$1 = {
     Hindi: "hi",
 };
 
-var amazon = {
+var amazon$1 = {
     Afrikaans: "af",
     Albanian: "sq",
     Amharic: "am",
@@ -2453,16 +2625,16 @@ var amazon = {
 };
 
 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",
@@ -2501,7 +2673,7 @@ var deepl = {
     Ukrainian: "uk",
 };
 
-var tencent = {
+var tencent$1 = {
     "Simplified Chinese": "zh",
     "Traditional Chinese": "zh-TW",
     English: "en",
@@ -2523,13 +2695,197 @@ var tencent = {
 };
 
 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) {
@@ -2610,6 +2966,42 @@ class Translator {
         }
         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;
@@ -2621,7 +3013,7 @@ class Translator {
         }
         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}`);
@@ -2709,11 +3101,17 @@ var index = {
 };
 
 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;
 //# sourceMappingURL=index.cjs.map