Add missing docstrings to classes

Author: will-fawcett

src/eve_api/client.py

@@ -39,6 +39,7 @@ class EVEClient:
     """
 
     _DEFAULT_TIMEOUT = 30.0
+    _SSE_DONE_SENTINEL = "[DONE]"
 
     def __init__(
         self,
@@ -260,9 +261,7 @@ async def stream(
                 if not line or not line.startswith("data: "):
                     continue
 
-                if (  # pylint: disable=magic-value-comparison
-                    data_str := line[6:]
-                ) == "[DONE]":
+                if (data_str := line[6:]) == self._SSE_DONE_SENTINEL:
                     return
 
                 try:

tests/test_client.py

@@ -21,22 +21,30 @@
 
 
 class StatusEvent(TypedDict):
+    """SSE event emitted while the server is still working."""
+
     type: Literal["status"]
     content: str
 
 
 class TokenEvent(TypedDict):
+    """SSE event carrying an incremental token of the streamed response."""
+
     type: Literal["token"]
     content: str
 
 
 class FinalEvent(TypedDict):
+    """SSE event marking the final, complete response."""
+
     type: Literal["final"]
     content: str
     message_id: str
 
 
 class ErrorEvent(TypedDict):
+    """SSE event indicating the stream terminated with an error."""
+
     type: Literal["error"]
     content: str