wappa 0.1.8__tar.gz → 0.1.9__tar.gz

{wappa-0.1.8 → wappa-0.1.9}/.gitignore

@@ -1,7 +1,6 @@
 # AI
 .claude/
 CLAUDE.md
-app/
 logs/
 .ruff_cache
 # Python-related files

{wappa-0.1.8 → wappa-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wappa
-Version: 0.1.8
+Version: 0.1.9
 Summary: Open Source Framework to develop smart Workflows, Agents and full chat applications through WhatsApp
 Project-URL: Homepage, https://wappa.mimeia.com
 Project-URL: Documentation, https://wappa.mimeia.com/docs

{wappa-0.1.8 → wappa-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wappa"
-version = "0.1.8"
+version = "0.1.9"
 description = "Open Source Framework to develop smart Workflows, Agents and full chat applications through WhatsApp"
 authors = [
     {name = "Sasha Canal", email = "contact@mimeia.com"},

wappa-0.1.9/wappa/cli/examples/init/.env.example

@@ -0,0 +1,33 @@
+# ================================================================
+# WAPPA WHATSAPP FRAMEWORK CONFIGURATION
+# ================================================================
+
+# General Configuration
+PORT=8000
+TIME_ZONE=America/Bogota
+
+# DEBUG or INFO or WARNING or ERROR or CRITICAL
+LOG_LEVEL=DEBUG
+LOG_DIR=./logs
+## Environment DEV or PROD
+ENVIRONMENT=DEV  
+
+# WhatsApp Graph API
+BASE_URL=https://graph.facebook.com/
+API_VERSION=v23.0
+
+# WhatsApp Business API Credentials
+WP_ACCESS_TOKEN=
+WP_PHONE_ID=
+WP_BID=
+
+# Webhook Configuration
+WHATSAPP_WEBHOOK_VERIFY_TOKEN=
+
+# Redis Configuration (Optional - uncomment to enable Redis persistence)
+# REDIS_URL=redis://localhost:6379/
+# REDIS_MAX_CONNECTIONS=64
+
+# Optional: AI Tools
+# OPENAI_API_KEY=
+

wappa-0.1.9/wappa/cli/examples/init/app/master_event.py

@@ -0,0 +1,8 @@
+from wappa import WappaEventHandler
+from wappa.webhooks import IncomingMessageWebhook
+
+class MasterEventHandler(WappaEventHandler):
+    
+    async def process_message(self, webhook: IncomingMessageWebhook):
+        await self.messenger.mark_as_read(webhook.message.message_id, webhook.user.user_id)
+        await self.messenger.send_text("Welcome to Wappa", webhook.user.user_id)

wappa-0.1.9/wappa/cli/examples/json_cache_example/.env.example

@@ -0,0 +1,33 @@
+# ================================================================
+# WAPPA WHATSAPP FRAMEWORK CONFIGURATION
+# ================================================================
+
+# General Configuration
+PORT=8000
+TIME_ZONE=America/Bogota
+
+# DEBUG or INFO or WARNING or ERROR or CRITICAL
+LOG_LEVEL=DEBUG
+LOG_DIR=./logs
+## Environment DEV or PROD
+ENVIRONMENT=DEV  
+
+# WhatsApp Graph API
+BASE_URL=https://graph.facebook.com/
+API_VERSION=v23.0
+
+# WhatsApp Business API Credentials
+WP_ACCESS_TOKEN=
+WP_PHONE_ID=
+WP_BID=
+
+# Webhook Configuration
+WHATSAPP_WEBHOOK_VERIFY_TOKEN=
+
+# Redis Configuration (Optional - uncomment to enable Redis persistence)
+# REDIS_URL=redis://localhost:6379/
+# REDIS_MAX_CONNECTIONS=64
+
+# Optional: AI Tools
+# OPENAI_API_KEY=
+

wappa-0.1.9/wappa/cli/examples/json_cache_example/app/__init__.py

@@ -0,0 +1 @@
+"""JSON Cache Example - SOLID Architecture Implementation"""

wappa-0.1.9/wappa/cli/examples/json_cache_example/app/main.py

@@ -0,0 +1,235 @@
+"""
+JSON Cache Example - SOLID Architecture Implementation
+
+This is the main initialization file following SOLID principles:
+- Single Responsibility: Pure initialization and configuration
+- Open/Closed: Extensible through score module registration
+- Liskov Substitution: Compatible with Wappa framework interface
+- Interface Segregation: Clean dependency interfaces
+- Dependency Inversion: Abstractions injected into concrete implementations
+
+SETUP REQUIRED:
+1. Create a .env file with your WhatsApp Business API credentials:
+    WP_ACCESS_TOKEN=your_access_token_here
+    WP_PHONE_ID=your_phone_number_id_here
+    WP_BID=your_business_id_here
+
+2. JSON Cache automatically creates cache directory:
+    No external dependencies required!
+    Cache files will be created in {project_root}/cache/
+
+DEMO FEATURES:
+- SOLID architecture with separated concerns
+- Master event orchestrator with score modules
+- User management, message history, and state commands
+- Cache statistics and monitoring
+- Professional logging and error handling
+- File-based JSON cache with TTL support
+
+USAGE:
+- Direct Python: python -m app.main (from project root)
+- FastAPI-style: uvicorn app.main:app --reload (from project root)
+- Wappa CLI: wappa dev app.main (when CLI is available)
+"""
+
+# Import core Wappa components
+from wappa import Wappa, __version__
+from wappa.core.config.settings import settings
+from wappa.core.logging import get_logger
+
+logger = get_logger(__name__)
+
+# Import our SOLID architecture WappaEventHandler implementation
+from .master_event import JSONCacheExampleHandler
+
+
+def validate_configuration() -> bool:
+    """
+    Validate required configuration settings.
+    
+    Returns:
+        True if configuration is valid, False otherwise
+    """
+    
+    # Check required WhatsApp credentials
+    missing_configs = []
+    
+    if not settings.wp_access_token:
+        missing_configs.append("WP_ACCESS_TOKEN")
+    
+    if not settings.wp_phone_id:
+        missing_configs.append("WP_PHONE_ID")
+        
+    if not settings.wp_bid:
+        missing_configs.append("WP_BID")
+    
+    if missing_configs:
+        logger.error(f"❌ Missing required configuration: {', '.join(missing_configs)}")
+        logger.error("💡 Create a .env file with the required credentials")
+        return False
+    
+    logger.info("✅ Configuration validation passed")
+    return True
+
+
+def display_startup_information() -> None:
+    """
+    Display startup information and demo features.
+    
+    Shows configuration status, architecture overview,
+    and available demo features.
+    """
+    print(f"🚀 Wappa v{__version__} - JSON Cache Example (SOLID Architecture)")
+    print("=" * 80)
+    print()
+    
+    print("🏗️ *SOLID ARCHITECTURE IMPLEMENTATION:*")
+    print("  • Single Responsibility: Each score module has one specific concern")
+    print("  • Open/Closed: New score modules can be added without modification")
+    print("  • Liskov Substitution: All scores implement the same interface")
+    print("  • Interface Segregation: Clean, focused interfaces for each concern")
+    print("  • Dependency Inversion: Dependencies injected through abstractions")
+    print()
+    
+    print("📋 *CONFIGURATION STATUS:*")
+    print(f"  • Access Token: {'✅ Configured' if settings.wp_access_token else '❌ Missing'}")
+    print(f"  • Phone ID: {settings.wp_phone_id if settings.wp_phone_id else '❌ Missing'}")
+    print(f"  • Business ID: {'✅ Configured' if settings.wp_bid else '❌ Missing'}")
+    print(f"  • JSON Cache: ✅ No external dependencies required")
+    print(f"  • Environment: {'🛠️ Development' if settings.is_development else '🚀 Production'}")
+    print()
+    
+    print("🎯 *SCORE MODULES (BUSINESS LOGIC):*")
+    print("  • UserManagementScore: User profile and caching logic")
+    print("  • MessageHistoryScore: Message logging and /HISTORY command")
+    print("  • StateCommandsScore: /WAPPA and /EXIT command processing")  
+    print("  • CacheStatisticsScore: Cache monitoring and /STATS command")
+    print()
+    
+    print("🧪 *DEMO FEATURES:*")
+    print("  1. Send any message → User profile created/updated + message logged")
+    print("  2. Send '/WAPPA' → Enter special state with cache management")
+    print("  3. While in WAPPA state → All messages replied with 'Hola Wapp@ ;)'")
+    print("  4. Send '/EXIT' → Leave special state with session summary")
+    print("  5. Send '/HISTORY' → View your last 20 messages with timestamps")
+    print("  6. Send '/STATS' → View comprehensive cache statistics")
+    print()
+    
+    print("💎 *JSON CACHE ARCHITECTURE:*")
+    print("  • user_cache: User profiles stored in {project_root}/cache/users/")
+    print("  • table_cache: Message history in {project_root}/cache/tables/")  
+    print("  • state_cache: Command state management in {project_root}/cache/states/")
+    print("  • TTL Support: Metadata-based expiration with lazy cleanup")
+    print("  • File Safety: Atomic write operations prevent corruption")
+    print()
+    
+    print("🔧 *TECHNICAL FEATURES:*")
+    print("  • File-based persistence with project root auto-detection")
+    print("  • BaseModel JSON serialization with datetime handling")
+    print("  • TTL support through JSON metadata")
+    print("  • Dependency injection with interface abstractions")
+    print("  • Score module registry with automatic discovery")
+    print("  • Professional error handling and recovery")
+    print("  • Performance monitoring and statistics")
+    print("  • Comprehensive logging with structured output")
+    print("  • Cache file inspection for debugging")
+    print()
+
+
+def create_wappa_application() -> Wappa:
+    """
+    Create and configure the Wappa application.
+    
+    This function follows Single Responsibility Principle by focusing
+    only on application creation and initial configuration.
+    
+    Returns:
+        Configured Wappa application instance
+    """
+    
+    try:
+        # Create Wappa instance with JSON cache
+        logger.info("🏗️ Creating Wappa application with JSON cache...")
+        app = Wappa(cache="json")
+        
+        logger.info("✅ Wappa application created successfully")
+        return app
+        
+    except Exception as e:
+        logger.error(f"❌ Failed to create Wappa application: {e}")
+        raise
+
+
+def main() -> None:
+    """
+    Main application entry point.
+    
+    Demonstrates SOLID principles in action:
+    - Single Responsibility: Each function has one clear purpose
+    - Dependency Inversion: Dependencies flow from abstractions
+    - Open/Closed: System is open for extension via score modules
+    """
+    
+    logger.info("🚀 Starting JSON Cache Example with SOLID Architecture")
+    
+    try:
+        # Display startup information
+        display_startup_information()
+        
+        # Validate configuration before proceeding
+        if not validate_configuration():
+            logger.error("❌ Configuration validation failed - cannot start application")
+            return
+        
+        # Create Wappa application
+        app = create_wappa_application()
+        
+        # Create and set the SOLID WappaEventHandler implementation
+        handler = JSONCacheExampleHandler()
+        app.set_event_handler(handler)
+        
+        logger.info("✅ Application initialization completed with SOLID WappaEventHandler")
+        
+        print("🌐 Starting SOLID JSON cache demo server...")
+        print("💡 Press CTRL+C to stop the server")
+        print("💾 Cache files will be created in the project's cache/ directory")
+        print("=" * 80)
+        print()
+        
+        # Start the application
+        # The framework will handle dependency injection automatically
+        app.run()
+        
+    except KeyboardInterrupt:
+        logger.info("👋 Application stopped by user")
+        print("\n👋 JSON cache demo stopped by user")
+        
+    except Exception as e:
+        logger.error(f"❌ Application startup error: {e}", exc_info=True)
+        print(f"\n❌ Server error: {e}")
+        
+    finally:
+        logger.info("🏁 JSON cache demo completed")
+        print("🏁 JSON cache demo completed")
+
+
+# Module-level app instance for uvicorn compatibility
+# This enables: uvicorn main:app --reload
+
+try:
+    logger.info("📦 Creating module-level Wappa application instance")
+    app = Wappa(cache="json")
+    
+    # Create and set the SOLID WappaEventHandler implementation
+    handler = JSONCacheExampleHandler()
+    app.set_event_handler(handler)
+    
+    logger.info("✅ Module-level application instance ready with SOLID WappaEventHandler")
+    
+except Exception as e:
+    logger.error(f"❌ Failed to create module-level app instance: {e}")
+    raise
+
+
+if __name__ == "__main__":
+    main()