[v12.0/forgejo] fix(api): set default pagination and Link header for repoListTags (#9214)

**Backport:** https://codeberg.org/forgejo/forgejo/pulls/9201

Resolves: [8828](https://codeberg.org/forgejo/forgejo/issues/8828)

## Checklist

The [contributor guide](https://forgejo.org/docs/next/contributor/) contains information that will be helpful to first time contributors. There also are a few [conditions for merging Pull Requests in Forgejo repositories](https://codeberg.org/forgejo/governance/src/branch/main/PullRequestsAgreement.md). You are also welcome to join the [Forgejo development chatroom](https://matrix.to/#/#forgejo-development:matrix.org).

### Tests

- I added test coverage for Go changes...
  - [x] in their respective `*_test.go` for unit tests.
  - [x] in the `tests/integration` directory if it involves interactions with a live Forgejo server.
- I added test coverage for JavaScript changes...
  - [ ] in `web_src/js/*.test.js` if it can be unit tested.
  - [ ] in `tests/e2e/*.test.e2e.js` if it requires interactions with a live Forgejo server (see also the [developer guide for JavaScript testing](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/tests/e2e/README.md#end-to-end-tests)).

### Documentation

- [ ] I created a pull request [to the documentation](https://codeberg.org/forgejo/docs) to explain to Forgejo users how to use this change.
- [ ] I did not document these changes and I do not expect someone else to do it.

### Release notes

- [ ] I do not want this change to show in the release notes.
- [ ] I want the title to show in the release notes with a link to this pull request.
- [ ] I want the content of the `release-notes/<pull request number>.md` to be be used for the release notes instead of the title.

<!--start release-notes-assistant-->

## Release notes
<!--URL:https://codeberg.org/forgejo/forgejo-->
- Bug fixes
  - [PR](https://codeberg.org/forgejo/forgejo/pulls/9201): <!--number 9201 --><!--line 0 --><!--description Zml4KGFwaSk6IHNldCBkZWZhdWx0IHBhZ2luYXRpb24gYW5kIExpbmsgaGVhZGVyIGZvciBgcmVwb0xpc3RUYWdzYA==-->fix(api): set default pagination and Link header for `repoListTags`<!--description-->
<!--end release-notes-assistant-->

Co-authored-by: deadkittens <montage_inches78@icloud.com>
Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/9214
Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org>
Co-authored-by: forgejo-backport-action <forgejo-backport-action@noreply.codeberg.org>
Co-committed-by: forgejo-backport-action <forgejo-backport-action@noreply.codeberg.org>

routers/api/v1/repo/tag.go

@@ -55,6 +55,7 @@ func ListTags(ctx *context.APIContext) {
 	//     "$ref": "#/responses/notFound"
 
 	listOpts := utils.GetListOptions(ctx)
+	listOpts.SetDefaultValues()
 
 	tags, total, err := ctx.Repo.GitRepo.GetTagInfos(listOpts.Page, listOpts.PageSize)
 	if err != nil {
@@ -72,7 +73,7 @@ func ListTags(ctx *context.APIContext) {
 
 		apiTags[i] = convert.ToTag(ctx.Repo.Repository, tags[i])
 	}
-
+	ctx.SetLinkHeader(total, listOpts.PageSize)
 	ctx.SetTotalCountHeader(int64(total))
 	ctx.JSON(http.StatusOK, &apiTags)
 }

routers/api/v1/repo/tag_test.go

@@ -0,0 +1,39 @@
+// Copyright 2025 The Forgejo Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package repo
+
+import (
+	"testing"
+
+	"forgejo.org/models/unittest"
+	"forgejo.org/services/contexttest"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestListTagsSetsLinkHeader(t *testing.T) {
+	unittest.PrepareTestEnv(t)
+
+	// limit=1 so that any repo with >=2 tags will paginate
+	ctx, resp := contexttest.MockAPIContext(t, "GET /api/v1/repos/user2/repo1/tags?limit=1")
+	contexttest.LoadRepo(t, ctx, 1)
+	contexttest.LoadUser(t, ctx, 2)
+	contexttest.LoadGitRepo(t, ctx)
+
+	// Ensure at least two tags exist for pagination
+	commit, err := ctx.Repo.GitRepo.GetBranchCommit("master")
+	require.NoError(t, err)
+	_ = ctx.Repo.GitRepo.CreateTag("listtags-linkheader-a", commit.ID.String())
+	_ = ctx.Repo.GitRepo.CreateTag("listtags-linkheader-b", commit.ID.String())
+
+	ListTags(ctx)
+
+	assert.Equal(t, 200, ctx.Resp.Status())
+
+	link := resp.Header().Get("Link")
+	assert.NotEmpty(t, link, "Link header should be set for paginated responses")
+	assert.Contains(t, link, "rel=\"next\"")
+	assert.Contains(t, link, "page=2")
+}

tests/integration/api_repo_tags_test.go

@@ -121,3 +121,36 @@ func TestAPIGetTagArchiveDownloadCount(t *testing.T) {
 	assert.Equal(t, int64(1), tagInfo.ArchiveDownloadCount.TarGz)
 	assert.Equal(t, int64(0), tagInfo.ArchiveDownloadCount.Zip)
 }
+
+func TestAPIGetTagsPaginated(t *testing.T) {
+	defer tests.PrepareTestEnv(t)()
+	user := unittest.AssertExistsAndLoadBean(t, &user_model.User{ID: 2})
+	// Login as User2.
+	session := loginUser(t, user.Name)
+	token := getTokenForLoggedInUser(t, session, auth_model.AccessTokenScopeWriteRepository)
+
+	repoName := "repo1"
+	expectedTagName := "TagDownloadCount"
+
+	for i := range 5 {
+		createNewTagUsingAPI(t, token, user.Name, repoName, expectedTagName+fmt.Sprintf("%d", i), "", "")
+	}
+
+	// List tags with pagination
+	req := NewRequestf(t, "GET", "/api/v1/repos/%s/%s/tags?limit=1", user.Name, repoName).
+		AddTokenAuth(token)
+	resp := MakeRequest(t, req, http.StatusOK)
+
+	var tags []*api.Tag
+	DecodeJSON(t, resp, &tags)
+
+	assert.Len(t, tags, 1)
+
+	assert.Equal(t, fmt.Sprintf("%s%d", expectedTagName, 0), tags[0].Name)
+
+	// Check if Link header is present for pagination
+	link := resp.Header().Get("Link")
+	assert.NotEmpty(t, link, "Link header should be set for paginated responses")
+	assert.Contains(t, link, "rel=\"next\"")
+	assert.Contains(t, link, "page=2")
+}