homebridge-roborock-vacuum2 1.4.7

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## 1.2.2
+- **New Feature**: Dynamic Scene Switch Management
+  - Automatically create HomeKit switch buttons for each device's available scenes
+  - Scene switches named after scene names with momentary switch behavior
+  - Automatically add/remove corresponding switch buttons when scenes change
+  - Execute corresponding scenes when switches are pressed, with error handling and status feedback
+  - Synchronize scene switches when HomeData is updated
+- **Improvement**: Refactored scene API methods, separated scene fetching and device filtering functionality
+- **Fix**: Resolved recursive call issue in scene methods
+
+## 1.0.15
+- Fix Roborock Saros 10R Status issue
+
+## 1.0.6
+- Support new model
+
+## 1.0.0
+
+- First version.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018-2019 Nico Hartung
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# homebridge-roborock-vacuum
+
+![Roborock Vacuum in Home App](https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/40/21/71/40217177-c879-f670-bd01-c93acfabc31e/AppIcon-0-0-1x_U007emarketing-0-8-0-85-220.png/460x0w.webp)
+
+A Homebridge plugin to integrate your Roborock vacuum cleaner with Apple HomeKit, allowing you to control it via the Home app and Siri.
+
+## Introduction
+
+`homebridge-roborock-vacuum` brings your Roborock vacuum cleaner into Apple HomeKit. Using your Roborock app account credentials, this plugin automatically detects your vacuum, enabling you to control it directly from the Home app on your iPhone, iPad, or Mac, or with Siri voice commands.
+
+This plugin is inspired by and adapted from the [ioBroker.roborock](https://github.com/copystring/ioBroker.roborock) project by copystring.
+
+## Features
+
+- **Automatic Device Detection**: No need to manually find or enter your vacuum's device ID.
+- **Start/Stop Cleaning**: Begin or end cleaning sessions.
+
+## The supported robots are:
+
+Roborock S4
+Roborock S4 Max
+Roborock S5 Max
+Roborock S6
+Roborock S6 Pure
+Roborock S6 MaxV
+Roborock S7
+Roborock S7 MaxV (Ultra)
+Roborock Q7
+Roborock Q7 Max
+Roborock S7 Pro Ultra
+Roborock S7 Max Ultra
+Roborock S8
+Roborock S8 Pro Ultra
+Roborock Q Revo
+Roborock Q8 Max
+Roborock Q5 Pro
+Roborock Q Revo Pro
+Roborock Qrevo S
+Roborock Qrevo Curve
+Roborock Saros 10
+Roborock (roborock.vacuum.a95)
+Roborock (roborock.vacuum.a159)
+Roborock (roborock.vacuum.ss07)
+
+
+## Requirements
+
+Before installing, ensure you have:
+
+- A Roborock vacuum cleaner compatible with the Roborock app.
+- A Roborock app account (email and password).
+- [Homebridge](https://github.com/homebridge/homebridge) installed on a server (e.g., Raspberry Pi).
+- Node.js and npm installed on your Homebridge server.
+
+## Installation
+
+Follow these steps to install the plugin:
+
+1. **Install Homebridge** (if not already installed):
+   - Refer to the official [Homebridge installation guide](https://github.com/homebridge/homebridge#installation).
+
+2. **Install the Plugin**:
+   - Open a terminal and run:
+     ```bash
+     npm install -g homebridge-roborock-vacuum

package/ROADMAP.md

@@ -0,0 +1,28 @@
+# Homebridge Roborock Vacuum 2 Roadmap
+
+## Worth Doing Now
+
+- Add diagnostics for model resolution, `localKey` presence, and local-vs-cloud readiness in the admin UI.
+- Persist enough discovery data to inspect failures after startup.
+- Harden model lookup so new Roborock API shapes do not immediately become `unknown`.
+- Add targeted tests around discovery parsing, payload normalization, and command transport fallback.
+- Keep CI validating both Homebridge `1.11.x` and `2.0.0-beta`.
+
+## Worth Doing Soon
+
+- Add an explicit per-device transport status view that shows `local`, `cloud fallback`, or `unknown`.
+- Add clearer logs for `localKey` missing, model lookup mismatches, and unsupported attributes.
+- Improve support for recently reported models such as Saros 10, Q5 Max+, QX Revo Plus, and Q10 S5+.
+- Reduce brittle model-specific switches by moving feature detection toward schema/capability-based logic.
+
+## Worth Evaluating Carefully
+
+- Optional manual overrides for model mapping when Roborock metadata is incomplete.
+- Manual local-IP diagnostics or reconnect tools in the UI.
+- A small telemetry/debug export for users opening issue reports.
+
+## Probably Not Worth It
+
+- Rewriting the transport stack from scratch.
+- Fork-only divergence without tests or observability.
+- Large UI redesign before operational visibility is in place.

package/config.schema.json

@@ -0,0 +1,48 @@
+{
+    "pluginAlias": "RoborockVacuumPlatform",
+    "pluginType": "platform",
+    "singular": true,
+    "customUi": true,
+    "customUiPath": "./homebridge-ui",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "email": {
+          "title": "Email",
+          "type": "string",
+          "format": "email",
+          "description": "Roborock account email"
+        },
+        "password": {
+          "title": "Password",
+          "type": "string",
+          "placeholder": "Password",
+          "description": "Roborock account password"
+        },
+        "encryptedToken": {
+          "title": "Encrypted Token",
+          "type": "string",
+          "description": "Encrypted Roborock session data (managed by the UI)",
+          "readOnly": true
+        },
+        "skipDevices": {
+          "title": "Skip Devices",
+          "type": "string",
+          "description": "Comma-separated device IDs to skip"
+        },
+        "baseURL": {
+          "type": "string",
+          "default": "https://usiot.roborock.com",
+          "description": "Roborock API endpoint: https://usiot.roborock.com (US), https://euiot.roborock.com (EU), https://cniot.roborock.com (CN), https://api.roborock.com (Asia)"
+        }
+        ,
+        "debugMode": {
+          "title": "Debug Mode",
+          "description": "When enabled, debug messages will be written to the log.",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": ["email"]
+    }
+  }

package/dist/crypto.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encryptSession = encryptSession;
+exports.decryptSession = decryptSession;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const KEY_FILENAME = 'roborock.token.key';
+function loadOrCreateKey(storagePath) {
+    const keyPath = path_1.default.join(storagePath, KEY_FILENAME);
+    try {
+        const existing = fs_1.default.readFileSync(keyPath);
+        if (existing.length === 32) {
+            return existing;
+        }
+    }
+    catch (error) {
+        // Ignore and create a new key.
+    }
+    const key = crypto_1.default.randomBytes(32);
+    fs_1.default.mkdirSync(storagePath, { recursive: true });
+    fs_1.default.writeFileSync(keyPath, key, { mode: 0o600 });
+    return key;
+}
+function encryptSession(session, storagePath) {
+    const key = loadOrCreateKey(storagePath);
+    const iv = crypto_1.default.randomBytes(12);
+    const cipher = crypto_1.default.createCipheriv('aes-256-gcm', key, iv);
+    const plaintext = Buffer.from(JSON.stringify(session), 'utf8');
+    const ciphertext = Buffer.concat([cipher.update(plaintext), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    const payload = {
+        iv: iv.toString('base64'),
+        tag: tag.toString('base64'),
+        data: ciphertext.toString('base64'),
+    };
+    return Buffer.from(JSON.stringify(payload), 'utf8').toString('base64');
+}
+function decryptSession(encrypted, storagePath) {
+    if (!encrypted) {
+        return null;
+    }
+    try {
+        const key = loadOrCreateKey(storagePath);
+        const raw = Buffer.from(encrypted, 'base64').toString('utf8');
+        const payload = JSON.parse(raw);
+        const iv = Buffer.from(payload.iv, 'base64');
+        const tag = Buffer.from(payload.tag, 'base64');
+        const ciphertext = Buffer.from(payload.data, 'base64');
+        const decipher = crypto_1.default.createDecipheriv('aes-256-gcm', key, iv);
+        decipher.setAuthTag(tag);
+        const plaintext = Buffer.concat([decipher.update(ciphertext), decipher.final()]).toString('utf8');
+        return JSON.parse(plaintext);
+    }
+    catch (error) {
+        return null;
+    }
+}
+//# sourceMappingURL=crypto.js.map

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":";;;;;AAwBA,wCAgBC;AAED,wCAsBC;AAhED,oDAA4B;AAC5B,4CAAoB;AACpB,gDAAwB;AAExB,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,SAAS,eAAe,CAAC,WAAmB;IAC1C,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,YAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+BAA+B;IACjC,CAAC;IAED,MAAM,GAAG,GAAG,gBAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACnC,YAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,YAAE,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,cAAc,CAAC,OAAgC,EAAE,WAAmB;IAClF,MAAM,GAAG,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,EAAE,GAAG,gBAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,gBAAM,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAE7D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEhC,MAAM,OAAO,GAAG;QACd,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzB,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3B,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;KACpC,CAAC;IAEF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,cAAc,CAAC,SAAiB,EAAE,WAAmB;IACnE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA8C,CAAC;QAE7E,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,gBAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACjE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAEzB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const platform_1 = __importDefault(require("./platform"));
+const settings_1 = require("./settings");
+module.exports = (api) => {
+    api.registerPlatform(settings_1.PLATFORM_NAME, platform_1.default);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AACA,0DAA0C;AAC1C,yCAA2C;AAK3C,iBAAS,CAAC,GAAQ,EAAE,EAAE;IACpB,GAAG,CAAC,gBAAgB,CAAC,wBAAa,EAAE,kBAAgB,CAAC,CAAC;AACxD,CAAC,CAAC"}

package/dist/logger.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Decorates the Homebridge logger to only log debug messages when debug mode is enabled.
+ */
+class RoborockPlatformLogger {
+    constructor(logger, debugMode) {
+        this.logger = logger;
+        this.debugMode = debugMode;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    debug(...messages) {
+        if (this.debugMode) {
+            for (let i = 0; i < messages.length; i++) {
+                this.logger.debug(messages[i]);
+            }
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    info(...messages) {
+        for (let i = 0; i < messages.length; i++) {
+            this.logger.info(messages[i]);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    warn(...messages) {
+        for (let i = 0; i < messages.length; i++) {
+            this.logger.warn(messages[i]);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    error(...messages) {
+        for (let i = 0; i < messages.length; i++) {
+            this.logger.error(messages[i]);
+        }
+    }
+}
+exports.default = RoborockPlatformLogger;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;AAEA;;GAEG;AACH,MAAqB,sBAAsB;IACzC,YACmB,MAAc,EACd,SAAkB;QADlB,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAS;IAClC,CAAC;IAEJ,8DAA8D;IAC9D,KAAK,CAAC,GAAG,QAAe;QACtB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,CAAC,GAAG,QAAe;QACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,CAAC,GAAG,QAAe;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC;IACF,CAAC;IAEA,8DAA8D;IAC9D,KAAK,CAAC,GAAG,QAAe;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF;AAnCD,yCAmCC"}

package/dist/platform.js

@@ -0,0 +1,221 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vacuum_accessory_1 = __importDefault(require("./vacuum_accessory"));
+const logger_1 = __importDefault(require("./logger"));
+const settings_1 = require("./settings");
+const crypto_1 = require("./crypto");
+const DEP0040_CODE = "DEP0040";
+let dep0040FilterInstalled = false;
+function installDeprecationWarningFilter() {
+    if (dep0040FilterInstalled) {
+        return;
+    }
+    dep0040FilterInstalled = true;
+    const originalEmitWarning = process.emitWarning.bind(process);
+    let dep0040Logged = false;
+    process.emitWarning = ((warning, type, code, ctor) => {
+        const warningCode = typeof warning === "object" && warning !== null && "code" in warning
+            ? String(warning.code)
+            : code;
+        if (warningCode === DEP0040_CODE) {
+            if (!dep0040Logged) {
+                dep0040Logged = true;
+                process.stderr.write("[Roborock Vacuum] Suppressed Node.js DEP0040 warning from upstream dependency.\n");
+            }
+            return;
+        }
+        originalEmitWarning(warning, type, code, ctor);
+    });
+}
+installDeprecationWarningFilter();
+const Roborock = require("../roborockLib/roborockAPI").Roborock;
+/**
+ * Roborock App Platform Plugin for Homebridge
+ * Based on https://github.com/homebridge/homebridge-plugin-template
+ */
+class RoborockPlatform {
+    /**
+     * This constructor is where you should parse the user config
+     * and discover/register accessories with Homebridge.
+     *
+     * @param logger Homebridge logger
+     * @param config Homebridge platform config
+     * @param api Homebridge API
+     */
+    constructor(homebridgeLogger, config, api) {
+        this.api = api;
+        this.Service = this.api.hap.Service;
+        this.Characteristic = this.api.hap.Characteristic;
+        // Used to track restored cached accessories
+        this.accessories = [];
+        this.vacuums = [];
+        this.platformConfig = config;
+        // Initialise logging utility
+        this.log = new logger_1.default(homebridgeLogger, this.platformConfig.debugMode);
+        // Create Roborock App communication module
+        const username = this.platformConfig.email;
+        const password = this.platformConfig.password;
+        const baseURL = this.platformConfig.baseURL;
+        const debugMode = this.platformConfig.debugMode;
+        const storagePath = this.api.user.storagePath();
+        const decryptedSession = this.platformConfig.encryptedToken
+            ? (0, crypto_1.decryptSession)(this.platformConfig.encryptedToken, storagePath)
+            : null;
+        this.roborockAPI = new Roborock({
+            username: username,
+            password: password,
+            debug: debugMode,
+            baseURL: baseURL,
+            log: this.log,
+            userData: decryptedSession,
+            storagePath: storagePath,
+        });
+        /**
+         * When this event is fired it means Homebridge has restored all cached accessories from disk.
+         * Dynamic Platform plugins should only register new accessories after this event was fired,
+         * in order to ensure they weren't added to homebridge already. This event can also be used
+         * to start discovery of new accessories.
+         */
+        this.api.on("didFinishLaunching" /* APIEvent.DID_FINISH_LAUNCHING */, () => {
+            this.log.debug("Finished launching and restored cached accessories.");
+            this.configurePlugin();
+        });
+        this.api.on("shutdown" /* APIEvent.SHUTDOWN */, () => {
+            this.log.debug("Shutting down...");
+            if (this.roborockAPI) {
+                this.roborockAPI.stopService();
+            }
+        });
+    }
+    async configurePlugin() {
+        await this.loginAndDiscoverDevices();
+    }
+    async loginAndDiscoverDevices() {
+        if (!this.platformConfig.email) {
+            this.log.error("Email is not configured - aborting plugin start. " +
+                "Please set the field `email` in your config and restart Homebridge.");
+            return;
+        }
+        if (!this.platformConfig.password && !this.platformConfig.encryptedToken) {
+            this.log.error("Password is not configured - aborting plugin start. " +
+                "Please set `password` or complete login in the Config UI.");
+            return;
+        }
+        const self = this;
+        self.roborockAPI.setDeviceNotify(function (id, homeData) {
+            self.log.debug(`${id} notifyDeviceUpdater:${JSON.stringify(homeData)}`);
+            for (const vacuum of self.vacuums) {
+                vacuum.notifyDeviceUpdater(id, homeData);
+            }
+        });
+        self.roborockAPI.startService(function () {
+            self.log.info("Service started");
+            //call the discoverDevices function
+            self.discoverDevices();
+        });
+    }
+    /**
+     * This function is invoked when Homebridge restores cached accessories from disk at startup.
+     * It should be used to set up event handlers for characteristics and update respective values.
+     */
+    configureAccessory(accessory) {
+        this.log.info(`Loading accessory '${accessory.displayName}' from cache.`);
+        // Store restored accessory in the cached accessories list
+        // remove duplicates accessories
+        try {
+            const existingAccessory = this.accessories.find((a) => a.UUID === accessory.UUID);
+            if (existingAccessory) {
+                this.log.info(`Removing duplicate accessory '${existingAccessory.displayName}' from cache.`);
+                this.api.unregisterPlatformAccessories(settings_1.PLUGIN_NAME, settings_1.PLATFORM_NAME, [
+                    existingAccessory,
+                ]);
+            }
+        }
+        catch (e) {
+            this.log.error("Error loading accessory from cache: " + e);
+        }
+        this.accessories.push(accessory);
+    }
+    isSupportedDevice(model) {
+        return typeof model === "string" && model.startsWith("roborock.vacuum.");
+    }
+    /**
+     * Fetches all of the user's devices from Roborock App and sets up handlers.
+     *
+     * Accessories must only be registered once. Previously created accessories
+     * must not be registered again to prevent "duplicate UUID" errors.
+     */
+    async discoverDevices() {
+        this.log.info("Discovering vacuum devices...");
+        try {
+            const self = this;
+            if (self.roborockAPI.isInited()) {
+                self.roborockAPI.getVacuumList().forEach(function (device) {
+                    var duid = device.duid;
+                    var name = device.name;
+                    var model = self.roborockAPI.getProductAttribute(duid, "model");
+                    if (!self.isSupportedDevice(model)) {
+                        self.log.info(`Device '${name}' (${duid}) is not supported (model '${model || "unknown"}').`);
+                        return;
+                    }
+                    const uuid = self.api.hap.uuid.generate(device.duid);
+                    const existingAccessory = self.accessories.find((accessory) => accessory.UUID === uuid);
+                    if (existingAccessory !== undefined) {
+                        self.log.info(`Restoring accessory '${existingAccessory.displayName}' ` +
+                            `(${uuid}) from cache.`);
+                        // If you need to update the accessory.context then you should run
+                        // `api.updatePlatformAccessories`. eg.:
+                        existingAccessory.context = duid;
+                        self.api.updatePlatformAccessories([existingAccessory]);
+                        // Create the accessory handler for the restored accessory
+                        self.createRoborockAccessory(existingAccessory);
+                    }
+                    else {
+                        // The accessory already exists, so we need to create it
+                        self.log.info(`Adding accessory '${name}' (${uuid}).`);
+                        // The accessory does not yet exist, so we need to create it
+                        const accessory = new self.api.platformAccessory(name, uuid);
+                        // Store a copy of the device object in the `accessory.context` property,
+                        // which can be used to store any data about the accessory you may need.
+                        accessory.context = duid;
+                        // Create the accessory handler for the newly create accessory
+                        // this is imported from `platformAccessory.ts`
+                        self.createRoborockAccessory(accessory);
+                        // Link the accessory to your platform
+                        self.api.registerPlatformAccessories(settings_1.PLUGIN_NAME, settings_1.PLATFORM_NAME, [
+                            accessory,
+                        ]);
+                    }
+                });
+            }
+            // At this point, we set up all devices from Roborock App, but we did not unregister
+            // cached devices that do not exist on the Roborock App account anymore.
+            for (const cachedAccessory of this.accessories) {
+                if (cachedAccessory.context) {
+                    const vacuum = self.roborockAPI.getVacuumDeviceData(cachedAccessory.context);
+                    if (vacuum === undefined) {
+                        // This cached devices does not exist on the Roborock App account (anymore).
+                        this.log.info(`Removing accessory '${cachedAccessory.displayName}' (${cachedAccessory.context}) ` +
+                            "because it does not exist on the Roborock account anymore.");
+                        this.api.unregisterPlatformAccessories(settings_1.PLUGIN_NAME, settings_1.PLATFORM_NAME, [
+                            cachedAccessory,
+                        ]);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this.log.error("An error occurred during device discovery. " +
+                "Turn on debug mode for more information.");
+            this.log.debug(error);
+        }
+    }
+    createRoborockAccessory(accessory) {
+        this.vacuums.push(new vacuum_accessory_1.default(this, accessory));
+    }
+}
+exports.default = RoborockPlatform;
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"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"}

package/dist/settings.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_NAME = exports.PLUGIN_NAME = void 0;
+// Name of the plugin (must match the `name` of the package.json).
+exports.PLUGIN_NAME = 'homebridge-roborock-vacuum';
+// The platform the plugin creates (see config.json).
+exports.PLATFORM_NAME = 'RoborockVacuumPlatform';
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":";;;AAAA,kEAAkE;AACrD,QAAA,WAAW,GAAG,4BAA4B,CAAC;AAExD,qDAAqD;AACxC,QAAA,aAAa,GAAG,wBAAwB,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}