node-red-contrib-knx-ultimate 7.1.4 → 8.0.2

package/resources/hueControllerEditorSelection.js

@@ -1,32 +1,2 @@
-(function (root, factory) {
-  const api = factory()
-  if (typeof module === 'object' && module.exports) module.exports = api
-  if (root) root.KNXUltimateHueControllerEditorSelection = api
-}(typeof window !== 'undefined' ? window : globalThis, function () {
-  const DEFAULT_EMPTY_VALUES = new Set(['', 'none', '_add_', '__none__'])
-
-  function normalizeSelection (value, emptyValues = DEFAULT_EMPTY_VALUES) {
-    const normalized = value === undefined || value === null ? '' : String(value).trim()
-    const normalizedEmptyValues = emptyValues instanceof Set
-      ? emptyValues
-      : new Set(Array.isArray(emptyValues) ? emptyValues : DEFAULT_EMPTY_VALUES)
-    return normalizedEmptyValues.has(normalized.toLowerCase()) ? '' : normalized
-  }
-
-  function shouldPreserveStoredSelection (event, nextValue, storedValue, emptyValues = DEFAULT_EMPTY_VALUES) {
-    const programmaticChange = !event || !event.originalEvent
-    return programmaticChange &&
-      normalizeSelection(nextValue, emptyValues) === '' &&
-      normalizeSelection(storedValue, emptyValues) !== ''
-  }
-
-  function resolveSelectedOrStoredSelection (selectedValue, storedValue, emptyValues = DEFAULT_EMPTY_VALUES) {
-    return normalizeSelection(selectedValue, emptyValues) || normalizeSelection(storedValue, emptyValues)
-  }
-
-  return {
-    normalizeSelection,
-    resolveSelectedOrStoredSelection,
-    shouldPreserveStoredSelection
-  }
-}))
+// Inert compatibility resource for the version 7 Hue editor cached before restart.
+// Hue editors now belong to node-red-contrib-hue-ultimate.

package/resources/hueControllerMigrationDialog.js

@@ -1,254 +1,2 @@
-(function (root, factory) {
-  const api = factory()
-  if (typeof module === 'object' && module.exports) module.exports = api
-  if (root) {
-    root.KNXUltimateHueControllerMigrationDialog = api
-    if (root.RED && root.jQuery && root.document) {
-      api.installLegacyButton(root.RED, root.jQuery, root, root.document)
-    }
-  }
-}(typeof globalThis !== 'undefined' ? globalThis : this, function () {
-  'use strict'
-
-  const EVENT_NAMESPACE = '.knxUltimateHueControllerMigrationDialog'
-  const BUTTON_SELECTOR = '.hue-legacy-migrate-flow'
-  const BUTTON_STYLE_ID = 'knxUltimateHueLegacyMigrationButtonStyle'
-  const I18N_PREFIX = 'node-red-contrib-knx-ultimate/knxUltimateHueController:knxUltimateHueController.'
-  let closeActiveDialog = function () {}
-
-  function defaultTranslate (RED, key, fallback, values) {
-    try {
-      const qualifiedKey = `${I18N_PREFIX}${key}`
-      const translated = RED._(qualifiedKey, values)
-      if (translated && translated !== qualifiedKey) return translated
-    } catch (error) { /* use fallback */ }
-    return fallback
-  }
-
-  function closeEditorTray (RED, $) {
-    try {
-      if (RED.actions && typeof RED.actions.invoke === 'function') {
-        RED.actions.invoke('core:cancel-edit-tray')
-        return
-      }
-    } catch (error) { /* use the compatible button fallback */ }
-    const $cancel = $('#node-dialog-cancel:visible, #node-config-dialog-cancel:visible').first()
-    if ($cancel.length) $cancel.trigger('click')
-  }
-
-  function ensureLegacyButtonStyle ($) {
-    if ($(`#${BUTTON_STYLE_ID}`).length) return
-    $('<style></style>')
-      .attr('id', BUTTON_STYLE_ID)
-      .text(`
-        .hue-legacy-migrate-flow.red-ui-button,
-        .hue-legacy-migrate-flow.red-ui-button:hover,
-        .hue-legacy-migrate-flow.red-ui-button:active,
-        .hue-legacy-migrate-flow.red-ui-button:focus,
-        .hue-legacy-migrate-flow.red-ui-button > i,
-        .hue-legacy-migrate-flow.red-ui-button > span {
-          color: #ffffff !important;
-        }
-      `)
-      .appendTo('head')
-  }
-
-  function openDonationPage (RED, translate, windowObject, donationUrl) {
-    try {
-      if (!windowObject || typeof windowObject.open !== 'function') throw new Error('Browser window opening is unavailable')
-      const donationWindow = windowObject.open(donationUrl, '_blank', 'noopener,noreferrer')
-      if (!donationWindow) throw new Error('The browser blocked the donation window')
-    } catch (error) {
-      if (RED && typeof RED.notify === 'function') {
-        RED.notify(translate('migration_donation_failed', 'The donation page could not be opened. You can try again.'), 'warning')
-      }
-    }
-  }
-
-  function showCompletionMessage (RED, translate, convertedCount, windowObject, donationUrl) {
-    if (!RED || typeof RED.notify !== 'function') return
-    const message = translate('migration_success', 'The flow backup download has started. Process finished. {{count}} legacy HUE nodes were converted. Inspect every modified node, including its function, configuration, pins and wiring, before clicking Deploy. If this conversion saved you time, you can support the continued development of KNX Ultimate with the optional button below.')
-      .replace('{{count}}', String(convertedCount))
-    let notification
-    try {
-      notification = RED.notify(message, {
-        modal: true,
-        fixed: true,
-        type: 'success',
-        buttons: [
-          {
-            text: translate('migration_donate', 'Support KNX Ultimate ❤️'),
-            class: 'hue-controller-migration-donate',
-            click () {
-              openDonationPage(RED, translate, windowObject, donationUrl)
-            }
-          },
-          {
-            text: translate('migration_ok', 'OK'),
-            class: 'primary',
-            click () {
-              if (notification && typeof notification.close === 'function') notification.close()
-            }
-          }
-        ]
-      })
-    } catch (error) { /* the conversion is already complete */ }
-  }
-
-  function open (options = {}) {
-    const RED = options.RED
-    const $ = options.$
-    const windowObject = options.windowObject
-    const documentObject = options.documentObject
-    const migrationApi = options.migrationApi || (windowObject && windowObject.KNXUltimateHueControllerMigration)
-    const translate = typeof options.translate === 'function'
-      ? options.translate
-      : (key, fallback, values) => defaultTranslate(RED, key, fallback, values)
-
-    if (!RED || !$ || !windowObject || !documentObject || !migrationApi ||
-        typeof migrationApi.collectLegacyHueNodes !== 'function' ||
-        typeof migrationApi.createLocalMigrationPatches !== 'function' ||
-        typeof migrationApi.applyLocalMigration !== 'function' ||
-        typeof migrationApi.createUsageMailto !== 'function' ||
-        typeof migrationApi.openUsageMailto !== 'function' ||
-        typeof migrationApi.MIGRATION_DONATION_URL !== 'string') {
-      if (RED && typeof RED.notify === 'function') {
-        RED.notify(translate('migration_unavailable', 'The HUE migration tool is unavailable. Restart Node-RED after updating the package.'), 'error')
-      }
-      if (typeof options.onClose === 'function') options.onClose()
-      return function () {}
-    }
-
-    const legacyNodes = migrationApi.collectLegacyHueNodes(RED)
-    if (legacyNodes.length === 0) {
-      if (typeof RED.notify === 'function') RED.notify(translate('migration_none', 'No legacy HUE nodes were found.'), 'warning')
-      if (typeof options.onClose === 'function') options.onClose()
-      return function () {}
-    }
-
-    const $dialog = $('<div class="hue-controller-migration-dialog"></div>').appendTo('body')
-    $('<div class="hue-controller-migration-summary"></div>')
-      .text(translate('migration_confirm', '{{count}} legacy HUE nodes will be converted directly in the editor.').replace('{{count}}', String(legacyNodes.length)))
-      .css({ marginBottom: '10px', fontWeight: 'bold' })
-      .appendTo($dialog)
-    $('<div class="hue-controller-migration-note"></div>')
-      .text(translate('migration_privacy', 'Conversion happens entirely in this browser. No flow, node, configuration, credential, group address or wiring data is sent to external services. A JSON flow backup is downloaded locally.'))
-      .css({ marginBottom: '10px', padding: '8px 10px', borderLeft: '4px solid #2980b9', background: '#eaf4fb' })
-      .appendTo($dialog)
-    $('<div class="hue-controller-migration-email"></div>')
-      .text(translate('migration_email_notice', 'After conversion, your email app will open an editable draft addressed to the author without navigating away from Node-RED. The draft contains only the number of converted nodes and space for optional notes; nothing is sent automatically. The final Node-RED message will offer an optional button to support KNX Ultimate.'))
-      .css({ marginBottom: '10px' })
-      .appendTo($dialog)
-    $('<div class="form-tips hue-controller-migration-backup"></div>')
-      .text(translate('migration_deploy_notice', 'Before conversion, the browser automatically starts downloading a JSON backup of all flows. Protected credentials are excluded, as in the standard Node-RED export. Your browser may ask where to save the file. The current editor will close. Only the legacy HUE nodes will be changed; all config nodes and wiring remain untouched. Review the result, then click Deploy yourself.'))
-      .css({ marginBottom: '10px', padding: '8px 10px', borderLeft: '4px solid #d79b00', background: '#fff8df' })
-      .appendTo($dialog)
-    $('<div class="form-tips hue-controller-migration-review"></div>')
-      .text(translate('migration_review_notice', 'Safety check: after conversion, inspect every modified HUE node in the flow. Verify its selected function, configuration references, input/output pins and wiring before clicking Deploy.'))
-      .css({ marginBottom: '12px', padding: '8px 10px', borderLeft: '4px solid #d79b00', background: '#fff8df' })
-      .appendTo($dialog)
-    const $status = $('<div class="hue-controller-migration-status"></div>')
-      .css({ minHeight: '20px', marginTop: '8px' })
-      .appendTo($dialog)
-
-    let closed = false
-    let running = false
-    let $convert
-    const closeDialog = () => {
-      if (closed) return
-      closed = true
-      if ($convert) $convert.off(EVENT_NAMESPACE)
-      try { $dialog.dialog('destroy') } catch (error) { /* already detached */ }
-      $dialog.remove()
-      if (typeof options.onClose === 'function') options.onClose()
-    }
-
-    const performMigration = () => {
-      if (running || closed) return
-      running = true
-      $convert.prop('disabled', true)
-      try {
-        migrationApi.createLocalMigrationPatches(legacyNodes)
-        try {
-          const backupApi = options.backupApi || windowObject.KNXUltimateFlowMigrationBackup
-          if (!backupApi || typeof backupApi.download !== 'function') throw new Error('The flow backup tool is unavailable')
-          backupApi.download(RED, { environment: windowObject, documentObject, kind: 'hue' })
-        } catch (error) {
-          running = false
-          $convert.prop('disabled', false)
-          const message = error && error.message ? error.message : String(error)
-          $status.text(`${translate('migration_backup_failed', 'Flow backup could not be started. No nodes were converted:')} ${message}`).css('color', '#b00020')
-          return
-        }
-        closeDialog()
-        closeEditorTray(RED, $)
-        windowObject.setTimeout(() => {
-          let convertedCount
-          try {
-            convertedCount = migrationApi.applyLocalMigration(RED, legacyNodes)
-          } catch (error) {
-            const message = error && error.message ? error.message : String(error)
-            RED.notify(`${translate('migration_failed', 'HUE migration failed; the flow was not changed:')} ${message}`, 'error')
-            return
-          }
-          try {
-            const mailto = migrationApi.createUsageMailto(convertedCount, {
-              subject: translate('migration_email_subject', 'KNX Ultimate - legacy HUE conversion used'),
-              body: translate('migration_email_body', 'Hello Massimo,\n\nI used the legacy HUE node conversion button.\nConverted legacy HUE nodes: {{count}}.\n\nOptional notes:\n')
-            })
-            migrationApi.openUsageMailto(mailto, {
-              document: documentObject,
-              setTimeout: (callback, delay) => windowObject.setTimeout(callback, delay)
-            })
-          } catch (error) {
-            RED.notify(translate('migration_email_failed', 'The nodes were converted, but the email draft could not be opened.'), 'warning')
-          }
-          showCompletionMessage(RED, translate, convertedCount, windowObject, migrationApi.MIGRATION_DONATION_URL)
-        }, 0)
-      } catch (error) {
-        running = false
-        $convert.prop('disabled', false)
-        const message = error && error.message ? error.message : String(error)
-        $status.text(`${translate('migration_failed', 'HUE migration failed; the flow was not changed:')} ${message}`).css('color', '#b00020')
-      }
-    }
-
-    $dialog.dialog({
-      modal: true,
-      width: Math.min(680, Math.max(520, $(windowObject).width() - 80)),
-      title: translate('migration_title', 'Convert legacy HUE nodes'),
-      beforeClose: () => !running,
-      close: closeDialog,
-      buttons: [
-        {
-          text: translate('migration_close', 'Cancel'),
-          click () { if (!running) $(this).dialog('close') }
-        },
-        {
-          text: translate('migration_convert', 'Convert HUE nodes'),
-          class: 'hue-controller-migration-convert',
-          click: performMigration
-        }
-      ],
-      open () {
-        $convert = $dialog.parent().find('.hue-controller-migration-convert')
-        $convert.addClass('primary')
-      }
-    })
-    return closeDialog
-  }
-
-  function installLegacyButton (RED, $, windowObject, documentObject) {
-    if (!RED || !$ || !documentObject) return
-    ensureLegacyButtonStyle($)
-    const $document = $(documentObject)
-    $document.off(`click${EVENT_NAMESPACE}`, BUTTON_SELECTOR)
-    $document.on(`click${EVENT_NAMESPACE}`, BUTTON_SELECTOR, (event) => {
-      event.preventDefault()
-      closeActiveDialog()
-      closeActiveDialog = open({ RED, $, windowObject, documentObject })
-    })
-  }
-
-  return { installLegacyButton, open }
-}))
+// Inert compatibility resource for version 7 editor templates cached before restart.
+// The old migration plugin now displays the Node-RED restart notice instead.