iobroker.homewizard 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 krobi <krobi@power-dreams.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,190 @@
+# ioBroker.homewizard
+
+[![npm version](https://img.shields.io/npm/v/iobroker.homewizard)](https://www.npmjs.com/package/iobroker.homewizard)
+![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)
+![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![npm downloads](https://img.shields.io/npm/dt/iobroker.homewizard)](https://www.npmjs.com/package/iobroker.homewizard)
+![Installations](https://iobroker.live/badges/homewizard-installed.svg)
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-ff5e5b?logo=ko-fi)](https://ko-fi.com/krobipd)
+[![PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://paypal.me/krobipd)
+
+<img src="https://raw.githubusercontent.com/krobipd/ioBroker.homewizard/main/admin/homewizard.svg" width="100" />
+
+Real-time energy monitoring from HomeWizard devices via API v2 with WebSocket push (~1 update/second).
+
+---
+
+## Features
+
+- **WebSocket push** for real-time energy data (~1 update per second)
+- **Automatic device discovery** via mDNS (zero configuration)
+- **Hue-style pairing** — press the button on the device to connect
+- **Multi-device support** — manage all HomeWizard devices in one adapter instance
+- **Battery control** — manage HomeWizard Plug-In Batteries (mode, permissions)
+- **System control** — LED brightness, cloud toggle, reboot, identify
+- **REST fallback** — automatic polling when WebSocket is unavailable
+
+---
+
+## Requirements
+
+- **Node.js >= 20**
+- **ioBroker js-controller >= 7.0.0**
+- **ioBroker Admin >= 7.6.20**
+- **HomeWizard device with API v2 support** (firmware 4.x+ with local API enabled)
+
+---
+
+## Supported Devices
+
+| Device | Product Type | WebSocket | Battery Control |
+|--------|-------------|-----------|-----------------|
+| P1 Meter | HWE-P1 | Yes | Yes (as controller) |
+| kWh Meter 1-Phase | HWE-KWH1 / SDM230 | Yes | Yes (as controller) |
+| kWh Meter 3-Phase | HWE-KWH3 / SDM630 | Yes | Yes (as controller) |
+| Plug-In Battery | HWE-BAT | Yes | Controlled via P1/kWh |
+
+> **Note:** Energy Socket (HWE-SKT) and Watermeter (HWE-WTR) only support API v1 and are not yet supported. Support will be added when HomeWizard releases API v2 for these devices.
+
+---
+
+## Configuration
+
+Devices are added via the **pairing mode**, not manually:
+
+1. Open the **Objects** tab in ioBroker Admin
+2. Set `homewizard.0.startPairing` to `true`
+3. **Press the physical button** on your HomeWizard device within 60 seconds
+4. The device is discovered automatically and appears in the adapter settings
+
+The Admin UI shows all paired devices. You can update the IP address if a device gets a new one.
+
+---
+
+## State Tree
+
+```
+homewizard.0.
+├── info.connection              — Overall connection status (bool)
+├── startPairing                 — Activate pairing mode (button)
+└── {productType}_{serial}/      — e.g. hwe-p1_5c2fafaabbcc
+    ├── info/
+    │   ├── productName          — Device name (string)
+    │   ├── productType          — Product type (string)
+    │   ├── firmware             — Firmware version (string)
+    │   ├── connected            — WebSocket connection status (bool)
+    │   ├── wifi_rssi_db         — WiFi signal strength (number, dB)
+    │   └── uptime_s             — Device uptime (number, s)
+    ├── power_w                  — Total power (number, W)
+    ├─�� power_l1_w .. l3_w       — Power per phase (number, W)
+    ├── voltage_l1_v .. l3_v     — Voltage per phase (number, V)
+    ├── current_l1_a .. l3_a     — Current per phase (number, A)
+    ├── frequency_hz             — Grid frequency (number, Hz)
+    ├── energy_import_kwh        — Total import (number, kWh)
+    ├── energy_import_t1..t4_kwh — Import per tariff (number, kWh)
+    ├── energy_export_kwh        — Total export (number, kWh)
+    ├── energy_export_t1..t4_kwh — Export per tariff (number, kWh)
+    ├── tariff                   — Active tariff (number)
+    ├── quality/                 — Power quality counters
+    │   ├── voltage_sag_l1..l3_count
+    │   ├── voltage_swell_l1..l3_count
+    │   ├── power_fail_count
+    │   └── long_power_fail_count
+    ├── external/                — External meters (gas, water, heat)
+    │   └── {type}_{id}/
+    │       ├── value            — Meter reading (number)
+    │       ���── unit             — Unit (string)
+    │       └── timestamp        — Last update (string)
+    ├── battery/                 — Battery control (if batteries connected)
+    │   ├── mode                 — zero / to_full / standby (string, R/W)
+    │   ├── permissions          — JSON array (string, R/W)
+    │   ├── battery_count        — Connected batteries (number)
+    │   ├── power_w              — Battery power (number, W)
+    │   ├── target_power_w       — Target power (number, W)
+    │   ├── max_consumption_w    — Max consumption (number, W)
+    │   └── max_production_w     — Max production (number, W)
+    └── system/                  — System settings
+        ├── cloud_enabled        — Cloud communication (bool, R/W)
+        ├── status_led_brightness_pct — LED brightness 0-100 (number, R/W)
+        ├── api_v1_enabled       — Legacy API v1 (bool, R/W)
+        ├── reboot               — Reboot device (button)
+        └── identify             — Blink LED (button)
+```
+
+> States are created dynamically based on what the device reports. Not all devices have all states.
+
+---
+
+## Troubleshooting
+
+### Device not found during pairing
+- Make sure the device is on the same network/VLAN as the ioBroker server
+- Verify that **local API** is enabled in the HomeWizard app (Settings > Meters > your device > Local API)
+- Check that multicast/mDNS traffic is not blocked by your router/firewall
+
+### WebSocket keeps disconnecting
+- Check WiFi signal strength (`info.wifi_rssi_db`) — consider moving the device closer to the router
+- The adapter automatically reconnects with exponential backoff and falls back to REST polling
+
+### Token invalid after factory reset
+- Remove the device from the adapter settings and pair again
+
+---
+
+## Changelog
+
+### 0.1.0 (2026-04-04)
+- Initial release
+- HomeWizard API v2 with Bearer Token authentication
+- WebSocket push for real-time energy data
+- mDNS device discovery
+- Hue-style multi-device pairing
+- Battery control and system settings
+- REST fallback when WebSocket unavailable
+
+Older changelog: [CHANGELOG.md](CHANGELOG.md)
+
+---
+
+## Support
+
+- [ioBroker Forum](https://forum.iobroker.net/)
+- [GitHub Issues](https://github.com/krobipd/ioBroker.homewizard/issues)
+
+### Support Development
+
+This adapter is free and open source. If you find it useful, consider buying me a coffee:
+
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support-ff5e5b?style=for-the-badge&logo=ko-fi)](https://ko-fi.com/krobipd)
+[![PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=for-the-badge)](https://paypal.me/krobipd)
+
+---
+
+## License
+
+MIT License
+
+Copyright (c) 2026 krobi <krobi@power-dreams.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+*Developed with assistance from Claude.ai*

package/admin/homewizard.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100">
+  <circle cx="50" cy="50" r="48" fill="#00B4D8" stroke="#0077B6" stroke-width="2"/>
+  <path d="M30 65 L50 25 L70 65" fill="none" stroke="#FFFFFF" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
+  <line x1="38" y1="50" x2="62" y2="50" stroke="#FFFFFF" stroke-width="6" stroke-linecap="round"/>
+  <line x1="50" y1="65" x2="50" y2="80" stroke="#FFFFFF" stroke-width="6" stroke-linecap="round"/>
+</svg>

package/admin/i18n/de/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Gekoppelte Geräte",
+  "devicesInfo": "Geräte werden automatisch über den Pairing-Modus hinzugefügt. Verwende den Datenpunkt 'startPairing' im Objekte-Tab, um ein neues Gerät zu koppeln. Die IP-Adresse kann hier aktualisiert werden, falls sich diese ändert.",
+  "labelDevices": "Geräte",
+  "colProductName": "Name",
+  "colProductType": "Typ",
+  "colSerial": "Seriennummer",
+  "colIP": "IP-Adresse",
+  "colToken": "Token",
+  "headerPairing": "Kopplung",
+  "pairingInfo": "Um ein neues Gerät hinzuzufügen: Setze den Datenpunkt 'startPairing' auf true und drücke dann innerhalb von 60 Sekunden den physischen Knopf am HomeWizard-Gerät. Das Gerät wird automatisch erkannt und zur Liste hinzugefügt.",
+  "supportHeader": "Unterstützung",
+  "aboutInfo": "Dieser Adapter ist kostenlos und Open Source. Wenn er dir nützlich ist, erwäge die Entwicklung zu unterstützen:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/en/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Paired Devices",
+  "devicesInfo": "Devices are added automatically via the pairing mode. Use the 'startPairing' data point in the Objects tab to pair a new device. You can update the IP address here if a device gets a new one.",
+  "labelDevices": "Devices",
+  "colProductName": "Name",
+  "colProductType": "Type",
+  "colSerial": "Serial",
+  "colIP": "IP Address",
+  "colToken": "Token",
+  "headerPairing": "Pairing",
+  "pairingInfo": "To add a new device: Set the 'startPairing' data point to true, then press the physical button on your HomeWizard device within 60 seconds. The device will be discovered automatically and added to the list above.",
+  "supportHeader": "Support",
+  "aboutInfo": "This adapter is free and open source. If you find it useful, consider supporting the development:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/es/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Dispositivos emparejados",
+  "devicesInfo": "Los dispositivos se añaden automáticamente a través del modo de emparejamiento. Usa el punto de datos 'startPairing' en la pestaña Objetos para emparejar un nuevo dispositivo. La dirección IP se puede actualizar aquí si cambia.",
+  "labelDevices": "Dispositivos",
+  "colProductName": "Nombre",
+  "colProductType": "Tipo",
+  "colSerial": "Número de serie",
+  "colIP": "Dirección IP",
+  "colToken": "Token",
+  "headerPairing": "Emparejamiento",
+  "pairingInfo": "Para añadir un dispositivo: establece el punto de datos 'startPairing' en true y luego presiona el botón físico en tu dispositivo HomeWizard dentro de 60 segundos. El dispositivo se descubrirá automáticamente.",
+  "supportHeader": "Apoyo",
+  "aboutInfo": "Este adaptador es gratuito y de código abierto. Si te resulta útil, considera apoyar el desarrollo:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/fr/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Appareils appairés",
+  "devicesInfo": "Les appareils sont ajoutés automatiquement via le mode d'appairage. Utilisez le point de données 'startPairing' dans l'onglet Objets pour appairer un nouvel appareil. L'adresse IP peut être mise à jour ici si elle change.",
+  "labelDevices": "Appareils",
+  "colProductName": "Nom",
+  "colProductType": "Type",
+  "colSerial": "Numéro de série",
+  "colIP": "Adresse IP",
+  "colToken": "Jeton",
+  "headerPairing": "Appairage",
+  "pairingInfo": "Pour ajouter un appareil : définissez le point de données 'startPairing' sur true, puis appuyez sur le bouton physique de votre appareil HomeWizard dans les 60 secondes. L'appareil sera découvert automatiquement.",
+  "supportHeader": "Soutien",
+  "aboutInfo": "Cet adaptateur est gratuit et open source. Si vous le trouvez utile, envisagez de soutenir le développement :",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/it/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Dispositivi associati",
+  "devicesInfo": "I dispositivi vengono aggiunti automaticamente tramite la modalità di associazione. Usa il punto dati 'startPairing' nella scheda Oggetti per associare un nuovo dispositivo. L'indirizzo IP può essere aggiornato qui se cambia.",
+  "labelDevices": "Dispositivi",
+  "colProductName": "Nome",
+  "colProductType": "Tipo",
+  "colSerial": "Numero di serie",
+  "colIP": "Indirizzo IP",
+  "colToken": "Token",
+  "headerPairing": "Associazione",
+  "pairingInfo": "Per aggiungere un dispositivo: imposta il punto dati 'startPairing' su true, poi premi il pulsante fisico sul dispositivo HomeWizard entro 60 secondi. Il dispositivo verrà scoperto automaticamente.",
+  "supportHeader": "Supporto",
+  "aboutInfo": "Questo adattatore è gratuito e open source. Se lo trovi utile, considera di supportare lo sviluppo:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/nl/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Gekoppelde apparaten",
+  "devicesInfo": "Apparaten worden automatisch toegevoegd via de koppelmodus. Gebruik het datapunt 'startPairing' in het tabblad Objecten om een nieuw apparaat te koppelen. Het IP-adres kan hier worden bijgewerkt als dit verandert.",
+  "labelDevices": "Apparaten",
+  "colProductName": "Naam",
+  "colProductType": "Type",
+  "colSerial": "Serienummer",
+  "colIP": "IP-adres",
+  "colToken": "Token",
+  "headerPairing": "Koppelen",
+  "pairingInfo": "Om een apparaat toe te voegen: zet het datapunt 'startPairing' op true en druk vervolgens binnen 60 seconden op de fysieke knop op je HomeWizard-apparaat. Het apparaat wordt automatisch gevonden en toegevoegd.",
+  "supportHeader": "Ondersteuning",
+  "aboutInfo": "Deze adapter is gratis en open source. Als je het nuttig vindt, overweeg dan de ontwikkeling te steunen:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/pl/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Sparowane urządzenia",
+  "devicesInfo": "Urządzenia są dodawane automatycznie przez tryb parowania. Użyj punktu danych 'startPairing' w zakładce Obiekty, aby sparować nowe urządzenie. Adres IP można zaktualizować tutaj, jeśli się zmieni.",
+  "labelDevices": "Urządzenia",
+  "colProductName": "Nazwa",
+  "colProductType": "Typ",
+  "colSerial": "Numer seryjny",
+  "colIP": "Adres IP",
+  "colToken": "Token",
+  "headerPairing": "Parowanie",
+  "pairingInfo": "Aby dodać urządzenie: ustaw punkt danych 'startPairing' na true, a następnie naciśnij fizyczny przycisk na urządzeniu HomeWizard w ciągu 60 sekund. Urządzenie zostanie wykryte automatycznie.",
+  "supportHeader": "Wsparcie",
+  "aboutInfo": "Ten adapter jest darmowy i otwartoźródłowy. Jeśli uważasz go za przydatny, rozważ wsparcie rozwoju:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/pt/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Dispositivos emparelhados",
+  "devicesInfo": "Os dispositivos são adicionados automaticamente através do modo de emparelhamento. Use o ponto de dados 'startPairing' na aba Objetos para emparelhar um novo dispositivo. O endereço IP pode ser atualizado aqui se mudar.",
+  "labelDevices": "Dispositivos",
+  "colProductName": "Nome",
+  "colProductType": "Tipo",
+  "colSerial": "Número de série",
+  "colIP": "Endereço IP",
+  "colToken": "Token",
+  "headerPairing": "Emparelhamento",
+  "pairingInfo": "Para adicionar um dispositivo: defina o ponto de dados 'startPairing' como true e pressione o botão físico no dispositivo HomeWizard dentro de 60 segundos. O dispositivo será descoberto automaticamente.",
+  "supportHeader": "Apoio",
+  "aboutInfo": "Este adaptador é gratuito e de código aberto. Se você achar útil, considere apoiar o desenvolvimento:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/ru/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Сопряженные устройства",
+  "devicesInfo": "Устройства добавляются автоматически через режим сопряжения. Используйте точку данных 'startPairing' на вкладке объектов для добавления нового устройства. IP-адрес можно обновить здесь, если он изменился.",
+  "labelDevices": "Устройства",
+  "colProductName": "Имя",
+  "colProductType": "Тип",
+  "colSerial": "Серийный номер",
+  "colIP": "IP-адрес",
+  "colToken": "Токен",
+  "headerPairing": "Сопряжение",
+  "pairingInfo": "Чтобы добавить устройство: установите точку данных 'startPairing' в true, затем нажмите физическую кнопку на устройстве HomeWizard в течение 60 секунд. Устройство будет обнаружено автоматически.",
+  "supportHeader": "Поддержка",
+  "aboutInfo": "Этот адаптер бесплатный и с открытым исходным кодом. Если он вам полезен, рассмотрите поддержку разработки:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/uk/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "Сполучені пристрої",
+  "devicesInfo": "Пристрої додаються автоматично через режим сполучення. Використовуйте точку даних 'startPairing' на вкладці Об'єкти для сполучення нового пристрою. IP-адресу можна оновити тут, якщо вона змінилася.",
+  "labelDevices": "Пристрої",
+  "colProductName": "Назва",
+  "colProductType": "Тип",
+  "colSerial": "Серійний номер",
+  "colIP": "IP-адреса",
+  "colToken": "Токен",
+  "headerPairing": "Сполучення",
+  "pairingInfo": "Щоб додати пристрій: встановіть точку даних 'startPairing' на true, потім натисніть фізичну кнопку на пристрої HomeWizard протягом 60 секунд. Пристрій буде виявлено автоматично.",
+  "supportHeader": "Підтримка",
+  "aboutInfo": "Цей адаптер безкоштовний і з відкритим кодом. Якщо він вам корисний, розгляньте підтримку розробки:",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/i18n/zh-cn/translations.json

@@ -0,0 +1,16 @@
+{
+  "headerDevices": "已配对设备",
+  "devicesInfo": "设备通过配对模式自动添加。使用对象选项卡中的 'startPairing' 数据点来配对新设备。如果设备的 IP 地址发生变化，可以在此处更新。",
+  "labelDevices": "设备",
+  "colProductName": "名称",
+  "colProductType": "类型",
+  "colSerial": "序列号",
+  "colIP": "IP 地址",
+  "colToken": "令牌",
+  "headerPairing": "配对",
+  "pairingInfo": "要添加新设备：将 'startPairing' 数据点设置为 true，然后在 60 秒内按下 HomeWizard 设备上的物理按钮。设备将被自动发现并添加到上面的列表中。",
+  "supportHeader": "支持",
+  "aboutInfo": "此适配器免费且开源。如果您觉得有用，请考虑支持开发：",
+  "donateKofi": "Ko-fi",
+  "donatePaypal": "PayPal"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,99 @@
+{
+  "i18n": true,
+  "type": "panel",
+  "items": {
+    "_headerDevices": {
+      "type": "header",
+      "text": "headerDevices",
+      "size": 3
+    },
+    "_devicesInfo": {
+      "type": "staticText",
+      "text": "devicesInfo",
+      "style": { "fontSize": 14, "marginBottom": 16 }
+    },
+    "devices": {
+      "type": "table",
+      "label": "labelDevices",
+      "sm": 12,
+      "items": [
+        {
+          "type": "text",
+          "attr": "productName",
+          "title": "colProductName",
+          "width": "20%",
+          "readOnly": true
+        },
+        {
+          "type": "text",
+          "attr": "productType",
+          "title": "colProductType",
+          "width": "15%",
+          "readOnly": true
+        },
+        {
+          "type": "text",
+          "attr": "serial",
+          "title": "colSerial",
+          "width": "20%",
+          "readOnly": true
+        },
+        {
+          "type": "text",
+          "attr": "ip",
+          "title": "colIP",
+          "width": "20%"
+        },
+        {
+          "type": "text",
+          "attr": "token",
+          "title": "colToken",
+          "width": "25%",
+          "readOnly": true
+        }
+      ],
+      "noDelete": false
+    },
+    "_headerPairing": {
+      "newLine": true,
+      "type": "header",
+      "text": "headerPairing",
+      "size": 4
+    },
+    "_pairingInfo": {
+      "type": "staticText",
+      "text": "pairingInfo",
+      "style": { "fontSize": 14, "marginBottom": 16 }
+    },
+    "_supportHeader": {
+      "newLine": true,
+      "type": "header",
+      "text": "supportHeader",
+      "size": 5
+    },
+    "_aboutInfo": {
+      "type": "staticText",
+      "text": "aboutInfo",
+      "xs": 12, "sm": 12, "md": 12, "lg": 12, "xl": 12,
+      "style": { "fontSize": 14, "marginBottom": 16 }
+    },
+    "_kofiLink": {
+      "type": "staticLink",
+      "href": "https://ko-fi.com/krobipd",
+      "label": "donateKofi",
+      "button": true,
+      "variant": "outlined",
+      "color": "primary",
+      "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
+    },
+    "_paypalLink": {
+      "type": "staticLink",
+      "href": "https://paypal.me/krobipd",
+      "label": "donatePaypal",
+      "button": true,
+      "variant": "outlined",
+      "color": "primary",
+      "xs": 12, "sm": 6, "md": 4, "lg": 4, "xl": 4
+    }
+  }
+}

package/build/lib/discovery.js

@@ -0,0 +1,103 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var discovery_exports = {};
+__export(discovery_exports, {
+  HomeWizardDiscovery: () => HomeWizardDiscovery
+});
+module.exports = __toCommonJS(discovery_exports);
+var import_bonjour_service = __toESM(require("bonjour-service"));
+class HomeWizardDiscovery {
+  bonjour = null;
+  browser = null;
+  log;
+  /**
+   * @param log Logger interface
+   * @param log.debug Debug log function
+   * @param log.warn Warning log function
+   */
+  constructor(log) {
+    this.log = log;
+  }
+  /**
+   * Start scanning for HomeWizard devices
+   *
+   * @param callback Called for each discovered device
+   */
+  start(callback) {
+    this.stop();
+    this.bonjour = new import_bonjour_service.default();
+    this.log.debug("mDNS: browsing for _hwenergy._tcp");
+    this.browser = this.bonjour.find(
+      { type: "hwenergy", protocol: "tcp" },
+      (service) => {
+        const device = this.parseService(service);
+        if (device) {
+          this.log.debug(
+            `mDNS: found ${device.name} (${device.productType}) at ${device.ip}`
+          );
+          callback(device);
+        }
+      }
+    );
+  }
+  /** Stop scanning */
+  stop() {
+    if (this.browser) {
+      this.browser.stop();
+      this.browser = null;
+    }
+    if (this.bonjour) {
+      this.bonjour.destroy();
+      this.bonjour = null;
+    }
+  }
+  /**
+   * Parse a Bonjour service into a DiscoveredDevice
+   *
+   * @param service Bonjour service record
+   */
+  parseService(service) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const ip = (_a = service.addresses) == null ? void 0 : _a.find((addr) => addr.includes("."));
+    if (!ip) {
+      this.log.debug(`mDNS: no IPv4 address for ${service.name}`);
+      return null;
+    }
+    const txt = service.txt;
+    const productType = (_c = (_b = txt == null ? void 0 : txt.product_type) != null ? _b : txt == null ? void 0 : txt.type) != null ? _c : "unknown";
+    const serial = (_e = (_d = txt == null ? void 0 : txt.serial) != null ? _d : service.name) != null ? _e : "unknown";
+    const name = (_g = (_f = txt == null ? void 0 : txt.product_name) != null ? _f : service.name) != null ? _g : productType;
+    return { ip, productType, serial, name };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HomeWizardDiscovery
+});
+//# sourceMappingURL=discovery.js.map

package/build/lib/discovery.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/discovery.ts"],
+  "sourcesContent": ["import Bonjour, { type Service } from \"bonjour-service\";\nimport type { DiscoveredDevice } from \"./types\";\n\n/** Callback for discovered devices */\nexport type DiscoveryCallback = (device: DiscoveredDevice) => void;\n\n/**\n * mDNS discovery for HomeWizard Energy devices.\n * Browses for `_hwenergy._tcp` services on the local network.\n */\nexport class HomeWizardDiscovery {\n  private bonjour: Bonjour | null = null;\n  private browser: ReturnType<Bonjour[\"find\"]> | null = null;\n  private readonly log: {\n    debug: (msg: string) => void;\n    warn: (msg: string) => void;\n  };\n\n  /**\n   * @param log Logger interface\n   * @param log.debug Debug log function\n   * @param log.warn Warning log function\n   */\n  constructor(log: {\n    debug: (msg: string) => void;\n    warn: (msg: string) => void;\n  }) {\n    this.log = log;\n  }\n\n  /**\n   * Start scanning for HomeWizard devices\n   *\n   * @param callback Called for each discovered device\n   */\n  start(callback: DiscoveryCallback): void {\n    this.stop();\n\n    this.bonjour = new Bonjour();\n    this.log.debug(\"mDNS: browsing for _hwenergy._tcp\");\n\n    this.browser = this.bonjour.find(\n      { type: \"hwenergy\", protocol: \"tcp\" },\n      (service: Service) => {\n        const device = this.parseService(service);\n        if (device) {\n          this.log.debug(\n            `mDNS: found ${device.name} (${device.productType}) at ${device.ip}`,\n          );\n          callback(device);\n        }\n      },\n    );\n  }\n\n  /** Stop scanning */\n  stop(): void {\n    if (this.browser) {\n      this.browser.stop();\n      this.browser = null;\n    }\n    if (this.bonjour) {\n      this.bonjour.destroy();\n      this.bonjour = null;\n    }\n  }\n\n  /**\n   * Parse a Bonjour service into a DiscoveredDevice\n   *\n   * @param service Bonjour service record\n   */\n  private parseService(service: Service): DiscoveredDevice | null {\n    // IPv4 address\n    const ip = service.addresses?.find((addr) => addr.includes(\".\"));\n    if (!ip) {\n      this.log.debug(`mDNS: no IPv4 address for ${service.name}`);\n      return null;\n    }\n\n    // TXT records contain product_type, serial, etc.\n    const txt = service.txt as Record<string, string> | undefined;\n    const productType = txt?.product_type ?? txt?.type ?? \"unknown\";\n    const serial = txt?.serial ?? service.name ?? \"unknown\";\n    const name = txt?.product_name ?? service.name ?? productType;\n\n    return { ip, productType, serial, name };\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,6BAAsC;AAU/B,MAAM,oBAAoB;AAAA,EACvB,UAA0B;AAAA,EAC1B,UAA8C;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUjB,YAAY,KAGT;AACD,SAAK,MAAM;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAmC;AACvC,SAAK,KAAK;AAEV,SAAK,UAAU,IAAI,uBAAAA,QAAQ;AAC3B,SAAK,IAAI,MAAM,mCAAmC;AAElD,SAAK,UAAU,KAAK,QAAQ;AAAA,MAC1B,EAAE,MAAM,YAAY,UAAU,MAAM;AAAA,MACpC,CAAC,YAAqB;AACpB,cAAM,SAAS,KAAK,aAAa,OAAO;AACxC,YAAI,QAAQ;AACV,eAAK,IAAI;AAAA,YACP,eAAe,OAAO,IAAI,KAAK,OAAO,WAAW,QAAQ,OAAO,EAAE;AAAA,UACpE;AACA,mBAAS,MAAM;AAAA,QACjB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,OAAa;AACX,QAAI,KAAK,SAAS;AAChB,WAAK,QAAQ,KAAK;AAClB,WAAK,UAAU;AAAA,IACjB;AACA,QAAI,KAAK,SAAS;AAChB,WAAK,QAAQ,QAAQ;AACrB,WAAK,UAAU;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,aAAa,SAA2C;AAxElE;AA0EI,UAAM,MAAK,aAAQ,cAAR,mBAAmB,KAAK,CAAC,SAAS,KAAK,SAAS,GAAG;AAC9D,QAAI,CAAC,IAAI;AACP,WAAK,IAAI,MAAM,6BAA6B,QAAQ,IAAI,EAAE;AAC1D,aAAO;AAAA,IACT;AAGA,UAAM,MAAM,QAAQ;AACpB,UAAM,eAAc,sCAAK,iBAAL,YAAqB,2BAAK,SAA1B,YAAkC;AACtD,UAAM,UAAS,sCAAK,WAAL,YAAe,QAAQ,SAAvB,YAA+B;AAC9C,UAAM,QAAO,sCAAK,iBAAL,YAAqB,QAAQ,SAA7B,YAAqC;AAElD,WAAO,EAAE,IAAI,aAAa,QAAQ,KAAK;AAAA,EACzC;AACF;",
+  "names": ["Bonjour"]
+}