refactor: add services layer on the Gitea Go SDK (#1125)

- `internal/services`: typed Gitea workflows built on `gitea.dev/sdk`, independent of CLI flags and terminal I/O: issues, pull requests, reviews, comments, labels, milestones, releases and assets, repositories, branches, wiki, Actions (workflows, runs, jobs, logs, artifacts, secrets, variables), organizations, teams, webhooks, notifications, SSH keys, tracked time, admin users, search and status.
- SDK types are mapped to tea's own output types, so `--json` stays a stable contract. Requests the SDK cannot express yet (e.g. pull list filters, multi-status run lists, org label archiving) go through small raw helpers, each marked `TODO(sdk)` with the missing SDK piece.
- Targets Gitea 28 or newer: no version or API-schema probing. List helpers fill pages capped by `MAX_RESPONSE_ITEMS`.

Nothing imports this package yet.

Reviewed-on: https://gitea.com/gitea/tea/pulls/1125
Reviewed-by: TheFox0x7 <95654+thefox0x7@noreply.gitea.com>

internal/services/repository_search.go

@@ -0,0 +1,130 @@
+// Copyright 2026 The Gitea Authors. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+package services
+
+import (
+	"context"
+	"net/http"
+
+	gitea "gitea.dev/sdk"
+)
+
+// RepositoryListOptions selects a repository collection and page.
+type RepositoryListOptions struct {
+	Owner, Kind      string
+	Starred, Watched bool
+	Limit, Page      int
+}
+
+// RepositorySearchOptions supplies explicit repository search filters.
+type RepositorySearchOptions struct {
+	Query, Owner, Kind, Sort, Order string
+	Topic                           bool
+	Private, Archived               *bool
+	Limit, Page                     int
+}
+
+func (s Repositories) ownerID(ctx context.Context, owner string) (int64, bool, error) {
+	if id, isOrg, err := organization(ctx, s.Client, owner); err != nil || isOrg {
+		return id, isOrg, err
+	}
+	user, _, err := call(ctx, s.Client, func(ctx context.Context, c *gitea.Client) (*gitea.User, *gitea.Response, error) {
+		return c.Users.GetUserInfo(ctx, owner)
+	})
+	if err != nil {
+		return 0, false, err
+	}
+	return user.ID, false, nil
+}
+
+func repositoryKind(item Repository, kind string) bool {
+	switch kind {
+	case "fork":
+		return item.Fork
+	case "mirror":
+		return item.Mirror
+	case "source":
+		return !item.Fork && !item.Mirror
+	default:
+		return true
+	}
+}
+
+// List returns repositories accessible to the account, or its selected collection.
+// It reports whether more repositories follow the selected page.
+func (s Repositories) List(ctx context.Context, opts RepositoryListOptions) ([]Repository, bool, error) {
+	isOrg := false
+	var err error
+	if opts.Owner != "" {
+		if _, isOrg, err = s.ownerID(ctx, opts.Owner); err != nil {
+			return nil, false, err
+		}
+	}
+	var items []*gitea.Repository
+	var more bool
+	if opts.Owner == "" && (opts.Starred || opts.Watched) {
+		// TODO(sdk): GetMyStarredRepos and GetMyWatchedRepos accept no ListOptions.
+		endpoint := "user/subscriptions"
+		if opts.Starred {
+			endpoint = "user/starred"
+		}
+		items, more, err = rawWindow[*gitea.Repository](ctx, s.Client, endpoint, nil, opts.Limit, opts.Page)
+	} else {
+		items, more, err = listWindow(opts.Limit, opts.Page, func(limit, page int) ([]*gitea.Repository, http.Header, error) {
+			items, resp, err := call(ctx, s.Client, func(ctx context.Context, c *gitea.Client) ([]*gitea.Repository, *gitea.Response, error) {
+				switch {
+				case isOrg:
+					return c.Repositories.ListOrgRepos(ctx, opts.Owner, gitea.ListOrgReposOptions{ListOptions: listOptions(limit, page)})
+				case opts.Owner != "":
+					return c.Repositories.ListUserRepos(ctx, opts.Owner, gitea.ListReposOptions{ListOptions: listOptions(limit, page)})
+				default:
+					return c.Repositories.ListMyRepos(ctx, gitea.ListReposOptions{ListOptions: listOptions(limit, page)})
+				}
+			})
+			return items, headerOf(resp), err
+		})
+	}
+	if err != nil {
+		return nil, false, err
+	}
+	result := make([]Repository, 0, len(items))
+	for _, item := range items {
+		if repo := repositoryFrom(item); repositoryKind(repo, opts.Kind) {
+			result = append(result, repo)
+		}
+	}
+	return result, more, nil
+}
+
+// Search searches repository names, descriptions or topics within one instance.
+func (s Repositories) Search(ctx context.Context, opts RepositorySearchOptions) ([]Repository, error) {
+	options := gitea.SearchRepoOptions{
+		ListOptions: listOptions(opts.Limit, opts.Page), Keyword: opts.Query, KeywordIsTopic: opts.Topic,
+		KeywordInDescription: true, IsPrivate: opts.Private, IsArchived: opts.Archived, Type: gitea.RepoType(opts.Kind),
+	}
+	if opts.Sort != "" {
+		options.Sort, options.Order = opts.Sort, opts.Order
+	}
+	if opts.Owner != "" {
+		id, _, err := s.ownerID(ctx, opts.Owner)
+		if err != nil {
+			return nil, err
+		}
+		options.OwnerID = id
+	}
+	account, _, err := call(ctx, s.Client, func(ctx context.Context, c *gitea.Client) (*gitea.User, *gitea.Response, error) {
+		return c.Users.GetMyUserInfo(ctx)
+	})
+	if err != nil {
+		return nil, err
+	}
+	options.PrioritizedByOwnerID = account.ID
+	items, _, err := call(ctx, s.Client, func(ctx context.Context, c *gitea.Client) ([]*gitea.Repository, *gitea.Response, error) {
+		return c.Repositories.SearchRepos(ctx, options)
+	})
+	if err != nil {
+		return nil, err
+	}
+	return convertAll(items, repositoryFrom), nil
+}