@matter/node 0.16.0-alpha.0-20251006-3fe1e7c57 → 0.16.0-alpha.0-20251013-89bb7099d

package/dist/cjs/behavior/system/mqtt/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mqtt_exports = {};
+module.exports = __toCommonJS(mqtt_exports);
+__reExport(mqtt_exports, require("./MqttInterface.js"), module.exports);
+__reExport(mqtt_exports, require("./MqttServer.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/behavior/system/mqtt/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/mqtt/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,yBAAc,+BANd;AAOA,yBAAc,4BAPd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/behavior/system/network/NetworkClient.d.ts

@@ -3,6 +3,7 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Observable } from "#general";
 import { DatatypeModel } from "#model";
 import { Subscribe } from "#protocol";
 import { CaseAuthenticatedTag } from "#types";
@@ -12,7 +13,15 @@ export declare class NetworkClient extends NetworkBehavior {
     #private;
     internal: NetworkClient.Internal;
     state: NetworkClient.State;
+    events: NetworkClient.Events;
+    initialize(): void;
     startup(): Promise<void>;
+    /**
+     * Manually activate the subscription for the node, if not already active. This will fail if the node is disabled.
+     *
+     * If you want to disable subscription, set the isDisabled state to true or set autoSubscribe to false.
+     */
+    subscribe(): Promise<void>;
     /**
      * Define logical schema for fields that should persist.
      */
@@ -21,21 +30,37 @@ export declare class NetworkClient extends NetworkBehavior {
 export declare namespace NetworkClient {
     class Internal extends NetworkBehavior.Internal {
         runtime?: ClientNetworkRuntime;
+        /**
+         * Contains the subscription target state.  It will also be true if a subscription is in the process of being
+         * established, or we wait for the node to be rediscovered.
+         */
+        subscriptionActivated: boolean;
+        /** The ID of the current active default subscription, if any */
+        defaultSubscriptionId?: number;
     }
     class State extends NetworkBehavior.State {
         /**
-         * A subscription installed when the node is first commissioned and when the service is restarted.
+         * This subscription defines the default set of attributes and events to which the node will automatically
+         * subscribe when started, if autoSubscribe is true.
          *
          * The default subscription is a wildcard for all attributes of the node.  You can set to undefined or filter
          * the fields and values but only values selected by this subscription will update automatically.
          *
          * Set to null to disable automatic subscription.
          */
-        startupSubscription?: Subscribe | null;
+        defaultSubscription?: Subscribe;
         /**
-         * If true, the matter.js will not perform network communication with the node.
+         * Represents the current operational network state of the node. When true the node is enabled and operational.
+         * When false the node is disabled and not operational.
+         *
+         * This state can be changed at any time to enable or disable the node.
          */
         isDisabled: boolean;
+        /**
+         * If true, automatically subscribe to the provided default subscription (or all attributes and events) when
+         * the node is started. If false, do not automatically subscribe.
+         */
+        autoSubscribe: boolean;
         /**
          * Case Authenticated Tags (CATs) to use for operational CASE sessions with this node.
          *
@@ -45,5 +70,9 @@ export declare namespace NetworkClient {
          */
         caseAuthenticatedTags?: CaseAuthenticatedTag[];
     }
+    class Events extends NetworkBehavior.Events {
+        autoSubscribe$Changed: Observable<[value: boolean, oldValue: boolean], void>;
+        defaultSubscription$Changed: Observable<[value: Subscribe | undefined, oldValue: Subscribe | undefined], void>;
+    }
 }
 //# sourceMappingURL=NetworkClient.d.ts.map

package/dist/cjs/behavior/system/network/NetworkClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkClient.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/network/NetworkClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,QAAQ,CAAC;AAErD,OAAO,EAA8B,SAAS,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,qBAAa,aAAc,SAAQ,eAAe;;IACtC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IACjC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;IAEpB,OAAO;IA4BtB;;OAEG;IACH,gBAAyB,MAAM,gBA+B5B;CACN;AAED,yBAAiB,aAAa,CAAC;IAC3B,MAAa,QAAS,SAAQ,eAAe,CAAC,QAAQ;QAC1C,OAAO,CAAC,EAAE,oBAAoB,CAAC;KAC1C;IAED,MAAa,KAAM,SAAQ,eAAe,CAAC,KAAK;QAC5C;;;;;;;WAOG;QACH,mBAAmB,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;QAEvC;;WAEG;QACH,UAAU,UAAS;QAEnB;;;;;;WAMG;QACH,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;KAClD;CACJ"}
+{"version":3,"file":"NetworkClient.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/network/NetworkClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAuB,UAAU,EAAmC,MAAM,UAAU,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAgB,MAAM,QAAQ,CAAC;AAGrD,OAAO,EAA0D,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,qBAAa,aAAc,SAAQ,eAAe;;IACtC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IACjC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;IAE5B,UAAU;IAKJ,OAAO;IAqBtB;;;;OAIG;IACH,SAAS;IA4DT;;OAEG;IACH,gBAAyB,MAAM,gBAwC5B;CACN;AAED,yBAAiB,aAAa,CAAC;IAC3B,MAAa,QAAS,SAAQ,eAAe,CAAC,QAAQ;QAC1C,OAAO,CAAC,EAAE,oBAAoB,CAAC;QAEvC;;;WAGG;QACH,qBAAqB,UAAS;QAE9B,gEAAgE;QAChE,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAClC;IAED,MAAa,KAAM,SAAQ,eAAe,CAAC,KAAK;QAC5C;;;;;;;;WAQG;QACH,mBAAmB,CAAC,EAAE,SAAS,CAAC;QAEhC;;;;;WAKG;QACH,UAAU,UAAS;QAEnB;;;WAGG;QACH,aAAa,UAAS;QAEtB;;;;;;WAMG;QACH,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;KAClD;IAED,MAAa,MAAO,SAAQ,eAAe,CAAC,MAAM;QAC9C,qBAAqB,wDAAyD;QAC9E,2BAA2B,oFAAqF;KACnH;CACJ"}

package/dist/cjs/behavior/system/network/NetworkClient.js

@@ -21,6 +21,8 @@ __export(NetworkClient_exports, {
   NetworkClient: () => NetworkClient
 });
 module.exports = __toCommonJS(NetworkClient_exports);
+var import_RemoteDescriptor = require("#behavior/system/commissioning/RemoteDescriptor.js");
+var import_general = require("#general");
 var import_model = require("#model");
 var import_Node = require("#node/Node.js");
 var import_protocol = require("#protocol");
@@ -31,21 +33,72 @@ var import_NetworkBehavior = require("./NetworkBehavior.js");
  * SPDX-License-Identifier: Apache-2.0
  */
 class NetworkClient extends import_NetworkBehavior.NetworkBehavior {
+  initialize() {
+    this.reactTo(this.events.autoSubscribe$Changed, this.#handleSubscription);
+    this.reactTo(this.events.defaultSubscription$Changed, this.#handleChangedDefaultSubscription);
+  }
   async startup() {
-    const { startupSubscription, isDisabled } = this.state;
-    if (startupSubscription === null || isDisabled) {
+    const peerAddress = this.#node.state.commissioning.peerAddress;
+    if (peerAddress !== void 0) {
+      const peerSet = this.env.get(import_protocol.PeerSet);
+      if (!peerSet.has(peerAddress)) {
+        const udpAddresses = this.#node.state.commissioning.addresses?.filter((a) => a.type === "udp") ?? [];
+        if (udpAddresses.length) {
+          const latestUdpAddress = (0, import_general.ServerAddress)(udpAddresses[udpAddresses.length - 1]);
+          await peerSet.addKnownPeer(
+            peerAddress,
+            latestUdpAddress,
+            import_RemoteDescriptor.RemoteDescriptor.fromLongForm(this.#node.state.commissioning)
+          );
+        }
+      }
+    }
+    await this.#handleSubscription();
+  }
+  /**
+   * Manually activate the subscription for the node, if not already active. This will fail if the node is disabled.
+   *
+   * If you want to disable subscription, set the isDisabled state to true or set autoSubscribe to false.
+   */
+  subscribe() {
+    if (this.state.isDisabled) {
+      throw new import_general.ImplementationError("Cannot subscribe when node is disabled");
+    }
+    return this.#handleSubscription(true);
+  }
+  async #handleChangedDefaultSubscription() {
+    if (!this.internal.subscriptionActivated) {
       return;
     }
-    const subscribe = (0, import_protocol.Subscribe)({
-      fabricFilter: true,
-      minIntervalFloor: import_protocol.DEFAULT_MIN_INTERVAL_FLOOR,
-      maxIntervalCeiling: 0,
-      attributes: [{}],
-      events: [{ isUrgent: true }],
-      ...startupSubscription
-    });
-    for await (const _chunk of this.#node.interaction.read(subscribe)) ;
-    await this.#node.interaction.subscribe(subscribe);
+    await this.#handleSubscription(false);
+    await this.#handleSubscription(true);
+  }
+  async #handleSubscription(desiredState = this.state.autoSubscribe) {
+    const { isDisabled } = this.state;
+    const subscriptionDesired = desiredState && !isDisabled;
+    if (subscriptionDesired === this.internal.subscriptionActivated) {
+      return;
+    }
+    if (subscriptionDesired) {
+      const subscribe = (0, import_protocol.Subscribe)({
+        fabricFilter: true,
+        minIntervalFloor: import_protocol.DEFAULT_MIN_INTERVAL_FLOOR,
+        maxIntervalCeiling: 0,
+        attributes: [{}],
+        events: [{ isUrgent: true }],
+        ...this.state.defaultSubscription
+      });
+      for await (const _chunk of this.#node.interaction.read(subscribe)) ;
+      const { subscriptionId } = await this.#node.interaction.subscribe(subscribe);
+      this.internal.subscriptionActivated = true;
+      this.internal.defaultSubscriptionId = subscriptionId;
+    } else {
+      if (this.internal.defaultSubscriptionId !== void 0) {
+        this.#node.interaction.subscriptions.get(this.internal.defaultSubscriptionId)?.close();
+        this.internal.defaultSubscriptionId = void 0;
+      }
+      this.internal.subscriptionActivated = false;
+    }
   }
   get #node() {
     return this.env.get(import_Node.Node);
@@ -58,15 +111,23 @@ class NetworkClient extends import_NetworkBehavior.NetworkBehavior {
     type: "struct",
     children: [
       (0, import_model.FieldElement)({
-        name: "startupSubscription",
+        name: "defaultSubscription",
         type: "any",
         default: { type: "properties", properties: {} },
-        quality: "XN"
+        conformance: "O",
+        quality: "N"
       }),
       (0, import_model.FieldElement)({
         name: "isDisabled",
         type: "bool",
-        quality: "N"
+        quality: "N",
+        default: false
+      }),
+      (0, import_model.FieldElement)({
+        name: "autoSubscribe",
+        type: "bool",
+        quality: "N",
+        default: false
       }),
       (0, import_model.FieldElement)({
         name: "caseAuthenticatedTags",
@@ -85,22 +146,38 @@ class NetworkClient extends import_NetworkBehavior.NetworkBehavior {
 }
 ((NetworkClient2) => {
   class Internal extends import_NetworkBehavior.NetworkBehavior.Internal {
+    /**
+     * Contains the subscription target state.  It will also be true if a subscription is in the process of being
+     * established, or we wait for the node to be rediscovered.
+     */
+    subscriptionActivated = false;
+    /** The ID of the current active default subscription, if any */
+    defaultSubscriptionId;
   }
   NetworkClient2.Internal = Internal;
   class State extends import_NetworkBehavior.NetworkBehavior.State {
     /**
-     * A subscription installed when the node is first commissioned and when the service is restarted.
+     * This subscription defines the default set of attributes and events to which the node will automatically
+     * subscribe when started, if autoSubscribe is true.
      *
      * The default subscription is a wildcard for all attributes of the node.  You can set to undefined or filter
      * the fields and values but only values selected by this subscription will update automatically.
      *
      * Set to null to disable automatic subscription.
      */
-    startupSubscription;
+    defaultSubscription;
     /**
-     * If true, the matter.js will not perform network communication with the node.
+     * Represents the current operational network state of the node. When true the node is enabled and operational.
+     * When false the node is disabled and not operational.
+     *
+     * This state can be changed at any time to enable or disable the node.
      */
     isDisabled = false;
+    /**
+     * If true, automatically subscribe to the provided default subscription (or all attributes and events) when
+     * the node is started. If false, do not automatically subscribe.
+     */
+    autoSubscribe = false;
     /**
      * Case Authenticated Tags (CATs) to use for operational CASE sessions with this node.
      *
@@ -111,5 +188,10 @@ class NetworkClient extends import_NetworkBehavior.NetworkBehavior {
     caseAuthenticatedTags;
   }
   NetworkClient2.State = State;
+  class Events extends import_NetworkBehavior.NetworkBehavior.Events {
+    autoSubscribe$Changed = new import_general.Observable();
+    defaultSubscription$Changed = new import_general.Observable();
+  }
+  NetworkClient2.Events = Events;
 })(NetworkClient || (NetworkClient = {}));
 //# sourceMappingURL=NetworkClient.js.map

package/dist/cjs/behavior/system/network/NetworkClient.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../../src/behavior/system/network/NetworkClient.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,mBAA4C;AAC5C,kBAAqB;AACrB,sBAAsD;AAGtD,6BAAgC;AAXhC;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,sBAAsB,uCAAgB;AAAA,EAI/C,MAAe,UAAU;AACrB,UAAM,EAAE,qBAAqB,WAAW,IAAI,KAAK;AAEjD,QAAI,wBAAwB,QAAQ,YAAY;AAC5C;AAAA,IACJ;AAGA,UAAM,gBAAY,2BAAU;AAAA,MACxB,cAAc;AAAA,MACd,kBAAkB;AAAA,MAClB,oBAAoB;AAAA,MACpB,YAAY,CAAC,CAAC,CAAC;AAAA,MACf,QAAQ,CAAC,EAAE,UAAU,KAAK,CAAC;AAAA,MAC3B,GAAG;AAAA,IACP,CAAC;AAGD,qBAAiB,UAAU,KAAK,MAAM,YAAY,KAAK,SAAS,EAAE;AAGlE,UAAM,KAAK,MAAM,YAAY,UAAU,SAAS;AAAA,EACpD;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK,IAAI,IAAI,gBAAI;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKA,OAAyB,SAAS,IAAI,2BAAc;AAAA,IAChD,MAAM;AAAA,IACN,MAAM;AAAA,IAEN,UAAU;AAAA,UACN,2BAAa;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS,EAAE,MAAM,cAAc,YAAY,CAAC,EAAE;AAAA,QAC9C,SAAS;AAAA,MACb,CAAC;AAAA,UAED,2BAAa;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,MACb,CAAC;AAAA,UAED,2BAAa;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,QACT,aAAa;AAAA,QACb,UAAU;AAAA,cACN,2BAAa;AAAA,YACT,MAAM;AAAA,YACN,MAAM;AAAA,UACV,CAAC;AAAA,QACL;AAAA,MACJ,CAAC;AAAA,IACL;AAAA,EACJ,CAAC;AACL;AAAA,CAEO,CAAUA,mBAAV;AAAA,EACI,MAAM,iBAAiB,uCAAgB,SAAS;AAAA,EAEvD;AAFO,EAAAA,eAAM;AAAA,EAIN,MAAM,cAAc,uCAAgB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAS7C;AAAA;AAAA;AAAA;AAAA,IAKA,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASb;AAAA,EACJ;AAxBO,EAAAA,eAAM;AAAA,GALA;",
+  "mappings": "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",
   "names": ["NetworkClient"]
 }

package/dist/cjs/behavior/system/product-description/ProductDescriptionServer.d.ts

@@ -15,7 +15,8 @@ export declare class ProductDescriptionServer extends Behavior {
     initialize(): void;
 }
 export declare namespace ProductDescriptionServer {
-    const UNKNOWN_DEVICE_TYPE: DeviceTypeId;
+    const UNKNOWN_VENDOR_ID: VendorId;
+    const UNKNOWN_PRODUCT_ID = -1;
     class State implements ProductDescription {
         /**
          * The device name for commissioning announcements.

package/dist/cjs/behavior/system/product-description/ProductDescriptionServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductDescriptionServer.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/product-description/ProductDescriptionServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,QAAQ;;IAClD,gBAAyB,EAAE,wBAAwB;IAE3C,KAAK,EAAE,wBAAwB,CAAC,KAAK,CAAC;IAErC,UAAU;CAyCtB;AAED,yBAAiB,wBAAwB,CAAC;IAC/B,MAAM,mBAAmB,cAA0B,CAAC;IAE3D,MAAa,KAAM,YAAW,kBAAkB;QAC5C;;WAEG;QACH,IAAI,SAAM;QAEV;;WAEG;QACH,UAAU,EAAE,YAAY,CAAuB;QAE/C;;WAEG;QACH,QAAQ,WAAuB;QAE/B;;WAEG;QACH,SAAS,SAAM;KAClB;CACJ"}
+{"version":3,"file":"ProductDescriptionServer.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/product-description/ProductDescriptionServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,QAAQ;;IAClD,gBAAyB,EAAE,wBAAwB;IAE3C,KAAK,EAAE,wBAAwB,CAAC,KAAK,CAAC;IAErC,UAAU;CAyCtB;AAED,yBAAiB,wBAAwB,CAAC;IAC/B,MAAM,iBAAiB,UAAsB,CAAC;IAC9C,MAAM,kBAAkB,KAAK,CAAC;IAErC,MAAa,KAAM,YAAW,kBAAkB;QAC5C;;WAEG;QACH,IAAI,SAAM;QAEV;;WAEG;QACH,UAAU,EAAE,YAAY,CAAoC;QAE5D;;WAEG;QACH,QAAQ,WAAqB;QAE7B;;WAEG;QACH,SAAS,SAAsB;KAClC;CACJ"}

package/dist/cjs/behavior/system/product-description/ProductDescriptionServer.js

@@ -21,6 +21,7 @@ __export(ProductDescriptionServer_exports, {
   ProductDescriptionServer: () => ProductDescriptionServer
 });
 module.exports = __toCommonJS(ProductDescriptionServer_exports);
+var import_EndpointType = require("#endpoint/type/EndpointType.js");
 var import_model = require("#model");
 var import_types = require("#types");
 var import_BasicInformationBehavior = require("../../../behaviors/basic-information/BasicInformationBehavior.js");
@@ -48,7 +49,7 @@ class ProductDescriptionServer extends import_Behavior.Behavior {
     this.#setDeviceType();
   }
   #setDeviceType() {
-    if (this.state.deviceType !== ProductDescriptionServer.UNKNOWN_DEVICE_TYPE) {
+    if (this.state.deviceType !== import_EndpointType.EndpointType.UNKNOWN_DEVICE_TYPE) {
       return;
     }
     const deviceType = inferDeviceType(this.agent);
@@ -64,7 +65,8 @@ class ProductDescriptionServer extends import_Behavior.Behavior {
   }
 }
 ((ProductDescriptionServer2) => {
-  ProductDescriptionServer2.UNKNOWN_DEVICE_TYPE = (0, import_types.DeviceTypeId)(-1, false);
+  ProductDescriptionServer2.UNKNOWN_VENDOR_ID = (0, import_types.VendorId)(-1, false);
+  ProductDescriptionServer2.UNKNOWN_PRODUCT_ID = -1;
   class State {
     /**
      * The device name for commissioning announcements.
@@ -73,15 +75,15 @@ class ProductDescriptionServer extends import_Behavior.Behavior {
     /**
      * The device type for commissioning announcements.
      */
-    deviceType = ProductDescriptionServer2.UNKNOWN_DEVICE_TYPE;
+    deviceType = import_EndpointType.EndpointType.UNKNOWN_DEVICE_TYPE;
     /**
      * The vendor ID for commissioning announcements.
      */
-    vendorId = (0, import_types.VendorId)(-1, false);
+    vendorId = ProductDescriptionServer2.UNKNOWN_VENDOR_ID;
     /**
      * The product ID for commissioning announcements.
      */
-    productId = -1;
+    productId = ProductDescriptionServer2.UNKNOWN_PRODUCT_ID;
   }
   ProductDescriptionServer2.State = State;
 })(ProductDescriptionServer || (ProductDescriptionServer = {}));

package/dist/cjs/behavior/system/product-description/ProductDescriptionServer.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../../src/behavior/system/product-description/ProductDescriptionServer.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,mBAA8E;AAC9E,mBAA2D;AAC3D,sCAAyC;AACzC,gCAAmC;AACnC,sBAAyB;AAXzB;AAAA;AAAA;AAAA;AAAA;AAgBO,MAAM,iCAAiC,yBAAS;AAAA,EACnD,OAAyB,KAAK;AAAA,EAIrB,aAAa;AAClB,UAAM,KAAK,KAAK;AAEhB,UAAM,KAAK,KAAK,MAAM,IAAI,wDAAwB,EAAE;AAEpD,QAAI,GAAG,SAAS,IAAI;AAChB,SAAG,OAAO,GAAG;AAAA,IACjB;AAEA,QAAI,GAAG,aAAa,IAAI;AACpB,SAAG,WAAW,GAAG;AAAA,IACrB;AAEA,QAAI,GAAG,cAAc,IAAI;AACrB,SAAG,YAAY,GAAG;AAAA,IACtB;AAEA,SAAK,eAAe;AAAA,EACxB;AAAA,EAEA,iBAAiB;AACb,QAAI,KAAK,MAAM,eAAe,yBAAyB,qBAAqB;AACxE;AAAA,IACJ;AAEA,UAAM,aAAa,gBAAgB,KAAK,KAAK;AAE7C,QAAI,eAAe,QAAW;AAC1B,WAAK,MAAM,aAAa;AACxB;AAAA,IACJ;AAGA,SAAK;AAAA,MACD,KAAK,SAAS,UAAU;AAAA,MAExB,KAAK;AAAA,MAEL,EAAE,MAAM,KAAK;AAAA,IACjB;AAAA,EACJ;AACJ;AAAA,CAEO,CAAUA,8BAAV;AACI,EAAMA,0BAAA,0BAAsB,2BAAa,IAAI,KAAK;AAAA,EAElD,MAAM,MAAoC;AAAA;AAAA;AAAA;AAAA,IAI7C,OAAO;AAAA;AAAA;AAAA;AAAA,IAKP,aAA2BA,0BAAA;AAAA;AAAA;AAAA;AAAA,IAK3B,eAAW,uBAAS,IAAI,KAAK;AAAA;AAAA;AAAA;AAAA,IAK7B,YAAY;AAAA,EAChB;AApBO,EAAAA,0BAAM;AAAA,GAHA;AA0BjB,SAAS,gBAAgB,OAAwC;AAC7D,MAAI,CAAC,MAAM,SAAS,UAAU,SAAS,4CAAkB,GAAG;AACxD;AAAA,EACJ;AAEA,MAAI,UAAU;AACd,aAAW,MAAM,MAAM,IAAI,4CAAkB,EAAE,MAAM,gBAAgB;AACjE,YAAQ,GAAG,YAAY;AAAA;AAAA;AAAA,MAGnB,KAAK,wBAAW;AAAA,MAChB,KAAK,2BAAc;AAAA,MACnB,KAAK,0BAAa;AACd,kBAAU;AACV;AAAA,MAEJ;AACI,YAAI,MAAM,SAAS,KAAK,gBAAgB,kCAAqB,QAAQ;AACjE,iBAAO,GAAG;AAAA,QACd;AAAA,IACR;AAAA,EACJ;AAEA,MAAI,CAAC,WAAW,CAAC,MAAM,SAAS,UAAU;AACtC;AAAA,EACJ;AAEA,aAAW,SAAS,MAAM,SAAS,OAAO;AACtC,UAAM,aAAa,gBAAgB,MAAM,SAAS,MAAM,OAAO,CAAC;AAChE,QAAI,eAAe,QAAW;AAC1B,aAAO;AAAA,IACX;AAAA,EACJ;AACJ;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,0BAA6B;AAC7B,mBAA8E;AAC9E,mBAA2D;AAC3D,sCAAyC;AACzC,gCAAmC;AACnC,sBAAyB;AAZzB;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,iCAAiC,yBAAS;AAAA,EACnD,OAAyB,KAAK;AAAA,EAIrB,aAAa;AAClB,UAAM,KAAK,KAAK;AAEhB,UAAM,KAAK,KAAK,MAAM,IAAI,wDAAwB,EAAE;AAEpD,QAAI,GAAG,SAAS,IAAI;AAChB,SAAG,OAAO,GAAG;AAAA,IACjB;AAEA,QAAI,GAAG,aAAa,IAAI;AACpB,SAAG,WAAW,GAAG;AAAA,IACrB;AAEA,QAAI,GAAG,cAAc,IAAI;AACrB,SAAG,YAAY,GAAG;AAAA,IACtB;AAEA,SAAK,eAAe;AAAA,EACxB;AAAA,EAEA,iBAAiB;AACb,QAAI,KAAK,MAAM,eAAe,iCAAa,qBAAqB;AAC5D;AAAA,IACJ;AAEA,UAAM,aAAa,gBAAgB,KAAK,KAAK;AAE7C,QAAI,eAAe,QAAW;AAC1B,WAAK,MAAM,aAAa;AACxB;AAAA,IACJ;AAGA,SAAK;AAAA,MACD,KAAK,SAAS,UAAU;AAAA,MAExB,KAAK;AAAA,MAEL,EAAE,MAAM,KAAK;AAAA,IACjB;AAAA,EACJ;AACJ;AAAA,CAEO,CAAUA,8BAAV;AACI,EAAMA,0BAAA,wBAAoB,uBAAS,IAAI,KAAK;AAC5C,EAAMA,0BAAA,qBAAqB;AAAA,EAE3B,MAAM,MAAoC;AAAA;AAAA;AAAA;AAAA,IAI7C,OAAO;AAAA;AAAA;AAAA;AAAA,IAKP,aAA2B,iCAAa;AAAA;AAAA;AAAA;AAAA,IAKxC,WAAWA,0BAAA;AAAA;AAAA;AAAA;AAAA,IAKX,YAAYA,0BAAA;AAAA,EAChB;AApBO,EAAAA,0BAAM;AAAA,GAJA;AA2BjB,SAAS,gBAAgB,OAAwC;AAC7D,MAAI,CAAC,MAAM,SAAS,UAAU,SAAS,4CAAkB,GAAG;AACxD;AAAA,EACJ;AAEA,MAAI,UAAU;AACd,aAAW,MAAM,MAAM,IAAI,4CAAkB,EAAE,MAAM,gBAAgB;AACjE,YAAQ,GAAG,YAAY;AAAA;AAAA;AAAA,MAGnB,KAAK,wBAAW;AAAA,MAChB,KAAK,2BAAc;AAAA,MACnB,KAAK,0BAAa;AACd,kBAAU;AACV;AAAA,MAEJ;AACI,YAAI,MAAM,SAAS,KAAK,gBAAgB,kCAAqB,QAAQ;AACjE,iBAAO,GAAG;AAAA,QACd;AAAA,IACR;AAAA,EACJ;AAEA,MAAI,CAAC,WAAW,CAAC,MAAM,SAAS,UAAU;AACtC;AAAA,EACJ;AAEA,aAAW,SAAS,MAAM,SAAS,OAAO;AACtC,UAAM,aAAa,gBAAgB,MAAM,SAAS,MAAM,OAAO,CAAC;AAChE,QAAI,eAAe,QAAW;AAC1B,aAAO;AAAA,IACX;AAAA,EACJ;AACJ;",
   "names": ["ProductDescriptionServer"]
 }

package/dist/cjs/behavior/system/remote/RemoteInterface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AppAddress } from "#general";
+import type { ServerNode } from "#node/ServerNode.js";
+import { ApiPath } from "./api/ApiPath.js";
+/**
+ * An implementation of a non-Matter network protocol for accessing a {@link ServerNode}.
+ */
+export declare abstract class RemoteInterface {
+    #private;
+    constructor(node: ServerNode, address: AppAddress);
+    get root(): ApiPath;
+    get env(): import("#general").Environment;
+    get node(): ServerNode<ServerNode.RootEndpoint>;
+    get address(): AppAddress;
+    get isAborted(): boolean;
+    get abort(): AbortSignal;
+    static create<This extends new (node: ServerNode, address: AppAddress) => RemoteInterface>(this: This, node: ServerNode, address: AppAddress): Promise<RemoteInterface>;
+    close(): Promise<void>;
+    protected assertProtocol(appProtocol: string): void;
+    protected addWorker(worker: Promise<void>, description: string): void;
+    static protocol: string;
+    /**
+     * Initialize and begin handling requests to the interface.
+     */
+    protected abstract start(): Promise<void>;
+    /**
+     * Stop servicing requests.  Called on close.  The default implementation just waits for any workers to complete.
+     */
+    protected stop(): Promise<void>;
+}
+export declare namespace RemoteInterface {
+    interface Type {
+        protocol: string;
+        create(node: ServerNode, address: AppAddress): Promise<RemoteInterface>;
+    }
+}
+//# sourceMappingURL=RemoteInterface.d.ts.map

package/dist/cjs/behavior/system/remote/RemoteInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteInterface.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/remote/RemoteInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAA+C,MAAM,UAAU,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI3C;;GAEG;AACH,8BAAsB,eAAe;;gBAOrB,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU;IAWjD,IAAI,IAAI,YAEP;IAED,IAAI,GAAG,mCAEN;IAED,IAAI,IAAI,wCAEP;IAED,IAAI,OAAO,eAEV;IAED,IAAI,SAAS,YAEZ;IAED,IAAI,KAAK,gBAER;WAEY,MAAM,CAAC,IAAI,SAAS,KAAK,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,KAAK,eAAe,EAC3F,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,UAAU;IAYjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B,SAAS,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM;IAQ5C,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM;IAI9D,MAAM,CAAC,QAAQ,SAAM;IAErB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEzC;;OAEG;cACa,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGxC;AAED,yBAAiB,eAAe,CAAC;IAC7B,UAAiB,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;KAC3E;CACJ"}

package/dist/cjs/behavior/system/remote/RemoteInterface.js

@@ -0,0 +1,105 @@
+"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 RemoteInterface_exports = {};
+__export(RemoteInterface_exports, {
+  RemoteInterface: () => RemoteInterface
+});
+module.exports = __toCommonJS(RemoteInterface_exports);
+var import_general = require("#general");
+var import_ApiPath = require("./api/ApiPath.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("RemoteAdapter");
+class RemoteInterface {
+  #node;
+  #address;
+  #abort = new AbortController();
+  #root;
+  #workers = new import_general.BasicMultiplex();
+  constructor(node, address) {
+    if (address.appProtocol !== this.constructor.protocol) {
+      throw new import_general.ImplementationError(
+        `API endpoint type ${this.constructor.name} does not support address ${address}`
+      );
+    }
+    this.#node = node;
+    this.#address = address;
+    this.#root = new import_ApiPath.ApiPath(address);
+  }
+  get root() {
+    return this.#root;
+  }
+  get env() {
+    return this.#node.env;
+  }
+  get node() {
+    return this.#node;
+  }
+  get address() {
+    return this.#address;
+  }
+  get isAborted() {
+    return this.#abort.signal.aborted;
+  }
+  get abort() {
+    return this.#abort.signal;
+  }
+  static async create(node, address) {
+    const instance = new this(node, address);
+    try {
+      await instance.start();
+    } catch (e) {
+      await instance.close();
+      throw e;
+    }
+    return instance;
+  }
+  async close() {
+    if (this.isAborted) {
+      return;
+    }
+    this.#abort.abort();
+    try {
+      await this.stop();
+    } catch (e) {
+      logger.error(`Error terminating API endpoint ${this.address}`);
+    }
+  }
+  assertProtocol(appProtocol) {
+    if (this.address.appProtocol !== appProtocol) {
+      throw new import_general.ImplementationError(
+        `Invalid protocol ${this.address} for API endpoin type ${this.constructor.name}`
+      );
+    }
+  }
+  addWorker(worker, description) {
+    this.#workers.add(worker, description);
+  }
+  static protocol = "";
+  /**
+   * Stop servicing requests.  Called on close.  The default implementation just waits for any workers to complete.
+   */
+  async stop() {
+    await this.#workers.close();
+  }
+}
+//# sourceMappingURL=RemoteInterface.js.map

package/dist/cjs/behavior/system/remote/RemoteInterface.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/remote/RemoteInterface.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAwE;AAExE,qBAAwB;AARxB;AAAA;AAAA;AAAA;AAAA;AAUA,MAAM,SAAS,sBAAO,IAAI,eAAe;AAKlC,MAAe,gBAAgB;AAAA,EAClC;AAAA,EACA;AAAA,EACA,SAAS,IAAI,gBAAgB;AAAA,EAC7B;AAAA,EACA,WAAW,IAAI,8BAAe;AAAA,EAE9B,YAAY,MAAkB,SAAqB;AAC/C,QAAI,QAAQ,gBAAiB,KAAK,YAAgD,UAAU;AACxF,YAAM,IAAI;AAAA,QACN,qBAAqB,KAAK,YAAY,IAAI,6BAA6B,OAAO;AAAA,MAClF;AAAA,IACJ;AACA,SAAK,QAAQ;AACb,SAAK,WAAW;AAChB,SAAK,QAAQ,IAAI,uBAAQ,OAAO;AAAA,EACpC;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,MAAM;AACN,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAU;AACV,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,YAAY;AACZ,WAAO,KAAK,OAAO,OAAO;AAAA,EAC9B;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK,OAAO;AAAA,EACvB;AAAA,EAEA,aAAa,OAET,MACA,SACF;AACE,UAAM,WAAW,IAAI,KAAK,MAAM,OAAO;AACvC,QAAI;AACA,YAAM,SAAS,MAAM;AAAA,IACzB,SAAS,GAAG;AACR,YAAM,SAAS,MAAM;AACrB,YAAM;AAAA,IACV;AACA,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,QAAuB;AACzB,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AAEA,SAAK,OAAO,MAAM;AAElB,QAAI;AACA,YAAM,KAAK,KAAK;AAAA,IACpB,SAAS,GAAG;AACR,aAAO,MAAM,kCAAkC,KAAK,OAAO,EAAE;AAAA,IACjE;AAAA,EACJ;AAAA,EAEU,eAAe,aAAqB;AAC1C,QAAI,KAAK,QAAQ,gBAAgB,aAAa;AAC1C,YAAM,IAAI;AAAA,QACN,oBAAoB,KAAK,OAAO,yBAAyB,KAAK,YAAY,IAAI;AAAA,MAClF;AAAA,IACJ;AAAA,EACJ;AAAA,EAEU,UAAU,QAAuB,aAAqB;AAC5D,SAAK,SAAS,IAAI,QAAQ,WAAW;AAAA,EACzC;AAAA,EAEA,OAAO,WAAW;AAAA;AAAA;AAAA;AAAA,EAUlB,MAAgB,OAAsB;AAClC,UAAM,KAAK,SAAS,MAAM;AAAA,EAC9B;AACJ;",
+  "names": []
+}

package/dist/cjs/behavior/system/remote/RemoteServer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "#behavior/Behavior.js";
+import { DatatypeModel } from "#model";
+import { RemoteInterface } from "./RemoteInterface.js";
+/**
+ * Base class for {@link Behavior}s that enable remote access to a {@link ServerNode} via a non-Matter API.
+ *
+ * Each protocol supported by Matter.js implements a subclass of {@link RemoteServer} and {@link RemoteInterface}.
+ *
+ * The {@link RemoteServer} provides a convenient interface for adding a protocol to a {@link ServerNode}.  The The
+ * {@link RemoteInterface} implements the actual protocol.
+ *
+ * For greater control you may instantiate and manage {@link RemoteInterface} separately from {@link RemoteServer}. To
+ * implement your own protocol you may extend the server implementations provided by matter.js, or create a new protocol
+ * implementation by subclassing {@link RemoteInterface} yourself.
+ */
+export declare abstract class RemoteServer extends Behavior {
+    #private;
+    static readonly early = true;
+    static interfaceType: RemoteInterface.Type;
+    internal: RemoteServer.Internal;
+    state: RemoteServer.State;
+    initialize(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    static readonly schema: DatatypeModel;
+}
+export declare namespace RemoteServer {
+    class Internal {
+        interface?: RemoteInterface;
+    }
+    class State {
+        /**
+         * The public address at which the service endpoint is accessible.
+         *
+         * The address is a URL.  See subclasses for supported protocols.  An "s" suffix indicates standard TLS support.
+         * The "+unix" suffix indicates that the hostname is a URL encoded path to a UNIX socket.  The socket path may
+         * be absolute or relative to the node's storage root.
+         *
+         * The path portion of the URL generally acts as a namespace prefix for the relevant protocol implementation.
+         * Matter.js replaces the special token `{node}` in the URL with the {@link ServerNode.id}.  This allows for
+         * multiple nodes to participate in a protocol in separate namespaces.
+         */
+        address: string;
+        /**
+         * Set to false to disable this service.
+         */
+        enabled: boolean;
+        /**
+         * By default the HTTP endpoint is available as soon as the {@link Node} initializes.
+         *
+         * If you set this to false, the HTTP endpoint is only available when the {@link Node}'s Matter networking is
+         * also online.
+         */
+        allowOfflineUse: boolean;
+    }
+}
+//# sourceMappingURL=RemoteServer.d.ts.map

package/dist/cjs/behavior/system/remote/RemoteServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteServer.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/remote/RemoteServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAgB,MAAM,QAAQ,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,8BAAsB,YAAa,SAAQ,QAAQ;;IAC/C,gBAAyB,KAAK,QAAQ;IAEtC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,IAAI,CAAC;IAEnC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC;IAChC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;IAEnB,UAAU;IAiBhB,CAAC,MAAM,CAAC,YAAY,CAAC;IAoC9B,gBAAyB,MAAM,gBAS7B;CACL;AAED,yBAAiB,YAAY,CAAC;IAC1B,MAAa,QAAQ;QACjB,SAAS,CAAC,EAAE,eAAe,CAAC;KAC/B;IAED,MAAa,KAAK;QACd;;;;;;;;;;WAUG;QACH,OAAO,SAAM;QAEb;;WAEG;QACH,OAAO,UAAQ;QAEf;;;;;WAKG;QACH,eAAe,UAAQ;KAC1B;CACJ"}