@matter/mqtt 0.16.0-alpha.0-20251011-d8942d7d5

package/dist/esm/MqttJsEndpoint.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MqttEndpoint } from "#general";
+import { MqttClient } from "mqtt";
+/**
+ * MQTT.js-based MQTT endpoint.
+ */
+export declare class MqttJsEndpoint implements MqttEndpoint {
+    #private;
+    constructor(client: MqttClient, options: MqttEndpoint.ConnectionOptions);
+    subscribe(topic: string, options?: MqttEndpoint.SubscriptionOptions): AsyncIterableIterator<MqttEndpoint.Message>;
+    publish(message: MqttEndpoint.Message): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=MqttJsEndpoint.d.ts.map

package/dist/esm/MqttJsEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MqttJsEndpoint.d.ts","sourceRoot":"","sources":["../../src/MqttJsEndpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAe,YAAY,EAAS,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAsC,UAAU,EAAqB,MAAM,MAAM,CAAC;AAGzF;;GAEG;AACH,qBAAa,cAAe,YAAW,YAAY;;gBAKnC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,iBAAiB;IAiBhE,SAAS,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,YAAY,CAAC,mBAAmB,GAC3C,qBAAqB,CAAC,YAAY,CAAC,OAAO,CAAC;IAmDxC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,KAAK;CAId"}

package/dist/esm/MqttJsEndpoint.js

@@ -0,0 +1,80 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Abort, Gate, Mutex } from "#general";
+import { MqttJsMessage } from "./MqttJsMessage.js";
+class MqttJsEndpoint {
+  #client;
+  #nextSubscriptionIdentifier = 1;
+  #mutex = new Mutex(this);
+  constructor(client, options) {
+    this.#client = client;
+    const { onUp, onDown } = options;
+    if (onUp) {
+      const onConnect = () => this.#mutex.run(async () => onUp(this));
+      queueMicrotask(onConnect);
+      this.#client.on("connect", () => this.#mutex.run(async () => onUp(this)));
+    }
+    if (onDown) {
+      this.#client.on("offline", () => this.#mutex.run(async () => onDown(this)));
+    }
+  }
+  async *subscribe(topic, options) {
+    const subscriptionIdentifier = this.#nextSubscriptionIdentifier++;
+    const queue = new Array();
+    const gate = new Gate();
+    let grants;
+    try {
+      this.#client.on("message", onMessage);
+      grants = await this.#client.subscribeAsync(topic, {
+        nl: options?.noLocal ?? true,
+        properties: {
+          subscriptionIdentifier
+        }
+      });
+      while (true) {
+        await Abort.race(options?.abort, gate);
+        if (Abort.is(options?.abort)) {
+          break;
+        }
+        while (true) {
+          const message = queue.shift();
+          if (message === void 0) {
+            gate.close();
+            break;
+          }
+          yield message;
+        }
+      }
+    } finally {
+      this.#client.off("message", onMessage);
+      if (grants && !(this.#client.disconnecting || this.#client.disconnected)) {
+        for (const grant of grants) {
+          await this.#client.unsubscribeAsync(grant.topic);
+        }
+      }
+    }
+    function onMessage(_topic, _payload, packet) {
+      if (packet.properties?.subscriptionIdentifier !== subscriptionIdentifier) {
+        return;
+      }
+      queue.push(MqttJsMessage.decode(packet));
+      gate.open();
+    }
+    onMessage;
+  }
+  async publish(message) {
+    const { topic, payload, options } = MqttJsMessage.encode(message);
+    await this.#client.publishAsync(topic, payload, options);
+  }
+  async close() {
+    await this.#client.endAsync();
+    await this.#mutex.then();
+  }
+}
+export {
+  MqttJsEndpoint
+};
+//# sourceMappingURL=MqttJsEndpoint.js.map

package/dist/esm/MqttJsEndpoint.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/MqttJsEndpoint.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,OAAO,MAAoB,aAAa;AAEjD,SAAS,qBAAqB;AAKvB,MAAM,eAAuC;AAAA,EAChD;AAAA,EACA,8BAA8B;AAAA,EAC9B,SAAS,IAAI,MAAM,IAAI;AAAA,EAEvB,YAAY,QAAoB,SAAyC;AACrE,SAAK,UAAU;AAEf,UAAM,EAAE,MAAM,OAAO,IAAI;AAEzB,QAAI,MAAM;AACN,YAAM,YAAY,MAAM,KAAK,OAAO,IAAI,YAAY,KAAK,IAAI,CAAC;AAE9D,qBAAe,SAAS;AACxB,WAAK,QAAQ,GAAG,WAAW,MAAM,KAAK,OAAO,IAAI,YAAY,KAAK,IAAI,CAAC,CAAC;AAAA,IAC5E;AAEA,QAAI,QAAQ;AACR,WAAK,QAAQ,GAAG,WAAW,MAAM,KAAK,OAAO,IAAI,YAAY,OAAO,IAAI,CAAC,CAAC;AAAA,IAC9E;AAAA,EACJ;AAAA,EAEA,OAAO,UACH,OACA,SAC2C;AAC3C,UAAM,yBAAyB,KAAK;AAEpC,UAAM,QAAQ,IAAI,MAA4B;AAC9C,UAAM,OAAO,IAAI,KAAK;AAEtB,QAAI;AACJ,QAAI;AACA,WAAK,QAAQ,GAAG,WAAW,SAAS;AACpC,eAAS,MAAM,KAAK,QAAQ,eAAe,OAAO;AAAA,QAC9C,IAAI,SAAS,WAAW;AAAA,QACxB,YAAY;AAAA,UACR;AAAA,QACJ;AAAA,MACJ,CAAC;AAED,aAAO,MAAM;AACT,cAAM,MAAM,KAAK,SAAS,OAAO,IAAI;AACrC,YAAI,MAAM,GAAG,SAAS,KAAK,GAAG;AAC1B;AAAA,QACJ;AAEA,eAAO,MAAM;AACT,gBAAM,UAAU,MAAM,MAAM;AAC5B,cAAI,YAAY,QAAW;AACvB,iBAAK,MAAM;AACX;AAAA,UACJ;AACA,gBAAM;AAAA,QACV;AAAA,MACJ;AAAA,IACJ,UAAE;AACE,WAAK,QAAQ,IAAI,WAAW,SAAS;AACrC,UAAI,UAAU,EAAE,KAAK,QAAQ,iBAAiB,KAAK,QAAQ,eAAe;AACtE,mBAAW,SAAS,QAAQ;AACxB,gBAAM,KAAK,QAAQ,iBAAiB,MAAM,KAAK;AAAA,QACnD;AAAA,MACJ;AAAA,IACJ;AAEA,aAAS,UAAU,QAAiB,UAAmB,QAAwB;AAC3E,UAAI,OAAO,YAAY,2BAA2B,wBAAwB;AACtE;AAAA,MACJ;AACA,YAAM,KAAK,cAAc,OAAO,MAAM,CAAC;AACvC,WAAK,KAAK;AAAA,IACd;AAEA;AAAA,EACJ;AAAA,EAEA,MAAM,QAAQ,SAA8C;AACxD,UAAM,EAAE,OAAO,SAAS,QAAQ,IAAI,cAAc,OAAO,OAAO;AAChE,UAAM,KAAK,QAAQ,aAAa,OAAO,SAAS,OAAO;AAAA,EAC3D;AAAA,EAEA,MAAM,QAAQ;AACV,UAAM,KAAK,QAAQ,SAAS;AAC5B,UAAM,KAAK,OAAO,KAAK;AAAA,EAC3B;AACJ;",
+  "names": []
+}

package/dist/esm/MqttJsEndpointFactory.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MqttEndpoint, MqttEndpointFactory } from "#general";
+import { MqttJsEndpoint } from "./MqttJsEndpoint.js";
+/**
+ * MQTT.js-based MQTT implementation.
+ */
+export declare class MqttJsEndpointFactory extends MqttEndpointFactory {
+    connect(options: MqttEndpoint.ConnectionOptions): Promise<MqttJsEndpoint>;
+}
+//# sourceMappingURL=MqttJsEndpointFactory.d.ts.map

package/dist/esm/MqttJsEndpointFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MqttJsEndpointFactory.d.ts","sourceRoot":"","sources":["../../src/MqttJsEndpointFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAmC,YAAY,EAAE,mBAAmB,EAAkB,MAAM,UAAU,CAAC;AAE9G,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;IAC3C,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,iBAAiB;CA2DjE"}

package/dist/esm/MqttJsEndpointFactory.js

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AppAddress, ImplementationError, MqttEndpointFactory, StorageService } from "#general";
+import { connectAsync } from "mqtt";
+import { MqttJsEndpoint } from "./MqttJsEndpoint.js";
+import { MqttJsMessage } from "./MqttJsMessage.js";
+class MqttJsEndpointFactory extends MqttEndpointFactory {
+  async connect(options) {
+    const addr = AppAddress.for(options.address);
+    const opts = {
+      protocolVersion: 5
+    };
+    if (addr.protocolModifiers.includes("ws")) {
+      opts.protocol = "ws";
+      opts.path = addr.pathname;
+    } else {
+      opts.protocol = "mqtt";
+    }
+    if (addr.isTls) {
+      opts.protocol += "s";
+    }
+    const transport = addr.transport;
+    switch (transport.kind) {
+      case "ip":
+        opts.hostname = addr.hostname;
+        if (addr.port) {
+          opts.port = Number(addr.port);
+        }
+        break;
+      case "unix":
+        opts.protocol += "+unix";
+        opts.unixSocket = true;
+        opts.path = decodeURIComponent(addr.hostname);
+        const storage = options.environment?.get(StorageService);
+        if (storage) {
+          opts.path = storage.resolve(opts.path);
+        }
+        break;
+      default:
+        throw new ImplementationError(
+          `Unknown transport address kind ${transport.kind}`
+        );
+    }
+    if (addr.username) {
+      opts.username = addr.username;
+    }
+    if (addr.password) {
+      opts.password = addr.password;
+    }
+    if (options.will) {
+      opts.will = MqttJsMessage.encode(options.will);
+    }
+    const client = await connectAsync(opts);
+    return new MqttJsEndpoint(client, options);
+  }
+}
+export {
+  MqttJsEndpointFactory
+};
+//# sourceMappingURL=MqttJsEndpointFactory.js.map

package/dist/esm/MqttJsEndpointFactory.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/MqttJsEndpointFactory.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,YAAY,qBAAmC,qBAAqB,sBAAsB;AACnG,SAAS,oBAAoC;AAC7C,SAAS,sBAAsB;AAC/B,SAAS,qBAAqB;AAKvB,MAAM,8BAA8B,oBAAoB;AAAA,EAC3D,MAAe,QAAQ,SAAyC;AAC5D,UAAM,OAAO,WAAW,IAAI,QAAQ,OAAO;AAC3C,UAAM,OAAuB;AAAA,MACzB,iBAAiB;AAAA,IACrB;AAEA,QAAI,KAAK,kBAAkB,SAAS,IAAI,GAAG;AACvC,WAAK,WAAW;AAGhB,WAAK,OAAO,KAAK;AAAA,IACrB,OAAO;AACH,WAAK,WAAW;AAAA,IACpB;AAEA,QAAI,KAAK,OAAO;AACZ,WAAK,YAAY;AAAA,IACrB;AAEA,UAAM,YAAY,KAAK;AACvB,YAAQ,UAAU,MAAM;AAAA,MACpB,KAAK;AACD,aAAK,WAAW,KAAK;AACrB,YAAI,KAAK,MAAM;AACX,eAAK,OAAO,OAAO,KAAK,IAAI;AAAA,QAChC;AACA;AAAA,MAEJ,KAAK;AACD,aAAK,YAAY;AACjB,aAAK,aAAa;AAClB,aAAK,OAAO,mBAAmB,KAAK,QAAQ;AAC5C,cAAM,UAAU,QAAQ,aAAa,IAAI,cAAc;AACvD,YAAI,SAAS;AACT,eAAK,OAAO,QAAQ,QAAQ,KAAK,IAAI;AAAA,QACzC;AACA;AAAA,MAEJ;AACI,cAAM,IAAI;AAAA,UACN,kCAAmC,UAA0C,IAAI;AAAA,QACrF;AAAA,IACR;AAEA,QAAI,KAAK,UAAU;AACf,WAAK,WAAW,KAAK;AAAA,IACzB;AACA,QAAI,KAAK,UAAU;AACf,WAAK,WAAW,KAAK;AAAA,IACzB;AAEA,QAAI,QAAQ,MAAM;AACd,WAAK,OAAO,cAAc,OAAO,QAAQ,IAAI;AAAA,IACjD;AAEA,UAAM,SAAS,MAAM,aAAa,IAAI;AAEtC,WAAO,IAAI,eAAe,QAAQ,OAAO;AAAA,EAC7C;AACJ;",
+  "names": []
+}

package/dist/esm/MqttJsMessage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MqttEndpoint } from "#general";
+import { IClientPublishOptions, IPublishPacket } from "mqtt";
+export declare namespace MqttJsMessage {
+    function encode(message: MqttEndpoint.Message): {
+        topic: string;
+        payload: string | Buffer;
+        options?: IClientPublishOptions;
+    };
+    function decode(message: IPublishPacket): MqttEndpoint.Message;
+}
+//# sourceMappingURL=MqttJsMessage.d.ts.map

package/dist/esm/MqttJsMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MqttJsMessage.d.ts","sourceRoot":"","sources":["../../src/MqttJsMessage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAS,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAQ7D,yBAAiB,aAAa,CAAC;IAC3B,SAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG;QACnD,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,qBAAqB,CAAC;KACnC,CA6BA;IAED,SAAgB,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,OAAO,CAUpE;CACJ"}

package/dist/esm/MqttJsMessage.js

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Bytes } from "#general";
+import { Buffer as SafeBuffer } from "safe-buffer";
+const Buffer = globalThis.Buffer ?? SafeBuffer;
+const empty = Buffer.alloc(0);
+var MqttJsMessage;
+((MqttJsMessage2) => {
+  function encode(message) {
+    let payload, payloadFormatIndicator;
+    if (message.payload === null) {
+      payload = empty;
+      payloadFormatIndicator = false;
+    } else if (Bytes.isBytes(message.payload)) {
+      payload = bytesToBuffer(message.payload);
+      payloadFormatIndicator = false;
+    } else {
+      payload = message.payload;
+      payloadFormatIndicator = true;
+    }
+    return {
+      topic: message.topic,
+      payload,
+      options: {
+        qos: message.qos,
+        retain: message.retain,
+        properties: {
+          payloadFormatIndicator,
+          contentType: message.contentType,
+          correlationData: message.correlationData && bytesToBuffer(message.correlationData),
+          responseTopic: message.responseTopic
+        }
+      }
+    };
+  }
+  MqttJsMessage2.encode = encode;
+  function decode(message) {
+    return {
+      topic: message.topic,
+      payload: message.payload.length ? message.payload : null,
+      qos: message.qos,
+      retain: message.retain,
+      contentType: message.properties?.contentType,
+      correlationData: message.properties?.correlationData,
+      responseTopic: message.properties?.responseTopic
+    };
+  }
+  MqttJsMessage2.decode = decode;
+})(MqttJsMessage || (MqttJsMessage = {}));
+function bytesToBuffer(bytes) {
+  bytes = Bytes.exclusive(bytes);
+  if (bytes instanceof ArrayBuffer) {
+    return Buffer.from(bytes);
+  }
+  return Buffer.from(bytes.buffer, bytes.byteLength, bytes.byteOffset);
+}
+export {
+  MqttJsMessage
+};
+//# sourceMappingURL=MqttJsMessage.js.map

package/dist/esm/MqttJsMessage.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/MqttJsMessage.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,aAA2B;AAEpC,SAAS,UAAU,kBAAkB;AAIrC,MAAM,SAAS,WAAW,UAAU;AACpC,MAAM,QAAQ,OAAO,MAAM,CAAC;AAErB,IAAU;AAAA,CAAV,CAAUA,mBAAV;AACI,WAAS,OAAO,SAIrB;AACE,QAAI,SAA0B;AAC9B,QAAI,QAAQ,YAAY,MAAM;AAC1B,gBAAU;AACV,+BAAyB;AAAA,IAC7B,WAAW,MAAM,QAAQ,QAAQ,OAAO,GAAG;AACvC,gBAAU,cAAc,QAAQ,OAAO;AACvC,+BAAyB;AAAA,IAC7B,OAAO;AACH,gBAAU,QAAQ;AAClB,+BAAyB;AAAA,IAC7B;AAEA,WAAO;AAAA,MACH,OAAO,QAAQ;AAAA,MACf;AAAA,MAEA,SAAS;AAAA,QACL,KAAK,QAAQ;AAAA,QACb,QAAQ,QAAQ;AAAA,QAEhB,YAAY;AAAA,UACR;AAAA,UACA,aAAa,QAAQ;AAAA,UACrB,iBAAiB,QAAQ,mBAAmB,cAAc,QAAQ,eAAe;AAAA,UACjF,eAAe,QAAQ;AAAA,QAC3B;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAjCO,EAAAA,eAAS;AAmCT,WAAS,OAAO,SAA+C;AAClE,WAAO;AAAA,MACH,OAAO,QAAQ;AAAA,MACf,SAAS,QAAQ,QAAQ,SAAS,QAAQ,UAAU;AAAA,MACpD,KAAK,QAAQ;AAAA,MACb,QAAQ,QAAQ;AAAA,MAChB,aAAa,QAAQ,YAAY;AAAA,MACjC,iBAAiB,QAAQ,YAAY;AAAA,MACrC,eAAe,QAAQ,YAAY;AAAA,IACvC;AAAA,EACJ;AAVO,EAAAA,eAAS;AAAA,GApCH;AAiDjB,SAAS,cAAc,OAAc;AACjC,UAAQ,MAAM,UAAU,KAAK;AAE7B,MAAI,iBAAiB,aAAa;AAC9B,WAAO,OAAO,KAAK,KAAK;AAAA,EAC5B;AAEA,SAAO,OAAO,KAAK,MAAM,QAAQ,MAAM,YAAY,MAAM,UAAU;AACvE;",
+  "names": ["MqttJsMessage"]
+}

package/dist/esm/index.d.ts

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

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,4BAA4B,CAAC;AAE3C,OAAO,cAAc,CAAC"}

package/dist/esm/index.js

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

package/dist/esm/index.js.map

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

package/dist/esm/install.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/esm/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/install.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/esm/install.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MqttEndpointFactory, ServiceBundle } from "#general";
+import { MqttJsEndpointFactory } from "./MqttJsEndpointFactory.js";
+ServiceBundle.default.add((env) => env.set(MqttEndpointFactory, new MqttJsEndpointFactory()));
+//# sourceMappingURL=install.js.map

package/dist/esm/install.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/install.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,qBAAqB,qBAAqB;AACnD,SAAS,6BAA6B;AAEtC,cAAc,QAAQ,IAAI,SAAO,IAAI,IAAI,qBAAqB,IAAI,sBAAsB,CAAC,CAAC;",
+  "names": []
+}

package/dist/esm/package.json

@@ -0,0 +1,6 @@
+{
+    "type": "module",
+    "imports": {
+        "#general": "@matter/general"
+    }
+}

package/package.json

@@ -0,0 +1,74 @@
+{
+    "name": "@matter/mqtt",
+    "version": "0.16.0-alpha.0-20251011-d8942d7d5",
+    "description": "matter.js MQTT support",
+    "keywords": [
+        "iot",
+        "home automation",
+        "matter",
+        "smart device",
+        "MQTT"
+    ],
+    "license": "Apache-2.0",
+    "author": "matter.js authors",
+    "contributors": [
+        "Greg Lauckhart <greg@lauckhart.com>"
+    ],
+    "bugs": {
+        "url": "https://github.com/matter-js/matter.js/issues"
+    },
+    "homepage": "https://github.com/matter-js/matter.js",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/matter-js/matter.js.git"
+    },
+    "scripts": {
+        "clean": "matter-build clean",
+        "build": "matter-build",
+        "build-clean": "matter-build --clean"
+    },
+    "dependencies": {
+        "@matter/general": "0.16.0-alpha.0-20251011-d8942d7d5",
+        "mqtt": "^5.14.1",
+        "safe-buffer": "^5.2.1"
+    },
+    "devDependencies": {
+        "@matter/tools": "0.16.0-alpha.0-20251011-d8942d7d5"
+    },
+    "engines": {
+        "node": ">=20.19.0 <22.0.0 || >=22.13.0"
+    },
+    "files": [
+        "dist/**/*",
+        "src/**/*",
+        "LICENSE"
+    ],
+    "imports": {
+        "#general": "@matter/general"
+    },
+    "type": "module",
+    "main": "dist/cjs/index.js",
+    "types": "dist/cjs/index.d.ts",
+    "exports": {
+        ".": {
+            "import": {
+                "types": "./dist/esm/index.d.ts",
+                "default": "./dist/esm/index.js"
+            },
+            "require": {
+                "types": "./dist/cjs/index.d.ts",
+                "default": "./dist/cjs/index.js"
+            }
+        }
+    },
+    "typesVersions": {
+        "*": {
+            ".": [
+                "/dist/cjs/index.d.ts"
+            ]
+        }
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}

package/src/MqttJsEndpoint.ts

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { Abort, Gate, MqttEndpoint, Mutex } from "#general";
+import { IPublishPacket, ISubscriptionGrant, MqttClient, OnMessageCallback } from "mqtt";
+import { MqttJsMessage } from "./MqttJsMessage.js";
+
+/**
+ * MQTT.js-based MQTT endpoint.
+ */
+export class MqttJsEndpoint implements MqttEndpoint {
+    #client: MqttClient;
+    #nextSubscriptionIdentifier = 1;
+    #mutex = new Mutex(this);
+
+    constructor(client: MqttClient, options: MqttEndpoint.ConnectionOptions) {
+        this.#client = client;
+
+        const { onUp, onDown } = options;
+
+        if (onUp) {
+            const onConnect = () => this.#mutex.run(async () => onUp(this));
+
+            queueMicrotask(onConnect);
+            this.#client.on("connect", () => this.#mutex.run(async () => onUp(this)));
+        }
+
+        if (onDown) {
+            this.#client.on("offline", () => this.#mutex.run(async () => onDown(this)));
+        }
+    }
+
+    async *subscribe(
+        topic: string,
+        options?: MqttEndpoint.SubscriptionOptions,
+    ): AsyncIterableIterator<MqttEndpoint.Message> {
+        const subscriptionIdentifier = this.#nextSubscriptionIdentifier++;
+
+        const queue = new Array<MqttEndpoint.Message>();
+        const gate = new Gate();
+
+        let grants: ISubscriptionGrant[] | undefined;
+        try {
+            this.#client.on("message", onMessage);
+            grants = await this.#client.subscribeAsync(topic, {
+                nl: options?.noLocal ?? true,
+                properties: {
+                    subscriptionIdentifier,
+                },
+            });
+
+            while (true) {
+                await Abort.race(options?.abort, gate);
+                if (Abort.is(options?.abort)) {
+                    break;
+                }
+
+                while (true) {
+                    const message = queue.shift();
+                    if (message === undefined) {
+                        gate.close();
+                        break;
+                    }
+                    yield message;
+                }
+            }
+        } finally {
+            this.#client.off("message", onMessage);
+            if (grants && !(this.#client.disconnecting || this.#client.disconnected)) {
+                for (const grant of grants) {
+                    await this.#client.unsubscribeAsync(grant.topic);
+                }
+            }
+        }
+
+        function onMessage(_topic: unknown, _payload: unknown, packet: IPublishPacket) {
+            if (packet.properties?.subscriptionIdentifier !== subscriptionIdentifier) {
+                return;
+            }
+            queue.push(MqttJsMessage.decode(packet));
+            gate.open();
+        }
+
+        onMessage satisfies OnMessageCallback;
+    }
+
+    async publish(message: MqttEndpoint.Message): Promise<void> {
+        const { topic, payload, options } = MqttJsMessage.encode(message);
+        await this.#client.publishAsync(topic, payload, options);
+    }
+
+    async close() {
+        await this.#client.endAsync();
+        await this.#mutex.then();
+    }
+}

package/src/MqttJsEndpointFactory.ts

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { AppAddress, ImplementationError, MqttEndpoint, MqttEndpointFactory, StorageService } from "#general";
+import { connectAsync, IClientOptions } from "mqtt";
+import { MqttJsEndpoint } from "./MqttJsEndpoint.js";
+import { MqttJsMessage } from "./MqttJsMessage.js";
+
+/**
+ * MQTT.js-based MQTT implementation.
+ */
+export class MqttJsEndpointFactory extends MqttEndpointFactory {
+    override async connect(options: MqttEndpoint.ConnectionOptions) {
+        const addr = AppAddress.for(options.address);
+        const opts: IClientOptions = {
+            protocolVersion: 5,
+        };
+
+        if (addr.protocolModifiers.includes("ws")) {
+            opts.protocol = "ws";
+            // This conflicts for WS + UNIX socket but that's an MQTT.js problem and likely not a real-world issue since
+            // MQTT over WS is generally for browsers
+            opts.path = addr.pathname;
+        } else {
+            opts.protocol = "mqtt";
+        }
+
+        if (addr.isTls) {
+            opts.protocol += "s";
+        }
+
+        const transport = addr.transport;
+        switch (transport.kind) {
+            case "ip":
+                opts.hostname = addr.hostname;
+                if (addr.port) {
+                    opts.port = Number(addr.port);
+                }
+                break;
+
+            case "unix":
+                opts.protocol += "+unix";
+                opts.unixSocket = true;
+                opts.path = decodeURIComponent(addr.hostname);
+                const storage = options.environment?.get(StorageService);
+                if (storage) {
+                    opts.path = storage.resolve(opts.path);
+                }
+                break;
+
+            default:
+                throw new ImplementationError(
+                    `Unknown transport address kind ${(transport as AppAddress.TransportAddress).kind}`,
+                );
+        }
+
+        if (addr.username) {
+            opts.username = addr.username;
+        }
+        if (addr.password) {
+            opts.password = addr.password;
+        }
+
+        if (options.will) {
+            opts.will = MqttJsMessage.encode(options.will);
+        }
+
+        const client = await connectAsync(opts);
+
+        return new MqttJsEndpoint(client, options);
+    }
+}