sockudo-http-python 2.0.0__tar.gz → 2.1.0__tar.gz

{sockudo_http_python-2.0.0/src/sockudo_http_python.egg-info → sockudo_http_python-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sockudo-http-python
-Version: 2.0.0
+Version: 2.1.0
 Summary: High-performance Python HTTP server SDK for Sockudo
 Author: Sockudo
 License-Expression: MIT
@@ -46,14 +46,7 @@ For apps, install the published package:
 pip install sockudo-http-python
 ```
 
-For local monorepo development, install from the local path:
-
-```bash
-git clone https://github.com/sockudo/sockudo.git
-pip install -e sockudo/server-sdks/sockudo-http-python
-```
-
-For local development from this monorepo:
+For contributors working inside this repository:
 
 ```bash
 pip install -e server-sdks/sockudo-http-python[dev]

{sockudo_http_python-2.0.0 → sockudo_http_python-2.1.0}/README.md

@@ -24,14 +24,7 @@ For apps, install the published package:
 pip install sockudo-http-python
 ```
 
-For local monorepo development, install from the local path:
-
-```bash
-git clone https://github.com/sockudo/sockudo.git
-pip install -e sockudo/server-sdks/sockudo-http-python
-```
-
-For local development from this monorepo:
+For contributors working inside this repository:
 
 ```bash
 pip install -e server-sdks/sockudo-http-python[dev]

{sockudo_http_python-2.0.0 → sockudo_http_python-2.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sockudo-http-python"
-version = "2.0.0"
+version = "2.1.0"
 description = "High-performance Python HTTP server SDK for Sockudo"
 readme = "README.md"
 requires-python = ">=3.9"

{sockudo_http_python-2.0.0 → sockudo_http_python-2.1.0}/src/sockudo_http_python/client.py

@@ -387,6 +387,19 @@ class WebhookEvent:
     data: Optional[Any] = None
     socket_id: Optional[str] = None
     user_id: Optional[str] = None
+    raw: Mapping[str, Any] = field(default_factory=dict)
+
+    @staticmethod
+    def from_payload(payload: Mapping[str, Any]) -> "WebhookEvent":
+        return WebhookEvent(
+            name=_optional_string(payload.get("name")) or "",
+            channel=_optional_string(payload.get("channel")),
+            event=_optional_string(payload.get("event")),
+            data=payload.get("data"),
+            socket_id=_optional_string(payload.get("socket_id")),
+            user_id=_optional_string(payload.get("user_id")),
+            raw=dict(payload),
+        )
 
 
 @dataclass(frozen=True)
@@ -398,7 +411,11 @@ class Webhook:
     def parse(body: Union[str, bytes]) -> "Webhook":
         text = body.decode("utf-8") if isinstance(body, bytes) else body
         raw = json.loads(text)
-        events = tuple(WebhookEvent(**event) for event in raw.get("events", []))
+        events = tuple(
+            WebhookEvent.from_payload(event)
+            for event in raw.get("events", [])
+            if isinstance(event, Mapping)
+        )
         return Webhook(time_ms=raw.get("time_ms"), events=events)
 
 
@@ -702,13 +719,16 @@ class _BaseSockudo:
             nacl_exceptions.CryptoError,
         ) as exc:
             raise SockudoError("Failed to decrypt encrypted webhook event") from exc
+        raw = dict(event.raw)
+        raw["data"] = plaintext.decode("utf-8")
         return WebhookEvent(
             name=event.name,
             channel=event.channel,
             event=event.event,
-            data=plaintext.decode("utf-8"),
+            data=raw["data"],
             socket_id=event.socket_id,
             user_id=event.user_id,
+            raw=raw,
         )
 
     def _serialize(self, payload: Mapping[str, Any]) -> str:
@@ -1744,6 +1764,10 @@ def _clean_raw(values: Mapping[str, Any]) -> JsonDict:
     return {key: value for key, value in values.items() if value is not None}
 
 
+def _optional_string(value: Any) -> Optional[str]:
+    return value if isinstance(value, str) else None
+
+
 def _clean_query(values: Mapping[str, Any]) -> Dict[str, str]:
     return {key: str(value) for key, value in values.items() if value is not None}
 

{sockudo_http_python-2.0.0 → sockudo_http_python-2.1.0/src/sockudo_http_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sockudo-http-python
-Version: 2.0.0
+Version: 2.1.0
 Summary: High-performance Python HTTP server SDK for Sockudo
 Author: Sockudo
 License-Expression: MIT
@@ -46,14 +46,7 @@ For apps, install the published package:
 pip install sockudo-http-python
 ```
 
-For local monorepo development, install from the local path:
-
-```bash
-git clone https://github.com/sockudo/sockudo.git
-pip install -e sockudo/server-sdks/sockudo-http-python
-```
-
-For local development from this monorepo:
+For contributors working inside this repository:
 
 ```bash
 pip install -e server-sdks/sockudo-http-python[dev]

{sockudo_http_python-2.0.0 → sockudo_http_python-2.1.0}/tests/test_client.py

@@ -1,6 +1,7 @@
 import json
 import base64
 import hashlib
+from pathlib import Path
 from urllib.parse import parse_qs, urlparse
 
 import httpx
@@ -23,6 +24,7 @@ from sockudo_http_python import (
     Status,
     TriggerOptions,
     Validity,
+    Webhook,
     sign,
 )
 
@@ -42,6 +44,16 @@ def make_client(handler):
     )
 
 
+def load_forward_fixture(name):
+    for parent in Path(__file__).resolve().parents:
+        candidate = (
+            parent / "tests" / "ai-conformance" / "fixtures" / "forward-compat" / name
+        )
+        if candidate.exists():
+            return candidate.read_text(encoding="utf-8")
+    raise AssertionError(f"forward-compat fixture not found: {name}")
+
+
 def test_signed_uri_contains_expected_signature_params():
     sockudo = Sockudo(
         "app-id", "key", "secret", options=SockudoOptions(host="localhost", port=6001)
@@ -60,6 +72,65 @@ def test_signed_uri_contains_expected_signature_params():
     sockudo.close()
 
 
+def test_webhook_accepts_future_event_fixture_and_preserves_unknown_fields():
+    body = load_forward_fixture("future-webhook-events.json")
+    sockudo = Sockudo(
+        "app-id", "app-key", "app-secret", options=SockudoOptions(max_retries=1)
+    )
+
+    webhook = sockudo.parse_webhook("app-key", sign(body, "app-secret"), body)
+
+    assert webhook.time_ms == 1710000000000
+    assert [event.name for event in webhook.events] == [
+        "member_updated",
+        "ai_turn_started",
+        "message_version_created",
+    ]
+    assert webhook.events[0].channel == "presence-ai-forward"
+    assert webhook.events[0].user_id == "user-1"
+    assert webhook.events[0].raw["future_field"] == "must-pass-through"
+    assert webhook.events[1].raw["turn_id"] == "turn-1"
+    assert Webhook.parse(body).events[2].raw["version_serial"] == "ver-1"
+    sockudo.close()
+
+
+def test_webhook_preserves_nested_future_event_values():
+    body = json.dumps(
+        {
+            "time_ms": 1710000000000,
+            "events": [
+                {
+                    "name": "ai_turn_started",
+                    "channel": "private-ai-forward",
+                    "data": {
+                        "turn_id": "turn-1",
+                        "tokens": ["hello", "world"],
+                        "done": False,
+                        "nullable": None,
+                    },
+                    "future_field": {"nested": True},
+                }
+            ],
+        },
+        separators=(",", ":"),
+    )
+    sockudo = Sockudo(
+        "app-id", "app-key", "app-secret", options=SockudoOptions(max_retries=1)
+    )
+
+    webhook = sockudo.parse_webhook("app-key", sign(body, "app-secret"), body)
+
+    assert webhook.events[0].name == "ai_turn_started"
+    assert webhook.events[0].data == {
+        "turn_id": "turn-1",
+        "tokens": ["hello", "world"],
+        "done": False,
+        "nullable": None,
+    }
+    assert webhook.events[0].raw["future_field"] == {"nested": True}
+    sockudo.close()
+
+
 def test_signed_uri_signs_lowercase_query_keys_but_keeps_original_request_keys():
     sockudo = Sockudo(
         "app-id", "key", "secret", options=SockudoOptions(host="localhost", port=6001)