Method putUserAppearanceSettings

coderd/users.go:1172–1273

@Summary Update user appearance settings @ID update-user-appearance-settings @Security CoderSessionToken @Accept json @Produce json @Tags Users @Param user path string true "User ID, name, or me" @Param request body codersdk.UpdateUserAppearanceSettingsRequest true "New appearance settings" @Success

(rw http.ResponseWriter, r *http.Request)

// @Success 200 {object} codersdk.UserAppearanceSettings
// @Router /api/v2/users/{user}/appearance [put]
func (api *API) putUserAppearanceSettings(rw http.ResponseWriter, r *http.Request) {
	var (
		ctx  = r.Context()
		user = httpmw.UserParam(r)
	)

	var params codersdk.UpdateUserAppearanceSettingsRequest
	if !httpapi.Read(ctx, rw, r, &params) {
		return
	}

	if !isValidFontName(params.TerminalFont) {
		httpapi.Write(ctx, rw, http.StatusBadRequest, codersdk.Response{
			Message: "Unsupported font family.",
		})
		return
	}

	// theme_mode is optional for backward compatibility. Older CLI
	// clients do not know about theme_mode or the sync slots, so an
	// omitted mode must leave those fields untouched instead of replacing
	// them with single-mode defaults. Legacy auto values are the exception:
	// the old UI used them to mean sync-with-system, so clearing theme_mode
	// lets modern clients migrate them on read.
	themeModeProvided := params.ThemeMode != codersdk.ThemeModeUnset
	updateThemeMode := themeModeProvided
	isSyncMode := params.ThemeMode == codersdk.ThemeModeSync
	isSingleMode := params.ThemeMode == codersdk.ThemeModeSingle
	updateThemeLight := isSyncMode || (isSingleMode && params.ThemeLight != "")
	updateThemeDark := isSyncMode || (isSingleMode && params.ThemeDark != "")
	themeMode := params.ThemeMode
	if !updateThemeMode && isLegacyAutoThemePreference(params.ThemePreference) {
		updateThemeMode = true
		themeMode = codersdk.ThemeModeUnset
	}

	var updatedSettings database.GetUserAppearanceSettingsRow

	err := api.Database.InTx(func(tx database.Store) error {
		_, err := tx.UpdateUserThemePreference(ctx, database.UpdateUserThemePreferenceParams{
			UserID:          user.ID,
			ThemePreference: params.ThemePreference,
		})
		if err != nil {
			return xerrors.Errorf("update user theme preference: %w", err)
		}

		if updateThemeMode {
			_, err = tx.UpdateUserThemeMode(ctx, database.UpdateUserThemeModeParams{
				UserID:    user.ID,
				ThemeMode: string(themeMode),
			})
			if err != nil {
				return xerrors.Errorf("update user theme mode: %w", err)
			}
		}

		if updateThemeLight {