@yxw007/translate 0.0.14 → 0.0.16

package/dist/browser/index.cjs

@@ -1,4 +1,4 @@
-// translate v0.0.14 Copyright (c) 2024 Potter<aa4790139@gmail.com> and contributors
+// translate v0.0.16 Copyright (c) 2024 Potter<aa4790139@gmail.com> and contributors
 'use strict';
 
 Object.defineProperty(exports, '__esModule', { value: true });
@@ -6,6 +6,15 @@ Object.defineProperty(exports, '__esModule', { value: true });
 var clientTranslate = require('@aws-sdk/client-translate');
 var deeplEngine = require('deepl-node');
 
+class TranslationError extends Error {
+    region;
+    constructor(region, message) {
+        super(`${region}: ${message}`);
+        this.region = region;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+
 function google$1(options) {
     const base = "https://translate.googleapis.com/translate_a/single";
     return {
@@ -20,7 +29,7 @@ function google$1(options) {
             const res = await fetch(url);
             const body = await res.json();
             if (!body || body.length === 0) {
-                throw new Error("Translate fail ! translate's result is null or empty");
+                throw new TranslationError(this.name, "Translate fail ! translate's result is null or empty");
             }
             const translations = [];
             for (let i = 0; body[0] && i < body[0].length; i++) {
@@ -40,10 +49,18 @@ function google$1(options) {
  */
 function azure$1(options) {
     const { key, region } = options;
+    const name = "azure";
+    const checkOptions = () => {
+        if (!key || !region) {
+            throw new TranslationError(name, `${name} key and region is required`);
+        }
+    };
+    checkOptions();
     const base = "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0";
     return {
-        name: "azure",
+        name,
         async translate(text, opts) {
+            checkOptions();
             const { from, to } = opts;
             const url = `${base}&to=${to}${from && from !== "auto" ? `&from=${from}` : ""}`;
             if (!Array.isArray(text)) {
@@ -60,11 +77,11 @@ function azure$1(options) {
             });
             const bodyRes = await res.json();
             if (bodyRes.error) {
-                throw new Error(`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}`);
             }
             const body = bodyRes;
             if (!body || body.length === 0) {
-                throw new Error("Translate fail ! translate's result is null or empty");
+                throw new TranslationError(this.name, "Translate fail ! translate's result is null or empty");
             }
             const translations = [];
             for (const translation of body) {
@@ -80,9 +97,17 @@ function azure$1(options) {
 
 function amazon$1(options) {
     const { region, accessKeyId, secretAccessKey } = options;
+    const name = "amazon";
+    const checkOptions = () => {
+        if (!region || !accessKeyId || !secretAccessKey) {
+            throw new TranslationError(name, `${name} region, accessKeyId ,secretAccessKey is required`);
+        }
+    };
+    checkOptions();
     return {
-        name: "amazon",
+        name,
         async translate(text, opts) {
+            checkOptions();
             const { from = "auto", to } = opts;
             const translateClient = new clientTranslate.TranslateClient({ region: region, credentials: { accessKeyId, secretAccessKey } });
             if (!Array.isArray(text)) {
@@ -1230,9 +1255,17 @@ var md5 = /*@__PURE__*/getDefaultExportFromCjs(md5Exports);
 function baidu$1(options) {
     const { appId, secretKey } = options;
     const url = "https://fanyi-api.baidu.com/api/trans/vip/fieldtranslate";
+    const name = "baidu";
+    const checkOptions = () => {
+        if (!appId || !secretKey) {
+            throw new TranslationError(name, `${name} appId and secretKey is required`);
+        }
+    };
+    checkOptions();
     return {
-        name: "baidu",
+        name,
         async translate(text, opts) {
+            checkOptions();
             const { to, from = "auto", domain = "it" } = opts;
             if (!Array.isArray(text)) {
                 text = [text];
@@ -1257,7 +1290,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 Error("Failed to translate text");
+                throw new TranslationError(this.name, `Translate fail ! error_code:${data.error_code}, error_msg: ${data.error_msg}`);
             }
             const translations = [];
             for (const translation of data.trans_result) {
@@ -1272,10 +1305,18 @@ function baidu$1(options) {
 
 function deepl$2(options) {
     const { key } = options;
+    const name = "deepl";
+    const checkOptions = () => {
+        if (!key) {
+            throw new TranslationError(name, `${name} key is required`);
+        }
+    };
+    checkOptions();
     const translator = new deeplEngine.Translator(key);
     return {
-        name: "deepl",
+        name,
         async translate(text, opts) {
+            checkOptions();
             const { to, from = "auto" } = opts;
             if (!Array.isArray(text)) {
                 text = [text];
@@ -1378,6 +1419,12 @@ function useLogger(name = "") {
 function getGapLine() {
     return "-".repeat(20);
 }
+function getErrorMessages(e, prefix = "Translate fail ! ") {
+    if (e instanceof TypeError) {
+        return prefix + (e.cause.message ?? e.message);
+    }
+    return prefix + e.message;
+}
 
 var azure = {
     Afrikaans: "af",
@@ -2183,6 +2230,8 @@ function getLanguage(engine) {
     };
 }
 
+const appName = "Translate";
+
 const logger = useLogger();
 const cache = new Cache();
 class Translator {
@@ -2206,17 +2255,17 @@ class Translator {
         to = options.to = normalToLanguage(to, engine);
         //1. Check if engine exists
         if (!this.engines.has(engine)) {
-            throw new Error(`Engine ${engine} not found`);
+            throw new TranslationError(appName, `Engine ${engine} not found`);
         }
         const engineInstance = this.engines.get(engine);
         if (!engineInstance) {
-            throw new Error(`Engine ${engine} not found`);
+            throw new TranslationError(appName, `Engine ${engine} not found`);
         }
         if (!from) {
-            throw new Error(`Invalid origin language ${from}`);
+            throw new TranslationError(appName, `Invalid origin language ${from}`);
         }
         if (!to) {
-            throw new Error(`Invalid target language ${to}`);
+            throw new TranslationError(appName, `Invalid target language ${to}`);
         }
         const key = `${from}:${to}:${engine}:${text}`;
         //3. If the cache is matched, the cache is used directly
@@ -2226,12 +2275,17 @@ class Translator {
         return engineInstance
             .translate(text, options)
             .then((translated) => {
-            cache.set(key, translated, cache_time);
+            cache.set(key, translated, cache_time ?? this.cache_time);
             return translated;
         })
             .catch((e) => {
-            logger.error(`Translate Failed: from=${from},to=${to},engine=${engine},translate text: \n${getGapLine()}\n${text}\n${getGapLine()}\n error: ${e.message}`);
-            throw e;
+            logger.error(`${appName} Failed: from=${from},to=${to},engine=${engine},translate text: \n${getGapLine()}\n${text}\n${getGapLine()}\n error: ${getErrorMessages(e)}`);
+            if (e instanceof TranslationError) {
+                throw e;
+            }
+            else {
+                throw new TranslationError(appName, getErrorMessages(e));
+            }
         });
     }
 }
@@ -2245,6 +2299,7 @@ var index = {
 };
 
 exports.Cache = Cache;
+exports.TranslationError = TranslationError;
 exports.Translator = Translator;
 exports.default = index;
 exports.engines = engines;