iobroker.zwavews 0.1.2 → 0.1.4

package/README.md

@@ -35,6 +35,14 @@ Activate WS Server Settings in `zwave-js-ui` we use the Home Assistant Settings
 
 
 ## Changelog
+### 0.1.4 (2026-04-16)
+* (arteck) Dependencies have been updated
+* (arteck) add vscode folder
+
+### 0.1.3 (2026-04-03)
+* (arteck) del last dot from DP
+* (arteck) fix scene
+
 ### 0.1.2 (2026-03-15)
 * (arteck) typo
 

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "zwavews",
-    "version": "0.1.2",
+    "version": "0.1.4",
     "news": {
+      "0.1.4": {
+        "en": "Dependencies have been updated\nadd vscode folder",
+        "de": "Abhängigkeiten wurden aktualisiert\nvscode ordner hinzufügen",
+        "ru": "Зависимости были обновлены\nдобавить vscode папку",
+        "pt": "As dependências foram atualizadas\nadicionar pasta vscode",
+        "nl": "Afhankelijkheden zijn bijgewerkt\nvscode map toevoegen",
+        "fr": "Les dépendances ont été actualisées\najouter un dossier vscode",
+        "it": "Le dipendenze sono state aggiornate\naggiungere cartella vscode",
+        "es": "Se han actualizado las dependencias\nañadir carpeta vscode",
+        "pl": "Zaktualizowano zależności\ndodaj folder vscode",
+        "uk": "Залежність було оновлено\nдодати папку проти коду",
+        "zh-cn": "依赖关系已更新\n添加 vscode 文件夹"
+      },
+      "0.1.3": {
+        "en": "fix unknown state from scene\ndel last dot from DP\nfix scene",
+        "de": "unbekannter zustand von szene\nder letzte Punkt von DP\nfixe szene",
+        "ru": "неизвестное состояние с места происшествия\nпоследняя точка от DP\nисправить",
+        "pt": "corrigir o estado desconhecido da cena\ndo último ponto do DP\ncorrigir cena",
+        "nl": "fix onbekende toestand vanaf locatie\nde laatste stip van DP\nscène herstellen",
+        "fr": "réparer l'état inconnu de la scène\ndel dernier point de DP\nréparer la scène",
+        "it": "fissare stato sconosciuto dalla scena\ndel ultimo punto da DP\ncorrere la scena",
+        "es": "arreglar estado desconocido de la escena\ndel último punto de DP\nescena arreglada",
+        "pl": "naprawić nieznany stan z miejsca zbrodni\ndel ostatnia kropka z DP\nmiejsce",
+        "uk": "виправити невідомого стану з сцени\ndel last dot від DP\nфіксувати сцена",
+        "zh-cn": "从现场修复未知状态\ndP 的最后一个点\n修补场景"
+      },
       "0.1.2": {
         "en": "typo",
         "de": "typo",
@@ -67,32 +93,6 @@
         "pl": "uruchomić adapter\nZaktualizowano zależności",
         "uk": "запуск адаптера\nЗалежність було оновлено",
         "zh-cn": "固定适配器启动\n依赖关系已更新"
-      },
-      "0.0.16": {
-        "en": "fix warning message",
-        "de": "warnmeldung aktivieren",
-        "ru": "исправить предупреждающее сообщение",
-        "pt": "corrigir a mensagem de aviso",
-        "nl": "waarschuwingsbericht herstellen",
-        "fr": "corriger le message d'avertissement",
-        "it": "correzione del messaggio di avviso",
-        "es": "mensaje de advertencia",
-        "pl": "naprawić komunikat ostrzegawczy",
-        "uk": "фіксувати повідомлення про попередження",
-        "zh-cn": "修补警告消息"
-      },
-      "0.0.15": {
-        "en": "typo\nfix ready status if status is dead",
-        "de": "typo\nbereitstellen des status, wenn der status tot ist",
-        "ru": "опечатка\nготовый статус, если статус мертв",
-        "pt": "erro de digitação\ncorrigir o estado pronto se o estado estiver morto",
-        "nl": "type\nfix ready status als status dood is",
-        "fr": "typo\nfixer le statut prêt si le statut est mort",
-        "it": "tipo\nfissare lo stato pronto se lo stato è morto",
-        "es": "typo\nfijar estado listo si el estado está muerto",
-        "pl": "typo\nustaw stan gotowy, jeśli stan jest martwy",
-        "uk": "типи\nвиправити готовий статус, якщо статус мертвий",
-        "zh-cn": "类型\n如果状态已死亡, 则固定状态"
       }
     },
     "titleLang": {
@@ -180,13 +180,13 @@
     ],
     "globalDependencies": [
       {
-        "admin": ">=7.6.17"
+        "admin": ">=7.6.20"
       }
     ],
     "plugins": {
       "docker": {
         "iobDockerComposeFiles": [
-          "https://github.com/zwave-js/zwave-js-ui/blob/master/docker/docker-compose.yml"
+          "docker-compose.yaml"
         ]
       }
     },

package/lib/devicemgmt.js

@@ -3,12 +3,13 @@ const dmUtils = require('@iobroker/dm-utils');
 const humanizeDuration = require('humanize-duration');
 
 /**
- *
+ * Device management class for the ZWave adapter.
  */
 class dmZwave extends dmUtils.DeviceManagement {
     /**
+     * Creates a new dmZwave instance.
      *
-     * @param adapter
+     * @param {object} adapter - The ioBroker adapter instance.
      */
     constructor(adapter) {
         super(adapter);
@@ -28,9 +29,7 @@ class dmZwave extends dmUtils.DeviceManagement {
 
             const device = this.adapter.nodeCache[nodeId].nodeData;
 
-            if (device.ready) {
-                status.connection = device.ready ? 'connected' : 'disconnected';
-            }
+            status.connection = device.ready ? 'connected' : 'disconnected';
 
             //const link_quality = await this.adapter.getStateAsync(`${theDevice._id}.status`);
             //status.rssi = link_quality.val == 'alive' ? '100' : '0';
@@ -91,9 +90,10 @@ class dmZwave extends dmUtils.DeviceManagement {
     }
 
     /**
+     * Opens the device documentation PDF or link in a form dialog.
      *
-     * @param context
-     * @param device
+     * @param {object} context - The device management context used to show the form.
+     * @param {object} device - The ZWave device object containing device config and metadata.
      */
     async openPDF(context, device) {
         const manual = device?.deviceConfig?.metadata?.manual;
@@ -140,12 +140,13 @@ class dmZwave extends dmUtils.DeviceManagement {
     }
 
     /**
+     * Returns the detail schema and data for a specific device.
      *
-     * @param id
-     * @param action
-     * @param context
+     * @param {string} id - The node ID of the device.
+     * @param {object} _action - The action object passed by the device management framework.
+     * @param {object} _context - The device management context.
      */
-    async getDeviceDetails(id, action, context) {
+    async getDeviceDetails(id, _action, _context) {
         this.adapter.log.debug('getDeviceDetails');
 
         const device = this.adapter.nodeCache[id]?.nodeData;
@@ -362,27 +363,27 @@ class dmZwave extends dmUtils.DeviceManagement {
 
 
     /**
+     * Formats a timestamp according to the given format type.
      *
-     * @param time
-     * @param type
+     * @param {number} time - The timestamp in milliseconds (epoch).
+     * @param {'ISO_8601'|'ISO_8601_local'|'epoch'|'relative'} type - The desired output format.
      */
-    async formatDate(time, type) {   //'ISO_8601' | 'ISO_8601_local' | 'epoch' | 'relative'
+    formatDate(time, type) {   //'ISO_8601' | 'ISO_8601_local' | 'epoch' | 'relative'
         if (type === 'ISO_8601') {
-return new Date(time).toISOString();
-} else if (type === 'ISO_8601_local') {
-return this.toLocalISOString(new Date(time));
-} else if (type === 'epoch') {
-return time;
-}
-         // relative
-            const ago = `${humanizeDuration(Date.now() - time, {language: 'en', largest: 2, round: true})  } ago`;
-            return ago;
-        
+            return new Date(time).toISOString();
+        } else if (type === 'ISO_8601_local') {
+            return this.toLocalISOString(new Date(time));
+        } else if (type === 'epoch') {
+            return time;
+        }
+        // relative
+        return `${humanizeDuration(Date.now() - time, { language: 'en', largest: 2, round: true })} ago`;
     }
 
     /**
+     * Converts a Date object to a local ISO 8601 string.
      *
-     * @param d
+     * @param {Date} d - The Date object to convert.
      */
     toLocalISOString(d) {
         const off = d.getTimezoneOffset();
@@ -391,8 +392,10 @@ return time;
     // Entfernt den ioBroker-Prefix am Anfang, z.B.
     // "zwavews.0.nodeID_1.info.name" -> "nodeID_1.info.name"
      /**
+      * Strips the ioBroker adapter prefix from an object ID.
       *
-      * @param id
+      * @param {string} id - The full ioBroker object ID (e.g. "zwavews.0.nodeID_1.info.name").
+      * @returns {string} The ID without the adapter prefix (e.g. "nodeID_1.info.name").
       */
      stripIobPrefix(id) {
         const s = String(id ?? '');

package/lib/helper.js

@@ -1,6 +1,5 @@
 const utils = require("./utils");
 const constant = require("./constants");
-const {isObject} = require("./utils");
 
 /*
 options:
@@ -12,13 +11,14 @@ autoCast (true false) // make JSON.parse to parse numbers correctly
 descriptions: Object of names for state keys
 */
 /**
- *
+ * Helper class for creating and managing ioBroker objects and states from ZWave data.
  */
 class Helper {
   /**
+   * Creates a new Helper instance.
    *
-   * @param adapter
-   * @param alreadyCreatedObjects
+   * @param {object} adapter - The ioBroker adapter instance.
+   * @param {object} [alreadyCreatedObjects] - Cache of already created object paths.
    */
   constructor(adapter, alreadyCreatedObjects = {}) {
     this.adapter = adapter;
@@ -27,17 +27,10 @@ class Helper {
   }
 
   /**
+   * Creates a ZWave node device and all its value states in ioBroker.
    *
-   * @param path
-   * @param element
-   * @param options
-   */
-
-
-  /**
-   *
-   * @param nodeIdOriginal
-   * @param element
+   * @param {string|number} nodeIdOriginal - The original node ID as received from the ZWave driver.
+   * @param {object} element - The node data object containing values, name and device config.
    */
   async createNode(nodeIdOriginal, element) {
     try {
@@ -68,13 +61,10 @@ class Helper {
 
       if (valuesOnly != null && typeof valuesOnly === "object" && valuesOnly.length > 0) {
         for (const v of valuesOnly) {
-          let parsePath = utils.formatObject(`${nodeId}.${v.commandClassName}`);
+          let parsePath = utils.deleteLastDot(utils.formatObject(`${nodeId}.${v.commandClassName}`));
           let metadata = v.metadata || {};
 
-          if (constant.noInfoDP.includes(v.commandClassName)) {
-            continue;
-          }
-          if (constant.noInfoDP.includes(v.propertyName)) {
+          if (constant.noInfoDP.includes(v.commandClassName) || constant.noInfoDP.includes(v.propertyName)) {
             continue;
           }
 
@@ -100,10 +90,10 @@ class Helper {
                 .replace(/[^\p{L}\p{N}\s]/gu, "")
                 .replace(/\s+/g, " ")
                 .trim()}`;
+          }
 
-            if (constant.RGB.includes(v.propertyKeyName)) {
+          if (constant.RGB.includes(v.propertyKeyName)) {
               parsePath = utils.replaceLastDot(parsePath);
-            }
           }
 
           if (this.isObject(v.value))  {   // da gibts ein object mit value
@@ -115,7 +105,7 @@ class Helper {
             parsePath = `${parsePath}_${v.endpoint}`;
           }
 
-          parsePath = utils.formatObject(parsePath);     // entferne sonderzeichen und blanke aus dem namen
+          parsePath = utils.deleteLastDot(utils.formatObject(parsePath));     // entferne sonderzeichen und blank aus dem namen und letzten dot
 
           const nam_id = v.label ?? v.propertyName;
 
@@ -127,7 +117,7 @@ class Helper {
           if (constant.mixedType.includes(nam_id)) {
             typeDp = "mixed";
           }
-
+          
           const common = {
             id:    nam_id,
             name:  nam_id,
@@ -166,7 +156,7 @@ class Helper {
             this.adapter.subscribeStates(parsePath);
           }
 
-          this.adapter.setStateChanged(parsePath, valDp, true);
+          await this.changeState(parsePath, valDp);
 
           this.alreadyCreatedObjects[parsePath] = {};
         }
@@ -177,16 +167,18 @@ class Helper {
   }
 
   /**
+   * Recursively parses an element and creates the corresponding ioBroker objects and states.
    *
-   * @param path
-   * @param element
-   * @param options
+   * @param {string} path - The ioBroker object path to write to.
+   * @param {*} element - The value or object to parse and persist.
+   * @param {object} [options] - Parsing options (e.g. write, channelName, descriptions).
+   * @param {boolean} [change] - If true, forces setState instead of setStateChanged.
    */
-  async parse(path, element, options = { write: false }) {
-    let parsePath = utils.formatObject(path);
+  async parse(path, element, options = { write: false },change = false) {
+    let parsePath = utils.deleteLastDot(utils.formatObject(path));
 
-    if (element == null) {
-      this.adapter.log.debug(`Cannot extract empty: ${parsePath}`);
+    if (element === undefined || element === null) {
+      this.adapter.log.error(`Skip undefined value for ${parsePath}`);
       return;
     }
 
@@ -220,13 +212,16 @@ class Helper {
 
           this.alreadyCreatedObjects[parsePath] = {};
         } catch (error) {
+          this.adapter.log.error(`parse error ${  parsePath}`);
           this.adapter.log.error(error);
         }
       }
 
-      this.adapter.setStateChanged(parsePath, valDp, true);
+      await this.changeState(parsePath, valDp, change);
+
       return;
     }
+
     options.channelName = utils.getLastSegment(parsePath);
 
     if (!this.alreadyCreatedObjects[parsePath]) {
@@ -242,6 +237,7 @@ class Helper {
         this.alreadyCreatedObjects[parsePath] = { };
         delete options.channelName;
       } catch (error) {
+        this.adapter.log.error(`parse error ${  parsePath}`);
         this.adapter.log.error(error);
       }
     }
@@ -310,6 +306,8 @@ class Helper {
           typeDp = "mixed";
         }
 
+        fullPath = utils.deleteLastDot(fullPath);
+        
         const common = {
           id: objectName,
           name: objectName,
@@ -333,14 +331,15 @@ class Helper {
       }
 
       try {
-        if (valDP !== undefined) {
-          this.adapter.setStateChanged(fullPath, valDP, true);
 
+        await this.changeState(fullPath, valDP, change);
+
+        if (valDP !== undefined) {
           if (fullPath.endsWith('ready') ) {
             valDP = element['status'];
-            if (utils.isNumeric(valDP) && valDP == 3) {
+            if (utils.isNumeric(valDP) && valDP === 3) {
               fullPath = fullPath.replace(".status", ".ready");
-              this.adapter.setStateChanged(fullPath, false, true);
+              await this.changeState(fullPath, false);
             }
           }
         }
@@ -353,19 +352,22 @@ class Helper {
 
 
   /**
+   * Checks whether a value is a non-null object.
    *
-   * @param value
+   * @param {*} value - The value to check.
+   * @returns {boolean}
    */
   isObject(value) {
     return value !== null && typeof value === "object";
   }
 
   /**
+   * Extracts and processes an array from an element, creating ioBroker objects for each entry.
    *
-   * @param element
-   * @param key
-   * @param path
-   * @param options
+   * @param {object|Array} element - The element containing the array, or the array itself.
+   * @param {string} key - The key of the array within the element, or empty string if element is the array.
+   * @param {string} path - The ioBroker base path to write to.
+   * @param {object} options - Parsing options forwarded to the parse method.
    */
   async extractArray(element, key, path, options) {
     try {
@@ -396,13 +398,15 @@ class Helper {
   }
 
   /**
+   * Determines the ioBroker role string for a datapoint based on its value and metadata.
    *
-   * @param element
-   * @param options
-   * @param dpName
+   * @param {*} element - The value or metadata object to derive the role from.
+   * @param {object|boolean} options - Parsing options or write flag.
+   * @param {string} [dpName] - The datapoint name used to detect time-based roles.
+   * @returns {string} The ioBroker role string (e.g. "state", "switch", "text").
    */
   getRole(element, options, dpName) {
-    const write = options.write;
+    // const write = options.write;
     const hasStates = element && typeof element === "object" && element.states !== undefined;
 
 
@@ -412,7 +416,7 @@ class Helper {
     }
 
     if (hasStates) {
-      if (element.type == "boolean") {
+      if (element.type === "boolean") {
         delete element.states;
         return "button";
       }
@@ -431,8 +435,10 @@ class Helper {
     return "state";
   }
   /**
+   * Resolves and normalises the value from a ZWave command class metadata object.
    *
-   * @param element
+   * @param {object} element - The metadata object containing type, value, min, writeable and readable fields.
+   * @returns {*} The resolved and normalised value ready for use as an ioBroker state value.
    */
   resolveCommandClassValue(element) {
     const type = element.type;
@@ -494,8 +500,9 @@ class Helper {
 
 
   /**
+   * Creates the ready and status state objects directly on the node device.
    *
-   * @param nodeId
+   * @param {string} nodeId - The formatted node ID used as the ioBroker object path prefix.
    */
   async createReadyStatus(nodeId) {
      // leg die status direkt auch an
@@ -529,12 +536,13 @@ class Helper {
         native: {},
       });
   }
-/**
- *
- * @param nodeId
- * @param element
- * @param nameChange
- */
+  /**
+   * Updates the name or description of an existing ioBroker device object.
+   *
+   * @param {string} nodeId - The ioBroker object ID of the device to update.
+   * @param {object} element - The element containing the new name, productLabel, manufacturer or desc.
+   * @param {boolean} [nameChange] - If true, updates the common name; otherwise updates the description.
+   */
   async updateDevice(nodeId, element, nameChange = true) {
     const obj = await this.adapter.getObjectAsync(nodeId);
     if (obj) {
@@ -553,6 +561,22 @@ class Helper {
       }
     }
   }
+
+  /**
+   * Sets or conditionally updates an ioBroker state value.
+   *
+   * @param {string} path - The ioBroker state ID to set.
+   * @param {*} value - The value to write to the state.
+   * @param {boolean} [change] - If true, uses setState (unconditional); otherwise uses setStateChanged.
+   */
+  async changeState(path, value, change = false) {
+    if (change) {
+      this.adapter.setState(path, value, true);
+    } else {
+      this.adapter.setStateChanged(path, value, true);
+    }
+  }
+
 }
 
 module.exports = {

package/lib/mqttServerController.js

@@ -1,6 +1,6 @@
 const core = require("@iobroker/adapter-core");
 const Aedes = require("aedes");
-const net = require("net");
+const net = require("node:net");
 let mqttServer;
 
 /**

package/lib/statesController.js

@@ -1,20 +1,21 @@
 /**
- *
+ * Controls reading and writing of ioBroker states for the ZWave adapter.
  */
 class StatesController {
   /**
+   * Creates a new StatesController instance.
    *
-   * @param adapter
-   * @param deviceCache
+   * @param {object} adapter - The ioBroker adapter instance.
    */
   constructor(adapter) {
     this.adapter = adapter;
   }
 
   /**
+   * Sets a state value unconditionally, skipping null/undefined values.
    *
-   * @param stateName
-   * @param value
+   * @param {string} stateName - The ioBroker state ID to set.
+   * @param {*} value - The value to write to the state.
    */
   async setStateSafelyAsync(stateName, value) {
     if (value === undefined || value === null) {
@@ -24,9 +25,10 @@ class StatesController {
   }
 
   /**
+   * Sets a state value only if it has changed, skipping null/undefined values.
    *
-   * @param stateName
-   * @param value
+   * @param {string} stateName - The ioBroker state ID to set.
+   * @param {*} value - The value to write to the state.
    */
   async setStateChangedSafelyAsync(stateName, value) {
     if (value === undefined || value === null) {
@@ -36,8 +38,9 @@ class StatesController {
   }
 
   /**
+   * Reads all writable ZWave states from ioBroker and returns them as a map keyed by object ID.
    *
-   * @param deviceCache
+   * @returns {Promise<object>} A map of writable state IDs to their MQTT path and write flag.
    */
   async subscribeAllWritableExistsStates() {
     const writableStates = {};
@@ -62,7 +65,8 @@ class StatesController {
   }
 
   /**
-   *
+   * Sets all node ready-states to false, all status-states to "unknown"
+   * and the gateway status to "offline".
    */
   async setAllAvailableToFalse() {
     const readyStates = await this.adapter.getStatesAsync("*.ready");

package/lib/utils.js

@@ -1,6 +1,7 @@
 /**
+ * Converts a byte array to a word array.
  *
- * @param ba
+ * @param {number[]} ba - The byte array to convert.
  */
 function bytesArrayToWordArray(ba) {
   const wa = [];
@@ -13,8 +14,9 @@ function bytesArrayToWordArray(ba) {
 // If the value is greater than 1000, kelvin is assumed.
 // If smaller, it is assumed to be mired.
 /**
+ * Converts a temperature value to mired.
  *
- * @param t
+ * @param {number} t - Temperature value in Kelvin or mired.
  */
 function toMired(t) {
   let miredValue = t;
@@ -25,8 +27,9 @@ function toMired(t) {
 }
 
 /**
+ * Converts between mired and Kelvin.
  *
- * @param t
+ * @param {number} t - Temperature value to convert.
  */
 function miredKelvinConversion(t) {
   return Math.round(1000000 / t);
@@ -35,8 +38,8 @@ function miredKelvinConversion(t) {
 /**
  * Converts a decimal number to a hex string with zero-padding
  *
- * @param decimal
- * @param padding
+ * @param {number} decimal - The decimal number to convert.
+ * @param {number} padding - The minimum length of the resulting hex string.
  */
 function decimalToHex(decimal, padding) {
   let hex = Number(decimal).toString(16);
@@ -53,8 +56,9 @@ function decimalToHex(decimal, padding) {
 }
 
 /**
+ * Removes all elements from an array in place.
  *
- * @param array
+ * @param {any[]} array - The array to clear.
  */
 function clearArray(array) {
   while (array.length > 0) {
@@ -63,9 +67,10 @@ function clearArray(array) {
 }
 
 /**
+ * Moves all elements from source array into target array.
  *
- * @param source
- * @param target
+ * @param {any[]} source - The source array to move elements from.
+ * @param {any[]} target - The target array to move elements into.
  */
 function moveArray(source, target) {
   while (source.length > 0) {
@@ -74,16 +79,18 @@ function moveArray(source, target) {
 }
 
 /**
+ * Checks whether a value is a plain object.
  *
- * @param item
+ * @param {any} item - The value to check.
  */
 function isObject(item) {
   return typeof item === "object" && !Array.isArray(item) && item !== null;
 }
 
 /**
+ * Checks whether a value is valid JSON.
  *
- * @param item
+ * @param {any} item - The value to check.
  */
 function isJson(item) {
   let value = typeof item !== "string" ? JSON.stringify(item) : item;
@@ -97,8 +104,9 @@ function isJson(item) {
 }
 
 /**
+ * Returns the last segment of a dot- or slash-separated string.
  *
- * @param input
+ * @param {string} input - The input string to parse.
  */
 function getLastSegment(input) {
   if (typeof input !== "string") {
@@ -109,7 +117,9 @@ function getLastSegment(input) {
 }
 
 /**
- * @param {any} value
+ * Checks whether a value is numeric (finite number or numeric string).
+ *
+ * @param {any} value - The value to check.
  * @returns {boolean}
  */
 function isNumeric(value) {
@@ -130,8 +140,9 @@ function isNumeric(value) {
 }
 
 /**
+ * Replaces the last dot in a string with an underscore.
  *
- * @param str
+ * @param {string} str - The string to process.
  */
 function replaceLastDot(str) {
   const idx = str.lastIndexOf(".");
@@ -139,8 +150,18 @@ function replaceLastDot(str) {
 }
 
 /**
+ * Removes a trailing dot from a string if present.
+ *
+ * @param {string|undefined} str - The string to process.
+ */
+function deleteLastDot(str) {
+  return str.endsWith(".") ? str.slice(0, -1) : str;
+}
+
+/**
+ * Trims and normalises an object name string.
  *
- * @param str
+ * @param {string} str - The string to format.
  */
 function formatObject(str) {
   if (typeof str !== "string") {
@@ -150,8 +171,9 @@ function formatObject(str) {
 }
 
 /**
+ * Replaces all dots in an MQTT topic with slashes.
  *
- * @param input
+ * @param {string} input - The MQTT topic string to format.
  */
 function formatMQTT(input) {
   if (typeof input !== "string") {
@@ -161,17 +183,19 @@ function formatMQTT(input) {
 }
 
 /**
+ * Zero-pads the numeric suffix of a node ID string.
  *
- * @param nodeId
- * @param width
+ * @param {string} nodeId - The node ID string to pad.
+ * @param {number} [width] - The desired minimum width of the numeric part.
  */
 function padNodeId(nodeId, width = 3) {
   return nodeId.replace(/(\d+)$/, (m) => m.padStart(width, "0"));
 }
 
 /**
+ * Returns a human-readable status text for a given node status code.
  *
- * @param status
+ * @param {number} status - The numeric status code.
  */
 function getStatusText(status) {
   const nodeStatus = {
@@ -186,8 +210,9 @@ function getStatusText(status) {
 }
 
 /**
+ * Formats a node ID, padding numeric IDs with a prefix.
  *
- * @param nodeIdOriginal
+ * @param {string|number} nodeIdOriginal - The original node ID to format.
  */
 function formatNodeId(nodeIdOriginal) {
   let nodeId = nodeIdOriginal;
@@ -215,4 +240,5 @@ module.exports = {
   padNodeId,
   getStatusText,
   formatObject,
+  deleteLastDot,
 };

package/lib/websocketController.js

@@ -7,19 +7,22 @@ let pingTimeout;
 let autoRestartTimeout;
 
 /**
- *
+ * Manages the WebSocket connection to the zwave-js-ui server.
  */
 class WebsocketController {
     /**
+     * Creates a new WebsocketController instance.
      *
-     * @param adapter
+     * @param {object} adapter - The ioBroker adapter instance.
      */
     constructor(adapter) {
         this.adapter = adapter;
     }
 
     /**
+     * Initialises and connects the WebSocket client to the zwave-js-ui server.
      *
+     * @returns {WebSocket} The created WebSocket client instance.
      */
     initWsClient() {
         try {
@@ -64,8 +67,9 @@ class WebsocketController {
     }
 
     /**
+     * Sends a message to the zwave-js-ui server via the WebSocket connection.
      *
-     * @param message
+     * @param {string} message - The message payload to send.
      */
     send(message) {
         if (wsClient.readyState !== WebSocket.OPEN) {
@@ -76,7 +80,7 @@ class WebsocketController {
     }
 
     /**
-     *
+     * Sends a WebSocket ping to the server and schedules the next ping.
      */
     sendPingToServer() {
         //this.logDebug('Send ping to server');
@@ -87,7 +91,7 @@ class WebsocketController {
     }
 
     /**
-     *
+     * Resets the heartbeat timeout; terminates the connection if no pong is received in time.
      */
     wsHeartbeat() {
         clearTimeout(pingTimeout);
@@ -98,7 +102,7 @@ class WebsocketController {
     }
 
     /**
-     *
+     * Schedules an automatic reconnect attempt after the configured restart timeout.
      */
     async autoRestart() {
         this.adapter.log.warn(`Start try again in ${restartTimeout / 1000} seconds...`);
@@ -108,7 +112,7 @@ class WebsocketController {
     }
 
     /**
-     *
+     * Closes the WebSocket connection if it is currently open.
      */
     closeConnection() {
         if (wsClient && wsClient.readyState !== WebSocket.CLOSED) {
@@ -117,7 +121,7 @@ class WebsocketController {
     }
 
     /**
-     *
+     * Clears all active timers (ping, pingTimeout, autoRestartTimeout).
      */
     async allTimerClear() {
         clearTimeout(pingTimeout);

package/main.js

@@ -160,6 +160,7 @@ class zwavews extends core.Adapter {
               this.setStateChanged('info.connection', false, true);
               await statesController.setAllAvailableToFalse();
               startListening = false;
+              allNodesCreated = false;
               deviceCache = [];
               this.nodeCache = [];
               this.log.info('Websocket connection closed. Attempting to reconnect...');
@@ -263,7 +264,7 @@ class zwavews extends core.Adapter {
                           }
                       }
 
-                      parsePath = utils.formatObject(parsePath);
+                      parsePath = utils.deleteLastDot(utils.formatObject(parsePath));
 
                       if (nodeArg.commandClass === 119) {    // sonderlocke für node naming
                           switch (nodeArg.property) {
@@ -291,8 +292,13 @@ class zwavews extends core.Adapter {
                         parsePath = `${parsePath}_${nodeArg.endpoint}`;
                       }
 
-                      await helper.parse(`${parsePath}`, nodeArg.newValue, options);
+                      parsePath = utils.deleteLastDot(parsePath); // check again
 
+                      if (eventTyp.event === 'value notification') {
+                        await helper.parse(`${parsePath}`, nodeArg.newValue, options, true);
+                      } else {
+                        await helper.parse(`${parsePath}`, nodeArg.newValue, options, false);
+                      }
                       break;
                   }
 
@@ -381,11 +387,9 @@ class zwavews extends core.Adapter {
     if (["exmqtt", "intmqtt"].includes(this.config.connectionType)) {
       if (mqttClient && !mqttClient.closed) {
         try {
-          if (mqttClient) {
             mqttClient.end();
-          }
         } catch (e) {
-          this.log.error(e);
+            this.log.error(e);
         }
       }
     }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "iobroker.zwavews",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "zwavews adapter for ioBroker",
   "author": {
-    "name": "Dennis Rathjen and Arthur Rupp",
+    "name": "Arthur Rupp",
     "email": "arteck@outlook.com"
   },
   "homepage": "https://github.com/arteck/ioBroker.zwavews",
@@ -26,28 +26,28 @@
   },
   "dependencies": {
     "@iobroker/adapter-core": "^3.3.2",
-    "@iobroker/dm-utils": "^2.0.1",
+    "@iobroker/dm-utils": "^3.0.3",
     "humanize-duration": "^3.33.2",
     "aedes": "^0.51.3",
     "aedes-persistence-nedb": "^2.0.3",
-    "mqtt": "^5.15.0",
+    "mqtt": "^5.15.1",
     "net": "^1.0.2",
     "node-schedule": "^2.1.1",
     "sharp": "^0.34.5",
-    "ws": "^8.19.0"
+    "ws": "^8.20.0"
   },
   "devDependencies": {
     "@alcalzone/release-script": "^5.1.1",
-    "@alcalzone/release-script-plugin-iobroker": "^4.0.0",
+    "@alcalzone/release-script-plugin-iobroker": "^5.1.2",
     "@alcalzone/release-script-plugin-license": "^5.1.1",
-    "@alcalzone/release-script-plugin-manual-review": "^4.0.0",
+    "@alcalzone/release-script-plugin-manual-review": "^5.1.1",
     "@iobroker/adapter-dev": "^1.5.0",
     "@iobroker/testing": "^5.2.2",
     "@iobroker/eslint-config": "^2.2.0",
     "@tsconfig/node14": "^14.1.8",
-    "@types/node": "^25.2.3",
+    "@types/node": "^25.5.0",
     "@types/node-schedule": "^2.1.8",
-    "typescript": "~5.9.2"
+    "typescript": "~6.0.2"
   },
   "main": "main.js",
   "files": [