wappa 0.1.9__py3-none-any.whl → 0.1.10__py3-none-any.whl

wappa/cli/examples/wappa_full_example/app/handlers/command_handlers.py

@@ -6,10 +6,12 @@ that demonstrate interactive features and specialized messaging capabilities.
 """
 
 import time
-from typing import Dict
 
+from wappa.messaging.whatsapp.models.interactive_models import (
+    InteractiveHeader,
+    ReplyButton,
+)
 from wappa.webhooks import IncomingMessageWebhook
-from wappa.messaging.whatsapp.models.interactive_models import ReplyButton, InteractiveHeader
 
 from ..models.state_models import ButtonState, ListState, StateType
 from ..models.user_models import UserProfile
@@ -18,11 +20,11 @@ from ..utils.cache_utils import CacheHelper
 
 class CommandHandlers:
     """Collection of handlers for special commands."""
-    
+
     def __init__(self, messenger, cache_factory, logger):
         """
         Initialize command handlers.
-        
+
         Args:
             messenger: IMessenger instance for sending messages
             cache_factory: Cache factory for data persistence
@@ -31,56 +33,59 @@ class CommandHandlers:
         self.messenger = messenger
         self.cache_helper = CacheHelper(cache_factory)
         self.logger = logger
-    
-    async def handle_button_command(self, webhook: IncomingMessageWebhook, 
-                                   user_profile: UserProfile) -> Dict[str, any]:
+
+    async def handle_button_command(
+        self, webhook: IncomingMessageWebhook, user_profile: UserProfile
+    ) -> dict[str, any]:
         """
         Handle /button command - creates interactive button message.
-        
+
         Args:
             webhook: IncomingMessageWebhook with command
             user_profile: User profile for tracking
-            
+
         Returns:
             Result dictionary with operation status
         """
         try:
             start_time = time.time()
-            
+
             user_id = webhook.user.user_id
             message_id = webhook.message.message_id
-            
+
             self.logger.info(f"🔘 Processing /button command from {user_id}")
-            
+
             # Clean up any existing button state
-            existing_state = await self.cache_helper.get_user_state(user_id, StateType.BUTTON)
+            existing_state = await self.cache_helper.get_user_state(
+                user_id, StateType.BUTTON
+            )
             if existing_state:
                 await self.cache_helper.remove_user_state(user_id, StateType.BUTTON)
-            
+
             # Create button data for state storage (as dictionaries)
             button_data = [
                 {"id": "kitty", "title": "🐱 Kitty"},
-                {"id": "puppy", "title": "🐶 Puppy"}
+                {"id": "puppy", "title": "🐶 Puppy"},
             ]
-            
+
             # Create button objects for WhatsApp messenger
             buttons = [
                 ReplyButton(id="kitty", title="🐱 Kitty"),
-                ReplyButton(id="puppy", title="🐶 Puppy")
+                ReplyButton(id="puppy", title="🐶 Puppy"),
             ]
-            
+
             # Create button state with 10 minute TTL (using dictionaries)
             button_state = ButtonState.create_button_state(
                 user_id=user_id,
                 buttons=button_data,
                 message_text="Choose your favorite animal! You have 10 minutes to decide.",
                 ttl_seconds=600,  # 10 minutes
-                original_message_id=message_id
+                original_message_id=message_id,
             )
-            
+
             # Save the state
             await self.cache_helper.save_user_state(button_state)
-            
+
             # Send button message
             button_result = await self.messenger.send_button_message(
                 buttons=buttons,
@@ -88,18 +93,20 @@ class CommandHandlers:
                 body="🎯 *Button Demo Activated!*\n\nChoose your favorite animal below. You have 10 minutes to make your selection, or the state will expire automatically.",
                 header=InteractiveHeader(type="text", text="Interactive Button Demo"),
                 footer="⏰ Expires in 10 minutes",
-                reply_to_message_id=message_id
+                reply_to_message_id=message_id,
             )
-            
+
             if not button_result.success:
-                self.logger.error(f"Failed to send button message: {button_result.error}")
+                self.logger.error(
+                    f"Failed to send button message: {button_result.error}"
+                )
                 await self.cache_helper.remove_user_state(user_id, StateType.BUTTON)
                 return {"success": False, "error": "Failed to send button message"}
-            
+
             # Update button state with message ID
             button_state.interactive_message_id = button_result.message_id
             await self.cache_helper.save_user_state(button_state)
-            
+
             # Send instruction message
             instruction_text = (
                 "📋 *How to use this demo:*\n\n"
@@ -110,56 +117,56 @@ class CommandHandlers:
                 "5. ⏰ State expires in 10 minutes if no selection is made\n\n"
                 "💡 *Pro tip*: This demonstrates state management with TTL!"
             )
-            
-            await self.messenger.send_text(
-                recipient=user_id,
-                text=instruction_text
-            )
-            
+
+            await self.messenger.send_text(recipient=user_id, text=instruction_text)
+
             # Update user activity
             await self.cache_helper.update_user_activity(user_id, "text", "/button")
-            
+
             processing_time = int((time.time() - start_time) * 1000)
             self.logger.info(f"✅ Button command processed in {processing_time}ms")
-            
+
             return {
                 "success": True,
                 "command": "/button",
                 "state_created": True,
                 "state_ttl_seconds": 600,
                 "buttons_sent": True,
-                "processing_time_ms": processing_time
+                "processing_time_ms": processing_time,
             }
-            
+
         except Exception as e:
             self.logger.error(f"❌ Error handling /button command: {e}", exc_info=True)
             return {"success": False, "error": str(e)}
-    
-    async def handle_list_command(self, webhook: IncomingMessageWebhook, 
-                                 user_profile: UserProfile) -> Dict[str, any]:
+
+    async def handle_list_command(
+        self, webhook: IncomingMessageWebhook, user_profile: UserProfile
+    ) -> dict[str, any]:
         """
         Handle /list command - creates interactive list message.
-        
+
         Args:
             webhook: IncomingMessageWebhook with command
             user_profile: User profile for tracking
-            
+
         Returns:
             Result dictionary with operation status
         """
         try:
             start_time = time.time()
-            
+
             user_id = webhook.user.user_id
             message_id = webhook.message.message_id
-            
+
             self.logger.info(f"📋 Processing /list command from {user_id}")
-            
+
             # Clean up any existing list state
-            existing_state = await self.cache_helper.get_user_state(user_id, StateType.LIST)
+            existing_state = await self.cache_helper.get_user_state(
+                user_id, StateType.LIST
+            )
             if existing_state:
                 await self.cache_helper.remove_user_state(user_id, StateType.LIST)
-            
+
             # Create list sections with media options
             sections = [
                 {
@@ -168,27 +175,27 @@ class CommandHandlers:
                         {
                             "id": "image_file",
                             "title": "🖼️ Image",
-                            "description": "Get a sample image file"
+                            "description": "Get a sample image file",
                         },
                         {
                             "id": "video_file",
                             "title": "🎬 Video",
-                            "description": "Get a sample video file"
+                            "description": "Get a sample video file",
                         },
                         {
                             "id": "audio_file",
                             "title": "🎵 Audio",
-                            "description": "Get a sample audio file"
+                            "description": "Get a sample audio file",
                         },
                         {
                             "id": "document_file",
                             "title": "📄 Document",
-                            "description": "Get a sample document file"
-                        }
-                    ]
+                            "description": "Get a sample document file",
+                        },
+                    ],
                 }
             ]
-            
+
             # Create list state with 10 minute TTL
             list_state = ListState.create_list_state(
                 user_id=user_id,
@@ -196,12 +203,12 @@ class CommandHandlers:
                 message_text="Choose the type of media file you want to receive!",
                 button_text="Choose Media",
                 ttl_seconds=600,  # 10 minutes
-                original_message_id=message_id
+                original_message_id=message_id,
             )
-            
+
             # Save the state
             await self.cache_helper.save_user_state(list_state)
-            
+
             # Send list message
             list_result = await self.messenger.send_list_message(
                 sections=sections,
@@ -210,18 +217,18 @@ class CommandHandlers:
                 button_text="Choose Media",
                 header="Interactive List Demo",
                 footer="⏰ Expires in 10 minutes",
-                reply_to_message_id=message_id
+                reply_to_message_id=message_id,
             )
-            
+
             if not list_result.success:
                 self.logger.error(f"Failed to send list message: {list_result.error}")
                 await self.cache_helper.remove_user_state(user_id, StateType.LIST)
                 return {"success": False, "error": "Failed to send list message"}
-            
+
             # Update list state with message ID
             list_state.interactive_message_id = list_result.message_id
             await self.cache_helper.save_user_state(list_state)
-            
+
             # Send instruction message
             instruction_text = (
                 "📋 *How to use this demo:*\n\n"
@@ -233,51 +240,49 @@ class CommandHandlers:
                 "6. ⏰ State expires in 10 minutes if no selection is made\n\n"
                 "💡 *Pro tip*: This demonstrates list interactions with media responses!"
             )
-            
-            await self.messenger.send_text(
-                recipient=user_id,
-                text=instruction_text
-            )
-            
+
+            await self.messenger.send_text(recipient=user_id, text=instruction_text)
+
             # Update user activity
             await self.cache_helper.update_user_activity(user_id, "text", "/list")
-            
+
             processing_time = int((time.time() - start_time) * 1000)
             self.logger.info(f"✅ List command processed in {processing_time}ms")
-            
+
             return {
                 "success": True,
                 "command": "/list",
                 "state_created": True,
                 "state_ttl_seconds": 600,
                 "list_sent": True,
-                "processing_time_ms": processing_time
+                "processing_time_ms": processing_time,
             }
-            
+
         except Exception as e:
             self.logger.error(f"❌ Error handling /list command: {e}", exc_info=True)
             return {"success": False, "error": str(e)}
-    
-    async def handle_cta_command(self, webhook: IncomingMessageWebhook, 
-                                user_profile: UserProfile) -> Dict[str, any]:
+
+    async def handle_cta_command(
+        self, webhook: IncomingMessageWebhook, user_profile: UserProfile
+    ) -> dict[str, any]:
         """
         Handle /cta command - sends call-to-action message.
-        
+
         Args:
             webhook: IncomingMessageWebhook with command
             user_profile: User profile for tracking
-            
+
         Returns:
             Result dictionary with operation status
         """
         try:
             start_time = time.time()
-            
+
             user_id = webhook.user.user_id
             message_id = webhook.message.message_id
-            
+
             self.logger.info(f"🔗 Processing /cta command from {user_id}")
-            
+
             # Send CTA message with link to Wappa documentation
             cta_result = await self.messenger.send_cta_message(
                 button_text="📚 View Documentation",
@@ -286,13 +291,13 @@ class CommandHandlers:
                 body="🎯 *Call-to-Action Demo*\n\nThis is a demonstration of CTA (Call-to-Action) buttons that link to external websites. Click the button below to visit the Wappa framework documentation!",
                 header="CTA Button Demo",
                 footer="External link - opens in browser",
-                reply_to_message_id=message_id
+                reply_to_message_id=message_id,
             )
-            
+
             if not cta_result.success:
                 self.logger.error(f"Failed to send CTA message: {cta_result.error}")
                 return {"success": False, "error": "Failed to send CTA message"}
-            
+
             # Send follow-up explanation
             explanation_text = (
                 "📋 *About CTA Buttons:*\n\n"
@@ -307,56 +312,54 @@ class CommandHandlers:
                 "• Provide easy access to support or contact forms\n\n"
                 "💡 *Pro tip*: CTA buttons are great for bridging WhatsApp conversations with web experiences!"
             )
-            
-            await self.messenger.send_text(
-                recipient=user_id,
-                text=explanation_text
-            )
-            
+
+            await self.messenger.send_text(recipient=user_id, text=explanation_text)
+
             # Update user activity
             await self.cache_helper.update_user_activity(user_id, "text", "/cta")
-            
+
             processing_time = int((time.time() - start_time) * 1000)
             self.logger.info(f"✅ CTA command processed in {processing_time}ms")
-            
+
             return {
                 "success": True,
                 "command": "/cta",
                 "cta_sent": True,
                 "url": "https://wappa.mimeia.com/docs",
-                "processing_time_ms": processing_time
+                "processing_time_ms": processing_time,
             }
-            
+
         except Exception as e:
             self.logger.error(f"❌ Error handling /cta command: {e}", exc_info=True)
             return {"success": False, "error": str(e)}
-    
-    async def handle_location_command(self, webhook: IncomingMessageWebhook, 
-                                    user_profile: UserProfile) -> Dict[str, any]:
+
+    async def handle_location_command(
+        self, webhook: IncomingMessageWebhook, user_profile: UserProfile
+    ) -> dict[str, any]:
         """
         Handle /location command - sends predefined location.
-        
+
         Args:
             webhook: IncomingMessageWebhook with command
             user_profile: User profile for tracking
-            
+
         Returns:
             Result dictionary with operation status
         """
         try:
             start_time = time.time()
-            
+
             user_id = webhook.user.user_id
             message_id = webhook.message.message_id
-            
+
             self.logger.info(f"📍 Processing /location command from {user_id}")
-            
+
             # Predefined coordinates (Bogotá, Colombia)
             latitude = 4.616738
             longitude = -74.089853
             location_name = "Bogotá, Colombia"
             location_address = "Bogotá D.C., Colombia"
-            
+
             # Send location message
             location_result = await self.messenger.send_location(
                 latitude=latitude,
@@ -364,13 +367,13 @@ class CommandHandlers:
                 recipient=user_id,
                 name=location_name,
                 address=location_address,
-                reply_to_message_id=message_id
+                reply_to_message_id=message_id,
             )
-            
+
             if not location_result.success:
                 self.logger.error(f"Failed to send location: {location_result.error}")
                 return {"success": False, "error": "Failed to send location"}
-            
+
             # Send follow-up explanation
             explanation_text = (
                 f"📍 *Location Demo*\n\n"
@@ -386,47 +389,52 @@ class CommandHandlers:
                 f"• Useful for sharing business locations, meeting points, etc.\n\n"
                 f"💡 *Pro tip*: Location messages are perfect for businesses to share their address with customers!"
             )
-            
-            await self.messenger.send_text(
-                recipient=user_id,
-                text=explanation_text
-            )
-            
+
+            await self.messenger.send_text(recipient=user_id, text=explanation_text)
+
             # Update user activity
             await self.cache_helper.update_user_activity(user_id, "text", "/location")
-            
+
             processing_time = int((time.time() - start_time) * 1000)
             self.logger.info(f"✅ Location command processed in {processing_time}ms")
-            
+
             return {
                 "success": True,
                 "command": "/location",
                 "location_sent": True,
                 "coordinates": {"latitude": latitude, "longitude": longitude},
                 "location_name": location_name,
-                "processing_time_ms": processing_time
+                "processing_time_ms": processing_time,
             }
-            
+
         except Exception as e:
-            self.logger.error(f"❌ Error handling /location command: {e}", exc_info=True)
+            self.logger.error(
+                f"❌ Error handling /location command: {e}", exc_info=True
+            )
             return {"success": False, "error": str(e)}
 
 
 # Command mapping for easy lookup
 COMMAND_HANDLERS = {
     "/button": "handle_button_command",
-    "/list": "handle_list_command", 
+    "/list": "handle_list_command",
     "/cta": "handle_cta_command",
-    "/location": "handle_location_command"
+    "/location": "handle_location_command",
 }
 
 
 # Convenience functions for direct use
-async def handle_command(command: str, webhook: IncomingMessageWebhook, 
-                        user_profile: UserProfile, messenger, cache_factory, logger) -> Dict[str, any]:
+async def handle_command(
+    command: str,
+    webhook: IncomingMessageWebhook,
+    user_profile: UserProfile,
+    messenger,
+    cache_factory,
+    logger,
+) -> dict[str, any]:
     """
     Handle command based on command string (convenience function).
-    
+
     Args:
         command: Command string (e.g., "/button")
         webhook: IncomingMessageWebhook with command
@@ -434,13 +442,13 @@ async def handle_command(command: str, webhook: IncomingMessageWebhook,
         messenger: IMessenger instance
         cache_factory: Cache factory
         logger: Logger instance
-        
+
     Returns:
         Result dictionary
     """
     handlers = CommandHandlers(messenger, cache_factory, logger)
     command_lower = command.lower()
-    
+
     if command_lower == "/button":
         return await handlers.handle_button_command(webhook, user_profile)
     elif command_lower == "/list":
@@ -457,10 +465,10 @@ async def handle_command(command: str, webhook: IncomingMessageWebhook,
 def is_special_command(text: str) -> bool:
     """
     Check if text is a special command.
-    
+
     Args:
         text: Message text to check
-        
+
     Returns:
         True if it's a special command, False otherwise
     """
@@ -471,14 +479,14 @@ def is_special_command(text: str) -> bool:
 def get_command_from_text(text: str) -> str:
     """
     Extract command from message text.
-    
+
     Args:
         text: Message text
-        
+
     Returns:
         Command string or empty string if not a command
     """
     text_clean = text.strip().lower()
     if is_special_command(text_clean):
         return text_clean
-    return ""
+    return ""