matterbridge 3.2.3-dev-20250816-3639b16 → 3.2.3-dev-20250821-ef6a4eb

package/CHANGELOG.md

@@ -8,7 +8,7 @@ If you like this project and find it useful, please consider giving it a star on
   <img src="bmc-button.svg" alt="Buy me a coffee" width="120">
 </a>
 
-## [3.2.3] - 2025-08-??
+## [3.2.3] - 2025-08-20
 
 ### Added
 
@@ -18,6 +18,7 @@ If you like this project and find it useful, please consider giving it a star on
 - [Refrigerator]: Added Refrigerator() class and Jest test. It is not supported by the Home app.
 - [Pages]: Added first draft of https://luligu.github.io/matterbridge.
 - [Matter]: Added Matter Specification Version 1.0, 1.1, 1.2, 1.3, 1.4 and 1.4.1 pdf files.
+- [Development]: Improved README-DEV.md.
 
 ### Changed
 

package/README-DEV.md

@@ -288,6 +288,11 @@ All default cluster helpers are available as methods of MatterbridgeEndpoint.
 
 ## MatterbridgeEndpointOptions
 
+- @param {Semtag[]} [tagList] - The tagList of the endpoint.
+- @param {'server' | 'matter'} [mode] - The mode for the endpoint.
+- @param {string} [id] - The unique storage key for the endpoint. If not provided, a default key will be used.
+- @param {EndpointNumber} [number] - The endpoint number for the endpoint. If not provided, the endpoint will be created with the next available endpoint number.
+
 ```typescript
     const robot = new RoboticVacuumCleaner('Robot Vacuum', 'RVC1238777820', 'server');
 ```
@@ -298,6 +303,89 @@ The mode=`server` property of MatterbridgeEndpointOptions, allows to create an i
 
 The mode=`matter` property of MatterbridgeEndpointOptions, allows to create a (not bridged) Matter device that is added to the Matterbridge server node alongside the aggregator.
 
+## MatterbridgeEndpoint single class devices
+
+For the device types listed below there are single class provided to createa a fully functional device.
+
+For a working example refer to the 'matterbridge-example-dynamic-platform'.
+
+### Chapter 12. Robotic Device Types - Single class device types
+
+```typescript
+const robot = new RoboticVacuumCleaner('Robot Vacuum', 'RVC1238777820', 'server');
+```
+
+### Chapter 13. Appliances Device Types - Single class device types
+
+```typescript
+    this.laundryWasher = new LaundryWasher('Laundry Washer', 'LW1234567890');
+```
+
+```typescript
+    this.laundryDryer = new LaundryDryer('Laundry Dryer', 'LDW1235227890');
+```
+
+```typescript
+    this.dishwasher = new Dishwasher('Dishwasher', 'DW1234567890');
+```
+
+```typescript
+    this.extractorHood = new ExtractorHood('Extractor Hood', 'EH1234567893');
+```
+
+```typescript
+    this.microwaveOven = new MicrowaveOven('Microwave Oven', 'MO1234567893');
+```
+
+The Oven is always a composed device. You create the Oven and add one or more cabinet.
+
+```typescript
+    this.oven = new Oven('Oven', 'OV1234567890');
+    this.oven.addCabinet('Upper Cabinet', [{ mfgCode: null, namespaceId: PositionTag.Top.namespaceId, tag: PositionTag.Top.tag, label: PositionTag.Top.label }]);
+```
+
+The Cooktop is always a composed device. You create the Cooktop and add one or more surface.
+
+```typescript
+    this.cooktop = new Cooktop('Cooktop', 'CT1234567890');
+    this.cooktop.addSurface('Surface Top Left', [
+      { mfgCode: null, namespaceId: PositionTag.Top.namespaceId, tag: PositionTag.Top.tag, label: PositionTag.Top.label },
+      { mfgCode: null, namespaceId: PositionTag.Left.namespaceId, tag: PositionTag.Left.tag, label: PositionTag.Left.label },
+    ]);
+```
+
+The Refrigerator is always a composed device. You create the Refrigerator and add one or more cabinet.
+
+```typescript
+    const refrigerator = new Refrigerator('Refrigerator', 'RE1234567890');
+    refrigerator.addCabinet('Refrigerator Top', [
+      { mfgCode: null, namespaceId: PositionTag.Top.namespaceId, tag: PositionTag.Top.tag, label: 'Refrigerator Top' },
+      { mfgCode: null, namespaceId: RefrigeratorTag.Refrigerator.namespaceId, tag: RefrigeratorTag.Refrigerator.tag, label: RefrigeratorTag.Refrigerator.label },
+    ]);
+```
+
+### Chapter 14. Energy Device Types - Single class device types
+
+```typescript
+const waterHeater = new WaterHeater('Water Heater', 'WH3456177820');
+```
+
+```typescript
+const evse = new Evse('Evse', 'EV3456127820');
+```
+
+```typescript
+const solarPower = new SolarPower('Solar Power', 'SP3456127821');
+```
+
+```typescript
+const batteryStorage = new BatteryStorage('Battery Storage', 'BS3456127822');
+```
+
+```typescript
+const heatPump = new HeatPump('Heat Pump', 'HP1234567890');
+```
+
 ## Plugin config file
 
 Each plugin has a minimal default config file injected by Matterbridge when it is loaded:
@@ -424,5 +512,5 @@ I warmly welcome contributions to this project! Whether it's reporting bugs, pro
 
 - Create a new pull request against the dev from my repository and I'll be glad to check it out
 - Be sure to follow the existing code style
-- Add unit tests for any new or changed functionality if possible
+- Add unit tests for any new or changed functionality if possible cause Matterbridge has a 100% test coverage.
 - In your pull request, do describe what your changes do and how they work

package/dist/devices/export.js

@@ -1,3 +1,4 @@
+export * from './roboticVacuumCleaner.js';
 export * from './laundryWasher.js';
 export * from './laundryDryer.js';
 export * from './extractorHood.js';
@@ -11,4 +12,3 @@ export * from './evse.js';
 export * from './solarPower.js';
 export * from './batteryStorage.js';
 export * from './heatPump.js';
-export * from './roboticVacuumCleaner.js';

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.2.3-dev-20250816-3639b16",
+  "version": "3.2.3-dev-20250821-ef6a4eb",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.2.3-dev-20250816-3639b16",
+      "version": "3.2.3-dev-20250821-ef6a4eb",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.15.3",
@@ -153,9 +153,9 @@
       }
     },
     "node_modules/@noble/curves": {
-      "version": "1.9.6",
-      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.6.tgz",
-      "integrity": "sha512-GIKz/j99FRthB8icyJQA51E8Uk5hXmdyThjgQXRKiv9h0zeRlzSCLIzFw6K1LotZ3XuB7yzlf76qk7uBmTdFqA==",
+      "version": "1.9.7",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.7.tgz",
+      "integrity": "sha512-gbKGcRUYIjA3/zCCNaWDciTMFI0dCkvou3TL8Zmy5Nc7sJ47a0jtOeZoTaMxkuqRo9cRhjOdZJXegxYE5FN/xw==",
       "license": "MIT",
       "dependencies": {
         "@noble/hashes": "1.8.0"
@@ -215,9 +215,9 @@
       }
     },
     "node_modules/ansi-regex": {
-      "version": "6.1.0",
-      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz",
-      "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==",
+      "version": "6.2.0",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.0.tgz",
+      "integrity": "sha512-TKY5pyBkHyADOPYlRT9Lx6F544mPl0vS5Ew7BJ45hA08Q+t3GjbueLliBWN3sMICk6+y7HdyxSzC4bWS8baBdg==",
       "license": "MIT",
       "engines": {
         "node": ">=12"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.2.3-dev-20250816-3639b16",
+  "version": "3.2.3-dev-20250821-ef6a4eb",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -98,9 +98,6 @@
       "types": "./dist/matter/types.d.ts"
     }
   },
-  "overrides": {
-    "typescript": "5.9.2"
-  },
   "dependencies": {
     "@matter/main": "0.15.3",
     "archiver": "7.0.1",