playwright

type BrowserAutomation interface {
	// Browser management
	LaunchBrowser(ctx context.Context, config *BrowserConfig) (*BrowserSession, error)
	CloseBrowser(ctx context.Context, sessionID string) error
	GetSession(sessionID string) (*BrowserSession, error)
	GetOrCreateDefaultSession(ctx context.Context) (*BrowserSession, error)

	// Page operations
	NavigateToURL(ctx context.Context, sessionID, url string, waitUntil string, timeout time.Duration) error
	ClickElement(ctx context.Context, sessionID, selector string, options map[string]any) error
	FillForm(ctx context.Context, sessionID string, fields []map[string]any, submit bool, submitSelector string) error
	ExtractData(ctx context.Context, sessionID string, extractors []map[string]any, format string) (string, error)
	TakeScreenshot(ctx context.Context, sessionID, path string, fullPage bool, selector string, format string, quality int) error
	ExecuteScript(ctx context.Context, sessionID, script string, args []any) (any, error)
	WaitForCondition(ctx context.Context, sessionID, condition, selector, state string, timeout time.Duration, customFunction string) error
	HandleAuthentication(ctx context.Context, sessionID, authType, username, password, loginURL string, selectors map[string]string) error

	// Service management
	GetHealth(ctx context.Context) error
	Shutdown(ctx context.Context) error
	GetConfig() *config.Config
}

type BrowserConfig struct {
	Engine         BrowserEngine
	Headless       bool
	Timeout        time.Duration
	ViewportWidth  int
	ViewportHeight int
	Args           []string
}

type BrowserEngine string

type BrowserSession struct {
	ID       string
	Browser  playwright.Browser
	Context  playwright.BrowserContext
	Page     playwright.Page
	Created  time.Time
	LastUsed time.Time
}