@yxw007/translate 0.0.14 → 0.0.15

package/dist/browser/index.umd.js

@@ -1,10 +1,19 @@
-// translate v0.0.14 Copyright (c) 2024 Potter<aa4790139@gmail.com> and contributors
+// translate v0.0.15 Copyright (c) 2024 Potter<aa4790139@gmail.com> and contributors
 (function (global, factory) {
     typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@aws-sdk/client-translate'), require('deepl-node')) :
     typeof define === 'function' && define.amd ? define(['exports', '@aws-sdk/client-translate', 'deepl-node'], factory) :
     (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.translate = {}, global.clientTranslate, global.deeplEngine));
 })(this, (function (exports, clientTranslate, deeplEngine) { 'use strict';
 
+    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 {
@@ -19,7 +28,7 @@
                 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++) {
@@ -39,10 +48,18 @@
      */
     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)) {
@@ -59,11 +76,11 @@
                 });
                 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) {
@@ -79,9 +96,17 @@
 
     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)) {
@@ -1229,9 +1254,17 @@
     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];
@@ -1256,7 +1289,7 @@
                 });
                 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) {
@@ -1271,10 +1304,18 @@
 
     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];
@@ -1377,6 +1418,12 @@
     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",
@@ -2182,6 +2229,8 @@
         };
     }
 
+    const appName = "Translate";
+
     const logger = useLogger();
     const cache = new Cache();
     class Translator {
@@ -2205,17 +2254,17 @@
             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
@@ -2225,12 +2274,17 @@
             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));
+                }
             });
         }
     }
@@ -2244,6 +2298,7 @@
     };
 
     exports.Cache = Cache;
+    exports.TranslationError = TranslationError;
     exports.Translator = Translator;
     exports.default = index;
     exports.engines = engines;