iobroker.esphome 1.0.0-beta.1 → 1.0.0

package/README.md

@@ -147,11 +147,38 @@ All our adapter documentation can be found at [The DrozmotiX Docu Page](https://
 
 ## Prerequisites
 
-    * NodeJS >= 20.x
+    * NodeJS >= 22.x
     * API is activated in YAML
     * For admin tabs (optional)
         * ESPHome Dashboard IP is provided in instance settings
 
+## Testing pre-releases
+
+Pre-releases are published to npm under the `next` dist-tag and are **not** offered by the
+ioBroker repository - they have to be installed explicitly. Feedback on a beta is very welcome,
+please report anything you find in the [issue tracker](https://github.com/DrozmotiX/ioBroker.esphome/issues).
+
+Install the current pre-release from the ioBroker host:
+
+```bash
+iobroker url iobroker.esphome@next
+```
+
+Or install one specific version:
+
+```bash
+iobroker url iobroker.esphome@1.0.0-beta.1
+```
+
+To go back to the released version afterwards:
+
+```bash
+iobroker url iobroker.esphome
+```
+
+Every pre-release is also listed under
+[Releases](https://github.com/DrozmotiX/ioBroker.esphome/releases) with its changelog.
+
 ## ESPHome Dashboard Integration (Optional)
 
 This adapter can optionally integrate the ESPHome Dashboard into ioBroker's admin interface. You have several options:
@@ -413,6 +440,21 @@ If you like my work, please consider a personal donation
     ### __WORK IN PROGRESS__
     * (DutchmanNL)
 -->
+### 1.0.0 (2026-09-26) - Public Stable Release
+
+- (@arteck) **FIXED**: A device that drops while its entities are still being announced no longer throws "Not connected", the state subscription is left to the reconnect
+- (@arteck) **FIXED**: A connection loss logs one "Connection destroyed" warning per device instead of one per entity
+- (@DutchmanNL) **ENHANCED**: Updated @iobroker/testing to 6.2.2 and @iobroker/adapter-core to 3.4.3
+- (@DutchmanNL) **ENHANCED**: Tests now cover Node.js 22, 24 and 26 and the websocket library ws was updated to 8.21.3
+
+### 1.0.0-beta.2 (2026-07-30)
+
+- (@SimonFischer04) **FIXED**: ESPHome Dashboard 2026.6.5 and Pillow 12.2.0 are used instead of the latest available release, the 2026.7.x releases currently fail to install (#463)
+- (@SimonFischer04) **FIXED**: Installations still set to "Always last available" are migrated to those versions once, so an update no longer leaves behind a dashboard that cannot be installed (#463)
+- (@SimonFischer04) **NEW**: Selecting "Always last available" again is respected, the migration runs only once and such a setup only gets a warning at startup (#463)
+- (@DutchmanNL) **FIXED**: Falling back to the latest ESPHome or Pillow release no longer aborts the dashboard setup, the requirement was passed to pip without a version specifier
+- (@DutchmanNL) **FIXED**: Added the missing "pingInterval" and "pingAttempts" defaults to io-package.json, they were only defined in the admin configuration
+- (@DutchmanNL) **ENHANCED**: "npm run check" is free of type errors, so type regressions are visible again
 
 ### 1.0.0-beta.1 (2026-07-28)
 
@@ -441,17 +483,6 @@ If you like my work, please consider a personal donation
 - (@copilot) **FIXED**: Invalid jsonConfig warning on adapter installation
 - (DutchmanNL) **FIXED**: ESLint errors by code refactoring
 
-### 0.7.0-beta.4 (2026-02-21)
-
-- (DutchmanNL) **FIXED**: ESLint errors by code refactoring
-- (@copilot) **FIXED**: Restore missing `configStates` option in admin UI to allow configuring whether configuration states are shown per entity
-- (@copilot) **NEW**: Per-device `rgbAutoWhite` toggle in the light config channel for automatic white-channel routing on RGBW lights (see [Controlling RGBW Lights](#controlling-rgbw-lights))
-
-### 0.7.0-beta.3 (2026-02-20)
-
-- (@copilot) **NEW**: Added support for `colorBrightness`, `coldWhite`, `warmWhite`, and `colorMode` states for lights using the new ESPHome color mode API
-- (@copilot) **FIXED**: RGB light control (brightness, color, white, colorTemperature) not working with newer ESPHome firmware that uses `supportedColorModesList` instead of deprecated legacy flags (#338)
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## License

package/admin/i18n/de.json

@@ -104,5 +104,5 @@
     "reConInterval": "Einstellung zwischen ioBroker versucht, dieses Gerät erneut zu verbinden",
     "templateKeyTip": "Dieser Wert wird vom Adapter bereitgestellt.",
     "ttGetStationId": "Führen Sie diese Aktion für das ausgewählte Gerät aus.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Beispielkonfiguration\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/en.json

@@ -104,5 +104,5 @@
     "reConInterval": "Setting between ioBroker tries to reconnect this device",
     "templateKeyTip": "This value is provided by the adapter.",
     "ttGetStationId": "Run this action for the selected device.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Example configuration\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/es.json

@@ -104,5 +104,5 @@
     "reConInterval": "Configuración entre intentos de ioBroker para volver a conectar este dispositivo",
     "templateKeyTip": "Este valor lo proporciona el adaptador.",
     "ttGetStationId": "Ejecute esta acción para el dispositivo seleccionado.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Configuración de ejemplo\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/fr.json

@@ -104,5 +104,5 @@
     "reConInterval": "Paramètres entre ioBroker essayant de reconnecter cet appareil",
     "templateKeyTip": "Cette valeur est fournie par l'adaptateur.",
     "ttGetStationId": "Exécutez cette action pour le périphérique sélectionné.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Exemple de configuration\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/it.json

@@ -104,5 +104,5 @@
     "reConInterval": "Impostazione tra i tentativi di ioBroker di riconnettere questo dispositivo",
     "templateKeyTip": "Questo valore è fornito dall'adattatore.",
     "ttGetStationId": "Esegui questa azione per il dispositivo selezionato.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Configurazione di esempio\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/nl.json

@@ -104,5 +104,5 @@
     "reConInterval": "Instelling tussen ioBroker-pogingen om dit apparaat opnieuw te verbinden",
     "templateKeyTip": "Deze waarde wordt geleverd door de adapter.",
     "ttGetStationId": "Voer deze actie uit voor het geselecteerde apparaat.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Voorbeeldconfiguratie\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/pl.json

@@ -104,5 +104,5 @@
     "reConInterval": "Ustawienie między próbą ponownego podłączenia tego urządzenia przez ioBroker",
     "templateKeyTip": "Ta wartość jest dostarczana przez adapter.",
     "ttGetStationId": "Uruchom tę akcję dla wybranego urządzenia.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Przykładowa konfiguracja\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/pt.json

@@ -104,5 +104,5 @@
     "reConInterval": "Configuração entre tentativas do ioBroker para reconectar este dispositivo",
     "templateKeyTip": "Esse valor é fornecido pelo adaptador.",
     "ttGetStationId": "Execute esta ação para o dispositivo selecionado.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Configuração de exemplo\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/ru.json

@@ -104,5 +104,5 @@
     "reConInterval": "Настройка между попытками ioBroker повторно подключить это устройство",
     "templateKeyTip": "Это значение предоставляется адаптером.",
     "ttGetStationId": "Запустите это действие для выбранного устройства.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Пример конфигурации\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/uk.json

@@ -104,5 +104,5 @@
     "reConInterval": "Інтервал, через який ioBroker намагається повторно підключити цей пристрій",
     "templateKeyTip": "Це значення забезпечує адаптер.",
     "ttGetStationId": "Запустіть цю дію для вибраного пристрою.",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# Приклад конфігурації\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/admin/i18n/zh-cn.json

@@ -104,5 +104,5 @@
     "reConInterval": "ioBroker 尝试重新连接此设备之间的设置",
     "templateKeyTip": "该值由适配器提供。",
     "ttGetStationId": "为选定的设备运行此操作。",
-    "yamlUploadContentPlaceholder": "esphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
+    "yamlUploadContentPlaceholder": "# 示例配置\nesphome:\n  name: my-device\n  platform: ESP8266\n  board: nodemcuv2"
 }

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "esphome",
-    "version": "1.0.0-beta.1",
+    "version": "1.0.0",
     "news": {
+      "1.0.0": {
+        "en": "**FIXED**: A device that drops while its entities are still being announced no longer throws \"Not connected\", the state subscription is left to the reconnect\n**FIXED**: A connection loss logs one \"Connection destroyed\" warning per device instead of one per entity\n**ENHANCED**: Updated @iobroker/testing to 6.2.2 and @iobroker/adapter-core to 3.4.3\n**ENHANCED**: Tests now cover Node.js 22, 24 and 26 and the websocket library ws was updated to 8.21.3",
+        "de": "**BEHOBEN**: Ein Gerät, das abbricht, während seine Entitäten noch angekündigt werden, gibt nicht mehr „Nicht verbunden“ aus, das Statusabonnement bleibt der erneuten Verbindung überlassen\n**BEHOBEN**: Bei einem Verbindungsverlust wird eine Warnung „Verbindung zerstört“ pro Gerät protokolliert statt einer pro Entität\n**VERBESSERT**: @iobroker/testing auf 6.2.2 und @iobroker/adapter-core auf 3.4.3 aktualisiert\n**VERBESSERT**: Tests decken jetzt Node.js 22, 24 und 26 ab und die Websocket-Bibliothek ws wurde auf 8.21.3 aktualisiert",
+        "ru": "**ИСПРАВЛЕНО**: устройство, которое отключается, пока его объекты все еще объявляются, больше не выдает сообщение «Не подключено», государственная подписка остается на повторное подключение.\n**ИСПРАВЛЕНО**: при потере соединения регистрируется одно предупреждение «Соединение разрушено» для каждого устройства вместо одного для каждого объекта.\n**УЛУЧШЕНО**: @iobroker/testing обновлен до версии 6.2.2 и @iobroker/adapter-core до версии 3.4.3.\n**УЛУЧШЕНО**: тесты теперь охватывают Node.js 22, 24 и 26, а библиотека веб-сокетов ws обновлена до версии 8.21.3.",
+        "pt": "**CORRIGIDO**: Um dispositivo que cai enquanto suas entidades ainda estão sendo anunciadas não gera mais \"Não conectado\", a assinatura do estado fica para a reconexão\n**CORRIGIDO**: uma perda de conexão registra um aviso de \"Conexão destruída\" por dispositivo em vez de um por entidade\n**MELHORADO**: @iobroker/testing atualizado para 6.2.2 e @iobroker/adapter-core para 3.4.3\n**MELHORADO**: Os testes agora cobrem o Node.js 22, 24 e 26 e a biblioteca websocket ws foi atualizada para 8.21.3",
+        "nl": "**OPGELOST**: een apparaat dat uitvalt terwijl de entiteiten nog worden aangekondigd, geeft niet langer de melding \"Niet verbonden\", het statusabonnement wordt overgelaten aan het opnieuw verbinden\n**OPGELOST**: Bij verbindingsverlies wordt één waarschuwing 'Verbinding vernietigd' per apparaat geregistreerd in plaats van één per entiteit\n**VERBETERD**: @iobroker/testing bijgewerkt naar 6.2.2 en @iobroker/adapter-core naar 3.4.3\n**VERBETERD**: tests omvatten nu Node.js 22, 24 en 26 en de websocketbibliotheek ws is bijgewerkt naar 8.21.3",
+        "fr": "**CORRIGÉ** : Un appareil qui tombe alors que ses entités sont encore annoncées ne lance plus \"Non connecté\", l'abonnement de l'état est laissé à la reconnexion\n**CORRIGÉ** : Une perte de connexion enregistre un avertissement « Connexion détruite » par appareil au lieu d'un par entité.\n**AMÉLIORÉ** : mise à jour de @iobroker/testing vers 6.2.2 et de @iobroker/adapter-core vers 3.4.3\n**AMÉLIORÉ** : les tests couvrent désormais Node.js 22, 24 et 26 et la bibliothèque websocket ws a été mise à jour vers 8.21.3",
+        "it": "**RISOLTO**: Un dispositivo che cade mentre le sue entità vengono ancora annunciate non lancia più \"Non connesso\", l'abbonamento statale viene lasciato alla riconnessione\n**RISOLTO**: una perdita di connessione registra un avviso \"Connessione distrutta\" per dispositivo anziché uno per entità\n**MIGLIORATO**: aggiornato @iobroker/testing alla 6.2.2 e @iobroker/adapter-core alla 3.4.3\n**MIGLIORATO**: i test ora coprono Node.js 22, 24 e 26 e la libreria websocket ws è stata aggiornata alla versione 8.21.3",
+        "es": "**CORREGIDO**: Un dispositivo que se cae mientras sus entidades aún se están anunciando ya no arroja \"No conectado\", la suscripción estatal se deja para la reconexión\n**SOLUCIONADO**: Una pérdida de conexión registra una advertencia de \"Conexión destruida\" por dispositivo en lugar de una por entidad\n**MEJORADO**: @iobroker/testing actualizado a 6.2.2 y @iobroker/adapter-core a 3.4.3\n**MEJORADO**: Las pruebas ahora cubren Node.js 22, 24 y 26 y la biblioteca websocket ws se actualizó a 8.21.3",
+        "pl": "**NAPRAWIONO**: Urządzenie, które zostanie utracone, gdy nadal ogłaszane są jego elementy, nie wyświetla już komunikatu „Brak połączenia”, subskrypcja stanowa pozostaje do ponownego połączenia\n**NAPRAWIONO**: W przypadku utraty połączenia rejestrowane jest jedno ostrzeżenie „Połączenie zniszczone” na każde urządzenie zamiast jednego na jednostkę\n**ULEPSZONE**: Zaktualizowano @iobroker/testing do wersji 6.2.2 i @iobroker/adapter-core do wersji 3.4.3\n**ULEPSZONE**: Testy obejmują teraz Node.js 22, 24 i 26, a biblioteka websocket ws została zaktualizowana do wersji 8.21.3",
+        "uk": "**ВИПРАВЛЕНО**: пристрій, який відключається, поки його об’єкти все ще оголошуються, більше не видає повідомлення «Не підключено», підписка на стан залишається для повторного підключення\n**ВИПРАВЛЕНО**: втрата з’єднання реєструє одне попередження «З’єднання зруйновано» на пристрій замість одного на об’єкт.\n**ПОКРАЩЕНО**: оновлено @iobroker/testing до 6.2.2 і @iobroker/adapter-core до 3.4.3\n**ПОКРАЩЕНО**: тепер тести охоплюють Node.js 22, 24 і 26, а бібліотеку websocket ws оновлено до 8.21.3",
+        "zh-cn": "**已修复**：在其实体仍在宣布时掉落的设备不再抛出“未连接”，状态订阅将留给重新连接\n**已修复**：连接丢失会为每个设备记录一个“连接已损坏”警告，而不是每个实体一个\n**增强**：将 @iobroker/testing 更新至 6.2.2，将 @iobroker/adapter-core 更新至 3.4.3\n**增强**：测试现在涵盖 Node.js 22、24 和 26，并且 websocket 库 ws 已更新至 8.21.3"
+      },
+      "1.0.0-beta.2": {
+        "en": "**FIXED**: ESPHome Dashboard 2026.6.5 and Pillow 12.2.0 are used instead of the latest available release, the 2026.7.x releases currently fail to install (#463)\n**FIXED**: Installations still set to \"Always last available\" are migrated to those versions once, so an update no longer leaves behind a dashboard that cannot be installed (#463)\n**NEW**: Selecting \"Always last available\" again is respected, the migration runs only once and such a setup only gets a warning at startup (#463)\n**FIXED**: Falling back to the latest ESPHome or Pillow release no longer aborts the dashboard setup, the requirement was passed to pip without a version specifier\n**FIXED**: Added the missing \"pingInterval\" and \"pingAttempts\" defaults to io-package.json, they were only defined in the admin configuration\n**ENHANCED**: \"npm run check\" is free of type errors, so type regressions are visible again",
+        "de": "**BEHOBEN**: ESPHome Dashboard 2026.6.5 und Pillow 12.2.0 werden anstelle der neuesten verfügbaren Version verwendet, die 2026.7.x-Versionen können derzeit nicht installiert werden (#463)\n**BEHOBEN**: Installationen, die noch auf „Immer zuletzt verfügbar“ eingestellt sind, werden einmal auf diese Versionen migriert, sodass ein Update kein Dashboard mehr hinterlässt, das nicht installiert werden kann (#463)\n**NEU**: Die erneute Auswahl von „Immer zuletzt verfügbar“ wird berücksichtigt, die Migration wird nur einmal ausgeführt und ein solches Setup erhält nur beim Start eine Warnung (#463)\n**BEHOBEN**: Beim Zurückgreifen auf die neueste ESPHome- oder Pillow-Version wird die Dashboard-Einrichtung nicht mehr abgebrochen. Die Anforderung wurde ohne Versionsspezifizierer an pip übergeben\n**BEHOBEN**: Die fehlenden Standardeinstellungen „pingInterval“ und „pingAttempts“ wurden zu io-package.json hinzugefügt. Sie wurden nur in der Administratorkonfiguration definiert\n**VERBESSERT**: „npm run check“ ist frei von Typfehlern, sodass Typregressionen wieder sichtbar sind",
+        "ru": "**ИСПРАВЛЕНО**: ESPHome Dashboard 2026.6.5 и Pillow 12.2.0 используются вместо последней доступной версии, версии 2026.7.x в настоящее время не устанавливаются (#463).\n**ИСПРАВЛЕНО**: Установки, для которых по-прежнему установлен режим «Всегда последний доступный», переносятся в эти версии один раз, поэтому обновление больше не оставляет после себя панель управления, которую невозможно установить (#463).\n**НОВОЕ**: повторный выбор «Всегда последний доступен» учитывается, миграция выполняется только один раз, и такая настройка получает предупреждение только при запуске (# 463).\n**ИСПРАВЛЕНО**: возврат к последней версии ESPHome или Pillow больше не прерывает настройку информационной панели, требование было передано в pip без указания версии.\n**ИСПРАВЛЕНО**: в io-package.json добавлены отсутствующие значения по умолчанию «pingInterval» и «pingAttempts», они были определены только в конфигурации администратора.\n**УЛУЧШЕНО**: «проверка запуска npm» не содержит ошибок типа, поэтому регрессия типов снова видна.",
+        "pt": "**CORRIGIDO**: ESPHome Dashboard 2026.6.5 e Pillow 12.2.0 são usados em vez da versão mais recente disponível, as versões 2026.7.x atualmente não conseguem ser instaladas (#463)\n**CORRIGIDO**: As instalações ainda definidas como \"Sempre últimas disponíveis\" são migradas para essas versões uma vez, portanto, uma atualização não deixa mais um painel que não pode ser instalado (#463)\n**NOVO**: Selecionar \"Sempre o último disponível\" novamente é respeitado, a migração é executada apenas uma vez e tal configuração só recebe um aviso na inicialização (#463)\n**CORRIGIDO**: Voltar para a versão mais recente do ESPHome ou Pillow não cancela mais a configuração do painel, o requisito foi passado para pip sem um especificador de versão\n**CORRIGIDO**: Adicionados os padrões \"pingInterval\" e \"pingAttempts\" ausentes para io-package.json, eles foram definidos apenas na configuração do administrador\n**MELHORADO**: \"npm run check\" está livre de erros de tipo, então as regressões de tipo são visíveis novamente",
+        "nl": "**OPGELOST**: ESPHome Dashboard 2026.6.5 en Pillow 12.2.0 worden gebruikt in plaats van de nieuwste beschikbare release, de 2026.7.x-releases kunnen momenteel niet worden geïnstalleerd (#463)\n**OPGELOST**: Installaties die nog steeds zijn ingesteld op 'Altijd laatst beschikbaar' worden één keer naar die versies gemigreerd, zodat een update niet langer een dashboard achterlaat dat niet kan worden geïnstalleerd (#463)\n**NIEUW**: Opnieuw \"Altijd laatst beschikbaar\" selecteren wordt gerespecteerd, de migratie wordt slechts één keer uitgevoerd en zo'n setup krijgt alleen een waarschuwing bij het opstarten (#463)\n**OPGELOST**: Terugvallen naar de nieuwste ESPHome- of Pillow-release breekt niet langer de dashboardconfiguratie af, de vereiste werd doorgegeven aan pip zonder een versiespecificatie\n**OPGELOST**: De ontbrekende standaardwaarden \"pingInterval\" en \"pingAttempts\" zijn toegevoegd aan io-package.json, deze werden alleen gedefinieerd in de beheerdersconfiguratie\n**VERBETERD**: \"npm run check\" bevat geen typefouten, dus typeregressies zijn weer zichtbaar",
+        "fr": "**CORRIGÉ** : ESPHome Dashboard 2026.6.5 et Pillow 12.2.0 sont utilisés à la place de la dernière version disponible, les versions 2026.7.x ne parviennent actuellement pas à s'installer (#463)\n**CORRIGÉ** : Les installations toujours définies sur \"Toujours dernière disponible\" sont migrées vers ces versions une fois, donc une mise à jour ne laisse plus derrière elle un tableau de bord qui ne peut pas être installé (#463).\n**NOUVEAU** : La sélection à nouveau de \"Toujours dernier disponible\" est respectée, la migration ne s'exécute qu'une seule fois et une telle configuration ne reçoit qu'un avertissement au démarrage (#463)\n** CORRIGÉ ** : le retour à la dernière version d'ESPHome ou Pillow n'interrompt plus la configuration du tableau de bord, l'exigence a été transmise à pip sans spécificateur de version.\n**FIXED** : Ajout des valeurs par défaut manquantes \"pingInterval\" et \"pingAttempts\" à io-package.json, elles n'étaient définies que dans la configuration de l'administrateur\n**AMÉLIORÉ** : \"npm run check\" est exempt d'erreurs de type, donc les régressions de type sont à nouveau visibles",
+        "it": "**RISOLTO**: ESPHome Dashboard 2026.6.5 e Pillow 12.2.0 vengono utilizzati al posto dell'ultima versione disponibile, le versioni 2026.7.x attualmente non vengono installate (#463)\n**RISOLTO**: le installazioni ancora impostate su \"Sempre ultime disponibili\" vengono migrate a quelle versioni una volta, quindi un aggiornamento non lascia più un dashboard che non può essere installato (#463)\n**NOVITÀ**: Selezionando nuovamente \"Sempre ultimo disponibile\" viene rispettata, la migrazione viene eseguita solo una volta e tale configurazione riceve un avviso solo all'avvio (#463)\n**RISOLTO**: il ritorno all'ultima versione di ESPHome o Pillow non interrompe più la configurazione del dashboard, il requisito veniva passato a pip senza uno specificatore di versione\n**RISOLTO**: aggiunti i valori predefiniti mancanti \"pingInterval\" e \"pingAttempts\" a io-package.json, erano definiti solo nella configurazione dell'amministratore\n**MIGLIORATO**: \"npm run check\" è privo di errori di tipo, quindi le regressioni di tipo sono nuovamente visibili",
+        "es": "**CORREGIDO**: ESPHome Dashboard 2026.6.5 y Pillow 12.2.0 se utilizan en lugar de la última versión disponible; las versiones 2026.7.x actualmente no se instalan (#463)\n**CORREGIDO**: Las instalaciones que aún están configuradas como \"Siempre disponibles por última vez\" se migran a esas versiones una vez, por lo que una actualización ya no deja un panel que no se puede instalar (#463)\n**NUEVO**: Se respeta la selección \"Siempre último disponible\", la migración se ejecuta solo una vez y dicha configuración solo recibe una advertencia al inicio (#463)\n**CORREGIDO**: Volver a la última versión de ESPHome o Pillow ya no cancela la configuración del panel, el requisito se pasó a pip sin un especificador de versión\n**CORREGIDO**: Se agregaron los valores predeterminados faltantes de \"pingInterval\" y \"pingAttempts\" a io-package.json, solo se definieron en la configuración del administrador.\n**MEJORADO**: \"npm run check\" no tiene errores de tipo, por lo que las regresiones de tipo son visibles nuevamente",
+        "pl": "**NAPRAWIONO**: ESPHome Dashboard 2026.6.5 i Pillow 12.2.0 są używane zamiast najnowszej dostępnej wersji, obecnie nie można zainstalować wersji 2026.7.x (#463)\n**NAPRAWIONO**: Instalacje nadal ustawione na „Zawsze ostatnio dostępne” są migrowane do tych wersji tylko raz, więc aktualizacja nie pozostawia już pulpitu nawigacyjnego, którego nie można zainstalować (#463)\n**NOWOŚĆ**: Ponowne wybranie opcji „Zawsze ostatnia dostępna” jest przestrzegane, migracja odbywa się tylko raz, a taka konfiguracja wyświetla ostrzeżenie tylko przy uruchomieniu (#463)\n**NAPRAWIONO**: Powrót do najnowszej wersji ESPHome lub Pillow nie powoduje już przerwania konfiguracji pulpitu nawigacyjnego, wymaganie zostało przekazane do pip bez specyfikatora wersji\n**NAPRAWIONO**: Dodano brakujące wartości domyślne „pingInterval” i „pingAttempts” do io-package.json, zostały one zdefiniowane tylko w konfiguracji administratora\n**ULEPSZONE**: „sprawdzenie przebiegu npm” jest wolne od błędów typów, więc regresje typów są ponownie widoczne",
+        "uk": "**ВИПРАВЛЕНО**: ESPHome Dashboard 2026.6.5 і Pillow 12.2.0 використовуються замість останньої доступної версії, версії 2026.7.x наразі не вдається встановити (#463)\n**ВИПРАВЛЕНО**: інсталяції, які все ще мають значення «Завжди останні доступні», переносяться до цих версій один раз, тому оновлення більше не залишає інформаційну панель, яку неможливо встановити (#463)\n**НОВЕ**: вибір «Завжди останній доступний» знову виконується, міграція виконується лише один раз, і таке налаштування отримує лише попередження під час запуску (#463)\n**ВИПРАВЛЕНО**: повернення до останньої версії ESPHome або Pillow більше не припиняє налаштування інформаційної панелі, вимогу було передано pip без специфікатора версії\n**ВИПРАВЛЕНО**: до io-package.json додано відсутні параметри «pingInterval» і «pingAttempts» за замовчуванням, їх було визначено лише в конфігурації адміністратора\n**ПОКРАЩЕНО**: \"npm run check\" не містить помилок типу, тому регресії типу знову видно",
+        "zh-cn": "**已修复**：使用 ESPHome Dashboard 2026.6.5 和 Pillow 12.2.0，而不是最新的可用版本，2026.7.x 版本当前无法安装 (#463)\n**已修复**：仍设置为“始终最后可用”的安装会迁移到这些版本一次，因此更新不再留下无法安装的仪表板 (#463)\n**新**：再次选择“始终最后可用”受到尊重，迁移仅运行一次，并且此类设置仅在启动时收到警告（#463）\n**已修复**：回退到最新的 ESPHome 或 Pillow 版本不再中止仪表板设置，要求已在没有版本说明符的情况下传递给 pip\n**已修复**：将缺少的“pingInterval”和“pingAttempts”默认值添加到 io-package.json，它们仅在管理配置中定义\n**增强**：“npm run check”没有类型错误，因此类型回归再次可见"
+      },
       "1.0.0-beta.1": {
         "en": "**FIXED**: Restored a green CI matrix, the dashboard integration tests no longer hang the test runner\n**FIXED**: Corrected the changelog entry in io-package.json so it matches the published version\n**FIXED**: Admin configuration is fully translated again, 29 texts were only available in English\n**FIXED**: YAML upload field renders as a proper multi-line text area again\n**ENHANCED**: Timers are now managed by the adapter, so they are always cleaned up on unload\n**ENHANCED**: Pre-releases are published under the npm \"beta\" tag instead of \"latest\"\n**ENHANCED**: Removed the obsolete admin/words.js and added prettier formatting scripts\n**ENHANCED**: Updated @iobroker/testing to 5.3.0 and the GitHub actions used in CI",
         "de": "**BEHOBEN**: Eine grüne CI-Matrix wurde wiederhergestellt. Die Dashboard-Integrationstests hängen den Test Runner nicht mehr auf\n**BEHOBEN**: Der Changelog-Eintrag in io-package.json wurde korrigiert, sodass er mit der veröffentlichten Version übereinstimmt\n**BEHOBEN**: Admin-Konfiguration ist wieder vollständig übersetzt, 29 Texte waren nur auf Englisch verfügbar\n**BEHOBEN**: Das YAML-Upload-Feld wird wieder als richtiger mehrzeiliger Textbereich dargestellt\n**VERBESSERT**: Timer werden jetzt vom Adapter verwaltet, sodass sie beim Entladen immer bereinigt werden\n**VERBESSERT**: Vorabversionen werden unter dem npm-Tag „beta“ anstelle von „latest“ veröffentlicht.\n**VERBESSERT**: Die veraltete Datei admin/words.js wurde entfernt und hübschere Formatierungsskripte hinzugefügt\n**VERBESSERT**: @iobroker/testing auf 5.3.0 und die in CI verwendeten GitHub-Aktionen aktualisiert",
@@ -67,32 +93,6 @@
         "pl": "ulepszenie README\nfix # 394, actually fix # 340, # 356\n* *FIXED* *: Element wentylatora nie działa # 205 \n* *NOWOŚĆ* *: Zezwalaj na personalizację wersji Poduszki używanej przez ESPHome Dashboard, podobną do wyboru wersji ESPHome \n* *NOWOŚĆ* *: Dodaj przycisk \"Clear Autopy Cache\" w zakładce Konfiguracja tablicy rozdzielczej ESPHome, aby rozwiązać problemy z załadowaniem tablicy rozdzielczej (# 209) ",
         "uk": "покращити резюме\nвиправити #394, насправді виправити #340, #356\n**FIXED***: Компонент вентилятора не працює #205\n**NEW**: Дозволяє налаштування версії Pillow, що використовується ESPHome Dashboard, схожим на ESPHome версія selector\n**NEW**: Додати кнопку \"Зареєструвати Autopy Cache\" у вкладці конфігурації ESPHome Dashboard для вирішення проблем завантаження панелі (#209)",
         "zh-cn": "改进读取\n修复394号,实际修复340号,356号\n** FIXED**:粉丝组件不工作#205\n**NEW**:允许定制ESPHome Dashboard使用的Pillow版本,类似于ESPHome版本选择器\n**NEW**:在ESPHome Dashboard配置标签中添加\"清除自动缓存\"按钮以解决仪表板加载问题(# 209)"
-      },
-      "0.7.0-beta.1": {
-        "en": "improve dashboard testing",
-        "de": "dashboard testen",
-        "ru": "улучшить тестирование приборной панели",
-        "pt": "melhorar o teste do painel",
-        "nl": "verbeteren van dashboard testen",
-        "fr": "améliorer les essais de tableau de bord",
-        "it": "migliorare il test del cruscotto",
-        "es": "mejorar las pruebas de dashboard",
-        "pl": "poprawić testowanie płyt rozdzielczych",
-        "uk": "поліпшити тестування панелі приладів",
-        "zh-cn": "改进仪表板测试"
-      },
-      "0.7.0-beta.0": {
-        "en": "**FIXED**: Invalid jsonConfig schema - removed unsupported `doNotSave` property from table elements\n**NEW**: YAML file management interface in admin UI for upload/download/delete operations (#369)\nimprove logging for #201\nautomatic migration from versions prior to ESPHomeDashboardUrl introduction (pre v0.6.1)\nupdate pillow\nfix readme link to lib\nfix connection status #311\nremove unneeded node-fetch dependency",
-        "de": "**FIXED**: Invalid jsonConfig Schema - entfernte nicht unterstützte `doNotSave` Eigenschaft von Tabellenelementen\n**NEW**: YAML-Dateiverwaltungsschnittstelle in admin UI für Upload/Download/Auslöschung (#369)\nverbesserung der protokollierung für #201\nautomatische Migration von Versionen vor der Einführung von ESPHomeDashboardUrl (pre v0.6.1)\nupdate kissen\nreadme link zu lib reparieren\nfix-verbindungsstatus #311\nnicht benötigte knoten-fetch-abhängigkeit entfernen",
-        "ru": "** FIXED**: Недействительная схема jsonConfig - удалено неподдерживаемое свойство \"doNotSave\" из элементов таблицы\n**NEW**: интерфейс управления файлами YAML в интерфейсе администратора для операций загрузки/загрузки/удаления (#369)\nулучшение регистрации для #201\nавтоматическая миграция с версий до внедрения ESPHomeDashboardUrl (pre v0.6.1)\nобновление подушки\nобсуждение readme link to lib\nстатус подключения #311\nустранение ненужной зависимости от узла",
-        "pt": "**FIXED**: Esquema inválido do jsonConfig - propriedade `doNotSave` não suportada\n**NOVO**: Interface de gerenciamento de arquivos YAML na interface de administração UI para operações de upload/download/delete (#369)\nmelhorar o registro para #201\nmigração automática de versões anteriores à introdução ESPHomeDashboardUrl (pré v0.6.1)\natualizar almofada\ncorrigir o link readme para a lib\ncorrigir o estado da ligação # 311\nremover a dependência de busca de nó desnecessária",
-        "nl": "** VAST**: Ongeldig jsonConfig schema - verwijderde niet-ondersteunde eigenschap van tabelelementen\n**NIEUW**: YAML file management interface in admin UI voor upload/download/delete operaties (#369)\nverbeteren logging voor #201\nautomatische migratie van versies voorafgaand aan ESPHomeDashboardUrl introductie (pre v0.6.1)\nupdate kussen\nrepareren readme link naar lib\nfix verbindingsstatus #311\nverwijder ongewenste node-fetch afhankelijkheid",
-        "fr": "**FIXED**: Schéma jsonConfig non valide - supprimé la propriété `doNotSave` non supportée des éléments de table\n**NOUVEAU**: Interface de gestion de fichiers YAML dans l'interface utilisateur admin pour les opérations de téléchargement/téléchargement/effacement (#369)\naméliorer l'enregistrement pour #201\nmigration automatique des versions avant l'introduction de ESPHomeDashboardUrl (pre v0.6.1)\nmettre à jour l'oreiller\ncorriger le lien readme vers lib\nfixer l'état de connexion #311\nsupprimer la dépendance inutile des nœuds",
-        "it": "**FIXED**: Invalid jsonConfig schema - rimosso `doNotSave` immobili da elementi da tavolo\n**NEW**: interfaccia di gestione dei file YAML nell'interfaccia di amministrazione UI per operazioni di upload/download/delete (#369)\nmigliorare logging per #201\nmigrazione automatica dalle versioni precedenti l'introduzione di ESPHomeDashboardUrl (pre v0.6.1)\naggiornamento cuscino\ncorrezione link di lettura per lib\nstato di connessione di correzione #311\nrimuovere la dipendenza da nodo-fetch non necessaria",
-        "es": "**FIXED**: Invalid jsonConfig schema - eliminó propiedad no apoyada `doNotSave` de elementos de mesa\n**NEW**: Interfaz de gestión de archivos YAML en admin UI para operaciones de carga/descarga/delete (#369)\nmejorar el registro para #201\nmigración automática desde versiones anteriores a ESPHomeDashboardIntroducción del usuario (pre v0.6.1)\nactualización almohada\narreglar el vínculo readme con la lib\nestado de conexión de fijación #311\neliminar la dependencia sin necesidad",
-        "pl": "* *FIXED* *: Nieprawidłowy schemat jsonConfig - usunięte nieobsługiwane właściwości 'doNotSave' z elementów tabeli \n* *NOWOŚĆ* *: Interfejs do zarządzania plikami YAML w UI administratora do wysyłania / pobierania / usuwania operacji (# 369) \npoprawić logowanie dla # 201\nautomatyczna migracja z wersji przed wprowadzeniem ESPHOmeDashboardUrl (pre v0.6.1)\naktualizacji poduszki\nfix readme link do lib\nustaw status połączenia # 311\nusuń niepotrzebną zależność node-get",
-        "uk": "**FIXED**: Invalid jsonConfig schema - вилучено непідтримуваний `doNotSave` майно з елементів таблиці\n**NEW**: Інтерфейс керування файлами YAML в адмін UI для завантаження / завантаження / видалення операцій (#369)\nпокращити залогів на #201\nавтоматична міграція з версій до ESPHomeDashboardUrl введення (pre v0.6.1)\nоновлення подушки\nвиправити посилання для читання\nстатус на сервери\nвидалити невидиму залежність від вузла",
-        "zh-cn": "** FIXED**: 无效的jsonConfig schema - 从表格元素中删除未支持的“不拯救”属性\n**NEW**:用于上传/下载/删除操作的管理员UI中的YAML文件管理接口(# 369)\n改进201号记录\n从ESPHomeDashboardUrl引入前的版本自动迁移(pre v0.6.1)\n更新枕头\n固定读取链接到 lib\n固定连接状态 # 311\n删除不需要的节点依赖"
       }
     },
     "titleLang": {
@@ -182,9 +182,11 @@
     "apiPassword"
   ],
   "native": {
-    "ESPHomeDashboardVersion": "Always last available",
-    "PillowVersion": "Always last available",
+    "ESPHomeDashboardVersion": "2026.6.5",
+    "PillowVersion": "12.2.0",
     "reconnectInterval": 30,
+    "pingInterval": 5,
+    "pingAttempts": 1,
     "apiPass": "",
     "apiPassword": "",
     "encryptionKey": "",

package/lib/dashboardApi.js

@@ -58,11 +58,16 @@ async function request(method, dashboardUrl, path, params) {
 async function streamLogs(dashboardUrl, path, spawnParams, lineReceivedCb) {
     const wsUrl = `${dashboardUrl.replace(/\/+$/, '').replace(/^http/, 'ws')}/${path}`;
 
-    // Prefer native WebSocket (Node >= 22), but fall back to "ws" package on older Node versions
+    // Prefer native WebSocket (Node >= 22), but fall back to "ws" package on older Node versions.
+    // Both constructors are used interchangeably here although they expose different APIs
+    // (addEventListener vs. on), which is why the two branches below exist and why the instance
+    // cannot be described by a single type.
     const hasNativeWebSocket = typeof WebSocket !== 'undefined';
-    let WebSocketImpl = hasNativeWebSocket ? WebSocket : null;
+    let WebSocketImpl;
 
-    if (!WebSocketImpl) {
+    if (hasNativeWebSocket) {
+        WebSocketImpl = WebSocket;
+    } else {
         try {
             WebSocketImpl = require('ws');
         } catch {

package/lib/helpers.js

@@ -16,13 +16,18 @@ class DeviceInfo {
     connected = false;
     connecting = false;
     connectionError = false;
+    connectionDestroyedLogged = false;
     connectStatus = 'Initialisation needed';
     deletionRequested = false;
+    /** @type {string | null} */
     deviceFriendlyName = null;
     deviceInfo = null;
+    /** @type {string | null} */
     deviceName = null;
     initialized = false;
+    /** @type {string | null} */
     ip = null;
+    /** @type {string | null} */
     mac = null;
 }
 

package/lib/stateAttr.js

@@ -96,6 +96,13 @@ const stateAttrb = {
         write: true,
         role: 'switch',
     },
+    versionPinMigrationDone: {
+        name: 'Migration to pinned dashboard versions applied',
+        type: 'boolean',
+        read: true,
+        write: false,
+        role: 'indicator',
+    },
 };
 
 module.exports = stateAttrb;

package/lib/yamlFileManager.js

@@ -163,10 +163,11 @@ class YamlFileManager {
                 message: `File ${filename} uploaded successfully`,
             };
         } catch (error) {
+            const reason = error instanceof Error && error.message ? error.message : String(error);
             this.adapter.log.error(`[yamlFileManager.uploadYamlFile] ${error}`);
             return {
                 success: false,
-                error: `Failed to upload file: ${error.message || error}`,
+                error: `Failed to upload file: ${reason}`,
             };
         }
     }
@@ -208,10 +209,11 @@ class YamlFileManager {
                 filename: filename,
             };
         } catch (error) {
+            const reason = error instanceof Error && error.message ? error.message : String(error);
             this.adapter.log.error(`[yamlFileManager.downloadYamlFile] ${error}`);
             return {
                 success: false,
-                error: `Failed to download file: ${error.message || error}`,
+                error: `Failed to download file: ${reason}`,
             };
         }
     }
@@ -253,10 +255,11 @@ class YamlFileManager {
                 message: `File ${filename} deleted successfully`,
             };
         } catch (error) {
+            const reason = error instanceof Error && error.message ? error.message : String(error);
             this.adapter.log.error(`[yamlFileManager.deleteYamlFile] ${error}`);
             return {
                 success: false,
-                error: `Failed to delete file: ${error.message || error}`,
+                error: `Failed to delete file: ${reason}`,
             };
         }
     }

package/main.js

@@ -9,7 +9,6 @@
 const utils = require('@iobroker/adapter-core');
 const clientDevice = require('./lib/helpers.js');
 const YamlFileManager = require('./lib/yamlFileManager.js');
-// @ts-expect-error Client is just missing in index.d.ts file
 const { Client, Discovery } = require('@2colors/esphome-native-api');
 const stateAttr = require(`${__dirname}/lib/stateAttr.js`); // Load attribute library
 const disableSentry = false; // Ensure to set to true during development!
@@ -23,6 +22,17 @@ const clientDetails = {}; // Memory cache of all devices and their connection st
 const newlyDiscoveredClient = {}; // Memory cache of all newly discovered devices and their connection status
 const dashboardVersions = [];
 const pillowVersions = []; // Memory cache for available Pillow versions
+
+// Versions installations are pinned to. ESPHome 2026.7.x currently fails to install for a part of
+// our users (#463), so both the defaults for new installations and the one-time migration in
+// migratePinnedVersions() point at the last combination known to work instead of
+// "Always last available". Keep in sync with the "native" defaults in io-package.json.
+const defaultDashboardVersion = '2026.6.5';
+const defaultPillowVersion = '12.2.0';
+
+// State holding whether the one-time migration away from "Always last available" already ran.
+const versionMigrationState = '_ESPHomeDashboard.versionPinMigrationDone';
+
 class Esphome extends utils.Adapter {
     /**
      * @param {Partial<utils.AdapterOptions>} [options] - Adapter configuration options
@@ -55,6 +65,9 @@ class Esphome extends utils.Adapter {
             // Migrate from older adapter versions that only had ESPHomeDashboardIP
             await this.migrateConfig();
 
+            // Move installations still on "Always last available" to the pinned versions, once
+            await this.migratePinnedVersions();
+
             //ToDo: store default data into clientDetails object instead of global variable
             // Store settings in global variables
             // defaultApiPass = this.config.apiPass;
@@ -152,8 +165,105 @@ class Esphome extends utils.Adapter {
                 // adapter will restart
             }
         } catch (error) {
+            const reason = error instanceof Error && error.message ? error.message : String(error);
             this.log.error(
-                `Error during configuration migration from ESPHomeDashboardIP to ESPHomeDashboardUrl: ${error.message || error}`,
+                `Error during configuration migration from ESPHomeDashboardIP to ESPHomeDashboardUrl: ${reason}`,
+            );
+        }
+    }
+
+    /**
+     * Migrate installations which are still on "Always last available" to the pinned versions, once.
+     *
+     * The pinned defaults in io-package.json only apply to new installations, so without this every
+     * existing installation would stay on a release line that currently cannot be installed (#463)
+     * and would have to be corrected by hand.
+     *
+     * Whether the migration already ran is stored in a state, not in "native": a new installation
+     * already ships the pinned defaults, and a "native" marker would be seeded into every existing
+     * instance on upgrade, so neither could tell "not migrated yet" from "nothing to migrate".
+     * Once the marker is set, a deliberate switch back to "Always last available" is never touched.
+     */
+    async migratePinnedVersions() {
+        try {
+            await this.extendObjectAsync('_ESPHomeDashboard', {
+                type: 'channel',
+                common: {
+                    name: 'ESPHome Dashboard details',
+                },
+                native: {},
+            });
+
+            const migrationDone = await this.getStateAsync(versionMigrationState);
+            if (migrationDone && migrationDone.val === true) {
+                return;
+            }
+
+            /** @type {Record<string, string>} */
+            const migrated = {};
+            if (this.config.ESPHomeDashboardVersion === 'Always last available') {
+                migrated.ESPHomeDashboardVersion = defaultDashboardVersion;
+            }
+            if (this.config.PillowVersion === 'Always last available') {
+                migrated.PillowVersion = defaultPillowVersion;
+            }
+
+            // New installation, or the versions were already pinned by hand: only remember that the
+            // migration is done so a later switch to "Always last available" is respected.
+            if (!Object.keys(migrated).length) {
+                await this.stateSetCreate(versionMigrationState, 'versionPinMigrationDone', true);
+                return;
+            }
+
+            const adapterObj = await this.getForeignObjectAsync(`system.adapter.${this.namespace}`);
+            if (!adapterObj || !adapterObj.native) {
+                this.log.error(
+                    `Migration to pinned versions failed: could not read the configuration object of ${this.namespace}. Please select a fixed ESPHome Dashboard version in the adapter configuration.`,
+                );
+                return;
+            }
+
+            const changes = Object.entries(migrated)
+                .map(([key, value]) => `${key} = ${value}`)
+                .join(', ');
+            this.log.info(
+                `Not every ESPHome release can be installed on every system, so your configuration has been migrated once from "Always last available" to the last combination known to work: ${changes}. Select "Always last available" again in the adapter configuration if you prefer to follow the newest release, this migration only runs once.`,
+            );
+
+            Object.assign(adapterObj.native, migrated);
+            // Keep this run consistent until the restart caused by the write below kicks in
+            Object.assign(this.config, migrated);
+
+            await this.setForeignObject(adapterObj._id, adapterObj);
+            // Written after the configuration: should the write above fail, the migration is retried
+            // on the next start instead of being silently skipped forever
+            await this.stateSetCreate(versionMigrationState, 'versionPinMigrationDone', true);
+
+            // adapter will restart
+        } catch (error) {
+            this.errorHandler(`[migratePinnedVersions]`, error);
+        }
+    }
+
+    /**
+     * Warn when a version is left at "Always last available". Such a setup can break without any
+     * change on the user side as soon as an ESPHome release cannot be installed (#463). Reached only
+     * when the user selected it deliberately, migratePinnedVersions() moves existing installations
+     * off that setting once.
+     *
+     * @param {string} useDashBoardVersion - ESPHome Dashboard version which will be installed
+     * @param {string} usePillowVersion - Pillow version which will be installed
+     */
+    warnUnpinnedVersions(useDashBoardVersion, usePillowVersion) {
+        if (this.config.ESPHomeDashboardVersion === 'Always last available') {
+            this.log.warn(
+                `ESPHome Dashboard version is set to "Always last available" and resolves to ${useDashBoardVersion || 'the newest release'}. Not every ESPHome release can be installed on every system. If the dashboard does not start, select a fixed version in the adapter configuration, ${defaultDashboardVersion} is known to work.`,
+            );
+        }
+
+        if (this.config.PillowVersion === 'Always last available') {
+            this.log.warn(
+                `Pillow version is set to "Always last available" and resolves to ${usePillowVersion || 'the newest release'}. If the dashboard does not start, select a fixed version in the adapter configuration, ${defaultPillowVersion} is known to work.`,
             );
         }
     }
@@ -211,7 +321,7 @@ class Esphome extends utils.Adapter {
                 );
                 let cachedVersions = await this.getStateAsync(`_ESPHomeDashboard.versionCache`);
                 if (cachedVersions && cachedVersions.val) {
-                    cachedVersions = JSON.parse(cachedVersions.val);
+                    cachedVersions = JSON.parse(String(cachedVersions.val));
                     for (const version in cachedVersions) {
                         dashboardVersions.push(cachedVersions[version].name);
                     }
@@ -266,11 +376,16 @@ class Esphome extends utils.Adapter {
             // Start Dashboard Process
             if (this.config.ESPHomeDashboardEnabled) {
                 this.log.info(`Native Integration of ESPHome Dashboard enabled, making environment ready`);
+
+                this.warnUnpinnedVersions(useDashBoardVersion, usePillowVersion);
                 try {
-                    // @ts-expect-error autopy types are incomplete
                     const { getVenv } = await import('autopy');
                     let python;
                     try {
+                        // "version" must be present on every requirement even when no version is
+                        // pinned: autopy builds the pip argument as `${name}${version}` and passes
+                        // it to pep440 satisfies(), both of which break on undefined. An empty
+                        // specifier means "any version" for both.
                         const requirements = [];
                         if (useDashBoardVersion) {
                             requirements.push({ name: 'esphome', version: `==${useDashBoardVersion}` });
@@ -278,7 +393,7 @@ class Esphome extends utils.Adapter {
                             this.log.warn(
                                 `Unable to determine a specific ESPHome dashboard version. Falling back to latest available version from PyPI`,
                             );
-                            requirements.push({ name: 'esphome' });
+                            requirements.push({ name: 'esphome', version: '' });
                         }
                         if (usePillowVersion) {
                             requirements.push({ name: 'pillow', version: `==${usePillowVersion}` });
@@ -286,7 +401,7 @@ class Esphome extends utils.Adapter {
                             this.log.warn(
                                 `Unable to determine a specific Pillow version. Falling back to latest available version from PyPI`,
                             );
-                            requirements.push({ name: 'pillow' });
+                            requirements.push({ name: 'pillow', version: '' });
                         }
                         // Create a virtual environment with esphome installed.
                         python = await getVenv({
@@ -295,7 +410,8 @@ class Esphome extends utils.Adapter {
                             requirements,
                         });
                     } catch (error) {
-                        this.log.error(`Fatal error starting ESPHomeDashboard | ${error} | ${error.stack}`);
+                        const stack = error instanceof Error ? error.stack : undefined;
+                        this.log.error(`Fatal error starting ESPHomeDashboard | ${error} | ${stack}`);
                         return;
                     }
 
@@ -321,7 +437,7 @@ class Esphome extends utils.Adapter {
                     dashboardProcess = python('esphome', [
                         'dashboard',
                         '--port',
-                        this.config.ESPHomeDashboardPort,
+                        String(this.config.ESPHomeDashboardPort),
                         `${dataDir}esphome.${this.instance}`,
                     ]);
 
@@ -523,6 +639,8 @@ class Esphome extends utils.Adapter {
                     this.log.info(`ESPHome client ${host} connected`);
                     // Clear possible present warning messages for devices from previous connection
                     delete warnMessages[host];
+                    // Allow the next connection-loss event to log a "Connection destroyed" warning again
+                    clientDetails[host].connectionDestroyedLogged = false;
 
                     // Check if device connection is caused by adding  device from admin, if yes send OK message
                     if (this.messageResponse[host]) {
@@ -636,7 +754,6 @@ class Esphome extends utils.Adapter {
                             statusStates: {
                                 onlineId: `${this.namespace}.${deviceName}.info._online`,
                             },
-                            // @ts-expect-error js-controller issue - desc should be string but friendlyName may be undefined
                             desc: deviceInfo.friendlyName,
                         },
                         native: {
@@ -804,8 +921,19 @@ class Esphome extends utils.Adapter {
 
                     await this.createNonStateDevices(host, entity);
 
-                    // Request current state values
-                    await clientDetails[host].client.connection.subscribeStatesService();
+                    // Request current state values. If the connection dropped while entities were
+                    // still being announced, `newEntity` fires again on the stale connection and
+                    // subscribeStatesService() throws "Not connected". Skip it silently here; the
+                    // reconnection cycle handles the fresh subscription.
+                    if (clientDetails[host].client.connection.connected) {
+                        try {
+                            await clientDetails[host].client.connection.subscribeStatesService();
+                        } catch (e) {
+                            this.log.debug(
+                                `[subscribeStates] ${clientDetails[host].deviceFriendlyName}: ${e instanceof Error ? e.message : e}`,
+                            );
+                        }
+                    }
                     this.log.debug(
                         `[DeviceInfoData] ${clientDetails[host].deviceFriendlyName} ${JSON.stringify(clientDetails[host].deviceInfo)}`,
                     );
@@ -929,6 +1057,14 @@ class Esphome extends utils.Adapter {
 
                     entity.on(`destroyed`, async state => {
                         try {
+                            // `destroyed` fires once per entity when the connection goes down.
+                            // Log only the first one per connection-loss event and let the
+                            // 'disconnected' handler summarize the device that went away.
+                            if (clientDetails[host].connectionDestroyedLogged) {
+                                return;
+                            }
+                            clientDetails[host].connectionDestroyedLogged = true;
+
                             const entityIdentity = entity?.name || entity?.id || host || 'unknown';
                             if (state !== undefined) {
                                 this.log.warn(`Connection destroyed for ${state} (${entityIdentity})`);
@@ -944,7 +1080,8 @@ class Esphome extends utils.Adapter {
                         this.log.error(`Entity error: ${name}`);
                     });
                 } catch (e) {
-                    this.log.error(`Connection issue for ${entity.name} ${e} | ${e.stack}`);
+                    const stack = e instanceof Error ? e.stack : undefined;
+                    this.log.error(`Connection issue for ${entity.name} ${e} | ${stack}`);
                 }
             });
 
@@ -1030,7 +1167,8 @@ class Esphome extends utils.Adapter {
                 );
             }
         } catch (e) {
-            this.log.error(`ESP device error for ${host} | ${e} | ${e.stack}`);
+            const stack = e instanceof Error ? e.stack : undefined;
+            this.log.error(`ESP device error for ${host} | ${e} | ${stack}`);
         }
     }
 
@@ -1412,7 +1550,6 @@ class Esphome extends utils.Adapter {
                         common.write !== this.createdStatesDetails[objName].write))
             ) {
                 // console.log(`An attribute has changed : ${state}`);
-                // @ts-expect-error values are correctly provided by state Attribute definitions, error can be ignored
                 await this.extendObjectAsync(objName, {
                     type: 'state',
                     common,
@@ -1443,7 +1580,7 @@ class Esphome extends utils.Adapter {
      * Handles error messages for log and Sentry
      *
      * @param {string} codepart Function were exception occurred
-     * @param {Error|string} error Error message
+     * @param {unknown} error Caught value, anything can be thrown in JavaScript
      */
     errorHandler(codepart, error) {
         let errorMsg = error;
@@ -1490,6 +1627,17 @@ class Esphome extends utils.Adapter {
         return str.replace(new RegExp(this.escapeRegExp(find), 'g'), replace);
     }
 
+    /**
+     * Extract the argument of a modify method, so "multiply(2.5)" yields "2.5"
+     *
+     * @param {string} method defines the method to be executed (e.g. round())
+     * @returns {string} text between the brackets, empty when the method has no argument
+     */
+    modifyArgument(method) {
+        const inBracket = method.match(/(?<=\()(.*?)(?=\))/);
+        return inBracket ? inBracket[0] : '';
+    }
+
     /**
      * Analysis modify an element in stateAttr.js and execute command
      *
@@ -1505,24 +1653,24 @@ class Esphome extends utils.Adapter {
                 value = eval(method.replace(/^custom:/gi, '')); //get value without "custom:"
             } else if (method.match(/^multiply\(/gi) != null) {
                 //check if starts with "multiply("
-                const inBracket = parseFloat(method.match(/(?<=\()(.*?)(?=\))/g)); //get value in brackets
-                value = value * inBracket;
+                const inBracket = parseFloat(this.modifyArgument(method)); //get value in brackets
+                value = Number(value) * inBracket;
             } else if (method.match(/^divide\(/gi) != null) {
                 //check if starts with "divide("
-                const inBracket = parseFloat(method.match(/(?<=\()(.*?)(?=\))/g)); //get value in brackets
-                value = value / inBracket;
+                const inBracket = parseFloat(this.modifyArgument(method)); //get value in brackets
+                value = Number(value) / inBracket;
             } else if (method.match(/^round\(/gi) != null) {
                 //check if starts with "round("
-                const inBracket = parseInt(method.match(/(?<=\()(.*?)(?=\))/g)); //get value in brackets
-                value = Math.round(value * Math.pow(10, inBracket)) / Math.pow(10, inBracket);
+                const inBracket = parseInt(this.modifyArgument(method)); //get value in brackets
+                value = Math.round(Number(value) * Math.pow(10, inBracket)) / Math.pow(10, inBracket);
             } else if (method.match(/^add\(/gi) != null) {
                 //check if starts with "add("
-                const inBracket = parseFloat(method.match(/(?<=\()(.*?)(?=\))/g)); //get value in brackets
-                value = parseFloat(value) + inBracket;
+                const inBracket = parseFloat(this.modifyArgument(method)); //get value in brackets
+                value = parseFloat(String(value)) + inBracket;
             } else if (method.match(/^substract\(/gi) != null) {
                 //check if starts with "substract("
-                const inBracket = parseFloat(method.match(/(?<=\()(.*?)(?=\))/g)); //get value in brackets
-                value = parseFloat(value) - inBracket;
+                const inBracket = parseFloat(this.modifyArgument(method)); //get value in brackets
+                value = parseFloat(String(value)) - inBracket;
             } else {
                 const methodUC = method.toUpperCase();
                 switch (methodUC) {
@@ -1725,6 +1873,9 @@ class Esphome extends utils.Adapter {
                                 value: dashboardVersions[versions],
                             });
                         }
+                        // The version new installations default to must always be selectable, also
+                        // when the release list could not be retrieved from GitHub
+                        this.ensureVersionInDropDown(dropDownEntry, defaultDashboardVersion);
 
                         this.sendTo(obj.from, obj.command, dropDownEntry, obj.callback);
                     }
@@ -1747,7 +1898,7 @@ class Esphome extends utils.Adapter {
                         } else {
                             // Fallback versions if cache is empty
                             this.log.info('No cached Pillow versions available, using fallback versions');
-                            const fallbackVersions = ['11.3.0', '11.2.0', '11.1.0', '11.0.0', '10.4.0', '10.3.0'];
+                            const fallbackVersions = ['12.2.0', '12.1.1', '12.0.0', '11.3.0', '11.2.0', '11.1.0'];
                             for (const version of fallbackVersions) {
                                 dropDownEntry.push({
                                     label: version,
@@ -1755,6 +1906,9 @@ class Esphome extends utils.Adapter {
                                 });
                             }
                         }
+                        // The version new installations default to must always be selectable, also
+                        // when the release list could not be retrieved from PyPI
+                        this.ensureVersionInDropDown(dropDownEntry, defaultPillowVersion);
 
                         this.sendTo(obj.from, obj.command, dropDownEntry, obj.callback);
                     }
@@ -1988,18 +2142,32 @@ class Esphome extends utils.Adapter {
         }
     }
 
+    /**
+     * Add a version to a dropDown when it is not part of it yet, so a configured version can never
+     * silently disappear from the selection when the release list is unavailable or outdated
+     *
+     * @param {Array<string | {label: string, value: string}>} dropDownEntry - dropDown entries to extend
+     * @param {string} version - version which must be selectable
+     */
+    ensureVersionInDropDown(dropDownEntry, version) {
+        const known = dropDownEntry.some(entry => (typeof entry === 'string' ? entry : entry.value) === version);
+        if (!known) {
+            dropDownEntry.push({ label: version, value: version });
+        }
+    }
+
     /**
      * Fetch Pillow versions from PyPI and cache them
      *
      * @returns {Promise<string[]>} Array of available Pillow versions
      */
     async fetchAndCachePillowVersions() {
-        const fallbackVersions = ['11.3.0', '11.2.0', '11.1.0', '11.0.0', '10.4.0', '10.3.0'];
+        const fallbackVersions = ['12.2.0', '12.1.1', '12.0.0', '11.3.0', '11.2.0', '11.1.0'];
 
         try {
             const response = await fetch('https://pypi.org/pypi/pillow/json');
             if (response.ok) {
-                const data = await response.json();
+                const data = /** @type {{ releases: Record<string, unknown> }} */ (await response.json());
                 const versions = Object.keys(data.releases)
                     .filter(v => !v.includes('a') && !v.includes('b') && !v.includes('rc')) // Filter out alpha/beta/rc versions
                     .sort((a, b) => {
@@ -2037,16 +2205,15 @@ class Esphome extends utils.Adapter {
                 this.log.warn(`Unable to fetch Pillow versions from PyPI: ${response.status}, using cached values`);
             }
         } catch (error) {
-            this.log.warn(
-                `Error fetching Pillow versions from PyPI: ${error.message}, using cached or fallback versions`,
-            );
+            const reason = error instanceof Error && error.message ? error.message : String(error);
+            this.log.warn(`Error fetching Pillow versions from PyPI: ${reason}, using cached or fallback versions`);
         }
 
         // Try to load from cache
         try {
             const cachedPillowVersions = await this.getStateAsync(`_ESPHomeDashboard.pillowVersionCache`);
             if (cachedPillowVersions && cachedPillowVersions.val) {
-                const versions = JSON.parse(cachedPillowVersions.val);
+                const versions = JSON.parse(String(cachedPillowVersions.val));
                 this.log.info(`Loaded ${versions.length} Pillow versions from cache`);
                 return versions;
             }
@@ -2078,7 +2245,8 @@ class Esphome extends utils.Adapter {
                 this.log.info('Autopy cache directory does not exist');
             }
         } catch (error) {
-            this.log.error(`Error clearing autopy cache: ${error.message}`);
+            const reason = error instanceof Error && error.message ? error.message : String(error);
+            this.log.error(`Error clearing autopy cache: ${reason}`);
             throw error;
         }
     }
@@ -2256,7 +2424,7 @@ class Esphome extends utils.Adapter {
                         device[5] === `warmWhite`
                     ) {
                         // Convert value to 255 range
-                        writeValue = writeValue / 100 / 2.55;
+                        writeValue = Number(writeValue) / 100 / 2.55;
 
                         // Store value to memory
                         clientDetails[deviceIP][device[4]].states[device[5]] = writeValue;
@@ -2309,7 +2477,7 @@ class Esphome extends utils.Adapter {
                     // Auto white channel: when colorHEX is set to white (#ffffff) on RGBW lights,
                     // automatically switch to white channel; otherwise switch to RGB mode
                     if (clientDetails[deviceIP][device[4]].rgbAutoWhite && supportsWhite && device[5] === 'colorHEX') {
-                        if (writeValue.replace(/^#/, '').toLowerCase() === 'ffffff') {
+                        if (String(writeValue).replace(/^#/, '').toLowerCase() === 'ffffff') {
                             // White color detected: redirect to dedicated white channel
                             clientDetails[deviceIP][device[4]].states.red = 0;
                             clientDetails[deviceIP][device[4]].states.green = 0;
@@ -2438,7 +2606,6 @@ class Esphome extends utils.Adapter {
             const _channels = await this.getObjectViewAsync('system', 'channel', params);
             // List all found channels & compare with memory, delete unneeded channels
             for (const currDevice in _channels.rows) {
-                // @ts-expect-error _channels.rows is an array but treated as object here
                 if (
                     !clientDetails[ip].adapterObjects.channels.includes(_channels.rows[currDevice].id) &&
                     _channels.rows[currDevice].id.split('.')[2] === clientDetails[ip].deviceName

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.esphome",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0",
   "description": "Control your ESP8266/ESP32 with simple yet powerful configuration files created and managed by ESPHome",
   "author": {
     "name": "DutchmanNL",
@@ -24,27 +24,27 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/DrozmotiX/ioBroker.esphome"
+    "url": "git+https://github.com/DrozmotiX/ioBroker.esphome.git"
   },
   "engines": {
     "node": ">= 22"
   },
   "dependencies": {
     "@2colors/esphome-native-api": "^1.3.6",
-    "@iobroker/adapter-core": "^3.4.1",
+    "@iobroker/adapter-core": "^3.4.3",
     "autopy": "github:SimonFischer04/autopy#fbe016f35e13e335e1c44783a1e7273bbb2a08c1",
-    "ws": "^8.21.1"
+    "ws": "^8.21.3"
   },
   "devDependencies": {
     "@alcalzone/release-script": "^5.2.1",
     "@alcalzone/release-script-plugin-iobroker": "^5.2.0",
-    "@alcalzone/release-script-plugin-license": "^5.2.0",
+    "@alcalzone/release-script-plugin-license": "^5.2.2",
     "@alcalzone/release-script-plugin-manual-review": "^5.2.0",
     "@iobroker/adapter-dev": "^1.5.0",
     "@iobroker/dev-server": "^0.8.0",
     "@iobroker/eslint-config": "^2.3.4",
-    "@iobroker/testing": "^5.3.0",
-    "@tsconfig/node22": "^22.0.5",
+    "@iobroker/testing": "^6.2.2",
+    "@tsconfig/node22": "^22.0.6",
     "@types/node": "^22.0.5",
     "promisify": "~0.0.3",
     "typescript": "~5.9.3"
@@ -69,8 +69,8 @@
     "check": "tsc --noEmit -p tsconfig.check.json",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "format": "prettier . --write",
-    "format:check": "prettier . --check",
+    "format": "prettier . --write --ignore-path .gitignore --ignore-path prettier.ignore",
+    "format:check": "prettier . --check --ignore-path .gitignore --ignore-path prettier.ignore",
     "release": "release-script --all --branchPattern '*'",
     "release-dry": "release-script --all --dry"
   },