[1.1.0-rc01] - 2025-07-07
🚀 Major & Breaking Changes
-
Matterbridge Version Requirement Raised:
- Now requires Matterbridge version >= 3.1.2.
- Older Matterbridge versions will not work with this plugin version.
-
Experimental Feature: Server Mode
- New advanced option:
enableServerMode
. - When enabled, each vacuum will run in its own server mode.
- This is a major architectural feature for advanced integrations, multi-device setups, or distributed deployments.
- New advanced option:
-
Device Class Construction
- Vacuum devices now use
matterbridge/devices
import forRoboticVacuumCleaner
(ensures compatibility with latest Matterbridge).
- Vacuum devices now use
✨ Features & Improvements
-
Advanced Configuration:
- New setting:
enableServerMode
(see above). - Improved type safety and passing of advanced/experimental settings throughout the plugin.
- New setting:
-
Error Handling & Diagnostics:
- Improved error reporting and diagnostics for operational states and docking station errors.
- New helpers for mapping docking station errors to Matter operational error states.
- Enhanced debug/info log messages for local network client connections and error scenarios.
-
Local Network Robustness:
- Local network client now retries connection more robustly and gives clear errors if the device fails to connect locally.
-
Command Handler Upgrades:
- Command handler signatures for identify/selectAreas/changeToMode updated for improved compatibility and better logging.
🧰 Internal & Dependency Updates
-
Scripts:
- Updated
precondition
script to require Matterbridge 3.1.2+. - Updated build/package script references.
- Updated
-
Dependencies:
- Updated lots of dependencies for compatibility and security:
(babel, eslint, axios, zod, ws, etc.)
- Updated lots of dependencies for compatibility and security:
📝 Schema & Config Updates
- Schema:
- Schema updated (
matterbridge-roborock-vacuum-plugin.schema.json
) to document newenableServerMode
option and clarify other advanced settings.
- Schema updated (
⚠️ Upgrade Notes
- This release is not compatible with Matterbridge < 3.1.2.
- If you use advanced/experimental features, review new options in the configuration UI or your config file.
Thanks for using matterbridge-roborock-vacuum-plugin!
For bug reports or feedback, open an issue at GitHub.