hakurei/cmd/pkgserver/api.go

package main

import (
	"encoding/json"
	"log"
	"net/http"
	"path"
	"strconv"
	"sync"

	"hakurei.app/internal/info"
	"hakurei.app/internal/rosa"
)

// for lazy initialisation of serveInfo
var (
	infoPayload struct {
		// Current package count.
		Count int `json:"count"`
		// Hakurei version, set at link time.
		HakureiVersion string `json:"hakurei_version"`
	}
	infoPayloadOnce sync.Once
)

// handleInfo writes constant system information.
func handleInfo(w http.ResponseWriter, _ *http.Request) {
	infoPayloadOnce.Do(func() {
		infoPayload.Count = int(rosa.PresetUnexportedStart)
		infoPayload.HakureiVersion = info.Version()
	})
	// TODO(mae): cache entire response if no additional fields are planned
	writeAPIPayload(w, infoPayload)
}

// newStatusHandler returns a [http.HandlerFunc] that offers status files for
// viewing or download, if available.
func (index *packageIndex) newStatusHandler(disposition bool) http.HandlerFunc {
	return func(w http.ResponseWriter, r *http.Request) {
		m, ok := index.names[path.Base(r.URL.Path)]
		if !ok || !m.HasReport {
			http.NotFound(w, r)
			return
		}

		contentType := "text/plain; charset=utf-8"
		if disposition {
			contentType = "application/octet-stream"

			// quoting like this is unsound, but okay, because metadata is hardcoded
			contentDisposition := `attachment; filename="`
			contentDisposition += m.Name + "-"
			if m.Version != "" {
				contentDisposition += m.Version + "-"
			}
			contentDisposition += m.ids + `.log"`
			w.Header().Set("Content-Disposition", contentDisposition)
		}
		w.Header().Set("Content-Type", contentType)
		w.Header().Set("Cache-Control", "no-cache, no-store, must-revalidate")
		if err := func() (err error) {
			defer index.handleAccess(&err)()
			_, err = w.Write(m.status)
			return
		}(); err != nil {
			log.Println(err)
			http.Error(
				w, "cannot deliver status, contact maintainers",
				http.StatusInternalServerError,
			)
		}
	}
}

// handleGet writes a slice of metadata with specified order.
func (index *packageIndex) handleGet(w http.ResponseWriter, r *http.Request) {
	q := r.URL.Query()
	limit, err := strconv.Atoi(q.Get("limit"))
	if err != nil || limit > 100 || limit < 1 {
		http.Error(
			w, "limit must be an integer between 1 and 100",
			http.StatusBadRequest,
		)
		return
	}
	i, err := strconv.Atoi(q.Get("index"))
	if err != nil || i >= len(index.sorts[0]) || i < 0 {
		http.Error(
			w, "index must be an integer between 0 and "+
				strconv.Itoa(int(rosa.PresetUnexportedStart-1)),
			http.StatusBadRequest,
		)
		return
	}
	sort, err := strconv.Atoi(q.Get("sort"))
	if err != nil || sort >= len(index.sorts) || sort < 0 {
		http.Error(
			w, "sort must be an integer between 0 and "+
				strconv.Itoa(sortOrderEnd),
			http.StatusBadRequest,
		)
		return
	}
	values := index.sorts[sort][i:min(i+limit, len(index.sorts[sort]))]
	// TODO(mae): remove count field
	writeAPIPayload(w, &struct {
		Count  int         `json:"count"`
		Values []*metadata `json:"values"`
	}{len(values), values})
}

// apiVersion is the name of the current API revision, as part of the pattern.
const apiVersion = "v1"

// registerAPI registers API handler functions.
func (index *packageIndex) registerAPI(mux *http.ServeMux) {
	mux.HandleFunc("GET /api/"+apiVersion+"/info", handleInfo)
	mux.HandleFunc("GET /api/"+apiVersion+"/get", index.handleGet)
	mux.HandleFunc("GET /api/"+apiVersion+"/status/", index.newStatusHandler(false))
	mux.HandleFunc("GET /status/", index.newStatusHandler(true))
}

// writeAPIPayload sets headers common to API responses and encodes payload as
// JSON for the response body.
func writeAPIPayload(w http.ResponseWriter, payload any) {
	w.Header().Set("Content-Type", "application/json; charset=utf-8")
	w.Header().Set("Cache-Control", "no-cache, no-store, must-revalidate")
	w.Header().Set("Pragma", "no-cache")
	w.Header().Set("Expires", "0")

	if err := json.NewEncoder(w).Encode(payload); err != nil {
		log.Println(err)
		http.Error(
			w, "cannot encode payload, contact maintainers",
			http.StatusInternalServerError,
		)
	}
}