label stubs

backend/app/api/v1/partials.go

@@ -0,0 +1,36 @@
+package v1
+
+import (
+	"net/http"
+
+	"github.com/go-chi/chi/v5"
+	"github.com/google/uuid"
+	"github.com/hay-kot/content/backend/internal/services"
+	"github.com/hay-kot/content/backend/internal/types"
+	"github.com/hay-kot/content/backend/pkgs/logger"
+	"github.com/hay-kot/content/backend/pkgs/server"
+)
+
+/*
+This is where we put partial snippets/functions for actions that are commonly
+used within the controller class. This _hopefully_ helps with code duplication
+and makes it a little more consistent when error handling and logging.
+*/
+
+// partialParseIdAndUser parses the ID from the requests URL and pulls the user
+// from the context. If either of these fail, it will return an error. When an error
+// occurs it will also write the error to the response. As such, if an error is returned
+// from this function you can return immediately without writing to the response.
+func (ctrl *V1Controller) partialParseIdAndUser(w http.ResponseWriter, r *http.Request) (uuid.UUID, *types.UserOut, error) {
+	uid, err := uuid.Parse(chi.URLParam(r, "id"))
+	if err != nil {
+		ctrl.log.Debug(err.Error(), logger.Props{
+			"details": "failed to convert id to valid UUID",
+		})
+		server.RespondError(w, http.StatusBadRequest, err)
+		return uuid.Nil, nil, err
+	}
+
+	user := services.UseUserCtx(r.Context())
+	return uid, user, nil
+}

backend/app/api/v1/v1_ctrl_labels.go

@@ -0,0 +1,69 @@
+package v1
+
+import (
+	"net/http"
+)
+
+// HandleLabelsGetAll godoc
+// @Summary   Get All Labels
+// @Tags      Labels
+// @Produce   json
+// @Success   200  {object}  server.Results{items=[]types.LabelOut}
+// @Router    /v1/labels [GET]
+// @Security  Bearer
+func (ctrl *V1Controller) HandleLabelsGetAll() http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+	}
+}
+
+// HandleLabelsCreate godoc
+// @Summary   Create a new label
+// @Tags      Labels
+// @Produce   json
+// @Param     payload  body      types.LabelCreate  true  "Label Data"
+// @Success   200      {object}  types.LabelSummary
+// @Router    /v1/labels [POST]
+// @Security  Bearer
+func (ctrl *V1Controller) HandleLabelsCreate() http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+	}
+}
+
+// HandleLabelDelete godocs
+// @Summary   deletes a label
+// @Tags      Labels
+// @Produce   json
+// @Param     id   path      string  true  "Label ID"
+// @Success   204
+// @Router    /v1/labels/{id} [DELETE]
+// @Security  Bearer
+func (ctrl *V1Controller) HandleLabelDelete() http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+	}
+}
+
+// HandleLabelGet godocs
+// @Summary   Gets a label and fields
+// @Tags      Labels
+// @Produce   json
+// @Param     id   path      string  true  "Label ID"
+// @Success   200  {object}  types.LabelOut
+// @Router    /v1/labels/{id} [GET]
+// @Security  Bearer
+func (ctrl *V1Controller) HandleLabelGet() http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+	}
+}
+
+// HandleLabelUpdate godocs
+// @Summary   updates a label
+// @Tags      Labels
+// @Produce   json
+// @Param     id  path  string  true  "Label ID"
+// @Success   200  {object}  types.LabelOut
+// @Router    /v1/labels/{id} [PUT]
+// @Security  Bearer
+func (ctrl *V1Controller) HandleLabelUpdate() http.HandlerFunc {
+	return func(w http.ResponseWriter, r *http.Request) {
+	}
+}

backend/app/api/v1/v1_ctrl_locations.go

@@ -3,11 +3,8 @@ package v1
 import (
 	"net/http"
 
-	"github.com/go-chi/chi/v5"
-	"github.com/google/uuid"
 	"github.com/hay-kot/content/backend/internal/services"
 	"github.com/hay-kot/content/backend/internal/types"
-	"github.com/hay-kot/content/backend/pkgs/logger"
 	"github.com/hay-kot/content/backend/pkgs/server"
 )
 
@@ -61,20 +58,6 @@ func (ctrl *V1Controller) HandleLocationCreate() http.HandlerFunc {
 	}
 }
 
-func (ctrl *V1Controller) partialParseIdAndUser(w http.ResponseWriter, r *http.Request) (uuid.UUID, *types.UserOut, error) {
-	uid, err := uuid.Parse(chi.URLParam(r, "id"))
-	if err != nil {
-		ctrl.log.Debug(err.Error(), logger.Props{
-			"details": "failed to convert id to valid UUID",
-		})
-		server.RespondError(w, http.StatusBadRequest, err)
-		return uuid.Nil, nil, err
-	}
-
-	user := services.UseUserCtx(r.Context())
-	return uid, user, nil
-}
-
 // HandleLocationDelete godocs
 // @Summary   deletes a location
 // @Tags      Locations