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
+        )