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

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

@@ -3,6 +3,10 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -16,6 +20,47 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+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();
+};
 var ClientStructure_exports = {};
 __export(ClientStructure_exports, {
   ClientStructure: () => ClientStructure
@@ -26,17 +71,20 @@ var import_descriptor = require("#clusters/descriptor");
 var import_Endpoint = require("#endpoint/Endpoint.js");
 var import_EndpointType = require("#endpoint/type/EndpointType.js");
 var import_root = require("#endpoints/root");
+var import_general = require("#general");
 var import_model = require("#model");
 var import_protocol = require("#protocol");
 var import_DatasourceCache = require("#storage/client/DatasourceCache.js");
 var import_storage = require("#storage/index.js");
 var import_ClientEventEmitter = require("./ClientEventEmitter.js");
+var import_ClientStructureEvents = require("./ClientStructureEvents.js");
 var import_PeerBehavior = require("./PeerBehavior.js");
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+const logger = import_general.Logger.get("ClientStructure");
 const DEVICE_TYPE_LIST_ATTR_ID = import_descriptor.Descriptor.Cluster.attributes.deviceTypeList.id;
 const SERVER_LIST_ATTR_ID = import_descriptor.Descriptor.Cluster.attributes.serverList.id;
 const PARTS_LIST_ATTR_ID = import_descriptor.Descriptor.Cluster.attributes.partsList.id;
@@ -46,6 +94,8 @@ class ClientStructure {
   #emitEvent;
   #node;
   #subscribedFabricFiltered;
+  #pending = /* @__PURE__ */ new Map();
+  #events;
   constructor(node) {
     this.#node = node;
     this.#nodeStore = node.env.get(import_storage.ClientNodeStore);
@@ -54,6 +104,7 @@ class ClientStructure {
       clusters: {}
     };
     this.#emitEvent = (0, import_ClientEventEmitter.ClientEventEmitter)(node, this);
+    this.#events = this.#node.env.get(import_ClientStructureEvents.ClientStructureEvents);
   }
   /**
    * Load initial structure from cache.
@@ -72,7 +123,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 import_general.InternalError(`Unexpected ${opcode} operation in initial hierarchy load`);
       }
     }
   }
@@ -127,23 +188,48 @@ class ClientStructure {
    * Update the node structure by applying attribute changes.
    */
   async *mutate(request, changes) {
-    const scope = (0, import_protocol.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 = (0, import_protocol.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. */
@@ -206,7 +292,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
@@ -216,15 +302,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 {
         [import_model.ClusterRevision.id]: clusterRevision,
         [import_model.FeatureMap.id]: features,
         [import_model.AttributeList.id]: attributeList,
         [import_model.AcceptedCommandList.id]: commandList
-      } = attrs;
+      } = cluster.store.initialValues;
       if (typeof clusterRevision === "number") {
         cluster.revision = clusterRevision;
       }
@@ -240,9 +325,18 @@ class ClientStructure {
       if (cluster.revision !== void 0 && cluster.features !== void 0 && cluster.attributes !== void 0 && cluster.commands !== void 0) {
         cluster.behavior = (0, import_PeerBehavior.PeerBehavior)(cluster);
         endpoint.endpoint.behaviors.require(cluster.behavior);
+        if (endpoint.endpoint.lifecycle.isInstalled) {
+          this.#events.emitCluster(endpoint.endpoint, cluster.behavior);
+        }
       }
     }
     if (cluster.id === import_descriptor.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);
     }
   }
@@ -283,23 +377,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;
       }
     }
   }
@@ -329,11 +439,33 @@ 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);
+  }
 }
 //# sourceMappingURL=ClientStructure.js.map

package/dist/cjs/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": "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",
+  "names": ["id", "endpoint"]
 }

package/dist/cjs/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/cjs/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/cjs/node/client/ClientStructureEvents.js

@@ -0,0 +1,92 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ClientStructureEvents_exports = {};
+__export(ClientStructureEvents_exports, {
+  ClientStructureEvents: () => ClientStructureEvents
+});
+module.exports = __toCommonJS(ClientStructureEvents_exports);
+var import_descriptor = require("#behaviors/descriptor");
+var import_general = require("#general");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ClientStructureEvents {
+  #endpointEvents;
+  #clusterEvents;
+  static [import_general.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 = (0, import_general.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 = (0, import_general.Observable)();
+    events.push({ requestedType: type, event });
+    return event;
+  }
+  emitEndpoint(endpoint) {
+    if (this.#endpointEvents && endpoint.behaviors.supported.descriptor) {
+      const deviceTypes = endpoint.stateOf(import_descriptor.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);
+      }
+    }
+  }
+}
+//# sourceMappingURL=ClientStructureEvents.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/node/client/ClientStructureEvents.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,wBAAiC;AAGjC,qBAAuD;AAXvD;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,sBAAsB;AAAA,EAC/B;AAAA,EACA;AAAA,EAQA,QAAQ,6BAAc,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,YAAQ,2BAAW,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,YAAQ,2BAAW;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,kCAAgB,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/cjs/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/cjs/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"}