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

package/dist/cjs/behavior/system/http/HttpServer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { RemoteServer } from "../remote/RemoteServer.js";
+import { HttpInterface } from "./HttpInterface.js";
+/**
+ * Allows control of a Matter node using an HTTP API.
+ */
+export declare class HttpServer extends RemoteServer {
+    static readonly id = "http";
+    static readonly interfaceType: typeof HttpInterface;
+}
+export declare namespace HttpServer {
+    class State extends RemoteServer.State {
+        /**
+         * The HTTP server address.
+         *
+         * Supported protocols:
+         *
+         *   - http
+         *   - https
+         *   - http+unix (HTTP over UNIX socket)
+         *   - https+unix (HTTPS over UNIX socket)
+         */
+        address: string;
+    }
+}
+//# sourceMappingURL=HttpServer.d.ts.map

package/dist/cjs/behavior/system/http/HttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpServer.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/http/HttpServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;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;;;;;;;;;WASG;QACM,OAAO,SAA2B;KAC9C;CACJ"}

package/dist/cjs/behavior/system/http/HttpServer.js

@@ -0,0 +1,51 @@
+"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 HttpServer_exports = {};
+__export(HttpServer_exports, {
+  HttpServer: () => HttpServer
+});
+module.exports = __toCommonJS(HttpServer_exports);
+var import_RemoteServer = require("../remote/RemoteServer.js");
+var import_HttpInterface = require("./HttpInterface.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class HttpServer extends import_RemoteServer.RemoteServer {
+  static id = "http";
+  static interfaceType = import_HttpInterface.HttpInterface;
+}
+((HttpServer2) => {
+  class State extends import_RemoteServer.RemoteServer.State {
+    /**
+     * The HTTP server address.
+     *
+     * Supported protocols:
+     *
+     *   - http
+     *   - https
+     *   - http+unix (HTTP over UNIX socket)
+     *   - https+unix (HTTPS over UNIX socket)
+     */
+    address = "http+unix:matter.sock";
+  }
+  HttpServer2.State = State;
+})(HttpServer || (HttpServer = {}));
+//# sourceMappingURL=HttpServer.js.map

package/dist/cjs/behavior/system/http/HttpServer.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/http/HttpServer.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,0BAA6B;AAC7B,2BAA8B;AAP9B;AAAA;AAAA;AAAA;AAAA;AAYO,MAAM,mBAAmB,iCAAa;AAAA,EACzC,OAAyB,KAAK;AAAA,EAC9B,OAAyB,gBAAgB;AAC7C;AAAA,CAEO,CAAUA,gBAAV;AAAA,EACI,MAAM,cAAc,iCAAa,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAWjC,UAAU;AAAA,EACvB;AAZO,EAAAA,YAAM;AAAA,GADA;",
+  "names": ["HttpServer"]
+}

package/dist/cjs/behavior/system/http/index.d.ts

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

package/dist/cjs/behavior/system/http/index.d.ts.map

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

package/dist/cjs/behavior/system/http/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 http_exports = {};
+module.exports = __toCommonJS(http_exports);
+__reExport(http_exports, require("./HttpInterface.js"), module.exports);
+__reExport(http_exports, require("./HttpServer.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/http/index.js.map

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

package/dist/cjs/behavior/system/index/IndexBehavior.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { Endpoint } from "#endpoint/Endpoint.js";
-import { EventEmitter, Observable, Timer } from "#general";
+import { EventEmitter, Observable } from "#general";
 import { Behavior } from "../../Behavior.js";
 /**
  * This behavior indexes all descendents of a {@link Endpoint} by number.
@@ -21,7 +21,7 @@ export declare class IndexBehavior extends Behavior {
     initialize(): void;
     [Symbol.asyncDispose](): void;
     get partsById(): Record<string, Endpoint<import("../../../index.js").EndpointType.Empty>>;
-    get partsByNumber(): Record<number, Endpoint<import("../../../index.js").EndpointType.Empty>>;
+    get partsByNumber(): Record<string, Endpoint<import("../../../index.js").EndpointType.Empty>>;
     /**
      * Retrieve a {@link Endpoint} by number.
      *
@@ -32,7 +32,7 @@ export declare class IndexBehavior extends Behavior {
 }
 export declare namespace IndexBehavior {
     class Internal {
-        changeBroadcaster?: Timer;
+        changeBroadcastPending?: boolean;
         /**
          * Map of ID to {@link Endpoint}.
          */
@@ -40,7 +40,7 @@ export declare namespace IndexBehavior {
         /**
          * Map of number to {@link Endpoint}.
          */
-        partsByNumber: Record<number, Endpoint>;
+        partsByNumber: Record<string, Endpoint>;
     }
     class Events extends EventEmitter {
         /**

package/dist/cjs/behavior/system/index/IndexBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IndexBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/index/IndexBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,QAAQ;;IACvC,gBAAyB,EAAE,WAAW;IAE9B,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IACjC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;IAErC,gBAAyB,KAAK,QAAQ;IAE7B,UAAU;IAIV,CAAC,MAAM,CAAC,YAAY,CAAC;IAK9B,IAAI,SAAS,6EAEZ;IAED,IAAI,aAAa,6EAEhB;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;CAkE3B;AAED,yBAAiB,aAAa,CAAC;IAC3B,MAAa,QAAQ;QACjB,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAE1B;;WAEG;QACH,SAAS,EAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE3C;;WAEG;QACH,aAAa,EAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KAClD;IAED,MAAa,MAAO,SAAQ,YAAY;QACpC;;WAEG;QACH,MAAM,uBAAoB;KAC7B;CACJ"}
+{"version":3,"file":"IndexBehavior.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/index/IndexBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,QAAQ;;IACvC,gBAAyB,EAAE,WAAW;IAE9B,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;IACjC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;IAErC,gBAAyB,KAAK,QAAQ;IAE7B,UAAU;IAIV,CAAC,MAAM,CAAC,YAAY,CAAC;IAI9B,IAAI,SAAS,6EAEZ;IAED,IAAI,aAAa,6EAEhB;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;CA2E3B;AAED,yBAAiB,aAAa,CAAC;IAC3B,MAAa,QAAQ;QACjB,sBAAsB,CAAC,EAAE,OAAO,CAAC;QAEjC;;WAEG;QACH,SAAS,EAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE3C;;WAEG;QACH,aAAa,EAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KAClD;IAED,MAAa,MAAO,SAAQ,YAAY;QACpC;;WAEG;QACH,MAAM,uBAAoB;KAC7B;CACJ"}

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

@@ -36,8 +36,7 @@ class IndexBehavior extends import_Behavior.Behavior {
     this.reactTo(this.endpoint.lifecycle.changed, this.#handleChange);
   }
   [Symbol.asyncDispose]() {
-    this.internal.changeBroadcaster?.stop();
-    delete this.internal.changeBroadcaster;
+    this.internal.changeBroadcastPending = false;
   }
   get partsById() {
     return this.internal.partsById;
@@ -98,17 +97,23 @@ class IndexBehavior extends import_Behavior.Behavior {
    * Trigger change event lazily so transactions complete and we can coalesce into fewer events.
    */
   #change() {
-    if (this.internal.changeBroadcaster) {
+    const { internal } = this;
+    if (internal.changeBroadcastPending) {
       return;
     }
+    internal.changeBroadcastPending = true;
     void Promise.resolve().then(() => {
+      if (!internal.changeBroadcastPending) {
+        return;
+      }
+      internal.changeBroadcastPending = false;
       this.events.change.emit();
     });
   }
 }
 ((IndexBehavior2) => {
   class Internal {
-    changeBroadcaster;
+    changeBroadcastPending;
     /**
      * Map of ID to {@link Endpoint}.
      */

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../../src/behavior/system/index/IndexBehavior.ts"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,+BAAkC;AAClC,qBAAgD;AAChD,sBAAyB;AATzB;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,sBAAsB,yBAAS;AAAA,EACxC,OAAyB,KAAK;AAAA,EAK9B,OAAyB,QAAQ;AAAA,EAExB,aAAa;AAClB,SAAK,QAAQ,KAAK,SAAS,UAAU,SAAS,KAAK,aAAa;AAAA,EACpE;AAAA,EAEA,CAAU,OAAO,YAAY,IAAI;AAC7B,SAAK,SAAS,mBAAmB,KAAK;AACtC,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA,EAEA,IAAI,YAAY;AACZ,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA,EAEA,IAAI,gBAAgB;AAChB,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,QAAgB;AACtB,QAAI,KAAK,SAAS,UAAU,aAAa,WAAW,KAAK,SAAS,QAAQ;AACtE,aAAO,KAAK;AAAA,IAChB;AACA,WAAO,KAAK,SAAS,cAAc,MAAM;AAAA,EAC7C;AAAA,EAEA,cAAc,MAAgC,UAAoB;AAC9D,YAAQ,MAAM;AAAA,MACV,KAAK,2CAAkB,OAAO;AAAA,MAC9B,KAAK,2CAAkB,OAAO;AAAA,MAC9B,KAAK,2CAAkB,OAAO;AAC1B,aAAK,KAAK,QAAQ;AAClB,aAAK,QAAQ;AACb;AAAA,MAEJ,KAAK,2CAAkB,OAAO;AAC1B,aAAK,QAAQ,QAAQ;AACrB,aAAK,QAAQ;AACb;AAAA,IACR;AAAA,EACJ;AAAA,EAEA,KAAK,UAAoB;AACrB,QAAI,SAAS,UAAU,WAAW;AAE9B,WAAK,SAAS,cAAc,SAAS,MAAM,IAAI;AAAA,IACnD;AAEA,QAAI,SAAS,UAAU,OAAO;AAC1B,WAAK,SAAS,UAAU,SAAS,EAAE,IAAI;AAAA,IAC3C;AAEA,eAAW,SAAS,SAAS,OAAO;AAChC,WAAK,KAAK,KAAK;AAAA,IACnB;AAAA,EACJ;AAAA,EAEA,QAAQ,UAAoB;AACxB,QAAI,SAAS,MAAM,KAAK,SAAS,UAAU,SAAS,EAAE,MAAM,UAAU;AAClE,aAAO,KAAK,SAAS,UAAU,SAAS,EAAE;AAAA,IAC9C;AAEA,QAAI,SAAS,WAAW,UAAa,KAAK,SAAS,cAAc,SAAS,MAAM,MAAM,UAAU;AAC5F,aAAO,KAAK,SAAS,cAAc,SAAS,MAAM;AAAA,IACtD;AAEA,eAAW,SAAS,SAAS,OAAO;AAChC,WAAK,QAAQ,KAAK;AAAA,IACtB;AAEA,SAAK,QAAQ;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU;AACN,QAAI,KAAK,SAAS,mBAAmB;AACjC;AAAA,IACJ;AAEA,SAAK,QAAQ,QAAQ,EAAE,KAAK,MAAM;AAC9B,WAAK,OAAO,OAAO,KAAK;AAAA,IAC5B,CAAC;AAAA,EACL;AACJ;AAAA,CAEO,CAAUA,mBAAV;AAAA,EACI,MAAM,SAAS;AAAA,IAClB;AAAA;AAAA;AAAA;AAAA,IAKA,YAAY,CAAC;AAAA;AAAA;AAAA;AAAA,IAKb,gBAAgB,CAAC;AAAA,EACrB;AAZO,EAAAA,eAAM;AAAA,EAcN,MAAM,eAAe,4BAAa;AAAA;AAAA;AAAA;AAAA,IAIrC,aAAS,2BAAe;AAAA,EAC5B;AALO,EAAAA,eAAM;AAAA,GAfA;",
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,+BAAkC;AAClC,qBAAyC;AACzC,sBAAyB;AATzB;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,sBAAsB,yBAAS;AAAA,EACxC,OAAyB,KAAK;AAAA,EAK9B,OAAyB,QAAQ;AAAA,EAExB,aAAa;AAClB,SAAK,QAAQ,KAAK,SAAS,UAAU,SAAS,KAAK,aAAa;AAAA,EACpE;AAAA,EAEA,CAAU,OAAO,YAAY,IAAI;AAC7B,SAAK,SAAS,yBAAyB;AAAA,EAC3C;AAAA,EAEA,IAAI,YAAY;AACZ,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA,EAEA,IAAI,gBAAgB;AAChB,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,QAAgB;AACtB,QAAI,KAAK,SAAS,UAAU,aAAa,WAAW,KAAK,SAAS,QAAQ;AACtE,aAAO,KAAK;AAAA,IAChB;AACA,WAAO,KAAK,SAAS,cAAc,MAAM;AAAA,EAC7C;AAAA,EAEA,cAAc,MAAgC,UAAoB;AAC9D,YAAQ,MAAM;AAAA,MACV,KAAK,2CAAkB,OAAO;AAAA,MAC9B,KAAK,2CAAkB,OAAO;AAAA,MAC9B,KAAK,2CAAkB,OAAO;AAC1B,aAAK,KAAK,QAAQ;AAClB,aAAK,QAAQ;AACb;AAAA,MAEJ,KAAK,2CAAkB,OAAO;AAC1B,aAAK,QAAQ,QAAQ;AACrB,aAAK,QAAQ;AACb;AAAA,IACR;AAAA,EACJ;AAAA,EAEA,KAAK,UAAoB;AACrB,QAAI,SAAS,UAAU,WAAW;AAE9B,WAAK,SAAS,cAAc,SAAS,MAAM,IAAI;AAAA,IACnD;AAEA,QAAI,SAAS,UAAU,OAAO;AAC1B,WAAK,SAAS,UAAU,SAAS,EAAE,IAAI;AAAA,IAC3C;AAEA,eAAW,SAAS,SAAS,OAAO;AAChC,WAAK,KAAK,KAAK;AAAA,IACnB;AAAA,EACJ;AAAA,EAEA,QAAQ,UAAoB;AACxB,QAAI,SAAS,MAAM,KAAK,SAAS,UAAU,SAAS,EAAE,MAAM,UAAU;AAClE,aAAO,KAAK,SAAS,UAAU,SAAS,EAAE;AAAA,IAC9C;AAEA,QAAI,SAAS,WAAW,UAAa,KAAK,SAAS,cAAc,SAAS,MAAM,MAAM,UAAU;AAC5F,aAAO,KAAK,SAAS,cAAc,SAAS,MAAM;AAAA,IACtD;AAEA,eAAW,SAAS,SAAS,OAAO;AAChC,WAAK,QAAQ,KAAK;AAAA,IACtB;AAEA,SAAK,QAAQ;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU;AACN,UAAM,EAAE,SAAS,IAAI;AAErB,QAAI,SAAS,wBAAwB;AACjC;AAAA,IACJ;AAEA,aAAS,yBAAyB;AAElC,SAAK,QAAQ,QAAQ,EAAE,KAAK,MAAM;AAC9B,UAAI,CAAC,SAAS,wBAAwB;AAClC;AAAA,MACJ;AAEA,eAAS,yBAAyB;AAClC,WAAK,OAAO,OAAO,KAAK;AAAA,IAC5B,CAAC;AAAA,EACL;AACJ;AAAA,CAEO,CAAUA,mBAAV;AAAA,EACI,MAAM,SAAS;AAAA,IAClB;AAAA;AAAA;AAAA;AAAA,IAKA,YAAY,CAAC;AAAA;AAAA;AAAA;AAAA,IAKb,gBAAgB,CAAC;AAAA,EACrB;AAZO,EAAAA,eAAM;AAAA,EAcN,MAAM,eAAe,4BAAa;AAAA;AAAA;AAAA;AAAA,IAIrC,aAAS,2BAAe;AAAA,EAC5B;AALO,EAAAA,eAAM;AAAA,GAfA;",
   "names": ["IndexBehavior"]
 }

package/dist/cjs/behavior/system/index.d.ts

@@ -6,9 +6,13 @@
 export * from "./commissioning/index.js";
 export * from "./controller/index.js";
 export * from "./events/index.js";
+export * from "./http/index.js";
 export * from "./index/index.js";
+export * from "./mqtt/index.js";
 export * from "./network/index.js";
 export * from "./parts/index.js";
 export * from "./product-description/index.js";
+export * from "./remote/index.js";
 export * from "./sessions/index.js";
+export * from "./websocket/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/behavior/system/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/behavior/system/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/behavior/system/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

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

@@ -18,11 +18,15 @@ module.exports = __toCommonJS(system_exports);
 __reExport(system_exports, require("./commissioning/index.js"), module.exports);
 __reExport(system_exports, require("./controller/index.js"), module.exports);
 __reExport(system_exports, require("./events/index.js"), module.exports);
+__reExport(system_exports, require("./http/index.js"), module.exports);
 __reExport(system_exports, require("./index/index.js"), module.exports);
+__reExport(system_exports, require("./mqtt/index.js"), module.exports);
 __reExport(system_exports, require("./network/index.js"), module.exports);
 __reExport(system_exports, require("./parts/index.js"), module.exports);
 __reExport(system_exports, require("./product-description/index.js"), module.exports);
+__reExport(system_exports, require("./remote/index.js"), module.exports);
 __reExport(system_exports, require("./sessions/index.js"), module.exports);
+__reExport(system_exports, require("./websocket/index.js"), module.exports);
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/behavior/system/index.ts"],
-  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,2BAAc,qCANd;AAOA,2BAAc,kCAPd;AAQA,2BAAc,8BARd;AASA,2BAAc,6BATd;AAUA,2BAAc,+BAVd;AAWA,2BAAc,6BAXd;AAYA,2BAAc,2CAZd;AAaA,2BAAc,gCAbd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,2BAAc,qCANd;AAOA,2BAAc,kCAPd;AAQA,2BAAc,8BARd;AASA,2BAAc,4BATd;AAUA,2BAAc,6BAVd;AAWA,2BAAc,4BAXd;AAYA,2BAAc,+BAZd;AAaA,2BAAc,6BAbd;AAcA,2BAAc,2CAdd;AAeA,2BAAc,8BAfd;AAgBA,2BAAc,gCAhBd;AAiBA,2BAAc,iCAjBd;AAAA;AAAA;AAAA;AAAA;AAAA;",
   "names": []
 }

package/dist/cjs/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/cjs/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/cjs/behavior/system/mqtt/MqttInterface.js

@@ -0,0 +1,351 @@
+"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 MqttInterface_exports = {};
+__export(MqttInterface_exports, {
+  MqttInterface: () => MqttInterface
+});
+module.exports = __toCommonJS(MqttInterface_exports);
+var import_general = require("#general");
+var import_model = require("#model");
+var import_StateStream = require("#node/integration/StateStream.js");
+var import_types = require("#types");
+var import_Api = require("../remote/api/Api.js");
+var import_ApiPath = require("../remote/api/ApiPath.js");
+var import_Envelope = require("../remote/api/Envelope.js");
+var import_RemoteResponse = require("../remote/api/RemoteResponse.js");
+var import_RemoteInterface = require("../remote/RemoteInterface.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const LOG_FACILITY = "MQTT";
+class MqttInterface extends import_RemoteInterface.RemoteInterface {
+  static protocol = "mqtt";
+  #endpoint;
+  #mutex = new import_general.Mutex(this);
+  #retainedTopics = /* @__PURE__ */ new Map();
+  async start() {
+    this.#endpoint = await this.env.get(import_general.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 import_general.Abort.race(this.abort, this.node.construction);
+    if (import_general.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 import_ApiPath.ApiPath(message.topic));
+      if (!relativeTopic) {
+        continue;
+      }
+      await this.#respond(relativeTopic, message);
+    }
+  }
+  async #respond(topic, message) {
+    let response;
+    const via = message.correlationData ? import_general.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 import_Api.Api.resourceFor(agent, topic);
+        if (resource === void 0) {
+          throw new import_types.StatusResponse.NotFoundError(`No resource at subtopic ${topic}`);
+        }
+        const schema = resource.schema;
+        if (!schema) {
+          throw new import_general.NotImplementedError();
+        }
+        const input = payloadToJs(schema, message.payload);
+        if (resource.isInvocable) {
+          import_Api.Api.logRequest(LOG_FACILITY, via, "invoke", topic.toString());
+          let value = await resource.invoke({ js: input });
+          const responseSchema = schema.responseModel;
+          if (responseSchema) {
+            value ??= new import_Envelope.Envelope({ supervisor: resource.supervisorFor(responseSchema), js: null });
+            response = { kind: "value", value };
+          }
+        } else {
+          import_Api.Api.logRequest(LOG_FACILITY, via, "update", topic.toString());
+          await resource.patch(input ?? { js: null });
+        }
+      });
+    } catch (e) {
+      response = import_Api.Api.errorResponseOf(LOG_FACILITY, via, e);
+    }
+    if (!response) {
+      response = { kind: "ok" };
+    }
+    response.id = via;
+    import_Api.Api.logResponse(LOG_FACILITY, (0, import_RemoteResponse.RemoteResponse)(response));
+    if (message.responseTopic) {
+      await this.#publish({
+        topic: message.responseTopic,
+        correlationData: message.correlationData,
+        payload: (0, import_general.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 import_Api.Api.execute(LOG_FACILITY, this.node, request, this.abort);
+    if (response.kind === "subscription") {
+      await response.stream.return?.();
+      throw new import_types.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 = (0, import_StateStream.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(), (0, import_general.decamelize)(behavior.id)]);
+    for (const name in changes) {
+      const value = changes[name];
+      const schema = behavior.schema?.conformant.properties.for(name);
+      const payload = jsToPayload(schema ?? import_model.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 import_general.InternalError("MQTT endpoint missing");
+    }
+    return this.#endpoint;
+  }
+  /**
+   * Publish a message.
+   *
+   * Default QOS is 2.
+   */
+  #publish(message) {
+    if (this.abort.aborted) {
+      throw new import_general.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 import_model.Metatype.any:
+      js = payload;
+      break;
+    case import_model.Metatype.object:
+    case import_model.Metatype.array:
+    case import_model.Metatype.bitmap:
+      js = parseJsonPayload(payload);
+      break;
+    case import_model.Metatype.bytes:
+      if (typeof payload === "string") {
+        try {
+          js = import_general.Base64.decode(payload);
+        } catch (e) {
+          if (e instanceof SyntaxError) {
+            throw new import_types.StatusResponse.InvalidDataTypeError(
+              `Value is not binary or a base64 string: ${e.message}`
+            );
+          }
+        }
+        break;
+      }
+      js = payload;
+      break;
+    default:
+      if (import_general.Bytes.isBytes(payload)) {
+        try {
+          payload = import_general.Bytes.toString(payload);
+        } catch (e) {
+          if (e instanceof TypeError) {
+            throw new import_types.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 import_general.Bytes.empty;
+  }
+  switch (schema.effectiveMetatype) {
+    case import_model.Metatype.object:
+    case import_model.Metatype.array:
+    case import_model.Metatype.bitmap:
+      return (0, import_general.asJson)(js);
+    case import_model.Metatype.bytes:
+      if (import_general.Bytes.isBytes(js)) {
+        return js;
+      }
+      return import_general.Bytes.fromString(js.toString());
+    default:
+      if (import_general.Bytes.isBytes(js)) {
+        return js;
+      }
+      return js.toString();
+  }
+}
+function parseJsonPayload(payload) {
+  if (payload === null) {
+    throw new import_types.StatusResponse.InvalidDataTypeError("Empty payload where JSON expected");
+  }
+  if (import_general.Bytes.isBytes(payload)) {
+    payload = import_general.Bytes.toString(payload);
+  }
+  try {
+    return JSON.parse(payload);
+  } catch (e) {
+    if (e instanceof SyntaxError) {
+      throw new import_types.StatusResponse.InvalidDataTypeError(`Payload is not valid JSON: ${e.message}`);
+    }
+    throw e;
+  }
+}
+//# sourceMappingURL=MqttInterface.js.map