add v4 of the home data endpoint

Author: Lash-L

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "roborock-local-server"
-version = "1.0.0"
+version = "1.0.1"
 description = "private local Roborock server stack."
 requires-python = ">=3.11,<3.14"
 readme = "README.md"

roborock_local_server_addon/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.0.1
+
+- Added support for the iOS app's `/v4/user/homes/{home_id}` home-data route so device lists no longer fall through to the generic catchall response.
+- Protected `/v4/user/*` routes with the same Hawk authentication used by existing user API versions.
+
 ## 0.0.2-rc8
 
 - Initial Home Assistant add-on manifest using the shared GHCR image.

roborock_local_server_addon/config.yaml

@@ -1,5 +1,5 @@
 name: Roborock Local Server
-version: "1.0.0"
+version: "1.0.1"
 slug: roborock_local_server
 description: Private Roborock HTTPS and MQTT stack for Home Assistant environments.
 url: "https://github.com/Python-roborock/local_roborock_server"

src/roborock_local_server/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "1.0.0"
+__version__ = "1.0.1"

src/roborock_local_server/bundled_backend/https_server/routes/user/homes/item.py

@@ -11,7 +11,7 @@
 
 def match(path: str) -> bool:
     clean = path.rstrip("/")
-    return bool(re.fullmatch(r"/(?:(?:v2|v3)/)?user/homes/[^/]+", clean))
+    return bool(re.fullmatch(r"/(?:(?:v2|v3|v4)/)?user/homes/[^/]+", clean))
 
 
 def build(

src/roborock_local_server/server.py

@@ -717,7 +717,7 @@ def _required_protocol_auth(cls, clean_path: str) -> str | None:
         normalized = cls._normalized_path(clean_path)
         if cls._is_public_protocol_path(normalized):
             return None
-        if normalized.startswith(("/user/", "/v2/user/", "/v3/user/")):
+        if normalized.startswith(("/user/", "/v2/user/", "/v3/user/", "/v4/user/")):
             return "hawk"
         if normalized.startswith("/api/"):
             return "token"

tests/test_home_data_online.py

@@ -2,6 +2,7 @@
 from pathlib import Path
 
 from fastapi.testclient import TestClient
+import pytest
 from roborock.data import HomeData
 
 from conftest import write_release_config
@@ -340,7 +341,8 @@ def test_device_detail_uses_runtime_connection_and_preserves_inventory_fields(tm
     assert device_data["deviceStatus"] == {"121": 10, "122": 99}
 
 
-def test_home_data_preserves_last_working_app_contract(tmp_path: Path) -> None:
+@pytest.mark.parametrize("home_path", ["/v3/user/homes/1233716", "/v4/user/homes/1233716"])
+def test_home_data_preserves_last_working_app_contract(tmp_path: Path, home_path: str) -> None:
     config_file = write_release_config(tmp_path)
     config = load_config(config_file)
     paths = resolve_paths(config_file, config)
@@ -423,7 +425,7 @@ def test_home_data_preserves_last_working_app_contract(tmp_path: Path) -> None:
     supervisor.refresh_inventory_state()
 
     client = TestClient(supervisor.app)
-    response = client.get("/v3/user/homes/1233716", headers=_hawk_headers(paths.cloud_snapshot_path, "/v3/user/homes/1233716"))
+    response = client.get(home_path, headers=_hawk_headers(paths.cloud_snapshot_path, home_path))
     assert response.status_code == 200
 
     home_data = response.json()["data"]

tests/test_protocol_auth.py

@@ -139,6 +139,23 @@ def test_protected_routes_require_native_token_and_hawk_auth(tmp_path: Path) ->
     assert authed_inbox.status_code == 200
     assert authed_inbox.json()["data"]["count"] == 0
 
+    unauth_v4_home = client.get("/v4/user/homes/12345")
+    assert unauth_v4_home.status_code == 401
+    assert unauth_v4_home.json()["code"] == 40101
+    assert unauth_v4_home.json()["data"]["auth"] == "hawk"
+
+    v4_home_headers = {
+        "Authorization": build_hawk_authorization(
+            user=user,
+            path="/v4/user/homes/12345",
+            timestamp=int(time.time()),
+            nonce="nonce-protocol-auth-v4-home",
+        )
+    }
+    authed_v4_home = client.get("/v4/user/homes/12345", headers=v4_home_headers)
+    assert authed_v4_home.status_code == 200
+    assert authed_v4_home.json()["data"]["id"] == 12345
+
 
 def test_token_auth_failures_use_roborock_invalid_credentials_code(tmp_path: Path) -> None:
     supervisor, _paths = _build_supervisor(tmp_path)