Scaffolding baseline

service/internal/api/handlers.go

@@ -0,0 +1,34 @@
+package api
+
+import (
+	"encoding/json"
+	"net/http"
+)
+
+const Version = "0.1.0"
+
+type healthResponse struct {
+	Status string `json:"status"`
+}
+
+type statusResponse struct {
+	Service string `json:"service"`
+	Version string `json:"version"`
+}
+
+func writeJSON(writer http.ResponseWriter, statusCode int, payload any) {
+	writer.Header().Set("Content-Type", "application/json")
+	writer.WriteHeader(statusCode)
+	_ = json.NewEncoder(writer).Encode(payload)
+}
+
+func HealthHandler(writer http.ResponseWriter, request *http.Request) {
+	writeJSON(writer, http.StatusOK, healthResponse{Status: "ok"})
+}
+
+func StatusHandler(writer http.ResponseWriter, request *http.Request) {
+	writeJSON(writer, http.StatusOK, statusResponse{
+		Service: "clustercanvas",
+		Version: Version,
+	})
+}

service/internal/api/handlers_test.go

@@ -0,0 +1,72 @@
+package api
+
+import (
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"testing"
+)
+
+func TestHealthHandler(t *testing.T) {
+	t.Parallel()
+
+	request := httptest.NewRequest(http.MethodGet, "/health", nil)
+	recorder := httptest.NewRecorder()
+
+	NewRouter().ServeHTTP(recorder, request)
+
+	if recorder.Code != http.StatusOK {
+		t.Fatalf("expected status %d, got %d", http.StatusOK, recorder.Code)
+	}
+
+	var payload healthResponse
+	if err := json.NewDecoder(recorder.Body).Decode(&payload); err != nil {
+		t.Fatalf("decode response: %v", err)
+	}
+	if payload.Status != "ok" {
+		t.Fatalf("expected status %q, got %q", "ok", payload.Status)
+	}
+	if contentType := recorder.Header().Get("Content-Type"); contentType != "application/json" {
+		t.Fatalf("expected Content-Type application/json, got %q", contentType)
+	}
+}
+
+func TestStatusHandler(t *testing.T) {
+	t.Parallel()
+
+	request := httptest.NewRequest(http.MethodGet, "/api/v1/status", nil)
+	recorder := httptest.NewRecorder()
+
+	NewRouter().ServeHTTP(recorder, request)
+
+	if recorder.Code != http.StatusOK {
+		t.Fatalf("expected status %d, got %d", http.StatusOK, recorder.Code)
+	}
+
+	var payload statusResponse
+	if err := json.NewDecoder(recorder.Body).Decode(&payload); err != nil {
+		t.Fatalf("decode response: %v", err)
+	}
+	if payload.Service != "clustercanvas" {
+		t.Fatalf("expected service %q, got %q", "clustercanvas", payload.Service)
+	}
+	if payload.Version != Version {
+		t.Fatalf("expected version %q, got %q", Version, payload.Version)
+	}
+}
+
+func TestCORSPreflight(t *testing.T) {
+	t.Parallel()
+
+	request := httptest.NewRequest(http.MethodOptions, "/health", nil)
+	recorder := httptest.NewRecorder()
+
+	NewRouter().ServeHTTP(recorder, request)
+
+	if recorder.Code != http.StatusNoContent {
+		t.Fatalf("expected status %d, got %d", http.StatusNoContent, recorder.Code)
+	}
+	if origin := recorder.Header().Get("Access-Control-Allow-Origin"); origin != defaultAllowedOrigin {
+		t.Fatalf("expected Allow-Origin %q, got %q", defaultAllowedOrigin, origin)
+	}
+}

service/internal/api/router.go

@@ -0,0 +1,29 @@
+package api
+
+import (
+	"net/http"
+)
+
+const defaultAllowedOrigin = "http://localhost:5173"
+
+func withCORS(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(writer http.ResponseWriter, request *http.Request) {
+		writer.Header().Set("Access-Control-Allow-Origin", defaultAllowedOrigin)
+		writer.Header().Set("Access-Control-Allow-Methods", "GET, OPTIONS")
+		writer.Header().Set("Access-Control-Allow-Headers", "Content-Type")
+
+		if request.Method == http.MethodOptions {
+			writer.WriteHeader(http.StatusNoContent)
+			return
+		}
+
+		next.ServeHTTP(writer, request)
+	})
+}
+
+func NewRouter() http.Handler {
+	mux := http.NewServeMux()
+	mux.HandleFunc("GET /health", HealthHandler)
+	mux.HandleFunc("GET /api/v1/status", StatusHandler)
+	return withCORS(mux)
+}