python-roborock 7.14.1__py3-none-any.whl → 7.15.0__py3-none-any.whl

{python_roborock-7.14.1.dist-info → python_roborock-7.15.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-roborock
-Version: 7.14.1
+Version: 7.15.0
 Summary: A package to control Roborock vacuums.
 Project-URL: Repository, https://github.com/python-roborock/python-roborock
 Project-URL: Documentation, https://python-roborock.readthedocs.io/

{python_roborock-7.14.1.dist-info → python_roborock-7.15.0.dist-info}/RECORD

@@ -12,7 +12,8 @@ roborock/roborock_message.py,sha256=VWsytnm7nQqOMBj7oYbiqPPqwE9qClDSI03CFuHXsds,
 roborock/roborock_typing.py,sha256=xppavdf57-Cu6elj3MP403uT75Tjw5Zs6bLGPLQmZf4,15483
 roborock/util.py,sha256=4zibjn2MgPrLCiha66LUXZj907LOXUtNzugbbb0NIlo,1634
 roborock/web_api.py,sha256=G42qiPdTGx4LhMA4uTDASAMYw1HIipDnD6_eziwCPqs,43202
-roborock/data/__init__.py,sha256=jSZHOrd-LfVN-TdBkjNW334ef99rGBz4-hPT_7KvoLs,278
+roborock/data/__init__.py,sha256=mmFs7SGa1ciqXME5Al9gfIKiCnbhgu1V84wa4j5mdfs,300
+roborock/data/camera.py,sha256=AaTsDqNlUwV_6zdIX9wQkPXGFzyt2EiiKnitcnfQJA4,5792
 roborock/data/code_mappings.py,sha256=j-ZZRtQQdIMJQAgEwDAxWKreNhD6U36oIhBKr_nLbis,9783
 roborock/data/containers.py,sha256=ePz1tmhNY1QpgiVlyc8j6PH5kjU6fkZYtBByCFj2wzU,17896
 roborock/data/b01_q10/__init__.py,sha256=E4lwJcz4AI1z92FcYOJ-cY3fcfHSoXqvYVgfA-TgaRk,71
@@ -25,12 +26,13 @@ roborock/data/dyad/__init__.py,sha256=Ksx7Ri1alsAYAyILOpj9iNbCC_6sF7xvETFRnTO4rd
 roborock/data/dyad/dyad_code_mappings.py,sha256=PGzEpkdc1jsR5RLRnjVnI2Y87O_HFAFulwOjjjbT4B0,2872
 roborock/data/dyad/dyad_containers.py,sha256=klJD2wV-2McjAoSN8Bthuyeid59L7M8nzSvc3MtmqOI,434
 roborock/data/mower/__init__.py,sha256=RXFcOE0-rchWViq3F-cLXB9Jnx4nKrn98TUR917szWM,114
-roborock/data/mower/mower_code_mappings.py,sha256=T3NJEjgkYv3svIt7-gqFgrnNmVeBOkqit8_D52vSIao,1741
-roborock/data/mower/mower_containers.py,sha256=PYNVhbGCafkchenBlBmG_fUnIC-9WfxF8gNB0C4_9Yo,4106
-roborock/data/v1/__init__.py,sha256=Lx_D6baZrCMxp57D0NcdiA8rssJ5NnInZwUwrT79XOI,91
+roborock/data/mower/mower_code_mappings.py,sha256=dKHgZxpNVaO-uFZvqjPouYbpzgukAlnFgHa8vGsNxKs,14110
+roborock/data/mower/mower_containers.py,sha256=s8xzDOW7Pgoipw7P2ROjj-4-c0qZRHuZ-kw_Zu-Aqt0,4938
+roborock/data/v1/__init__.py,sha256=3cdjyhCkD4EmEn9JVlSakGusnEgzGajpn8tAvzB3FkI,121
 roborock/data/v1/v1_clean_modes.py,sha256=uePsc82-7C6tjybYmnYtxA6WAOPS9ofnJXMEP218KTQ,15767
 roborock/data/v1/v1_code_mappings.py,sha256=9lbpJ5Ugzb0IhjiHjNNQvgLBxEsjZdfq1sEOHkjJIfI,12970
 roborock/data/v1/v1_containers.py,sha256=s5ivZjkNIX7ls6IXBnppBWATTqdAlRY-Busw3aoKPnc,18602
+roborock/data/v1/v1_dynamic_map.py,sha256=W6eGGR25euxvilnl8KyYBhzUZCbizUC29tCY36mXQhM,7795
 roborock/data/zeo/__init__.py,sha256=VxG5qG4M24DGOq2YAaxownWp6bEfj9DEOgOMHmTpcqY,63
 roborock/data/zeo/zeo_code_mappings.py,sha256=mfm2xoI8RllPZfyZE0HmUhUhLECwRD0llkMNWfaEHvw,8057
 roborock/data/zeo/zeo_containers.py,sha256=huDeisutagKz1rzsLZr_tGAietec_qOd0KB3i09YGgo,4339
@@ -120,6 +122,7 @@ roborock/protocols/__init__.py,sha256=1ems3I1_KUQoMf2Hf6ZYDKFhu5Gnsc0PbfD-dkQJ7v
 roborock/protocols/a01_protocol.py,sha256=nyUAn39CXH0xLqcRcr7JiORt2zFNgxP4F4ClVc3dvB4,2501
 roborock/protocols/b01_q10_protocol.py,sha256=cQnVo5HIVoYhjtVAdnZsPkM-5Glrq9x2jcMG9vhHtRw,7213
 roborock/protocols/b01_q7_protocol.py,sha256=2dk6nbDOhb0O-Q_UPKeZHjzdazbS-MA3PIqpXvqRqoo,4657
+roborock/protocols/camera_signaling.py,sha256=tCaVbHPjlHpsGL4RLjkgBVZFYgYg1PvBA8Ns-eEErEE,13179
 roborock/protocols/v1_protocol.py,sha256=ntFQoGn1IF7v_BwjiGow478SJHBSKr6jq6M2s01OdaI,12918
 roborock/testing/__init__.py,sha256=rji4a-JBIWC_I6SUTG9j4r2bGxfhYUoopdDAzYQ1tmA,5086
 roborock/testing/a01_simulator.py,sha256=M4R0ATgebIva6Jl0BPKfwdGqdZjmjGZHlozAVVteJ5I,10477
@@ -128,8 +131,8 @@ roborock/testing/channel.py,sha256=vjulT5MHBe8lAq6XITUqcxJVcCILWx7ZEcw5imTx0Tk,7
 roborock/testing/cloud.py,sha256=L2L0KlZDYaMuoV19KUQUoq5EAUDeNQ1lJ8Ew5YaOgjo,11946
 roborock/testing/simulator.py,sha256=g8ZUWVSjgAzuRRxWOCeOq-7deodyEItwUpqEw9RzCmQ,4347
 roborock/testing/v1_simulator.py,sha256=dDlaaCqKMrE-IotSqaENGf-mZYLDFVelozDJAXnet0s,18929
-python_roborock-7.14.1.dist-info/METADATA,sha256=vvndtBwZRgub5PRRfgYSqRW8llXWGtcHZ8vpLobbrdc,5279
-python_roborock-7.14.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-python_roborock-7.14.1.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
-python_roborock-7.14.1.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-python_roborock-7.14.1.dist-info/RECORD,,
+python_roborock-7.15.0.dist-info/METADATA,sha256=XxXWSGrnE-azLQjTId5OhnGB5Vq0LZ1MxiB86b3gVXE,5279
+python_roborock-7.15.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+python_roborock-7.15.0.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
+python_roborock-7.15.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+python_roborock-7.15.0.dist-info/RECORD,,

roborock/data/__init__.py

@@ -2,6 +2,7 @@
 
 from .b01_q7 import *
 from .b01_q10 import *
+from .camera import *
 from .code_mappings import *
 from .containers import *
 from .dyad import *

roborock/data/camera.py

@@ -0,0 +1,158 @@
+"""Data models for Roborock camera live view."""
+
+from dataclasses import dataclass, field
+from enum import StrEnum
+from typing import Any, Self
+
+from .containers import RoborockBase
+
+__all__ = ["CameraIceCandidate", "CameraQuality", "CameraSdpDescription", "CameraTurnServer"]
+
+_VALID_TURN_SCHEMES = ("turn:", "turns:", "stun:", "stuns:")
+
+
+class CameraQuality(StrEnum):
+    """Camera video streaming resolution setting."""
+
+    HD = "HD"
+    SD = "SD"
+    FHD = "FHD"
+    AUTO = "auto"
+
+    @classmethod
+    def from_str(cls, value: str) -> Self:
+        """Parse CameraQuality case-insensitively."""
+        normalized = value.strip()
+        # "auto" is lowercase in the Roborock app enum, while HD/SD/FHD are uppercase
+        for member in cls:
+            if member.value.lower() == normalized.lower():
+                return member
+        valid = ", ".join(repr(m.value) for m in cls)
+        raise ValueError(f"Invalid camera quality: {value!r}. Expected one of {valid}.")
+
+
+@dataclass
+class CameraTurnServer(RoborockBase):
+    """Ephemeral TURN server credentials for WebRTC peer connection relay."""
+
+    urls: list[str]
+    username: str | None = None
+    credential: str | None = field(default=None, repr=False)
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any] | list[dict[str, Any]]) -> Self:
+        """Create CameraTurnServer from get_turn_server response or dict.
+
+        Handles both device RPC responses (single-item list or dict with 'url', 'user', 'pwd')
+        and standard WebRTC configuration dicts ('urls', 'username', 'credential').
+        """
+        if isinstance(data, list):
+            if not data:
+                raise ValueError("Empty TURN server data list")
+            item = data[0]
+            if not isinstance(item, dict):
+                raise TypeError(f"Expected dict inside TURN server list, got {type(item).__name__}")
+            data = item
+        if not isinstance(data, dict):
+            raise TypeError(f"Expected dict or list of dicts for TURN server, got {type(data).__name__}")
+
+        if "urls" in data:
+            urls_val = data["urls"]
+        elif "url" in data:
+            urls_val = data["url"]
+        else:
+            raise ValueError("Missing 'url' or 'urls' in TURN server response")
+
+        urls: list[str] = []
+        if isinstance(urls_val, str):
+            urls_clean = urls_val.strip()
+            if not urls_clean:
+                raise ValueError("TURN server URL cannot be empty")
+            urls = [urls_clean]
+        elif isinstance(urls_val, list):
+            if not urls_val:
+                raise ValueError("TURN server 'urls' list cannot be empty")
+            for u in urls_val:
+                if not isinstance(u, str) or not u.strip():
+                    raise ValueError(f"Each URL in 'urls' must be a non-empty string, got {u!r}")
+                urls.append(u.strip())
+        else:
+            raise TypeError(f"Expected str or list for urls, got {type(urls_val).__name__}")
+
+        # Validate URL scheme (stun:, stuns:, turn:, turns:)
+        for u in urls:
+            if not any(u.lower().startswith(scheme) for scheme in _VALID_TURN_SCHEMES):
+                raise ValueError(f"Invalid ICE server URL scheme in {u!r}. Expected turn:, turns:, stun:, or stuns:")
+
+        user_val = data.get("username") if "username" in data else data.get("user")
+        pwd_val = data.get("credential") if "credential" in data else data.get("pwd")
+
+        if user_val is not None and not isinstance(user_val, str):
+            raise TypeError(f"Expected str for username, got {type(user_val).__name__}")
+        if pwd_val is not None and not isinstance(pwd_val, str):
+            raise TypeError(f"Expected str for credential, got {type(pwd_val).__name__}")
+
+        return cls(
+            urls=urls,
+            username=user_val,
+            credential=pwd_val,
+        )
+
+
+@dataclass
+class CameraIceCandidate(RoborockBase):
+    """Parsed WebRTC ICE candidate representation (RFC 5245 / RFC 8839)."""
+
+    foundation: str
+    component: int
+    protocol: str
+    priority: int
+    ip: str
+    port: int
+    candidate_type: str
+    related_address: str | None = None
+    related_port: int | None = None
+    tcp_type: str | None = None
+    sdp_mid: str | None = None
+    sdp_mline_index: int | None = None
+    extensions: dict[str, str] = field(default_factory=dict)
+
+    def to_sdp(self) -> str:
+        """Format candidate as an SDP attribute line value (RFC 5245 / RFC 8839)."""
+        parts = [
+            f"candidate:{self.foundation}",
+            str(self.component),
+            self.protocol.lower(),
+            str(self.priority),
+            self.ip,
+            str(self.port),
+            "typ",
+            self.candidate_type.lower(),
+        ]
+        if self.related_address is not None and self.related_port is not None:
+            parts.extend(["raddr", self.related_address, "rport", str(self.related_port)])
+        if self.tcp_type is not None:
+            parts.extend(["tcptype", self.tcp_type.lower()])
+        for ext_k, ext_v in self.extensions.items():
+            parts.extend([ext_k, ext_v])
+        return " ".join(parts)
+
+    def to_signaling_dict(self) -> dict[str, str | int]:
+        """Convert to Roborock camera signaling dictionary format."""
+        return {
+            "candidate": self.to_sdp(),
+            "sdpMid": self.sdp_mid if self.sdp_mid is not None else "0",
+            "sdpMLineIndex": self.sdp_mline_index if self.sdp_mline_index is not None else 0,
+        }
+
+    def __str__(self) -> str:
+        """Return the SDP candidate string."""
+        return self.to_sdp()
+
+
+@dataclass
+class CameraSdpDescription(RoborockBase):
+    """WebRTC session description exchanged during camera signaling."""
+
+    sdp: str
+    type: str