package gotelem // this file defines the HTTP handlers and routes. import ( "encoding/json" "fmt" "net/http" "github.com/go-chi/chi/v5" "github.com/go-chi/chi/v5/middleware" "github.com/google/uuid" "github.com/kschamplin/gotelem/internal/db" "github.com/kschamplin/gotelem/skylab" "golang.org/x/exp/slog" "nhooyr.io/websocket" "nhooyr.io/websocket/wsjson" ) type slogHttpLogger struct { slog.Logger } func TelemRouter(log *slog.Logger, broker *Broker, db *db.TelemDb) http.Handler { r := chi.NewRouter() r.Use(middleware.RequestID) r.Use(middleware.RealIP) r.Use(middleware.Logger) // TODO: integrate with slog instead of go default logger. r.Use(middleware.Recoverer) r.Get("/schema", func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") // return the spicy json response. w.WriteHeader(http.StatusOK) w.Write([]byte(skylab.SkylabDefinitions)) }) // heartbeat request. r.Get("/ping", func(w http.ResponseWriter, r *http.Request) { w.Write([]byte("pong")) }) r.Mount("/api/v1", apiV1(broker, db)) // To future residents - you can add new API calls/systems in /api/v2 // Don't break anything in api v1! keep legacy code working! // serve up a local status page. return r } // define API version 1 routes. func apiV1(broker *Broker, db *db.TelemDb) chi.Router { r := chi.NewRouter() // this API only accepts JSON. r.Use(middleware.AllowContentType("application/json")) // no caching - always get the latest data. // TODO: add a smart short expiry cache for queries that take a while. r.Use(middleware.NoCache) r.Get("/schema", func(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") // return the Skylab JSON definitions w.Write([]byte(skylab.SkylabDefinitions)) }) r.Route("/packets", func(r chi.Router) { r.Get("/subscribe", apiV1PacketSubscribe(broker, db)) r.Post("/", func(w http.ResponseWriter, r *http.Request) { var pkgs []skylab.BusEvent decoder := json.NewDecoder(r.Body) if err := decoder.Decode(&pkgs); err != nil { w.WriteHeader(http.StatusTeapot) return } // we have a list of packets now. let's commit them. db.AddEvents(pkgs...) }) r.Get("/", func(w http.ResponseWriter, r *http.Request) { // this should use http query params to return a list of packets. }) // this is to get packets by a name. r.Get("/{name:[a-z_]+}", func(w http.ResponseWriter, r *http.Request) { // support field getting (matching too?) // support limit }) }) // records are driving segments/runs. r.Route("/records", func(r chi.Router) { r.Get("/", apiV1GetRecords(db)) // get all runs r.Get("/active", apiV1GetActiveRecord(db)) // get current run (no end time) r.Post("/", apiV1StartRecord(db)) // create a new run (with note). Ends active run if any, and creates new active run (no end time) r.Get("/{id}", apiV1GetRecord(db)) // get details on a specific run r.Put("/{id}", apiV1UpdateRecord(db)) // update a specific run. Can only be used to add notes/metadata, and not to change time/id. }) r.Get("/stats", func(w http.ResponseWriter, r *http.Request) { }) // v1 api stats (calls, clients, xbee connected, meta health ok) return r } // apiV1Subscriber is a websocket session for the v1 api. type apiV1Subscriber struct { idFilter []uint32 // list of Ids to subscribe to. If it's empty, subscribes to all. } // this is a websocket stream. func apiV1PacketSubscribe(broker *Broker, db *db.TelemDb) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { conn_id := r.RemoteAddr + uuid.New().String() sub, err := broker.Subscribe(conn_id) if err != nil { w.WriteHeader(http.StatusInternalServerError) fmt.Fprintf(w, "error subscribing: %s", err) return } defer broker.Unsubscribe(conn_id) // attempt to upgrade. c, err := websocket.Accept(w, r, nil) c.Ping(r.Context()) if err != nil { // TODO: is this the correct option? w.WriteHeader(http.StatusInternalServerError) fmt.Fprintf(w, "error ws handshake: %s", err) return } // TODO: use K/V with session token? sess := &apiV1Subscriber{} for { select { case <-r.Context().Done(): return case msgIn := <-sub: if len(sess.idFilter) == 0 { // send it. wsjson.Write(r.Context(), c, msgIn) } for _, id := range sess.idFilter { if id == msgIn.Id { // send it break } } } } } } // TODO: rename. record is not a clear name. Runs? drives? segments? func apiV1GetRecords(db *db.TelemDb) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { } } func apiV1GetActiveRecord(db *db.TelemDb) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) { } } func apiV1StartRecord(db *db.TelemDb) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) {} } func apiV1GetRecord(db *db.TelemDb) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) {} } func apiV1UpdateRecord(db *db.TelemDb) http.HandlerFunc { return func(w http.ResponseWriter, r *http.Request) {} }