@matter/node 0.16.0-alpha.0-20251004-92135c7df → 0.16.0-alpha.0-20251011-d8942d7d5

package/dist/esm/behavior/system/mqtt/MqttServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MqttServer.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/mqtt/MqttServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,YAAY;IACxC,gBAAyB,EAAE,UAAU;IACrC,gBAAyB,aAAa,uBAAiB;CAC1D;AAED,yBAAiB,UAAU,CAAC;IACxB,MAAa,KAAM,SAAQ,YAAY,CAAC,KAAK;QACzC;;;;;;;;;;;;;WAaG;QACM,OAAO,SAAkC;KACrD;CACJ"}

package/dist/esm/behavior/system/mqtt/MqttServer.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { RemoteServer } from "../remote/RemoteServer.js";
+import { MqttInterface } from "./MqttInterface.js";
+class MqttServer extends RemoteServer {
+  static id = "mqtt";
+  static interfaceType = MqttInterface;
+}
+((MqttServer2) => {
+  class State extends RemoteServer.State {
+    /**
+     * The MQTT broker address.
+     *
+     * Supported protocols:
+     *
+     *   - mqtt
+     *   - mqtts
+     *   - mqtt+ws (MQTT over web sockets)
+     *   - mqtt+wss
+     *   - mqtt+unix (MQTT over UNIX socket)
+     *   - mqtts+unix
+     *
+     * If present, the path portion of the address adds a prefix to the topics registered by the server.
+     */
+    address = "mqtt:localhost/matter/{node}";
+  }
+  MqttServer2.State = State;
+})(MqttServer || (MqttServer = {}));
+export {
+  MqttServer
+};
+//# sourceMappingURL=MqttServer.js.map

package/dist/esm/behavior/system/mqtt/MqttServer.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/mqtt/MqttServer.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAOvB,MAAM,mBAAmB,aAAa;AAAA,EACzC,OAAyB,KAAK;AAAA,EAC9B,OAAyB,gBAAgB;AAC7C;AAAA,CAEO,CAAUA,gBAAV;AAAA,EACI,MAAM,cAAc,aAAa,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAejC,UAAU;AAAA,EACvB;AAhBO,EAAAA,YAAM;AAAA,GADA;",
+  "names": ["MqttServer"]
+}

package/dist/esm/behavior/system/mqtt/index.d.ts

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

package/dist/esm/behavior/system/mqtt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/mqtt/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

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

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

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

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

package/dist/esm/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/esm/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/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"}