homebridge-roborock-matter 2.9.7 → 2.9.8

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 2.9.8
+
+- Fixed a long-standing quirk in state persistence: the file encoding argument was passed to `JSON.stringify` (where it is silently ignored) instead of `fs.writeFileSync`. Behavior was correct by luck (utf8 is the default); the code now says what it means.
+- npm search keywords expanded (s7, s8, q revo, saros, robotic vacuum) so the plugin is found by people searching for their model.
+- README: highlighted that one sign-in brings the whole fleet — every robot on the account appears as its own accessory.
+
 ## 2.9.7
 
 - Positioning sharpened across the npm description and README: the entire Roborock lineup is supported (classic S/Q/Saros series through the 2025 Q7 series that no other plugin can control, with automatic adoption of future models), presented as the most complete Roborock plugin for Apple Home. No functional changes.

package/README.md

@@ -35,7 +35,7 @@ This is the most feature-packed, most thoroughly engineered Roborock plugin for
 
 - 🥇 **Every Roborock, fully supported.** The entire lineup works — from the classic S-series through the Q- and Saros families to the 2025 Q7 series (Q7 M5 / M5+), which speaks a brand-new protocol that no other Homebridge plugin understands. Brand-new models are adopted automatically with sensible defaults.
 - 📍 **See where it's cleaning — live.** Apple Home shows _"Cleaning — Kitchen"_ with the room the robot is actually inside, updating as it moves from room to room. Works even for cleans started from the robot's button or the Roborock app. No other Homebridge plugin does this.
-- 🧭 **One robot, one tile.** Your vacuum shows up as a single, native accessory in Apple Home — no clutter of fake fans and helper switches. Rooms appear with the names you gave them in the Roborock app.
+- 🧭 **One robot, one tile — and as many robots as you own.** Sign in once and your whole fleet comes along: every vacuum on your account appears as its own clean, native accessory in Apple Home. No clutter of fake fans and helper switches, and rooms appear with the names you gave them in the Roborock app.
 - ⚡ **Fast and reliable.** Commands go directly to the robot over your own network whenever possible, with the Roborock cloud as automatic backup — and built-in diagnostics in the settings if you ever want to look under the hood.
 - 🛡️ **Verified by Homebridge.** Reviewed and endorsed by the Homebridge team. 263 automated tests, zero known vulnerabilities, no analytics, and a startup designed to never crash your Homebridge — even when your Wi-Fi or the Roborock cloud has a bad day.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-roborock-matter",
-  "version": "2.9.7",
+  "version": "2.9.8",
   "description": "The most complete Roborock plugin for Apple Home. Supports the entire Roborock lineup — from the classic S-series to the new 2025 Q7 series that no other plugin can control. Sign in with your Roborock account and get native start/stop, room cleaning, suction levels, battery, and live 'cleaning in the kitchen' room tracking. Verified by Homebridge.",
   "license": "MIT",
   "author": {
@@ -16,9 +16,14 @@
     "homekit",
     "matter",
     "q7",
+    "q revo",
+    "robotic vacuum",
     "roborock",
     "roborock app",
     "roborock vacuum",
+    "s7",
+    "s8",
+    "saros",
     "vacuum",
     "vacuum cleaner"
   ],

package/roborockLib/roborockAPI.js

@@ -303,7 +303,7 @@ class Roborock {
         }
         const persistPath = this.getPersistPath(id);
         fs.mkdirSync(path.dirname(persistPath), { recursive: true });
-        fs.writeFileSync(persistPath, JSON.stringify(state, null, 2, "utf8"));
+        fs.writeFileSync(persistPath, JSON.stringify(state, null, 2), "utf8");
       }
 
       this.states[id] = state;
@@ -320,7 +320,8 @@ class Roborock {
           );
           fs.writeFileSync(
             fallbackPath,
-            JSON.stringify(state, null, 2, "utf8")
+            JSON.stringify(state, null, 2),
+            "utf8"
           );
           this.states[id] = state;
           this.log.warn(
@@ -431,7 +432,7 @@ class Roborock {
 
     try {
       fs.mkdirSync(path.dirname(persistPath), { recursive: true });
-      fs.writeFileSync(persistPath, JSON.stringify(state, null, 2, "utf8"));
+      fs.writeFileSync(persistPath, JSON.stringify(state, null, 2), "utf8");
       this.log.info(
         `Migrated legacy '${id}' state file from '${legacyPath}' to '${persistPath}'.`
       );

package/docs/issue-3958-reply.md

@@ -1,29 +0,0 @@
-# Svar til bwp91 på homebridge#3958 — klar til at poste
-
-```markdown
-Thank you — this is exactly the kind of verification I was hoping for, and
-the C → Q correction is a genuinely important update. You're right that my
-analysis was written against the older changes-omitted reading of the
-attribute; I've already corrected the plugin's documentation to reflect the
-Matter 1.4 Q (quieter) quality and your subscription trace
-(mathiashornbek/homebridge-roborock-matter@main, README + docs).
-
-Your controller log also explains two things I had observed but couldn't
-fully reconcile: the resync nudge's null → value transition "working" at the
-wire level while Apple still never converged, and `batChargeState` updating
-live throughout. Both are consistent with the reports leaving the bridge and
-Apple simply not applying Q-quality percentage reports in steady state.
-
-I'll run the verification you suggested on my production setup (three
-robots: one V1, two B01) — Homebridge with matter.js debug logging through a
-full charge cycle, watching for the subscription flushes carrying
-`batPercentRemaining` — and post the log excerpts here. If I can get
-chip-tool set up on the same network I'll add a subscription trace from that
-side too.
-
-Assuming both confirm what your trace already shows, I'll file the Apple
-Feedback report about the controller's handling of Q-quality PowerSource
-attributes and link it here so others can dupe it. Thanks again for digging
-in — happy to test any builds if something changes in the Homebridge Matter
-layer down the road.
-```