@yxw007/translate 0.3.2 → 0.4.1

package/README.md

@@ -73,7 +73,7 @@ English | [简体中文](./README_zh-CN.md)
   const { translator, engines }  = required("@yxw007/translate")
   ```
 
-- example
+- Translation examples
   ```typescript
   translator.addEngine(engines.google());
   const res1 = await translator.translate("hello", { from: "en", to: "zh" });
@@ -83,11 +83,22 @@ English | [简体中文](./README_zh-CN.md)
   console.log(res2);
   ```
 
-  输出结果
+  Output results
   ```bash
   ['你好']
   ["你好", "好的"]
   ```
+- Language detection examples
+  ```typescript
+  translator.addEngine(engines.google());
+  const res1 = await translator.checkLanguage("hello", { engine:"google" });
+  console.log(res1);
+
+  ```
+  Output results
+  ```bash
+  en
+  ```
 
 ### Browser
 
@@ -363,6 +374,9 @@ export interface TencentEngineOption extends BaseEngineOption {
       const base = "https://translate.yandex.net/api/v1.5/tr.json/translate";
       return {
         name: "yandex",
+         async checkLanguage<T extends Engines>(text: string): Promise<string> {
+          //TODO: This can be done with translate, in which case the target language configuration is reused.
+        },
         async translate<T extends Engines>(text: string | string[], opts: EngineTranslateOptions<T>) {
           const { from, to } = opts;
           if (!Array.isArray(text)) {

package/README_zh-CN.md

@@ -76,7 +76,7 @@ Translate 是一个支持多翻译引擎的翻译工具库，它提供了一套
   const { translator, engines }  = required("@yxw007/translate")
   ```
 
-- example
+- 翻译例子
   ```typescript
   translator.addEngine(engines.google());
   const res1 = await translator.translate("hello", { from: "en", to: "zh" });
@@ -91,6 +91,17 @@ Translate 是一个支持多翻译引擎的翻译工具库，它提供了一套
   ['你好']
   ["你好", "好的"]
   ```
+- 语言检测例子
+  ```typescript
+  translator.addEngine(engines.google());
+  const res1 = await translator.checkLanguage("hello", { engine:"google" });
+  console.log(res1);
+  ```
+
+  输出结果
+  ```bash
+  en
+  ```
 
 ### Browser
 
@@ -365,6 +376,9 @@ export interface TencentEngineOption extends BaseEngineOption {
       const base = "https://translate.yandex.net/api/v1.5/tr.json/translate";
       return {
         name: "xx",
+        async checkLanguage<T extends Engines>(text: string): Promise<string> {
+          //TODO: 可以用translate来实现，这样的话就复用target语言配置
+        },
         async translate<T extends Engines>(text: string | string[], opts: EngineTranslateOptions<T>) {
           const { from, to } = opts;
           if (!Array.isArray(text)) {

package/dist/browser/index.cjs

@@ -1,4 +1,4 @@
-// translate v0.3.2 Copyright (c) 2025 Potter<aa4790139@gmail.com> and contributors
+// translate v0.4.1 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",
@@ -231,6 +239,22 @@ 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;
+        },
     };
 }
 
@@ -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,6 +309,34 @@ function azure$1(options) {
             }
             return translations;
         },
+        async checkLanguage(text) {
+            checkOptions();
+            const url = `${base}&to=en`;
+            const res = await fetch(url, {
+                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 bodyRes = await res.json();
+            if (bodyRes.error) {
+                throw new CheckLanguageError(this.name, `checkLanguage 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`);
+            }
+            if (!bodyRes || !Array.isArray(bodyRes) || bodyRes.length === 0) {
+                throw new CheckLanguageError(this.name, "Check language fail! No result returned");
+            }
+            const detectedLanguage = bodyRes[0]?.detectedLanguage?.language;
+            if (!detectedLanguage) {
+                throw new CheckLanguageError(this.name, "Check language fail! Language not detected");
+            }
+            return detectedLanguage;
+        },
     };
 }
 
@@ -319,6 +371,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}`);
+            }
+        },
     };
 }
 
@@ -1445,7 +1519,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";
@@ -1486,7 +1560,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) {
@@ -1496,6 +1570,31 @@ 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;
+        },
     };
 }
 
@@ -1546,6 +1645,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;
+        },
     };
 }
 
@@ -1728,7 +1860,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) {
@@ -1742,6 +1874,51 @@ function tencent$2(options) {
                 throw new TranslationError(name, `Translation failed: ${error}`);
             }
         },
+        async checkLanguage(text) {
+            checkOptions();
+            const payloadObj = {
+                SourceText: text,
+                Source: "auto",
+                Target: "en",
+                ProjectId: 0,
+            };
+            const payload = JSON.stringify(payloadObj);
+            const headers = buildAuthorization({
+                secretId,
+                secretKey,
+                service,
+                host,
+                payload,
+                httpRequestMethod: "POST",
+                action,
+                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/15619 view details`);
+                }
+                const detectedLanguage = data.Response?.Source;
+                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}`);
+            }
+        },
     };
 }
 
@@ -1749,7 +1926,7 @@ const engines = {
     google,
     azure: azure$1,
     amazon: amazon$1,
-    baidu: baidu$1,
+    baidu: baidu$2,
     deepl: deepl$2,
     openai: openai$1,
     tencent: tencent$2,
@@ -2139,7 +2316,7 @@ var openai = {
     Zulu: "zu",
 };
 
-var baidu = {
+var baidu$1 = {
     Achinese: "ach",
     Afrikaans: "afr",
     Akan: "aka",
@@ -2489,7 +2666,7 @@ var amazon = {
 const originLanguages = {
     azure: azure,
     google: openai,
-    baidu: baidu,
+    baidu: baidu$1,
     deepl: deepl$1,
     amazon: amazon,
     openai: openai,
@@ -2559,13 +2736,26 @@ var tencent = {
 const targetLanguages = {
     azure: azure,
     google: openai,
-    baidu: baidu,
+    baidu: baidu$1,
     deepl: deepl,
     amazon: amazon,
     openai: openai,
     tencent: tencent,
 };
 
+var baidu = {
+    Chinese: "zh",
+    English: "en",
+    Japanese: "jp",
+    Korean: "kor",
+    Thai: "th",
+    Russian: "ru",
+};
+
+const checkLanguages = Object.assign(Object.assign({}, originLanguages), {
+    baidu: baidu,
+});
+
 function normalFromLanguage(from, engine) {
     if (from === "auto") {
         return "auto";
@@ -2644,6 +2834,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;
@@ -2655,7 +2881,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}`);
@@ -2743,11 +2969,16 @@ 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