@matter/node 0.16.0-alpha.0-20251108-514b3f69e → 0.16.0-alpha.0-20251110-c4c70a41b

package/dist/esm/node/client/ClientStructure.js

@@ -1,3 +1,48 @@
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (async) dispose = value[__knownSymbol("asyncDispose")];
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+      if (async) inner = dispose;
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors
@@ -8,6 +53,7 @@ import { Descriptor } from "#clusters/descriptor";
 import { Endpoint } from "#endpoint/Endpoint.js";
 import { EndpointType } from "#endpoint/type/EndpointType.js";
 import { RootEndpoint } from "#endpoints/root";
+import { InternalError, Logger } from "#general";
 import {
   AcceptedCommandList,
   AttributeList,
@@ -21,7 +67,9 @@ import { ReadScope } from "#protocol";
 import { DatasourceCache } from "#storage/client/DatasourceCache.js";
 import { ClientNodeStore } from "#storage/index.js";
 import { ClientEventEmitter } from "./ClientEventEmitter.js";
+import { ClientStructureEvents } from "./ClientStructureEvents.js";
 import { PeerBehavior } from "./PeerBehavior.js";
+const logger = Logger.get("ClientStructure");
 const DEVICE_TYPE_LIST_ATTR_ID = Descriptor.Cluster.attributes.deviceTypeList.id;
 const SERVER_LIST_ATTR_ID = Descriptor.Cluster.attributes.serverList.id;
 const PARTS_LIST_ATTR_ID = Descriptor.Cluster.attributes.partsList.id;
@@ -31,6 +79,8 @@ class ClientStructure {
   #emitEvent;
   #node;
   #subscribedFabricFiltered;
+  #pending = /* @__PURE__ */ new Map();
+  #events;
   constructor(node) {
     this.#node = node;
     this.#nodeStore = node.env.get(ClientNodeStore);
@@ -39,6 +89,7 @@ class ClientStructure {
       clusters: {}
     };
     this.#emitEvent = ClientEventEmitter(node, this);
+    this.#events = this.#node.env.get(ClientStructureEvents);
   }
   /**
    * Load initial structure from cache.
@@ -57,7 +108,17 @@ class ClientStructure {
           continue;
         }
         const cluster = this.#clusterFor(endpoint, id2);
-        this.#initializeCluster(endpoint, cluster);
+        this.#synchronizeCluster(endpoint, cluster);
+      }
+    }
+    for (const [endpoint, opcode] of this.#pending.entries()) {
+      this.#pending.delete(endpoint);
+      switch (opcode) {
+        case "reparent":
+          this.#install(endpoint);
+          break;
+        default:
+          throw new InternalError(`Unexpected ${opcode} operation in initial hierarchy load`);
       }
     }
   }
@@ -112,23 +173,48 @@ class ClientStructure {
    * Update the node structure by applying attribute changes.
    */
   async *mutate(request, changes) {
-    const scope = ReadScope(request);
-    let currentUpdates;
-    for await (const chunk of changes) {
-      for (const change of chunk) {
-        switch (change.kind) {
-          case "attr-value":
-            currentUpdates = await this.#mutateAttribute(change, scope, currentUpdates);
+    var _stack = [];
+    try {
+      const _lock = __using(_stack, await this.#node.lifecycle.mutex.lock());
+      let currentUpdates;
+      const scope = ReadScope(request);
+      for await (const chunk of changes) {
+        for (const change of chunk) {
+          switch (change.kind) {
+            case "attr-value":
+              currentUpdates = await this.#mutateAttribute(change, scope, currentUpdates);
+              break;
+            case "event-value":
+              this.#emitEvent(change);
+              break;
+          }
+        }
+        yield chunk;
+      }
+      if (currentUpdates) {
+        await this.#updateCluster(currentUpdates);
+      }
+      for (const [endpoint, opcode] of this.#pending.entries()) {
+        this.#pending.delete(endpoint);
+        switch (opcode) {
+          case "reparent":
+            this.#install(endpoint);
             break;
-          case "event-value":
-            this.#emitEvent(change);
+          case "erase":
+            logger.debug(`Removing endpoint ${endpoint.endpoint} because it is no longer present on the peer`);
+            delete this.#endpoints[endpoint.endpoint.number];
+            try {
+              await endpoint.endpoint.delete();
+            } catch (e) {
+              logger.error(`Error erasing peer endpoint ${endpoint.endpoint}:`, e);
+            }
             break;
         }
       }
-      yield chunk;
-    }
-    if (currentUpdates) {
-      await this.#updateCluster(currentUpdates);
+    } catch (_) {
+      var _error = _, _hasError = true;
+    } finally {
+      __callDispose(_stack, _error, _hasError);
     }
   }
   /** Reference to the default subscription used when the node was started. */
@@ -191,7 +277,7 @@ class ClientStructure {
     const endpoint = this.#endpointFor(attrs.endpointId);
     const cluster = this.#clusterFor(endpoint, attrs.clusterId);
     await cluster.store.externalSet(attrs.values);
-    this.#initializeCluster(endpoint, cluster);
+    this.#synchronizeCluster(endpoint, cluster);
   }
   /**
    * If enough attributes are present, installs a behavior on an endpoint
@@ -201,15 +287,14 @@ class ClientStructure {
    *
    * Invoked once we've loaded all attributes in an interaction.
    */
-  #initializeCluster(endpoint, cluster) {
-    const attrs = cluster.store.initialValues ?? {};
-    if (cluster.behavior === void 0) {
+  #synchronizeCluster(endpoint, cluster) {
+    if (cluster.behavior === void 0 && cluster.store.initialValues) {
       const {
         [ClusterRevision.id]: clusterRevision,
         [FeatureMap.id]: features,
         [AttributeList.id]: attributeList,
         [AcceptedCommandList.id]: commandList
-      } = attrs;
+      } = cluster.store.initialValues;
       if (typeof clusterRevision === "number") {
         cluster.revision = clusterRevision;
       }
@@ -225,9 +310,18 @@ class ClientStructure {
       if (cluster.revision !== void 0 && cluster.features !== void 0 && cluster.attributes !== void 0 && cluster.commands !== void 0) {
         cluster.behavior = PeerBehavior(cluster);
         endpoint.endpoint.behaviors.require(cluster.behavior);
+        if (endpoint.endpoint.lifecycle.isInstalled) {
+          this.#events.emitCluster(endpoint.endpoint, cluster.behavior);
+        }
       }
     }
     if (cluster.id === Descriptor.Cluster.id) {
+      let attrs;
+      if (cluster.behavior && endpoint.endpoint.behaviors.isActive(cluster.behavior.id)) {
+        attrs = endpoint.endpoint.stateOf(cluster.behavior);
+      } else {
+        attrs = cluster.store.initialValues ?? {};
+      }
       this.#synchronizeDescriptor(endpoint, attrs);
     }
   }
@@ -268,23 +362,39 @@ class ClientStructure {
       }
     }
     const partsList = attrs[PARTS_LIST_ATTR_ID];
-    if (Array.isArray(partsList)) {
-      for (const partNo of partsList) {
-        if (typeof partNo !== "number") {
+    if (!Array.isArray(partsList)) {
+      return;
+    }
+    for (const partNo of partsList) {
+      if (typeof partNo !== "number") {
+        continue;
+      }
+      const part = this.#endpointFor(partNo);
+      let isAlreadyDescendant = false;
+      for (let owner = this.#ownerOf(part); owner; owner = this.#ownerOf(owner)) {
+        if (owner === endpoint) {
+          isAlreadyDescendant = true;
+          break;
+        }
+      }
+      if (isAlreadyDescendant) {
+        continue;
+      }
+      part.pendingOwner = endpoint;
+      this.#pending.set(part, "reparent");
+    }
+    if (endpoint.endpoint.maybeNumber === 0) {
+      const numbersUsed = new Set(partsList);
+      for (const descendent of endpoint.endpoint.endpoints) {
+        if (!descendent.maybeNumber) {
           continue;
         }
-        const part = this.#endpointFor(partNo);
-        let isAlreadyDescendant = false;
-        for (let owner = part.endpoint.owner; owner; owner = owner.owner) {
-          if (owner === endpoint.endpoint) {
-            isAlreadyDescendant = true;
-            break;
+        if (!numbersUsed.has(descendent.number)) {
+          const endpoint2 = this.#endpoints[descendent.number];
+          if (endpoint2) {
+            this.#pending.set(endpoint2, "erase");
           }
         }
-        if (isAlreadyDescendant) {
-          continue;
-        }
-        part.endpoint.owner = endpoint.endpoint;
       }
     }
   }
@@ -314,12 +424,34 @@ class ClientStructure {
       return cluster;
     }
     cluster = {
+      kind: "discovered",
       id,
       store: this.#nodeStore.storeForEndpoint(endpoint.endpoint).createStoreForBehavior(id.toString())
     };
     endpoint.clusters[id] = cluster;
     return cluster;
   }
+  #ownerOf(endpoint) {
+    if (endpoint.pendingOwner) {
+      return endpoint.pendingOwner;
+    }
+    if (endpoint.endpoint.number === 0) {
+      return;
+    }
+    const ownerNumber = endpoint.endpoint.owner?.maybeNumber;
+    if (ownerNumber !== void 0) {
+      return this.#endpointFor(ownerNumber);
+    }
+  }
+  #install(endpoint) {
+    const { pendingOwner } = endpoint;
+    if (!pendingOwner) {
+      return;
+    }
+    endpoint.endpoint.owner = pendingOwner.endpoint;
+    endpoint.pendingOwner = void 0;
+    this.#events.emitEndpoint(endpoint.endpoint);
+  }
 }
 export {
   ClientStructure

package/dist/esm/node/client/ClientStructure.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/node/client/ClientStructure.ts"],
-  "mappings": "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",
-  "names": ["id"]
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AACzB,SAAS,oBAAoB;AAC7B,SAAS,oBAAoB;AAC7B,SAAS,eAAe,cAAc;AACtC;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEG;AAGP,SAAS,iBAA6C;AACtD,SAAS,uBAAuB;AAChC,SAAS,uBAAuB;AAEhC,SAAS,0BAA0B;AACnC,SAAS,6BAA6B;AACtC,SAAS,oBAAoB;AAE7B,MAAM,SAAS,OAAO,IAAI,iBAAiB;AAE3C,MAAM,2BAA2B,WAAW,QAAQ,WAAW,eAAe;AAC9E,MAAM,sBAAsB,WAAW,QAAQ,WAAW,WAAW;AACrE,MAAM,qBAAqB,WAAW,QAAQ,WAAW,UAAU;AAK5D,MAAM,gBAAgB;AAAA,EACzB;AAAA,EACA,aAAwD,CAAC;AAAA,EACzD;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW,oBAAI,IAA6C;AAAA,EAC5D;AAAA,EAEA,YAAY,MAAkB;AAC1B,SAAK,QAAQ;AACb,SAAK,aAAa,KAAK,IAAI,IAAI,eAAe;AAC9C,SAAK,WAAW,KAAK,MAAM,IAAI;AAAA,MAC3B,UAAU;AAAA,MACV,UAAU,CAAC;AAAA,IACf;AACA,SAAK,aAAa,mBAAmB,MAAM,IAAI;AAC/C,SAAK,UAAU,KAAK,MAAM,IAAI,IAAI,qBAAqB;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY;AACR,eAAW,SAAS,KAAK,WAAW,gBAAgB;AAChD,YAAM,KAAK,MAAM;AAGjB,YAAM,SAAS,OAAO,SAAS,EAAE;AACjC,UAAI,CAAC,OAAO,SAAS,MAAM,GAAG;AAC1B;AAAA,MACJ;AAEA,YAAM,WAAW,KAAK,aAAa,MAAwB;AAG3D,iBAAW,SAAS,MAAM,gBAAgB;AACtC,cAAMA,MAAK,OAAO,SAAS,KAAK;AAChC,YAAI,CAAC,OAAO,SAASA,GAAE,GAAG;AACtB;AAAA,QACJ;AAEA,cAAM,UAAU,KAAK,YAAY,UAAUA,GAAE;AAC7C,aAAK,oBAAoB,UAAU,OAAO;AAAA,MAC9C;AAAA,IACJ;AAEA,eAAW,CAAC,UAAU,MAAM,KAAK,KAAK,SAAS,QAAQ,GAAG;AACtD,WAAK,SAAS,OAAO,QAAQ;AAE7B,cAAQ,QAAQ;AAAA,QACZ,KAAK;AACD,eAAK,SAAS,QAAQ;AACtB;AAAA,QAEJ;AACI,gBAAM,IAAI,cAAc,cAAc,MAAM,sCAAsC;AAAA,MAC1F;AAAA,IACJ;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe,UAAoB,MAA4B;AAC3D,UAAM,oBAAoB,KAAK,aAAa,SAAS,MAAM;AAC3D,UAAM,mBAAmB,KAAK,YAAY,mBAAmB,KAAK,QAAQ,EAAE;AAE5E,WAAO,iBAAiB;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,cAAc,UAAoB,MAAqB;AACnD,WAAO,KAAK,WAAW,iBAAiB,QAAQ,EAAE,4BAA4B,KAAK,EAAE;AAAA,EACzF;AAAA;AAAA;AAAA;AAAA,EAKA,qBAAqC,SAAe;AAChD,UAAM,QAAQ,UAAU,OAAO;AAC/B,QAAI,SAAS;AAEb,eAAW;AAAA,MACP,UAAU,EAAE,QAAQ,WAAW;AAAA,MAC/B;AAAA,IACJ,KAAK,OAAO,OAAO,KAAK,UAAU,GAAG;AACjC,iBAAW;AAAA,QACP,IAAI;AAAA,QACJ,OAAO,EAAE,QAAQ;AAAA,MACrB,KAAK,OAAO,OAAO,QAAQ,GAAG;AAC1B,YAAI,CAAC,MAAM,WAAW,YAAY,SAAS,GAAG;AAC1C;AAAA,QACJ;AAEA,YAAI,YAAY,WAAW,iBAAiB;AACxC;AAAA,QACJ;AAEA,YAAI,WAAW,SAAS;AACpB,mBAAS,EAAE,GAAG,QAAQ;AAAA,QAC1B;AAEA,YAAI,OAAO,uBAAuB,QAAW;AACzC,iBAAO,qBAAqB,CAAC;AAAA,QACjC;AAEA,eAAO,mBAAmB,KAAK,EAAE,MAAM,EAAE,YAAY,UAAU,GAAG,aAAa,QAAQ,CAAC;AAAA,MAC5F;AAAA,IACJ;AAEA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,OAAO,SAAe,SAAqB;AAE9C;AAAA;AAAA,YAAM,QAAQ,sBAAM,KAAK,MAAM,UAAU,MAAM,KAAK;AAGpD,UAAI;AAGJ,YAAM,QAAQ,UAAU,OAAO;AAC/B,uBAAiB,SAAS,SAAS;AAC/B,mBAAW,UAAU,OAAO;AACxB,kBAAQ,OAAO,MAAM;AAAA,YACjB,KAAK;AACD,+BAAiB,MAAM,KAAK,iBAAiB,QAAQ,OAAO,cAAc;AAC1E;AAAA,YAEJ,KAAK;AACD,mBAAK,WAAW,MAAM;AACtB;AAAA,UAGR;AAAA,QACJ;AAEA,cAAM;AAAA,MACV;AAGA,UAAI,gBAAgB;AAChB,cAAM,KAAK,eAAe,cAAc;AAAA,MAC5C;AAIA,iBAAW,CAAC,UAAU,MAAM,KAAK,KAAK,SAAS,QAAQ,GAAG;AACtD,aAAK,SAAS,OAAO,QAAQ;AAE7B,gBAAQ,QAAQ;AAAA,UACZ,KAAK;AACD,iBAAK,SAAS,QAAQ;AACtB;AAAA,UAEJ,KAAK;AACD,mBAAO,MAAM,qBAAqB,SAAS,QAAQ,8CAA8C;AACjG,mBAAO,KAAK,WAAW,SAAS,SAAS,MAAM;AAC/C,gBAAI;AACA,oBAAM,SAAS,SAAS,OAAO;AAAA,YACnC,SAAS,GAAG;AACR,qBAAO,MAAM,+BAA+B,SAAS,QAAQ,KAAK,CAAC;AAAA,YACvE;AACA;AAAA,QACR;AAAA,MACJ;AAAA,aAlDA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmDJ;AAAA;AAAA,EAGA,IAAc,2BAA2B;AACrC,QAAI,KAAK,8BAA8B,QAAW;AAC9C,WAAK,4BAA4B,KAAK,MAAM,MAAM,QAAQ,qBAAqB,oBAAoB;AACnG,WAAK,MAAM,OAAO,QAAQ,4BAA4B,GAAG,qBAAmB;AACxE,aAAK,4BAA4B,iBAAiB,oBAAoB;AAAA,MAC1E,CAAC;AAAA,IACL;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,MAAM,iBACF,QACA,OACA,gBACF;AAEE,QAAI,KAAK,6BAA6B,MAAM,kBAAkB;AAC1D,aAAO;AAAA,IACX;AAEA,UAAM,EAAE,YAAY,WAAW,YAAY,IAAI,OAAO;AAItD,QAAI,mBAAmB,eAAe,eAAe,cAAc,eAAe,cAAc,YAAY;AACxG,YAAM,KAAK,eAAe,cAAc;AACxC,uBAAiB;AAAA,IACrB;AAEA,QAAI,mBAAmB,QAAW;AAE9B,uBAAiB;AAAA,QACb;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,UACJ,CAAC,WAAW,GAAG,OAAO;AAAA,QAC1B;AAAA,MACJ;AAGA,UAAI,MAAM,WAAW,YAAY,SAAS,GAAG;AACzC,uBAAe,OAAO,gBAAgB,WAAW,IAAI,OAAO;AAAA,MAChE;AAAA,IACJ,OAAO;AAEH,qBAAe,OAAO,WAAW,IAAI,OAAO;AAAA,IAChD;AAEA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,UAA0B,SAAoB;AACrD,UAAM,KAAK,KAAK,aAAa,QAAQ;AACrC,QAAI,CAAC,IAAI;AACL;AAAA,IACJ;AAEA,WAAO,KAAK,YAAY,IAAI,OAAO,GAAG,UAAU;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY,UAAgD;AACxD,WAAO,KAAK,WAAW,QAAQ,GAAG;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,eAAe,OAAyB;AAE1C,UAAM,WAAW,KAAK,aAAa,MAAM,UAAU;AACnD,UAAM,UAAU,KAAK,YAAY,UAAU,MAAM,SAAS;AAC1D,UAAM,QAAQ,MAAM,YAAY,MAAM,MAAM;AAC5C,SAAK,oBAAoB,UAAU,OAAO;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,oBAAoB,UAA6B,SAA2B;AAExE,QAAI,QAAQ,aAAa,UAAa,QAAQ,MAAM,eAAe;AAC/D,YAAM;AAAA,QACF,CAAC,gBAAgB,EAAE,GAAG;AAAA,QACtB,CAAC,WAAW,EAAE,GAAG;AAAA,QACjB,CAAC,cAAc,EAAE,GAAG;AAAA,QACpB,CAAC,oBAAoB,EAAE,GAAG;AAAA,MAC9B,IAAI,QAAQ,MAAM;AAElB,UAAI,OAAO,oBAAoB,UAAU;AACrC,gBAAQ,WAAW;AAAA,MACvB;AAEA,UAAI,OAAO,aAAa,YAAY,aAAa,QAAQ,CAAC,MAAM,QAAQ,QAAQ,GAAG;AAC/E,gBAAQ,WAAW;AAAA,MACvB;AAEA,UAAI,MAAM,QAAQ,aAAa,GAAG;AAC9B,gBAAQ,aAAa,cAAc,OAAO,UAAQ,OAAO,SAAS,QAAQ;AAAA,MAC9E;AAEA,UAAI,MAAM,QAAQ,WAAW,GAAG;AAC5B,gBAAQ,WAAW,YAAY,OAAO,SAAO,OAAO,QAAQ,QAAQ;AAAA,MACxE;AAEA,UACI,QAAQ,aAAa,UACrB,QAAQ,aAAa,UACrB,QAAQ,eAAe,UACvB,QAAQ,aAAa,QACvB;AACE,gBAAQ,WAAW,aAAa,OAAoC;AACpE,iBAAS,SAAS,UAAU,QAAQ,QAAQ,QAAQ;AACpD,YAAI,SAAS,SAAS,UAAU,aAAa;AACzC,eAAK,QAAQ,YAAY,SAAS,UAAU,QAAQ,QAAQ;AAAA,QAChE;AAAA,MACJ;AAAA,IACJ;AAGA,QAAI,QAAQ,OAAO,WAAW,QAAQ,IAAI;AACtC,UAAI;AACJ,UAAI,QAAQ,YAAY,SAAS,SAAS,UAAU,SAAS,QAAQ,SAAS,EAAE,GAAG;AAC/E,gBAAQ,SAAS,SAAS,QAAQ,QAAQ,QAAQ;AAAA,MACtD,OAAO;AACH,gBAAQ,QAAQ,MAAM,iBAAiB,CAAC;AAAA,MAC5C;AACA,WAAK,uBAAuB,UAAU,KAAK;AAAA,IAC/C;AAAA,EACJ;AAAA,EAEA,uBAAuB,UAA6B,OAAgC;AAChF,UAAM,iBAAiB,MAAM,wBAAwB;AACrD,QAAI,MAAM,QAAQ,cAAc,GAAG;AAC/B,YAAM,eAAe,SAAS,SAAS;AACvC,iBAAW,MAAM,gBAAgB;AAC7B,YAAI,OAAO,IAAI,eAAe,UAAU;AACpC;AAAA,QACJ;AAEA,YAAI,QAAQ;AACZ,cAAM,QAAQ,OAAO,IAAI,iBAAiB,GAAG,UAAU;AACvD,YAAI,UAAU,QAAW;AACrB,kBAAQ,qBAAqB,cAAc,MAAM,cAAc;AAAA,QACnE;AAGA,YAAI,CAAC,SAAS,SAAS,UAAU,aAAa,eAAe,aAAa,YAAY;AAClF,uBAAa,iBAAiB,GAAG;AACjC;AAAA,QACJ;AAGA,YAAI,aAAa,eAAe,UAAa,CAAC,OAAO;AACjD;AAAA,QACJ;AAEA,qBAAa,aAAa,GAAG;AAC7B,qBAAa,iBAAiB,GAAG;AACjC,qBAAa,cAAc,OAAO,kBAAkB,qBAAqB;AAIzE,YAAI,OAAO;AACP;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAEA,UAAM,aAAa,MAAM,mBAAmB;AAC5C,QAAI,MAAM,QAAQ,UAAU,GAAG;AAI3B,iBAAW,WAAW,YAAY;AAC9B,YAAI,OAAO,YAAY,UAAU;AAC7B,eAAK,YAAY,UAAU,OAAoB;AAAA,QACnD;AAAA,MACJ;AAAA,IACJ;AAGA,UAAM,YAAY,MAAM,kBAAkB;AAC1C,QAAI,CAAC,MAAM,QAAQ,SAAS,GAAG;AAC3B;AAAA,IACJ;AAGA,eAAW,UAAU,WAAW;AAC5B,UAAI,OAAO,WAAW,UAAU;AAC5B;AAAA,MACJ;AAEA,YAAM,OAAO,KAAK,aAAa,MAAwB;AAEvD,UAAI,sBAAsB;AAC1B,eAAS,QAAQ,KAAK,SAAS,IAAI,GAAG,OAAO,QAAQ,KAAK,SAAS,KAAK,GAAG;AACvE,YAAI,UAAU,UAAU;AACpB,gCAAsB;AACtB;AAAA,QACJ;AAAA,MACJ;AAEA,UAAI,qBAAqB;AACrB;AAAA,MACJ;AAEA,WAAK,eAAe;AACpB,WAAK,SAAS,IAAI,MAAM,UAAU;AAAA,IACtC;AAIA,QAAI,SAAS,SAAS,gBAAgB,GAAG;AACrC,YAAM,cAAc,IAAI,IAAI,SAAS;AACrC,iBAAW,cAAe,SAAS,SAAkB,WAAW;AAE5D,YAAI,CAAC,WAAW,aAAa;AACzB;AAAA,QACJ;AAEA,YAAI,CAAC,YAAY,IAAI,WAAW,MAAM,GAAG;AACrC,gBAAMC,YAAW,KAAK,WAAW,WAAW,MAAM;AAClD,cAAIA,WAAU;AACV,iBAAK,SAAS,IAAIA,WAAU,OAAO;AAAA,UACvC;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,aAAa,QAAwB;AACjC,QAAI,WAAW,KAAK,WAAW,MAAM;AACrC,QAAI,UAAU;AACV,aAAO;AAAA,IACX;AAEA,eAAW;AAAA,MACP,UAAU,IAAI,SAAS;AAAA,QACnB,IAAI,KAAK,MAAM;AAAA,QACf;AAAA,QACA,MAAM,aAAa;AAAA,UACf,MAAM;AAAA,UACN,YAAY,aAAa;AAAA,UACzB,gBAAgB,aAAa;AAAA,QACjC,CAAC;AAAA,MACL,CAAC;AAAA,MACD,UAAU,CAAC;AAAA,IACf;AACA,SAAK,WAAW,MAAM,IAAI;AAE1B,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,UAA6B,IAAe;AACpD,QAAI,UAAU,SAAS,SAAS,EAAE;AAClC,QAAI,SAAS;AACT,aAAO;AAAA,IACX;AAEA,cAAU;AAAA,MACN,MAAM;AAAA,MACN;AAAA,MACA,OAAO,KAAK,WAAW,iBAAiB,SAAS,QAAQ,EAAE,uBAAuB,GAAG,SAAS,CAAC;AAAA,IACnG;AACA,aAAS,SAAS,EAAE,IAAI;AAExB,WAAO;AAAA,EACX;AAAA,EAEA,SAAS,UAA6B;AAClC,QAAI,SAAS,cAAc;AACvB,aAAO,SAAS;AAAA,IACpB;AAGA,QAAI,SAAS,SAAS,WAAW,GAAG;AAChC;AAAA,IACJ;AAEA,UAAM,cAAc,SAAS,SAAS,OAAO;AAC7C,QAAI,gBAAgB,QAAW;AAC3B,aAAO,KAAK,aAAa,WAAW;AAAA,IACxC;AAAA,EACJ;AAAA,EAEA,SAAS,UAA6B;AAClC,UAAM,EAAE,aAAa,IAAI;AACzB,QAAI,CAAC,cAAc;AACf;AAAA,IACJ;AAEA,aAAS,SAAS,QAAQ,aAAa;AACvC,aAAS,eAAe;AACxB,SAAK,QAAQ,aAAa,SAAS,QAAQ;AAAA,EAC/C;AACJ;",
+  "names": ["id", "endpoint"]
 }

package/dist/esm/node/client/ClientStructureEvents.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "#behavior/Behavior.js";
+import { ClusterBehavior } from "#behavior/cluster/ClusterBehavior.js";
+import { Endpoint } from "#endpoint/Endpoint.js";
+import { EndpointType } from "#endpoint/type/EndpointType.js";
+import { Environment, Environmental, Observable } from "#general";
+/**
+ * An environmental service that manages events endpoint and behavior types.
+ */
+export declare class ClientStructureEvents {
+    #private;
+    static [Environmental.create](env: Environment): ClientStructureEvents;
+    endpointInstalled<T extends EndpointType>(type: T): Observable<[endpoint: Endpoint<T>]>;
+    clusterInstalled<T extends ClusterBehavior.Type>(type: T): Observable<[endpoint: Endpoint, type: T]>;
+    emitEndpoint(endpoint: Endpoint): void;
+    emitCluster(endpoint: Endpoint, type: Behavior.Type): void;
+}
+//# sourceMappingURL=ClientStructureEvents.d.ts.map

package/dist/esm/node/client/ClientStructureEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientStructureEvents.d.ts","sourceRoot":"","sources":["../../../../src/node/client/ClientStructureEvents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGlE;;GAEG;AACH,qBAAa,qBAAqB;;IAU9B,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW;IAM9C,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAavF,gBAAgB,CAAC,CAAC,SAAS,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAsBpG,YAAY,CAAC,QAAQ,EAAE,QAAQ;IAiB/B,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI;CAWtD"}

package/dist/esm/node/client/ClientStructureEvents.js

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DescriptorClient } from "#behaviors/descriptor";
+import { Environmental, Observable } from "#general";
+class ClientStructureEvents {
+  #endpointEvents;
+  #clusterEvents;
+  static [Environmental.create](env) {
+    const instance = new ClientStructureEvents();
+    env.set(ClientStructureEvents, instance);
+    return instance;
+  }
+  endpointInstalled(type) {
+    if (this.#endpointEvents === void 0) {
+      this.#endpointEvents = /* @__PURE__ */ new Map();
+    }
+    let event = this.#endpointEvents.get(type.deviceType);
+    if (event === void 0) {
+      this.#endpointEvents.set(type.deviceType, event = Observable());
+    }
+    return event;
+  }
+  clusterInstalled(type) {
+    if (this.#clusterEvents === void 0) {
+      this.#clusterEvents = /* @__PURE__ */ new Map();
+    }
+    let events = this.#clusterEvents.get(type.id);
+    if (events === void 0) {
+      this.#clusterEvents.set(type.id, events = []);
+    }
+    for (const { requestedType, event: event2 } of events) {
+      if (requestedType.supports(type)) {
+        return event2;
+      }
+    }
+    const event = Observable();
+    events.push({ requestedType: type, event });
+    return event;
+  }
+  emitEndpoint(endpoint) {
+    if (this.#endpointEvents && endpoint.behaviors.supported.descriptor) {
+      const deviceTypes = endpoint.stateOf(DescriptorClient).deviceTypeList;
+      for (const dt of deviceTypes) {
+        this.#endpointEvents.get(dt.deviceType)?.emit(endpoint);
+      }
+    }
+    for (const type of Object.values(endpoint.behaviors.supported)) {
+      this.emitCluster(endpoint, type);
+    }
+    for (const part of endpoint.parts) {
+      this.emitEndpoint(part);
+    }
+  }
+  emitCluster(endpoint, type) {
+    const events = this.#clusterEvents?.get(type.id);
+    if (!events) {
+      return;
+    }
+    for (const { requestedType, event } of events) {
+      if (type.supports(requestedType)) {
+        event.emit(endpoint, type);
+      }
+    }
+  }
+}
+export {
+  ClientStructureEvents
+};
+//# sourceMappingURL=ClientStructureEvents.js.map

package/dist/esm/node/client/ClientStructureEvents.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/node/client/ClientStructureEvents.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,wBAAwB;AAGjC,SAAsB,eAAe,kBAAkB;AAMhD,MAAM,sBAAsB;AAAA,EAC/B;AAAA,EACA;AAAA,EAQA,QAAQ,cAAc,MAAM,EAAE,KAAkB;AAC5C,UAAM,WAAW,IAAI,sBAAsB;AAC3C,QAAI,IAAI,uBAAuB,QAAQ;AACvC,WAAO;AAAA,EACX;AAAA,EAEA,kBAA0C,MAA8C;AACpF,QAAI,KAAK,oBAAoB,QAAW;AACpC,WAAK,kBAAkB,oBAAI,IAAI;AAAA,IACnC;AAEA,QAAI,QAAQ,KAAK,gBAAgB,IAAI,KAAK,UAAU;AACpD,QAAI,UAAU,QAAW;AACrB,WAAK,gBAAgB,IAAI,KAAK,YAAa,QAAQ,WAAW,CAAE;AAAA,IACpE;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,iBAAiD,MAAoD;AACjG,QAAI,KAAK,mBAAmB,QAAW;AACnC,WAAK,iBAAiB,oBAAI,IAAI;AAAA,IAClC;AAEA,QAAI,SAAS,KAAK,eAAe,IAAI,KAAK,EAAE;AAC5C,QAAI,WAAW,QAAW;AACtB,WAAK,eAAe,IAAI,KAAK,IAAK,SAAS,CAAC,CAAE;AAAA,IAClD;AAEA,eAAW,EAAE,eAAe,OAAAA,OAAM,KAAK,QAAQ;AAC3C,UAAI,cAAc,SAAS,IAAI,GAAG;AAC9B,eAAOA;AAAA,MACX;AAAA,IACJ;AAEA,UAAM,QAAQ,WAAW;AACzB,WAAO,KAAK,EAAE,eAAe,MAAM,MAAM,CAAC;AAE1C,WAAO;AAAA,EACX;AAAA,EAEA,aAAa,UAAoB;AAC7B,QAAI,KAAK,mBAAmB,SAAS,UAAU,UAAU,YAAY;AACjE,YAAM,cAAc,SAAS,QAAQ,gBAAgB,EAAE;AACvD,iBAAW,MAAM,aAAa;AAC1B,aAAK,gBAAgB,IAAI,GAAG,UAAU,GAAG,KAAK,QAAQ;AAAA,MAC1D;AAAA,IACJ;AAEA,eAAW,QAAQ,OAAO,OAAO,SAAS,UAAU,SAAS,GAAG;AAC5D,WAAK,YAAY,UAAU,IAAI;AAAA,IACnC;AAEA,eAAW,QAAQ,SAAS,OAAO;AAC/B,WAAK,aAAa,IAAI;AAAA,IAC1B;AAAA,EACJ;AAAA,EAEA,YAAY,UAAoB,MAAqB;AACjD,UAAM,SAAS,KAAK,gBAAgB,IAAI,KAAK,EAAE;AAC/C,QAAI,CAAC,QAAQ;AACT;AAAA,IACJ;AACA,eAAW,EAAE,eAAe,MAAM,KAAK,QAAQ;AAC3C,UAAI,KAAK,SAAS,aAAa,GAAG;AAC9B,cAAM,KAAK,UAAU,IAAI;AAAA,MAC7B;AAAA,IACJ;AAAA,EACJ;AACJ;",
+  "names": ["event"]
+}

package/dist/esm/node/client/PeerBehavior.d.ts

@@ -11,7 +11,13 @@ import { AttributeId, ClusterId, CommandId } from "#types";
  */
 export declare function PeerBehavior(shape: PeerBehavior.ClusterShape): ClusterBehavior.Type;
 export declare namespace PeerBehavior {
-    interface ClusterShape {
+    type ClusterShape = DiscoveredClusterShape | KnownClusterShape;
+    /**
+     * A cluster shape that we assemble using a combination of Matter standards and metadata discovered by reading from
+     * a peer.
+     */
+    interface DiscoveredClusterShape {
+        kind: "discovered";
         id: ClusterId;
         revision: number;
         features: FeatureBitmap | number;
@@ -20,5 +26,12 @@ export declare namespace PeerBehavior {
         attributeNames: Record<AttributeId, string>;
         commandNames: Record<CommandId, string>;
     }
+    /**
+     * A known cluster shape that we instrument as is.
+     */
+    interface KnownClusterShape {
+        kind: "known";
+        behavior: ClusterBehavior.Type;
+    }
 }
 //# sourceMappingURL=PeerBehavior.d.ts.map

package/dist/esm/node/client/PeerBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerBehavior.d.ts","sourceRoot":"","sources":["../../../../src/node/client/PeerBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAEvE,OAAO,EAA2D,aAAa,EAAU,MAAM,QAAQ,CAAC;AAIxG,OAAO,EAEH,WAAW,EAEX,SAAS,EAGT,SAAS,EAMZ,MAAM,QAAQ,CAAC;AAMhB;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,YAAY,GAAG,eAAe,CAAC,IAAI,CAoBnF;AAED,yBAAiB,YAAY,CAAC;IAC1B,UAAiB,YAAY;QACzB,EAAE,EAAE,SAAS,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC;QACjC,UAAU,EAAE,WAAW,EAAE,CAAC;QAC1B,QAAQ,EAAE,SAAS,EAAE,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC5C,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;KAC3C;CACJ"}
+{"version":3,"file":"PeerBehavior.d.ts","sourceRoot":"","sources":["../../../../src/node/client/PeerBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAGvE,OAAO,EAOH,aAAa,EAGhB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAEH,WAAW,EAEX,SAAS,EAGT,SAAS,EAIZ,MAAM,QAAQ,CAAC;AAUhB;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,YAAY,GAAG,eAAe,CAAC,IAAI,CAsBnF;AAED,yBAAiB,YAAY,CAAC;IAC1B,KAAY,YAAY,GAAG,sBAAsB,GAAG,iBAAiB,CAAC;IAEtE;;;OAGG;IACH,UAAiB,sBAAsB;QACnC,IAAI,EAAE,YAAY,CAAC;QACnB,EAAE,EAAE,SAAS,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC;QACjC,UAAU,EAAE,WAAW,EAAE,CAAC;QAC1B,QAAQ,EAAE,SAAS,EAAE,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC5C,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;KAC3C;IAED;;OAEG;IACH,UAAiB,iBAAiB;QAC9B,IAAI,EAAE,OAAO,CAAC;QACd,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC;KAClC;CACJ"}