@matter/node 0.11.9 → 0.12.0-alpha.0-20241213-fcd71a96d

package/dist/esm/endpoint/server/BehaviorServer.js

@@ -0,0 +1,269 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AccessControl } from "#behavior/AccessControl.js";
+import { Contextual, Resource } from "#behavior/index.js";
+import { StructManager } from "#behavior/state/managed/values/StructManager.js";
+import { Status } from "#behavior/state/transaction/Status.js";
+import {
+  camelize,
+  Diagnostic,
+  ImplementationError,
+  InternalError,
+  isObject,
+  Logger,
+  MaybePromise,
+  ObserverGroup
+} from "#general";
+import { ElementTag } from "#model";
+import {
+  AttributeServer,
+  CommandServer,
+  createAttributeServer as ConstructAttributeServer,
+  EventServer,
+  FabricManager,
+  OccurrenceManager,
+  SecureSession
+} from "#protocol";
+const logger = Logger.get("BehaviorServer");
+function BehaviorServer(endpointServer, type) {
+  const { id, name, attributes, commands, events } = type.cluster;
+  const { endpoint } = endpointServer;
+  const datasource = createClusterDatasource(endpoint, type);
+  const observers = new ObserverGroup();
+  const clusterServer = {
+    id,
+    name,
+    datasource,
+    attributes: {},
+    commands: {},
+    events: {},
+    close() {
+      observers.close();
+    }
+  };
+  const stateView = endpoint.stateOf(type);
+  const observables = endpoint.eventsOf(type);
+  const elements = endpointServer.endpoint.behaviors.elementsOf(type);
+  for (const name2 of elements.attributes) {
+    const attribute = attributes[name2];
+    const server = createAttributeServer(
+      name2,
+      attribute,
+      endpoint,
+      type,
+      datasource,
+      stateView,
+      observables,
+      observers
+    );
+    clusterServer.attributes[name2] = server;
+    server.assignToEndpoint(endpointServer);
+  }
+  for (const name2 of elements.commands) {
+    const command = commands[name2];
+    clusterServer.commands[name2] = createCommandServer(name2, command, endpoint, type);
+  }
+  for (const name2 of elements.events) {
+    const server = createEventServer(name2, events[name2], endpoint, type, observables, observers);
+    clusterServer.events[name2] = server;
+    server.assignToEndpoint(endpointServer);
+  }
+  return clusterServer;
+}
+function createClusterDatasource(endpoint, type) {
+  const env = endpoint.env;
+  return {
+    get version() {
+      return endpoint.behaviors.versionOf(type);
+    },
+    get eventHandler() {
+      return env.get(OccurrenceManager);
+    },
+    get fabrics() {
+      return env.get(FabricManager).fabrics;
+    },
+    // We handle change management ourselves
+    changed() {
+    },
+    // We handle version management ourselves
+    increaseVersion() {
+      return this.version;
+    }
+  };
+}
+function createAttributeServer(name, definition, endpoint, type, datasource, stateView, observables, observers) {
+  function getter(_session, _endpoint, _isFabricFiltered, message) {
+    if (!message) {
+      return stateView[name];
+    }
+    const behavior = behaviorFor(endpoint, type, message);
+    behavior.context.activity?.frame(`read ${name}`);
+    const trace = behavior.context.trace;
+    if (trace) {
+      trace.path = endpoint.path.at(name);
+    }
+    logger.debug("Read", Diagnostic.strong(`${endpoint}.state.${name}`), "via", behavior.context.transaction.via);
+    const state = behavior.state;
+    StructManager.assertDirectReadAuthorized(state, name);
+    if (trace) {
+      trace.output = state[name];
+    }
+    return state[name];
+  }
+  function setter(value, _session, _endpoint, message) {
+    const behavior = behaviorFor(endpoint, type, message);
+    behavior.context.activity?.frame(`write ${name}`);
+    logger.info("Write", Diagnostic.strong(`${endpoint}.state.${name}`), "via", behavior.context.transaction.via);
+    const trace = behavior.context.trace;
+    if (trace) {
+      trace.path = endpoint.path.at(name);
+      trace.input = value;
+    }
+    const state = behavior.state;
+    state[name] = value;
+    return behavior.context.transaction?.status === Status.Exclusive;
+  }
+  const server = ConstructAttributeServer(
+    type.cluster,
+    definition,
+    name,
+    stateView[name],
+    datasource,
+    getter,
+    setter
+  );
+  if (server instanceof AttributeServer) {
+    const observable = observables[`${name}$Changed`];
+    if (observable !== void 0) {
+      observers.on(observable, (_value, _oldValue, context) => {
+        const session = context.session;
+        if (session instanceof SecureSession) {
+          server.updated(session);
+        } else {
+          server.updatedLocal();
+        }
+      });
+    }
+  }
+  return server;
+}
+function createCommandServer(name, definition, endpoint, type) {
+  const schema = type.schema?.member(camelize(name, true), [ElementTag.Command]);
+  if (schema === void 0) {
+    throw new ImplementationError(`There is no metadata for command ${name}`);
+  }
+  const access = AccessControl(schema);
+  const handler = (request, _session, message) => {
+    let requestDiagnostic;
+    if (isObject(request)) {
+      requestDiagnostic = Diagnostic.dict(request);
+    } else if (request !== void 0) {
+      requestDiagnostic = request;
+    } else {
+      requestDiagnostic = Diagnostic.weak("(no payload)");
+    }
+    const behavior = behaviorFor(endpoint, type, message);
+    const path = endpoint.path.at(name);
+    const trace = behavior.context.trace;
+    if (trace) {
+      trace.path = endpoint.path.at(name);
+      trace.input = request;
+    }
+    logger.info("Invoke", Diagnostic.strong(path.toString()), behavior.context.transaction.via, requestDiagnostic);
+    access.authorizeInvoke(behavior.context, {
+      path,
+      cluster: behavior.cluster.id
+    });
+    let isAsync = false;
+    let activity;
+    let result;
+    try {
+      activity = behavior.context?.activity?.frame(`invoke ${name}`);
+      const invoke = behavior[name].bind(behavior);
+      if (behavior.constructor.lockOnInvoke) {
+        const tx = behavior.context.transaction;
+        if (Resource.isLocked(behavior)) {
+          result = async function invokeAsync() {
+            await tx.addResources(behavior);
+            await tx.begin();
+            return invoke(request);
+          }();
+        } else {
+          tx.addResourcesSync(behavior);
+          tx.beginSync();
+          result = invoke(request);
+        }
+      } else {
+        result = invoke(request);
+      }
+      if (MaybePromise.is(result)) {
+        isAsync = true;
+        result = Promise.resolve(result).then((result2) => {
+          if (trace) {
+            trace.output = result2;
+          }
+          return result2;
+        }).finally(() => activity?.[Symbol.dispose]());
+      } else if (trace) {
+        trace.output = result;
+      }
+    } finally {
+      if (!isAsync) {
+        activity?.[Symbol.dispose]();
+      }
+    }
+    return result;
+  };
+  const server = new CommandServer(
+    definition.requestId,
+    definition.responseId,
+    name,
+    definition.requestSchema,
+    definition.responseSchema,
+    definition.timed,
+    definition.invokeAcl,
+    handler
+  );
+  server.debug = () => {
+  };
+  return server;
+}
+function createEventServer(name, definition, endpoint, type, observables, observers) {
+  const observable = observables[name];
+  const server = new EventServer(
+    definition.id,
+    type.cluster.id,
+    name,
+    definition.schema,
+    definition.priority,
+    definition.readAcl
+  );
+  if (observable !== void 0) {
+    observers.on(observable, (payload, _context) => {
+      const maybePromise = server.triggerEvent(payload);
+      if (MaybePromise.is(maybePromise)) {
+        endpoint.env.runtime.add(maybePromise);
+      }
+    });
+  }
+  const promise = server.bindToEventHandler(endpoint.env.get(OccurrenceManager));
+  if (MaybePromise.is(promise)) {
+    throw new InternalError("Event handler binding returned a promise");
+  }
+  return server;
+}
+function behaviorFor(endpoint, type, message) {
+  const context = Contextual.contextOf(message);
+  if (!context) {
+    throw new InternalError("Message context not installed");
+  }
+  const agent = context.agentFor(endpoint);
+  return agent.get(type);
+}
+export {
+  BehaviorServer
+};
+//# sourceMappingURL=BehaviorServer.js.map

package/dist/esm/endpoint/server/BehaviorServer.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/endpoint/server/BehaviorServer.ts"],
+  "mappings": "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",
+  "names": ["name", "result"]
+}

package/dist/{cjs/endpoint → esm/endpoint/server}/EndpointServer.d.ts

@@ -3,22 +3,21 @@
  * Copyright 2022-2024 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Behavior } from "#behavior/Behavior.js";
-import { BehaviorBacking } from "#behavior/internal/BehaviorBacking.js";
 import { ClusterClientObj, ClusterServer, EndpointInterface } from "#protocol";
 import { ClusterId, ClusterType, EndpointNumber } from "#types";
-import { Endpoint } from "./Endpoint.js";
+import { Endpoint } from "../Endpoint.js";
+import { BehaviorServer } from "./BehaviorServer.js";
 /**
  * EndpointServer makes an {@link Endpoint} available for remote access as an Endpoint on a Matter network.
  */
 export declare class EndpointServer implements EndpointInterface {
     #private;
-    get endpoint(): Endpoint<import("./index.js").EndpointType.Empty>;
+    get endpoint(): Endpoint<import("../index.js").EndpointType.Empty>;
     get deviceType(): import("#types").DeviceTypeId;
     constructor(endpoint: Endpoint);
-    createBacking(type: Behavior.Type): BehaviorBacking;
     get number(): EndpointNumber;
     get name(): string;
+    updateServers(): void;
     getNumber(): EndpointNumber;
     removeFromStructure(): void;
     updatePartsList(): EndpointNumber[];
@@ -28,7 +27,7 @@ export declare class EndpointServer implements EndpointInterface {
     close(): void;
     [Symbol.asyncDispose](): Promise<void>;
     setStructureChangedCallback(): void;
-    addClusterServer(server: ClusterServer): void;
+    addClusterServer(server: BehaviorServer): void;
     hasClusterServer(cluster: ClusterType): boolean;
     getClusterServer(cluster: ClusterType): ClusterServer | undefined;
     getClusterServerById(clusterId: ClusterId): ClusterServer | undefined;

package/dist/esm/endpoint/server/EndpointServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointServer.d.ts","sourceRoot":"","sources":["../../../../src/endpoint/server/EndpointServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD;;GAEG;AACH,qBAAa,cAAe,YAAW,iBAAiB;;IAKpD,IAAI,QAAQ,uDAEX;IAED,IAAI,UAAU,kCAEb;gBAEW,QAAQ,EAAE,QAAQ;IAqB9B,IAAI,MAAM,mBAET;IAED,IAAI,IAAI,WAEP;IAED,aAAa;IAcb,SAAS,IAAI,cAAc;IAO3B,mBAAmB,IAAI,IAAI;IAI3B,eAAe,IAAI,cAAc,EAAE;IAKnC,iBAAiB,IAAI,iBAAiB,EAAE;IAQxC,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAIvC,sBAAsB,IAAI,IAAI;IAI9B,KAAK,IAAI,IAAI;IAIP,CAAC,MAAM,CAAC,YAAY,CAAC;IAc3B,2BAA2B,IAAI,IAAI;IAInC,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAI9C,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAI/C,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS;IAOjE,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS;IAIrE,oBAAoB,IAAI,aAAa,EAAE;IAIvC,oBAAoB,IAAI,gBAAgB,EAAE;IAK1C,gBAAgB,IAAI,IAAI;IAIxB,gBAAgB,IAAI,GAAG;IAIvB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAQnD,gBAAgB,CAAC,EAAE,EAAE,cAAc,GAAG,iBAAiB,GAAG,SAAS;IA6BnE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ;CAOxC"}

package/dist/esm/endpoint/{EndpointServer.js → server/EndpointServer.js}

@@ -4,9 +4,8 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { ClusterBehavior } from "#behavior/cluster/ClusterBehavior.js";
-import { ClusterServerBacking } from "#behavior/internal/ClusterServerBacking.js";
-import { ServerBehaviorBacking } from "#behavior/internal/ServerBehaviorBacking.js";
 import { ImplementationError, InternalError, NotImplementedError } from "#general";
+import { BehaviorServer } from "./BehaviorServer.js";
 const SERVER = Symbol("server");
 class EndpointServer {
   #endpoint;
@@ -19,22 +18,19 @@ class EndpointServer {
     return this.#endpoint.type.deviceType;
   }
   constructor(endpoint) {
-    endpoint[SERVER] = this;
+    if (endpoint[SERVER] !== void 0) {
+      throw new InternalError(`Endpoint ${endpoint} cluster server is already initialized`);
+    }
+    endpoint.construction.assert();
     this.#endpoint = endpoint;
     this.#name = endpoint.type.name;
-  }
-  createBacking(type) {
-    let backing;
-    if (type.prototype instanceof ClusterBehavior) {
-      const cluster = type.cluster;
-      if (this.#clusterServers.has(cluster.id)) {
-        throw new InternalError(`${this.#endpoint}.${cluster.id} initialized multiple times`);
+    endpoint[SERVER] = this;
+    for (const type of Object.values(endpoint.behaviors.supported)) {
+      if (!(type.prototype instanceof ClusterBehavior)) {
+        continue;
       }
-      backing = new ClusterServerBacking(this, type);
-    } else {
-      backing = new ServerBehaviorBacking(this.#endpoint, type, this.#endpoint.behaviors.optionsFor(type));
+      this.#serve(type);
     }
-    return backing;
   }
   get number() {
     return this.#endpoint.number;
@@ -42,6 +38,17 @@ class EndpointServer {
   get name() {
     return this.#name;
   }
+  updateServers() {
+    for (const type of Object.values(this.#endpoint.behaviors.supported)) {
+      if (!(type.prototype instanceof ClusterBehavior)) {
+        continue;
+      }
+      if (this.#clusterServers.has(type.cluster?.id)) {
+        continue;
+      }
+      this.#serve(type);
+    }
+  }
   getNumber() {
     if (this.number === void 0) {
       throw new InternalError("Endpoint ID has not been assigned yet");
@@ -69,6 +76,9 @@ class EndpointServer {
   close() {
   }
   async [Symbol.asyncDispose]() {
+    for (const server of this.#clusterServers.values()) {
+      server.close();
+    }
     this.#clusterServers.clear();
     delete this.#endpoint[SERVER];
     for (const endpoint of this.#endpoint.parts) {
@@ -124,6 +134,20 @@ class EndpointServer {
       }
     }
   }
+  /**
+   * Install a ClusterServer for a behavior.
+   */
+  #serve(type) {
+    const { cluster } = type;
+    if (cluster === void 0) {
+      throw new InternalError(`Cannot serve ${this.endpoint} behavior ${type.id}} because it is not a cluster`);
+    }
+    if (this.#clusterServers.has(cluster.id)) {
+      throw new ImplementationError(`Duplicate behaviors for ${this.endpoint} define cluster ${cluster.id}`);
+    }
+    const clusterServer = BehaviorServer(this, type);
+    this.#clusterServers.set(cluster.id, clusterServer);
+  }
   /**
    * Retrieve the server for an endpoint.
    */

package/dist/esm/endpoint/server/EndpointServer.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/endpoint/server/EndpointServer.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/{node → endpoint}/server/ServerEndpointInitializer.d.ts

@@ -15,11 +15,11 @@ export declare class ServerEndpointInitializer extends EndpointInitializer {
     eraseDescendant(endpoint: Endpoint): Promise<void>;
     deactivateDescendant(endpoint: Endpoint): Promise<void>;
     /**
-     * If a {@link Endpoint} does not yet have a {@link EndpointServer}, create one now, then create a
-     * {@link BehaviorBacking} for a specific {@link Behavior}.
+     * Create the backing.
      *
-     * This is where we adapt endpoints and behaviors for a server role.
+     * If the behavior is a cluster behavior and the node is already initialized, create a server when the behavior
+     * initializes.
      */
-    createBacking(endpoint: Endpoint, behavior: Behavior.Type): BehaviorBacking;
+    createBacking(endpoint: Endpoint, type: Behavior.Type): BehaviorBacking;
 }
 //# sourceMappingURL=ServerEndpointInitializer.d.ts.map

package/dist/esm/endpoint/server/ServerEndpointInitializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerEndpointInitializer.d.ts","sourceRoot":"","sources":["../../../../src/endpoint/server/ServerEndpointInitializer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EAAE,WAAW,EAAyB,MAAM,UAAU,CAAC;AAM9D,qBAAa,yBAA0B,SAAQ,mBAAmB;;gBAGlD,WAAW,EAAE,WAAW;IAK3B,oBAAoB,CAAC,QAAQ,EAAE,QAAQ;IAU1C,eAAe,CAAC,QAAQ,EAAE,QAAQ;IAQlC,oBAAoB,CAAC,QAAQ,EAAE,QAAQ;IAQ7C;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,GAAG,eAAe;CA6C1E"}

package/dist/esm/{node → endpoint}/server/ServerEndpointInitializer.js

@@ -3,12 +3,12 @@
  * Copyright 2022-2024 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ServerBehaviorBacking } from "#behavior/internal/ServerBehaviorBacking.js";
 import { Endpoint } from "#endpoint/Endpoint.js";
-import { EndpointServer } from "#endpoint/EndpointServer.js";
 import { EndpointInitializer } from "#endpoint/properties/EndpointInitializer.js";
 import { InternalError, Logger } from "#general";
 import { DescriptorServer } from "../../behaviors/descriptor/DescriptorServer.js";
-import { ServerNodeStore } from "../storage/ServerNodeStore.js";
+import { ServerNodeStore } from "../../node/storage/ServerNodeStore.js";
 const logger = Logger.get("BehaviorInit");
 class ServerEndpointInitializer extends EndpointInitializer {
   #store;
@@ -36,13 +36,13 @@ class ServerEndpointInitializer extends EndpointInitializer {
     this.#store.endpointStores.deactivateStoreForEndpoint(endpoint);
   }
   /**
-   * If a {@link Endpoint} does not yet have a {@link EndpointServer}, create one now, then create a
-   * {@link BehaviorBacking} for a specific {@link Behavior}.
+   * Create the backing.
    *
-   * This is where we adapt endpoints and behaviors for a server role.
+   * If the behavior is a cluster behavior and the node is already initialized, create a server when the behavior
+   * initializes.
    */
-  createBacking(endpoint, behavior) {
-    return EndpointServer.forEndpoint(endpoint).createBacking(behavior);
+  createBacking(endpoint, type) {
+    return new ServerBehaviorBacking(endpoint, type, endpoint.behaviors.optionsFor(type));
   }
   /**
    * Select an ID for an endpoint automatically based on available metadata.

package/dist/esm/endpoint/server/ServerEndpointInitializer.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/endpoint/server/ServerEndpointInitializer.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,6BAA6B;AACtC,SAAS,gBAAgB;AACzB,SAAS,2BAA2B;AACpC,SAAsB,eAAe,cAAc;AACnD,SAAS,wBAAwB;AACjC,SAAS,uBAAuB;AAEhC,MAAM,SAAS,OAAO,IAAI,cAAc;AAEjC,MAAM,kCAAkC,oBAAoB;AAAA,EAC/D;AAAA,EAEA,YAAY,aAA0B;AAClC,UAAM;AACN,SAAK,SAAS,YAAY,IAAI,eAAe;AAAA,EACjD;AAAA,EAES,qBAAqB,UAAoB;AAC9C,QAAI,CAAC,SAAS,UAAU,OAAO;AAC3B,eAAS,KAAK,KAAK,cAAc,QAAQ;AAAA,IAC7C;AAEA,SAAK,OAAO,eAAe,aAAa,QAAQ;AAEhD,aAAS,UAAU,QAAQ,gBAAgB;AAAA,EAC/C;AAAA,EAEA,MAAM,gBAAgB,UAAoB;AACtC,QAAI,CAAC,SAAS,UAAU,OAAO;AAC3B;AAAA,IACJ;AAEA,UAAM,KAAK,OAAO,eAAe,sBAAsB,QAAQ;AAAA,EACnE;AAAA,EAEA,MAAM,qBAAqB,UAAoB;AAC3C,QAAI,CAAC,SAAS,UAAU,SAAS,SAAS,WAAW,GAAG;AACpD;AAAA,IACJ;AAEA,SAAK,OAAO,eAAe,2BAA2B,QAAQ;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,cAAc,UAAoB,MAAsC;AACpE,WAAO,IAAI,sBAAsB,UAAU,MAAM,SAAS,UAAU,WAAW,IAAI,CAAC;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,UAAoB;AAC9B,UAAM,YACF,SAAS,UAAU,UAAU,oBAAoB,SAAS,UAAU,UAAU;AAClF,QAAI,WAAW;AACX,YAAM,WAAW;AAAA,QACb,GAAG,IAAI,UAAU,MAAM;AAAA,QACvB,GAAG,SAAS,UAAU,YAAY,SAAS;AAAA,MAC/C;AAEA,UAAIA,MAAM,SAAoC;AAC9C,UAAIA,KAAI;AACJ,eAAOA;AAAA,MACX;AAEA,MAAAA,MAAM,SAAoC;AAC1C,UAAIA,KAAI;AACJ,eAAOA;AAAA,MACX;AAAA,IACJ;AAEA,QAAI,EAAE,SAAS,iBAAiB,WAAW;AACvC,YAAM,IAAI,cAAc,2DAA2D;AAAA,IACvF;AACA,QAAI,CAAC,SAAS,MAAM,UAAU,OAAO;AACjC,YAAM,IAAI,cAAc,2DAA2D;AAAA,IACvF;AAEA,UAAM,QAAQ,SAAS,MAAM,MAAM,QAAQ,QAAQ;AACnD,QAAI,UAAU,IAAI;AACd,YAAM,IAAI,cAAc,wEAAwE;AAAA,IACpG;AAGA,UAAM,KAAK,OAAO,KAAK;AACvB,WAAO,KAAK,wBAAwB,EAAE,iBAAiB,SAAS,KAAK,oCAAoC;AAEzG,WAAO;AAAA,EACX;AACJ;",
+  "names": ["id"]
+}

package/dist/esm/endpoint/server/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./EndpointServer.js";
+export * from "./ServerEndpointInitializer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/endpoint/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/endpoint/server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC"}

package/dist/esm/endpoint/server/index.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./EndpointServer.js";
+export * from "./ServerEndpointInitializer.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/endpoint/server/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/endpoint/server/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/endpoint/type/MutableEndpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MutableEndpoint.d.ts","sourceRoot":"","sources":["../../../../src/endpoint/type/MutableEndpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACjD;;OAEG;IACH,QAAQ,EAAE,EAAE,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,eAAe,CAAC;IAEnC;;OAEG;IACH,aAAa,CAAC,GAAG,SAAS,EAAE,kBAAkB,CAAC,IAAI,GAAG,eAAe,CAAC;IAEtE;;OAEG;IACH,IAAI,CAAC,GAAG,SAAS,EAAE,kBAAkB,CAAC,IAAI,GAAG,eAAe,CAAC;CAChE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,GAuC5D,eAAe,CAAC,IAAI,CAChC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EACnB,CAAC,CAAC,WAAW,CAAC,SAAS,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAClE,CACJ;AAED,yBAAiB,eAAe,CAAC;IAC7B,KAAY,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,EAAE,SAAS,kBAAkB,IAAI,IAAI,CAC1E,CAAC,EACD,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAC5C,GAAG;QACA,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAE/B;;WAEG;QACH,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEzC;;WAEG;QACH,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhE;;WAEG;QACH,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,kBAAkB,CAAC,IAAI,EAClD,GAAG,SAAS,EAAE,EAAE,GACjB,IAAI,CAAC,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAE5C;;WAEG;QACH,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,kBAAkB,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;KAC9G,CAAC;CACL"}
+{"version":3,"file":"MutableEndpoint.d.ts","sourceRoot":"","sources":["../../../../src/endpoint/type/MutableEndpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACjD;;OAEG;IACH,QAAQ,EAAE,EAAE,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,eAAe,CAAC;IAEnC;;OAEG;IACH,aAAa,CAAC,GAAG,SAAS,EAAE,kBAAkB,CAAC,IAAI,GAAG,eAAe,CAAC;IAEtE;;OAEG;IACH,IAAI,CAAC,GAAG,SAAS,EAAE,kBAAkB,CAAC,IAAI,GAAG,eAAe,CAAC;CAChE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,GA2C5D,eAAe,CAAC,IAAI,CAChC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EACnB,CAAC,CAAC,WAAW,CAAC,SAAS,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAClE,CACJ;AAED,yBAAiB,eAAe,CAAC;IAC7B,KAAY,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,EAAE,SAAS,kBAAkB,IAAI,IAAI,CAC1E,CAAC,EACD,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAC5C,GAAG;QACA,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAE/B;;WAEG;QACH,QAAQ,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEzC;;WAEG;QACH,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhE;;WAEG;QACH,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,kBAAkB,CAAC,IAAI,EAClD,GAAG,SAAS,EAAE,EAAE,GACjB,IAAI,CAAC,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAE5C;;WAEG;QACH,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,kBAAkB,CAAC,IAAI,EAAE,GAAG,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;KAC9G,CAAC;CACL"}

package/dist/esm/endpoint/type/MutableEndpoint.js

@@ -35,6 +35,9 @@ function MutableEndpoint(options) {
         ...options,
         behaviors: SupportedBehaviors.extend(this.behaviors, behaviors)
       });
+    },
+    withBehaviors(...behaviors) {
+      return this.with(...behaviors);
     }
   };
 }

package/dist/esm/endpoint/type/MutableEndpoint.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/endpoint/type/MutableEndpoint.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;AA8BtB,SAAS,gBAAsD,SAAY;AAC9E,QAAM,OAAO,aAAa,OAAO;AACjC,MAAI;AAEJ,SAAO;AAAA,IACH,GAAG;AAAA,IAEH,IAAI,WAAW;AACX,UAAI,CAAC,UAAU;AACX,mBAAW,CAAC;AAEZ,mBAAW,QAAQ,KAAK,WAAW;AAC/B,mBAAS,IAAI,IAAK,KAAK,UAAU,IAAI,EAAoB;AAAA,QAC7D;AAAA,MACJ;AAEA,aAAO;AAAA,IACX;AAAA,IAEA,IAA2BA,WAAkE;AACzF,YAAM,eAAe,MAAqB;AAE1C,iBAAW,QAAQ,KAAK,WAAW;AAC/B,cAAM,UAAWA,UAAiB,IAAI;AACtC,cAAM,WAAW,KAAK,UAAU,IAAI;AACpC,YAAI,SAAS;AACT,uBAAa,KAAK,SAAS,IAAI,OAAO,CAAC;AAAA,QAC3C;AAAA,MACJ;AAEA,aAAO,KAAK,KAAK,GAAG,YAAY;AAAA,IACpC;AAAA,IAEA,QAA+B,WAA4B;AACvD,aAAO,gBAAgB;AAAA,QACnB,GAAG;AAAA,QACH,WAAW,mBAAmB,OAAO,KAAK,WAAW,SAAS;AAAA,MAClE,CAAC;AAAA,IACL;AAAA,EACJ;AAIJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;AA8BtB,SAAS,gBAAsD,SAAY;AAC9E,QAAM,OAAO,aAAa,OAAO;AACjC,MAAI;AAEJ,SAAO;AAAA,IACH,GAAG;AAAA,IAEH,IAAI,WAAW;AACX,UAAI,CAAC,UAAU;AACX,mBAAW,CAAC;AAEZ,mBAAW,QAAQ,KAAK,WAAW;AAC/B,mBAAS,IAAI,IAAK,KAAK,UAAU,IAAI,EAAoB;AAAA,QAC7D;AAAA,MACJ;AAEA,aAAO;AAAA,IACX;AAAA,IAEA,IAA2BA,WAAkE;AACzF,YAAM,eAAe,MAAqB;AAE1C,iBAAW,QAAQ,KAAK,WAAW;AAC/B,cAAM,UAAWA,UAAiB,IAAI;AACtC,cAAM,WAAW,KAAK,UAAU,IAAI;AACpC,YAAI,SAAS;AACT,uBAAa,KAAK,SAAS,IAAI,OAAO,CAAC;AAAA,QAC3C;AAAA,MACJ;AAEA,aAAO,KAAK,KAAK,GAAG,YAAY;AAAA,IACpC;AAAA,IAEA,QAA+B,WAA4B;AACvD,aAAO,gBAAgB;AAAA,QACnB,GAAG;AAAA,QACH,WAAW,mBAAmB,OAAO,KAAK,WAAW,SAAS;AAAA,MAClE,CAAC;AAAA,IACL;AAAA,IAEA,iBAAwC,WAA4B;AAChE,aAAO,KAAK,KAAK,GAAG,SAAS;AAAA,IACjC;AAAA,EACJ;AAIJ;",
   "names": ["defaults"]
 }

package/dist/esm/node/Node.d.ts

@@ -26,6 +26,7 @@ export declare abstract class Node<T extends Node.CommonRootEndpoint = Node.Comm
      * Bring the node online.
      */
     start(): Promise<void>;
+    protected startWithMutex(): Promise<void>;
     /**
      * @deprecated use {@link start}
      */
@@ -40,7 +41,11 @@ export declare abstract class Node<T extends Node.CommonRootEndpoint = Node.Comm
      * Once the node is offline you may use {@link start} to bring the node online again.
      */
     cancel(): Promise<void>;
+    protected cancelWithMutex(): Promise<void>;
     close(): Promise<void>;
+    protected closeWithMutex(): Promise<void>;
+    reset(): Promise<void>;
+    protected resetWithMutex(): Promise<void>;
     /**
      * Create the network runtime.
      */

package/dist/esm/node/Node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/node/Node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EACH,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,QAAQ,EAGR,cAAc,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD;;;;GAIG;AACH,8BAAsB,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;;gBAI3F,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAmCzC,IAAa,GAAG,gBAEf;cAEkB,eAAe,IAAI,aAAa;IAInD;;OAEG;IACG,KAAK;IAqBX;;OAEG;IACG,WAAW;IAIjB;;OAEG;IACG,GAAG;IAKT;;;;OAIG;IACG,MAAM;IAUG,KAAK;IAYpB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,cAAc;IAElD,QAAQ,CAAC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,4BAEzB;IAED,IAAa,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAWzC;IAED,IAAa,SAAS,IAAI,aAAa,CAEtC;IAED,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM;IAIvB,CAAC,YAAY,CAAC,QAAQ,CAAC;CAKzC;AAED,yBAAiB,IAAI,CAAC;IAClB,UAAiB,WAAY,SAAQ,QAAQ,CAAC,eAAe;QACzD,WAAW,CAAC,EAAE,WAAW,CAAC;KAC7B;IAED,KAAY,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAEpH,KAAY,aAAa,CAAC,CAAC,SAAS,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,QAAQ,CAAC,aAAa,CAC3G,CAAC,EACD,WAAW,CACd,CAAC;IAEF,SAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAChD,WAAW,EAAE,CAAC,EACd,aAAa,EAAE,SAAS,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC/C,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GACrB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAoBvB;IAED;;OAEG;IACI,MAAM,kBAAkB;;;;;;;;;;;;;MAU7B,CAAC;IAEH,UAAiB,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,kBAAkB,CAAC;KAAG;CACrF"}
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/node/Node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EACH,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,QAAQ,EAGR,cAAc,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD;;;;GAIG;AACH,8BAAsB,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;;gBAI3F,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAmCzC,IAAa,GAAG,gBAEf;cAEkB,eAAe,IAAI,aAAa;IAInD;;OAEG;IACG,KAAK;cAIK,cAAc;IAqB9B;;OAEG;IACG,WAAW;IAIjB;;OAEG;IACG,GAAG;IAKT;;;;OAIG;IACG,MAAM;cAII,eAAe;IAUhB,KAAK;cAIJ,cAAc;IAUf,KAAK;cAIJ,cAAc;IAI9B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,cAAc;IAElD,QAAQ,CAAC,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,4BAEzB;IAED,IAAa,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAWzC;IAED,IAAa,SAAS,IAAI,aAAa,CAEtC;IAED,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM;IAIvB,CAAC,YAAY,CAAC,QAAQ,CAAC;CAKzC;AAED,yBAAiB,IAAI,CAAC;IAClB,UAAiB,WAAY,SAAQ,QAAQ,CAAC,eAAe;QACzD,WAAW,CAAC,EAAE,WAAW,CAAC;KAC7B;IAED,KAAY,OAAO,CAAC,CAAC,SAAS,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAEpH,KAAY,aAAa,CAAC,CAAC,SAAS,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,IAAI,QAAQ,CAAC,aAAa,CAC3G,CAAC,EACD,WAAW,CACd,CAAC;IAEF,SAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAChD,WAAW,EAAE,CAAC,EACd,aAAa,EAAE,SAAS,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAC/C,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GACrB,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAoBvB;IAED;;OAEG;IACI,MAAM,kBAAkB;;;;;;;;;;;;;MAU7B,CAAC;IAEH,UAAiB,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,kBAAkB,CAAC;KAAG;CACrF"}

package/dist/esm/node/Node.js

@@ -103,6 +103,9 @@ class Node extends Endpoint {
    * Bring the node online.
    */
   async start() {
+    await this.lifecycle.mutex.produce(this.startWithMutex.bind(this));
+  }
+  async startWithMutex() {
     this.env.runtime.add(this);
     try {
       await this.construction.ready;
@@ -137,6 +140,9 @@ class Node extends Endpoint {
    * Once the node is offline you may use {@link start} to bring the node online again.
    */
   async cancel() {
+    await this.lifecycle.mutex.produce(this.cancelWithMutex.bind(this));
+  }
+  async cancelWithMutex() {
     if (!this.#runtime) {
       return;
     }
@@ -145,11 +151,20 @@ class Node extends Endpoint {
     this.#runtime = void 0;
   }
   async close() {
+    await this.lifecycle.mutex.produce(this.closeWithMutex.bind(this));
+  }
+  async closeWithMutex() {
     if (this.#runtime) {
-      await this.cancel();
+      await this.cancelWithMutex();
     }
     await super.close();
   }
+  async reset() {
+    await this.lifecycle.mutex.produce(this.resetWithMutex.bind(this));
+  }
+  async resetWithMutex() {
+    return super.reset();
+  }
   get [RuntimeService.label]() {
     return ["Runtime for", Diagnostic.strong(this.toString())];
   }
@@ -179,7 +194,7 @@ class Node extends Endpoint {
     logger.notice(Diagnostic.strong(this.toString()), message);
   }
   async [Construction.destruct]() {
-    await this.cancel();
+    await this.cancelWithMutex();
     await super[Construction.destruct]();
     DiagnosticSource.delete(this);
   }