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

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { RemoteInterface } from "../remote/RemoteInterface.js";
+/**
+ * MQTT remote interface.
+ *
+ * Currently publishes a read-only feed.  Will address TODOs if there is real-world use.
+ *
+ * TODO - events
+ * TODO - clean out topics from previous runs that are no longer relevant, e.g. deleted endpoint, removed attrs, etc.
+ * TODO - TLV serialiation/deserialization
+ */
+export declare class MqttInterface extends RemoteInterface {
+    #private;
+    static protocol: string;
+    protected start(): Promise<void>;
+    protected stop(): Promise<void>;
+}
+//# sourceMappingURL=MqttInterface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MqttInterface.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/mqtt/MqttInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAI/D;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,eAAe;;IAC9C,OAAgB,QAAQ,SAAU;cAMT,KAAK;cA0BL,IAAI;CA+OhC"}

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

@@ -0,0 +1,341 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  Abort,
+  asJson,
+  Base64,
+  Bytes,
+  decamelize,
+  InternalError,
+  MqttService,
+  Mutex,
+  NotImplementedError
+} from "#general";
+import { any, Metatype } from "#model";
+import { StateStream } from "#node/integration/StateStream.js";
+import { StatusResponse } from "#types";
+import { Api } from "../remote/api/Api.js";
+import { ApiPath } from "../remote/api/ApiPath.js";
+import { Envelope } from "../remote/api/Envelope.js";
+import { RemoteResponse } from "../remote/api/RemoteResponse.js";
+import { RemoteInterface } from "../remote/RemoteInterface.js";
+const LOG_FACILITY = "MQTT";
+class MqttInterface extends RemoteInterface {
+  static protocol = "mqtt";
+  #endpoint;
+  #mutex = new Mutex(this);
+  #retainedTopics = /* @__PURE__ */ new Map();
+  async start() {
+    this.#endpoint = await this.env.get(MqttService).connect({
+      address: this.address,
+      environment: this.node.env,
+      will: {
+        topic: this.root.at("status").toString(),
+        payload: "offline"
+      },
+      onUp: (endpoint) => {
+        if (!this.#endpoint) {
+          this.#endpoint = endpoint;
+        }
+        return this.#publish({
+          topic: this.root.at("status").toString(),
+          payload: "online"
+        });
+      }
+    });
+    this.addWorker(this.#listen(), "mqtt listener");
+    this.addWorker(this.#feed(), "mqtt feeder");
+  }
+  async stop() {
+    await this.#mutex.then();
+    await this.#mqtt?.close();
+  }
+  /**
+   * A background process that handles incoming MQTT messages.
+   */
+  async #listen() {
+    await Abort.race(this.abort, this.node.construction);
+    if (Abort.is(this.abort)) {
+      return;
+    }
+    let topic = this.root.toString();
+    if (topic !== "") {
+      topic += "/#";
+    } else {
+      topic = "#";
+    }
+    for await (const message of this.#mqtt.subscribe(`${topic}`, { noLocal: true, abort: this.abort })) {
+      if (message.retain) {
+        continue;
+      }
+      const relativeTopic = this.root.subpathFor(new ApiPath(message.topic));
+      if (!relativeTopic) {
+        continue;
+      }
+      await this.#respond(relativeTopic, message);
+    }
+  }
+  async #respond(topic, message) {
+    let response;
+    const via = message.correlationData ? Bytes.toHex(message.correlationData) : message.responseTopic;
+    try {
+      await this.node.act("MQTT listener", async (agent) => {
+        if (topic.toString() === "call") {
+          response = await this.#call(message);
+          return;
+        }
+        const resource = await Api.resourceFor(agent, topic);
+        if (resource === void 0) {
+          throw new StatusResponse.NotFoundError(`No resource at subtopic ${topic}`);
+        }
+        const schema = resource.schema;
+        if (!schema) {
+          throw new NotImplementedError();
+        }
+        const input = payloadToJs(schema, message.payload);
+        if (resource.isInvocable) {
+          Api.logRequest(LOG_FACILITY, via, "invoke", topic.toString());
+          let value = await resource.invoke({ js: input });
+          const responseSchema = schema.responseModel;
+          if (responseSchema) {
+            value ??= new Envelope({ supervisor: resource.supervisorFor(responseSchema), js: null });
+            response = { kind: "value", value };
+          }
+        } else {
+          Api.logRequest(LOG_FACILITY, via, "update", topic.toString());
+          await resource.patch(input ?? { js: null });
+        }
+      });
+    } catch (e) {
+      response = Api.errorResponseOf(LOG_FACILITY, via, e);
+    }
+    if (!response) {
+      response = { kind: "ok" };
+    }
+    response.id = via;
+    Api.logResponse(LOG_FACILITY, RemoteResponse(response));
+    if (message.responseTopic) {
+      await this.#publish({
+        topic: message.responseTopic,
+        correlationData: message.correlationData,
+        payload: asJson(response)
+      });
+    }
+  }
+  /**
+   * Specialized handling for "call" topic to support full {@link RemoteRequest}/{@link RemoteResponse} interaction.
+   */
+  async #call(message) {
+    const request = parseJsonPayload(message.payload);
+    const response = await Api.execute(LOG_FACILITY, this.node, request, this.abort);
+    if (response.kind === "subscription") {
+      await response.stream.return?.();
+      throw new StatusResponse.InvalidSubscriptionError(
+        "Subscription via RPC is not supported, use MQTT instead"
+      );
+    }
+    return response;
+  }
+  /**
+   * A background process that continuously updates MQTT topics.
+   */
+  async #feed() {
+    const stream = StateStream(this.node, { abort: this.abort });
+    for await (const change of stream) {
+      await this.#mutex.produce(async () => {
+        switch (change.kind) {
+          case "update":
+            await this.#publishUpdate(change);
+            break;
+          case "delete":
+            await this.#publishDelete(change);
+        }
+      });
+    }
+  }
+  /**
+   * Publish attribute values for state changes.
+   */
+  async #publishUpdate({ node, endpoint, behavior, changes }) {
+    let nodeTopics = this.#retainedTopics.get(node.id);
+    if (nodeTopics === void 0) {
+      this.#retainedTopics.set(node.id, nodeTopics = /* @__PURE__ */ new Map());
+    }
+    let endpointTopics = nodeTopics.get(endpoint.number);
+    if (endpointTopics === void 0) {
+      nodeTopics.set(endpoint.number, endpointTopics = /* @__PURE__ */ new Set());
+    }
+    const behaviorRoot = this.#nodeRoot(node.id).at([endpoint.number.toString(), decamelize(behavior.id)]);
+    for (const name in changes) {
+      const value = changes[name];
+      const schema = behavior.schema?.conformant.properties.for(name);
+      const payload = jsToPayload(schema ?? any, value);
+      const topic = behaviorRoot.at([name]).toString();
+      endpointTopics.add(topic);
+      await this.#publish({
+        topic,
+        payload,
+        retain: true
+      });
+    }
+  }
+  /**
+   * Delete all published topics for an endpoint or node that has disappeared.
+   */
+  async #publishDelete(change) {
+    const nodeTopics = this.#retainedTopics.get(change.node.id);
+    if (!nodeTopics) {
+      return;
+    }
+    const deleteEndpoint = async (endpoint) => {
+      const topics = nodeTopics.get(endpoint);
+      if (!topics) {
+        return;
+      }
+      for (const topic of topics) {
+        await this.#publish({
+          topic,
+          payload: null,
+          retain: true
+        });
+      }
+      nodeTopics.delete(endpoint);
+    };
+    if (change.endpoint === change.node) {
+      for (const number of nodeTopics.keys()) {
+        await deleteEndpoint(number);
+      }
+      this.#retainedTopics.delete(change.node.id);
+    } else {
+      await deleteEndpoint(change.endpoint.number);
+    }
+  }
+  /**
+   * Obtain the root path for a node.
+   *
+   * This will either be the root path for the server or a subpath for peers.
+   */
+  #nodeRoot(id) {
+    if (id === this.node.id) {
+      return this.root;
+    }
+    return this.root.at(["peers", id]);
+  }
+  /**
+   * Safe access to the MQTT endpoint.
+   */
+  get #mqtt() {
+    if (this.#endpoint === void 0) {
+      throw new InternalError("MQTT endpoint missing");
+    }
+    return this.#endpoint;
+  }
+  /**
+   * Publish a message.
+   *
+   * Default QOS is 2.
+   */
+  #publish(message) {
+    if (this.abort.aborted) {
+      throw new InternalError("MQTT publish after abort");
+    }
+    if (message.qos === void 0) {
+      message.qos = 2;
+    }
+    return this.#mqtt.publish(message);
+  }
+}
+function payloadToJs(schema, payload) {
+  if (payload === null) {
+    return null;
+  }
+  const length = typeof payload === "string" ? payload.length : payload.byteLength;
+  if (!length) {
+    return null;
+  }
+  let js;
+  switch (schema.effectiveMetatype) {
+    case Metatype.any:
+      js = payload;
+      break;
+    case Metatype.object:
+    case Metatype.array:
+    case Metatype.bitmap:
+      js = parseJsonPayload(payload);
+      break;
+    case Metatype.bytes:
+      if (typeof payload === "string") {
+        try {
+          js = Base64.decode(payload);
+        } catch (e) {
+          if (e instanceof SyntaxError) {
+            throw new StatusResponse.InvalidDataTypeError(
+              `Value is not binary or a base64 string: ${e.message}`
+            );
+          }
+        }
+        break;
+      }
+      js = payload;
+      break;
+    default:
+      if (Bytes.isBytes(payload)) {
+        try {
+          payload = Bytes.toString(payload);
+        } catch (e) {
+          if (e instanceof TypeError) {
+            throw new StatusResponse.InvalidDataTypeError(
+              `Value is not a valid UTF-8 string: ${e.message}`
+            );
+          }
+        }
+      }
+      js = payload;
+      break;
+  }
+  return js;
+}
+function jsToPayload(schema, js) {
+  if (js === void 0 || js === null || js === "") {
+    return Bytes.empty;
+  }
+  switch (schema.effectiveMetatype) {
+    case Metatype.object:
+    case Metatype.array:
+    case Metatype.bitmap:
+      return asJson(js);
+    case Metatype.bytes:
+      if (Bytes.isBytes(js)) {
+        return js;
+      }
+      return Bytes.fromString(js.toString());
+    default:
+      if (Bytes.isBytes(js)) {
+        return js;
+      }
+      return js.toString();
+  }
+}
+function parseJsonPayload(payload) {
+  if (payload === null) {
+    throw new StatusResponse.InvalidDataTypeError("Empty payload where JSON expected");
+  }
+  if (Bytes.isBytes(payload)) {
+    payload = Bytes.toString(payload);
+  }
+  try {
+    return JSON.parse(payload);
+  } catch (e) {
+    if (e instanceof SyntaxError) {
+      throw new StatusResponse.InvalidDataTypeError(`Payload is not valid JSON: ${e.message}`);
+    }
+    throw e;
+  }
+}
+export {
+  MqttInterface
+};
+//# sourceMappingURL=MqttInterface.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { RemoteServer } from "../remote/RemoteServer.js";
+import { MqttInterface } from "./MqttInterface.js";
+/**
+ * Allows control of a Matter node via an MQTT broker.
+ *
+ * The broker must support MQTT version 5.
+ */
+export declare class MqttServer extends RemoteServer {
+    static readonly id = "mqtt";
+    static readonly interfaceType: typeof MqttInterface;
+}
+export declare namespace MqttServer {
+    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: string;
+    }
+}
+//# sourceMappingURL=MqttServer.d.ts.map

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"}