node-red-contrib-knx-ultimate 7.0.4 → 7.1.0-beta.0

package/nodes/knxUltimateDateTime.js

@@ -1,33 +1,9 @@
 const loggerClass = require('./utils/sysLogger')
 
-let sendNowEndpointRegistered = false
+const registerSendNowEndpoint = require('./utils/knxDateTimeSendNow')
 
 module.exports = function (RED) {
-  if (!sendNowEndpointRegistered) {
-    RED.httpAdmin.post('/knxUltimateDateTime/sendNow', RED.auth.needsPermission('knxUltimate-config.write'), (req, res) => {
-      try {
-        const { id } = req.body || {}
-        if (!id) {
-          res.status(400).json({ error: 'Missing node id' })
-          return
-        }
-        const targetNode = RED.nodes.getNode(id)
-        if (!targetNode) {
-          res.status(404).json({ error: 'KNX DateTime node not found' })
-          return
-        }
-        if (typeof targetNode.triggerSend !== 'function') {
-          res.status(400).json({ error: 'Node does not support sendNow' })
-          return
-        }
-        const result = targetNode.triggerSend({ reason: 'button' })
-        res.json({ status: 'ok', queued: result && result.queued === true })
-      } catch (error) {
-        res.status(500).json({ error: error.message || 'KNX DateTime send failed' })
-      }
-    })
-    sendNowEndpointRegistered = true
-  }
+  registerSendNowEndpoint(RED)
 
   function knxUltimateDateTime (config) {
     RED.nodes.createNode(this, config)

package/nodes/knxUltimateGarage.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
   RED.nodes.registerType('knxUltimateGarage', {
-    category: 'KNX Ultimate',
-    color: '#C7E9C0',
+    category: 'deprecated',
+    color: '#E5F0E2',
     defaults: {
       server: { type: 'knxUltimate-config', required: true },
       name: { value: '' },
@@ -37,9 +39,9 @@
     outputs: 1,
     icon: 'node-knx-icon.svg',
     label: function () {
-      return this.name || 'KNX Garage';
+      return (this.name || 'KNX Garage') + " (deprecated)";
     },
-    paletteLabel: 'KNX Garage',
+    paletteLabel: 'KNX Garage (deprecated)',
     oneditprepare: function () {
       const node = this;
       const $knxServerInput = $('#node-input-server');
@@ -183,6 +185,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateGarage">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateGarage.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateGarage.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateGarage.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateGlobalContext.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateGlobalContext', {
-        category: "KNX Ultimate",
-        color: '#C7E9C0',
+        category: 'deprecated',
+        color: '#E5F0E2',
         defaults: {
             //buttonState: {value: true},
             server: { type: "knxUltimate-config", required: true },
@@ -16,9 +18,9 @@
         outputs: 0,
         icon: "node-knx-icon.svg",
         label: function () {
-            return (this.name);
+            return ((this.name)) + " (deprecated)";
         },
-        paletteLabel: "KNX Global Context",
+        paletteLabel: "KNX Global Context (deprecated)",
         // button: {
         //     enabled: function() {
         //         // return whether or not the button is enabled, based on the current
@@ -64,6 +66,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateGlobalContext">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateGlobalContext.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateGlobalContext.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateGlobalContext.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateHATranslator.html

@@ -1,6 +1,8 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript">
 	RED.nodes.registerType('knxUltimateHATranslator', {
-		category: 'KNX Ultimate',
+		category: 'deprecated',
 		defaults: {
 			name: { value: "" },
 			payloadPropName: { value: "payload", required: false },
@@ -10,10 +12,10 @@
 		outputs: 1,
 		icon: "node-ha-icon.svg",
 		label: function () {
-			return (this.name || 'HA -> KNX');
+			return (this.name || 'HA -> KNX') + ' (deprecated)';
 		},
-		color: '#AED6F1',
-		paletteLabel: "Home Assistant translator",
+		color: '#E5F0E2',
+		paletteLabel: "Home Assistant translator (deprecated)",
 		oneditprepare: function () {
 			// Go to the help panel
 			try {
@@ -47,6 +49,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateHATranslator">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateHATranslator.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateHATranslator.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateHATranslator.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateHueController.html

@@ -3,6 +3,7 @@
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/hueControllerEditorSelection.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/hueControllerProfiles.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/hueControllerMigration.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/hueControllerMigrationDialog.js"></script>
 
 <script type="text/javascript">
@@ -1067,11 +1068,9 @@ The controller supports lights and grouped lights, plugs, buttons, Tap dial, mot
 
 ## Convert a legacy HUE flow
 
-Use **Convert legacy HUE flow**, paste a complete Node-RED flow export, and press **Convert**. The conversion runs only in the browser: it does not inspect or modify the open flow. The returned JSON replaces every supported legacy HUE node with HUE Controller while preserving IDs, configuration references, properties, positions, and wires. Copy the result and import it into Node-RED, preferably as a new flow for comparison before removing the original.
+Use **Convert legacy HUE flow** in HUE Controller or the conversion button in a legacy HUE editor. After confirmation, the browser automatically starts downloading a dated JSON backup of all current editor flows, including tabs, subflows, configuration nodes, groups and wires. The backup uses the standard Node-RED export format and excludes declared credentials. Your browser may ask where to save the file. If the backup cannot be created or its download cannot be started, no nodes are converted.
 
-Node-RED intentionally excludes credentials from flow exports. When importing into the same Node-RED installation, keep **Reuse existing Hue and KNX config nodes** selected: referenced `hue-config` and `knxUltimate-config` objects are omitted from the converted JSON, while their IDs remain on the converted nodes so the existing configurations retain their keys and passwords. Clear the option only for a different installation, where credentials must be entered again after import.
-
-**Copy converted flow** uses the browser Clipboard API and falls back to a temporary selected textarea when direct clipboard access is unavailable. If the browser blocks both methods, the output JSON is selected so it can be copied manually.
+The current editor then closes and discards unsaved form edits. Conversion runs locally in the editor and preserves node IDs, settings, configuration references, positions, groups and wiring. A single Undo restores the original nodes. Review the converted flows and click **Deploy** yourself; conversion does not deploy automatically.
 
 ## Compatibility and loop protection
 

package/nodes/knxUltimateLoadControl.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateLoadControl', {
-        category: "KNX Ultimate",
-        color: '#C7E9C0',
+        category: 'deprecated',
+        color: '#E5F0E2',
         defaults: {
             //buttonState: {value: true},
             server: { type: "knxUltimate-config", required: false },
@@ -54,9 +56,9 @@
         outputs: 1,
         icon: "node-alerter-icon.svg",
         label: function () {
-            return (this.name || this.topic || "KNX Load Control");
+            return ((this.name || this.topic || "KNX Load Control")) + " (deprecated)";
         },
-        paletteLabel: "KNX Load Control",
+        paletteLabel: "KNX Load Control (deprecated)",
         // button: {
         //     enabled: function() {
         //         // return whether or not the button is enabled, based on the current
@@ -205,6 +207,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateLoadControl">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateLoadControl.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateLoadControl.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateLoadControl.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateLogger.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateLogger', {
-        category: "KNX Ultimate",
-        color: '#C7E9C0',
+        category: 'deprecated',
+        color: '#E5F0E2',
         defaults: {
             server: { type: "knxUltimate-config", required: true },
             topic: { value: "" },
@@ -22,9 +24,9 @@
         outputLabels: ["ETS Diag file", "Telegram Count"],
         icon: "node-logger-icon.svg",
         label: function () {
-            return ((this.name || "KNX Logger") + " " + this.topic);
+            return (((this.name || "KNX Logger") + " " + this.topic)) + " (deprecated)";
         },
-        paletteLabel: "KNX Logger",
+        paletteLabel: "KNX Logger (deprecated)",
         oneditprepare: function () {
             // Go to the help panel
             try {
@@ -110,6 +112,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateLogger">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateLogger.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateLogger.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateLogger.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateSceneController.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateSceneController', {
-        category: "KNX Ultimate",
-        color: '#C7E9C0',
+        category: 'deprecated',
+        color: '#E5F0E2',
         defaults: {
             //buttonState: {value: true},
             server: { type: "knxUltimate-config", required: true },
@@ -24,9 +26,9 @@
         outputs: 1,
         icon: "node-scene-icon.svg",
         label: function () {
-            return (this.outputRBE == true ? "|rbe| " : "") + (this.name || this.topic || "KNX Scene Controller") + (this.inputRBE == true ? " |rbe|" : "")
+            return ((this.outputRBE == true ? "|rbe| " : "") + (this.name || this.topic || "KNX Scene Controller") + (this.inputRBE == true ? " |rbe|" : "")) + " (deprecated)";
         },
-        paletteLabel: "KNX Scene Controller",
+        paletteLabel: "KNX Scene Controller (deprecated)",
         // button: {
         //     enabled: function() {
         //         // return whether or not the button is enabled, based on the current
@@ -451,6 +453,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateSceneController">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateSceneController.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateSceneController.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateSceneController.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateStaircase.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
   RED.nodes.registerType('knxUltimateStaircase', {
-    category: 'KNX Ultimate',
-    color: '#C7E9C0',
+    category: 'deprecated',
+    color: '#E5F0E2',
     defaults: {
       server: { type: 'knxUltimate-config', required: true },
       name: { value: '' },
@@ -37,9 +39,9 @@
     outputs: 1,
     icon: 'node-knx-icon.svg',
     label: function () {
-      return this.name || 'KNX Staircase';
+      return (this.name || 'KNX Staircase') + " (deprecated)";
     },
-    paletteLabel: 'KNX Staircase',
+    paletteLabel: 'KNX Staircase (deprecated)',
     oneditprepare: function () {
       const node = this;
       const $knxServerInput = $('#node-input-server');
@@ -195,6 +197,15 @@
 
 
 <script type="text/html" data-template-name="knxUltimateStaircase">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateStaircase.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateStaircase.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateStaircase.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>