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

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

@@ -3,26 +3,79 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { RemoteDescriptor } from "#behavior/system/commissioning/RemoteDescriptor.js";
+import { ImplementationError, Observable, ServerAddress } from "#general";
 import { DatatypeModel, FieldElement } from "#model";
 import { Node } from "#node/Node.js";
-import { DEFAULT_MIN_INTERVAL_FLOOR, Subscribe } from "#protocol";
+import { DEFAULT_MIN_INTERVAL_FLOOR, PeerSet, Subscribe } from "#protocol";
 import { NetworkBehavior } from "./NetworkBehavior.js";
 class NetworkClient extends 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(PeerSet);
+      if (!peerSet.has(peerAddress)) {
+        const udpAddresses = this.#node.state.commissioning.addresses?.filter((a) => a.type === "udp") ?? [];
+        if (udpAddresses.length) {
+          const latestUdpAddress = ServerAddress(udpAddresses[udpAddresses.length - 1]);
+          await peerSet.addKnownPeer(
+            peerAddress,
+            latestUdpAddress,
+            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 ImplementationError("Cannot subscribe when node is disabled");
+    }
+    return this.#handleSubscription(true);
+  }
+  async #handleChangedDefaultSubscription() {
+    if (!this.internal.subscriptionActivated) {
       return;
     }
-    const subscribe = Subscribe({
-      fabricFilter: true,
-      minIntervalFloor: 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 = Subscribe({
+        fabricFilter: true,
+        minIntervalFloor: 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(Node);
@@ -35,15 +88,23 @@ class NetworkClient extends NetworkBehavior {
     type: "struct",
     children: [
       FieldElement({
-        name: "startupSubscription",
+        name: "defaultSubscription",
         type: "any",
         default: { type: "properties", properties: {} },
-        quality: "XN"
+        conformance: "O",
+        quality: "N"
       }),
       FieldElement({
         name: "isDisabled",
         type: "bool",
-        quality: "N"
+        quality: "N",
+        default: false
+      }),
+      FieldElement({
+        name: "autoSubscribe",
+        type: "bool",
+        quality: "N",
+        default: false
       }),
       FieldElement({
         name: "caseAuthenticatedTags",
@@ -62,22 +123,38 @@ class NetworkClient extends NetworkBehavior {
 }
 ((NetworkClient2) => {
   class Internal extends 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 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.
      *
@@ -88,6 +165,11 @@ class NetworkClient extends NetworkBehavior {
     caseAuthenticatedTags;
   }
   NetworkClient2.State = State;
+  class Events extends NetworkBehavior.Events {
+    autoSubscribe$Changed = new Observable();
+    defaultSubscription$Changed = new Observable();
+  }
+  NetworkClient2.Events = Events;
 })(NetworkClient || (NetworkClient = {}));
 export {
   NetworkClient

package/dist/esm/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,SAAS,eAAe,oBAAoB;AAC5C,SAAS,YAAY;AACrB,SAAS,4BAA4B,iBAAiB;AAGtD,SAAS,uBAAuB;AAEzB,MAAM,sBAAsB,gBAAgB;AAAA,EAI/C,MAAe,UAAU;AACrB,UAAM,EAAE,qBAAqB,WAAW,IAAI,KAAK;AAEjD,QAAI,wBAAwB,QAAQ,YAAY;AAC5C;AAAA,IACJ;AAGA,UAAM,YAAY,UAAU;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,IAAI;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKA,OAAyB,SAAS,IAAI,cAAc;AAAA,IAChD,MAAM;AAAA,IACN,MAAM;AAAA,IAEN,UAAU;AAAA,MACN,aAAa;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS,EAAE,MAAM,cAAc,YAAY,CAAC,EAAE;AAAA,QAC9C,SAAS;AAAA,MACb,CAAC;AAAA,MAED,aAAa;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,MACb,CAAC;AAAA,MAED,aAAa;AAAA,QACT,MAAM;AAAA,QACN,MAAM;AAAA,QACN,SAAS;AAAA,QACT,aAAa;AAAA,QACb,UAAU;AAAA,UACN,aAAa;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,gBAAgB,SAAS;AAAA,EAEvD;AAFO,EAAAA,eAAM;AAAA,EAIN,MAAM,cAAc,gBAAgB,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/esm/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/esm/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/esm/behavior/system/product-description/ProductDescriptionServer.js

@@ -3,8 +3,9 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { EndpointType } from "#endpoint/type/EndpointType.js";
 import { AggregatorDt, BridgedNodeDt, DeviceClassification, RootNodeDt } from "#model";
-import { DeviceTypeId, VendorId } from "#types";
+import { VendorId } from "#types";
 import { BasicInformationBehavior } from "../../../behaviors/basic-information/BasicInformationBehavior.js";
 import { DescriptorBehavior } from "../../../behaviors/descriptor/DescriptorBehavior.js";
 import { Behavior } from "../../Behavior.js";
@@ -25,7 +26,7 @@ class ProductDescriptionServer extends Behavior {
     this.#setDeviceType();
   }
   #setDeviceType() {
-    if (this.state.deviceType !== ProductDescriptionServer.UNKNOWN_DEVICE_TYPE) {
+    if (this.state.deviceType !== EndpointType.UNKNOWN_DEVICE_TYPE) {
       return;
     }
     const deviceType = inferDeviceType(this.agent);
@@ -41,7 +42,8 @@ class ProductDescriptionServer extends Behavior {
   }
 }
 ((ProductDescriptionServer2) => {
-  ProductDescriptionServer2.UNKNOWN_DEVICE_TYPE = DeviceTypeId(-1, false);
+  ProductDescriptionServer2.UNKNOWN_VENDOR_ID = VendorId(-1, false);
+  ProductDescriptionServer2.UNKNOWN_PRODUCT_ID = -1;
   class State {
     /**
      * The device name for commissioning announcements.
@@ -50,15 +52,15 @@ class ProductDescriptionServer extends Behavior {
     /**
      * The device type for commissioning announcements.
      */
-    deviceType = ProductDescriptionServer2.UNKNOWN_DEVICE_TYPE;
+    deviceType = EndpointType.UNKNOWN_DEVICE_TYPE;
     /**
      * The vendor ID for commissioning announcements.
      */
-    vendorId = 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/esm/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,SAAS,cAAc,eAAe,sBAAsB,kBAAkB;AAC9E,SAAS,cAAkC,gBAAgB;AAC3D,SAAS,gCAAgC;AACzC,SAAS,0BAA0B;AACnC,SAAS,gBAAgB;AAKlB,MAAM,iCAAiC,SAAS;AAAA,EACnD,OAAyB,KAAK;AAAA,EAIrB,aAAa;AAClB,UAAM,KAAK,KAAK;AAEhB,UAAM,KAAK,KAAK,MAAM,IAAI,wBAAwB,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,sBAAsB,aAAa,IAAI,KAAK;AAAA,EAElD,MAAM,MAAoC;AAAA;AAAA;AAAA;AAAA,IAI7C,OAAO;AAAA;AAAA;AAAA;AAAA,IAKP,aAA2BA,0BAAA;AAAA;AAAA;AAAA;AAAA,IAK3B,WAAW,SAAS,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,kBAAkB,GAAG;AACxD;AAAA,EACJ;AAEA,MAAI,UAAU;AACd,aAAW,MAAM,MAAM,IAAI,kBAAkB,EAAE,MAAM,gBAAgB;AACjE,YAAQ,GAAG,YAAY;AAAA;AAAA;AAAA,MAGnB,KAAK,WAAW;AAAA,MAChB,KAAK,cAAc;AAAA,MACnB,KAAK,aAAa;AACd,kBAAU;AACV;AAAA,MAEJ;AACI,YAAI,MAAM,SAAS,KAAK,gBAAgB,qBAAqB,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,SAAS,oBAAoB;AAC7B,SAAS,cAAc,eAAe,sBAAsB,kBAAkB;AAC9E,SAA2C,gBAAgB;AAC3D,SAAS,gCAAgC;AACzC,SAAS,0BAA0B;AACnC,SAAS,gBAAgB;AAKlB,MAAM,iCAAiC,SAAS;AAAA,EACnD,OAAyB,KAAK;AAAA,EAIrB,aAAa;AAClB,UAAM,KAAK,KAAK;AAEhB,UAAM,KAAK,KAAK,MAAM,IAAI,wBAAwB,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,aAAa,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,oBAAoB,SAAS,IAAI,KAAK;AAC5C,EAAMA,0BAAA,qBAAqB;AAAA,EAE3B,MAAM,MAAoC;AAAA;AAAA;AAAA;AAAA,IAI7C,OAAO;AAAA;AAAA;AAAA;AAAA,IAKP,aAA2B,aAAa;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,kBAAkB,GAAG;AACxD;AAAA,EACJ;AAEA,MAAI,UAAU;AACd,aAAW,MAAM,MAAM,IAAI,kBAAkB,EAAE,MAAM,gBAAgB;AACjE,YAAQ,GAAG,YAAY;AAAA;AAAA;AAAA,MAGnB,KAAK,WAAW;AAAA,MAChB,KAAK,cAAc;AAAA,MACnB,KAAK,aAAa;AACd,kBAAU;AACV;AAAA,MAEJ;AACI,YAAI,MAAM,SAAS,KAAK,gBAAgB,qBAAqB,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/esm/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/esm/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/esm/behavior/system/remote/RemoteInterface.js

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BasicMultiplex, ImplementationError, Logger } from "#general";
+import { ApiPath } from "./api/ApiPath.js";
+const logger = Logger.get("RemoteAdapter");
+class RemoteInterface {
+  #node;
+  #address;
+  #abort = new AbortController();
+  #root;
+  #workers = new BasicMultiplex();
+  constructor(node, address) {
+    if (address.appProtocol !== this.constructor.protocol) {
+      throw new ImplementationError(
+        `API endpoint type ${this.constructor.name} does not support address ${address}`
+      );
+    }
+    this.#node = node;
+    this.#address = address;
+    this.#root = new 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 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();
+  }
+}
+export {
+  RemoteInterface
+};
+//# sourceMappingURL=RemoteInterface.js.map

package/dist/esm/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,SAAqB,gBAAgB,qBAAqB,cAAc;AAExE,SAAS,eAAe;AAExB,MAAM,SAAS,OAAO,IAAI,eAAe;AAKlC,MAAe,gBAAgB;AAAA,EAClC;AAAA,EACA;AAAA,EACA,SAAS,IAAI,gBAAgB;AAAA,EAC7B;AAAA,EACA,WAAW,IAAI,eAAe;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,QAAQ,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/esm/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/esm/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"}

package/dist/esm/behavior/system/remote/RemoteServer.js

@@ -0,0 +1,98 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "#behavior/Behavior.js";
+import { EndpointInitializer } from "#endpoint/index.js";
+import { AppAddress, ImplementationError, InternalError } from "#general";
+import { DatatypeModel, FieldElement } from "#model";
+import { ServerEndpointInitializer } from "#node/index.js";
+class RemoteServer extends Behavior {
+  static early = true;
+  static interfaceType;
+  async initialize() {
+    if (!(this.env.get(EndpointInitializer) instanceof ServerEndpointInitializer)) {
+      throw new ImplementationError("Remote server is not installed in a ServerNode");
+    }
+    this.reactTo(this.endpoint.lifecycle.online, this.#start);
+    this.reactTo(this.endpoint.lifecycle.offline, this.#onOffline);
+    this.reactTo(this.endpoint.lifecycle.destroying, this.#stop);
+    if (this.state.allowOfflineUse) {
+      await this.#start();
+    }
+  }
+  [Symbol.asyncDispose]() {
+    return this.#stop();
+  }
+  async #start() {
+    if (!this.state.enabled || this.internal.interface) {
+      return;
+    }
+    const interfaceType = this.constructor.interfaceType;
+    if (typeof interfaceType !== "function") {
+      throw new InternalError(`Remote server ${this.constructor.name} does not define a remote interface`);
+    }
+    const address = new AppAddress(this.state.address);
+    const intf = await interfaceType.create(this.endpoint, address);
+    this.internal.interface = intf;
+  }
+  async #stop() {
+    const { interface: intf } = this.internal;
+    if (!intf) {
+      return;
+    }
+    this.internal.interface = void 0;
+    await intf.close();
+  }
+  async #onOffline() {
+    if (!this.state.allowOfflineUse) {
+      await this.#stop();
+    }
+  }
+  static schema = new DatatypeModel(
+    {
+      name: "ApiState",
+      type: "struct"
+    },
+    FieldElement({ name: "address", type: "string" }),
+    FieldElement({ name: "enabled", type: "bool" }),
+    FieldElement({ name: "allowOfflineUse", type: "bool" })
+  );
+}
+((RemoteServer2) => {
+  class Internal {
+    interface;
+  }
+  RemoteServer2.Internal = Internal;
+  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 = "";
+    /**
+     * Set to false to disable this service.
+     */
+    enabled = true;
+    /**
+     * 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 = true;
+  }
+  RemoteServer2.State = State;
+})(RemoteServer || (RemoteServer = {}));
+export {
+  RemoteServer
+};
+//# sourceMappingURL=RemoteServer.js.map

package/dist/esm/behavior/system/remote/RemoteServer.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/remote/RemoteServer.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,gBAAgB;AACzB,SAAS,2BAA2B;AACpC,SAAS,YAAY,qBAAqB,qBAAqB;AAC/D,SAAS,eAAe,oBAAoB;AAE5C,SAAS,iCAAiC;AAenC,MAAe,qBAAqB,SAAS;AAAA,EAChD,OAAyB,QAAQ;AAAA,EAEjC,OAAO;AAAA,EAKP,MAAe,aAAa;AACxB,QAAI,EAAE,KAAK,IAAI,IAAI,mBAAmB,aAAa,4BAA4B;AAC3E,YAAM,IAAI,oBAAoB,gDAAgD;AAAA,IAClF;AAEA,SAAK,QAAS,KAAK,SAAwB,UAAU,QAAQ,KAAK,MAAM;AACxE,SAAK,QAAS,KAAK,SAAwB,UAAU,SAAS,KAAK,UAAU;AAI7E,SAAK,QAAS,KAAK,SAAwB,UAAU,YAAY,KAAK,KAAK;AAE3E,QAAI,KAAK,MAAM,iBAAiB;AAC5B,YAAM,KAAK,OAAO;AAAA,IACtB;AAAA,EACJ;AAAA,EAEA,CAAU,OAAO,YAAY,IAAI;AAC7B,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EAEA,MAAM,SAAS;AACX,QAAI,CAAC,KAAK,MAAM,WAAW,KAAK,SAAS,WAAW;AAChD;AAAA,IACJ;AAEA,UAAM,gBAAiB,KAAK,YAAoC;AAChE,QAAI,OAAQ,kBAA0B,YAAY;AAC9C,YAAM,IAAI,cAAc,iBAAiB,KAAK,YAAY,IAAI,qCAAqC;AAAA,IACvG;AAEA,UAAM,UAAU,IAAI,WAAW,KAAK,MAAM,OAAO;AACjD,UAAM,OAAO,MAAM,cAAc,OAAO,KAAK,UAAwB,OAAO;AAE5E,SAAK,SAAS,YAAY;AAAA,EAC9B;AAAA,EAEA,MAAM,QAAQ;AACV,UAAM,EAAE,WAAW,KAAK,IAAI,KAAK;AACjC,QAAI,CAAC,MAAM;AACP;AAAA,IACJ;AAEA,SAAK,SAAS,YAAY;AAC1B,UAAM,KAAK,MAAM;AAAA,EACrB;AAAA,EAEA,MAAM,aAAa;AACf,QAAI,CAAC,KAAK,MAAM,iBAAiB;AAC7B,YAAM,KAAK,MAAM;AAAA,IACrB;AAAA,EACJ;AAAA,EAEA,OAAyB,SAAS,IAAI;AAAA,IAClC;AAAA,MACI,MAAM;AAAA,MACN,MAAM;AAAA,IACV;AAAA,IAEA,aAAa,EAAE,MAAM,WAAW,MAAM,SAAS,CAAC;AAAA,IAChD,aAAa,EAAE,MAAM,WAAW,MAAM,OAAO,CAAC;AAAA,IAC9C,aAAa,EAAE,MAAM,mBAAmB,MAAM,OAAO,CAAC;AAAA,EAC1D;AACJ;AAAA,CAEO,CAAUA,kBAAV;AAAA,EACI,MAAM,SAAS;AAAA,IAClB;AAAA,EACJ;AAFO,EAAAA,cAAM;AAAA,EAIN,MAAM,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAYf,UAAU;AAAA;AAAA;AAAA;AAAA,IAKV,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQV,kBAAkB;AAAA,EACtB;AA1BO,EAAAA,cAAM;AAAA,GALA;",
+  "names": ["RemoteServer"]
+}

package/dist/esm/behavior/system/remote/api/Api.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Agent } from "#endpoint/Agent.js";
+import { Abort } from "#general";
+import { ServerNode } from "#node/ServerNode.js";
+import { ApiPath } from "./ApiPath.js";
+import { ApiResource } from "./ApiResource.js";
+import { LocalResponse } from "./LocalResponse.js";
+import { RemoteRequest } from "./RemoteRequest.js";
+import { RemoteResponse } from "./RemoteResponse.js";
+/**
+ * Common substrate for the network APIs.
+ *
+ * The logical API covers RPC and read/write semantics.  These involve a "/"-separated path and a logical operation
+ * (read, write, invoke, etc.)
+ *
+ * This namespace provides utilities for mapping paths to resources and taking action on the resource.
+ */
+export declare namespace Api {
+    /**
+     * Retrieve the {@link ApiResource} for a path.
+     */
+    function resourceFor(agent: Agent, path: ApiPath): Promise<ApiResource | void>;
+    function log(level: "error" | "info", facility: string, id: string | undefined, ...message: unknown[]): void;
+    function logRequest(facility: string, id: string | undefined, method: string, target: string): void;
+    function logResponse(facility: string, response: RemoteResponse): void;
+    /**
+     * Execute a {@link RemoteRequest}.
+     */
+    function execute(facility: string, node: ServerNode, request: RemoteRequest, signal: Abort.Signal): Promise<LocalResponse>;
+    function errorResponseOf(facility: string, id: string | undefined, error: unknown): LocalResponse;
+}
+//# sourceMappingURL=Api.d.ts.map

package/dist/esm/behavior/system/remote/api/Api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/Api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAA8C,MAAM,UAAU,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD;;;;;;;GAOG;AACH,yBAAiB,GAAG,CAAC;IACjB;;OAEG;IACH,SAAsB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwB1F;IAED,SAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,QAM3G;IAED,SAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAElG;IAED,SAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,QAerE;IAED;;OAEG;IACH,SAAsB,OAAO,CACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,KAAK,CAAC,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,CAmExB;IAED,SAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAWvG;CACJ"}