node-red-contrib-room-tools 1.4.2

package/README.md

@@ -0,0 +1,27 @@
+# Room Tools
+
+One package containing three nodes:
+
+- room-gateway: authenticated region control and feedback gateway.
+- room-message: typed panel feedback message generator.
+- ui-control-panel: Dashboard 2 template widget without message ports.
+
+Every room gateway uses `/room-panel-api/regions/<room-id>` so additional
+regions follow the same URL structure.
+
+The node type names and configuration fields are unchanged from the individual
+1.0.0 packages. No external dependencies or installation scripts are required.
+
+## Migrating from the individual packages
+
+Do not install this package alongside node-red-contrib-room-gateway or
+node-red-contrib-room-message: they register the same node types.
+
+Back up the project and its credentials, save changes, and stop Automator.
+In its user directory (on this Mac, ~/.node-red), uninstall the two individual
+packages with npm, then install this .tgz package before restarting Automator.
+Keep the existing flow nodes and their IDs; do not delete them from the canvas.
+After restarting, verify the gateway credentials and both nodes before use.
+
+This package does not contain accounts, passwords, or flows. Installing it on a
+Mac does not install it on a MUSE controller.

package/control-panel.html

@@ -0,0 +1,462 @@
+<script type="text/javascript">
+    (async function () {
+        // convert to i18 text
+        function c_ (x) {
+            return RED._('@flowfuse/node-red-dashboard/ui-template:ui-template.' + x)
+        }
+        // TODO: move this to util.js for reuse & unit testing
+        function hasProperty (obj, prop) {
+            return Object.prototype.hasOwnProperty.call(obj, prop)
+        }
+
+        const template = []
+
+        template.push('<template>')
+        template.push('    <div>')
+        template.push('        <h2>Counter</h2>')
+        template.push('        <!-- Conditional Styling using Attribute Binding (":") -->')
+        template.push('        <!-- and rendering content inside <tags></tags> with {{ }} -->')
+        template.push('        <p :style="{\'color\' : (count > 5 ? \'red\' : \'green\' )}">Current Count: {{ count }}</p>')
+        template.push('        <!-- Computed Rendering using Vue Computed Variables -->')
+        template.push('        <p class="my-class">Formatted Count: {{ formattedCount }}</p>')
+        template.push('        <!-- Conditional Rendering with "v-if" -->')
+        template.push('        <b v-if="count > 5">Too many!</b>')
+        template.push('        <v-btn @click="increase()">Increment</v-btn>')
+        template.push('    </div>')
+        template.push('</template>')
+        template.push('')
+        template.push('<script>')
+        template.push('    export default {')
+        template.push('        data() {')
+        template.push('            // define variables available component-wide')
+        template.push('            // (in <template> and component functions)')
+        template.push('            return {')
+        template.push('                count: 0')
+        template.push('            }')
+        template.push('        },')
+        template.push('        watch: {')
+        template.push('            // watch for any changes of "count"')
+        template.push('            count: function () {')
+        template.push('                if (this.count % 5 === 0) {')
+        template.push('                    this.send({payload: \'Multiple of 5\'})')
+        template.push('                }')
+        template.push('            }')
+        template.push('        },')
+        template.push('        computed: {')
+        template.push('            // automatically compute this variable')
+        template.push('            // whenever VueJS deems appropriate')
+        template.push('            formattedCount: function () {')
+        template.push('                return this.count + \' Apples\'')
+        template.push('            }')
+        template.push('        },')
+        template.push('        methods: {')
+        template.push('            // expose a method to our <template> and Vue Application')
+        template.push('            increase: function () {')
+        template.push('                this.count++')
+        template.push('            }')
+        template.push('        },')
+        template.push('        mounted() {')
+        template.push('            // code here when the component is first loaded')
+        template.push('        },')
+        template.push('        unmounted() {')
+        template.push('            // code here when the component is removed from the Dashboard')
+        template.push('            // i.e. when the user navigates away from the page')
+        template.push('        }')
+        template.push('    }')
+        // eslint complaingin about unterminated string literal - need to do this oddity to get around it
+        template.push('</' + 'script>')
+        template.push('<style>')
+        template.push('    /* define any styles here - supports raw CSS */')
+        template.push('    .my-class {')
+        template.push('        color: red;')
+        template.push('    }')
+        template.push('</style>')
+
+        const defaultTemplate = template.join('\n')
+
+        RED.nodes.registerType('ui-control-panel', {
+            category: RED._('@flowfuse/node-red-dashboard/ui-base:ui-base.label.category'),
+            color: RED._('@flowfuse/node-red-dashboard/ui-base:ui-base.colors.dark'),
+            defaults: {
+                group: {
+                    type: 'ui-group',
+                    validate: function () {
+                        const tempScope = ($('#node-input-templateScope').val() !== undefined) ? $('#node-input-templateScope').val() : this.templateScope
+                        const groupVal = ($('#node-input-group').val() !== undefined) ? $('#node-input-group').val() : this.group
+
+                        if (tempScope !== 'local') {
+                            return true
+                        }
+
+                        if (tempScope === 'local') {
+                            if (!!groupVal && groupVal !== '_ADD_') {
+                                return true
+                            }
+                        }
+                        return false
+                    }
+                }, // for when template is scoped to 'local' (default)
+                page: {
+                    type: 'ui-page',
+                    validate: function () {
+                        const tempScope = ($('#node-input-templateScope').val() !== undefined) ? $('#node-input-templateScope').val() : this.templateScope
+                        const pageVal = ($('#node-input-page').val() !== undefined) ? $('#node-input-page').val() : this.page
+
+                        if (tempScope !== 'widget:page' && tempScope !== 'page:style') {
+                            return true
+                        }
+                        if (tempScope === 'widget:page' || tempScope === 'page:style') {
+                            if (!!pageVal && pageVal !== '_ADD_') {
+                                return true
+                            }
+                        }
+                        return false
+                    }
+                }, // for when template is scoped to 'page'
+                ui: {
+                    type: 'ui-base',
+                    validate: function () {
+                        const tempScope = ($('#node-input-templateScope').val() !== undefined) ? $('#node-input-templateScope').val() : this.templateScope
+                        const uiVal = ($('#node-input-ui').val() !== undefined) ? $('#node-input-ui').val() : this.ui
+
+                        if (tempScope !== 'widget:ui' && tempScope !== 'site:style') {
+                            return true
+                        }
+                        if (tempScope === 'widget:ui' || tempScope === 'site:style') {
+                            if (!!uiVal && uiVal !== '_ADD_') {
+                                return true
+                            }
+                        }
+                        return false
+                    }
+                }, // for when template is scoped to 'site'
+                name: { value: '' },
+                order: { value: 0 },
+                width: {
+                    value: 0,
+                    validate: function (v) {
+                        if (this.templateScope !== 'global') {
+                            const width = v || 0
+                            const currentGroup = $('#node-input-group').val() || this.group
+                            const groupNode = RED.nodes.node(currentGroup)
+                            const valid = !groupNode || +width >= 0
+                            $('#node-input-size').toggleClass('input-error', !valid)
+                            return valid
+                        }
+                        return true
+                    }
+                },
+                height: { value: 0 },
+                head: { value: '' },
+                format: { value: defaultTemplate },
+                storeOutMessages: { value: true },
+                passthru: { value: true },
+                resendOnRefresh: { value: true },
+                templateScope: { value: 'local' },
+                className: { value: '' }
+            },
+            inputs: 0,
+            outputs: 0,
+            icon: 'font-awesome/fa-code',
+            paletteLabel: 'ControlPanel',
+            label: function () {
+                if (this.name) { return this.name }
+                const knownLabels = {
+                    local: 'template', // widget:group - kept as local for backward compatability
+                    'widget:page': 'template',
+                    'widget:ui': 'template',
+                    'site:style': 'site style',
+                    'page:style': 'page style'
+                }
+                return knownLabels[this.templateScope] || 'template'
+            },
+            labelStyle: function () { return this.name ? 'node_label_italic' : '' },
+            oneditprepare: function () {
+                if (RED.editor.__debug === true) {
+                    console.log('ui-template: oneditprepare') // useful for locating this code in the browser debugger
+                }
+                if (hasProperty(RED.editor, 'editText') && typeof RED.editor.editText === 'function') {
+                    $('#node-template-expand-editor').show()
+                } else {
+                    $('#node-template-expand-editor').hide()
+                }
+                const that = this
+                const $templateScope = $('#node-input-templateScope')
+
+                // The native editor translations belong to ui-template. Reuse them for this renamed node.
+                const nativeLabel = (key) => c_('label.' + key)
+                $('#node-input-templateScope').closest('.form-row').find('label span').text(nativeLabel('scope'))
+                $('#node-input-templateScope option[value="local"]').text(nativeLabel('widget-group'))
+                $('#node-input-templateScope option[value="widget:page"]').text(nativeLabel('widget-page'))
+                $('#node-input-templateScope option[value="widget:ui"]').text(nativeLabel('widget-ui'))
+                $('#node-input-templateScope option[value="site:style"]').text(nativeLabel('site-style'))
+                $('#node-input-templateScope option[value="page:style"]').text(nativeLabel('page-style'))
+                $('#template-row-ui label span').text(nativeLabel('ui'))
+                $('#template-row-page label span').text(nativeLabel('page'))
+                $('#template-row-group label span').text(nativeLabel('group'))
+                $('#node-input-className').attr('placeholder', nativeLabel('classNamePlaceholder'))
+                $('#node-input-className').closest('.form-row').find('label span').text(nativeLabel('className'))
+                $('#node-input-format').closest('.form-row').find('label span').text(nativeLabel('template'))
+                $('#node-input-passthru').closest('.form-row').find('label span').text(nativeLabel('pass-through'))
+
+                // if this groups parent is a subflow template, set the node-config-input-width and node-config-input-height up
+                // as typedInputs and hide the elementSizer (as it doesn't make sense for subflow templates)
+                if (RED.nodes.subflow(this.z)) {
+                    // change inputs from hidden to text & display them
+                    $('#node-input-width').attr('type', 'text')
+                    $('#node-input-height').attr('type', 'text')
+                    $('div.form-row.nr-db-ui-element-hide-in-subflow').hide()
+                    $('div.form-row.nr-db-ui-element-show-in-subflow').show()
+                } else {
+                    // not in a subflow, use the elementSizer
+                    $('div.form-row.nr-db-ui-element-hide-in-subflow').show()
+                    $('div.form-row.nr-db-ui-element-show-in-subflow').hide()
+                    $('#node-input-size').elementSizer({
+                        width: '#node-input-width',
+                        height: '#node-input-height',
+                        group: '#node-input-group'
+                    })
+                }
+
+                if (typeof this.storeOutMessages === 'undefined') {
+                    this.storeOutMessages = true
+                    $('#node-input-storeOutMessages').prop('checked', true)
+                }
+
+                if (typeof this.passthru === 'undefined') {
+                    this.passthru = true
+                    $('#node-input-passthru').prop('checked', true)
+                }
+
+                if (typeof this.templateScope === 'undefined') {
+                    this.templateScope = 'local'
+                    $templateScope.val(this.templateScope)
+                }
+
+                $templateScope.on('change', function () {
+                    $('#template-row-group, #template-row-page, #template-row-ui, #template-row-class').hide()
+
+                    switch ($templateScope.val()) {
+                    case 'site:style':
+                        $('#template-row-ui').show()
+                        that.editor.getSession().setMode('ace/mode/css')
+                        break
+                    case 'page:style':
+                        $('#template-row-page').show()
+                        that.editor.getSession().setMode('ace/mode/css')
+                        break
+                    case 'site:script':
+                        $('#template-row-ui').show()
+                        that.editor.getSession().setMode('ace/mode/javascript')
+                        break
+                    case 'page:script':
+                        $('#template-row-page').show()
+                        that.editor.getSession().setMode('ace/mode/javascript')
+                        break
+                    case 'widget:ui':
+                        $('#template-row-ui').show()
+                        that.editor.getSession().setMode('ace/mode/html')
+                        break
+                    case 'widget:page':
+                        $('#template-row-page').show()
+                        that.editor.getSession().setMode('ace/mode/html')
+                        break
+                    default:
+                        $('#template-row-group, #template-row-class').show()
+                        that.editor.getSession().setMode('ace/mode/html')
+                        break
+                    }
+                    resize.call(that)
+                })
+
+                this.editor = RED.editor.createEditor({
+                    id: 'node-input-format-editor',
+                    mode: 'ace/mode/html',
+                    value: $('#node-input-format').val()
+                })
+
+                RED.library.create({
+                    url: 'uitemplates', // where to get the data from
+                    type: 'ui-template', // the type of object the library is for
+                    editor: this.editor, // the field name the main text body goes to
+                    mode: 'ace/mode/html',
+                    fields: ['name']
+                })
+
+                this.editor.focus()
+
+                RED.popover.tooltip($('#node-template-expand-editor'), c_('label.expand'))
+
+                $('#node-template-expand-editor').on('click', function (e) {
+                    e.preventDefault()
+                    const value = that.editor.getValue()
+                    RED.editor.editText({
+                        mode: $templateScope.val() === 'global' ? 'css' : 'html',
+                        value,
+                        width: 'Infinity',
+                        cursor: that.editor.getCursorPosition(),
+                        complete: function (v, cursor) {
+                            that.editor.setValue(v, -1)
+                            that.editor.gotoLine(cursor.row + 1, cursor.column, false)
+                            setTimeout(function () { that.editor.focus() }, 300)
+                        }
+                    })
+                })
+
+                // use jQuery UI tooltip to convert the plain old title attribute to a nice tooltip
+                $('.ui-node-popover-title').tooltip({
+                    show: {
+                        effect: 'slideDown',
+                        delay: 150
+                    }
+                })
+
+                $templateScope.trigger('change') // trigger the change event to hide/show the group/dashboard row
+            },
+            oneditsave: function () {
+                const annot = this.editor.getSession().getAnnotations()
+                this.noerr = 0
+                $('#node-input-noerr').val(0)
+                for (let k = 0; k < annot.length; k++) {
+                    if (annot[k].type === 'error') {
+                        $('#node-input-noerr').val(annot.length)
+                        this.noerr = annot.length
+                    }
+                }
+                $('#node-input-format').val(this.editor.getValue())
+                this.editor.destroy()
+                delete this.editor
+
+                // ensure we only have one of group/page/dashboard defined
+                const scope = $('#node-input-templateScope').val()
+                if (scope === 'local') {
+                    $('#node-input-ui').val('_ADD_')
+                    $('#node-input-page').val('_ADD_')
+                } else if (scope === 'widget:page') {
+                    $('#node-input-ui').val('_ADD_')
+                    $('#node-input-group').val('_ADD_')
+                } else if (scope === 'widget:ui') {
+                    $('#node-input-page').val('_ADD_')
+                    $('#node-input-group').val('_ADD_')
+                } else if (scope === 'site:style') {
+                    $('#node-input-page').val('_ADD_')
+                    $('#node-input-group').val('_ADD_')
+                } else if (scope === 'page:style') {
+                    $('#node-input-ui').val('_ADD_')
+                    $('#node-input-group').val('_ADD_')
+                }
+            },
+            oneditcancel: function () {
+                this.editor.destroy()
+                delete this.editor
+            },
+            oneditresize: resize.bind(this)
+        })
+
+        function resize (size) {
+            const rows = $('#dialog-form>div:not(.node-text-editor-row)')
+            let fixRowsHeight = 0
+            for (let i = 0; i < rows.size(); i++) {
+                fixRowsHeight += $(rows[i]).height()
+            }
+            const dialogHeight = $('#dialog-form').height()
+            const height = dialogHeight - fixRowsHeight
+            $('.node-text-editor').css('height', height + 'px')
+            if (RED.editor.__debug === true) {
+                console.log('dialogHeight', dialogHeight, 'fixRowsHeight', fixRowsHeight, 'height', height, 'editorRow')
+            }
+            this.editor && this.editor.resize()
+        }
+    })()
+</script>
+
+<script type="text/html" data-template-name="ui-control-panel">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="node-red:common.label.name"></span></label>
+        <div style="display:inline-block; width:calc(100% - 105px)">
+            <input type="text" id="node-input-name" data-i18n="[placeholder]node-red:common.label.name">
+        </div>
+    </div>
+    <div class="form-row">
+        <label for="node-input-templateScope"><i class="fa fa-dot-circle-o"></i> <span data-i18n="ui-template.label.scope"></span></label>
+        <select style="width:76%" id="node-input-templateScope">
+            <option value="local" data-i18n="ui-template.label.widget-group"></option>
+            <option value="widget:page" data-i18n="ui-template.label.widget-page"></option>
+            <option value="widget:ui" data-i18n="ui-template.label.widget-ui"></option>
+            <option value="site:style" data-i18n="ui-template.label.site-style"></option>
+            <option value="page:style" data-i18n="ui-template.label.page-style"></option>
+            <!-- FUTURE? <option value="site:script" data-i18n="ui-template.label.site-script"></option>
+            <option value="page:script" data-i18n="ui-template.label.page-script"></option> -->
+        </select>
+    </div>
+    <div id="template-row-ui" class="form-row">
+        <label for="node-input-ui"><i class="fa fa-bookmark"></i> <span data-i18n="ui-template.label.ui"></label>
+        <input type="text" id="node-input-ui">
+    </div>
+    <div id="template-row-page" class="form-row">
+        <label for="node-input-page"><i class="fa fa-bookmark"></i> <span data-i18n="ui-template.label.page"></label>
+        <input type="text" id="node-input-page">
+    </div>
+    <div id="template-row-group" class="form-row">
+        <label for="node-input-group"><i class="fa fa-table"></i> <span data-i18n="ui-template.label.group"></label>
+        <input type="text" id="node-input-group">
+    </div>
+    <div class="form-row nr-db-ui-element-hide-in-subflow">
+        <label><i class="fa fa-object-group"></i> <span data-i18n="ui-base.label.size">Size</label>
+        <button class="editor-button" id="node-input-size"></button>
+    </div>
+    <div class="form-row nr-db-ui-element-show-in-subflow">
+        <label><i class="fa fa-arrows-h"></i> <span data-i18n="ui-base.label.width">Width</label>
+        <input type="hidden" id="node-input-width">
+    </div>
+    <div class="form-row nr-db-ui-element-show-in-subflow">
+        <label><i class="fa fa-arrows-v"></i> <span data-i18n="ui-base.label.height">Height</label>
+        <input type="hidden" id="node-input-height">
+    </div>
+    <div class="form-row nr-db-ui-element-show-in-subflow">
+        <label><i class="fa fa-arrows"></i> <span data-i18n="ui-base.label.order">Order</label>
+        <input type="text" id="node-input-order">
+    </div>
+    <!--<div class="form-row" id="template-row-size">
+        <label><i class="fa fa-object-group"></i> <span data-i18n="ui-template.label.size"></span></label>
+        <input type="hidden" id="node-input-width">
+        <input type="hidden" id="node-input-height">
+        <button class="editor-button" id="node-input-size"></button>
+    </div>-->
+    <div class="form-row">
+        <label for="node-input-className"><i class="fa fa-code"></i> <span data-i18n="ui-template.label.className"></label>
+        <div style="display: inline;">
+            <input style="width: 70%;" type="text" id="node-input-className" data-i18n="[placeholder]ui-template.label.classNamePlaceholder" style="flex-grow: 1;">
+            <a
+                data-html="true"
+                title="Dynamic Property: Send msg.class to append new classes to this widget. NOTE: classes set at runtime will be applied in addition to any class(es) set in the nodes class field."
+                class="red-ui-button ui-node-popover-title"
+                style="margin-left: 4px; cursor: help; font-size: 0.625rem; border-radius: 50%; width: 24px; height: 24px; display: inline-flex; justify-content: center; align-items: center;">
+                <i style="font-family: ui-serif;">fx</i>
+            </a>
+        </div>
+    </div>
+    <div class="form-row" style="margin-bottom:0px;">
+        <label for="node-input-format" style="width:110px;"><i class="fa fa-copy"></i> <span data-i18n="ui-template.label.template"></span></label>
+        <input type="hidden" id="node-input-format">
+        <button id="node-template-expand-editor" class="red-ui-button red-ui-button-small" style="float:right"><i class="fa fa-expand"></i></button>
+    </div>
+    <div class="form-row node-text-editor-row" style="display: block;">
+        <div style="height:250px; min-height:100px" class="node-text-editor" id="node-input-format-editor" ></div>
+    </div>
+    <div id="template-pass-store">
+        <div class="form-row" style="margin-bottom:0px;">
+            <input type="checkbox" id="node-input-passthru" style="display:inline-block; margin-left:8px; width:auto; vertical-align:top;">
+            <label for="node-input-passthru" style="width:70%;"> <span data-i18n="ui-template.label.pass-through"></span></label>
+        </div>
+    </div>
+    <!--<div class="form-row" style="margin-bottom:0px;">
+            <input type="checkbox" id="node-input-storeOutMessages" style="display:inline-block; margin-left:8px; width:auto; vertical-align:top;">
+            <label for="node-input-storeOutMessages" style="width:70%;"> <span data-i18n="ui-template.label.store-state"></span></label>
+        </div>
+        <div class="form-row" style="margin-bottom:0px;">
+            <input type="checkbox" id="node-input-resendOnRefresh" style="display:inline-block; margin-left:8px; width:auto; vertical-align:top;">
+            <label for="node-input-resendOnRefresh" style="width:70%;"> <span data-i18n="ui-template.label.resend"></span></label>
+        </div>
+    </div> -->
+</script>

package/control-panel.js

@@ -0,0 +1,68 @@
+let statestore
+
+function getStateStore (RED) {
+  if (statestore) return statestore
+  try {
+    const dashboardPath = require.resolve('@flowfuse/node-red-dashboard/nodes/store/state.js', {
+      paths: [RED.settings.userDir || process.cwd()]
+    })
+    statestore = require(dashboardPath)
+  } catch (error) {
+    RED.log.warn('ui-control-panel: Dashboard 2 state store is unavailable')
+  }
+  return statestore
+}
+
+module.exports = function (RED) {
+  function ControlPanel (config) {
+    const node = this
+    RED.nodes.createNode(node, config)
+
+    let parentNode
+
+    const events = {
+      onAction: true,
+      beforeSend (msg) {
+        if (msg && msg.ui_update && statestore) {
+          const parent = parentNode
+          if (parent && typeof msg.ui_update.format !== 'undefined') {
+            statestore.set(parent.getBase(), node, msg, 'format', msg.ui_update.format)
+          }
+        }
+        return msg
+      }
+    }
+
+    let retryTimer
+    let attempts = 0
+    let registered = false
+
+    // Config nodes can be created after this node during a full flow deploy.
+    // Retry briefly so a valid group/page is not missed during startup.
+    const registerWidget = () => {
+      if (registered) return
+      const group = config.group ? RED.nodes.getNode(config.group) : null
+      const page = !group && config.page ? RED.nodes.getNode(config.page) : null
+      const ui = !group && !page && config.ui ? RED.nodes.getNode(config.ui) : null
+      if (!group && !page && !ui && attempts++ < 40) {
+        retryTimer = setTimeout(registerWidget, 25)
+        return
+      }
+
+      // Keep the custom editor type in Dashboard's namespace, but use Dashboard's built-in renderer.
+      const widgetConfig = { ...config, type: 'ui-template' }
+      parentNode = group || page || ui
+      if (group) group.register(node, widgetConfig, events)
+      else if (page) page.register(null, node, widgetConfig, events)
+      else if (ui) ui.register(null, null, node, widgetConfig, events)
+      registered = Boolean(parentNode)
+    }
+
+    registerWidget()
+    node.on('close', () => clearTimeout(retryTimer))
+
+  }
+
+  getStateStore(RED)
+  RED.nodes.registerType('ui-control-panel', ControlPanel)
+}

package/gateway.cjs

@@ -0,0 +1,109 @@
+const crypto = require('node:crypto')
+const PREFIX = '/room-panel-api'
+const defaults = () => ({scene:'meeting',display:true,source:'无线投屏',volume:42,muted:false,light:80,curtains:75,temperature:23,meeting:false})
+const fields = {'display/power':'display','display/source':'source','audio/volume':'volume','audio/mute':'muted','lighting/brightness':'light','room/curtain':'curtains','climate/temperature':'temperature','room/scene':'scene','room/meeting':'meeting'}
+const ranges = {volume:[0,100],light:[0,100],curtains:[0,100],temperature:[16,30]}
+const presets = {
+  focus:{light:85,curtains:80,volume:25,display:true},
+  cinema:{light:20,curtains:10,volume:65,display:true},
+  social:{light:70,curtains:80,volume:40,display:true},
+  unwind:{light:35,curtains:80,volume:32,display:true},
+  meeting:{light:80,curtains:75,volume:42,source:'无线投屏',display:true},
+  present:{light:30,curtains:10,volume:55,source:'HDMI 1',display:true},
+  video:{light:65,curtains:35,volume:65,source:'视频会议',display:true},
+  relax:{light:45,curtains:100,volume:20,source:'无线投屏',display:false}
+}
+function valid(key, value) {
+  if(ranges[key]) return typeof value === 'number' && Number.isFinite(value) && value >= ranges[key][0] && value <= ranges[key][1]
+  if(['display','muted','meeting'].includes(key)) return typeof value === 'boolean'
+  if(key === 'source') return ['无线投屏','HDMI 1','HDMI 2','视频会议'].includes(value)
+  if(key === 'scene') return ['custom',...Object.keys(presets)].includes(value)
+  return false
+}
+function createGateway({username,password,room='room-01',onCommand=()=>{},secureCookie=false,prefix}) {
+  const routePrefix=prefix||PREFIX+'/regions/'+encodeURIComponent(room)
+  if(!username || typeof password !== 'string' || password.length < 12) throw Error('Set a username and password of at least 12 characters')
+  const salt=crypto.randomBytes(16), hash=crypto.scryptSync(password,salt,32)
+  const sessions=new Map(), attempts=new Map()
+  let state=defaults(), revision=0, closed=false
+  function feedback(msg) {
+    if(msg.room!==room || msg.kind!=='state') throw Error('Feedback requires matching room and kind=state')
+    const values=msg.topic==='room/state' ? msg.payload : fields[msg.topic] ? {[fields[msg.topic]]:msg.payload} : null
+    if(!values || typeof values!=='object' || Array.isArray(values) || !Object.keys(values).length || Object.entries(values).some(([k,v])=>!valid(k,v))) throw Error('Invalid feedback')
+    state={...state,...values};revision++
+  }
+  function reply(res,status,data,headers={}) {
+    res.writeHead(status,{'Content-Type':'application/json; charset=utf-8','Cache-Control':'no-store','X-Content-Type-Options':'nosniff',...headers})
+    res.end(JSON.stringify(data))
+  }
+  async function body(req) {
+    if(!String(req.headers['content-type']||'').startsWith('application/json')) throw Error('JSON required')
+    if(req.body !== undefined) {
+      if(Buffer.isBuffer(req.body)) return JSON.parse(req.body.toString('utf8'))
+      if(typeof req.body === 'string') return JSON.parse(req.body)
+      if(req.body&&typeof req.body==='object'&&Object.keys(req.body).length)return req.body
+    }
+    let raw='';for await(const chunk of req){raw+=chunk;if(Buffer.byteLength(raw)>8192)throw Error('Request too large')}
+    return JSON.parse(raw)
+  }
+  const cookieName='room_panel_'+Buffer.from(room).toString('hex')
+  const cookie=(token,maxAge)=>`${cookieName}=${token}; Path=${routePrefix}; HttpOnly; SameSite=Strict; Max-Age=${maxAge}${secureCookie?'; Secure':''}`
+  async function handler(req,res) {
+    const path=new URL(req.url,'http://localhost').pathname
+    if(!path.startsWith(routePrefix+'/')) return false
+    if(closed){reply(res,503,{error:'Gateway unavailable'});return true}
+    try {
+      const now=Date.now()
+      for(const [id,s]of sessions)if(s.expiry<now)sessions.delete(id)
+      for(const [ip,a]of attempts)if(a.until<now)attempts.delete(ip)
+      if(req.method==='POST') {
+        const origin=req.headers.origin
+        if(!origin || new URL(origin).host!==req.headers.host){reply(res,403,{error:'Origin rejected'});return true}
+      }
+      if(path===routePrefix+'/login' && req.method==='POST') {
+        const ip=req.socket.remoteAddress||'unknown', entry=attempts.get(ip)||{count:0,until:now+60000}
+        if(entry.count>=10 || attempts.size>1000){reply(res,429,{error:'Too many attempts. Wait one minute.'});return true}
+        entry.count++;attempts.set(ip,entry)
+        const data=await body(req)
+        const supplied=String(data.password||'')
+        if(supplied.length>256){reply(res,401,{error:'Invalid credentials'});return true}
+        const test=await new Promise((resolve,reject)=>crypto.scrypt(supplied,salt,32,(err,key)=>err?reject(err):resolve(key)))
+        const passwordMatch=crypto.timingSafeEqual(test,hash), usernameMatch=data.username===username
+        if(!passwordMatch||!usernameMatch){reply(res,401,{error:'Invalid credentials'});return true}
+        if(sessions.size>=100){reply(res,503,{error:'Session limit reached'});return true}
+        attempts.delete(ip)
+        const token=crypto.randomBytes(32).toString('hex'),csrf=crypto.randomBytes(24).toString('hex')
+        sessions.set(token,{csrf,expiry:now+8*3600000})
+        reply(res,200,{room,username,csrf},{'Set-Cookie':cookie(token,28800)});return true
+      }
+      const token=String(req.headers.cookie||'').split(';').map(v=>v.trim()).find(v=>v.startsWith(cookieName+'='))?.split('=')[1]
+      const session=sessions.get(token)
+      if(!session){reply(res,401,{error:'Login required'});return true}
+      if(req.method==='POST' && req.headers['x-room-csrf']!==session.csrf){reply(res,403,{error:'CSRF rejected'});return true}
+      if(path===routePrefix+'/session' && req.method==='GET'){reply(res,200,{room,username,csrf:session.csrf});return true}
+      if(path===routePrefix+'/state' && req.method==='GET') {
+        if(new URL(req.url,'http://localhost').searchParams.get('room')!==room){reply(res,403,{error:'Region denied'});return true}
+        reply(res,200,{room,kind:'state',topic:'room/state',payload:state,revision});return true
+      }
+      if(path===routePrefix+'/logout' && req.method==='POST'){sessions.delete(token);reply(res,200,{ok:true},{'Set-Cookie':cookie('',0)});return true}
+      if(path===routePrefix+'/command' && req.method==='POST') {
+        const data=await body(req)
+        if(data.room!==room){reply(res,403,{error:'Region denied'});return true}
+        const key=fields[data.topic]
+        if(data.topic==='room/reset' ? data.payload!==true : !key || !valid(key,data.payload) || (key==='scene' && !presets[data.payload])){reply(res,400,{error:'Invalid control value'});return true}
+        let next={...state}
+        if(data.topic==='room/reset')next=defaults()
+        else if(key==='scene')next={...next,...presets[data.payload],scene:data.payload}
+        else {next[key]=data.payload;if(['light','curtains'].includes(key))next.scene='custom';if(key==='meeting'&&data.payload)next.display=true}
+        // Identity and the complete command state are rebuilt on the server.
+        onCommand({room,topic:data.topic,payload:data.payload,kind:'command',user:username,state:next})
+        state=next;revision++
+        reply(res,200,{ok:true,revision});return true
+      }
+      reply(res,404,{error:'Not found'})
+    }catch(err){reply(res,400,{error:'Invalid request'})}
+    return true
+  }
+  return {handler,feedback,close(){closed=true;sessions.clear();attempts.clear()}}
+}
+module.exports={createGateway,PREFIX}

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "node-red-contrib-room-tools",
+  "version": "1.4.2",
+  "description": "Room panel message generator and authenticated region gateway for Node-RED and MUSE Automator",
+  "license": "UNLICENSED",
+  "keywords": ["node-red"],
+  "files": ["gateway.cjs", "room-gateway.js", "room-gateway.html", "room-message.js", "room-message.html", "control-panel.js", "control-panel.html", "README.md"],
+  "node-red": {
+    "nodes": {
+      "room-gateway": "room-gateway.js",
+      "room-message": "room-message.js",
+      "ui-control-panel": "control-panel.js"
+    }
+  }
+}

package/room-gateway.html

@@ -0,0 +1,20 @@
+<script type="text/javascript">
+RED.nodes.registerType('room-gateway',{
+ category:'Room Tools',color:'#a8d5c3',defaults:{name:{value:''},room:{value:'room-01',required:true},secureCookie:{value:false}},
+ credentials:{username:{type:'text'},password:{type:'password'}},inputs:1,outputs:1,icon:'font-awesome/fa-lock',
+ paletteLabel:'区域权限网关',label:function(){return this.name||'区域权限网关'},inputLabels:'设备反馈 kind=state',outputLabels:'已验证的控制指令'
+})
+</script>
+<script type="text/html" data-template-name="room-gateway">
+<div class="form-row"><label for="node-input-name">名称</label><input id="node-input-name" type="text"></div>
+<div class="form-row"><label for="node-input-room">区域 ID</label><input id="node-input-room" type="text"></div>
+<div class="form-row"><label for="node-input-username">登录账号</label><input id="node-input-username" type="text" autocomplete="off"></div>
+<div class="form-row"><label for="node-input-password">登录密码</label><input id="node-input-password" type="password" autocomplete="new-password"></div>
+<div class="form-row"><label for="node-input-secureCookie">HTTPS</label><input id="node-input-secureCookie" type="checkbox" style="width:auto">仅通过 HTTPS 发送会话 Cookie</div>
+<p>密码至少 12 个字符。每个区域 ID 只能部署一个网关，账号只能访问该网关配置的区域。</p>
+</script>
+<script type="text/html" data-help-name="room-gateway">
+<p>Template 通过同源 /room-panel-api/regions/&lt;区域 ID&gt; 登录、发送控制请求和读取反馈。Template 输出不再用于控制设备。</p>
+<p>本节点输出已授权消息，连接原来的 Switch。设备反馈必须含 room、kind: state、topic 和 payload，接入本节点输入，不接 Template。</p>
+<p>状态包含最近接受的目标值，实际设备反馈可覆盖。Node-RED 编辑器属于管理员入口，部署时应独立保护。生产 iPad 访问请配置 HTTPS 并启用 HTTPS Cookie。</p>
+</script>

package/room-gateway.js

@@ -0,0 +1,57 @@
+const {createGateway,PREFIX}=require('./gateway.cjs')
+const fs=require('node:fs')
+const path=require('node:path')
+
+function storedCredentials(RED,nodeId){
+  const files=[]
+  const add=file=>{if(file&&!files.includes(file))files.push(file)}
+  const flowFile=RED.settings.flowFile
+  const credentialsFile=RED.settings.credentialsFile
+  if(path.isAbsolute(String(credentialsFile||'')))add(credentialsFile)
+  if(path.isAbsolute(String(flowFile||''))){
+    add(path.join(path.dirname(flowFile),path.basename(flowFile,path.extname(flowFile))+'_cred.json'))
+    if(credentialsFile)add(path.resolve(path.dirname(flowFile),credentialsFile))
+  }
+  const projects=path.join(RED.settings.userDir||'', 'projects')
+  try{
+    for(const entry of fs.readdirSync(projects,{withFileTypes:true})){
+      if(!entry.isDirectory())continue
+      add(path.join(projects,entry.name,'flow_cred.json'))
+    }
+  }catch{}
+  for(const file of files){
+    try{
+      const credentials=JSON.parse(fs.readFileSync(file,'utf8'))[nodeId]
+      if(credentials?.username&&typeof credentials.password==='string')return credentials
+    }catch{}
+  }
+  return null
+}
+
+module.exports=function(RED){
+  const active=new Map()
+  RED.httpNode.use((req,res,next)=>{
+    const route=new URL(req.url,'http://localhost').pathname
+    const match=route.match(new RegExp('^'+PREFIX+'/regions/([^/]+)/'))
+    if(!match)return next()
+    const room=decodeURIComponent(match[1])
+    const gateway=active.get(room)
+    if(!gateway)return res.status(503).json({error:'Region gateway not configured'})
+    gateway.handler(req,res).then(handled=>{if(!handled)res.status(404).json({error:'Not found'})}).catch(next)
+  })
+  function Gateway(config){
+    RED.nodes.createNode(this,config)
+    const room=config.room||'room-01'
+    if(!/^[a-zA-Z0-9_-]+$/.test(room)){this.error('Invalid room identifier');return}
+    if(active.has(room)){this.status({fill:'red',shape:'ring',text:'Duplicate room gateway'});return}
+    let gateway
+    const credentials=this.credentials?.username&&this.credentials?.password?this.credentials:storedCredentials(RED,this.id)||{}
+    try{gateway=createGateway({username:credentials.username,password:credentials.password,room,secureCookie:!!config.secureCookie,onCommand:msg=>this.send(msg)})}
+    catch(err){this.status({fill:'red',shape:'ring',text:err.message});this.error(err.message);return}
+    active.set(room,gateway)
+    this.status({fill:'green',shape:'dot',text:'Access protected: '+(config.room||'room-01')})
+    this.on('input',(msg,send,done)=>{try{gateway.feedback(msg);if(done)done()}catch(err){if(done)done(err);else this.error(err,msg)}})
+    this.on('close',()=>{gateway.close();if(active.get(room)===gateway)active.delete(room)})
+  }
+  RED.nodes.registerType('room-gateway',Gateway,{credentials:{username:{type:'text'},password:{type:'password'}}})
+}

package/room-message.html

@@ -0,0 +1,56 @@
+<script type="text/javascript">
+RED.nodes.registerType('room-message', {
+  category: 'Room Tools',
+  color: '#a8d5c3',
+  defaults: {
+    name: { value: '' },
+    topic: { value: 'audio/volume', required: true },
+    value: { value: '65' },
+    room: { value: 'room-01', required: true },
+    useInput: { value: false }
+  },
+  inputs: 1,
+  outputs: 1,
+  icon: 'font-awesome/fa-sliders',
+  paletteLabel: '面板消息',
+  label: function () { return this.name || '面板消息 · ' + this.topic },
+  inputLabels: '触发消息，或使用输入 payload',
+  outputLabels: 'Template 状态反馈',
+  oneditprepare: function () {
+    const hints = {
+      'audio/volume': '0 ~ 100', 'lighting/brightness': '0 ~ 100',
+      'room/curtain': '0 ~ 100', 'climate/temperature': '16 ~ 30',
+      'display/power': 'true / false', 'audio/mute': 'true / false', 'room/meeting': 'true / false',
+      'display/source': '无线投屏 / HDMI 1 / HDMI 2 / 视频会议',
+      'room/scene': 'meeting / present / video / relax / custom'
+    }
+    function update() {
+      $('#room-message-hint').text(hints[$('#node-input-topic').val()] || '')
+      $('#node-input-value').prop('disabled', $('#node-input-useInput').prop('checked'))
+    }
+    $('#node-input-topic, #node-input-useInput').on('change', update)
+    update()
+  }
+})
+</script>
+<script type="text/html" data-template-name="room-message">
+  <div class="form-row"><label for="node-input-name">名称</label><input id="node-input-name" type="text" placeholder="可选" /></div>
+  <div class="form-row"><label for="node-input-room">房间 ID</label><input id="node-input-room" type="text" /></div>
+  <div class="form-row"><label for="node-input-topic">控件</label><select id="node-input-topic" style="width:70%">
+    <option value="audio/volume">音量</option><option value="audio/mute">静音</option>
+    <option value="display/power">显示电源</option><option value="display/source">信号源</option>
+    <option value="lighting/brightness">灯光亮度</option><option value="room/curtain">窗帘开度</option>
+    <option value="climate/temperature">目标温度</option><option value="room/scene">场景状态</option>
+    <option value="room/meeting">会议状态</option>
+  </select></div>
+  <div class="form-row"><label for="node-input-value">设定值</label><input id="node-input-value" type="text" /></div>
+  <div class="form-row"><span style="margin-left:100px" id="room-message-hint"></span></div>
+  <div class="form-row"><label for="node-input-useInput">输入值</label><input id="node-input-useInput" type="checkbox" style="width:auto" /> 使用收到的 msg.payload</div>
+</script>
+<script type="text/html" data-help-name="room-message">
+  <p>收到任意输入后，为会议室 Template 生成状态反馈消息。</p>
+  <p>连接：Inject → 面板消息 → Template。默认发送音量 65。</p>
+  <p>输出包含 topic、payload、kind: state、room。数值和布尔值自动转换并校验；非法值报错，不输出。</p>
+  <p>勾选“使用收到的 msg.payload”后，可从上游动态传入值。其他输入属性保留，旧 state 快照移除。</p>
+  <p>场景状态仅回填场景名称，不执行场景联动；本节点不生成重置命令。</p>
+</script>

package/room-message.js

@@ -0,0 +1,43 @@
+module.exports = function (RED) {
+  const types = {
+    'audio/volume': [0, 100], 'lighting/brightness': [0, 100],
+    'room/curtain': [0, 100], 'climate/temperature': [16, 30],
+    'display/power': 'bool', 'audio/mute': 'bool', 'room/meeting': 'bool',
+    'display/source': ['无线投屏', 'HDMI 1', 'HDMI 2', '视频会议'],
+    'room/scene': ['meeting', 'present', 'video', 'relax', 'custom']
+  }
+  function RoomMessage(config) {
+    RED.nodes.createNode(this, config)
+    const node = this
+    node.on('input', function (msg, send, done) {
+      send = send || node.send.bind(node)
+      done = done || function (err) { if (err) node.error(err, msg) }
+      try {
+        const rule = types[config.topic]
+        if (!rule) throw new Error('请选择有效的控件')
+        const raw = config.useInput ? msg.payload : config.value
+        let value = raw
+        if (rule === 'bool') {
+          if (![true, false, 'true', 'false'].includes(raw)) throw new Error('开关值必须为 true 或 false')
+          value = raw === true || raw === 'true'
+        } else if (typeof rule[0] === 'number') {
+          if (!['number', 'string'].includes(typeof raw) || String(raw).trim() === '') throw new Error('请输入数字')
+          value = Number(raw)
+          if (!Number.isFinite(value) || value < rule[0] || value > rule[1]) throw new Error('数值范围应为 ' + rule.join(' ~ '))
+        } else if (!rule.includes(raw)) throw new Error('可用值: ' + rule.join(', '))
+        msg.topic = config.topic
+        msg.payload = value
+        msg.kind = 'state'
+        msg.room = config.room || 'room-01'
+        delete msg.state
+        node.status({ fill: 'green', shape: 'dot', text: config.topic + ': ' + value })
+        send(msg)
+        done()
+      } catch (err) {
+        node.status({ fill: 'red', shape: 'ring', text: err.message })
+        done(err)
+      }
+    })
+  }
+  RED.nodes.registerType('room-message', RoomMessage)
+}