iobroker.mqtt-plus 1.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 proxy
+
+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,124 @@
+<p align="center">
+  <img src="admin/mqtt-plus.png" alt="MQTT Plus Logo" width="96">
+</p>
+
+<h1 align="center">ioBroker.mqtt-plus</h1>
+
+<p align="center">
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-MIT-blue"></a>
+  <img alt="Version" src="https://img.shields.io/badge/Version-1.6.1-informational">
+  <img alt="js-controller" src="https://img.shields.io/badge/js--controller-%3E%3D6.0.11-informational">
+  <img alt="Node" src="https://img.shields.io/badge/Node.js-%3E%3D18-informational">
+  <img alt="Tests" src="https://img.shields.io/badge/Tests-not%20implemented-yellow">
+</p>
+
+**mqtt-plus** ist ein Adapter für [ioBroker](https://www.iobroker.net/), der ioBroker-Datenpunkte
+mit dem Namespace eines bereits installierten MQTT-Client-Adapters (z. B. `mqtt.0`) spiegelt.
+Er legt die nötige Ordnerstruktur automatisch an, konvertiert Werte live, bietet ein
+abgesichertes Web-Dashboard für Backup/Restore und kann Daten zusätzlich per HTTP(S) an einen
+externen Webhook senden.
+
+`mqtt-plus` spricht selbst kein MQTT-Protokoll — Verbindung, QoS und `retain` zum eigentlichen
+Broker liegen vollständig beim separat installierten MQTT-Adapter, auf dessen Namespace
+`mqtt-plus` nur liest/schreibt.
+
+## Funktionsumfang
+
+* **Bidirektionale Spiegelung** — `out` (IOB → MQTT), `in` (MQTT → IOB) oder `both`.
+* **Topic-Modus pro Mapping** — `single` (ein gemeinsames Topic) oder `dual` nach üblicher
+  MQTT-Konvention (Status auf `<topic>`, Befehle auf `<topic>/set`).
+* **Typ-Konvertierung** — Runden, Bool ↔ Zahl oder automatische Erkennung des Zieltyps, in
+  beide Richtungen.
+* **Unverfälschte Zeitstempel** — der Spiegel übernimmt `ts`/`lc`/`q` der Quelle statt bei
+  jedem Kopiervorgang ein neues "jetzt" zu setzen. Inaktive Quellen (Alter oder Qualität)
+  werden erkannt und nicht künstlich frisch gehalten; drei Sync-Modi pro Mapping erlauben
+  Ausnahmen für selten meldende Sensoren oder bewusst immer frische Ziele.
+* **Force-Sync** — vergleicht Quelle und Ziel direkt und heilt nur echte Abweichungen, z. B.
+  nach einem Neustart oder Verbindungsabbruch.
+* **Ack-Filter pro Mapping** — für Datenpunkte ohne echtes Gerät dahinter
+  (`0_userdata.0.*`, `alias.0.*`).
+* **Abgesichertes Web-Dashboard** — Basic-Auth mit Brute-Force-Sperre, optional HTTPS,
+  CSRF-/CORS-Schutz. Live-Status, JSON-Struktur-Vorschau, Backup & Restore.
+* **Remote Sync** — sendet die Daten zyklisch oder manuell per HTTP(S) POST an einen externen
+  Webhook, Payload frei per Template konfigurierbar, TLS-Prüfung immer aktiv (optionale eigene
+  CA für interne/selbstsignierte Ziele).
+* **Admin 7 Ready** — modernes `jsonConfig` mit responsiven Elementen.
+
+Die vollständige Konfigurationsanleitung inklusive aller Details zu Topic-Modus, Echo-Schutz,
+Sync-Modus und Remote-Sync-Templates steht in **[admin/readme.md](admin/readme.md)** — das ist
+derselbe Text, den ioBroker Admin auch in der Instanz-Ansicht anzeigt.
+
+## Status der Aufnahme ins offizielle ioBroker-Repository
+
+`mqtt-plus` ist derzeit **nicht** Teil des offiziellen ioBroker-`latest`-Repositories und noch
+nicht auf npm veröffentlicht — Installation läuft bis dahin ausschließlich direkt aus diesem
+Git-Repository (siehe [Installation](#installation)). Der offizielle
+[ioBroker Adapter-Checker](https://adapter-check.iobroker.in/) läuft bereits fehlerfrei bis auf
+die Prüfungen, die zwingend eine vorherige npm-Veröffentlichung voraussetzen. Bis zur Aufnahme
+fehlen noch:
+
+1. `npm publish` — Veröffentlichung auf dem npm-Registry.
+2. Ein Pull Request gegen [ioBroker/ioBroker.repositories](https://github.com/ioBroker/ioBroker.repositories),
+   der den Adapter in die `latest`-Liste einträgt.
+
+## Installation
+
+Installation direkt aus diesem Repository:
+
+**Über die Admin-Oberfläche:**
+Instanzen → "+" → Reiter *Benutzerdefiniert* → GitHub-URL eintragen:
+
+```
+https://github.com/Proxyyy87/ioBroker.mqtt-plus/
+```
+
+**Über die Kommandozeile:**
+
+```bash
+iobroker url https://github.com/Proxyyy87/ioBroker.mqtt-plus/tarball/main mqtt-plus
+```
+
+Beim Installieren aus dem Git-Repository wird TypeScript automatisch kompiliert
+(`npm`-`prepare`-Skript) — ein manueller Build-Schritt ist nicht nötig.
+
+Vorausgesetzt wird ein bereits eingerichteter MQTT-Client-Adapter (z. B.
+[ioBroker.mqtt](https://github.com/ioBroker/ioBroker.mqtt)), dessen Namespace `mqtt-plus` als
+Ziel-Präfix verwendet.
+
+## Entwicklung
+
+```bash
+git clone https://github.com/Proxyyy87/ioBroker.mqtt-plus.git
+cd ioBroker.mqtt-plus
+npm install
+npm run build   # kompiliert src/*.ts nach build/
+npm run watch   # kompiliert bei Änderungen automatisch neu
+```
+
+**Wichtig für Pull Requests:** Der Ordner `build/` wird bewusst mitversioniert (nicht per
+`.gitignore` ausgeschlossen), weil der offizielle ioBroker Adapter-Checker die Datei `main`
+(`build/main.js`) direkt aus dem Repository lädt, ohne vorher `npm install`/`prepare`
+auszuführen. Nach jeder Änderung an `src/*.ts` also `npm run build` laufen lassen und den
+aktualisierten `build/`-Ordner mit committen.
+
+Technisch basiert der Adapter auf TypeScript, `@iobroker/adapter-core` und `axios`; das
+Web-Dashboard und der HTTP(S)-Server sind mit Bordmitteln von Node.js (`http`/`https`)
+umgesetzt, ohne zusätzliches Web-Framework. `@iobroker/testing` ist als devDependency
+vorbereitet, aktuell gibt es aber noch keine automatisierten Tests (siehe Test-Badge oben).
+
+## Changelog
+
+Die vollständige Versionshistorie steht in [`io-package.json`](io-package.json) unter
+`common.news`. Die letzten Versionen:
+
+* **1.6.1** — Sync-Modus pro Mapping (`Standard`, `Jede Meldung weiterreichen`,
+  `Force wie vor 1.6.0`); Mapping-Einstellungen als aufklappbare Liste mit zwei kurzen Zeilen
+  pro Eintrag statt einer breiten Tabelle.
+* **1.6.0** — Zeitstempel (`ts`/`lc`/`q`) werden beim Spiegeln durchgereicht statt überschrieben;
+  Start, Update-Intervall und Force-Sync überspringen inaktive Quellen; Force-Sync schreibt nur
+  tatsächlich abweichende Werte; neue Remote-Sync-Platzhalter `%LC%`, `%ACK%`, `%Q%`.
+* **1.5.x** — Topic-Modus `dual` (Status/Befehl auf getrennten Topics) pro Mapping.
+
+## Lizenz
+
+MIT — siehe [LICENSE](LICENSE).

package/admin/jsonConfig.json

@@ -0,0 +1,358 @@
+{
+  "type": "tabs",
+  "items": {
+    "main": {
+      "type": "panel",
+      "label": "Einstellungen & Routen",
+      "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTMgMTNIMXYtMmgydjJ6bTA-MmgydjJIN1YzHptMTQgMTlIMXYtMmgydjJ6bTQtMmgydjJIN1YxN3ptNCAwaC0ydjJoMnYtMnoiLz48L3N2Zz4=",
+      "items": {
+        "targetBasePath": {
+          "type": "text",
+          "label": "MQTT Ziel-Pfad (Prefix)",
+          "default": "mqtt.0.",
+          "sm": 6,
+          "help": "Muss auf . enden! Bsp: mqtt.0."
+        },
+        "updateIntervalSec": {
+          "type": "number",
+          "label": "Update Intervall (s)",
+          "default": 30,
+          "sm": 3
+        },
+        "logTransfers": {
+          "type": "checkbox",
+          "label": "Log Aktiv",
+          "default": true,
+          "sm": 3
+        },
+        "forceSyncIntervalMin": {
+          "type": "number",
+          "label": "Force-Sync Intervall (Min, 0 = aus)",
+          "default": 5,
+          "sm": 3,
+          "help": "Vergleicht Quelle und Ziel und schreibt nur Abweichungen - Mappings im Sync-Modus \"Force\" werden immer neu geschrieben."
+        },
+        "staleAfterMin": {
+          "type": "number",
+          "label": "Aktualitätsgrenze (Min, 0 = aus)",
+          "default": 1440,
+          "min": 0,
+          "sm": 3,
+          "help": "Quellen, deren letztes Update älter ist (oder mit Qualität q≠0), werden bei Start, Update-Intervall und Force-Sync nicht gespiegelt - ein inaktives Gerät wird so auf der Zielseite nicht wieder \"frisch\". Echte Änderungs-Ereignisse gehen immer durch. Standard: 1440 (24 h)."
+        },
+        "mappings": {
+          "type": "accordion",
+          "label": "Mappings",
+          "titleAttr": "mqttName",
+          "clone": true,
+          "newLine": true,
+          "sm": 12,
+          "items": [
+            {
+              "type": "objectId",
+              "attr": "id",
+              "label": "Quell-ID (ioBroker)",
+              "xs": 12,
+              "sm": 12,
+              "md": 6,
+              "lg": 4,
+              "xl": 4
+            },
+            {
+              "type": "text",
+              "attr": "mqttName",
+              "label": "Pfad Suffix (z.B. home/küche/licht)",
+              "xs": 12,
+              "sm": 12,
+              "md": 6,
+              "lg": 3,
+              "xl": 3
+            },
+            {
+              "type": "select",
+              "attr": "dir",
+              "label": "Richtung",
+              "options": [
+                {
+                  "value": "out",
+                  "label": "IOB -> MQTT"
+                },
+                {
+                  "value": "in",
+                  "label": "MQTT -> IOB"
+                },
+                {
+                  "value": "both",
+                  "label": "Beide"
+                }
+              ],
+              "default": "out",
+              "xs": 12,
+              "sm": 6,
+              "md": 4,
+              "lg": 2,
+              "xl": 2
+            },
+            {
+              "type": "select",
+              "attr": "topicMode",
+              "label": "MQTT-Topic-Modus",
+              "options": [
+                {
+                  "value": "single",
+                  "label": "Single (ein Topic)"
+                },
+                {
+                  "value": "dual",
+                  "label": "Dual (Befehl auf /set)"
+                }
+              ],
+              "default": "single",
+              "xs": 12,
+              "sm": 6,
+              "md": 4,
+              "lg": 2,
+              "xl": 2,
+              "help": "Dual: Befehle auf <topic>/set"
+            },
+            {
+              "type": "text",
+              "attr": "commandSuffix",
+              "label": "Befehls-Suffix",
+              "default": "/set",
+              "xs": 12,
+              "sm": 6,
+              "md": 4,
+              "lg": 1,
+              "xl": 1,
+              "hidden": "data.topicMode !== 'dual'"
+            },
+            {
+              "type": "select",
+              "attr": "type",
+              "label": "Typ",
+              "options": [
+                {
+                  "value": "auto",
+                  "label": "Auto"
+                },
+                {
+                  "value": "round",
+                  "label": "Runden"
+                },
+                {
+                  "value": "boolToNum",
+                  "label": "Bool->Num"
+                },
+                {
+                  "value": "numToBool",
+                  "label": "Num->Bool"
+                }
+              ],
+              "default": "auto",
+              "newLine": true,
+              "xs": 12,
+              "sm": 6,
+              "md": 3,
+              "lg": 2,
+              "xl": 2
+            },
+            {
+              "type": "number",
+              "attr": "decimals",
+              "label": "Nachkommastellen",
+              "default": 2,
+              "xs": 12,
+              "sm": 6,
+              "md": 3,
+              "lg": 1,
+              "xl": 1,
+              "hidden": "data.type !== 'round'"
+            },
+            {
+              "type": "text",
+              "attr": "unit",
+              "label": "Einheit",
+              "xs": 12,
+              "sm": 6,
+              "md": 2,
+              "lg": 1,
+              "xl": 1
+            },
+            {
+              "type": "select",
+              "attr": "ackFilter",
+              "label": "Ack-Filter",
+              "options": [
+                {
+                  "value": "confirmed",
+                  "label": "Nur bestätigt (ack=true)"
+                },
+                {
+                  "value": "any",
+                  "label": "Auch unbestätigt (userdata/alias)"
+                }
+              ],
+              "default": "confirmed",
+              "xs": 12,
+              "sm": 6,
+              "md": 4,
+              "lg": 3,
+              "xl": 3,
+              "help": "\"Auch unbestätigt\" für 0_userdata/alias"
+            },
+            {
+              "type": "number",
+              "attr": "staleAfterMin",
+              "label": "Aktualität (Min)",
+              "min": 0,
+              "xs": 12,
+              "sm": 6,
+              "md": 3,
+              "lg": 2,
+              "xl": 2,
+              "help": "leer = global, 0 = aus",
+              "hidden": "data.syncMode === 'force'"
+            },
+            {
+              "type": "select",
+              "attr": "syncMode",
+              "label": "Sync-Modus",
+              "default": "standard",
+              "xs": 12,
+              "sm": 6,
+              "md": 4,
+              "lg": 3,
+              "xl": 3,
+              "options": [
+                {
+                  "value": "standard",
+                  "label": "Standard (nur Änderungen)"
+                },
+                {
+                  "value": "refresh",
+                  "label": "Jede Meldung weiterreichen"
+                },
+                {
+                  "value": "force",
+                  "label": "Force wie vor 1.6.0"
+                }
+              ],
+              "help": "Siehe Hilfe: Sync-Modus"
+            }
+          ]
+        }
+      }
+    },
+    "webTab": {
+      "type": "panel",
+      "label": "Web Dashboard",
+      "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTE0IDJINkM0Ljg5IDIgNCAyLjg5IDQgNHYxNmMwIDEuMTEuODkgMiAyIDJoMTJjMS4xMSAwIDItLjg5IDItMlY4bC02LTZ6bS0xIDlIN3YtMmg2djJ6bTMgN0g3di0yaDEwdjJ6bTAtNEg3di0yaDEwdjJ6Ii8+PC9zdmc+",
+      "items": {
+        "webInfo": {
+          "type": "staticText",
+          "text": "Der Adapter stellt ein Web-Interface für Backup/Restore und Status bereit. Nutzen Sie den Link in der Instanz-Übersicht.",
+          "sm": 12
+        },
+        "serverPort": {
+          "type": "number",
+          "label": "Webserver Port",
+          "default": 8095,
+          "sm": 4
+        },
+        "bindHost": {
+          "type": "select",
+          "label": "Bind-Interface",
+          "default": "0.0.0.0",
+          "sm": 4,
+          "options": [
+            {
+              "value": "0.0.0.0",
+              "label": "Alle Interfaces (LAN erreichbar)"
+            },
+            {
+              "value": "127.0.0.1",
+              "label": "Nur lokal (127.0.0.1)"
+            }
+          ]
+        },
+        "dashboardUser": {
+          "type": "text",
+          "label": "Dashboard Benutzername",
+          "default": "admin",
+          "sm": 4
+        },
+        "dashboardPassword": {
+          "type": "password",
+          "label": "Dashboard Passwort",
+          "sm": 4,
+          "help": "Leer lassen = kein Zugangsschutz (nicht empfohlen). Wird per HTTP Basic-Auth abgefragt."
+        },
+        "dashboardTlsCert": {
+          "type": "text",
+          "label": "TLS-Zertifikat (PEM, optional)",
+          "multiline": true,
+          "rows": 6,
+          "sm": 6,
+          "help": "Mit TLS-Key zusammen gesetzt: Dashboard läuft über HTTPS statt HTTP, Zugangsdaten werden verschlüsselt übertragen."
+        },
+        "dashboardTlsKey": {
+          "type": "text",
+          "label": "TLS-Key (PEM, optional)",
+          "multiline": true,
+          "rows": 6,
+          "sm": 6,
+          "help": "Privater Schlüssel zum obigen Zertifikat. Leer lassen = HTTP (unverschlüsselt). Wird verschlüsselt gespeichert (encryptedNative)."
+        }
+      }
+    },
+    "syncTab": {
+      "type": "panel",
+      "label": "Remote Sync",
+      "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTE5LjM1IDEwLjA0QzE4LjY3IDYuNTkgMTUuNjQgNCAxMiA0IDkuMTEgNCA2LjYgNS42NCA1LjM1IDguMDQgMi4zNCA4LjM2IDAgMTAuOTEgMCAxNGMwIDMuMzEgMi42OSA2IDYgNmgxM2MzLjMxIDAgNi0yLjY5IDYtNkwyNCAxNGMtMy4zMSAwLTYtMi42OS02LTYgMC0zLjMxIDIuNjktNiA2LTZ6Ii8+PC9zdmc+",
+      "items": {
+        "syncUrl": {
+          "type": "text",
+          "label": "Webhook URL",
+          "sm": 12,
+          "help": "Komplette URL inkl. API Key Parameter, z.B. https://.../sync?api-key=123"
+        },
+        "syncIntervalMin": {
+          "type": "number",
+          "label": "Intervall (Min)",
+          "default": 60,
+          "sm": 6
+        },
+        "remoteSyncSkipStale": {
+          "type": "checkbox",
+          "label": "Inaktive Quellen weglassen",
+          "default": false,
+          "sm": 6,
+          "help": "Werte, die laut Aktualitätsgrenze/Qualität als inaktiv gelten, werden nicht an den Webhook gesendet."
+        },
+        "syncCaCert": {
+          "type": "text",
+          "label": "Vertrauenswürdiges Zertifikat / CA (PEM, optional)",
+          "multiline": true,
+          "rows": 6,
+          "sm": 12,
+          "help": "Nur bei selbstsigniertem/internem Zertifikat der Sync-Gegenstelle nötig. Leer lassen bei öffentlichem Zertifikat (Standard-Systemvertrauensstore wird genutzt)."
+        },
+        "checkSync": {
+          "type": "sendTo",
+          "command": "checkSync",
+          "label": "Verbindung Prüfen",
+          "sm": 4,
+          "variant": "contained"
+        },
+        "lastSyncStatus": {
+          "type": "text",
+          "oid": "info.lastSyncStatus",
+          "label": "Letzter Status / Fehlercode",
+          "sm": 8,
+          "readOnly": true
+        }
+      }
+    }
+  }
+}