Publish ITWorx Pulse source

internal/arrayapi/handler.go

@@ -0,0 +1,52 @@
+package arrayapi
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"net/http"
+	"time"
+
+	"github.com/itworx/pulse/internal/array"
+	"github.com/itworx/pulse/internal/auth"
+	"github.com/itworx/pulse/internal/problem"
+)
+
+type Handler struct{ Provider array.Provider }
+
+func (h Handler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
+	if r.Method != http.MethodGet || r.URL.Path != "/api/v1/array" {
+		http.NotFound(w, r)
+		return
+	}
+	if _, ok := auth.PrincipalFromContext(r.Context()); !ok {
+		problem.Write(w, r, http.StatusUnauthorized, "UNAUTHORIZED", "Authentication required", "Authentication is required to read array status.", nil)
+		return
+	}
+	if err := r.Context().Err(); err != nil {
+		return
+	}
+	var snapshot array.Snapshot
+	var err error
+	if h.Provider == nil {
+		snapshot = array.UnknownSnapshot(time.Now().UTC(), "array", "unraid", "source_unavailable")
+	} else {
+		snapshot, err = h.Provider.Snapshot(r.Context())
+	}
+	if err != nil {
+		if errors.Is(err, context.Canceled) || errors.Is(err, context.DeadlineExceeded) || errors.Is(r.Context().Err(), context.Canceled) {
+			return
+		}
+		problem.Write(w, r, http.StatusServiceUnavailable, "ARRAY_UNAVAILABLE", "Array status unavailable", "De arraystatus kon niet worden gelezen.", nil)
+		return
+	}
+	if snapshot.Members == nil {
+		snapshot.Members = []array.Member{}
+	}
+	if snapshot.History == nil {
+		snapshot.History = []array.Check{}
+	}
+	w.Header().Set("Content-Type", "application/json")
+	w.Header().Set("Cache-Control", "private, max-age=5")
+	_ = json.NewEncoder(w).Encode(snapshot)
+}

internal/arrayapi/handler_test.go

@@ -0,0 +1,63 @@
+package arrayapi
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+	"time"
+
+	"github.com/itworx/pulse/internal/array"
+	"github.com/itworx/pulse/internal/auth"
+)
+
+type provider struct{ snapshot array.Snapshot }
+
+func (p provider) Snapshot(context.Context) (array.Snapshot, error) { return p.snapshot, nil }
+func authenticatedRequest(method, path string) *http.Request {
+	request := httptest.NewRequest(method, path, nil)
+	return request.WithContext(auth.WithPrincipal(request.Context(), auth.Principal{Subject: "viewer", Role: auth.RoleViewer}))
+}
+
+func TestHandlerRequiresAuthenticationAndReturnsUnknown(t *testing.T) {
+	unauthenticated := httptest.NewRecorder()
+	Handler{}.ServeHTTP(unauthenticated, httptest.NewRequest(http.MethodGet, "/api/v1/array", nil))
+	if unauthenticated.Code != http.StatusUnauthorized {
+		t.Fatalf("status=%d", unauthenticated.Code)
+	}
+	response := httptest.NewRecorder()
+	Handler{}.ServeHTTP(response, authenticatedRequest(http.MethodGet, "/api/v1/array"))
+	if response.Code != http.StatusOK || !strings.Contains(response.Body.String(), `"state":"unknown"`) {
+		t.Fatalf("status=%d body=%s", response.Code, response.Body.String())
+	}
+}
+func TestHandlerReturnsSnapshotAndRejectsMutations(t *testing.T) {
+	snapshot := array.UnknownSnapshot(time.Date(2026, 8, 1, 12, 0, 0, 0, time.UTC), "fixture-array", "fixture", "test")
+	response := httptest.NewRecorder()
+	Handler{Provider: provider{snapshot: snapshot}}.ServeHTTP(response, authenticatedRequest(http.MethodGet, "/api/v1/array"))
+	if response.Code != http.StatusOK || !strings.Contains(response.Body.String(), `"id":"fixture-array"`) {
+		t.Fatalf("status=%d body=%s", response.Code, response.Body.String())
+	}
+	mutation := httptest.NewRecorder()
+	Handler{}.ServeHTTP(mutation, authenticatedRequest(http.MethodPost, "/api/v1/array/check"))
+	if mutation.Code != http.StatusNotFound {
+		t.Fatalf("status=%d", mutation.Code)
+	}
+}
+
+func TestHandlerEncodesEmptyCollectionsAsArrays(t *testing.T) {
+	response := httptest.NewRecorder()
+	Handler{Provider: provider{snapshot: array.Snapshot{}}}.ServeHTTP(response, authenticatedRequest(http.MethodGet, "/api/v1/array"))
+	var body struct {
+		Members []array.Member `json:"members"`
+		History []array.Check  `json:"history"`
+	}
+	if err := json.Unmarshal(response.Body.Bytes(), &body); err != nil {
+		t.Fatal(err)
+	}
+	if body.Members == nil || body.History == nil {
+		t.Fatalf("empty collections must be JSON arrays: %s", response.Body.String())
+	}
+}