iobroker.alpha-ess 2.0.2 → 2.1.1

package/README.md

@@ -13,6 +13,13 @@
 
 ---
 
+### For support please open a GitHub issue or visit
+
+https://forum.iobroker.net/post/892023
+https://www.storion4you.de/thread/683
+
+---
+
 ### Due to current circumstances, please take note!
 
 [Interface restriction announcement](https://github.com/alphaess-developer/alphacloud_open_api/issues/54)
@@ -28,10 +35,10 @@ The quality attribute of each state is set accordingly to its status:
 | Quality | meaning |
 |:--------|:--------------------------------------------------|
 |0x00 |OK and up to date |
-|0x01 |value not updated due to unknown reason, see log |
+|0x01 |value not updated due to unknown reason, see debug log |
 |0x02 |problem with online connection for this data point |
 |0x12 |adapter disconnected or stopped |
-|0x44 |API returned error or internal error, see log |
+|0x44 |API returned error or internal error, see debug log |
 
 ## Settings:
 
@@ -54,6 +61,15 @@ How to find SN and Check code for registration is described here: https://github
 **All product and company names or logos are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them or any associated subsidiaries! This personal project is maintained in spare time and has no business goal.**
 
 ## Changelog
+### 2.1.1 (2024-08-07)
+
+-   (Gaspode) Do not longer report read timeouts as error. It should be enough to set the quality of concerned states to values according the table above and to display warnings, if values were not updated for a long time. To see details, debug log level must be enabled by the user.
+
+### 2.1.0 (2024-08-01)
+
+-   (Gaspode) Adapter requires node.js >= 18 and js-controller >= 5 now
+-   (Gaspode) Dependencies updated
+-   (Gaspode) Adapter logo updated. Alpha-ESS has kindly permitted to use the Alpha-ESS logo. This does not imply any affiliation with Alpha-ESS! Alpha-ESS is not the developer or provider of this adapter!
 
 ### 2.0.2 (2024-01-12)
 
@@ -157,7 +173,7 @@ How to find SN and Check code for registration is described here: https://github
 
 MIT License
 
-Copyright (c) 2024 Gaspode <gaspode69@online.de>
+Copyright (c) 2024 Gaspode <gaspode69@online.de> (**NO SUPPORT VIA EMAIL**)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "alpha-ess",
-    "version": "2.0.2",
+    "version": "2.1.1",
     "news": {
+      "2.1.1": {
+        "en": "Do not longer report read timeouts as error. It should be enough to set the quality of concerned states to values according the table above and to display warnings, if values were not updated for a long time. To see details, debug log level must be enabled by the user.",
+        "de": "Read Timeouts werden nicht länger als Fehler im Log angezeigt. Es sollte ausreichen, dass die Qualität der betreffenden States auf Werte gemäß der obigen Tabelle gesetzt wird und dass Warnungen angezeigt werden, wenn Werte lange nicht aktualisiert wurden. Um Details zu sehen, muss der Log-Level Debug vom Benutzer aktiviert werden.",
+        "ru": "Не сообщайте больше о времени чтения как об ошибке. Это должно быть достаточно, чтобы установить качество соответствующих состояний к значениям согласно таблице выше и отображать предупреждения, если значения не обновлялись в течение длительного времени. Чтобы увидеть детали, уровень отладки журнала должен быть включен пользователем.",
+        "pt": "Não reporte mais tempo de leitura como erro. Deve ser suficiente definir a qualidade dos estados em causa para valores de acordo com a tabela acima e para exibir avisos, se os valores não foram atualizados por muito tempo. Para ver detalhes, o nível de log de depuração deve ser ativado pelo usuário.",
+        "nl": "Niet langer lezen time-outs rapporteren als fout. Het zou voldoende moeten zijn om de kwaliteit van de betrokken staten vast te stellen op waarden volgens bovenstaande tabel en waarschuwingen weer te geven, indien de waarden lange tijd niet werden bijgewerkt. Om details te zien, moet het debug-logniveau door de gebruiker worden ingeschakeld.",
+        "fr": "Ne déclarez plus les temps de lecture comme erreur. Il devrait suffire de fixer la qualité des états concernés à des valeurs selon le tableau ci-dessus et d'afficher des avertissements, si les valeurs ne sont pas mises à jour pendant longtemps. Pour voir les détails, le niveau de débogage doit être activé par l'utilisateur.",
+        "it": "Non report più i timeout di lettura come errore. Dovrebbe essere sufficiente impostare la qualità degli stati interessati ai valori secondo la tabella sopra e mostrare avvisi, se i valori non sono stati aggiornati per molto tempo. Per visualizzare i dettagli, il livello di registro del debug deve essere abilitato dall'utente.",
+        "es": "No reporte más tiempo de lectura como error. Debe ser suficiente para establecer la calidad de los estados interesados a valores según la tabla anterior y para mostrar advertencias, si los valores no se actualizaron durante mucho tiempo. Para ver detalles, el nivel de registro de depuración debe ser habilitado por el usuario.",
+        "pl": "Nie raportuj już timeout jako błąd. Powinno wystarczyć ustawić jakość danych państw na wartości zgodnie z powyższą tabelą oraz wyświetlić ostrzeżenia, jeżeli wartości nie były aktualizowane przez długi czas. Aby zobaczyć szczegóły, poziom dziennika debugowania musi być włączony przez użytkownika.",
+        "uk": "Не довший звіт про те, як помилка. Для того, щоб встановити якість занепокоєних станів до значень, зазначених вище таблиці та для відображення попередження, якщо значення не було оновлено протягом тривалого часу. Щоб дізнатися подробиці, рівень дебюг повинен бути включений користувачем.",
+        "zh-cn": "不再将超时读取为错误 。 如果长期不更新有关数值,则应该足以按照上表的数值确定有关国家的质量,并显示警告。 要查看细节,调试日志级别必须由用户启用."
+      },
+      "2.1.0": {
+        "en": "Adapter requires node.js >= 18 and js-controller >= 5 now\nDependencies updated\nAdapter logo updated. Alpha-ESS has kindly permitted to use the Alpha-ESS logo. This does not imply any affiliation with Alpha-ESS! Alpha-ESS is not the developer or provider of this adapter!",
+        "de": "Adapter benötigt jetzt node.js >= 18 und js-controller >= 5\nAbhängigkeiten aktualisiert\nAdapter-Logo aktualisiert. Alpha-ESS hat freundlicherweise die Nutzung des Alpha-ESS-Logos genehmigt. Dies impliziert keine Zugehörigkeit zu Alpha-ESS! Alpha-ESS ist nicht der Entwickler oder Anbieter dieses Adapters!",
+        "ru": "Адаптер требует node.js >= 18 и js-контроллер >= 5 сейчас\nОбновленные данные о зависимостях\nОбновлен логотип адаптера. Alpha-ESS любезно разрешил использовать логотип Alpha-ESS. Это не означает никакой связи с Alpha-ESS! Alpha-ESS не является разработчиком или поставщиком этого адаптера!",
+        "pt": "Adapter requer node.js >= 18 e js-controller >= 5 agora\nDependências atualizadas\nLogotipo do adaptador atualizado. Alpha-ESS tem permissão para usar o logotipo Alpha-ESS. Isso não implica nenhuma afiliação com Alpha-ESS! Alpha-ESS não é o desenvolvedor ou provedor deste adaptador!",
+        "nl": "Voor adaptor zijn node.js < 18 en js-controller > Nu 5\nAfhankelijkheden bijgewerkt\nAdapterlogo bijgewerkt. Alpha-ESS mag het Alpha-ESS-logo gebruiken. Dit impliceert geen band met Alpha-ESS! Alpha-ESS is niet de ontwikkelaar of leverancier van deze adapter!",
+        "fr": "L'adaptateur nécessite node.js >= 18 et js-controller >= 5 maintenant\nDépendances actualisées\nLogo de l'adaptateur mis à jour. Alpha-ESS a permis d'utiliser le logo Alpha-ESS. Cela n'implique aucune affiliation avec Alpha-ESS ! Alpha-ESS n'est pas le développeur ou le fournisseur de cet adaptateur !",
+        "it": "Adattatore richiede node.js >= 18 e js-controller >= 5 ora\nDipendenze aggiornate\nLogo adattatore aggiornato. Alpha-ESS ha gentilmente permesso di utilizzare il logo Alpha-ESS. Questo non implica alcuna affiliazione con Alpha-ESS! Alpha-ESS non è lo sviluppatore o il fornitore di questo adattatore!",
+        "es": "Adaptador requiere node.js √≥= 18 y js-controller 5 ahora\nActualización de las dependencias\nAdaptador logo actualizado. Alpha-ESS ha permitido utilizar el logotipo de Alpha-ESS. ¡Esto no implica ninguna afiliación con Alpha-ESS! Alpha-ESS no es el desarrollador o proveedor de este adaptador!",
+        "pl": "Adapter wymaga node.js > = 18 i kontroler js- > = 5 teraz\nAktualizacja zależności\nAktualizacja logo adaptera. Alpha- ESS uprzejmie zezwolił na użycie logo Alpha- ESS. To nie oznacza żadnego związku z AlphaESS! Alpha- ESS nie jest deweloperem ani dostawcą tego adaptera!",
+        "uk": "Адаптер вимагає node.js >= 18 і js-controller >= 5 тепер\nЗалежність оновлено\nОновлено логотип адаптера. Альфа-ESS дозволяє використовувати логотип Альфа-ESS. Це не означає афілію Альфа-ESS! Альфа-ESS не є розробником або постачальником цього адаптера!",
+        "zh-cn": "适配器需要节点.js QQ18和js控制器 QQ 现在5号\n更新的依赖关系\n适配器标志更新. Alpha-ESS允许使用Alpha-ESS标志。 这并不意味着与Alpha -ESS有任何关系! Alpha-ESS不是这个适配器的开发者或提供者!"
+      },
       "2.0.2": {
         "en": "Updated Copyright year",
         "de": "Aktualisierung des Copyright-Jahres",
@@ -67,32 +93,6 @@
         "pl": "Szczegółowy błąd w ClosedAPI",
         "uk": "Виправлено тяжку помилку в ClosedAPI",
         "zh-cn": "A. 近似严重错误"
-      },
-      "1.2.0": {
-        "en": "Added additional realtime attributes for OpenAPI",
-        "de": "Zusätzliche Echtzeit-Attribute für OpenAPI hinzugefügt",
-        "ru": "Добавлены дополнительные атрибуты в реальном времени для OpenAPI",
-        "pt": "Adicionado atributos em tempo real adicionais para OpenAPI",
-        "nl": "Toegevoegd aanvullingen voor OpenAPI",
-        "fr": "Ajout d'autres attributs en temps réel pour OpenAPI",
-        "it": "Aggiunto attributi in tempo reale aggiuntivi per OpenAPI",
-        "es": "Atributos adicionales en tiempo real para OpenAPI",
-        "pl": "Dodać dodatkowe atrybuty dla OpenAPI",
-        "uk": "Додано додаткові атрибути в режимі реального часу для OpenAPI",
-        "zh-cn": "增加开放协会实时归属"
-      },
-      "1.1.1": {
-        "en": "Closed API adapted to latest Alpha-ESS changes and enabled again",
-        "de": "Closed API angepasst an neueste Alpha-ESS-Änderungen und wieder aktiviert",
-        "ru": "Закрытый API адаптирован к последним изменениям Alpha-ESS и включен снова",
-        "pt": "API fechada adaptada às últimas alterações Alpha-ESS e ativada novamente",
-        "nl": "Quality over Quantity (QoQ) Releases Vertaling:",
-        "fr": "API fermée adaptée aux derniers changements Alpha-ESS et réactivée",
-        "it": "API chiusa adattata alle ultime modifiche Alpha-ESS e abilitata di nuovo",
-        "es": "API cerrada adaptada a los últimos cambios de Alpha-ESS y habilitada de nuevo",
-        "pl": "Zamknięty interfejs API zaadaptował się do najnowszych zmian Alpha-ESS i umożliwił powtórzenie się",
-        "uk": "Закритий API, адаптований до останніх змін Альфа-ESS і знову ввімкнено",
-        "zh-cn": "适应最近Alpha-ESS变革的贴近性联谊会再次促成了变革。"
       }
     },
     "titleLang": {
@@ -145,12 +145,12 @@
     },
     "dependencies": [
       {
-        "js-controller": ">=3.3.22"
+        "js-controller": ">=5.0.19"
       }
     ],
     "globalDependencies": [
       {
-        "admin": ">=5.1.13"
+        "admin": ">=6.13.16"
       }
     ]
   },

package/main.js

@@ -651,7 +651,7 @@ class OpenAPI {
             return res;
         }
         catch (e) {
-            this.adapter.log.error('Error prforming get request ' + path + ': ' + e);
+            this.adapter.log.debug('Error performing get request ' + path + ': ' + e);
             return this.emptyBody;
         }
     }
@@ -676,7 +676,7 @@ class OpenAPI {
             return res;
         }
         catch (e) {
-            this.adapter.log.error('Error prforming post request ' + path + ': ' + e);
+            this.adapter.log.error('Error performing post request ' + path + ': ' + e);
             return this.emptyBody;
         }
     }
@@ -1010,25 +1010,25 @@ class OpenAPI {
         if (res.data && res.data.code && res.data.code != 0) {
             this.adapter.log.error(`Alpha ESS Api returns an error! Group: ${group}`);
             switch (res.data.code) {
-                case 6001: this.adapter.log.info(`Error code: ${res.data.code} - Parameter error (#${this.adapter.errorCount})`); break;
-                case 6002: this.adapter.log.info(`Error code: ${res.data.code} - The SN is not bound to the user (#${this.adapter.errorCount})`); break;
-                case 6003: this.adapter.log.info(`Error code: ${res.data.code} - You have bound this SN (#${this.adapter.errorCount})`); break;
-                case 6004: this.adapter.log.info(`Error code: ${res.data.code} - CheckCode error (#${this.adapter.errorCount})`); break;
-                case 6005: this.adapter.log.info(`Error code: ${res.data.code} - This appId is not bound to the SN (#${this.adapter.errorCount})`); break;
-                case 6006: this.adapter.log.info(`Error code: ${res.data.code} - Timestamp error (#${this.adapter.errorCount})`); break;
-                case 6007: this.adapter.log.info(`Error code: ${res.data.code} - Sign verification error (#${this.adapter.errorCount})`); break;
-                case 6008: this.adapter.log.info(`Error code: ${res.data.code} - Set failed (#${this.adapter.errorCount})`); break;
-                case 6009: this.adapter.log.info(`Error code: ${res.data.code} - Whitelist verification failed (#${this.adapter.errorCount})`); break;
-                case 6010: this.adapter.log.info(`Error code: ${res.data.code} - Sign is empty (#${this.adapter.errorCount})`); break;
-                case 6011: this.adapter.log.info(`Error code: ${res.data.code} - timestamp is empty (#${this.adapter.errorCount})`); break;
-                case 6012: this.adapter.log.info(`Error code: ${res.data.code} - AppId is empty (#${this.adapter.errorCount})`); break;
-                case 6016: this.adapter.log.info(`Error code: ${res.data.code} - Data does not exist or has been deleted (#${this.adapter.errorCount})`); break;
-                case 6026: this.adapter.log.info(`Error code: ${res.data.code} - Internal Error (#${this.adapter.errorCount})`); break;
-                case 6029: this.adapter.log.info(`Error code: ${res.data.code} - operation failed (#${this.adapter.errorCount})`); break;
-                case 6038: this.adapter.log.info(`Error code: ${res.data.code} - system sn does not exist (#${this.adapter.errorCount})`); break;
-                case 6042: this.adapter.log.info(`Error code: ${res.data.code} - system offline (#${this.adapter.errorCount})`); break;
-                case 6046: this.adapter.log.info(`Error code: ${res.data.code} - Verification code error (#${this.adapter.errorCount})`); break;
-                case 6053: this.adapter.log.info(`Error code: ${res.data.code} - The request was too fast, please try again later (#${this.adapter.errorCount})`); break;
+                case 6001: this.adapter.log.error(`Error code: ${res.data.code} - Parameter error (#${this.adapter.errorCount})`); break;
+                case 6002: this.adapter.log.error(`Error code: ${res.data.code} - The SN is not bound to the user (#${this.adapter.errorCount})`); break;
+                case 6003: this.adapter.log.error(`Error code: ${res.data.code} - You have bound this SN (#${this.adapter.errorCount})`); break;
+                case 6004: this.adapter.log.error(`Error code: ${res.data.code} - CheckCode error (#${this.adapter.errorCount})`); break;
+                case 6005: this.adapter.log.error(`Error code: ${res.data.code} - This appId is not bound to the SN (#${this.adapter.errorCount})`); break;
+                case 6006: this.adapter.log.error(`Error code: ${res.data.code} - Timestamp error (#${this.adapter.errorCount})`); break;
+                case 6007: this.adapter.log.error(`Error code: ${res.data.code} - Sign verification error (#${this.adapter.errorCount})`); break;
+                case 6008: this.adapter.log.error(`Error code: ${res.data.code} - Set failed (#${this.adapter.errorCount})`); break;
+                case 6009: this.adapter.log.error(`Error code: ${res.data.code} - Whitelist verification failed (#${this.adapter.errorCount})`); break;
+                case 6010: this.adapter.log.error(`Error code: ${res.data.code} - Sign is empty (#${this.adapter.errorCount})`); break;
+                case 6011: this.adapter.log.error(`Error code: ${res.data.code} - timestamp is empty (#${this.adapter.errorCount})`); break;
+                case 6012: this.adapter.log.error(`Error code: ${res.data.code} - AppId is empty (#${this.adapter.errorCount})`); break;
+                case 6016: this.adapter.log.error(`Error code: ${res.data.code} - Data does not exist or has been deleted (#${this.adapter.errorCount})`); break;
+                case 6026: this.adapter.log.error(`Error code: ${res.data.code} - Internal Error (#${this.adapter.errorCount})`); break;
+                case 6029: this.adapter.log.error(`Error code: ${res.data.code} - operation failed (#${this.adapter.errorCount})`); break;
+                case 6038: this.adapter.log.error(`Error code: ${res.data.code} - system sn does not exist (#${this.adapter.errorCount})`); break;
+                case 6042: this.adapter.log.error(`Error code: ${res.data.code} - system offline (#${this.adapter.errorCount})`); break;
+                case 6046: this.adapter.log.error(`Error code: ${res.data.code} - Verification code error (#${this.adapter.errorCount})`); break;
+                case 6053: this.adapter.log.error(`Error code: ${res.data.code} - The request was too fast, please try again later (#${this.adapter.errorCount})`); break;
                 default: this.adapter.log.info(`Error code: ${res.data.code} - Unknown error (#${this.adapter.errorCount})`);
             }
             if (res.data.code == 6002 ||
@@ -1044,7 +1044,7 @@ class OpenAPI {
             }
         }
         else {
-            this.adapter.log.error(`Unknown error occurred: ${JSON.stringify(res.data)} (#${this.adapter.errorCount}) Group:${group}`);
+            this.adapter.log.debug(`Unknown error occurred: ${JSON.stringify(res.data)} (#${this.adapter.errorCount}) Group:${group}`);
         }
         await this.adapter.setQualityForGroup(group, 0x44);
     }
@@ -1591,7 +1591,7 @@ class AlphaEss extends utils.Adapter {
                 await this.setStateChangedAsync(group + '.' + this.osn(stateInfo.id), { val: tvalue, q: 0 }, true);
             }
             stateInfo.lastUpdateTs = Date.now();
-            this.log.debug('Received object ' + group + '.' + this.osn(stateInfo.alphaAttrName) + ' with value ' + rawValue);
+            this.log.silly('Received object ' + group + '.' + this.osn(stateInfo.alphaAttrName) + ' with value ' + rawValue);
         }
     }
 
@@ -1662,7 +1662,7 @@ class AlphaEss extends utils.Adapter {
                         if (newState) {
                             if (newState.q != q && newState.ack) {
                                 newState.q = q;
-                                this.log.debug(`Set state ${groupInfo.Group}.${groupStates[i].id} to val: ${newState.val}; q: ${newState.q}; ack: ${newState.ack}`);
+                                this.log.silly(`Set state ${groupInfo.Group}.${groupStates[i].id} to val: ${newState.val}; q: ${newState.q}; ack: ${newState.ack}`);
                                 await this.setStateAsync(`${groupInfo.Group}.${groupStates[i].id}`, newState, true);
                             }
                             else {
@@ -1749,7 +1749,7 @@ class AlphaEss extends utils.Adapter {
         }
         else {
             if (timeInS < 300000) { // 5 minutes
-                this.log.warn(txt + ': Five or more errors occurred, next request in 5 minutes.');
+                this.log.error(txt + ': Five or more errors occurred, next request in 5 minutes.');
                 return 300000;
             }
             else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.alpha-ess",
-  "version": "2.0.2",
+  "version": "2.1.1",
   "description": "Read and write data from and to Alpha ESS systems.",
   "author": {
     "name": "Gaspode",
@@ -16,40 +16,40 @@
     "url": "https://github.com/Gaspode69/ioBroker.alpha-ess.git"
   },
   "engines": {
-    "node": ">= 16"
+    "node": ">= 18"
   },
   "dependencies": {
-    "@iobroker/adapter-core": "^3.0.4",
-    "axios": "^1.6.3"
+    "@iobroker/adapter-core": "^3.1.4",
+    "axios": "^1.7.2"
   },
   "devDependencies": {
-    "@alcalzone/release-script": "^3.6.0",
-    "@alcalzone/release-script-plugin-iobroker": "^3.6.0",
+    "@alcalzone/release-script": "^3.8.0",
+    "@alcalzone/release-script-plugin-iobroker": "^3.7.0",
     "@alcalzone/release-script-plugin-license": "^3.7.0",
     "@alcalzone/release-script-plugin-manual-review": "^3.7.0",
-    "@iobroker/adapter-dev": "^1.2.0",
-    "@iobroker/dev-server": "^0.7.1",
-    "@iobroker/testing": "^4.1.0",
-    "@tsconfig/node14": "^14.1.0",
-    "@tsconfig/node18": "^18.2.2",
+    "@iobroker/adapter-dev": "^1.3.0",
+    "@iobroker/dev-server": "^0.7.3",
+    "@iobroker/testing": "^4.1.3",
+    "@tsconfig/node14": "^14.1.2",
+    "@tsconfig/node18": "^18.2.4",
     "@types/chai": "^4.3.11",
     "@types/chai-as-promised": "^7.1.8",
     "@types/mocha": "^10.0.6",
-    "@types/node": "^20.10.0",
+    "@types/node": "^20.14.9",
     "@types/proxyquire": "^1.3.31",
-    "@types/sinon": "^17.0.2",
+    "@types/sinon": "^17.0.3",
     "@types/sinon-chai": "^3.2.12",
-    "chai": "^4.3.10",
-    "chai-as-promised": "^7.1.1",
-    "eslint": "^8.56.0",
+    "chai": "^4.5.0",
+    "chai-as-promised": "^8.0.0",
+    "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-prettier": "^5.0.1",
-    "mocha": "^10.2.0",
-    "prettier": "^3.1.1",
+    "eslint-plugin-prettier": "^5.1.3",
+    "mocha": "^10.4.0",
+    "prettier": "^3.3.3",
     "proxyquire": "^2.1.3",
-    "sinon": "^17.0.1",
+    "sinon": "^18.0.0",
     "sinon-chai": "^3.7.0",
-    "typescript": "~5.3.3"
+    "typescript": "~5.5.2"
   },
   "main": "main.js",
   "files": [