go-proxy/api/router.go

// Package api implements the HTTP monitoring endpoints for the proxy.
//
// Registered routes:
//
//	GET /1/summary — aggregated proxy stats
//	GET /1/workers — per-worker hashrate table
//	GET /1/miners  — per-connection state table
//
//	proxyapi.RegisterRoutes(apiRouter, p)
package api

import (
	"encoding/json"
	"net/http"

	"dappco.re/go/proxy"
)

// Router matches the standard http.ServeMux registration shape.
type Router interface {
	HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))
}

// RegisterRoutes wires the monitoring endpoints onto the supplied router.
//
//	mux := http.NewServeMux()
//	proxyapi.RegisterRoutes(mux, p)
//	// GET /1/summary, /1/workers, and /1/miners are now live.
func RegisterRoutes(router Router, p *proxy.Proxy) {
	if router == nil || p == nil {
		return
	}
	registerGETRoute(router, "/1/summary", func() any { return p.SummaryDocument() })
	registerGETRoute(router, "/1/workers", func() any { return p.WorkersDocument() })
	registerGETRoute(router, "/1/miners", func() any { return p.MinersDocument() })
}

func registerGETRoute(router Router, pattern string, document func() any) {
	router.HandleFunc(pattern, func(w http.ResponseWriter, request *http.Request) {
		if request.Method != http.MethodGet {
			w.WriteHeader(http.StatusMethodNotAllowed)
			return
		}
		writeJSON(w, document())
	})
}

func writeJSON(w http.ResponseWriter, payload any) {
	w.Header().Set("Content-Type", "application/json")
	_ = json.NewEncoder(w).Encode(payload)
}