feat: headings and instant messaging api

Author: New-dev0

docs/docusaurus.config.js

@@ -37,23 +37,18 @@ const config = {
       ({
         docs: {
           sidebarPath: require.resolve('./sidebars.js'),
-          // Please change this to your repo.
-          // Remove this to remove the "edit this page" links.
-          // editUrl:
-          //   'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
         },
-        // blog: {
-        //   showReadingTime: true,
-        //   // Please change this to your repo.
-        //   // Remove this to remove the "edit this page" links.
-        //   // editUrl:
-        //   //   'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
-        // },
         theme: {
           customCss: [
             require.resolve('./src/css/custom.css'),
           ],
         },
+        sitemap: {
+          changefreq: 'weekly',
+          priority: 0.5,
+          ignorePatterns: ['/tags/**'],
+          filename: 'sitemap.xml',
+        },
       }),
     ],
   ],
@@ -166,6 +161,16 @@ const config = {
         insights: true
       }
     }),
+
+  headTags: [
+    {
+      tagName: 'meta',
+      attributes: {
+        name: 'google-site-verification',
+        content: 'yC1cNX1v5yzD_O87LDsebxnxy7KTEoe4-WE3OTQ6q80'
+      }
+    }
+  ],
 };
 
 module.exports = config;

docs/package.json

@@ -16,6 +16,7 @@
   "dependencies": {
     "@docusaurus/core": "^3.1.0",
     "@docusaurus/preset-classic": "^3.1.0",
+    "@docusaurus/plugin-sitemap": "^3.1.0",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^1.2.1",
     "prism-react-renderer": "^1.3.5",

swibots/api/chat/controllers/heading_controller.py

@@ -91,4 +91,15 @@ async def rearrange_headings(self,
         }
         response = await self.client.post("/headings/rearrange-headings",
                                           data=body)
-        
+        return response.data
+
+    async def move_heading_content(self, request_dto: dict):
+        """
+        Move content from one heading to another
+        
+        :param request_dto: Dictionary containing move heading content details
+        :return: Response data from the API
+        """
+        response = await self.client.post("/headings/move-heading-content", 
+                                        data=request_dto)
+        return response.data

swibots/api/chat/methods/__init__.py

@@ -24,6 +24,7 @@
 from .upload_media import UploadMedia
 from .sticker_methods import StickerMethods
 from .organization_methods import OrganizationMethods
+from .heading_methods import HeadingMethods
 
 
 class ChatMethods(
@@ -52,5 +53,6 @@ class ChatMethods(
     GetUser,
     StickerMethods,
     OrganizationMethods,
+    HeadingMethods,
 ):
     pass

swibots/api/chat/methods/heading_methods.py

@@ -66,3 +66,47 @@ async def edit_heading(
         return await self.chat_service.headings.edit_heading(
             community_id, heading_name, new_heading_name, heading_type
         )
+
+    async def rearrange_headings(
+        self: "swibots.ApiClient",
+        community_id: str,
+        heading_names: List[str],
+        subheading: str = ''
+    ):
+        """
+        Rearrange headings in a community
+
+        :param community_id: The ID of the community
+        :param heading_names: List of heading names in the desired order
+        :param subheading: Optional subheading name
+        """
+        return await self.chat_service.headings.rearrange_headings(
+            community_id, heading_names, subheading
+        )
+
+    async def move_heading_content(
+        self,
+        community_id: str,
+        heading_for: Literal["GROUP", "CHANNEL", "STORE", "WIDGET"],
+        heading_type: Literal["BLANK", "VALUE"],
+        type_id: str,
+        updated_heading: str
+    ):
+        """
+        Move content from one heading to another
+
+        :param community_id: The ID of the community
+        :param heading_for: The type of content being moved
+        :param heading_type: The type of heading
+        :param type_id: The ID of the content being moved
+        :param updated_heading: The name of the heading to move content to
+        """
+        move_dto = {
+            "communityId": community_id,
+            "headingFor": heading_for,
+            "headingType": heading_type,
+            "typeId": type_id,
+            "updatedHeading": updated_heading
+        }
+        request_dto = {"moveHeadingContentDto": [move_dto]}
+        return await self.chat_service.headings.move_heading_content(request_dto)

swibots/api/community/community_client.py

@@ -18,6 +18,7 @@
     RoleMemberController,
     RestrictController,
     BanController,
+    InstantMessagingController,
     QuestsController,
 )
 
@@ -45,6 +46,7 @@ def __init__(
         self._restrict = None
         self._ws: SwitchWSAsyncClient = None
         self._started = False
+        self._instant_messaging = None
 
     @property
     def quests(self) -> QuestsController:
@@ -59,6 +61,12 @@ def channels(self) -> ChannelController:
             self._channels = ChannelController(self)
         return self._channels
 
+    @property
+    def instant_messaging(self) -> InstantMessagingController:
+        if self._instant_messaging is None:
+            self._instant_messaging = InstantMessagingController(self)
+        return self._instant_messaging
+
     @property
     def groups(self) -> GroupController:
         """Get the channels controller"""

swibots/api/community/controllers/__init__.py

@@ -7,3 +7,4 @@
 from .restrict_controller import *
 from .ban_controller import *
 from .quest_controller import *
+from .messaging_controller import InstantMessagingController

swibots/api/community/controllers/messaging_controller.py

@@ -0,0 +1,41 @@
+import logging
+from typing import TYPE_CHECKING, List
+from swibots.api.community.models import InstantMessaging
+
+if TYPE_CHECKING:
+    from swibots.api.community import CommunityClient
+
+log = logging.getLogger(__name__)
+
+BASE_PATH = "/v1/community/instant/messaging"
+
+
+class InstantMessagingController:
+    def __init__(self, client: "CommunityClient"):
+        self.client = client
+
+    async def enable_messages(
+        self, community_id: str, group_id: str, bot_id: str | int = None
+    ) -> InstantMessaging:
+        if not bot_id:
+            bot_id = self.client.user.id
+        response = await self.client.get(
+            f"{BASE_PATH}/enable",
+            data={"communityId": community_id, "groupId": group_id, "botId": bot_id},
+        )
+        return self.client.build_object(InstantMessaging, response.data.get("result"))
+
+    async def disable_messages(
+        self, community_id: str, group_id: str, bot_id: str | int = None
+    ) -> InstantMessaging:
+        if not bot_id:
+            bot_id = self.client.user.id
+        response = await self.client.get(
+            f"{BASE_PATH}/disable",
+            data={"communityId": community_id, "groupId": group_id, "botId": bot_id},
+        )
+        return self.client.build_object(InstantMessaging, response.data.get("result"))
+
+    async def get_messaging_enabled(self, community_id: str, group_id: str) -> List[InstantMessaging]:
+        resp = await self.client.get(f"{BASE_PATH}/bots?communityId={community_id}&groupId={group_id}")
+        return self.client.build_list(InstantMessaging, resp.data.get("result"))

swibots/api/community/methods/__init__.py

@@ -8,6 +8,7 @@
 from .community_methods import CommunityMethods
 from .restrict_user import RestrictUser
 from .deduct_xp import DeductXP
+from .instant_messaging import InstantMessagingMethods
 from .quest_methods import QuestsMethods
 
 
@@ -23,5 +24,6 @@ class CommunityMethods(
     RestrictUser,
     DeductXP,
     QuestsMethods,
+    InstantMessagingMethods,
 ):
     pass

swibots/api/community/methods/instant_messaging.py

@@ -0,0 +1,36 @@
+import swibots
+from typing import Optional
+
+from swibots.api.community.models import InstantMessaging
+
+
+class InstantMessagingMethods:
+    async def enable_messages(
+        self: "swibots.ApiClient",
+        community_id: str,
+        group_id: str,
+        bot_id: Optional[str] = None,
+    ) -> InstantMessaging:
+        """Enable messaging in group"""
+        return await self.community_service.instant_messaging.enable_messages(
+            community_id, group_id, bot_id
+        )
+
+    async def disable_messages(
+        self: "swibots.ApiClient",
+        community_id: str,
+        group_id: str,
+        bot_id: Optional[str] = None,
+    ) -> InstantMessaging:
+        """Disable messaging in group"""
+        return await self.community_service.instant_messaging.disable_messages(
+            community_id, group_id, bot_id
+        )
+
+    async def get_messaging_enabled(
+        self: "swibots.ApiClient", community_id: str, group_id: str
+    ) -> InstantMessaging:
+        """Get bot with messaging enable in the community"""
+        return await self.community_service.instant_messaging.get_messaging_enabled(
+            community_id, group_id
+        )

swibots/api/community/models/channel.py

@@ -25,6 +25,8 @@ def __init__(
         link: Optional[str] = None,
         muted: Optional[bool] = None,
         bot_id: Optional[str] = None,
+        mini_app_link: Optional[str] = None,
+        linked_group_id: Optional[str] = None,
     ):
         super().__init__(app)
         self.id = id
@@ -46,6 +48,8 @@ def __init__(
         self.link_based = bool(self.link)
         self.muted = muted
         self.bot_id = bot_id
+        self.mini_app_link = mini_app_link
+        self.linked_group_id = linked_group_id
 
     def to_json(self) -> JSONDict:
         return {
@@ -68,6 +72,8 @@ def to_json(self) -> JSONDict:
             "twitterUsername": self.twitter,
             "muted": self.muted,
             "linkBased": self.link_based,
+            "miniAppLink": self.mini_app_link,
+            "linkedGroupId": self.linked_group_id,
         }
 
     def from_json(self, data: JSONDict) -> "Channel":
@@ -90,4 +96,7 @@ def from_json(self, data: JSONDict) -> "Channel":
             self.muted = data.get("muted")
             self.is_twitter = data.get("isTwitter")
             self.twitter = data.get("twitterUsername")
+            self.mini_app_link = data.get("miniAppLink")
+            self.linked_group_id = data.get("linkedGroupId")
         return self
+

swibots/api/community/models/community.py

@@ -31,6 +31,7 @@ def __init__(
         channels_count: Optional[int] = None,
         default_channel: Optional[Channel] = None,
         visible: Optional[bool] = True,
+        ai_data: Optional[dict] = None,
     ):
         super().__init__(app)
         self.id = id
@@ -54,6 +55,7 @@ def __init__(
         self.channels_count = channels_count
         self.default_channel = default_channel
         self.visible = visible
+        self.ai_data = ai_data
 
     def to_json(self) -> JSONDict:
         return {
@@ -80,6 +82,7 @@ def to_json(self) -> JSONDict:
             "defaultChannel": (
                 self.default_channel.to_json() if self.default_channel else None
             ),
+            "aiData": self.ai_data,
         }
 
     def from_json(self, data: Optional[JSONDict]) -> Optional["Community"]:
@@ -104,6 +107,7 @@ def from_json(self, data: Optional[JSONDict]) -> Optional["Community"]:
             self.link = data.get("link")
             self.icon = data.get("icon")
             self.visible = data.get("visible")
+            self.ai_data = data.get("aiData")
 
             if data.get("defaultChannel"):
                 self.default_channel = Channel().from_json(data.get("defaultChannel"))

swibots/api/community/models/group.py

@@ -21,6 +21,7 @@ def __init__(
         allowed_content: Optional[str] = None,
         created_at: Optional[str] = None,
         updated_at: Optional[str] = None,
+        is_linked_chat: Optional[bool] = None,
     ):
         super().__init__(app)
         self.id = id
@@ -36,6 +37,7 @@ def __init__(
         self.allowed_content = allowed_content
         self.created_at = created_at
         self.updated_at = updated_at
+        self.is_linked_chat = is_linked_chat
 
     def to_json(self) -> JSONDict:
         return {
@@ -52,6 +54,7 @@ def to_json(self) -> JSONDict:
             "allowedContent": self.allowed_content,
             "createdAt": self.created_at,
             "updatedAt": self.updated_at,
+            "linkedChat": self.is_linked_chat,
         }
 
     def from_json(self, data: JSONDict) -> "Group":
@@ -69,6 +72,7 @@ def from_json(self, data: JSONDict) -> "Group":
             self.allowed_content = data.get("allowedContent")
             self.created_at = data.get("createdAt")
             self.updated_at = data.get("updatedAt")
+            self.is_linked_chat = data.get("linkedChat")
         return self
 
     async def m_enabled(self) -> bool: