Jason RossandClaude Opus 4.8
499bf7f655
Initialize the Go module and the Go -> Cloudflare Workers (TinyGo/Wasm) build path, structured so `go test` and a local dev server run on plain Go without TinyGo, while the real Wasm entrypoint is isolated behind build tags. - go.mod/go.sum: module github.com/JMR-dev/LibreMail-Bug-Report-Ingest (Go 1.26), requiring github.com/syumai/workers. - internal/handler: build-tag-free core http.Handler (GET / and GET /healthz, JSON responses, 404/405 handling) with net/http/httptest unit tests. - cmd/devserver: plain net/http server mounting the core handler for local dev without TinyGo (listens on :8787, override with ADDR). - worker/main.go: Cloudflare Workers (Wasm) entrypoint behind //go:build js && wasm, wiring the same handler via github.com/syumai/workers; excluded from host builds/tests. - package.json + pnpm-lock.yaml + pnpm-workspace.yaml: wrangler dev dependency managed with pnpm, with toolchain build scripts approved. - wrangler.jsonc: name=libremail-bug-report-ingest, main=./build/worker.mjs, build via `pnpm run build` (TinyGo). - README: "Build & run locally" section with exact commands and the rationale for the TinyGo + syumai/workers path. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
83 lines
2.6 KiB
Go
83 lines
2.6 KiB
Go
// Package handler holds the core, transport-agnostic HTTP handlers for the
|
|
// LibreMail bug-report ingest Worker.
|
|
//
|
|
// It intentionally carries no build constraints, so it compiles and is
|
|
// unit-tested with the standard Go toolchain on the host, and is reused
|
|
// verbatim by both the local dev server (cmd/devserver) and the Cloudflare
|
|
// Worker Wasm entrypoint (worker). Keeping the request logic here means the same
|
|
// http.Handler runs unchanged on the dev server and in the deployed Worker.
|
|
package handler
|
|
|
|
import (
|
|
"encoding/json"
|
|
"net/http"
|
|
)
|
|
|
|
// serviceName identifies this service in responses.
|
|
const serviceName = "libremail-bug-report-ingest"
|
|
|
|
// New returns an http.Handler serving the bootstrap health/hello endpoints:
|
|
//
|
|
// GET / -> 200, JSON service/status/message
|
|
// GET /healthz -> 200, JSON {"status":"ok"}
|
|
//
|
|
// Any other path returns 404 and any non-GET method returns 405.
|
|
func New() http.Handler {
|
|
mux := http.NewServeMux()
|
|
mux.HandleFunc("/healthz", healthz)
|
|
mux.HandleFunc("/", root)
|
|
return mux
|
|
}
|
|
|
|
// root handles the service root. Because "/" is the catch-all pattern in the
|
|
// mux, it also rejects unknown paths with 404.
|
|
func root(w http.ResponseWriter, r *http.Request) {
|
|
if r.URL.Path != "/" {
|
|
writeJSON(w, http.StatusNotFound, response{Status: "error", Error: "not found"})
|
|
return
|
|
}
|
|
if !isGet(w, r) {
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, response{
|
|
Service: serviceName,
|
|
Status: "ok",
|
|
Message: "hello from the LibreMail bug-report ingest Worker",
|
|
})
|
|
}
|
|
|
|
// healthz is a liveness/readiness probe endpoint.
|
|
func healthz(w http.ResponseWriter, r *http.Request) {
|
|
if !isGet(w, r) {
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, response{Status: "ok"})
|
|
}
|
|
|
|
// isGet reports whether the request method is GET. If not, it writes a 405 with
|
|
// an Allow header and returns false.
|
|
func isGet(w http.ResponseWriter, r *http.Request) bool {
|
|
if r.Method != http.MethodGet {
|
|
w.Header().Set("Allow", http.MethodGet)
|
|
writeJSON(w, http.StatusMethodNotAllowed, response{Status: "error", Error: "method not allowed"})
|
|
return false
|
|
}
|
|
return true
|
|
}
|
|
|
|
// response is the JSON body shape returned by every endpoint. Empty fields are
|
|
// omitted so success and error bodies stay minimal.
|
|
type response struct {
|
|
Service string `json:"service,omitempty"`
|
|
Status string `json:"status"`
|
|
Message string `json:"message,omitempty"`
|
|
Error string `json:"error,omitempty"`
|
|
}
|
|
|
|
// writeJSON writes body as JSON with the given status code.
|
|
func writeJSON(w http.ResponseWriter, status int, body response) {
|
|
w.Header().Set("Content-Type", "application/json; charset=utf-8")
|
|
w.WriteHeader(status)
|
|
_ = json.NewEncoder(w).Encode(body)
|
|
}
|