"""Playwright browser automation executor (stub for MVP)."""

from typing import Any

from app.executors.base import BaseExecutor, ExecutionResult


class PlaywrightExecutor(BaseExecutor):
    """Browser automation executor using Playwright.

    This is a stub for MVP. Future implementation will support:
    - Flow definitions with steps
    - Screenshot capture
    - Form filling
    - Navigation
    - Element interaction
    - Waiting conditions

    Payload (future):
        {
            "flow": [
                {"action": "goto", "url": "https://example.com"},
                {"action": "fill", "selector": "#email", "value": "test@example.com"},
                {"action": "click", "selector": "#submit"},
                {"action": "screenshot", "path": "/tmp/result.png"}
            ],
            "timeout": 30
        }
    """

    @property
    def task_type(self) -> str:
        return "PLAYWRIGHT"

    async def execute(self, payload: dict[str, Any]) -> ExecutionResult:
        """Stub: Playwright automation is not yet implemented.

        Args:
            payload: Flow definition (ignored in stub)

        Returns:
            ExecutionResult indicating not implemented
        """
        self.logger.info("playwright_stub_called", payload_keys=list(payload.keys()))

        return ExecutionResult(
            success=False,
            data={
                "status": "NOT_IMPLEMENTED",
                "message": "Playwright executor is planned for a future release",
            },
            error="Playwright executor not yet implemented",
        )