matter-python-client 0.7.0a0.dev20260512__tar.gz → 0.7.0a0.dev20260516__tar.gz

{matter_python_client-0.7.0a0.dev20260512 → matter_python_client-0.7.0a0.dev20260516}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matter-python-client
-Version: 0.7.0a0.dev20260512
+Version: 0.7.0a0.dev20260516
 Summary: Python Client for the OHF Matter Server
 Author-email: Open Home Foundation <hello@openhomefoundation.io>
 License-Expression: Apache-2.0

{matter_python_client-0.7.0a0.dev20260512 → matter_python_client-0.7.0a0.dev20260516}/matter_python_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: matter-python-client
-Version: 0.7.0a0.dev20260512
+Version: 0.7.0a0.dev20260516
 Summary: Python Client for the OHF Matter Server
 Author-email: Open Home Foundation <hello@openhomefoundation.io>
 License-Expression: Apache-2.0

{matter_python_client-0.7.0a0.dev20260512 → matter_python_client-0.7.0a0.dev20260516}/matter_python_client.egg-info/SOURCES.txt

@@ -177,4 +177,5 @@ matter_server/common/helpers/json.py
 matter_server/common/helpers/util.py
 tests/test_client_integration.py
 tests/test_imports.py
-tests/test_integration.py
+tests/test_integration.py
+tests/test_webrtc_protocol.py

{matter_python_client-0.7.0a0.dev20260512 → matter_python_client-0.7.0a0.dev20260516}/matter_server/client/client.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import asyncio
 import logging
-from typing import TYPE_CHECKING, Any, Final, Self, cast
+from typing import TYPE_CHECKING, Any, Final, Literal, Self, cast
 import uuid
 
 from chip.clusters import Objects as Clusters
@@ -547,6 +547,27 @@ class MatterClient:
             require_schema=10,
         )
 
+    async def send_webrtc_provider_command(
+        self,
+        node_id: int,
+        endpoint_id: int,
+        command_name: Literal["ProvideOffer", "SolicitOffer"],
+        payload: dict,
+    ) -> dict[str, Any]:
+        """Invoke a WebRTCTransportProvider command on a commissioned camera.
+
+        The server hard-codes the cluster id (0x0553) and injects
+        originatingEndpointId — payload should omit both.
+        """
+        response = await self.send_command(
+            APICommand.SEND_WEBRTC_PROVIDER_COMMAND,
+            node_id=node_id,
+            endpoint_id=endpoint_id,
+            command_name=command_name,
+            payload=payload,
+        )
+        return cast(dict[str, Any], response)
+
     def _prepare_message(
         self,
         command: str,

{matter_python_client-0.7.0a0.dev20260512 → matter_python_client-0.7.0a0.dev20260516}/matter_server/common/models.py

@@ -6,7 +6,7 @@ from collections.abc import Callable
 from dataclasses import dataclass, field
 from datetime import datetime  # noqa: TC003
 from enum import Enum
-from typing import Any
+from typing import Any, Literal
 
 # Enums and constants
 
@@ -23,6 +23,7 @@ class EventType(Enum):
     SERVER_INFO_UPDATED = "server_info_updated"
     ENDPOINT_ADDED = "endpoint_added"
     ENDPOINT_REMOVED = "endpoint_removed"
+    WEBRTC_CALLBACK = "webrtc_callback"
 
 
 class APICommand(str, Enum):
@@ -55,6 +56,7 @@ class APICommand(str, Enum):
     SET_DEFAULT_FABRIC_LABEL = "set_default_fabric_label"
     SET_ACL_ENTRY = "set_acl_entry"
     SET_NODE_BINDING = "set_node_binding"
+    SEND_WEBRTC_PROVIDER_COMMAND = "send_webrtc_provider_command"
 
 
 EventCallBackType = Callable[[EventType, Any], None]
@@ -109,6 +111,37 @@ class MatterNodeEvent:
     data: dict[str, Any] | None
 
 
+WebRTCEventType = Literal["offer", "answer", "ice_candidates", "end"]
+
+
+@dataclass
+class WebRTCIceCandidate:
+    """ICE candidate carried inside a webrtc_callback.ice_candidates event."""
+
+    candidate: str
+    sdpMid: str | None = None
+    sdpMLineIndex: int | None = None
+
+
+@dataclass
+class WebRTCCallbackData:
+    """Payload of a webrtc_callback event.
+
+    `data` shape varies by event_type:
+      - "offer": {"sdp": str, "ice_servers": list | None, "ice_transport_policy": str | None}
+      - "answer": {"sdp": str}
+      - "ice_candidates": {"ice_candidates": list[WebRTCIceCandidate]}
+      - "end": {"reason": int}
+    """
+
+    event_type: WebRTCEventType
+    webrtc_session_id: int
+    node_id: int
+    endpoint_id: int
+    fabric_index: int
+    data: dict | None
+
+
 @dataclass
 class ServerDiagnostics:
     """Full dump of the server information and data."""

{matter_python_client-0.7.0a0.dev20260512 → matter_python_client-0.7.0a0.dev20260516}/pyproject.toml

@@ -25,7 +25,7 @@ license = "Apache-2.0"
 name = "matter-python-client"
 readme = "README.md"
 requires-python = ">=3.12"
-version = "0.7.0a0.dev20260512"
+version = "0.7.0a0.dev20260516"
 
 [project.urls]
 Homepage = "https://github.com/matter-js/matterjs-server"

matter_python_client-0.7.0a0.dev20260516/tests/test_webrtc_protocol.py

@@ -0,0 +1,36 @@
+"""Tests for the WebRTC additions to the websocket protocol model."""
+
+from matter_server.common.models import (
+    APICommand,
+    EventType,
+    WebRTCCallbackData,
+    WebRTCIceCandidate,
+)
+
+
+def test_event_type_webrtc_callback_value():
+    assert EventType.WEBRTC_CALLBACK.value == "webrtc_callback"
+
+
+def test_api_command_send_webrtc_provider_command_value():
+    assert APICommand.SEND_WEBRTC_PROVIDER_COMMAND.value == "send_webrtc_provider_command"
+
+
+def test_webrtc_callback_data_roundtrip():
+    payload = WebRTCCallbackData(
+        event_type="answer",
+        webrtc_session_id=5,
+        node_id=100,
+        endpoint_id=2,
+        fabric_index=1,
+        data={"sdp": "v=0"},
+    )
+    assert payload.event_type == "answer"
+    assert payload.webrtc_session_id == 5
+    assert payload.data == {"sdp": "v=0"}
+
+
+def test_webrtc_ice_candidate_optional_fields():
+    c = WebRTCIceCandidate(candidate="candidate:foo")
+    assert c.sdpMid is None
+    assert c.sdpMLineIndex is None