(20250117) Major revamping in the mail module. Everything revamped. Sending is a pending task.

controllers_v2/message/sms/base.py

@@ -61,6 +61,9 @@ from typing import List, Any
 # To make HTTP requests:
 import httpx
 
+# to work with MongoDB:
+from bson.objectid import ObjectId
+
 # To make abstract classes:
 from abc import ABC, abstractmethod
 
@@ -197,6 +200,39 @@ class SMSController(CoreMessageController, ABC):
 
         pass
 
+    # ┏┓┳┳┓┏┓  ┳┳   ┓   •
+    # ┗┓┃┃┃┗┓  ┃┃┏┓┏┫┏┓╋┓┏┓┏┓
+    # ┗┛┛ ┗┗┛  ┗┛┣┛┗┻┗┻┗┗┛┗┗┫
+    #            ┛          ┛
+
+    # We cannot modify the SMS messages themselves, but we can set/unset tags on them for internal referencing and
+    # filtering. This will help the users organize their inboxes well.
+
+    async def update_sms_tags(
+            self,
+            mongo_data_conn: AsyncMongo,
+            message_id: ObjectId | str,
+            unset_tags: List[str] = None,
+            set_tags: List[str] = None
+    ) -> bool:
+
+        """
+        To set and unset tags on an SMS message.
+        :param mongo_data_conn: The database connection to use to perform this action.
+        :param message_id: The ObjectId of the document in MongoDb that holds the message.
+        :param unset_tags: The list of tags to unset (done before setting new tags).
+        :param set_tags: The list of tags to set (done after unsetting old tags).
+        :return: True if successful, else False.
+        """
+
+        # Simply call the core model:
+        return await self.update_message_tags(
+            mongo_data_conn = mongo_data_conn,
+            message_id = message_id,
+            unset_tags = unset_tags,
+            set_tags = set_tags
+        )
+
 
 #   *****************************************************************************************************************
 #  *****                                                                                                          ****