feat: enable enterprise users to specify a custom logo (#5566)

* feat: enable enterprise users to specify a custom logo

This adds a field in deployment settings that allows users to specify
the URL to a custom logo that will display in the dashboard.

This also groups service banner into a new appearance settings page.
It adds a Fieldset component to allow for modular fields moving forward.

* Fix tests

enterprise/coderd/appearance.go

@@ -0,0 +1,126 @@
+package coderd
+
+import (
+	"database/sql"
+	"encoding/hex"
+	"encoding/json"
+	"errors"
+	"fmt"
+	"net/http"
+
+	"golang.org/x/xerrors"
+
+	"github.com/coder/coder/coderd/httpapi"
+	"github.com/coder/coder/coderd/rbac"
+	"github.com/coder/coder/codersdk"
+)
+
+func (api *API) appearance(rw http.ResponseWriter, r *http.Request) {
+	api.entitlementsMu.RLock()
+	isEntitled := api.entitlements.Features[codersdk.FeatureAppearance].Entitlement == codersdk.EntitlementEntitled
+	api.entitlementsMu.RUnlock()
+
+	ctx := r.Context()
+
+	if !isEntitled {
+		httpapi.Write(ctx, rw, http.StatusOK, codersdk.AppearanceConfig{})
+		return
+	}
+
+	logoURL, err := api.Database.GetLogoURL(ctx)
+	if err != nil && !errors.Is(err, sql.ErrNoRows) {
+		httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
+			Message: "Failed to fetch logo URL.",
+			Detail:  err.Error(),
+		})
+		return
+	}
+
+	serviceBannerJSON, err := api.Database.GetServiceBanner(r.Context())
+	if err != nil && !errors.Is(err, sql.ErrNoRows) {
+		httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
+			Message: "Failed to fetch service banner.",
+			Detail:  err.Error(),
+		})
+		return
+	}
+
+	cfg := codersdk.AppearanceConfig{
+		LogoURL: logoURL,
+	}
+	if serviceBannerJSON != "" {
+		err = json.Unmarshal([]byte(serviceBannerJSON), &cfg.ServiceBanner)
+		if err != nil {
+			httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
+				Message: fmt.Sprintf(
+					"unmarshal json: %+v, raw: %s", err, serviceBannerJSON,
+				),
+			})
+			return
+		}
+	}
+
+	httpapi.Write(r.Context(), rw, http.StatusOK, cfg)
+}
+
+func validateHexColor(color string) error {
+	if len(color) != 7 {
+		return xerrors.New("expected 7 characters")
+	}
+	if color[0] != '#' {
+		return xerrors.New("no # prefix")
+	}
+	_, err := hex.DecodeString(color[1:])
+	return err
+}
+
+func (api *API) putAppearance(rw http.ResponseWriter, r *http.Request) {
+	ctx := r.Context()
+
+	if !api.Authorize(r, rbac.ActionUpdate, rbac.ResourceDeploymentConfig) {
+		httpapi.Write(ctx, rw, http.StatusForbidden, codersdk.Response{
+			Message: "Insufficient permissions to update appearance",
+		})
+		return
+	}
+
+	var appearance codersdk.AppearanceConfig
+	if !httpapi.Read(ctx, rw, r, &appearance) {
+		return
+	}
+
+	if appearance.ServiceBanner.Enabled {
+		if err := validateHexColor(appearance.ServiceBanner.BackgroundColor); err != nil {
+			httpapi.Write(ctx, rw, http.StatusBadRequest, codersdk.Response{
+				Message: fmt.Sprintf("parse color: %+v", err),
+			})
+			return
+		}
+	}
+
+	serviceBannerJSON, err := json.Marshal(appearance.ServiceBanner)
+	if err != nil {
+		httpapi.Write(ctx, rw, http.StatusBadRequest, codersdk.Response{
+			Message: fmt.Sprintf("marshal banner: %+v", err),
+		})
+		return
+	}
+
+	err = api.Database.InsertOrUpdateServiceBanner(ctx, string(serviceBannerJSON))
+	if err != nil {
+		httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
+			Message: fmt.Sprintf("database error: %+v", err),
+		})
+		return
+	}
+
+	err = api.Database.InsertOrUpdateLogoURL(ctx, appearance.LogoURL)
+	if err != nil {
+		httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
+			Message: fmt.Sprintf("database error: %+v", err),
+		})
+		return
+	}
+
+	httpapi.Write(r.Context(), rw, http.StatusOK, appearance)
+}