@matter/examples 0.16.0-alpha.0-20250916-d577beb1d → 0.16.0-alpha.0-20250920-809524dba

package/README.md

@@ -6,6 +6,9 @@ This project provides a set of reference implementations to show several types o
 
 > This package supports all Node.js LTS versions starting with 18.x
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 To better show how to use the library we provide some reference implementations in the examples directory. They are usable as CLI scripts without changes in the first place but are very simple. They are meant to be used as a starting point for your own implementation, or to experiment with Matter at all in a first place.
 
 For BLE usage please also see the [@matter/node-ble README.md](../nodejs-ble/README.md)  for prerequisites and limitations!

package/dist/esm/control-onoff/OnOffController.js

@@ -21,7 +21,7 @@ switch (command) {
   case "toggle":
     {
       const endpointNo = Number.parseInt(args[0]);
-      if (args.length !== 1 || Number.isNaN(endpointNo)) {
+      if (args.length !== 1 || !Number.isFinite(endpointNo)) {
         die(`Usage: ${process.argv[0]} toggle <endpoint number>`);
       }
       const node = controller.nodes.get("device");

package/dist/esm/control-onoff/OnOffController.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/control-onoff/OnOffController.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAG5B,MAAM,aAAa,MAAM,WAAW,OAAO;AAE3C,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC;AAEnD,QAAQ,SAAS;AAAA,EACb,KAAK;AAED,QAAI,WAAW,MAAM,IAAI,QAAQ,GAAG;AAChC,UAAI,wCAAwC;AAAA,IAChD;AACA,QAAI,KAAK,WAAW,GAAG;AACnB,UAAI,UAAU,QAAQ,KAAK,CAAC,CAAC,2BAA2B;AAAA,IAC5D;AACA,UAAM,CAAC,WAAW,IAAI;AAGtB,UAAM,WAAW,MAAM,WAAW,EAAE,IAAI,UAAU,YAAY,CAAC;AAE/D;AAAA,EAEJ,KAAK;AACD;AAEI,YAAM,aAAa,OAAO,SAAS,KAAK,CAAC,CAAC;AAC1C,UAAI,KAAK,WAAW,KAAK,OAAO,MAAM,UAAU,GAAG;AAC/C,YAAI,UAAU,QAAQ,KAAK,CAAC,CAAC,2BAA2B;AAAA,MAC5D;AACA,YAAM,OAAO,WAAW,MAAM,IAAI,QAAQ;AAC1C,UAAI,SAAS,QAAW;AACpB,YAAI,uDAAuD;AAAA,MAC/D;AACA,YAAM,WAAW,KAAK,MAAM,IAAI,UAAU;AAC1C,UAAI,aAAa,QAAW;AACxB,YAAI,kCAAkC,UAAU,iBAAiB;AAAA,MACrE;AAGA,YAAM,SAAS,WAAW,WAAW,EAAE,OAAO;AAAA,IAClD;AAEA;AAAA,EAEJ,KAAK;AACD;AAEI,YAAM,OAAO,WAAW,MAAM,IAAI,QAAQ;AAC1C,UAAI,SAAS,QAAW;AACpB,YAAI,6DAA6D;AAAA,MACrE;AAGA,YAAM,KAAK,OAAO;AAAA,IACtB;AACA;AAAA,EAEJ;AACI;AAAA,MACI,uBAAuB,QAAQ,KAAK,CAAC,KAAK,QAAQ;AAAA,IACtD;AACR;AAKA,SAAS,IAAI,SAAwB;AACjC,UAAQ,IAAI,OAAO;AACnB,UAAQ,KAAK,CAAC;AAClB;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAG5B,MAAM,aAAa,MAAM,WAAW,OAAO;AAE3C,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,IAAI,QAAQ,KAAK,MAAM,CAAC;AAEnD,QAAQ,SAAS;AAAA,EACb,KAAK;AAED,QAAI,WAAW,MAAM,IAAI,QAAQ,GAAG;AAChC,UAAI,wCAAwC;AAAA,IAChD;AACA,QAAI,KAAK,WAAW,GAAG;AACnB,UAAI,UAAU,QAAQ,KAAK,CAAC,CAAC,2BAA2B;AAAA,IAC5D;AACA,UAAM,CAAC,WAAW,IAAI;AAGtB,UAAM,WAAW,MAAM,WAAW,EAAE,IAAI,UAAU,YAAY,CAAC;AAE/D;AAAA,EAEJ,KAAK;AACD;AAEI,YAAM,aAAa,OAAO,SAAS,KAAK,CAAC,CAAC;AAC1C,UAAI,KAAK,WAAW,KAAK,CAAC,OAAO,SAAS,UAAU,GAAG;AACnD,YAAI,UAAU,QAAQ,KAAK,CAAC,CAAC,2BAA2B;AAAA,MAC5D;AACA,YAAM,OAAO,WAAW,MAAM,IAAI,QAAQ;AAC1C,UAAI,SAAS,QAAW;AACpB,YAAI,uDAAuD;AAAA,MAC/D;AACA,YAAM,WAAW,KAAK,MAAM,IAAI,UAAU;AAC1C,UAAI,aAAa,QAAW;AACxB,YAAI,kCAAkC,UAAU,iBAAiB;AAAA,MACrE;AAGA,YAAM,SAAS,WAAW,WAAW,EAAE,OAAO;AAAA,IAClD;AAEA;AAAA,EAEJ,KAAK;AACD;AAEI,YAAM,OAAO,WAAW,MAAM,IAAI,QAAQ;AAC1C,UAAI,SAAS,QAAW;AACpB,YAAI,6DAA6D;AAAA,MACrE;AAGA,YAAM,KAAK,OAAO;AAAA,IACtB;AACA;AAAA,EAEJ;AACI;AAAA,MACI,uBAAuB,QAAQ,KAAK,CAAC,KAAK,QAAQ;AAAA,IACtD;AACR;AAKA,SAAS,IAAI,SAAwB;AACjC,UAAQ,IAAI,OAAO;AACnB,UAAQ,KAAK,CAAC;AAClB;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/examples",
-    "version": "0.16.0-alpha.0-20250916-d577beb1d",
+    "version": "0.16.0-alpha.0-20250920-809524dba",
     "description": "Matter.js examples and reference implementations",
     "keywords": [
         "iot",
@@ -55,14 +55,14 @@
         "matter-controller": "dist/esm/controller/ControllerNode.js"
     },
     "dependencies": {
-        "@matter/main": "0.16.0-alpha.0-20250916-d577beb1d",
-        "@matter/nodejs": "0.16.0-alpha.0-20250916-d577beb1d",
-        "@matter/tools": "0.16.0-alpha.0-20250916-d577beb1d",
-        "@project-chip/matter.js": "0.16.0-alpha.0-20250916-d577beb1d",
+        "@matter/main": "0.16.0-alpha.0-20250920-809524dba",
+        "@matter/nodejs": "0.16.0-alpha.0-20250920-809524dba",
+        "@matter/tools": "0.16.0-alpha.0-20250920-809524dba",
+        "@project-chip/matter.js": "0.16.0-alpha.0-20250920-809524dba",
         "esbuild": "^0.25.9"
     },
     "optionalDependencies": {
-        "@matter/nodejs-ble": "0.16.0-alpha.0-20250916-d577beb1d"
+        "@matter/nodejs-ble": "0.16.0-alpha.0-20250920-809524dba"
     },
     "engines": {
         "node": ">=20.19.0 <22.0.0 || >=22.13.0"

package/src/control-onoff/OnOffController.ts

@@ -38,7 +38,7 @@ switch (command) {
         {
             // Validation
             const endpointNo = Number.parseInt(args[0]);
-            if (args.length !== 1 || Number.isNaN(endpointNo)) {
+            if (args.length !== 1 || !Number.isFinite(endpointNo)) {
                 die(`Usage: ${process.argv[0]} toggle <endpoint number>`);
             }
             const node = controller.nodes.get("device");

package/src/control-onoff/README.md

@@ -1,6 +1,9 @@
 # Simple light controller
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This is an example of a simple Matter controller.  A "controller" is a device that can add another device to a Matter
 network.  This process is called "commissioning".
 
-In this case the device can add another device that supports the "on/off" cluster and toggle it on or off.
+In this case the device can add another device that supports the "on/off" cluster and toggle it on or off.

package/src/controller/README.md

@@ -1,5 +1,8 @@
 # Controller example to commission and connect devices
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows basically how a controller could be implemented by showing pairing and connections to a paired device. When there is an OnOff Endpoint with ID 1 then this is controlled and toggled.
 
 ## Usage

package/src/device-air-quality-sensor/README.md

@@ -1,5 +1,8 @@
 # Air quality sensor example
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to build a simple Air quality Sensor device with temperature, humidity, PMx and TVOC measurements.
 It just defines initial static values, so it won't change over time.
 

package/src/device-bridge-onoff/README.md

@@ -1,5 +1,8 @@
 # Bridge for multiple OnOff light/sockets with a CLI command execution interface
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to build a Matter-Bridge that offers multiple OnOff lights and sockets as a bridge. It can be configured via command line and allows for specifications of shell commands to be executed when on and off commands are received at the numbered devices. For more details see below.
 
 A Bridge is used to expose multiple devices at once.

package/src/device-composed-onoff/README.md

@@ -1,5 +1,8 @@
 # Composed device for multiple OnOff light/sockets with a CLI command execution interface
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to build a "simple" composed device where multiple OnOff lights and sockets are combined as a single device. The devices are all added at the root level, so no bridge is used. It can be configured via command line and allows for specifications of shell commands to be executed when on and off commands are received at the numbered devices. For more details see below.
 
 A composed device is one device with multiple different device types combined. This is useful for devices that have multiple functions, e.g. a light bulb with a temperature sensor.

package/src/device-composed-wc-light/README.md

@@ -1,5 +1,8 @@
 # Composed device with Window covering and a light endpoint that logs changes
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example implements the Window Covering cluster server logic and also overrides a OnOff cluster server to build a composed devices with a window covering nd a light.
 
 ## Usage

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

@@ -1,5 +1,8 @@
 # Socket device that reports random Energy and Power measurements
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to run a simple socket device that also includes a power and energy measurement. It is not configurable via CLI and only sets random energy and power values when turned on.
 
 

package/src/device-multiple-onoff/README.md

@@ -1,5 +1,8 @@
 # Multiple OnOff light/socket nodes in one process with a CLI command execution interface
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to start multiple Matter nodes on one MatterServer where each node is run on its own Port, but share a single MDNS broadcaster and scanner in order to optimize resources. Each node can be configured via CLI to be an onoff socket or a light. CLI. Options also allow specification of shell commands to be executed for on and off commands.
 
 matter.js also allows it to start multiple devices in one process. With this especially the MDNS functionalities are shared between these processes and it should use less resources. How many devices you acn add in one process depends on the load they produce and how many devices run in the single Node.js thread.

package/src/device-onoff/README.md

@@ -1,5 +1,8 @@
 # OnOff light/socket device with a CLI command execution interface
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to build a simple minimalistic DeviceNode with just one socket or light endpoint. The shell commands to be executed by on/off commands can be configured via CLI.
 
 ## Usage

package/src/device-onoff-advanced/README.md

@@ -1,5 +1,8 @@
 # OnOff light/socket device with BLE support and advanced API usage
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to build a simple Device node with just one socket or light endpoint. The shell commands to be executed by on/off commands can be configured via CLI. Additionally, this example also shows the following use cases:
 - it shows how to enable BLE for a device node and tweaks the announcement so that BLE is only announced in the beginning.
 -it includes a dummy WifiNetworkCommissioning and a dummy ThreadNetworkCommissioning implementation that simulates Wi-Fi/Thread logic for the commissioner and logs the Wi-Fi/Thread credentials the commissioner sends to the device.

package/src/device-onoff-light/README.md

@@ -1,5 +1,8 @@
 # OnOff light example which logs the state changes to the console
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to run a Light device which is not configurable via CLI and only logs changes, so it is the most minimalistic example. It shows how to enhance the OnOff cluster server with own logic.
 
 ## Usage

package/src/device-robotic-vacuum-cleaner/README.md

@@ -1,5 +1,8 @@
 # Robotic Vacuum Cleaner Example
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to run a Robot Vacuum Cleaning device. This is a bit more complex and implements the following 
 (fictional) features and state engine:
 * Supports Run Modes: Idle, Quick-Clean (one cleaning round), Auto-Clean (3 rounds for one cycle and does cleaning again after 3h)

package/src/device-sensor/README.md

@@ -1,5 +1,8 @@
 # Temperature/Humidity sensor with a CLI command interface to get the value
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to build a simple Sensor device with a temperature (default) or humidity (`--type humidity`) sensor. The sensor values are updated by default every 60 seconds, or the number of seconds specified via the CLI parameter `--interval`. The value can be defined by the output of a CLI script provided via parameter `--value` or, if no command is specified, are randomly set in the interval -50..+50. To read the Temperature of a Raspberry Pi as example use `--value ="echo \$((\$(</sys/class/thermal/thermal_zone0/temp)/10))"` or to read temperature of your location `--value="curl -s 'wttr.in/?format=%t\&m' | sed 's/°C//'| awk '{print \$1*100}'"` (or use `?format=%h` for humidity).
 
 ## Usage

package/src/device-simple/README.md

@@ -1,3 +1,6 @@
 # A simple on/off device
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This is the simplest possible matter.js device.

package/src/device-smoke-co-alarm/README.md

@@ -1,5 +1,8 @@
 # Smoke CO Alarm Example
 
+> [!IMPORTANT]
+> matter.js as library, along with all related tools (such as the Shell app) and examples, is not certified by the Connectivity Standards Alliance (CSA). They are provided solely to demonstrate the capabilities of our solution and to support testing and development.  Using matter.js does not certify your product — Connectivity Standards Alliance membership and product certification are required to release official Matter devices. For more details, see [A note on certification](https://github.com/matter-js/matter.js/blob/main/README.md#a-note-on-certification).
+
 This example shows how to build a simple Smoke&CO Alarm Sensor Matter device.  It just defines initial static values,
 so it won't change over time.