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

package/dist/esm/mqtt-device/MqttDevice.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MqttServer, ServerNode } from "@matter/main";
+import { OnOffLightDevice, OnOffLightRequirements } from "@matter/main/devices/on-off-light";
+import "@matter/mqtt";
+const node = await ServerNode.create(ServerNode.RootEndpoint.with(MqttServer));
+class ReportingOnOffServer extends OnOffLightRequirements.OnOffServer {
+  initialize() {
+    this.events.onOff$Changed.on((value) => {
+      console.log(`Light is now ${value ? "ON" : "OFF"}`);
+    });
+  }
+}
+await node.add(OnOffLightDevice.with(ReportingOnOffServer));
+await node.run();
+//# sourceMappingURL=MqttDevice.js.map

package/dist/esm/mqtt-device/MqttDevice.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mqtt-device/MqttDevice.ts"],
+  "mappings": ";AACA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,YAAY,kBAAkB;AACvC,SAAS,kBAAkB,8BAA8B;AAGzD,OAAO;AAeP,MAAM,OAAO,MAAM,WAAW,OAAO,WAAW,aAAa,KAAK,UAAU,CAAC;AAG7E,MAAM,6BAA6B,uBAAuB,YAAY;AAAA,EACzD,aAAa;AAClB,SAAK,OAAO,cAAc,GAAG,WAAS;AAClC,cAAQ,IAAI,gBAAgB,QAAQ,OAAO,KAAK,EAAE;AAAA,IACtD,CAAC;AAAA,EACL;AACJ;AAEA,MAAM,KAAK,IAAI,iBAAiB,KAAK,oBAAoB,CAAC;AAE1D,MAAM,KAAK,IAAI;",
+  "names": []
+}

package/dist/esm/web-socket-device/WebSocketDevice.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ServerNode, WebSocketServer } from "@matter/main";
+import { OnOffLightDevice, OnOffLightRequirements } from "@matter/main/devices/on-off-light";
+import "@matter/nodejs-ws";
+const node = await ServerNode.create(ServerNode.RootEndpoint.with(WebSocketServer));
+class ReportingOnOffServer extends OnOffLightRequirements.OnOffServer {
+  initialize() {
+    this.events.onOff$Changed.on((value) => {
+      console.log(`Light is now ${value ? "ON" : "OFF"}`);
+    });
+  }
+}
+await node.add(OnOffLightDevice.with(ReportingOnOffServer));
+await node.run();
+//# sourceMappingURL=WebSocketDevice.js.map

package/dist/esm/web-socket-device/WebSocketDevice.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/web-socket-device/WebSocketDevice.ts"],
+  "mappings": ";AACA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,YAAY,uBAAuB;AAC5C,SAAS,kBAAkB,8BAA8B;AAGzD,OAAO;AAcP,MAAM,OAAO,MAAM,WAAW,OAAO,WAAW,aAAa,KAAK,eAAe,CAAC;AAGlF,MAAM,6BAA6B,uBAAuB,YAAY;AAAA,EACzD,aAAa;AAClB,SAAK,OAAO,cAAc,GAAG,WAAS;AAClC,cAAQ,IAAI,gBAAgB,QAAQ,OAAO,KAAK,EAAE;AAAA,IACtD,CAAC;AAAA,EACL;AACJ;AAEA,MAAM,KAAK,IAAI,iBAAiB,KAAK,oBAAoB,CAAC;AAE1D,MAAM,KAAK,IAAI;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/examples",
-    "version": "0.16.0-alpha.0-20251006-3fe1e7c57",
+    "version": "0.16.0-alpha.0-20251013-89bb7099d",
     "description": "Matter.js examples and reference implementations",
     "keywords": [
         "iot",
@@ -55,14 +55,17 @@
         "matter-controller": "dist/esm/controller/ControllerNode.js"
     },
     "dependencies": {
-        "@matter/main": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/nodejs": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@matter/tools": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "@project-chip/matter.js": "0.16.0-alpha.0-20251006-3fe1e7c57",
-        "esbuild": "^0.25.9"
+        "@matter/main": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/nodejs": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/tools": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@project-chip/matter.js": "0.16.0-alpha.0-20251013-89bb7099d",
+        "esbuild": "^0.25.9",
+        "@matter/nodejs-ble": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/mqtt": "0.16.0-alpha.0-20251013-89bb7099d",
+        "@matter/nodejs-ws": "0.16.0-alpha.0-20251013-89bb7099d"
     },
     "optionalDependencies": {
-        "@matter/nodejs-ble": "0.16.0-alpha.0-20251006-3fe1e7c57"
+        "@matter/nodejs-ble": "0.16.0-alpha.0-20251013-89bb7099d"
     },
     "engines": {
         "node": ">=20.19.0 <22.0.0 || >=22.13.0"

package/src/mqtt-device/MqttDevice.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// This demonstrates a matter.js device that supports an MQTT API on Node.js
+
+import { MqttServer, ServerNode } from "@matter/main";
+import { OnOffLightDevice, OnOffLightRequirements } from "@matter/main/devices/on-off-light";
+
+// This plugin installs MQTT support for matter.js
+import "@matter/mqtt";
+
+/**
+ * Create node with MQTT APIs enabled.
+ *
+ * This requires an MQTT 5 broker.  By default we configure the broker on localhost.
+ *
+ * You may configure the broker address here, or use environment variables:
+ *
+ *     MATTER_MQTT_ADDRESS=mqtt://localhost/matter/light01
+ *
+ * or command line arguments:
+ *
+ *     --mqtt-address=mqtt://localhost/matter/light01
+ */
+const node = await ServerNode.create(ServerNode.RootEndpoint.with(MqttServer));
+
+// For demonstration purposes, this server prints state changes to the console
+class ReportingOnOffServer extends OnOffLightRequirements.OnOffServer {
+    override initialize() {
+        this.events.onOff$Changed.on(value => {
+            console.log(`Light is now ${value ? "ON" : "OFF"}`);
+        });
+    }
+}
+
+await node.add(OnOffLightDevice.with(ReportingOnOffServer));
+
+await node.run();

package/src/mqtt-device/README.md

@@ -0,0 +1,13 @@
+# Example device with MQTT control enabled
+
+This example demonstrates how to implement a matter.js device that you can control via MQTT.
+
+This requires an MQTT 5 broker.  The example is configured for a broker on localhost by default.
+
+You may modify {@link MqttDevice.ts} to change the default address, or override using environment variables:
+
+    MATTER_MQTT_ADDRESS=mqtt://localhost/matter/light01
+
+or command line arguments:
+
+    --mqtt-address=mqtt://localhost/matter/light01

package/src/tsconfig.json

@@ -12,9 +12,15 @@
         {
             "path": "../../matter.js/src"
         },
+        {
+            "path": "../../mqtt/src"
+        },
         {
             "path": "../../nodejs-ble/src"
         },
+        {
+            "path": "../../nodejs-ws/src"
+        },
         {
             "path": "../../nodejs/src"
         },

package/src/web-socket-device/README.md

@@ -0,0 +1,12 @@
+# Example device with WebSocket control enabled
+
+This example demonstrates how to implement a matter.js device that you can control via WebSockets.
+
+By default the device listens on a UNIX socket under ~/.matter/matter.sock.  You can change by modifying {@link
+WebSocketDevice.ts} or override with environment variables:
+
+    MATTER_WEBSOCKET_ADDRESS=ws://localhost
+
+or command line arguments:
+
+    --websocket-address=ws://localhost

package/src/web-socket-device/WebSocketDevice.ts

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// This demonstrates a matter.js device that supports a WebSocket API on Node.js
+
+import { ServerNode, WebSocketServer } from "@matter/main";
+import { OnOffLightDevice, OnOffLightRequirements } from "@matter/main/devices/on-off-light";
+
+// This plugin installs WebSocket support for matter.js on Node.js
+import "@matter/nodejs-ws";
+
+/**
+ * Create node with WebSocket APIs enabled.
+ *
+ * By default these listen on a UNIX socket under ~/.matter/matter.sock.  You can change this here or by using
+ * environment variables:
+ *
+ *     MATTER_WEBSOCKET_ADDRESS=ws://localhost
+ *
+ * or command line arguments:
+ *
+ *     --websocket-address=ws://localhost
+ */
+const node = await ServerNode.create(ServerNode.RootEndpoint.with(WebSocketServer));
+
+// For demonstration purposes, this server prints state changes to the console
+class ReportingOnOffServer extends OnOffLightRequirements.OnOffServer {
+    override initialize() {
+        this.events.onOff$Changed.on(value => {
+            console.log(`Light is now ${value ? "ON" : "OFF"}`);
+        });
+    }
+}
+
+await node.add(OnOffLightDevice.with(ReportingOnOffServer));
+
+await node.run();