homebridge-roborock-vacuum 1.2.4 → 1.3.0

package/homebridge-ui/public/index.js

@@ -0,0 +1,250 @@
+const elements = {
+  email: document.getElementById('email'),
+  password: document.getElementById('password'),
+  passwordRow: document.getElementById('password-row'),
+  baseUrl: document.getElementById('base-url'),
+  skipDevices: document.getElementById('skip-devices'),
+  debugMode: document.getElementById('debug-mode'),
+  code: document.getElementById('two-factor-code'),
+  login: document.getElementById('login'),
+  logout: document.getElementById('logout'),
+  send2fa: document.getElementById('send-2fa'),
+  verify2fa: document.getElementById('verify-2fa'),
+  twoFactorSection: document.getElementById('two-factor-section'),
+  toastContainer: document.getElementById('toast-container'),
+};
+
+function showToast(type, message) {
+  if (window.homebridge && window.homebridge.toast && typeof window.homebridge.toast[type] === 'function') {
+    window.homebridge.toast[type](message);
+    return;
+  }
+
+  const toast = document.createElement('div');
+  toast.className = `toast ${type}`;
+  toast.textContent = message;
+  elements.toastContainer.appendChild(toast);
+
+  setTimeout(() => {
+    toast.remove();
+  }, 4000);
+}
+
+async function request(path, body) {
+  try {
+    return await window.homebridge.request(path, body);
+  } catch (error) {
+    return { ok: false, message: error.message || 'Request failed.' };
+  }
+}
+
+async function loadConfig() {
+  if (!window.homebridge || typeof window.homebridge.getPluginConfig !== 'function') {
+    return;
+  }
+
+  const configs = await window.homebridge.getPluginConfig();
+  const config = configs.find((entry) => entry.platform === 'RoborockVacuumPlatform');
+  if (!config) {
+    return;
+  }
+
+  if (config.email) {
+    elements.email.value = config.email;
+  }
+  elements.baseUrl.value = normalizeBaseUrl(config.baseURL || 'https://usiot.roborock.com');
+  if (config.skipDevices) {
+    elements.skipDevices.value = config.skipDevices;
+  }
+  elements.debugMode.checked = Boolean(config.debugMode);
+
+  setLoggedInState(Boolean(config.encryptedToken));
+}
+
+function getEmail() {
+  return elements.email.value.trim();
+}
+
+function getPassword() {
+  return elements.password.value;
+}
+
+function getBaseUrl() {
+  return elements.baseUrl.value;
+}
+
+function getSkipDevices() {
+  return elements.skipDevices.value.trim();
+}
+
+function getDebugMode() {
+  return Boolean(elements.debugMode.checked);
+}
+
+function getCode() {
+  return elements.code.value.trim();
+}
+
+async function saveCredentials() {
+  const email = getEmail();
+  const baseURL = getBaseUrl();
+  const skipDevices = getSkipDevices();
+  const debugMode = getDebugMode();
+  if (!email) {
+    showToast('error', 'Email is required.');
+    return;
+  }
+
+  await updatePluginConfig({
+    email,
+    baseURL,
+    skipDevices,
+    debugMode,
+  });
+}
+
+async function login() {
+  const email = getEmail();
+  const password = getPassword();
+  const baseURL = getBaseUrl();
+  const result = await request('/auth/login', { email, password, baseURL });
+
+  if (result.ok) {
+    await updatePluginConfig({
+      email,
+      password,
+      baseURL,
+      encryptedToken: result.encryptedToken,
+    });
+    showToast('success', result.message || 'Login successful.');
+    setLoggedInState(true);
+    return;
+  }
+
+  if (result.twoFactorRequired) {
+    showToast('warning', result.message || 'Two-factor authentication required.');
+    return;
+  }
+
+  showToast('error', result.message || 'Login failed.');
+}
+
+async function sendTwoFactorEmail() {
+  const email = getEmail();
+  const baseURL = getBaseUrl();
+  if (!email) {
+    showToast('error', 'Email is required.');
+    return;
+  }
+
+  const result = await request('/auth/send-2fa-email', { email, baseURL });
+  if (result.ok) {
+    showToast('success', result.message || 'Verification email sent.');
+  } else {
+    showToast('error', result.message || 'Failed to send verification email.');
+  }
+}
+
+async function verifyTwoFactorCode() {
+  const email = getEmail();
+  const code = getCode();
+  const baseURL = getBaseUrl();
+  if (!email) {
+    showToast('error', 'Email is required.');
+    return;
+  }
+  if (!code) {
+    showToast('error', 'Verification code is required.');
+    return;
+  }
+
+  const result = await request('/auth/verify-2fa-code', { email, code, baseURL });
+  if (result.ok) {
+    await updatePluginConfig({
+      email,
+      baseURL,
+      encryptedToken: result.encryptedToken,
+    });
+    showToast('success', result.message || 'Verification successful.');
+    setLoggedInState(true);
+  } else {
+    showToast('error', result.message || 'Verification failed.');
+  }
+}
+
+async function logout() {
+  const result = await request('/auth/logout');
+  if (result.ok) {
+    await updatePluginConfig({ encryptedToken: undefined });
+    showToast('success', result.message || 'Logged out.');
+    setLoggedInState(false);
+  } else {
+    showToast('error', result.message || 'Logout failed.');
+  }
+}
+
+function normalizeBaseUrl(value) {
+  if (!value) {
+    return 'https://usiot.roborock.com';
+  }
+  if (value.startsWith('http://') || value.startsWith('https://')) {
+    return value.replace(/\/+$/, '');
+  }
+  return `https://${value.replace(/\/+$/, '')}`;
+}
+
+function setLoggedInState(isLoggedIn) {
+  elements.logout.classList.toggle('hidden', !isLoggedIn);
+  elements.login.classList.toggle('hidden', isLoggedIn);
+  elements.passwordRow.classList.toggle('hidden', isLoggedIn);
+  elements.twoFactorSection.classList.toggle('hidden', isLoggedIn);
+  elements.email.readOnly = isLoggedIn;
+  elements.email.parentElement.classList.toggle('readonly', isLoggedIn);
+}
+
+async function updatePluginConfig(patch) {
+  if (!window.homebridge || typeof window.homebridge.getPluginConfig !== 'function') {
+    return;
+  }
+
+  const configs = await window.homebridge.getPluginConfig();
+  let config = configs.find((entry) => entry.platform === 'RoborockVacuumPlatform');
+  if (!config) {
+    config = { platform: 'RoborockVacuumPlatform', name: 'Roborock Vacuum' };
+    configs.push(config);
+  }
+
+  Object.keys(patch).forEach((key) => {
+    const value = patch[key];
+    if (value === undefined) {
+      delete config[key];
+    } else {
+      config[key] = value;
+    }
+  });
+
+  await window.homebridge.updatePluginConfig(configs);
+  await window.homebridge.savePluginConfig();
+}
+
+function init() {
+  loadConfig().catch(() => {
+    showToast('error', 'Failed to load current config.');
+  });
+  elements.login.addEventListener('click', login);
+  elements.send2fa.addEventListener('click', sendTwoFactorEmail);
+  elements.verify2fa.addEventListener('click', verifyTwoFactorCode);
+  elements.logout.addEventListener('click', logout);
+  elements.baseUrl.addEventListener('change', saveCredentials);
+  elements.skipDevices.addEventListener('change', saveCredentials);
+  elements.debugMode.addEventListener('change', saveCredentials);
+  elements.email.addEventListener('change', saveCredentials);
+}
+
+if (window.homebridge) {
+  window.homebridge.addEventListener('ready', () => {
+    init();
+  });
+} else {
+  document.addEventListener('DOMContentLoaded', init);
+}

package/homebridge-ui/public/styles.css

@@ -0,0 +1,184 @@
+@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;600&display=swap');
+
+:root {
+  --bg: #0f172a;
+  --card: #111c33;
+  --text: #e2e8f0;
+  --muted: #94a3b8;
+  --primary: #38bdf8;
+  --secondary: #1e293b;
+  --border: #1f2a44;
+  --shadow: 0 20px 40px rgba(15, 23, 42, 0.35);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: "Space Grotesk", "Segoe UI", sans-serif;
+  background: radial-gradient(circle at top, #1e3a8a, #0b1120 55%, #020617);
+  color: var(--text);
+}
+
+.container {
+  max-width: 860px;
+  margin: 0 auto;
+  padding: 32px 24px 24px;
+  display: grid;
+  gap: 24px;
+}
+
+header h1 {
+  font-size: 2.6rem;
+  margin-bottom: 8px;
+}
+
+.subtitle {
+  margin: 0;
+  color: var(--muted);
+}
+
+.card {
+  background: var(--card);
+  border: 1px solid var(--border);
+  border-radius: 18px;
+  padding: 24px;
+  box-shadow: var(--shadow);
+}
+
+.card h2 {
+  margin-top: 0;
+  font-size: 1.4rem;
+}
+
+.help {
+  color: var(--muted);
+  margin-top: 0;
+}
+
+label {
+  display: block;
+  margin-top: 16px;
+  font-size: 0.95rem;
+  color: var(--muted);
+}
+
+select,
+input {
+  width: 100%;
+  margin-top: 8px;
+  padding: 12px 14px;
+  border-radius: 10px;
+  border: 1px solid var(--border);
+  background: #0b1328;
+  color: var(--text);
+  font-size: 1rem;
+}
+
+input::placeholder {
+  color: #64748b;
+}
+
+.checkbox {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  margin-top: 18px;
+}
+
+.checkbox input {
+  width: auto;
+  margin: 0;
+}
+
+.hidden {
+  display: none;
+}
+
+.readonly input {
+  background: #111827;
+  opacity: 0.75;
+}
+
+.actions {
+  display: flex;
+  gap: 12px;
+  flex-wrap: wrap;
+  margin-top: 20px;
+}
+
+button {
+  border: none;
+  border-radius: 999px;
+  padding: 12px 20px;
+  font-size: 0.95rem;
+  cursor: pointer;
+  transition: transform 0.15s ease, box-shadow 0.15s ease;
+}
+
+button:hover {
+  transform: translateY(-1px);
+  box-shadow: 0 12px 24px rgba(56, 189, 248, 0.18);
+}
+
+.primary {
+  background: var(--primary);
+  color: #041826;
+}
+
+.secondary {
+  background: var(--secondary);
+  color: var(--text);
+  border: 1px solid var(--border);
+}
+
+.toast-container {
+  position: fixed;
+  right: 24px;
+  bottom: 24px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  z-index: 9999;
+}
+
+.toast {
+  background: #0f172a;
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  padding: 12px 16px;
+  box-shadow: var(--shadow);
+  min-width: 220px;
+  animation: slide-in 0.2s ease-out;
+}
+
+.toast.success {
+  border-color: #22c55e;
+}
+
+.toast.error {
+  border-color: #ef4444;
+}
+
+.toast.warning {
+  border-color: #f59e0b;
+}
+
+@keyframes slide-in {
+  from {
+    transform: translateY(10px);
+    opacity: 0;
+  }
+  to {
+    transform: translateY(0);
+    opacity: 1;
+  }
+}
+
+@media (max-width: 640px) {
+  header h1 {
+    font-size: 2.1rem;
+  }
+}

package/homebridge-ui/server.js

@@ -0,0 +1,3 @@
+"use strict";
+
+require("../dist/ui/index.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-roborock-vacuum",
-  "version": "1.2.4",
+  "version": "1.3.0",
   "description": "Roborock Vacuum Cleaner - plugin for Homebridge.",
   "license": "MIT",
   "keywords": [
@@ -20,11 +20,12 @@
   "main": "dist/index.js",
   "engines": {
     "homebridge": "^1.6.0 || ^2.0.0-beta.0",
-    "node": "^18.20.4 || ^20.15.1 || ^22"
+    "node": "^18.20.4 || ^20.15.1 || ^22 || ^24"
   },
   "scripts": {
     "clean": "rimraf ./dist",
     "build": "rimraf ./dist && tsc",
+    "prepare": "npm run build",
     "prepublishOnly": "npm run build",
     "postpublish": "npm run clean",
     "lint": "prettier --check .",
@@ -32,6 +33,7 @@
     "test": "jest"
   },
   "dependencies": {
+    "@homebridge/plugin-ui-utils": "^2.0.0",
     "abstract-things": "0.9.0",
     "axios": "^1.11.0",
     "binary-parser": "^2.2.1",

package/roborockLib/lib/deviceFeatures.js

@@ -595,6 +595,8 @@ class deviceFeatures {
 				"roborock.vacuum.a117", // Qrevo Master
 				"roborock.vacuum.a21", // Qrevo Slim
 				"roborock.vacuum.a144", // Saros 10R
+				"roborock.vacuum.a140",
+				"roborock.vacuum.ss07",
 			].includes(robotModel),
 			// isShakeMopStrengthSupported: p.DMM.currentProduct == p.Products.TanosS || p.DMM.currentProduct == p.Products.TanosSPlus || p.DMM.isGarnet || p.DMM.isTopazSV || p.DMM.isPearlPlus || p.DMM.isCoral || p.DMM.isTopazS || p.DMM.isTopazSPlus || p.DMM.isTopazSC || p.DMM.isTopazSV || p.DMM.isPearlPlus || p.DMM.isTanosSMax || p.DMM.isUltron || p.DMM.isUltronSPlus || p.DMM.isUltronSMop || p.DMM.isUltronSV || p.DMM.isPearl
 			isShakeMopStrengthSupported: [
@@ -615,6 +617,8 @@ class deviceFeatures {
 				"roborock.vacuum.a87", // Qrevo MaxV
 				"roborock.vacuum.a101", // Q Revo Pro
 				"roborock.vacuum.a144", // Saros 10R
+				"roborock.vacuum.a140",
+				"roborock.vacuum.ss07",
 			].includes(robotModel),
 			// isWaterBoxSupported: [p.Products.Tanos_CE, p.Products.Tanos_CN].hasElement(p.DMM.currentProduct)
 			isWaterBoxSupported: [
@@ -641,6 +645,8 @@ class deviceFeatures {
 				"roborock.vacuum.a117", // Qrevo Master
 				"roborock.vacuum.a21", // Qrevo Slim
 				"roborock.vacuum.a144", // Saros 10R
+				"roborock.vacuum.a140",
+				"roborock.vacuum.ss07",
 
 			].includes(robotModel),
 			isCustomWaterBoxDistanceSupported: !!(2147483648 & this.features),
@@ -665,6 +671,8 @@ class deviceFeatures {
 				"roborock.vacuum.a135", // Qrevo Curv
 				"roborock.vacuum.a117", // Qrevo Master
 				"roborock.vacuum.a144", // Saros 10R
+				"roborock.vacuum.a140",
+				"roborock.vacuum.ss07",
 
 			].includes(robotModel),
 			// this isn't the correct way to use this. This code must be from a different robot
@@ -965,6 +973,38 @@ class deviceFeatures {
 					"set_switch_status",
 					"set_last_clean_t",
 				],
+				"roborock.vacuum.a140": [
+					"setCleaningRecordsString",
+					"setConsumablesInt",
+					"set_common_status",
+					"set_dss",
+					"set_rss",
+					"set_kct",
+					"set_in_warmup",
+					"set_last_clean_t",
+					"set_map_flag",
+					"set_back_type",
+					"set_charge_status",
+					"set_clean_percent",
+					"set_cleaned_area",
+					"set_switch_status",
+				],
+				"roborock.vacuum.ss07": [
+					"setCleaningRecordsString",
+					"setConsumablesInt",
+					"set_common_status",
+					"set_dss",
+					"set_rss",
+					"set_kct",
+					"set_in_warmup",
+					"set_last_clean_t",
+					"set_map_flag",
+					"set_back_type",
+					"set_charge_status",
+					"set_clean_percent",
+					"set_cleaned_area",
+					"set_switch_status",
+				],
 
 			};
 

package/roborockLib/lib/roborockAuth.js

@@ -0,0 +1,147 @@
+"use strict";
+
+const crypto = require("crypto");
+const axios = require("axios");
+
+const API_V3_SIGN = "api/v3/key/sign";
+const API_V4_LOGIN_CODE = "api/v4/auth/email/login/code";
+const API_V4_LOGIN_PASSWORD = "api/v4/auth/email/login/pwd";
+const API_V4_EMAIL_CODE = "api/v4/email/code/send";
+
+const DEFAULT_HEADERS = {
+	header_appversion: "4.54.02",
+	header_clientlang: "en",
+	header_phonemodel: "Pixel 7",
+	header_phonesystem: "Android",
+};
+
+function normalizeBaseURL(baseURL) {
+	if (!baseURL) {
+		return "usiot.roborock.com";
+	}
+	return baseURL.replace(/^https?:\/\//i, "").replace(/\/+$/, "");
+}
+
+function getRegionConfig(baseURL) {
+	const lower = normalizeBaseURL(baseURL).toLowerCase();
+	if (lower.includes("euiot")) {
+		return { country: "DE", countryCode: "49" };
+	}
+	if (lower.includes("usiot")) {
+		return { country: "US", countryCode: "1" };
+	}
+	if (lower.includes("cniot")) {
+		return { country: "CN", countryCode: "86" };
+	}
+	if (lower.includes("api.roborock.com")) {
+		return { country: "SG", countryCode: "65" };
+	}
+	return { country: "US", countryCode: "1" };
+}
+
+function encryptPassword(password, k) {
+	const derivedKey = k.slice(4) + k.slice(0, 4);
+	const cipher = crypto.createCipheriv("aes-128-ecb", Buffer.from(derivedKey, "utf-8"), null);
+	cipher.setAutoPadding(true);
+	let encrypted = cipher.update(password, "utf8", "base64");
+	encrypted += cipher.final("base64");
+	return encrypted;
+}
+
+function createLoginApi({ baseURL, username, clientID, language }) {
+	return axios.create({
+		baseURL: `https://${normalizeBaseURL(baseURL)}`,
+		headers: {
+			header_clientid: crypto.createHash("md5").update(username).update(clientID).digest().toString("base64"),
+			header_clientlang: language || DEFAULT_HEADERS.header_clientlang,
+			header_appversion: DEFAULT_HEADERS.header_appversion,
+			header_phonemodel: DEFAULT_HEADERS.header_phonemodel,
+			header_phonesystem: DEFAULT_HEADERS.header_phonesystem,
+		},
+	});
+}
+
+async function signRequest(loginApi, s) {
+	const res = await loginApi.post(`${API_V3_SIGN}?s=${s}`);
+	return res.data && res.data.data ? res.data.data : null;
+}
+
+async function requestEmailCode(loginApi, email) {
+	const params = new URLSearchParams();
+	params.append("type", "login");
+	params.append("email", email);
+	params.append("platform", "");
+
+	try {
+		const res = await loginApi.post(API_V4_EMAIL_CODE, params.toString());
+		if (res.data && res.data.code !== 200) {
+			throw new Error(`Send code failed: ${res.data.msg || "Unknown error"} (Code: ${res.data.code})`);
+		}
+		return res.data;
+	} catch (error) {
+		if (error.response && error.response.data) {
+			throw new Error(`Send code failed: ${JSON.stringify(error.response.data)}`);
+		}
+		throw error;
+	}
+}
+
+async function loginWithCode(loginApi, { email, code, country, countryCode, k, s }) {
+	const headers = {
+		"x-mercy-k": k,
+		"x-mercy-ks": s,
+	};
+
+	const params = new URLSearchParams({
+		country,
+		countryCode,
+		email,
+		code,
+		majorVersion: "14",
+		minorVersion: "0",
+	});
+
+	try {
+		const res = await loginApi.post(API_V4_LOGIN_CODE, params.toString(), { headers });
+		return res.data;
+	} catch (error) {
+		if (error.response && error.response.data) {
+			return error.response.data;
+		}
+		throw error;
+	}
+}
+
+async function loginByPassword(loginApi, { email, password, k, s }) {
+	const headers = {
+		"x-mercy-k": k,
+		"x-mercy-ks": s,
+	};
+
+	const params = new URLSearchParams({
+		email,
+		password: encryptPassword(password, k),
+		majorVersion: "14",
+		minorVersion: "0",
+	});
+
+	try {
+		const res = await loginApi.post(API_V4_LOGIN_PASSWORD, params.toString(), { headers });
+		return res.data;
+	} catch (error) {
+		if (error.response && error.response.data) {
+			return error.response.data;
+		}
+		throw error;
+	}
+}
+
+module.exports = {
+	createLoginApi,
+	getRegionConfig,
+	normalizeBaseURL,
+	signRequest,
+	requestEmailCode,
+	loginWithCode,
+	loginByPassword,
+};