RinDevJunior/matterbridge-roborock-vacuum-plugin 1.0.8-rc06

on GitHub

[1.0.8-rc06] - 2025-06-10

Major Changes

• Unified "Smart" Behavior:

  • Refactored model-specific behaviors (QREVO_EDGE_5V1, S7_MAXV, S8_PRO_ULTRA) to use a single "smart" behavior implementation for all supported models.
  • Removed model-specific files and runtimes in favor of a unified smart behavior (/behaviors/roborock.vacuum/smart/).
  • "Force run at default" option added to allow fallback to the default implementation if needed (configurable via advanced settings).

• Clean Mode Mapping & Apple Home:

  • Added a comprehensive mapping table for Apple Home ↔️ Roborock clean modes in a new documentation file (README_CLEANMODE.md). Linked from main README.
  • Expanded internal clean mode list and mapping logic for more granular modes like "Quick", "Quiet", "DeepClean", etc.
  • Clean mode mapping is now centralized and easier to maintain/extend.

Features

• Experimental Feature:

  • New advanced feature: forceRunAtDefault (configurable in advanced settings) allows all robots to use the default behavior if troubleshooting or testing is needed.

• Plugin Storage:

  • Added persistent storage using node-persist, initializing a dedicated directory for plugin data.

• API Improvements:

  • Added getCleanModeData to retrieve current clean mode settings from the robot (combining suction, water flow, mop route, etc.) for accurate mode tracking and mapping.

Refactoring & Internal

• Removed old model-specific logic and files for QREVO_EDGE_5V1, S7_MAXV, S8_PRO_ULTRA.
• Cleaned up and renamed tests to reflect new code structure.
• Internal helpers for clean mode detection and mapping are now model-agnostic or fallback to default.

Dependency Updates

• Updated several dependencies for bugfixes and compatibility (see package.json and package-lock.json).

Docs

• Added README_CLEANMODE.md with a full table describing clean mode mapping between Apple Home and Roborock.
• Updated usage instructions in README.md to clarify whiteList format and link to the new mapping table.

Note:
This release is not backwards-compatible with custom behaviors for QREVO_EDGE_5V1, S7_MAXV, S8_PRO_ULTRA models. All supported models now share a unified "smart" implementation.
If you encounter issues, try enabling "Force run at default" in advanced settings.