homebox/backend/internal/web/adapters/query.go

package adapters

import (
	"net/http"

	"github.com/hay-kot/homebox/backend/pkgs/server"
)

// Query is a server.Handler that decodes a query from the request and calls the provided function.
//
// Example:
//
//	type Query struct {
//	    Foo string `schema:"foo"`
//	}
//
//	fn := func(ctx context.Context, q Query) (any, error) {
//	    // do something with q
//		return nil, nil
//	}
//
//	r.Get("/foo", adapters.Query(fn, http.StatusOK))
func Query[T any, Y any](f AdapterFunc[T, Y], ok int) server.HandlerFunc {
	return func(w http.ResponseWriter, r *http.Request) error {
		q, err := decodeQuery[T](r)
		if err != nil {
			return err
		}

		res, err := f(r.Context(), q)
		if err != nil {
			return err
		}

		return server.Respond(w, ok, res)
	}
}

// QueryID is a server.Handler that decodes a query and an ID from the request and calls the provided function.
//
// Example:
//
//	type Query struct {
//	    Foo string `schema:"foo"`
//	}
//
//	fn := func(ctx context.Context, ID uuid.UUID, q Query) (any, error) {
//	    // do something with ID and q
//		return nil, nil
//	}
//
//	r.Get("/foo/{id}", adapters.QueryID(fn, http.StatusOK))
func QueryID[T any, Y any](param string, f IDFunc[T, Y], ok int) server.HandlerFunc {
	return func(w http.ResponseWriter, r *http.Request) error {
		ID, err := routeUUID(r, param)
		if err != nil {
			return err
		}

		q, err := decodeQuery[T](r)
		if err != nil {
			return err
		}

		res, err := f(r.Context(), ID, q)
		if err != nil {
			return err
		}

		return server.Respond(w, ok, res)
	}
}