From 11f39bead048821d2508569f339113127c654480 Mon Sep 17 00:00:00 2001 From: tobi Date: Tue, 16 Sep 2025 14:30:39 +0200 Subject: [PATCH] [feature] Stub out trends + suggestions (always return empty array) (#4435) # Description > If this is a code change, please include a summary of what you've coded, and link to the issue(s) it closes/implements. > > If this is a documentation change, please briefly describe what you've changed and why. This pull request stubs out the trends and suggestions APIs, just returning empty arrays for all four of the added endpoints. This is to help clients show fewer errors. It does *not* signal any intention to actually implement these endpoints properly, though you never know. closes https://codeberg.org/superseriousbusiness/gotosocial/issues/4385 ## Checklist Please put an x inside each checkbox to indicate that you've read and followed it: `[ ]` -> `[x]` If this is a documentation change, only the first checkbox must be filled (you can delete the others if you want). - [x] I/we have read the [GoToSocial contribution guidelines](https://codeberg.org/superseriousbusiness/gotosocial/src/branch/main/CONTRIBUTING.md). - [x] I/we have discussed the proposed changes already, either in an issue on the repository, or in the Matrix chat. - [x] I/we have not leveraged AI to create the proposed changes. - [x] I/we have performed a self-review of added code. - [x] I/we have written code that is legible and maintainable by others. - [x] I/we have commented the added code, particularly in hard-to-understand areas. - [x] I/we have made any necessary changes to documentation. - [ ] I/we have added tests that cover new code. - [x] I/we have run tests and they pass locally with the changes. - [x] I/we have run `go fmt ./...` and `golangci-lint run`. Reviewed-on: https://codeberg.org/superseriousbusiness/gotosocial/pulls/4435 Co-authored-by: tobi Co-committed-by: tobi --- docs/api/swagger.yaml | 83 +++++++++++++++++ internal/api/client.go | 8 ++ .../api/client/suggestions/suggestions.go | 93 +++++++++++++++++++ internal/api/client/trends/links.go | 57 ++++++++++++ internal/api/client/trends/statuses.go | 57 ++++++++++++ internal/api/client/trends/tags.go | 57 ++++++++++++ internal/api/client/trends/trends.go | 48 ++++++++++ 7 files changed, 403 insertions(+) create mode 100644 internal/api/client/suggestions/suggestions.go create mode 100644 internal/api/client/trends/links.go create mode 100644 internal/api/client/trends/statuses.go create mode 100644 internal/api/client/trends/tags.go create mode 100644 internal/api/client/trends/trends.go diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml index ae8888af4..7de635d1e 100644 --- a/docs/api/swagger.yaml +++ b/docs/api/swagger.yaml @@ -12115,6 +12115,32 @@ paths: summary: Initiate a websocket connection for live streaming of statuses and notifications. tags: - streaming + /api/v1/suggestions: + get: + description: 'THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array.' + operationId: getSuggestions + produces: + - application/json + responses: + "200": + description: "" + schema: + items: + type: object + maxItems: 0 + type: array + "401": + description: unauthorized + "403": + description: forbidden + "406": + description: not acceptable + security: + - OAuth2 Bearer: + - read + summary: Accounts that are promoted by staff, or that the user has had past positive interactions with, but is not yet following. + tags: + - suggestions /api/v1/tags/{tag_name}: get: description: If the tag does not exist, this method will not create it in the database. @@ -12567,6 +12593,63 @@ paths: summary: Invalidate the target token, removing it from the database and making it unusable. tags: - tokens + /api/v1/trends/links: + get: + description: 'THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array.' + operationId: getTrendingLinks + produces: + - application/json + responses: + "200": + description: "" + schema: + items: + type: object + maxItems: 0 + type: array + "406": + description: not acceptable + summary: Links that have been shared more than others. + tags: + - trends + /api/v1/trends/statuses: + get: + description: 'THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array.' + operationId: getTrendingStatuses + produces: + - application/json + responses: + "200": + description: "" + schema: + items: + type: object + maxItems: 0 + type: array + "406": + description: not acceptable + summary: Statuses that have been interacted with more than others. + tags: + - trends + /api/v1/trends/tags: + get: + description: 'THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array.' + operationId: getTrendingTags + produces: + - application/json + responses: + "200": + description: "" + schema: + items: + type: object + maxItems: 0 + type: array + "406": + description: not acceptable + summary: View hashtags that are currently being used more frequently than usual. + tags: + - trends /api/v1/user: get: operationId: getUser diff --git a/internal/api/client.go b/internal/api/client.go index 829c9326d..45490b843 100644 --- a/internal/api/client.go +++ b/internal/api/client.go @@ -52,9 +52,11 @@ import ( "code.superseriousbusiness.org/gotosocial/internal/api/client/search" "code.superseriousbusiness.org/gotosocial/internal/api/client/statuses" "code.superseriousbusiness.org/gotosocial/internal/api/client/streaming" + "code.superseriousbusiness.org/gotosocial/internal/api/client/suggestions" "code.superseriousbusiness.org/gotosocial/internal/api/client/tags" "code.superseriousbusiness.org/gotosocial/internal/api/client/timelines" "code.superseriousbusiness.org/gotosocial/internal/api/client/tokens" + "code.superseriousbusiness.org/gotosocial/internal/api/client/trends" "code.superseriousbusiness.org/gotosocial/internal/api/client/user" "code.superseriousbusiness.org/gotosocial/internal/db" "code.superseriousbusiness.org/gotosocial/internal/middleware" @@ -100,9 +102,11 @@ type Client struct { search *search.Module // api/v1/search, api/v2/search statuses *statuses.Module // api/v1/statuses streaming *streaming.Module // api/v1/streaming + suggestions *suggestions.Module // api/v2/suggestions tags *tags.Module // api/v1/tags timelines *timelines.Module // api/v1/timelines tokens *tokens.Module // api/v1/tokens + trends *trends.Module // api/v1/trends user *user.Module // api/v1/user } @@ -155,9 +159,11 @@ func (c *Client) Route(r *router.Router, m ...gin.HandlerFunc) { c.search.Route(h) c.statuses.Route(h) c.streaming.Route(h) + c.suggestions.Route(h) c.tags.Route(h) c.timelines.Route(h) c.tokens.Route(h) + c.trends.Route(h) c.user.Route(h) } @@ -198,9 +204,11 @@ func NewClient(state *state.State, p *processing.Processor) *Client { search: search.New(p), statuses: statuses.New(p), streaming: streaming.New(p, time.Second*30, 4096), + suggestions: suggestions.New(p), tags: tags.New(p), timelines: timelines.New(p), tokens: tokens.New(p), + trends: trends.New(p), user: user.New(p), } } diff --git a/internal/api/client/suggestions/suggestions.go b/internal/api/client/suggestions/suggestions.go new file mode 100644 index 000000000..1a63d900e --- /dev/null +++ b/internal/api/client/suggestions/suggestions.go @@ -0,0 +1,93 @@ +// GoToSocial +// Copyright (C) GoToSocial Authors admin@gotosocial.org +// SPDX-License-Identifier: AGPL-3.0-or-later +// +// 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 suggestions + +import ( + "net/http" + + apiutil "code.superseriousbusiness.org/gotosocial/internal/api/util" + "code.superseriousbusiness.org/gotosocial/internal/gtserror" + "code.superseriousbusiness.org/gotosocial/internal/processing" + "github.com/gin-gonic/gin" +) + +const ( + BasePath = "/v2/suggestions" +) + +type Module struct { + processor *processing.Processor +} + +func New(processor *processing.Processor) *Module { + return &Module{ + processor: processor, + } +} + +// SuggestionsGETHandler swagger:operation GET /api/v1/suggestions getSuggestions +// +// Accounts that are promoted by staff, or that the user has had past positive interactions with, but is not yet following. +// +// THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array. +// +// --- +// tags: +// - suggestions +// +// produces: +// - application/json +// +// security: +// - OAuth2 Bearer: +// - read +// +// responses: +// '200': +// schema: +// type: array +// items: +// type: object +// maxItems: 0 +// '401': +// description: unauthorized +// '403': +// description: forbidden +// '406': +// description: not acceptable +func (m *Module) SuggestionsGETHandler(c *gin.Context) { + _, errWithCode := apiutil.TokenAuth(c, + true, true, true, true, + apiutil.ScopeRead, + ) + if errWithCode != nil { + apiutil.ErrorHandler(c, errWithCode, m.processor.InstanceGetV1) + return + } + + if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { + apiutil.ErrorHandler(c, gtserror.NewErrorNotAcceptable(err, err.Error()), m.processor.InstanceGetV1) + return + } + + apiutil.JSON(c, http.StatusOK, apiutil.EmptyJSONArray) +} + +func (m *Module) Route(attachHandler func(method string, path string, f ...gin.HandlerFunc) gin.IRoutes) { + attachHandler(http.MethodGet, BasePath, m.SuggestionsGETHandler) +} diff --git a/internal/api/client/trends/links.go b/internal/api/client/trends/links.go new file mode 100644 index 000000000..72444538e --- /dev/null +++ b/internal/api/client/trends/links.go @@ -0,0 +1,57 @@ +// GoToSocial +// Copyright (C) GoToSocial Authors admin@gotosocial.org +// SPDX-License-Identifier: AGPL-3.0-or-later +// +// 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 trends + +import ( + "net/http" + + apiutil "code.superseriousbusiness.org/gotosocial/internal/api/util" + "code.superseriousbusiness.org/gotosocial/internal/gtserror" + "github.com/gin-gonic/gin" +) + +// LinksGETHandler swagger:operation GET /api/v1/trends/links getTrendingLinks +// +// Links that have been shared more than others. +// +// THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array. +// +// --- +// tags: +// - trends +// +// produces: +// - application/json +// +// responses: +// '200': +// schema: +// type: array +// items: +// type: object +// maxItems: 0 +// '406': +// description: not acceptable +func (m *Module) LinksGETHandler(c *gin.Context) { + if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { + apiutil.ErrorHandler(c, gtserror.NewErrorNotAcceptable(err, err.Error()), m.processor.InstanceGetV1) + return + } + + apiutil.JSON(c, http.StatusOK, apiutil.EmptyJSONArray) +} diff --git a/internal/api/client/trends/statuses.go b/internal/api/client/trends/statuses.go new file mode 100644 index 000000000..f8282095e --- /dev/null +++ b/internal/api/client/trends/statuses.go @@ -0,0 +1,57 @@ +// GoToSocial +// Copyright (C) GoToSocial Authors admin@gotosocial.org +// SPDX-License-Identifier: AGPL-3.0-or-later +// +// 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 trends + +import ( + "net/http" + + apiutil "code.superseriousbusiness.org/gotosocial/internal/api/util" + "code.superseriousbusiness.org/gotosocial/internal/gtserror" + "github.com/gin-gonic/gin" +) + +// StatusesGETHandler swagger:operation GET /api/v1/trends/statuses getTrendingStatuses +// +// Statuses that have been interacted with more than others. +// +// THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array. +// +// --- +// tags: +// - trends +// +// produces: +// - application/json +// +// responses: +// '200': +// schema: +// type: array +// items: +// type: object +// maxItems: 0 +// '406': +// description: not acceptable +func (m *Module) StatusesGETHandler(c *gin.Context) { + if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { + apiutil.ErrorHandler(c, gtserror.NewErrorNotAcceptable(err, err.Error()), m.processor.InstanceGetV1) + return + } + + apiutil.JSON(c, http.StatusOK, apiutil.EmptyJSONArray) +} diff --git a/internal/api/client/trends/tags.go b/internal/api/client/trends/tags.go new file mode 100644 index 000000000..a309082bf --- /dev/null +++ b/internal/api/client/trends/tags.go @@ -0,0 +1,57 @@ +// GoToSocial +// Copyright (C) GoToSocial Authors admin@gotosocial.org +// SPDX-License-Identifier: AGPL-3.0-or-later +// +// 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 trends + +import ( + "net/http" + + apiutil "code.superseriousbusiness.org/gotosocial/internal/api/util" + "code.superseriousbusiness.org/gotosocial/internal/gtserror" + "github.com/gin-gonic/gin" +) + +// TagsGETHandler swagger:operation GET /api/v1/trends/tags getTrendingTags +// +// View hashtags that are currently being used more frequently than usual. +// +// THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array. +// +// --- +// tags: +// - trends +// +// produces: +// - application/json +// +// responses: +// '200': +// schema: +// type: array +// items: +// type: object +// maxItems: 0 +// '406': +// description: not acceptable +func (m *Module) TagsGETHandler(c *gin.Context) { + if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { + apiutil.ErrorHandler(c, gtserror.NewErrorNotAcceptable(err, err.Error()), m.processor.InstanceGetV1) + return + } + + apiutil.JSON(c, http.StatusOK, apiutil.EmptyJSONArray) +} diff --git a/internal/api/client/trends/trends.go b/internal/api/client/trends/trends.go new file mode 100644 index 000000000..056f00e31 --- /dev/null +++ b/internal/api/client/trends/trends.go @@ -0,0 +1,48 @@ +// GoToSocial +// Copyright (C) GoToSocial Authors admin@gotosocial.org +// SPDX-License-Identifier: AGPL-3.0-or-later +// +// 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 trends + +import ( + "net/http" + + "code.superseriousbusiness.org/gotosocial/internal/processing" + "github.com/gin-gonic/gin" +) + +const ( + BasePath = "/v1/trends" + TagsPath = BasePath + "/tags" + StatusesPath = BasePath + "/statuses" + LinksPath = BasePath + "/links" +) + +type Module struct { + processor *processing.Processor +} + +func New(processor *processing.Processor) *Module { + return &Module{ + processor: processor, + } +} + +func (m *Module) Route(attachHandler func(method string, path string, f ...gin.HandlerFunc) gin.IRoutes) { + attachHandler(http.MethodGet, TagsPath, m.TagsGETHandler) + attachHandler(http.MethodGet, StatusesPath, m.StatusesGETHandler) + attachHandler(http.MethodGet, LinksPath, m.LinksGETHandler) +}