node-red-contrib-dmx-for-ha 0.1.0

package/nodes/ha-mqtt-relay.html

@@ -0,0 +1,326 @@
+<!-- ============================================================
+     ha-mqtt-relay — Relay Node Editor
+     Package: node-red-contrib-dmx-for-ha
+     Author:  DeSwaggy — Discord: @deswaggy
+     ============================================================ -->
+
+<script type="text/javascript">
+
+    RED.nodes.registerType('ha-mqtt-relay', {
+        category:     'DMX for HA',
+        color:        '#e67e22',
+        icon:         'font-awesome/fa-toggle-on',
+        inputs:       1,
+        outputs:      0,
+        inputLabels:  ['Input'],
+        paletteLabel: 'Relay',
+
+        defaults: {
+            name:           { value: '' },
+            config:         { value: '', type: 'ha-mqtt-config', required: true },
+            // Fixture identity
+            uidPrefix:      { value: 'P',         required: true },
+            uid:            { value: '',          required: true },
+            uidPostfix:     { value: '' },
+            deviceType:     { value: '' },
+            // Location
+            area:           { value: 'Area 52' },
+            situation:      { value: 'in' },
+            subLocation:    { value: '' },
+            // Controller
+            controllerNum:  { value: '1',         required: true },
+            relayNum:       { value: '',          required: true },
+            mqttSegment:    { value: 'relay' },
+            // Options
+            haIcon:         { value: 'mdi:toggle-switch' },
+            showEffects:    { value: false },
+            defaultState:   { value: 'OFF' },
+        },
+
+        label: function () {
+            if (this.name) return this.name;
+            const prefix  = this.uidPrefix  || 'P';
+            const id      = this.uid        || '?';
+            const postfix = this.uidPostfix || '';
+            return prefix + '-' + id + postfix;
+        },
+
+        labelStyle: function () {
+            return this.name ? 'node_label_italic' : '';
+        },
+
+        oneditprepare: function () {
+            const node = this;
+            const areas = [
+                { v: 'Area 52',             l: 'TBC' },
+                { v: 'Attic Roof',          l: 'Attic Roof' },
+                { v: 'Backyard',            l: 'Backyard' },
+                { v: 'Balcony',             l: 'Balcony' },
+                { v: 'Bathroom',            l: 'Bathroom' },
+                { v: 'Bedroom 1',           l: 'Bedroom 1' },
+                { v: 'Bedroom 2',           l: 'Bedroom 2' },
+                { v: 'Bedroom 3',           l: 'Bedroom 3' },
+                { v: 'Bedroom 4',           l: 'Bedroom 4' },
+                { v: 'Carport',             l: 'Carport' },
+                { v: 'Cellar',              l: 'Cellar' },
+                { v: 'Dining',              l: 'Dining' },
+                { v: 'Driveway',            l: 'Driveway' },
+                { v: 'Entry',               l: 'Entry' },
+                { v: 'Garage',              l: 'Garage' },
+                { v: 'Gym',                 l: 'Gym' },
+                { v: 'Hallway',             l: 'Hallway' },
+                { v: 'Kitchen',             l: 'Kitchen' },
+                { v: 'Laundry',             l: 'Laundry' },
+                { v: 'Link Bridge (Upper)', l: 'Link Bridge Upper' },
+                { v: 'Link Bridge (Lower)', l: 'Link Bridge Lower' },
+                { v: 'Living',              l: 'Living' },
+                { v: 'Media',               l: 'Media' },
+                { v: 'Office',              l: 'Office' },
+                { v: 'Pantry',              l: 'Pantry' },
+                { v: 'Pass Over',           l: 'Pass Over' },
+                { v: 'Pass Under',          l: 'Pass Under' },
+                { v: 'Passageway',          l: 'Passageway' },
+                { v: 'Pool',                l: 'Pool' },
+                { v: 'Portico',             l: 'Portico' },
+                { v: 'PowderRoom',          l: 'PowderRoom' },
+                { v: 'Reading',             l: 'Reading' },
+                { v: 'Rumpus',              l: 'Rumpus' },
+                { v: 'Spa',                 l: 'Spa' },
+                { v: 'Stairs',              l: 'Stairs' },
+                { v: 'Store',               l: 'Store' },
+                { v: 'SubFloor',            l: 'SubFloor' },
+                { v: 'Terrace',             l: 'Terrace' },
+            ];
+            const subAreas = [
+                { v: '',              l: 'None' },
+                { v: 'Balcony',       l: 'Balcony' },
+                { v: 'Bed (North)',   l: 'Bed North' },
+                { v: 'Bed (South)',   l: 'Bed South' },
+                { v: 'Bed (East)',    l: 'Bed East' },
+                { v: 'Bed (West)',    l: 'Bed West' },
+                { v: 'Ceiling',       l: 'Ceiling' },
+                { v: 'Dress',         l: 'Dress' },
+                { v: 'Ensuite',       l: 'Ensuite' },
+                { v: 'Exterior',      l: 'Exterior' },
+                { v: 'Ground Floor',  l: 'Ground Floor' },
+                { v: '1st Floor',     l: '1st Floor' },
+                { v: 'Landing',       l: 'Landing' },
+                { v: 'Office',        l: 'Office' },
+                { v: 'Stairs',        l: 'Stairs' },
+                { v: 'WIR',           l: 'WIR' },
+                { v: '(North)',        l: 'North' },
+                { v: '(South)',        l: 'South' },
+                { v: '(East)',         l: 'East' },
+                { v: '(West)',         l: 'West' },
+                { v: 'Void',          l: 'Void' },
+            ];
+
+            const areaEl = $('#node-input-area');
+            areaEl.empty();
+            areas.forEach(function (a) {
+                areaEl.append($('<option>').val(a.v).text(a.l)
+                    .prop('selected', a.v === node.area));
+            });
+
+            const subEl = $('#node-input-subLocation');
+            subEl.empty();
+            subAreas.forEach(function (s) {
+                subEl.append($('<option>').val(s.v).text(s.l)
+                    .prop('selected', s.v === node.subLocation));
+            });
+        },
+    });
+
+</script>
+
+<script type="text/html" data-template-name="ha-mqtt-relay">
+
+    <div class="form-row">
+        <label for="node-input-name">
+            <i class="fa fa-tag"></i> Name
+        </label>
+        <input type="text" id="node-input-name"
+               placeholder="Optional — defaults to fixture ID e.g. P-51" />
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-config">
+            <i class="fa fa-cog"></i> Config
+        </label>
+        <input type="text" id="node-input-config" />
+    </div>
+
+    <hr/>
+
+    <!-- ── RELAY (* Required) ────────────────────────────────── -->
+    <div class="form-row">
+        <label style="width:100%; font-weight:bold; color:#999; font-size:0.85em; text-transform:uppercase; letter-spacing:0.05em;">
+            <i class="fa fa-toggle-on"></i> Relay &nbsp;<span style="color:#e74c3c">* Required</span>
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-deviceType">
+            <i class="fa fa-lightbulb-o"></i> Device Type
+        </label>
+        <input type="text" id="node-input-deviceType"
+               placeholder="e.g. Exhaust Fan, Pump, Socket"
+               style="width:55%" />
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-uidPrefix">
+            <i class="fa fa-tv"></i> Fixture ID
+        </label>
+        <select id="node-input-uidPrefix" style="width:55px">
+            <option value="P">P</option>
+            <option value="L">L</option>
+        </select>
+        &nbsp;-&nbsp;
+        <input type="text" id="node-input-uid"
+               placeholder="51" style="width:70px" />
+        &nbsp;
+        <select id="node-input-uidPostfix" style="width:65px">
+            <option value="">(none)</option>
+            <option value="-A">-A</option>
+            <option value="-B">-B</option>
+            <option value="-C">-C</option>
+            <option value="-D">-D</option>
+        </select>
+        <span style="margin-left:8px; color:#999; font-size:0.85em;">
+            Prefix — Plan ID — Channel
+        </span>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-area">
+            <i class="fa fa-map-marker"></i> Area
+        </label>
+        <select id="node-input-area" style="width:55%"></select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-situation">
+            <i class="fa fa-compass"></i> Situation
+        </label>
+        <select id="node-input-situation" style="width:55%">
+            <option value="in">in</option>
+            <option value="above">above</option>
+            <option value="below">below</option>
+            <option value="outside">outside</option>
+            <option value="throughout">throughout</option>
+            <option value="under">under</option>
+            <option value="over">over</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-subLocation">
+            <i class="fa fa-map-marker"></i> Sub-Area
+        </label>
+        <select id="node-input-subLocation" style="width:55%"></select>
+    </div>
+
+    <hr/>
+
+    <!-- ── CONTROLLER ────────────────────────────────────────── -->
+    <div class="form-row">
+        <label style="width:100%; font-weight:bold; color:#999; font-size:0.85em; text-transform:uppercase; letter-spacing:0.05em;">
+            <i class="fa fa-sort-numeric-asc"></i> Controller
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-controllerNum">
+            <i class="fa fa-sort-numeric-asc"></i> Controller
+        </label>
+        <input type="number" id="node-input-controllerNum"
+               min="1" style="width:70px" />
+        &nbsp;&nbsp;
+        <label for="node-input-relayNum" style="width:auto">
+            Relay number
+        </label>
+        <input type="number" id="node-input-relayNum"
+               min="1" style="width:70px" />
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-mqttSegment">
+            <i class="fa fa-exchange"></i> MQTT segment
+        </label>
+        <input type="text" id="node-input-mqttSegment"
+               style="width:120px" placeholder="relay" />
+        <span style="margin-left:8px; color:#999; font-size:0.85em;">
+            Topic: {siteId}/{zone}/{controller}/<strong>relay</strong>/{relayNum}
+        </span>
+    </div>
+
+    <hr/>
+
+    <!-- ── OPTIONS ───────────────────────────────────────────── -->
+    <div class="form-row">
+        <label style="width:100%; font-weight:bold; color:#999; font-size:0.85em; text-transform:uppercase; letter-spacing:0.05em;">
+            <i class="fa fa-sliders"></i> Options
+        </label>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-haIcon">
+            <i class="fa fa-image"></i> HA Icon
+        </label>
+        <input type="text" id="node-input-haIcon"
+               placeholder="mdi:toggle-switch" style="width:55%" />
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-defaultState">
+            <i class="fa fa-toggle-off"></i> Default state
+        </label>
+        <select id="node-input-defaultState" style="width:100px">
+            <option value="OFF">OFF</option>
+            <option value="ON">ON</option>
+        </select>
+    </div>
+
+    <div class="form-row">
+        <label>&nbsp;</label>
+        <input type="checkbox" id="node-input-showEffects"
+               style="width:auto; margin-right:8px" />
+        <label for="node-input-showEffects" style="width:auto">
+            Show effects in HA
+        </label>
+    </div>
+
+</script>
+
+<script type="text/html" data-help-name="ha-mqtt-relay">
+    <p>
+        Controls a 230V relay via Home Assistant and MQTT.
+        Publishes integer <code>1</code> (ON) or <code>0</code> (OFF) to
+        the relay controller. Not related to DMX — entirely separate control path.
+    </p>
+
+    <h3>Setup</h3>
+    <ol>
+        <li>Select your <strong>Config</strong> node</li>
+        <li>Set <strong>Fixture ID</strong> — Prefix (P for power), Plan ID, optional channel</li>
+        <li>Set <strong>Controller</strong> and <strong>Relay number</strong></li>
+        <li>Deploy — relay entity appears in HA</li>
+    </ol>
+
+    <h3>Relay payload</h3>
+    <p>
+        Publishes integer <code>1</code> or <code>0</code> — not a string,
+        not JSON. Most relay controller firmware expects a numeric payload.
+    </p>
+
+    <h3>MQTT topic</h3>
+    <pre>{siteId}/{zone}/{controller}/relay/{relayNum}</pre>
+
+    <h3>Effects</h3>
+    <p>
+        Flash short, flash long, and strobe are available.
+        Strobe enforces a 500ms minimum interval to protect
+        mechanical relay contacts. SSRs do not have this limitation.
+    </p>
+</script>

package/nodes/ha-mqtt-relay.js

@@ -0,0 +1,289 @@
+// ============================================================
+// ha-mqtt-relay — 230V Relay Node Runtime
+// Package: node-red-contrib-dmx-for-ha
+// Author:  DeSwaggy — Discord: @deswaggy
+//
+// NOT related to DMX. Entirely separate control path.
+// Publishes integer 1 (ON) or 0 (OFF) to relay controller.
+// ============================================================
+
+module.exports = function (RED) {
+
+    function HaMqttRelayNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        // ── Config & broker ───────────────────────────────────────
+        const cfg = RED.nodes.getNode(config.config);
+        if (!cfg) { node.error('Relay: no config node selected'); return; }
+
+        const broker = RED.nodes.getNode(cfg.broker);
+        if (!broker) { node.error('Relay: no MQTT broker in config'); return; }
+
+        broker.register(node);
+
+        // ── Node settings ─────────────────────────────────────────
+        const S = {
+            uidPrefix:     config.uidPrefix    || 'P',
+            uid:           config.uid          || '',
+            uidPostfix:    config.uidPostfix    || '',
+            deviceType:    config.deviceType    || '',
+            area:          config.area          || '',
+            situation:     config.situation      || 'in',
+            subLocation:   config.subLocation    || '',
+            controllerNum: config.controllerNum  || '1',
+            relayNum:      config.relayNum       || '',
+            mqttSegment:   config.mqttSegment    || 'relay',
+            haIcon:        config.haIcon         || 'mdi:toggle-switch',
+            showEffects:   config.showEffects    !== false,
+            defaultState:  config.defaultState   || 'OFF',
+            flashShort:    cfg.flashShort,
+            flashLong:     cfg.flashLong,
+            diskDelay:     cfg.diskDelay,
+        };
+
+        const fixtureId    = `${S.uidPrefix}-${S.uid}${S.uidPostfix}`;
+        const objectId     = `${S.uidPrefix}_${S.uid}${S.uidPostfix}`.toLowerCase().replace(/[^a-z0-9_]/g, '_');
+        const fixtureTopic = `${cfg.discoveryPrefix}/light/${fixtureId}`;
+        const cfgTopic     = `${fixtureTopic}/${cfg.configTopic}`;
+        const statTopic    = `${fixtureTopic}/${cfg.stateTopic}`;
+        const cmdTopic     = `${fixtureTopic}/${cfg.commandTopic}`;
+        const relayTopic   = `${cfg.siteId}/${cfg.zone}/${S.controllerNum}/${S.mqttSegment}/${S.relayNum}`;
+
+        // ── Context helpers ───────────────────────────────────────
+        function ctxGet(key, store) {
+            try { return node.context().get(key, store); }
+            catch(e) { return node.context().get(key); }
+        }
+        function ctxSet(key, val, store) {
+            try { node.context().set(key, val, store); }
+            catch(e) { node.context().set(key, val); }
+        }
+        function recall(ramKey, diskKey, fallback) {
+            return ctxGet(ramKey) || ctxGet(diskKey, 'disk') || fallback;
+        }
+
+        // ── Disk save timer ───────────────────────────────────────
+        let diskTimer = null;
+        function startDiskSave(onComplete) {
+            if (diskTimer) { clearTimeout(diskTimer); diskTimer = null; }
+            diskTimer = setTimeout(() => {
+                diskTimer = null;
+                onComplete();
+            }, S.diskDelay * 1000);
+        }
+
+        // ── MQTT helpers ──────────────────────────────────────────
+        function pub(topic, payload, retain) {
+            broker.publish({
+                topic,
+                payload: typeof payload === 'object' ? JSON.stringify(payload) : String(payload),
+                qos:    cfg.qos,
+                retain: retain !== undefined ? retain : cfg.retain,
+            });
+        }
+
+        function pubRelay(value) {
+            // Relay controller expects integer payload
+            broker.publish({ topic: relayTopic, payload: String(value), qos: cfg.qos, retain: false });
+            node.log(`${fixtureId} relay — topic:${relayTopic}  payload:${value}`);
+        }
+
+        function pubState(state) {
+            pub(statTopic, JSON.stringify({ state, color_mode: 'onoff' }), false);
+        }
+
+        function setStatus(fill, shape, text) {
+            node.status({ fill, shape, text });
+        }
+
+        // ── Effects ───────────────────────────────────────────────
+        let effectTimer = null;
+
+        function stopEffect() {
+            if (effectTimer) {
+                clearTimeout(effectTimer);
+                clearInterval(effectTimer);
+                effectTimer = null;
+            }
+        }
+
+        function restoreAfterEffect() {
+            const state = recall('state', 'state_disk', S.defaultState);
+            pubRelay(state === 'ON' ? 1 : 0);
+            pubState(state);
+            setStatus('yellow', 'ring', `${fixtureId} ready — awaiting HA`);
+        }
+
+        function effectPulse(durationSecs) {
+            stopEffect();
+            pubRelay(1); pubState('ON');
+            setStatus('blue', 'dot', `${fixtureId} flash`);
+            effectTimer = setTimeout(() => {
+                effectTimer = null;
+                restoreAfterEffect();
+            }, durationSecs * 1000);
+        }
+
+        function effectStrobe() {
+            stopEffect();
+            setStatus('blue', 'dot', `${fixtureId} strobe`);
+            let on = false;
+            effectTimer = setInterval(() => {
+                on = !on;
+                pubRelay(on ? 1 : 0);
+            }, 500); // 500ms minimum for mechanical relay safety
+        }
+
+        const EFFECTS = {
+            flash_short: () => effectPulse(S.flashShort),
+            flash_long:  () => effectPulse(S.flashLong),
+            strobe:      () => effectStrobe(),
+        };
+
+        // ── State handlers ────────────────────────────────────────
+        function handleON() {
+            stopEffect();
+            pubRelay(1);
+            pubState('ON');
+            ctxSet('state', 'ON');
+            startDiskSave(() => {
+                ctxSet('state', 'ON', 'disk');
+                node.log(`${fixtureId} disk saved — state:ON`);
+            });
+            setStatus('green', 'dot', `${fixtureId} ON`);
+        }
+
+        function handleOFF() {
+            stopEffect();
+            pubRelay(0);
+            pubState('OFF');
+            ctxSet('state', 'OFF');
+            startDiskSave(() => {
+                ctxSet('state', 'OFF', 'disk');
+                node.log(`${fixtureId} disk saved — state:OFF`);
+            });
+            setStatus('grey', 'ring', `${fixtureId} OFF`);
+        }
+
+        // ── Device add ────────────────────────────────────────────
+        function handleDeviceAdd() {
+            // Init default memory if first run
+            if (!ctxGet('state') && !ctxGet('state', 'disk')) {
+                ctxSet('state', S.defaultState);
+            }
+
+            const discovery = {
+                unique_id:           `${S.deviceType}(${fixtureId})`,
+                schema:              'json',
+                object_id:           objectId,
+                name:                `${S.deviceType} ${S.situation} the ${cfg.zone} ${S.area} ${S.subLocation}`,
+                cmd_t:               cmdTopic,
+                stat_t:              statTopic,
+                optimistic:          false,
+                enabled_by_default:  cfg.enabledDefault,
+                icon:                S.haIcon,
+                supported_color_modes: ['onoff'],
+                brightness:          false,
+                effect:              S.showEffects,
+                effect_list:         S.showEffects ? Object.keys(EFFECTS) : [],
+                flash_time_short:    S.flashShort,
+                flash_time_long:     S.flashLong,
+                device: {
+                    identifiers:    `light-${fixtureId}`,
+                    name:           `(${fixtureId}) - ${S.deviceType} ${S.situation} the ${cfg.zone} - ${S.area} - ${S.subLocation}`,
+                    model:          `${S.deviceType} located ${S.situation} the ${cfg.zone} - ${S.area}`,
+                    model_id:       `referenced on plan as: (${fixtureId}`,
+                    suggested_area: `${cfg.zone} ${S.area} ${S.subLocation}`,
+                    hw_version:     `Relay Controller in ${cfg.zone}. Topic: ${relayTopic}`,
+                    serial_number:  fixtureId,
+                    sw_version:     'ha-mqtt-relay: 0.1.0',
+                    manufacturer:   'DeSwaggy — Discord: @deswaggy',
+                },
+            };
+
+            pub(cfgTopic, discovery, true);
+
+            broker.subscribe(cmdTopic, cfg.qos, function (topic, payload) {
+                let msg;
+                try { msg = JSON.parse(payload.toString()); }
+                catch(e) { node.warn(`${fixtureId} — failed to parse HA command`); return; }
+
+                if (msg.effect && S.showEffects && EFFECTS[msg.effect]) {
+                    EFFECTS[msg.effect]();
+                } else if (msg.state === 'ON') {
+                    handleON();
+                } else if (msg.state === 'OFF') {
+                    handleOFF();
+                }
+            }, node.id);
+
+            setStatus('green', 'ring', `${fixtureId} discovery sent`);
+            node.log(`${fixtureId} device added`);
+
+            // Recovery — re-assert state after deploy
+            setTimeout(() => {
+                const state = recall('state', 'state_disk', S.defaultState);
+                pubRelay(state === 'ON' ? 1 : 0);
+                pubState(state);
+                setStatus('yellow', 'ring', `${fixtureId} ready — awaiting HA`);
+                node.log(`${fixtureId} recovery — state:${state}`);
+            }, 2000);
+        }
+
+        // ── Device remove ─────────────────────────────────────────
+        function handleDeviceRemove() {
+            stopEffect();
+            if (diskTimer) { clearTimeout(diskTimer); diskTimer = null; }
+            ctxSet('state', null); ctxSet('state', null, 'disk');
+            pub(cfgTopic, '', true);
+            broker.unsubscribe(cmdTopic, node.id);
+            setStatus('red', 'ring', `${fixtureId} removed`);
+            node.log(`${fixtureId} device removed`);
+        }
+
+        // ── AUX cascade from Group Node ───────────────────────────
+        function handleAux(msg) {
+            if (!msg.payload) return;
+            if (msg.payload.effect && S.showEffects && EFFECTS[msg.payload.effect]) {
+                EFFECTS[msg.payload.effect]();
+            } else if (msg.payload.state === 'ON') {
+                handleON();
+            } else if (msg.payload.state === 'OFF') {
+                handleOFF();
+            }
+        }
+
+        // ── NR input entry point ──────────────────────────────────
+        node.on('input', function (msg, send, done) {
+            if (msg.dmx_trace != null) {
+                handleAux(msg);
+            } else {
+                const devReq = typeof msg.device === 'string'
+                    ? msg.device
+                    : (msg.device && msg.device.request);
+
+                if (devReq) {
+                    switch (devReq) {
+                        case 'add':    handleDeviceAdd();    break;
+                        case 'remove': handleDeviceRemove(); break;
+                        default: node.warn(`${fixtureId} — unknown device.request: "${devReq}"`);
+                    }
+                } else {
+                    node.warn(`${fixtureId} — unrecognised message received and dropped. See node documentation.`);
+                }
+            }
+            done();
+        });
+
+        // ── Cleanup ───────────────────────────────────────────────
+        node.on('close', function (done) {
+            stopEffect();
+            if (diskTimer) clearTimeout(diskTimer);
+            broker.unsubscribe(cmdTopic, node.id);
+            broker.deregister(node, done);
+        });
+    }
+
+    RED.nodes.registerType('ha-mqtt-relay', HaMqttRelayNode);
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "node-red-contrib-dmx-for-ha",
+  "version": "0.1.0",
+  "description": "DMX lighting control for Home Assistant via Node-RED and MQTT. Place a node, fill in the settings, deploy. Full HA device registry integration with RGBW/RGBWW/CCT/brightness colour modes, transitions, effects, and group control.",
+  "keywords": [
+    "node-red",
+    "dmx",
+    "dmx512",
+    "home-assistant",
+    "mqtt",
+    "mqtt-discovery",
+    "lighting",
+    "building-automation",
+    "rgb",
+    "rgbw",
+    "color-temp",
+    "relay",
+    "pir",
+    "motion-sensor",
+    "button",
+    "smart-home"
+  ],
+  "author": "DeSwaggy",
+  "license": "Apache-2.0",
+  "node-red": {
+    "version": ">=3.0.0",
+    "nodes": {
+      "ha-mqtt-config":     "nodes/ha-mqtt-config.js",
+      "ha-mqtt-dmx":        "nodes/ha-mqtt-dmx.js",
+      "ha-mqtt-dmx-group":  "nodes/ha-mqtt-dmx-group.js",
+      "ha-mqtt-relay":      "nodes/ha-mqtt-relay.js",
+      "ha-mqtt-button":     "nodes/ha-mqtt-button.js",
+      "ha-mqtt-pir":        "nodes/ha-mqtt-pir.js"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}