api_types: Update Stream and Subscription typeddict fields.

This commit updates the `date_created` and
`stream_post_policy` fields present in the Stream typeddict,
and the `role` field in the Subscription typeddict.

For `date_created`, since servers with ZFL<30 do not include
the field, but ZT does add it with a value of None to ensure
consistency, the type is changed to
`NotRequired[Optional[int]]`.

For `stream_post_policy`, the field is only included after
Zulip 3.0 / ZFL 1, so it has been changed to a NotRequired
field.

For `role`, the field has been removed in Zulip 6.0 (ZFL 133),
so it has been removed from the Subscriptions typeddict and
also from the unsubscribed_streams_fixture.

Author: theViz343

tests/conftest.py

@@ -370,7 +370,6 @@ def unsubscribed_streams_fixture() -> List[Subscription]:
                 "stream_post_policy": 0,
                 "is_web_public": True,
                 "first_message_id": None,
-                "role": 1,
             }
         )
     return deepcopy(unsubscribed_streams)

zulipterminal/api_types.py

@@ -216,12 +216,18 @@ class Stream(TypedDict):
     name: str
     description: str
     rendered_description: str
-    date_created: int  # NOTE: new in Zulip 4.0 / ZFL 30
+
+    # NOTE: Server data may not contain this field, in which case ZT adds it
+    # and sets it to None.
+    date_created: NotRequired[Optional[int]]
+
     invite_only: bool
     subscribers: List[int]
 
     is_announcement_only: bool  # Deprecated in Zulip 3.0 -> stream_post_policy
-    stream_post_policy: int  # NOTE: new in Zulip 3.0 / ZFL 1
+
+    # NOTE: new in Zulip 3.0 / ZFL 1, server versions < 3.0 may not contain this field
+    stream_post_policy: NotRequired[int]
 
     is_web_public: bool
     message_retention_days: Optional[int]  # NOTE: new in Zulip 3.0 / ZFL 17
@@ -241,11 +247,11 @@ class Subscription(Stream):
 
     is_muted: bool
 
-    role: int  # NOTE: new in Zulip 4.0 / ZFL 31
     color: str
 
     # Deprecated fields
     # in_home_view: bool  # Replaced by is_muted in Zulip 2.1; still present in updates
+    # role: int  # Removed in Zulip 6.0 / ZFL 133; not actively used by ZT or Zulip web
 
 
 ###############################################################################