/* GoToSocial Copyright (C) 2021-2022 GoToSocial Authors admin@gotosocial.org This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see . */ package admin import ( "errors" "fmt" "net/http" "strings" "github.com/gin-gonic/gin" apimodel "github.com/superseriousbusiness/gotosocial/internal/api/model" apiutil "github.com/superseriousbusiness/gotosocial/internal/api/util" "github.com/superseriousbusiness/gotosocial/internal/config" "github.com/superseriousbusiness/gotosocial/internal/gtserror" "github.com/superseriousbusiness/gotosocial/internal/oauth" "github.com/superseriousbusiness/gotosocial/internal/validate" ) // EmojiPATCHHandler swagger:operation PATCH /api/v1/admin/custom_emojis/{id} emojiUpdate // // Perform admin action on a local or remote emoji known to this instance. // // Action performed depends upon the action `type` provided. // // `disable`: disable a REMOTE emoji from being used/displayed on this instance. Does not work for local emojis. // // `copy`: copy a REMOTE emoji to this instance. When doing this action, a shortcode MUST be provided, and it must // be unique among emojis already present on this instance. A category MAY be provided, and the copied emoji will then // be put into the provided category. // // `modify`: modify a LOCAL emoji. You can provide a new image for the emoji and/or update the category. // // Local emojis cannot be deleted using this endpoint. To delete a local emoji, check DELETE /api/v1/admin/custom_emojis/{id} instead. // // --- // tags: // - admin // // consumes: // - multipart/form-data // // produces: // - application/json // // parameters: // - // name: id // type: string // description: The id of the emoji. // in: path // required: true // - // name: type // in: formData // description: |- // Type of action to be taken. One of: (`disable`, `copy`, `modify`). // For REMOTE emojis, `copy` or `disable` are supported. // For LOCAL emojis, only `modify` is supported. // type: string // required: true // - // name: shortcode // in: formData // description: >- // The code to use for the emoji, which will be used by instance denizens to select it. // This must be unique on the instance. Works for the `copy` action type only. // type: string // pattern: \w{2,30} // - // name: image // in: formData // description: >- // A new png or gif image to use for the emoji. Animated pngs work too! // To ensure compatibility with other fedi implementations, emoji size limit is 50kb by default. // Works for LOCAL emojis only. // type: file // - // name: category // in: formData // description: >- // Category in which to place the emoji. 64 characters or less. // If a category with the given name doesn't exist yet, it will be created. // type: string // // security: // - OAuth2 Bearer: // - admin // // responses: // '200': // description: The updated emoji. // schema: // "$ref": "#/definitions/adminEmoji" // '400': // description: bad request // '401': // description: unauthorized // '403': // description: forbidden // '404': // description: not found // '406': // description: not acceptable // '500': // description: internal server error func (m *Module) EmojiPATCHHandler(c *gin.Context) { authed, err := oauth.Authed(c, true, true, true, true) if err != nil { apiutil.ErrorHandler(c, gtserror.NewErrorUnauthorized(err, err.Error()), m.processor.InstanceGet) return } if !*authed.User.Admin { err := fmt.Errorf("user %s not an admin", authed.User.ID) apiutil.ErrorHandler(c, gtserror.NewErrorForbidden(err, err.Error()), m.processor.InstanceGet) return } if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { apiutil.ErrorHandler(c, gtserror.NewErrorNotAcceptable(err, err.Error()), m.processor.InstanceGet) return } emojiID := c.Param(IDKey) if emojiID == "" { err := errors.New("no emoji id specified") apiutil.ErrorHandler(c, gtserror.NewErrorBadRequest(err, err.Error()), m.processor.InstanceGet) return } form := &apimodel.EmojiUpdateRequest{} if err := c.ShouldBind(form); err != nil { apiutil.ErrorHandler(c, gtserror.NewErrorBadRequest(err, err.Error()), m.processor.InstanceGet) return } if err := validateUpdateEmoji(form); err != nil { apiutil.ErrorHandler(c, gtserror.NewErrorBadRequest(err, err.Error()), m.processor.InstanceGet) return } emoji, errWithCode := m.processor.AdminEmojiUpdate(c.Request.Context(), emojiID, form) if errWithCode != nil { apiutil.ErrorHandler(c, errWithCode, m.processor.InstanceGet) return } c.JSON(http.StatusOK, emoji) } // do a first pass on the form here func validateUpdateEmoji(form *apimodel.EmojiUpdateRequest) error { // check + normalize update type so we don't need // to do this trimming + lowercasing again later switch strings.TrimSpace(strings.ToLower(string(form.Type))) { case string(apimodel.EmojiUpdateDisable): // no params required for this one, so don't bother checking form.Type = apimodel.EmojiUpdateDisable case string(apimodel.EmojiUpdateCopy): // need at least a valid shortcode when doing a copy if form.Shortcode == nil { return errors.New("emoji action type was 'copy' but no shortcode was provided") } if err := validate.EmojiShortcode(*form.Shortcode); err != nil { return err } // category optional during copy if form.CategoryName != nil { if err := validate.EmojiCategory(*form.CategoryName); err != nil { return err } } form.Type = apimodel.EmojiUpdateCopy case string(apimodel.EmojiUpdateModify): // need either image or category name for modify hasImage := form.Image != nil && form.Image.Size != 0 hasCategoryName := form.CategoryName != nil if !hasImage && !hasCategoryName { return errors.New("emoji action type was 'modify' but no image or category name was provided") } if hasImage { maxSize := config.GetMediaEmojiLocalMaxSize() if form.Image.Size > int64(maxSize) { return fmt.Errorf("emoji image too large: image is %dKB but size limit for custom emojis is %dKB", form.Image.Size/1024, maxSize/1024) } } if hasCategoryName { if err := validate.EmojiCategory(*form.CategoryName); err != nil { return err } } form.Type = apimodel.EmojiUpdateModify default: return errors.New("emoji action type must be one of 'disable', 'copy', 'modify'") } return nil }