@matter/general 0.16.0-alpha.0-20251006-3fe1e7c57 → 0.16.0-alpha.0-20251011-d8942d7d5

package/dist/cjs/net/http/HttpService.js

@@ -0,0 +1,83 @@
+"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 HttpService_exports = {};
+__export(HttpService_exports, {
+  HttpService: () => HttpService
+});
+module.exports = __toCommonJS(HttpService_exports);
+var import_Environmental = require("#environment/Environmental.js");
+var import_MatterError = require("#MatterError.js");
+var import_AppAddress = require("#net/AppAddress.js");
+var import_HttpEndpointFactory = require("./HttpEndpointFactory.js");
+var import_HttpEndpointGroup = require("./HttpEndpointGroup.js");
+var import_HttpSharedEndpoint = require("./HttpSharedEndpoint.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class HttpService {
+  #factory;
+  #endpoints = {};
+  constructor(factory) {
+    this.#factory = factory;
+  }
+  async create(...addresses) {
+    if (addresses.length === 1) {
+      return this.#forAddress(addresses[0]);
+    }
+    const endpoints = Array();
+    try {
+      for (const address of addresses) {
+        endpoints.push(await this.#forAddress(address));
+      }
+    } catch (e) {
+      await Promise.allSettled(endpoints.map((endpoint) => endpoint.close()));
+      throw e;
+    }
+    return new import_HttpEndpointGroup.HttpEndpointGroup(endpoints);
+  }
+  async #forAddress(address) {
+    const addr = import_AppAddress.AppAddress.for(address);
+    if (addr.appProtocol !== "http" && addr.appProtocol !== "ws") {
+      throw new import_MatterError.ImplementationError(`Unsupported address ${addr} for HTTP endpoint`);
+    }
+    const key = JSON.stringify(addr.transport);
+    let endpoint = this.#endpoints[key];
+    if (endpoint) {
+      if (endpoint.isTls !== addr.isTls) {
+        const addrIs = addr.isTls ? "encrypted" : "unencrypted";
+        const endpointIs = endpoint.isTls ? "encrypted" : "unencrypted";
+        throw new import_MatterError.ImplementationError(
+          `Service address ${addr} is ${addrIs} but existing endpoint is ${endpointIs}`
+        );
+      }
+    } else {
+      endpoint = new import_HttpSharedEndpoint.HttpSharedEndpoint(addr.isTls, () => this.#factory.create({ address }));
+      this.#endpoints[key] = endpoint;
+    }
+    return await endpoint.use();
+  }
+  static [import_Environmental.Environmental.create](env) {
+    const instance = new HttpService(env.get(import_HttpEndpointFactory.HttpEndpointFactory));
+    env.set(HttpService, instance);
+    return instance;
+  }
+}
+//# sourceMappingURL=HttpService.js.map

package/dist/cjs/net/http/HttpService.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/http/HttpService.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,2BAA8B;AAC9B,yBAAoC;AACpC,wBAA2B;AAE3B,iCAAoC;AACpC,+BAAkC;AAClC,gCAAmC;AAbnC;AAAA;AAAA;AAAA;AAAA;AAkBO,MAAM,YAAY;AAAA,EACrB;AAAA,EACA,aAAa,CAAC;AAAA,EAEd,YAAY,SAA8B;AACtC,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,MAAM,UAAU,WAAoC;AAChD,QAAI,UAAU,WAAW,GAAG;AACxB,aAAO,KAAK,YAAY,UAAU,CAAC,CAAC;AAAA,IACxC;AAEA,UAAM,YAAY,MAAoB;AAEtC,QAAI;AACA,iBAAW,WAAW,WAAW;AAC7B,kBAAU,KAAK,MAAM,KAAK,YAAY,OAAO,CAAC;AAAA,MAClD;AAAA,IACJ,SAAS,GAAG;AACR,YAAM,QAAQ,WAAW,UAAU,IAAI,cAAY,SAAS,MAAM,CAAC,CAAC;AACpE,YAAM;AAAA,IACV;AAEA,WAAO,IAAI,2CAAkB,SAAS;AAAA,EAC1C;AAAA,EAEA,MAAM,YAAY,SAAgC;AAC9C,UAAM,OAAO,6BAAW,IAAI,OAAO;AACnC,QAAI,KAAK,gBAAgB,UAAU,KAAK,gBAAgB,MAAM;AAC1D,YAAM,IAAI,uCAAoB,uBAAuB,IAAI,oBAAoB;AAAA,IACjF;AAEA,UAAM,MAAM,KAAK,UAAU,KAAK,SAAS;AACzC,QAAI,WAAW,KAAK,WAAW,GAAG;AAClC,QAAI,UAAU;AACV,UAAI,SAAS,UAAU,KAAK,OAAO;AAC/B,cAAM,SAAS,KAAK,QAAQ,cAAc;AAC1C,cAAM,aAAa,SAAS,QAAQ,cAAc;AAClD,cAAM,IAAI;AAAA,UACN,mBAAmB,IAAI,OAAO,MAAM,6BAA6B,UAAU;AAAA,QAC/E;AAAA,MACJ;AAAA,IACJ,OAAO;AACH,iBAAW,IAAI,6CAAmB,KAAK,OAAO,MAAM,KAAK,SAAS,OAAO,EAAE,QAAQ,CAAC,CAAC;AACrF,WAAK,WAAW,GAAG,IAAI;AAAA,IAC3B;AAEA,WAAO,MAAM,SAAS,IAAI;AAAA,EAC9B;AAAA,EAEA,QAAQ,mCAAc,MAAM,EAAE,KAAkB;AAC5C,UAAM,WAAW,IAAI,YAAY,IAAI,IAAI,8CAAmB,CAAC;AAC7D,QAAI,IAAI,aAAa,QAAQ;AAC7B,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/cjs/net/http/HttpSharedEndpoint.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HttpEndpoint } from "./HttpEndpoint.js";
+/**
+ * Shared access to a single underlying HTTP endpoint.
+ */
+export declare class HttpSharedEndpoint {
+    #private;
+    constructor(isTls: boolean, create: () => Promise<HttpEndpoint>);
+    get isTls(): boolean;
+    use(): Promise<HttpEndpoint>;
+}
+//# sourceMappingURL=HttpSharedEndpoint.d.ts.map

package/dist/cjs/net/http/HttpSharedEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpSharedEndpoint.d.ts","sourceRoot":"","sources":["../../../../src/net/http/HttpSharedEndpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD;;GAEG;AACH,qBAAa,kBAAkB;;gBAMf,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC;IAK/D,IAAI,KAAK,YAER;IAEK,GAAG;CA0DZ"}

package/dist/cjs/net/http/HttpSharedEndpoint.js

@@ -0,0 +1,92 @@
+"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 HttpSharedEndpoint_exports = {};
+__export(HttpSharedEndpoint_exports, {
+  HttpSharedEndpoint: () => HttpSharedEndpoint
+});
+module.exports = __toCommonJS(HttpSharedEndpoint_exports);
+var import_Logger = require("#log/Logger.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_Logger.Logger.get("HttpSharedEntpoint");
+class HttpSharedEndpoint {
+  #create;
+  #target;
+  #instances = /* @__PURE__ */ new Set();
+  #isTls;
+  constructor(isTls, create) {
+    this.#isTls = isTls;
+    this.#create = create;
+  }
+  get isTls() {
+    return this.#isTls;
+  }
+  async use() {
+    if (this.#target === void 0) {
+      this.#target = this.#createTarget();
+    }
+    await this.#target;
+    const instance = {
+      http: void 0,
+      ws: void 0,
+      close: async () => {
+        this.#instances.delete(instance);
+        if (!this.#instances.size) {
+          try {
+            await (await this.#target)?.close();
+          } catch (e) {
+            logger.error("Error closing HTTP endpoint", e);
+          } finally {
+            this.#target = void 0;
+          }
+        }
+      }
+    };
+    this.#instances.add(instance);
+    return instance;
+  }
+  async #createTarget() {
+    const target = await this.#create();
+    target.http = async (request) => {
+      for (const instance of this.#instances) {
+        const response = await instance.http?.(request);
+        if (response) {
+          return response;
+        }
+      }
+    };
+    target.ws = async (request, connect) => {
+      let connected = false;
+      for (const instance of this.#instances) {
+        await instance.ws?.(request, async () => {
+          connected = true;
+          return connect();
+        });
+        if (connected) {
+          break;
+        }
+      }
+    };
+    return target;
+  }
+}
+//# sourceMappingURL=HttpSharedEndpoint.js.map

package/dist/cjs/net/http/HttpSharedEndpoint.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/http/HttpSharedEndpoint.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAAuB;AANvB;AAAA;AAAA;AAAA;AAAA;AASA,MAAM,SAAS,qBAAO,IAAI,oBAAoB;AAKvC,MAAM,mBAAmB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,aAAa,oBAAI,IAAkB;AAAA,EACnC;AAAA,EAEA,YAAY,OAAgB,QAAqC;AAC7D,SAAK,SAAS;AACd,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,MAAM,MAAM;AACR,QAAI,KAAK,YAAY,QAAW;AAC5B,WAAK,UAAU,KAAK,cAAc;AAAA,IACtC;AAEA,UAAM,KAAK;AAEX,UAAM,WAAyB;AAAA,MAC3B,MAAM;AAAA,MACN,IAAI;AAAA,MAEJ,OAAO,YAAY;AACf,aAAK,WAAW,OAAO,QAAQ;AAC/B,YAAI,CAAC,KAAK,WAAW,MAAM;AACvB,cAAI;AACA,mBAAO,MAAM,KAAK,UAAU,MAAM;AAAA,UACtC,SAAS,GAAG;AACR,mBAAO,MAAM,+BAA+B,CAAC;AAAA,UACjD,UAAE;AACE,iBAAK,UAAU;AAAA,UACnB;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK,WAAW,IAAI,QAAQ;AAE5B,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,gBAAgB;AAClB,UAAM,SAAS,MAAM,KAAK,QAAQ;AAElC,WAAO,OAAO,OAAM,YAAW;AAC3B,iBAAW,YAAY,KAAK,YAAY;AACpC,cAAM,WAAW,MAAM,SAAS,OAAO,OAAO;AAC9C,YAAI,UAAU;AACV,iBAAO;AAAA,QACX;AAAA,MACJ;AAAA,IACJ;AAEA,WAAO,KAAK,OAAO,SAAS,YAAY;AACpC,UAAI,YAAY;AAChB,iBAAW,YAAY,KAAK,YAAY;AACpC,cAAM,SAAS,KAAK,SAAS,YAAY;AACrC,sBAAY;AACZ,iBAAO,QAAQ;AAAA,QACnB,CAAC;AAED,YAAI,WAAW;AACX;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAEA,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/cjs/net/http/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./HttpEndpoint.js";
+export * from "./HttpEndpointFactory.js";
+export * from "./HttpEndpointGroup.js";
+export * from "./HttpService.js";
+export * from "./HttpSharedEndpoint.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/net/http/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/net/http/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/cjs/net/http/index.js

@@ -0,0 +1,28 @@
+"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("./HttpEndpoint.js"), module.exports);
+__reExport(http_exports, require("./HttpEndpointFactory.js"), module.exports);
+__reExport(http_exports, require("./HttpEndpointGroup.js"), module.exports);
+__reExport(http_exports, require("./HttpService.js"), module.exports);
+__reExport(http_exports, require("./HttpSharedEndpoint.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/net/http/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/http/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,yBAAc,8BANd;AAOA,yBAAc,qCAPd;AAQA,yBAAc,mCARd;AASA,yBAAc,6BATd;AAUA,yBAAc,oCAVd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/net/index.d.ts

@@ -6,7 +6,9 @@
 export * from "./AppAddress.js";
 export * from "./Channel.js";
 export * from "./ConnectionlessTransport.js";
+export * from "./http/index.js";
 export * from "./mock/index.js";
+export * from "./mqtt/index.js";
 export * from "./Network.js";
 export * from "./RetrySchedule.js";
 export * from "./ServerAddress.js";

package/dist/cjs/net/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/net/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/net/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC"}

package/dist/cjs/net/index.js

@@ -18,7 +18,9 @@ module.exports = __toCommonJS(net_exports);
 __reExport(net_exports, require("./AppAddress.js"), module.exports);
 __reExport(net_exports, require("./Channel.js"), module.exports);
 __reExport(net_exports, require("./ConnectionlessTransport.js"), module.exports);
+__reExport(net_exports, require("./http/index.js"), module.exports);
 __reExport(net_exports, require("./mock/index.js"), module.exports);
+__reExport(net_exports, require("./mqtt/index.js"), module.exports);
 __reExport(net_exports, require("./Network.js"), module.exports);
 __reExport(net_exports, require("./RetrySchedule.js"), module.exports);
 __reExport(net_exports, require("./ServerAddress.js"), module.exports);

package/dist/cjs/net/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/net/index.ts"],
-  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,wBAAc,4BANd;AAOA,wBAAc,yBAPd;AAQA,wBAAc,yCARd;AASA,wBAAc,4BATd;AAUA,wBAAc,yBAVd;AAWA,wBAAc,+BAXd;AAYA,wBAAc,+BAZd;AAaA,wBAAc,2BAbd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,wBAAc,4BANd;AAOA,wBAAc,yBAPd;AAQA,wBAAc,yCARd;AASA,wBAAc,4BATd;AAUA,wBAAc,4BAVd;AAWA,wBAAc,4BAXd;AAYA,wBAAc,yBAZd;AAaA,wBAAc,+BAbd;AAcA,wBAAc,+BAdd;AAeA,wBAAc,2BAfd;AAAA;AAAA;AAAA;AAAA;AAAA;",
   "names": []
 }

package/dist/cjs/net/mqtt/MqttEndpoint.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Environment } from "#environment/Environment.js";
+import { AppAddress } from "#net/AppAddress.js";
+import { Abort } from "#util/Abort.js";
+import { Bytes } from "#util/Bytes.js";
+import { MaybePromise } from "#util/Promises.js";
+export interface MqttEndpoint {
+    subscribe(topic: string, options?: MqttEndpoint.SubscriptionOptions): AsyncIterableIterator<MqttEndpoint.Message, void, void>;
+    publish(message: MqttEndpoint.Message): Promise<void>;
+    close(): Promise<void>;
+}
+export declare namespace MqttEndpoint {
+    interface Message {
+        topic: string;
+        payload: Bytes | string | null;
+        retain?: boolean;
+        contentType?: string;
+        responseTopic?: string;
+        correlationData?: Bytes;
+        qos?: 0 | 1 | 2;
+    }
+    function Message(message: Message): Message;
+    interface ConnectionOptions {
+        address: AppAddress.Definition;
+        environment?: Environment;
+        will?: Message;
+        onUp?: (endpoint: MqttEndpoint) => MaybePromise<void>;
+        onDown?: (endpoint: MqttEndpoint) => MaybePromise<void>;
+    }
+    interface SubscriptionOptions {
+        noLocal?: boolean;
+        abort?: Abort.Signal;
+    }
+}
+//# sourceMappingURL=MqttEndpoint.d.ts.map

package/dist/cjs/net/mqtt/MqttEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MqttEndpoint.d.ts","sourceRoot":"","sources":["../../../../src/net/mqtt/MqttEndpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,YAAY;IACzB,SAAS,CACL,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,YAAY,CAAC,mBAAmB,GAC3C,qBAAqB,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,yBAAiB,YAAY,CAAC;IAC1B,UAAiB,OAAO;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;QAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,KAAK,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;KACnB;IAED,SAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,WAEvC;IAED,UAAiB,iBAAiB;QAC9B,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC;QAC/B,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;KAC3D;IAED,UAAiB,mBAAmB;QAChC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC;KACxB;CACJ"}

package/dist/cjs/net/mqtt/MqttEndpoint.js

@@ -0,0 +1,36 @@
+"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 MqttEndpoint_exports = {};
+__export(MqttEndpoint_exports, {
+  MqttEndpoint: () => MqttEndpoint
+});
+module.exports = __toCommonJS(MqttEndpoint_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var MqttEndpoint;
+((MqttEndpoint2) => {
+  function Message(message) {
+    return message;
+  }
+  MqttEndpoint2.Message = Message;
+})(MqttEndpoint || (MqttEndpoint = {}));
+//# sourceMappingURL=MqttEndpoint.js.map

package/dist/cjs/net/mqtt/MqttEndpoint.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/mqtt/MqttEndpoint.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBO,IAAU;AAAA,CAAV,CAAUA,kBAAV;AAWI,WAAS,QAAQ,SAAkB;AACtC,WAAO;AAAA,EACX;AAFO,EAAAA,cAAS;AAAA,GAXH;",
+  "names": ["MqttEndpoint"]
+}

package/dist/cjs/net/mqtt/MqttEndpointFactory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MqttEndpoint } from "./MqttEndpoint.js";
+/**
+ * Connects to an MQTT broker.
+ *
+ * MQTT adapters should implement this class.  Clients should access via {@link MqttService}.
+ */
+export declare abstract class MqttEndpointFactory {
+    abstract connect(options: MqttEndpoint.ConnectionOptions): Promise<MqttEndpoint>;
+}
+//# sourceMappingURL=MqttEndpointFactory.d.ts.map

package/dist/cjs/net/mqtt/MqttEndpointFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MqttEndpointFactory.d.ts","sourceRoot":"","sources":["../../../../src/net/mqtt/MqttEndpointFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;GAIG;AACH,8BAAsB,mBAAmB;IACrC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;CACnF"}

package/dist/cjs/net/mqtt/MqttEndpointFactory.js

@@ -0,0 +1,31 @@
+"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 MqttEndpointFactory_exports = {};
+__export(MqttEndpointFactory_exports, {
+  MqttEndpointFactory: () => MqttEndpointFactory
+});
+module.exports = __toCommonJS(MqttEndpointFactory_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class MqttEndpointFactory {
+}
+//# sourceMappingURL=MqttEndpointFactory.js.map

package/dist/cjs/net/mqtt/MqttEndpointFactory.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/mqtt/MqttEndpointFactory.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAcO,MAAe,oBAAoB;AAE1C;",
+  "names": []
+}

package/dist/cjs/net/mqtt/MqttService.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Environment } from "#environment/Environment.js";
+import { Environmental } from "#environment/Environmental.js";
+import { MqttEndpoint } from "./MqttEndpoint.js";
+import { MqttEndpointFactory } from "./MqttEndpointFactory.js";
+/**
+ * Provides connections to MQTT brokers.
+ */
+export declare class MqttService {
+    #private;
+    constructor(factory: MqttEndpointFactory);
+    static [Environmental.create](env: Environment): MqttService;
+    connect(options: MqttEndpoint.ConnectionOptions): Promise<MqttEndpoint>;
+}
+//# sourceMappingURL=MqttService.d.ts.map

package/dist/cjs/net/mqtt/MqttService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MqttService.d.ts","sourceRoot":"","sources":["../../../../src/net/mqtt/MqttService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,qBAAa,WAAW;;gBAGR,OAAO,EAAE,mBAAmB;IAIxC,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW;IAO9C,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,iBAAiB;CASlD"}

package/dist/cjs/net/mqtt/MqttService.js

@@ -0,0 +1,52 @@
+"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 MqttService_exports = {};
+__export(MqttService_exports, {
+  MqttService: () => MqttService
+});
+module.exports = __toCommonJS(MqttService_exports);
+var import_Environmental = require("#environment/Environmental.js");
+var import_MatterError = require("#MatterError.js");
+var import_AppAddress = require("#net/AppAddress.js");
+var import_MqttEndpointFactory = require("./MqttEndpointFactory.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class MqttService {
+  #factory;
+  constructor(factory) {
+    this.#factory = factory;
+  }
+  static [import_Environmental.Environmental.create](env) {
+    const factory = env.get(import_MqttEndpointFactory.MqttEndpointFactory);
+    const instance = new this(factory);
+    env.set(MqttService, instance);
+    return instance;
+  }
+  connect(options) {
+    const addr = import_AppAddress.AppAddress.for(options.address);
+    if (addr.appProtocol !== "mqtt") {
+      throw new import_MatterError.ImplementationError(`Unsupported address ${addr} for MQTT connection`);
+    }
+    return this.#factory.connect(options);
+  }
+}
+//# sourceMappingURL=MqttService.js.map

package/dist/cjs/net/mqtt/MqttService.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/mqtt/MqttService.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,2BAA8B;AAC9B,yBAAoC;AACpC,wBAA2B;AAE3B,iCAAoC;AAXpC;AAAA;AAAA;AAAA;AAAA;AAgBO,MAAM,YAAY;AAAA,EACrB;AAAA,EAEA,YAAY,SAA8B;AACtC,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,QAAQ,mCAAc,MAAM,EAAE,KAAkB;AAC5C,UAAM,UAAU,IAAI,IAAI,8CAAmB;AAC3C,UAAM,WAAW,IAAI,KAAK,OAAO;AACjC,QAAI,IAAI,aAAa,QAAQ;AAC7B,WAAO;AAAA,EACX;AAAA,EAEA,QAAQ,SAAyC;AAC7C,UAAM,OAAO,6BAAW,IAAI,QAAQ,OAAO;AAE3C,QAAI,KAAK,gBAAgB,QAAQ;AAC7B,YAAM,IAAI,uCAAoB,uBAAuB,IAAI,sBAAsB;AAAA,IACnF;AAEA,WAAO,KAAK,SAAS,QAAQ,OAAO;AAAA,EACxC;AACJ;",
+  "names": []
+}

package/dist/cjs/net/mqtt/index.d.ts

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

package/dist/cjs/net/mqtt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/net/mqtt/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC"}

package/dist/cjs/net/mqtt/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mqtt_exports = {};
+module.exports = __toCommonJS(mqtt_exports);
+__reExport(mqtt_exports, require("./MqttEndpoint.js"), module.exports);
+__reExport(mqtt_exports, require("./MqttEndpointFactory.js"), module.exports);
+__reExport(mqtt_exports, require("./MqttService.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/net/mqtt/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/net/mqtt/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,yBAAc,8BANd;AAOA,yBAAc,qCAPd;AAQA,yBAAc,6BARd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/net/udp/UdpChannel.d.ts

@@ -8,12 +8,41 @@ import { ChannelType } from "../Channel.js";
 import { ConnectionlessTransport } from "../ConnectionlessTransport.js";
 /** @see {@link MatterSpecification.v12.Core} § 4.4.4 */
 export declare const MAX_UDP_MESSAGE_SIZE: number;
-export type UdpSocketType = "udp4" | "udp6";
+/**
+ * UDP socket address type.
+ *
+ * "udp4" and "udp6" are IPv4 and IPv6 exclusively.  "udp" binds both IPv4 and IPv6 addresses.
+ */
+export type UdpSocketType = "udp" | "udp4" | "udp6";
 export interface UdpChannelOptions {
-    listeningPort?: number;
+    /**
+     * UDP channel type.  "udp4" and "udp6" mean IPv4 and IPv6 respectively.  "udp" is dual-mode IPv4/IPv6.
+     */
     type: UdpSocketType;
+    /**
+     * The port to listen on.  undefined or 0 directs the operating system to select an open port.
+     */
+    listeningPort?: number;
+    /**
+     * The address to listen on, either a hostname or IP address in correct format based on {@link type}.
+     *
+     * undefined directs the operating system to listen on all addresses on the port.  "0.0.0.0" is wildcard IPv4 and
+     * "::" is wildcard IPv6.
+     *
+     * "0.0.0.0" is not allowed if {@link type} is "udp".
+     */
     listeningAddress?: string;
+    /**
+     * Specifies a specific network interface.
+     *
+     * This is required for multicast sockets.
+     */
     netInterface?: string;
+    /**
+     * Address+port pairs are normally may normally only be opened by a single socket.  This allows shared access to a
+     * port.
+     */
+    reuseAddress?: boolean;
 }
 export interface UdpChannel {
     maxPayloadSize: number;

package/dist/cjs/net/udp/UdpChannel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UdpChannel.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpChannel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,CAAC;IACxE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1D;AAED,yBAAiB,UAAU,CAAC;IACxB,UAAiB,QAAQ;QACrB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;KAChG;CACJ"}
+{"version":3,"file":"UdpChannel.d.ts","sourceRoot":"","sources":["../../../../src/net/udp/UdpChannel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAE9C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,CAAC;IACxE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1D;AAED,yBAAiB,UAAU,CAAC;IACxB,UAAiB,QAAQ;QACrB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;KAChG;CACJ"}