iobroker.al-ko 0.2.2 → 0.2.4

package/README.md

@@ -54,7 +54,31 @@ Es handelt sich um ein Community-Projekt, und AL-KO bietet **keinen Support** da
 
 ## Changelog
 
-## Changelog
+### 0.2.4 (2025-10-23)
+
+**Deutsch:**
+- Metadaten-Anpassungen für korrekte Anzeige im ioBroker Admin und auf npm
+- Der Autor wird jetzt korrekt angezeigt, und das Adapter-Icon erscheint im Admin
+- Keine funktionalen Änderungen am Code
+
+**English:**
+- Metadata adjustments for correct display in ioBroker Admin and npm
+- Author information and adapter icon are now shown correctly
+- No functional changes to the code
+
+### 0.2.3 (2025-10-22)
+
+**Deutsch:**
+- WebSocket-Stabilität deutlich verbessert:
+  - Heartbeat (Ping/Pong) alle **120 Sekunden** mit **30 Sekunden** Timeout
+  - Bei fehlendem Pong oder Fehlern wird die Verbindung **aktiv beendet**, damit ein sauberer **Reconnect** erfolgt
+  - Entfernt: „Silence-Watchdog“, damit es in längeren Ruhephasen (z. B. nachts) **keine unnötigen Reconnects** gibt
+
+**English:**
+- Improved WebSocket stability:
+  - Heartbeat (ping/pong) every **120 seconds** with **30 seconds** timeout
+  - If pong is missing or errors occur, the socket is **terminated** to trigger a clean **reconnect**
+  - Removed the **silence watchdog** to avoid unnecessary reconnects during long idle periods (e.g., at night)
 
 
 ### 0.2.2 (2025-10-20)

package/io-package.json

@@ -1,7 +1,7 @@
 {
   "common": {
     "name": "al-ko",
-    "version": "0.2.2",
+    "version": "0.2.4",
     "tier": 3,
     "titleLang": {
       "en": "AL-KO",
@@ -33,6 +33,32 @@
       "Hubert Zechner <hubertiob@posteo.at>"
     ],
     "news": {
+      "0.2.4": {
+        "en": "Metadata adjustments for correct npm/Admin display (author, icon). No functional changes.",
+        "de": "Metadaten-Anpassungen für korrekte npm-/Admin-Anzeige (Autor, Icon). Keine funktionalen Änderungen.",
+        "ru": "Корректировка метаданных для правильного отображения npm/Admin (автор, значок). Без функциональных изменений.",
+        "pt": "Ajustes de metadados para exibição correta no npm/Admin (autor, ícone). Sem alterações funcionais.",
+        "nl": "Metadata-aanpassingen voor juiste npm/Admin-weergave (auteur, pictogram). Geen functionele wijzigingen.",
+        "fr": "Ajustements des métadonnées pour un affichage correct dans npm/Admin (auteur, icône). Aucune modification fonctionnelle.",
+        "it": "Regolazioni dei metadati per la corretta visualizzazione su npm/Admin (autore, icona). Nessuna modifica funzionale.",
+        "es": "Ajustes de metadatos para una visualización correcta en npm/Admin (autor, icono). Sin cambios funcionales.",
+        "pl": "Dostosowanie metadanych do prawidłowego wyświetlania w npm/Admin (autor, ikona). Bez zmian funkcjonalnych.",
+        "uk": "Коригування метаданих для правильного відображення в npm/Admin (автор, іконка). Без функціональних змін.",
+        "zh-cn": "为确保在 npm/Admin 中正确显示（作者、图标）调整了元数据。无功能更改。"
+      },
+      "0.2.3": {
+        "en": "Improved WebSocket stability: Added heartbeat (ping/pong) every 120 seconds with 30 seconds timeout. If no pong or an error occurs, the socket is closed and reconnected automatically. Removed the silence watchdog to avoid unnecessary reconnects during long idle phases (e.g., at night).",
+        "de": "WebSocket-Stabilität verbessert: Heartbeat (Ping/Pong) alle 120 Sekunden mit 30 Sekunden Timeout hinzugefügt. Bei fehlendem Pong oder Fehlern wird die Verbindung geschlossen und automatisch neu verbunden. Der Silence-Watchdog wurde entfernt, um unnötige Reconnects während längerer Ruhephasen (z. B. nachts) zu vermeiden.",
+        "ru": "Улучшена стабильность WebSocket: добавлен Heartbeat (ping/pong) каждые 120 секунд с тайм-аутом 30 секунд. При отсутствии pong или ошибках соединение закрывается и автоматически восстанавливается. Удалён watchdog тишины, чтобы избежать ненужных переподключений во время долгих периодов бездействия (например, ночью).",
+        "pt": "Melhorada a estabilidade do WebSocket: Adicionado heartbeat (ping/pong) a cada 120 segundos com tempo limite de 30 segundos. Se não houver pong ou ocorrer um erro, o socket é fechado e reconectado automaticamente. Removido o watchdog de silêncio para evitar reconexões desnecessárias durante longos períodos de inatividade (por exemplo, à noite).",
+        "nl": "Verbeterde WebSocket-stabiliteit: Heartbeat (ping/pong) toegevoegd elke 120 seconden met een timeout van 30 seconden. Als er geen pong of een fout optreedt, wordt de socket gesloten en automatisch opnieuw verbonden. De stilte-watchdog is verwijderd om onnodige reconnects tijdens langere inactieve periodes (bijv. 's nachts) te voorkomen.",
+        "fr": "Stabilité WebSocket améliorée : ajout d'un heartbeat (ping/pong) toutes les 120 secondes avec un délai d'attente de 30 secondes. En cas d'absence de pong ou d'erreur, la connexion est fermée et reconnectée automatiquement. Le watchdog de silence a été supprimé afin d'éviter des reconnexions inutiles lors de longues périodes d'inactivité (par exemple, la nuit).",
+        "it": "Migliorata la stabilità del WebSocket: aggiunto heartbeat (ping/pong) ogni 120 secondi con timeout di 30 secondi. Se manca il pong o si verifica un errore, la connessione viene chiusa e riconnessa automaticamente. Rimosso il watchdog del silenzio per evitare riconnessioni inutili durante lunghi periodi di inattività (ad esempio, di notte).",
+        "es": "Mejorada la estabilidad del WebSocket: se añadió un heartbeat (ping/pong) cada 120 segundos con un tiempo de espera de 30 segundos. Si no hay pong o ocurre un error, el socket se cierra y se reconecta automáticamente. Se eliminó el watchdog de silencio para evitar reconexiones innecesarias durante largos períodos de inactividad (por ejemplo, por la noche).",
+        "pl": "Poprawiona stabilność WebSocket: dodano heartbeat (ping/pong) co 120 sekund z limitem czasu 30 sekund. W przypadku braku pong lub błędu połączenie jest zamykane i automatycznie ponownie nawiązywane. Usunięto watchdog ciszy, aby uniknąć niepotrzebnych ponownych połączeń podczas długich okresów bezczynności (np. w nocy).",
+        "uk": "Покращено стабільність WebSocket: додано heartbeat (ping/pong) кожні 120 секунд із тайм-аутом 30 секунд. Якщо pong не надходить або виникає помилка, з'єднання закривається та автоматично відновлюється. Видалено watchdog тиші, щоб уникнути непотрібних повторних підключень під час тривалих періодів бездіяльності (наприклад, уночі).",
+        "zh-cn": "改进了 WebSocket 稳定性：每 120 秒添加一次心跳 (ping/pong)，超时 30 秒。如果没有收到 pong 或发生错误，连接将关闭并自动重新连接。移除了静默监视程序，以避免在长时间空闲期间（例如夜间）不必要的重新连接。"
+      },
       "0.2.2": {
         "en": "Prepared for the first npm release. Synchronized versions between io-package.json and package.json. Added npm metadata and publication configuration. Minor internal adjustments for improved compatibility.",
         "de": "Für die erste npm-Veröffentlichung vorbereitet. Versionen zwischen io-package.json und package.json synchronisiert. npm-Metadaten und Veröffentlichungskonfiguration hinzugefügt. Kleine interne Anpassungen zur verbesserten Kompatibilität.",
@@ -45,60 +71,8 @@
         "pl": "Przygotowano do pierwszego wydania npm. Zsynchronizowano wersje między io-package.json i package.json. Dodano metadane npm i konfigurację publikacji. Drobne poprawki wewnętrzne dla lepszej kompatybilności.",
         "uk": "Підготовлено до першого випуску npm. Синхронізовано версії між io-package.json і package.json. Додано метадані npm та конфігурацію публікації. Невеликі внутрішні покращення для кращої сумісності.",
         "zh-cn": "为首次 npm 发布做好准备。同步 io-package.json 与 package.json 之间的版本。添加了 npm 元数据和发布配置。进行了少量内部改进以提高兼容性。"
-      },
-      "0.2.1": {
-        "en": "Added option in Admin UI to enable or disable WebSocket message logging (wsDebug). This allows toggling incoming WebSocket message logs directly in the adapter configuration. Minor internal improvements.",
-        "de": "Neue Option in der Admin-UI zum Aktivieren oder Deaktivieren des WebSocket-Nachrichten-Loggings (wsDebug). Das Logging eingehender WebSocket-Nachrichten kann nun direkt in der Adapter-Konfiguration gesteuert werden. Kleine interne Verbesserungen.",
-        "ru": "Добавлена опция в интерфейсе администратора для включения или отключения логирования сообщений WebSocket (wsDebug). Теперь можно управлять логированием входящих сообщений WebSocket прямо в настройках адаптера. Незначительные внутренние улучшения.",
-        "pt": "Adicionada opção na interface de administração para ativar ou desativar o registro de mensagens WebSocket (wsDebug). Agora é possível alternar o registro de mensagens diretamente na configuração do adaptador. Pequenas melhorias internas.",
-        "nl": "Optie toegevoegd in de Admin UI om het loggen van WebSocket-berichten in of uit te schakelen (wsDebug). Hiermee kun je inkomende berichten direct in de adapterconfiguratie beheren. Kleine interne verbeteringen.",
-        "fr": "Ajout d'une option dans l'interface d'administration pour activer ou désactiver la journalisation des messages WebSocket (wsDebug). Permet de basculer l'enregistrement des messages directement depuis la configuration de l'adaptateur. Améliorations internes mineures.",
-        "it": "Aggiunta un'opzione nell'interfaccia di amministrazione per abilitare o disabilitare il logging dei messaggi WebSocket (wsDebug). Ora è possibile gestire i log direttamente nella configurazione dell'adattatore. Piccoli miglioramenti interni.",
-        "es": "Se agregó una opción en la interfaz de administración para habilitar o deshabilitar el registro de mensajes WebSocket (wsDebug). Ahora se puede activar o desactivar directamente desde la configuración del adaptador. Pequeñas mejoras internas.",
-        "pl": "Dodano opcję w interfejsie administratora do włączania lub wyłączania logowania wiadomości WebSocket (wsDebug). Można teraz sterować logowaniem bezpośrednio w konfiguracji adaptera. Drobne ulepszenia wewnętrzne.",
-        "uk": "Додано опцію в інтерфейсі адміністратора для ввімкнення або вимкнення журналювання повідомлень WebSocket (wsDebug). Тепер можна керувати логуванням безпосередньо в налаштуваннях адаптера. Незначні внутрішні покращення.",
-        "zh-cn": "在管理界面中添加了启用或禁用 WebSocket 消息日志记录 (wsDebug) 的选项。现在可以在适配器配置中直接切换日志记录。进行了少量内部改进。"
-      },
-      "0.2.0": {
-        "en": "Migrated to ESLint 9 (Flat-Config) and updated development dependencies",
-        "de": "Migration auf ESLint 9 (Flat-Config) und Aktualisierung der Entwicklungsabhängigkeiten",
-        "ru": "Переход на ESLint 9 (Flat-Config) и обновлены зависимости для разработки",
-        "pt": "Migrado para ESLint 9 (Flat-Config) e dependências de desenvolvimento atualizadas",
-        "nl": "Gemigreerd naar ESLint 9 (Flat-Config) en ontwikkelafhankelijkheden bijgewerkt",
-        "fr": "Migration vers ESLint 9 (Flat-Config) et mise à jour des dépendances de développement",
-        "it": "Migrazione a ESLint 9 (Flat-Config) e aggiornate le dipendenze di sviluppo",
-        "es": "Migrado a ESLint 9 (Flat-Config) y actualizadas las dependencias de desarrollo",
-        "pl": "Migracja do ESLint 9 (Flat-Config) i aktualizacja zależności deweloperskich",
-        "uk": "Міграція на ESLint 9 (Flat-Config) та оновлено залежності розробки",
-        "zh-cn": "迁移到 ESLint 9（Flat-Config）并更新开发依赖项"
-      },
-      "0.1.2": {
-        "en": "Improved admin UI config and fixed adapter-check issues",
-        "de": "Verbesserte Admin-UI-Konfiguration und behobene Adapter-Check-Fehler",
-        "ru": "Улучшена конфигурация админ-интерфейса и исправлены ошибки adapter-check",
-        "pt": "Configuração da interface de administração melhorada e problemas do adapter-check corrigidos",
-        "nl": "Verbeterde admin UI-configuratie en adapter-checkproblemen opgelost",
-        "fr": "Configuration de l'interface d'administration améliorée et correction des problèmes d'adapter-check",
-        "it": "Configurazione dell'interfaccia di amministrazione migliorata e risolti i problemi di adapter-check",
-        "es": "Configuración de la interfaz de administración mejorada y problemas de verificación del adaptador corregidos",
-        "pl": "Ulepszona konfiguracja interfejsu administratora i naprawione błędy adapter-check",
-        "uk": "Покращена конфігурація інтерфейсу адміністратора та виправлені помилки adapter-check",
-        "zh-cn": "改进了管理界面配置并修复了适配器检查问题"
-      },
-      "0.1.1": {
-        "en": "Initial release",
-        "de": "Erste Version",
-        "ru": "Первая версия",
-        "pt": "Versão inicial",
-        "nl": "Eerste versie",
-        "fr": "Première version",
-        "it": "Prima versione",
-        "es": "Primera versión",
-        "pl": "Pierwsza wersja",
-        "uk": "Перша версія",
-        "zh-cn": "初始版本"
       }
-    },
+     },
     "keywords": [
       "al-ko",
       "Robolinho",
@@ -110,7 +84,6 @@
     "adminUI": {
       "config": "json"
     },
-    "license": "MIT",
     "licenseInformation": {
       "type": "free",
       "license": "MIT",

package/main.js

@@ -31,7 +31,9 @@ class AlKoAdapter extends utils.Adapter {
     this.adapterSetStates = new Set();
     this.pendingPushes = new Set();
     this.webSockets = {}; // offene WebSocket-Verbindungen pro Gerät
-    this.reconnectTimeouts = {}; // hier speichern wir alle offenen Reconnect-Timeouts
+    this.reconnectTimeouts = {}; // offene Reconnect-Timeouts
+    this.pingIntervals = {}; // Ping-Intervalle pro Gerät
+    this.pongTimeouts = {}; // Timeout-Überwachung nach Ping
 
     this._stopRequested = false;
 
@@ -97,6 +99,7 @@ class AlKoAdapter extends utils.Adapter {
 
     this.log.info("✅ Login erfolgreich");
   }
+
   async refreshAuth() {
     if (!this.refreshToken || Date.now() >= this.tokenExpiresAt - 60000) {
       this.log.info("🔄 Erneuere Access-Token…");
@@ -206,8 +209,32 @@ class AlKoAdapter extends utils.Adapter {
     const url = `wss://socket.al-ko.com/v1?Authorization=${this.accessToken}&thingName=${deviceId}`;
     const ws = new WebSocket(url);
 
+    ws.isAlive = true;
+
     ws.on("open", () => {
       this.log.info(`🔗 WebSocket verbunden für Gerät: ${deviceId}`);
+
+      // PING-Mechanismus (alle 120 Sekunden)
+      this.pingIntervals[deviceId] = setInterval(() => {
+        if (ws.readyState === WebSocket.OPEN) {
+          ws.ping();
+          ws.isAlive = false;
+
+          this.pongTimeouts[deviceId] = setTimeout(() => {
+            if (!ws.isAlive) {
+              this.log.warn(
+                `💤 Keine Pong-Antwort von ${deviceId} → Verbindung wird beendet`,
+              );
+              ws.terminate();
+            }
+          }, 30_000); // 30 Sekunden Zeit für Pong
+        }
+      }, 120_000); // 120 Sekunden Ping-Intervall
+    });
+
+    ws.on("pong", () => {
+      ws.isAlive = true;
+      clearTimeout(this.pongTimeouts[deviceId]);
     });
 
     ws.on("message", async (msg) => {
@@ -242,7 +269,8 @@ class AlKoAdapter extends utils.Adapter {
       this.log.warn(
         `⚠️ WebSocket geschlossen für ${deviceId}, erneuter Versuch in 10s`,
       );
-      // Timeout merken, damit wir ihn im onUnload wieder aufräumen können
+      clearInterval(this.pingIntervals[deviceId]);
+      clearTimeout(this.pongTimeouts[deviceId]);
       this.reconnectTimeouts[deviceId] = setTimeout(
         () => this.connectWebSocket(deviceId),
         10000,
@@ -251,6 +279,10 @@ class AlKoAdapter extends utils.Adapter {
 
     ws.on("error", (err) => {
       this.log.error(`❌ WebSocket-Fehler (${deviceId}): ${err.message}`);
+      // Falls kein 'close' folgt, aktiv terminieren, damit Reconnect greift
+      try {
+        ws.terminate();
+      } catch {}
     });
 
     this.webSockets[deviceId] = ws;
@@ -565,22 +597,29 @@ class AlKoAdapter extends utils.Adapter {
         clearInterval(this.tokenInterval);
       }
 
-      // offene Reconnect-Timeouts aufräumen
       for (const t of Object.values(this.reconnectTimeouts)) {
         try {
           clearTimeout(t);
-        } catch {
-          // intentionally empty
-        }
+        } catch {}
+      }
+
+      for (const t of Object.values(this.pingIntervals)) {
+        try {
+          clearInterval(t);
+        } catch {}
+      }
+
+      for (const t of Object.values(this.pongTimeouts)) {
+        try {
+          clearTimeout(t);
+        } catch {}
       }
 
       // offene WebSockets schließen
       for (const ws of Object.values(this.webSockets)) {
         try {
           ws.close();
-        } catch {
-          // intentionally empty
-        }
+        } catch {}
       }
 
       this.log.info("Adapter gestoppt.");

package/package.json

@@ -1,11 +1,8 @@
 {
   "name": "iobroker.al-ko",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Adapter for communication with Al-Ko garden tools",
-  "author": {
-    "name": "Hubertiob",
-    "email": "hubertiob@posteo.at"
-  },
+  "author": "Hubert Zechner <hubertiob@posteo.at>",
   "contributors": [
     {
       "name": "AL-KO"
@@ -23,7 +20,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/zechnerhubert/ioBroker.al-ko.git"
+    "url": "git+https://github.com/zechnerhubert/ioBroker.al-ko.git"
   },
   "bugs": {
     "url": "https://github.com/zechnerhubert/ioBroker.al-ko/issues"
@@ -44,15 +41,15 @@
     "README.md"
   ],
   "scripts": {
-  "test:js": "mocha --config test/mocharc.custom.json \"{!(node_modules|test)/**/*.test.js,*.test.js,test/**/test!(PackageFiles|Startup).js}\"",
-  "test:package": "mocha test/package --exit",
-  "test:integration": "mocha test/integration --exit",
-  "test": "npm run test:js && npm run test:package",
-  "check": "tsc --noEmit -p tsconfig.check.json",
-  "lint": "eslint main.js lib/ --ext .js",
-  "lint:fix": "eslint main.js lib/ --ext .js --fix",
-  "translate": "translate-adapter",
-  "release": "release-script"
+    "test:js": "mocha --config test/mocharc.custom.json \"{!(node_modules|test)/**/*.test.js,*.test.js,test/**/test!(PackageFiles|Startup).js}\"",
+    "test:package": "mocha test/package --exit",
+    "test:integration": "mocha test/integration --exit",
+    "test": "npm run test:js && npm run test:package",
+    "check": "tsc --noEmit -p tsconfig.check.json",
+    "lint": "eslint main.js lib/ admin/jsonConfig.json --ext .js,.json",
+    "lint:fix": "eslint main.js lib/ admin/jsonConfig.json --ext .js,.json --fix",
+    "translate": "translate-adapter",
+    "release": "release-script"
   },
   "dependencies": {
     "@iobroker/adapter-core": "^3.3.2",
@@ -60,35 +57,35 @@
     "ws": "^8.18.0"
   },
   "devDependencies": {
-  "@alcalzone/release-script": "^3.8.0",
-  "@alcalzone/release-script-plugin-iobroker": "^3.7.2",
-  "@alcalzone/release-script-plugin-license": "^3.7.0",
-  "@alcalzone/release-script-plugin-manual-review": "^3.7.0",
-  "@iobroker/adapter-dev": "^1.5.0",
-  "@iobroker/testing": "^5.1.1",
-  "@tsconfig/node20": "^20.1.6",
-  "@types/chai": "^4.3.20",
-  "@types/chai-as-promised": "^7.1.8",
-  "@types/mocha": "^10.0.10",
-  "@types/node": "^24.6.1",
-  "@types/proxyquire": "^1.3.31",
-  "@types/sinon": "^17.0.4",
-  "@types/sinon-chai": "^4.0.0",
-  "@eslint/js": "^9.14.0",
-  "@iobroker/eslint-config": "^1.5.0",
-  "chai": "^4.5.0",
-  "chai-as-promised": "^7.1.2",
-  "eslint": "^9.14.0",
-  "mocha": "^11.7.2",
-  "prettier": "^3.3.3",
-  "proxyquire": "^2.1.3",
-  "sinon": "^21.0.0",
-  "sinon-chai": "^4.0.1",
-  "typescript": "~5.0.4",
-  "typescript-eslint": "^8.8.0"
-},
-"publishConfig": {
-  "access": "public"
-},
+    "@alcalzone/release-script": "^3.8.0",
+    "@alcalzone/release-script-plugin-iobroker": "^3.7.2",
+    "@alcalzone/release-script-plugin-license": "^3.7.0",
+    "@alcalzone/release-script-plugin-manual-review": "^3.7.0",
+    "@iobroker/adapter-dev": "^1.5.0",
+    "@iobroker/testing": "^5.1.1",
+    "@tsconfig/node20": "^20.1.6",
+    "@types/chai": "^4.3.20",
+    "@types/chai-as-promised": "^7.1.8",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^24.6.1",
+    "@types/proxyquire": "^1.3.31",
+    "@types/sinon": "^17.0.4",
+    "@types/sinon-chai": "^4.0.0",
+    "@eslint/js": "^9.14.0",
+    "@iobroker/eslint-config": "^1.5.0",
+    "chai": "^4.5.0",
+    "chai-as-promised": "^7.1.2",
+    "eslint": "^9.14.0",
+    "mocha": "^11.7.2",
+    "prettier": "^3.3.3",
+    "proxyquire": "^2.1.3",
+    "sinon": "^21.0.0",
+    "sinon-chai": "^4.0.1",
+    "typescript": "~5.0.4",
+    "typescript-eslint": "^8.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "readmeFilename": "README.md"
 }