diff --git a/pkg/miniapp/miniapp.go b/pkg/miniapp/miniapp.go
index d34158409..3a3d41599 100644
--- a/pkg/miniapp/miniapp.go
+++ b/pkg/miniapp/miniapp.go
@@ -9,10 +9,12 @@ import (
"encoding/json"
"fmt"
"io"
+ "net"
"net/http"
"net/http/httputil"
"net/url"
"sort"
+ "strconv"
"strings"
"sync"
"time"
@@ -159,10 +161,21 @@ func (n *StateNotifier) Notify() {
}
}
-// DevTargetSetter allows tools to control the dev proxy target.
-type DevTargetSetter interface {
- SetDevTarget(target string) error
+// DevTarget represents a registered dev server target.
+type DevTarget struct {
+ ID string `json:"id"`
+ Name string `json:"name"` // display name (e.g. "frontend")
+ Target string `json:"target"` // URL (e.g. "http://localhost:3000")
+}
+
+// DevTargetManager allows tools to register, activate, and deactivate dev proxy targets.
+type DevTargetManager interface {
+ RegisterDevTarget(name, target string) (id string, err error)
+ UnregisterDevTarget(id string) error
+ ActivateDevTarget(id string) error
+ DeactivateDevTarget() error
GetDevTarget() string
+ ListDevTargets() []DevTarget
}
// Handler serves the Mini App HTML and API endpoints.
@@ -172,48 +185,130 @@ type Handler struct {
botToken string
notifier *StateNotifier
- devMu sync.RWMutex
- devTarget *url.URL
- devProxy *httputil.ReverseProxy
+ devMu sync.RWMutex
+ devTarget *url.URL
+ devProxy *httputil.ReverseProxy
+ devTargets map[string]*DevTarget // registered targets (ID→DevTarget)
+ devNextID int
+ devActiveID string
}
// NewHandler creates a new Mini App handler.
func NewHandler(provider DataProvider, sender CommandSender, botToken string, notifier *StateNotifier) *Handler {
return &Handler{
- provider: provider,
- sender: sender,
- botToken: botToken,
- notifier: notifier,
+ provider: provider,
+ sender: sender,
+ botToken: botToken,
+ notifier: notifier,
+ devTargets: make(map[string]*DevTarget),
}
}
-// SetDevTarget sets the reverse proxy target URL. Only localhost targets are allowed.
-// Pass an empty string to disable the proxy.
-func (h *Handler) SetDevTarget(target string) error {
+// validateLocalhostURL parses and validates that a URL targets localhost.
+func validateLocalhostURL(target string) (*url.URL, error) {
+ u, err := url.Parse(target)
+ if err != nil {
+ return nil, fmt.Errorf("invalid URL: %w", err)
+ }
+ host := u.Hostname()
+ if host != "localhost" && host != "127.0.0.1" && host != "::1" {
+ return nil, fmt.Errorf("only localhost targets are allowed, got %q", host)
+ }
+ return u, nil
+}
+
+// RegisterDevTarget registers a new dev server target. Only localhost targets are allowed.
+func (h *Handler) RegisterDevTarget(name, target string) (string, error) {
+ if _, err := validateLocalhostURL(target); err != nil {
+ return "", err
+ }
+
h.devMu.Lock()
defer h.devMu.Unlock()
- if target == "" {
+ h.devNextID++
+ id := strconv.Itoa(h.devNextID)
+
+ h.devTargets[id] = &DevTarget{ID: id, Name: name, Target: target}
+ if h.notifier != nil {
+ h.notifier.Notify()
+ }
+ return id, nil
+}
+
+// UnregisterDevTarget removes a registered target. If it was active, the proxy is disabled.
+func (h *Handler) UnregisterDevTarget(id string) error {
+ h.devMu.Lock()
+ defer h.devMu.Unlock()
+
+ if _, ok := h.devTargets[id]; !ok {
+ return fmt.Errorf("target %q not found", id)
+ }
+ delete(h.devTargets, id)
+
+ if h.devActiveID == id {
+ h.devActiveID = ""
h.devTarget = nil
h.devProxy = nil
- if h.notifier != nil {
- h.notifier.Notify()
- }
- return nil
+ }
+ if h.notifier != nil {
+ h.notifier.Notify()
+ }
+ return nil
+}
+
+// ActivateDevTarget sets the reverse proxy to the registered target with the given ID.
+func (h *Handler) ActivateDevTarget(id string) error {
+ h.devMu.Lock()
+ defer h.devMu.Unlock()
+
+ dt, ok := h.devTargets[id]
+ if !ok {
+ return fmt.Errorf("target %q not found", id)
}
- u, err := url.Parse(target)
+ u, err := url.Parse(dt.Target)
if err != nil {
return fmt.Errorf("invalid URL: %w", err)
}
- host := u.Hostname()
- if host != "localhost" && host != "127.0.0.1" && host != "::1" {
- return fmt.Errorf("only localhost targets are allowed, got %q", host)
+ // Fix IPv6: resolve "localhost" to 127.0.0.1 to avoid connection refused on systems
+ // where localhost resolves to [::1] but the dev server only listens on IPv4.
+ if u.Hostname() == "localhost" {
+ u.Host = net.JoinHostPort("127.0.0.1", u.Port())
+ }
+
+ proxy := httputil.NewSingleHostReverseProxy(u)
+ proxy.ErrorHandler = func(w http.ResponseWriter, r *http.Request, err error) {
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ w.WriteHeader(http.StatusBadGateway)
+ fmt.Fprintf(w, `
+Cannot connect
%s
Target: %s