smart-home-engine 1.20.3 → 1.20.5

package/dist/web/assets/{tsMode-DBmTyMNv.js → tsMode-xpfUxGc8.js}

@@ -1,4 +1,4 @@
-import{m as O}from"./monaco-langs-Dt8a9eeo.js";import{t as I}from"./index-BbXC7eVn.js";/*!-----------------------------------------------------------------------------
+import{m as O}from"./monaco-langs-Dt8a9eeo.js";import{t as I}from"./index-DvxIhiIs.js";/*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license

package/dist/web/index.html

@@ -172,7 +172,7 @@
                 }
             })();
         </script>
-      <script type="module" crossorigin src="/assets/index-BbXC7eVn.js"></script>
+      <script type="module" crossorigin src="/assets/index-DvxIhiIs.js"></script>
       <link rel="modulepreload" crossorigin href="/assets/monaco-langs-Dt8a9eeo.js">
       <link rel="stylesheet" crossorigin href="/assets/monaco-langs-DyX1CsEw.css">
       <link rel="stylesheet" crossorigin href="/assets/index-B4M4MeEk.css">

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "smart-home-engine",
-    "version": "1.20.3",
+    "version": "1.20.5",
     "description": "Node.js based script runner for use in MQTT based Smart Home environments",
     "main": "src/index.js",
     "scripts": {

package/src/matter/controller.js

@@ -403,6 +403,13 @@ async function getAttribute(nodeId, endpointId, clusterName, attrName) {
  * Write a single attribute value (a remote write for client nodes — the
  * attribute must be writable per the device's Matter data model).
  *
+ * Uses the interaction-level write rather than Endpoint.set(): set() requires
+ * a synthesized client behavior, which matter.js does not create for every
+ * cluster (e.g. basicInformation on the root endpoint reports
+ * "Behavior ... is not present on this endpoint" although the cluster and its
+ * state are there). The interaction write goes over the same wire path that
+ * commands use and needs no behavior instance.
+ *
  * @param {string}  nodeId
  * @param {number}  endpointId
  * @param {string}  clusterName  camelCase cluster name, e.g. "basicInformation"
@@ -412,8 +419,14 @@ async function getAttribute(nodeId, endpointId, clusterName, attrName) {
  */
 async function setAttribute(nodeId, endpointId, clusterName, attrName, value) {
     const node = _findClientNode(nodeId);
-    const endpoint = _resolveEndpoint(node, endpointId);
-    await endpoint.set({ [_clusterName(clusterName)]: { [attrName]: value } });
+    const { Write, WriteResult } = require('@matter/protocol');
+    const clusters = require('@matter/main/clusters');
+    const clusterDef = clusters[clusterName.charAt(0).toUpperCase() + clusterName.slice(1)]?.Complete;
+    if (!clusterDef) throw new Error(`Unknown cluster "${clusterName}"`);
+    if (!clusterDef.attributes?.[attrName]) throw new Error(`Unknown attribute "${clusterName}.${attrName}"`);
+    const request = Write(Write.Attribute({ endpoint: Number(endpointId), cluster: clusterDef, attributes: attrName, value }));
+    const result = await node.interaction.write(request);
+    WriteResult.assertSuccess(result);
 }
 
 /**
@@ -434,18 +447,43 @@ async function rename(nodeId, name) {
 
 // ── Commands ──────────────────────────────────────────────────────────────────
 
+/** Lowercase the first character (PascalCase model names → camelCase). */
+function _camelize(s) {
+    return s.charAt(0).toLowerCase() + s.slice(1);
+}
+
 /**
  * Best-effort: list the mandatory field names (camelCase) of a command's
- * request schema. Handles both shapes matter.js uses: a TLV ObjectSchema
- * (fieldDefinitions, camelCase keys) and a CommandModel (children with
- * PascalCase names and conformance flags). Returns [] when unresolvable.
- * @param {object} cluster      the behavior's cluster definition
+ * request schema. Resolution mirrors matter.js's own command lookup:
+ *   1. the behavior's cluster definition (unwrapping a `.cluster`-wrapped
+ *      specifier like @matter/protocol Specifier.clusterFor does), commands as
+ *      a TLV Command (requestSchema/fieldDefinitions) or a model-based command
+ *      ({ schema: CommandModel });
+ *   2. fallback: the behavior's ClusterModel schema — request-direction
+ *      CommandModel children matched by camelized name (the shape generated
+ *      for discovered client clusters).
+ * Returns [] when unresolvable.
+ * @param {object} behavior     the cluster behavior (agent[clusterName])
  * @param {string} commandName
  * @returns {string[]}
  */
-function _mandatoryCommandFields(cluster, commandName) {
+function _mandatoryCommandFields(behavior, commandName) {
     try {
-        const cmd = cluster?.commands?.[commandName];
+        let cluster = behavior?.cluster;
+        if (cluster && typeof cluster === 'object' && 'cluster' in cluster) cluster = cluster.cluster;
+        let cmd = cluster?.commands?.[commandName];
+        if (!cmd) {
+            // Discovered client clusters: command models live on the ClusterModel schema
+            const schemaModel = behavior?.schema ?? behavior?.constructor?.schema;
+            if (schemaModel?.children) {
+                for (const c of schemaModel.children) {
+                    if (c.tag === 'command' && c.name && _camelize(c.name) === commandName && c.direction !== 'response') {
+                        cmd = { schema: c };
+                        break;
+                    }
+                }
+            }
+        }
         const schema = cmd?.schema ?? cmd?.requestSchema;
         if (schema?.fieldDefinitions) {
             return Object.entries(schema.fieldDefinitions)
@@ -453,7 +491,7 @@ function _mandatoryCommandFields(cluster, commandName) {
                 .map(([name]) => name);
         }
         if (schema?.children) {
-            return [...schema.children].filter((c) => c.effectiveConformance?.isMandatory !== false).map((c) => c.name.charAt(0).toLowerCase() + c.name.slice(1));
+            return [...schema.children].filter((c) => c.effectiveConformance?.isMandatory !== false).map((c) => _camelize(c.name));
         }
     } catch {
         /* best-effort — fall through */
@@ -489,7 +527,17 @@ async function sendCommand(nodeId, endpointId, clusterName, commandName, args) {
         if (typeof cmd !== 'function') throw new Error(`Command "${commandName}" not found in cluster "${clusterName}"`);
         // Fill neutral defaults for mandatory boilerplate fields the caller omitted.
         const merged = args !== undefined && args !== null && typeof args === 'object' ? { ...args } : {};
-        for (const field of _mandatoryCommandFields(clusterAgent.cluster, commandName)) {
+        let mandatoryFields = _mandatoryCommandFields(clusterAgent, commandName);
+        if (mandatoryFields.length === 0) {
+            _log?.debug(`matter: could not resolve request fields for ${clusterName}.${commandName}`);
+            // Last resort: every LevelControl/ColorControl command carries the two
+            // options bitmaps (and the TLV encoder ignores unknown fields), so
+            // injecting them is safe even for the few commands without them.
+            if (_clusterName(clusterName) === 'levelControl' || _clusterName(clusterName) === 'colorControl') {
+                mandatoryFields = ['optionsMask', 'optionsOverride'];
+            }
+        }
+        for (const field of mandatoryFields) {
             if (merged[field] !== undefined) continue;
             if (field === 'optionsMask' || field === 'optionsOverride') merged[field] = {};
             else if (field === 'transitionTime') merged[field] = 0;
@@ -540,6 +588,13 @@ function _broadcastNodeAttributes(node, nodeId) {
                             value: _jsonSafe(value),
                             ts: Date.now(),
                         });
+                        // Device/endpoint labels feed the device list — rebroadcast it
+                        // when they change. This is also what completes a rename():
+                        // the local mirror only learns the new nodeLabel when the
+                        // device's subscription report arrives, i.e. exactly now.
+                        if (attrName === 'nodeLabel' || attrName === 'productName') {
+                            _broadcast?.({ type: 'matter:deviceList', devices: listPaired() });
+                        }
                     });
                     count++;
                 }