DRAFT: feat: webview commands for listing and evaluating js

commands/webview.go

@@ -0,0 +1,72 @@
+package commands
+
+import "fmt"
+
+// ─── Request types ────────────────────────────────────────────
+
+type WebViewListRequest struct {
+	DeviceID string
+}
+
+// WebViewRequest is the base for all webview operations that target a specific webview.
+type WebViewRequest struct {
+	DeviceID  string
+	WebViewID string
+}
+
+type WebViewGotoRequest struct {
+	DeviceID  string
+	WebViewID string
+	URL       string
+	WaitUntil string
+}
+
+type WebViewReloadRequest struct {
+	DeviceID  string
+	WebViewID string
+	WaitUntil string
+}
+
+type WebViewEvaluateRequest struct {
+	DeviceID   string
+	WebViewID  string
+	Expression string
+	Args       []any
+}
+
+type WebViewWaitForLoadStateRequest struct {
+	DeviceID  string
+	WebViewID string
+	State     string
+	Timeout   int
+}
+
+// ─── Stubs ────────────────────────────────────────────────────
+
+func WebViewListCommand(req WebViewListRequest) *CommandResponse {
+	return NewErrorResponse(fmt.Errorf("not implemented"))
+}
+
+func WebViewGotoCommand(req WebViewGotoRequest) *CommandResponse {
+	return NewErrorResponse(fmt.Errorf("not implemented"))
+}
+
+func WebViewReloadCommand(req WebViewReloadRequest) *CommandResponse {
+	return NewErrorResponse(fmt.Errorf("not implemented"))
+}
+
+func WebViewGoBackCommand(req WebViewRequest) *CommandResponse {
+	return NewErrorResponse(fmt.Errorf("not implemented"))
+}
+
+func WebViewGoForwardCommand(req WebViewRequest) *CommandResponse {
+	return NewErrorResponse(fmt.Errorf("not implemented"))
+}
+
+func WebViewEvaluateCommand(req WebViewEvaluateRequest) *CommandResponse {
+	return NewErrorResponse(fmt.Errorf("not implemented"))
+}
+
+func WebViewWaitForLoadStateCommand(req WebViewWaitForLoadStateRequest) *CommandResponse {
+	return NewErrorResponse(fmt.Errorf("not implemented"))
+}

server/dispatch.go

@@ -39,6 +39,13 @@ func GetMethodRegistry() map[string]HandlerFunc {
 		"device.screenrecord.stop":  handleScreenRecordStop,
 		"device.crashes.list":       handleCrashesList,
 		"device.crashes.get":        handleCrashesGet,
+		"device.webview.list":             handleWebViewList,
+		"device.webview.goto":             handleWebViewGoto,
+		"device.webview.reload":           handleWebViewReload,
+		"device.webview.goBack":           handleWebViewGoBack,
+		"device.webview.goForward":        handleWebViewGoForward,
+		"device.webview.evaluate":         handleWebViewEvaluate,
+		"device.webview.waitForLoadState": handleWebViewWaitForLoadState,
 		"server.info":               handleServerInfo,
 		"server.shutdown":           handleServerShutdown,
 	}

server/webview_handlers.go

@@ -0,0 +1,192 @@
+package server
+
+import (
+	"encoding/json"
+	"fmt"
+
+	"github.com/mobile-next/mobilecli/commands"
+)
+
+// ─── Params structs ───────────────────────────────────────────
+
+type WebViewListParams struct {
+	DeviceID string `json:"deviceId"`
+}
+
+type WebViewParams struct {
+	DeviceID  string `json:"deviceId"`
+	WebViewID string `json:"id"`
+}
+
+type WebViewGotoParams struct {
+	DeviceID  string `json:"deviceId"`
+	WebViewID string `json:"id"`
+	URL       string `json:"url"`
+	WaitUntil string `json:"waitUntil,omitempty"`
+}
+
+type WebViewReloadParams struct {
+	DeviceID  string `json:"deviceId"`
+	WebViewID string `json:"id"`
+	WaitUntil string `json:"waitUntil,omitempty"`
+}
+
+type WebViewEvaluateParams struct {
+	DeviceID   string `json:"deviceId"`
+	WebViewID  string `json:"id"`
+	Expression string `json:"expression"`
+	Args       []any  `json:"args,omitempty"`
+}
+
+type WebViewWaitForLoadStateParams struct {
+	DeviceID  string `json:"deviceId"`
+	WebViewID string `json:"id"`
+	State     string `json:"state,omitempty"`
+	Timeout   int    `json:"timeout,omitempty"`
+}
+
+// ─── Shared helpers ───────────────────────────────────────────
+
+func unmarshal[T any](params json.RawMessage) (T, error) {
+	var p T
+	if err := json.Unmarshal(params, &p); err != nil {
+		return p, fmt.Errorf("invalid parameters: %w", err)
+	}
+	return p, nil
+}
+
+func resultOf(resp *commands.CommandResponse) (any, error) {
+	if resp.Status == "error" {
+		return nil, fmt.Errorf("%s", resp.Error)
+	}
+	return resp.Data, nil
+}
+
+func voidOf(resp *commands.CommandResponse) (any, error) {
+	if resp.Status == "error" {
+		return nil, fmt.Errorf("%s", resp.Error)
+	}
+	return okResponse, nil
+}
+
+func requireWebViewParams(deviceID, webViewID string) error {
+	if deviceID == "" {
+		return fmt.Errorf("deviceId is required")
+	}
+	if webViewID == "" {
+		return fmt.Errorf("id is required")
+	}
+	return nil
+}
+
+// ─── Handlers ─────────────────────────────────────────────────
+
+func handleWebViewList(params json.RawMessage) (any, error) {
+	p, err := unmarshal[WebViewListParams](params)
+	if err != nil {
+		return nil, err
+	}
+	if p.DeviceID == "" {
+		return nil, fmt.Errorf("deviceId is required")
+	}
+	return resultOf(commands.WebViewListCommand(commands.WebViewListRequest{
+		DeviceID: p.DeviceID,
+	}))
+}
+
+func handleWebViewGoto(params json.RawMessage) (any, error) {
+	p, err := unmarshal[WebViewGotoParams](params)
+	if err != nil {
+		return nil, err
+	}
+	if err := requireWebViewParams(p.DeviceID, p.WebViewID); err != nil {
+		return nil, err
+	}
+	if p.URL == "" {
+		return nil, fmt.Errorf("url is required")
+	}
+	return voidOf(commands.WebViewGotoCommand(commands.WebViewGotoRequest{
+		DeviceID:  p.DeviceID,
+		WebViewID: p.WebViewID,
+		URL:       p.URL,
+		WaitUntil: p.WaitUntil,
+	}))
+}
+
+func handleWebViewReload(params json.RawMessage) (any, error) {
+	p, err := unmarshal[WebViewReloadParams](params)
+	if err != nil {
+		return nil, err
+	}
+	if err := requireWebViewParams(p.DeviceID, p.WebViewID); err != nil {
+		return nil, err
+	}
+	return voidOf(commands.WebViewReloadCommand(commands.WebViewReloadRequest{
+		DeviceID:  p.DeviceID,
+		WebViewID: p.WebViewID,
+		WaitUntil: p.WaitUntil,
+	}))
+}
+
+func handleWebViewGoBack(params json.RawMessage) (any, error) {
+	p, err := unmarshal[WebViewParams](params)
+	if err != nil {
+		return nil, err
+	}
+	if err := requireWebViewParams(p.DeviceID, p.WebViewID); err != nil {
+		return nil, err
+	}
+	return voidOf(commands.WebViewGoBackCommand(commands.WebViewRequest{
+		DeviceID:  p.DeviceID,
+		WebViewID: p.WebViewID,
+	}))
+}
+
+func handleWebViewGoForward(params json.RawMessage) (any, error) {
+	p, err := unmarshal[WebViewParams](params)
+	if err != nil {
+		return nil, err
+	}
+	if err := requireWebViewParams(p.DeviceID, p.WebViewID); err != nil {
+		return nil, err
+	}
+	return voidOf(commands.WebViewGoForwardCommand(commands.WebViewRequest{
+		DeviceID:  p.DeviceID,
+		WebViewID: p.WebViewID,
+	}))
+}
+
+func handleWebViewEvaluate(params json.RawMessage) (any, error) {
+	p, err := unmarshal[WebViewEvaluateParams](params)
+	if err != nil {
+		return nil, err
+	}
+	if err := requireWebViewParams(p.DeviceID, p.WebViewID); err != nil {
+		return nil, err
+	}
+	if p.Expression == "" {
+		return nil, fmt.Errorf("expression is required")
+	}
+	return resultOf(commands.WebViewEvaluateCommand(commands.WebViewEvaluateRequest{
+		DeviceID:   p.DeviceID,
+		WebViewID:  p.WebViewID,
+		Expression: p.Expression,
+		Args:       p.Args,
+	}))
+}
+
+func handleWebViewWaitForLoadState(params json.RawMessage) (any, error) {
+	p, err := unmarshal[WebViewWaitForLoadStateParams](params)
+	if err != nil {
+		return nil, err
+	}
+	if err := requireWebViewParams(p.DeviceID, p.WebViewID); err != nil {
+		return nil, err
+	}
+	return voidOf(commands.WebViewWaitForLoadStateCommand(commands.WebViewWaitForLoadStateRequest{
+		DeviceID:  p.DeviceID,
+		WebViewID: p.WebViewID,
+		State:     p.State,
+		Timeout:   p.Timeout,
+	}))
+}