iobroker.amtronwallbox 0.0.1

package/lib/tools.js

@@ -0,0 +1,99 @@
+const axios = require("axios");
+
+/**
+ * Tests whether the given variable is a real object and not an Array
+ * @param {any} it The variable to test
+ * @returns {it is Record<string, any>}
+ */
+function isObject(it) {
+	// This is necessary because:
+	// typeof null === 'object'
+	// typeof [] === 'object'
+	// [] instanceof Object === true
+	return Object.prototype.toString.call(it) === "[object Object]";
+}
+
+/**
+ * Tests whether the given variable is really an Array
+ * @param {any} it The variable to test
+ * @returns {it is any[]}
+ */
+function isArray(it) {
+	if (typeof Array.isArray === "function") return Array.isArray(it);
+	return Object.prototype.toString.call(it) === "[object Array]";
+}
+
+/**
+ * Translates text to the target language. Automatically chooses the right translation API.
+ * @param {string} text The text to translate
+ * @param {string} targetLang The target languate
+ * @param {string} [yandexApiKey] The yandex API key. You can create one for free at https://translate.yandex.com/developers
+ * @returns {Promise<string>}
+ */
+async function translateText(text, targetLang, yandexApiKey) {
+	if (targetLang === "en") {
+		return text;
+	} else if (!text) {
+		return "";
+	}
+	if (yandexApiKey) {
+		return translateYandex(text, targetLang, yandexApiKey);
+	} else {
+		return translateGoogle(text, targetLang);
+	}
+}
+
+/**
+ * Translates text with Yandex API
+ * @param {string} text The text to translate
+ * @param {string} targetLang The target languate
+ * @param {string} apiKey The yandex API key. You can create one for free at https://translate.yandex.com/developers
+ * @returns {Promise<string>}
+ */
+async function translateYandex(text, targetLang, apiKey) {
+	if (targetLang === "zh-cn") {
+		targetLang = "zh";
+	}
+	try {
+		const url = `https://translate.yandex.net/api/v1.5/tr.json/translate?key=${apiKey}&text=${encodeURIComponent(text)}&lang=en-${targetLang}`;
+		const response = await axios({url, timeout: 15000});
+		if (response.data && response.data.text && isArray(response.data.text)) {
+			return response.data.text[0];
+		}
+		throw new Error("Invalid response for translate request");
+	} catch (e) {
+		throw new Error(`Could not translate to "${targetLang}": ${e}`);
+	}
+}
+
+/**
+ * Translates text with Google API
+ * @param {string} text The text to translate
+ * @param {string} targetLang The target languate
+ * @returns {Promise<string>}
+ */
+async function translateGoogle(text, targetLang) {
+	try {
+		const url = `http://translate.googleapis.com/translate_a/single?client=gtx&sl=en&tl=${targetLang}&dt=t&q=${encodeURIComponent(text)}&ie=UTF-8&oe=UTF-8`;
+		const response = await axios({url, timeout: 15000});
+		if (isArray(response.data)) {
+			// we got a valid response
+			return response.data[0][0][0];
+		}
+		throw new Error("Invalid response for translate request");
+	} catch (e) {
+		if (e.response && e.response.status === 429) {
+			throw new Error(
+				`Could not translate to "${targetLang}": Rate-limited by Google Translate`
+			);
+		} else {
+			throw new Error(`Could not translate to "${targetLang}": ${e}`);
+		}
+	}
+}
+
+module.exports = {
+	isArray,
+	isObject,
+	translateText
+};