iobroker.zeptrion 0.8.6 → 1.0.1

package/README.md

@@ -190,6 +190,14 @@ npm run test:integration   # starts a real js-controller (takes longer)
 
 ## Changelog
 
+### 1.0.1 (2026-07-17)
+- FIX: calibrate declared role 'level' but read=false - role 'level' requires read=true per the ioBroker role catalogue. Changed to read=true and extended the startup migration to also correct existing objects still holding the old read=false.
+- Added the missing translations for the global info.connection object (was only en/de).
+
+### 1.0.0 (2026-07-17)
+- First 1.0 release - the adapter has reached a stable, complete feature set (multicast command bundling, mDNS discovery, hail bulk commands, position estimation, Smartfront support, CSV import, full i18n).
+- FIX: the previous release corrected calibrate/ntp.per roles and the info.connection translation, but ensureState() never updates an object that already exists - so installations updated from an older version kept the old, incorrect objects forever. Added a one-time startup migration that force-corrects exactly those known objects via extendObjectAsync(), without touching anything else (including the adapter's own built-in root info.connection object).
+
 ### 0.8.6 (2026-07-17)
 - Corrected object role/type mismatches found by the ioBroker store submission's object structure check: calibrate and ntp.per used role 'value', which strictly requires read=true/write=false and does not fit these intentionally writable states - changed to role 'level'. Also added the missing full i18n translation for info.connection.
 

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "zeptrion",
-    "version": "0.8.6",
+    "version": "1.0.1",
     "news": {
+      "1.0.1": {
+        "en": "FIX: calibrate declared role 'level' but read=false - role 'level' requires read=true per the ioBroker role catalogue. Changed to read=true and extended the startup migration to also correct existing objects still holding the old read=false. Added the missing translations for the global info.connection object (was only en/de).",
+        "de": "FIX: calibrate deklarierte Rolle 'level', aber read=false - die Rolle 'level' erfordert laut ioBroker-Rollenkatalog read=true. Auf read=true geändert und die Start-Migration erweitert, damit auch bestehende Objekte mit dem alten read=false korrigiert werden. Fehlende Übersetzungen für das globale info.connection-Objekt ergänzt (waren nur en/de).",
+        "ru": "ИСПРАВЛЕНИЕ: calibrate объявлял роль 'level', но read=false - роль 'level' требует read=true согласно каталогу ролей ioBroker. Изменено на read=true, миграция при запуске расширена. Добавлены отсутствующие переводы для глобального объекта info.connection.",
+        "pt": "CORREÇÃO: calibrate declarava a função 'level', mas read=false - a função 'level' exige read=true segundo o catálogo de funções do ioBroker. Alterado para read=true, migração de arranque estendida. Adicionadas as traduções em falta para o objeto global info.connection.",
+        "nl": "FIX: calibrate declareerde rol 'level', maar read=false - rol 'level' vereist read=true volgens de ioBroker-rolcatalogus. Gewijzigd naar read=true, opstartmigratie uitgebreid. Ontbrekende vertalingen voor het globale info.connection-object toegevoegd.",
+        "fr": "CORRECTIF : calibrate déclarait le rôle 'level', mais read=false - le rôle 'level' nécessite read=true selon le catalogue de rôles ioBroker. Changé en read=true, migration au démarrage étendue. Traductions manquantes pour l'objet global info.connection ajoutées.",
+        "it": "CORREZIONE: calibrate dichiarava il ruolo 'level', ma read=false - il ruolo 'level' richiede read=true secondo il catalogo dei ruoli di ioBroker. Cambiato in read=true, migrazione all'avvio estesa. Aggiunte le traduzioni mancanti per l'oggetto globale info.connection.",
+        "es": "CORRECCIÓN: calibrate declaraba el rol 'level', pero read=false - el rol 'level' requiere read=true según el catálogo de roles de ioBroker. Cambiado a read=true, migración de inicio ampliada. Se añadieron las traducciones faltantes para el objeto global info.connection.",
+        "pl": "POPRAWKA: calibrate deklarował rolę 'level', ale read=false - rola 'level' wymaga read=true zgodnie z katalogiem ról ioBroker. Zmieniono na read=true, rozszerzono migrację przy starcie. Dodano brakujące tłumaczenia dla globalnego obiektu info.connection.",
+        "uk": "ВИПРАВЛЕННЯ: calibrate декларував роль 'level', але read=false - роль 'level' вимагає read=true згідно з каталогом ролей ioBroker. Змінено на read=true, розширено міграцію під час запуску. Додано відсутні переклади для глобального об'єкта info.connection.",
+        "zh-cn": "修复：calibrate 声明角色为 'level'，但 read=false——根据 ioBroker 角色目录，角色 'level' 要求 read=true。已更改为 read=true，并扩展了启动迁移。补充了全局 info.connection 对象缺失的翻译。"
+      },
+      "1.0.0": {
+        "en": "First 1.0 release. FIX: the previous release corrected calibrate/ntp.per roles and the info.connection translation, but ensureState() never updates an object that already exists - so installations updated from an older version kept the old, incorrect objects forever. Added a one-time startup migration that force-corrects exactly those known objects via extendObjectAsync(), without touching anything else (including the adapter's own built-in root info.connection object). No other functional changes since 0.8.6 - the version bump to 1.0.0 reflects that the adapter has reached a stable, complete feature set (multicast command bundling, mDNS discovery, hail bulk commands, position estimation, Smartfront support, CSV import, full i18n).",
+        "de": "Erstes 1.0-Release. FIX: Das vorherige Release hat die calibrate/ntp.per-Rollen und die info.connection-Übersetzung korrigiert, aber ensureState() aktualisiert nie ein bereits existierendes Objekt - Installationen, die von einer älteren Version aktualisiert haben, behielten die alten, falschen Objekte dauerhaft. Eine einmalige Start-Migration ergänzt, die genau diese bekannten Objekte per extendObjectAsync() zwangskorrigiert, ohne sonst etwas anzufassen (auch nicht das adaptereigene, eingebaute root-info.connection-Objekt). Keine weiteren funktionalen Änderungen seit 0.8.6 - der Sprung auf 1.0.0 spiegelt wider, dass der Adapter einen stabilen, vollständigen Funktionsumfang erreicht hat (Multicast-Befehlsbündelung, mDNS-Discovery, Hagel-Sammelbefehle, Positionsschätzung, Smartfront-Unterstützung, CSV-Import, vollständige i18n).",
+        "ru": "Первый релиз 1.0. ИСПРАВЛЕНИЕ: предыдущий релиз исправил роли calibrate/ntp.per и перевод info.connection, но ensureState() никогда не обновляет уже существующий объект - поэтому установки, обновлённые с более старой версии, навсегда сохраняли старые, неверные объекты. Добавлена одноразовая миграция при запуске, принудительно исправляющая именно эти известные объекты.",
+        "pt": "Primeiro lançamento 1.0. CORREÇÃO: o lançamento anterior corrigiu as funções calibrate/ntp.per e a tradução info.connection, mas ensureState() nunca atualiza um objeto já existente - por isso as instalações atualizadas de uma versão mais antiga mantinham para sempre os objetos antigos incorretos. Adicionada uma migração única no arranque.",
+        "nl": "Eerste 1.0-release. FIX: de vorige release corrigeerde de calibrate/ntp.per-rollen en de info.connection-vertaling, maar ensureState() werkt nooit een reeds bestaand object bij - installaties bijgewerkt vanaf een oudere versie behielden dus permanent de oude, onjuiste objecten. Eenmalige opstartmigratie toegevoegd.",
+        "fr": "Première version 1.0. CORRECTIF : la version précédente a corrigé les rôles calibrate/ntp.per et la traduction info.connection, mais ensureState() ne met jamais à jour un objet déjà existant - les installations mises à jour depuis une version plus ancienne conservaient donc indéfiniment les anciens objets incorrects. Migration unique au démarrage ajoutée.",
+        "it": "Prima versione 1.0. CORREZIONE: la versione precedente ha corretto i ruoli calibrate/ntp.per e la traduzione info.connection, ma ensureState() non aggiorna mai un oggetto già esistente - le installazioni aggiornate da una versione precedente mantenevano quindi per sempre i vecchi oggetti errati. Aggiunta una migrazione una tantum all'avvio.",
+        "es": "Primera versión 1.0. CORRECCIÓN: la versión anterior corrigió los roles calibrate/ntp.per y la traducción de info.connection, pero ensureState() nunca actualiza un objeto ya existente, por lo que las instalaciones actualizadas desde una versión anterior conservaban para siempre los objetos antiguos incorrectos. Se añadió una migración única al inicio.",
+        "pl": "Pierwsze wydanie 1.0. POPRAWKA: poprzednie wydanie naprawiło role calibrate/ntp.per oraz tłumaczenie info.connection, ale ensureState() nigdy nie aktualizuje już istniejącego obiektu - instalacje zaktualizowane ze starszej wersji na stałe zachowywały więc stare, błędne obiekty. Dodano jednorazową migrację przy starcie.",
+        "uk": "Перший реліз 1.0. ВИПРАВЛЕННЯ: попередній реліз виправив ролі calibrate/ntp.per та переклад info.connection, але ensureState() ніколи не оновлює вже існуючий об'єкт - тому інсталяції, оновлені зі старішої версії, назавжди зберігали старі, неправильні об'єкти. Додано одноразову міграцію під час запуску.",
+        "zh-cn": "首个 1.0 版本。修复：上一版本修正了 calibrate/ntp.per 角色和 info.connection 翻译，但 ensureState() 从不更新已存在的对象——因此从旧版本升级的安装会永久保留旧的、不正确的对象。新增了一次性启动迁移来强制修正这些已知对象。"
+      },
       "0.8.6": {
         "en": "Corrected object role/type mismatches found by the ioBroker store submission's object structure check: calibrate and ntp.per used role 'value', which strictly requires read=true/write=false and does not fit these intentionally writable states - changed to role 'level'. Also added the missing full i18n translation for info.connection. No functional/API changes - purely metadata (common.role/common.name) corrections.",
         "de": "Objekt-Rollen-/Typ-Abweichungen behoben, die beim Objektstruktur-Check der ioBroker-Store-Einreichung gefunden wurden: calibrate und ntp.per nutzten die Rolle 'value', die zwingend read=true/write=false erfordert und nicht zu diesen bewusst schreibbaren States passt - auf Rolle 'level' umgestellt. Zusätzlich die fehlende vollständige i18n-Übersetzung für info.connection ergänzt. Keine funktionalen/API-Änderungen - reine Metadaten-Korrekturen (common.role/common.name).",
@@ -164,7 +190,16 @@
         "role": "indicator.connected",
         "name": {
           "en": "At least one device reachable",
-          "de": "Mindestens ein Gerät erreichbar"
+          "de": "Mindestens ein Gerät erreichbar",
+          "ru": "Доступно хотя бы одно устройство",
+          "pt": "Pelo menos um dispositivo acessível",
+          "nl": "Ten minste één apparaat bereikbaar",
+          "fr": "Au moins un appareil accessible",
+          "it": "Almeno un dispositivo raggiungibile",
+          "es": "Al menos un dispositivo accesible",
+          "pl": "Co najmniej jedno urządzenie dostępne",
+          "uk": "Принаймні один пристрій доступний",
+          "zh-cn": "至少有一个设备可访问"
         },
         "type": "boolean",
         "read": true,

package/main.js

@@ -120,7 +120,66 @@ class Zeptrion extends utils.Adapter {
 
     // ---------------------------------------------------------------- ready
 
+    // Force-corrects a small set of known-bad object roles/names left over from before this fix.
+    // Only touches an object if it still holds the exact old, known-bad value, so it never
+    // clobbers anything a user might have customized in the meantime. Role fixes are matched by
+    // ID suffix (calibrate/ntp.per are always per-device, unambiguous); the info.connection name
+    // fix is matched by its exact old string value instead of by ID, since the adapter's own
+    // built-in root "info.connection" object (not created by ensureState, must not be touched)
+    // would otherwise be hard to tell apart from the per-device one by ID pattern alone.
+    async migrateObjectRoles() {
+        try {
+            const objects = await this.getAdapterObjectsAsync();
+            let fixedCount = 0;
+            for (const id of Object.keys(objects)) {
+                const obj = objects[id];
+                if (!obj || obj.type !== 'state' || !obj.common) {
+                    continue;
+                }
+                if (/\.calibrate$/.test(id) && (obj.common.role === 'value' || obj.common.read === false)) {
+                    await this.extendObjectAsync(id, { common: { role: 'level', read: true } });
+                    fixedCount++;
+                } else if (/\.ntp\.per$/.test(id) && obj.common.role === 'value') {
+                    await this.extendObjectAsync(id, { common: { role: 'level' } });
+                    fixedCount++;
+                } else if (/\.info\.connection$/.test(id) && obj.common.name === 'Verbindung OK') {
+                    await this.extendObjectAsync(id, {
+                        common: {
+                            name: {
+                                en: 'Connection OK',
+                                de: 'Verbindung OK',
+                                ru: 'Соединение в порядке',
+                                pt: 'Ligação OK',
+                                nl: 'Verbinding OK',
+                                fr: 'Connexion OK',
+                                it: 'Connessione OK',
+                                es: 'Conexión OK',
+                                pl: 'Połączenie OK',
+                                uk: "З'єднання в порядку",
+                                'zh-cn': '连接正常'
+                            }
+                        }
+                    });
+                    fixedCount++;
+                }
+            }
+            if (fixedCount > 0) {
+                this.log.info(`Migration: corrected role/name on ${fixedCount} existing object(s) created by an older version.`);
+            }
+        } catch (e) {
+            // Never let a migration failure block adapter startup.
+            this.log.warn(`Migration of object roles/names failed (non-fatal, adapter will continue starting): ${e}`);
+        }
+    }
+
     async onReady() {
+        // One-time (cheap-and-idempotent-every-startup) fix for role/name mistakes present in
+        // objects created before this fix (see CHANGELOG). ensureState()/setObjectNotExistsAsync()
+        // never touches an object that already exists, so simply updating the adapter does not
+        // correct objects an already-running installation had already created - this actively
+        // force-corrects them via extendObjectAsync() instead.
+        await this.migrateObjectRoles();
+
         await this.setStateAsync('info.connection', { val: false, ack: true });
 
         const timeout = parseInt(String(this.config.requestTimeout), 10) || 4000;
@@ -528,7 +587,7 @@ class Zeptrion extends utils.Adapter {
                 });
                 await this.ensureState(`${ch}.calibrate`, {
                     name: 'Schätzung setzen OHNE Fahrt (z.B. nach manueller Bedienung am Wandtaster): aktuellen Ist-Zustand in % eintragen',
-                    type: 'number', role: 'level', min: 0, max: 100, read: false, write: true
+                    type: 'number', role: 'level', min: 0, max: 100, read: true, write: true
                 });
                 await this.extendObjectAsync(`${ch}.tiltOpen`, {
                     type: 'state',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.zeptrion",
-  "version": "0.8.6",
+  "version": "1.0.1",
   "description": "ioBroker Adapter für Feller zeptrion / zApp WLAN-Aktoren (WLAN-Nebenstelle 4K, WLAN-Zwischenmodul 2K) über die zrap Webservice API - inkl. Sammelbefehlen für Hagelalarm und mDNS-Discovery",
   "author": {
     "name": "Stefan",