node-red-contrib-knx-ultimate 6.0.5 → 6.0.7

package/nodes/locales/zh-CN/matterbridge-config.json

@@ -16,7 +16,10 @@
       "deploy_first": "请先部署此配置节点，然后点击刷新。",
       "reset_button": "重置配对",
       "reset_confirm": "移除所有已配对的控制器并重新开始配对？设备将从 Alexa/Google/Apple 中消失。",
-      "reset_ok": "配对已重置。桥接器重新进入配对模式。"
+      "reset_ok": "配对已重置。桥接器重新进入配对模式。",
+      "storage_title": "Fabric 和配网备份", "storage_export": "导出", "storage_import": "导入",
+      "storage_warning": "备份包含 Fabric 凭据、私钥和配对数据。请像密码一样妥善保管。导入会替换此网桥的 Matter 存储并短暂重启。",
+      "storage_import_confirm": "要用所选备份替换此网桥的 Matter Fabric 和已配对控制器吗？", "storage_import_ok": "Matter 备份已导入，网桥已重启。"
     }
   }
 }

package/nodes/matter-config.html

@@ -3,6 +3,7 @@
 <script type="text/javascript">
     RED.nodes.registerType('matter-config', {
         category: 'config',
+        icon: 'node-matter-controller-icon.svg',
         defaults: {
             name: { value: "Matter Controller" },
             fabricLabel: { value: "KNX-Ultimate" }
@@ -20,6 +21,23 @@
             var $devicesBody = $("#matter-devices-body");
             var $refreshDevices = $("#matterRefreshDevices");
             var $pairSpinner = $("#matterPairSpinner");
+            var $storageExport = $('#matter-storage-export');
+            var $storageImport = $('#matter-storage-import');
+            var $storageFile = $('#matter-storage-file');
+
+            function storageExportUrl() {
+                var adminRoot = (RED.settings && typeof RED.settings.httpAdminRoot === 'string') ? RED.settings.httpAdminRoot : '/';
+                adminRoot = String(adminRoot || '/').trim();
+                adminRoot = adminRoot === '/' ? '' : '/' + adminRoot.replace(/^\/+|\/+$/g, '');
+                var params = new URLSearchParams();
+                params.set('serverId', node.id);
+                params.set('_', String(Date.now()));
+                try {
+                    var tokens = (RED.settings && typeof RED.settings.get === 'function') ? RED.settings.get('auth-tokens') : null;
+                    if (tokens && typeof tokens.access_token === 'string' && tokens.access_token.trim() !== '') params.set('access_token', tokens.access_token.trim());
+                } catch (error) { }
+                return adminRoot + '/KNXUltimateMatterStorageExport?' + params.toString();
+            }
 
             function notifyPairingError(msg) {
                 var text = RED._("node-red-contrib-knx-ultimate/matter-config:matter-config.properties.pairing_failed") + ': ' + (msg || '');
@@ -148,6 +166,32 @@
             });
 
             loadDevices();
+
+            $storageExport.on('click', function () {
+                window.location = storageExportUrl();
+            });
+            $storageImport.on('click', function () { $storageFile.trigger('click'); });
+            $storageFile.on('change', function () {
+                var file = this.files && this.files[0];
+                this.value = '';
+                if (!file || !window.confirm(RED._('node-red-contrib-knx-ultimate/matter-config:matter-config.properties.storage_import_confirm'))) return;
+                var reader = new FileReader();
+                reader.onload = function () {
+                    var backup;
+                    try { backup = JSON.parse(reader.result); } catch (error) { RED.notify(error.message, { type: 'error' }); return; }
+                    $storageImport.prop('disabled', true);
+                    $.ajax({
+                        url: 'KNXUltimateMatterStorageImport?serverId=' + encodeURIComponent(node.id),
+                        method: 'POST', contentType: 'application/json', data: JSON.stringify(backup)
+                    }).done(function () {
+                        RED.notify(RED._('node-red-contrib-knx-ultimate/matter-config:matter-config.properties.storage_import_ok'), { type: 'success' });
+                        loadDevices();
+                    }).fail(function (xhr) {
+                        RED.notify((xhr.responseJSON && xhr.responseJSON.error) || xhr.statusText, { type: 'error', fixed: true });
+                    }).always(function () { $storageImport.prop('disabled', false); });
+                };
+                reader.readAsText(file);
+            });
         },
         oneditsave: function () {
             // Return to the info tab
@@ -167,7 +211,6 @@
   </div>
 
   <div class="form-row">
-    <b><span data-i18n="matter-config.properties.title"></span></b>
     <p align="center" style="margin:8px 0;">
       <svg width="70" height="77" viewBox="0 8 40 44" xmlns="http://www.w3.org/2000/svg" aria-label="Matter" style="vertical-align:middle;">
         <g fill="currentColor" stroke="none">
@@ -187,9 +230,8 @@
         </g>
       </svg>
       <br/>
-      <span style="font-size:18px; font-weight:600; letter-spacing:1px;">matter</span>
+      <span style="font-size:18px; font-weight:600; letter-spacing:1px;" data-i18n="matter-config.properties.title"></span>
     </p>
-    <p><span data-i18n="matter-config.properties.intro"></span></p>
   </div>
 
   <div class="form-row">
@@ -210,9 +252,17 @@
 
   <hr/>
 
+  <div class="form-row">
+    <b><i class="fa fa-database"></i>&nbsp;<span data-i18n="matter-config.properties.storage_title"></span></b>
+    <button type="button" id="matter-storage-export" class="red-ui-button" style="margin-left:8px;"><i class="fa fa-download"></i>&nbsp;<span data-i18n="matter-config.properties.storage_export"></span></button>
+    <button type="button" id="matter-storage-import" class="red-ui-button"><i class="fa fa-upload"></i>&nbsp;<span data-i18n="matter-config.properties.storage_import"></span></button>
+    <input type="file" id="matter-storage-file" accept="application/json,.json" style="display:none;">
+  </div>
+
+  <hr/>
+
   <div class="form-row">
     <b><i class="fa fa-qrcode"></i>&nbsp;<span data-i18n="matter-config.properties.pairing_title"></span></b>
-    <p><span data-i18n="matter-config.properties.pairing_help"></span></p>
   </div>
 
   <div class="form-row">
@@ -236,15 +286,6 @@
     </label>
     <input type="text" id="matter-pairing-name" placeholder="Kitchen plug" style="width:250px;">
   </div>
-  <div class="form-tips" style="margin: 4px 0 8px; font-size:12px;">
-    <i class="fa fa-circle-info" style="color:#1b7d33; margin-right:4px;"></i>
-    <span data-i18n="matter-config.properties.pairing_hint">Prefer the QR code (MT:…): it carries the full device discriminator. The manual code
-    stores only a short discriminator and cannot reliably tell identical devices apart
-    (e.g. several Shelly of the same model), which can pair the wrong one or report it as
-    already commissioned. Pair one device at a time; if a device is already paired
-    elsewhere, factory-reset it first.</span>
-  </div>
-
   <hr/>
 
   <div class="form-row">
@@ -270,9 +311,9 @@
   </div>
 
   <br/>
-   <br/>
-    <br/>
-    <br/>
-   <br/>
-    <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
 </script>

package/nodes/matter-config.js

@@ -1,5 +1,8 @@
 /* eslint-disable max-len */
 const path = require('path')
+const { exportMatterStorage, importMatterStorage } = require('./utils/matterStorageBackup')
+const matterPackageVersion = require('@matter/main').version
+const { Specification } = require('@matter/model')
 
 // 10/09/2024 Setup the color logger
 const loggerSetup = (options) => {
@@ -18,6 +21,7 @@ module.exports = (RED) => {
     node.sysLogger = null
     node.matterManager = null
     node.timerMatterConfigCheckState = null
+    node.storageOperation = null
     try {
       node.sysLogger = loggerSetup({ loglevel: node.loglevel, setPrefix: 'matter-config.js' })
     } catch (error) { console.log(error.stack) }
@@ -190,6 +194,35 @@ module.exports = (RED) => {
       if (node.matterManager === null) throw new Error('Matter controller not started')
       return node.matterManager.renameNode(_nodeId, _label)
     }
+
+    const withStoppedController = async (operation) => {
+      if (node.storageOperation !== null) throw new Error('Another Matter storage operation is already running')
+      node.storageOperation = (async () => {
+        if (node.matterManager !== null) await node.matterManager.close()
+        node.matterManager = null
+        try {
+          return await operation()
+        } finally {
+          await node.initMatterConnection()
+        }
+      })()
+      try { return await node.storageOperation } finally { node.storageOperation = null }
+    }
+
+    node.exportMatterStorage = () => withStoppedController(() => exportMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'controller',
+      protocolVersion: Specification.REVISION,
+      packageVersion: matterPackageVersion
+    }))
+
+    node.importMatterStorage = (backup) => withStoppedController(() => importMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'controller',
+      backup
+    }))
     // END functions called from the nodes -------------------------------------------------------------
 
     node.addClient = (_Node) => {

package/nodes/matterbridge-config.html

@@ -3,6 +3,7 @@
 <script type="text/javascript">
     RED.nodes.registerType('matterbridge-config', {
         category: 'config',
+        icon: 'node-matter-bridge-icon.svg',
         defaults: {
             name: { value: '' },
             bridgeDeviceName: { value: '' },
@@ -15,6 +16,21 @@
             var $pairingBody = $('#mbc-pairing-body');
             var $refreshPairing = $('#mbc-refresh-pairing');
             var $resetButton = $('#mbc-factory-reset');
+            var $storageFile = $('#mbc-storage-file');
+
+            function storageExportUrl() {
+                var adminRoot = (RED.settings && typeof RED.settings.httpAdminRoot === 'string') ? RED.settings.httpAdminRoot : '/';
+                adminRoot = String(adminRoot || '/').trim();
+                adminRoot = adminRoot === '/' ? '' : '/' + adminRoot.replace(/^\/+|\/+$/g, '');
+                var params = new URLSearchParams();
+                params.set('configId', node.id);
+                params.set('_', String(Date.now()));
+                try {
+                    var tokens = (RED.settings && typeof RED.settings.get === 'function') ? RED.settings.get('auth-tokens') : null;
+                    if (tokens && typeof tokens.access_token === 'string' && tokens.access_token.trim() !== '') params.set('access_token', tokens.access_token.trim());
+                } catch (error) { }
+                return adminRoot + '/KNXUltimateMatterBridgeStorageExport?' + params.toString();
+            }
 
             var t = function (key) {
                 return RED._('node-red-contrib-knx-ultimate/matterbridge-config:matterbridge-config.properties.' + key);
@@ -37,7 +53,6 @@
                         info.fabrics.forEach(function (f) {
                             $pairingBody.append($('<div style="margin-left:10px;"></div>').text('• ' + (f.label || 'Controller') + ' (vendor ' + f.vendorId + ')'));
                         });
-                        $pairingBody.append($('<p style="max-width:760px; margin:14px auto 0; color:#777;"></p>').text(t('commissioned_hint')));
                         $resetButton.show();
                         return;
                     }
@@ -69,6 +84,26 @@
                     loadPairingInfo();
                 }).always(function () { $resetButton.prop('disabled', false); });
             });
+            $('#mbc-storage-export').on('click', function () {
+                window.location = storageExportUrl();
+            });
+            $('#mbc-storage-import').on('click', function () { $storageFile.trigger('click'); });
+            $storageFile.on('change', function () {
+                var file = this.files && this.files[0];
+                this.value = '';
+                if (!file || !window.confirm(t('storage_import_confirm'))) return;
+                var reader = new FileReader();
+                reader.onload = function () {
+                    var backup;
+                    try { backup = JSON.parse(reader.result); } catch (error) { RED.notify(error.message, { type: 'error' }); return; }
+                    $('#mbc-storage-import').prop('disabled', true);
+                    $.ajax({ url: 'KNXUltimateMatterBridgeStorageImport?configId=' + encodeURIComponent(node.id), method: 'POST', contentType: 'application/json', data: JSON.stringify(backup) })
+                        .done(function () { RED.notify(t('storage_import_ok'), { type: 'success' }); loadPairingInfo(); })
+                        .fail(function (xhr) { RED.notify((xhr.responseJSON && xhr.responseJSON.error) || xhr.statusText, { type: 'error', fixed: true }); })
+                        .always(function () { $('#mbc-storage-import').prop('disabled', false); });
+                };
+                reader.readAsText(file);
+            });
 
             loadPairingInfo();
         },
@@ -87,8 +122,27 @@
   </div>
 
   <div class="form-row">
-    <b><span data-i18n="matterbridge-config.properties.title"></span></b>
-    <p><span data-i18n="matterbridge-config.properties.intro"></span></p>
+    <p align="center" style="margin:8px 0;">
+      <svg width="70" height="77" viewBox="0 8 40 44" xmlns="http://www.w3.org/2000/svg" aria-label="Matter" style="vertical-align:middle;">
+        <g fill="currentColor" stroke="none">
+          <circle cx="20" cy="30" r="4.5"/>
+          <g>
+            <rect x="18.4" y="9" width="3.2" height="11"/>
+            <path d="M 14.5 18.5 L 25.5 18.5 L 20 25.5 Z"/>
+          </g>
+          <g transform="rotate(120 20 30)">
+            <rect x="18.4" y="9" width="3.2" height="11"/>
+            <path d="M 14.5 18.5 L 25.5 18.5 L 20 25.5 Z"/>
+          </g>
+          <g transform="rotate(240 20 30)">
+            <rect x="18.4" y="9" width="3.2" height="11"/>
+            <path d="M 14.5 18.5 L 25.5 18.5 L 20 25.5 Z"/>
+          </g>
+        </g>
+      </svg>
+      <br/>
+      <span style="font-size:18px; font-weight:600; letter-spacing:1px;" data-i18n="matterbridge-config.properties.title"></span>
+    </p>
   </div>
 
   <div class="form-row">
@@ -109,6 +163,15 @@
 
   <hr/>
 
+  <div class="form-row">
+    <b><i class="fa fa-database"></i>&nbsp;<span data-i18n="matterbridge-config.properties.storage_title"></span></b>
+    <button type="button" id="mbc-storage-export" class="red-ui-button" style="margin-left:8px;"><i class="fa fa-download"></i>&nbsp;<span data-i18n="matterbridge-config.properties.storage_export"></span></button>
+    <button type="button" id="mbc-storage-import" class="red-ui-button"><i class="fa fa-upload"></i>&nbsp;<span data-i18n="matterbridge-config.properties.storage_import"></span></button>
+    <input type="file" id="mbc-storage-file" accept="application/json,.json" style="display:none;">
+  </div>
+
+  <hr/>
+
   <div class="form-row">
     <b><i class="fa fa-qrcode"></i>&nbsp;<span data-i18n="matterbridge-config.properties.pairing_title"></span></b>
     <button type="button" id="mbc-refresh-pairing" class="red-ui-button" style="margin-left:6px; color:#1b7d33; border-color:#1b7d33;">
@@ -119,4 +182,11 @@
     </button>
   </div>
   <div class="form-row" id="mbc-pairing-body" style="text-align:center;"></div>
+
+  <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
+  <br/>
 </script>

package/nodes/matterbridge-config.js

@@ -1,5 +1,8 @@
 /* eslint-disable max-len */
 const path = require('path')
+const { exportMatterStorage, importMatterStorage } = require('./utils/matterStorageBackup')
+const matterPackageVersion = require('@matter/main').version
+const { Specification } = require('@matter/model')
 
 // 10/09/2024 Setup the color logger
 const loggerSetup = (options) => {
@@ -39,6 +42,7 @@ module.exports = (RED) => {
     let startupTimer = null
     let reconcileTimer = null
     let closing = false
+    let storageOperation = null
 
     Object.defineProperty(node, 'linkStatus', {
       get: function () {
@@ -193,6 +197,40 @@ module.exports = (RED) => {
       await node.matterBridge.factoryReset()
       notifyClientsStatus()
     }
+
+    const withStoppedBridge = async (operation) => {
+      if (storageOperation !== null) throw new Error('Another Matter storage operation is already running')
+      storageOperation = (async () => {
+        const engine = node.matterBridge
+        if (engine !== null) {
+          engine.removeAllListeners()
+          await engine.close()
+          runningBridges.delete(node.id)
+          node.matterBridge = null
+        }
+        try {
+          return await operation()
+        } finally {
+          await ensureEngineStarted()
+        }
+      })()
+      try { return await storageOperation } finally { storageOperation = null }
+    }
+
+    node.exportMatterStorage = () => withStoppedBridge(() => exportMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'bridge',
+      protocolVersion: Specification.REVISION,
+      packageVersion: matterPackageVersion
+    }))
+
+    node.importMatterStorage = (backup) => withStoppedBridge(() => importMatterStorage({
+      storagePath: node.matterStoragePath,
+      instanceId: node.matterInstanceId,
+      kind: 'bridge',
+      backup
+    }))
     // END functions called from the device nodes -------------------------------------
 
     node.on('close', (removed, done) => {

package/nodes/utils/matterControllerProfiles/doorLock.js

@@ -0,0 +1,210 @@
+'use strict'
+
+const dptlib = require('knxultimate').dptlib
+
+const DOOR_LOCK_CLUSTER_ID = 0x0101
+const LOCK_STATE = {
+  NOT_FULLY_LOCKED: 0,
+  LOCKED: 1,
+  UNLOCKED: 2,
+  UNLATCHED: 3
+}
+
+const decodeKnxBoolean = (msg, dpt) => {
+  if (msg && msg.knx && Buffer.isBuffer(msg.knx.rawValue)) {
+    return !!dptlib.fromBuffer(msg.knx.rawValue, dptlib.resolve(dpt || '1.001'))
+  }
+  return !!(msg && msg.payload)
+}
+
+const lockStateName = (value) => {
+  switch (Number(value)) {
+    case LOCK_STATE.LOCKED: return 'locked'
+    case LOCK_STATE.UNLOCKED: return 'unlocked'
+    case LOCK_STATE.NOT_FULLY_LOCKED: return 'notFullyLocked'
+    case LOCK_STATE.UNLATCHED: return 'unlatched'
+    default: return 'unknown'
+  }
+}
+
+const lockStateToBoolean = (value) => {
+  if (Number(value) === LOCK_STATE.LOCKED) return true
+  if (Number(value) === LOCK_STATE.UNLOCKED) return false
+  return undefined
+}
+
+const setupDoorLockProfile = (RED, node, config) => {
+  node.name = config.name || node.matterDeviceName || 'Control Matter door lock from KNX'
+  node.topic = node.name
+  node.notifyreadrequest = true
+  node.notifyreadrequestalsorespondtobus = 'false'
+  node.notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized = ''
+  node.notifyresponse = false
+  node.notifywrite = true
+  node.initialread = true
+  node.listenallga = true
+  node.outputtype = 'write'
+  node.outputRBE = 'false'
+  node.inputRBE = 'false'
+  node.passthrough = 'no'
+  node.currentLockState = undefined
+  node.knxUltimateAcceptedGAs = [config.GALightSwitch, config.GALightState]
+    .map((ga) => String(ga || '').trim())
+    .filter((ga) => ga !== '')
+
+  const setStatus = (fill, shape, text) => node.status({ fill, shape, text })
+
+  const commandArgs = () => {
+    const pin = String(node.credentials?.doorLockPin || '')
+    return pin === '' ? {} : { pinCode: Buffer.from(pin, 'utf8') }
+  }
+
+  const sendFlow = (source, state, rawState) => {
+    if (config.enableNodePINS !== 'yes') return
+    node.send({
+      topic: node.topic,
+      payload: state,
+      matter: {
+        source,
+        nodeId: node.matterNodeId,
+        endpointId: node.matterEndpointId,
+        clusterId: DOOR_LOCK_CLUSTER_ID,
+        lockState: rawState,
+        lockStateName: rawState === undefined ? (state ? 'locked' : 'unlocked') : lockStateName(rawState)
+      }
+    })
+  }
+
+  const writeKnxState = (state, outputtype = 'write') => {
+    const ga = String(config.GALightState || '').trim()
+    if (ga === '' || !node.serverKNX) return
+    node.serverKNX.sendKNXTelegramToKNXEngine({
+      grpaddr: ga,
+      payload: state,
+      dpt: config.dptLightState || '1.001',
+      outputtype,
+      nodecallerid: node.id
+    })
+  }
+
+  const publishMatterState = (rawState, source = 'matter') => {
+    node.currentLockState = Number(rawState)
+    const state = lockStateToBoolean(rawState)
+    const name = lockStateName(rawState)
+    if (state !== undefined) writeKnxState(state)
+    sendFlow(source, state, rawState)
+    setStatus(state === undefined ? 'yellow' : 'blue', state === undefined ? 'ring' : 'dot', `Matter: ${name}`)
+  }
+
+  const queueCommand = (locked, source = 'knx') => {
+    const manager = node.serverMatter?.matterManager
+    if (!manager) throw new Error('Matter controller not ready')
+    const capabilities = (() => {
+      try { return JSON.parse(config.matterDeviceCapabilities || '{}') } catch (error) { return {} }
+    })()
+    if (locked && capabilities.lockDoor === false) throw new Error('The Matter endpoint does not expose lockDoor')
+    if (!locked && capabilities.unlockDoor === false) throw new Error('The Matter endpoint does not expose unlockDoor')
+    const queued = manager.writeMatterQueueAdd({
+      nodeId: node.matterNodeId,
+      endpointId: node.matterEndpointId,
+      clusterId: DOOR_LOCK_CLUSTER_ID,
+      kind: 'command',
+      name: locked ? 'lockDoor' : 'unlockDoor',
+      args: commandArgs()
+    })
+    if (queued && typeof queued.catch === 'function') {
+      queued.catch((error) => {
+        RED.log.error(`knxUltimateMatterControllerDevice DoorLock command: ${error.message}`)
+        setStatus('red', 'ring', error.message)
+      })
+    }
+    sendFlow(source, locked)
+    setStatus('green', 'dot', `KNX→Matter: ${locked ? 'lock' : 'unlock'}`)
+  }
+
+  node.handleSend = (msg) => {
+    try {
+      if (!msg?.knx || !node.knxUltimateAcceptedGAs.includes(String(msg.knx.destination || '').trim())) return
+      if (msg.knx.event === 'GroupValue_Read') {
+        if (String(msg.knx.destination) === String(config.GALightState)) {
+          const state = lockStateToBoolean(node.currentLockState)
+          if (state !== undefined) writeKnxState(state, 'response')
+        }
+        return
+      }
+      if (String(msg.knx.destination) !== String(config.GALightSwitch)) return
+      queueCommand(decodeKnxBoolean(msg, config.dptLightSwitch), 'knx')
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice DoorLock KNX: ${error.message}`)
+      setStatus('red', 'ring', error.message)
+    }
+  }
+
+  node.handleSendMatter = (event) => {
+    try {
+      if (String(event?.nodeId) !== String(node.matterNodeId)) return
+      if (Number(event?.endpointId) !== Number(node.matterEndpointId)) return
+      if (Number(event?.clusterId) !== DOOR_LOCK_CLUSTER_ID || event.attributeName !== 'lockState') return
+      publishMatterState(event.value)
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice DoorLock Matter: ${error.message}`)
+    }
+  }
+  node.handleMatterClusterEvent = () => {}
+  node.handleMatterNodeInitialized = () => {
+    try {
+      const value = node.serverMatter?.matterManager?.getCachedAttribute(
+        node.matterNodeId,
+        node.matterEndpointId,
+        DOOR_LOCK_CLUSTER_ID,
+        'lockState'
+      )
+      if (value !== undefined && value !== null) publishMatterState(value, 'initial')
+    } catch (error) {
+      RED.log.error(`knxUltimateMatterControllerDevice DoorLock initial state: ${error.message}`)
+    }
+  }
+  node.setNodeStatusMatter = (status) => {
+    if (status && status.text) setStatus(status.fill || 'grey', status.shape || 'ring', status.text)
+  }
+
+  if (node.serverKNX) {
+    node.serverKNX.removeClient(node)
+    node.serverKNX.addClient(node)
+  } else {
+    setStatus('yellow', 'ring', 'No KNX gateway selected')
+  }
+  if (node.serverMatter) {
+    node.serverMatter.removeClient(node)
+    node.serverMatter.addClient(node)
+  }
+
+  node.on('input', (msg, send, done) => {
+    try {
+      const value = typeof msg.payload === 'object' && msg.payload !== null && msg.payload.locked !== undefined
+        ? msg.payload.locked
+        : msg.payload
+      if (typeof value !== 'boolean') throw new Error('Door Lock input requires msg.payload boolean or { locked: boolean }')
+      queueCommand(value, 'flow')
+      if (done) done()
+    } catch (error) {
+      setStatus('red', 'ring', error.message)
+      if (done) done(error)
+      else node.error(error, msg)
+    }
+  })
+
+  node.on('close', (done) => {
+    try { if (node.serverKNX) node.serverKNX.removeClient(node) } catch (error) { /* empty */ }
+    try { if (node.serverMatter) node.serverMatter.removeClient(node) } catch (error) { /* empty */ }
+    done()
+  })
+}
+
+module.exports = {
+  DOOR_LOCK_CLUSTER_ID,
+  LOCK_STATE,
+  lockStateName,
+  lockStateToBoolean,
+  setupDoorLockProfile
+}

package/nodes/utils/matterControllerProfiles/index.js

@@ -0,0 +1,21 @@
+'use strict'
+
+const { setupDoorLockProfile } = require('./doorLock')
+const { setupMappedEndpointProfile } = require('./mappedEndpoint')
+
+// Controller-side Matter device profiles live behind this registry.  Keep profile
+// selection capability-driven: the editor records the profile only after inspecting
+// the endpoint's actual device types, clusters, attributes and supported commands.
+const PROFILE_SETUPS = Object.freeze({
+  doorLock: setupDoorLockProfile,
+  mapped: setupMappedEndpointProfile
+})
+
+const setupMatterControllerProfile = (profile, RED, node, config) => {
+  const setup = PROFILE_SETUPS[profile]
+  if (typeof setup !== 'function') return false
+  setup(RED, node, config)
+  return true
+}
+
+module.exports = { PROFILE_SETUPS, setupMatterControllerProfile }