browser

type BrowserSession struct {
	SessionID uuid.UUID
	CreatedAt time.Time
	LastUsed  time.Time
	PageCount int
}

type ExtractOpts struct {
	Selector string // CSS selector (empty = entire page)
	Extract  string // "text", "html", "attributes"
}

type Manager interface {
	// Navigate to a URL
	Navigate(ctx context.Context, sessionID uuid.UUID, url string, opts NavigateOpts) error

	// Take a screenshot
	Screenshot(ctx context.Context, sessionID uuid.UUID, opts ScreenshotOpts) (*ScreenshotResult, error)

	// Click an element
	Click(ctx context.Context, sessionID uuid.UUID, selector string) error

	// Fill an input field
	Fill(ctx context.Context, sessionID uuid.UUID, selector, value string) error

	// Extract content from the page
	Extract(ctx context.Context, sessionID uuid.UUID, opts ExtractOpts) (string, error)

	// Evaluate JavaScript
	Evaluate(ctx context.Context, sessionID uuid.UUID, script string) (interface{}, error)

	// Wait for an element or condition
	Wait(ctx context.Context, sessionID uuid.UUID, opts WaitOpts) error

	// Generate a PDF
	PDF(ctx context.Context, sessionID uuid.UUID, opts PDFOpts) (*PDFResult, error)

	// Close browser resources for a session
	Close(ctx context.Context, sessionID uuid.UUID) error
}

type NavigateOpts struct {
	WaitUntil string // "load", "domcontentloaded", "networkidle"
	Timeout   int    // milliseconds
}

type NetworkPolicy struct {
	AllowedHosts    []string
	BlockPrivateIPs bool
	BlockLocalhost  bool
	BlockMetadata   bool // Block cloud metadata endpoints (169.254.169.254, etc.)
}

type PDFOpts struct {
	Format string // "A4", "Letter"
	Path   string // Output path (optional)
}

type PDFResult struct {
	ArtifactID uuid.UUID
	Path       string
	SizeBytes  int64
}

type PlaywrightManager struct {
	// contains filtered or unexported fields
}

type ScreenshotOpts struct {
	FullPage bool   // Capture entire page (not just viewport)
	Selector string // Screenshot specific element only
	Format   string // "png" or "jpeg"
}

type ScreenshotResult struct {
	ArtifactID uuid.UUID
	Path       string
	SizeBytes  int64
	Format     string
}

type WaitOpts struct {
	Selector string // Wait for element to appear
	Timeout  int    // milliseconds
}