iobroker.zeptrion 0.8.6 → 1.0.0

package/README.md

@@ -190,6 +190,10 @@ npm run test:integration   # starts a real js-controller (takes longer)
 
 ## Changelog
 
+### 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,21 @@
 {
   "common": {
     "name": "zeptrion",
-    "version": "0.8.6",
+    "version": "1.0.0",
     "news": {
+      "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).",

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') {
+                    await this.extendObjectAsync(id, { common: { role: 'level' } });
+                    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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.zeptrion",
-  "version": "0.8.6",
+  "version": "1.0.0",
   "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",