gui/pkg/webview/messages.go

// pkg/webview/messages.go
package webview

import "time"

// --- Queries (read-only) ---

// QueryURL gets the current page URL. Result: string
type QueryURL struct {
	Window string `json:"window"`
}

// QueryTitle gets the current page title. Result: string
type QueryTitle struct {
	Window string `json:"window"`
}

// QueryConsole gets captured console messages. Result: []ConsoleMessage
type QueryConsole struct {
	Window string `json:"window"`
	Level  string `json:"level,omitempty"` // filter by type: "log", "warn", "error", "info", "debug"
	Limit  int    `json:"limit,omitempty"` // max messages (0 = all)
}

// QuerySelector finds a single element. Result: *ElementInfo (nil if not found)
type QuerySelector struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
}

// QuerySelectorAll finds all matching elements. Result: []*ElementInfo
type QuerySelectorAll struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
}

// QueryDOMTree gets HTML content. Result: string (outerHTML)
type QueryDOMTree struct {
	Window   string `json:"window"`
	Selector string `json:"selector,omitempty"` // empty = full document
}

// QueryComputedStyle returns the computed CSS properties for an element.
type QueryComputedStyle struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
}

// QueryPerformance returns page performance metrics.
type QueryPerformance struct {
	Window string `json:"window"`
}

// QueryResources returns the page's loaded resource entries.
type QueryResources struct {
	Window string `json:"window"`
}

// QueryNetwork returns the captured network log.
type QueryNetwork struct {
	Window string `json:"window"`
	Limit  int    `json:"limit,omitempty"`
}

// QueryExceptions returns captured JavaScript exceptions.
type QueryExceptions struct {
	Window string `json:"window"`
	Limit  int    `json:"limit,omitempty"`
}

// --- Tasks (side-effects) ---

// TaskEvaluate executes JavaScript. Result: any (JS return value)
type TaskEvaluate struct {
	Window string `json:"window"`
	Script string `json:"script"`
}

// TaskClick clicks an element. Result: nil
type TaskClick struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
}

// TaskType types text into an element. Result: nil
type TaskType struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
	Text     string `json:"text"`
}

// TaskNavigate navigates to a URL. Result: nil
type TaskNavigate struct {
	Window string `json:"window"`
	URL    string `json:"url"`
}

// TaskScreenshot captures the page as PNG. Result: ScreenshotResult
type TaskScreenshot struct {
	Window string `json:"window"`
}

// TaskScreenshotElement captures a specific element as PNG. Result: ScreenshotResult
type TaskScreenshotElement struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
}

// TaskScroll scrolls to an absolute position (window.scrollTo). Result: nil
type TaskScroll struct {
	Window string `json:"window"`
	X      int    `json:"x"`
	Y      int    `json:"y"`
}

// TaskHover hovers over an element. Result: nil
type TaskHover struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
}

// TaskSelect selects an option in a <select> element. Result: nil
type TaskSelect struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
	Value    string `json:"value"`
}

// TaskCheck checks/unchecks a checkbox. Result: nil
type TaskCheck struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
	Checked  bool   `json:"checked"`
}

// TaskUploadFile uploads files to an input element. Result: nil
type TaskUploadFile struct {
	Window   string   `json:"window"`
	Selector string   `json:"selector"`
	Paths    []string `json:"paths"`
}

// TaskSetViewport sets the viewport dimensions. Result: nil
type TaskSetViewport struct {
	Window string `json:"window"`
	Width  int    `json:"width"`
	Height int    `json:"height"`
}

// TaskClearConsole clears captured console messages. Result: nil
type TaskClearConsole struct {
	Window string `json:"window"`
}

// TaskHighlight visually highlights an element.
type TaskHighlight struct {
	Window   string `json:"window"`
	Selector string `json:"selector"`
	Colour   string `json:"colour,omitempty"`
}

// TaskOpenDevTools opens the browser devtools for the target window. Result: nil
type TaskOpenDevTools struct {
	Window string `json:"window"`
}

// TaskCloseDevTools closes the browser devtools for the target window. Result: nil
type TaskCloseDevTools struct {
	Window string `json:"window"`
}

// TaskInjectNetworkLogging injects fetch/XHR interception into the page.
type TaskInjectNetworkLogging struct {
	Window string `json:"window"`
}

// TaskClearNetworkLog clears the captured network log.
type TaskClearNetworkLog struct {
	Window string `json:"window"`
}

// TaskPrint prints the current page using the browser's native print flow.
type TaskPrint struct {
	Window string `json:"window"`
}

// TaskExportPDF exports the page to a PDF document.
type TaskExportPDF struct {
	Window string `json:"window"`
}

// --- Actions (broadcast) ---

// ActionConsoleMessage is broadcast when a console message is captured.
type ActionConsoleMessage struct {
	Window  string         `json:"window"`
	Message ConsoleMessage `json:"message"`
}

// ActionException is broadcast when a JavaScript exception occurs.
type ActionException struct {
	Window    string        `json:"window"`
	Exception ExceptionInfo `json:"exception"`
}

// --- Types ---

// ConsoleMessage represents a browser console message.
type ConsoleMessage struct {
	Type      string    `json:"type"` // "log", "warn", "error", "info", "debug"
	Text      string    `json:"text"`
	Timestamp time.Time `json:"timestamp"`
	URL       string    `json:"url,omitempty"`
	Line      int       `json:"line,omitempty"`
	Column    int       `json:"column,omitempty"`
}

// ElementInfo represents a DOM element.
type ElementInfo struct {
	TagName     string            `json:"tagName"`
	Attributes  map[string]string `json:"attributes,omitempty"`
	InnerText   string            `json:"innerText,omitempty"`
	InnerHTML   string            `json:"innerHTML,omitempty"`
	BoundingBox *BoundingBox      `json:"boundingBox,omitempty"`
}

// BoundingBox represents element position and size.
type BoundingBox struct {
	X      float64 `json:"x"`
	Y      float64 `json:"y"`
	Width  float64 `json:"width"`
	Height float64 `json:"height"`
}

// ExceptionInfo represents a JavaScript exception.
// Field mapping from go-webview: LineNumber->Line, ColumnNumber->Column.
type ExceptionInfo struct {
	Text       string    `json:"text"`
	URL        string    `json:"url,omitempty"`
	Line       int       `json:"line,omitempty"`
	Column     int       `json:"column,omitempty"`
	StackTrace string    `json:"stackTrace,omitempty"`
	Timestamp  time.Time `json:"timestamp"`
}

// ScreenshotResult wraps raw PNG bytes as base64 for JSON/MCP transport.
type ScreenshotResult struct {
	Base64   string `json:"base64"`
	MimeType string `json:"mimeType"` // always "image/png"
}

// PerformanceMetrics summarises browser performance timings.
type PerformanceMetrics struct {
	NavigationStart      float64 `json:"navigationStart"`
	DOMContentLoaded     float64 `json:"domContentLoaded"`
	LoadEventEnd         float64 `json:"loadEventEnd"`
	FirstPaint           float64 `json:"firstPaint,omitempty"`
	FirstContentfulPaint float64 `json:"firstContentfulPaint,omitempty"`
	UsedJSHeapSize       float64 `json:"usedJSHeapSize,omitempty"`
	TotalJSHeapSize      float64 `json:"totalJSHeapSize,omitempty"`
}

// ResourceEntry summarises a loaded resource.
type ResourceEntry struct {
	Name            string  `json:"name"`
	EntryType       string  `json:"entryType"`
	InitiatorType   string  `json:"initiatorType,omitempty"`
	StartTime       float64 `json:"startTime"`
	Duration        float64 `json:"duration"`
	TransferSize    float64 `json:"transferSize,omitempty"`
	EncodedBodySize float64 `json:"encodedBodySize,omitempty"`
	DecodedBodySize float64 `json:"decodedBodySize,omitempty"`
}

// NetworkEntry summarises a captured fetch/XHR request.
type NetworkEntry struct {
	URL       string `json:"url"`
	Method    string `json:"method"`
	Status    int    `json:"status,omitempty"`
	Resource  string `json:"resource,omitempty"`
	OK        bool   `json:"ok,omitempty"`
	Error     string `json:"error,omitempty"`
	Timestamp int64  `json:"timestamp,omitempty"`
}

// PDFResult contains exported PDF bytes encoded for transport.
type PDFResult struct {
	Base64   string `json:"base64"`
	MimeType string `json:"mimeType"` // always "application/pdf"
}