Add users_shared and chat_shared filters

Fix documentation of filters.media

Author: SpEcHiDe

docs/source/releases/changes-in-this-fork.rst

@@ -12,6 +12,7 @@ it can take advantage of new goodies!
 | Scheme layer used: 177 |
 +------------------------+
 
+- Added ``filters.users_shared`` and ``filters.chat_shared``.
 - Added the field ``origin`` of type :obj:`~pyrogram.types.MessageOrigin`` in the class :obj:`~pyrogram.types.ExternalReplyInfo`.
 - Added the class :obj:`~pyrogram.types.MessageOrigin` and replaced the fields ``forward_from``, ``forward_from_chat``, ``forward_from_message_id``, ``forward_signature``, ``forward_sender_name``, and ``forward_date`` with the field ``forward_origin`` of type :obj:`~pyrogram.types.MessageOrigin`` in the class :obj:`~pyrogram.types.Message`.
 - Added ``accent_color``, ``profile_color``, ``emoji_status``, ``is_close_friend`` to :obj:`~pyrogram.types.Chat` and :obj:`~pyrogram.types.User`.

pyrogram/filters.py

@@ -774,8 +774,7 @@ async def media_filter(_, __, m: Message) -> bool:
 media: Filter = create(media_filter)
 """Filter media messages.
 
-A media message contains any of the following fields set: *audio*, *document*, *photo*, *sticker*, *video*,
-*animation*, *voice*, *video_note*, *contact*, *location*, *venue*, *poll*.
+A media message contains any of the following fields set: *animation*, *audio*, *contact*, *dice*, *document*, *game*, *giveaway*, *giveaway_winners*, *location*, *photo*, *poll*, *sticker*, *story*, *venue*, *video*, *video_note*, *voice*, *web_page*.
 """
 
 
@@ -1057,3 +1056,27 @@ async def __call__(self, _, message: Message) -> bool:
                 and not message.outgoing
             )
         )
+
+
+# region chat_shared filter
+
+chat_shared: Filter = create(
+    lambda _, __, m: (
+        bool(m.chat_shared)
+    )
+)
+"""Filter service messages for chat shared."""
+
+# endregion
+
+
+# region users_shared filter
+
+users_shared: Filter = create(
+    lambda _, __, m: (
+        bool(m.users_shared)
+    )
+)
+"""Filter service messages for chat shared."""
+
+# endregion