@matter/create 0.16.0-alpha.0-20250912-0d12bf718 → 0.16.0-alpha.0-20250913-0bc2515df

package/dist/templates/controller/ControllerNode.ts

@@ -11,29 +11,21 @@
  * because you need to adjust the code in any way depending on your use case.
  */
 
-import { Diagnostic, Environment, Logger, singleton, StorageService, Time } from "@matter/main";
-import { BasicInformationCluster, DescriptorCluster, GeneralCommissioning, OnOff } from "@matter/main/clusters";
-import { Ble, ClusterClientObj } from "@matter/main/protocol";
+import { Diagnostic, Environment, Logger, StorageService, Time } from "@matter/main";
+import { DescriptorClient } from "@matter/main/behaviors/descriptor";
+import { OnOffClient } from "@matter/main/behaviors/on-off";
+import { BasicInformationCluster, Descriptor, GeneralCommissioning } from "@matter/main/clusters";
 import { ManualPairingCodeCodec, NodeId } from "@matter/main/types";
-import { NodeJsBle } from "@matter/nodejs-ble";
 import { CommissioningController, NodeCommissioningOptions } from "@project-chip/matter.js";
 import { NodeStates } from "@project-chip/matter.js/device";
 
+// This installs BLE support if configuration variable "ble.enable" is true
+import "@matter/nodejs-ble";
+
 const logger = Logger.get("Controller");
 
 const environment = Environment.default;
 
-if (environment.vars.get("ble")) {
-    // Initialize Ble
-    Ble.get = singleton(
-        () =>
-            new NodeJsBle({
-                environment,
-                hciId: environment.vars.number("ble.hci.id"),
-            }),
-    );
-}
-
 const storageService = environment.get(StorageService);
 
 console.log(`Storage location: ${storageService.location} (Directory)`);
@@ -229,16 +221,28 @@ class ControllerNode {
 
             node.logStructure();
 
-            // Example to initialize a ClusterClient and access concrete fields as API methods
-            const descriptor = node.getRootClusterClient(DescriptorCluster);
+            // Example to conveniently access cluster states in a typed manner and read the data from the local cache
+            // This is the new preferred way to access the latest known cluster data
+            const descriptorState = node.stateOf(DescriptorClient);
+            if (descriptorState !== undefined) {
+                console.log("deviceTypeList", descriptorState.deviceTypeList); // you can access the state that way
+            } else {
+                console.log("No Descriptor Cluster found. This should never happen!");
+            }
+
+            // Alternatively you can access concrete fields as API methods by creating a ClusterClient and
+            // reading the data from the device or local cache
+            const descriptor = node.getRootClusterClient(Descriptor.Complete);
             if (descriptor !== undefined) {
-                console.log(await descriptor.attributes.deviceTypeList.get()); // you can call that way
-                console.log(await descriptor.getServerListAttribute()); // or more convenient that way
+                console.log(descriptor.getTagListAttributeFromCache()); // Convenient that way from local cache
+                console.log(await descriptor.getServerListAttribute()); // Convenient that way (async!)
+                console.log(await descriptor.attributes.clientList.get()); // or more low level that way (async!)
             } else {
                 console.log("No Descriptor Cluster found. This should never happen!");
             }
 
-            // Example to subscribe to a field and get the value
+            // Example to subscribe to a field and get the value, normally this is not needed because by default
+            // all attributes are subscribed automatically!
             const info = node.getRootClusterClient(BasicInformationCluster);
             if (info !== undefined) {
                 console.log(await info.getProductNameAttribute()); // This call is executed remotely
@@ -260,25 +264,23 @@ class ControllerNode {
             //const attributesBasicInformation = await interactionClient.getMultipleAttributes([{ endpointId: 0, clusterId: BasicInformationCluster.id} ]);
             //console.log("Attributes-BasicInformation:", JSON.stringify(attributesBasicInformation, null, 2));
 
-            const devices = node.getDevices();
-            if (devices[0] && devices[0].number === 1) {
+            const endpointOne = node.parts.get(1);
+            if (endpointOne) {
                 // Example to subscribe to all Attributes of endpoint 1 of the commissioned node: */*/*
                 //await interactionClient.subscribeMultipleAttributes([{ endpointId: 1, /* subscribe anything from endpoint 1 */ }], 0, 180, data => {
                 //    console.log("Subscribe-All Data:", Diagnostic.json(data));
                 //});
 
-                const onOff: ClusterClientObj<OnOff.Complete> | undefined = devices[0].getClusterClient(OnOff.Complete);
-                if (onOff !== undefined) {
-                    let onOffStatus = await onOff.getOnOffAttribute();
+                // Example using the new convenient typed access to state and commands of the OnOff cluster
+                const onOffState = endpointOne.stateOf(OnOffClient);
+                if (onOffState !== undefined) {
+                    let onOffStatus = onOffState.onOff;
                     console.log("initial onOffStatus", onOffStatus);
 
-                    onOff.addOnOffAttributeListener(value => {
-                        console.log("subscription onOffStatus", value);
-                        onOffStatus = value;
-                    });
+                    const onOffCommands = endpointOne.commandsOf(OnOffClient);
                     // read data every minute to keep up the connection to show the subscription is working
                     setInterval(() => {
-                        onOff
+                        onOffCommands
                             .toggle()
                             .then(() => {
                                 onOffStatus = !onOffStatus;

package/dist/templates/device-onoff-advanced/DeviceNodeFull.ts

@@ -32,7 +32,6 @@ import {
     StorageService,
     Time,
     VendorId,
-    singleton,
 } from "@matter/main";
 import { OnOffServer } from "@matter/main/behaviors";
 import { GeneralDiagnostics, NetworkCommissioning, OnOff } from "@matter/main/clusters";
@@ -41,7 +40,6 @@ import { RootRequirements } from "@matter/main/endpoints";
 import { Ble, FabricAction } from "@matter/main/protocol";
 import { QrCode } from "@matter/main/types";
 import { createFileLogger } from "@matter/nodejs";
-import { NodeJsBle } from "@matter/nodejs-ble";
 import { execSync } from "node:child_process";
 import { DummyThreadNetworkCommissioningServer } from "./cluster/DummyThreadNetworkCommissioningServer.js";
 import { DummyWifiNetworkCommissioningServer } from "./cluster/DummyWifiNetworkCommissioningServer.js";
@@ -51,6 +49,13 @@ import {
     MyFancyOwnFunctionalityBehavior,
 } from "./cluster/MyFancyOwnFunctionality.js";
 
+// This installs BLE support if:
+//
+// - The environment.vars value "ble.enable" is true
+// - The command line flag "--ble-enable" is set
+// - The system environment variable "BLE_ENABLE" is set
+import "@matter/nodejs-ble";
+
 const logger = Logger.get("DeviceNodeFull");
 
 /**
@@ -68,19 +73,6 @@ const logger = Logger.get("DeviceNodeFull");
 
 const environment = Environment.default;
 
-// Alternatively "--ble-enable" or environment variable "BLE_ENABLED"
-// Alternatively "--ble-hciId" or environment variable "BLE_HCIID"
-if (environment.vars.get("ble.enable")) {
-    // Initialize Ble
-    Ble.get = singleton(
-        () =>
-            new NodeJsBle({
-                environment,
-                hciId: environment.vars.number("ble.hciId"),
-            }),
-    );
-}
-
 function executeCommand(scriptParamName: string) {
     const script = environment.vars.string(scriptParamName);
     if (script === undefined) return undefined;
@@ -261,7 +253,7 @@ const server = await ServerNode.create(RootEndpoint, {
 });
 
 const networkId = new Uint8Array(32);
-if (Ble.enabled) {
+if (environment.has(Ble)) {
     // matter.js will create an Ethernet-only device by default when it comes to Network Commissioning Features.
     // To offer e.g. a "Wi-Fi only device" (or any other combination) we need to override the Network Commissioning
     // cluster and implement all the need handling here. This is a "static implementation" for pure demonstration

package/dist/templates/index.json

@@ -5,7 +5,7 @@
         {
             "name": "control-onoff",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Simple light controller",
             "entrypoint": "OnOffController.ts"
@@ -13,9 +13,8 @@
         {
             "name": "controller",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718",
-                "@matter/nodejs-ble": "~0.16.0-alpha.0-20250912-0d12bf718",
-                "@project-chip/matter.js": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df",
+                "@project-chip/matter.js": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Controller example to commission and connect devices",
             "entrypoint": "ControllerNode.ts"
@@ -23,7 +22,7 @@
         {
             "name": "device-air-quality-sensor",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Air quality sensor example",
             "entrypoint": "AirQualitySensorDeviceNode.ts"
@@ -31,7 +30,7 @@
         {
             "name": "device-bridge-onoff",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Bridge for multiple OnOff light/sockets with a CLI command execution interface",
             "entrypoint": "BridgedDevicesNode.ts"
@@ -39,7 +38,7 @@
         {
             "name": "device-composed-onoff",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Composed device for multiple OnOff light/sockets with a CLI command execution interface",
             "entrypoint": "ComposedDeviceNode.ts"
@@ -47,7 +46,7 @@
         {
             "name": "device-composed-wc-light",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Composed device with Window covering and a light endpoint that logs changes",
             "entrypoint": "IlluminatedRollerShade.ts"
@@ -55,7 +54,7 @@
         {
             "name": "device-measuring-socket",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Socket device that reports random Energy and Power measurements",
             "entrypoint": "MeasuredSocketDevice.ts"
@@ -63,7 +62,7 @@
         {
             "name": "device-multiple-onoff",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Multiple OnOff light/socket nodes in one process with a CLI command execution interface",
             "entrypoint": "MultiDeviceNode.ts"
@@ -71,7 +70,7 @@
         {
             "name": "device-onoff",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "OnOff light/socket device with a CLI command execution interface",
             "entrypoint": "DeviceNode.ts"
@@ -79,9 +78,8 @@
         {
             "name": "device-onoff-advanced",
             "dependencies": {
-                "@matter/nodejs": "~0.16.0-alpha.0-20250912-0d12bf718",
-                "@matter/nodejs-ble": "~0.16.0-alpha.0-20250912-0d12bf718",
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/nodejs": "~0.16.0-alpha.0-20250913-0bc2515df",
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "OnOff light/socket device with BLE support and advanced API usage",
             "entrypoint": "DeviceNodeFull.ts"
@@ -89,7 +87,7 @@
         {
             "name": "device-onoff-light",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "OnOff light example which logs the state changes to the console",
             "entrypoint": "LightDevice.ts"
@@ -97,7 +95,7 @@
         {
             "name": "device-robotic-vacuum-cleaner",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Robotic Vacuum Cleaner Example",
             "entrypoint": "RoboticVacuumCleanerDevice.ts"
@@ -105,7 +103,7 @@
         {
             "name": "device-sensor",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Temperature/Humidity sensor with a CLI command interface to get the value",
             "entrypoint": "SensorDeviceNode.ts"
@@ -113,7 +111,7 @@
         {
             "name": "device-simple",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "A simple on/off device",
             "entrypoint": "main.ts"
@@ -121,7 +119,7 @@
         {
             "name": "device-smoke-co-alarm",
             "dependencies": {
-                "@matter/main": "~0.16.0-alpha.0-20250912-0d12bf718"
+                "@matter/main": "~0.16.0-alpha.0-20250913-0bc2515df"
             },
             "description": "Smoke CO Alarm Example",
             "entrypoint": "SmokeCOAlarmDeviceNode.ts"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/create",
-    "version": "0.16.0-alpha.0-20250912-0d12bf718",
+    "version": "0.16.0-alpha.0-20250913-0bc2515df",
     "description": "Matter.js skeleton project generator",
     "type": "module",
     "scripts": {
@@ -32,7 +32,7 @@
     },
     "homepage": "https://github.com/matter-js/matter.js#readme",
     "devDependencies": {
-        "@matter/tools": "0.16.0-alpha.0-20250912-0d12bf718",
+        "@matter/tools": "0.16.0-alpha.0-20250913-0bc2515df",
         "@types/node": "^24.3.1",
         "@types/tar-stream": "^3.1.4"
     },