wappa 0.1.0__py3-none-any.whl

wappa/domain/models/media_result.py

@@ -0,0 +1,110 @@
+"""
+Media result models for platform-agnostic media operations.
+
+These models represent the results of media operations across different
+messaging platforms, providing consistent response structures while
+maintaining compatibility with platform-specific response formats.
+"""
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+from wappa.schemas.core.types import PlatformType
+
+
+class MediaUploadResult(BaseModel):
+    """Result of a media upload operation.
+
+    Standard response model for media upload operations across platforms.
+    Based on WhatsApp Cloud API response: {"id": "<MEDIA_ID>"}
+    """
+
+    success: bool
+    platform: PlatformType = PlatformType.WHATSAPP
+    media_id: str | None = None
+    media_url: str | None = None
+    file_size: int | None = None
+    mime_type: str | None = None
+    error: str | None = None
+    error_code: str | None = None
+    uploaded_at: datetime = Field(default_factory=datetime.utcnow)
+    tenant_id: str | None = None  # phone_number_id in WhatsApp context
+
+    class Config:
+        use_enum_values = True
+
+
+class MediaInfoResult(BaseModel):
+    """Result of a media info retrieval operation.
+
+    Standard response model for media info operations.
+    Based on WhatsApp Cloud API response:
+    {
+        "messaging_product": "whatsapp",
+        "url": "<URL>",
+        "mime_type": "<MIME_TYPE>",
+        "sha256": "<HASH>",
+        "file_size": "<FILE_SIZE>",
+        "id": "<MEDIA_ID>"
+    }
+    """
+
+    success: bool
+    platform: PlatformType = PlatformType.WHATSAPP
+    media_id: str | None = None
+    url: str | None = None
+    mime_type: str | None = None
+    file_size: int | None = None
+    sha256: str | None = None
+    error: str | None = None
+    error_code: str | None = None
+    retrieved_at: datetime = Field(default_factory=datetime.utcnow)
+    tenant_id: str | None = None
+
+    class Config:
+        use_enum_values = True
+
+
+class MediaDownloadResult(BaseModel):
+    """Result of a media download operation.
+
+    Standard response model for media download operations.
+    Compatible with existing handle_media.py download patterns.
+    """
+
+    success: bool
+    platform: PlatformType = PlatformType.WHATSAPP
+    file_data: bytes | None = None
+    file_path: str | None = None
+    mime_type: str | None = None
+    file_size: int | None = None
+    sha256: str | None = None
+    error: str | None = None
+    error_code: str | None = None
+    downloaded_at: datetime = Field(default_factory=datetime.utcnow)
+    tenant_id: str | None = None
+
+    class Config:
+        use_enum_values = True
+        # Allow bytes in file_data field
+        arbitrary_types_allowed = True
+
+
+class MediaDeleteResult(BaseModel):
+    """Result of a media delete operation.
+
+    Standard response model for media delete operations.
+    Based on WhatsApp Cloud API response: {"success": true}
+    """
+
+    success: bool
+    platform: PlatformType = PlatformType.WHATSAPP
+    media_id: str | None = None
+    error: str | None = None
+    error_code: str | None = None
+    deleted_at: datetime = Field(default_factory=datetime.utcnow)
+    tenant_id: str | None = None
+
+    class Config:
+        use_enum_values = True

wappa/domain/models/platforms/__init__.py

@@ -0,0 +1,15 @@
+"""Platform configuration models."""
+
+from .platform_config import (
+    PlatformCapabilities,
+    PlatformConfig,
+    PlatformCredentials,
+    PlatformLimits,
+)
+
+__all__ = [
+    "PlatformConfig",
+    "PlatformCredentials",
+    "PlatformCapabilities",
+    "PlatformLimits",
+]

wappa/domain/models/platforms/platform_config.py

@@ -0,0 +1,104 @@
+"""
+Platform configuration models for messenger platforms.
+
+Defines configuration structure for messenger platforms similar to
+payment provider configuration but adapted for messaging platforms.
+"""
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class PlatformCapabilities(BaseModel):
+    """Platform-specific capabilities and limits."""
+
+    max_text_length: int = Field(
+        default=4096, description="Maximum text message length"
+    )
+    max_media_size: int = Field(
+        default=16 * 1024 * 1024, description="Maximum media file size in bytes"
+    )
+    supports_threads: bool = Field(
+        default=False, description="Whether platform supports message threads"
+    )
+    supports_reactions: bool = Field(
+        default=True, description="Whether platform supports message reactions"
+    )
+    supports_editing: bool = Field(
+        default=False, description="Whether platform supports message editing"
+    )
+    supported_message_types: list[str] = Field(
+        default_factory=list, description="Supported message types"
+    )
+    supported_interactive_types: list[str] = Field(
+        default_factory=list, description="Supported interactive message types"
+    )
+
+
+class PlatformCredentials(BaseModel):
+    """Platform-specific credentials and API keys."""
+
+    access_token: str | None = Field(default=None, description="Platform access token")
+    app_id: str | None = Field(default=None, description="Application ID")
+    app_secret: str | None = Field(default=None, description="Application secret")
+    phone_id: str | None = Field(default=None, description="Phone number ID (WhatsApp)")
+    business_id: str | None = Field(default=None, description="Business account ID")
+    webhook_verify_token: str | None = Field(
+        default=None, description="Webhook verification token"
+    )
+
+    def is_configured(self) -> bool:
+        """Check if minimum required credentials are present."""
+        # For WhatsApp, we need access_token and phone_id
+        if self.access_token and self.phone_id:
+            return True
+        return False
+
+
+class PlatformLimits(BaseModel):
+    """Platform-specific rate limits and constraints."""
+
+    max_requests_per_minute: int = Field(
+        default=1000, description="Maximum API requests per minute"
+    )
+    max_recipients_per_message: int = Field(
+        default=1, description="Maximum recipients per message"
+    )
+    max_buttons_per_message: int = Field(
+        default=3, description="Maximum buttons per interactive message"
+    )
+    max_list_sections: int = Field(
+        default=10, description="Maximum sections in list messages"
+    )
+    max_list_rows_per_section: int = Field(
+        default=10, description="Maximum rows per list section"
+    )
+
+
+class PlatformConfig(BaseModel):
+    """Complete platform configuration."""
+
+    platform_name: str = Field(description="Internal platform name (lowercase)")
+    display_name: str = Field(description="Human-readable platform name")
+    is_enabled: bool = Field(default=True, description="Whether platform is enabled")
+    is_test_mode: bool = Field(
+        default=False, description="Whether platform is in test mode"
+    )
+
+    credentials: PlatformCredentials = Field(description="Platform credentials")
+    capabilities: PlatformCapabilities = Field(description="Platform capabilities")
+    limits: PlatformLimits = Field(description="Platform limits")
+
+    webhook_events: list[str] = Field(
+        default_factory=list, description="Supported webhook events"
+    )
+    webhook_url_template: str = Field(description="Webhook URL template")
+
+    platform_settings: dict[str, Any] = Field(
+        default_factory=dict, description="Platform-specific settings"
+    )
+
+    def is_configured(self) -> bool:
+        """Check if platform is properly configured."""
+        return self.credentials.is_configured()

wappa/domain/services/__init__.py

@@ -0,0 +1,11 @@
+"""
+Domain services.
+
+Contains business logic that doesn't belong to a specific entity.
+"""
+
+from .tenant_credentials_service import TenantCredentialsService
+
+__all__ = [
+    "TenantCredentialsService",
+]

wappa/domain/services/tenant_credentials_service.py

@@ -0,0 +1,56 @@
+"""
+Tenant credentials service for managing tenant-specific WhatsApp credentials.
+
+Currently uses settings for single tenant, but will be migrated to database
+for multi-tenant support in the future.
+"""
+
+from wappa.core.config.settings import settings
+
+
+class TenantCredentialsService:
+    """Service to get tenant-specific WhatsApp credentials.
+
+    Currently uses settings for single tenant, but will be migrated to database
+    for multi-tenant support in the future.
+
+    Note: In WhatsApp Business API, the phone_number_id IS the tenant identifier.
+    """
+
+    @staticmethod
+    def get_whatsapp_access_token(phone_number_id: str) -> str:
+        """Get WhatsApp access token for tenant.
+
+        Args:
+            phone_number_id: WhatsApp Business phone number ID (this IS the tenant_id)
+
+        Returns:
+            WhatsApp access token for this tenant
+
+        Future: This will query the database using phone_number_id as the key:
+        SELECT access_token FROM tenants WHERE phone_number_id = ?
+        """
+        # TODO: Replace with database query when migrating to multi-tenant
+        # For now, use settings computed properties (DEV/PROD switching)
+        return settings.wp_access_token
+
+    @staticmethod
+    def validate_tenant(phone_number_id: str) -> bool:
+        """Validate that the tenant exists and is active.
+
+        Args:
+            phone_number_id: WhatsApp Business phone number ID
+
+        Returns:
+            True if tenant is valid and active, False otherwise
+
+        Future: This will validate against the database
+        """
+        # TODO: Replace with database validation when migrating to multi-tenant
+        # For now, check if we have valid credentials in settings
+        try:
+            token = settings.wp_access_token
+            configured_phone_id = settings.wp_phone_id
+            return bool(token and configured_phone_id == phone_number_id)
+        except Exception:
+            return False

wappa/messaging/__init__.py

@@ -0,0 +1,7 @@
+"""Messaging interfaces and implementations for Wappa framework."""
+
+from wappa.domain.interfaces.messaging_interface import IMessenger
+
+from .whatsapp.messenger.whatsapp_messenger import WhatsAppMessenger
+
+__all__ = ["IMessenger", "WhatsAppMessenger"]

wappa/messaging/whatsapp/__init__.py

@@ -0,0 +1 @@
+"""WhatsApp services package."""

wappa/messaging/whatsapp/client/__init__.py

@@ -0,0 +1,5 @@
+"""WhatsApp client package."""
+
+from .whatsapp_client import WhatsAppClient, WhatsAppFormDataBuilder, WhatsAppUrlBuilder
+
+__all__ = ["WhatsAppClient", "WhatsAppUrlBuilder", "WhatsAppFormDataBuilder"]